@reckona/mreact-router 0.0.189 → 0.0.191

package/README.md

@@ -363,7 +363,7 @@ For Cloudflare Pages advanced mode, run `mreact-router package cloudflare-pages
 User Vite plugins from the project config are forwarded into router bundle builds after the `mreact-router` plugin itself is removed, so MDX-style syntax transforms and custom content loaders can participate in server, client, Cloudflare, and prerender bundles. Vite `define` values are also forwarded into generated Cloudflare server bundles, including `import.meta.env.*` aliases and plain define identifiers used by loaders and route handlers. Client assets, route stylesheet assets imported by pages/layouts/templates or special `error.tsx`/`not-found.tsx` boundaries, and copied public assets are served only when they appear in the generated manifest allow-list. Dynamic routes resolve modules through a build-time registry keyed by `route.file`, not by constructing module ids from request input. Generated Cloudflare route modules preserve app-router layout/template shells and named slots for both string and `stream = true` pages, including route-local `<Await>` boundaries and local server-component imports. Generated Cloudflare server route modules dispatch method exports such as `GET`, `POST`, and `ALL` with decoded dynamic params plus `context.env`, `context.context`, `context.request`, and `context.route`, so handlers can use Worker bindings directly. Cloudflare page rendering installs the per-request query client scope before loader, page, metadata, and document rendering, so server-rendered helpers can call `getQueryClient()` even in runtimes without `AsyncLocalStorage`. The Cloudflare adapter marks streamed HTML with `Cache-Control: no-transform` and `Content-Encoding: identity` so Workers compression does not gzip-buffer the first shell before placeholders can paint. Pass `onResponse` to add cross-cutting response headers to rendered, static, asset, reload, not-found, and error responses. If a generated Cloudflare route module cannot produce the `data-mreact-route-id` marker contract required by client navigation, the adapter returns a reload signal for `x-mreact-navigation: 1` requests so the browser performs a normal document navigation without first buffering the full HTML response.
 
 For AWS Lambda, use `createPreloadedAwsLambdaRequestHandler()` with API Gateway
-HTTP API v2 or Lambda Function URL payload format 2.0:
+HTTP API v2 or Lambda Function URL payload format 2.0. It validates the event before materializing runtime files or starting preload work:
 
 ```ts
 import { createPreloadedAwsLambdaRequestHandler } from "@reckona/mreact-router/adapters/aws-lambda";
@@ -377,17 +377,30 @@ export const handler = await createPreloadedAwsLambdaRequestHandler({
 });
 ```
 
+When a deployment deliberately trades Lambda initialization time for lower first-valid-request latency, call `warmAwsLambdaRuntime()` explicitly before creating the handler:
+
+```ts
+import {
+  createPreloadedAwsLambdaRequestHandler,
+  warmAwsLambdaRuntime,
+} from "@reckona/mreact-router/adapters/aws-lambda";
+
+const options = { importPolicy: "generated" as const, outDir: ".mreact" };
+await warmAwsLambdaRuntime(options);
+export const handler = await createPreloadedAwsLambdaRequestHandler(options);
+```
+
 Production adapters enforce the app-router import policy when bundling loaders, middleware, route handlers, metadata, and server actions. `mreact-router build` writes `.mreact/server/import-policy.json` from server-side static imports. The built Node server used by `mreact-router start .mreact`, `renderBuiltAppRequest()`, and `createBuiltRequestRuntime()` reads that generated policy automatically and merges its runtime packages with any explicit policy options. Lambda handlers can use `importPolicy: "generated"`. You can still pass an explicit `importPolicy.allowedPackages` list when you need a hand-audited policy.
 
-For Lambda deployments, build with `mreact-router build --target=aws-lambda` or `buildApp({ targets: ["aws-lambda"] })`. The target writes Node-compatible server/client output, `.mreact/server/import-policy.json`, and `.mreact/aws-lambda/mreact-handler.mjs` while skipping `.mreact/cloudflare` route modules, so loaders and server helpers may import Node-only dependencies such as database drivers without being bundled for the Workers runtime.
+For Lambda deployments, build with `mreact-router build --target=aws-lambda` or `buildApp({ targets: ["aws-lambda"] })`. The generated buffered and streaming handlers warm the same middleware policy during module initialization by default and then use request handlers with duplicate preload disabled. The artifact manifest records `mreact-handler.handler` and `mreact-streaming-handler.handler` separately. Select a broader or disabled initialization policy with `--aws-lambda-preload=hot-route-requests|all|none` or `buildApp({ awsLambdaPreload: "all", targets: ["aws-lambda"] })` only after measuring the packaged handler; pair `hot-route-requests` with `--aws-lambda-preload-routes=/,/login` or `awsLambdaPreloadRoutes`. `none` disables generated module preload but still materializes the writable runtime directory during generated handler import. The package command preserves the build-generated policy unless package options explicitly override it. The target writes Node-compatible server/client output, `.mreact/server/import-policy.json`, and generated Lambda entries while skipping `.mreact/cloudflare` route modules, so loaders and server helpers may import Node-only dependencies such as database drivers without being bundled for the Workers runtime.
 
-Package Lambda deployments with `mreact-router package aws-lambda --from .mreact --out .lambda` instead of pointing deployment tooling at the full project checkout. AWS Lambda enforces a 250 MB unzipped deployment package limit, and the runtime only needs `.mreact/`, `mreact-handler.mjs`, `package.json` / lockfiles, and production `node_modules`; `src/`, tests, dev dependencies, build caches, and Vite/Vitest/Playwright tooling are not required. `mreact-router build --target=aws-lambda` keeps compiled server route artifacts in `.mreact/server/server-modules/*.json` instead of embedding them in one large server manifest, writes compiled module bodies as hashed `.mjs` files, and keeps request/control artifacts separate from render artifacts so loader redirects do not read page render bundles. AWS Lambda request/control artifacts bundle the generated import-policy packages they use for loaders, middleware, route handlers, and metadata, reducing first-hit package resolution on sparse Lambda traffic while leaving render-only, server action, custom handler, and adapter dependencies in production `node_modules`. `createAwsLambdaRequestHandler()` treats `outDir` as read-only and materializes generated runtime files under `/tmp/mreact-router/<hash>/runtime` by default, with a `node_modules` symlink back to the deployed package root. Direct `createAwsLambdaRequestHandler()` and `createAwsLambdaStreamingRequestHandler()` handlers start only middleware and shared runtime preload in the background by default, so all-route preload work does not compete with the first user request. If a request arrives before preload finishes, middleware is resolved first, middleware responses or redirects return without loading the matched page artifact, and continuing requests load only the matched route's artifact closure. Static middleware `config.matcher` and `config.id` values are checked before importing the middleware module, so unmatched health checks and route-local middleware skips avoid evaluating heavyweight middleware dependencies. Route request artifacts omit page render exports, and built loader and route metadata artifacts are split, so loader redirects do not evaluate page-only or metadata-only dependencies before render or metadata is needed. Loader redirects settle before page component server transforms and render imports for non-stream routes, stream routes without a loading boundary, and stream loading routes whose loader source contains router control-flow helpers such as `redirect()` or `notFound()`. Prefer `await createPreloadedAwsLambdaRequestHandler()` in Node 24 ESM Lambda handlers when first-request latency matters: it waits for the full preload during Lambda initialization by default, increasing `Init Duration` but making the first handler invocation much closer to warm steady-state. Pass `runtimeDir` only when you need to control that writable cache location. With pnpm, run `pnpm --dir .lambda install --prod --frozen-lockfile --ignore-scripts --config.node-linker=hoisted`. pnpm's default isolated linker is symlink-heavy, so verify the artifact's symlink count with `find .lambda -type l | wc -l` and measure actual file bytes in addition to `du -sh .lambda` before upload. Packages listed in the generated import policy may still be needed by render-only modules, inferred server actions, custom handlers, or adapter code, so keep them installed in that production artifact.
+Package Lambda deployments with `mreact-router package aws-lambda --from .mreact --out .lambda` instead of pointing deployment tooling at the full project checkout. AWS Lambda enforces a 250 MB unzipped deployment package limit, and the runtime only needs `.mreact/`, `mreact-handler.mjs`, `package.json` / lockfiles, and production `node_modules`; `src/`, tests, dev dependencies, build caches, and Vite/Vitest/Playwright tooling are not required. `mreact-router build --target=aws-lambda` keeps compiled server route artifacts in `.mreact/server/server-modules/*.json` instead of embedding them in one large server manifest, writes compiled module bodies as hashed `.mjs` files, and keeps request/control artifacts separate from render artifacts so loader redirects do not read page render bundles. AWS Lambda request/control artifacts bundle the generated import-policy packages they use for loaders, middleware, route handlers, and metadata, reducing first-hit package resolution on sparse Lambda traffic while leaving render-only, server action, custom handler, and adapter dependencies in production `node_modules`. `createAwsLambdaRequestHandler()` treats `outDir` as read-only and materializes generated runtime files under `/tmp/mreact-router/<hash>/runtime` by default, with a `node_modules` symlink back to the deployed package root. Direct `createAwsLambdaRequestHandler()` and `createAwsLambdaStreamingRequestHandler()` handlers start only middleware and shared runtime preload in the background by default, so all-route preload work does not compete with the first user request. If a request arrives before preload finishes, middleware is resolved first, middleware responses or redirects return without loading the matched page artifact, and continuing requests load only the matched route's artifact closure. Static middleware `config.matcher` and `config.id` values are checked before importing the middleware module, so unmatched health checks and route-local middleware skips avoid evaluating heavyweight middleware dependencies. Route request artifacts omit page render exports, and built loader and route metadata artifacts are split, so loader redirects do not evaluate page-only or metadata-only dependencies before render or metadata is needed. Loader redirects settle before page component server transforms and render imports for non-stream routes, stream routes without a loading boundary, and stream loading routes whose loader source contains router control-flow helpers such as `redirect()` or `notFound()`. `createPreloadedAwsLambdaRequestHandler()` validates the first event before it starts full preload. When a deployment intentionally accepts extra Lambda initialization work to reduce first-valid-request latency, call `await warmAwsLambdaRuntime(options)` during controlled initialization before creating the handler. Pass `runtimeDir` only when you need to control that writable cache location. With pnpm, run `pnpm --dir .lambda install --prod --frozen-lockfile --ignore-scripts --config.node-linker=hoisted`. pnpm's default isolated linker is symlink-heavy, so verify the artifact's symlink count with `find .lambda -type l | wc -l` and measure actual file bytes in addition to `du -sh .lambda` before upload. Packages listed in the generated import policy may still be needed by render-only modules, inferred server actions, custom handlers, or adapter code, so keep them installed in that production artifact.
 
 When a deployment needs custom adapter options such as `serverActions.authorize`, `onResponse`, `errorHandler`, or `allowedHosts`, create an app handler and package it with `mreact-router package aws-lambda --from .mreact --out .lambda --handler src/lambda.ts`. The package command bundles that handler into `.lambda/mreact-handler.mjs`, resolves app-local TypeScript imports with Vite-style extensionless paths, and keeps package imports external so production `node_modules` remains the runtime dependency boundary. If the handler imports the same app server modules that routes also import, those modules are compiled into the handler bundle separately from the mreact route artifacts; use `getServerRuntimeState()` for state that must be shared through the router runtime instead of relying on module singletons.
 
 Configure `allowedHosts` for production Lambda deployments so absolute URLs, redirects, cache keys, and metadata cannot be derived from attacker-controlled Host input. The Lambda adapter uses `Host` by default and only reads `x-forwarded-host` when `hostPolicy: "trusted-proxy"` is set. It also ignores `x-forwarded-proto` unless `trustForwardedProto: true` is configured, deriving the request scheme from the Lambda event protocol when available and otherwise defaulting to HTTPS.
 
-Use the Lambda `preload` option to tune that trade-off. Direct handlers default to `"middleware"` so cold starts do not kick off all route module imports in parallel with the first request. `createPreloadedAwsLambdaRequestHandler()` and `createPreloadedAwsLambdaStreamingRequestHandler()` default to `"all"` because the work is awaited during Lambda initialization instead of racing user traffic. Set `preload: "none"` to disable background preload, `preload: "all"` only when you have measured that all-route background preload helps the deployed function, `preload: { mode: "hot-routes", routes: ["/", "/dashboard"] }` with `createPreloadedAwsLambdaRequestHandler()` to await selected route closures including render modules during Lambda initialization, or `preload: { mode: "hot-route-requests", routes: ["/", "/login"] }` to warm only middleware plus selected route loader/server-route request modules without evaluating page/layout render modules. For direct handlers that cannot use top-level async initialization, add `wait: "before-render"` to an object preload strategy to let page-rendering invocations wait for the already-started preload after loader redirects have had a chance to return; add `wait: "first-request"` only when the first invocation can pay the full preload cost. Lambda request timing reports `first-request` waits as `preloadWaitMs`, and render timing reports `before-render` waits as `preloadWaitMs`.
+Use the Lambda `preload` option to tune that trade-off. Direct handlers default to `"middleware"` so cold starts do not kick off all route module imports in parallel with the first request. `createPreloadedAwsLambdaRequestHandler()` and `createPreloadedAwsLambdaStreamingRequestHandler()` default to `"all"` after event validation. Call `warmAwsLambdaRuntime()` explicitly when initialization-time full preload is an intentional deployment choice. Set `preload: "none"` to disable background preload, `preload: "all"` only when you have measured that all-route background preload helps the deployed function, `preload: { mode: "hot-routes", routes: ["/", "/dashboard"] }` with `warmAwsLambdaRuntime()` to warm selected route closures including render modules before valid traffic, or `preload: { mode: "hot-route-requests", routes: ["/", "/login"] }` to warm only middleware plus selected route loader/server-route request modules without evaluating page/layout render modules. For direct handlers that cannot use top-level async initialization, add `wait: "before-render"` to an object preload strategy to let page-rendering invocations wait for the already-started preload after loader redirects have had a chance to return; add `wait: "first-request"` only when the first invocation can pay the full preload cost. Lambda request timing reports `first-request` waits as `preloadWaitMs`, and render timing reports `before-render` waits as `preloadWaitMs`.
 
 Set `timings: true` on `createAwsLambdaRequestHandler()` or `createAwsLambdaStreamingRequestHandler()` when you need low-overhead Lambda phase diagnostics. The adapter emits a `router:request:timing` debug log event with `eventToRequestMs`, `runtimeDirMs`, `renderMs`, and response serialization or streaming time, so production measurements can separate API Gateway event normalization, runtime materialization, route rendering, and Lambda response conversion. It also forwards `router:render:timing` debug events for route-level phases such as route matching, middleware, loader start/wait, source analysis, page module load, page component render, route slot render, layout module load, layout component render, metadata, and response construction. Loader timings split module load/evaluation (`loaderModuleLoadMs`) from user loader execution (`loaderExecutionMs`) inside the existing `loaderWaitMs` envelope, source analysis reports `sourceAnalysisArtifactMs` when a built analysis summary is reused, and middleware timings similarly split `middlewareModuleLoadMs` from `middlewareExecutionMs` inside `middlewareMs`. Buffered handlers report `responseSerializationMs` as the total conversion phase and split it into `streamDrainMs`, `streamReadMs`, `streamConcatMs`, and `bodyEncodeMs`; streaming handlers report `responseStreamingMs` as the total streaming phase and split it into `streamWaitMs` and `streamWriteMs`.
 

package/bin/mreact-router.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+const builtCliUrl = new URL("../dist/cli.js", import.meta.url);
+
+try {
+  await import(builtCliUrl.href);
+} catch (error) {
+  if (
+    error !== null &&
+    typeof error === "object" &&
+    "code" in error &&
+    error.code === "ERR_MODULE_NOT_FOUND" &&
+    "url" in error &&
+    error.url === builtCliUrl.href
+  ) {
+    console.error(
+      "mreact-router has not been built yet. Run the workspace or package build before invoking the CLI.",
+    );
+    process.exitCode = 1;
+  } else {
+    throw error;
+  }
+}

package/dist/adapters/aws-lambda.d.ts

@@ -4,11 +4,23 @@ import type { AppRouterImportPolicy } from "../import-policy.js";
 import { type AppRouterLogger } from "../logger.js";
 import type { AppRouterResponseHook } from "../render.js";
 import type { RouterInstrumentation } from "../trace.js";
-/** Re-exports router instrumentation hooks for AWS Lambda handlers. */
-export type { RouterInstrumentation } from "../trace.js";
+/** Re-exports cache contracts used by AWS Lambda handlers. */
+export type { AppRouterCache, AppRouterCacheEntry } from "../cache.js";
+/** Re-exports server action contracts used by AWS Lambda handlers. */
+export type { AppRouterAllowedServerAction, AppRouterServerActionOptions, } from "../actions.js";
+/** Re-exports logger contracts used by AWS Lambda handlers. */
+export type { AppRouterCspInlineNonceWarningLogEvent, AppRouterLogger, AppRouterLogError, AppRouterLogEvent, AppRouterRenderTimingLogEvent, AppRouterRequestEndLogEvent, AppRouterRequestErrorLogEvent, AppRouterRequestStartLogEvent, AppRouterRequestTimingLogEvent, AppRouterRuntime, } from "../logger.js";
+/** Re-exports response hook contracts used by AWS Lambda handlers. */
+export type { AppRouterResponseHook, AppRouterResponseHookContext } from "../render.js";
+/** Re-exports build contracts referenced by AWS Lambda handler options. */
+export type { BuiltPrerenderedRoute } from "../build.js";
+/** Re-exports router instrumentation hooks and events for AWS Lambda handlers. */
+export type { RouterInstrumentation, RouterMiddlewareEndInstrumentationEvent, RouterMiddlewareInstrumentationEvent, RouterRequestEndInstrumentationEvent, RouterRequestInstrumentationEvent, RouterRouteEndInstrumentationEvent, RouterRouteInstrumentationEvent, RouterTraceContext, } from "../trace.js";
 /** Re-exports app-router import policy controls for AWS Lambda handlers. */
 export type { AppRouterImportPolicy } from "../import-policy.js";
 import { type AppRouterPrerenderStore, type RequestHostPolicy, type ResponseSinkStrategy } from "../serve.js";
+/** Re-exports request and rendering contracts used by AWS Lambda handlers. */
+export type { AppRouterPrerenderStore, RequestHostPolicy, ResponseSinkStrategy, } from "../serve.js";
 /**
  * Represents the AWS API Gateway HTTP API v2 event consumed by buffered handlers.
  */
@@ -17,15 +29,15 @@ export interface AwsLambdaHttpEventV2 {
     cookies?: string[] | undefined;
     headers?: Record<string, string | undefined> | undefined;
     isBase64Encoded?: boolean | undefined;
-    rawPath?: string | undefined;
-    rawQueryString?: string | undefined;
-    requestContext?: {
-        http?: {
-            method?: string | undefined;
+    rawPath: string;
+    rawQueryString: string;
+    requestContext: {
+        http: {
+            method: string;
             protocol?: string | undefined;
-        } | undefined;
-    } | undefined;
-    version?: "2.0" | string | undefined;
+        };
+    };
+    version: "2.0";
 }
 /**
  * Represents the AWS API Gateway HTTP API v2 result returned by buffered handlers.
@@ -109,11 +121,17 @@ export type AwsLambdaStreamingRequestHandler<TContext = unknown> = (event: AwsLa
  */
 export declare function createAwsLambdaRequestHandler(options: AwsLambdaRequestHandlerOptions): AwsLambdaRequestHandler;
 /**
- * Creates a buffered AWS Lambda handler after eagerly preparing and preloading the built runtime.
+ * Creates a buffered AWS Lambda handler that starts full runtime preparation after the first valid event.
  *
- * Use this when startup code can await preload work before the first request instead of letting the first invocation share that cost.
+ * Invalid events are rejected before runtime materialization or preload work begins.
  */
 export declare function createPreloadedAwsLambdaRequestHandler(options: AwsLambdaRequestHandlerOptions): Promise<AwsLambdaRequestHandler>;
+/**
+ * Explicitly materializes and preloads a built Lambda runtime before request handling.
+ *
+ * Call this during controlled Lambda initialization only when the extra startup work is preferable to first-valid-request latency. Request handlers always validate events before they start runtime work.
+ */
+export declare function warmAwsLambdaRuntime(options: AwsLambdaRequestHandlerOptions): Promise<void>;
 /**
  * Creates an AWS Lambda streaming response handler for built app-router output.
  *
@@ -121,7 +139,9 @@ export declare function createPreloadedAwsLambdaRequestHandler(options: AwsLambd
  */
 export declare function createAwsLambdaStreamingRequestHandler<TContext = unknown>(options: AwsLambdaRequestHandlerOptions): AwsLambdaStreamingRequestHandler<TContext>;
 /**
- * Creates a streaming AWS Lambda handler after eagerly preparing and preloading the built runtime.
+ * Creates a streaming AWS Lambda handler that starts full runtime preparation after the first valid event.
+ *
+ * Invalid events are rejected before runtime materialization or preload work begins.
  */
 export declare function createPreloadedAwsLambdaStreamingRequestHandler<TContext = unknown>(options: AwsLambdaRequestHandlerOptions): Promise<AwsLambdaStreamingRequestHandler<TContext>>;
 //# sourceMappingURL=aws-lambda.d.ts.map

package/dist/adapters/aws-lambda.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aws-lambda.d.ts","sourceRoot":"","sources":["../../src/adapters/aws-lambda.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"aws-lambda.d.ts","sourceRoot":"","sources":["../../src/adapters/aws-lambda.ts"],"names":[],"mappings":"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"}

package/dist/adapters/aws-lambda.js

@@ -6,6 +6,21 @@ import { dirname, join } from "node:path";
 import { normalizeBuiltAppRuntimePreloadStrategy, } from "../preload-policy.js";
 import { emitRouterLog, logDurationMs, logError, logNow, requestLogFields, } from "../logger.js";
 import { createBuiltRequestRuntime, preloadBuiltAppRuntime, resolveRequestHost, warnIfImplicitHostTrust, } from "../serve.js";
+const invalidAwsLambdaHttpEventV2Diagnostic = 'Expected an AWS Lambda HTTP API payload format 2.0 event with rawPath and requestContext.http.method.';
+function invalidAwsLambdaHttpEventV2Result() {
+    return {
+        body: invalidAwsLambdaHttpEventV2Diagnostic,
+        headers: { "content-type": "text/plain; charset=utf-8" },
+        isBase64Encoded: false,
+        statusCode: 400,
+    };
+}
+function invalidAwsLambdaHttpEventV2Response() {
+    return new Response(invalidAwsLambdaHttpEventV2Diagnostic, {
+        headers: { "content-type": "text/plain; charset=utf-8" },
+        status: 400,
+    });
+}
 /**
  * Creates a buffered AWS Lambda HTTP API v2 handler for built app-router output.
  *
@@ -13,24 +28,65 @@ import { createBuiltRequestRuntime, preloadBuiltAppRuntime, resolveRequestHost,
  */
 export function createAwsLambdaRequestHandler(options) {
     warnIfImplicitHostTrust(options);
-    const runtimeDirPromise = prepareAwsLambdaRuntimeDir(options);
-    const runtimePreloadPromise = startAwsLambdaRuntimePreload(options, runtimeDirPromise, "middleware");
-    void runtimePreloadPromise?.catch(() => { });
-    return createAwsLambdaRequestHandlerFromRuntime(options, runtimeDirPromise, runtimePreloadPromise, "middleware");
+    let handler;
+    return async (event) => {
+        try {
+            validateAwsLambdaHttpEventV2(event);
+        }
+        catch {
+            return invalidAwsLambdaHttpEventV2Result();
+        }
+        handler ??= (() => {
+            const runtimeDirPromise = prepareAwsLambdaRuntimeDir(options);
+            const runtimePreloadPromise = startAwsLambdaRuntimePreload(options, runtimeDirPromise, "middleware");
+            void runtimePreloadPromise?.catch(() => { });
+            return createAwsLambdaRequestHandlerFromRuntime(options, runtimeDirPromise, runtimePreloadPromise, "middleware");
+        })();
+        return await handler(event);
+    };
 }
 /**
- * Creates a buffered AWS Lambda handler after eagerly preparing and preloading the built runtime.
+ * Creates a buffered AWS Lambda handler that starts full runtime preparation after the first valid event.
  *
- * Use this when startup code can await preload work before the first request instead of letting the first invocation share that cost.
+ * Invalid events are rejected before runtime materialization or preload work begins.
  */
 export async function createPreloadedAwsLambdaRequestHandler(options) {
+    warnIfImplicitHostTrust(options);
+    let handler;
+    return async (event) => {
+        try {
+            validateAwsLambdaHttpEventV2(event);
+        }
+        catch {
+            return invalidAwsLambdaHttpEventV2Result();
+        }
+        handler ??= (() => {
+            const runtimeDirPromise = prepareAwsLambdaRuntimeDir(options);
+            const runtimePreloadPromise = startAwsLambdaRuntimePreload(options, runtimeDirPromise, "all");
+            void runtimePreloadPromise?.catch(() => { });
+            return createAwsLambdaRequestHandlerFromRuntime(options, runtimeDirPromise, runtimePreloadPromise);
+        })();
+        return await handler(event);
+    };
+}
+/**
+ * Explicitly materializes and preloads a built Lambda runtime before request handling.
+ *
+ * Call this during controlled Lambda initialization only when the extra startup work is preferable to first-valid-request latency. Request handlers always validate events before they start runtime work.
+ */
+export async function warmAwsLambdaRuntime(options) {
     warnIfImplicitHostTrust(options);
     const runtimeDir = await prepareAwsLambdaRuntimeDir(options);
     await preloadAwsLambdaRuntime(options, runtimeDir);
-    return createAwsLambdaRequestHandlerFromRuntime(options, Promise.resolve(runtimeDir));
 }
 function createAwsLambdaRequestHandlerFromRuntime(options, runtimeDirPromise, runtimePreloadPromise, defaultPreloadMode = "all") {
     return async (event) => {
+        try {
+            validateAwsLambdaHttpEventV2(event);
+        }
+        catch {
+            return invalidAwsLambdaHttpEventV2Result();
+        }
         const startedAt = logNow();
         const phases = createAwsLambdaTimingPhases(options);
         const eventToRequestStartedAt = phaseStartedAt(phases);
@@ -107,20 +163,49 @@ function createAwsLambdaRequestHandlerFromRuntime(options, runtimeDirPromise, ru
 export function createAwsLambdaStreamingRequestHandler(options) {
     warnIfImplicitHostTrust(options);
     const runtime = awsLambdaRuntime();
-    const runtimeDirPromise = prepareAwsLambdaRuntimeDir(options);
-    const runtimePreloadPromise = startAwsLambdaRuntimePreload(options, runtimeDirPromise, "middleware");
-    void runtimePreloadPromise?.catch(() => { });
-    return createAwsLambdaStreamingRequestHandlerFromRuntime(options, runtime, runtimeDirPromise, runtimePreloadPromise, "middleware");
+    let handler;
+    return runtime.streamifyResponse(async (event, responseStream, context) => {
+        try {
+            validateAwsLambdaHttpEventV2(event);
+        }
+        catch {
+            await streamResponseToLambda(invalidAwsLambdaHttpEventV2Response(), responseStream, runtime);
+            return;
+        }
+        handler ??= (() => {
+            const runtimeDirPromise = prepareAwsLambdaRuntimeDir(options);
+            const runtimePreloadPromise = startAwsLambdaRuntimePreload(options, runtimeDirPromise, "middleware");
+            void runtimePreloadPromise?.catch(() => { });
+            return createAwsLambdaStreamingRequestHandlerFromRuntime(options, runtime, runtimeDirPromise, runtimePreloadPromise, "middleware");
+        })();
+        await handler(event, responseStream, context);
+    });
 }
 /**
- * Creates a streaming AWS Lambda handler after eagerly preparing and preloading the built runtime.
+ * Creates a streaming AWS Lambda handler that starts full runtime preparation after the first valid event.
+ *
+ * Invalid events are rejected before runtime materialization or preload work begins.
  */
 export async function createPreloadedAwsLambdaStreamingRequestHandler(options) {
     warnIfImplicitHostTrust(options);
     const runtime = awsLambdaRuntime();
-    const runtimeDir = await prepareAwsLambdaRuntimeDir(options);
-    await preloadAwsLambdaRuntime(options, runtimeDir);
-    return createAwsLambdaStreamingRequestHandlerFromRuntime(options, runtime, Promise.resolve(runtimeDir));
+    let handler;
+    return runtime.streamifyResponse(async (event, responseStream, context) => {
+        try {
+            validateAwsLambdaHttpEventV2(event);
+        }
+        catch {
+            await streamResponseToLambda(invalidAwsLambdaHttpEventV2Response(), responseStream, runtime);
+            return;
+        }
+        handler ??= (() => {
+            const runtimeDirPromise = prepareAwsLambdaRuntimeDir(options);
+            const runtimePreloadPromise = startAwsLambdaRuntimePreload(options, runtimeDirPromise, "all");
+            void runtimePreloadPromise?.catch(() => { });
+            return createAwsLambdaStreamingRequestHandlerFromRuntime(options, runtime, runtimeDirPromise, runtimePreloadPromise);
+        })();
+        await handler(event, responseStream, context);
+    });
 }
 function startAwsLambdaRuntimePreload(options, runtimeDirPromise, defaultMode = "all") {
     const preload = normalizeAwsLambdaPreload(options.preload, defaultMode);
@@ -213,6 +298,13 @@ function normalizeAwsLambdaPreload(strategy, defaultMode = "all") {
 }
 function createAwsLambdaStreamingRequestHandlerFromRuntime(options, runtime, runtimeDirPromise, runtimePreloadPromise, defaultPreloadMode = "all") {
     return runtime.streamifyResponse(async (event, responseStream, _context) => {
+        try {
+            validateAwsLambdaHttpEventV2(event);
+        }
+        catch {
+            await streamResponseToLambda(invalidAwsLambdaHttpEventV2Response(), responseStream, runtime);
+            return;
+        }
         const startedAt = logNow();
         const phases = createAwsLambdaTimingPhases(options);
         const eventToRequestStartedAt = phaseStartedAt(phases);
@@ -337,6 +429,7 @@ function isNodeErrorCode(error, code) {
         error.code === code);
 }
 function eventToRequest(event, options) {
+    validateAwsLambdaHttpEventV2(event);
     const headers = eventHeaders(event);
     const rawHost = lambdaRequestHost(headers, options);
     const host = resolveRequestHost({
@@ -346,11 +439,9 @@ function eventToRequest(event, options) {
         rawHost: rawHost ?? undefined,
     });
     const protocol = lambdaRequestProtocol(event, headers, options);
-    const rawPath = event.rawPath === undefined || event.rawPath === "" ? "/" : event.rawPath;
-    const rawQueryString = event.rawQueryString === undefined || event.rawQueryString === ""
-        ? ""
-        : `?${event.rawQueryString}`;
-    const method = event.requestContext?.http?.method ?? "GET";
+    const rawPath = event.rawPath;
+    const rawQueryString = event.rawQueryString === "" ? "" : `?${event.rawQueryString}`;
+    const method = event.requestContext.http.method;
     const init = {
         headers,
         method,
@@ -361,6 +452,23 @@ function eventToRequest(event, options) {
     }
     return new Request(`${protocol}://${host}${rawPath}${rawQueryString}`, init);
 }
+function validateAwsLambdaHttpEventV2(event) {
+    const candidate = event;
+    if (typeof candidate !== "object" ||
+        candidate === null ||
+        candidate.version !== "2.0" ||
+        typeof candidate.rawPath !== "string" ||
+        !candidate.rawPath.startsWith("/") ||
+        typeof candidate.rawQueryString !== "string" ||
+        typeof candidate.requestContext !== "object" ||
+        candidate.requestContext === null ||
+        typeof (candidate.requestContext.http) !== "object" ||
+        candidate.requestContext.http === null ||
+        typeof (candidate.requestContext.http.method) !== "string" ||
+        candidate.requestContext.http.method === "") {
+        throw new Error(invalidAwsLambdaHttpEventV2Diagnostic);
+    }
+}
 function lambdaRequestHost(headers, options) {
     if (options.hostPolicy === "trusted-proxy") {
         return firstForwardedValue(headers.get("x-forwarded-host")) ?? headers.get("host");