Add new helpers sub-module with getRequestExecutionContext

.changeset/happy-beds-talk.md

@@ -0,0 +1,14 @@
+---
+'@cloudflare/next-on-pages': minor
+---
+
+Add new `helpers` sub-module with `getRequestExecutionContext`.
+
+Add a new `helpers` module that will provide utilities that will allow developer to utilize better next-on-pages and the cloudflare platform.
+
+The `getRequestExecutionContext` function has been introduced with helpers.
+This function provides an execution context object (`ctx`) to the developer.
+
+This function throws an error when executed on the client.
+This function also returns a mocked context when executed in a non pages environment.
+This is useful when executing unit tests, for example, as it prevents errors from occurring.

packages/next-on-pages/env.d.ts

@@ -4,6 +4,7 @@ declare global {
 			NODE_ENV?: string;
 			npm_config_user_agent?: string;
 			CF_PAGES?: string;
+			CF_NEXT_ON_PAGES_EXECUTION_CONTEXT?: ExecutionContext;
 			SHELL?: string;
 			[key: string]: string | Fetcher;
 		}