clear-router 2.6.6 → 2.7.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![NPM Downloads](https://img.shields.io/npm/dt/clear-router.svg)](https://www.npmjs.com/package/clear-router)
 [![npm version](https://img.shields.io/npm/v/clear-router.svg)](https://www.npmjs.com/package/clear-router)
-[![License](https://img.shields.io/npm/l/clear-router.svg)](https://github.com/toneflix/clear-router/blob/main/LICENSE)
+[![License](https://img.shields.io/npm/l/clear-router.svg)](https://github.com/arkstack-tmp/clear-router/blob/main/LICENSE)
 [![Publish to NPM](https://github.com/arkstack-tmp/clear-router/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/arkstack-tmp/clear-router/actions/workflows/npm-publish.yml)
 [![Run Tests](https://github.com/arkstack-tmp/clear-router/actions/workflows/ci.yml/badge.svg)](https://github.com/arkstack-tmp/clear-router/actions/workflows/ci.yml)
 
@@ -146,4 +146,4 @@ MIT License © 2026 ToneFlix Technologies Limited
 
 ## Repository
 
-https://github.com/toneflix/clear-router
+https://github.com/arkstack-tmp/clear-router

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-CB7Duy0X.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-BITqScD_.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-Cl6q9Od3.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-Cs8cC5zd.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-1hB-k4No.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-CTzjojnD.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-CB7Duy0X.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-CTzjojnD.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-CB7Duy0X.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 
 //#region src/express/router.ts
@@ -9,7 +9,7 @@ const require_responses = require('../responses-Bvnk0uvc.cjs');
 * @description Laravel-style routing system for Express.js and H3 with support for CommonJS, ESM, and TypeScript
 * @author Refkinscallv
 * @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:express";

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-BITqScD_.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-Cl6q9Od3.cjs";
 import { Router as Router$1 } from "express";
 
 //#region src/express/router.d.ts
@@ -7,7 +7,7 @@ import { Router as Router$1 } from "express";
  * @description Laravel-style routing system for Express.js and H3 with support for CommonJS, ESM, and TypeScript
  * @author Refkinscallv
  * @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/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-Cs8cC5zd.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-1hB-k4No.mjs";
 import { Router as Router$1 } from "express";
 
 //#region src/express/router.d.ts
@@ -7,7 +7,7 @@ import { Router as Router$1 } from "express";
  * @description Laravel-style routing system for Express.js and H3 with support for CommonJS, ESM, and TypeScript
  * @author Refkinscallv
  * @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/express/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, r as responseWasSent, t as isFetchResponse } from "../responses-BvETUeDL.mjs";
 
 //#region src/express/router.ts
@@ -8,7 +8,7 @@ import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse }
 * @description Laravel-style routing system for Express.js and H3 with support for CommonJS, ESM, and TypeScript
 * @author Refkinscallv
 * @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:express";

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-CB7Duy0X.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 
 //#region src/fastify/router.ts
@@ -8,7 +8,7 @@ const require_responses = require('../responses-Bvnk0uvc.cjs');
 * @class clear-router Fastify Router
 * @description Laravel-style routing system for Fastify using 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:fastify";

package/dist/fastify/index.d.cts

@@ -1,11 +1,11 @@
-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-BITqScD_.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-Cl6q9Od3.cjs";
 
 //#region src/fastify/router.d.ts
 /**
  * @class clear-router Fastify Router
  * @description Laravel-style routing system for Fastify using 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/fastify/index.d.mts

@@ -1,11 +1,11 @@
-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-Cs8cC5zd.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-1hB-k4No.mjs";
 
 //#region src/fastify/router.d.ts
 /**
  * @class clear-router Fastify Router
  * @description Laravel-style routing system for Fastify using 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/fastify/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, r as responseWasSent, t as isFetchResponse } from "../responses-BvETUeDL.mjs";
 
 //#region src/fastify/router.ts
@@ -7,7 +7,7 @@ import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse }
 * @class clear-router Fastify Router
 * @description Laravel-style routing system for Fastify using 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:fastify";

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-CB7Duy0X.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 let h3 = require("h3");
 
@@ -9,7 +9,7 @@ let h3 = require("h3");
 * @class clear-router H3 Router
 * @description Laravel-style routing system for Express.js and H3 with support for CommonJS, ESM, and TypeScript
 * @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: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-BITqScD_.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-Cl6q9Od3.cjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts
@@ -6,7 +6,7 @@ import { H3 } from "h3";
  * @class clear-router H3 Router
  * @description Laravel-style routing system for Express.js and H3 with support for CommonJS, ESM, and TypeScript
  * @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/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-Cs8cC5zd.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-1hB-k4No.mjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts
@@ -6,7 +6,7 @@ import { H3 } from "h3";
  * @class clear-router H3 Router
  * @description Laravel-style routing system for Express.js and H3 with support for CommonJS, ESM, and TypeScript
  * @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/h3/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 } from "../responses-BvETUeDL.mjs";
 import { HTTPResponse, getQuery, getRouterParams, readBody } from "h3";
 
@@ -8,7 +8,7 @@ import { HTTPResponse, getQuery, getRouterParams, readBody } from "h3";
 * @class clear-router H3 Router
 * @description Laravel-style routing system for Express.js and H3 with support for CommonJS, ESM, and TypeScript
 * @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: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-CB7Duy0X.cjs');
+const require_router = require('../router-C6W-k6sS.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 
 //#region src/hono/router.ts
@@ -8,7 +8,7 @@ const require_responses = require('../responses-Bvnk0uvc.cjs');
 * @class clear-router Hono Router
 * @description Laravel-style routing system for Hono using 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:hono";

package/dist/hono/index.d.cts

@@ -1,11 +1,11 @@
-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-BITqScD_.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-Cl6q9Od3.cjs";
 
 //#region src/hono/router.d.ts
 /**
  * @class clear-router Hono Router
  * @description Laravel-style routing system for Hono using 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/hono/index.d.mts

@@ -1,11 +1,11 @@
-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-Cs8cC5zd.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-1hB-k4No.mjs";
 
 //#region src/hono/router.d.ts
 /**
  * @class clear-router Hono Router
  * @description Laravel-style routing system for Hono using 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/hono/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 } from "../responses-BvETUeDL.mjs";
 
 //#region src/hono/router.ts
@@ -7,7 +7,7 @@ import { n as resolveResponseMeta } from "../responses-BvETUeDL.mjs";
 * @class clear-router Hono Router
 * @description Laravel-style routing system for Hono using 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:hono";

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;
 }
@@ -290,7 +296,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";
@@ -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

@@ -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