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

package/dist/dispatch/dispatch-routing-policy.d.ts

@@ -1,4 +1,17 @@
 import type { FrameworkRequest, HandlerMapping, HandlerMatch, RequestContext } from '../types.js';
+/**
+ * Match handler or throw.
+ *
+ * @param handlerMapping The handler mapping.
+ * @param request The request.
+ * @returns The match handler or throw result.
+ */
 export declare function matchHandlerOrThrow(handlerMapping: HandlerMapping, request: FrameworkRequest): HandlerMatch;
+/**
+ * Update request params.
+ *
+ * @param requestContext The request context.
+ * @param params The params.
+ */
 export declare function updateRequestParams(requestContext: RequestContext, params: Readonly<Record<string, string>>): void;
 //# sourceMappingURL=dispatch-routing-policy.d.ts.map

package/dist/dispatch/dispatch-routing-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch-routing-policy.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-routing-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElG,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAQ3G;AAED,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAKlH"}
+{"version":3,"file":"dispatch-routing-policy.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-routing-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElG;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAQ3G;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAKlH"}

package/dist/dispatch/dispatch-routing-policy.js

@@ -1,4 +1,11 @@
 import { HandlerNotFoundError } from '../errors.js';
+/**
+ * Match handler or throw.
+ *
+ * @param handlerMapping The handler mapping.
+ * @param request The request.
+ * @returns The match handler or throw result.
+ */
 export function matchHandlerOrThrow(handlerMapping, request) {
   const match = handlerMapping.match(request);
   if (!match) {
@@ -6,6 +13,13 @@ export function matchHandlerOrThrow(handlerMapping, request) {
   }
   return match;
 }
+
+/**
+ * Update request params.
+ *
+ * @param requestContext The request context.
+ * @param params The params.
+ */
 export function updateRequestParams(requestContext, params) {
   requestContext.request = {
     ...requestContext.request,

package/dist/dispatch/dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C,OAAO,KAAK,EACV,MAAM,EACN,yBAAyB,EACzB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAGjB,cAAc,EACd,eAAe,EAGf,cAAc,EAId,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;AAEpK;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iDAAiD;IACjD,aAAa,CAAC,EAAE,cAAc,EAAE,CAAC;IACjC,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IAC/C,sDAAsD;IACtD,cAAc,EAAE,cAAc,CAAC;IAC/B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,qCAAqC;IACrC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,qDAAqD;IACrD,aAAa,EAAE,SAAS,CAAC;CAC1B;AAmQD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU,CA8B7E"}
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C,OAAO,KAAK,EACV,MAAM,EACN,yBAAyB,EACzB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAGjB,cAAc,EACd,eAAe,EAEf,cAAc,EAId,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC;AAEpK;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iDAAiD;IACjD,aAAa,CAAC,EAAE,cAAc,EAAE,CAAC;IACjC,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IAC/C,sDAAsD;IACtD,cAAc,EAAE,cAAc,CAAC;IAC/B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,0DAA0D;IAC1D,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,qCAAqC;IACrC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,qDAAqD;IACrD,aAAa,EAAE,SAAS,CAAC;CAC1B;AA8SD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU,CAoC7E"}

package/dist/dispatch/dispatcher.js

@@ -31,6 +31,28 @@ function createDispatchRequest(request) {
     }
   };
 }
+function cloneHandlerDescriptor(descriptor) {
+  return {
+    ...descriptor,
+    metadata: {
+      ...descriptor.metadata,
+      moduleMiddleware: [...descriptor.metadata.moduleMiddleware],
+      pathParams: [...descriptor.metadata.pathParams]
+    },
+    route: {
+      ...descriptor.route,
+      guards: descriptor.route.guards ? [...descriptor.route.guards] : undefined,
+      headers: descriptor.route.headers?.map(header => ({
+        ...header
+      })),
+      interceptors: descriptor.route.interceptors ? [...descriptor.route.interceptors] : undefined,
+      produces: descriptor.route.produces ? [...descriptor.route.produces] : undefined,
+      redirect: descriptor.route.redirect ? {
+        ...descriptor.route.redirect
+      } : undefined
+    }
+  };
+}
 function readRequestId(request) {
   const raw = request.headers['x-request-id'] ?? request.headers['X-Request-Id'];
   const value = Array.isArray(raw) ? raw[0] : raw;
@@ -71,29 +93,41 @@ async function notifyObservers(observers, requestContext, callback, handler) {
   }
 }
 async function notifyObserversSafely(observers, requestContext, callback, logger, handler) {
+  if (observers.length === 0) {
+    return;
+  }
   try {
     await notifyObservers(observers, requestContext, callback, handler);
   } catch (error) {
     logDispatchFailure(logger, 'Request observer threw an unhandled error.', error);
   }
 }
+function mergeInterceptors(globalInterceptors, routeInterceptors) {
+  if (globalInterceptors.length === 0) {
+    return routeInterceptors;
+  }
+  if (routeInterceptors.length === 0) {
+    return globalInterceptors;
+  }
+  return [...globalInterceptors, ...routeInterceptors];
+}
 async function dispatchMatchedHandler(handler, requestContext, observers, contentNegotiation, binder, globalInterceptors, logger) {
-  const guardContext = {
-    handler,
-    requestContext
-  };
-  const interceptorContext = {
-    handler,
-    requestContext
-  };
-  await runGuardChain(handler.route.guards ?? [], guardContext);
+  const routeGuards = handler.route.guards ?? [];
+  if (routeGuards.length > 0) {
+    const guardContext = {
+      handler,
+      requestContext
+    };
+    await runGuardChain(routeGuards, guardContext);
+  }
   if (requestContext.response.committed) {
     return;
   }
-  const interceptors = [...(globalInterceptors ?? []), ...(handler.route.interceptors ?? [])];
-  const result = await runInterceptorChain(interceptors, interceptorContext, async () => {
-    return invokeControllerHandler(handler, requestContext, binder);
-  });
+  const routeInterceptors = handler.route.interceptors ?? [];
+  const result = globalInterceptors.length === 0 && routeInterceptors.length === 0 ? await invokeControllerHandler(handler, requestContext, binder) : await runInterceptorChain(mergeInterceptors(globalInterceptors, routeInterceptors), {
+    handler,
+    requestContext
+  }, async () => invokeControllerHandler(handler, requestContext, binder));
   ensureRequestNotAborted(requestContext.request);
   if (!(result instanceof SseResponse) && !requestContext.response.committed) {
     await writeSuccessResponse(handler, requestContext.request, requestContext.response, result, contentNegotiation);
@@ -143,7 +177,7 @@ async function runDispatchPipeline(context) {
       response: context.response
     };
     await runMiddlewareChain(match.descriptor.metadata.moduleMiddleware ?? [], moduleMiddlewareContext, async () => {
-      await dispatchMatchedHandler(match.descriptor, context.requestContext, context.observers, context.contentNegotiation, context.options.binder, context.options.interceptors, context.options.logger);
+      await dispatchMatchedHandler(match.descriptor, context.requestContext, context.observers, context.contentNegotiation, context.options.binder, context.options.interceptors ?? [], context.options.logger);
     });
   });
 }
@@ -167,11 +201,15 @@ async function handleDispatchError(context, error) {
  */
 export function createDispatcher(options) {
   const contentNegotiation = resolveContentNegotiation(options.contentNegotiation);
-  return {
+  const observers = options.observers ?? [];
+  const dispatcher = {
+    describeRoutes() {
+      return options.handlerMapping.descriptors.map(descriptor => cloneHandlerDescriptor(descriptor));
+    },
     async dispatch(request, response) {
       const phaseContext = {
         contentNegotiation,
-        observers: options.observers ?? [],
+        observers,
         options,
         requestContext: createDispatchContext(createDispatchRequest(request), response, options.rootContainer),
         response
@@ -193,4 +231,5 @@ export function createDispatcher(options) {
       });
     }
   };
+  return dispatcher;
 }

package/dist/errors.d.ts

@@ -5,6 +5,9 @@ import { FluoError } from '@fluojs/core';
 export declare class RouteConflictError extends FluoError {
     constructor(message: string);
 }
+/**
+ * Represents the invalid route path error.
+ */
 export declare class InvalidRoutePathError extends FluoError {
     constructor(message: string);
 }

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,qBAAsB,SAAQ,SAAS;gBACtC,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;gBACrC,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,SAA4C;CAGhE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;gBACtC,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;gBACrC,OAAO,EAAE,MAAM;CAG5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,OAAO,SAA4C;CAGhE"}

package/dist/errors.js

@@ -10,6 +10,10 @@ export class RouteConflictError extends FluoError {
     });
   }
 }
+
+/**
+ * Represents the invalid route path error.
+ */
 export class InvalidRoutePathError extends FluoError {
   constructor(message) {
     super(message, {

package/dist/guards.d.ts

@@ -1,3 +1,10 @@
 import type { GuardContext, GuardLike } from './types.js';
+/**
+ * Run guard chain.
+ *
+ * @param definitions The definitions.
+ * @param context The context.
+ * @returns The run guard chain result.
+ */
 export declare function runGuardChain(definitions: GuardLike[], context: GuardContext): Promise<void>;
 //# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAS,YAAY,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAcjF,wBAAsB,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CASlG"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAS,YAAY,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAC;AAcjF;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAalG"}

package/dist/guards.js

@@ -8,7 +8,18 @@ async function resolveGuard(definition, requestContext) {
   }
   return requestContext.container.resolve(definition);
 }
+
+/**
+ * Run guard chain.
+ *
+ * @param definitions The definitions.
+ * @param context The context.
+ * @returns The run guard chain result.
+ */
 export async function runGuardChain(definitions, context) {
+  if (definitions.length === 0) {
+    return;
+  }
   for (const definition of definitions) {
     const guard = await resolveGuard(definition, context.requestContext);
     const result = await guard.canActivate(context);

package/dist/input-error-detail.d.ts

@@ -1,10 +1,19 @@
 import type { MetadataSource } from '@fluojs/core';
 import type { HttpExceptionDetail } from './exceptions.js';
+/**
+ * Describes the input error detail contract.
+ */
 export interface InputErrorDetail {
     code: string;
     field?: string;
     message: string;
     source?: MetadataSource;
 }
+/**
+ * To input error detail.
+ *
+ * @param detail The detail.
+ * @returns The to input error detail result.
+ */
 export declare function toInputErrorDetail(detail: InputErrorDetail): HttpExceptionDetail;
 //# sourceMappingURL=input-error-detail.d.ts.map

package/dist/input-error-detail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-error-detail.d.ts","sourceRoot":"","sources":["../src/input-error-detail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,CAOhF"}
+{"version":3,"file":"input-error-detail.d.ts","sourceRoot":"","sources":["../src/input-error-detail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,CAOhF"}

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"}