clear-router 2.9.0 → 2.9.2

package/dist/decorators/middleware.mjs

@@ -0,0 +1,98 @@
+//#region src/decorators/middleware.ts
+const CLASS_KEY = "__class__";
+const metadataKey = Symbol.for("clear-router:middleware-metadata");
+const store = /* @__PURE__ */ new WeakMap();
+/**
+* Attach one or more middleware to a controller class or a controller method.
+*
+* @example
+* ```ts
+* @Middleware([auth])
+* class AccountController {}
+*
+* class LoginController {
+*     @Middleware(GuestMiddleware)
+*     create () {}
+* }
+* ```
+*
+* Accepts the middleware variadically or as arrays, and every supported
+* middleware shape: callbacks, middleware classes, or instances exposing a
+* `handle` method.
+*
+* @param middlewares
+* @returns
+*/
+function middleware(...middlewares) {
+	const flattened = middlewares.flat();
+	return ((target, propertyKeyOrContext) => {
+		if (isStandardClassContext(propertyKeyOrContext)) {
+			setClassMiddlewareMetadata(target, flattened);
+			setStandardMetadata(propertyKeyOrContext.metadata, CLASS_KEY, flattened);
+			return;
+		}
+		if (isStandardMethodContext(propertyKeyOrContext)) {
+			setStandardMetadata(propertyKeyOrContext.metadata, propertyKeyOrContext.name, flattened);
+			return;
+		}
+		if (typeof propertyKeyOrContext === "undefined") {
+			setClassMiddlewareMetadata(target, flattened);
+			return;
+		}
+		setMiddlewareMetadata(target, propertyKeyOrContext, flattened);
+	});
+}
+/**
+* Collect the decorator-declared middleware for a controller route handler,
+* ordered class-level first then method-level. Returns an empty array for
+* non-controller (callback) handlers or handlers without any decorators.
+*
+* @param handler
+* @returns
+*/
+function getControllerMiddlewares(handler) {
+	if (!Array.isArray(handler) || handler.length !== 2) return [];
+	const [controller, method] = handler;
+	if (!controller) return [];
+	const constructor = typeof controller === "function" ? controller : controller.constructor;
+	const prototype = typeof controller === "function" ? controller.prototype : Object.getPrototypeOf(controller);
+	const standardMetadata = constructor?.[Symbol.metadata];
+	const classMiddlewares = getMiddlewareMetadata(constructor, CLASS_KEY) ?? getMiddlewareMetadata(prototype, CLASS_KEY) ?? getStandardMetadata(standardMetadata, CLASS_KEY) ?? [];
+	const methodMiddlewares = getMiddlewareMetadata(prototype, method) ?? getMiddlewareMetadata(constructor, method) ?? getStandardMetadata(standardMetadata, method) ?? [];
+	return [...classMiddlewares, ...methodMiddlewares];
+}
+function setClassMiddlewareMetadata(target, middlewares) {
+	setMiddlewareMetadata(target, CLASS_KEY, middlewares);
+	const prototype = target.prototype;
+	if (prototype) setMiddlewareMetadata(prototype, CLASS_KEY, middlewares);
+}
+function setMiddlewareMetadata(target, propertyKey, middlewares) {
+	const map = store.get(target) ?? /* @__PURE__ */ new Map();
+	const existing = map.get(propertyKey);
+	map.set(propertyKey, existing ? [...existing, ...middlewares] : middlewares);
+	store.set(target, map);
+}
+function getMiddlewareMetadata(target, propertyKey) {
+	if (!target) return void 0;
+	return store.get(target)?.get(propertyKey);
+}
+function setStandardMetadata(metadata, propertyKey, middlewares) {
+	if (!metadata) return;
+	const record = metadata;
+	record[metadataKey] = record[metadataKey] ?? {};
+	const existing = record[metadataKey][propertyKey];
+	record[metadataKey][propertyKey] = existing ? [...existing, ...middlewares] : middlewares;
+}
+function getStandardMetadata(metadata, propertyKey) {
+	const record = metadata && metadata[metadataKey];
+	return record ? record[propertyKey] : void 0;
+}
+function isStandardMethodContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "method" && typeof value.name !== "undefined");
+}
+function isStandardClassContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "class" && typeof value.name !== "undefined");
+}
+
+//#endregion
+export { getControllerMiddlewares, middleware };

package/dist/decorators/setup.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_bindings = require('../core/bindings.cjs');
+const require_middleware = require('./middleware.cjs');
 const require_CoreRouter = require('../core/CoreRouter.cjs');
 require('./index.cjs');
 require("reflect-metadata");
@@ -12,4 +13,8 @@ require_CoreRouter.CoreRouter.configureDefaults({ container: {
 
 //#endregion
 exports.Bind = require_bindings.Bind;
-exports.Container = require_bindings.Container;
+exports.Container = require_bindings.Container;
+exports.ContainerResolutionError = require_bindings.ContainerResolutionError;
+exports.InjectionToken = require_bindings.InjectionToken;
+exports.getControllerMiddlewares = require_middleware.getControllerMiddlewares;
+exports.middleware = require_middleware.middleware;

package/dist/decorators/setup.d.cts

@@ -1,2 +1,3 @@
-import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.cjs";
-export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container };
+import { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, Container, ContainerResolutionError, ExistingProvider, FactoryProvider, InjectionToken, ValueProvider } from "../core/bindings.cjs";
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./middleware.cjs";
+export { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, Container, ContainerResolutionError, ExistingProvider, FactoryProvider, InjectionToken, MiddlewareDecorator, MiddlewareInput, ValueProvider, getControllerMiddlewares, middleware };

package/dist/decorators/setup.d.mts

@@ -1,2 +1,3 @@
-import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.mjs";
-export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container };
+import { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, Container, ContainerResolutionError, ExistingProvider, FactoryProvider, InjectionToken, ValueProvider } from "../core/bindings.mjs";
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./middleware.mjs";
+export { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, Container, ContainerResolutionError, ExistingProvider, FactoryProvider, InjectionToken, MiddlewareDecorator, MiddlewareInput, ValueProvider, getControllerMiddlewares, middleware };

package/dist/decorators/setup.mjs

@@ -1,4 +1,5 @@
-import { Bind, Container } from "../core/bindings.mjs";
+import { Bind, Container, ContainerResolutionError, InjectionToken } from "../core/bindings.mjs";
+import { getControllerMiddlewares, middleware } from "./middleware.mjs";
 import { CoreRouter } from "../core/CoreRouter.mjs";
 import "./index.mjs";
 import "reflect-metadata";
@@ -10,4 +11,4 @@ CoreRouter.configureDefaults({ container: {
 } });
 
 //#endregion
-export { Bind, Container };
+export { Bind, Container, ContainerResolutionError, InjectionToken, getControllerMiddlewares, middleware };

package/dist/index.cjs

@@ -7,19 +7,35 @@ const require_RouteGroup = require('./RouteGroup.cjs');
 const require_RouteRegistrar = require('./RouteRegistrar.cjs');
 const require_Request = require('./core/Request.cjs');
 const require_Response = require('./core/Response.cjs');
+const require_bindings = require('./core/bindings.cjs');
 const require_plugins = require('./core/plugins.cjs');
+const require_middleware = require('./decorators/middleware.cjs');
 const require_CoreRouter = require('./core/CoreRouter.cjs');
 require('./core/index.cjs');
 
+exports.Bind = require_bindings.Bind;
 exports.ClearRequest = require_ClearRequest.ClearRequest;
+exports.Container = require_bindings.Container;
+exports.ContainerResolutionError = require_bindings.ContainerResolutionError;
 exports.Controller = require_Controller.Controller;
 exports.CoreRouter = require_CoreRouter.CoreRouter;
+exports.InjectionToken = require_bindings.InjectionToken;
 exports.Request = require_Request.Request;
 exports.Response = require_Response.Response;
 exports.Route = require_Route.Route;
 exports.RouteGroup = require_RouteGroup.RouteGroup;
 exports.RouteRegistrar = require_RouteRegistrar.RouteRegistrar;
 exports.definePlugin = require_plugins.definePlugin;
+exports.getBindingMetadata = require_bindings.getBindingMetadata;
+exports.getBindingMetadataFromTargets = require_bindings.getBindingMetadataFromTargets;
+exports.getControllerMiddlewares = require_middleware.getControllerMiddlewares;
+exports.getDesignParamTypes = require_bindings.getDesignParamTypes;
+exports.getMetadataKey = require_bindings.getMetadataKey;
+exports.getStandardMetadata = require_bindings.getStandardMetadata;
 exports.importFile = require_helpers.importFile;
+exports.isClass = require_bindings.isClass;
+exports.middleware = require_middleware.middleware;
 exports.parseDomainParameters = require_Route.parseDomainParameters;
+exports.setBindingMetadata = require_bindings.setBindingMetadata;
+exports.setStandardMetadata = require_bindings.setStandardMetadata;
 exports.wrap = require_helpers.wrap;

package/dist/index.d.cts

@@ -3,10 +3,12 @@ import { Response } from "./core/Response.cjs";
 import { ClearRequest } from "./ClearRequest.cjs";
 import { Route, parseDomainParameters } from "./Route.cjs";
 import { Request } from "./core/Request.cjs";
+import { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, Container, ContainerResolutionError, ExistingProvider, FactoryProvider, InjectionToken, ValueProvider, getBindingMetadata, getBindingMetadataFromTargets, getDesignParamTypes, getMetadataKey, getStandardMetadata, isClass, setBindingMetadata, setStandardMetadata } from "./core/bindings.cjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./core/plugins.cjs";
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./decorators/middleware.cjs";
 import { Controller } from "./Controller.cjs";
 import { RouteGroup } from "./RouteGroup.cjs";
 import { RouteRegistrar, RouteRegistrarGroupFactory } from "./RouteRegistrar.cjs";
 import { CoreRouter } from "./core/CoreRouter.cjs";
 import { importFile, wrap } from "./core/helpers.cjs";
-export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, definePlugin, importFile, parseDomainParameters, wrap };
+export { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Container, ContainerResolutionError, Controller, CoreRouter, ExistingProvider, FactoryProvider, InjectionToken, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, ValueProvider, definePlugin, getBindingMetadata, getBindingMetadataFromTargets, getControllerMiddlewares, getDesignParamTypes, getMetadataKey, getStandardMetadata, importFile, isClass, middleware, parseDomainParameters, setBindingMetadata, setStandardMetadata, wrap };

package/dist/index.d.mts

@@ -3,10 +3,12 @@ import { Response } from "./core/Response.mjs";
 import { ClearRequest } from "./ClearRequest.mjs";
 import { Route, parseDomainParameters } from "./Route.mjs";
 import { Request } from "./core/Request.mjs";
+import { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, Container, ContainerResolutionError, ExistingProvider, FactoryProvider, InjectionToken, ValueProvider, getBindingMetadata, getBindingMetadataFromTargets, getDesignParamTypes, getMetadataKey, getStandardMetadata, isClass, setBindingMetadata, setStandardMetadata } from "./core/bindings.mjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./core/plugins.mjs";
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./decorators/middleware.mjs";
 import { Controller } from "./Controller.mjs";
 import { RouteGroup } from "./RouteGroup.mjs";
 import { RouteRegistrar, RouteRegistrarGroupFactory } from "./RouteRegistrar.mjs";
 import { CoreRouter } from "./core/CoreRouter.mjs";
 import { importFile, wrap } from "./core/helpers.mjs";
-export { ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, definePlugin, importFile, parseDomainParameters, wrap };
+export { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, ClearHttpContext, ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Container, ContainerResolutionError, Controller, CoreRouter, ExistingProvider, FactoryProvider, InjectionToken, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, ValueProvider, definePlugin, getBindingMetadata, getBindingMetadataFromTargets, getControllerMiddlewares, getDesignParamTypes, getMetadataKey, getStandardMetadata, importFile, isClass, middleware, parseDomainParameters, setBindingMetadata, setStandardMetadata, wrap };

package/dist/index.mjs

@@ -6,8 +6,10 @@ import { RouteGroup } from "./RouteGroup.mjs";
 import { RouteRegistrar } from "./RouteRegistrar.mjs";
 import { Request } from "./core/Request.mjs";
 import { Response } from "./core/Response.mjs";
+import { Bind, Container, ContainerResolutionError, InjectionToken, getBindingMetadata, getBindingMetadataFromTargets, getDesignParamTypes, getMetadataKey, getStandardMetadata, isClass, setBindingMetadata, setStandardMetadata } from "./core/bindings.mjs";
 import { definePlugin } from "./core/plugins.mjs";
+import { getControllerMiddlewares, middleware } from "./decorators/middleware.mjs";
 import { CoreRouter } from "./core/CoreRouter.mjs";
 import "./core/index.mjs";
 
-export { ClearRequest, Controller, CoreRouter, Request, Response, Route, RouteGroup, RouteRegistrar, definePlugin, importFile, parseDomainParameters, wrap };
+export { Bind, ClearRequest, Container, ContainerResolutionError, Controller, CoreRouter, InjectionToken, Request, Response, Route, RouteGroup, RouteRegistrar, definePlugin, getBindingMetadata, getBindingMetadataFromTargets, getControllerMiddlewares, getDesignParamTypes, getMetadataKey, getStandardMetadata, importFile, isClass, middleware, parseDomainParameters, setBindingMetadata, setStandardMetadata, wrap };

package/dist/types/basic.d.cts

@@ -56,6 +56,11 @@ interface RouterConfig {
   container?: {
     /** Whether decorated handler parameter binding is enabled */enabled?: boolean; /** Whether unknown constructor tokens should be instantiated automatically */
     autoDiscover?: boolean;
+    /**
+     * Whether unresolved decorated arguments should throw instead of using
+     * the default handler signature
+     */
+    strict?: boolean;
   };
 }
 type ResourceRouteDefinition = {

package/dist/types/basic.d.mts

@@ -56,6 +56,11 @@ interface RouterConfig {
   container?: {
     /** Whether decorated handler parameter binding is enabled */enabled?: boolean; /** Whether unknown constructor tokens should be instantiated automatically */
     autoDiscover?: boolean;
+    /**
+     * Whether unresolved decorated arguments should throw instead of using
+     * the default handler signature
+     */
+    strict?: boolean;
   };
 }
 type ResourceRouteDefinition = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-router",
-  "version": "2.9.0",
+  "version": "2.9.2",
   "description": "Laravel-style routing for Node.js with support for Express, H3, Fastify, Hono, and Koa, including CommonJS, ESM, and TypeScript support.",
   "keywords": [
     "h3",