@fluojs/http 1.0.0-beta.2 → 1.0.0-beta.3

package/dist/input-error-detail.js

@@ -1,3 +1,13 @@
+/**
+ * Describes the input error detail contract.
+ */
+
+/**
+ * To input error detail.
+ *
+ * @param detail The detail.
+ * @returns The to input error detail result.
+ */
 export function toInputErrorDetail(detail) {
   return {
     code: detail.code,

package/dist/interceptors.d.ts

@@ -1,3 +1,11 @@
 import type { InterceptorContext, InterceptorLike } from './types.js';
+/**
+ * Run interceptor chain.
+ *
+ * @param definitions The definitions.
+ * @param context The context.
+ * @param terminal The terminal.
+ * @returns The run interceptor chain result.
+ */
 export declare function runInterceptorChain(definitions: InterceptorLike[], context: InterceptorContext, terminal: () => Promise<unknown>): Promise<unknown>;
 //# sourceMappingURL=interceptors.d.ts.map

package/dist/interceptors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../src/interceptors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,kBAAkB,EAClB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAiBpB,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,eAAe,EAAE,EAC9B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAelB"}
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../src/interceptors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,kBAAkB,EAClB,eAAe,EAEhB,MAAM,YAAY,CAAC;AAiBpB;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,eAAe,EAAE,EAC9B,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAoBlB"}

package/dist/interceptors.js

@@ -7,11 +7,24 @@ async function resolveInterceptor(definition, requestContext) {
   }
   return requestContext.container.resolve(definition);
 }
+
+/**
+ * Run interceptor chain.
+ *
+ * @param definitions The definitions.
+ * @param context The context.
+ * @param terminal The terminal.
+ * @returns The run interceptor chain result.
+ */
 export async function runInterceptorChain(definitions, context, terminal) {
+  if (definitions.length === 0) {
+    return terminal();
+  }
   let next = {
     handle: terminal
   };
-  for (const definition of [...definitions].reverse()) {
+  for (let index = definitions.length - 1; index >= 0; index -= 1) {
+    const definition = definitions[index];
     const interceptor = await resolveInterceptor(definition, context.requestContext);
     const previous = next;
     next = {

package/dist/mapping.d.ts

@@ -2,6 +2,13 @@ import type { HandlerMapping, HandlerSource, VersioningOptions } from './types.j
 interface CreateHandlerMappingOptions {
     versioning?: VersioningOptions;
 }
+/**
+ * Create handler mapping.
+ *
+ * @param sources The sources.
+ * @param options The options.
+ * @returns The create handler mapping result.
+ */
 export declare function createHandlerMapping(sources: HandlerSource[], options?: CreateHandlerMappingOptions): HandlerMapping;
 export {};
 //# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAIV,cAAc,EAEd,aAAa,EAIb,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAOpB,UAAU,2BAA2B;IACnC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAmQD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE,2BAA2B,GAAG,cAAc,CA0DpH"}
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAIV,cAAc,EAEd,aAAa,EAIb,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAOpB,UAAU,2BAA2B;IACnC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AA6VD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,OAAO,CAAC,EAAE,2BAA2B,GAAG,cAAc,CAuEpH"}

package/dist/mapping.js

@@ -1,7 +1,7 @@
 import { getControllerMetadata, getRouteMetadata } from '@fluojs/core/internal';
 import { getRouteProducesMetadata } from './decorators.js';
 import { RouteConflictError } from './errors.js';
-import { extractRoutePathParams, matchRoutePath, normalizeRoutePath, parseRoutePath } from './route-path.js';
+import { extractRoutePathParams, normalizeRoutePath, parseRoutePath } from './route-path.js';
 import { VersioningType } from './types.js';
 function joinPaths(basePath, routePath) {
   return normalizeRoutePath(`${basePath}/${routePath}`);
@@ -116,19 +116,32 @@ function matchesRouteVersion(descriptor, requestVersion) {
 function getControllerMethodNames(controllerToken) {
   return Object.getOwnPropertyNames(controllerToken.prototype).filter(propertyKey => propertyKey !== 'constructor');
 }
-function splitIncomingPathSegments(path) {
-  return normalizeRoutePath(path).split('/').filter(Boolean);
-}
 function buildDescriptorIndex(descriptors) {
-  const index = new Map();
+  const staticIndex = new Map();
+  const paramIndex = new Map();
   for (const descriptor of descriptors) {
     const method = descriptor.route.method;
     const segments = parseRoutePath(descriptor.route.path, `Registered ${descriptor.route.method} route path`);
+    if (segments.every(segment => segment.kind === 'literal')) {
+      let methodMap = staticIndex.get(method);
+      if (!methodMap) {
+        methodMap = new Map();
+        staticIndex.set(method, methodMap);
+      }
+      const path = descriptor.route.path;
+      const bucket = methodMap.get(path);
+      if (bucket) {
+        bucket.push(descriptor);
+      } else {
+        methodMap.set(path, [descriptor]);
+      }
+      continue;
+    }
     const segmentCount = segments.length;
-    let methodMap = index.get(method);
+    let methodMap = paramIndex.get(method);
     if (!methodMap) {
       methodMap = new Map();
-      index.set(method, methodMap);
+      paramIndex.set(method, methodMap);
     }
     let bucket = methodMap.get(segmentCount);
     if (!bucket) {
@@ -140,7 +153,61 @@ function buildDescriptorIndex(descriptors) {
       segments
     });
   }
-  return index;
+  return {
+    param: paramIndex,
+    static: staticIndex
+  };
+}
+function findStaticMatch(descriptorBuckets, requestVersion, versioning) {
+  let firstUnversionedMatch;
+  for (const descriptors of descriptorBuckets) {
+    if (!descriptors || descriptors.length === 0) {
+      continue;
+    }
+    for (const descriptor of descriptors) {
+      if (versioning.type === VersioningType.URI) {
+        return {
+          descriptor,
+          params: {}
+        };
+      }
+      if (matchesRouteVersion(descriptor, requestVersion)) {
+        return {
+          descriptor,
+          params: {}
+        };
+      }
+      if (descriptor.route.version === undefined && !firstUnversionedMatch) {
+        firstUnversionedMatch = {
+          descriptor,
+          params: {}
+        };
+      }
+    }
+  }
+  return firstUnversionedMatch;
+}
+function matchParameterizedRoute(candidate, incomingSegments) {
+  const {
+    segments
+  } = candidate;
+  if (segments.length !== incomingSegments.length) {
+    return undefined;
+  }
+  for (let index = 0; index < segments.length; index += 1) {
+    const segment = segments[index];
+    if (segment.kind === 'literal' && segment.value !== incomingSegments[index]) {
+      return undefined;
+    }
+  }
+  const params = {};
+  for (let index = 0; index < segments.length; index += 1) {
+    const segment = segments[index];
+    if (segment.kind === 'param') {
+      params[segment.name] = incomingSegments[index];
+    }
+  }
+  return params;
 }
 function createHandlerDescriptors(source, versioning) {
   const controllerMetadata = getControllerMetadata(source.controllerToken) ?? {
@@ -194,6 +261,14 @@ function buildDescriptorList(sources, versioning) {
   }
   return descriptors;
 }
+
+/**
+ * Create handler mapping.
+ *
+ * @param sources The sources.
+ * @param options The options.
+ * @returns The create handler mapping result.
+ */
 export function createHandlerMapping(sources, options) {
   const versioning = resolveVersioning(options);
   const descriptors = buildDescriptorList(sources, versioning);
@@ -203,11 +278,18 @@ export function createHandlerMapping(sources, options) {
     match(request) {
       const method = request.method.toUpperCase();
       const requestVersion = versioning.type === VersioningType.URI ? undefined : resolveRequestVersion(request, versioning);
-      const incomingSegments = splitIncomingPathSegments(request.path);
-      const candidates = [...(descriptorIndex.get(method)?.get(incomingSegments.length) ?? []), ...(descriptorIndex.get('ALL')?.get(incomingSegments.length) ?? [])];
+      const normalizedPath = normalizeRoutePath(request.path);
+      const methodStaticDescriptors = descriptorIndex.static.get(method)?.get(normalizedPath);
+      const allStaticDescriptors = descriptorIndex.static.get('ALL')?.get(normalizedPath);
+      const directStaticMatch = findStaticMatch([methodStaticDescriptors, allStaticDescriptors], requestVersion, versioning);
+      if (directStaticMatch) {
+        return directStaticMatch;
+      }
+      const incomingSegments = normalizedPath.split('/').filter(Boolean);
+      const candidates = [...(descriptorIndex.param.get(method)?.get(incomingSegments.length) ?? []), ...(descriptorIndex.param.get('ALL')?.get(incomingSegments.length) ?? [])];
       let firstUnversionedMatch;
       for (const candidate of candidates) {
-        const params = matchRoutePath(candidate.segments, incomingSegments);
+        const params = matchParameterizedRoute(candidate, incomingSegments);
         if (!params) {
           continue;
         }

package/dist/middleware/correlation.d.ts

@@ -1,3 +1,8 @@
 import type { Middleware } from '../types.js';
+/**
+ * Create correlation middleware.
+ *
+ * @returns The create correlation middleware result.
+ */
 export declare function createCorrelationMiddleware(): Middleware;
 //# sourceMappingURL=correlation.d.ts.map

package/dist/middleware/correlation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../../src/middleware/correlation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAY9C,wBAAgB,2BAA2B,IAAI,UAAU,CAYxD"}
+{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../../src/middleware/correlation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAY9C;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,UAAU,CAYxD"}

package/dist/middleware/correlation.js

@@ -6,6 +6,12 @@ function resolveInboundRequestId(headers) {
   const value = Array.isArray(requestId) ? requestId[0] : requestId;
   return value ?? randomUUID();
 }
+
+/**
+ * Create correlation middleware.
+ *
+ * @returns The create correlation middleware result.
+ */
 export function createCorrelationMiddleware() {
   return {
     async handle(context, next) {

package/dist/middleware/cors.d.ts

@@ -1,4 +1,7 @@
 import type { Middleware } from '../types.js';
+/**
+ * Describes the cors options contract.
+ */
 export interface CorsOptions {
     allowCredentials?: boolean;
     allowHeaders?: string[];
@@ -7,5 +10,11 @@ export interface CorsOptions {
     exposeHeaders?: string[];
     maxAge?: number;
 }
+/**
+ * Create cors middleware.
+ *
+ * @param options The options.
+ * @returns The create cors middleware result.
+ */
 export declare function createCorsMiddleware(options?: CorsOptions): Middleware;
 //# sourceMappingURL=cors.d.ts.map

package/dist/middleware/cors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cors.d.ts","sourceRoot":"","sources":["../../src/middleware/cors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IACvF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CA0D1E"}
+{"version":3,"file":"cors.d.ts","sourceRoot":"","sources":["../../src/middleware/cors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IACvF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CA0D1E"}

package/dist/middleware/cors.js

@@ -1,3 +1,7 @@
+/**
+ * Describes the cors options contract.
+ */
+
 function resolveOrigin(options, requestOrigin) {
   if (typeof options.allowOrigin === 'function') {
     return options.allowOrigin(requestOrigin);
@@ -15,6 +19,13 @@ function setHeaderIfValue(response, name, value) {
     response.setHeader(name, value);
   }
 }
+
+/**
+ * Create cors middleware.
+ *
+ * @param options The options.
+ * @returns The create cors middleware result.
+ */
 export function createCorsMiddleware(options = {}) {
   if (options.allowCredentials === true) {
     if (options.allowOrigin === '*' || options.allowOrigin === undefined) {

package/dist/middleware/middleware.d.ts

@@ -1,8 +1,42 @@
 import type { Constructor } from '@fluojs/core';
 import type { Middleware, MiddlewareContext, MiddlewareLike, MiddlewareRouteConfig, Next } from '../types.js';
+/**
+ * Is middleware route config.
+ *
+ * @param value The value.
+ * @returns The is middleware route config result.
+ */
 export declare function isMiddlewareRouteConfig(value: MiddlewareLike): value is MiddlewareRouteConfig;
+/**
+ * Normalize route pattern.
+ *
+ * @param path The path.
+ * @returns The normalize route pattern result.
+ */
 export declare function normalizeRoutePattern(path: string): string;
+/**
+ * Match route pattern.
+ *
+ * @param pattern The pattern.
+ * @param path The path.
+ * @returns The match route pattern result.
+ */
 export declare function matchRoutePattern(pattern: string, path: string): boolean;
+/**
+ * For routes.
+ *
+ * @param middlewareClass The middleware class.
+ * @param routes The routes.
+ * @returns The for routes result.
+ */
 export declare function forRoutes<T extends Constructor<Middleware>>(middlewareClass: T, ...routes: string[]): MiddlewareRouteConfig;
+/**
+ * Run middleware chain.
+ *
+ * @param definitions The definitions.
+ * @param context The context.
+ * @param terminal The terminal.
+ * @returns The run middleware chain result.
+ */
 export declare function runMiddlewareChain(definitions: MiddlewareLike[], context: MiddlewareContext, terminal: Next): Promise<void>;
 //# sourceMappingURL=middleware.d.ts.map

package/dist/middleware/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,cAAc,CAAC;AAGvD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,IAAI,EAAkB,MAAM,aAAa,CAAC;AAM9H,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,IAAI,qBAAqB,CAE7F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUxE;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EACzD,eAAe,EAAE,CAAC,EAClB,GAAG,MAAM,EAAE,MAAM,EAAE,GAClB,qBAAqB,CAEvB;AA2CD,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,cAAc,EAAE,EAC7B,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,IAAI,GACb,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,cAAc,CAAC;AAGvD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,IAAI,EAAkB,MAAM,aAAa,CAAC;AAM9H;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,IAAI,qBAAqB,CAE7F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAUxE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EACzD,eAAe,EAAE,CAAC,EAClB,GAAG,MAAM,EAAE,MAAM,EAAE,GAClB,qBAAqB,CAEvB;AA2CD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,cAAc,EAAE,EAC7B,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,IAAI,GACb,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/middleware/middleware.js

@@ -2,15 +2,37 @@ import { normalizeRoutePath } from '../route-path.js';
 function isMiddleware(value) {
   return typeof value === 'object' && value !== null && 'handle' in value;
 }
+
+/**
+ * Is middleware route config.
+ *
+ * @param value The value.
+ * @returns The is middleware route config result.
+ */
 export function isMiddlewareRouteConfig(value) {
   return typeof value === 'object' && value !== null && 'middleware' in value && 'routes' in value;
 }
+
+/**
+ * Normalize route pattern.
+ *
+ * @param path The path.
+ * @returns The normalize route pattern result.
+ */
 export function normalizeRoutePattern(path) {
   if (path.endsWith('/*')) {
     return `${normalizeRoutePattern(path.slice(0, -2))}/*`;
   }
   return normalizeRoutePath(path);
 }
+
+/**
+ * Match route pattern.
+ *
+ * @param pattern The pattern.
+ * @param path The path.
+ * @returns The match route pattern result.
+ */
 export function matchRoutePattern(pattern, path) {
   const normalizedPath = normalizeRoutePattern(path);
   const normalizedPattern = normalizeRoutePattern(pattern);
@@ -20,6 +42,14 @@ export function matchRoutePattern(pattern, path) {
   }
   return normalizedPath === normalizedPattern;
 }
+
+/**
+ * For routes.
+ *
+ * @param middlewareClass The middleware class.
+ * @param routes The routes.
+ * @returns The for routes result.
+ */
 export function forRoutes(middlewareClass, ...routes) {
   return {
     middleware: middlewareClass,
@@ -55,8 +85,25 @@ function deferNext(next) {
     await next();
   };
 }
+
+/**
+ * Run middleware chain.
+ *
+ * @param definitions The definitions.
+ * @param context The context.
+ * @param terminal The terminal.
+ * @returns The run middleware chain result.
+ */
 export async function runMiddlewareChain(definitions, context, terminal) {
+  if (definitions.length === 0) {
+    await terminal();
+    return;
+  }
   const middlewareChain = await resolveActiveMiddlewareDefinitions(definitions, context);
+  if (middlewareChain.length === 0) {
+    await terminal();
+    return;
+  }
   const composed = middlewareChain.reduceRight((next, middleware) => deferNext(async () => {
     await middleware.handle(context, next);
   }), deferNext(terminal));

package/dist/middleware/security-headers.d.ts

@@ -1,4 +1,7 @@
 import type { Middleware } from '../types.js';
+/**
+ * Describes the security headers options contract.
+ */
 export interface SecurityHeadersOptions {
     contentSecurityPolicy?: string | false;
     crossOriginOpenerPolicy?: string | false;
@@ -8,5 +11,11 @@ export interface SecurityHeadersOptions {
     xFrameOptions?: string | false;
     xXssProtection?: string | false;
 }
+/**
+ * Create security headers middleware.
+ *
+ * @param options The options.
+ * @returns The create security headers middleware result.
+ */
 export declare function createSecurityHeadersMiddleware(options?: SecurityHeadersOptions): Middleware;
 //# sourceMappingURL=security-headers.d.ts.map

package/dist/middleware/security-headers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security-headers.d.ts","sourceRoot":"","sources":["../../src/middleware/security-headers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvC,uBAAuB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzC,mBAAmB,CAAC,EAAE,KAAK,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACjC;AAYD,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,sBAA2B,GAAG,UAAU,CA6ChG"}
+{"version":3,"file":"security-headers.d.ts","sourceRoot":"","sources":["../../src/middleware/security-headers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvC,uBAAuB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzC,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzC,mBAAmB,CAAC,EAAE,KAAK,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACjC;AAYD;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,sBAA2B,GAAG,UAAU,CA6ChG"}

package/dist/middleware/security-headers.js

@@ -1,3 +1,7 @@
+/**
+ * Describes the security headers options contract.
+ */
+
 const DEFAULTS = {
   contentSecurityPolicy: "default-src 'self'",
   crossOriginOpenerPolicy: 'same-origin',
@@ -7,6 +11,13 @@ const DEFAULTS = {
   xFrameOptions: 'SAMEORIGIN',
   xXssProtection: '0'
 };
+
+/**
+ * Create security headers middleware.
+ *
+ * @param options The options.
+ * @returns The create security headers middleware result.
+ */
 export function createSecurityHeadersMiddleware(options = {}) {
   const csp = 'contentSecurityPolicy' in options ? options.contentSecurityPolicy : DEFAULTS.contentSecurityPolicy;
   const coop = 'crossOriginOpenerPolicy' in options ? options.crossOriginOpenerPolicy : DEFAULTS.crossOriginOpenerPolicy;

package/dist/route-path.d.ts

@@ -1,15 +1,56 @@
+/**
+ * Describes the route path literal segment contract.
+ */
 export interface RoutePathLiteralSegment {
     kind: 'literal';
     value: string;
 }
+/**
+ * Describes the route path param segment contract.
+ */
 export interface RoutePathParamSegment {
     kind: 'param';
     name: string;
 }
+/**
+ * Defines the route path segment type.
+ */
 export type RoutePathSegment = RoutePathLiteralSegment | RoutePathParamSegment;
+/**
+ * Normalize route path.
+ *
+ * @param path The path.
+ * @returns The normalize route path result.
+ */
 export declare function normalizeRoutePath(path: string): string;
+/**
+ * Parse route path.
+ *
+ * @param path The path.
+ * @param label The label.
+ * @returns The parse route path result.
+ */
 export declare function parseRoutePath(path: string, label?: string): RoutePathSegment[];
+/**
+ * Validate route path.
+ *
+ * @param path The path.
+ * @param label The label.
+ */
 export declare function validateRoutePath(path: string, label?: string): void;
+/**
+ * Extract route path params.
+ *
+ * @param path The path.
+ * @returns The extract route path params result.
+ */
 export declare function extractRoutePathParams(path: string): string[];
+/**
+ * Match route path.
+ *
+ * @param registeredSegments The registered segments.
+ * @param incomingSegments The incoming segments.
+ * @returns The match route path result.
+ */
 export declare function matchRoutePath(registeredSegments: readonly RoutePathSegment[], incomingSegments: readonly string[]): Readonly<Record<string, string>> | undefined;
 //# sourceMappingURL=route-path.d.ts.map

package/dist/route-path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-path.d.ts","sourceRoot":"","sources":["../src/route-path.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,qBAAqB,CAAC;AAsD/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAK/E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE7D;AAED,wBAAgB,cAAc,CAC5B,kBAAkB,EAAE,SAAS,gBAAgB,EAAE,EAC/C,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAqB9C"}
+{"version":3,"file":"route-path.d.ts","sourceRoot":"","sources":["../src/route-path.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,qBAAqB,CAAC;AAsD/E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAK/E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,kBAAkB,EAAE,SAAS,gBAAgB,EAAE,EAC/C,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAqB9C"}

package/dist/route-path.js

@@ -1,4 +1,17 @@
 import { InvalidRoutePathError } from './errors.js';
+
+/**
+ * Describes the route path literal segment contract.
+ */
+
+/**
+ * Describes the route path param segment contract.
+ */
+
+/**
+ * Defines the route path segment type.
+ */
+
 const routeParamNamePattern = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
 const unsupportedLiteralTokenPattern = /[*?+()[\]{}\\]/;
 const supportedRouteSyntaxDescription = 'Only literal segments and full-segment ":param" placeholders are supported.';
@@ -34,22 +47,59 @@ function parseRoutePathSegment(segment, path, label) {
     value: segment
   };
 }
+
+/**
+ * Normalize route path.
+ *
+ * @param path The path.
+ * @returns The normalize route path result.
+ */
 export function normalizeRoutePath(path) {
   const segments = path.split('/').filter(Boolean);
   const normalized = `/${segments.join('/')}`;
   return normalized === '' ? '/' : normalized;
 }
+
+/**
+ * Parse route path.
+ *
+ * @param path The path.
+ * @param label The label.
+ * @returns The parse route path result.
+ */
 export function parseRoutePath(path, label) {
   const normalizedPath = normalizeRoutePath(path);
   const segments = normalizedPath.split('/').filter(Boolean);
   return segments.map(segment => parseRoutePathSegment(segment, path, label));
 }
+
+/**
+ * Validate route path.
+ *
+ * @param path The path.
+ * @param label The label.
+ */
 export function validateRoutePath(path, label) {
   void parseRoutePath(path, label);
 }
+
+/**
+ * Extract route path params.
+ *
+ * @param path The path.
+ * @returns The extract route path params result.
+ */
 export function extractRoutePathParams(path) {
   return parseRoutePath(path).flatMap(segment => segment.kind === 'param' ? [segment.name] : []);
 }
+
+/**
+ * Match route path.
+ *
+ * @param registeredSegments The registered segments.
+ * @param incomingSegments The incoming segments.
+ * @returns The match route path result.
+ */
 export function matchRoutePath(registeredSegments, incomingSegments) {
   if (registeredSegments.length !== incomingSegments.length) {
     return undefined;

package/dist/types.d.ts

@@ -182,6 +182,11 @@ export type VersioningOptions = {
 /** Runtime dispatcher that executes the full HTTP request lifecycle. */
 export interface Dispatcher {
     dispatch(request: FrameworkRequest, response: FrameworkResponse): Promise<void>;
+    /**
+     * Returns the mapped route descriptors known to this dispatcher when the
+     * implementation can expose them without changing dispatch behavior.
+     */
+    describeRoutes?(): readonly HandlerDescriptor[];
 }
 /** Logger seam used by the dispatcher for non-fatal internal failure reporting. */
 export interface DispatcherLogger {