clear-router 2.8.9 → 2.9.1

package/dist/decorators/middleware.cjs

@@ -0,0 +1,100 @@
+
+//#region src/decorators/middleware.ts
+const CLASS_KEY = "__class__";
+const metadataKey = Symbol.for("clear-router:middleware-metadata");
+const store = /* @__PURE__ */ new WeakMap();
+/**
+* Attach one or more middleware to a controller class or a controller method.
+*
+* @example
+* ```ts
+* @Middleware([auth])
+* class AccountController {}
+*
+* class LoginController {
+*     @Middleware(GuestMiddleware)
+*     create () {}
+* }
+* ```
+*
+* Accepts the middleware variadically or as arrays, and every supported
+* middleware shape: callbacks, middleware classes, or instances exposing a
+* `handle` method.
+*
+* @param middlewares
+* @returns
+*/
+function middleware(...middlewares) {
+	const flattened = middlewares.flat();
+	return ((target, propertyKeyOrContext) => {
+		if (isStandardClassContext(propertyKeyOrContext)) {
+			setClassMiddlewareMetadata(target, flattened);
+			setStandardMetadata(propertyKeyOrContext.metadata, CLASS_KEY, flattened);
+			return;
+		}
+		if (isStandardMethodContext(propertyKeyOrContext)) {
+			setStandardMetadata(propertyKeyOrContext.metadata, propertyKeyOrContext.name, flattened);
+			return;
+		}
+		if (typeof propertyKeyOrContext === "undefined") {
+			setClassMiddlewareMetadata(target, flattened);
+			return;
+		}
+		setMiddlewareMetadata(target, propertyKeyOrContext, flattened);
+	});
+}
+/**
+* Collect the decorator-declared middleware for a controller route handler,
+* ordered class-level first then method-level. Returns an empty array for
+* non-controller (callback) handlers or handlers without any decorators.
+*
+* @param handler
+* @returns
+*/
+function getControllerMiddlewares(handler) {
+	if (!Array.isArray(handler) || handler.length !== 2) return [];
+	const [controller, method] = handler;
+	if (!controller) return [];
+	const constructor = typeof controller === "function" ? controller : controller.constructor;
+	const prototype = typeof controller === "function" ? controller.prototype : Object.getPrototypeOf(controller);
+	const standardMetadata = constructor?.[Symbol.metadata];
+	const classMiddlewares = getMiddlewareMetadata(constructor, CLASS_KEY) ?? getMiddlewareMetadata(prototype, CLASS_KEY) ?? getStandardMetadata(standardMetadata, CLASS_KEY) ?? [];
+	const methodMiddlewares = getMiddlewareMetadata(prototype, method) ?? getMiddlewareMetadata(constructor, method) ?? getStandardMetadata(standardMetadata, method) ?? [];
+	return [...classMiddlewares, ...methodMiddlewares];
+}
+function setClassMiddlewareMetadata(target, middlewares) {
+	setMiddlewareMetadata(target, CLASS_KEY, middlewares);
+	const prototype = target.prototype;
+	if (prototype) setMiddlewareMetadata(prototype, CLASS_KEY, middlewares);
+}
+function setMiddlewareMetadata(target, propertyKey, middlewares) {
+	const map = store.get(target) ?? /* @__PURE__ */ new Map();
+	const existing = map.get(propertyKey);
+	map.set(propertyKey, existing ? [...existing, ...middlewares] : middlewares);
+	store.set(target, map);
+}
+function getMiddlewareMetadata(target, propertyKey) {
+	if (!target) return void 0;
+	return store.get(target)?.get(propertyKey);
+}
+function setStandardMetadata(metadata, propertyKey, middlewares) {
+	if (!metadata) return;
+	const record = metadata;
+	record[metadataKey] = record[metadataKey] ?? {};
+	const existing = record[metadataKey][propertyKey];
+	record[metadataKey][propertyKey] = existing ? [...existing, ...middlewares] : middlewares;
+}
+function getStandardMetadata(metadata, propertyKey) {
+	const record = metadata && metadata[metadataKey];
+	return record ? record[propertyKey] : void 0;
+}
+function isStandardMethodContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "method" && typeof value.name !== "undefined");
+}
+function isStandardClassContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "class" && typeof value.name !== "undefined");
+}
+
+//#endregion
+exports.getControllerMiddlewares = getControllerMiddlewares;
+exports.middleware = middleware;

package/dist/decorators/middleware.d.cts

@@ -0,0 +1,51 @@
+import { ClassMiddleware, MiddlewareHandle } from "../types/basic.cjs";
+
+//#region src/decorators/middleware.d.ts
+/**
+ * Any value accepted as a middleware by the router: a plain callback, a class
+ * exposing a `handle` method, or an already-instantiated object exposing one.
+ */
+type MiddlewareInput = MiddlewareHandle | ClassMiddleware;
+/**
+ * Decorator produced by {@link Middleware}. Works both as a class decorator (to
+ * apply the middleware to every action of a controller) and as a method
+ * decorator (to apply it to a single action). Supports the legacy
+ * (`experimentalDecorators`) and TC39 standard decorator signatures.
+ */
+type MiddlewareDecorator = 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;
+};
+/**
+ * Attach one or more middleware to a controller class or a controller method.
+ *
+ * @example
+ * ```ts
+ * @Middleware([auth])
+ * class AccountController {}
+ *
+ * class LoginController {
+ *     @Middleware(GuestMiddleware)
+ *     create () {}
+ * }
+ * ```
+ *
+ * Accepts the middleware variadically or as arrays, and every supported
+ * middleware shape: callbacks, middleware classes, or instances exposing a
+ * `handle` method.
+ *
+ * @param middlewares
+ * @returns
+ */
+declare function middleware(...middlewares: Array<MiddlewareInput | MiddlewareInput[]>): MiddlewareDecorator;
+/**
+ * Collect the decorator-declared middleware for a controller route handler,
+ * ordered class-level first then method-level. Returns an empty array for
+ * non-controller (callback) handlers or handlers without any decorators.
+ *
+ * @param handler
+ * @returns
+ */
+declare function getControllerMiddlewares(handler: any): MiddlewareInput[];
+//#endregion
+export { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware };

package/dist/decorators/middleware.d.mts

@@ -0,0 +1,51 @@
+import { ClassMiddleware, MiddlewareHandle } from "../types/basic.mjs";
+
+//#region src/decorators/middleware.d.ts
+/**
+ * Any value accepted as a middleware by the router: a plain callback, a class
+ * exposing a `handle` method, or an already-instantiated object exposing one.
+ */
+type MiddlewareInput = MiddlewareHandle | ClassMiddleware;
+/**
+ * Decorator produced by {@link Middleware}. Works both as a class decorator (to
+ * apply the middleware to every action of a controller) and as a method
+ * decorator (to apply it to a single action). Supports the legacy
+ * (`experimentalDecorators`) and TC39 standard decorator signatures.
+ */
+type MiddlewareDecorator = 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;
+};
+/**
+ * Attach one or more middleware to a controller class or a controller method.
+ *
+ * @example
+ * ```ts
+ * @Middleware([auth])
+ * class AccountController {}
+ *
+ * class LoginController {
+ *     @Middleware(GuestMiddleware)
+ *     create () {}
+ * }
+ * ```
+ *
+ * Accepts the middleware variadically or as arrays, and every supported
+ * middleware shape: callbacks, middleware classes, or instances exposing a
+ * `handle` method.
+ *
+ * @param middlewares
+ * @returns
+ */
+declare function middleware(...middlewares: Array<MiddlewareInput | MiddlewareInput[]>): MiddlewareDecorator;
+/**
+ * Collect the decorator-declared middleware for a controller route handler,
+ * ordered class-level first then method-level. Returns an empty array for
+ * non-controller (callback) handlers or handlers without any decorators.
+ *
+ * @param handler
+ * @returns
+ */
+declare function getControllerMiddlewares(handler: any): MiddlewareInput[];
+//#endregion
+export { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware };

package/dist/decorators/middleware.mjs

@@ -0,0 +1,98 @@
+//#region src/decorators/middleware.ts
+const CLASS_KEY = "__class__";
+const metadataKey = Symbol.for("clear-router:middleware-metadata");
+const store = /* @__PURE__ */ new WeakMap();
+/**
+* Attach one or more middleware to a controller class or a controller method.
+*
+* @example
+* ```ts
+* @Middleware([auth])
+* class AccountController {}
+*
+* class LoginController {
+*     @Middleware(GuestMiddleware)
+*     create () {}
+* }
+* ```
+*
+* Accepts the middleware variadically or as arrays, and every supported
+* middleware shape: callbacks, middleware classes, or instances exposing a
+* `handle` method.
+*
+* @param middlewares
+* @returns
+*/
+function middleware(...middlewares) {
+	const flattened = middlewares.flat();
+	return ((target, propertyKeyOrContext) => {
+		if (isStandardClassContext(propertyKeyOrContext)) {
+			setClassMiddlewareMetadata(target, flattened);
+			setStandardMetadata(propertyKeyOrContext.metadata, CLASS_KEY, flattened);
+			return;
+		}
+		if (isStandardMethodContext(propertyKeyOrContext)) {
+			setStandardMetadata(propertyKeyOrContext.metadata, propertyKeyOrContext.name, flattened);
+			return;
+		}
+		if (typeof propertyKeyOrContext === "undefined") {
+			setClassMiddlewareMetadata(target, flattened);
+			return;
+		}
+		setMiddlewareMetadata(target, propertyKeyOrContext, flattened);
+	});
+}
+/**
+* Collect the decorator-declared middleware for a controller route handler,
+* ordered class-level first then method-level. Returns an empty array for
+* non-controller (callback) handlers or handlers without any decorators.
+*
+* @param handler
+* @returns
+*/
+function getControllerMiddlewares(handler) {
+	if (!Array.isArray(handler) || handler.length !== 2) return [];
+	const [controller, method] = handler;
+	if (!controller) return [];
+	const constructor = typeof controller === "function" ? controller : controller.constructor;
+	const prototype = typeof controller === "function" ? controller.prototype : Object.getPrototypeOf(controller);
+	const standardMetadata = constructor?.[Symbol.metadata];
+	const classMiddlewares = getMiddlewareMetadata(constructor, CLASS_KEY) ?? getMiddlewareMetadata(prototype, CLASS_KEY) ?? getStandardMetadata(standardMetadata, CLASS_KEY) ?? [];
+	const methodMiddlewares = getMiddlewareMetadata(prototype, method) ?? getMiddlewareMetadata(constructor, method) ?? getStandardMetadata(standardMetadata, method) ?? [];
+	return [...classMiddlewares, ...methodMiddlewares];
+}
+function setClassMiddlewareMetadata(target, middlewares) {
+	setMiddlewareMetadata(target, CLASS_KEY, middlewares);
+	const prototype = target.prototype;
+	if (prototype) setMiddlewareMetadata(prototype, CLASS_KEY, middlewares);
+}
+function setMiddlewareMetadata(target, propertyKey, middlewares) {
+	const map = store.get(target) ?? /* @__PURE__ */ new Map();
+	const existing = map.get(propertyKey);
+	map.set(propertyKey, existing ? [...existing, ...middlewares] : middlewares);
+	store.set(target, map);
+}
+function getMiddlewareMetadata(target, propertyKey) {
+	if (!target) return void 0;
+	return store.get(target)?.get(propertyKey);
+}
+function setStandardMetadata(metadata, propertyKey, middlewares) {
+	if (!metadata) return;
+	const record = metadata;
+	record[metadataKey] = record[metadataKey] ?? {};
+	const existing = record[metadataKey][propertyKey];
+	record[metadataKey][propertyKey] = existing ? [...existing, ...middlewares] : middlewares;
+}
+function getStandardMetadata(metadata, propertyKey) {
+	const record = metadata && metadata[metadataKey];
+	return record ? record[propertyKey] : void 0;
+}
+function isStandardMethodContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "method" && typeof value.name !== "undefined");
+}
+function isStandardClassContext(value) {
+	return Boolean(value && typeof value === "object" && value.kind === "class" && typeof value.name !== "undefined");
+}
+
+//#endregion
+export { getControllerMiddlewares, middleware };

package/dist/decorators/setup.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_middleware = require('./middleware.cjs');
 const require_bindings = require('../core/bindings.cjs');
 const require_CoreRouter = require('../core/CoreRouter.cjs');
 require('./index.cjs');
@@ -12,4 +13,6 @@ require_CoreRouter.CoreRouter.configureDefaults({ container: {
 
 //#endregion
 exports.Bind = require_bindings.Bind;
-exports.Container = require_bindings.Container;
+exports.Container = require_bindings.Container;
+exports.getControllerMiddlewares = require_middleware.getControllerMiddlewares;
+exports.middleware = require_middleware.middleware;

package/dist/decorators/setup.d.cts

@@ -1,2 +1,3 @@
 import { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container } from "../core/bindings.cjs";
-export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container };
+import { MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware } from "./middleware.cjs";
+export { Bind, BindDecorator, BindFactory, BindToken, BindValue, Container, MiddlewareDecorator, MiddlewareInput, getControllerMiddlewares, middleware };

package/dist/decorators/setup.d.mts

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

package/dist/decorators/setup.mjs

@@ -1,3 +1,4 @@
+import { getControllerMiddlewares, middleware } from "./middleware.mjs";
 import { Bind, Container } from "../core/bindings.mjs";
 import { CoreRouter } from "../core/CoreRouter.mjs";
 import "./index.mjs";
@@ -10,4 +11,4 @@ CoreRouter.configureDefaults({ container: {
 } });
 
 //#endregion
-export { Bind, Container };
+export { Bind, Container, getControllerMiddlewares, middleware };

package/dist/express/router.cjs

@@ -11,6 +11,9 @@ const require_responses = require('../core/responses.cjs');
 */
 var Router = class Router extends require_CoreRouter.CoreRouter {
 	static routerStateNamespace = "clear-router:express";
+	static formatWildcardParam(name) {
+		return `*${name}`;
+	}
 	static ensureRequestBodyAccessor(req) {
 		if (typeof req.getBody !== "function") req.getBody = () => req.body ?? {};
 	}
@@ -196,7 +199,7 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 					console.error("[ROUTES]", error.message);
 					throw error;
 				}
-				for (const registrationPath of route.registrationPaths) router[method](registrationPath, (req, _res, next) => {
+				for (const registrationPath of this.resolveRegistrationPaths(route)) 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");
@@ -210,10 +213,13 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 							next
 						};
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, ctx.req.params);
+						if (params === false) return next("route");
+						Object.assign(ctx.req.params, params);
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: ctx.req.getBody(),
 							query: ctx.req.query,
-							params: ctx.req.params,
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);
@@ -228,7 +234,7 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 					"put",
 					"patch",
 					"delete"
-				].includes(method)) for (const registrationPath of route.registrationPaths) router.post(registrationPath, (req, _res, next) => {
+				].includes(method)) for (const registrationPath of this.resolveRegistrationPaths(route)) 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();
@@ -242,10 +248,13 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 							next
 						};
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, ctx.req.params);
+						if (params === false) return next("route");
+						Object.assign(ctx.req.params, params);
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: ctx.req.getBody(),
 							query: ctx.req.query,
-							params: ctx.req.params,
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);

package/dist/express/router.d.cts

@@ -16,6 +16,7 @@ import { Router } from "express";
  */
 declare class Router$1 extends CoreRouter {
   protected static routerStateNamespace: string;
+  protected static formatWildcardParam(name: string): string;
   private static ensureRequestBodyAccessor;
   private static sendReturnValue;
   /**

package/dist/express/router.d.mts

@@ -16,6 +16,7 @@ import { Router } from "express";
  */
 declare class Router$1 extends CoreRouter {
   protected static routerStateNamespace: string;
+  protected static formatWildcardParam(name: string): string;
   private static ensureRequestBodyAccessor;
   private static sendReturnValue;
   /**

package/dist/express/router.mjs

@@ -11,6 +11,9 @@ import { isFetchResponse, resolveResponseMeta, responseWasSent } from "../core/r
 */
 var Router = class Router extends CoreRouter {
 	static routerStateNamespace = "clear-router:express";
+	static formatWildcardParam(name) {
+		return `*${name}`;
+	}
 	static ensureRequestBodyAccessor(req) {
 		if (typeof req.getBody !== "function") req.getBody = () => req.body ?? {};
 	}
@@ -196,7 +199,7 @@ var Router = class Router extends CoreRouter {
 					console.error("[ROUTES]", error.message);
 					throw error;
 				}
-				for (const registrationPath of route.registrationPaths) router[method](registrationPath, (req, _res, next) => {
+				for (const registrationPath of this.resolveRegistrationPaths(route)) 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");
@@ -210,10 +213,13 @@ var Router = class Router extends CoreRouter {
 							next
 						};
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, ctx.req.params);
+						if (params === false) return next("route");
+						Object.assign(ctx.req.params, params);
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: ctx.req.getBody(),
 							query: ctx.req.query,
-							params: ctx.req.params,
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);
@@ -228,7 +234,7 @@ var Router = class Router extends CoreRouter {
 					"put",
 					"patch",
 					"delete"
-				].includes(method)) for (const registrationPath of route.registrationPaths) router.post(registrationPath, (req, _res, next) => {
+				].includes(method)) for (const registrationPath of this.resolveRegistrationPaths(route)) 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();
@@ -242,10 +248,13 @@ var Router = class Router extends CoreRouter {
 							next
 						};
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, ctx.req.params);
+						if (params === false) return next("route");
+						Object.assign(ctx.req.params, params);
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: ctx.req.getBody(),
 							query: ctx.req.query,
-							params: ctx.req.params,
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);

package/dist/fastify/router.cjs

@@ -10,6 +10,9 @@ const require_responses = require('../core/responses.cjs');
 */
 var Router = class Router extends require_CoreRouter.CoreRouter {
 	static routerStateNamespace = "clear-router:fastify";
+	static formatWildcardParam() {
+		return "*";
+	}
 	static ensureRequestBodyAccessor(req) {
 		if (typeof req.getBody !== "function") req.getBody = () => req.body ?? {};
 	}
@@ -191,7 +194,7 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 				];
 				if (method === "options" && route.methods.length > 1) continue;
 				if (!allowedMethods.includes(method)) throw new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
-				for (const registrationPath of route.registrationPaths) app.route({
+				for (const registrationPath of this.resolveRegistrationPaths(route)) app.route({
 					method: method.toUpperCase(),
 					url: registrationPath,
 					preHandler: route.middlewares,
@@ -204,10 +207,13 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 							reply
 						};
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, ctx.req.params ?? {});
+						if (params === false) return reply.code(404).send();
+						Object.assign(ctx.req.params ??= {}, params);
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: ctx.req.getBody(),
 							query: ctx.req.query ?? {},
-							params: ctx.req.params ?? {},
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);
@@ -220,7 +226,7 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 					"put",
 					"patch",
 					"delete"
-				].includes(method)) for (const registrationPath of route.registrationPaths) app.route({
+				].includes(method)) for (const registrationPath of this.resolveRegistrationPaths(route)) app.route({
 					method: "POST",
 					url: registrationPath,
 					preHandler: route.middlewares,
@@ -232,10 +238,13 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 							reply
 						};
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, ctx.req.params ?? {});
+						if (params === false) return reply.code(404).send();
+						Object.assign(ctx.req.params ??= {}, params);
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: ctx.req.getBody(),
 							query: ctx.req.query ?? {},
-							params: ctx.req.params ?? {},
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);

package/dist/fastify/router.d.cts

@@ -14,6 +14,7 @@ import { CoreRouter } from "../core/CoreRouter.cjs";
  */
 declare class Router extends CoreRouter {
   protected static routerStateNamespace: string;
+  protected static formatWildcardParam(): string;
   private static ensureRequestBodyAccessor;
   private static sendReturnValue;
   /**

package/dist/fastify/router.d.mts

@@ -14,6 +14,7 @@ import { CoreRouter } from "../core/CoreRouter.mjs";
  */
 declare class Router extends CoreRouter {
   protected static routerStateNamespace: string;
+  protected static formatWildcardParam(): string;
   private static ensureRequestBodyAccessor;
   private static sendReturnValue;
   /**

package/dist/fastify/router.mjs

@@ -10,6 +10,9 @@ import { isFetchResponse, resolveResponseMeta, responseWasSent } from "../core/r
 */
 var Router = class Router extends CoreRouter {
 	static routerStateNamespace = "clear-router:fastify";
+	static formatWildcardParam() {
+		return "*";
+	}
 	static ensureRequestBodyAccessor(req) {
 		if (typeof req.getBody !== "function") req.getBody = () => req.body ?? {};
 	}
@@ -191,7 +194,7 @@ var Router = class Router extends CoreRouter {
 				];
 				if (method === "options" && route.methods.length > 1) continue;
 				if (!allowedMethods.includes(method)) throw new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
-				for (const registrationPath of route.registrationPaths) app.route({
+				for (const registrationPath of this.resolveRegistrationPaths(route)) app.route({
 					method: method.toUpperCase(),
 					url: registrationPath,
 					preHandler: route.middlewares,
@@ -204,10 +207,13 @@ var Router = class Router extends CoreRouter {
 							reply
 						};
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, ctx.req.params ?? {});
+						if (params === false) return reply.code(404).send();
+						Object.assign(ctx.req.params ??= {}, params);
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: ctx.req.getBody(),
 							query: ctx.req.query ?? {},
-							params: ctx.req.params ?? {},
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);
@@ -220,7 +226,7 @@ var Router = class Router extends CoreRouter {
 					"put",
 					"patch",
 					"delete"
-				].includes(method)) for (const registrationPath of route.registrationPaths) app.route({
+				].includes(method)) for (const registrationPath of this.resolveRegistrationPaths(route)) app.route({
 					method: "POST",
 					url: registrationPath,
 					preHandler: route.middlewares,
@@ -232,10 +238,13 @@ var Router = class Router extends CoreRouter {
 							reply
 						};
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, ctx.req.params ?? {});
+						if (params === false) return reply.code(404).send();
+						Object.assign(ctx.req.params ??= {}, params);
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: ctx.req.getBody(),
 							query: ctx.req.query ?? {},
-							params: ctx.req.params ?? {},
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);

package/dist/h3/router.cjs

@@ -11,6 +11,9 @@ let h3 = require("h3");
 */
 var Router = class Router extends require_CoreRouter.CoreRouter {
 	static routerStateNamespace = "clear-router:h3";
+	static formatWildcardParam(name) {
+		return `**:${name}`;
+	}
 	static bodyCache = /* @__PURE__ */ new WeakMap();
 	static toResponse(ctx, value, method, path) {
 		const meta = require_responses.resolveResponseMeta(value, {
@@ -205,17 +208,20 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 					console.error("[ROUTES]", error.message);
 					throw error;
 				}
-				for (const registrationPath of route.registrationPaths) app[method](registrationPath, async (event) => {
+				for (const registrationPath of this.resolveRegistrationPaths(route)) app[method](registrationPath, async (event) => {
 					try {
 						const ctx = event;
 						const reqBody = await Router.readBodyCached(ctx);
 						const override = Router.resolveMethodOverride(ctx.req.method, ctx.req.headers, reqBody);
 						if (method === "post" && override && override !== "post") return;
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, (0, h3.getRouterParams)(ctx, { decode: true }));
+						if (params === false) return Symbol.for("h3.notFound");
+						ctx.context = Object.assign(ctx.context ?? {}, { params });
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: reqBody,
 							query: (0, h3.getQuery)(ctx),
-							params: (0, h3.getRouterParams)(ctx, { decode: true }),
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);
@@ -230,16 +236,19 @@ var Router = class Router extends require_CoreRouter.CoreRouter {
 					"put",
 					"patch",
 					"delete"
-				].includes(method)) for (const registrationPath of route.registrationPaths) app.post(registrationPath, async (event) => {
+				].includes(method)) for (const registrationPath of this.resolveRegistrationPaths(route)) app.post(registrationPath, async (event) => {
 					try {
 						const ctx = event;
 						const reqBody = await Router.readBodyCached(ctx);
 						if (Router.resolveMethodOverride(ctx.req.method, ctx.req.headers, reqBody) !== method) return Symbol.for("h3.notFound");
 						const inst = instance ?? route;
+						const params = Router.matchRoute(route, ctx, (0, h3.getRouterParams)(ctx, { decode: true }));
+						if (params === false) return Symbol.for("h3.notFound");
+						ctx.context = Object.assign(ctx.context ?? {}, { params });
 						Router.bindRequestToInstance(ctx, inst, route, {
 							body: reqBody,
 							query: (0, h3.getQuery)(ctx),
-							params: (0, h3.getRouterParams)(ctx, { decode: true }),
+							params,
 							method
 						});
 						const result = await Router.callHandler(handlerFunction, ctx, bindingTarget, bindingMethod, bindingHandler, bindingMetadata);