clear-router 2.5.6 → 2.5.7

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_router = require('../router-BdMuUzGU.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";
+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-WAxKAcWR.cjs";
 export { ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, CoreRouter, PluginBind, 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";
+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-D7R3G8w-.mjs";
 export { ClearRouterPlugin, ClearRouterPluginContext, ClearRouterPluginInput, CoreRouter, PluginBind, 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 { t as CoreRouter } from "../router-DzbF-ZV0.mjs";
 
 //#region src/core/plugins.ts
 function definePlugin(plugin) {

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_router = require('../router-BdMuUzGU.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 { t as CoreRouter } from "../router-DzbF-ZV0.mjs";
 import "./index.mjs";
 import "reflect-metadata";
 

package/dist/express/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
+const require_router = require('../router-BdMuUzGU.cjs');
 const require_responses = require('../responses-JzXstGU5.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 { _ 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-WAxKAcWR.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 { _ 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-D7R3G8w-.mjs";
 import { Router as Router$1 } from "express";
 
 //#region src/express/router.d.ts

package/dist/express/index.mjs

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

package/dist/fastify/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
+const require_router = require('../router-BdMuUzGU.cjs');
 const require_responses = require('../responses-JzXstGU5.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 { _ 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-WAxKAcWR.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 { _ 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-D7R3G8w-.mjs";
 import { FastifyInstance, FastifyReply, FastifyRequest } from "fastify";
 
 //#region types/fastify.d.ts

package/dist/fastify/index.mjs

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

package/dist/h3/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
+const require_router = require('../router-BdMuUzGU.cjs');
 const require_responses = require('../responses-JzXstGU5.cjs');
 let h3 = require("h3");
 

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 { _ 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-WAxKAcWR.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 { _ 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-D7R3G8w-.mjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts

package/dist/h3/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-DIanvIVd.mjs";
-import { t as CoreRouter } from "../router-B3QjblRX.mjs";
+import { t as CoreRouter } from "../router-DzbF-ZV0.mjs";
 import { n as resolveResponseMeta } from "../responses-_II3dOJ5.mjs";
 import { HTTPResponse, getQuery, getRouterParams, readBody } from "h3";
 

package/dist/hono/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 require('../bindings-DvV2DXWi.cjs');
-const require_router = require('../router-CU4V1kX0.cjs');
+const require_router = require('../router-BdMuUzGU.cjs');
 const require_responses = require('../responses-JzXstGU5.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 { _ 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-WAxKAcWR.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 { _ 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-D7R3G8w-.mjs";
 import { Context, HonoRequest, MiddlewareHandler } from "hono";
 
 //#region types/hono.d.ts

package/dist/hono/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-DIanvIVd.mjs";
-import { t as CoreRouter } from "../router-B3QjblRX.mjs";
+import { t as CoreRouter } from "../router-DzbF-ZV0.mjs";
 import { n as resolveResponseMeta } from "../responses-_II3dOJ5.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,20 +376,38 @@ 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: Container.bind.bind(Container),
+				configure: this.configure.bind(this),
+				configureDefaults: this.configureDefaults.bind(this),
+				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 routes = [];
@@ -706,6 +730,7 @@ var CoreRouter = class {
 		};
 	}
 	static async callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata) {
+		await this.pluginsReady();
 		if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
 		const metadata = getBindingMetadataFromTargets([
 			{

package/dist/index.d.cts

@@ -143,7 +143,7 @@ declare class Container {
 }
 //#endregion
 //#region src/core/plugins.d.ts
-type PluginSetupResult = void;
+type PluginSetupResult = void | Promise<void>;
 type PluginBind = <T>(token: BindToken<T>, value: BindValue<T>) => void;
 interface ClearRouterPluginContext<Options = any> {
   container: typeof Container;
@@ -172,12 +172,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,7 +205,8 @@ 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[];

package/dist/index.d.mts

@@ -143,7 +143,7 @@ declare class Container {
 }
 //#endregion
 //#region src/core/plugins.d.ts
-type PluginSetupResult = void;
+type PluginSetupResult = void | Promise<void>;
 type PluginBind = <T>(token: BindToken<T>, value: BindValue<T>) => void;
 interface ClearRouterPluginContext<Options = any> {
   container: typeof Container;
@@ -172,12 +172,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,7 +205,8 @@ 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[];

package/dist/index.mjs

@@ -218,6 +218,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: {
@@ -264,6 +265,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(),
@@ -369,20 +375,38 @@ 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: Container.bind.bind(Container),
+				configure: this.configure.bind(this),
+				configureDefaults: this.configureDefaults.bind(this),
+				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 AsyncLocalStorage();
 	static routes = [];
@@ -705,6 +729,7 @@ var CoreRouter = class {
 		};
 	}
 	static async callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata) {
+		await this.pluginsReady();
 		if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
 		const metadata = getBindingMetadataFromTargets([
 			{

package/dist/koa/index.cjs

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

package/dist/koa/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 { _ 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-WAxKAcWR.cjs";
 import Koa from "koa";
 import Router$1 from "@koa/router";
 

package/dist/koa/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 { _ 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-D7R3G8w-.mjs";
 import Koa from "koa";
 import Router$1 from "@koa/router";
 

package/dist/koa/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-DIanvIVd.mjs";
-import { t as CoreRouter } from "../router-B3QjblRX.mjs";
+import { t as CoreRouter } from "../router-DzbF-ZV0.mjs";
 import { n as resolveResponseMeta, t as isFetchResponse } from "../responses-_II3dOJ5.mjs";
 
 //#region src/koa/router.ts

package/dist/{router-CU4V1kX0.cjs → router-BdMuUzGU.cjs}

@@ -42,6 +42,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: {
@@ -88,6 +89,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(),
@@ -193,20 +199,38 @@ 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: require_bindings.Container,
-			bind: require_bindings.Container.bind.bind(require_bindings.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: require_bindings.Container,
+				bind: require_bindings.Container.bind.bind(require_bindings.Container),
+				configure: this.configure.bind(this),
+				configureDefaults: this.configureDefaults.bind(this),
+				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 routes = [];
@@ -529,6 +553,7 @@ var CoreRouter = class {
 		};
 	}
 	static async callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata) {
+		await this.pluginsReady();
 		if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
 		const metadata = require_bindings.getBindingMetadataFromTargets([
 			{

package/dist/{router-DCMtQ_Xi.d.mts → router-D7R3G8w-.d.mts}

@@ -190,7 +190,7 @@ declare class Request$1<X = any, M = any> extends ClearRequest<X, M> {
 }
 //#endregion
 //#region src/core/plugins.d.ts
-type PluginSetupResult = void;
+type PluginSetupResult = void | Promise<void>;
 type PluginBind = <T>(token: BindToken<T>, value: BindValue<T>) => void;
 interface ClearRouterPluginContext<Options = any> {
   container: typeof Container;
@@ -229,12 +229,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<{
@@ -260,7 +262,8 @@ 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[];

package/dist/{router-B3QjblRX.mjs → router-DzbF-ZV0.mjs}

@@ -42,6 +42,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: {
@@ -88,6 +89,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(),
@@ -193,20 +199,38 @@ 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: Container.bind.bind(Container),
+				configure: this.configure.bind(this),
+				configureDefaults: this.configureDefaults.bind(this),
+				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 AsyncLocalStorage();
 	static routes = [];
@@ -529,6 +553,7 @@ var CoreRouter = class {
 		};
 	}
 	static async callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata) {
+		await this.pluginsReady();
 		if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
 		const metadata = getBindingMetadataFromTargets([
 			{

package/dist/{router-BYZmNzrZ.d.cts → router-WAxKAcWR.d.cts}

@@ -190,7 +190,7 @@ declare class Request$1<X = any, M = any> extends ClearRequest<X, M> {
 }
 //#endregion
 //#region src/core/plugins.d.ts
-type PluginSetupResult = void;
+type PluginSetupResult = void | Promise<void>;
 type PluginBind = <T>(token: BindToken<T>, value: BindValue<T>) => void;
 interface ClearRouterPluginContext<Options = any> {
   container: typeof Container;
@@ -229,12 +229,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<{
@@ -260,7 +262,8 @@ 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[];

package/package.json

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