feat: Include CF exec context in RouteOptions

docs/src/content/docs/core/routing.mdx

@@ -101,6 +101,7 @@ The request handler function takes in the following options:
 2. `params`: The matched parameters from the request URL.
 3. `env`: The Cloudflare environment.
 4. `ctx`: The context object (See [Middleware & Context](#middleware-context)).
+5. `cf:` Cloudflare's [Execution Context API](https://developers.cloudflare.com/workers/runtime-apis/context/) methods, e.g. `waitUntil()`
 
 Return values:
 - `Response`: A standard response object.

sdk/src/runtime/lib/router.ts

@@ -1,14 +1,17 @@
 import { isValidElementType } from "react-is";
+import { ExecutionContext } from "@cloudflare/workers-types";
 
 export type HandlerOptions<TContext = Record<string, any>> = {
   request: Request;
   env: Env;
+  cf: ExecutionContext;
   ctx: TContext;
   headers: Headers;
   rw: RwContext<TContext>;
 };
 
 export type RouteOptions<TContext = Record<string, any>, TParams = any> = {
+  cf: ExecutionContext;
   request: Request;
   params: TParams;
   env: Env;
@@ -19,7 +22,7 @@ export type RouteOptions<TContext = Record<string, any>, TParams = any> = {
 
 export type PageProps<TContext> = Omit<
   RouteOptions<TContext>,
-  "request" | "headers" | "rw"
+  "request" | "headers" | "rw" | "cf"
 > & { rw: { nonce: string } };
 
 export type LayoutProps<TContext> = PageProps<TContext> & {
@@ -134,12 +137,14 @@ export function defineRoutes<TContext = Record<string, any>>(
 ): {
   routes: Route<TContext>[];
   handle: ({
+    cf,
     request,
     ctx,
     env,
     rw,
     headers,
   }: {
+    cf: ExecutionContext;
     request: Request;
     ctx: TContext;
     env: Env;
@@ -150,7 +155,7 @@ export function defineRoutes<TContext = Record<string, any>>(
   const flattenedRoutes = flattenRoutes(routes);
   return {
     routes: flattenedRoutes,
-    async handle({ request, ctx, env, rw, headers }) {
+    async handle({ cf, request, ctx, env, rw, headers }) {
       const url = new URL(request.url);
       let path = url.pathname;
 
@@ -162,6 +167,7 @@ export function defineRoutes<TContext = Record<string, any>>(
       // Find matching route
       let match: RouteMatch<TContext> | null = null;
       const routeOptions: RouteOptions<TContext> = {
+        cf,
         request,
         params: {},
         ctx,

sdk/src/runtime/worker.tsx

@@ -26,7 +26,7 @@ declare global {
 
 export const defineApp = <Context,>(routes: Route<Context>[]) => {
   return {
-    fetch: async (request: Request, env: Env, _ctx: ExecutionContext) => {
+    fetch: async (request: Request, env: Env, cf: ExecutionContext) => {
       globalThis.__webpack_require__ = ssrWebpackRequire;
 
       const router = defineRoutes(routes);
@@ -127,6 +127,7 @@ export const defineApp = <Context,>(routes: Route<Context>[]) => {
         const userHeaders = new Headers();
 
         const response = await router.handle({
+          cf,
           request,
           headers: userHeaders,
           ctx: {} as Context,