@fluojs/runtime 1.0.0-beta.1

package/dist/types.d.ts

@@ -0,0 +1,161 @@
+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 { BootstrapTimingDiagnostics } from './health/diagnostics.js';
+import type { PlatformComponentInput } from './platform-contract.js';
+/** Module class accepted by bootstrap and module-graph compilation helpers. */
+export type ModuleType = Constructor & {
+    definition?: ModuleDefinition;
+};
+/** Controller class discovered inside one compiled module definition. */
+export type ControllerType = Constructor;
+/** Programmatic module definition consumed by `defineModule()` and bootstrap. */
+export interface ModuleDefinition {
+    imports?: ModuleType[];
+    providers?: Provider[];
+    controllers?: ControllerType[];
+    exports?: Token[];
+    middleware?: MiddlewareLike[];
+    global?: boolean;
+}
+/** Low-level options used while compiling the runtime module graph. */
+export interface BootstrapModuleOptions {
+    duplicateProviderPolicy?: 'warn' | 'throw' | 'ignore';
+    logger?: ApplicationLogger;
+    providers?: Provider[];
+    validationTokens?: Token[];
+}
+/** Compiled module record produced by module-graph analysis. */
+export interface CompiledModule {
+    type: ModuleType;
+    definition: ModuleDefinition;
+    exportedTokens: Set<Token>;
+    providerTokens: Set<Token>;
+}
+/** Result returned by low-level bootstrap compilation helpers. */
+export interface BootstrapResult {
+    container: Container;
+    modules: CompiledModule[];
+    rootModule: ModuleType;
+}
+/** Lifecycle hook invoked after one module's providers are instantiated. */
+export interface OnModuleInit {
+    onModuleInit(): MaybePromise<void>;
+}
+/** Lifecycle hook invoked after the full application bootstrap finishes. */
+export interface OnApplicationBootstrap {
+    onApplicationBootstrap(): MaybePromise<void>;
+}
+/** Lifecycle hook invoked when one module is being torn down. */
+export interface OnModuleDestroy {
+    onModuleDestroy(): MaybePromise<void>;
+}
+/** Lifecycle hook invoked during application shutdown with the active signal. */
+export interface OnApplicationShutdown {
+    onApplicationShutdown(signal?: string): MaybePromise<void>;
+}
+/** Convenience union covering every public runtime lifecycle hook contract. */
+export type LifecycleHooks = OnModuleInit | OnApplicationBootstrap | OnModuleDestroy | OnApplicationShutdown;
+/** Logger contract used by runtime bootstrap and lifecycle diagnostics. */
+export interface ApplicationLogger {
+    debug(message: string, context?: string): void;
+    error(message: string, error?: unknown, context?: string): void;
+    log(message: string, context?: string): void;
+    warn(message: string, context?: string): void;
+}
+/** Runtime-visible application states for HTTP and microservice shells. */
+export type ApplicationState = 'bootstrapped' | 'ready' | 'closed';
+/**
+ * Called when an unhandled error escapes the request pipeline.
+ * Return a value to override the default error response, or return `undefined`
+ * to fall through to the next filter or the built-in 500 handler.
+ */
+export interface ExceptionFilterContext {
+    request: FrameworkRequest;
+    response: FrameworkResponse;
+    requestId?: string;
+}
+/** Error filter contract evaluated when a request pipeline throws. */
+export interface ExceptionFilterHandler {
+    catch(error: unknown, context: ExceptionFilterContext): MaybePromise<boolean | void>;
+}
+/** High-level bootstrap options for creating an HTTP application shell. */
+export interface BootstrapApplicationOptions {
+    adapter?: HttpApplicationAdapter;
+    /**
+     * Policy for duplicate provider tokens across modules.
+     *
+     * - `'warn'`   — log a warning but continue bootstrap (default)
+     * - `'throw'`  — throw a `DuplicateProviderError` and abort bootstrap
+     * - `'ignore'` — silently allow duplicates (last-registered wins)
+     */
+    duplicateProviderPolicy?: 'warn' | 'throw' | 'ignore';
+    /**
+     * Global exception filters, evaluated before any module/controller/handler
+     * scoped filters.  Each filter's `catch()` is called in order; the first
+     * one that returns `true` (handled) stops the chain.
+     */
+    filters?: ExceptionFilterHandler[];
+    converters?: readonly ConverterLike[];
+    interceptors?: InterceptorLike[];
+    logger?: ApplicationLogger;
+    middleware?: MiddlewareLike[];
+    observers?: RequestObserverLike[];
+    providers?: Provider[];
+    platform?: {
+        components?: readonly PlatformComponentInput[];
+    };
+    rootModule: ModuleType;
+    diagnostics?: {
+        timing?: boolean;
+    };
+    versioning?: VersioningOptions;
+}
+/** Options accepted by `FluoFactory.create(...)`. */
+export type CreateApplicationOptions = Omit<BootstrapApplicationOptions, 'rootModule'>;
+/** Options accepted by `FluoFactory.createApplicationContext(...)`. */
+export interface CreateApplicationContextOptions extends Omit<BootstrapApplicationOptions, 'adapter' | 'converters' | 'filters' | 'middleware' | 'observers' | 'rootModule'> {
+}
+/** Runtime transport contract used by microservice application shells. */
+export interface MicroserviceRuntime {
+    emit?(pattern: string, payload: unknown): MaybePromise<void>;
+    listen(): MaybePromise<void>;
+    send?(pattern: string, payload: unknown, signal?: AbortSignal): MaybePromise<unknown>;
+}
+/** Options accepted by `Application.connectMicroservice(...)`. */
+export interface CreateMicroserviceOptions extends CreateApplicationContextOptions {
+    microserviceToken?: Token<MicroserviceRuntime>;
+}
+/** Dependency-injection application shell without an HTTP listener. */
+export interface ApplicationContext {
+    readonly bootstrapTiming?: BootstrapTimingDiagnostics;
+    readonly container: Container;
+    readonly modules: CompiledModule[];
+    readonly rootModule: ModuleType;
+    close(signal?: string): Promise<void>;
+    get<T>(token: Token<T>): Promise<T>;
+}
+/** Full HTTP application shell returned by `FluoFactory.create(...)`. */
+export interface Application {
+    readonly bootstrapTiming?: BootstrapTimingDiagnostics;
+    readonly container: Container;
+    readonly modules: CompiledModule[];
+    readonly rootModule: ModuleType;
+    readonly state: ApplicationState;
+    readonly dispatcher: Dispatcher;
+    close(signal?: string): Promise<void>;
+    connectMicroservice(options?: CreateMicroserviceOptions): Promise<MicroserviceApplication>;
+    dispatch: Dispatcher['dispatch'];
+    get<T>(token: Token<T>): Promise<T>;
+    startAllMicroservices(): Promise<void>;
+    listen(): Promise<void>;
+    ready(): Promise<void>;
+}
+/** Connected microservice shell managed by an HTTP application or context. */
+export interface MicroserviceApplication extends ApplicationContext {
+    readonly state: ApplicationState;
+    emit(pattern: string, payload: unknown): Promise<void>;
+    listen(): Promise<void>;
+    send(pattern: string, payload: unknown, signal?: AbortSignal): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/web.d.ts

@@ -0,0 +1,58 @@
+import { type Dispatcher, type FrameworkRequest, type FrameworkResponse } from '@fluojs/http';
+import { type MultipartOptions, type UploadedFile } from './multipart.js';
+import { type RequestResponseFactory } from './adapters/request-response-factory.js';
+declare module '@fluojs/http' {
+    interface FrameworkRequest {
+        files?: UploadedFile[];
+        rawBody?: Uint8Array;
+    }
+}
+/**
+ * Configures Web request parsing, multipart handling, and raw body preservation.
+ */
+export interface CreateWebRequestResponseFactoryOptions {
+    maxBodySize?: number;
+    multipart?: MultipartOptions;
+    rawBody?: boolean;
+}
+/**
+ * Describes a dispatched Web request and the runtime options used to handle it.
+ */
+export interface DispatchWebRequestOptions extends CreateWebRequestResponseFactoryOptions {
+    dispatcher?: Dispatcher;
+    dispatcherNotReadyMessage?: string;
+    request: Request;
+}
+/**
+ * Represents a framework response that can be materialized as a native Web `Response`.
+ */
+export interface WebFrameworkResponse extends FrameworkResponse {
+    toResponse(): Response;
+}
+export { parseMultipart } from './multipart.js';
+/**
+ * Creates the request/response factory used by Web-standard adapters.
+ *
+ * @param options - Web parsing options for body limits, multipart handling, and raw body retention.
+ * @returns A request/response factory for Web requests and responses.
+ */
+export declare function createWebRequestResponseFactory(options?: CreateWebRequestResponseFactoryOptions): RequestResponseFactory<Request, AbortSignal | undefined, WebFrameworkResponse>;
+/**
+ * Dispatches a native Web request through the shared runtime pipeline.
+ *
+ * @param options - Dispatch configuration including the request and runtime parsing options.
+ * @returns The native Web response produced by the dispatcher.
+ */
+export declare function dispatchWebRequest({ dispatcher, dispatcherNotReadyMessage, request, ...options }: DispatchWebRequestOptions): Promise<Response>;
+/**
+ * Creates a framework request from a native Web request.
+ *
+ * @param request - Native Web request to normalize.
+ * @param signal - Abort signal propagated to the framework request.
+ * @param multipartOptions - Multipart parser options applied to multipart requests.
+ * @param maxBodySize - Maximum allowed non-multipart body size in bytes.
+ * @param preserveRawBody - Whether to retain the raw request body bytes.
+ * @returns The normalized framework request used by the dispatcher.
+ */
+export declare function createWebFrameworkRequest(request: Request, signal: AbortSignal, multipartOptions?: MultipartOptions, maxBodySize?: number, preserveRawBody?: boolean): Promise<FrameworkRequest>;
+//# sourceMappingURL=web.d.ts.map

package/dist/web.d.ts.map

@@ -0,0 +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;AAEtB,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,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;AAqLhD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,sCAA2C,GACnD,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,oBAAoB,CAAC,CA0BhF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,UAAU,EACV,yBAAiG,EACjG,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,CA6C3B"}

package/dist/web.js

@@ -0,0 +1,431 @@
+import { BadRequestException, createErrorResponse, HttpException, InternalServerErrorException, PayloadTooLargeException } from '@fluojs/http';
+import { parseMultipart } from './multipart.js';
+import { dispatchWithRequestResponseFactory } from './adapters/request-response-factory.js';
+const DEFAULT_MAX_BODY_SIZE = 1 * 1024 * 1024;
+const TEXT_ENCODER = new TextEncoder();
+const TEXT_DECODER = new TextDecoder();
+const REQUEST_BODY_LIMIT_MESSAGE = 'Request body exceeds the size limit.';
+
+/**
+ * Configures Web request parsing, multipart handling, and raw body preservation.
+ */
+
+/**
+ * Describes a dispatched Web request and the runtime options used to handle it.
+ */
+
+/**
+ * Represents a framework response that can be materialized as a native Web `Response`.
+ */
+
+export { parseMultipart } from './multipart.js';
+class WebResponseStream {
+  closeListeners = new Set();
+  controller;
+  markedActive = false;
+  markedClosed = false;
+  readable = new ReadableStream({
+    cancel: () => {
+      this.close();
+    },
+    start: controller => {
+      this.controller = controller;
+    }
+  });
+  constructor(onActivate) {
+    this.onActivate = onActivate;
+  }
+  get closed() {
+    return this.markedClosed;
+  }
+  close() {
+    this.activate();
+    if (this.markedClosed) {
+      return;
+    }
+    this.markedClosed = true;
+    this.controller?.close();
+    this.emitClose();
+  }
+  flush() {
+    this.activate();
+  }
+  onClose(listener) {
+    if (this.markedClosed) {
+      listener();
+      return () => {};
+    }
+    this.closeListeners.add(listener);
+    return () => {
+      this.closeListeners.delete(listener);
+    };
+  }
+  waitForDrain() {
+    this.activate();
+    return Promise.resolve();
+  }
+  write(chunk) {
+    this.activate();
+    if (this.markedClosed) {
+      return false;
+    }
+    this.controller?.enqueue(typeof chunk === 'string' ? TEXT_ENCODER.encode(chunk) : chunk);
+    return true;
+  }
+  activate() {
+    if (this.markedActive) {
+      return;
+    }
+    this.markedActive = true;
+    this.onActivate();
+  }
+  emitClose() {
+    for (const listener of this.closeListeners) {
+      listener();
+    }
+    this.closeListeners.clear();
+  }
+}
+class MutableWebFrameworkResponse {
+  committed = false;
+  headers = {};
+  raw;
+  statusCode;
+  statusSet;
+  finalizedResponse;
+  responseStream = new WebResponseStream(() => {
+    this.streamActive = true;
+  });
+  responseBody;
+  streamActive = false;
+  stream = this.responseStream;
+  redirect(status, location) {
+    this.setStatus(status);
+    this.setHeader('Location', location);
+    void this.send(undefined);
+  }
+  async send(body) {
+    if (this.finalizedResponse) {
+      this.committed = true;
+      return;
+    }
+    const serialized = serializeWebResponseBody(body, typeof this.headers['Content-Type'] === 'string' ? this.headers['Content-Type'] : typeof this.headers['content-type'] === 'string' ? this.headers['content-type'] : undefined);
+    if (serialized.defaultContentType && !hasHeader(this.headers, 'content-type')) {
+      this.setHeader('Content-Type', serialized.defaultContentType);
+    }
+    this.responseBody = serialized.payload;
+    this.committed = true;
+  }
+  setHeader(name, value) {
+    const existingHeaderName = findHeaderName(this.headers, name) ?? name;
+    if (name.toLowerCase() === 'set-cookie') {
+      this.headers[existingHeaderName] = mergeSetCookieHeader(this.headers[existingHeaderName], value);
+      return;
+    }
+    this.headers[existingHeaderName] = value;
+  }
+  setStatus(code) {
+    this.statusCode = code;
+    this.statusSet = true;
+  }
+  toResponse() {
+    if (!this.finalizedResponse) {
+      const init = {
+        headers: toResponseHeaders(this.headers),
+        status: this.statusCode ?? 200
+      };
+      const responseBody = this.responseBody instanceof Uint8Array ? this.responseBody.slice().buffer : this.responseBody;
+      this.finalizedResponse = this.streamActive ? new Response(this.responseStream.readable, init) : new Response(responseBody ?? '', init);
+      this.raw = this.finalizedResponse;
+      this.committed = true;
+    }
+    return this.finalizedResponse;
+  }
+}
+
+/**
+ * Creates the request/response factory used by Web-standard adapters.
+ *
+ * @param options - Web parsing options for body limits, multipart handling, and raw body retention.
+ * @returns A request/response factory for Web requests and responses.
+ */
+export function createWebRequestResponseFactory(options = {}) {
+  return {
+    async createRequest(request, signal) {
+      return await createWebFrameworkRequest(request, signal, options.multipart, options.maxBodySize ?? DEFAULT_MAX_BODY_SIZE, options.rawBody ?? false);
+    },
+    createRequestSignal(signal) {
+      return signal ?? new AbortController().signal;
+    },
+    createResponse() {
+      return new MutableWebFrameworkResponse();
+    },
+    resolveRequestId(request) {
+      return request.headers.get('x-request-id') ?? request.headers.get('x-correlation-id') ?? undefined;
+    },
+    async writeErrorResponse(error, response, requestId) {
+      const httpError = toHttpException(error);
+      response.setStatus(httpError.status);
+      await response.send(createErrorResponse(httpError, requestId));
+    }
+  };
+}
+
+/**
+ * Dispatches a native Web request through the shared runtime pipeline.
+ *
+ * @param options - Dispatch configuration including the request and runtime parsing options.
+ * @returns The native Web response produced by the dispatcher.
+ */
+export async function dispatchWebRequest({
+  dispatcher,
+  dispatcherNotReadyMessage = 'Web adapter received a request before dispatcher binding completed.',
+  request,
+  ...options
+}) {
+  const frameworkResponse = await dispatchWithRequestResponseFactory({
+    dispatcher,
+    dispatcherNotReadyMessage,
+    factory: createWebRequestResponseFactory(options),
+    rawRequest: request,
+    rawResponse: request.signal
+  });
+  return frameworkResponse.toResponse();
+}
+
+/**
+ * Creates a framework request from a native Web request.
+ *
+ * @param request - Native Web request to normalize.
+ * @param signal - Abort signal propagated to the framework request.
+ * @param multipartOptions - Multipart parser options applied to multipart requests.
+ * @param maxBodySize - Maximum allowed non-multipart body size in bytes.
+ * @param preserveRawBody - Whether to retain the raw request body bytes.
+ * @returns The normalized framework request used by the dispatcher.
+ */
+export async function createWebFrameworkRequest(request, signal, multipartOptions, maxBodySize = DEFAULT_MAX_BODY_SIZE, preserveRawBody = false) {
+  const url = new URL(request.url);
+  const headers = cloneWebHeaders(request.headers);
+  const contentType = request.headers.get('content-type') ?? undefined;
+  const isMultipart = typeof contentType === 'string' && contentType.includes('multipart/form-data');
+  let body;
+  let files;
+  let rawBody;
+  if (isMultipart) {
+    const result = await parseMultipart(request.clone(), {
+      ...multipartOptions,
+      maxTotalSize: multipartOptions?.maxTotalSize ?? maxBodySize
+    });
+    body = result.fields;
+    files = result.files;
+  } else {
+    const bodyResult = await readWebRequestBody(request.clone(), contentType, maxBodySize, preserveRawBody);
+    body = bodyResult.body;
+    rawBody = bodyResult.rawBody;
+  }
+  const frameworkRequest = {
+    body,
+    cookies: parseCookieHeader(request.headers.get('cookie') ?? undefined),
+    headers,
+    method: request.method,
+    params: {},
+    path: url.pathname,
+    query: parseQueryParams(url.searchParams),
+    raw: request,
+    signal,
+    url: url.pathname + url.search
+  };
+  if (files) {
+    frameworkRequest.files = files;
+  }
+  if (rawBody) {
+    frameworkRequest.rawBody = rawBody;
+  }
+  return frameworkRequest;
+}
+function parseQueryParams(searchParams) {
+  const query = {};
+  for (const [key, value] of searchParams.entries()) {
+    const current = query[key];
+    if (current === undefined) {
+      query[key] = value;
+      continue;
+    }
+    if (Array.isArray(current)) {
+      current.push(value);
+      continue;
+    }
+    query[key] = [current, value];
+  }
+  return query;
+}
+function cloneWebHeaders(headers) {
+  const clonedHeaders = {};
+  for (const [name, value] of headers.entries()) {
+    clonedHeaders[name] = value;
+  }
+  return clonedHeaders;
+}
+function decodeCookieValue(raw) {
+  try {
+    return decodeURIComponent(raw);
+  } catch {
+    return raw;
+  }
+}
+function parseCookieHeader(cookieHeader) {
+  if (!cookieHeader) {
+    return {};
+  }
+  return Object.fromEntries(cookieHeader.split(';').map(pair => pair.trim()).filter(Boolean).map(pair => {
+    const index = pair.indexOf('=');
+    if (index === -1) {
+      return [pair.trim(), ''];
+    }
+    return [pair.slice(0, index).trim(), decodeCookieValue(pair.slice(index + 1).trim())];
+  }));
+}
+async function readWebRequestBody(request, contentType, maxBodySize = DEFAULT_MAX_BODY_SIZE, preserveRawBody = false) {
+  const contentLength = request.headers.get('content-length');
+  if (contentLength !== null) {
+    const parsedContentLength = Number(contentLength);
+    if (Number.isFinite(parsedContentLength) && parsedContentLength > maxBodySize) {
+      throw new PayloadTooLargeException(REQUEST_BODY_LIMIT_MESSAGE);
+    }
+  }
+  if (!request.body) {
+    return {
+      body: undefined
+    };
+  }
+  const rawBody = await readByteLimitedStream(request.body, maxBodySize);
+  if (rawBody.byteLength === 0) {
+    return {
+      body: undefined
+    };
+  }
+  const bodyText = TEXT_DECODER.decode(rawBody);
+  if (bodyText.length === 0) {
+    return {
+      body: undefined,
+      rawBody: preserveRawBody ? rawBody : undefined
+    };
+  }
+  if (typeof contentType === 'string' && contentType.includes('application/json')) {
+    try {
+      return {
+        body: JSON.parse(bodyText),
+        rawBody: preserveRawBody ? rawBody : undefined
+      };
+    } catch {
+      throw new BadRequestException('Request body contains invalid JSON.');
+    }
+  }
+  return {
+    body: bodyText,
+    rawBody: preserveRawBody ? rawBody : undefined
+  };
+}
+async function readByteLimitedStream(stream, maxBodySize) {
+  const reader = stream.getReader();
+  const chunks = [];
+  let totalSize = 0;
+  try {
+    while (true) {
+      const {
+        done,
+        value
+      } = await reader.read();
+      if (done) {
+        break;
+      }
+      totalSize += value.byteLength;
+      if (totalSize > maxBodySize) {
+        await reader.cancel(REQUEST_BODY_LIMIT_MESSAGE);
+        throw new PayloadTooLargeException(REQUEST_BODY_LIMIT_MESSAGE);
+      }
+      chunks.push(value);
+    }
+  } finally {
+    reader.releaseLock();
+  }
+  return concatUint8Arrays(chunks, totalSize);
+}
+function concatUint8Arrays(chunks, totalSize) {
+  const rawBody = new Uint8Array(totalSize);
+  let offset = 0;
+  for (const chunk of chunks) {
+    rawBody.set(chunk, offset);
+    offset += chunk.byteLength;
+  }
+  return rawBody;
+}
+function mergeSetCookieHeader(current, incoming) {
+  const nextValues = Array.isArray(incoming) ? incoming : [incoming];
+  if (current === undefined) {
+    return nextValues.length === 1 ? nextValues[0] : [...nextValues];
+  }
+  const currentValues = Array.isArray(current) ? current : [current];
+  const merged = [...currentValues, ...nextValues];
+  return merged.length === 1 ? merged[0] : merged;
+}
+function findHeaderName(headers, name) {
+  const lowerName = name.toLowerCase();
+  return Object.keys(headers).find(key => key.toLowerCase() === lowerName);
+}
+function hasHeader(headers, name) {
+  return findHeaderName(headers, name) !== undefined;
+}
+function toResponseHeaders(headers) {
+  const responseHeaders = new Headers();
+  for (const [name, value] of Object.entries(headers)) {
+    if (Array.isArray(value)) {
+      for (const headerValue of value) {
+        responseHeaders.append(name, headerValue);
+      }
+      continue;
+    }
+    responseHeaders.set(name, value);
+  }
+  return responseHeaders;
+}
+function serializeWebResponseBody(body, contentType) {
+  if (body === undefined) {
+    return {
+      payload: ''
+    };
+  }
+  if (body instanceof Uint8Array) {
+    return {
+      defaultContentType: 'application/octet-stream',
+      payload: body
+    };
+  }
+  if (body instanceof ArrayBuffer) {
+    return {
+      defaultContentType: 'application/octet-stream',
+      payload: new Uint8Array(body)
+    };
+  }
+  if (typeof body === 'string') {
+    return {
+      defaultContentType: isJsonContentType(contentType) ? undefined : 'text/plain; charset=utf-8',
+      payload: isJsonContentType(contentType) ? JSON.stringify(body) : body
+    };
+  }
+  return {
+    defaultContentType: 'application/json; charset=utf-8',
+    payload: JSON.stringify(body)
+  };
+}
+function isJsonContentType(contentType) {
+  return typeof contentType === 'string' && contentType.toLowerCase().includes('application/json');
+}
+function toHttpException(error) {
+  if (error instanceof HttpException) {
+    return error;
+  }
+  return new InternalServerErrorException('Internal server error.', {
+    cause: error
+  });
+}