clear-router 2.8.3 → 2.8.4

package/dist/ClearRequest.d.cts

@@ -1,13 +1,13 @@
-import { Middleware } from "./types/h3.cjs";
-import { Route } from "./Route.cjs";
-import { RequestData } from "./types/basic.cjs";
-import { Middleware as Middleware$1 } from "./types/express.cjs";
-import { Middleware as Middleware$2 } from "./types/fastify.cjs";
+import { Middleware } from "./types/express.cjs";
+import { Middleware as Middleware$1 } from "./types/fastify.cjs";
+import { Middleware as Middleware$2 } from "./types/h3.cjs";
 import { Middleware as Middleware$3 } from "./types/hono.cjs";
 import { Middleware as Middleware$4 } from "./types/koa.cjs";
+import { Route } from "./Route.cjs";
+import { RequestData } from "./types/basic.cjs";
 
 //#region src/ClearRequest.d.ts
-declare class ClearRequest<X = any, M = Middleware | Middleware$1 | Middleware$2 | Middleware$3 | Middleware$4> {
+declare class ClearRequest<X = any, M = Middleware$2 | Middleware | Middleware$1 | Middleware$3 | Middleware$4> {
   [key: string]: any;
   /**
    * @param body - Parsed request body

package/dist/Controller.d.cts

@@ -1,5 +1,5 @@
-import { RequestData } from "./types/basic.cjs";
 import { ClearRequest } from "./ClearRequest.cjs";
+import { RequestData } from "./types/basic.cjs";
 
 //#region src/Controller.d.ts
 declare abstract class Controller<X = any> {

package/dist/ResourceRouteSelection.d.cts

@@ -1,9 +1,9 @@
-import { Middleware } from "./types/h3.cjs";
+import { Middleware } from "./types/express.cjs";
+import { Middleware as Middleware$1 } from "./types/h3.cjs";
 import { Route } from "./Route.cjs";
-import { Middleware as Middleware$1 } from "./types/express.cjs";
 
 //#region src/ResourceRouteSelection.d.ts
-declare class ResourceRouteSelection<X = any, M = Middleware | Middleware$1, H = any> {
+declare class ResourceRouteSelection<X = any, M = Middleware$1 | Middleware, H = any> {
   readonly routes: Array<Route<X, M, H>>;
   constructor(routes: Array<Route<X, M, H>>);
   /**

package/dist/ResourceRoutes.d.cts

@@ -1,7 +1,7 @@
-import { Middleware } from "./types/h3.cjs";
+import { Middleware } from "./types/express.cjs";
+import { Middleware as Middleware$1 } from "./types/h3.cjs";
 import { Route } from "./Route.cjs";
 import { ApiResourceMiddleware, HttpMethod, ResourceAction, ResourceRouteDefinition, ResourceRouteRegistrar, ResourceRouteRemover, ResourceRoutesOptions } from "./types/basic.cjs";
-import { Middleware as Middleware$1 } from "./types/express.cjs";
 import { ResourceRouteSelection } from "./ResourceRouteSelection.cjs";
 
 //#region src/ResourceRoutes.d.ts
@@ -11,7 +11,7 @@ import { ResourceRouteSelection } from "./ResourceRouteSelection.cjs";
  * @author 3m1n3nc3
  * @repository https://github.com/arkstack-tmp/clear-router
  */
-declare class ResourceRoutes<X = any, M = Middleware | Middleware$1, H = any> {
+declare class ResourceRoutes<X = any, M = Middleware$1 | Middleware, H = any> {
   readonly basePath: string;
   readonly controller: any;
   readonly paramName: string;

package/dist/Route.d.cts

@@ -1,8 +1,8 @@
 import { RouteParameter } from "./Contracts.cjs";
-import { Middleware } from "./types/h3.cjs";
-import { HttpMethod, RequestData } from "./types/basic.cjs";
-import { Middleware as Middleware$1 } from "./types/express.cjs";
+import { Middleware } from "./types/express.cjs";
+import { Middleware as Middleware$1 } from "./types/h3.cjs";
 import { ClearRequest } from "./ClearRequest.cjs";
+import { HttpMethod, RequestData } from "./types/basic.cjs";
 
 //#region src/Route.d.ts
 /**
@@ -11,7 +11,7 @@ import { ClearRequest } from "./ClearRequest.cjs";
  * @author 3m1n3nc3
  * @repository https://github.com/arkstack-tmp/clear-router
  */
-declare class Route<X = any, M = Middleware | Middleware$1, H = any> {
+declare class Route<X = any, M = Middleware$1 | Middleware, H = any> {
   ctx: X;
   body: RequestData;
   query: RequestData;

package/dist/RouteGroup.cjs

@@ -11,8 +11,10 @@ let node_fs_promises = require("node:fs/promises");
 */
 var RouteGroup = class {
 	checks = [];
+	conditions = [];
 	registration;
 	routes = /* @__PURE__ */ new Set();
+	unfilteredSources = /* @__PURE__ */ new Set();
 	constructor(options) {
 		this.options = options;
 		this.registration = this.register();
@@ -24,8 +26,13 @@ var RouteGroup = class {
 	* @returns 
 	*/
 	when(condition) {
-		this.checks.push(this.registration.then(async () => {
-			if (!await condition(this.options.source)) this.rollback();
+		this.conditions.push(condition);
+		const unfilteredSources = Array.from(this.unfilteredSources);
+		if (unfilteredSources.length) this.checks.push(this.registration.then(async () => {
+			for (const source of unfilteredSources) if (!await condition(source)) {
+				this.rollback();
+				break;
+			}
 		}));
 		return this;
 	}
@@ -67,20 +74,37 @@ var RouteGroup = class {
 		await this.options.context.run(nextContext, async () => {
 			for (const entry of Array.isArray(this.options.source) ? this.options.source : [this.options.source]) {
 				if (typeof entry === "function") {
+					if (!this.conditions.length) this.unfilteredSources.add(entry);
+					else if (!await this.accepts(entry)) continue;
 					await Promise.resolve(entry());
 					continue;
 				}
-				for (const file of await this.resolveFiles(entry)) await require_helpers.importFile(file);
+				const resolved = await this.resolveFiles(entry);
+				if (!resolved.directory && !await this.accepts(entry)) continue;
+				for (const file of resolved.files) {
+					if (resolved.directory && !await this.accepts(file)) continue;
+					await require_helpers.importFile(file);
+				}
 			}
 		});
 	}
 	/**
-	* Rollback the route registrations
+	* Rollback the route registration
 	*/
 	rollback() {
 		for (const route of this.routes) this.options.removeRoute(route);
 	}
 	/**
+	* Check whether a callback or path should be registered.
+	* 
+	* @param source 
+	* @returns 
+	*/
+	async accepts(source) {
+		for (const condition of this.conditions) if (!await condition(source)) return false;
+		return true;
+	}
+	/**
 	* Resolve files from the group path
 	* 
 	* @param source 
@@ -94,9 +118,15 @@ var RouteGroup = class {
 		} catch {
 			throw new Error(`Route group source not found: ${source}`);
 		}
-		if (sourceStat.isFile()) return [resolved];
+		if (sourceStat.isFile()) return {
+			directory: false,
+			files: [resolved]
+		};
 		if (!sourceStat.isDirectory()) throw new Error(`Route group source must be a file or directory: ${source}`);
-		return this.readDirectory(resolved);
+		return {
+			directory: true,
+			files: await this.readDirectory(resolved)
+		};
 	}
 	/**
 	* Read all the files in the configured directory

package/dist/RouteGroup.d.cts

@@ -1,6 +1,6 @@
-import { Middleware } from "./types/h3.cjs";
+import { Middleware } from "./types/express.cjs";
+import { Middleware as Middleware$1 } from "./types/h3.cjs";
 import { RouteGroupCondition, RouteGroupOptions } from "./types/basic.cjs";
-import { Middleware as Middleware$1 } from "./types/express.cjs";
 
 //#region src/RouteGroup.d.ts
 /**
@@ -9,11 +9,13 @@ import { Middleware as Middleware$1 } from "./types/express.cjs";
  * @author 3m1n3nc3
  * @repository https://github.com/arkstack-tmp/clear-router
  */
-declare class RouteGroup<X = any, M = Middleware | Middleware$1, H = any> implements PromiseLike<void> {
+declare class RouteGroup<X = any, M = Middleware$1 | Middleware, H = any> implements PromiseLike<void> {
   private readonly options;
   private readonly checks;
+  private readonly conditions;
   private readonly registration;
   private readonly routes;
+  private readonly unfilteredSources;
   constructor(options: RouteGroupOptions);
   /**
    * Returning a falsy value will stop route group registration
@@ -42,9 +44,16 @@ declare class RouteGroup<X = any, M = Middleware | Middleware$1, H = any> implem
    */
   private register;
   /**
-   * Rollback the route registrations
-   */
+  * Rollback the route registration
+  */
   private rollback;
+  /**
+   * Check whether a callback or path should be registered.
+   *
+   * @param source
+   * @returns
+   */
+  private accepts;
   /**
    * Resolve files from the group path
    *

package/dist/RouteGroup.d.mts

@@ -12,8 +12,10 @@ import { RouteGroupCondition, RouteGroupOptions } from "./types/basic.mjs";
 declare class RouteGroup<X = any, M = Middleware$1 | Middleware, H = any> implements PromiseLike<void> {
   private readonly options;
   private readonly checks;
+  private readonly conditions;
   private readonly registration;
   private readonly routes;
+  private readonly unfilteredSources;
   constructor(options: RouteGroupOptions);
   /**
    * Returning a falsy value will stop route group registration
@@ -42,9 +44,16 @@ declare class RouteGroup<X = any, M = Middleware$1 | Middleware, H = any> implem
    */
   private register;
   /**
-   * Rollback the route registrations
-   */
+  * Rollback the route registration
+  */
   private rollback;
+  /**
+   * Check whether a callback or path should be registered.
+   *
+   * @param source
+   * @returns
+   */
+  private accepts;
   /**
    * Resolve files from the group path
    *

package/dist/RouteGroup.mjs

@@ -11,8 +11,10 @@ import { readdir, stat } from "node:fs/promises";
 */
 var RouteGroup = class {
 	checks = [];
+	conditions = [];
 	registration;
 	routes = /* @__PURE__ */ new Set();
+	unfilteredSources = /* @__PURE__ */ new Set();
 	constructor(options) {
 		this.options = options;
 		this.registration = this.register();
@@ -24,8 +26,13 @@ var RouteGroup = class {
 	* @returns 
 	*/
 	when(condition) {
-		this.checks.push(this.registration.then(async () => {
-			if (!await condition(this.options.source)) this.rollback();
+		this.conditions.push(condition);
+		const unfilteredSources = Array.from(this.unfilteredSources);
+		if (unfilteredSources.length) this.checks.push(this.registration.then(async () => {
+			for (const source of unfilteredSources) if (!await condition(source)) {
+				this.rollback();
+				break;
+			}
 		}));
 		return this;
 	}
@@ -67,20 +74,37 @@ var RouteGroup = class {
 		await this.options.context.run(nextContext, async () => {
 			for (const entry of Array.isArray(this.options.source) ? this.options.source : [this.options.source]) {
 				if (typeof entry === "function") {
+					if (!this.conditions.length) this.unfilteredSources.add(entry);
+					else if (!await this.accepts(entry)) continue;
 					await Promise.resolve(entry());
 					continue;
 				}
-				for (const file of await this.resolveFiles(entry)) await importFile(file);
+				const resolved = await this.resolveFiles(entry);
+				if (!resolved.directory && !await this.accepts(entry)) continue;
+				for (const file of resolved.files) {
+					if (resolved.directory && !await this.accepts(file)) continue;
+					await importFile(file);
+				}
 			}
 		});
 	}
 	/**
-	* Rollback the route registrations
+	* Rollback the route registration
 	*/
 	rollback() {
 		for (const route of this.routes) this.options.removeRoute(route);
 	}
 	/**
+	* Check whether a callback or path should be registered.
+	* 
+	* @param source 
+	* @returns 
+	*/
+	async accepts(source) {
+		for (const condition of this.conditions) if (!await condition(source)) return false;
+		return true;
+	}
+	/**
 	* Resolve files from the group path
 	* 
 	* @param source 
@@ -94,9 +118,15 @@ var RouteGroup = class {
 		} catch {
 			throw new Error(`Route group source not found: ${source}`);
 		}
-		if (sourceStat.isFile()) return [resolved];
+		if (sourceStat.isFile()) return {
+			directory: false,
+			files: [resolved]
+		};
 		if (!sourceStat.isDirectory()) throw new Error(`Route group source must be a file or directory: ${source}`);
-		return this.readDirectory(resolved);
+		return {
+			directory: true,
+			files: await this.readDirectory(resolved)
+		};
 	}
 	/**
 	* Read all the files in the configured directory

package/dist/core/CoreRouter.d.cts

@@ -1,11 +1,11 @@
-import { Request } from "./Request.cjs";
 import { Response } from "./Response.cjs";
 import { Route } from "../Route.cjs";
 import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupContext, RouteGroupSource, RouterConfig } from "../types/basic.cjs";
-import { Controller } from "../Controller.cjs";
-import { RouteGroup } from "../RouteGroup.cjs";
+import { Request } from "./Request.cjs";
 import { ClearRouterPluginArgumentsContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind } from "./plugins.cjs";
+import { Controller } from "../Controller.cjs";
 import { ResourceRoutes } from "../ResourceRoutes.cjs";
+import { RouteGroup } from "../RouteGroup.cjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/core/CoreRouter.d.ts

package/dist/core/Request.d.cts

@@ -1,6 +1,6 @@
+import { ClearRequest } from "../ClearRequest.cjs";
 import { Route } from "../Route.cjs";
 import { HttpMethod, RequestData } from "../types/basic.cjs";
-import { ClearRequest } from "../ClearRequest.cjs";
 
 //#region src/core/Request.d.ts
 declare class Request<X = any, M = any> extends ClearRequest<X, M> {

package/dist/core/bindings.d.cts

@@ -2,6 +2,10 @@
 type BindToken<T = any> = abstract new (...args: any[]) => T;
 type BindFactory<T = any> = (ctx: any) => T | Promise<T>;
 type BindValue<T = any> = T | BindFactory<T> | BindToken<T>;
+type BindDecorator = MethodDecorator & ClassDecorator & {
+  <This, Value extends (this: This, ...args: any[]) => any>(value: Value, context: ClassMethodDecoratorContext<This, Value>): void | Value;
+  <Value extends abstract new (...args: any[]) => any>(value: Value, context: ClassDecoratorContext<Value>): void | Value;
+};
 declare class Container {
   private static readonly registry;
   static bind<T>(token: BindToken<T>, value: BindValue<T>): void;
@@ -16,5 +20,6 @@ declare class Container {
   private static staticPropsMatch;
   private static resolveBinding;
 }
+declare function Bind(...tokens: BindToken[]): BindDecorator;
 //#endregion
-export { BindToken, BindValue, Container };
+export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container };

package/dist/core/plugins.d.cts

@@ -1,6 +1,6 @@
-import { Request } from "./Request.cjs";
 import { Response } from "./Response.cjs";
 import { RouterConfig } from "../types/basic.cjs";
+import { Request } from "./Request.cjs";
 import { BindToken, BindValue, Container } from "./bindings.cjs";
 
 //#region src/core/plugins.d.ts

package/dist/types/basic.d.cts

@@ -3,6 +3,10 @@ import { JitiOptions, JitiResolveOptions } from "jiti";
 import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/types/basic.d.ts
+/**
+ * Controller method reference
+ */
+type ControllerHandler = [any, string];
 type MaybePromise<T = any> = T | Promise<T>;
 type RouteGroupCallback = () => MaybePromise<any>;
 type RouteGroupEntry = RouteGroupCallback | string;
@@ -84,7 +88,7 @@ interface RouteGroupOptions {
   normalizePath: (path: string) => string;
   removeRoute: (route: Route<any, any, any>) => void;
 }
-type RouteGroupCondition = (source: RouteGroupSource) => MaybePromise<unknown>;
+type RouteGroupCondition = (source: RouteGroupEntry) => MaybePromise<unknown>;
 interface FileImporter {
   <T = unknown>(filePath: string): Promise<T>;
   <T = unknown>(filePath: string, userOptions?: JitiOptions | undefined): Promise<T>;
@@ -93,4 +97,4 @@ interface FileImporter {
   })): Promise<T>;
 }
 //#endregion
-export { ApiResourceMiddleware, ClassMiddleware, FileImporter, HttpMethod, MiddlewareHandle, RequestData, ResourceAction, ResourceRouteDefinition, ResourceRouteRegistrar, ResourceRouteRemover, ResourceRoutesOptions, RouteGroupCondition, RouteGroupContext, RouteGroupOptions, RouteGroupSource, RouterConfig };
+export { ApiResourceMiddleware, ClassMiddleware, ControllerHandler, FileImporter, HttpMethod, MiddlewareHandle, RequestData, ResourceAction, ResourceRouteDefinition, ResourceRouteRegistrar, ResourceRouteRemover, ResourceRoutesOptions, RouteGroupCondition, RouteGroupContext, RouteGroupOptions, RouteGroupSource, RouterConfig };

package/dist/types/basic.d.mts

@@ -88,7 +88,7 @@ interface RouteGroupOptions {
   normalizePath: (path: string) => string;
   removeRoute: (route: Route<any, any, any>) => void;
 }
-type RouteGroupCondition = (source: RouteGroupSource) => MaybePromise<unknown>;
+type RouteGroupCondition = (source: RouteGroupEntry) => MaybePromise<unknown>;
 interface FileImporter {
   <T = unknown>(filePath: string): Promise<T>;
   <T = unknown>(filePath: string, userOptions?: JitiOptions | undefined): Promise<T>;

package/dist/types/express.d.cts

@@ -1,7 +1,41 @@
-import { ClassMiddleware, MiddlewareHandle } from "./basic.cjs";
+import { ClearHttpContext } from "../Contracts.cjs";
+import { Response as Response$1 } from "../core/Response.cjs";
+import { ClassMiddleware, ControllerHandler, MiddlewareHandle } from "./basic.cjs";
+import { Request as Request$1 } from "../core/Request.cjs";
 import { NextFunction, Request, Response } from "express";
 
 //#region src/types/express.d.ts
+interface RequestWithGetBody extends Request {
+  getBody: () => Record<string, any>;
+}
+/**
+ * HTTP context passed to route handlers
+ */
+interface HttpContext extends ClearHttpContext {
+  req: RequestWithGetBody;
+  res: Response;
+  next: NextFunction;
+  clearRequest: Request$1;
+  clearResponse: Response$1;
+}
+/**
+ * Route handler function type
+ */
+type RouteHandler = (
+/**
+ * Express context object containing req, res, and next
+ */
+
+ctx: HttpContext,
+/**
+ * ClearRequest instance
+ */
+
+req: Request$1) => any | Promise<any>;
+/**
+ * Handler can be either a function or controller reference
+ */
+type Handler = RouteHandler | ControllerHandler;
 /**
  * Middleware function type
  */
@@ -11,4 +45,4 @@ type MiddlewareFunction = MiddlewareHandle<[Request, Response, NextFunction]>;
  */
 type Middleware = MiddlewareFunction | ClassMiddleware<MiddlewareFunction>;
 //#endregion
-export { Middleware };
+export { Handler, HttpContext, Middleware };

package/dist/types/fastify.d.cts

@@ -1,12 +1,24 @@
-import { ClassMiddleware, MiddlewareHandle } from "./basic.cjs";
-import { FastifyReply, FastifyRequest } from "fastify";
+import { ClearHttpContext } from "../Contracts.cjs";
+import { Response } from "../core/Response.cjs";
+import { ClassMiddleware, ControllerHandler, MiddlewareHandle } from "./basic.cjs";
+import { Request } from "../core/Request.cjs";
+import { FastifyInstance, FastifyReply, FastifyRequest } from "fastify";
 
 //#region src/types/fastify.d.ts
 interface RequestWithGetBody extends FastifyRequest {
   getBody: () => Record<string, any>;
 }
+interface HttpContext extends ClearHttpContext {
+  req: RequestWithGetBody;
+  reply: FastifyReply;
+  clearRequest: Request;
+  clearResponse: Response;
+}
+type RouteHandler = (ctx: HttpContext, req: Request) => any | Promise<any>;
+type Handler = RouteHandler | ControllerHandler;
 type NextFunction = (err?: Error) => void;
 type MiddlewareFunction = MiddlewareHandle<[req: RequestWithGetBody, reply: FastifyReply, next: NextFunction]>;
 type Middleware = MiddlewareFunction | ClassMiddleware<MiddlewareFunction>;
+type FastifyApp = FastifyInstance;
 //#endregion
-export { Middleware };
+export { FastifyApp, Handler, HttpContext, Middleware };

package/dist/types/h3.d.cts

@@ -1,11 +1,46 @@
-import { ClassMiddleware } from "./basic.cjs";
-import { Middleware } from "h3";
+import { ClearHttpContext } from "../Contracts.cjs";
+import { Response as Response$1 } from "../core/Response.cjs";
+import { ClassMiddleware, ControllerHandler } from "./basic.cjs";
+import { Request } from "../core/Request.cjs";
+import { EventHandlerRequest, H3, H3Event, Middleware, TypedServerRequest } from "h3";
 
 //#region src/types/h3.d.ts
+type H3App = Omit<H3, 'fetch'> & {
+  fetch: (request: TypedServerRequest<EventHandlerRequest>) => Promise<Response>;
+};
+interface HttpRequest extends TypedServerRequest<EventHandlerRequest> {
+  getBody: () => Record<string, any>;
+}
+/**
+ * HTTP context passed to route handlers
+ */
+interface HttpContext extends Omit<H3Event, 'req'>, ClearHttpContext {
+  req: HttpRequest;
+  clearRequest: Request;
+  clearResponse: Response$1;
+}
+/**
+ * Route handler function type
+ */
+type RouteHandler = (
+/**
+ * H3 event context
+ */
+
+ctx: HttpContext,
+/**
+ * ClearRequest instance
+ */
+
+req: Request) => any | Promise<any>;
+/**
+ * Handler can be either a function or controller reference
+ */
+type Handler = RouteHandler | ControllerHandler;
 /**
  * Middleware function type
  */
 type MiddlewareFunction = Middleware;
 type Middleware$1 = MiddlewareFunction | ClassMiddleware<MiddlewareFunction>;
 //#endregion
-export { Middleware$1 as Middleware };
+export { H3App, Handler, HttpContext, Middleware$1 as Middleware };

package/dist/types/hono.d.cts

@@ -1,8 +1,22 @@
-import { ClassMiddleware } from "./basic.cjs";
-import { MiddlewareHandler } from "hono";
+import { ClearHttpContext } from "../Contracts.cjs";
+import { Response } from "../core/Response.cjs";
+import { ClassMiddleware, ControllerHandler } from "./basic.cjs";
+import { Request } from "../core/Request.cjs";
+import { Context, HonoRequest, MiddlewareHandler } from "hono";
 
 //#region src/types/hono.d.ts
+type RequestWithGetBody = HonoRequest & {
+  getBody: () => Record<string, any>;
+};
+interface HttpContext extends Context, ClearHttpContext {
+  req: RequestWithGetBody;
+  clearRequest: Request;
+  clearResponse: Response;
+}
+type RouteHandler = (ctx: HttpContext, req: Request) => any | Promise<any>;
+type Handler = RouteHandler | ControllerHandler;
 type MiddlewareFunction = MiddlewareHandler;
 type Middleware = MiddlewareFunction | ClassMiddleware<MiddlewareFunction>;
+type HonoApp = { [K in 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head']: (path: string, ...handlers: MiddlewareFunction[]) => any };
 //#endregion
-export { Middleware };
+export { Handler, HonoApp, HttpContext, Middleware };

package/dist/types/koa.d.cts

@@ -1,8 +1,26 @@
-import { ClassMiddleware } from "./basic.cjs";
+import { ClearHttpContext } from "../Contracts.cjs";
+import { Response } from "../core/Response.cjs";
+import { ClassMiddleware, ControllerHandler } from "./basic.cjs";
+import { Request } from "../core/Request.cjs";
 import Koa from "koa";
+import Router from "@koa/router";
 
 //#region src/types/koa.d.ts
+interface RequestWithGetBody extends Koa.Request {
+  getBody: () => Record<string, any>;
+  body?: any;
+}
+interface HttpContext extends Koa.Context, ClearHttpContext {
+  request: RequestWithGetBody;
+  clearRequest: Request;
+  clearResponse: Response;
+  params: Record<string, any>;
+  query: Record<string, any>;
+}
+type RouteHandler = (ctx: HttpContext, req: Request) => any | Promise<any>;
+type Handler = RouteHandler | ControllerHandler;
 type MiddlewareFunction = Koa.Middleware<any, any>;
 type Middleware = MiddlewareFunction | ClassMiddleware<MiddlewareFunction>;
+type KoaRouterApp = Router<any, any>;
 //#endregion
-export { Middleware };
+export { Handler, HttpContext, KoaRouterApp, Middleware };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-router",
-  "version": "2.8.3",
+  "version": "2.8.4",
   "description": "Laravel-style routing for Node.js with support for Express, H3, Fastify, Hono, and Koa, including CommonJS, ESM, and TypeScript support.",
   "keywords": [
     "h3",