@fluojs/runtime 1.0.0-beta.6 → 1.0.0-beta.8

package/dist/node/internal-node-request.d.ts

@@ -1,6 +1,25 @@
 import type { IncomingHttpHeaders, IncomingMessage, ServerResponse } from 'node:http';
 import { PayloadTooLargeException, type FrameworkRequest } from '@fluojs/http';
 import { type MultipartOptions } from '../multipart.js';
+type MemoizedValue<T> = () => T;
+type QueryRecord = Record<string, string | string[] | undefined>;
+/**
+ * Options for creating a deferred framework request shell from a Node-backed adapter.
+ */
+export interface DeferredFrameworkRequestShellOptions<RawRequest> {
+    cookieHeader?: string | string[] | undefined;
+    headers?: FrameworkRequest['headers'];
+    headersFactory?: () => FrameworkRequest['headers'];
+    materializeBody?: () => Promise<void>;
+    method?: string;
+    path: string;
+    query?: QueryRecord;
+    queryFactory?: () => QueryRecord;
+    raw: RawRequest;
+    requestId?: string;
+    signal: AbortSignal | (() => AbortSignal);
+    url: string;
+}
 /**
  * HTTP payload-size error that closes the underlying Node request stream after the response commits.
  */
@@ -31,6 +50,13 @@ export declare function createFrameworkRequest(request: IncomingMessage, signal:
  * @returns The framework request shell with metadata snapshotted and body materialization deferred.
  */
 export declare function createDeferredFrameworkRequest(request: IncomingMessage, signal: AbortSignal, multipartOptions?: MultipartOptions, maxBodySize?: number, preserveRawBody?: boolean): FrameworkRequest;
+/**
+ * Creates a framework request shell from already-snapshotted Node adapter metadata.
+ *
+ * @param options - Raw request, metadata factories, and deferred body materialization hooks.
+ * @returns A framework request with lazy headers, cookies, query values, and optional body materialization.
+ */
+export declare function createDeferredFrameworkRequestShell<RawRequest>({ cookieHeader, headers, headersFactory, materializeBody, method, path, query, queryFactory, raw, requestId, signal, url, }: DeferredFrameworkRequestShellOptions<RawRequest>): FrameworkRequest;
 /**
  * Materializes a deferred Node framework request body exactly once.
  *
@@ -38,6 +64,20 @@ export declare function createDeferredFrameworkRequest(request: IncomingMessage,
  * @returns A promise that settles after body, rawBody, and files fields are populated when applicable.
  */
 export declare function materializeFrameworkRequestBody(request: FrameworkRequest): Promise<void>;
+/**
+ * Creates a synchronous memoized value resolver.
+ *
+ * @param factory - Function that computes the value on first access.
+ * @returns A stable resolver that returns the cached value after the first call.
+ */
+export declare function createMemoizedValue<T>(factory: () => T): MemoizedValue<T>;
+/**
+ * Creates an async memoized side-effect resolver.
+ *
+ * @param factory - Async function to run at most once.
+ * @returns A resolver that returns the same in-flight or completed promise for every call.
+ */
+export declare function createMemoizedAsyncValue(factory: () => Promise<void>): () => Promise<void>;
 /**
  * Creates an abort signal that fires when the Node response closes unexpectedly.
  *
@@ -52,4 +92,71 @@ export declare function createRequestSignal(response: ServerResponse): AbortSign
  * @returns The request identifier when present.
  */
 export declare function resolveRequestIdFromHeaders(headers: IncomingHttpHeaders): string | undefined;
+/**
+ * Parses a raw URL search string into the framework query shape.
+ *
+ * @param search - Raw search string, with or without a leading question mark.
+ * @returns Query values where repeated keys become string arrays.
+ */
+export declare function parseQueryParamsFromSearch(search: string): Record<string, string | string[]>;
+/**
+ * Snapshots host-parsed query values when they already match framework semantics.
+ *
+ * @param query - Host query object exposed by a Node-backed adapter.
+ * @returns A cloned query record when all values are strings or string arrays; otherwise `undefined` for raw URL fallback.
+ */
+export declare function snapshotSimpleQueryRecord(query: unknown): QueryRecord | undefined;
+/**
+ * Clones Node request headers into the framework header record shape.
+ *
+ * @param headers - Raw Node incoming headers.
+ * @returns A shallow header snapshot with array values cloned.
+ */
+export declare function cloneRequestHeaders(headers: IncomingHttpHeaders): FrameworkRequest['headers'];
+/**
+ * Clones a single Node header value when it is array-backed.
+ *
+ * @param value - Header value to snapshot.
+ * @returns The original scalar value or a cloned array value.
+ */
+export declare function cloneHeaderValue<T extends string | string[] | undefined>(value: T): T;
+/**
+ * Reads the primary value from a Node header value.
+ *
+ * @param headerValue - Header value that may contain multiple entries.
+ * @returns The first header value when present.
+ */
+export declare function readPrimaryHeaderValue(headerValue: string | string[] | undefined): string | undefined;
+/**
+ * Normalizes a Node content-type header to its primary media type.
+ *
+ * @param headerValue - Raw content-type header value.
+ * @returns Lowercase primary media type without parameters, or `undefined` when absent.
+ */
+export declare function normalizePrimaryContentType(headerValue: string | string[] | undefined): string | undefined;
+/**
+ * Parses a Node cookie header into framework cookie values.
+ *
+ * @param cookieHeader - Raw cookie header value or values.
+ * @returns Cookie name/value pairs with percent-decoded values when possible.
+ */
+export declare function parseCookieHeader(cookieHeader: string | string[] | undefined): Record<string, string>;
+/**
+ * Splits a raw Node request URL into path and search components.
+ *
+ * @param rawUrl - Raw request URL, absolute URL, or undefined value from Node.
+ * @returns The pathname and search string used by framework request matching and query parsing.
+ */
+export declare function splitRawRequestUrl(rawUrl: string | undefined): {
+    path: string;
+    search: string;
+};
+/**
+ * Resolves a raw Node request URL into an absolute URL string.
+ *
+ * @param rawUrl - Raw request URL, absolute URL, or undefined value from Node.
+ * @returns An absolute URL suitable for Web-standard parsers.
+ */
+export declare function resolveAbsoluteRequestUrl(rawUrl: string | undefined): string;
+export {};
 //# sourceMappingURL=internal-node-request.d.ts.map

package/dist/node/internal-node-request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-node-request.d.ts","sourceRoot":"","sources":["../../src/node/internal-node-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,cAAc,EACf,MAAM,WAAW,CAAC;AAInB,OAAO,EAEL,wBAAwB,EACxB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAC;AAUzB;;GAEG;AACH,qBAAa,mCAAoC,SAAQ,wBAAwB;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,eAAe;IAIrD,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;CAahD;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,EACnB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,SAAkB,EAC7B,eAAe,UAAQ,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAW3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,EACnB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,SAAkB,EAC7B,eAAe,UAAQ,GACtB,gBAAgB,CA2DlB;AAoBD;;;;;GAKG;AACH,wBAAsB,+BAA+B,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9F;AAyBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,WAAW,CAezE;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAG5F"}
+{"version":3,"file":"internal-node-request.d.ts","sourceRoot":"","sources":["../../src/node/internal-node-request.ts"],"names":[],"mappings":"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"}

package/dist/node/internal-node-request.js

@@ -2,6 +2,11 @@ import { Readable } from 'node:stream';
 import { URL } from 'node:url';
 import { BadRequestException, PayloadTooLargeException } from '@fluojs/http';
 import { parseMultipart } from '../multipart.js';
+
+/**
+ * Options for creating a deferred framework request shell from a Node-backed adapter.
+ */
+
 /**
  * HTTP payload-size error that closes the underlying Node request stream after the response commits.
  */
@@ -50,21 +55,19 @@ export async function createFrameworkRequest(request, signal, multipartOptions,
  * @returns The framework request shell with metadata snapshotted and body materialization deferred.
  */
 export function createDeferredFrameworkRequest(request, signal, multipartOptions, maxBodySize = 1 * 1024 * 1024, preserveRawBody = false) {
-  const url = new URL(request.url ?? '/', 'http://localhost');
+  const rawUrl = request.url ?? '/';
+  const urlParts = splitRawRequestUrl(rawUrl);
   const headers = cloneRequestHeaders(request.headers);
-  const cookieHeader = cloneHeaderValue(headers.cookie);
-  const searchParams = new URLSearchParams(url.searchParams);
-  const cookies = createMemoizedValue(() => parseCookieHeader(cookieHeader));
-  const query = createMemoizedValue(() => parseQueryParams(searchParams));
   const contentType = normalizePrimaryContentType(headers['content-type']);
   const isMultipart = contentType === 'multipart/form-data';
+  let frameworkRequest;
   const materializeBody = createMemoizedAsyncValue(async () => {
     if (isMultipart) {
       const result = await parseMultipart({
         body: Readable.toWeb(request),
         headers,
         method: request.method,
-        url: url.toString()
+        url: resolveAbsoluteRequestUrl(rawUrl)
       }, {
         ...multipartOptions,
         maxTotalSize: multipartOptions?.maxTotalSize ?? maxBodySize
@@ -83,22 +86,85 @@ export function createDeferredFrameworkRequest(request, signal, multipartOptions
       frameworkRequest.rawBody = bodyResult.rawBody;
     }
   });
+  frameworkRequest = createDeferredFrameworkRequestShell({
+    cookieHeader: cloneHeaderValue(headers.cookie),
+    headers,
+    materializeBody,
+    method: request.method,
+    path: urlParts.path,
+    queryFactory: () => parseQueryParamsFromSearch(urlParts.search),
+    raw: request,
+    requestId: resolvePrimaryRequestIdFromHeaders(headers),
+    signal,
+    url: urlParts.path + urlParts.search
+  });
+  return frameworkRequest;
+}
+
+/**
+ * Creates a framework request shell from already-snapshotted Node adapter metadata.
+ *
+ * @param options - Raw request, metadata factories, and deferred body materialization hooks.
+ * @returns A framework request with lazy headers, cookies, query values, and optional body materialization.
+ */
+export function createDeferredFrameworkRequestShell({
+  cookieHeader,
+  headers,
+  headersFactory,
+  materializeBody,
+  method,
+  path,
+  query,
+  queryFactory,
+  raw,
+  requestId,
+  signal,
+  url
+}) {
+  const hasQuerySnapshot = query !== undefined;
+  const hasLazySignal = typeof signal === 'function';
+  const resolveHeaders = headersFactory ? createMemoizedValue(headersFactory) : () => headers ?? {};
+  const resolveCookies = createMemoizedValue(() => parseCookieHeader(cookieHeader ?? resolveHeaders().cookie));
+  const resolveQuery = hasQuerySnapshot ? undefined : createMemoizedValue(() => queryFactory?.() ?? {});
   const frameworkRequest = {
     get cookies() {
-      return cookies();
+      return resolveCookies();
     },
-    headers,
-    method: request.method ?? 'GET',
-    params: {},
-    path: url.pathname,
-    get query() {
-      return query();
+    get headers() {
+      return resolveHeaders();
     },
-    raw: request,
-    signal,
-    url: url.pathname + url.search,
-    materializeBody
+    method: method ?? 'GET',
+    params: {},
+    path,
+    requestId,
+    raw,
+    url
   };
+  if (hasLazySignal) {
+    Object.defineProperty(frameworkRequest, 'signal', {
+      configurable: true,
+      enumerable: true,
+      get() {
+        return signal();
+      }
+    });
+  } else {
+    frameworkRequest.signal = signal;
+  }
+  if (hasQuerySnapshot) {
+    frameworkRequest.query = query;
+  } else {
+    Object.defineProperty(frameworkRequest, 'query', {
+      configurable: true,
+      enumerable: true,
+      get() {
+        return resolveQuery();
+      }
+    });
+  }
+  if (materializeBody) {
+    frameworkRequest.materializeBody = materializeBody;
+  }
   return frameworkRequest;
 }
 function hasNodeRequestBody(request) {
@@ -125,7 +191,14 @@ export async function materializeFrameworkRequestBody(request) {
   await request.materializeBody?.();
   delete request.materializeBody;
 }
-function createMemoizedValue(factory) {
+
+/**
+ * Creates a synchronous memoized value resolver.
+ *
+ * @param factory - Function that computes the value on first access.
+ * @returns A stable resolver that returns the cached value after the first call.
+ */
+export function createMemoizedValue(factory) {
   let initialized = false;
   let value;
   return () => {
@@ -136,7 +209,14 @@ function createMemoizedValue(factory) {
     return value;
   };
 }
-function createMemoizedAsyncValue(factory) {
+
+/**
+ * Creates an async memoized side-effect resolver.
+ *
+ * @param factory - Async function to run at most once.
+ * @returns A resolver that returns the same in-flight or completed promise for every call.
+ */
+export function createMemoizedAsyncValue(factory) {
   let promise;
   return () => {
     promise ??= factory();
@@ -175,6 +255,20 @@ export function resolveRequestIdFromHeaders(headers) {
   const requestId = headers['x-request-id'] ?? headers['x-correlation-id'];
   return Array.isArray(requestId) ? requestId[0] : requestId;
 }
+function resolvePrimaryRequestIdFromHeaders(headers) {
+  const requestId = headers['x-request-id'];
+  return Array.isArray(requestId) ? requestId[0] : requestId;
+}
+
+/**
+ * Parses a raw URL search string into the framework query shape.
+ *
+ * @param search - Raw search string, with or without a leading question mark.
+ * @returns Query values where repeated keys become string arrays.
+ */
+export function parseQueryParamsFromSearch(search) {
+  return parseQueryParams(new URLSearchParams(search));
+}
 function parseQueryParams(searchParams) {
   const query = {};
   for (const [key, value] of searchParams.entries()) {
@@ -191,20 +285,73 @@ function parseQueryParams(searchParams) {
   }
   return query;
 }
-function cloneRequestHeaders(headers) {
+
+/**
+ * Snapshots host-parsed query values when they already match framework semantics.
+ *
+ * @param query - Host query object exposed by a Node-backed adapter.
+ * @returns A cloned query record when all values are strings or string arrays; otherwise `undefined` for raw URL fallback.
+ */
+export function snapshotSimpleQueryRecord(query) {
+  if (typeof query !== 'object' || query === null) {
+    return undefined;
+  }
+  const snapshot = {};
+  for (const [key, value] of Object.entries(query)) {
+    if (typeof value === 'string') {
+      snapshot[key] = value;
+      continue;
+    }
+    if (Array.isArray(value) && value.every(item => typeof item === 'string')) {
+      snapshot[key] = [...value];
+      continue;
+    }
+    return undefined;
+  }
+  return snapshot;
+}
+
+/**
+ * Clones Node request headers into the framework header record shape.
+ *
+ * @param headers - Raw Node incoming headers.
+ * @returns A shallow header snapshot with array values cloned.
+ */
+export function cloneRequestHeaders(headers) {
   const clonedEntries = Object.entries(headers).map(([name, value]) => [name, cloneHeaderValue(value)]);
   return Object.fromEntries(clonedEntries);
 }
-function cloneHeaderValue(value) {
+
+/**
+ * Clones a single Node header value when it is array-backed.
+ *
+ * @param value - Header value to snapshot.
+ * @returns The original scalar value or a cloned array value.
+ */
+export function cloneHeaderValue(value) {
   return Array.isArray(value) ? [...value] : value;
 }
-function readPrimaryHeaderValue(headerValue) {
+
+/**
+ * Reads the primary value from a Node header value.
+ *
+ * @param headerValue - Header value that may contain multiple entries.
+ * @returns The first header value when present.
+ */
+export function readPrimaryHeaderValue(headerValue) {
   if (Array.isArray(headerValue)) {
     return headerValue[0];
   }
   return headerValue;
 }
-function normalizePrimaryContentType(headerValue) {
+
+/**
+ * Normalizes a Node content-type header to its primary media type.
+ *
+ * @param headerValue - Raw content-type header value.
+ * @returns Lowercase primary media type without parameters, or `undefined` when absent.
+ */
+export function normalizePrimaryContentType(headerValue) {
   const primaryHeaderValue = readPrimaryHeaderValue(headerValue);
   if (typeof primaryHeaderValue !== 'string') {
     return undefined;
@@ -220,7 +367,14 @@ function decodeCookieValue(raw) {
     return raw;
   }
 }
-function parseCookieHeader(cookieHeader) {
+
+/**
+ * Parses a Node cookie header into framework cookie values.
+ *
+ * @param cookieHeader - Raw cookie header value or values.
+ * @returns Cookie name/value pairs with percent-decoded values when possible.
+ */
+export function parseCookieHeader(cookieHeader) {
   const normalizedCookieHeader = Array.isArray(cookieHeader) ? cookieHeader.join('; ') : cookieHeader;
   if (!normalizedCookieHeader) {
     return {};
@@ -272,4 +426,51 @@ async function readRequestBody(request, contentType, maxBodySize = 1 * 1024 * 10
     body: bodyText,
     rawBody: preserveRawBody ? rawBody : undefined
   };
+}
+
+/**
+ * Splits a raw Node request URL into path and search components.
+ *
+ * @param rawUrl - Raw request URL, absolute URL, or undefined value from Node.
+ * @returns The pathname and search string used by framework request matching and query parsing.
+ */
+export function splitRawRequestUrl(rawUrl) {
+  const resolvedRawUrl = rawUrl ?? '/';
+  if (resolvedRawUrl.startsWith('http://') || resolvedRawUrl.startsWith('https://')) {
+    const url = new URL(resolvedRawUrl);
+    return {
+      path: url.pathname,
+      search: url.search
+    };
+  }
+  const queryStart = resolvedRawUrl.indexOf('?');
+  const hashStart = resolvedRawUrl.indexOf('#');
+  const pathEndCandidates = [queryStart, hashStart].filter(index => index >= 0);
+  const pathEnd = pathEndCandidates.length > 0 ? Math.min(...pathEndCandidates) : resolvedRawUrl.length;
+  const path = resolvedRawUrl.slice(0, pathEnd) || '/';
+  if (queryStart === -1) {
+    return {
+      path,
+      search: ''
+    };
+  }
+  const searchEnd = hashStart >= 0 && hashStart > queryStart ? hashStart : resolvedRawUrl.length;
+  return {
+    path,
+    search: resolvedRawUrl.slice(queryStart, searchEnd)
+  };
+}
+
+/**
+ * Resolves a raw Node request URL into an absolute URL string.
+ *
+ * @param rawUrl - Raw request URL, absolute URL, or undefined value from Node.
+ * @returns An absolute URL suitable for Web-standard parsers.
+ */
+export function resolveAbsoluteRequestUrl(rawUrl) {
+  const resolvedRawUrl = rawUrl ?? '/';
+  if (resolvedRawUrl.startsWith('http://') || resolvedRawUrl.startsWith('https://')) {
+    return resolvedRawUrl;
+  }
+  return new URL(resolvedRawUrl, 'http://localhost').toString();
 }

package/dist/node/internal-node.d.ts

@@ -2,6 +2,7 @@ import { createServer as createHttpServer } from 'node:http';
 import { createServer as createHttpsServer, type ServerOptions as HttpsServerOptions } from 'node:https';
 import { type CorsOptions, type Dispatcher, type HttpApplicationAdapter, type MiddlewareLike, type SecurityHeadersOptions } from '@fluojs/http';
 import { createNodeResponseCompression, compressNodeResponse } from './internal-node-compression.js';
+import { cloneHeaderValue, cloneRequestHeaders, createDeferredFrameworkRequestShell, createMemoizedAsyncValue, createMemoizedValue, normalizePrimaryContentType, parseCookieHeader, parseQueryParamsFromSearch, createRequestSignal, readPrimaryHeaderValue, resolveAbsoluteRequestUrl, resolveRequestIdFromHeaders, snapshotSimpleQueryRecord, splitRawRequestUrl } from './internal-node-request.js';
 import { createNodeShutdownSignalRegistration, defaultNodeShutdownSignals, registerShutdownSignals } from './internal-node-shutdown.js';
 import type { MultipartOptions, UploadedFile } from '../multipart.js';
 import type { Application, ApplicationLogger, CreateApplicationOptions, ModuleType } from '../types.js';
@@ -112,5 +113,5 @@ export declare function bootstrapNodeApplication(rootModule: ModuleType, options
  * @returns The run node application result.
  */
 export declare function runNodeApplication(rootModule: ModuleType, options: RunNodeApplicationOptions): Promise<Application>;
-export { compressNodeResponse, createNodeResponseCompression, createNodeShutdownSignalRegistration, defaultNodeShutdownSignals, registerShutdownSignals, };
+export { cloneHeaderValue, cloneRequestHeaders, compressNodeResponse, createDeferredFrameworkRequestShell, createMemoizedAsyncValue, createMemoizedValue, createRequestSignal, createNodeResponseCompression, createNodeShutdownSignalRegistration, defaultNodeShutdownSignals, normalizePrimaryContentType, parseCookieHeader, parseQueryParamsFromSearch, readPrimaryHeaderValue, registerShutdownSignals, resolveAbsoluteRequestUrl, resolveRequestIdFromHeaders, snapshotSimpleQueryRecord, splitRawRequestUrl, };
 //# sourceMappingURL=internal-node.d.ts.map

package/dist/node/internal-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-node.d.ts","sourceRoot":"","sources":["../../src/node/internal-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAA6C,MAAM,WAAW,CAAC;AACxG,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAE,KAAK,aAAa,IAAI,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGzG,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACrB,MAAM,gCAAgC,CAAC;AAaxC,OAAO,EACL,oCAAoC,EACpC,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKtE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAExG,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,gBAAgB;QACxB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB;CACF;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW,CAAC;AAIhE;;GAEG;AACH,MAAM,WAAW,+BAAgC,SAAQ,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC1H,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,KAAK,GAAG,sBAAsB,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,+BAA+B;IAChF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,KAAK,GAAG,SAAS,qBAAqB,EAAE,CAAC;CAC5D;AAED,UAAU,gBAAgB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AASD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAG7F;;GAEG;AACH,qBAAa,0BAA2B,YAAW,sBAAsB;IAWrE,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAI7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAnBpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAIrC;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAG1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,oBAAM,EAClB,UAAU,oBAAK,EAChC,WAAW,qBAAQ,EACF,YAAY,EAAE,kBAAkB,GAAG,SAAS,EAC7D,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,SAAkB,EAC7B,eAAe,UAAQ,EACN,iBAAiB,SAA8B;IAmBlE,SAAS,IAAI,UAAU;IAIvB,qBAAqB;IAIrB,eAAe,IAAI,gBAAgB;IAI7B,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAad,aAAa;CAY5B;AAiDD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,EAAE,WAAW,UAAQ,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,sBAAsB,CAa5J;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,WAAW,CAAC,CAMtB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,oCAAoC,EACpC,0BAA0B,EAC1B,uBAAuB,GACxB,CAAC"}
+{"version":3,"file":"internal-node.d.ts","sourceRoot":"","sources":["../../src/node/internal-node.ts"],"names":[],"mappings":"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"}

package/dist/node/internal-node.js

@@ -3,7 +3,7 @@ import { createServer as createHttpsServer } from 'node:https';
 import { createServerBackedHttpAdapterRealtimeCapability } from '@fluojs/http';
 import { bootstrapHttpAdapterApplication, runHttpAdapterApplication } from '../http-adapter-shared.js';
 import { createNodeResponseCompression, compressNodeResponse } from './internal-node-compression.js';
-import { createDeferredFrameworkRequest, NodeRequestPayloadTooLargeException, createRequestSignal, materializeFrameworkRequestBody, resolveRequestIdFromHeaders } from './internal-node-request.js';
+import { cloneHeaderValue, cloneRequestHeaders, createDeferredFrameworkRequestShell, createDeferredFrameworkRequest, createMemoizedAsyncValue, createMemoizedValue, NodeRequestPayloadTooLargeException, normalizePrimaryContentType, parseCookieHeader, parseQueryParamsFromSearch, createRequestSignal, materializeFrameworkRequestBody, readPrimaryHeaderValue, resolveAbsoluteRequestUrl, resolveRequestIdFromHeaders, snapshotSimpleQueryRecord, splitRawRequestUrl } from './internal-node-request.js';
 import { createFrameworkResponse, writeNodeAdapterErrorResponse } from './internal-node-response.js';
 import { createNodeShutdownSignalRegistration, defaultNodeShutdownSignals, registerShutdownSignals } from './internal-node-shutdown.js';
 import { dispatchWithRequestResponseFactory } from '../adapters/request-response-factory.js';
@@ -156,7 +156,7 @@ export async function runNodeApplication(rootModule, options) {
     shutdownRegistration: createNodeShutdownSignalRegistration(options.shutdownSignals ?? defaultNodeShutdownSignals())
   }, adapter);
 }
-export { compressNodeResponse, createNodeResponseCompression, createNodeShutdownSignalRegistration, defaultNodeShutdownSignals, registerShutdownSignals };
+export { cloneHeaderValue, cloneRequestHeaders, compressNodeResponse, createDeferredFrameworkRequestShell, createMemoizedAsyncValue, createMemoizedValue, createRequestSignal, createNodeResponseCompression, createNodeShutdownSignalRegistration, defaultNodeShutdownSignals, normalizePrimaryContentType, parseCookieHeader, parseQueryParamsFromSearch, readPrimaryHeaderValue, registerShutdownSignals, resolveAbsoluteRequestUrl, resolveRequestIdFromHeaders, snapshotSimpleQueryRecord, splitRawRequestUrl };
 function createNodeServer(httpsOptions, handler) {
   return httpsOptions ? createHttpsServer(httpsOptions, handler) : createHttpServer(handler);
 }

package/dist/web.d.ts

@@ -11,8 +11,10 @@ declare module '@fluojs/http' {
  * Configures Web request parsing, multipart handling, and raw body preservation.
  */
 export interface CreateWebRequestResponseFactoryOptions {
+    consumeOriginalBody?: boolean;
     maxBodySize?: number;
     multipart?: MultipartOptions;
+    preferNativeJsonBodyReader?: boolean;
     rawBody?: boolean;
 }
 /**

package/dist/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AAMtB,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,gBAAgB;QACxB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB;CACF;AAOD;;GAEG;AACH,MAAM,WAAW,sCAAsC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,sCAAsC;IACvF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACzF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,UAAU,IAAI,QAAQ,CAAC;CACxB;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAiNhD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,sCAA2C,GACnD,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,oBAAoB,CAAC,CA6BhF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,UAAU,EACV,yBAAiG,EACjG,OAAO,EACP,OAAO,EACP,GAAG,OAAO,EACX,EAAE,yBAAyB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAU/C;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,SAAwB,EACnC,eAAe,UAAQ,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AAMtB,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,gBAAgB;QACxB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,UAAU,CAAC;KACtB;CACF;AAOD;;GAEG;AACH,MAAM,WAAW,sCAAsC;IACrD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,sCAAsC;IACvF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACzF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,UAAU,IAAI,QAAQ,CAAC;CACxB;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAgNhD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,sCAA2C,GACnD,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,oBAAoB,CAAC,CA+BhF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,UAAU,EACV,yBAAiG,EACjG,OAAO,EACP,OAAO,EACP,GAAG,OAAO,EACX,EAAE,yBAAyB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAU/C;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,EACnB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,WAAW,SAAwB,EACnC,eAAe,UAAQ,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/web.js

@@ -146,8 +146,7 @@ class MutableWebFrameworkResponse {
         headers: toResponseHeaders(this.headers),
         status: this.statusCode ?? 200
       };
-      const responseBody = this.responseBody instanceof Uint8Array ? this.responseBody.slice().buffer : this.responseBody;
-      const nativeResponseBody = isResponseBodyForbidden(init.status) ? undefined : responseBody ?? '';
+      const nativeResponseBody = isResponseBodyForbidden(init.status) ? undefined : this.responseBody === undefined ? '' : this.responseBody;
       this.finalizedResponse = this.streamActive ? new Response(this.getOrCreateResponseStream().readable, init) : new Response(nativeResponseBody, init);
       this.raw = this.finalizedResponse;
       this.committed = true;
@@ -171,7 +170,7 @@ class MutableWebFrameworkResponse {
 export function createWebRequestResponseFactory(options = {}) {
   return {
     async createRequest(request, signal) {
-      return createDeferredWebFrameworkRequest(request, signal, options.multipart, options.maxBodySize ?? DEFAULT_MAX_BODY_SIZE, options.rawBody ?? false);
+      return createDeferredWebFrameworkRequest(request, signal, options.multipart, options.maxBodySize ?? DEFAULT_MAX_BODY_SIZE, options.rawBody ?? false, options.preferNativeJsonBodyReader ?? false, options.consumeOriginalBody ?? false);
     },
     materializeRequest(request) {
       return materializeWebFrameworkRequestBody(request);
@@ -242,26 +241,20 @@ export async function createWebFrameworkRequest(request, signal, multipartOption
  * @param preserveRawBody - Whether materialization should retain raw request body bytes.
  * @returns The framework request shell with metadata snapshotted and body materialization deferred.
  */
-function createDeferredWebFrameworkRequest(request, signal, multipartOptions, maxBodySize = DEFAULT_MAX_BODY_SIZE, preserveRawBody = false) {
+function createDeferredWebFrameworkRequest(request, signal, multipartOptions, maxBodySize = DEFAULT_MAX_BODY_SIZE, preserveRawBody = false, preferNativeJsonBodyReader = false, consumeOriginalBody = false) {
   const url = new URL(request.url);
-  const headerEntries = Array.from(request.headers.entries());
+  const requestHeaders = new Headers(request.headers);
   const method = request.method;
-  const cookieHeader = request.headers.get('cookie') ?? undefined;
-  const searchParams = new URLSearchParams(url.searchParams);
-  const headers = createMemoizedValue(() => cloneWebHeaders(headerEntries));
-  const cookies = createMemoizedValue(() => parseCookieHeader(cookieHeader));
-  const query = createMemoizedValue(() => parseQueryParams(searchParams));
-  const contentType = request.headers.get('content-type') ?? undefined;
+  const headers = createMemoizedValue(() => cloneWebHeaders(requestHeaders));
+  const cookies = createMemoizedValue(() => parseCookieHeader(requestHeaders.get('cookie') ?? undefined));
+  const query = createMemoizedValue(() => parseQueryString(url.search));
+  const contentType = requestHeaders.get('content-type') ?? undefined;
   const isMultipart = typeof contentType === 'string' && contentType.includes('multipart/form-data');
-  const materializeBody = createMemoizedAsyncValue(async () => {
+  const hasRequestBody = request.body !== null;
+  const materializeBody = hasRequestBody ? createMemoizedAsyncValue(async () => {
     if (isMultipart) {
       const materializedRequest = request.clone();
-      const result = await parseMultipart({
-        body: materializedRequest.body,
-        headers: new Headers(headerEntries),
-        method,
-        url: url.toString()
-      }, {
+      const result = await parseMultipart(createRequestWithSnapshotMetadata(materializedRequest, request.url, method, requestHeaders), {
         ...multipartOptions,
         maxTotalSize: multipartOptions?.maxTotalSize ?? maxBodySize
       });
@@ -274,12 +267,13 @@ function createDeferredWebFrameworkRequest(request, signal, multipartOptions, ma
       frameworkRequest.body = undefined;
       return;
     }
-    const bodyResult = await readWebRequestBody(request.clone(), contentType, maxBodySize, preserveRawBody);
+    const requestToRead = consumeOriginalBody ? request : request.clone();
+    const bodyResult = await readWebRequestBody(requestToRead, contentType, maxBodySize, preserveRawBody, preferNativeJsonBodyReader);
     frameworkRequest.body = bodyResult.body;
     if (bodyResult.rawBody) {
       frameworkRequest.rawBody = bodyResult.rawBody;
     }
-  });
+  }) : undefined;
   const frameworkRequest = {
     get cookies() {
       return cookies();
@@ -294,13 +288,28 @@ function createDeferredWebFrameworkRequest(request, signal, multipartOptions, ma
       return query();
     },
     raw: request,
+    requestId: requestHeaders.get('x-request-id') ?? undefined,
     signal,
     url: url.pathname + url.search,
     materializeBody
   };
+  if (!hasRequestBody) {
+    frameworkRequest.body = undefined;
+  }
   const nativeRouteHandoff = consumeRawRequestNativeRouteHandoff(request);
   return nativeRouteHandoff ? attachFrameworkRequestNativeRouteHandoff(frameworkRequest, nativeRouteHandoff) : frameworkRequest;
 }
+function createRequestWithSnapshotMetadata(request, url, method, headers) {
+  const init = {
+    headers: new Headers(headers),
+    method
+  };
+  if (request.body) {
+    init.body = request.body;
+    init.duplex = 'half';
+  }
+  return new Request(url, init);
+}
 function validateWebRequestContentLength(request, maxBodySize) {
   const contentLength = request.headers.get('content-length');
   if (contentLength === null) {
@@ -340,25 +349,56 @@ function createMemoizedAsyncValue(factory) {
     return promise;
   };
 }
-function parseQueryParams(searchParams) {
+function parseQueryString(search) {
   const query = {};
-  for (const [key, value] of searchParams.entries()) {
-    const current = query[key];
-    if (current === undefined) {
-      query[key] = value;
-      continue;
+  if (search.length <= 1) {
+    return query;
+  }
+  let index = search.charCodeAt(0) === 63 ? 1 : 0;
+  while (index <= search.length) {
+    let nextDelimiter = search.indexOf('&', index);
+    if (nextDelimiter === -1) {
+      nextDelimiter = search.length;
     }
-    if (Array.isArray(current)) {
-      current.push(value);
-      continue;
+    const entry = search.slice(index, nextDelimiter);
+    if (entry.length > 0) {
+      const separatorIndex = entry.indexOf('=');
+      const rawKey = separatorIndex === -1 ? entry : entry.slice(0, separatorIndex);
+      const rawValue = separatorIndex === -1 ? '' : entry.slice(separatorIndex + 1);
+      const key = decodeQueryComponent(rawKey, 'key');
+      const value = decodeQueryComponent(rawValue, 'value');
+      const current = query[key];
+      if (current === undefined) {
+        query[key] = value;
+      } else if (Array.isArray(current)) {
+        current.push(value);
+      } else {
+        query[key] = [current, value];
+      }
     }
-    query[key] = [current, value];
+    index = nextDelimiter + 1;
   }
   return query;
 }
+function decodeQueryComponent(value, kind) {
+  const normalizedValue = value.includes('+') ? value.replaceAll('+', ' ') : value;
+  try {
+    return decodeURIComponent(normalizedValue);
+  } catch {
+    return decodeQueryComponentLikeUrlSearchParams(value, kind);
+  }
+}
+function decodeQueryComponentLikeUrlSearchParams(value, kind) {
+  if (kind === 'key') {
+    const params = new URLSearchParams(`${value}=`);
+    return params.keys().next().value ?? '';
+  }
+  const params = new URLSearchParams(`x=${value}`);
+  return params.get('x') ?? '';
+}
 function cloneWebHeaders(headers) {
   const clonedHeaders = {};
-  for (const [name, value] of headers) {
+  for (const [name, value] of headers.entries()) {
     clonedHeaders[name] = value;
   }
   return clonedHeaders;
@@ -382,14 +422,23 @@ function parseCookieHeader(cookieHeader) {
     return [pair.slice(0, index).trim(), decodeCookieValue(pair.slice(index + 1).trim())];
   }));
 }
-async function readWebRequestBody(request, contentType, maxBodySize = DEFAULT_MAX_BODY_SIZE, preserveRawBody = false) {
+async function readWebRequestBody(request, contentType, maxBodySize = DEFAULT_MAX_BODY_SIZE, preserveRawBody = false, preferNativeJsonBodyReader = false) {
   validateWebRequestContentLength(request, maxBodySize);
   if (!request.body) {
     return {
       body: undefined
     };
   }
-  const rawBody = await readByteLimitedStream(request.body, maxBodySize);
+  if (!preserveRawBody && isJsonContentType(contentType) && (preferNativeJsonBodyReader || isContentLengthWithinLimit(request, maxBodySize))) {
+    const rawBody = new Uint8Array(await request.arrayBuffer());
+    if (rawBody.byteLength > maxBodySize) {
+      throw new PayloadTooLargeException(REQUEST_BODY_LIMIT_MESSAGE);
+    }
+    return parseWebRequestRawBody(rawBody, contentType, preserveRawBody);
+  }
+  return parseWebRequestRawBody(await readByteLimitedStream(request.body, maxBodySize), contentType, preserveRawBody);
+}
+function parseWebRequestRawBody(rawBody, contentType, preserveRawBody) {
   if (rawBody.byteLength === 0) {
     return {
       body: undefined
@@ -402,7 +451,7 @@ async function readWebRequestBody(request, contentType, maxBodySize = DEFAULT_MA
       rawBody: preserveRawBody ? rawBody : undefined
     };
   }
-  if (typeof contentType === 'string' && contentType.includes('application/json')) {
+  if (isJsonContentType(contentType)) {
     try {
       return {
         body: JSON.parse(bodyText),
@@ -417,6 +466,14 @@ async function readWebRequestBody(request, contentType, maxBodySize = DEFAULT_MA
     rawBody: preserveRawBody ? rawBody : undefined
   };
 }
+function isContentLengthWithinLimit(request, maxBodySize) {
+  const contentLength = request.headers.get('content-length');
+  if (contentLength === null) {
+    return false;
+  }
+  const parsedContentLength = Number(contentLength);
+  return Number.isFinite(parsedContentLength) && parsedContentLength > 0 && parsedContentLength <= maxBodySize;
+}
 async function readByteLimitedStream(stream, maxBodySize) {
   const reader = stream.getReader();
   const chunks = [];

package/package.json

@@ -9,7 +9,7 @@
     "module-graph",
     "orchestration"
   ],
-  "version": "1.0.0-beta.6",
+  "version": "1.0.0-beta.8",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -70,7 +70,7 @@
     "@fluojs/config": "^1.0.0-beta.3",
     "@fluojs/core": "^1.0.0-beta.2",
     "@fluojs/di": "^1.0.0-beta.5",
-    "@fluojs/http": "^1.0.0-beta.4"
+    "@fluojs/http": "^1.0.0-beta.6"
   },
   "devDependencies": {
     "vitest": "^3.2.4",