clear-router 2.8.3 → 2.8.5

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";
 
 //#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/ClearRequest.d.mts

@@ -1,10 +1,10 @@
+import { RequestData } from "./types/basic.mjs";
 import { Middleware } from "./types/express.mjs";
 import { Middleware as Middleware$1 } from "./types/fastify.mjs";
 import { Middleware as Middleware$2 } from "./types/h3.mjs";
 import { Middleware as Middleware$3 } from "./types/hono.mjs";
 import { Middleware as Middleware$4 } from "./types/koa.mjs";
 import { Route } from "./Route.mjs";
-import { RequestData } from "./types/basic.mjs";
 
 //#region src/ClearRequest.d.ts
 declare class ClearRequest<X = any, M = Middleware$2 | Middleware | Middleware$1 | Middleware$3 | Middleware$4> {

package/dist/Controller.d.mts

@@ -1,5 +1,5 @@
-import { ClearRequest } from "./ClearRequest.mjs";
 import { RequestData } from "./types/basic.mjs";
+import { ClearRequest } from "./ClearRequest.mjs";
 
 //#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.cjs

@@ -1,5 +1,5 @@
-const require_ResourceRouteSelection = require('./ResourceRouteSelection.cjs');
 const require_helpers = require('./core/helpers.cjs');
+const require_ResourceRouteSelection = require('./ResourceRouteSelection.cjs');
 require('./core/index.cjs');
 
 //#region src/ResourceRoutes.ts

package/dist/ResourceRoutes.d.cts

@@ -1,7 +1,7 @@
-import { Middleware } 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 { Middleware } from "./types/express.cjs";
+import { Middleware as Middleware$1 } from "./types/h3.cjs";
+import { Route } from "./Route.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/ResourceRoutes.d.mts

@@ -1,7 +1,7 @@
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, ResourceRouteDefinition, ResourceRouteRegistrar, ResourceRouteRemover, ResourceRoutesOptions } from "./types/basic.mjs";
 import { Middleware } from "./types/express.mjs";
 import { Middleware as Middleware$1 } from "./types/h3.mjs";
 import { Route } from "./Route.mjs";
-import { ApiResourceMiddleware, HttpMethod, ResourceAction, ResourceRouteDefinition, ResourceRouteRegistrar, ResourceRouteRemover, ResourceRoutesOptions } from "./types/basic.mjs";
 import { ResourceRouteSelection } from "./ResourceRouteSelection.mjs";
 
 //#region src/ResourceRoutes.d.ts

package/dist/ResourceRoutes.mjs

@@ -1,5 +1,5 @@
-import { ResourceRouteSelection } from "./ResourceRouteSelection.mjs";
 import { wrap } from "./core/helpers.mjs";
+import { ResourceRouteSelection } from "./ResourceRouteSelection.mjs";
 import "./core/index.mjs";
 
 //#region src/ResourceRoutes.ts

package/dist/Route.d.cts

@@ -1,7 +1,7 @@
-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 { RouteParameter } from "./Contracts.cjs";
+import { Middleware } from "./types/express.cjs";
+import { Middleware as Middleware$1 } from "./types/h3.cjs";
 import { ClearRequest } from "./ClearRequest.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/Route.d.mts

@@ -1,8 +1,8 @@
+import { HttpMethod, RequestData } from "./types/basic.mjs";
 import { RouteParameter } from "./Contracts.mjs";
 import { Middleware } from "./types/express.mjs";
 import { Middleware as Middleware$1 } from "./types/h3.mjs";
 import { ClearRequest } from "./ClearRequest.mjs";
-import { HttpMethod, RequestData } from "./types/basic.mjs";
 
 //#region src/Route.d.ts
 /**

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 { RouteGroupCondition, RouteGroupOptions } 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";
 
 //#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

@@ -1,6 +1,6 @@
+import { RouteGroupCondition, RouteGroupOptions } from "./types/basic.mjs";
 import { Middleware } from "./types/express.mjs";
 import { Middleware as Middleware$1 } from "./types/h3.mjs";
-import { RouteGroupCondition, RouteGroupOptions } from "./types/basic.mjs";
 
 //#region src/RouteGroup.d.ts
 /**
@@ -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.cjs

@@ -1,9 +1,9 @@
+const require_Route = require('../Route.cjs');
+const require_RouteGroup = require('../RouteGroup.cjs');
 const require_Request = require('./Request.cjs');
 const require_Response = require('./Response.cjs');
 const require_bindings = require('./bindings.cjs');
 const require_ResourceRoutes = require('../ResourceRoutes.cjs');
-const require_Route = require('../Route.cjs');
-const require_RouteGroup = require('../RouteGroup.cjs');
 let node_async_hooks = require("node:async_hooks");
 let node_module = require("node:module");
 

package/dist/core/CoreRouter.d.cts

@@ -1,11 +1,11 @@
-import { Request } from "./Request.cjs";
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupContext, RouteGroupSource, RouterConfig } from "../types/basic.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/CoreRouter.d.mts

@@ -1,6 +1,6 @@
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupContext, RouteGroupSource, RouterConfig } from "../types/basic.mjs";
 import { Response } from "./Response.mjs";
 import { Route } from "../Route.mjs";
-import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupContext, RouteGroupSource, RouterConfig } from "../types/basic.mjs";
 import { Request } from "./Request.mjs";
 import { ClearRouterPluginArgumentsContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, PluginArgumentsResolver, PluginBind } from "./plugins.mjs";
 import { Controller } from "../Controller.mjs";

package/dist/core/CoreRouter.mjs

@@ -1,9 +1,9 @@
+import { Route } from "../Route.mjs";
+import { RouteGroup } from "../RouteGroup.mjs";
 import { Request } from "./Request.mjs";
 import { Response } from "./Response.mjs";
 import { Container, getBindingMetadataFromTargets, getDesignParamTypes, getStandardMetadata, isClass } from "./bindings.mjs";
 import { ResourceRoutes } from "../ResourceRoutes.mjs";
-import { Route } from "../Route.mjs";
-import { RouteGroup } from "../RouteGroup.mjs";
 import { createRequire } from "node:module";
 import { AsyncLocalStorage } from "node:async_hooks";
 

package/dist/core/Request.d.cts

@@ -1,5 +1,5 @@
-import { Route } from "../Route.cjs";
 import { HttpMethod, RequestData } from "../types/basic.cjs";
+import { Route } from "../Route.cjs";
 import { ClearRequest } from "../ClearRequest.cjs";
 
 //#region src/core/Request.d.ts

package/dist/core/Request.d.mts

@@ -1,6 +1,6 @@
-import { ClearRequest } from "../ClearRequest.mjs";
-import { Route } from "../Route.mjs";
 import { HttpMethod, RequestData } from "../types/basic.mjs";
+import { Route } from "../Route.mjs";
+import { ClearRequest } from "../ClearRequest.mjs";
 
 //#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/helpers.d.cts

@@ -1,4 +1,4 @@
-import { FileImporter } from "../types/basic.cjs";
+import { FileImporter } from "src/types";
 
 //#region src/core/helpers.d.ts
 declare const wrap: <T>(value: T | T[] | null | undefined) => T[];

package/dist/core/helpers.d.mts

@@ -1,4 +1,4 @@
-import { FileImporter } from "../types/basic.mjs";
+import { FileImporter } from "src/types";
 
 //#region src/core/helpers.d.ts
 declare const wrap: <T>(value: T | T[] | null | undefined) => T[];

package/dist/core/index.cjs

@@ -1,6 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_helpers = require('./helpers.cjs');
 const require_RouteGroup = require('../RouteGroup.cjs');
 const require_Request = require('./Request.cjs');
 const require_Response = require('./Response.cjs');
 const require_plugins = require('./plugins.cjs');
 const require_CoreRouter = require('./CoreRouter.cjs');
+
+exports.CoreRouter = require_CoreRouter.CoreRouter;
+exports.Request = require_Request.Request;
+exports.Response = require_Response.Response;
+exports.RouteGroup = require_RouteGroup.RouteGroup;
+exports.definePlugin = require_plugins.definePlugin;
+exports.importFile = require_helpers.importFile;
+exports.wrap = require_helpers.wrap;

package/dist/core/index.mjs

@@ -1,8 +1,8 @@
+import { importFile, wrap } from "./helpers.mjs";
+import { RouteGroup } from "../RouteGroup.mjs";
 import { Request } from "./Request.mjs";
 import { Response } from "./Response.mjs";
 import { definePlugin } from "./plugins.mjs";
-import { importFile, wrap } from "./helpers.mjs";
-import { RouteGroup } from "../RouteGroup.mjs";
 import { CoreRouter } from "./CoreRouter.mjs";
 
 export { CoreRouter, Request, Response, RouteGroup, definePlugin, importFile, wrap };

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 { Response } from "./Response.cjs";
+import { Request } from "./Request.cjs";
 import { BindToken, BindValue, Container } from "./bindings.cjs";
 
 //#region src/core/plugins.d.ts

package/dist/core/plugins.d.mts

@@ -1,5 +1,5 @@
-import { Response } from "./Response.mjs";
 import { RouterConfig } from "../types/basic.mjs";
+import { Response } from "./Response.mjs";
 import { Request } from "./Request.mjs";
 import { BindToken, BindValue, Container } from "./bindings.mjs";
 

package/dist/decorators/setup.d.mts

@@ -1,2 +1,3 @@
 import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.mjs";
+import "reflect-metadata";
 export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container };

package/dist/express/router.d.cts

@@ -1,6 +1,6 @@
+import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.cjs";
 import { Handler, HttpContext, Middleware } from "../types/express.cjs";
 import { Route } from "../Route.cjs";
-import { ApiResourceMiddleware, HttpMethod, ResourceAction, RouteGroupSource } from "../types/basic.cjs";
 import { ResourceRoutes } from "../ResourceRoutes.cjs";
 import { RouteGroup } from "../RouteGroup.cjs";
 import { CoreRouter } from "../core/CoreRouter.cjs";
@@ -26,7 +26,7 @@ declare class Router$1 extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
+  static add<T = any>(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler<T>>;
   /**
    * Define a resourceful API controller with standard CRUD routes
    *
@@ -46,7 +46,7 @@ declare class Router$1 extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
+  static get<T = any>(path: string, handler: Handler<T>, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler<T>>;
   /**
    * Adds a new POST route to the router.
    *
@@ -54,7 +54,7 @@ declare class Router$1 extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
+  static post<T = any>(path: string, handler: Handler<T>, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler<T>>;
   /**
    * Adds a new PUT route to the router.
    *
@@ -62,7 +62,7 @@ declare class Router$1 extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
+  static put<T = any>(path: string, handler: Handler<T>, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler<T>>;
   /**
    * Adds a new DELETE route to the router.
    *
@@ -70,7 +70,7 @@ declare class Router$1 extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
+  static delete<T = any>(path: string, handler: Handler<T>, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler<T>>;
   /**
    * Adds a new PATCH route to the router.
    *
@@ -78,7 +78,7 @@ declare class Router$1 extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
+  static patch<T = any>(path: string, handler: Handler<T>, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler<T>>;
   /**
    * Adds a new OPTIONS route to the router.
    *
@@ -86,7 +86,7 @@ declare class Router$1 extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
+  static options<T = any>(path: string, handler: Handler<T>, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler<T>>;
   /**
    * Adds a new HEAD route to the router.
    *
@@ -94,7 +94,7 @@ declare class Router$1 extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
+  static head<T = any>(path: string, handler: Handler<T>, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler<T>>;
   /**
    * Defines a group of routes with a common prefix.
    *
@@ -102,7 +102,7 @@ declare class Router$1 extends CoreRouter {
    * @param callback
    * @param middlewares
    */
-  static group(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): RouteGroup<HttpContext, Middleware, Handler>;
+  static group<T = any>(prefix: string, source: RouteGroupSource, middlewares?: Middleware[]): RouteGroup<HttpContext, Middleware, Handler<T>>;
   /**
    * Adds global middlewares to the router, which will be applied to all routes.
    *
@@ -115,11 +115,11 @@ declare class Router$1 extends CoreRouter {
    *
    * @param type
    */
-  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>> };
-  static allRoutes(type: 'name'): Record<string, Route<HttpContext, Middleware, Handler>>;
-  static route(name: string): Route<HttpContext, Middleware, Handler> | undefined;
+  static allRoutes<T = any>(): Array<Route<HttpContext, Middleware, Handler<T>>>;
+  static allRoutes<T = any>(type: 'path'): Record<string, Route<HttpContext, Middleware, Handler<T>>>;
+  static allRoutes<T = any>(type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware, Handler<T>>> };
+  static allRoutes<T = any>(type: 'name'): Record<string, Route<HttpContext, Middleware, Handler<T>>>;
+  static route<T = any>(name: string): Route<HttpContext, Middleware, Handler<T>> | undefined;
   /**
    * Applies the registered routes to the given Express router instance, setting up the necessary
    * handlers and middlewares for each route.