clear-router 2.5.6 → 2.5.8

package/dist/{bindings-DIanvIVd.mjs → bindings-DJDdQv1q.mjs}

@@ -208,4 +208,4 @@ function isClass(value) {
 }
 
 //#endregion
-export { getStandardMetadata as a, getDesignParamTypes as i, Container as n, Response as o, getBindingMetadataFromTargets as r, Request as s, Bind as t };
+export { getStandardMetadata as a, Request as c, getDesignParamTypes as i, Container as n, isClass as o, getBindingMetadataFromTargets as r, Response as s, Bind as t };

package/dist/{bindings-DvV2DXWi.cjs → bindings-T0FKpWyi.cjs}

@@ -250,4 +250,10 @@ Object.defineProperty(exports, 'getStandardMetadata', {
   get: function () {
     return getStandardMetadata;
   }
+});
+Object.defineProperty(exports, 'isClass', {
+  enumerable: true,
+  get: function () {
+    return isClass;
+  }
 });

package/dist/core/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_bindings = require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
+const require_bindings = require('../bindings-T0FKpWyi.cjs');
+const require_router = require('../router-DbPFGTYG.cjs');
 
 //#region src/core/plugins.ts
 function definePlugin(plugin) {

package/dist/core/index.d.cts

@@ -1,2 +1,2 @@
-import { a as PluginBind, c as Request, i as ClearRouterPluginInput, n as ClearRouterPlugin, o as PluginSetupResult, r as ClearRouterPluginContext, s as definePlugin, t as CoreRouter, x as Response } from "../router-BYZmNzrZ.cjs";
-export { ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, CoreRouter, PluginBind, PluginSetupResult, Request, Response, definePlugin };
+import { a as ClearRouterPluginRequestContext, c as PluginBindValue, d as Request, i as ClearRouterPluginInput, l as PluginSetupResult, n as ClearRouterPlugin, o as PluginBind, r as ClearRouterPluginContext, s as PluginBindFactory, t as CoreRouter, u as definePlugin, w as Response } from "../router-CiGcLUZD.cjs";
+export { ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin };

package/dist/core/index.d.mts

@@ -1,2 +1,2 @@
-import { a as PluginBind, c as Request, i as ClearRouterPluginInput, n as ClearRouterPlugin, o as PluginSetupResult, r as ClearRouterPluginContext, s as definePlugin, t as CoreRouter, x as Response } from "../router-DCMtQ_Xi.mjs";
-export { ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, CoreRouter, PluginBind, PluginSetupResult, Request, Response, definePlugin };
+import { a as ClearRouterPluginRequestContext, c as PluginBindValue, d as Request, i as ClearRouterPluginInput, l as PluginSetupResult, n as ClearRouterPlugin, o as PluginBind, r as ClearRouterPluginContext, s as PluginBindFactory, t as CoreRouter, u as definePlugin, w as Response } from "../router-B8l8jerS.mjs";
+export { ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin };

package/dist/core/index.mjs

@@ -1,5 +1,5 @@
-import { o as Response, s as Request } from "../bindings-DIanvIVd.mjs";
-import { t as CoreRouter } from "../router-B3QjblRX.mjs";
+import { c as Request, s as Response } from "../bindings-DJDdQv1q.mjs";
+import { t as CoreRouter } from "../router-we2Hw9nA.mjs";
 
 //#region src/core/plugins.ts
 function definePlugin(plugin) {

package/dist/decorators/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_bindings = require('../bindings-DvV2DXWi.cjs');
+const require_bindings = require('../bindings-T0FKpWyi.cjs');
 
 exports.Bind = require_bindings.Bind;
 exports.Container = require_bindings.Container;

package/dist/decorators/index.mjs

@@ -1,3 +1,3 @@
-import { n as Container, t as Bind } from "../bindings-DIanvIVd.mjs";
+import { n as Container, t as Bind } from "../bindings-DJDdQv1q.mjs";
 
 export { Bind, Container };

package/dist/decorators/setup.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_bindings = require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
+const require_bindings = require('../bindings-T0FKpWyi.cjs');
+const require_router = require('../router-DbPFGTYG.cjs');
 require('./index.cjs');
 require("reflect-metadata");
 

package/dist/decorators/setup.mjs

@@ -1,5 +1,5 @@
-import { n as Container, t as Bind } from "../bindings-DIanvIVd.mjs";
-import { t as CoreRouter } from "../router-B3QjblRX.mjs";
+import { n as Container, t as Bind } from "../bindings-DJDdQv1q.mjs";
+import { t as CoreRouter } from "../router-we2Hw9nA.mjs";
 import "./index.mjs";
 import "reflect-metadata";
 

package/dist/express/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
-const require_responses = require('../responses-JzXstGU5.cjs');
+require('../bindings-T0FKpWyi.cjs');
+const require_router = require('../router-DbPFGTYG.cjs');
+const require_responses = require('../responses-CfCmLLo9.cjs');
 
 //#region src/express/router.ts
 /**

package/dist/express/index.d.cts

@@ -1,4 +1,4 @@
-import { _ as ApiResourceMiddleware, b as HttpMethod, g as Middleware, h as HttpContext, l as Route, m as Handler, t as CoreRouter, v as ControllerAction } from "../router-BYZmNzrZ.cjs";
+import { C as HttpMethod, _ as Handler, b as ApiResourceMiddleware, f as Route, t as CoreRouter, v as HttpContext, x as ControllerAction, y as Middleware } from "../router-CiGcLUZD.cjs";
 import { Router as Router$1 } from "express";
 
 //#region src/express/router.d.ts

package/dist/express/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as ApiResourceMiddleware, b as HttpMethod, g as Middleware, h as HttpContext, l as Route, m as Handler, t as CoreRouter, v as ControllerAction } from "../router-DCMtQ_Xi.mjs";
+import { C as HttpMethod, _ as Handler, b as ApiResourceMiddleware, f as Route, t as CoreRouter, v as HttpContext, x as ControllerAction, y as Middleware } from "../router-B8l8jerS.mjs";
 import { Router as Router$1 } from "express";
 
 //#region src/express/router.d.ts

package/dist/express/index.mjs

@@ -1,6 +1,6 @@
-import "../bindings-DIanvIVd.mjs";
-import { t as CoreRouter } from "../router-B3QjblRX.mjs";
-import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse } from "../responses-_II3dOJ5.mjs";
+import "../bindings-DJDdQv1q.mjs";
+import { t as CoreRouter } from "../router-we2Hw9nA.mjs";
+import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse } from "../responses-B184V5nj.mjs";
 
 //#region src/express/router.ts
 /**

package/dist/fastify/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
-const require_responses = require('../responses-JzXstGU5.cjs');
+require('../bindings-T0FKpWyi.cjs');
+const require_router = require('../router-DbPFGTYG.cjs');
+const require_responses = require('../responses-CfCmLLo9.cjs');
 
 //#region src/fastify/router.ts
 /**

package/dist/fastify/index.d.cts

@@ -1,4 +1,4 @@
-import { _ as ApiResourceMiddleware, b as HttpMethod, c as Request, l as Route, t as CoreRouter, v as ControllerAction, x as Response, y as ControllerHandler } from "../router-BYZmNzrZ.cjs";
+import { C as HttpMethod, S as ControllerHandler, b as ApiResourceMiddleware, d as Request, f as Route, t as CoreRouter, w as Response, x as ControllerAction } from "../router-CiGcLUZD.cjs";
 import { FastifyInstance, FastifyReply, FastifyRequest } from "fastify";
 
 //#region types/fastify.d.ts

package/dist/fastify/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as ApiResourceMiddleware, b as HttpMethod, c as Request, l as Route, t as CoreRouter, v as ControllerAction, x as Response, y as ControllerHandler } from "../router-DCMtQ_Xi.mjs";
+import { C as HttpMethod, S as ControllerHandler, b as ApiResourceMiddleware, d as Request, f as Route, t as CoreRouter, w as Response, x as ControllerAction } from "../router-B8l8jerS.mjs";
 import { FastifyInstance, FastifyReply, FastifyRequest } from "fastify";
 
 //#region types/fastify.d.ts

package/dist/fastify/index.mjs

@@ -1,6 +1,6 @@
-import "../bindings-DIanvIVd.mjs";
-import { t as CoreRouter } from "../router-B3QjblRX.mjs";
-import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse } from "../responses-_II3dOJ5.mjs";
+import "../bindings-DJDdQv1q.mjs";
+import { t as CoreRouter } from "../router-we2Hw9nA.mjs";
+import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse } from "../responses-B184V5nj.mjs";
 
 //#region src/fastify/router.ts
 /**

package/dist/h3/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
-const require_responses = require('../responses-JzXstGU5.cjs');
+require('../bindings-T0FKpWyi.cjs');
+const require_router = require('../router-DbPFGTYG.cjs');
+const require_responses = require('../responses-CfCmLLo9.cjs');
 let h3 = require("h3");
 
 //#region src/h3/router.ts

package/dist/h3/index.d.cts

@@ -1,4 +1,4 @@
-import { _ as ApiResourceMiddleware, b as HttpMethod, d as Handler, f as HttpContext, l as Route, p as Middleware, t as CoreRouter, u as H3App, v as ControllerAction } from "../router-BYZmNzrZ.cjs";
+import { C as HttpMethod, b as ApiResourceMiddleware, f as Route, g as Middleware, h as HttpContext, m as Handler, p as H3App, t as CoreRouter, x as ControllerAction } from "../router-CiGcLUZD.cjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts

package/dist/h3/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as ApiResourceMiddleware, b as HttpMethod, d as Handler, f as HttpContext, l as Route, p as Middleware, t as CoreRouter, u as H3App, v as ControllerAction } from "../router-DCMtQ_Xi.mjs";
+import { C as HttpMethod, b as ApiResourceMiddleware, f as Route, g as Middleware, h as HttpContext, m as Handler, p as H3App, t as CoreRouter, x as ControllerAction } from "../router-B8l8jerS.mjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts

package/dist/h3/index.mjs

@@ -1,6 +1,6 @@
-import "../bindings-DIanvIVd.mjs";
-import { t as CoreRouter } from "../router-B3QjblRX.mjs";
-import { n as resolveResponseMeta } from "../responses-_II3dOJ5.mjs";
+import "../bindings-DJDdQv1q.mjs";
+import { t as CoreRouter } from "../router-we2Hw9nA.mjs";
+import { n as resolveResponseMeta } from "../responses-B184V5nj.mjs";
 import { HTTPResponse, getQuery, getRouterParams, readBody } from "h3";
 
 //#region src/h3/router.ts

package/dist/hono/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
-const require_responses = require('../responses-JzXstGU5.cjs');
+require('../bindings-T0FKpWyi.cjs');
+const require_router = require('../router-DbPFGTYG.cjs');
+const require_responses = require('../responses-CfCmLLo9.cjs');
 
 //#region src/hono/router.ts
 /**

package/dist/hono/index.d.cts

@@ -1,4 +1,4 @@
-import { _ as ApiResourceMiddleware, b as HttpMethod, c as Request, l as Route, t as CoreRouter, v as ControllerAction, x as Response, y as ControllerHandler } from "../router-BYZmNzrZ.cjs";
+import { C as HttpMethod, S as ControllerHandler, b as ApiResourceMiddleware, d as Request, f as Route, t as CoreRouter, w as Response, x as ControllerAction } from "../router-CiGcLUZD.cjs";
 import { Context, HonoRequest, MiddlewareHandler } from "hono";
 
 //#region types/hono.d.ts

package/dist/hono/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as ApiResourceMiddleware, b as HttpMethod, c as Request, l as Route, t as CoreRouter, v as ControllerAction, x as Response, y as ControllerHandler } from "../router-DCMtQ_Xi.mjs";
+import { C as HttpMethod, S as ControllerHandler, b as ApiResourceMiddleware, d as Request, f as Route, t as CoreRouter, w as Response, x as ControllerAction } from "../router-B8l8jerS.mjs";
 import { Context, HonoRequest, MiddlewareHandler } from "hono";
 
 //#region types/hono.d.ts

package/dist/hono/index.mjs

@@ -1,6 +1,6 @@
-import "../bindings-DIanvIVd.mjs";
-import { t as CoreRouter } from "../router-B3QjblRX.mjs";
-import { n as resolveResponseMeta } from "../responses-_II3dOJ5.mjs";
+import "../bindings-DJDdQv1q.mjs";
+import { t as CoreRouter } from "../router-we2Hw9nA.mjs";
+import { n as resolveResponseMeta } from "../responses-B184V5nj.mjs";
 
 //#region src/hono/router.ts
 /**

package/dist/index.cjs

@@ -219,6 +219,7 @@ var CoreRouter = class {
 	static stateBoundKey = Symbol.for("clear-router:router-state-bound");
 	static defaultConfigKey = Symbol.for("clear-router:default-config");
 	static pluginStoreKey = Symbol.for("clear-router:plugins");
+	static pluginPendingKey = Symbol.for("clear-router:plugin-promises");
 	static createBaseConfig() {
 		return {
 			methodOverride: {
@@ -265,6 +266,11 @@ var CoreRouter = class {
 		if (!g[this.pluginStoreKey]) g[this.pluginStoreKey] = /* @__PURE__ */ new Set();
 		return g[this.pluginStoreKey];
 	}
+	static getPluginPendingStore() {
+		const g = globalThis;
+		if (!g[this.pluginPendingKey]) g[this.pluginPendingKey] = /* @__PURE__ */ new Set();
+		return g[this.pluginPendingKey];
+	}
 	static createDefaultState() {
 		return {
 			config: this.getDefaultConfig(),
@@ -370,28 +376,81 @@ var CoreRouter = class {
 	* @param options 
 	* @returns 
 	*/
-	static use(plugin, options) {
+	static async use(plugin, options) {
 		const name = typeof plugin === "function" ? plugin.name : plugin.name;
 		const store = this.getPluginStore();
 		if (name && store.has(name)) return;
-		const ctx = {
-			container: Container,
-			bind: Container.bind.bind(Container),
-			configure: this.configure.bind(this),
-			configureDefaults: this.configureDefaults.bind(this),
-			options
-		};
-		if (typeof plugin === "function") plugin(ctx);
-		else plugin.setup(ctx);
 		if (name) store.add(name);
+		const setup = async () => {
+			const ctx = {
+				container: Container,
+				bind: this.createPluginBind(),
+				configure: this.configure.bind(this),
+				configureDefaults: this.configureDefaults.bind(this),
+				get request() {
+					return this.getRequest();
+				},
+				get response() {
+					return this.getResponse();
+				},
+				getRequest: () => this.getCurrentPluginRequestContext()?.request,
+				getResponse: () => this.getCurrentPluginRequestContext()?.response,
+				options
+			};
+			if (typeof plugin === "function") await plugin(ctx);
+			else await plugin.setup(ctx);
+		};
+		const pending = this.getPluginPendingStore();
+		const promise = setup();
+		pending.add(promise);
+		try {
+			await promise;
+		} catch (error) {
+			if (name) store.delete(name);
+			throw error;
+		} finally {
+			pending.delete(promise);
+		}
+	}
+	static async pluginsReady() {
+		const pending = Array.from(this.getPluginPendingStore());
+		if (!pending.length) return;
+		await Promise.all(pending);
 	}
 	static groupContext = new node_async_hooks.AsyncLocalStorage();
+	static pluginRequestContext = new node_async_hooks.AsyncLocalStorage();
 	static routes = [];
 	static routesByPathMethod = {};
 	static routesByMethod = {};
 	static prefix = "";
 	static groupMiddlewares = [];
 	static globalMiddlewares = [];
+	static getCurrentPluginRequestContext() {
+		return this.pluginRequestContext.getStore();
+	}
+	static createPluginRequestContext(ctx) {
+		const request = ctx.clearRequest;
+		const response = ctx.clearResponse;
+		return {
+			...ctx,
+			ctx,
+			request,
+			response,
+			clearRequest: request,
+			clearResponse: response
+		};
+	}
+	static createPluginBind() {
+		const bind = (token, value) => {
+			if (typeof value === "function" && !isClass(value)) {
+				const factory = value;
+				Container.bind(token, (ctx) => factory(this.createPluginRequestContext(ctx)));
+				return;
+			}
+			Container.bind(token, value);
+		};
+		return bind;
+	}
 	static ensureState() {
 		this.bindStateAccessors();
 		if (!this.config) this.config = { methodOverride: {
@@ -706,29 +765,32 @@ var CoreRouter = class {
 		};
 	}
 	static async callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata) {
-		if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
-		const metadata = getBindingMetadataFromTargets([
-			{
-				target: bindingTarget,
-				propertyKey: bindingMethod
-			},
-			{ target: bindingHandler },
-			{
-				target: bindingTarget,
-				propertyKey: "__class__"
+		return this.pluginRequestContext.run(this.createPluginRequestContext(ctx), async () => {
+			await this.pluginsReady();
+			if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
+			const metadata = getBindingMetadataFromTargets([
+				{
+					target: bindingTarget,
+					propertyKey: bindingMethod
+				},
+				{ target: bindingHandler },
+				{
+					target: bindingTarget,
+					propertyKey: "__class__"
+				}
+			]) ?? getStandardMetadata(bindingMetadata, bindingMethod) ?? getStandardMetadata(bindingMetadata, "__class__");
+			if (!metadata) return handlerFunction(ctx, ctx.clearRequest);
+			const designTokens = [...bindingTarget ? getDesignParamTypes(bindingTarget, bindingMethod) : [], ...bindingHandler ? getDesignParamTypes(bindingHandler) : []];
+			const tokens = metadata.tokens?.length ? metadata.tokens : designTokens;
+			if (!tokens.length) return handlerFunction(ctx, ctx.clearRequest);
+			const args = [];
+			for (const token of tokens) {
+				const resolved = await Container.resolve(token, ctx, Boolean(this.config.container?.autoDiscover));
+				if (typeof resolved === "undefined") return handlerFunction(ctx, ctx.clearRequest);
+				args.push(resolved);
 			}
-		]) ?? getStandardMetadata(bindingMetadata, bindingMethod) ?? getStandardMetadata(bindingMetadata, "__class__");
-		if (!metadata) return handlerFunction(ctx, ctx.clearRequest);
-		const designTokens = [...bindingTarget ? getDesignParamTypes(bindingTarget, bindingMethod) : [], ...bindingHandler ? getDesignParamTypes(bindingHandler) : []];
-		const tokens = metadata.tokens?.length ? metadata.tokens : designTokens;
-		if (!tokens.length) return handlerFunction(ctx, ctx.clearRequest);
-		const args = [];
-		for (const token of tokens) {
-			const resolved = await Container.resolve(token, ctx, Boolean(this.config.container?.autoDiscover));
-			if (typeof resolved === "undefined") return handlerFunction(ctx, ctx.clearRequest);
-			args.push(resolved);
-		}
-		return handlerFunction(...args);
+			return handlerFunction(...args);
+		});
 	}
 	static bindRequestToInstance(ctx, instance, route, payload) {
 		const clearRequest = ctx.clearRequest instanceof Request ? ctx.clearRequest : new Request({

package/dist/index.d.cts

@@ -143,13 +143,25 @@ declare class Container {
 }
 //#endregion
 //#region src/core/plugins.d.ts
-type PluginSetupResult = void;
-type PluginBind = <T>(token: BindToken<T>, value: BindValue<T>) => void;
+type PluginSetupResult = void | Promise<void>;
+interface ClearRouterPluginRequestContext {
+  ctx: any;
+  request: Request;
+  response: Response$1;
+  [key: string]: any;
+}
+type PluginBindFactory<T = any> = (ctx: ClearRouterPluginRequestContext) => T | Promise<T>;
+type PluginBindValue<T = any> = BindValue<T> | PluginBindFactory<T>;
+type PluginBind = <T>(token: BindToken<T>, value: PluginBindValue<T>) => void;
 interface ClearRouterPluginContext<Options = any> {
   container: typeof Container;
   bind: PluginBind;
   configure: (options: RouterConfig) => void;
   configureDefaults: (options: RouterConfig) => void;
+  readonly request?: Request;
+  readonly response?: Response$1;
+  getRequest: () => Request | undefined;
+  getResponse: () => Response$1 | undefined;
   options: Options;
 }
 interface ClearRouterPlugin<Options = any> {
@@ -172,12 +184,14 @@ declare abstract class CoreRouter {
   private static readonly stateBoundKey;
   private static readonly defaultConfigKey;
   private static readonly pluginStoreKey;
+  private static readonly pluginPendingKey;
   protected static createBaseConfig(): RouterConfig;
   protected static mergeConfig(target: RouterConfig, source?: RouterConfig): RouterConfig;
   protected static getDefaultConfig(): RouterConfig;
   protected static resolveStateNamespace(this: any): string;
   protected static getStateStore(): Record<string, any>;
   protected static getPluginStore(): Set<string>;
+  protected static getPluginPendingStore(): Set<Promise<void>>;
   protected static createDefaultState(): {
     config: RouterConfig;
     groupContext: AsyncLocalStorage<{
@@ -203,17 +217,22 @@ declare abstract class CoreRouter {
    * @param options
    * @returns
    */
-  static use<Options = any>(this: any, plugin: ClearRouterPluginInput<Options>, options?: Options): void;
+  static use<Options = any>(this: any, plugin: ClearRouterPluginInput<Options>, options?: Options): Promise<void>;
+  protected static pluginsReady(this: any): Promise<void>;
   protected static groupContext: AsyncLocalStorage<{
     prefix: string;
     groupMiddlewares: any[];
   }>;
+  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext>;
   static routes: Array<Route<any, any, any>>;
   static routesByPathMethod: Record<string, Route<any, any, any>>;
   static routesByMethod: { [method in Uppercase<HttpMethod>]?: Array<Route<any, any, any>> };
   static prefix: string;
   static groupMiddlewares: any[];
   static globalMiddlewares: any[];
+  protected static getCurrentPluginRequestContext(): ClearRouterPluginRequestContext | undefined;
+  protected static createPluginRequestContext(ctx: any): ClearRouterPluginRequestContext;
+  protected static createPluginBind(): PluginBind;
   protected static ensureState(this: any): void;
   /**
    * Normalizes a path by ensuring it starts with a single slash and does not have trailing
@@ -369,4 +388,4 @@ declare abstract class CoreRouter {
   }): void;
 }
 //#endregion
-export { ClearRequest, ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, Controller, CoreRouter, PluginBind, PluginSetupResult, Request, Response$1 as Response, Route, definePlugin };
+export { ClearRequest, ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response$1 as Response, Route, definePlugin };

package/dist/index.d.mts

@@ -143,13 +143,25 @@ declare class Container {
 }
 //#endregion
 //#region src/core/plugins.d.ts
-type PluginSetupResult = void;
-type PluginBind = <T>(token: BindToken<T>, value: BindValue<T>) => void;
+type PluginSetupResult = void | Promise<void>;
+interface ClearRouterPluginRequestContext {
+  ctx: any;
+  request: Request;
+  response: Response$1;
+  [key: string]: any;
+}
+type PluginBindFactory<T = any> = (ctx: ClearRouterPluginRequestContext) => T | Promise<T>;
+type PluginBindValue<T = any> = BindValue<T> | PluginBindFactory<T>;
+type PluginBind = <T>(token: BindToken<T>, value: PluginBindValue<T>) => void;
 interface ClearRouterPluginContext<Options = any> {
   container: typeof Container;
   bind: PluginBind;
   configure: (options: RouterConfig) => void;
   configureDefaults: (options: RouterConfig) => void;
+  readonly request?: Request;
+  readonly response?: Response$1;
+  getRequest: () => Request | undefined;
+  getResponse: () => Response$1 | undefined;
   options: Options;
 }
 interface ClearRouterPlugin<Options = any> {
@@ -172,12 +184,14 @@ declare abstract class CoreRouter {
   private static readonly stateBoundKey;
   private static readonly defaultConfigKey;
   private static readonly pluginStoreKey;
+  private static readonly pluginPendingKey;
   protected static createBaseConfig(): RouterConfig;
   protected static mergeConfig(target: RouterConfig, source?: RouterConfig): RouterConfig;
   protected static getDefaultConfig(): RouterConfig;
   protected static resolveStateNamespace(this: any): string;
   protected static getStateStore(): Record<string, any>;
   protected static getPluginStore(): Set<string>;
+  protected static getPluginPendingStore(): Set<Promise<void>>;
   protected static createDefaultState(): {
     config: RouterConfig;
     groupContext: AsyncLocalStorage<{
@@ -203,17 +217,22 @@ declare abstract class CoreRouter {
    * @param options
    * @returns
    */
-  static use<Options = any>(this: any, plugin: ClearRouterPluginInput<Options>, options?: Options): void;
+  static use<Options = any>(this: any, plugin: ClearRouterPluginInput<Options>, options?: Options): Promise<void>;
+  protected static pluginsReady(this: any): Promise<void>;
   protected static groupContext: AsyncLocalStorage<{
     prefix: string;
     groupMiddlewares: any[];
   }>;
+  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext>;
   static routes: Array<Route<any, any, any>>;
   static routesByPathMethod: Record<string, Route<any, any, any>>;
   static routesByMethod: { [method in Uppercase<HttpMethod>]?: Array<Route<any, any, any>> };
   static prefix: string;
   static groupMiddlewares: any[];
   static globalMiddlewares: any[];
+  protected static getCurrentPluginRequestContext(): ClearRouterPluginRequestContext | undefined;
+  protected static createPluginRequestContext(ctx: any): ClearRouterPluginRequestContext;
+  protected static createPluginBind(): PluginBind;
   protected static ensureState(this: any): void;
   /**
    * Normalizes a path by ensuring it starts with a single slash and does not have trailing
@@ -369,4 +388,4 @@ declare abstract class CoreRouter {
   }): void;
 }
 //#endregion
-export { ClearRequest, ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, Controller, CoreRouter, PluginBind, PluginSetupResult, Request, Response$1 as Response, Route, definePlugin };
+export { ClearRequest, ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response$1 as Response, Route, definePlugin };