clear-router 2.6.6 → 2.7.0

package/dist/index.d.mts

@@ -207,32 +207,94 @@ type PluginBindFactory<T = any> = (ctx: ClearRouterPluginRequestContext) => 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> {
+interface ClearRouterPluginContext<Options = any, _HttpContext = any> {
+  /**
+   * The service container
+   */
   container: typeof Container;
+  /**
+   * Register service container bindings
+   */
   bind: PluginBind;
+  /**
+   * Replace all controller method arguments
+   * @param resolver
+   * @returns
+   */
   resolveArguments: (resolver: PluginArgumentsResolver) => void;
+  /**
+   * Use the current http context
+   */
+  useHttpContext: (resolver: PluginArgumentsResolver) => 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
 /**
  * @class clear-router CoreRouter
  * @description Core routing logic for clear-router, shared between all supported adapters (Express.js, H3, etc.)
  * @author 3m1n3nc3
- * @repository https://github.com/toneflix/clear-router
+ * @repository https://github.com/arkstack-tmp/clear-router
  */
 declare abstract class CoreRouter {
   protected static routerStateNamespace: string;
@@ -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?;
@@ -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;
 }
@@ -289,7 +295,7 @@ function isClass(value) {
 * @class clear-router CoreRouter
 * @description Core routing logic for clear-router, shared between all supported adapters (Express.js, H3, etc.)
 * @author 3m1n3nc3
-* @repository https://github.com/toneflix/clear-router
+* @repository https://github.com/arkstack-tmp/clear-router
 */
 var CoreRouter = class {
 	static routerStateNamespace = "clear-router:core";
@@ -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-CB7Duy0X.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 
 //#region src/koa/router.ts
@@ -8,7 +8,7 @@ const require_responses = require('../responses-Bvnk0uvc.cjs');
 * @class clear-router Koa Router
 * @description Laravel-style routing system for Koa using @koa/router and shared clear-router core
 * @author 3m1n3nc3
-* @repository https://github.com/toneflix/clear-router
+* @repository https://github.com/arkstack-tmp/clear-router
 */
 var Router = class Router extends require_router.CoreRouter {
 	static routerStateNamespace = "clear-router:koa";

package/dist/koa/index.d.cts

@@ -1,11 +1,11 @@
-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-BITqScD_.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-Cl6q9Od3.cjs";
 
 //#region src/koa/router.d.ts
 /**
  * @class clear-router Koa Router
  * @description Laravel-style routing system for Koa using @koa/router and shared clear-router core
  * @author 3m1n3nc3
- * @repository https://github.com/toneflix/clear-router
+ * @repository https://github.com/arkstack-tmp/clear-router
  */
 declare class Router extends CoreRouter {
   protected static routerStateNamespace: string;

package/dist/koa/index.d.mts

@@ -1,11 +1,11 @@
-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-Cs8cC5zd.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-1hB-k4No.mjs";
 
 //#region src/koa/router.d.ts
 /**
  * @class clear-router Koa Router
  * @description Laravel-style routing system for Koa using @koa/router and shared clear-router core
  * @author 3m1n3nc3
- * @repository https://github.com/toneflix/clear-router
+ * @repository https://github.com/arkstack-tmp/clear-router
  */
 declare class Router extends CoreRouter {
   protected static routerStateNamespace: string;

package/dist/koa/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-CTzjojnD.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
@@ -7,7 +7,7 @@ import { n as resolveResponseMeta, t as isFetchResponse } from "../responses-BvE
 * @class clear-router Koa Router
 * @description Laravel-style routing system for Koa using @koa/router and shared clear-router core
 * @author 3m1n3nc3
-* @repository https://github.com/toneflix/clear-router
+* @repository https://github.com/arkstack-tmp/clear-router
 */
 var Router = class Router extends CoreRouter {
 	static routerStateNamespace = "clear-router:koa";

package/dist/{router-Cs8cC5zd.d.mts → router-1hB-k4No.d.mts}

@@ -284,25 +284,87 @@ type PluginBindFactory<T = any> = (ctx: ClearRouterPluginRequestContext) => 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> {
+interface ClearRouterPluginContext<Options = any, _HttpContext = any> {
+  /**
+   * The service container
+   */
   container: typeof Container;
+  /**
+   * Register service container bindings
+   */
   bind: PluginBind;
+  /**
+   * Replace all controller method arguments
+   * @param resolver
+   * @returns
+   */
   resolveArguments: (resolver: PluginArgumentsResolver) => void;
+  /**
+   * Use the current http context
+   */
+  useHttpContext: (resolver: PluginArgumentsResolver) => 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> {
@@ -319,7 +381,7 @@ declare abstract class Controller<X = any> {
  * @class clear-router CoreRouter
  * @description Core routing logic for clear-router, shared between all supported adapters (Express.js, H3, etc.)
  * @author 3m1n3nc3
- * @repository https://github.com/toneflix/clear-router
+ * @repository https://github.com/arkstack-tmp/clear-router
  */
 declare abstract class CoreRouter {
   protected static routerStateNamespace: string;
@@ -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?;
@@ -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-CB7Duy0X.cjs → router-C6W-k6sS.cjs}

@@ -63,7 +63,7 @@ var Route = class {
 * @class clear-router CoreRouter
 * @description Core routing logic for clear-router, shared between all supported adapters (Express.js, H3, etc.)
 * @author 3m1n3nc3
-* @repository https://github.com/toneflix/clear-router
+* @repository https://github.com/arkstack-tmp/clear-router
 */
 var CoreRouter = class {
 	static routerStateNamespace = "clear-router:core";
@@ -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-BITqScD_.d.cts → router-Cl6q9Od3.d.cts}

@@ -284,25 +284,87 @@ type PluginBindFactory<T = any> = (ctx: ClearRouterPluginRequestContext) => 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> {
+interface ClearRouterPluginContext<Options = any, _HttpContext = any> {
+  /**
+   * The service container
+   */
   container: typeof Container;
+  /**
+   * Register service container bindings
+   */
   bind: PluginBind;
+  /**
+   * Replace all controller method arguments
+   * @param resolver
+   * @returns
+   */
   resolveArguments: (resolver: PluginArgumentsResolver) => void;
+  /**
+   * Use the current http context
+   */
+  useHttpContext: (resolver: PluginArgumentsResolver) => 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> {
@@ -319,7 +381,7 @@ declare abstract class Controller<X = any> {
  * @class clear-router CoreRouter
  * @description Core routing logic for clear-router, shared between all supported adapters (Express.js, H3, etc.)
  * @author 3m1n3nc3
- * @repository https://github.com/toneflix/clear-router
+ * @repository https://github.com/arkstack-tmp/clear-router
  */
 declare abstract class CoreRouter {
   protected static routerStateNamespace: string;
@@ -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?;
@@ -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