clear-router 2.1.9 → 2.1.11

package/README.md

@@ -42,6 +42,7 @@ yarn add clear-router express
 
 - Simple and clean route declarations (get, post, put, delete, patch, options, head)
 - Grouped routes with prefix
+- Method override support via body or header keys (configurable)
 - Middleware stack: per-route and group-level
 - Controller-method pair as route handler
 - Supports HttpContext style handlers: { req, res, next }

package/dist/{basic-Chn8OGPD.d.cts → basic-DXbqD6cP.d.cts}

@@ -115,5 +115,16 @@ type ControllerAction = 'index' | 'show' | 'create' | 'update' | 'destroy';
  */
 type RequestData = Record<string, any>;
 type ApiResourceMiddleware<M extends Middleware | Middleware$1> = M | M[] | { [K in ControllerAction]?: M | M[] };
+interface RouterConfig {
+  /**
+   * Configuration for method override functionality, allowing clients to use a
+   * specific header or body parameter to override the HTTP method.
+   */
+  methodOverride?: {
+    /** Whether method override is enabled */enabled?: boolean; /** Keys in the request body to check for method override */
+    bodyKeys?: string[] | string; /** Keys in the request headers to check for method override */
+    headerKeys?: string[] | string;
+  };
+}
 //#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 };
+export { Handler as a, Route as c, HttpContext$1 as d, Middleware$1 as f, RouterConfig as i, H3App as l, ControllerAction as n, HttpContext as o, HttpMethod as r, Middleware as s, ApiResourceMiddleware as t, Handler$1 as u };

package/dist/{basic-DJmmZq1h.d.mts → basic-vvrFwa_Y.d.mts}

@@ -115,5 +115,16 @@ type ControllerAction = 'index' | 'show' | 'create' | 'update' | 'destroy';
  */
 type RequestData = Record<string, any>;
 type ApiResourceMiddleware<M extends Middleware | Middleware$1> = M | M[] | { [K in ControllerAction]?: M | M[] };
+interface RouterConfig {
+  /**
+   * Configuration for method override functionality, allowing clients to use a
+   * specific header or body parameter to override the HTTP method.
+   */
+  methodOverride?: {
+    /** Whether method override is enabled */enabled?: boolean; /** Keys in the request body to check for method override */
+    bodyKeys?: string[] | string; /** Keys in the request headers to check for method override */
+    headerKeys?: string[] | string;
+  };
+}
 //#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 };
+export { Handler as a, Route as c, HttpContext$1 as d, Middleware$1 as f, RouterConfig as i, H3App as l, ControllerAction as n, HttpContext as o, HttpMethod as r, Middleware as s, ApiResourceMiddleware as t, Handler$1 as u };

package/dist/express/index.cjs

@@ -11,6 +11,11 @@ let node_async_hooks = require("node:async_hooks");
 * @repository https://github.com/toneflix/clear-router
 */
 var Router = class Router {
+	static config = { methodOverride: {
+		enabled: true,
+		bodyKeys: ["_method"],
+		headerKeys: ["x-http-method"]
+	} };
 	static groupContext = new node_async_hooks.AsyncLocalStorage();
 	/**
 	* All registered routes
@@ -45,6 +50,53 @@ var Router = class Router {
 		return "/" + path.split("/").filter(Boolean).join("/");
 	}
 	/**
+	* Configure router settings to modify behavior.
+	* 
+	* @param options - Configuration options for the router
+	* @returns 
+	*/
+	static configure(options) {
+		if (!this.config.methodOverride) this.config.methodOverride = {
+			enabled: true,
+			bodyKeys: ["_method"],
+			headerKeys: ["x-http-method"]
+		};
+		const override = options?.methodOverride;
+		if (!override) return;
+		if (typeof override.enabled === "boolean") this.config.methodOverride.enabled = override.enabled;
+		const bodyKeys = override.bodyKeys;
+		if (typeof bodyKeys !== "undefined") this.config.methodOverride.bodyKeys = (Array.isArray(bodyKeys) ? bodyKeys : [bodyKeys]).map((e) => String(e).trim()).filter(Boolean);
+		const headerKeys = override.headerKeys;
+		if (typeof headerKeys !== "undefined") this.config.methodOverride.headerKeys = (Array.isArray(headerKeys) ? headerKeys : [headerKeys]).map((e) => String(e).trim().toLowerCase()).filter(Boolean);
+	}
+	static resolveMethodOverride(method, headers, body) {
+		if (!this.config.methodOverride?.enabled || method.toLowerCase() !== "post") return null;
+		let override;
+		for (const key of this.config.methodOverride?.headerKeys || []) {
+			const value = headers?.[key];
+			if (Array.isArray(value) ? value[0] : value) {
+				override = Array.isArray(value) ? value[0] : value;
+				break;
+			}
+		}
+		if (!override && body && typeof body === "object") for (const key of this.config.methodOverride?.bodyKeys || []) {
+			const value = body[key];
+			if (typeof value !== "undefined" && value !== null && value !== "") {
+				override = value;
+				break;
+			}
+		}
+		const normalized = String(override || "").trim().toLowerCase();
+		if (!normalized) return null;
+		if ([
+			"put",
+			"patch",
+			"delete",
+			"post"
+		].includes(normalized)) return normalized;
+		return null;
+	}
+	/**
 	* Add a route with specified HTTP methods, path, handler, and middlewares
 	* @param methods - HTTP method(s) for the route
 	* @param path - Route path
@@ -256,7 +308,34 @@ var Router = class Router {
 					console.error("[ROUTES]", error.message);
 					throw error;
 				}
-				router[method](route.path, ...route.middlewares || [], async (req, res, next) => {
+				router[method](route.path, (req, res, next) => {
+					const override = Router.resolveMethodOverride(req.method, req.headers, req.body);
+					if (method === "post" && override && override !== "post") return next("route");
+					return next();
+				}, ...route.middlewares || [], async (req, res, next) => {
+					try {
+						const ctx = {
+							req,
+							res,
+							next
+						};
+						const inst = instance ?? route;
+						await Router.bindRequestToInstance(ctx, inst, route);
+						const result = handlerFunction(ctx, inst.clearRequest);
+						await Promise.resolve(result);
+					} catch (error) {
+						next(error);
+					}
+				});
+				if ([
+					"put",
+					"patch",
+					"delete"
+				].includes(method)) router.post(route.path, (req, res, next) => {
+					if (Router.resolveMethodOverride(req.method, req.headers, req.body) !== method) return next("route");
+					req.method = method.toUpperCase();
+					return next();
+				}, ...route.middlewares || [], async (req, res, next) => {
 					try {
 						const ctx = {
 							req,

package/dist/express/index.d.cts

@@ -1,4 +1,4 @@
-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 { a as Handler, c as Route, i as RouterConfig, n as ControllerAction, o as HttpContext, r as HttpMethod, s as Middleware, t as ApiResourceMiddleware } from "../basic-DXbqD6cP.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 {
+  static config: RouterConfig;
   private static readonly groupContext;
   /**
    * All registered routes
@@ -41,6 +42,14 @@ declare class Router {
    * @returns Normalized path
    */
   static normalizePath(path: string): string;
+  /**
+   * Configure router settings to modify behavior.
+   *
+   * @param options - Configuration options for the router
+   * @returns
+   */
+  static configure(options?: RouterConfig): void;
+  private static resolveMethodOverride;
   /**
     * Add a route with specified HTTP methods, path, handler, and middlewares
     * @param methods - HTTP method(s) for the route
@@ -127,9 +136,9 @@ declare class Router {
    * Get all registered routes with their information
    * @returns Array of route information objects
    */
-  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>>;
+  static allRoutes(): Array<Route<HttpContext, Middleware>>;
+  static allRoutes(type: 'path'): Record<string, Route<HttpContext, Middleware>>;
+  static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: 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 { 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 { a as Handler, c as Route, i as RouterConfig, n as ControllerAction, o as HttpContext, r as HttpMethod, s as Middleware, t as ApiResourceMiddleware } from "../basic-vvrFwa_Y.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 {
+  static config: RouterConfig;
   private static readonly groupContext;
   /**
    * All registered routes
@@ -41,6 +42,14 @@ declare class Router {
    * @returns Normalized path
    */
   static normalizePath(path: string): string;
+  /**
+   * Configure router settings to modify behavior.
+   *
+   * @param options - Configuration options for the router
+   * @returns
+   */
+  static configure(options?: RouterConfig): void;
+  private static resolveMethodOverride;
   /**
     * Add a route with specified HTTP methods, path, handler, and middlewares
     * @param methods - HTTP method(s) for the route
@@ -127,9 +136,9 @@ declare class Router {
    * Get all registered routes with their information
    * @returns Array of route information objects
    */
-  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>>;
+  static allRoutes(): Array<Route<HttpContext, Middleware>>;
+  static allRoutes(type: 'path'): Record<string, Route<HttpContext, Middleware>>;
+  static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: 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

@@ -10,6 +10,11 @@ import { AsyncLocalStorage } from "node:async_hooks";
 * @repository https://github.com/toneflix/clear-router
 */
 var Router = class Router {
+	static config = { methodOverride: {
+		enabled: true,
+		bodyKeys: ["_method"],
+		headerKeys: ["x-http-method"]
+	} };
 	static groupContext = new AsyncLocalStorage();
 	/**
 	* All registered routes
@@ -44,6 +49,53 @@ var Router = class Router {
 		return "/" + path.split("/").filter(Boolean).join("/");
 	}
 	/**
+	* Configure router settings to modify behavior.
+	* 
+	* @param options - Configuration options for the router
+	* @returns 
+	*/
+	static configure(options) {
+		if (!this.config.methodOverride) this.config.methodOverride = {
+			enabled: true,
+			bodyKeys: ["_method"],
+			headerKeys: ["x-http-method"]
+		};
+		const override = options?.methodOverride;
+		if (!override) return;
+		if (typeof override.enabled === "boolean") this.config.methodOverride.enabled = override.enabled;
+		const bodyKeys = override.bodyKeys;
+		if (typeof bodyKeys !== "undefined") this.config.methodOverride.bodyKeys = (Array.isArray(bodyKeys) ? bodyKeys : [bodyKeys]).map((e) => String(e).trim()).filter(Boolean);
+		const headerKeys = override.headerKeys;
+		if (typeof headerKeys !== "undefined") this.config.methodOverride.headerKeys = (Array.isArray(headerKeys) ? headerKeys : [headerKeys]).map((e) => String(e).trim().toLowerCase()).filter(Boolean);
+	}
+	static resolveMethodOverride(method, headers, body) {
+		if (!this.config.methodOverride?.enabled || method.toLowerCase() !== "post") return null;
+		let override;
+		for (const key of this.config.methodOverride?.headerKeys || []) {
+			const value = headers?.[key];
+			if (Array.isArray(value) ? value[0] : value) {
+				override = Array.isArray(value) ? value[0] : value;
+				break;
+			}
+		}
+		if (!override && body && typeof body === "object") for (const key of this.config.methodOverride?.bodyKeys || []) {
+			const value = body[key];
+			if (typeof value !== "undefined" && value !== null && value !== "") {
+				override = value;
+				break;
+			}
+		}
+		const normalized = String(override || "").trim().toLowerCase();
+		if (!normalized) return null;
+		if ([
+			"put",
+			"patch",
+			"delete",
+			"post"
+		].includes(normalized)) return normalized;
+		return null;
+	}
+	/**
 	* Add a route with specified HTTP methods, path, handler, and middlewares
 	* @param methods - HTTP method(s) for the route
 	* @param path - Route path
@@ -255,7 +307,34 @@ var Router = class Router {
 					console.error("[ROUTES]", error.message);
 					throw error;
 				}
-				router[method](route.path, ...route.middlewares || [], async (req, res, next) => {
+				router[method](route.path, (req, res, next) => {
+					const override = Router.resolveMethodOverride(req.method, req.headers, req.body);
+					if (method === "post" && override && override !== "post") return next("route");
+					return next();
+				}, ...route.middlewares || [], async (req, res, next) => {
+					try {
+						const ctx = {
+							req,
+							res,
+							next
+						};
+						const inst = instance ?? route;
+						await Router.bindRequestToInstance(ctx, inst, route);
+						const result = handlerFunction(ctx, inst.clearRequest);
+						await Promise.resolve(result);
+					} catch (error) {
+						next(error);
+					}
+				});
+				if ([
+					"put",
+					"patch",
+					"delete"
+				].includes(method)) router.post(route.path, (req, res, next) => {
+					if (Router.resolveMethodOverride(req.method, req.headers, req.body) !== method) return next("route");
+					req.method = method.toUpperCase();
+					return next();
+				}, ...route.middlewares || [], async (req, res, next) => {
 					try {
 						const ctx = {
 							req,

package/dist/h3/index.cjs

@@ -11,6 +11,12 @@ let h3 = require("h3");
 * @repository https://github.com/toneflix/clear-router
 */
 var Router = class Router {
+	static config = { methodOverride: {
+		enabled: true,
+		bodyKeys: ["_method"],
+		headerKeys: ["x-http-method"]
+	} };
+	static bodyCache = /* @__PURE__ */ new WeakMap();
 	static groupContext = new node_async_hooks.AsyncLocalStorage();
 	/**
 	* All registered routes
@@ -44,6 +50,53 @@ var Router = class Router {
 	static normalizePath(path) {
 		return "/" + path.split("/").filter(Boolean).join("/");
 	}
+	static configure(options) {
+		if (!this.config.methodOverride) this.config.methodOverride = {
+			enabled: true,
+			bodyKeys: ["_method"],
+			headerKeys: ["x-http-method"]
+		};
+		const override = options?.methodOverride;
+		if (!override) return;
+		if (typeof override.enabled === "boolean") this.config.methodOverride.enabled = override.enabled;
+		const bodyKeys = override.bodyKeys;
+		if (typeof bodyKeys !== "undefined") this.config.methodOverride.bodyKeys = (Array.isArray(bodyKeys) ? bodyKeys : [bodyKeys]).map((e) => String(e).trim()).filter(Boolean);
+		const headerKeys = override.headerKeys;
+		if (typeof headerKeys !== "undefined") this.config.methodOverride.headerKeys = (Array.isArray(headerKeys) ? headerKeys : [headerKeys]).map((e) => String(e).trim().toLowerCase()).filter(Boolean);
+	}
+	static async readBodyCached(ctx) {
+		if (this.bodyCache.has(ctx)) return this.bodyCache.get(ctx);
+		const body = await (0, h3.readBody)(ctx) ?? {};
+		this.bodyCache.set(ctx, body);
+		return body;
+	}
+	static resolveMethodOverride(method, headers, body) {
+		if (!this.config.methodOverride?.enabled || method.toLowerCase() !== "post") return null;
+		let override;
+		for (const key of this.config.methodOverride?.headerKeys || []) {
+			const value = headers.get(key);
+			if (value) {
+				override = value;
+				break;
+			}
+		}
+		if (!override && body && typeof body === "object") for (const key of this.config.methodOverride?.bodyKeys || []) {
+			const value = body[key];
+			if (typeof value !== "undefined" && value !== null && value !== "") {
+				override = value;
+				break;
+			}
+		}
+		const normalized = String(override || "").trim().toLowerCase();
+		if (!normalized) return null;
+		if ([
+			"put",
+			"patch",
+			"delete",
+			"post"
+		].includes(normalized)) return normalized;
+		return null;
+	}
 	/**
 	* Add a route with specified HTTP methods, path, handler, and middlewares
 	* @param methods - HTTP method(s) for the route
@@ -266,8 +319,28 @@ var Router = class Router {
 				app[method](route.path, async (event) => {
 					try {
 						const ctx = event;
+						const reqBody = await Router.readBodyCached(ctx);
+						const override = Router.resolveMethodOverride(ctx.req.method, ctx.req.headers, reqBody);
+						if (method === "post" && override && override !== "post") return;
+						const inst = instance ?? route;
+						await Router.bindRequestToInstance(ctx, inst, route, reqBody);
+						const result = handlerFunction(ctx, inst.clearRequest);
+						return await Promise.resolve(result);
+					} catch (error) {
+						return error;
+					}
+				}, { middleware: route.middlewares });
+				if ([
+					"put",
+					"patch",
+					"delete"
+				].includes(method)) app.post(route.path, async (event) => {
+					try {
+						const ctx = event;
+						const reqBody = await Router.readBodyCached(ctx);
+						if (Router.resolveMethodOverride(ctx.req.method, ctx.req.headers, reqBody) !== method) return;
 						const inst = instance ?? route;
-						await Router.bindRequestToInstance(ctx, inst, route);
+						await Router.bindRequestToInstance(ctx, inst, route, reqBody);
 						const result = handlerFunction(ctx, inst.clearRequest);
 						return await Promise.resolve(result);
 					} catch (error) {
@@ -278,10 +351,10 @@ var Router = class Router {
 		}
 		return app;
 	}
-	static async bindRequestToInstance(ctx, instance, route) {
+	static async bindRequestToInstance(ctx, instance, route, body) {
 		if (!instance) return;
 		instance.ctx = ctx;
-		instance.body = await (0, h3.readBody)(ctx) ?? {};
+		instance.body = body ?? await Router.readBodyCached(ctx);
 		instance.query = (0, h3.getQuery)(ctx);
 		instance.params = (0, h3.getRouterParams)(ctx, { decode: true });
 		instance.clearRequest = new require_Route.ClearRequest({

package/dist/h3/index.d.cts

@@ -1,4 +1,4 @@
-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 { c as Route, d as HttpContext, f as Middleware, i as RouterConfig, l as H3App, n as ControllerAction, r as HttpMethod, t as ApiResourceMiddleware, u as Handler } from "../basic-DXbqD6cP.cjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts
@@ -9,6 +9,8 @@ import { H3 } from "h3";
  * @repository https://github.com/toneflix/clear-router
  */
 declare class Router {
+  static config: RouterConfig;
+  private static readonly bodyCache;
   private static readonly groupContext;
   /**
    * All registered routes
@@ -40,6 +42,9 @@ declare class Router {
    * @returns Normalized path
    */
   static normalizePath(path: string): string;
+  static configure(options?: RouterConfig): void;
+  private static readBodyCached;
+  private static resolveMethodOverride;
   /**
     * Add a route with specified HTTP methods, path, handler, and middlewares
     * @param methods - HTTP method(s) for the route
@@ -125,10 +130,10 @@ declare class Router {
   /**
    * Get all registered routes with their information
    * @returns Array of route information objects
-   */
-  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>>;
+  */
+  static allRoutes(): Array<Route<HttpContext, Middleware>>;
+  static allRoutes(type: 'path'): Record<string, Route<HttpContext, Middleware>>;
+  static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: 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,4 +1,4 @@
-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 { c as Route, d as HttpContext, f as Middleware, i as RouterConfig, l as H3App, n as ControllerAction, r as HttpMethod, t as ApiResourceMiddleware, u as Handler } from "../basic-vvrFwa_Y.mjs";
 import { H3 } from "h3";
 
 //#region src/h3/router.d.ts
@@ -9,6 +9,8 @@ import { H3 } from "h3";
  * @repository https://github.com/toneflix/clear-router
  */
 declare class Router {
+  static config: RouterConfig;
+  private static readonly bodyCache;
   private static readonly groupContext;
   /**
    * All registered routes
@@ -40,6 +42,9 @@ declare class Router {
    * @returns Normalized path
    */
   static normalizePath(path: string): string;
+  static configure(options?: RouterConfig): void;
+  private static readBodyCached;
+  private static resolveMethodOverride;
   /**
     * Add a route with specified HTTP methods, path, handler, and middlewares
     * @param methods - HTTP method(s) for the route
@@ -125,10 +130,10 @@ declare class Router {
   /**
    * Get all registered routes with their information
    * @returns Array of route information objects
-   */
-  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>>;
+  */
+  static allRoutes(): Array<Route<HttpContext, Middleware>>;
+  static allRoutes(type: 'path'): Record<string, Route<HttpContext, Middleware>>;
+  static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: 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

@@ -10,6 +10,12 @@ import { getQuery, getRouterParams, readBody } from "h3";
 * @repository https://github.com/toneflix/clear-router
 */
 var Router = class Router {
+	static config = { methodOverride: {
+		enabled: true,
+		bodyKeys: ["_method"],
+		headerKeys: ["x-http-method"]
+	} };
+	static bodyCache = /* @__PURE__ */ new WeakMap();
 	static groupContext = new AsyncLocalStorage();
 	/**
 	* All registered routes
@@ -43,6 +49,53 @@ var Router = class Router {
 	static normalizePath(path) {
 		return "/" + path.split("/").filter(Boolean).join("/");
 	}
+	static configure(options) {
+		if (!this.config.methodOverride) this.config.methodOverride = {
+			enabled: true,
+			bodyKeys: ["_method"],
+			headerKeys: ["x-http-method"]
+		};
+		const override = options?.methodOverride;
+		if (!override) return;
+		if (typeof override.enabled === "boolean") this.config.methodOverride.enabled = override.enabled;
+		const bodyKeys = override.bodyKeys;
+		if (typeof bodyKeys !== "undefined") this.config.methodOverride.bodyKeys = (Array.isArray(bodyKeys) ? bodyKeys : [bodyKeys]).map((e) => String(e).trim()).filter(Boolean);
+		const headerKeys = override.headerKeys;
+		if (typeof headerKeys !== "undefined") this.config.methodOverride.headerKeys = (Array.isArray(headerKeys) ? headerKeys : [headerKeys]).map((e) => String(e).trim().toLowerCase()).filter(Boolean);
+	}
+	static async readBodyCached(ctx) {
+		if (this.bodyCache.has(ctx)) return this.bodyCache.get(ctx);
+		const body = await readBody(ctx) ?? {};
+		this.bodyCache.set(ctx, body);
+		return body;
+	}
+	static resolveMethodOverride(method, headers, body) {
+		if (!this.config.methodOverride?.enabled || method.toLowerCase() !== "post") return null;
+		let override;
+		for (const key of this.config.methodOverride?.headerKeys || []) {
+			const value = headers.get(key);
+			if (value) {
+				override = value;
+				break;
+			}
+		}
+		if (!override && body && typeof body === "object") for (const key of this.config.methodOverride?.bodyKeys || []) {
+			const value = body[key];
+			if (typeof value !== "undefined" && value !== null && value !== "") {
+				override = value;
+				break;
+			}
+		}
+		const normalized = String(override || "").trim().toLowerCase();
+		if (!normalized) return null;
+		if ([
+			"put",
+			"patch",
+			"delete",
+			"post"
+		].includes(normalized)) return normalized;
+		return null;
+	}
 	/**
 	* Add a route with specified HTTP methods, path, handler, and middlewares
 	* @param methods - HTTP method(s) for the route
@@ -265,8 +318,28 @@ var Router = class Router {
 				app[method](route.path, async (event) => {
 					try {
 						const ctx = event;
+						const reqBody = await Router.readBodyCached(ctx);
+						const override = Router.resolveMethodOverride(ctx.req.method, ctx.req.headers, reqBody);
+						if (method === "post" && override && override !== "post") return;
+						const inst = instance ?? route;
+						await Router.bindRequestToInstance(ctx, inst, route, reqBody);
+						const result = handlerFunction(ctx, inst.clearRequest);
+						return await Promise.resolve(result);
+					} catch (error) {
+						return error;
+					}
+				}, { middleware: route.middlewares });
+				if ([
+					"put",
+					"patch",
+					"delete"
+				].includes(method)) app.post(route.path, async (event) => {
+					try {
+						const ctx = event;
+						const reqBody = await Router.readBodyCached(ctx);
+						if (Router.resolveMethodOverride(ctx.req.method, ctx.req.headers, reqBody) !== method) return;
 						const inst = instance ?? route;
-						await Router.bindRequestToInstance(ctx, inst, route);
+						await Router.bindRequestToInstance(ctx, inst, route, reqBody);
 						const result = handlerFunction(ctx, inst.clearRequest);
 						return await Promise.resolve(result);
 					} catch (error) {
@@ -277,10 +350,10 @@ var Router = class Router {
 		}
 		return app;
 	}
-	static async bindRequestToInstance(ctx, instance, route) {
+	static async bindRequestToInstance(ctx, instance, route, body) {
 		if (!instance) return;
 		instance.ctx = ctx;
-		instance.body = await readBody(ctx) ?? {};
+		instance.body = body ?? await Router.readBodyCached(ctx);
 		instance.query = getQuery(ctx);
 		instance.params = getRouterParams(ctx, { decode: true });
 		instance.clearRequest = new ClearRequest({

package/dist/types/basic.d.mts

@@ -19,5 +19,16 @@ type ControllerAction = 'index' | 'show' | 'create' | 'update' | 'destroy';
  */
 type RequestData = Record<string, any>;
 type ApiResourceMiddleware<M extends Middleware$1 | Middleware> = M | M[] | { [K in ControllerAction]?: M | M[] };
+interface RouterConfig {
+  /**
+   * Configuration for method override functionality, allowing clients to use a
+   * specific header or body parameter to override the HTTP method.
+   */
+  methodOverride?: {
+    /** Whether method override is enabled */enabled?: boolean; /** Keys in the request body to check for method override */
+    bodyKeys?: string[] | string; /** Keys in the request headers to check for method override */
+    headerKeys?: string[] | string;
+  };
+}
 //#endregion
-export { ApiResourceMiddleware, ControllerAction, ControllerHandler, HttpMethod, RequestData };
+export { ApiResourceMiddleware, ControllerAction, ControllerHandler, HttpMethod, RequestData, RouterConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-router",
-  "version": "2.1.9",
+  "version": "2.1.11",
   "description": "Laravel-style routing system for Express.js and H3, with CommonJS, ESM, and TypeScript support",
   "keywords": [
     "h3",