clear-router 2.6.7 → 2.7.1

package/dist/core/index.cjs

@@ -1,8 +1,14 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_bindings = require('../bindings-CLsZjOEy.cjs');
-const require_router = require('../router-CcG0NS8L.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 
 //#region src/core/plugins.ts
+/**
+* Creates a new plugin
+* 
+* @param plugin 
+* @returns 
+*/
 function definePlugin(plugin) {
 	return plugin;
 }

package/dist/core/index.d.cts

@@ -1,2 +1,2 @@
-import { L as Response, a as ClearRouterPluginInput, c as PluginBind, d as PluginSetupResult, f as definePlugin, i as ClearRouterPluginContext, l as PluginBindFactory, n as ClearRouterPlugin, o as ClearRouterPluginRequestContext, p as Request, r as ClearRouterPluginArgumentsContext, s as PluginArgumentsResolver, t as CoreRouter, u as PluginBindValue } from "../router-BHC0lGtp.cjs";
+import { L as Response, a as ClearRouterPluginInput, c as PluginBind, d as PluginSetupResult, f as definePlugin, i as ClearRouterPluginContext, l as PluginBindFactory, n as ClearRouterPlugin, o as ClearRouterPluginRequestContext, p as Request, r as ClearRouterPluginArgumentsContext, s as PluginArgumentsResolver, t as CoreRouter, u as PluginBindValue } from "../router-C7oMjml0.cjs";
 export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin };

package/dist/core/index.d.mts

@@ -1,2 +1,2 @@
-import { L as Response, a as ClearRouterPluginInput, c as PluginBind, d as PluginSetupResult, f as definePlugin, i as ClearRouterPluginContext, l as PluginBindFactory, n as ClearRouterPlugin, o as ClearRouterPluginRequestContext, p as Request, r as ClearRouterPluginArgumentsContext, s as PluginArgumentsResolver, t as CoreRouter, u as PluginBindValue } from "../router-BOKe0n0j.mjs";
+import { L as Response, a as ClearRouterPluginInput, c as PluginBind, d as PluginSetupResult, f as definePlugin, i as ClearRouterPluginContext, l as PluginBindFactory, n as ClearRouterPlugin, o as ClearRouterPluginRequestContext, p as Request, r as ClearRouterPluginArgumentsContext, s as PluginArgumentsResolver, t as CoreRouter, u as PluginBindValue } from "../router-B86hTwHL.mjs";
 export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin };

package/dist/core/index.mjs

@@ -1,7 +1,13 @@
 import { c as Request, s as Response } from "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-kOleKr2w.mjs";
+import { t as CoreRouter } from "../router-Dc9w86Wn.mjs";
 
 //#region src/core/plugins.ts
+/**
+* Creates a new plugin
+* 
+* @param plugin 
+* @returns 
+*/
 function definePlugin(plugin) {
 	return plugin;
 }

package/dist/decorators/setup.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_bindings = require('../bindings-CLsZjOEy.cjs');
-const require_router = require('../router-CcG0NS8L.cjs');
+const require_router = require('../router-C6W-k6sS.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-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-kOleKr2w.mjs";
+import { t as CoreRouter } from "../router-Dc9w86Wn.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-CLsZjOEy.cjs');
-const require_router = require('../router-CcG0NS8L.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 
 //#region src/express/router.ts

package/dist/express/index.d.cts

@@ -1,4 +1,4 @@
-import { F as ControllerAction, I as HttpMethod, M as HttpContext, N as Middleware, P as ApiResourceMiddleware, j as Handler, m as Route, t as CoreRouter } from "../router-BHC0lGtp.cjs";
+import { F as ControllerAction, I as HttpMethod, M as HttpContext, N as Middleware, P as ApiResourceMiddleware, j as Handler, m as Route, t as CoreRouter } from "../router-C7oMjml0.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 { F as ControllerAction, I as HttpMethod, M as HttpContext, N as Middleware, P as ApiResourceMiddleware, j as Handler, m as Route, t as CoreRouter } from "../router-BOKe0n0j.mjs";
+import { F as ControllerAction, I as HttpMethod, M as HttpContext, N as Middleware, P as ApiResourceMiddleware, j as Handler, m as Route, t as CoreRouter } from "../router-B86hTwHL.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-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-kOleKr2w.mjs";
+import { t as CoreRouter } from "../router-Dc9w86Wn.mjs";
 import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse } from "../responses-BvETUeDL.mjs";
 
 //#region src/express/router.ts

package/dist/fastify/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 require('../bindings-CLsZjOEy.cjs');
-const require_router = require('../router-CcG0NS8L.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 
 //#region src/fastify/router.ts

package/dist/fastify/index.d.cts

@@ -1,4 +1,4 @@
-import { A as Middleware, D as FastifyApp, F as ControllerAction, I as HttpMethod, O as Handler, P as ApiResourceMiddleware, k as HttpContext, m as Route, t as CoreRouter } from "../router-BHC0lGtp.cjs";
+import { A as Middleware, D as FastifyApp, F as ControllerAction, I as HttpMethod, O as Handler, P as ApiResourceMiddleware, k as HttpContext, m as Route, t as CoreRouter } from "../router-C7oMjml0.cjs";
 
 //#region src/fastify/router.d.ts
 /**

package/dist/fastify/index.d.mts

@@ -1,4 +1,4 @@
-import { A as Middleware, D as FastifyApp, F as ControllerAction, I as HttpMethod, O as Handler, P as ApiResourceMiddleware, k as HttpContext, m as Route, t as CoreRouter } from "../router-BOKe0n0j.mjs";
+import { A as Middleware, D as FastifyApp, F as ControllerAction, I as HttpMethod, O as Handler, P as ApiResourceMiddleware, k as HttpContext, m as Route, t as CoreRouter } from "../router-B86hTwHL.mjs";
 
 //#region src/fastify/router.d.ts
 /**

package/dist/fastify/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-kOleKr2w.mjs";
+import { t as CoreRouter } from "../router-Dc9w86Wn.mjs";
 import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse } from "../responses-BvETUeDL.mjs";
 
 //#region src/fastify/router.ts

package/dist/h3/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 require('../bindings-CLsZjOEy.cjs');
-const require_router = require('../router-CcG0NS8L.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 let h3 = require("h3");
 

package/dist/h3/index.d.cts

@@ -1,4 +1,4 @@
-import { C as H3App, E as Middleware, F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, T as HttpContext, m as Route, t as CoreRouter, w as Handler } from "../router-BHC0lGtp.cjs";
+import { C as H3App, E as Middleware, F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, T as HttpContext, m as Route, t as CoreRouter, w as Handler } from "../router-C7oMjml0.cjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts

package/dist/h3/index.d.mts

@@ -1,4 +1,4 @@
-import { C as H3App, E as Middleware, F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, T as HttpContext, m as Route, t as CoreRouter, w as Handler } from "../router-BOKe0n0j.mjs";
+import { C as H3App, E as Middleware, F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, T as HttpContext, m as Route, t as CoreRouter, w as Handler } from "../router-B86hTwHL.mjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts

package/dist/h3/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-kOleKr2w.mjs";
+import { t as CoreRouter } from "../router-Dc9w86Wn.mjs";
 import { n as resolveResponseMeta } from "../responses-BvETUeDL.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-CLsZjOEy.cjs');
-const require_router = require('../router-CcG0NS8L.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 
 //#region src/hono/router.ts

package/dist/hono/index.d.cts

@@ -1,4 +1,4 @@
-import { F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, S as Middleware, b as HonoApp, m as Route, t as CoreRouter, x as HttpContext, y as Handler } from "../router-BHC0lGtp.cjs";
+import { F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, S as Middleware, b as HonoApp, m as Route, t as CoreRouter, x as HttpContext, y as Handler } from "../router-C7oMjml0.cjs";
 
 //#region src/hono/router.d.ts
 /**

package/dist/hono/index.d.mts

@@ -1,4 +1,4 @@
-import { F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, S as Middleware, b as HonoApp, m as Route, t as CoreRouter, x as HttpContext, y as Handler } from "../router-BOKe0n0j.mjs";
+import { F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, S as Middleware, b as HonoApp, m as Route, t as CoreRouter, x as HttpContext, y as Handler } from "../router-B86hTwHL.mjs";
 
 //#region src/hono/router.d.ts
 /**

package/dist/hono/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-kOleKr2w.mjs";
+import { t as CoreRouter } from "../router-Dc9w86Wn.mjs";
 import { n as resolveResponseMeta } from "../responses-BvETUeDL.mjs";
 
 //#region src/hono/router.ts

package/dist/index.cjs

@@ -179,6 +179,12 @@ var Response = class {
 
 //#endregion
 //#region src/core/plugins.ts
+/**
+* Creates a new plugin
+* 
+* @param plugin 
+* @returns 
+*/
 function definePlugin(plugin) {
 	return plugin;
 }
@@ -299,6 +305,7 @@ var CoreRouter = class {
 	static defaultConfigKey = Symbol.for("clear-router:default-config");
 	static pluginStoreKey = Symbol.for("clear-router:plugins");
 	static pluginPendingKey = Symbol.for("clear-router:plugin-promises");
+	static pluginHttpCtxResolversKey = Symbol.for("clear-router:plugin-http-ctx");
 	static pluginArgumentResolversKey = Symbol.for("clear-router:plugin-argument-resolvers");
 	static requestProvider;
 	static responseProvider;
@@ -394,6 +401,11 @@ var CoreRouter = class {
 		if (!g[this.pluginArgumentResolversKey]) g[this.pluginArgumentResolversKey] = /* @__PURE__ */ new Set();
 		return g[this.pluginArgumentResolversKey];
 	}
+	static getPluginHttpCtxResolvers() {
+		const g = globalThis;
+		if (!g[this.pluginHttpCtxResolversKey]) g[this.pluginHttpCtxResolversKey] = /* @__PURE__ */ new Set();
+		return g[this.pluginHttpCtxResolversKey];
+	}
 	static createDefaultState() {
 		return {
 			config: this.getDefaultConfig(),
@@ -475,6 +487,11 @@ var CoreRouter = class {
 			}
 		};
 	}
+	/**
+	* Default configuration used for everytime the router is reset
+	* 
+	* @param options 
+	*/
 	static configureDefaults(options) {
 		const g = globalThis;
 		const defaults = this.mergeConfig(g[this.defaultConfigKey] || this.createBaseConfig(), options);
@@ -502,6 +519,9 @@ var CoreRouter = class {
 				resolveArguments: (resolver) => {
 					this.getPluginArgumentResolvers().add(resolver);
 				},
+				useHttpContext: (resolver) => {
+					this.getPluginHttpCtxResolvers().add(resolver);
+				},
 				bindings: Container.bindings(),
 				configure: this.configure.bind(this),
 				configureDefaults: this.configureDefaults.bind(this),
@@ -572,6 +592,12 @@ var CoreRouter = class {
 			if (Array.isArray(args)) return args;
 		}
 	}
+	static async resolvePluginHttpCtx(ctx) {
+		const resolvers = Array.from(this.getPluginHttpCtxResolvers());
+		if (!resolvers.length) return void 0;
+		const pluginContext = this.createPluginRequestContext(ctx);
+		for (const resolver of resolvers) await resolver(pluginContext);
+	}
 	static ensureState() {
 		this.bindStateAccessors();
 		if (!this.config) this.config = { methodOverride: {
@@ -995,6 +1021,7 @@ var CoreRouter = class {
 	static async callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata) {
 		return this.pluginRequestContext.run(this.createPluginRequestContext(ctx), async () => {
 			await this.pluginsReady();
+			await this.resolvePluginHttpCtx(ctx);
 			if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
 			const designTokens = [...bindingTarget ? getDesignParamTypes(bindingTarget, bindingMethod) : [], ...bindingHandler ? getDesignParamTypes(bindingHandler) : []];
 			const metadata = getBindingMetadataFromTargets([

package/dist/index.d.cts

@@ -188,14 +188,14 @@ declare class Container {
 //#endregion
 //#region src/core/plugins.d.ts
 type PluginSetupResult = void | Promise<void>;
-interface ClearRouterPluginRequestContext {
-  ctx: any;
+interface ClearRouterPluginRequestContext<HttpContext = any> {
+  ctx: HttpContext;
   request: Request;
   response: Response$1;
   getBindings: () => Record<string, BindValue>;
   [key: string]: any;
 }
-interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestContext {
+interface ClearRouterPluginArgumentsContext<X = any> extends ClearRouterPluginRequestContext<X> {
   target?: object;
   method?: PropertyKey;
   handler?: object;
@@ -206,26 +206,88 @@ interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestCont
 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;
-type PluginArgumentsResolver = (ctx: ClearRouterPluginArgumentsContext) => any[] | undefined | Promise<any[] | undefined>;
-interface ClearRouterPluginContext<Options = any> {
+type PluginArgumentsResolver<HttpContext = any> = (ctx: ClearRouterPluginArgumentsContext<HttpContext>) => any[] | undefined | Promise<any[] | undefined>;
+interface ClearRouterPluginContext<Options = any, HttpContext = any> {
+  /**
+   * The service container
+   */
   container: typeof Container;
+  /**
+   * Register service container bindings
+   */
   bind: PluginBind;
-  resolveArguments: (resolver: PluginArgumentsResolver) => void;
+  /**
+   * Replace all controller method arguments
+   * @param resolver
+   * @returns
+   */
+  resolveArguments: (resolver: PluginArgumentsResolver<HttpContext>) => void;
+  /**
+   * Use the current http context
+   */
+  useHttpContext: (resolver: PluginArgumentsResolver<HttpContext>) => void;
+  /**
+   * All registered service container bindings
+   */
   bindings: Record<string, BindValue>;
+  /**
+   * Configures the router with the given options, such as method override settings
+   *
+   * @param options
+   * @returns
+   */
   configure: (options: RouterConfig) => void;
+  /**
+   * Default configuration used for everytime the router is reset
+   *
+   * @param options
+   */
   configureDefaults: (options: RouterConfig) => void;
+  /**
+   * The current Request instance
+   */
   readonly request?: Request;
+  /**
+   * The current Response instance
+   * @returns
+   */
   readonly response?: Response$1;
+  /**
+   * Get the current Request instance
+   * @returns
+   */
   getRequest: () => Request | undefined;
+  /**
+   * Get the current Response instance
+   * @returns
+   */
   getResponse: () => Response$1 | undefined;
+  /**
+   * Plugin configuration options
+   */
   options: Options;
 }
-interface ClearRouterPlugin<Options = any> {
+interface ClearRouterPlugin<Options = any, HttpContext = any> {
+  /**
+   * The name of the plugin
+   */
   name?: string;
-  setup: (ctx: ClearRouterPluginContext<Options>) => PluginSetupResult;
+  /**
+   * Plugin setup an implemnetation
+   *
+   * @param ctx
+   * @returns
+   */
+  setup: (ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult;
 }
-type ClearRouterPluginInput<Options = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options>) => PluginSetupResult);
-declare function definePlugin<Options = any>(plugin: ClearRouterPlugin<Options>): ClearRouterPlugin<Options>;
+type ClearRouterPluginInput<Options = any, HttpContext = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult);
+/**
+ * Creates a new plugin
+ *
+ * @param plugin
+ * @returns
+ */
+declare function definePlugin<Options = any, HttpContext = any>(plugin: ClearRouterPlugin<Options, HttpContext>): ClearRouterPlugin<Options, HttpContext>;
 //#endregion
 //#region src/core/router.d.ts
 /**
@@ -241,6 +303,7 @@ declare abstract class CoreRouter {
   private static readonly defaultConfigKey;
   private static readonly pluginStoreKey;
   private static readonly pluginPendingKey;
+  private static readonly pluginHttpCtxResolversKey;
   private static readonly pluginArgumentResolversKey;
   private static requestProvider?;
   private static responseProvider?;
@@ -249,7 +312,7 @@ declare abstract class CoreRouter {
     prefix: string;
     groupMiddlewares: any[];
   }>;
-  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext>;
+  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext<any>>;
   static routes: Set<Route<any, any, any>>;
   static routesByPathMethod: Map<string, Route<any, any, any>>;
   static routesByMethod: Map<"GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD", Route<any, any, any>[]>;
@@ -269,6 +332,7 @@ declare abstract class CoreRouter {
   protected static getPluginStore(): Set<string>;
   protected static getPluginPendingStore(): Set<Promise<void>>;
   protected static getPluginArgumentResolvers(): Set<PluginArgumentsResolver>;
+  protected static getPluginHttpCtxResolvers(): Set<PluginArgumentsResolver>;
   protected static createDefaultState(): {
     config: RouterConfig;
     groupContext: AsyncLocalStorage<{
@@ -285,6 +349,11 @@ declare abstract class CoreRouter {
   };
   protected static bindStateAccessors(): void;
   protected static createDefaultOptionsHandler(): any;
+  /**
+   * Default configuration used for everytime the router is reset
+   *
+   * @param options
+   */
   static configureDefaults(options?: RouterConfig): void;
   /**
    * Use a registered plugin
@@ -299,7 +368,8 @@ declare abstract class CoreRouter {
   protected static getCurrentPluginRequestContext(): ClearRouterPluginRequestContext | undefined;
   protected static createPluginRequestContext(ctx: any): ClearRouterPluginRequestContext;
   protected static createPluginBind(): PluginBind;
-  protected static resolvePluginArguments(this: any, ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static resolvePluginArguments(ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static resolvePluginHttpCtx(ctx: any): Promise<void>;
   protected static ensureState(): void;
   /**
    * Normalizes a path by ensuring it starts with a single slash and does not have trailing

package/dist/index.d.mts

@@ -188,14 +188,14 @@ declare class Container {
 //#endregion
 //#region src/core/plugins.d.ts
 type PluginSetupResult = void | Promise<void>;
-interface ClearRouterPluginRequestContext {
-  ctx: any;
+interface ClearRouterPluginRequestContext<HttpContext = any> {
+  ctx: HttpContext;
   request: Request;
   response: Response$1;
   getBindings: () => Record<string, BindValue>;
   [key: string]: any;
 }
-interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestContext {
+interface ClearRouterPluginArgumentsContext<X = any> extends ClearRouterPluginRequestContext<X> {
   target?: object;
   method?: PropertyKey;
   handler?: object;
@@ -206,26 +206,88 @@ interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestCont
 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;
-type PluginArgumentsResolver = (ctx: ClearRouterPluginArgumentsContext) => any[] | undefined | Promise<any[] | undefined>;
-interface ClearRouterPluginContext<Options = any> {
+type PluginArgumentsResolver<HttpContext = any> = (ctx: ClearRouterPluginArgumentsContext<HttpContext>) => any[] | undefined | Promise<any[] | undefined>;
+interface ClearRouterPluginContext<Options = any, HttpContext = any> {
+  /**
+   * The service container
+   */
   container: typeof Container;
+  /**
+   * Register service container bindings
+   */
   bind: PluginBind;
-  resolveArguments: (resolver: PluginArgumentsResolver) => void;
+  /**
+   * Replace all controller method arguments
+   * @param resolver
+   * @returns
+   */
+  resolveArguments: (resolver: PluginArgumentsResolver<HttpContext>) => void;
+  /**
+   * Use the current http context
+   */
+  useHttpContext: (resolver: PluginArgumentsResolver<HttpContext>) => void;
+  /**
+   * All registered service container bindings
+   */
   bindings: Record<string, BindValue>;
+  /**
+   * Configures the router with the given options, such as method override settings
+   *
+   * @param options
+   * @returns
+   */
   configure: (options: RouterConfig) => void;
+  /**
+   * Default configuration used for everytime the router is reset
+   *
+   * @param options
+   */
   configureDefaults: (options: RouterConfig) => void;
+  /**
+   * The current Request instance
+   */
   readonly request?: Request;
+  /**
+   * The current Response instance
+   * @returns
+   */
   readonly response?: Response$1;
+  /**
+   * Get the current Request instance
+   * @returns
+   */
   getRequest: () => Request | undefined;
+  /**
+   * Get the current Response instance
+   * @returns
+   */
   getResponse: () => Response$1 | undefined;
+  /**
+   * Plugin configuration options
+   */
   options: Options;
 }
-interface ClearRouterPlugin<Options = any> {
+interface ClearRouterPlugin<Options = any, HttpContext = any> {
+  /**
+   * The name of the plugin
+   */
   name?: string;
-  setup: (ctx: ClearRouterPluginContext<Options>) => PluginSetupResult;
+  /**
+   * Plugin setup an implemnetation
+   *
+   * @param ctx
+   * @returns
+   */
+  setup: (ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult;
 }
-type ClearRouterPluginInput<Options = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options>) => PluginSetupResult);
-declare function definePlugin<Options = any>(plugin: ClearRouterPlugin<Options>): ClearRouterPlugin<Options>;
+type ClearRouterPluginInput<Options = any, HttpContext = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult);
+/**
+ * Creates a new plugin
+ *
+ * @param plugin
+ * @returns
+ */
+declare function definePlugin<Options = any, HttpContext = any>(plugin: ClearRouterPlugin<Options, HttpContext>): ClearRouterPlugin<Options, HttpContext>;
 //#endregion
 //#region src/core/router.d.ts
 /**
@@ -241,6 +303,7 @@ declare abstract class CoreRouter {
   private static readonly defaultConfigKey;
   private static readonly pluginStoreKey;
   private static readonly pluginPendingKey;
+  private static readonly pluginHttpCtxResolversKey;
   private static readonly pluginArgumentResolversKey;
   private static requestProvider?;
   private static responseProvider?;
@@ -249,7 +312,7 @@ declare abstract class CoreRouter {
     prefix: string;
     groupMiddlewares: any[];
   }>;
-  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext>;
+  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext<any>>;
   static routes: Set<Route<any, any, any>>;
   static routesByPathMethod: Map<string, Route<any, any, any>>;
   static routesByMethod: Map<"GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD", Route<any, any, any>[]>;
@@ -269,6 +332,7 @@ declare abstract class CoreRouter {
   protected static getPluginStore(): Set<string>;
   protected static getPluginPendingStore(): Set<Promise<void>>;
   protected static getPluginArgumentResolvers(): Set<PluginArgumentsResolver>;
+  protected static getPluginHttpCtxResolvers(): Set<PluginArgumentsResolver>;
   protected static createDefaultState(): {
     config: RouterConfig;
     groupContext: AsyncLocalStorage<{
@@ -285,6 +349,11 @@ declare abstract class CoreRouter {
   };
   protected static bindStateAccessors(): void;
   protected static createDefaultOptionsHandler(): any;
+  /**
+   * Default configuration used for everytime the router is reset
+   *
+   * @param options
+   */
   static configureDefaults(options?: RouterConfig): void;
   /**
    * Use a registered plugin
@@ -299,7 +368,8 @@ declare abstract class CoreRouter {
   protected static getCurrentPluginRequestContext(): ClearRouterPluginRequestContext | undefined;
   protected static createPluginRequestContext(ctx: any): ClearRouterPluginRequestContext;
   protected static createPluginBind(): PluginBind;
-  protected static resolvePluginArguments(this: any, ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static resolvePluginArguments(ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static resolvePluginHttpCtx(ctx: any): Promise<void>;
   protected static ensureState(): void;
   /**
    * Normalizes a path by ensuring it starts with a single slash and does not have trailing

package/dist/index.mjs

@@ -178,6 +178,12 @@ var Response = class {
 
 //#endregion
 //#region src/core/plugins.ts
+/**
+* Creates a new plugin
+* 
+* @param plugin 
+* @returns 
+*/
 function definePlugin(plugin) {
 	return plugin;
 }
@@ -298,6 +304,7 @@ var CoreRouter = class {
 	static defaultConfigKey = Symbol.for("clear-router:default-config");
 	static pluginStoreKey = Symbol.for("clear-router:plugins");
 	static pluginPendingKey = Symbol.for("clear-router:plugin-promises");
+	static pluginHttpCtxResolversKey = Symbol.for("clear-router:plugin-http-ctx");
 	static pluginArgumentResolversKey = Symbol.for("clear-router:plugin-argument-resolvers");
 	static requestProvider;
 	static responseProvider;
@@ -393,6 +400,11 @@ var CoreRouter = class {
 		if (!g[this.pluginArgumentResolversKey]) g[this.pluginArgumentResolversKey] = /* @__PURE__ */ new Set();
 		return g[this.pluginArgumentResolversKey];
 	}
+	static getPluginHttpCtxResolvers() {
+		const g = globalThis;
+		if (!g[this.pluginHttpCtxResolversKey]) g[this.pluginHttpCtxResolversKey] = /* @__PURE__ */ new Set();
+		return g[this.pluginHttpCtxResolversKey];
+	}
 	static createDefaultState() {
 		return {
 			config: this.getDefaultConfig(),
@@ -474,6 +486,11 @@ var CoreRouter = class {
 			}
 		};
 	}
+	/**
+	* Default configuration used for everytime the router is reset
+	* 
+	* @param options 
+	*/
 	static configureDefaults(options) {
 		const g = globalThis;
 		const defaults = this.mergeConfig(g[this.defaultConfigKey] || this.createBaseConfig(), options);
@@ -501,6 +518,9 @@ var CoreRouter = class {
 				resolveArguments: (resolver) => {
 					this.getPluginArgumentResolvers().add(resolver);
 				},
+				useHttpContext: (resolver) => {
+					this.getPluginHttpCtxResolvers().add(resolver);
+				},
 				bindings: Container.bindings(),
 				configure: this.configure.bind(this),
 				configureDefaults: this.configureDefaults.bind(this),
@@ -571,6 +591,12 @@ var CoreRouter = class {
 			if (Array.isArray(args)) return args;
 		}
 	}
+	static async resolvePluginHttpCtx(ctx) {
+		const resolvers = Array.from(this.getPluginHttpCtxResolvers());
+		if (!resolvers.length) return void 0;
+		const pluginContext = this.createPluginRequestContext(ctx);
+		for (const resolver of resolvers) await resolver(pluginContext);
+	}
 	static ensureState() {
 		this.bindStateAccessors();
 		if (!this.config) this.config = { methodOverride: {
@@ -994,6 +1020,7 @@ var CoreRouter = class {
 	static async callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata) {
 		return this.pluginRequestContext.run(this.createPluginRequestContext(ctx), async () => {
 			await this.pluginsReady();
+			await this.resolvePluginHttpCtx(ctx);
 			if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
 			const designTokens = [...bindingTarget ? getDesignParamTypes(bindingTarget, bindingMethod) : [], ...bindingHandler ? getDesignParamTypes(bindingHandler) : []];
 			const metadata = getBindingMetadataFromTargets([

package/dist/koa/index.cjs

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

package/dist/koa/index.d.cts

@@ -1,4 +1,4 @@
-import { F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, _ as KoaRouterApp, g as HttpContext, h as Handler, m as Route, t as CoreRouter, v as Middleware } from "../router-BHC0lGtp.cjs";
+import { F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, _ as KoaRouterApp, g as HttpContext, h as Handler, m as Route, t as CoreRouter, v as Middleware } from "../router-C7oMjml0.cjs";
 
 //#region src/koa/router.d.ts
 /**

package/dist/koa/index.d.mts

@@ -1,4 +1,4 @@
-import { F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, _ as KoaRouterApp, g as HttpContext, h as Handler, m as Route, t as CoreRouter, v as Middleware } from "../router-BOKe0n0j.mjs";
+import { F as ControllerAction, I as HttpMethod, P as ApiResourceMiddleware, _ as KoaRouterApp, g as HttpContext, h as Handler, m as Route, t as CoreRouter, v as Middleware } from "../router-B86hTwHL.mjs";
 
 //#region src/koa/router.d.ts
 /**

package/dist/koa/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-kOleKr2w.mjs";
+import { t as CoreRouter } from "../router-Dc9w86Wn.mjs";
 import { n as resolveResponseMeta, t as isFetchResponse } from "../responses-BvETUeDL.mjs";
 
 //#region src/koa/router.ts

package/dist/{router-BOKe0n0j.d.mts → router-B86hTwHL.d.mts}

@@ -265,14 +265,14 @@ declare class Request$1<X = any, M = any> extends ClearRequest<X, M> {
 //#endregion
 //#region src/core/plugins.d.ts
 type PluginSetupResult = void | Promise<void>;
-interface ClearRouterPluginRequestContext {
-  ctx: any;
+interface ClearRouterPluginRequestContext<HttpContext = any> {
+  ctx: HttpContext;
   request: Request$1;
   response: Response$2;
   getBindings: () => Record<string, BindValue>;
   [key: string]: any;
 }
-interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestContext {
+interface ClearRouterPluginArgumentsContext<X = any> extends ClearRouterPluginRequestContext<X> {
   target?: object;
   method?: PropertyKey;
   handler?: object;
@@ -283,26 +283,88 @@ interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestCont
 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;
-type PluginArgumentsResolver = (ctx: ClearRouterPluginArgumentsContext) => any[] | undefined | Promise<any[] | undefined>;
-interface ClearRouterPluginContext<Options = any> {
+type PluginArgumentsResolver<HttpContext = any> = (ctx: ClearRouterPluginArgumentsContext<HttpContext>) => any[] | undefined | Promise<any[] | undefined>;
+interface ClearRouterPluginContext<Options = any, HttpContext = any> {
+  /**
+   * The service container
+   */
   container: typeof Container;
+  /**
+   * Register service container bindings
+   */
   bind: PluginBind;
-  resolveArguments: (resolver: PluginArgumentsResolver) => void;
+  /**
+   * Replace all controller method arguments
+   * @param resolver
+   * @returns
+   */
+  resolveArguments: (resolver: PluginArgumentsResolver<HttpContext>) => void;
+  /**
+   * Use the current http context
+   */
+  useHttpContext: (resolver: PluginArgumentsResolver<HttpContext>) => void;
+  /**
+   * All registered service container bindings
+   */
   bindings: Record<string, BindValue>;
+  /**
+   * Configures the router with the given options, such as method override settings
+   *
+   * @param options
+   * @returns
+   */
   configure: (options: RouterConfig) => void;
+  /**
+   * Default configuration used for everytime the router is reset
+   *
+   * @param options
+   */
   configureDefaults: (options: RouterConfig) => void;
+  /**
+   * The current Request instance
+   */
   readonly request?: Request$1;
+  /**
+   * The current Response instance
+   * @returns
+   */
   readonly response?: Response$2;
+  /**
+   * Get the current Request instance
+   * @returns
+   */
   getRequest: () => Request$1 | undefined;
+  /**
+   * Get the current Response instance
+   * @returns
+   */
   getResponse: () => Response$2 | undefined;
+  /**
+   * Plugin configuration options
+   */
   options: Options;
 }
-interface ClearRouterPlugin<Options = any> {
+interface ClearRouterPlugin<Options = any, HttpContext = any> {
+  /**
+   * The name of the plugin
+   */
   name?: string;
-  setup: (ctx: ClearRouterPluginContext<Options>) => PluginSetupResult;
+  /**
+   * Plugin setup an implemnetation
+   *
+   * @param ctx
+   * @returns
+   */
+  setup: (ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult;
 }
-type ClearRouterPluginInput<Options = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options>) => PluginSetupResult);
-declare function definePlugin<Options = any>(plugin: ClearRouterPlugin<Options>): ClearRouterPlugin<Options>;
+type ClearRouterPluginInput<Options = any, HttpContext = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult);
+/**
+ * Creates a new plugin
+ *
+ * @param plugin
+ * @returns
+ */
+declare function definePlugin<Options = any, HttpContext = any>(plugin: ClearRouterPlugin<Options, HttpContext>): ClearRouterPlugin<Options, HttpContext>;
 //#endregion
 //#region src/Controller.d.ts
 declare abstract class Controller<X = any> {
@@ -328,6 +390,7 @@ declare abstract class CoreRouter {
   private static readonly defaultConfigKey;
   private static readonly pluginStoreKey;
   private static readonly pluginPendingKey;
+  private static readonly pluginHttpCtxResolversKey;
   private static readonly pluginArgumentResolversKey;
   private static requestProvider?;
   private static responseProvider?;
@@ -336,7 +399,7 @@ declare abstract class CoreRouter {
     prefix: string;
     groupMiddlewares: any[];
   }>;
-  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext>;
+  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext<any>>;
   static routes: Set<Route<any, any, any>>;
   static routesByPathMethod: Map<string, Route<any, any, any>>;
   static routesByMethod: Map<"GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD", Route<any, any, any>[]>;
@@ -356,6 +419,7 @@ declare abstract class CoreRouter {
   protected static getPluginStore(): Set<string>;
   protected static getPluginPendingStore(): Set<Promise<void>>;
   protected static getPluginArgumentResolvers(): Set<PluginArgumentsResolver>;
+  protected static getPluginHttpCtxResolvers(): Set<PluginArgumentsResolver>;
   protected static createDefaultState(): {
     config: RouterConfig;
     groupContext: AsyncLocalStorage<{
@@ -372,6 +436,11 @@ declare abstract class CoreRouter {
   };
   protected static bindStateAccessors(): void;
   protected static createDefaultOptionsHandler(): any;
+  /**
+   * Default configuration used for everytime the router is reset
+   *
+   * @param options
+   */
   static configureDefaults(options?: RouterConfig): void;
   /**
    * Use a registered plugin
@@ -386,7 +455,8 @@ declare abstract class CoreRouter {
   protected static getCurrentPluginRequestContext(): ClearRouterPluginRequestContext | undefined;
   protected static createPluginRequestContext(ctx: any): ClearRouterPluginRequestContext;
   protected static createPluginBind(): PluginBind;
-  protected static resolvePluginArguments(this: any, ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static resolvePluginArguments(ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static resolvePluginHttpCtx(ctx: any): Promise<void>;
   protected static ensureState(): void;
   /**
    * Normalizes a path by ensuring it starts with a single slash and does not have trailing

package/dist/{router-CcG0NS8L.cjs → router-C6W-k6sS.cjs}

@@ -72,6 +72,7 @@ var CoreRouter = class {
 	static defaultConfigKey = Symbol.for("clear-router:default-config");
 	static pluginStoreKey = Symbol.for("clear-router:plugins");
 	static pluginPendingKey = Symbol.for("clear-router:plugin-promises");
+	static pluginHttpCtxResolversKey = Symbol.for("clear-router:plugin-http-ctx");
 	static pluginArgumentResolversKey = Symbol.for("clear-router:plugin-argument-resolvers");
 	static requestProvider;
 	static responseProvider;
@@ -167,6 +168,11 @@ var CoreRouter = class {
 		if (!g[this.pluginArgumentResolversKey]) g[this.pluginArgumentResolversKey] = /* @__PURE__ */ new Set();
 		return g[this.pluginArgumentResolversKey];
 	}
+	static getPluginHttpCtxResolvers() {
+		const g = globalThis;
+		if (!g[this.pluginHttpCtxResolversKey]) g[this.pluginHttpCtxResolversKey] = /* @__PURE__ */ new Set();
+		return g[this.pluginHttpCtxResolversKey];
+	}
 	static createDefaultState() {
 		return {
 			config: this.getDefaultConfig(),
@@ -248,6 +254,11 @@ var CoreRouter = class {
 			}
 		};
 	}
+	/**
+	* Default configuration used for everytime the router is reset
+	* 
+	* @param options 
+	*/
 	static configureDefaults(options) {
 		const g = globalThis;
 		const defaults = this.mergeConfig(g[this.defaultConfigKey] || this.createBaseConfig(), options);
@@ -275,6 +286,9 @@ var CoreRouter = class {
 				resolveArguments: (resolver) => {
 					this.getPluginArgumentResolvers().add(resolver);
 				},
+				useHttpContext: (resolver) => {
+					this.getPluginHttpCtxResolvers().add(resolver);
+				},
 				bindings: require_bindings.Container.bindings(),
 				configure: this.configure.bind(this),
 				configureDefaults: this.configureDefaults.bind(this),
@@ -345,6 +359,12 @@ var CoreRouter = class {
 			if (Array.isArray(args)) return args;
 		}
 	}
+	static async resolvePluginHttpCtx(ctx) {
+		const resolvers = Array.from(this.getPluginHttpCtxResolvers());
+		if (!resolvers.length) return void 0;
+		const pluginContext = this.createPluginRequestContext(ctx);
+		for (const resolver of resolvers) await resolver(pluginContext);
+	}
 	static ensureState() {
 		this.bindStateAccessors();
 		if (!this.config) this.config = { methodOverride: {
@@ -768,6 +788,7 @@ var CoreRouter = class {
 	static async callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata) {
 		return this.pluginRequestContext.run(this.createPluginRequestContext(ctx), async () => {
 			await this.pluginsReady();
+			await this.resolvePluginHttpCtx(ctx);
 			if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
 			const designTokens = [...bindingTarget ? require_bindings.getDesignParamTypes(bindingTarget, bindingMethod) : [], ...bindingHandler ? require_bindings.getDesignParamTypes(bindingHandler) : []];
 			const metadata = require_bindings.getBindingMetadataFromTargets([

package/dist/{router-BHC0lGtp.d.cts → router-C7oMjml0.d.cts}

@@ -265,14 +265,14 @@ declare class Request$1<X = any, M = any> extends ClearRequest<X, M> {
 //#endregion
 //#region src/core/plugins.d.ts
 type PluginSetupResult = void | Promise<void>;
-interface ClearRouterPluginRequestContext {
-  ctx: any;
+interface ClearRouterPluginRequestContext<HttpContext = any> {
+  ctx: HttpContext;
   request: Request$1;
   response: Response$2;
   getBindings: () => Record<string, BindValue>;
   [key: string]: any;
 }
-interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestContext {
+interface ClearRouterPluginArgumentsContext<X = any> extends ClearRouterPluginRequestContext<X> {
   target?: object;
   method?: PropertyKey;
   handler?: object;
@@ -283,26 +283,88 @@ interface ClearRouterPluginArgumentsContext extends ClearRouterPluginRequestCont
 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;
-type PluginArgumentsResolver = (ctx: ClearRouterPluginArgumentsContext) => any[] | undefined | Promise<any[] | undefined>;
-interface ClearRouterPluginContext<Options = any> {
+type PluginArgumentsResolver<HttpContext = any> = (ctx: ClearRouterPluginArgumentsContext<HttpContext>) => any[] | undefined | Promise<any[] | undefined>;
+interface ClearRouterPluginContext<Options = any, HttpContext = any> {
+  /**
+   * The service container
+   */
   container: typeof Container;
+  /**
+   * Register service container bindings
+   */
   bind: PluginBind;
-  resolveArguments: (resolver: PluginArgumentsResolver) => void;
+  /**
+   * Replace all controller method arguments
+   * @param resolver
+   * @returns
+   */
+  resolveArguments: (resolver: PluginArgumentsResolver<HttpContext>) => void;
+  /**
+   * Use the current http context
+   */
+  useHttpContext: (resolver: PluginArgumentsResolver<HttpContext>) => void;
+  /**
+   * All registered service container bindings
+   */
   bindings: Record<string, BindValue>;
+  /**
+   * Configures the router with the given options, such as method override settings
+   *
+   * @param options
+   * @returns
+   */
   configure: (options: RouterConfig) => void;
+  /**
+   * Default configuration used for everytime the router is reset
+   *
+   * @param options
+   */
   configureDefaults: (options: RouterConfig) => void;
+  /**
+   * The current Request instance
+   */
   readonly request?: Request$1;
+  /**
+   * The current Response instance
+   * @returns
+   */
   readonly response?: Response$2;
+  /**
+   * Get the current Request instance
+   * @returns
+   */
   getRequest: () => Request$1 | undefined;
+  /**
+   * Get the current Response instance
+   * @returns
+   */
   getResponse: () => Response$2 | undefined;
+  /**
+   * Plugin configuration options
+   */
   options: Options;
 }
-interface ClearRouterPlugin<Options = any> {
+interface ClearRouterPlugin<Options = any, HttpContext = any> {
+  /**
+   * The name of the plugin
+   */
   name?: string;
-  setup: (ctx: ClearRouterPluginContext<Options>) => PluginSetupResult;
+  /**
+   * Plugin setup an implemnetation
+   *
+   * @param ctx
+   * @returns
+   */
+  setup: (ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult;
 }
-type ClearRouterPluginInput<Options = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options>) => PluginSetupResult);
-declare function definePlugin<Options = any>(plugin: ClearRouterPlugin<Options>): ClearRouterPlugin<Options>;
+type ClearRouterPluginInput<Options = any, HttpContext = any> = ClearRouterPlugin<Options> | ((ctx: ClearRouterPluginContext<Options, HttpContext>) => PluginSetupResult);
+/**
+ * Creates a new plugin
+ *
+ * @param plugin
+ * @returns
+ */
+declare function definePlugin<Options = any, HttpContext = any>(plugin: ClearRouterPlugin<Options, HttpContext>): ClearRouterPlugin<Options, HttpContext>;
 //#endregion
 //#region src/Controller.d.ts
 declare abstract class Controller<X = any> {
@@ -328,6 +390,7 @@ declare abstract class CoreRouter {
   private static readonly defaultConfigKey;
   private static readonly pluginStoreKey;
   private static readonly pluginPendingKey;
+  private static readonly pluginHttpCtxResolversKey;
   private static readonly pluginArgumentResolversKey;
   private static requestProvider?;
   private static responseProvider?;
@@ -336,7 +399,7 @@ declare abstract class CoreRouter {
     prefix: string;
     groupMiddlewares: any[];
   }>;
-  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext>;
+  protected static pluginRequestContext: AsyncLocalStorage<ClearRouterPluginRequestContext<any>>;
   static routes: Set<Route<any, any, any>>;
   static routesByPathMethod: Map<string, Route<any, any, any>>;
   static routesByMethod: Map<"GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD", Route<any, any, any>[]>;
@@ -356,6 +419,7 @@ declare abstract class CoreRouter {
   protected static getPluginStore(): Set<string>;
   protected static getPluginPendingStore(): Set<Promise<void>>;
   protected static getPluginArgumentResolvers(): Set<PluginArgumentsResolver>;
+  protected static getPluginHttpCtxResolvers(): Set<PluginArgumentsResolver>;
   protected static createDefaultState(): {
     config: RouterConfig;
     groupContext: AsyncLocalStorage<{
@@ -372,6 +436,11 @@ declare abstract class CoreRouter {
   };
   protected static bindStateAccessors(): void;
   protected static createDefaultOptionsHandler(): any;
+  /**
+   * Default configuration used for everytime the router is reset
+   *
+   * @param options
+   */
   static configureDefaults(options?: RouterConfig): void;
   /**
    * Use a registered plugin
@@ -386,7 +455,8 @@ declare abstract class CoreRouter {
   protected static getCurrentPluginRequestContext(): ClearRouterPluginRequestContext | undefined;
   protected static createPluginRequestContext(ctx: any): ClearRouterPluginRequestContext;
   protected static createPluginBind(): PluginBind;
-  protected static resolvePluginArguments(this: any, ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static resolvePluginArguments(ctx: any, routeContext: Omit<ClearRouterPluginArgumentsContext, keyof ClearRouterPluginRequestContext>): Promise<any[] | undefined>;
+  protected static resolvePluginHttpCtx(ctx: any): Promise<void>;
   protected static ensureState(): void;
   /**
    * Normalizes a path by ensuring it starts with a single slash and does not have trailing

package/dist/{router-kOleKr2w.mjs → router-Dc9w86Wn.mjs}

@@ -72,6 +72,7 @@ var CoreRouter = class {
 	static defaultConfigKey = Symbol.for("clear-router:default-config");
 	static pluginStoreKey = Symbol.for("clear-router:plugins");
 	static pluginPendingKey = Symbol.for("clear-router:plugin-promises");
+	static pluginHttpCtxResolversKey = Symbol.for("clear-router:plugin-http-ctx");
 	static pluginArgumentResolversKey = Symbol.for("clear-router:plugin-argument-resolvers");
 	static requestProvider;
 	static responseProvider;
@@ -167,6 +168,11 @@ var CoreRouter = class {
 		if (!g[this.pluginArgumentResolversKey]) g[this.pluginArgumentResolversKey] = /* @__PURE__ */ new Set();
 		return g[this.pluginArgumentResolversKey];
 	}
+	static getPluginHttpCtxResolvers() {
+		const g = globalThis;
+		if (!g[this.pluginHttpCtxResolversKey]) g[this.pluginHttpCtxResolversKey] = /* @__PURE__ */ new Set();
+		return g[this.pluginHttpCtxResolversKey];
+	}
 	static createDefaultState() {
 		return {
 			config: this.getDefaultConfig(),
@@ -248,6 +254,11 @@ var CoreRouter = class {
 			}
 		};
 	}
+	/**
+	* Default configuration used for everytime the router is reset
+	* 
+	* @param options 
+	*/
 	static configureDefaults(options) {
 		const g = globalThis;
 		const defaults = this.mergeConfig(g[this.defaultConfigKey] || this.createBaseConfig(), options);
@@ -275,6 +286,9 @@ var CoreRouter = class {
 				resolveArguments: (resolver) => {
 					this.getPluginArgumentResolvers().add(resolver);
 				},
+				useHttpContext: (resolver) => {
+					this.getPluginHttpCtxResolvers().add(resolver);
+				},
 				bindings: Container.bindings(),
 				configure: this.configure.bind(this),
 				configureDefaults: this.configureDefaults.bind(this),
@@ -345,6 +359,12 @@ var CoreRouter = class {
 			if (Array.isArray(args)) return args;
 		}
 	}
+	static async resolvePluginHttpCtx(ctx) {
+		const resolvers = Array.from(this.getPluginHttpCtxResolvers());
+		if (!resolvers.length) return void 0;
+		const pluginContext = this.createPluginRequestContext(ctx);
+		for (const resolver of resolvers) await resolver(pluginContext);
+	}
 	static ensureState() {
 		this.bindStateAccessors();
 		if (!this.config) this.config = { methodOverride: {
@@ -768,6 +788,7 @@ var CoreRouter = class {
 	static async callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata) {
 		return this.pluginRequestContext.run(this.createPluginRequestContext(ctx), async () => {
 			await this.pluginsReady();
+			await this.resolvePluginHttpCtx(ctx);
 			if (!this.config.container?.enabled) return handlerFunction(ctx, ctx.clearRequest);
 			const designTokens = [...bindingTarget ? getDesignParamTypes(bindingTarget, bindingMethod) : [], ...bindingHandler ? getDesignParamTypes(bindingHandler) : []];
 			const metadata = getBindingMetadataFromTargets([

package/package.json

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