clear-router 2.9.1 → 2.9.2

package/dist/core/bindings.mjs

@@ -1,54 +1,189 @@
 import { Request } from "./Request.mjs";
 import { Response } from "./Response.mjs";
+import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/core/bindings.ts
 const metadataKey = Symbol.for("clear-router:binding-metadata");
 const bindings = /* @__PURE__ */ new WeakMap();
-var Container = class {
-	static registry = /* @__PURE__ */ new Map();
-	static bind(token, value) {
-		this.registry.set(token, value);
+var InjectionToken = class {
+	key;
+	constructor(description) {
+		this.description = description;
+		this.key = Symbol(description);
+	}
+	toString() {
+		return `InjectionToken(${this.description})`;
+	}
+};
+var ContainerResolutionError = class extends Error {
+	constructor(message, path) {
+		super(`${message}\nResolution path: ${path.map(describeToken).join(" -> ")}`);
+		this.path = path;
+		this.name = "ContainerResolutionError";
+	}
+};
+var Container = class Container {
+	static activeScope = new AsyncLocalStorage();
+	static containers = /* @__PURE__ */ new Set();
+	static globalContainer = new Container();
+	registry = /* @__PURE__ */ new Map();
+	instances = /* @__PURE__ */ new Map();
+	pending = /* @__PURE__ */ new Map();
+	constructor(parent, context, requestScope = false) {
+		this.parent = parent;
+		this.context = context;
+		this.requestScope = requestScope;
+	}
+	static get global() {
+		return this.globalContainer;
+	}
+	static current() {
+		return this.activeScope.getStore() ?? this.globalContainer;
+	}
+	static run(container, callback) {
+		return this.activeScope.run(container, callback);
+	}
+	static create(parent = this.globalContainer) {
+		const container = new Container(parent);
+		this.containers.add(container);
+		return container;
+	}
+	createRequestScope(ctx) {
+		return new Container(this, ctx, true);
+	}
+	static bind(token, value, options) {
+		this.globalContainer.bind(token, value, options);
 	}
 	static unbind(token) {
-		this.registry.delete(token);
+		this.globalContainer.unbind(token);
 	}
 	static clear() {
-		this.registry.clear();
+		this.globalContainer.clear();
+		for (const container of this.containers) container.clear();
 	}
 	static has(token) {
-		return this.registry.has(token) || Boolean(this.findEquivalentToken(token));
+		return this.current().has(token);
 	}
 	static bindings() {
-		return Object.fromEntries(this.registry.entries());
+		return this.current().bindings();
 	}
 	static async resolve(token, ctx, autoDiscover = false) {
-		if (token === Request) return ctx.clearRequest;
-		if (token === Response) return ctx.clearResponse;
-		const binding = this.getBinding(token);
-		if (binding) return this.resolveBinding(binding, ctx, autoDiscover);
-		if (autoDiscover && typeof token === "function") return new token();
-	}
-	static getBinding(token) {
-		if (this.registry.has(token)) return this.registry.get(token);
+		return this.current().resolve(token, ctx, autoDiscover);
+	}
+	bind(token, value, options) {
+		this.registry.set(token, normalizeProvider(value, options));
+		this.instances.delete(token);
+	}
+	unbind(token) {
+		this.registry.delete(token);
+		this.instances.delete(token);
+	}
+	clear() {
+		this.registry.clear();
+		this.instances.clear();
+		this.pending.clear();
+	}
+	has(token) {
+		return Boolean(this.findProvider(token));
+	}
+	entries() {
+		const entries = /* @__PURE__ */ new Map();
+		for (const container of this.lineage().reverse()) for (const [token, provider] of container.registry) entries.set(token, provider);
+		return entries;
+	}
+	bindings() {
+		return Object.fromEntries(Array.from(this.entries(), ([token, provider]) => [describeToken(token), provider]));
+	}
+	async resolve(token, ctx = this.context, autoDiscover = false) {
+		return this.resolveToken(token, ctx, {
+			autoDiscover,
+			stack: []
+		});
+	}
+	async resolveOrFail(token, ctx = this.context, autoDiscover = false) {
+		const resolved = await this.resolve(token, ctx, autoDiscover);
+		if (typeof resolved === "undefined") throw new ContainerResolutionError(`Cannot resolve ${describeToken(token)}`, [token]);
+		return resolved;
+	}
+	async resolveToken(token, ctx, state) {
+		if (token === Request) return ctx?.clearRequest;
+		if (token === Response) return ctx?.clearResponse;
+		if (state.stack.includes(token)) throw new ContainerResolutionError(`Circular dependency detected while resolving ${describeToken(token)}`, [...state.stack, token]);
+		const nextState = {
+			...state,
+			stack: [...state.stack, token]
+		};
+		const found = this.findProvider(token);
+		if (found) return this.resolveProvider(found.token, found.provider, found.owner, ctx, nextState);
+		if (state.autoDiscover && typeof token === "function") return this.instantiate(token, void 0, ctx, nextState);
+	}
+	findProvider(token) {
+		if (this.registry.has(token)) return {
+			token,
+			provider: this.registry.get(token),
+			owner: this
+		};
 		const equivalent = this.findEquivalentToken(token);
-		return equivalent ? this.registry.get(equivalent) : void 0;
+		if (equivalent) return {
+			token: equivalent,
+			provider: this.registry.get(equivalent),
+			owner: this
+		};
+		return this.parent?.findProvider(token);
+	}
+	async resolveProvider(token, provider, owner, ctx, state) {
+		if ("useExisting" in provider) return this.resolveToken(provider.useExisting, ctx, state);
+		const cache = provider.scope === "singleton" ? owner : provider.scope === "request" ? this.findRequestScope() : void 0;
+		if (cache?.instances.has(token)) return cache.instances.get(token);
+		if (cache?.pending.has(token)) return cache.pending.get(token);
+		const create = async () => {
+			if ("useValue" in provider) return provider.useValue;
+			if ("useClass" in provider) return this.instantiate(provider.useClass, provider.dependencies, ctx, state);
+			return provider.useFactory(ctx);
+		};
+		if (!cache) return create();
+		const promise = create();
+		cache.pending.set(token, promise);
+		try {
+			const resolved = await promise;
+			if (typeof resolved !== "undefined") cache.instances.set(token, resolved);
+			return resolved;
+		} finally {
+			cache.pending.delete(token);
+		}
+	}
+	async instantiate(Type, dependencies, ctx, state) {
+		const tokens = dependencies ?? getInjectTokens(Type);
+		const args = [];
+		for (const dependency of tokens) {
+			const resolved = await this.resolveToken(dependency, ctx, state);
+			if (typeof resolved === "undefined") throw new ContainerResolutionError(`Cannot resolve ${describeToken(dependency)} required by ${describeToken(Type)}`, [...state.stack, dependency]);
+			args.push(resolved);
+		}
+		return new Type(...args);
 	}
-	static findEquivalentToken(token) {
+	findRequestScope() {
+		if (this.requestScope) return this;
+		return this.parent?.findRequestScope();
+	}
+	lineage() {
+		return [this, ...this.parent?.lineage() ?? []];
+	}
+	findEquivalentToken(token) {
+		if (typeof token !== "function") return void 0;
 		const name = token.name;
-		if (!name) return;
+		if (!name) return void 0;
 		const tokenParent = Object.getPrototypeOf(token);
 		const tokenProps = this.getComparableStaticProps(token);
 		for (const registered of this.registry.keys()) {
-			if (registered === token) continue;
-			if (registered.name !== name) continue;
+			if (typeof registered !== "function" || registered === token || registered.name !== name) continue;
 			const registeredParent = Object.getPrototypeOf(registered);
 			if (tokenParent && registeredParent && tokenParent.name !== registeredParent.name) continue;
 			const registeredProps = this.getComparableStaticProps(registered);
-			if (!this.staticPropsMatch(token, registered, tokenProps, registeredProps)) continue;
-			return registered;
+			if (this.staticPropsMatch(token, registered, tokenProps, registeredProps)) return registered;
 		}
 	}
-	static getComparableStaticProps(token) {
+	getComparableStaticProps(token) {
 		return Object.getOwnPropertyNames(token).filter((prop) => {
 			return ![
 				"length",
@@ -59,23 +194,38 @@ var Container = class {
 			].includes(prop);
 		});
 	}
-	static staticPropsMatch(token, registered, tokenProps, registeredProps) {
+	staticPropsMatch(token, registered, tokenProps, registeredProps) {
 		if (tokenProps.length !== registeredProps.length) return false;
-		for (const prop of tokenProps) {
-			if (!registeredProps.includes(prop)) return false;
-			if (Reflect.get(token, prop) !== Reflect.get(registered, prop)) return false;
-		}
+		for (const prop of tokenProps) if (!registeredProps.includes(prop) || Reflect.get(token, prop) !== Reflect.get(registered, prop)) return false;
 		return true;
 	}
-	static async resolveBinding(binding, ctx, autoDiscover) {
-		if (!binding) return void 0;
-		if (typeof binding !== "function") return binding;
-		if (isClass(binding)) return new binding();
-		const resolved = await binding(ctx);
-		if (typeof resolved === "function" && autoDiscover && isClass(resolved)) return new resolved();
-		return resolved;
-	}
 };
+function normalizeProvider(value, options) {
+	if (isProvider(value)) return {
+		scope: "transient",
+		...value
+	};
+	if (isClass(value)) return {
+		useClass: value,
+		scope: options?.scope ?? "transient"
+	};
+	if (typeof value === "function") return {
+		useFactory: value,
+		scope: options?.scope ?? "transient"
+	};
+	return { useValue: value };
+}
+function isProvider(value) {
+	return Boolean(value && typeof value === "object" && ("useValue" in value || "useClass" in value || "useFactory" in value || "useExisting" in value));
+}
+function getInjectTokens(Type) {
+	return Type.inject ?? getDesignParamTypes(Type);
+}
+function describeToken(token) {
+	if (token instanceof InjectionToken) return token.toString();
+	if (typeof token === "symbol") return token.description ?? token.toString();
+	return token.name || "<anonymous class>";
+}
 function Bind(...tokens) {
 	return ((target, propertyKeyOrContext) => {
 		if (isStandardClassContext(propertyKeyOrContext)) {
@@ -103,6 +253,9 @@ function Bind(...tokens) {
 		});
 	});
 }
+function getMetadataKey() {
+	return metadataKey;
+}
 function getStandardMetadata(metadata, propertyKey) {
 	const store = metadata && metadata[metadataKey];
 	if (!store) return void 0;
@@ -151,4 +304,4 @@ function isClass(value) {
 }
 
 //#endregion
-export { Bind, Container, getBindingMetadataFromTargets, getDesignParamTypes, getStandardMetadata, isClass };
+export { Bind, Container, ContainerResolutionError, InjectionToken, getBindingMetadata, getBindingMetadataFromTargets, getDesignParamTypes, getMetadataKey, getStandardMetadata, isClass, setBindingMetadata, setStandardMetadata };

package/dist/core/index.cjs

@@ -3,16 +3,29 @@ const require_helpers = require('./helpers.cjs');
 const require_RouteGroup = require('../RouteGroup.cjs');
 const require_Request = require('./Request.cjs');
 const require_Response = require('./Response.cjs');
+const require_bindings = require('./bindings.cjs');
 const require_plugins = require('./plugins.cjs');
 const require_middleware = require('../decorators/middleware.cjs');
 const require_CoreRouter = require('./CoreRouter.cjs');
 
+exports.Bind = require_bindings.Bind;
+exports.Container = require_bindings.Container;
+exports.ContainerResolutionError = require_bindings.ContainerResolutionError;
 exports.CoreRouter = require_CoreRouter.CoreRouter;
+exports.InjectionToken = require_bindings.InjectionToken;
 exports.Request = require_Request.Request;
 exports.Response = require_Response.Response;
 exports.RouteGroup = require_RouteGroup.RouteGroup;
 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.setBindingMetadata = require_bindings.setBindingMetadata;
+exports.setStandardMetadata = require_bindings.setStandardMetadata;
 exports.wrap = require_helpers.wrap;

package/dist/core/index.d.cts

@@ -1,8 +1,9 @@
 import { Response } from "./Response.cjs";
 import { Request } from "./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 "./bindings.cjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./plugins.cjs";
 import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "../decorators/middleware.cjs";
 import { RouteGroup } from "../RouteGroup.cjs";
 import { CoreRouter } from "./CoreRouter.cjs";
 import { importFile, wrap } from "./helpers.cjs";
-export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, RouteGroup, definePlugin, getControllerMiddlewares, importFile, middleware, wrap };
+export { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Container, ContainerResolutionError, CoreRouter, ExistingProvider, FactoryProvider, InjectionToken, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, RouteGroup, ValueProvider, definePlugin, getBindingMetadata, getBindingMetadataFromTargets, getControllerMiddlewares, getDesignParamTypes, getMetadataKey, getStandardMetadata, importFile, isClass, middleware, setBindingMetadata, setStandardMetadata, wrap };

package/dist/core/index.d.mts

@@ -1,8 +1,9 @@
 import { Response } from "./Response.mjs";
 import { Request } from "./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 "./bindings.mjs";
 import { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, definePlugin } from "./plugins.mjs";
 import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "../decorators/middleware.mjs";
 import { RouteGroup } from "../RouteGroup.mjs";
 import { CoreRouter } from "./CoreRouter.mjs";
 import { importFile, wrap } from "./helpers.mjs";
-export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, RouteGroup, definePlugin, getControllerMiddlewares, importFile, middleware, wrap };
+export { Bind, BindClass, BindDecorator, BindFactory, BindProvider, BindToken, BindValue, BindingOptions, BindingScope, ClassProvider, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Container, ContainerResolutionError, CoreRouter, ExistingProvider, FactoryProvider, InjectionToken, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, RouteGroup, ValueProvider, definePlugin, getBindingMetadata, getBindingMetadataFromTargets, getControllerMiddlewares, getDesignParamTypes, getMetadataKey, getStandardMetadata, importFile, isClass, middleware, setBindingMetadata, setStandardMetadata, wrap };

package/dist/core/index.mjs

@@ -2,8 +2,9 @@ import { importFile, wrap } from "./helpers.mjs";
 import { RouteGroup } from "../RouteGroup.mjs";
 import { Request } from "./Request.mjs";
 import { Response } from "./Response.mjs";
+import { Bind, Container, ContainerResolutionError, InjectionToken, getBindingMetadata, getBindingMetadataFromTargets, getDesignParamTypes, getMetadataKey, getStandardMetadata, isClass, setBindingMetadata, setStandardMetadata } from "./bindings.mjs";
 import { definePlugin } from "./plugins.mjs";
 import { getControllerMiddlewares, middleware } from "../decorators/middleware.mjs";
 import { CoreRouter } from "./CoreRouter.mjs";
 
-export { CoreRouter, Request, Response, RouteGroup, definePlugin, getControllerMiddlewares, importFile, middleware, wrap };
+export { Bind, Container, ContainerResolutionError, CoreRouter, InjectionToken, Request, Response, RouteGroup, definePlugin, getBindingMetadata, getBindingMetadataFromTargets, getControllerMiddlewares, getDesignParamTypes, getMetadataKey, getStandardMetadata, importFile, isClass, middleware, setBindingMetadata, setStandardMetadata, wrap };

package/dist/core/plugins.d.cts

@@ -1,7 +1,7 @@
 import { Response } from "./Response.cjs";
 import { RouterConfig } from "../types/basic.cjs";
 import { Request } from "./Request.cjs";
-import { BindToken, BindValue, Container } from "./bindings.cjs";
+import { BindToken, BindValue, BindingOptions, Container } from "./bindings.cjs";
 
 //#region src/core/plugins.d.ts
 type PluginSetupResult = void | Promise<void>;
@@ -22,13 +22,13 @@ interface ClearRouterPluginArgumentsContext<X = any> extends ClearRouterPluginRe
 }
 type PluginBindFactory<T = any, X = any> = (ctx: ClearRouterPluginRequestContext<X>) => T | Promise<T>;
 type PluginBindValue<T = any, X = any> = BindValue<T> | PluginBindFactory<T, X>;
-type PluginBind<X = any> = <T>(token: BindToken<T>, value: PluginBindValue<T, X>) => void;
+type PluginBind<X = any> = <T>(token: BindToken<T>, value: PluginBindValue<T, X>, options?: BindingOptions) => void;
 type PluginArgumentsResolver<HttpContext = any> = (ctx: ClearRouterPluginArgumentsContext<HttpContext>) => any[] | undefined | Promise<any[] | undefined>;
 interface ClearRouterPluginContext<Options = any, HttpContext = any> {
   /**
    * The service container
    */
-  container: typeof Container;
+  container: Container;
   /**
    * Register service container bindings
    */
@@ -97,7 +97,7 @@ interface ClearRouterPlugin<Options = any, HttpContext = any> {
    */
   setup: (ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult;
 }
-type ClearRouterPluginInput<Options = any, HttpContext = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult);
+type ClearRouterPluginInput<Options = any, HttpContext = any> = ClearRouterPlugin<Options, HttpContext> | ((ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult);
 /**
  * Creates a new plugin
  *

package/dist/core/plugins.d.mts

@@ -1,7 +1,7 @@
 import { Response } from "./Response.mjs";
 import { RouterConfig } from "../types/basic.mjs";
 import { Request } from "./Request.mjs";
-import { BindToken, BindValue, Container } from "./bindings.mjs";
+import { BindToken, BindValue, BindingOptions, Container } from "./bindings.mjs";
 
 //#region src/core/plugins.d.ts
 type PluginSetupResult = void | Promise<void>;
@@ -22,13 +22,13 @@ interface ClearRouterPluginArgumentsContext<X = any> extends ClearRouterPluginRe
 }
 type PluginBindFactory<T = any, X = any> = (ctx: ClearRouterPluginRequestContext<X>) => T | Promise<T>;
 type PluginBindValue<T = any, X = any> = BindValue<T> | PluginBindFactory<T, X>;
-type PluginBind<X = any> = <T>(token: BindToken<T>, value: PluginBindValue<T, X>) => void;
+type PluginBind<X = any> = <T>(token: BindToken<T>, value: PluginBindValue<T, X>, options?: BindingOptions) => void;
 type PluginArgumentsResolver<HttpContext = any> = (ctx: ClearRouterPluginArgumentsContext<HttpContext>) => any[] | undefined | Promise<any[] | undefined>;
 interface ClearRouterPluginContext<Options = any, HttpContext = any> {
   /**
    * The service container
    */
-  container: typeof Container;
+  container: Container;
   /**
    * Register service container bindings
    */
@@ -97,7 +97,7 @@ interface ClearRouterPlugin<Options = any, HttpContext = any> {
    */
   setup: (ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult;
 }
-type ClearRouterPluginInput<Options = any, HttpContext = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult);
+type ClearRouterPluginInput<Options = any, HttpContext = any> = ClearRouterPlugin<Options, HttpContext> | ((ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult);
 /**
  * Creates a new plugin
  *

package/dist/decorators/index.cjs

@@ -1,8 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_middleware = require('./middleware.cjs');
 const require_bindings = require('../core/bindings.cjs');
+const require_middleware = require('./middleware.cjs');
 
 exports.Bind = require_bindings.Bind;
 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/index.d.cts

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

package/dist/decorators/index.d.mts

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

package/dist/decorators/index.mjs

@@ -1,4 +1,4 @@
+import { Bind, Container, ContainerResolutionError, InjectionToken } from "../core/bindings.mjs";
 import { getControllerMiddlewares, middleware } from "./middleware.mjs";
-import { Bind, Container } from "../core/bindings.mjs";
 
-export { Bind, Container, getControllerMiddlewares, middleware };
+export { Bind, Container, ContainerResolutionError, InjectionToken, getControllerMiddlewares, middleware };

package/dist/decorators/setup.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_middleware = require('./middleware.cjs');
 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");
@@ -14,5 +14,7 @@ require_CoreRouter.CoreRouter.configureDefaults({ container: {
 //#endregion
 exports.Bind = require_bindings.Bind;
 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,3 +1,3 @@
-import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.cjs";
+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, BindDecorator, BindFactory, BindToken, BindValue, Container, MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware };
+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,3 +1,3 @@
-import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.mjs";
+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, BindDecorator, BindFactory, BindToken, BindValue, Container, MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware };
+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,5 +1,5 @@
+import { Bind, Container, ContainerResolutionError, InjectionToken } from "../core/bindings.mjs";
 import { getControllerMiddlewares, middleware } from "./middleware.mjs";
-import { Bind, Container } from "../core/bindings.mjs";
 import { CoreRouter } from "../core/CoreRouter.mjs";
 import "./index.mjs";
 import "reflect-metadata";
@@ -11,4 +11,4 @@ CoreRouter.configureDefaults({ container: {
 } });
 
 //#endregion
-export { Bind, Container, getControllerMiddlewares, middleware };
+export { Bind, Container, ContainerResolutionError, InjectionToken, getControllerMiddlewares, middleware };

package/dist/index.cjs

@@ -7,22 +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,6 +3,7 @@ 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";
@@ -10,4 +11,4 @@ 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, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, definePlugin, getControllerMiddlewares, importFile, middleware, 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,6 +3,7 @@ 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";
@@ -10,4 +11,4 @@ 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, MiddlewareDecorator, MiddlewareInput, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, Route, RouteGroup, RouteParameter, RouteRegistrar, RouteRegistrarGroupFactory, definePlugin, getControllerMiddlewares, importFile, middleware, 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,9 +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, getControllerMiddlewares, importFile, middleware, 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.1",
+  "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",