clear-router 2.1.6 → 2.1.8

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

@@ -15,6 +15,14 @@ var Router = class Router {
 	*/
 	static routes = [];
 	/**
+	* Mapping of routes by path and method for quick lookup.
+	*/
+	static routesByPathMethod = {};
+	/**
+	* Mapping of routes by method for quick lookup.
+	*/
+	static routesByMethod = {};
+	/**
 	* Current route prefix
 	*/
 	static prefix = "";
@@ -42,13 +50,24 @@ var Router = class Router {
 	* @param middlewares - Array of middleware functions
 	*/
 	static add(methods, path, handler, middlewares) {
-		const methodArray = Array.isArray(methods) ? methods : [methods];
+		methods = Array.isArray(methods) ? methods : [methods];
+		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
 		const fullPath = this.normalizePath(`${this.prefix}/${path}`);
-		this.routes.push(new require_Route.Route(methodArray, fullPath, handler, [
+		const route = new require_Route.Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
 			...this.globalMiddlewares,
 			...this.groupMiddlewares,
 			...middlewares || []
-		]));
+		]);
+		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, ({ res }) => {
+			res.set("Allow", "GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD");
+			res.sendStatus(204);
+		});
+		this.routes.push(route);
+		for (const method of methods.map((m) => m.toUpperCase())) {
+			this.routesByPathMethod[`${method.toUpperCase()} ${fullPath}`] = route;
+			if (!this.routesByMethod[method]) this.routesByMethod[method] = [];
+			this.routesByMethod[method].push(route);
+		}
 	}
 	/**
 	* Register RESTful API resource routes for a controller with optional action filtering
@@ -87,7 +106,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);
 			}
 		}
 	}
@@ -184,12 +204,10 @@ var Router = class Router {
 		callback();
 		this.globalMiddlewares = prevMiddlewares;
 	}
-	/**
-	* Get all registered routes with their information
-	* @returns Array of route information objects
-	*/
-	static allRoutes() {
-		return this.routes;
+	static allRoutes(type) {
+		if (type === "method") return this.routesByMethod;
+		if (type === "path") return this.routesByPathMethod;
+		return this.routes.filter((e) => e.methods.length > 1 || e.methods[0] !== "options");
 	}
 	static async apply(router) {
 		for (const route of this.routes) {
@@ -218,7 +236,7 @@ var Router = class Router {
 			}
 			if (!handlerFunction) continue;
 			for (const method of route.methods) {
-				if (![
+				const allowedMethods = [
 					"get",
 					"post",
 					"put",
@@ -226,7 +244,9 @@ var Router = class Router {
 					"patch",
 					"options",
 					"head"
-				].includes(method)) {
+				];
+				if (method === "options" && route.methods.length > 1) continue;
+				if (!allowedMethods.includes(method)) {
 					const error = /* @__PURE__ */ new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
 					console.error("[ROUTES]", error.message);
 					throw error;

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
@@ -14,6 +14,14 @@ declare class Router {
    * All registered routes
    */
   static routes: Array<Route<HttpContext, Middleware>>;
+  /**
+   * Mapping of routes by path and method for quick lookup.
+   */
+  static routesByPathMethod: Record<string, Route<HttpContext, Middleware>>;
+  /**
+   * Mapping of routes by method for quick lookup.
+   */
+  static routesByMethod: { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware>> };
   /**
    * Current route prefix
    */
@@ -39,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
    *
@@ -50,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
@@ -57,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
@@ -117,7 +126,9 @@ declare class Router {
    * Get all registered routes with their information
    * @returns Array of route information objects
    */
-  static allRoutes(): Route<HttpContext, Middleware>[];
+  static allRoutes(type?: 'path'): Record<string, Route<HttpContext, Middleware>>;
+  static allRoutes(type?: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware>> };
+  static allRoutes(type?: 'method'): Array<Route<HttpContext, Middleware>>;
   /**
    * Apply all registered routes to the provided Express Router instance
    * Handles controller-method binding and middleware application

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
@@ -14,6 +14,14 @@ declare class Router {
    * All registered routes
    */
   static routes: Array<Route<HttpContext, Middleware>>;
+  /**
+   * Mapping of routes by path and method for quick lookup.
+   */
+  static routesByPathMethod: Record<string, Route<HttpContext, Middleware>>;
+  /**
+   * Mapping of routes by method for quick lookup.
+   */
+  static routesByMethod: { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware>> };
   /**
    * Current route prefix
    */
@@ -39,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
    *
@@ -50,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
@@ -57,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
@@ -117,7 +126,9 @@ declare class Router {
    * Get all registered routes with their information
    * @returns Array of route information objects
    */
-  static allRoutes(): Route<HttpContext, Middleware>[];
+  static allRoutes(type?: 'path'): Record<string, Route<HttpContext, Middleware>>;
+  static allRoutes(type?: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware>> };
+  static allRoutes(type?: 'method'): Array<Route<HttpContext, Middleware>>;
   /**
    * Apply all registered routes to the provided Express Router instance
    * Handles controller-method binding and middleware application

package/dist/express/index.mjs

@@ -14,6 +14,14 @@ var Router = class Router {
 	*/
 	static routes = [];
 	/**
+	* Mapping of routes by path and method for quick lookup.
+	*/
+	static routesByPathMethod = {};
+	/**
+	* Mapping of routes by method for quick lookup.
+	*/
+	static routesByMethod = {};
+	/**
 	* Current route prefix
 	*/
 	static prefix = "";
@@ -41,13 +49,24 @@ var Router = class Router {
 	* @param middlewares - Array of middleware functions
 	*/
 	static add(methods, path, handler, middlewares) {
-		const methodArray = Array.isArray(methods) ? methods : [methods];
+		methods = Array.isArray(methods) ? methods : [methods];
+		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
 		const fullPath = this.normalizePath(`${this.prefix}/${path}`);
-		this.routes.push(new Route(methodArray, fullPath, handler, [
+		const route = new Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
 			...this.globalMiddlewares,
 			...this.groupMiddlewares,
 			...middlewares || []
-		]));
+		]);
+		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, ({ res }) => {
+			res.set("Allow", "GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD");
+			res.sendStatus(204);
+		});
+		this.routes.push(route);
+		for (const method of methods.map((m) => m.toUpperCase())) {
+			this.routesByPathMethod[`${method.toUpperCase()} ${fullPath}`] = route;
+			if (!this.routesByMethod[method]) this.routesByMethod[method] = [];
+			this.routesByMethod[method].push(route);
+		}
 	}
 	/**
 	* Register RESTful API resource routes for a controller with optional action filtering
@@ -86,7 +105,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);
 			}
 		}
 	}
@@ -183,12 +203,10 @@ var Router = class Router {
 		callback();
 		this.globalMiddlewares = prevMiddlewares;
 	}
-	/**
-	* Get all registered routes with their information
-	* @returns Array of route information objects
-	*/
-	static allRoutes() {
-		return this.routes;
+	static allRoutes(type) {
+		if (type === "method") return this.routesByMethod;
+		if (type === "path") return this.routesByPathMethod;
+		return this.routes.filter((e) => e.methods.length > 1 || e.methods[0] !== "options");
 	}
 	static async apply(router) {
 		for (const route of this.routes) {
@@ -217,7 +235,7 @@ var Router = class Router {
 			}
 			if (!handlerFunction) continue;
 			for (const method of route.methods) {
-				if (![
+				const allowedMethods = [
 					"get",
 					"post",
 					"put",
@@ -225,7 +243,9 @@ var Router = class Router {
 					"patch",
 					"options",
 					"head"
-				].includes(method)) {
+				];
+				if (method === "options" && route.methods.length > 1) continue;
+				if (!allowedMethods.includes(method)) {
 					const error = /* @__PURE__ */ new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
 					console.error("[ROUTES]", error.message);
 					throw error;

package/dist/h3/index.cjs

@@ -15,6 +15,14 @@ var Router = class Router {
 	*/
 	static routes = [];
 	/**
+	* Mapping of routes by path and method for quick lookup.
+	*/
+	static routesByPathMethod = {};
+	/**
+	* Mapping of routes by method for quick lookup.
+	*/
+	static routesByMethod = {};
+	/**
 	* Current route prefix
 	*/
 	static prefix = "";
@@ -42,13 +50,24 @@ var Router = class Router {
 	* @param middlewares - Array of middleware functions
 	*/
 	static add(methods, path, handler, middlewares) {
-		const methodArray = Array.isArray(methods) ? methods : [methods];
+		methods = Array.isArray(methods) ? methods : [methods];
+		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
 		const fullPath = this.normalizePath(`${this.prefix}/${path}`);
-		this.routes.push(new require_Route.Route(methodArray, fullPath, handler, [
+		const route = new require_Route.Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
 			...this.globalMiddlewares,
 			...this.groupMiddlewares,
 			...middlewares || []
-		]));
+		]);
+		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, ({ res }) => {
+			res.headers.set("Allow", "GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD");
+			res.status = 204;
+		});
+		this.routes.push(route);
+		for (const method of methods.map((m) => m.toUpperCase())) {
+			this.routesByPathMethod[`${method} ${fullPath}`] = route;
+			if (!this.routesByMethod[method]) this.routesByMethod[method] = [];
+			this.routesByMethod[method].push(route);
+		}
 	}
 	/**
 	* Register RESTful API resource routes for a controller with optional action filtering
@@ -87,7 +106,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);
 			}
 		}
 	}
@@ -184,12 +204,10 @@ var Router = class Router {
 		callback();
 		this.globalMiddlewares = prevMiddlewares;
 	}
-	/**
-	* Get all registered routes with their information
-	* @returns Array of route information objects
-	*/
-	static allRoutes() {
-		return this.routes;
+	static allRoutes(type) {
+		if (type === "method") return this.routesByMethod;
+		if (type === "path") return this.routesByPathMethod;
+		return this.routes.filter((e) => e.methods.length > 1 || e.methods[0] !== "options");
 	}
 	/**
 	* Apply all registered routes to the provided H3 Router instance
@@ -225,7 +243,7 @@ var Router = class Router {
 			}
 			if (!handlerFunction) continue;
 			for (const method of route.methods) {
-				if (![
+				const allowedMethods = [
 					"get",
 					"post",
 					"put",
@@ -233,7 +251,9 @@ var Router = class Router {
 					"patch",
 					"options",
 					"head"
-				].includes(method)) {
+				];
+				if (method === "options" && route.methods.length > 1) continue;
+				if (!allowedMethods.includes(method)) {
 					const error = /* @__PURE__ */ new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
 					console.error("[ROUTES]", error.message);
 					throw error;

package/dist/h3/index.d.cts

@@ -1,5 +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 * as h3 from "h3";
+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
@@ -14,6 +13,14 @@ declare class Router {
    * All registered routes
    */
   static routes: Array<Route<HttpContext, Middleware>>;
+  /**
+   * Mapping of routes by path and method for quick lookup.
+   */
+  static routesByPathMethod: Record<string, Route<HttpContext, Middleware>>;
+  /**
+   * Mapping of routes by method for quick lookup.
+   */
+  static routesByMethod: { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware>> };
   /**
    * Current route prefix
    */
@@ -39,7 +46,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
    *
@@ -50,6 +57,7 @@ declare class Router {
   static apiResource(basePath: string, controller: any, options?: {
     only?: ControllerAction[];
     except?: ControllerAction[];
+    middlewares?: ApiResourceMiddleware<Middleware>;
   }): void;
   /**
    * Register a GET route
@@ -57,49 +65,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
@@ -117,7 +125,9 @@ declare class Router {
    * Get all registered routes with their information
    * @returns Array of route information objects
    */
-  static allRoutes(): Route<h3.H3Event<h3.EventHandlerRequest>, Middleware>[];
+  static allRoutes(type?: 'path'): Record<string, Route<HttpContext, Middleware>>;
+  static allRoutes(type?: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware>> };
+  static allRoutes(type?: 'method'): Array<Route<HttpContext, Middleware>>;
   /**
    * Apply all registered routes to the provided H3 Router instance
    * Handles controller-method binding and middleware application

package/dist/h3/index.d.mts

@@ -1,5 +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 * as h3 from "h3";
+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
@@ -14,6 +13,14 @@ declare class Router {
    * All registered routes
    */
   static routes: Array<Route<HttpContext, Middleware>>;
+  /**
+   * Mapping of routes by path and method for quick lookup.
+   */
+  static routesByPathMethod: Record<string, Route<HttpContext, Middleware>>;
+  /**
+   * Mapping of routes by method for quick lookup.
+   */
+  static routesByMethod: { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware>> };
   /**
    * Current route prefix
    */
@@ -39,7 +46,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
    *
@@ -50,6 +57,7 @@ declare class Router {
   static apiResource(basePath: string, controller: any, options?: {
     only?: ControllerAction[];
     except?: ControllerAction[];
+    middlewares?: ApiResourceMiddleware<Middleware>;
   }): void;
   /**
    * Register a GET route
@@ -57,49 +65,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
@@ -117,7 +125,9 @@ declare class Router {
    * Get all registered routes with their information
    * @returns Array of route information objects
    */
-  static allRoutes(): Route<h3.H3Event<h3.EventHandlerRequest>, Middleware>[];
+  static allRoutes(type?: 'path'): Record<string, Route<HttpContext, Middleware>>;
+  static allRoutes(type?: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware>> };
+  static allRoutes(type?: 'method'): Array<Route<HttpContext, Middleware>>;
   /**
    * Apply all registered routes to the provided H3 Router instance
    * Handles controller-method binding and middleware application

package/dist/h3/index.mjs

@@ -14,6 +14,14 @@ var Router = class Router {
 	*/
 	static routes = [];
 	/**
+	* Mapping of routes by path and method for quick lookup.
+	*/
+	static routesByPathMethod = {};
+	/**
+	* Mapping of routes by method for quick lookup.
+	*/
+	static routesByMethod = {};
+	/**
 	* Current route prefix
 	*/
 	static prefix = "";
@@ -41,13 +49,24 @@ var Router = class Router {
 	* @param middlewares - Array of middleware functions
 	*/
 	static add(methods, path, handler, middlewares) {
-		const methodArray = Array.isArray(methods) ? methods : [methods];
+		methods = Array.isArray(methods) ? methods : [methods];
+		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
 		const fullPath = this.normalizePath(`${this.prefix}/${path}`);
-		this.routes.push(new Route(methodArray, fullPath, handler, [
+		const route = new Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
 			...this.globalMiddlewares,
 			...this.groupMiddlewares,
 			...middlewares || []
-		]));
+		]);
+		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, ({ res }) => {
+			res.headers.set("Allow", "GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD");
+			res.status = 204;
+		});
+		this.routes.push(route);
+		for (const method of methods.map((m) => m.toUpperCase())) {
+			this.routesByPathMethod[`${method} ${fullPath}`] = route;
+			if (!this.routesByMethod[method]) this.routesByMethod[method] = [];
+			this.routesByMethod[method].push(route);
+		}
 	}
 	/**
 	* Register RESTful API resource routes for a controller with optional action filtering
@@ -86,7 +105,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);
 			}
 		}
 	}
@@ -183,12 +203,10 @@ var Router = class Router {
 		callback();
 		this.globalMiddlewares = prevMiddlewares;
 	}
-	/**
-	* Get all registered routes with their information
-	* @returns Array of route information objects
-	*/
-	static allRoutes() {
-		return this.routes;
+	static allRoutes(type) {
+		if (type === "method") return this.routesByMethod;
+		if (type === "path") return this.routesByPathMethod;
+		return this.routes.filter((e) => e.methods.length > 1 || e.methods[0] !== "options");
 	}
 	/**
 	* Apply all registered routes to the provided H3 Router instance
@@ -224,7 +242,7 @@ var Router = class Router {
 			}
 			if (!handlerFunction) continue;
 			for (const method of route.methods) {
-				if (![
+				const allowedMethods = [
 					"get",
 					"post",
 					"put",
@@ -232,7 +250,9 @@ var Router = class Router {
 					"patch",
 					"options",
 					"head"
-				].includes(method)) {
+				];
+				if (method === "options" && route.methods.length > 1) continue;
+				if (!allowedMethods.includes(method)) {
 					const error = /* @__PURE__ */ new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
 					console.error("[ROUTES]", error.message);
 					throw error;

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.6",
+  "version": "2.1.8",
   "description": "Laravel-style routing system for Express.js and H3, with CommonJS, ESM, and TypeScript support",
   "keywords": [
     "h3",
@@ -72,6 +72,7 @@
     "@types/express": "^4.17.21",
     "@types/node": "^20.10.6",
     "@types/supertest": "^6.0.3",
+    "@vitest/coverage-v8": "4.0.18",
     "eslint": "^10.0.2",
     "supertest": "^7.1.1",
     "tsdown": "^0.20.3",