clear-router 2.1.10 → 2.1.12

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-C_1O6RVq.d.cts}

@@ -5,10 +5,15 @@ import { H3, H3Event, Middleware as Middleware$1, TypedServerRequest } from "h3"
 type H3App = Omit<H3['fetch'], 'fetch'> & {
   fetch: (request: TypedServerRequest) => Promise<Response>;
 };
+type HttpRequest = H3Event['req'] & {
+  getBody: () => Record<string, any>;
+};
 /**
  * HTTP context passed to route handlers
  */
-type HttpContext$1 = H3Event & {};
+type HttpContext$1 = Omit<H3Event, 'req'> & {
+  req: HttpRequest;
+};
 /**
  * Route handler function type
  */
@@ -66,11 +71,14 @@ declare class ClearRequest<X = any, M = Middleware$1 | Middleware> {
 }
 //#endregion
 //#region types/express.d.ts
+interface RequestWithGetBody extends Request {
+  getBody: () => Record<string, any>;
+}
 /**
  * HTTP context passed to route handlers
  */
 interface HttpContext {
-  req: Request;
+  req: RequestWithGetBody;
   res: Response$1;
   next: NextFunction;
 }
@@ -115,5 +123,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-cLeny2Zk.d.mts}

@@ -5,10 +5,15 @@ import { NextFunction, Request, Response as Response$1 } from "express";
 type H3App = Omit<H3['fetch'], 'fetch'> & {
   fetch: (request: TypedServerRequest) => Promise<Response>;
 };
+type HttpRequest = H3Event['req'] & {
+  getBody: () => Record<string, any>;
+};
 /**
  * HTTP context passed to route handlers
  */
-type HttpContext$1 = H3Event & {};
+type HttpContext$1 = Omit<H3Event, 'req'> & {
+  req: HttpRequest;
+};
 /**
  * Route handler function type
  */
@@ -66,11 +71,14 @@ declare class ClearRequest<X = any, M = Middleware$1 | Middleware> {
 }
 //#endregion
 //#region types/express.d.ts
+interface RequestWithGetBody extends Request {
+  getBody: () => Record<string, any>;
+}
 /**
  * HTTP context passed to route handlers
  */
 interface HttpContext {
-  req: Request;
+  req: RequestWithGetBody;
   res: Response$1;
   next: NextFunction;
 }
@@ -115,5 +123,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,56 @@ 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 ensureRequestBodyAccessor(req) {
+		if (typeof req.getBody !== "function") req.getBody = () => req.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?.[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,8 +311,39 @@ 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) => {
+					Router.ensureRequestBodyAccessor(req);
+					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 {
+						Router.ensureRequestBodyAccessor(req);
+						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) => {
+					Router.ensureRequestBodyAccessor(req);
+					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 {
+						Router.ensureRequestBodyAccessor(req);
 						const ctx = {
 							req,
 							res,
@@ -276,8 +362,9 @@ var Router = class Router {
 	}
 	static async bindRequestToInstance(ctx, instance, route) {
 		if (!instance) return;
+		Router.ensureRequestBodyAccessor(ctx.req);
 		instance.ctx = ctx;
-		instance.body = ctx.req.body;
+		instance.body = ctx.req.getBody();
 		instance.query = ctx.req.query;
 		instance.params = ctx.req.params;
 		instance.clearRequest = new require_Route.ClearRequest({

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-C_1O6RVq.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,15 @@ 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 ensureRequestBodyAccessor;
+  private static resolveMethodOverride;
   /**
     * Add a route with specified HTTP methods, path, handler, and middlewares
     * @param methods - HTTP method(s) for the route

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-cLeny2Zk.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,15 @@ 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 ensureRequestBodyAccessor;
+  private static resolveMethodOverride;
   /**
     * Add a route with specified HTTP methods, path, handler, and middlewares
     * @param methods - HTTP method(s) for the route

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,56 @@ 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 ensureRequestBodyAccessor(req) {
+		if (typeof req.getBody !== "function") req.getBody = () => req.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?.[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,8 +310,39 @@ 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) => {
+					Router.ensureRequestBodyAccessor(req);
+					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 {
+						Router.ensureRequestBodyAccessor(req);
+						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) => {
+					Router.ensureRequestBodyAccessor(req);
+					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 {
+						Router.ensureRequestBodyAccessor(req);
 						const ctx = {
 							req,
 							res,
@@ -275,8 +361,9 @@ var Router = class Router {
 	}
 	static async bindRequestToInstance(ctx, instance, route) {
 		if (!instance) return;
+		Router.ensureRequestBodyAccessor(ctx.req);
 		instance.ctx = ctx;
-		instance.body = ctx.req.body;
+		instance.body = ctx.req.getBody();
 		instance.query = ctx.req.query;
 		instance.params = ctx.req.params;
 		instance.clearRequest = new ClearRequest({

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,62 @@ 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)) {
+			const cached = this.bodyCache.get(ctx);
+			ctx.req.getBody = () => cached;
+			return cached;
+		}
+		let body = {};
+		if (ctx.req.headers.get("content-type")?.includes("multipart/form-data")) (await ctx.req.formData()).forEach((value, key) => {
+			body[key] = value;
+		});
+		else body = await (0, h3.readBody)(ctx) ?? {};
+		ctx.req.getBody = () => body;
+		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 +328,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 +360,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-C_1O6RVq.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

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-cLeny2Zk.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

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,62 @@ 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)) {
+			const cached = this.bodyCache.get(ctx);
+			ctx.req.getBody = () => cached;
+			return cached;
+		}
+		let body = {};
+		if (ctx.req.headers.get("content-type")?.includes("multipart/form-data")) (await ctx.req.formData()).forEach((value, key) => {
+			body[key] = value;
+		});
+		else body = await readBody(ctx) ?? {};
+		ctx.req.getBody = () => body;
+		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 +327,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 +359,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/index.d.cts

@@ -2,10 +2,15 @@ import { NextFunction, Request, Response as Response$1 } from "express";
 import { H3Event, Middleware as Middleware$1 } from "h3";
 
 //#region types/h3.d.ts
+type HttpRequest = H3Event['req'] & {
+  getBody: () => Record<string, any>;
+};
 /**
  * HTTP context passed to route handlers
  */
-type HttpContext = H3Event & {};
+type HttpContext = Omit<H3Event, 'req'> & {
+  req: HttpRequest;
+};
 /**
  * Route handler function type
  */
@@ -13,10 +18,12 @@ type RouteHandler = (
 /**
  * H3 event context
  */
+
 ctx: HttpContext,
 /**
  * ClearRequest instance
  */
+
 req: ClearRequest) => any | Promise<any>;
 /**
  * Handler can be either a function or controller reference

package/dist/index.d.mts

@@ -2,10 +2,15 @@ import { NextFunction, Request, Response as Response$1 } from "express";
 import { H3Event, Middleware as Middleware$1 } from "h3";
 
 //#region types/h3.d.ts
+type HttpRequest = H3Event['req'] & {
+  getBody: () => Record<string, any>;
+};
 /**
  * HTTP context passed to route handlers
  */
-type HttpContext = H3Event & {};
+type HttpContext = Omit<H3Event, 'req'> & {
+  req: HttpRequest;
+};
 /**
  * Route handler function type
  */
@@ -13,10 +18,12 @@ type RouteHandler = (
 /**
  * H3 event context
  */
+
 ctx: HttpContext,
 /**
  * ClearRequest instance
  */
+
 req: ClearRequest) => any | Promise<any>;
 /**
  * Handler can be either a function or controller reference

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/dist/types/express.d.mts

@@ -3,11 +3,14 @@ import { ControllerHandler } from "./basic.mjs";
 import { NextFunction, Request, Response } from "express";
 
 //#region types/express.d.ts
+interface RequestWithGetBody extends Request {
+  getBody: () => Record<string, any>;
+}
 /**
  * HTTP context passed to route handlers
  */
 interface HttpContext {
-  req: Request;
+  req: RequestWithGetBody;
   res: Response;
   next: NextFunction;
 }
@@ -34,4 +37,4 @@ type Handler = RouteHandler | ControllerHandler;
  */
 type Middleware = (req: Request, res: Response, next: NextFunction) => any | Promise<any>;
 //#endregion
-export { Handler, HttpContext, Middleware, RouteHandler };
+export { Handler, HttpContext, Middleware, RequestWithGetBody, RouteHandler };

package/dist/types/h3.d.mts

@@ -7,10 +7,15 @@ type H3App = Omit<H3['fetch'], 'fetch'> & {
   fetch: (request: TypedServerRequest) => Promise<Response>;
 };
 type MaybePromise<T = unknown> = T | Promise<T>;
+type HttpRequest = H3Event['req'] & {
+  getBody: () => Record<string, any>;
+};
 /**
  * HTTP context passed to route handlers
  */
-type HttpContext = H3Event & {};
+type HttpContext = Omit<H3Event, 'req'> & {
+  req: HttpRequest;
+};
 /**
  * Route handler function type
  */
@@ -31,4 +36,4 @@ req: ClearRequest) => any | Promise<any>;
 type Handler = RouteHandler | ControllerHandler;
 type NextFunction = () => MaybePromise<unknown | undefined>;
 //#endregion
-export { H3App, Handler, HttpContext, MaybePromise, type Middleware, NextFunction, RouteHandler };
+export { H3App, Handler, HttpContext, HttpRequest, MaybePromise, type Middleware, NextFunction, RouteHandler };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-router",
-  "version": "2.1.10",
+  "version": "2.1.12",
   "description": "Laravel-style routing system for Express.js and H3, with CommonJS, ESM, and TypeScript support",
   "keywords": [
     "h3",
@@ -80,6 +80,7 @@
     "typescript": "^5.3.3",
     "typescript-eslint": "^8.56.1",
     "vite-tsconfig-paths": "^6.1.1",
+    "vitepress": "^1.6.4",
     "vitest": "^4.0.18"
   },
   "engines": {
@@ -88,6 +89,9 @@
   "scripts": {
     "test": "vitest",
     "lint": "eslint",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
     "test:esm": "vitest tests/esm.test.ts",
     "test:ts": "vitest tests/typescript.test.ts",
     "test:coverage": "vitest run --coverage",