clear-router 2.4.0 → 2.5.0

package/README.md

@@ -49,6 +49,7 @@ yarn add clear-router express
 - Function handlers always receive context as first argument
 - Controller handlers receive hydrated `this.body`, `this.query`, `this.params`, and `this.clearRequest`
 - `clearRequest` is passed as second handler argument for controller handlers
+- Route handlers can return response values directly across Express, Fastify, Hono, and H3
 - Auto-binds controller methods
 - Full CommonJS, ESM, and TypeScript support
 - Error handling delegated to Express | H3 | Fastify | Hono

package/dist/core/index.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_router = require('../router-C-c43ybe.cjs');
+const require_router = require('../router-Cxi21bzi.cjs');
 
 exports.CoreRouter = require_router.CoreRouter;

package/dist/core/index.mjs

@@ -1,3 +1,3 @@
-import { t as CoreRouter } from "../router-CHaZi7NS.mjs";
+import { t as CoreRouter } from "../router-Dxc8FQOl.mjs";
 
 export { CoreRouter };

package/dist/express/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_router = require('../router-C-c43ybe.cjs');
+const require_router = require('../router-Cxi21bzi.cjs');
 const require_responses = require('../responses-r-O3jS-S.cjs');
 
 //#region src/express/router.ts

package/dist/express/index.mjs

@@ -1,4 +1,4 @@
-import { t as CoreRouter } from "../router-CHaZi7NS.mjs";
+import { t as CoreRouter } from "../router-Dxc8FQOl.mjs";
 import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse } from "../responses-HOePPAl8.mjs";
 
 //#region src/express/router.ts

package/dist/fastify/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_router = require('../router-C-c43ybe.cjs');
+const require_router = require('../router-Cxi21bzi.cjs');
 const require_responses = require('../responses-r-O3jS-S.cjs');
 
 //#region src/fastify/router.ts

package/dist/fastify/index.mjs

@@ -1,4 +1,4 @@
-import { t as CoreRouter } from "../router-CHaZi7NS.mjs";
+import { t as CoreRouter } from "../router-Dxc8FQOl.mjs";
 import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse } from "../responses-HOePPAl8.mjs";
 
 //#region src/fastify/router.ts

package/dist/h3/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_router = require('../router-C-c43ybe.cjs');
+const require_router = require('../router-Cxi21bzi.cjs');
 const require_responses = require('../responses-r-O3jS-S.cjs');
 let h3 = require("h3");
 

package/dist/h3/index.mjs

@@ -1,4 +1,4 @@
-import { t as CoreRouter } from "../router-CHaZi7NS.mjs";
+import { t as CoreRouter } from "../router-Dxc8FQOl.mjs";
 import { n as resolveResponseMeta } from "../responses-HOePPAl8.mjs";
 import { getQuery, getRouterParams, readBody } from "h3";
 

package/dist/hono/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_router = require('../router-C-c43ybe.cjs');
+const require_router = require('../router-Cxi21bzi.cjs');
 const require_responses = require('../responses-r-O3jS-S.cjs');
 
 //#region src/hono/router.ts

package/dist/hono/index.mjs

@@ -1,4 +1,4 @@
-import { t as CoreRouter } from "../router-CHaZi7NS.mjs";
+import { t as CoreRouter } from "../router-Dxc8FQOl.mjs";
 import { n as resolveResponseMeta } from "../responses-HOePPAl8.mjs";
 
 //#region src/hono/router.ts

package/dist/index.cjs

@@ -155,6 +155,11 @@ var CoreRouter = class {
 				ctx.reply.code(204).send();
 				return;
 			}
+			if (ctx?.set && "status" in ctx) {
+				ctx.set("Allow", allow);
+				ctx.status = 204;
+				ctx.body = null;
+			}
 		};
 	}
 	static config = { methodOverride: {

package/dist/index.mjs

@@ -154,6 +154,11 @@ var CoreRouter = class {
 				ctx.reply.code(204).send();
 				return;
 			}
+			if (ctx?.set && "status" in ctx) {
+				ctx.set("Allow", allow);
+				ctx.status = 204;
+				ctx.body = null;
+			}
 		};
 	}
 	static config = { methodOverride: {

package/dist/koa/index.cjs

@@ -0,0 +1,169 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_router = require('../router-Cxi21bzi.cjs');
+const require_responses = require('../responses-r-O3jS-S.cjs');
+
+//#region src/koa/router.ts
+/**
+* @class clear-router Koa Router
+* @description Laravel-style routing system for Koa using @koa/router and shared clear-router core
+* @author 3m1n3nc3
+* @repository https://github.com/toneflix/clear-router
+*/
+var Router = class Router extends require_router.CoreRouter {
+	static routerStateNamespace = "clear-router:koa";
+	static bodyCache = /* @__PURE__ */ new WeakMap();
+	static async readBodyCached(ctx) {
+		if (this.bodyCache.has(ctx)) {
+			const cached = this.bodyCache.get(ctx) || {};
+			ctx.request.getBody = () => cached;
+			return cached;
+		}
+		let body = ctx.request.body && typeof ctx.request.body === "object" ? ctx.request.body : {};
+		if (!Object.keys(body).length && !["GET", "HEAD"].includes(ctx.method.toUpperCase())) body = await this.readBody(ctx);
+		ctx.request.getBody = () => body;
+		this.bodyCache.set(ctx, body);
+		return body;
+	}
+	static async readBody(ctx) {
+		const contentType = String(ctx.get("content-type") || "").toLowerCase();
+		const chunks = [];
+		for await (const chunk of ctx.req) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+		const raw = Buffer.concat(chunks).toString("utf8");
+		if (!raw) return {};
+		if (contentType.includes("application/json")) return JSON.parse(raw);
+		if (contentType.includes("application/x-www-form-urlencoded")) return Object.fromEntries(new URLSearchParams(raw));
+		return {};
+	}
+	static async sendReturnValue(ctx, value, method, path) {
+		if (ctx.respond === false || ctx.headerSent) return value;
+		const meta = require_responses.resolveResponseMeta(value, {
+			headers: ctx.headers,
+			method,
+			path,
+			status: ctx.status && ctx.status !== 404 ? ctx.status : void 0
+		});
+		if (!meta) return void 0;
+		ctx.status = meta.status;
+		if (require_responses.isFetchResponse(meta.body)) {
+			meta.body.headers.forEach((headerValue, key) => {
+				ctx.set(key, headerValue);
+			});
+			ctx.status = meta.body.status;
+			ctx.body = Buffer.from(await meta.body.arrayBuffer());
+			return ctx.body;
+		}
+		if (meta.contentType) ctx.type = meta.contentType;
+		ctx.body = meta.isEmpty ? null : meta.body;
+		return ctx.body;
+	}
+	/**
+	* Adds a new route to the router with the specified HTTP methods, path, handler, and optional middlewares.
+	*/
+	static add(methods, path, handler, middlewares) {
+		super.add(methods, path, handler, middlewares);
+	}
+	/**
+	* Adds a new API resource route to the router for the specified base path and controller.
+	*/
+	static apiResource(basePath, controller, options) {
+		super.apiResource(basePath, controller, options);
+	}
+	static get(path, handler, middlewares) {
+		super.get(path, handler, middlewares);
+	}
+	static post(path, handler, middlewares) {
+		super.post(path, handler, middlewares);
+	}
+	static put(path, handler, middlewares) {
+		super.put(path, handler, middlewares);
+	}
+	static delete(path, handler, middlewares) {
+		super.delete(path, handler, middlewares);
+	}
+	static patch(path, handler, middlewares) {
+		super.patch(path, handler, middlewares);
+	}
+	static options(path, handler, middlewares) {
+		super.options(path, handler, middlewares);
+	}
+	static head(path, handler, middlewares) {
+		super.head(path, handler, middlewares);
+	}
+	static async group(prefix, callback, middlewares) {
+		await super.group(prefix, callback, middlewares);
+	}
+	static middleware(middlewares, callback) {
+		super.middleware(middlewares, callback);
+	}
+	static allRoutes(type) {
+		return super.allRoutes(type);
+	}
+	/**
+	* Applies the registered routes to a @koa/router instance.
+	*/
+	static apply(router) {
+		for (const route of this.routes) {
+			let handlerFunction = null;
+			let instance = null;
+			try {
+				const resolved = this.resolveHandler(route);
+				handlerFunction = resolved.handlerFunction;
+				instance = resolved.instance;
+			} catch (error) {
+				console.error(`[ROUTES] Error setting up route ${route.path}:`, error.message);
+				throw error;
+			}
+			if (!handlerFunction) continue;
+			for (const method of route.methods) {
+				const allowedMethods = [
+					"get",
+					"post",
+					"put",
+					"delete",
+					"patch",
+					"options",
+					"head"
+				];
+				if (method === "options" && route.methods.length > 1) continue;
+				if (!allowedMethods.includes(method)) throw new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
+				router[method](route.path, ...route.middlewares || [], async (context, next) => {
+					const ctx = context;
+					const reqBody = await Router.readBodyCached(ctx);
+					const override = Router.resolveMethodOverride(ctx.method, ctx.headers, reqBody);
+					if (method === "post" && override && override !== "post") return next();
+					const inst = instance ?? route;
+					Router.bindRequestToInstance(ctx, inst, route, {
+						body: reqBody,
+						query: ctx.query,
+						params: ctx.params ?? {}
+					});
+					const result = handlerFunction(ctx, inst.clearRequest);
+					const resolved = await Promise.resolve(result);
+					return Router.sendReturnValue(ctx, resolved, method, route.path);
+				});
+				if ([
+					"put",
+					"patch",
+					"delete"
+				].includes(method)) router.post(route.path, ...route.middlewares || [], async (context, next) => {
+					const ctx = context;
+					const reqBody = await Router.readBodyCached(ctx);
+					if (Router.resolveMethodOverride(ctx.method, ctx.headers, reqBody) !== method) return next();
+					const inst = instance ?? route;
+					Router.bindRequestToInstance(ctx, inst, route, {
+						body: reqBody,
+						query: ctx.query,
+						params: ctx.params ?? {}
+					});
+					const result = handlerFunction(ctx, inst.clearRequest);
+					const resolved = await Promise.resolve(result);
+					return Router.sendReturnValue(ctx, resolved, method, route.path);
+				});
+			}
+		}
+		return router;
+	}
+};
+
+//#endregion
+exports.Router = Router;

package/dist/koa/index.d.cts

@@ -0,0 +1,63 @@
+import { d as ApiResourceMiddleware, f as ControllerAction, m as HttpMethod, n as ClearRequest, p as ControllerHandler, r as Route, t as CoreRouter } from "../router-A-9JuZPi.cjs";
+import Koa from "koa";
+import Router$1 from "@koa/router";
+
+//#region types/koa.d.ts
+interface RequestWithGetBody extends Koa.Request {
+  getBody: () => Record<string, any>;
+  body?: any;
+}
+interface HttpContext extends Koa.Context {
+  request: RequestWithGetBody;
+  params: Record<string, any>;
+  query: Record<string, any>;
+}
+type RouteHandler = (ctx: HttpContext, req: ClearRequest) => any | Promise<any>;
+type Handler = RouteHandler | ControllerHandler;
+type Middleware = Koa.Middleware<any, any>;
+type KoaRouterApp = Router$1<any, any>;
+//#endregion
+//#region src/koa/router.d.ts
+/**
+ * @class clear-router Koa Router
+ * @description Laravel-style routing system for Koa using @koa/router and shared clear-router core
+ * @author 3m1n3nc3
+ * @repository https://github.com/toneflix/clear-router
+ */
+declare class Router extends CoreRouter {
+  protected static routerStateNamespace: string;
+  private static readonly bodyCache;
+  private static readBodyCached;
+  private static readBody;
+  private static sendReturnValue;
+  /**
+   * Adds a new route to the router with the specified HTTP methods, path, handler, and optional middlewares.
+   */
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  /**
+   * Adds a new API resource route to the router for the specified base path and controller.
+   */
+  static apiResource(basePath: string, controller: any, options?: {
+    only?: ControllerAction[];
+    except?: ControllerAction[];
+    middlewares?: ApiResourceMiddleware<Middleware>;
+  }): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static middleware(middlewares: Middleware[], callback: () => void): void;
+  static allRoutes(): Array<Route<HttpContext, Middleware, Handler>>;
+  static allRoutes(type: 'path'): Record<string, Route<HttpContext, Middleware, Handler>>;
+  static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware, Handler>> };
+  /**
+   * Applies the registered routes to a @koa/router instance.
+   */
+  static apply(router: KoaRouterApp): KoaRouterApp;
+}
+//#endregion
+export { Router };

package/dist/koa/index.d.mts

@@ -0,0 +1,63 @@
+import { d as ApiResourceMiddleware, f as ControllerAction, m as HttpMethod, n as ClearRequest, p as ControllerHandler, r as Route, t as CoreRouter } from "../router-CVeqd7Ro.mjs";
+import Koa from "koa";
+import Router$1 from "@koa/router";
+
+//#region types/koa.d.ts
+interface RequestWithGetBody extends Koa.Request {
+  getBody: () => Record<string, any>;
+  body?: any;
+}
+interface HttpContext extends Koa.Context {
+  request: RequestWithGetBody;
+  params: Record<string, any>;
+  query: Record<string, any>;
+}
+type RouteHandler = (ctx: HttpContext, req: ClearRequest) => any | Promise<any>;
+type Handler = RouteHandler | ControllerHandler;
+type Middleware = Koa.Middleware<any, any>;
+type KoaRouterApp = Router$1<any, any>;
+//#endregion
+//#region src/koa/router.d.ts
+/**
+ * @class clear-router Koa Router
+ * @description Laravel-style routing system for Koa using @koa/router and shared clear-router core
+ * @author 3m1n3nc3
+ * @repository https://github.com/toneflix/clear-router
+ */
+declare class Router extends CoreRouter {
+  protected static routerStateNamespace: string;
+  private static readonly bodyCache;
+  private static readBodyCached;
+  private static readBody;
+  private static sendReturnValue;
+  /**
+   * Adds a new route to the router with the specified HTTP methods, path, handler, and optional middlewares.
+   */
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  /**
+   * Adds a new API resource route to the router for the specified base path and controller.
+   */
+  static apiResource(basePath: string, controller: any, options?: {
+    only?: ControllerAction[];
+    except?: ControllerAction[];
+    middlewares?: ApiResourceMiddleware<Middleware>;
+  }): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static group(prefix: string, callback: () => void | Promise<void>, middlewares?: Middleware[]): Promise<void>;
+  static middleware(middlewares: Middleware[], callback: () => void): void;
+  static allRoutes(): Array<Route<HttpContext, Middleware, Handler>>;
+  static allRoutes(type: 'path'): Record<string, Route<HttpContext, Middleware, Handler>>;
+  static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware, Handler>> };
+  /**
+   * Applies the registered routes to a @koa/router instance.
+   */
+  static apply(router: KoaRouterApp): KoaRouterApp;
+}
+//#endregion
+export { Router };

package/dist/koa/index.mjs

@@ -0,0 +1,168 @@
+import { t as CoreRouter } from "../router-Dxc8FQOl.mjs";
+import { n as resolveResponseMeta, t as isFetchResponse } from "../responses-HOePPAl8.mjs";
+
+//#region src/koa/router.ts
+/**
+* @class clear-router Koa Router
+* @description Laravel-style routing system for Koa using @koa/router and shared clear-router core
+* @author 3m1n3nc3
+* @repository https://github.com/toneflix/clear-router
+*/
+var Router = class Router extends CoreRouter {
+	static routerStateNamespace = "clear-router:koa";
+	static bodyCache = /* @__PURE__ */ new WeakMap();
+	static async readBodyCached(ctx) {
+		if (this.bodyCache.has(ctx)) {
+			const cached = this.bodyCache.get(ctx) || {};
+			ctx.request.getBody = () => cached;
+			return cached;
+		}
+		let body = ctx.request.body && typeof ctx.request.body === "object" ? ctx.request.body : {};
+		if (!Object.keys(body).length && !["GET", "HEAD"].includes(ctx.method.toUpperCase())) body = await this.readBody(ctx);
+		ctx.request.getBody = () => body;
+		this.bodyCache.set(ctx, body);
+		return body;
+	}
+	static async readBody(ctx) {
+		const contentType = String(ctx.get("content-type") || "").toLowerCase();
+		const chunks = [];
+		for await (const chunk of ctx.req) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+		const raw = Buffer.concat(chunks).toString("utf8");
+		if (!raw) return {};
+		if (contentType.includes("application/json")) return JSON.parse(raw);
+		if (contentType.includes("application/x-www-form-urlencoded")) return Object.fromEntries(new URLSearchParams(raw));
+		return {};
+	}
+	static async sendReturnValue(ctx, value, method, path) {
+		if (ctx.respond === false || ctx.headerSent) return value;
+		const meta = resolveResponseMeta(value, {
+			headers: ctx.headers,
+			method,
+			path,
+			status: ctx.status && ctx.status !== 404 ? ctx.status : void 0
+		});
+		if (!meta) return void 0;
+		ctx.status = meta.status;
+		if (isFetchResponse(meta.body)) {
+			meta.body.headers.forEach((headerValue, key) => {
+				ctx.set(key, headerValue);
+			});
+			ctx.status = meta.body.status;
+			ctx.body = Buffer.from(await meta.body.arrayBuffer());
+			return ctx.body;
+		}
+		if (meta.contentType) ctx.type = meta.contentType;
+		ctx.body = meta.isEmpty ? null : meta.body;
+		return ctx.body;
+	}
+	/**
+	* Adds a new route to the router with the specified HTTP methods, path, handler, and optional middlewares.
+	*/
+	static add(methods, path, handler, middlewares) {
+		super.add(methods, path, handler, middlewares);
+	}
+	/**
+	* Adds a new API resource route to the router for the specified base path and controller.
+	*/
+	static apiResource(basePath, controller, options) {
+		super.apiResource(basePath, controller, options);
+	}
+	static get(path, handler, middlewares) {
+		super.get(path, handler, middlewares);
+	}
+	static post(path, handler, middlewares) {
+		super.post(path, handler, middlewares);
+	}
+	static put(path, handler, middlewares) {
+		super.put(path, handler, middlewares);
+	}
+	static delete(path, handler, middlewares) {
+		super.delete(path, handler, middlewares);
+	}
+	static patch(path, handler, middlewares) {
+		super.patch(path, handler, middlewares);
+	}
+	static options(path, handler, middlewares) {
+		super.options(path, handler, middlewares);
+	}
+	static head(path, handler, middlewares) {
+		super.head(path, handler, middlewares);
+	}
+	static async group(prefix, callback, middlewares) {
+		await super.group(prefix, callback, middlewares);
+	}
+	static middleware(middlewares, callback) {
+		super.middleware(middlewares, callback);
+	}
+	static allRoutes(type) {
+		return super.allRoutes(type);
+	}
+	/**
+	* Applies the registered routes to a @koa/router instance.
+	*/
+	static apply(router) {
+		for (const route of this.routes) {
+			let handlerFunction = null;
+			let instance = null;
+			try {
+				const resolved = this.resolveHandler(route);
+				handlerFunction = resolved.handlerFunction;
+				instance = resolved.instance;
+			} catch (error) {
+				console.error(`[ROUTES] Error setting up route ${route.path}:`, error.message);
+				throw error;
+			}
+			if (!handlerFunction) continue;
+			for (const method of route.methods) {
+				const allowedMethods = [
+					"get",
+					"post",
+					"put",
+					"delete",
+					"patch",
+					"options",
+					"head"
+				];
+				if (method === "options" && route.methods.length > 1) continue;
+				if (!allowedMethods.includes(method)) throw new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
+				router[method](route.path, ...route.middlewares || [], async (context, next) => {
+					const ctx = context;
+					const reqBody = await Router.readBodyCached(ctx);
+					const override = Router.resolveMethodOverride(ctx.method, ctx.headers, reqBody);
+					if (method === "post" && override && override !== "post") return next();
+					const inst = instance ?? route;
+					Router.bindRequestToInstance(ctx, inst, route, {
+						body: reqBody,
+						query: ctx.query,
+						params: ctx.params ?? {}
+					});
+					const result = handlerFunction(ctx, inst.clearRequest);
+					const resolved = await Promise.resolve(result);
+					return Router.sendReturnValue(ctx, resolved, method, route.path);
+				});
+				if ([
+					"put",
+					"patch",
+					"delete"
+				].includes(method)) router.post(route.path, ...route.middlewares || [], async (context, next) => {
+					const ctx = context;
+					const reqBody = await Router.readBodyCached(ctx);
+					if (Router.resolveMethodOverride(ctx.method, ctx.headers, reqBody) !== method) return next();
+					const inst = instance ?? route;
+					Router.bindRequestToInstance(ctx, inst, route, {
+						body: reqBody,
+						query: ctx.query,
+						params: ctx.params ?? {}
+					});
+					const result = handlerFunction(ctx, inst.clearRequest);
+					const resolved = await Promise.resolve(result);
+					return Router.sendReturnValue(ctx, resolved, method, route.path);
+				});
+			}
+		}
+		return router;
+	}
+};
+
+//#endregion
+export { Router };

package/dist/{router-C-c43ybe.cjs → router-Cxi21bzi.cjs}

@@ -144,6 +144,11 @@ var CoreRouter = class {
 				ctx.reply.code(204).send();
 				return;
 			}
+			if (ctx?.set && "status" in ctx) {
+				ctx.set("Allow", allow);
+				ctx.status = 204;
+				ctx.body = null;
+			}
 		};
 	}
 	static config = { methodOverride: {

package/dist/{router-CHaZi7NS.mjs → router-Dxc8FQOl.mjs}

@@ -144,6 +144,11 @@ var CoreRouter = class {
 				ctx.reply.code(204).send();
 				return;
 			}
+			if (ctx?.set && "status" in ctx) {
+				ctx.set("Allow", allow);
+				ctx.status = 204;
+				ctx.body = null;
+			}
 		};
 	}
 	static config = { methodOverride: {

package/dist/types/koa.d.mts

@@ -0,0 +1,22 @@
+import { ControllerHandler } from "./basic.mjs";
+import { ClearRequest } from "./ClearRequest.mjs";
+import Koa from "koa";
+import Router from "@koa/router";
+
+//#region types/koa.d.ts
+interface RequestWithGetBody extends Koa.Request {
+  getBody: () => Record<string, any>;
+  body?: any;
+}
+interface HttpContext extends Koa.Context {
+  request: RequestWithGetBody;
+  params: Record<string, any>;
+  query: Record<string, any>;
+}
+type RouteHandler = (ctx: HttpContext, req: ClearRequest) => any | Promise<any>;
+type Handler = RouteHandler | ControllerHandler;
+type NextFunction = Koa.Next;
+type Middleware = Koa.Middleware<any, any>;
+type KoaRouterApp = Router<any, any>;
+//#endregion
+export { Handler, HttpContext, KoaRouterApp, Middleware, NextFunction, RequestWithGetBody, RouteHandler };

package/dist/types/koa.mjs

@@ -0,0 +1 @@
+export {  };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clear-router",
-  "version": "2.4.0",
-  "description": "Laravel-style routing for Node.js with support for Express, H3, Fastify, and Hono, including CommonJS, ESM, and TypeScript support.",
+  "version": "2.5.0",
+  "description": "Laravel-style routing for Node.js with support for Express, H3, Fastify, Hono, and Koa, including CommonJS, ESM, and TypeScript support.",
   "keywords": [
     "h3",
     "srvx",
@@ -56,11 +56,16 @@
       "import": "./dist/hono/index.mjs",
       "require": "./dist/hono/index.cjs"
     },
+    "./koa": {
+      "import": "./dist/koa/index.mjs",
+      "require": "./dist/koa/index.cjs"
+    },
     "./types/basic": "./dist/types/basic.mjs",
     "./types/express": "./dist/types/express.mjs",
     "./types/fastify": "./dist/types/fastify.mjs",
     "./types/h3": "./dist/types/h3.mjs",
     "./types/hono": "./dist/types/hono.mjs",
+    "./types/koa": "./dist/types/koa.mjs",
     "./package.json": "./package.json"
   },
   "files": [
@@ -69,12 +74,17 @@
     "LICENSE"
   ],
   "peerDependencies": {
+    "@koa/router": "^15.0.0",
     "express": "^5.1.0",
     "fastify": "^5.0.0",
     "h3": "^2.0.1-rc.16",
-    "hono": "^4.0.0"
+    "hono": "^4.0.0",
+    "koa": "^3.0.0"
   },
   "peerDependenciesMeta": {
+    "@koa/router": {
+      "optional": true
+    },
     "express": {
       "optional": true
     },
@@ -86,19 +96,25 @@
     },
     "hono": {
       "optional": true
+    },
+    "koa": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@eslint/markdown": "^7.5.1",
+    "@koa/router": "^15.5.0",
     "@types/express": "^4.17.21",
+    "@types/koa": "^3.0.2",
+    "@types/koa__router": "^12.0.5",
     "@types/node": "^20.10.6",
-    "@types/supertest": "^6.0.3",
     "@vitest/coverage-v8": "4.0.18",
     "eslint": "^10.0.2",
     "fastify": "^5.8.2",
     "hono": "^4.12.8",
-    "supertest": "^7.1.1",
+    "koa": "^3.2.0",
+    "parasito": "^0.1.6",
     "tsdown": "^0.20.3",
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",