@fluojs/runtime 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/module-graph.js

@@ -1,4 +1,4 @@
-import { getClassDiMetadata, getModuleMetadata, getOwnClassDiMetadata } from '@fluojs/core/internal';
+import { getClassDiMetadata, getClassDiMetadataVersion, getModuleMetadata, getModuleMetadataVersion, getOwnClassDiMetadata } from '@fluojs/core/internal';
 import { ModuleGraphError, ModuleInjectionMetadataError, ModuleVisibilityError } from './errors.js';
 /**
  * Returns the public token represented by a provider declaration.
@@ -12,6 +12,280 @@ export function providerToken(provider) {
   }
   return provider.provide;
 }
+const objectTokenIds = new WeakMap();
+const symbolTokenIds = new Map();
+let nextTokenId = 0;
+const MODULE_GRAPH_COMPILE_ALGORITHM_VERSION = 1;
+const moduleGraphCompileCache = new Map();
+
+/** Clears the process-local module graph compile cache for isolated regression tests. */
+export function clearModuleGraphCompileCacheForTesting() {
+  moduleGraphCompileCache.clear();
+}
+
+/**
+ * Reads the current process-local module graph compile cache size for tests.
+ *
+ * @returns Number of successful compile snapshots currently retained in the cache.
+ */
+export function getModuleGraphCompileCacheSizeForTesting() {
+  return moduleGraphCompileCache.size;
+}
+function getFunctionTokenId(token) {
+  const existing = objectTokenIds.get(token);
+  if (existing !== undefined) {
+    return existing;
+  }
+  nextTokenId += 1;
+  objectTokenIds.set(token, nextTokenId);
+  return nextTokenId;
+}
+function getSymbolTokenId(token) {
+  const existing = symbolTokenIds.get(token);
+  if (existing !== undefined) {
+    return existing;
+  }
+  nextTokenId += 1;
+  symbolTokenIds.set(token, nextTokenId);
+  return nextTokenId;
+}
+function describeTokenForCacheKey(token) {
+  if (typeof token === 'function') {
+    return `fn:${getFunctionTokenId(token)}`;
+  }
+  if (typeof token === 'symbol') {
+    return `sym:${getSymbolTokenId(token)}`;
+  }
+  return `str:${JSON.stringify(token)}`;
+}
+function describeInjectionTokenForCacheKey(token) {
+  if (isForwardRef(token)) {
+    return `forward:${describeTokenForCacheKey(token.forwardRef())}`;
+  }
+  if (isOptionalToken(token)) {
+    return `optional:${describeTokenForCacheKey(token.token)}`;
+  }
+  return describeTokenForCacheKey(token);
+}
+function describeProviderForCacheKey(provider) {
+  if (typeof provider === 'function') {
+    return `class:${describeTokenForCacheKey(provider)}`;
+  }
+  const provide = describeTokenForCacheKey(provider.provide);
+  const multi = 'multi' in provider && provider.multi === true ? 'multi' : 'single';
+  if ('useClass' in provider) {
+    const inject = provider.inject?.map(describeInjectionTokenForCacheKey).join(',') ?? '';
+    return `useClass:${provide}:${describeTokenForCacheKey(provider.useClass)}:${provider.scope ?? ''}:${multi}:${inject}`;
+  }
+  if ('useFactory' in provider) {
+    const inject = provider.inject?.map(describeInjectionTokenForCacheKey).join(',') ?? '';
+    const resolverClass = provider.resolverClass ? describeTokenForCacheKey(provider.resolverClass) : '';
+    return `useFactory:${provide}:${getFunctionTokenId(provider.useFactory)}:${resolverClass}:${provider.scope ?? ''}:${multi}:${inject}`;
+  }
+  if ('useExisting' in provider) {
+    return `useExisting:${provide}:${describeTokenForCacheKey(provider.useExisting)}`;
+  }
+  return `useValue:${provide}:${multi}`;
+}
+
+/**
+ * Builds the key used for opt-in module graph compile caching.
+ *
+ * @param rootModule Root module that would be compiled.
+ * @param options Bootstrap options that influence graph validation.
+ * @returns Process-local key that changes when metadata or runtime validation inputs change.
+ */
+export function createModuleGraphCacheKey(rootModule, options = {}) {
+  const runtimeProviders = (options.providers ?? []).map(describeProviderForCacheKey).join('|');
+  const validationTokens = (options.validationTokens ?? []).map(describeTokenForCacheKey).join('|');
+  return [`root:${describeTokenForCacheKey(rootModule)}`, `module:${getModuleMetadataVersion()}`, `class-di:${getClassDiMetadataVersion()}`, `algorithm:${MODULE_GRAPH_COMPILE_ALGORITHM_VERSION}`, `runtime:${runtimeProviders}`, `validation:${validationTokens}`].join(';');
+}
+function cloneModuleDefinition(definition) {
+  return {
+    global: definition.global,
+    imports: definition.imports ? [...definition.imports] : undefined,
+    providers: definition.providers ? definition.providers.map(provider => cloneProvider(provider)) : undefined,
+    controllers: definition.controllers ? [...definition.controllers] : undefined,
+    exports: definition.exports ? [...definition.exports] : undefined,
+    middleware: definition.middleware ? definition.middleware.map(middleware => cloneMutableValue(middleware)) : undefined
+  };
+}
+function cloneMutableValue(value, clones = new WeakMap()) {
+  if (typeof value !== 'object' || value === null) {
+    return value;
+  }
+  const existing = clones.get(value);
+  if (existing !== undefined) {
+    return existing;
+  }
+  if (value instanceof Date) {
+    return new Date(value);
+  }
+  if (value instanceof RegExp) {
+    return new RegExp(value);
+  }
+  if (Array.isArray(value)) {
+    const clonedArray = [];
+    clones.set(value, clonedArray);
+    for (const item of value) {
+      clonedArray.push(cloneMutableValue(item, clones));
+    }
+    return clonedArray;
+  }
+  if (value instanceof Map) {
+    const clonedMap = new Map();
+    clones.set(value, clonedMap);
+    for (const [key, entryValue] of value) {
+      clonedMap.set(cloneMutableValue(key, clones), cloneMutableValue(entryValue, clones));
+    }
+    return clonedMap;
+  }
+  if (value instanceof Set) {
+    const clonedSet = new Set();
+    clones.set(value, clonedSet);
+    for (const entryValue of value) {
+      clonedSet.add(cloneMutableValue(entryValue, clones));
+    }
+    return clonedSet;
+  }
+  const source = value;
+  const prototype = Object.getPrototypeOf(value);
+  const clonedObject = Object.create(prototype);
+  clones.set(value, clonedObject);
+  for (const key of Reflect.ownKeys(source)) {
+    clonedObject[key] = cloneMutableValue(source[key], clones);
+  }
+  return clonedObject;
+}
+function cloneInjectionToken(token) {
+  if (isForwardRef(token)) {
+    return {
+      __forwardRef__: true,
+      forwardRef: token.forwardRef
+    };
+  }
+  if (isOptionalToken(token)) {
+    return {
+      __optional__: true,
+      token: token.token
+    };
+  }
+  return token;
+}
+function cloneProvider(provider) {
+  if (typeof provider === 'function') {
+    return provider;
+  }
+  if ('useClass' in provider) {
+    return {
+      ...provider,
+      ...(provider.inject ? {
+        inject: provider.inject.map(token => cloneInjectionToken(token))
+      } : {})
+    };
+  }
+  if ('useFactory' in provider) {
+    return {
+      ...provider,
+      ...(provider.inject ? {
+        inject: provider.inject.map(token => cloneInjectionToken(token))
+      } : {})
+    };
+  }
+  if ('useValue' in provider) {
+    return {
+      ...provider,
+      useValue: cloneMutableValue(provider.useValue)
+    };
+  }
+  return {
+    ...provider
+  };
+}
+function cloneCompiledModule(compiledModule) {
+  return {
+    type: compiledModule.type,
+    definition: cloneModuleDefinition(compiledModule.definition),
+    accessibleTokens: new Set(compiledModule.accessibleTokens),
+    exportedTokens: new Set(compiledModule.exportedTokens),
+    importedExportedTokens: new Set(compiledModule.importedExportedTokens),
+    providerTokens: new Set(compiledModule.providerTokens)
+  };
+}
+function cloneCompiledModules(modules) {
+  return modules.map(compiledModule => cloneCompiledModule(compiledModule));
+}
+function freezeInjectionToken(token) {
+  if (isForwardRef(token) || isOptionalToken(token)) {
+    Object.freeze(token);
+  }
+  return token;
+}
+function freezeMutableValue(value, frozen = new WeakSet()) {
+  if (typeof value !== 'object' || value === null || frozen.has(value)) {
+    return value;
+  }
+  frozen.add(value);
+  if (value instanceof Map) {
+    for (const [key, entryValue] of value) {
+      freezeMutableValue(key, frozen);
+      freezeMutableValue(entryValue, frozen);
+    }
+  } else if (value instanceof Set) {
+    for (const entryValue of value) {
+      freezeMutableValue(entryValue, frozen);
+    }
+  } else {
+    const source = value;
+    for (const key of Reflect.ownKeys(source)) {
+      freezeMutableValue(source[key], frozen);
+    }
+  }
+  Object.freeze(value);
+  return value;
+}
+function freezeProvider(provider) {
+  if (typeof provider === 'function') {
+    return provider;
+  }
+  if ('inject' in provider && provider.inject) {
+    for (const token of provider.inject) {
+      freezeInjectionToken(token);
+    }
+    Object.freeze(provider.inject);
+  }
+  if ('useValue' in provider) {
+    freezeMutableValue(provider.useValue);
+  }
+  return Object.freeze(provider);
+}
+function freezeMiddleware(middleware) {
+  if (typeof middleware === 'object' && middleware !== null) {
+    freezeMutableValue(middleware);
+  }
+  return middleware;
+}
+function freezeModuleDefinition(definition) {
+  definition.imports && Object.freeze(definition.imports);
+  for (const provider of definition.providers ?? []) {
+    freezeProvider(provider);
+  }
+  definition.providers && Object.freeze(definition.providers);
+  definition.controllers && Object.freeze(definition.controllers);
+  definition.exports && Object.freeze(definition.exports);
+  for (const middleware of definition.middleware ?? []) {
+    freezeMiddleware(middleware);
+  }
+  definition.middleware && Object.freeze(definition.middleware);
+  return Object.freeze(definition);
+}
+function freezeCompiledModule(compiledModule) {
+  freezeModuleDefinition(compiledModule.definition);
+  return Object.freeze(compiledModule);
+}
+function createModuleGraphCacheSnapshot(modules) {
+  return Object.freeze(cloneCompiledModules(modules).map(compiledModule => freezeCompiledModule(compiledModule)));
+}
 function getEffectiveClassDiMetadata(target) {
   const metadata = getClassDiMetadata(target);
   if (!metadata) {
@@ -132,7 +406,9 @@ function compileModule(moduleType, runtimeProviderTokens, compiled = new Map(),
   const compiledModule = {
     type: moduleType,
     definition,
+    accessibleTokens: new Set(),
     exportedTokens: new Set(),
+    importedExportedTokens: new Set(),
     providerTokens
   };
   compiled.set(moduleType, compiledModule);
@@ -154,11 +430,21 @@ function resolveImportedModules(compiledModule, compiledByType) {
   });
 }
 function createImportedExportedTokenSet(importedModules) {
-  return new Set(importedModules.flatMap(imported => Array.from(imported.exportedTokens)));
+  const importedExportedTokens = new Set();
+  for (const importedModule of importedModules) {
+    for (const token of importedModule.exportedTokens) {
+      importedExportedTokens.add(token);
+    }
+  }
+  return importedExportedTokens;
 }
 function createAccessibleTokenSet(runtimeProviderTokens, moduleProviderTokens, importedExportedTokens, globalExportedTokens) {
   return new Set([...runtimeProviderTokens, ...moduleProviderTokens, ...importedExportedTokens, ...globalExportedTokens]);
 }
+function memoizeAccessibleTokenSet(compiledModule, importedModules, runtimeProviderTokens, globalExportedTokens) {
+  compiledModule.importedExportedTokens = createImportedExportedTokenSet(importedModules);
+  compiledModule.accessibleTokens = createAccessibleTokenSet(runtimeProviderTokens, compiledModule.providerTokens, compiledModule.importedExportedTokens, globalExportedTokens);
+}
 function validateProviderVisibility(compiledModule, scope, accessibleTokens) {
   for (const provider of compiledModule.definition.providers ?? []) {
     validateProviderInjectionMetadata(provider, scope);
@@ -222,12 +508,10 @@ function validateCompiledModules(modules, runtimeProviders, runtimeProviderToken
   }
   for (const compiledModule of modules) {
     const scope = `module ${compiledModule.type.name}`;
-    const importedModules = resolveImportedModules(compiledModule, compiledByType);
-    const importedExportedTokens = createImportedExportedTokenSet(importedModules);
-    const accessibleTokens = createAccessibleTokenSet(runtimeProviderTokens, compiledModule.providerTokens, importedExportedTokens, globalExportedTokens);
-    validateProviderVisibility(compiledModule, scope, accessibleTokens);
-    validateControllerVisibility(compiledModule, scope, accessibleTokens);
-    compiledModule.exportedTokens = createExportedTokenSet(compiledModule, importedExportedTokens);
+    memoizeAccessibleTokenSet(compiledModule, resolveImportedModules(compiledModule, compiledByType), runtimeProviderTokens, globalExportedTokens);
+    validateProviderVisibility(compiledModule, scope, compiledModule.accessibleTokens);
+    validateControllerVisibility(compiledModule, scope, compiledModule.accessibleTokens);
+    compiledModule.exportedTokens = createExportedTokenSet(compiledModule, compiledModule.importedExportedTokens);
   }
 }
 
@@ -239,10 +523,22 @@ function validateCompiledModules(modules, runtimeProviders, runtimeProviderToken
  * @returns Compiled modules in dependency order after visibility and injection validation succeed.
  */
 export function compileModuleGraph(rootModule, options = {}) {
+  const cacheKey = options.moduleGraphCache === true ? createModuleGraphCacheKey(rootModule, options) : undefined;
+  if (cacheKey !== undefined) {
+    const cachedModules = moduleGraphCompileCache.get(cacheKey);
+    if (cachedModules !== undefined) {
+      return cloneCompiledModules(cachedModules);
+    }
+  }
   const ordered = [];
   const runtimeProviders = options.providers ?? [];
   const runtimeProviderTokens = mergeRuntimeTokenSets(runtimeProviders, options.validationTokens ?? []);
   compileModule(rootModule, runtimeProviderTokens, new Map(), new Set(), ordered);
   validateCompiledModules(ordered, runtimeProviders, runtimeProviderTokens);
+  if (cacheKey !== undefined) {
+    const cacheSnapshot = createModuleGraphCacheSnapshot(ordered);
+    moduleGraphCompileCache.set(cacheKey, cacheSnapshot);
+    return cloneCompiledModules(cacheSnapshot);
+  }
   return ordered;
 }

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

@@ -1,7 +1,22 @@
 import type { ServerResponse } from 'node:http';
 import type { FrameworkResponseCompression } from '@fluojs/http';
 type Encoding = 'br' | 'gzip' | 'identity';
+/**
+ * Create node response compression.
+ *
+ * @param response The response.
+ * @param acceptEncoding The accept encoding.
+ * @returns The create node response compression result.
+ */
 export declare function createNodeResponseCompression(response: ServerResponse, acceptEncoding: string | undefined): FrameworkResponseCompression | undefined;
+/**
+ * Compress node response.
+ *
+ * @param response The response.
+ * @param body The body.
+ * @param encoding The encoding.
+ * @returns The compress node response result.
+ */
 export declare function compressNodeResponse(response: ServerResponse, body: Uint8Array, encoding: Exclude<Encoding, 'identity'>): Promise<void>;
 export {};
 //# sourceMappingURL=internal-node-compression.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"internal-node-compression.d.ts","sourceRoot":"","sources":["../../src/node/internal-node-compression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,KAAK,EACV,4BAA4B,EAE7B,MAAM,cAAc,CAAC;AAiBtB,KAAK,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC;AAE3C,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,4BAA4B,GAAG,SAAS,CAqB1C;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf"}
+{"version":3,"file":"internal-node-compression.d.ts","sourceRoot":"","sources":["../../src/node/internal-node-compression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,KAAK,EACV,4BAA4B,EAE7B,MAAM,cAAc,CAAC;AAiBtB,KAAK,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,4BAA4B,GAAG,SAAS,CAqB1C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC,CAcf"}

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

@@ -1,6 +1,13 @@
 import { createBrotliCompress, createGzip } from 'node:zlib';
 const COMPRESS_THRESHOLD = 1024;
 const SKIP_CONTENT_TYPES = new Set(['image/', 'audio/', 'video/', 'application/zip', 'application/gzip', 'application/x-bzip', 'application/x-bzip2', 'application/x-xz', 'application/zstd', 'application/octet-stream']);
+/**
+ * Create node response compression.
+ *
+ * @param response The response.
+ * @param acceptEncoding The accept encoding.
+ * @returns The create node response compression result.
+ */
 export function createNodeResponseCompression(response, acceptEncoding) {
   if (!acceptEncoding) {
     return undefined;
@@ -19,6 +26,15 @@ export function createNodeResponseCompression(response, acceptEncoding) {
     }
   };
 }
+
+/**
+ * Compress node response.
+ *
+ * @param response The response.
+ * @param body The body.
+ * @param encoding The encoding.
+ * @returns The compress node response result.
+ */
 export function compressNodeResponse(response, body, encoding) {
   const stream = encoding === 'br' ? createBrotliCompress() : createGzip();
   response.setHeader('Content-Encoding', encoding);

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

@@ -1,6 +1,28 @@
 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.
+ */
 export declare class NodeRequestPayloadTooLargeException extends PayloadTooLargeException {
     private readonly request;
     constructor(request: IncomingMessage);
@@ -17,6 +39,45 @@ export declare class NodeRequestPayloadTooLargeException extends PayloadTooLarge
  * @returns The normalized framework request used by the dispatcher.
  */
 export declare function createFrameworkRequest(request: IncomingMessage, signal: AbortSignal, multipartOptions?: MultipartOptions, maxBodySize?: number, preserveRawBody?: boolean): Promise<FrameworkRequest>;
+/**
+ * Creates the cheap Node framework request shell before consuming the body stream.
+ *
+ * @param request - Raw Node request carrying headers, URL, and body stream.
+ * @param signal - Abort signal tied to the response lifecycle.
+ * @param multipartOptions - Multipart parser options applied when materializing multipart requests.
+ * @param maxBodySize - Maximum allowed non-multipart body size in bytes.
+ * @param preserveRawBody - Whether materialization should retain raw request body bytes.
+ * @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.
+ *
+ * @param request - Framework request returned by {@link createDeferredFrameworkRequest}.
+ * @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.
  *
@@ -31,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;AAOzB,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,CAqD3B;AAED;;;;;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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"}