@fluojs/runtime 1.1.8 → 3.0.0

package/dist/types.d.ts

@@ -1,7 +1,9 @@
 import type { Constructor, MaybePromise, Token } from '@fluojs/core';
 import type { Container, Provider } from '@fluojs/di';
-import type { ConverterLike, Dispatcher, FrameworkRequest, FrameworkResponse, HttpApplicationAdapter, InterceptorLike, MiddlewareLike, RequestObserverLike, VersioningOptions } from '@fluojs/http';
+import type { ConditionalRequestOptions, ContentNegotiationOptions, ConverterLike, Dispatcher, FrameworkRequest, FrameworkResponse, HttpApplicationAdapter, HttpErrorRepresentationOptions, InterceptorLike, MiddlewareLike, RequestObserverLike, VersioningOptions } from '@fluojs/http/portable';
+import type { StudioDevtoolsRuntime } from './devtools/studio-runtime.js';
 import type { BootstrapTimingDiagnostics } from './health/diagnostics.js';
+import type { ModuleGraphCompileCache } from './module-graph.js';
 import type { PlatformComponentInput } from './platform-contract.js';
 /** Module class accepted by bootstrap and module-graph compilation helpers. */
 export type ModuleType = Constructor & {
@@ -30,9 +32,10 @@ export interface BootstrapModuleOptions {
      * The cache is disabled by default. When enabled, successful graph compiles are
      * keyed by root module identity, runtime provider inputs, validation tokens,
      * module replacement pairs, core metadata write versions, and the runtime compile algorithm version.
-     * Failed compilations are never cached.
+     * Failed compilations are never cached. Pass a {@link ModuleGraphCompileCache}
+     * to bound and dispose cache retention under the caller's ownership.
      */
-    moduleGraphCache?: boolean;
+    moduleGraphCache?: boolean | ModuleGraphCompileCache;
     /**
      * Low-level testing seam for compiling a module with replacement metadata while
      * preserving the original logical module identity in the compiled graph.
@@ -88,8 +91,8 @@ export interface ApplicationLogger {
     log(message: string, context?: string): void;
     warn(message: string, context?: string): void;
 }
-/** Registers runtime-owned cleanup callbacks that must run during bootstrap failure or shutdown. */
-export type RuntimeCleanupRegistration = (cleanup: () => void) => () => void;
+/** Registers runtime-owned cleanup callbacks that must settle during bootstrap failure or shutdown. */
+export type RuntimeCleanupRegistration = (cleanup: () => MaybePromise<void>) => () => void;
 /** Runtime-visible application states for HTTP and microservice shells. */
 export type ApplicationState = 'bootstrapped' | 'ready' | 'closed';
 /**
@@ -109,12 +112,33 @@ export interface ExceptionFilterHandler {
 /** High-level bootstrap options for creating an HTTP application shell. */
 export interface BootstrapApplicationOptions {
     adapter?: HttpApplicationAdapter;
+    /**
+     * Host-owned Studio bridge used to publish live bootstrap and request events.
+     *
+     * When omitted, runtime preserves the CLI-injected Node.js bridge behavior.
+     * Platform integrations should create this bridge from `@fluojs/runtime/devtools`
+     * instead of mutating the undocumented Studio process-global.
+     */
+    studioDevtools?: StudioDevtoolsRuntime;
+    /** Dispatcher-owned policy for HTTP validators and conditional requests. */
+    conditionalRequest?: ConditionalRequestOptions;
+    /** Application-owned HTML provider for HTTP-classified error and not-found outcomes. */
+    errorRepresentation?: HttpErrorRepresentationOptions;
+    /**
+     * Response formatter selection owned by the HTTP dispatcher.
+     *
+     * The runtime forwards this contract unchanged; `@Produces(...)`, `Accept`,
+     * success response headers, and 406 handling remain HTTP-owned.
+     */
+    contentNegotiation?: ContentNegotiationOptions;
     /**
      * Enables the opt-in process-local module graph compile result cache for this
      * bootstrap. The default is `false`, so each bootstrap compiles a fresh graph
-     * unless callers explicitly request cache reuse.
+     * unless callers explicitly request cache reuse. Pass a
+     * {@link ModuleGraphCompileCache} to retain a bounded, caller-owned cache that
+     * can be disposed with its application lifecycle.
      */
-    moduleGraphCache?: boolean;
+    moduleGraphCache?: boolean | ModuleGraphCompileCache;
     /**
      * Policy for duplicate provider tokens across modules.
      *
@@ -151,12 +175,27 @@ export interface CreateApplicationContextOptions extends Omit<BootstrapApplicati
 }
 /** Runtime transport contract used by microservice application shells. */
 export interface MicroserviceRuntime {
-    /** Release transport resources owned by the microservice runtime during shutdown. */
+    /**
+     * Releases transport resources owned by the microservice runtime during shutdown.
+     *
+     * The owning {@link MicroserviceApplication} invokes this collaborator at most
+     * once and preserves its terminal success or failure for every later shell close.
+     */
     close?(signal?: string): MaybePromise<void>;
     /** Emit a fire-and-forget message for the given transport pattern. */
     emit?(pattern: string, payload: unknown): MaybePromise<void>;
     /** Start listening for transport messages. */
     listen(): MaybePromise<void>;
+    /**
+     * Synchronously notified when the owning shell begins shutdown.
+     *
+     * Implementations that expose their own ingress admission gate must close it
+     * before the first await in this call so that new send()/emit()/listen()
+     * attempts are rejected while a racing listen() is still settling. The
+     * owning shell caches its terminal close result before invoking this callback,
+     * and the terminal gate must stay closed even if close() later rejects.
+     */
+    markShutdownStarted?(): void;
     /** Send a request/response message for the given transport pattern. */
     send?(pattern: string, payload: unknown, signal?: AbortSignal): MaybePromise<unknown>;
 }
@@ -170,6 +209,7 @@ export interface ApplicationContext {
     readonly container: Container;
     readonly modules: CompiledModule[];
     readonly rootModule: ModuleType;
+    /** Closes the shell and retries incomplete teardown after a failed close. */
     close(signal?: string): Promise<void>;
     get<T>(token: Token<T>): Promise<T>;
 }
@@ -192,6 +232,11 @@ export interface Application {
 /** Connected microservice shell managed by an HTTP application or context. */
 export interface MicroserviceApplication extends ApplicationContext {
     readonly state: ApplicationState;
+    /**
+     * Closes the microservice shell once; later calls share its terminal success
+     * or failure result without re-invoking shutdown collaborators.
+     */
+    close(signal?: string): Promise<void>;
     emit(pattern: string, payload: unknown): Promise<void>;
     listen(): Promise<void>;
     send(pattern: string, payload: unknown, signal?: AbortSignal): Promise<unknown>;

package/dist/types.d.ts.map

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

package/dist/web.d.ts

@@ -1,12 +1,6 @@
-import { type Dispatcher, type FrameworkRequest, type FrameworkResponse } from '@fluojs/http';
-import { type MultipartOptions, type UploadedFile } from './multipart.js';
+import { type Dispatcher, type FrameworkRequest, type FrameworkResponse } from '@fluojs/http/portable';
 import { type RequestResponseFactory } from './adapters/request-response-factory.js';
-declare module '@fluojs/http' {
-    interface FrameworkRequest {
-        files?: UploadedFile[];
-        rawBody?: Uint8Array;
-    }
-}
+import { type MultipartOptions } from './multipart.js';
 /**
  * Configures Web request parsing, multipart handling, and raw body preservation.
  */
@@ -14,6 +8,10 @@ export interface CreateWebRequestResponseFactoryOptions {
     consumeOriginalBody?: boolean;
     maxBodySize?: number;
     multipart?: MultipartOptions;
+    /**
+     * @deprecated Retained for adapter compatibility. Web JSON bodies always use the bounded streaming reader,
+     * so this option no longer changes request parsing.
+     */
     preferNativeJsonBodyReader?: boolean;
     rawBody?: boolean;
 }
@@ -35,9 +33,17 @@ export interface DispatchWebRequestOptions extends CreateWebRequestResponseFacto
  * Represents a framework response that can be materialized as a native Web `Response`.
  */
 export interface WebFrameworkResponse extends FrameworkResponse {
+    /** @internal Optional early response signal provided by the built-in Web response facade. */
+    readonly responseReady?: Promise<Response>;
     toResponse(): Response;
 }
-export { parseMultipart } from './multipart.js';
+/** Native Web response materialization and long-lived request lifecycle signals. */
+export interface WebRequestDispatch {
+    readonly completion: Promise<void>;
+    readonly response: Promise<Response>;
+}
+export { MultipartBodyConsumedError, parseMultipart, parseMultipartStream, } from './multipart.js';
+export type { MultipartFieldPart, MultipartFilePart, MultipartPart, } from './multipart.js';
 /**
  * Creates the request/response factory used by Web-standard adapters.
  *
@@ -52,6 +58,13 @@ export declare function createWebRequestResponseFactory(options?: CreateWebReque
  * @returns The native Web response produced by the dispatcher.
  */
 export declare function dispatchWebRequest({ dispatcher, dispatcherNotReadyMessage, factory, request, ...options }: DispatchWebRequestOptions): Promise<Response>;
+/**
+ * Starts a native Web request dispatch without coupling streaming response materialization to lifecycle completion.
+ *
+ * @param options - Dispatch configuration including the request and runtime parsing options.
+ * @returns The native response signal and independently settling request lifecycle signal.
+ */
+export declare function startWebRequestDispatch({ dispatcher, dispatcherNotReadyMessage, factory, request, ...options }: DispatchWebRequestOptions): WebRequestDispatch;
 /**
  * Creates a framework request from a native Web request.
  *

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,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"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAIvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,wCAAwC,CAAC;AAKhD,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,gBAAgB,CAAC;AAOxB;;GAEG;AACH,MAAM,WAAW,sCAAsC;IACrD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,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,6FAA6F;IAC7F,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C,UAAU,IAAI,QAAQ,CAAC;CACxB;AAED,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtC;AAED,OAAO,EACL,0BAA0B,EAC1B,cAAc,EACd,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAwNxB;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,sCAA2C,GACnD,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,oBAAoB,CAAC,CAgChF;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,CAQ/C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,UAAU,EACV,yBAAiG,EACjG,OAAO,EACP,OAAO,EACP,GAAG,OAAO,EACX,EAAE,yBAAyB,GAAG,kBAAkB,CAoBhD;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,CAY3B"}

package/dist/web.js

@@ -1,7 +1,7 @@
-import { BadRequestException, createErrorResponse, HttpException, InternalServerErrorException, PayloadTooLargeException } from '@fluojs/http';
+import { BadRequestException, createErrorResponse, HttpException, InternalServerErrorException, PayloadTooLargeException } from '@fluojs/http/portable';
+import { startDispatchWithRequestResponseFactory } from './adapters/request-response-factory.js';
 import { attachRuntimeFrameworkRequestNativeRouteHandoff, consumeRuntimeRawRequestNativeRouteHandoff } from './internal/http-runtime.js';
-import { parseMultipart } from './multipart.js';
-import { dispatchWithRequestResponseFactory } from './adapters/request-response-factory.js';
+import { markMultipartBodyConsumed, parseMultipart, parseMultipartStream } from './multipart.js';
 const DEFAULT_MAX_BODY_SIZE = 1 * 1024 * 1024;
 const TEXT_ENCODER = new TextEncoder();
 const TEXT_DECODER = new TextDecoder();
@@ -19,7 +19,9 @@ const REQUEST_BODY_LIMIT_MESSAGE = 'Request body exceeds the size limit.';
  * Represents a framework response that can be materialized as a native Web `Response`.
  */
 
-export { parseMultipart } from './multipart.js';
+/** Native Web response materialization and long-lived request lifecycle signals. */
+
+export { MultipartBodyConsumedError, parseMultipart, parseMultipartStream } from './multipart.js';
 class WebResponseStream {
   closeListeners = new Set();
   controller;
@@ -27,7 +29,7 @@ class WebResponseStream {
   markedClosed = false;
   readable = new ReadableStream({
     cancel: () => {
-      this.close();
+      this.close(true);
     },
     start: controller => {
       this.controller = controller;
@@ -39,13 +41,15 @@ class WebResponseStream {
   get closed() {
     return this.markedClosed;
   }
-  close() {
+  close(closedByConsumer = false) {
     this.activate();
     if (this.markedClosed) {
       return;
     }
     this.markedClosed = true;
-    this.controller?.close();
+    if (!closedByConsumer) {
+      this.controller?.close();
+    }
     this.emitClose();
   }
   flush() {
@@ -94,9 +98,13 @@ class MutableWebFrameworkResponse {
   statusCode;
   statusSet;
   finalizedResponse;
+  resolveResponseReady = () => undefined;
   responseStream;
   responseBody;
   streamActive = false;
+  responseReady = new Promise(resolve => {
+    this.resolveResponseReady = resolve;
+  });
   get stream() {
     return this.getOrCreateResponseStream();
   }
@@ -150,12 +158,14 @@ class MutableWebFrameworkResponse {
       this.finalizedResponse = this.streamActive ? new Response(this.getOrCreateResponseStream().readable, init) : new Response(nativeResponseBody, init);
       this.raw = this.finalizedResponse;
       this.committed = true;
+      this.resolveResponseReady(this.finalizedResponse);
     }
     return this.finalizedResponse;
   }
   getOrCreateResponseStream() {
     this.responseStream ??= new WebResponseStream(() => {
       this.streamActive = true;
+      this.toResponse();
     });
     return this.responseStream;
   }
@@ -168,9 +178,10 @@ class MutableWebFrameworkResponse {
  * @returns A request/response factory for Web requests and responses.
  */
 export function createWebRequestResponseFactory(options = {}) {
+  const maxBodySize = resolveWebMaxBodySize(options.maxBodySize);
   return {
     async createRequest(request, signal) {
-      return createDeferredWebFrameworkRequest(request, signal, options.multipart, options.maxBodySize ?? DEFAULT_MAX_BODY_SIZE, options.rawBody ?? false, options.preferNativeJsonBodyReader ?? false, options.consumeOriginalBody ?? false);
+      return createDeferredWebFrameworkRequest(request, signal, options.multipart, maxBodySize, options.rawBody ?? false, options.consumeOriginalBody ?? false);
     },
     materializeRequest(request) {
       return materializeWebFrameworkRequestBody(request);
@@ -205,14 +216,40 @@ export async function dispatchWebRequest({
   request,
   ...options
 }) {
-  const frameworkResponse = await dispatchWithRequestResponseFactory({
+  return await startWebRequestDispatch({
+    dispatcher,
+    dispatcherNotReadyMessage,
+    factory,
+    request,
+    ...options
+  }).response;
+}
+
+/**
+ * Starts a native Web request dispatch without coupling streaming response materialization to lifecycle completion.
+ *
+ * @param options - Dispatch configuration including the request and runtime parsing options.
+ * @returns The native response signal and independently settling request lifecycle signal.
+ */
+export function startWebRequestDispatch({
+  dispatcher,
+  dispatcherNotReadyMessage = 'Web adapter received a request before dispatcher binding completed.',
+  factory,
+  request,
+  ...options
+}) {
+  const dispatch = startDispatchWithRequestResponseFactory({
     dispatcher,
     dispatcherNotReadyMessage,
     factory: factory ?? createWebRequestResponseFactory(options),
     rawRequest: request,
     rawResponse: request.signal
   });
-  return frameworkResponse.toResponse();
+  const responseReady = dispatch.response.responseReady;
+  return {
+    completion: dispatch.completion.then(() => undefined),
+    response: responseReady ? Promise.race([responseReady, dispatch.completion.then(frameworkResponse => frameworkResponse.toResponse())]) : dispatch.completion.then(frameworkResponse => frameworkResponse.toResponse())
+  };
 }
 
 /**
@@ -226,7 +263,8 @@ export async function dispatchWebRequest({
  * @returns The normalized framework request used by the dispatcher.
  */
 export async function createWebFrameworkRequest(request, signal, multipartOptions, maxBodySize = DEFAULT_MAX_BODY_SIZE, preserveRawBody = false) {
-  const frameworkRequest = createDeferredWebFrameworkRequest(request, signal, multipartOptions, maxBodySize, preserveRawBody);
+  const resolvedMaxBodySize = resolveWebMaxBodySize(maxBodySize);
+  const frameworkRequest = createDeferredWebFrameworkRequest(request, signal, multipartOptions, resolvedMaxBodySize, preserveRawBody);
   await materializeWebFrameworkRequestBody(frameworkRequest);
   return frameworkRequest;
 }
@@ -241,7 +279,7 @@ 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, preferNativeJsonBodyReader = false, consumeOriginalBody = false) {
+function createDeferredWebFrameworkRequest(request, signal, multipartOptions, maxBodySize = DEFAULT_MAX_BODY_SIZE, preserveRawBody = false, consumeOriginalBody = false) {
   const url = new URL(request.url);
   const requestHeaders = new Headers(request.headers);
   const method = request.method;
@@ -253,11 +291,23 @@ function createDeferredWebFrameworkRequest(request, signal, multipartOptions, ma
   const hasRequestBody = request.body !== null;
   const materializeBody = hasRequestBody ? createMemoizedAsyncValue(async () => {
     if (isMultipart) {
-      const materializedRequest = request.clone();
-      const result = await parseMultipart(createRequestWithSnapshotMetadata(materializedRequest, request.url, method, requestHeaders), {
+      const resolvedMultipartOptions = {
         ...multipartOptions,
         maxTotalSize: multipartOptions?.maxTotalSize ?? maxBodySize
-      });
+      };
+      if (multipartOptions?.strategy === 'stream') {
+        frameworkRequest.body = parseMultipartStream({
+          body: request.body,
+          headers: requestHeaders,
+          method,
+          signal,
+          url: request.url
+        }, resolvedMultipartOptions);
+        return;
+      }
+      const materializedRequest = request.clone();
+      markMultipartBodyConsumed(request);
+      const result = await parseMultipart(createRequestWithSnapshotMetadata(materializedRequest, request.url, method, requestHeaders), resolvedMultipartOptions);
       frameworkRequest.body = result.fields;
       frameworkRequest.files = result.files;
       return;
@@ -268,7 +318,7 @@ function createDeferredWebFrameworkRequest(request, signal, multipartOptions, ma
       return;
     }
     const requestToRead = consumeOriginalBody ? request : request.clone();
-    const bodyResult = await readWebRequestBody(requestToRead, contentType, maxBodySize, preserveRawBody, preferNativeJsonBodyReader);
+    const bodyResult = await readWebRequestBody(requestToRead, contentType, maxBodySize, preserveRawBody);
     frameworkRequest.body = bodyResult.body;
     if (bodyResult.rawBody) {
       frameworkRequest.rawBody = bodyResult.rawBody;
@@ -302,7 +352,8 @@ function createDeferredWebFrameworkRequest(request, signal, multipartOptions, ma
 function createRequestWithSnapshotMetadata(request, url, method, headers) {
   const init = {
     headers: new Headers(headers),
-    method
+    method,
+    signal: request.signal
   };
   if (request.body) {
     init.body = request.body;
@@ -320,6 +371,13 @@ function validateWebRequestContentLength(request, maxBodySize) {
     throw new PayloadTooLargeException(REQUEST_BODY_LIMIT_MESSAGE);
   }
 }
+function resolveWebMaxBodySize(value) {
+  const maxBodySize = value ?? DEFAULT_MAX_BODY_SIZE;
+  if (!Number.isInteger(maxBodySize) || maxBodySize < 0) {
+    throw new Error(`Invalid maxBodySize value: ${String(maxBodySize)}. Expected a non-negative integer number of bytes.`);
+  }
+  return maxBodySize;
+}
 
 /**
  * Materializes a deferred Web framework request body exactly once.
@@ -422,20 +480,13 @@ 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, preferNativeJsonBodyReader = false) {
+async function readWebRequestBody(request, contentType, maxBodySize = DEFAULT_MAX_BODY_SIZE, preserveRawBody = false) {
   validateWebRequestContentLength(request, maxBodySize);
   if (!request.body) {
     return {
       body: undefined
     };
   }
-  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) {
@@ -466,14 +517,6 @@ function parseWebRequestRawBody(rawBody, contentType, preserveRawBody) {
     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 = [];
@@ -489,7 +532,10 @@ async function readByteLimitedStream(stream, maxBodySize) {
       }
       totalSize += value.byteLength;
       if (totalSize > maxBodySize) {
-        await reader.cancel(REQUEST_BODY_LIMIT_MESSAGE);
+        const cancellation = new Promise((resolve, reject) => {
+          void reader.cancel(REQUEST_BODY_LIMIT_MESSAGE).then(resolve, reject);
+        });
+        void Promise.allSettled([cancellation]);
         throw new PayloadTooLargeException(REQUEST_BODY_LIMIT_MESSAGE);
       }
       chunks.push(value);

package/package.json

@@ -9,7 +9,7 @@
     "module-graph",
     "orchestration"
   ],
-  "version": "1.1.8",
+  "version": "3.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -17,9 +17,6 @@
     "url": "https://github.com/fluojs/fluo.git",
     "directory": "packages/runtime"
   },
-  "engines": {
-    "node": ">=20.0.0"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -27,16 +24,17 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./node": {
-      "types": "./dist/node.d.ts",
-      "import": "./dist/node.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./web": {
       "types": "./dist/web.d.ts",
       "import": "./dist/web.js"
     },
+    "./devtools": {
+      "types": "./dist/devtools/index.d.ts",
+      "import": "./dist/devtools/index.js"
+    },
     "./internal": {
       "types": "./dist/internal.d.ts",
       "import": "./dist/internal.js"
@@ -48,33 +46,22 @@
     "./internal/request-response-factory": {
       "types": "./dist/internal-request-response-factory.d.ts",
       "import": "./dist/internal-request-response-factory.js"
-    },
-    "./internal-node": {
-      "types": "./dist/internal-node.d.ts",
-      "import": "./dist/internal-node.js"
     }
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "internal-node": [
-        "./dist/internal-node.d.ts"
-      ]
-    }
-  },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@fluojs/config": "^1.0.3",
-    "@fluojs/core": "^1.0.3",
-    "@fluojs/di": "^1.1.0",
-    "@fluojs/http": "^1.1.2"
+    "@fluojs/core": "^2.0.0",
+    "@fluojs/di": "^3.0.0",
+    "@fluojs/http": "^3.0.0",
+    "@fluojs/studio": "^2.0.0"
   },
   "devDependencies": {
-    "vitest": "^3.2.4",
-    "@fluojs/serialization": "^1.0.4"
+    "vitest": "^4.1.11",
+    "@fluojs/serialization": "^2.0.0"
   },
   "scripts": {
     "prebuild": "node ../../tooling/scripts/clean-dist.mjs",

package/dist/internal-node.d.ts

@@ -1,2 +0,0 @@
-export * from './node/internal-node.js';
-//# sourceMappingURL=internal-node.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"internal-node.d.ts","sourceRoot":"","sources":["../src/internal-node.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/internal-node.js

@@ -1 +0,0 @@
-export * from './node/internal-node.js';

package/dist/logging/json-logger.d.ts

@@ -1,8 +0,0 @@
-import type { ApplicationLogger } from '../types.js';
-/**
- * Create json application logger.
- *
- * @returns The create json application logger result.
- */
-export declare function createJsonApplicationLogger(): ApplicationLogger;
-//# sourceMappingURL=json-logger.d.ts.map

package/dist/logging/json-logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"json-logger.d.ts","sourceRoot":"","sources":["../../src/logging/json-logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAqCrD;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,iBAAiB,CAe/D"}

package/dist/logging/json-logger.js

@@ -1,45 +0,0 @@
-import { getCurrentRequestContext } from '@fluojs/http';
-function buildEntry(level, message, context, error) {
-  const entry = {
-    level,
-    message,
-    timestamp: new Date().toISOString()
-  };
-  const requestId = getCurrentRequestContext()?.requestId;
-  if (requestId) {
-    entry.requestId = requestId;
-  }
-  if (context) {
-    entry.context = context;
-  }
-  if (error instanceof Error) {
-    entry.error = {
-      message: error.message,
-      name: error.name,
-      stack: error.stack
-    };
-  }
-  return entry;
-}
-
-/**
- * Create json application logger.
- *
- * @returns The create json application logger result.
- */
-export function createJsonApplicationLogger() {
-  return {
-    debug(message, context) {
-      process.stdout.write(JSON.stringify(buildEntry('debug', message, context)) + '\n');
-    },
-    error(message, error, context) {
-      process.stderr.write(JSON.stringify(buildEntry('error', message, context, error)) + '\n');
-    },
-    log(message, context) {
-      process.stdout.write(JSON.stringify(buildEntry('log', message, context)) + '\n');
-    },
-    warn(message, context) {
-      process.stderr.write(JSON.stringify(buildEntry('warn', message, context)) + '\n');
-    }
-  };
-}