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

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;AA2BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAsBlH"}

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,9 +13,47 @@ export function matchHandlerOrThrow(handlerMapping, request) {
   }
   return match;
 }
+function defineRequestParams(request, params) {
+  Object.defineProperty(request, 'params', {
+    configurable: true,
+    enumerable: true,
+    value: params,
+    writable: true
+  });
+}
+function findInheritedParamsDescriptor(request) {
+  let prototype = Object.getPrototypeOf(request);
+  while (prototype) {
+    const descriptor = Object.getOwnPropertyDescriptor(prototype, 'params');
+    if (descriptor) {
+      return descriptor;
+    }
+    prototype = Object.getPrototypeOf(prototype);
+  }
+  return undefined;
+}
+
+/**
+ * Update request params.
+ *
+ * @param requestContext The request context.
+ * @param params The params.
+ */
 export function updateRequestParams(requestContext, params) {
-  requestContext.request = {
-    ...requestContext.request,
-    params
-  };
+  const request = requestContext.request;
+  const ownDescriptor = Object.getOwnPropertyDescriptor(request, 'params');
+  if (ownDescriptor) {
+    if ('value' in ownDescriptor && ownDescriptor.writable) {
+      request.params = params;
+      return;
+    }
+    defineRequestParams(request, params);
+    return;
+  }
+  const inheritedDescriptor = findInheritedParamsDescriptor(request);
+  if (!inheritedDescriptor || 'value' in inheritedDescriptor && inheritedDescriptor.writable) {
+    request.params = params;
+    return;
+  }
+  defineRequestParams(request, params);
 }

package/dist/dispatch/dispatcher.d.ts

@@ -1,12 +1,11 @@
 import type { Container } from '@fluojs/di';
-import type { Binder, ContentNegotiationOptions, Dispatcher, DispatcherLogger, FrameworkRequest, FrameworkResponse, HandlerMapping, InterceptorLike, MiddlewareLike, RequestObserverLike } from '../types.js';
-/**
- * Type definition for a global HTTP error handler function.
- */
+import type { Binder, ContentNegotiationOptions, ConverterLike, Dispatcher, DispatcherLogger, FrameworkRequest, FrameworkResponse, HandlerMapping, InterceptorLike, MiddlewareLike, RequestObserverLike } from '../types.js';
+import { type FastPathStats } from './fast-path/index.js';
+export type { FastPathEligibility, FastPathStats } from './fast-path/index.js';
+export { FAST_PATH_ELIGIBILITY_SYMBOL, FAST_PATH_STATS_SYMBOL } from './fast-path/index.js';
+/** Type definition for a global HTTP error handler function. */
 export type ErrorHandler = (error: unknown, request: FrameworkRequest, response: FrameworkResponse, requestId?: string) => Promise<boolean | void> | boolean | void;
-/**
- * Options for creating an HTTP {@link Dispatcher}.
- */
+/** Options for creating an HTTP {@link Dispatcher}. */
 export interface CreateDispatcherOptions {
     /** Global middleware applied to all requests. */
     appMiddleware?: MiddlewareLike[];
@@ -20,11 +19,21 @@ export interface CreateDispatcherOptions {
     interceptors?: InterceptorLike[];
     /** Global request observers for telemetry and logging. */
     observers?: RequestObserverLike[];
+    /** Emits per-response fast-path debug headers when enabled. */
+    fastPathDebugHeaders?: boolean;
     /** Optional global error handler. */
     onError?: ErrorHandler;
+    /** Request-scope optimization hints supplied by runtime bootstrap. */
+    requestScope?: {
+        /** Global DTO converters used by the default binder. */
+        converterDefinitions?: readonly ConverterLike[];
+    };
+    /** Logger used for non-fatal dispatcher failures. */
     logger?: DispatcherLogger;
     /** Root DI container for creating request scopes. */
     rootContainer: Container;
+    /** Human-readable adapter label included in fast-path observability output. */
+    adapter?: string;
 }
 /**
  * Creates an HTTP dispatcher instance for processing requests.
@@ -33,4 +42,12 @@ export interface CreateDispatcherOptions {
  * @returns A {@link Dispatcher} capable of routing {@link FrameworkRequest}s.
  */
 export declare function createDispatcher(options: CreateDispatcherOptions): Dispatcher;
+/**
+ * Reads automatic fast-path eligibility statistics attached to a dispatcher.
+ *
+ * @param dispatcher Dispatcher returned by {@link createDispatcher}.
+ * @returns Fast-path statistics when available.
+ */
+export declare function getDispatcherFastPathStats(dispatcher: Dispatcher): FastPathStats | undefined;
+export { formatFastPathStats } from './fast-path/index.js';
 //# sourceMappingURL=dispatcher.d.ts.map

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,EAAyB,MAAM,YAAY,CAAC;AAQnE,OAAO,KAAK,EACV,MAAM,EACN,yBAAyB,EACzB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAIjB,cAAc,EAEd,eAAe,EAEf,cAAc,EAId,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAKL,KAAK,aAAa,EAOnB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE5F,gEAAgE;AAChE,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,uDAAuD;AACvD,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,+DAA+D;IAC/D,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qCAAqC;IACrC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,sEAAsE;IACtE,YAAY,CAAC,EAAE;QACb,wDAAwD;QACxD,oBAAoB,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;KACjD,CAAC;IACF,qDAAqD;IACrD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,qDAAqD;IACrD,aAAa,EAAE,SAAS,CAAC;IACzB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAyyBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU,CAuF7E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAE5F;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}