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

package/dist/decorators.js

@@ -1,8 +1,11 @@
-import { metadataSymbol } from '@fluojs/core/internal';
+import { defineControllerMetadata, defineDtoFieldBindingMetadata, defineRouteMetadata, ensureMetadataSymbol, getControllerMetadata, getDtoFieldBindingMetadata, getRouteMetadata, getStandardMetadataBag as readStandardMetadataBag } from '@fluojs/core/internal';
 import { validateRoutePath } from './route-path.js';
 const standardControllerMetadataKey = Symbol.for('fluo.standard.controller');
 const standardRouteMetadataKey = Symbol.for('fluo.standard.route');
 const standardDtoBindingMetadataKey = Symbol.for('fluo.standard.dto-binding');
+const legacyRouteMetadataStore = new WeakMap();
+const legacyDtoBindingMetadataStore = new WeakMap();
+ensureMetadataSymbol();
 function normalizeProducesMediaTypes(mediaTypes) {
   const normalized = [];
   for (const mediaType of mediaTypes) {
@@ -24,8 +27,115 @@ function mergeUnique(existing, values) {
   return merged;
 }
 function getStandardMetadataBag(metadata) {
-  void metadataSymbol;
-  return metadata;
+  return typeof metadata === 'object' && metadata !== null ? metadata : {};
+}
+function isStandardDecoratorContext(value) {
+  return typeof value === 'object' && value !== null && 'kind' in value && 'name' in value;
+}
+function isMetadataPropertyKey(value) {
+  return typeof value === 'string' || typeof value === 'symbol';
+}
+function getLegacyRouteRecord(target, propertyKey) {
+  let routeMap = legacyRouteMetadataStore.get(target);
+  if (!routeMap) {
+    routeMap = new Map();
+    legacyRouteMetadataStore.set(target, routeMap);
+  }
+  let record = routeMap.get(propertyKey);
+  if (!record) {
+    record = {};
+    routeMap.set(propertyKey, record);
+  }
+  return record;
+}
+function flushLegacyRouteMetadata(target, propertyKey, record) {
+  if (!record.method || record.path === undefined) {
+    return;
+  }
+  const existing = getRouteMetadata(target, propertyKey);
+  const metadata = {
+    guards: mergeUnique(existing?.guards, record.guards ?? []),
+    headers: record.headers ?? existing?.headers,
+    interceptors: mergeUnique(existing?.interceptors, record.interceptors ?? []),
+    method: record.method,
+    path: record.path,
+    redirect: record.redirect ?? existing?.redirect,
+    request: record.request ?? existing?.request,
+    successStatus: record.successStatus ?? existing?.successStatus,
+    version: record.version ?? existing?.version
+  };
+  defineRouteMetadata(target, propertyKey, metadata);
+}
+function mergeLegacyRouteMetadata(target, propertyKey, partial) {
+  const record = getLegacyRouteRecord(target, propertyKey);
+  Object.assign(record, partial);
+  flushLegacyRouteMetadata(target, propertyKey, record);
+}
+function defineLegacyControllerMetadata(target, partial) {
+  const existing = getControllerMetadata(target);
+  defineControllerMetadata(target, {
+    basePath: partial.basePath ?? existing?.basePath ?? '',
+    guards: partial.guards ?? existing?.guards,
+    interceptors: partial.interceptors ?? existing?.interceptors,
+    version: partial.version ?? existing?.version
+  });
+}
+function getLegacyDtoBindingRecord(target, propertyKey) {
+  let bindingMap = legacyDtoBindingMetadataStore.get(target);
+  if (!bindingMap) {
+    bindingMap = new Map();
+    legacyDtoBindingMetadataStore.set(target, bindingMap);
+  }
+  let record = bindingMap.get(propertyKey);
+  if (!record) {
+    record = {};
+    bindingMap.set(propertyKey, record);
+  }
+  return record;
+}
+function mergeLegacyDtoBinding(target, propertyKey, partial) {
+  const record = getLegacyDtoBindingRecord(target, propertyKey);
+  Object.assign(record, partial);
+  const source = record.source ?? getDtoFieldBindingMetadata(target, propertyKey)?.source;
+  if (!source) {
+    return;
+  }
+  defineDtoFieldBindingMetadata(target, propertyKey, {
+    converter: record.converter,
+    key: record.key,
+    optional: record.optional,
+    source
+  });
+}
+function appendLegacyRouteHeader(target, propertyKey, name, value) {
+  const record = getLegacyRouteRecord(target, propertyKey);
+  record.headers = [...(record.headers ?? []), {
+    name,
+    value
+  }];
+  flushLegacyRouteMetadata(target, propertyKey, record);
+}
+function appendLegacyControllerGuards(target, guards) {
+  const existing = getControllerMetadata(target);
+  defineLegacyControllerMetadata(target, {
+    guards: mergeUnique(existing?.guards, guards)
+  });
+}
+function appendLegacyControllerInterceptors(target, interceptors) {
+  const existing = getControllerMetadata(target);
+  defineLegacyControllerMetadata(target, {
+    interceptors: mergeUnique(existing?.interceptors, interceptors)
+  });
+}
+function appendLegacyRouteGuards(target, propertyKey, guards) {
+  const record = getLegacyRouteRecord(target, propertyKey);
+  record.guards = mergeUnique(record.guards, guards);
+  flushLegacyRouteMetadata(target, propertyKey, record);
+}
+function appendLegacyRouteInterceptors(target, propertyKey, interceptors) {
+  const record = getLegacyRouteRecord(target, propertyKey);
+  record.interceptors = mergeUnique(record.interceptors, interceptors);
+  flushLegacyRouteMetadata(target, propertyKey, record);
 }
 function getStandardControllerRecord(metadata) {
   const bag = getStandardMetadataBag(metadata);
@@ -77,29 +187,55 @@ function mergeStandardDtoBinding(metadata, propertyKey, partial) {
 function createRouteDecorator(method) {
   return path => {
     validateRoutePath(path, `@${method}() path`);
-    const decorator = (_value, context) => {
-      const route = getStandardRouteRecord(context.metadata, context.name);
-      route.method = method;
-      route.path = path;
+    const decorator = (valueOrTarget, contextOrPropertyKey) => {
+      if (isStandardDecoratorContext(contextOrPropertyKey)) {
+        const route = getStandardRouteRecord(contextOrPropertyKey.metadata, contextOrPropertyKey.name);
+        route.method = method;
+        route.path = path;
+        return;
+      }
+      if (isMetadataPropertyKey(contextOrPropertyKey)) {
+        mergeLegacyRouteMetadata(valueOrTarget, contextOrPropertyKey, {
+          method,
+          path
+        });
+      }
     };
     return decorator;
   };
 }
 function createRouteValueDecorator(apply) {
   return value => {
-    const decorator = (_target, context) => {
-      apply(getStandardRouteRecord(context.metadata, context.name), value);
+    const decorator = (valueOrTarget, contextOrPropertyKey) => {
+      if (isStandardDecoratorContext(contextOrPropertyKey)) {
+        apply(getStandardRouteRecord(contextOrPropertyKey.metadata, contextOrPropertyKey.name), value);
+        return;
+      }
+      if (isMetadataPropertyKey(contextOrPropertyKey)) {
+        const record = getLegacyRouteRecord(valueOrTarget, contextOrPropertyKey);
+        apply(record, value);
+        flushLegacyRouteMetadata(valueOrTarget, contextOrPropertyKey, record);
+      }
     };
     return decorator;
   };
 }
 function createDtoFieldDecorator(source) {
   return key => {
-    const decorator = (_value, context) => {
-      mergeStandardDtoBinding(context.metadata, context.name, {
-        key,
-        source
-      });
+    const decorator = (valueOrTarget, contextOrPropertyKey) => {
+      if (isStandardDecoratorContext(contextOrPropertyKey)) {
+        mergeStandardDtoBinding(contextOrPropertyKey.metadata, contextOrPropertyKey.name, {
+          key,
+          source
+        });
+        return;
+      }
+      if (isMetadataPropertyKey(contextOrPropertyKey) && valueOrTarget && typeof valueOrTarget === 'object') {
+        mergeLegacyDtoBinding(valueOrTarget, contextOrPropertyKey, {
+          key,
+          source
+        });
+      }
     };
     return decorator;
   };
@@ -113,8 +249,14 @@ function createDtoFieldDecorator(source) {
  */
 export function Controller(basePath = '') {
   validateRoutePath(basePath, '@Controller() base path');
-  const decorator = (_target, context) => {
-    getStandardControllerRecord(context.metadata).basePath = basePath;
+  const decorator = (target, context) => {
+    if (isStandardDecoratorContext(context)) {
+      getStandardControllerRecord(context.metadata).basePath = basePath;
+      return;
+    }
+    defineLegacyControllerMetadata(target, {
+      basePath
+    });
   };
   return decorator;
 }
@@ -126,12 +268,26 @@ export function Controller(basePath = '') {
  * @returns A decorator that applies version metadata at class or method scope.
  */
 export function Version(version) {
-  const decorator = (_target, context) => {
-    if (context.kind === 'class') {
-      getStandardControllerRecord(context.metadata).version = version;
+  const decorator = (target, contextOrPropertyKey) => {
+    if (isStandardDecoratorContext(contextOrPropertyKey)) {
+      if (contextOrPropertyKey.kind === 'class') {
+        getStandardControllerRecord(contextOrPropertyKey.metadata).version = version;
+        return;
+      }
+      getStandardRouteRecord(contextOrPropertyKey.metadata, contextOrPropertyKey.name).version = version;
       return;
     }
-    getStandardRouteRecord(context.metadata, context.name).version = version;
+    if (isMetadataPropertyKey(contextOrPropertyKey)) {
+      mergeLegacyRouteMetadata(target, contextOrPropertyKey, {
+        version
+      });
+      return;
+    }
+    if (typeof target === 'function') {
+      defineLegacyControllerMetadata(target, {
+        version
+      });
+    }
   };
   return decorator;
 }
@@ -233,9 +389,9 @@ export const HttpCode = createRouteValueDecorator((record, status) => {
  * @returns A defensive copy of declared media types, or `undefined` when not configured.
  */
 export function getRouteProducesMetadata(controllerToken, propertyKey) {
-  const bag = controllerToken[metadataSymbol];
+  const bag = readStandardMetadataBag(controllerToken);
   const routeMap = bag?.[standardRouteMetadataKey];
-  const produces = routeMap?.get(propertyKey)?.produces;
+  const produces = routeMap?.get(propertyKey)?.produces ?? legacyRouteMetadataStore.get(controllerToken.prototype)?.get(propertyKey)?.produces;
   return produces ? [...produces] : undefined;
 }
 
@@ -281,10 +437,18 @@ export const FromBody = createDtoFieldDecorator('body');
  * @returns A field decorator that marks the DTO binding as optional.
  */
 export function Optional() {
-  const decorator = (_value, context) => {
-    mergeStandardDtoBinding(context.metadata, context.name, {
-      optional: true
-    });
+  const decorator = (valueOrTarget, contextOrPropertyKey) => {
+    if (isStandardDecoratorContext(contextOrPropertyKey)) {
+      mergeStandardDtoBinding(contextOrPropertyKey.metadata, contextOrPropertyKey.name, {
+        optional: true
+      });
+      return;
+    }
+    if (isMetadataPropertyKey(contextOrPropertyKey) && valueOrTarget && typeof valueOrTarget === 'object') {
+      mergeLegacyDtoBinding(valueOrTarget, contextOrPropertyKey, {
+        optional: true
+      });
+    }
   };
   return decorator;
 }
@@ -296,10 +460,18 @@ export function Optional() {
  * @returns A field decorator that stores converter metadata for the DTO field.
  */
 export function Convert(converter) {
-  const decorator = (_value, context) => {
-    mergeStandardDtoBinding(context.metadata, context.name, {
-      converter
-    });
+  const decorator = (valueOrTarget, contextOrPropertyKey) => {
+    if (isStandardDecoratorContext(contextOrPropertyKey)) {
+      mergeStandardDtoBinding(contextOrPropertyKey.metadata, contextOrPropertyKey.name, {
+        converter
+      });
+      return;
+    }
+    if (isMetadataPropertyKey(contextOrPropertyKey) && valueOrTarget && typeof valueOrTarget === 'object') {
+      mergeLegacyDtoBinding(valueOrTarget, contextOrPropertyKey, {
+        converter
+      });
+    }
   };
   return decorator;
 }
@@ -312,12 +484,18 @@ export function Convert(converter) {
  * @returns A method decorator that appends route-level response-header metadata.
  */
 export function Header(name, value) {
-  const decorator = (_target, context) => {
-    const route = getStandardRouteRecord(context.metadata, context.name);
-    route.headers = [...(route.headers ?? []), {
-      name,
-      value
-    }];
+  const decorator = (valueOrTarget, contextOrPropertyKey) => {
+    if (isStandardDecoratorContext(contextOrPropertyKey)) {
+      const route = getStandardRouteRecord(contextOrPropertyKey.metadata, contextOrPropertyKey.name);
+      route.headers = [...(route.headers ?? []), {
+        name,
+        value
+      }];
+      return;
+    }
+    if (isMetadataPropertyKey(contextOrPropertyKey)) {
+      appendLegacyRouteHeader(valueOrTarget, contextOrPropertyKey, name, value);
+    }
   };
   return decorator;
 }
@@ -330,11 +508,22 @@ export function Header(name, value) {
  * @returns A method decorator that writes redirect metadata for the route.
  */
 export function Redirect(url, statusCode) {
-  const decorator = (_target, context) => {
-    getStandardRouteRecord(context.metadata, context.name).redirect = {
-      url,
-      statusCode
-    };
+  const decorator = (valueOrTarget, contextOrPropertyKey) => {
+    if (isStandardDecoratorContext(contextOrPropertyKey)) {
+      getStandardRouteRecord(contextOrPropertyKey.metadata, contextOrPropertyKey.name).redirect = {
+        url,
+        statusCode
+      };
+      return;
+    }
+    if (isMetadataPropertyKey(contextOrPropertyKey)) {
+      mergeLegacyRouteMetadata(valueOrTarget, contextOrPropertyKey, {
+        redirect: {
+          url,
+          statusCode
+        }
+      });
+    }
   };
   return decorator;
 }
@@ -346,14 +535,24 @@ export function Redirect(url, statusCode) {
  * @returns A decorator applicable to classes and methods.
  */
 export function UseGuards(...guards) {
-  const decorator = (_target, context) => {
-    if (context.kind === 'class') {
-      const controller = getStandardControllerRecord(context.metadata);
-      controller.guards = mergeUnique(controller.guards, guards);
+  const decorator = (target, contextOrPropertyKey) => {
+    if (isStandardDecoratorContext(contextOrPropertyKey)) {
+      if (contextOrPropertyKey.kind === 'class') {
+        const controller = getStandardControllerRecord(contextOrPropertyKey.metadata);
+        controller.guards = mergeUnique(controller.guards, guards);
+        return;
+      }
+      const route = getStandardRouteRecord(contextOrPropertyKey.metadata, contextOrPropertyKey.name);
+      route.guards = mergeUnique(route.guards, guards);
+      return;
+    }
+    if (isMetadataPropertyKey(contextOrPropertyKey)) {
+      appendLegacyRouteGuards(target, contextOrPropertyKey, guards);
       return;
     }
-    const route = getStandardRouteRecord(context.metadata, context.name);
-    route.guards = mergeUnique(route.guards, guards);
+    if (typeof target === 'function') {
+      appendLegacyControllerGuards(target, guards);
+    }
   };
   return decorator;
 }
@@ -365,14 +564,24 @@ export function UseGuards(...guards) {
  * @returns A decorator applicable to classes and methods.
  */
 export function UseInterceptors(...interceptors) {
-  const decorator = (_target, context) => {
-    if (context.kind === 'class') {
-      const controller = getStandardControllerRecord(context.metadata);
-      controller.interceptors = mergeUnique(controller.interceptors, interceptors);
+  const decorator = (target, contextOrPropertyKey) => {
+    if (isStandardDecoratorContext(contextOrPropertyKey)) {
+      if (contextOrPropertyKey.kind === 'class') {
+        const controller = getStandardControllerRecord(contextOrPropertyKey.metadata);
+        controller.interceptors = mergeUnique(controller.interceptors, interceptors);
+        return;
+      }
+      const route = getStandardRouteRecord(contextOrPropertyKey.metadata, contextOrPropertyKey.name);
+      route.interceptors = mergeUnique(route.interceptors, interceptors);
       return;
     }
-    const route = getStandardRouteRecord(context.metadata, context.name);
-    route.interceptors = mergeUnique(route.interceptors, interceptors);
+    if (isMetadataPropertyKey(contextOrPropertyKey)) {
+      appendLegacyRouteInterceptors(target, contextOrPropertyKey, interceptors);
+      return;
+    }
+    if (typeof target === 'function') {
+      appendLegacyControllerInterceptors(target, interceptors);
+    }
   };
   return decorator;
 }

package/dist/dispatch/dispatch-content-negotiation.d.ts

@@ -1,9 +1,26 @@
 import type { ContentNegotiationOptions, FrameworkRequest, HandlerDescriptor, ResponseFormatter } from '../types.js';
+/**
+ * Describes the resolved content negotiation contract.
+ */
 export interface ResolvedContentNegotiation {
     defaultFormatter: ResponseFormatter;
     formatters: ResponseFormatter[];
     normalizedMediaTypes: string[];
 }
+/**
+ * Resolve content negotiation.
+ *
+ * @param options The options.
+ * @returns The resolve content negotiation result.
+ */
 export declare function resolveContentNegotiation(options: ContentNegotiationOptions | undefined): ResolvedContentNegotiation | undefined;
+/**
+ * Select response formatter.
+ *
+ * @param handler The handler.
+ * @param request The request.
+ * @param contentNegotiation The content negotiation.
+ * @returns The select response formatter result.
+ */
 export declare function selectResponseFormatter(handler: HandlerDescriptor, request: FrameworkRequest, contentNegotiation: ResolvedContentNegotiation): ResponseFormatter;
 //# sourceMappingURL=dispatch-content-negotiation.d.ts.map

package/dist/dispatch/dispatch-content-negotiation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch-content-negotiation.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-content-negotiation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAQrB,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AA2GD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAAG,0BAA0B,GAAG,SAAS,CA+BhI;AAqCD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,gBAAgB,EACzB,kBAAkB,EAAE,0BAA0B,GAC7C,iBAAiB,CA2CnB"}
+{"version":3,"file":"dispatch-content-negotiation.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-content-negotiation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAQrB;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AA2GD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,GAAG,0BAA0B,GAAG,SAAS,CA+BhI;AAqCD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,gBAAgB,EACzB,kBAAkB,EAAE,0BAA0B,GAC7C,iBAAiB,CA2CnB"}

package/dist/dispatch/dispatch-content-negotiation.js

@@ -1,4 +1,9 @@
 import { NotAcceptableException } from '../exceptions.js';
+
+/**
+ * Describes the resolved content negotiation contract.
+ */
+
 const NO_ACCEPTABLE_REPRESENTATION_MESSAGE = 'No acceptable response representation found.';
 function normalizeMediaType(value) {
   return value.split(';')[0]?.trim().toLowerCase() ?? '';
@@ -77,6 +82,13 @@ function matchesMediaRange(mediaRange, mediaType) {
   }
   return rangeSubtype === '*' || rangeSubtype === mediaTypeSubtype;
 }
+
+/**
+ * Resolve content negotiation.
+ *
+ * @param options The options.
+ * @returns The resolve content negotiation result.
+ */
 export function resolveContentNegotiation(options) {
   if (!options?.formatters?.length) {
     return undefined;
@@ -128,6 +140,15 @@ function resolveDefaultFormatter(allowedFormatters, allowedNormalizedMediaTypes,
   const idx = allowedNormalizedMediaTypes.indexOf(defaultMediaType);
   return idx >= 0 ? allowedFormatters[idx] : allowedFormatters[0] ?? contentNegotiation.defaultFormatter;
 }
+
+/**
+ * Select response formatter.
+ *
+ * @param handler The handler.
+ * @param request The request.
+ * @param contentNegotiation The content negotiation.
+ * @returns The select response formatter result.
+ */
 export function selectResponseFormatter(handler, request, contentNegotiation) {
   const {
     formatters: allowedFormatters,

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

@@ -1,3 +1,11 @@
 import type { FrameworkResponse } from '../types.js';
+/**
+ * Write error response.
+ *
+ * @param error The error.
+ * @param response The response.
+ * @param requestId The request id.
+ * @returns The write error response result.
+ */
 export declare function writeErrorResponse(error: unknown, response: FrameworkResponse, requestId?: string): Promise<void>;
 //# sourceMappingURL=dispatch-error-policy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dispatch-error-policy.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-error-policy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAiBrD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvH"}
+{"version":3,"file":"dispatch-error-policy.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-error-policy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAiBrD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvH"}

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

@@ -14,6 +14,15 @@ function toHttpException(error) {
     cause: error
   });
 }
+
+/**
+ * Write error response.
+ *
+ * @param error The error.
+ * @param response The response.
+ * @param requestId The request id.
+ * @returns The write error response result.
+ */
 export async function writeErrorResponse(error, response, requestId) {
   if (response.committed) {
     return;

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

@@ -1,3 +1,13 @@
+import type { RequestScopeContainer } from '@fluojs/di';
 import type { Binder, HandlerDescriptor, RequestContext } from '../types.js';
-export declare function invokeControllerHandler(handler: HandlerDescriptor, requestContext: RequestContext, binder?: Binder): Promise<unknown>;
+/**
+ * Invoke controller handler.
+ *
+ * @param handler The handler.
+ * @param requestContext The request context.
+ * @param binder The binder.
+ * @param controllerContainer Container used for resolving the controller instance before handler invocation.
+ * @returns The invoke controller handler result.
+ */
+export declare function invokeControllerHandler(handler: HandlerDescriptor, requestContext: RequestContext, binder?: Binder, controllerContainer?: RequestScopeContainer): Promise<unknown>;
 //# sourceMappingURL=dispatch-handler-policy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dispatch-handler-policy.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-handler-policy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA2B,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKtG,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,iBAAiB,EAC1B,cAAc,EAAE,cAAc,EAC9B,MAAM,GAAE,MAAsB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAuBlB"}
+{"version":3,"file":"dispatch-handler-policy.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-handler-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAKxD,OAAO,KAAK,EAA2B,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKtG;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,iBAAiB,EAC1B,cAAc,EAAE,cAAc,EAC9B,MAAM,GAAE,MAAsB,EAC9B,mBAAmB,GAAE,qBAAgD,GACpE,OAAO,CAAC,OAAO,CAAC,CAwBlB"}

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

@@ -1,10 +1,21 @@
 import { InvariantError } from '@fluojs/core';
 import { DefaultBinder } from '../adapters/binding.js';
+import { getCompiledDtoBindingPlan } from '../adapters/dto-binding-plan.js';
 import { HttpDtoValidationAdapter } from '../adapters/dto-validation-adapter.js';
 const defaultBinder = new DefaultBinder();
 const defaultValidator = new HttpDtoValidationAdapter();
-export async function invokeControllerHandler(handler, requestContext, binder = defaultBinder) {
-  const controller = await requestContext.container.resolve(handler.controllerToken);
+
+/**
+ * Invoke controller handler.
+ *
+ * @param handler The handler.
+ * @param requestContext The request context.
+ * @param binder The binder.
+ * @param controllerContainer Container used for resolving the controller instance before handler invocation.
+ * @returns The invoke controller handler result.
+ */
+export async function invokeControllerHandler(handler, requestContext, binder = defaultBinder, controllerContainer = requestContext.container) {
+  const controller = await controllerContainer.resolve(handler.controllerToken);
   const method = controller[handler.methodName];
   if (typeof method !== 'function') {
     throw new InvariantError(`Controller ${handler.controllerToken.name} does not expose handler method ${handler.methodName}.`);
@@ -13,9 +24,10 @@ export async function invokeControllerHandler(handler, requestContext, binder =
     handler,
     requestContext
   };
-  const input = handler.route.request ? await binder.bind(handler.route.request, argumentResolverContext) : undefined;
-  if (handler.route.request) {
-    await defaultValidator.validate(input, handler.route.request);
+  const requestDto = handler.route.request;
+  const input = requestDto ? await binder.bind(requestDto, argumentResolverContext) : undefined;
+  if (requestDto && getCompiledDtoBindingPlan(requestDto).needsValidation) {
+    await defaultValidator.validate(input, requestDto);
   }
   return method.call(controller, input, requestContext);
 }

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

@@ -1,7 +1,17 @@
 import { resolveContentNegotiation, type ResolvedContentNegotiation } from './dispatch-content-negotiation.js';
 import { writeErrorResponse } from './dispatch-error-policy.js';
 import type { FrameworkRequest, FrameworkResponse, HandlerDescriptor } from '../types.js';
-export declare function writeSuccessResponse(handler: HandlerDescriptor, request: FrameworkRequest, response: FrameworkResponse, value: unknown, contentNegotiation: ResolvedContentNegotiation | undefined): Promise<void>;
+/**
+ * Write success response.
+ *
+ * @param handler The handler.
+ * @param request The request.
+ * @param response The response.
+ * @param value The value.
+ * @param contentNegotiation The content negotiation.
+ * @returns The write success response result.
+ */
+export declare function writeSuccessResponse(handler: HandlerDescriptor, request: FrameworkRequest, response: FrameworkResponse, value: unknown, contentNegotiation: ResolvedContentNegotiation | undefined): ReturnType<FrameworkResponse['send']> | void;
 export { resolveContentNegotiation, writeErrorResponse };
 export type { ResolvedContentNegotiation };
 //# sourceMappingURL=dispatch-response-policy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dispatch-response-policy.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-response-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EAEzB,KAAK,0BAA0B,EAChC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAcrB,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,OAAO,EACd,kBAAkB,EAAE,0BAA0B,GAAG,SAAS,GACzD,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,CAAC;AACzD,YAAY,EAAE,0BAA0B,EAAE,CAAC"}
+{"version":3,"file":"dispatch-response-policy.d.ts","sourceRoot":"","sources":["../../src/dispatch/dispatch-response-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EAEzB,KAAK,0BAA0B,EAChC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAgErB;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,OAAO,EACd,kBAAkB,EAAE,0BAA0B,GAAG,SAAS,GACzD,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAwC9C;AAED,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,CAAC;AACzD,YAAY,EAAE,0BAA0B,EAAE,CAAC"}

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

@@ -11,7 +11,46 @@ function resolveDefaultSuccessStatus(handler, value) {
       return 200;
   }
 }
-export async function writeSuccessResponse(handler, request, response, value, contentNegotiation) {
+function canUseSimpleJsonFastPath(response, value) {
+  return isSimpleJsonResponseBody(value) && !isResponseBodyForbidden(response.statusCode) && hasJsonCompatibleContentType(response);
+}
+function hasSimpleJsonResponseWriter(response) {
+  return typeof response.sendSimpleJson === 'function';
+}
+function isSimpleJsonResponseBody(value) {
+  if (Array.isArray(value)) {
+    return true;
+  }
+  return typeof value === 'object' && value !== null && Object.getPrototypeOf(value) === Object.prototype;
+}
+function isResponseBodyForbidden(status) {
+  return status === 204 || status === 205 || status === 304;
+}
+function hasJsonCompatibleContentType(response) {
+  const contentType = readHeader(response.headers, 'content-type');
+  return contentType === undefined || isJsonContentType(contentType);
+}
+function readHeader(headers, name) {
+  const lowerName = name.toLowerCase();
+  const entry = Object.entries(headers).find(([headerName]) => headerName.toLowerCase() === lowerName);
+  const value = entry?.[1];
+  return typeof value === 'string' ? value : undefined;
+}
+function isJsonContentType(contentType) {
+  return contentType.toLowerCase().includes('application/json') || contentType.toLowerCase().endsWith('+json');
+}
+
+/**
+ * Write success response.
+ *
+ * @param handler The handler.
+ * @param request The request.
+ * @param response The response.
+ * @param value The value.
+ * @param contentNegotiation The content negotiation.
+ * @returns The write success response result.
+ */
+export function writeSuccessResponse(handler, request, response, value, contentNegotiation) {
   if (response.committed) {
     return;
   }
@@ -39,7 +78,10 @@ export async function writeSuccessResponse(handler, request, response, value, co
   } else if (response.statusSet !== true) {
     response.setStatus(resolveDefaultSuccessStatus(handler, value));
   }
+  if (!formatter && hasSimpleJsonResponseWriter(response) && canUseSimpleJsonFastPath(response, value)) {
+    return response.sendSimpleJson(value);
+  }
   const responseBody = formatter ? formatter.format(value) : value;
-  await response.send(responseBody);
+  return response.send(responseBody);
 }
 export { resolveContentNegotiation, writeErrorResponse };