clear-router 2.5.13 → 2.5.14

package/README.md

@@ -50,6 +50,8 @@ yarn add clear-router express
 - 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, H3, and Koa
+- Laravel-style route parameters like `/books/{book}`, `/books/{book?}`, and `/books/{book:profile}`
+- Named routes with path generation via `Router.get(...).name(...)` and `Router.url(...)`
 - Optional decorated container binding for controller method arguments
 - Plugin API for registering container bindings from external packages
 - Supports TS 5.2+ standard decorators with explicit `@Bind(...)` tokens

package/dist/core/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_bindings = require('../bindings-CLsZjOEy.cjs');
-const require_router = require('../router-D9H9-T27.cjs');
+const require_router = require('../router-CAnd539U.cjs');
 
 //#region src/core/plugins.ts
 function definePlugin(plugin) {

package/dist/core/index.d.cts

@@ -1,2 +1,2 @@
-import { E as Response, a as ClearRouterPluginInput, c as PluginBind, d as PluginSetupResult, f as definePlugin, i as ClearRouterPluginContext, l as PluginBindFactory, n as ClearRouterPlugin, o as ClearRouterPluginRequestContext, p as Request, r as ClearRouterPluginArgumentsContext, s as PluginArgumentsResolver, t as CoreRouter, u as PluginBindValue } from "../router-DTI0BowV.cjs";
+import { E as Response, a as ClearRouterPluginInput, c as PluginBind, d as PluginSetupResult, f as definePlugin, i as ClearRouterPluginContext, l as PluginBindFactory, n as ClearRouterPlugin, o as ClearRouterPluginRequestContext, p as Request, r as ClearRouterPluginArgumentsContext, s as PluginArgumentsResolver, t as CoreRouter, u as PluginBindValue } from "../router-jwZwD8ZT.cjs";
 export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin };

package/dist/core/index.d.mts

@@ -1,2 +1,2 @@
-import { E as Response, a as ClearRouterPluginInput, c as PluginBind, d as PluginSetupResult, f as definePlugin, i as ClearRouterPluginContext, l as PluginBindFactory, n as ClearRouterPlugin, o as ClearRouterPluginRequestContext, p as Request, r as ClearRouterPluginArgumentsContext, s as PluginArgumentsResolver, t as CoreRouter, u as PluginBindValue } from "../router-DiKqUyvk.mjs";
+import { E as Response, a as ClearRouterPluginInput, c as PluginBind, d as PluginSetupResult, f as definePlugin, i as ClearRouterPluginContext, l as PluginBindFactory, n as ClearRouterPlugin, o as ClearRouterPluginRequestContext, p as Request, r as ClearRouterPluginArgumentsContext, s as PluginArgumentsResolver, t as CoreRouter, u as PluginBindValue } from "../router-Bk8mXRu1.mjs";
 export { ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response, definePlugin };

package/dist/core/index.mjs

@@ -1,5 +1,5 @@
 import { c as Request, s as Response } from "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-CPmZcbU0.mjs";
+import { t as CoreRouter } from "../router-DSq9dtuQ.mjs";
 
 //#region src/core/plugins.ts
 function definePlugin(plugin) {

package/dist/decorators/setup.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_bindings = require('../bindings-CLsZjOEy.cjs');
-const require_router = require('../router-D9H9-T27.cjs');
+const require_router = require('../router-CAnd539U.cjs');
 require('./index.cjs');
 require("reflect-metadata");
 

package/dist/decorators/setup.d.mts

@@ -1,3 +1,2 @@
 import { a as BindValue, i as BindToken, n as BindDecorator, o as Container, r as BindFactory, t as Bind } from "../bindings-CNL7bpz5.mjs";
-import "reflect-metadata";
 export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container };

package/dist/decorators/setup.mjs

@@ -1,5 +1,5 @@
 import { n as Container, t as Bind } from "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-CPmZcbU0.mjs";
+import { t as CoreRouter } from "../router-DSq9dtuQ.mjs";
 import "./index.mjs";
 import "reflect-metadata";
 

package/dist/express/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 require('../bindings-CLsZjOEy.cjs');
-const require_router = require('../router-D9H9-T27.cjs');
+const require_router = require('../router-CAnd539U.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 
 //#region src/express/router.ts
@@ -54,7 +54,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static add(methods, path, handler, middlewares) {
-		super.add(methods, path, handler, middlewares);
+		return super.add(methods, path, handler, middlewares);
 	}
 	/**
 	* Define a resourceful API controller with standard CRUD routes
@@ -74,7 +74,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static get(path, handler, middlewares) {
-		super.get(path, handler, middlewares);
+		return super.get(path, handler, middlewares);
 	}
 	/**
 	* Adds a new POST route to the router.
@@ -84,7 +84,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static post(path, handler, middlewares) {
-		super.post(path, handler, middlewares);
+		return super.post(path, handler, middlewares);
 	}
 	/**
 	* Adds a new PUT route to the router.
@@ -94,7 +94,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static put(path, handler, middlewares) {
-		super.put(path, handler, middlewares);
+		return super.put(path, handler, middlewares);
 	}
 	/**
 	* Adds a new DELETE route to the router.
@@ -104,7 +104,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static delete(path, handler, middlewares) {
-		super.delete(path, handler, middlewares);
+		return super.delete(path, handler, middlewares);
 	}
 	/**
 	* Adds a new PATCH route to the router.
@@ -114,7 +114,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static patch(path, handler, middlewares) {
-		super.patch(path, handler, middlewares);
+		return super.patch(path, handler, middlewares);
 	}
 	/**
 	* Adds a new OPTIONS route to the router.
@@ -124,7 +124,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static options(path, handler, middlewares) {
-		super.options(path, handler, middlewares);
+		return super.options(path, handler, middlewares);
 	}
 	/**
 	* Adds a new HEAD route to the router.
@@ -134,7 +134,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static head(path, handler, middlewares) {
-		super.head(path, handler, middlewares);
+		return super.head(path, handler, middlewares);
 	}
 	/**
 	* Defines a group of routes with a common prefix.
@@ -158,6 +158,9 @@ var Router = class Router extends require_router.CoreRouter {
 	static allRoutes(type) {
 		return super.allRoutes(type);
 	}
+	static route(name) {
+		return super.route(name);
+	}
 	static async apply(router) {
 		for (const route of this.routes) {
 			let handlerFunction = null;
@@ -195,7 +198,7 @@ var Router = class Router extends require_router.CoreRouter {
 					console.error("[ROUTES]", error.message);
 					throw error;
 				}
-				router[method](route.path, (req, _res, next) => {
+				for (const registrationPath of route.registrationPaths) router[method](registrationPath, (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");
@@ -227,7 +230,7 @@ var Router = class Router extends require_router.CoreRouter {
 					"put",
 					"patch",
 					"delete"
-				].includes(method)) router.post(route.path, (req, _res, next) => {
+				].includes(method)) for (const registrationPath of route.registrationPaths) router.post(registrationPath, (req, _res, next) => {
 					Router.ensureRequestBodyAccessor(req);
 					if (Router.resolveMethodOverride(req.method, req.headers, req.body) !== method) return next("route");
 					req.method = method.toUpperCase();

package/dist/express/index.d.cts

@@ -1,4 +1,4 @@
-import { C as ControllerAction, S as ApiResourceMiddleware, T as HttpMethod, b as HttpContext, m as Route, t as CoreRouter, x as Middleware, y as Handler } from "../router-DTI0BowV.cjs";
+import { C as ControllerAction, S as ApiResourceMiddleware, T as HttpMethod, b as HttpContext, m as Route, t as CoreRouter, x as Middleware, y as Handler } from "../router-jwZwD8ZT.cjs";
 import { Router as Router$1 } from "express";
 
 //#region src/express/router.d.ts
@@ -21,7 +21,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a resourceful API controller with standard CRUD routes
    *
@@ -41,7 +41,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new POST route to the router.
    *
@@ -49,7 +49,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new PUT route to the router.
    *
@@ -57,7 +57,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new DELETE route to the router.
    *
@@ -65,7 +65,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new PATCH route to the router.
    *
@@ -73,7 +73,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new OPTIONS route to the router.
    *
@@ -81,7 +81,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new HEAD route to the router.
    *
@@ -89,7 +89,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Defines a group of routes with a common prefix.
    *
@@ -113,6 +113,8 @@ declare class Router extends CoreRouter {
   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;
   /**
    * Applies the registered routes to the given Express router instance, setting up the necessary
    * handlers and middlewares for each route.

package/dist/express/index.d.mts

@@ -1,4 +1,4 @@
-import { C as ControllerAction, S as ApiResourceMiddleware, T as HttpMethod, b as HttpContext, m as Route, t as CoreRouter, x as Middleware, y as Handler } from "../router-DiKqUyvk.mjs";
+import { C as ControllerAction, S as ApiResourceMiddleware, T as HttpMethod, b as HttpContext, m as Route, t as CoreRouter, x as Middleware, y as Handler } from "../router-Bk8mXRu1.mjs";
 import { Router as Router$1 } from "express";
 
 //#region src/express/router.d.ts
@@ -21,7 +21,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a resourceful API controller with standard CRUD routes
    *
@@ -41,7 +41,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new POST route to the router.
    *
@@ -49,7 +49,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new PUT route to the router.
    *
@@ -57,7 +57,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new DELETE route to the router.
    *
@@ -65,7 +65,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new PATCH route to the router.
    *
@@ -73,7 +73,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new OPTIONS route to the router.
    *
@@ -81,7 +81,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Adds a new HEAD route to the router.
    *
@@ -89,7 +89,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Defines a group of routes with a common prefix.
    *
@@ -113,6 +113,8 @@ declare class Router extends CoreRouter {
   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;
   /**
    * Applies the registered routes to the given Express router instance, setting up the necessary
    * handlers and middlewares for each route.

package/dist/express/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-CPmZcbU0.mjs";
+import { t as CoreRouter } from "../router-DSq9dtuQ.mjs";
 import { n as resolveResponseMeta, r as responseWasSent, t as isFetchResponse } from "../responses-BvETUeDL.mjs";
 
 //#region src/express/router.ts
@@ -53,7 +53,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static add(methods, path, handler, middlewares) {
-		super.add(methods, path, handler, middlewares);
+		return super.add(methods, path, handler, middlewares);
 	}
 	/**
 	* Define a resourceful API controller with standard CRUD routes
@@ -73,7 +73,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static get(path, handler, middlewares) {
-		super.get(path, handler, middlewares);
+		return super.get(path, handler, middlewares);
 	}
 	/**
 	* Adds a new POST route to the router.
@@ -83,7 +83,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static post(path, handler, middlewares) {
-		super.post(path, handler, middlewares);
+		return super.post(path, handler, middlewares);
 	}
 	/**
 	* Adds a new PUT route to the router.
@@ -93,7 +93,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static put(path, handler, middlewares) {
-		super.put(path, handler, middlewares);
+		return super.put(path, handler, middlewares);
 	}
 	/**
 	* Adds a new DELETE route to the router.
@@ -103,7 +103,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static delete(path, handler, middlewares) {
-		super.delete(path, handler, middlewares);
+		return super.delete(path, handler, middlewares);
 	}
 	/**
 	* Adds a new PATCH route to the router.
@@ -113,7 +113,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static patch(path, handler, middlewares) {
-		super.patch(path, handler, middlewares);
+		return super.patch(path, handler, middlewares);
 	}
 	/**
 	* Adds a new OPTIONS route to the router.
@@ -123,7 +123,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static options(path, handler, middlewares) {
-		super.options(path, handler, middlewares);
+		return super.options(path, handler, middlewares);
 	}
 	/**
 	* Adds a new HEAD route to the router.
@@ -133,7 +133,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static head(path, handler, middlewares) {
-		super.head(path, handler, middlewares);
+		return super.head(path, handler, middlewares);
 	}
 	/**
 	* Defines a group of routes with a common prefix.
@@ -157,6 +157,9 @@ var Router = class Router extends CoreRouter {
 	static allRoutes(type) {
 		return super.allRoutes(type);
 	}
+	static route(name) {
+		return super.route(name);
+	}
 	static async apply(router) {
 		for (const route of this.routes) {
 			let handlerFunction = null;
@@ -194,7 +197,7 @@ var Router = class Router extends CoreRouter {
 					console.error("[ROUTES]", error.message);
 					throw error;
 				}
-				router[method](route.path, (req, _res, next) => {
+				for (const registrationPath of route.registrationPaths) router[method](registrationPath, (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");
@@ -226,7 +229,7 @@ var Router = class Router extends CoreRouter {
 					"put",
 					"patch",
 					"delete"
-				].includes(method)) router.post(route.path, (req, _res, next) => {
+				].includes(method)) for (const registrationPath of route.registrationPaths) router.post(registrationPath, (req, _res, next) => {
 					Router.ensureRequestBodyAccessor(req);
 					if (Router.resolveMethodOverride(req.method, req.headers, req.body) !== method) return next("route");
 					req.method = method.toUpperCase();

package/dist/fastify/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 require('../bindings-CLsZjOEy.cjs');
-const require_router = require('../router-D9H9-T27.cjs');
+const require_router = require('../router-CAnd539U.cjs');
 const require_responses = require('../responses-Bvnk0uvc.cjs');
 
 //#region src/fastify/router.ts
@@ -47,7 +47,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares   Optional middlewares for the route
 	*/
 	static add(methods, path, handler, middlewares) {
-		super.add(methods, path, handler, middlewares);
+		return super.add(methods, path, handler, middlewares);
 	}
 	/**
 	* Define a resourceful API controller with standard CRUD routes
@@ -67,7 +67,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static get(path, handler, middlewares) {
-		super.get(path, handler, middlewares);
+		return super.get(path, handler, middlewares);
 	}
 	/**
 	* Define a POST route
@@ -77,7 +77,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static post(path, handler, middlewares) {
-		super.post(path, handler, middlewares);
+		return super.post(path, handler, middlewares);
 	}
 	/**
 	* Define a PUT route
@@ -87,7 +87,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static put(path, handler, middlewares) {
-		super.put(path, handler, middlewares);
+		return super.put(path, handler, middlewares);
 	}
 	/**
 	* Define a DELETE route
@@ -97,7 +97,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static delete(path, handler, middlewares) {
-		super.delete(path, handler, middlewares);
+		return super.delete(path, handler, middlewares);
 	}
 	/**
 	* Define a PATCH route
@@ -107,7 +107,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static patch(path, handler, middlewares) {
-		super.patch(path, handler, middlewares);
+		return super.patch(path, handler, middlewares);
 	}
 	/**
 	* Define an OPTIONS route
@@ -117,7 +117,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static options(path, handler, middlewares) {
-		super.options(path, handler, middlewares);
+		return super.options(path, handler, middlewares);
 	}
 	/**
 	* Define a HEAD route
@@ -127,7 +127,7 @@ var Router = class Router extends require_router.CoreRouter {
 	* @param middlewares 
 	*/
 	static head(path, handler, middlewares) {
-		super.head(path, handler, middlewares);
+		return super.head(path, handler, middlewares);
 	}
 	/**
 	* Define a group of routes with a common prefix and optional middlewares
@@ -151,6 +151,9 @@ var Router = class Router extends require_router.CoreRouter {
 	static allRoutes(type) {
 		return super.allRoutes(type);
 	}
+	static route(name) {
+		return super.route(name);
+	}
 	/**
 	* Apply the defined routes to a Fastify application instance
 	* 
@@ -190,9 +193,9 @@ var Router = class Router extends require_router.CoreRouter {
 				];
 				if (method === "options" && route.methods.length > 1) continue;
 				if (!allowedMethods.includes(method)) throw new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
-				app.route({
+				for (const registrationPath of route.registrationPaths) app.route({
 					method: method.toUpperCase(),
-					url: route.path,
+					url: registrationPath,
 					preHandler: route.middlewares,
 					handler: async (req, reply) => {
 						Router.ensureRequestBodyAccessor(req);
@@ -219,9 +222,9 @@ var Router = class Router extends require_router.CoreRouter {
 					"put",
 					"patch",
 					"delete"
-				].includes(method)) app.route({
+				].includes(method)) for (const registrationPath of route.registrationPaths) app.route({
 					method: "POST",
-					url: route.path,
+					url: registrationPath,
 					preHandler: route.middlewares,
 					handler: async (req, reply) => {
 						Router.ensureRequestBodyAccessor(req);

package/dist/fastify/index.d.cts

@@ -1,4 +1,4 @@
-import { C as ControllerAction, E as Response, S as ApiResourceMiddleware, T as HttpMethod, m as Route, p as Request, t as CoreRouter, w as ControllerHandler } from "../router-DTI0BowV.cjs";
+import { C as ControllerAction, E as Response, S as ApiResourceMiddleware, T as HttpMethod, m as Route, p as Request, t as CoreRouter, w as ControllerHandler } from "../router-jwZwD8ZT.cjs";
 import { FastifyInstance, FastifyReply, FastifyRequest } from "fastify";
 
 //#region types/fastify.d.ts
@@ -36,7 +36,7 @@ declare class Router extends CoreRouter {
    * @param handler       Route handler function
    * @param middlewares   Optional middlewares for the route
    */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a resourceful API controller with standard CRUD routes
    *
@@ -56,7 +56,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a POST route
    *
@@ -64,7 +64,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a PUT route
    *
@@ -72,7 +72,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a DELETE route
    *
@@ -80,7 +80,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a PATCH route
    *
@@ -88,7 +88,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define an OPTIONS route
    *
@@ -96,7 +96,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a HEAD route
    *
@@ -104,7 +104,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a group of routes with a common prefix and optional middlewares
    *
@@ -129,6 +129,8 @@ declare class Router extends CoreRouter {
    * @param type  - 'method' to get routes organized by method
    */
   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;
   /**
    * Apply the defined routes to a Fastify application instance
    *