clear-router 2.1.7 → 2.1.9

package/README.md

@@ -1,5 +1,11 @@
 # Clear Router
 
+[![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)
+[![Publish to NPM](https://github.com/arkstack-hq/clear-router/actions/workflows/npm-publish.yml/badge.svg)](https://github.com/arkstack-hq/clear-router/actions/workflows/npm-publish.yml)
+[![Run Tests](https://github.com/arkstack-hq/clear-router/actions/workflows/ci.yml/badge.svg)](https://github.com/arkstack-hq/clear-router/actions/workflows/ci.yml)
+
 Laravel-style routing system for H3 and Express.js, with clean route definitions, middleware support, controller bindings and full TypeScript support.
 
 ## Installation

package/dist/{express-D9GR9yTH.d.mts → basic-Chn8OGPD.d.cts}

@@ -1,24 +1,6 @@
-import { H3, H3Event, Middleware as Middleware$1, TypedServerRequest } from "h3";
 import { NextFunction, Request, Response as Response$1 } from "express";
+import { H3, H3Event, Middleware as Middleware$1, TypedServerRequest } from "h3";
 
-//#region types/basic.d.ts
-/**
- * Controller method reference
- */
-type ControllerHandler = [any, string];
-/**
- * HTTP methods supported by the router
- */
-type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
-/**
- * Common controller action names
- */
-type ControllerAction = 'index' | 'show' | 'create' | 'update' | 'destroy';
-/**
- * Generic Object type for request data
- */
-type RequestData = Record<string, any>;
-//#endregion
 //#region types/h3.d.ts
 type H3App = Omit<H3['fetch'], 'fetch'> & {
   fetch: (request: TypedServerRequest) => Promise<Response>;
@@ -115,4 +97,23 @@ type Handler = RouteHandler | ControllerHandler;
  */
 type Middleware = (req: Request, res: Response$1, next: NextFunction) => any | Promise<any>;
 //#endregion
-export { H3App as a, Middleware$1 as c, Route as i, ControllerAction as l, HttpContext as n, Handler$1 as o, Middleware as r, HttpContext$1 as s, Handler as t, HttpMethod as u };
+//#region types/basic.d.ts
+/**
+ * Controller method reference
+ */
+type ControllerHandler = [any, string];
+/**
+ * HTTP methods supported by the router
+ */
+type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
+/**
+ * Common controller action names
+ */
+type ControllerAction = 'index' | 'show' | 'create' | 'update' | 'destroy';
+/**
+ * Generic Object type for request data
+ */
+type RequestData = Record<string, any>;
+type ApiResourceMiddleware<M extends Middleware | Middleware$1> = M | M[] | { [K in ControllerAction]?: M | M[] };
+//#endregion
+export { HttpContext as a, H3App as c, Middleware$1 as d, Handler as i, Handler$1 as l, ControllerAction as n, Middleware as o, HttpMethod as r, Route as s, ApiResourceMiddleware as t, HttpContext$1 as u };

package/dist/{express-JHxK-EqQ.d.cts → basic-DJmmZq1h.d.mts}

@@ -1,24 +1,6 @@
-import { NextFunction, Request, Response as Response$1 } from "express";
 import { H3, H3Event, Middleware as Middleware$1, TypedServerRequest } from "h3";
+import { NextFunction, Request, Response as Response$1 } from "express";
 
-//#region types/basic.d.ts
-/**
- * Controller method reference
- */
-type ControllerHandler = [any, string];
-/**
- * HTTP methods supported by the router
- */
-type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
-/**
- * Common controller action names
- */
-type ControllerAction = 'index' | 'show' | 'create' | 'update' | 'destroy';
-/**
- * Generic Object type for request data
- */
-type RequestData = Record<string, any>;
-//#endregion
 //#region types/h3.d.ts
 type H3App = Omit<H3['fetch'], 'fetch'> & {
   fetch: (request: TypedServerRequest) => Promise<Response>;
@@ -115,4 +97,23 @@ type Handler = RouteHandler | ControllerHandler;
  */
 type Middleware = (req: Request, res: Response$1, next: NextFunction) => any | Promise<any>;
 //#endregion
-export { H3App as a, Middleware$1 as c, Route as i, ControllerAction as l, HttpContext as n, Handler$1 as o, Middleware as r, HttpContext$1 as s, Handler as t, HttpMethod as u };
+//#region types/basic.d.ts
+/**
+ * Controller method reference
+ */
+type ControllerHandler = [any, string];
+/**
+ * HTTP methods supported by the router
+ */
+type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
+/**
+ * Common controller action names
+ */
+type ControllerAction = 'index' | 'show' | 'create' | 'update' | 'destroy';
+/**
+ * Generic Object type for request data
+ */
+type RequestData = Record<string, any>;
+type ApiResourceMiddleware<M extends Middleware | Middleware$1> = M | M[] | { [K in ControllerAction]?: M | M[] };
+//#endregion
+export { HttpContext as a, H3App as c, Middleware$1 as d, Handler as i, Handler$1 as l, ControllerAction as n, Middleware as o, HttpMethod as r, Route as s, ApiResourceMiddleware as t, HttpContext$1 as u };

package/dist/express/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_Route = require('../Route-DhC4kNPX.cjs');
+let node_async_hooks = require("node:async_hooks");
 
 //#region src/express/router.ts
 /**
@@ -10,6 +11,7 @@ const require_Route = require('../Route-DhC4kNPX.cjs');
 * @repository https://github.com/toneflix/clear-router
 */
 var Router = class Router {
+	static groupContext = new node_async_hooks.AsyncLocalStorage();
 	/**
 	* All registered routes
 	*/
@@ -50,11 +52,15 @@ var Router = class Router {
 	* @param middlewares - Array of middleware functions
 	*/
 	static add(methods, path, handler, middlewares) {
+		const context = this.groupContext.getStore();
+		const activePrefix = context?.prefix ?? this.prefix;
+		const activeGroupMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
 		methods = Array.isArray(methods) ? methods : [methods];
-		const fullPath = this.normalizePath(`${this.prefix}/${path}`);
+		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
+		const fullPath = this.normalizePath(`${activePrefix}/${path}`);
 		const route = new require_Route.Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
 			...this.globalMiddlewares,
-			...this.groupMiddlewares,
+			...activeGroupMiddlewares,
 			...middlewares || []
 		]);
 		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, ({ res }) => {
@@ -105,7 +111,8 @@ var Router = class Router {
 			if (except.includes(action)) continue;
 			if (typeof preController[action] === "function") {
 				const { method, path } = actions[action];
-				this.add(method, `${basePath}${path}`, [controller, action]);
+				const actionMiddlewares = typeof options?.middlewares === "object" && !Array.isArray(options.middlewares) ? options.middlewares[action] : options?.middlewares;
+				this.add(method, `${basePath}${path}`, [controller, action], Array.isArray(actionMiddlewares) ? actionMiddlewares : actionMiddlewares ? [actionMiddlewares] : void 0);
 			}
 		}
 	}
@@ -179,17 +186,17 @@ var Router = class Router {
 	* @param middlewares - Middleware functions applied to all routes in group
 	*/
 	static async group(prefix, callback, middlewares) {
-		const previousPrefix = this.prefix;
-		const previousMiddlewares = this.groupMiddlewares;
+		const context = this.groupContext.getStore();
+		const previousPrefix = context?.prefix ?? this.prefix;
+		const previousMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
 		const fullPrefix = [previousPrefix, prefix].filter(Boolean).join("/");
-		this.prefix = this.normalizePath(fullPrefix);
-		this.groupMiddlewares = [...previousMiddlewares, ...middlewares || []];
-		try {
+		const nextContext = {
+			prefix: this.normalizePath(fullPrefix),
+			groupMiddlewares: [...previousMiddlewares, ...middlewares || []]
+		};
+		await this.groupContext.run(nextContext, async () => {
 			await Promise.resolve(callback());
-		} finally {
-			this.prefix = previousPrefix;
-			this.groupMiddlewares = previousMiddlewares;
-		}
+		});
 	}
 	/**
 	* Apply global middlewares for the duration of the callback

package/dist/express/index.d.cts

@@ -1,4 +1,4 @@
-import { i as Route, l as ControllerAction, n as HttpContext, r as Middleware, t as Handler, u as HttpMethod } from "../express-JHxK-EqQ.cjs";
+import { a as HttpContext, i as Handler, n as ControllerAction, o as Middleware, r as HttpMethod, s as Route, t as ApiResourceMiddleware } from "../basic-Chn8OGPD.cjs";
 import { Router as Router$1 } from "express";
 
 //#region src/express/router.d.ts
@@ -10,6 +10,7 @@ import { Router as Router$1 } from "express";
  * @repository https://github.com/toneflix/clear-router
  */
 declare class Router {
+  private static readonly groupContext;
   /**
    * All registered routes
    */
@@ -47,7 +48,7 @@ declare class Router {
     * @param handler - Route handler function or controller reference
     * @param middlewares - Array of middleware functions
     */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register RESTful API resource routes for a controller with optional action filtering
    *
@@ -58,6 +59,7 @@ declare class Router {
   static apiResource(basePath: string, controller: any, options?: {
     only?: ControllerAction[];
     except?: ControllerAction[];
+    middlewares?: ApiResourceMiddleware<Middleware>;
   }): void;
   /**
    * Register a GET route
@@ -65,49 +67,49 @@ declare class Router {
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a POST route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a PUT route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a DELETE route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a PATCH route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register an OPTIONS route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a HEAD route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Group routes with a common prefix and middlewares
    * @param prefix - URL prefix for grouped routes

package/dist/express/index.d.mts

@@ -1,4 +1,4 @@
-import { i as Route, l as ControllerAction, n as HttpContext, r as Middleware, t as Handler, u as HttpMethod } from "../express-D9GR9yTH.mjs";
+import { a as HttpContext, i as Handler, n as ControllerAction, o as Middleware, r as HttpMethod, s as Route, t as ApiResourceMiddleware } from "../basic-DJmmZq1h.mjs";
 import { Router as Router$1 } from "express";
 
 //#region src/express/router.d.ts
@@ -10,6 +10,7 @@ import { Router as Router$1 } from "express";
  * @repository https://github.com/toneflix/clear-router
  */
 declare class Router {
+  private static readonly groupContext;
   /**
    * All registered routes
    */
@@ -47,7 +48,7 @@ declare class Router {
     * @param handler - Route handler function or controller reference
     * @param middlewares - Array of middleware functions
     */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register RESTful API resource routes for a controller with optional action filtering
    *
@@ -58,6 +59,7 @@ declare class Router {
   static apiResource(basePath: string, controller: any, options?: {
     only?: ControllerAction[];
     except?: ControllerAction[];
+    middlewares?: ApiResourceMiddleware<Middleware>;
   }): void;
   /**
    * Register a GET route
@@ -65,49 +67,49 @@ declare class Router {
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a POST route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a PUT route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a DELETE route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a PATCH route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register an OPTIONS route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a HEAD route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Group routes with a common prefix and middlewares
    * @param prefix - URL prefix for grouped routes

package/dist/express/index.mjs

@@ -1,4 +1,5 @@
 import { n as ClearRequest, t as Route } from "../Route-BbPXcDGX.mjs";
+import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/express/router.ts
 /**
@@ -9,6 +10,7 @@ import { n as ClearRequest, t as Route } from "../Route-BbPXcDGX.mjs";
 * @repository https://github.com/toneflix/clear-router
 */
 var Router = class Router {
+	static groupContext = new AsyncLocalStorage();
 	/**
 	* All registered routes
 	*/
@@ -49,11 +51,15 @@ var Router = class Router {
 	* @param middlewares - Array of middleware functions
 	*/
 	static add(methods, path, handler, middlewares) {
+		const context = this.groupContext.getStore();
+		const activePrefix = context?.prefix ?? this.prefix;
+		const activeGroupMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
 		methods = Array.isArray(methods) ? methods : [methods];
-		const fullPath = this.normalizePath(`${this.prefix}/${path}`);
+		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
+		const fullPath = this.normalizePath(`${activePrefix}/${path}`);
 		const route = new Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
 			...this.globalMiddlewares,
-			...this.groupMiddlewares,
+			...activeGroupMiddlewares,
 			...middlewares || []
 		]);
 		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, ({ res }) => {
@@ -104,7 +110,8 @@ var Router = class Router {
 			if (except.includes(action)) continue;
 			if (typeof preController[action] === "function") {
 				const { method, path } = actions[action];
-				this.add(method, `${basePath}${path}`, [controller, action]);
+				const actionMiddlewares = typeof options?.middlewares === "object" && !Array.isArray(options.middlewares) ? options.middlewares[action] : options?.middlewares;
+				this.add(method, `${basePath}${path}`, [controller, action], Array.isArray(actionMiddlewares) ? actionMiddlewares : actionMiddlewares ? [actionMiddlewares] : void 0);
 			}
 		}
 	}
@@ -178,17 +185,17 @@ var Router = class Router {
 	* @param middlewares - Middleware functions applied to all routes in group
 	*/
 	static async group(prefix, callback, middlewares) {
-		const previousPrefix = this.prefix;
-		const previousMiddlewares = this.groupMiddlewares;
+		const context = this.groupContext.getStore();
+		const previousPrefix = context?.prefix ?? this.prefix;
+		const previousMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
 		const fullPrefix = [previousPrefix, prefix].filter(Boolean).join("/");
-		this.prefix = this.normalizePath(fullPrefix);
-		this.groupMiddlewares = [...previousMiddlewares, ...middlewares || []];
-		try {
+		const nextContext = {
+			prefix: this.normalizePath(fullPrefix),
+			groupMiddlewares: [...previousMiddlewares, ...middlewares || []]
+		};
+		await this.groupContext.run(nextContext, async () => {
 			await Promise.resolve(callback());
-		} finally {
-			this.prefix = previousPrefix;
-			this.groupMiddlewares = previousMiddlewares;
-		}
+		});
 	}
 	/**
 	* Apply global middlewares for the duration of the callback

package/dist/h3/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_Route = require('../Route-DhC4kNPX.cjs');
+let node_async_hooks = require("node:async_hooks");
 let h3 = require("h3");
 
 //#region src/h3/router.ts
@@ -10,6 +11,7 @@ let h3 = require("h3");
 * @repository https://github.com/toneflix/clear-router
 */
 var Router = class Router {
+	static groupContext = new node_async_hooks.AsyncLocalStorage();
 	/**
 	* All registered routes
 	*/
@@ -50,11 +52,15 @@ var Router = class Router {
 	* @param middlewares - Array of middleware functions
 	*/
 	static add(methods, path, handler, middlewares) {
+		const context = this.groupContext.getStore();
+		const activePrefix = context?.prefix ?? this.prefix;
+		const activeGroupMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
 		methods = Array.isArray(methods) ? methods : [methods];
-		const fullPath = this.normalizePath(`${this.prefix}/${path}`);
+		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
+		const fullPath = this.normalizePath(`${activePrefix}/${path}`);
 		const route = new require_Route.Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
 			...this.globalMiddlewares,
-			...this.groupMiddlewares,
+			...activeGroupMiddlewares,
 			...middlewares || []
 		]);
 		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, ({ res }) => {
@@ -105,7 +111,8 @@ var Router = class Router {
 			if (except.includes(action)) continue;
 			if (typeof preController[action] === "function") {
 				const { method, path } = actions[action];
-				this.add(method, `${basePath}${path}`, [controller, action]);
+				const actionMiddlewares = typeof options?.middlewares === "object" && !Array.isArray(options.middlewares) ? options.middlewares[action] : options?.middlewares;
+				this.add(method, `${basePath}${path}`, [controller, action], Array.isArray(actionMiddlewares) ? actionMiddlewares : actionMiddlewares ? [actionMiddlewares] : void 0);
 			}
 		}
 	}
@@ -179,17 +186,17 @@ var Router = class Router {
 	* @param middlewares - Middleware functions applied to all routes in group
 	*/
 	static async group(prefix, callback, middlewares) {
-		const previousPrefix = this.prefix;
-		const previousMiddlewares = this.groupMiddlewares;
+		const context = this.groupContext.getStore();
+		const previousPrefix = context?.prefix ?? this.prefix;
+		const previousMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
 		const fullPrefix = [previousPrefix, prefix].filter(Boolean).join("/");
-		this.prefix = this.normalizePath(fullPrefix);
-		this.groupMiddlewares = [...previousMiddlewares, ...middlewares || []];
-		try {
+		const nextContext = {
+			prefix: this.normalizePath(fullPrefix),
+			groupMiddlewares: [...previousMiddlewares, ...middlewares || []]
+		};
+		await this.groupContext.run(nextContext, async () => {
 			await Promise.resolve(callback());
-		} finally {
-			this.prefix = previousPrefix;
-			this.groupMiddlewares = previousMiddlewares;
-		}
+		});
 	}
 	/**
 	* Apply global middlewares for the duration of the callback

package/dist/h3/index.d.cts

@@ -1,4 +1,4 @@
-import { a as H3App, c as Middleware, i as Route, l as ControllerAction, o as Handler, s as HttpContext, u as HttpMethod } from "../express-JHxK-EqQ.cjs";
+import { c as H3App, d as Middleware, l as Handler, n as ControllerAction, r as HttpMethod, s as Route, t as ApiResourceMiddleware, u as HttpContext } from "../basic-Chn8OGPD.cjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts
@@ -9,6 +9,7 @@ import { H3 } from "h3";
  * @repository https://github.com/toneflix/clear-router
  */
 declare class Router {
+  private static readonly groupContext;
   /**
    * All registered routes
    */
@@ -46,7 +47,7 @@ declare class Router {
     * @param handler - Route handler function or controller reference
     * @param middlewares - Array of middleware functions
     */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register RESTful API resource routes for a controller with optional action filtering
    *
@@ -57,6 +58,7 @@ declare class Router {
   static apiResource(basePath: string, controller: any, options?: {
     only?: ControllerAction[];
     except?: ControllerAction[];
+    middlewares?: ApiResourceMiddleware<Middleware>;
   }): void;
   /**
    * Register a GET route
@@ -64,49 +66,49 @@ declare class Router {
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a POST route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a PUT route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a DELETE route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a PATCH route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register an OPTIONS route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a HEAD route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Group routes with a common prefix and middlewares
    * @param prefix - URL prefix for grouped routes

package/dist/h3/index.d.mts

@@ -1,4 +1,4 @@
-import { a as H3App, c as Middleware, i as Route, l as ControllerAction, o as Handler, s as HttpContext, u as HttpMethod } from "../express-D9GR9yTH.mjs";
+import { c as H3App, d as Middleware, l as Handler, n as ControllerAction, r as HttpMethod, s as Route, t as ApiResourceMiddleware, u as HttpContext } from "../basic-DJmmZq1h.mjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts
@@ -9,6 +9,7 @@ import { H3 } from "h3";
  * @repository https://github.com/toneflix/clear-router
  */
 declare class Router {
+  private static readonly groupContext;
   /**
    * All registered routes
    */
@@ -46,7 +47,7 @@ declare class Router {
     * @param handler - Route handler function or controller reference
     * @param middlewares - Array of middleware functions
     */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register RESTful API resource routes for a controller with optional action filtering
    *
@@ -57,6 +58,7 @@ declare class Router {
   static apiResource(basePath: string, controller: any, options?: {
     only?: ControllerAction[];
     except?: ControllerAction[];
+    middlewares?: ApiResourceMiddleware<Middleware>;
   }): void;
   /**
    * Register a GET route
@@ -64,49 +66,49 @@ declare class Router {
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a POST route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a PUT route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a DELETE route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a PATCH route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register an OPTIONS route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Register a HEAD route
    * @param path - Route path
    * @param handler - Route handler
    * @param middlewares - Middleware functions
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[]): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
   /**
    * Group routes with a common prefix and middlewares
    * @param prefix - URL prefix for grouped routes

package/dist/h3/index.mjs

@@ -1,4 +1,5 @@
 import { n as ClearRequest, t as Route } from "../Route-BbPXcDGX.mjs";
+import { AsyncLocalStorage } from "node:async_hooks";
 import { getQuery, getRouterParams, readBody } from "h3";
 
 //#region src/h3/router.ts
@@ -9,6 +10,7 @@ import { getQuery, getRouterParams, readBody } from "h3";
 * @repository https://github.com/toneflix/clear-router
 */
 var Router = class Router {
+	static groupContext = new AsyncLocalStorage();
 	/**
 	* All registered routes
 	*/
@@ -49,11 +51,15 @@ var Router = class Router {
 	* @param middlewares - Array of middleware functions
 	*/
 	static add(methods, path, handler, middlewares) {
+		const context = this.groupContext.getStore();
+		const activePrefix = context?.prefix ?? this.prefix;
+		const activeGroupMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
 		methods = Array.isArray(methods) ? methods : [methods];
-		const fullPath = this.normalizePath(`${this.prefix}/${path}`);
+		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
+		const fullPath = this.normalizePath(`${activePrefix}/${path}`);
 		const route = new Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
 			...this.globalMiddlewares,
-			...this.groupMiddlewares,
+			...activeGroupMiddlewares,
 			...middlewares || []
 		]);
 		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, ({ res }) => {
@@ -104,7 +110,8 @@ var Router = class Router {
 			if (except.includes(action)) continue;
 			if (typeof preController[action] === "function") {
 				const { method, path } = actions[action];
-				this.add(method, `${basePath}${path}`, [controller, action]);
+				const actionMiddlewares = typeof options?.middlewares === "object" && !Array.isArray(options.middlewares) ? options.middlewares[action] : options?.middlewares;
+				this.add(method, `${basePath}${path}`, [controller, action], Array.isArray(actionMiddlewares) ? actionMiddlewares : actionMiddlewares ? [actionMiddlewares] : void 0);
 			}
 		}
 	}
@@ -178,17 +185,17 @@ var Router = class Router {
 	* @param middlewares - Middleware functions applied to all routes in group
 	*/
 	static async group(prefix, callback, middlewares) {
-		const previousPrefix = this.prefix;
-		const previousMiddlewares = this.groupMiddlewares;
+		const context = this.groupContext.getStore();
+		const previousPrefix = context?.prefix ?? this.prefix;
+		const previousMiddlewares = context?.groupMiddlewares ?? this.groupMiddlewares;
 		const fullPrefix = [previousPrefix, prefix].filter(Boolean).join("/");
-		this.prefix = this.normalizePath(fullPrefix);
-		this.groupMiddlewares = [...previousMiddlewares, ...middlewares || []];
-		try {
+		const nextContext = {
+			prefix: this.normalizePath(fullPrefix),
+			groupMiddlewares: [...previousMiddlewares, ...middlewares || []]
+		};
+		await this.groupContext.run(nextContext, async () => {
 			await Promise.resolve(callback());
-		} finally {
-			this.prefix = previousPrefix;
-			this.groupMiddlewares = previousMiddlewares;
-		}
+		});
 	}
 	/**
 	* Apply global middlewares for the duration of the callback

package/dist/index.d.cts

@@ -1,26 +1,6 @@
 import { NextFunction, Request, Response as Response$1 } from "express";
-import { H3Event, Middleware } from "h3";
+import { H3Event, Middleware as Middleware$1 } from "h3";
 
-//#region types/basic.d.ts
-/**
- * Controller method reference
- */
-type ControllerHandler = [any, string];
-/**
- * HTTP methods supported by the router
- */
-type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
-/**
- * Generic Object type for request data
- */
-type RequestData = Record<string, any>;
-//#endregion
-//#region types/express.d.ts
-/**
- * Middleware function type
- */
-type Middleware$1 = (req: Request, res: Response$1, next: NextFunction) => any | Promise<any>;
-//#endregion
 //#region types/h3.d.ts
 /**
  * HTTP context passed to route handlers
@@ -33,20 +13,38 @@ type RouteHandler = (
 /**
  * H3 event context
  */
-
 ctx: HttpContext,
 /**
  * ClearRequest instance
  */
-
 req: ClearRequest) => any | Promise<any>;
 /**
  * Handler can be either a function or controller reference
  */
 type Handler = RouteHandler | ControllerHandler;
 //#endregion
+//#region types/basic.d.ts
+/**
+ * Controller method reference
+ */
+type ControllerHandler = [any, string];
+/**
+ * HTTP methods supported by the router
+ */
+type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
+/**
+ * Generic Object type for request data
+ */
+type RequestData = Record<string, any>;
+//#endregion
+//#region types/express.d.ts
+/**
+ * Middleware function type
+ */
+type Middleware = (req: Request, res: Response$1, next: NextFunction) => any | Promise<any>;
+//#endregion
 //#region src/Route.d.ts
-declare class Route<X = any, M = Middleware | Middleware$1> {
+declare class Route<X = any, M = Middleware$1 | Middleware> {
   ctx: X;
   body: RequestData;
   query: RequestData;
@@ -64,7 +62,7 @@ declare class Route<X = any, M = Middleware | Middleware$1> {
 }
 //#endregion
 //#region src/ClearRequest.d.ts
-declare class ClearRequest<X = any, M = Middleware | Middleware$1> {
+declare class ClearRequest<X = any, M = Middleware$1 | Middleware> {
   [key: string]: any;
   /**
    * @param body - Parsed request body

package/dist/index.d.mts

@@ -1,26 +1,6 @@
 import { NextFunction, Request, Response as Response$1 } from "express";
-import { H3Event, Middleware } from "h3";
+import { H3Event, Middleware as Middleware$1 } from "h3";
 
-//#region types/basic.d.ts
-/**
- * Controller method reference
- */
-type ControllerHandler = [any, string];
-/**
- * HTTP methods supported by the router
- */
-type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
-/**
- * Generic Object type for request data
- */
-type RequestData = Record<string, any>;
-//#endregion
-//#region types/express.d.ts
-/**
- * Middleware function type
- */
-type Middleware$1 = (req: Request, res: Response$1, next: NextFunction) => any | Promise<any>;
-//#endregion
 //#region types/h3.d.ts
 /**
  * HTTP context passed to route handlers
@@ -33,20 +13,38 @@ type RouteHandler = (
 /**
  * H3 event context
  */
-
 ctx: HttpContext,
 /**
  * ClearRequest instance
  */
-
 req: ClearRequest) => any | Promise<any>;
 /**
  * Handler can be either a function or controller reference
  */
 type Handler = RouteHandler | ControllerHandler;
 //#endregion
+//#region types/basic.d.ts
+/**
+ * Controller method reference
+ */
+type ControllerHandler = [any, string];
+/**
+ * HTTP methods supported by the router
+ */
+type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
+/**
+ * Generic Object type for request data
+ */
+type RequestData = Record<string, any>;
+//#endregion
+//#region types/express.d.ts
+/**
+ * Middleware function type
+ */
+type Middleware = (req: Request, res: Response$1, next: NextFunction) => any | Promise<any>;
+//#endregion
 //#region src/Route.d.ts
-declare class Route<X = any, M = Middleware | Middleware$1> {
+declare class Route<X = any, M = Middleware$1 | Middleware> {
   ctx: X;
   body: RequestData;
   query: RequestData;
@@ -64,7 +62,7 @@ declare class Route<X = any, M = Middleware | Middleware$1> {
 }
 //#endregion
 //#region src/ClearRequest.d.ts
-declare class ClearRequest<X = any, M = Middleware | Middleware$1> {
+declare class ClearRequest<X = any, M = Middleware$1 | Middleware> {
   [key: string]: any;
   /**
    * @param body - Parsed request body

package/dist/types/ClearRequest.d.mts

@@ -1,7 +1,7 @@
-import { RequestData } from "../types/basic.mjs";
 import { Middleware } from "../types/h3.mjs";
 import { Route } from "./Route.mjs";
 import { Middleware as Middleware$1 } from "../types/express.mjs";
+import { RequestData } from "../types/basic.mjs";
 
 //#region src/ClearRequest.d.ts
 declare class ClearRequest<X = any, M = Middleware | Middleware$1> {

package/dist/types/Route.d.mts

@@ -1,7 +1,7 @@
-import { HttpMethod, RequestData } from "../types/basic.mjs";
 import { Handler, Middleware } from "../types/h3.mjs";
 import { ClearRequest } from "./ClearRequest.mjs";
 import { Middleware as Middleware$1 } from "../types/express.mjs";
+import { HttpMethod, RequestData } from "../types/basic.mjs";
 
 //#region src/Route.d.ts
 declare class Route<X = any, M = Middleware | Middleware$1> {

package/dist/types/basic.d.mts

@@ -1,3 +1,6 @@
+import { Middleware } from "./h3.mjs";
+import { Middleware as Middleware$1 } from "./express.mjs";
+
 //#region types/basic.d.ts
 /**
  * Controller method reference
@@ -15,5 +18,6 @@ type ControllerAction = 'index' | 'show' | 'create' | 'update' | 'destroy';
  * Generic Object type for request data
  */
 type RequestData = Record<string, any>;
+type ApiResourceMiddleware<M extends Middleware$1 | Middleware> = M | M[] | { [K in ControllerAction]?: M | M[] };
 //#endregion
-export { ControllerAction, ControllerHandler, HttpMethod, RequestData };
+export { ApiResourceMiddleware, ControllerAction, ControllerHandler, HttpMethod, RequestData };

package/dist/types/express.d.mts

@@ -1,5 +1,5 @@
-import { ControllerHandler } from "./basic.mjs";
 import { ClearRequest } from "./ClearRequest.mjs";
+import { ControllerHandler } from "./basic.mjs";
 import { NextFunction, Request, Response } from "express";
 
 //#region types/express.d.ts

package/dist/types/h3.d.mts

@@ -1,5 +1,5 @@
-import { ControllerHandler } from "./basic.mjs";
 import { ClearRequest } from "./ClearRequest.mjs";
+import { ControllerHandler } from "./basic.mjs";
 import { H3, H3Event, Middleware, TypedServerRequest } from "h3";
 
 //#region types/h3.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-router",
-  "version": "2.1.7",
+  "version": "2.1.9",
   "description": "Laravel-style routing system for Express.js and H3, with CommonJS, ESM, and TypeScript support",
   "keywords": [
     "h3",
@@ -90,6 +90,7 @@
     "lint": "eslint",
     "test:esm": "vitest tests/esm.test.ts",
     "test:ts": "vitest tests/typescript.test.ts",
+    "test:coverage": "vitest run --coverage",
     "example": "tsx example/express/index.ts",
     "example:esm": "tsx example/express/esm.ts",
     "example:ts": "tsx example/express/typescript.ts",