@warlock.js/core 4.15.0 → 5.0.0

package/esm/router/router.mjs

@@ -1,8 +1,11 @@
+import { forgetPositionalHandlerSuspects, inspectHandlerSignature, reportPositionalHandlerSuspects } from "./positional-handler-diagnostics.mjs";
+import { RouteRegistry } from "./route-registry.mjs";
 import { container } from "../container/index.mjs";
 import { Response } from "../http/response.mjs";
 import { Request } from "../http/request.mjs";
+import { describeRouteForLog } from "./describe-route-for-log.mjs";
+import { logRequestLifecycle } from "./log-request-lifecycle.mjs";
 import { RouteBuilder } from "./route-builder.mjs";
-import { RouteRegistry } from "./route-registry.mjs";
 import { log } from "@warlock.js/logger";
 import { isEmpty } from "@mongez/supportive-is";
 import { ltrim, merge, toCamelCase, trim } from "@mongez/reinforcements";
@@ -40,6 +43,24 @@ async function runRouteHooks(route, phase, request, reply) {
 	const hooks = toHookList(route.serverOptions?.[phase]);
 	for (const hook of hooks) if (await hook(request, reply) === reply) return reply;
 }
+/**
+* Describe one claimant of a route name, for the duplicate-name error.
+*
+* `warlock dev` registers SSR page routes on the same router as API routes, so
+* the two share a single route-name namespace and collide across kinds. The
+* error is only actionable if it says which claimant is which, so `isPage` —
+* the router's only route-kind discriminator — is what separates them here.
+*
+* `sourceFile` is stamped only on routes registered through `withSourceFile`,
+* which page routes are not (the stack is a single slot, so page installation
+* cannot nest inside a route file's scope without clobbering it). Say the
+* source is unknown rather than printing an empty string.
+*/
+function describeRouteClaimant(route) {
+	const type = route.isPage ? "page route" : "API route";
+	const source = route.sourceFile ? `declared in ${route.sourceFile}` : "source file unknown";
+	return `${type} ${route.method} ${route.path} (${source})`;
+}
 var Router = class Router {
 	/**
 	* Get router instance
@@ -77,7 +98,7 @@ var Router = class Router {
 	* Redirect path to another path
 	*/
 	redirect(from, to, redirectMode = "temporary") {
-		return this.get(from, (_request, response) => {
+		return this.get(from, ({ response }) => {
 			response.redirect(to, redirectMode === "temporary" ? 302 : 301);
 		});
 	}
@@ -92,7 +113,7 @@ var Router = class Router {
 	* Serve file
 	*/
 	file(path, location, cacheTime) {
-		return this.get(path, (_request, response) => {
+		return this.get(path, ({ response }) => {
 			response.sendFile(location, cacheTime);
 		});
 	}
@@ -100,7 +121,7 @@ var Router = class Router {
 	* Serve cached file, it will cache the file to 1 year by default
 	*/
 	cachedFile(path, location, cacheTime) {
-		return this.get(path, (_request, response) => {
+		return this.get(path, ({ response }) => {
 			response.sendCachedFile(location, cacheTime);
 		});
 	}
@@ -108,7 +129,7 @@ var Router = class Router {
 	* Serve list of files
 	*/
 	files(files, cacheTime) {
-		for (const [path, location] of Object.entries(files)) this.get(path, (_request, response) => {
+		for (const [path, location] of Object.entries(files)) this.get(path, ({ response }) => {
 			response.sendFile(location, cacheTime);
 		});
 	}
@@ -116,7 +137,7 @@ var Router = class Router {
 	* Serve list of cached files, it will cache the file to 1 year by default
 	*/
 	cachedFiles(files, cacheTime) {
-		for (const [path, location] of Object.entries(files)) this.get(path, (_request, response) => {
+		for (const [path, location] of Object.entries(files)) this.get(path, ({ response }) => {
 			response.sendCachedFile(location, cacheTime);
 		});
 	}
@@ -171,9 +192,10 @@ var Router = class Router {
 		};
 		if (routeData.name) {
 			const route = this.routes.find((route) => route.name === routeData.name);
-			if (route) if (route.method === routeData.method) throw new Error(`Route name "${routeData.name}" already exists`);
+			if (route) if (route.method === routeData.method) throw new Error(`Route name "${routeData.name}" is already taken.\n  already registered: ${describeRouteClaimant(route)}\n  now being added:    ${describeRouteClaimant(routeData)}\nPages and API routes share one route-name namespace, so a name can only be claimed once. Rename one of them via the "name" route option.`);
 			else routeData.name += `.${routeData.method.toLowerCase()}`;
 		}
+		inspectHandlerSignature(routeData.handler, routeData);
 		this.routes.push(routeData);
 		this.routesVersion++;
 		return this;
@@ -243,72 +265,60 @@ var Router = class Router {
 	* 6. PATCH /path/:id: update a resource partially
 	*/
 	restfulResource(path, resource, options = {}) {
-		return this.prefix(path, () => {
-			path = "";
-			const baseResourceName = options.name || toCamelCase(ltrim(path, "/"));
+		const baseResourceName = options.name || toCamelCase(ltrim(path, "/"));
+		return this.group({
+			prefix: path,
+			name: baseResourceName
+		}, () => {
+			const path = "";
 			const routeResource = resource;
 			const isAcceptableResource = (type) => {
 				return Boolean((!options.except || !options.except.includes(type)) && (!options.only || options.only.includes(type)));
 			};
-			if (routeResource.list && isAcceptableResource("list")) {
-				const resourceName = baseResourceName + ".list";
-				this.get(path, options.replace?.list || routeResource.list.bind(routeResource), {
-					...options,
-					name: resourceName,
-					restful: true
-				});
-			}
-			if (routeResource.get && isAcceptableResource("get")) {
-				const resourceName = baseResourceName + ".single";
-				this.get(path + "/:id", options.replace?.get || routeResource.get.bind(routeResource), {
-					...options,
-					name: resourceName,
-					restful: true
-				});
-			}
+			if (routeResource.list && isAcceptableResource("list")) this.get(path, options.replace?.list || routeResource.list.bind(routeResource), {
+				...options,
+				name: "list",
+				restful: true
+			});
+			if (routeResource.get && isAcceptableResource("get")) this.get("/:id", options.replace?.get || routeResource.get.bind(routeResource), {
+				...options,
+				name: "single",
+				restful: true
+			});
 			if (routeResource.create && isAcceptableResource("create")) {
-				const resourceName = baseResourceName + ".create";
 				const handler = options.replace?.create || this.manageValidation(routeResource, "create");
 				this.post(path, handler, {
 					...options,
-					name: resourceName,
+					name: "create",
 					restful: true
 				});
 			}
 			if (routeResource.update && isAcceptableResource("update")) {
-				const resourceName = baseResourceName + ".update";
 				const handler = options.replace?.update || this.manageValidation(routeResource, "update");
-				this.put(path + "/:id", handler, {
+				this.put("/:id", handler, {
 					...options,
-					name: resourceName,
+					name: "update",
 					restful: true
 				});
 			}
 			if (routeResource.patch && isAcceptableResource("patch")) {
-				const resourceName = baseResourceName + ".patch";
 				const handler = options.replace?.patch || this.manageValidation(routeResource, "patch");
-				this.patch(path + "/:id", handler, {
+				this.patch("/:id", handler, {
 					...options,
-					name: resourceName,
-					restful: true
-				});
-			}
-			if (routeResource.delete && isAcceptableResource("delete")) {
-				const resourceName = baseResourceName + ".delete";
-				this.delete(path + "/:id", options.replace?.delete || routeResource.delete.bind(routeResource), {
-					...options,
-					name: resourceName,
-					restful: true
-				});
-			}
-			if (routeResource.bulkDelete && isAcceptableResource("delete")) {
-				const resourceName = baseResourceName + ".bulkDelete";
-				this.delete(path, options.replace?.bulkDelete || routeResource.bulkDelete.bind(routeResource), {
-					...options,
-					name: resourceName,
+					name: "patch",
 					restful: true
 				});
 			}
+			if (routeResource.delete && isAcceptableResource("delete")) this.delete("/:id", options.replace?.delete || routeResource.delete.bind(routeResource), {
+				...options,
+				name: "delete",
+				restful: true
+			});
+			if (routeResource.bulkDelete && isAcceptableResource("delete")) this.delete(path, options.replace?.bulkDelete || routeResource.bulkDelete.bind(routeResource), {
+				...options,
+				name: "bulkDelete",
+				restful: true
+			});
 			return this;
 		});
 	}
@@ -382,6 +392,7 @@ var Router = class Router {
 	*/
 	removeRoutesBySourceFile(sourceFile) {
 		this.routes = this.routes.filter((route) => route.sourceFile !== sourceFile);
+		forgetPositionalHandlerSuspects(sourceFile);
 		this.routesVersion++;
 	}
 	/**
@@ -408,12 +419,18 @@ var Router = class Router {
 				else if (methodValidation?.schema && resource.validation.all.schema) validation.schema = resource.validation.all.schema.merge(methodValidation.schema);
 				else if (methodValidation?.schema && !resource.validation.all.schema) validation.schema = methodValidation.schema;
 			}
-			if (validationMethods.all || validationMethods[method]) validation.validate = async (request, response) => {
+			if (validationMethods.all || validationMethods[method]) validation.validate = async ({ request, response }) => {
 				if (validationMethods.all) {
-					const output = await validationMethods.all.call(resource, request, response);
+					const output = await validationMethods.all.call(resource, {
+						request,
+						response
+					});
 					if (output) return output;
 				}
-				if (validationMethods[method]) return await validationMethods[method]?.call(resource, request, response);
+				if (validationMethods[method]) return await validationMethods[method]?.call(resource, {
+					request,
+					response
+				});
 			};
 			if (!isEmpty(validation)) handler.validation = validation;
 		} else {
@@ -443,6 +460,7 @@ var Router = class Router {
 	* Register routes to the server
 	*/
 	scan(server) {
+		reportPositionalHandlerSuspects();
 		this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));
 		this.routes.forEach((route) => {
 			const requestMethodFunction = server[route.method.toLowerCase()].bind(server);
@@ -469,6 +487,7 @@ var Router = class Router {
 	* Uses wildcard routing with find-my-way for HMR support
 	*/
 	scanDevServer(server) {
+		reportPositionalHandlerSuspects();
 		this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));
 		let routeRegistry;
 		let registryVersion = -1;
@@ -549,17 +568,22 @@ var Router = class Router {
 			request.response = response;
 			response.request = request;
 			request.setRequest(fastifyRequest).setRoute(route);
-			log.info({
-				module: "route",
-				action: route.method + " " + route.path.replace("/*", ""),
-				message: `Starting Request: ${request.id}`,
-				context: {
-					request,
-					response
-				}
-			});
 			return {
-				output: await request.execute(),
+				output: await logRequestLifecycle({
+					info: (entry) => log.info(entry),
+					warn: (entry) => log.warn(entry),
+					error: (entry) => log.error(entry),
+					now: () => performance.now()
+				}, {
+					module: "route",
+					action: describeRouteForLog(route.method, route.path),
+					requestId: request.id,
+					context: {
+						request,
+						response
+					},
+					statusCode: () => fastifyResponse.statusCode
+				}, () => request.execute()),
 				response,
 				request
 			};

package/esm/router/router.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"router.mjs","names":[],"sources":["../../../../../../../core/src/router/router.ts"],"sourcesContent":["import proxy, { type FastifyHttpProxyOptions } from \"@fastify/http-proxy\";\nimport fastifyStatic, { type FastifyStaticOptions } from \"@fastify/static\";\nimport concatRoute from \"@mongez/concat-route\";\nimport { ltrim, merge, toCamelCase, trim } from \"@mongez/reinforcements\";\nimport { isEmpty } from \"@mongez/supportive-is\";\nimport { log } from \"@warlock.js/logger\";\nimport type { FastifyReply, FastifyRequest } from \"fastify\";\nimport { container } from \"../container\";\nimport { Request } from \"../http/request\";\nimport { Response } from \"../http/response\";\nimport { type FastifyInstance } from \"../http/server\";\nimport { RouteBuilder } from \"./route-builder\";\nimport { RouteRegistry } from \"./route-registry\";\nimport type {\n  GroupedRoutesOptions,\n  RequestHandler,\n  RequestHandlerType,\n  RequestHandlerValidation,\n  ResourceMethod,\n  Route,\n  RouteOptions,\n  RouteResource,\n  RouterGroupCallback,\n  RouterStacks,\n} from \"./types\";\n\n/**\n * A Fastify lifecycle hook as it may be declared in a route's `serverOptions`.\n * Fastify accepts a single hook or an array in either position.\n */\ntype RouteLifecycleHook = (\n  request: FastifyRequest,\n  reply: FastifyReply,\n) => unknown | Promise<unknown>;\n\n/**\n * The pre-handler phases the dev server forwards from a route's `serverOptions`.\n *\n * These are the admission-control phases and they share the `(request, reply)`\n * signature. `preParsing` is deliberately absent — it must return the payload\n * stream, so forwarding it generically would corrupt the body rather than\n * guard it. `bodyLimit` cannot be forwarded at all; Fastify reads it at\n * registration time and no hook can bound a body already being parsed.\n */\nconst FORWARDED_ROUTE_PHASES = [\"onRequest\", \"preValidation\", \"preHandler\"] as const;\n\ntype ForwardedRoutePhase = (typeof FORWARDED_ROUTE_PHASES)[number];\n\n/**\n * The route the dev dispatcher matched, stashed on the request so the hooks and\n * the wildcard handler all act on one match rather than each matching again.\n */\ntype DevMatchedRoute = { route: Route; params: Record<string, string> };\n\ntype DevDispatchRequest = FastifyRequest & {\n  matchedDevRoute?: DevMatchedRoute;\n};\n\nfunction toHookList(\n  hook: RouteLifecycleHook | RouteLifecycleHook[] | undefined,\n): RouteLifecycleHook[] {\n  if (!hook) {\n    return [];\n  }\n\n  return Array.isArray(hook) ? hook : [hook];\n}\n\n/**\n * Run a matched route's hooks for one phase.\n *\n * Returning the reply is how an async Fastify hook signals that it has answered\n * the request; the chain must stop there, so the value is propagated rather\n * than discarded.\n */\nasync function runRouteHooks(\n  route: Route,\n  phase: ForwardedRoutePhase,\n  request: FastifyRequest,\n  reply: FastifyReply,\n) {\n  const hooks = toHookList(\n    route.serverOptions?.[phase] as RouteLifecycleHook | RouteLifecycleHook[] | undefined,\n  );\n\n  for (const hook of hooks) {\n    const outcome = await hook(request, reply);\n\n    if (outcome === reply) {\n      return reply;\n    }\n  }\n\n  return undefined;\n}\n\nexport class Router {\n  /**\n   * Routes list\n   */\n  private routes: Route[] = [];\n\n  /**\n   * Bumped on every mutation of {@link routes}.\n   *\n   * The dev dispatcher caches a route registry and needs to know when it is\n   * stale. Comparing `routes.length` would miss an HMR reload that replaces a\n   * route without changing the count — the registry would then keep matching\n   * paths that no longer exist. A version counter cannot miss that.\n   */\n  private routesVersion = 0;\n\n  /**\n   * Router Instance\n   */\n  private static instance: Router;\n\n  /**\n   * Static paths\n   */\n  protected staticDirectories: FastifyStaticOptions[] = [];\n\n  /**\n   * Event listeners\n   */\n  protected eventListeners: Record<string, ((router: Router, server: FastifyInstance) => void)[]> =\n    {};\n\n  /**\n   * Stacks\n   * Stacks will be used for grouping routes to add prefix, name or middleware\n   */\n  protected stacks: RouterStacks = {\n    prefix: [],\n    name: [],\n    middleware: [],\n  };\n\n  /**\n   * Get router instance\n   */\n  public static getInstance() {\n    if (!Router.instance) {\n      Router.instance = new Router();\n    }\n\n    return Router.instance;\n  }\n\n  private constructor() {\n    //\n  }\n\n  /**\n   * Listen to router before scan\n   */\n  public beforeScanning(callback: (router: Router, server: FastifyInstance) => void) {\n    this.eventListeners.beforeScan = [...(this.eventListeners.beforeScan || []), callback];\n\n    return this;\n  }\n\n  /**\n   * Listen to router after scanning\n   */\n  public afterScanning(callback: (router: Router, server: FastifyInstance) => void) {\n    this.eventListeners.afterScanning = [...(this.eventListeners.afterScanning || []), callback];\n\n    return this;\n  }\n\n  /**\n   * Redirect path to another path\n   */\n  public redirect(from: string, to: string, redirectMode: \"temporary\" | \"permanent\" = \"temporary\") {\n    return this.get(from, (_request, response) => {\n      response.redirect(to, redirectMode === \"temporary\" ? 302 : 301);\n    });\n  }\n\n  /**\n   * Server static folder\n   */\n  public directory(options: FastifyStaticOptions) {\n    this.staticDirectories.push(options);\n\n    return this;\n  }\n\n  /**\n   * Serve file\n   */\n  public file(path: string, location: string, cacheTime?: number) {\n    return this.get(path, (_request, response) => {\n      response.sendFile(location, cacheTime);\n    });\n  }\n\n  /**\n   * Serve cached file, it will cache the file to 1 year by default\n   */\n  public cachedFile(path: string, location: string, cacheTime?: number) {\n    return this.get(path, (_request, response) => {\n      response.sendCachedFile(location, cacheTime);\n    });\n  }\n\n  /**\n   * Serve list of files\n   */\n  public files(files: Record<string, string>, cacheTime?: number) {\n    for (const [path, location] of Object.entries(files)) {\n      this.get(path, (_request, response) => {\n        response.sendFile(location, cacheTime);\n      });\n    }\n  }\n\n  /**\n   * Serve list of cached files, it will cache the file to 1 year by default\n   */\n  public cachedFiles(files: Record<string, string>, cacheTime?: number) {\n    for (const [path, location] of Object.entries(files)) {\n      this.get(path, (_request, response) => {\n        response.sendCachedFile(location, cacheTime);\n      });\n    }\n  }\n\n  /**\n   * Add proxy route\n   */\n  public proxy(\n    path: string,\n    baseUrl: string,\n    options?: Omit<FastifyHttpProxyOptions, \"prefix\" | \"upstream\">,\n  ): this;\n  public proxy(options: FastifyHttpProxyOptions): this;\n  public proxy(...args: any[]) {\n    this.beforeScanning((_router, server) => {\n      if (args.length === 1) {\n        server.register(proxy, args[0]);\n      } else {\n        server.register(proxy, {\n          prefix: args[0],\n          upstream: args[1],\n          ...args[2],\n        });\n      }\n    });\n\n    return this;\n  }\n\n  /**\n   * Add route to routes list\n   */\n  public add(\n    method: Route[\"method\"],\n    path: string | string[],\n    handler: RequestHandlerType,\n    options: RouteOptions = {},\n  ) {\n    if (Array.isArray(path)) {\n      path.forEach((p) => this.add(method, p, handler, options));\n      return this;\n    }\n\n    const prefix = this.stacks.prefix.reduce((path, prefix) => {\n      return concatRoute(path, prefix);\n    }, \"\");\n\n    const name = this.stacks.name.reduceRight(\n      (name, prefixName) => {\n        return trim(prefixName + \".\" + name, \".\");\n      },\n      options.name || trim(path.replace(/\\//g, \".\"), \".\"),\n    );\n\n    path = concatRoute(prefix, path);\n\n    const middlewarePrecedence = options.middlewarePrecedence || \"after\";\n\n    if (middlewarePrecedence === \"before\") {\n      options.middleware = [...(options.middleware || []), ...this.stacks.middleware];\n    } else {\n      options.middleware = [...this.stacks.middleware, ...(options.middleware || [])];\n    }\n\n    if (Array.isArray(handler)) {\n      const [controller, action] = handler;\n\n      if (typeof controller[action] !== \"function\") {\n        throw new Error(\n          `Invalid controller action \"${action}\" for controller \"${controller.constructor.name}\"`,\n        );\n      }\n\n      handler = controller[action].bind(controller) as RequestHandler;\n\n      if (!handler.validation) {\n        handler.validation = {};\n        if (controller[`${action}ValidationSchema`]) {\n          handler.validation.schema = controller[`${action}ValidationSchema`]();\n        }\n\n        if (controller[`${action}Validate`]) {\n          handler.validation.validate = controller[`${action}Validate`];\n        }\n      }\n    }\n\n    const routeData: Route = {\n      method,\n      path,\n      handler,\n      ...options,\n      name,\n      rateLimit: options.rateLimit,\n      $prefix: prefix || \"/\",\n      // it must be a new array to avoid modifying the original array\n      $prefixStack: [...this.stacks.prefix],\n      // Inject source file from stacks if set\n      sourceFile: this.stacks.sourceFile || \"\",\n    };\n\n    if (routeData.name) {\n      // check if the name exists\n      const route = this.routes.find((route) => route.name === routeData.name);\n\n      if (route) {\n        // check again if the route name exists with the same method\n        if (route.method === routeData.method) {\n          throw new Error(`Route name \"${routeData.name}\" already exists`);\n        } else {\n          routeData.name += `.${routeData.method.toLowerCase()}`;\n        }\n      }\n    }\n\n    this.routes.push(routeData);\n\n    this.routesVersion++;\n\n    return this;\n  }\n\n  /**\n   * Add a request that accepts all methods\n   */\n  public any(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"all\" as Route[\"method\"], path, handler, options);\n  }\n\n  /**\n   * Add get request method\n   */\n  public get(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"GET\", path, handler, options);\n  }\n\n  /**\n   * Add post request method\n   */\n  public post(path: string | string[], handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"POST\", path, handler, options);\n  }\n\n  /**\n   * Add put request method\n   */\n  public put(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"PUT\", path, handler, options);\n  }\n\n  /**\n   * Add delete request method\n   */\n  public delete(path: string | string[], handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"DELETE\", path, handler, options);\n  }\n\n  /**\n   * Add patch request method\n   */\n  public patch(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"PATCH\", path, handler, options);\n  }\n\n  /**\n   * Add head request method\n   */\n  public head(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"HEAD\", path, handler, options);\n  }\n\n  /**\n   * Add options request method\n   */\n  public options(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"OPTIONS\", path, handler, options);\n  }\n\n  /**\n   * Get a chainable route builder for the same route path\n   */\n  public route(path: string, options: RouteOptions = {}) {\n    return new RouteBuilder(this, path, options);\n  }\n\n  /**\n   * Add full restful resource routes\n   * This method will generate the following routes:\n   * 1. GET /path: list all resources\n   * 2. GET /path/:id: get a single resource\n   * 3. POST /path: create a new resource\n   * 4. PUT /path/:id: update a resource\n   * 5. DELETE /path/:id: delete a resource\n   * 6. PATCH /path/:id: update a resource partially\n   */\n  public restfulResource(\n    path: string,\n    resource: RouteResource,\n    options: RouteOptions & {\n      only?: ResourceMethod[];\n      except?: ResourceMethod[];\n      replace?: Partial<Record<ResourceMethod, RequestHandler>> & {\n        bulkDelete?: RequestHandler;\n      };\n    } = {},\n  ) {\n    return this.prefix(path, () => {\n      path = \"\";\n      // get base resource name\n      const baseResourceName = options.name || toCamelCase(ltrim(path, \"/\"));\n\n      // clone the resource so we don't mess up with it\n      const routeResource = resource;\n\n      const isAcceptableResource = (type: ResourceMethod) => {\n        return Boolean(\n          // check if the route is not excluded\n          (!options.except || !options.except.includes(type)) &&\n          // check if the only option is set and the route is included\n          (!options.only || options.only.includes(type)),\n        );\n      };\n\n      if (routeResource.list && isAcceptableResource(\"list\")) {\n        const resourceName = baseResourceName + \".list\";\n        this.get(path, options.replace?.list || routeResource.list.bind(routeResource), {\n          ...options,\n          name: resourceName,\n          restful: true,\n        });\n      }\n\n      if (routeResource.get && isAcceptableResource(\"get\")) {\n        const resourceName = baseResourceName + \".single\";\n\n        this.get(path + \"/:id\", options.replace?.get || routeResource.get.bind(routeResource), {\n          ...options,\n          name: resourceName,\n          restful: true,\n        });\n      }\n\n      if (routeResource.create && isAcceptableResource(\"create\")) {\n        const resourceName = baseResourceName + \".create\";\n\n        const handler = options.replace?.create || this.manageValidation(routeResource, \"create\");\n\n        this.post(path, handler, {\n          ...options,\n          name: resourceName,\n          restful: true,\n        });\n      }\n\n      if (routeResource.update && isAcceptableResource(\"update\")) {\n        const resourceName = baseResourceName + \".update\";\n\n        const handler = options.replace?.update || this.manageValidation(routeResource, \"update\");\n\n        this.put(path + \"/:id\", handler, {\n          ...options,\n          name: resourceName,\n          restful: true,\n        });\n      }\n\n      if (routeResource.patch && isAcceptableResource(\"patch\")) {\n        const resourceName = baseResourceName + \".patch\";\n\n        const handler = options.replace?.patch || this.manageValidation(routeResource, \"patch\");\n\n        this.patch(path + \"/:id\", handler, {\n          ...options,\n          name: resourceName,\n          restful: true,\n        });\n      }\n\n      if (routeResource.delete && isAcceptableResource(\"delete\")) {\n        const resourceName = baseResourceName + \".delete\";\n\n        this.delete(\n          path + \"/:id\",\n          options.replace?.delete || routeResource.delete.bind(routeResource),\n          {\n            ...options,\n            name: resourceName,\n            restful: true,\n          },\n        );\n      }\n\n      if (routeResource.bulkDelete && isAcceptableResource(\"delete\")) {\n        const resourceName = baseResourceName + \".bulkDelete\";\n\n        this.delete(\n          path,\n          options.replace?.bulkDelete || routeResource.bulkDelete.bind(routeResource),\n          {\n            ...options,\n            name: resourceName,\n            restful: true,\n          },\n        );\n      }\n\n      return this;\n    });\n  }\n\n  /**\n   * Group routes with options\n   */\n  public group(options: GroupedRoutesOptions, callback: RouterGroupCallback) {\n    const {\n      prefix,\n      // name must always be defined because\n      // if there are multiple groups without name\n      // they might generate the same route name\n      // thus causing an error\n      // in this case we need always to make sure that\n      // the name is always defined.\n      name = prefix ? trim(prefix.replace(/\\//g, \".\"), \".\") : undefined,\n      middleware,\n    } = options;\n\n    if (prefix) {\n      this.stacks.prefix.push(prefix);\n    }\n\n    if (name) {\n      this.stacks.name.push(name);\n    }\n\n    if (middleware) {\n      this.stacks.middleware.push(...middleware);\n    }\n\n    try {\n      callback();\n    } finally {\n      // Always pop/splice this group's stacks, even if the callback throws,\n      // so a throwing group never leaks state onto the process-global singleton.\n      if (prefix) {\n        this.stacks.prefix.pop();\n      }\n\n      if (name) {\n        this.stacks.name.pop();\n      }\n\n      if (middleware) {\n        this.stacks.middleware.splice(\n          this.stacks.middleware.length - middleware.length,\n          middleware.length,\n        );\n      }\n    }\n\n    return this;\n  }\n\n  /**\n   * Add prefix to all routes in the given callback\n   */\n  public prefix(prefix: string, callback: () => void) {\n    return this.group({ prefix }, callback);\n  }\n\n  /**\n   * Add API version prefix to all routes in the given callback\n   * Automatically formats the version as /v{version}\n   * @example\n   * router.version(\"1\", () => {\n   *   router.get(\"/users\", getUsersV1); // /v1/users\n   * });\n   *\n   * router.version(\"2\", () => {\n   *   router.get(\"/users\", getUsersV2); // /v2/users\n   * });\n   */\n  public version(version: string | number, callback: () => void) {\n    return this.prefix(`/v${version}`, callback);\n  }\n\n  /**\n   * Wrap route additions with a source file path\n   * Used for tracking which routes come from which file (for HMR)\n   * @param sourceFile Relative path to the source file (e.g., \"src/app/users/routes.ts\")\n   * @param callback Function that adds routes (will have sourceFile injected)\n   */\n  public async withSourceFile<T = any>(\n    sourceFile: string,\n    callback: () => T | Promise<T>,\n  ): Promise<T | undefined> {\n    // Set source file in stacks\n    this.stacks.sourceFile = sourceFile;\n\n    try {\n      // Execute callback (routes added here will have sourceFile injected)\n      return await callback();\n    } catch (error) {\n      // Log loudly, then RETHROW. Swallowing here silently dropped a whole\n      // route file (duplicate name, invalid action, import error) so the\n      // surface 404'd with no boot error. The caller decides what a throw\n      // means: at boot it aborts the boot, during HMR the dev server's\n      // batch-reload handler catches it, prints it, and keeps serving.\n      log.error({\n        module: \"router\",\n        action: \"registerRoutes\",\n        message: `Failed to register routes from \"${sourceFile}\"`,\n        context: { sourceFile, error },\n      });\n\n      throw error;\n    } finally {\n      // Always clear source file from stacks so a throwing file never leaks\n      // its sourceFile onto the process-global singleton.\n      delete this.stacks.sourceFile;\n    }\n  }\n\n  /**\n   * Remove all routes that belong to a specific source file\n   * Used when reloading routes files via HMR\n   * @param sourceFile Relative path to the source file\n   */\n  public removeRoutesBySourceFile(sourceFile: string): void {\n    this.routes = this.routes.filter((route) => route.sourceFile !== sourceFile);\n\n    this.routesVersion++;\n  }\n\n  /**\n   * Manage validation system for the given resource\n   */\n  private manageValidation(resource: RouteResource, method: \"create\" | \"update\" | \"patch\") {\n    const handler = resource[method]?.bind(resource) as RequestHandler;\n\n    const methodValidation = resource?.validation?.[method];\n\n    if (method === \"patch\") {\n      handler.validation = methodValidation;\n\n      if (handler.validation?.validate) {\n        handler.validation.validate = handler.validation.validate.bind(resource);\n      }\n\n      if (resource.validation?.patch) {\n        handler.validation = merge(resource.validation.patch, handler.validation);\n      }\n\n      return handler;\n    }\n\n    if (!resource.validation || (!methodValidation && !resource.validation.all)) return handler;\n\n    if (resource.validation.all) {\n      const validationMethods = {\n        all: resource?.validation?.all?.validate,\n        [method]: methodValidation?.validate,\n      };\n\n      const validation: RequestHandlerValidation = {};\n\n      if (resource.validation.all.schema || methodValidation?.schema) {\n        if (!methodValidation?.schema && resource.validation.all.schema) {\n          // Case 2: Only all.schema exists - clone it for this method\n          validation.schema = resource.validation.all.schema;\n        } else if (methodValidation?.schema && resource.validation.all.schema) {\n          // Case 3: Both exist - merge them (all is base, method overrides)\n          validation.schema = resource.validation.all.schema.merge(methodValidation.schema);\n        } else if (methodValidation?.schema && !resource.validation.all.schema) {\n          // Case 1: Only method schema exists - use it directly\n          validation.schema = methodValidation.schema;\n        }\n        // Case 4: Neither exists - handled by outer if being false\n      }\n\n      if (validationMethods.all || validationMethods[method]) {\n        validation.validate = async (request: Request, response: Response) => {\n          if (validationMethods.all) {\n            const output = await validationMethods.all.call(resource, request, response);\n\n            if (output) return output;\n          }\n\n          if (validationMethods[method]) {\n            return await validationMethods[method]?.call(resource, request, response);\n          }\n\n          return;\n        };\n      }\n\n      if (!isEmpty(validation)) {\n        handler.validation = validation;\n      }\n    } else {\n      handler.validation = resource.validation[method];\n\n      if (handler.validation?.validate) {\n        handler.validation.validate = handler.validation.validate.bind(resource);\n      }\n    }\n\n    return handler;\n  }\n\n  /**\n   * Get all routes list\n   */\n  public list() {\n    return this.routes;\n  }\n\n  /**\n   * Number of routes currently registered on the singleton.\n   *\n   * Used as a readiness signal: a successful boot that ends up with zero\n   * routes almost always means a route module failed to register silently\n   * (see `withSourceFile`), so callers can surface that instead of letting\n   * the whole surface 404.\n   */\n  public routeCount(): number {\n    return this.routes.length;\n  }\n\n  /**\n   * Register routes to the server\n   */\n  public scan(server: FastifyInstance) {\n    this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));\n\n    this.routes.forEach((route) => {\n      const requestMethod = route.method.toLowerCase();\n      const requestMethodFunction = server[requestMethod].bind(server);\n\n      const options = {\n        ...route.serverOptions,\n        config: {\n          ...route.serverOptions?.config,\n          ...(route.rateLimit && { rateLimit: route.rateLimit }),\n        },\n      };\n\n      requestMethodFunction(\n        route.path,\n        options,\n        async (baseRequest: FastifyRequest, reply: FastifyReply) => {\n          const { output, response } = await this.handleRoute(route)(baseRequest, reply);\n\n          return output || response.baseResponse;\n        },\n      );\n    });\n\n    for (const directoryOptions of this.staticDirectories) {\n      server.register(fastifyStatic, {\n        ...directoryOptions,\n        decorateReply: false,\n      });\n    }\n\n    this.eventListeners.afterScanning?.forEach((callback) => callback(this, server));\n  }\n\n  /**\n   * Scan routes for the development server\n   * Uses wildcard routing with find-my-way for HMR support\n   */\n  public scanDevServer(server: FastifyInstance) {\n    this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));\n\n    let routeRegistry: RouteRegistry | undefined;\n    let registryVersion = -1;\n\n    // Rebuilt when the route table changes rather than per request. Building it\n    // inside the handler re-registered every route on every hit — and `all`\n    // routes expand into seven registrations each. Keyed on `routesVersion`\n    // rather than on the route count, so an HMR reload that swaps a route\n    // without changing the count still invalidates.\n    const resolveRouteRegistry = () => {\n      if (routeRegistry && registryVersion === this.routesVersion) {\n        return routeRegistry;\n      }\n\n      routeRegistry = new RouteRegistry();\n\n      routeRegistry.register(this.routes);\n\n      registryVersion = this.routesVersion;\n\n      return routeRegistry;\n    };\n\n    // Matching happens here, in Fastify's own onRequest phase, so a route's\n    // `serverOptions.onRequest` still runs BEFORE body parsing. Production\n    // `scan()` gets that from per-route registration; the wildcard dispatcher\n    // has no per-route slot, so without this the hook silently never runs.\n    server.addHook(\n      \"onRequest\",\n      async (fastifyRequest: FastifyRequest, fastifyReply: FastifyReply) => {\n        const match = resolveRouteRegistry().find(fastifyRequest.method, fastifyRequest.url);\n\n        if (!match) {\n          return undefined;\n        }\n\n        (fastifyRequest as DevDispatchRequest).matchedDevRoute = match;\n\n        fastifyRequest.params = match.params;\n\n        return runRouteHooks(match.route, \"onRequest\", fastifyRequest, fastifyReply);\n      },\n    );\n\n    for (const phase of FORWARDED_ROUTE_PHASES.filter((name) => name !== \"onRequest\")) {\n      server.addHook(phase, async (fastifyRequest: FastifyRequest, fastifyReply: FastifyReply) => {\n        const match = (fastifyRequest as DevDispatchRequest).matchedDevRoute;\n\n        if (!match) {\n          return undefined;\n        }\n\n        return runRouteHooks(match.route, phase, fastifyRequest, fastifyReply);\n      });\n    }\n\n    // Shared handler for wildcard routing\n    const wildcardHandler = async (fastifyRequest: FastifyRequest, fastifyReply: FastifyReply) => {\n      const match = (fastifyRequest as DevDispatchRequest).matchedDevRoute;\n\n      // No match found - return 404\n      if (!match) {\n        return fastifyReply.code(404).send({\n          error: \"Route not found\",\n          path: fastifyRequest.url,\n          method: fastifyRequest.method,\n        });\n      }\n\n      try {\n        // Call the matched route handler\n        const { output, response } = await this.handleRoute(match.route)(\n          fastifyRequest,\n          fastifyReply,\n        );\n\n        return output || response.baseResponse;\n      } catch (error) {\n        log.error(\"router\", \"dev-dispatch\", error as Error, {\n          method: fastifyRequest.method,\n          url: fastifyRequest.url,\n        });\n\n        throw error;\n      }\n    };\n\n    // Register wildcard route for all methods EXCEPT OPTIONS (to avoid conflict with CORS)\n    // OPTIONS is handled by @fastify/cors plugin for preflight requests\n    const methods = [\"GET\", \"POST\", \"PUT\", \"DELETE\", \"PATCH\"] as const;\n    for (const method of methods) {\n      server.route({\n        method,\n        url: \"*\",\n        handler: wildcardHandler,\n      });\n    }\n\n    // Register static directories\n    for (const directoryOptions of this.staticDirectories) {\n      server.register(fastifyStatic, {\n        ...directoryOptions,\n        decorateReply: false,\n      });\n    }\n\n    this.eventListeners.afterScanning?.forEach((callback) => callback(this, server));\n  }\n\n  /**\n   * Get the route path for the given route name\n   */\n  public getRoute(name: string, params: any = {}) {\n    const route = this.routes.find((route) => route.name === name);\n\n    if (!route) {\n      throw new Error(`Route name \"${name}\" not found`);\n    }\n\n    let path = route.path;\n\n    if (route.path.includes(\":\")) {\n      Object.keys(params).forEach((key) => {\n        path = path.replace(\":\" + key, params[key]);\n      });\n    }\n\n    return path;\n  }\n\n  /**\n   * Handle the given route\n   */\n  private handleRoute(route: Route) {\n    return async (fastifyRequest: FastifyRequest, fastifyResponse: FastifyReply) => {\n      const request = new Request();\n      const response = new Response();\n      response.setResponse(fastifyResponse);\n      request.response = response;\n\n      response.request = request;\n\n      request.setRequest(fastifyRequest).setRoute(route);\n\n      log.info({\n        module: \"route\",\n        action: route.method + \" \" + route.path.replace(\"/*\", \"\"),\n        message: `Starting Request: ${request.id}`,\n        context: {\n          request,\n          response,\n        },\n      });\n\n      const result = await request.execute();\n\n      return {\n        output: result,\n        response,\n        request,\n      };\n    };\n  }\n}\n\nexport const router = Router.getInstance();\n\ncontainer.set(\"router\", router);\n"],"mappings":"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"}
+{"version":3,"file":"router.mjs","names":[],"sources":["../../../../../../../core/src/router/router.ts"],"sourcesContent":["import proxy, { type FastifyHttpProxyOptions } from \"@fastify/http-proxy\";\nimport fastifyStatic, { type FastifyStaticOptions } from \"@fastify/static\";\nimport concatRoute from \"@mongez/concat-route\";\nimport { ltrim, merge, toCamelCase, trim } from \"@mongez/reinforcements\";\nimport { isEmpty } from \"@mongez/supportive-is\";\nimport { log } from \"@warlock.js/logger\";\nimport type { FastifyReply, FastifyRequest } from \"fastify\";\nimport { container } from \"../container\";\nimport { Request } from \"../http/request\";\nimport { Response } from \"../http/response\";\nimport { type FastifyInstance } from \"../http/server\";\nimport { describeRouteForLog } from \"./describe-route-for-log\";\nimport { logRequestLifecycle } from \"./log-request-lifecycle\";\nimport {\n  forgetPositionalHandlerSuspects,\n  inspectHandlerSignature,\n  reportPositionalHandlerSuspects,\n} from \"./positional-handler-diagnostics\";\nimport { RouteBuilder } from \"./route-builder\";\nimport { RouteRegistry } from \"./route-registry\";\nimport type {\n  GroupedRoutesOptions,\n  HttpContext,\n  RequestHandler,\n  RequestHandlerType,\n  RequestHandlerValidation,\n  ResourceMethod,\n  Route,\n  RouteOptions,\n  RouteResource,\n  RouterGroupCallback,\n  RouterStacks,\n} from \"./types\";\n\n/**\n * A Fastify lifecycle hook as it may be declared in a route's `serverOptions`.\n * Fastify accepts a single hook or an array in either position.\n */\ntype RouteLifecycleHook = (\n  request: FastifyRequest,\n  reply: FastifyReply,\n) => unknown | Promise<unknown>;\n\n/**\n * The pre-handler phases the dev server forwards from a route's `serverOptions`.\n *\n * These are the admission-control phases and they share the `(request, reply)`\n * signature. `preParsing` is deliberately absent — it must return the payload\n * stream, so forwarding it generically would corrupt the body rather than\n * guard it. `bodyLimit` cannot be forwarded at all; Fastify reads it at\n * registration time and no hook can bound a body already being parsed.\n */\nconst FORWARDED_ROUTE_PHASES = [\"onRequest\", \"preValidation\", \"preHandler\"] as const;\n\ntype ForwardedRoutePhase = (typeof FORWARDED_ROUTE_PHASES)[number];\n\n/**\n * The route the dev dispatcher matched, stashed on the request so the hooks and\n * the wildcard handler all act on one match rather than each matching again.\n */\ntype DevMatchedRoute = { route: Route; params: Record<string, string> };\n\ntype DevDispatchRequest = FastifyRequest & {\n  matchedDevRoute?: DevMatchedRoute;\n};\n\nfunction toHookList(\n  hook: RouteLifecycleHook | RouteLifecycleHook[] | undefined,\n): RouteLifecycleHook[] {\n  if (!hook) {\n    return [];\n  }\n\n  return Array.isArray(hook) ? hook : [hook];\n}\n\n/**\n * Run a matched route's hooks for one phase.\n *\n * Returning the reply is how an async Fastify hook signals that it has answered\n * the request; the chain must stop there, so the value is propagated rather\n * than discarded.\n */\nasync function runRouteHooks(\n  route: Route,\n  phase: ForwardedRoutePhase,\n  request: FastifyRequest,\n  reply: FastifyReply,\n) {\n  const hooks = toHookList(\n    route.serverOptions?.[phase] as RouteLifecycleHook | RouteLifecycleHook[] | undefined,\n  );\n\n  for (const hook of hooks) {\n    const outcome = await hook(request, reply);\n\n    if (outcome === reply) {\n      return reply;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Describe one claimant of a route name, for the duplicate-name error.\n *\n * `warlock dev` registers SSR page routes on the same router as API routes, so\n * the two share a single route-name namespace and collide across kinds. The\n * error is only actionable if it says which claimant is which, so `isPage` —\n * the router's only route-kind discriminator — is what separates them here.\n *\n * `sourceFile` is stamped only on routes registered through `withSourceFile`,\n * which page routes are not (the stack is a single slot, so page installation\n * cannot nest inside a route file's scope without clobbering it). Say the\n * source is unknown rather than printing an empty string.\n */\nfunction describeRouteClaimant(route: Route) {\n  const type = route.isPage ? \"page route\" : \"API route\";\n  const source = route.sourceFile ? `declared in ${route.sourceFile}` : \"source file unknown\";\n\n  return `${type} ${route.method} ${route.path} (${source})`;\n}\n\nexport class Router {\n  /**\n   * Routes list\n   */\n  private routes: Route[] = [];\n\n  /**\n   * Bumped on every mutation of {@link routes}.\n   *\n   * The dev dispatcher caches a route registry and needs to know when it is\n   * stale. Comparing `routes.length` would miss an HMR reload that replaces a\n   * route without changing the count — the registry would then keep matching\n   * paths that no longer exist. A version counter cannot miss that.\n   */\n  private routesVersion = 0;\n\n  /**\n   * Router Instance\n   */\n  private static instance: Router;\n\n  /**\n   * Static paths\n   */\n  protected staticDirectories: FastifyStaticOptions[] = [];\n\n  /**\n   * Event listeners\n   */\n  protected eventListeners: Record<string, ((router: Router, server: FastifyInstance) => void)[]> =\n    {};\n\n  /**\n   * Stacks\n   * Stacks will be used for grouping routes to add prefix, name or middleware\n   */\n  protected stacks: RouterStacks = {\n    prefix: [],\n    name: [],\n    middleware: [],\n  };\n\n  /**\n   * Get router instance\n   */\n  public static getInstance() {\n    if (!Router.instance) {\n      Router.instance = new Router();\n    }\n\n    return Router.instance;\n  }\n\n  private constructor() {\n    //\n  }\n\n  /**\n   * Listen to router before scan\n   */\n  public beforeScanning(callback: (router: Router, server: FastifyInstance) => void) {\n    this.eventListeners.beforeScan = [...(this.eventListeners.beforeScan || []), callback];\n\n    return this;\n  }\n\n  /**\n   * Listen to router after scanning\n   */\n  public afterScanning(callback: (router: Router, server: FastifyInstance) => void) {\n    this.eventListeners.afterScanning = [...(this.eventListeners.afterScanning || []), callback];\n\n    return this;\n  }\n\n  /**\n   * Redirect path to another path\n   */\n  public redirect(from: string, to: string, redirectMode: \"temporary\" | \"permanent\" = \"temporary\") {\n    return this.get(from, ({ response }) => {\n      response.redirect(to, redirectMode === \"temporary\" ? 302 : 301);\n    });\n  }\n\n  /**\n   * Server static folder\n   */\n  public directory(options: FastifyStaticOptions) {\n    this.staticDirectories.push(options);\n\n    return this;\n  }\n\n  /**\n   * Serve file\n   */\n  public file(path: string, location: string, cacheTime?: number) {\n    return this.get(path, ({ response }) => {\n      response.sendFile(location, cacheTime);\n    });\n  }\n\n  /**\n   * Serve cached file, it will cache the file to 1 year by default\n   */\n  public cachedFile(path: string, location: string, cacheTime?: number) {\n    return this.get(path, ({ response }) => {\n      response.sendCachedFile(location, cacheTime);\n    });\n  }\n\n  /**\n   * Serve list of files\n   */\n  public files(files: Record<string, string>, cacheTime?: number) {\n    for (const [path, location] of Object.entries(files)) {\n      this.get(path, ({ response }) => {\n        response.sendFile(location, cacheTime);\n      });\n    }\n  }\n\n  /**\n   * Serve list of cached files, it will cache the file to 1 year by default\n   */\n  public cachedFiles(files: Record<string, string>, cacheTime?: number) {\n    for (const [path, location] of Object.entries(files)) {\n      this.get(path, ({ response }) => {\n        response.sendCachedFile(location, cacheTime);\n      });\n    }\n  }\n\n  /**\n   * Add proxy route\n   */\n  public proxy(\n    path: string,\n    baseUrl: string,\n    options?: Omit<FastifyHttpProxyOptions, \"prefix\" | \"upstream\">,\n  ): this;\n  public proxy(options: FastifyHttpProxyOptions): this;\n  public proxy(...args: any[]) {\n    this.beforeScanning((_router, server) => {\n      if (args.length === 1) {\n        server.register(proxy, args[0]);\n      } else {\n        server.register(proxy, {\n          prefix: args[0],\n          upstream: args[1],\n          ...args[2],\n        });\n      }\n    });\n\n    return this;\n  }\n\n  /**\n   * Add route to routes list\n   */\n  public add(\n    method: Route[\"method\"],\n    path: string | string[],\n    handler: RequestHandlerType,\n    options: RouteOptions = {},\n  ) {\n    if (Array.isArray(path)) {\n      path.forEach((p) => this.add(method, p, handler, options));\n      return this;\n    }\n\n    const prefix = this.stacks.prefix.reduce((path, prefix) => {\n      return concatRoute(path, prefix);\n    }, \"\");\n\n    const name = this.stacks.name.reduceRight(\n      (name, prefixName) => {\n        return trim(prefixName + \".\" + name, \".\");\n      },\n      options.name || trim(path.replace(/\\//g, \".\"), \".\"),\n    );\n\n    path = concatRoute(prefix, path);\n\n    const middlewarePrecedence = options.middlewarePrecedence || \"after\";\n\n    if (middlewarePrecedence === \"before\") {\n      options.middleware = [...(options.middleware || []), ...this.stacks.middleware];\n    } else {\n      options.middleware = [...this.stacks.middleware, ...(options.middleware || [])];\n    }\n\n    if (Array.isArray(handler)) {\n      const [controller, action] = handler;\n\n      if (typeof controller[action] !== \"function\") {\n        throw new Error(\n          `Invalid controller action \"${action}\" for controller \"${controller.constructor.name}\"`,\n        );\n      }\n\n      handler = controller[action].bind(controller) as RequestHandler;\n\n      if (!handler.validation) {\n        handler.validation = {};\n        if (controller[`${action}ValidationSchema`]) {\n          handler.validation.schema = controller[`${action}ValidationSchema`]();\n        }\n\n        if (controller[`${action}Validate`]) {\n          handler.validation.validate = controller[`${action}Validate`];\n        }\n      }\n    }\n\n    const routeData: Route = {\n      method,\n      path,\n      handler,\n      ...options,\n      name,\n      rateLimit: options.rateLimit,\n      $prefix: prefix || \"/\",\n      // it must be a new array to avoid modifying the original array\n      $prefixStack: [...this.stacks.prefix],\n      // Inject source file from stacks if set\n      sourceFile: this.stacks.sourceFile || \"\",\n    };\n\n    if (routeData.name) {\n      // check if the name exists\n      const route = this.routes.find((route) => route.name === routeData.name);\n\n      if (route) {\n        // check again if the route name exists with the same method\n        if (route.method === routeData.method) {\n          throw new Error(\n            `Route name \"${routeData.name}\" is already taken.\\n` +\n              `  already registered: ${describeRouteClaimant(route)}\\n` +\n              `  now being added:    ${describeRouteClaimant(routeData)}\\n` +\n              `Pages and API routes share one route-name namespace, so a name can only be ` +\n              `claimed once. Rename one of them via the \"name\" route option.`,\n          );\n        } else {\n          routeData.name += `.${routeData.method.toLowerCase()}`;\n        }\n      }\n    }\n\n    // Registration-time only — nothing here runs per request. Suspects are\n    // collected now and reported together at boot (see `scan`), so a route file\n    // written against v4 produces one legible list instead of a mystery 500 per\n    // request. Recorded after the collision check so a route that never lands\n    // is never reported.\n    inspectHandlerSignature(routeData.handler, routeData);\n\n    this.routes.push(routeData);\n\n    this.routesVersion++;\n\n    return this;\n  }\n\n  /**\n   * Add a request that accepts all methods\n   */\n  public any(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"all\" as Route[\"method\"], path, handler, options);\n  }\n\n  /**\n   * Add get request method\n   */\n  public get(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"GET\", path, handler, options);\n  }\n\n  /**\n   * Add post request method\n   */\n  public post(path: string | string[], handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"POST\", path, handler, options);\n  }\n\n  /**\n   * Add put request method\n   */\n  public put(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"PUT\", path, handler, options);\n  }\n\n  /**\n   * Add delete request method\n   */\n  public delete(path: string | string[], handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"DELETE\", path, handler, options);\n  }\n\n  /**\n   * Add patch request method\n   */\n  public patch(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"PATCH\", path, handler, options);\n  }\n\n  /**\n   * Add head request method\n   */\n  public head(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"HEAD\", path, handler, options);\n  }\n\n  /**\n   * Add options request method\n   */\n  public options(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\n    return this.add(\"OPTIONS\", path, handler, options);\n  }\n\n  /**\n   * Get a chainable route builder for the same route path\n   */\n  public route(path: string, options: RouteOptions = {}) {\n    return new RouteBuilder(this, path, options);\n  }\n\n  /**\n   * Add full restful resource routes\n   * This method will generate the following routes:\n   * 1. GET /path: list all resources\n   * 2. GET /path/:id: get a single resource\n   * 3. POST /path: create a new resource\n   * 4. PUT /path/:id: update a resource\n   * 5. DELETE /path/:id: delete a resource\n   * 6. PATCH /path/:id: update a resource partially\n   */\n  public restfulResource(\n    path: string,\n    resource: RouteResource,\n    options: RouteOptions & {\n      only?: ResourceMethod[];\n      except?: ResourceMethod[];\n      replace?: Partial<Record<ResourceMethod, RequestHandler>> & {\n        bulkDelete?: RequestHandler;\n      };\n    } = {},\n  ) {\n    // Derive the base resource name from the path before the group below\n    // clears it for use as the routes' relative path. `options.name`, when\n    // given, replaces the path-derived name entirely (see the explicit\n    // `name` passed to `group()`) rather than composing with it.\n    const baseResourceName = options.name || toCamelCase(ltrim(path, \"/\"));\n\n    return this.group({ prefix: path, name: baseResourceName }, () => {\n      const path = \"\";\n\n      // clone the resource so we don't mess up with it\n      const routeResource = resource;\n\n      const isAcceptableResource = (type: ResourceMethod) => {\n        return Boolean(\n          // check if the route is not excluded\n          (!options.except || !options.except.includes(type)) &&\n          // check if the only option is set and the route is included\n          (!options.only || options.only.includes(type)),\n        );\n      };\n\n      if (routeResource.list && isAcceptableResource(\"list\")) {\n        this.get(path, options.replace?.list || routeResource.list.bind(routeResource), {\n          ...options,\n          name: \"list\",\n          restful: true,\n        });\n      }\n\n      if (routeResource.get && isAcceptableResource(\"get\")) {\n        this.get(path + \"/:id\", options.replace?.get || routeResource.get.bind(routeResource), {\n          ...options,\n          name: \"single\",\n          restful: true,\n        });\n      }\n\n      if (routeResource.create && isAcceptableResource(\"create\")) {\n        const handler = options.replace?.create || this.manageValidation(routeResource, \"create\");\n\n        this.post(path, handler, {\n          ...options,\n          name: \"create\",\n          restful: true,\n        });\n      }\n\n      if (routeResource.update && isAcceptableResource(\"update\")) {\n        const handler = options.replace?.update || this.manageValidation(routeResource, \"update\");\n\n        this.put(path + \"/:id\", handler, {\n          ...options,\n          name: \"update\",\n          restful: true,\n        });\n      }\n\n      if (routeResource.patch && isAcceptableResource(\"patch\")) {\n        const handler = options.replace?.patch || this.manageValidation(routeResource, \"patch\");\n\n        this.patch(path + \"/:id\", handler, {\n          ...options,\n          name: \"patch\",\n          restful: true,\n        });\n      }\n\n      if (routeResource.delete && isAcceptableResource(\"delete\")) {\n        this.delete(\n          path + \"/:id\",\n          options.replace?.delete || routeResource.delete.bind(routeResource),\n          {\n            ...options,\n            name: \"delete\",\n            restful: true,\n          },\n        );\n      }\n\n      if (routeResource.bulkDelete && isAcceptableResource(\"delete\")) {\n        this.delete(\n          path,\n          options.replace?.bulkDelete || routeResource.bulkDelete.bind(routeResource),\n          {\n            ...options,\n            name: \"bulkDelete\",\n            restful: true,\n          },\n        );\n      }\n\n      return this;\n    });\n  }\n\n  /**\n   * Group routes with options\n   */\n  public group(options: GroupedRoutesOptions, callback: RouterGroupCallback) {\n    const {\n      prefix,\n      // name must always be defined because\n      // if there are multiple groups without name\n      // they might generate the same route name\n      // thus causing an error\n      // in this case we need always to make sure that\n      // the name is always defined.\n      name = prefix ? trim(prefix.replace(/\\//g, \".\"), \".\") : undefined,\n      middleware,\n    } = options;\n\n    if (prefix) {\n      this.stacks.prefix.push(prefix);\n    }\n\n    if (name) {\n      this.stacks.name.push(name);\n    }\n\n    if (middleware) {\n      this.stacks.middleware.push(...middleware);\n    }\n\n    try {\n      callback();\n    } finally {\n      // Always pop/splice this group's stacks, even if the callback throws,\n      // so a throwing group never leaks state onto the process-global singleton.\n      if (prefix) {\n        this.stacks.prefix.pop();\n      }\n\n      if (name) {\n        this.stacks.name.pop();\n      }\n\n      if (middleware) {\n        this.stacks.middleware.splice(\n          this.stacks.middleware.length - middleware.length,\n          middleware.length,\n        );\n      }\n    }\n\n    return this;\n  }\n\n  /**\n   * Add prefix to all routes in the given callback\n   */\n  public prefix(prefix: string, callback: () => void) {\n    return this.group({ prefix }, callback);\n  }\n\n  /**\n   * Add API version prefix to all routes in the given callback\n   * Automatically formats the version as /v{version}\n   * @example\n   * router.version(\"1\", () => {\n   *   router.get(\"/users\", getUsersV1); // /v1/users\n   * });\n   *\n   * router.version(\"2\", () => {\n   *   router.get(\"/users\", getUsersV2); // /v2/users\n   * });\n   */\n  public version(version: string | number, callback: () => void) {\n    return this.prefix(`/v${version}`, callback);\n  }\n\n  /**\n   * Wrap route additions with a source file path\n   * Used for tracking which routes come from which file (for HMR)\n   * @param sourceFile Relative path to the source file (e.g., \"src/app/users/routes.ts\")\n   * @param callback Function that adds routes (will have sourceFile injected)\n   */\n  public async withSourceFile<T = any>(\n    sourceFile: string,\n    callback: () => T | Promise<T>,\n  ): Promise<T | undefined> {\n    // Set source file in stacks\n    this.stacks.sourceFile = sourceFile;\n\n    try {\n      // Execute callback (routes added here will have sourceFile injected)\n      return await callback();\n    } catch (error) {\n      // Log loudly, then RETHROW. Swallowing here silently dropped a whole\n      // route file (duplicate name, invalid action, import error) so the\n      // surface 404'd with no boot error. The caller decides what a throw\n      // means: at boot it aborts the boot, during HMR the dev server's\n      // batch-reload handler catches it, prints it, and keeps serving.\n      log.error({\n        module: \"router\",\n        action: \"registerRoutes\",\n        message: `Failed to register routes from \"${sourceFile}\"`,\n        context: { sourceFile, error },\n      });\n\n      throw error;\n    } finally {\n      // Always clear source file from stacks so a throwing file never leaks\n      // its sourceFile onto the process-global singleton.\n      delete this.stacks.sourceFile;\n    }\n  }\n\n  /**\n   * Remove all routes that belong to a specific source file\n   * Used when reloading routes files via HMR\n   * @param sourceFile Relative path to the source file\n   */\n  public removeRoutesBySourceFile(sourceFile: string): void {\n    this.routes = this.routes.filter((route) => route.sourceFile !== sourceFile);\n\n    // Keep the signature diagnostics in step, so a reload that fixes a handler\n    // stops reporting the version it replaced.\n    forgetPositionalHandlerSuspects(sourceFile);\n\n    this.routesVersion++;\n  }\n\n  /**\n   * Manage validation system for the given resource\n   */\n  private manageValidation(resource: RouteResource, method: \"create\" | \"update\" | \"patch\") {\n    const handler = resource[method]?.bind(resource) as RequestHandler;\n\n    const methodValidation = resource?.validation?.[method];\n\n    if (method === \"patch\") {\n      handler.validation = methodValidation;\n\n      if (handler.validation?.validate) {\n        handler.validation.validate = handler.validation.validate.bind(resource);\n      }\n\n      if (resource.validation?.patch) {\n        handler.validation = merge(resource.validation.patch, handler.validation);\n      }\n\n      return handler;\n    }\n\n    if (!resource.validation || (!methodValidation && !resource.validation.all)) return handler;\n\n    if (resource.validation.all) {\n      const validationMethods = {\n        all: resource?.validation?.all?.validate,\n        [method]: methodValidation?.validate,\n      };\n\n      const validation: RequestHandlerValidation = {};\n\n      if (resource.validation.all.schema || methodValidation?.schema) {\n        if (!methodValidation?.schema && resource.validation.all.schema) {\n          // Case 2: Only all.schema exists - clone it for this method\n          validation.schema = resource.validation.all.schema;\n        } else if (methodValidation?.schema && resource.validation.all.schema) {\n          // Case 3: Both exist - merge them (all is base, method overrides)\n          validation.schema = resource.validation.all.schema.merge(methodValidation.schema);\n        } else if (methodValidation?.schema && !resource.validation.all.schema) {\n          // Case 1: Only method schema exists - use it directly\n          validation.schema = methodValidation.schema;\n        }\n        // Case 4: Neither exists - handled by outer if being false\n      }\n\n      if (validationMethods.all || validationMethods[method]) {\n        validation.validate = async ({ request, response }: HttpContext) => {\n          if (validationMethods.all) {\n            const output = await validationMethods.all.call(resource, { request, response });\n\n            if (output) return output;\n          }\n\n          if (validationMethods[method]) {\n            return await validationMethods[method]?.call(resource, { request, response });\n          }\n\n          return;\n        };\n      }\n\n      if (!isEmpty(validation)) {\n        handler.validation = validation;\n      }\n    } else {\n      handler.validation = resource.validation[method];\n\n      if (handler.validation?.validate) {\n        handler.validation.validate = handler.validation.validate.bind(resource);\n      }\n    }\n\n    return handler;\n  }\n\n  /**\n   * Get all routes list\n   */\n  public list() {\n    return this.routes;\n  }\n\n  /**\n   * Number of routes currently registered on the singleton.\n   *\n   * Used as a readiness signal: a successful boot that ends up with zero\n   * routes almost always means a route module failed to register silently\n   * (see `withSourceFile`), so callers can surface that instead of letting\n   * the whole surface 404.\n   */\n  public routeCount(): number {\n    return this.routes.length;\n  }\n\n  /**\n   * Register routes to the server\n   */\n  public scan(server: FastifyInstance) {\n    // Every route is registered by the time we scan, so this is the first\n    // moment the whole list can be reported at once — and it is still before a\n    // single request is served.\n    reportPositionalHandlerSuspects();\n\n    this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));\n\n    this.routes.forEach((route) => {\n      const requestMethod = route.method.toLowerCase();\n      const requestMethodFunction = server[requestMethod].bind(server);\n\n      const options = {\n        ...route.serverOptions,\n        config: {\n          ...route.serverOptions?.config,\n          ...(route.rateLimit && { rateLimit: route.rateLimit }),\n        },\n      };\n\n      requestMethodFunction(\n        route.path,\n        options,\n        async (baseRequest: FastifyRequest, reply: FastifyReply) => {\n          const { output, response } = await this.handleRoute(route)(baseRequest, reply);\n\n          return output || response.baseResponse;\n        },\n      );\n    });\n\n    for (const directoryOptions of this.staticDirectories) {\n      server.register(fastifyStatic, {\n        ...directoryOptions,\n        decorateReply: false,\n      });\n    }\n\n    this.eventListeners.afterScanning?.forEach((callback) => callback(this, server));\n  }\n\n  /**\n   * Scan routes for the development server\n   * Uses wildcard routing with find-my-way for HMR support\n   */\n  public scanDevServer(server: FastifyInstance) {\n    // Same boot-time report as production `scan`. Routes reloaded later by HMR\n    // are still recorded, but only surface on the next scan or via\n    // `warlock doctor`.\n    reportPositionalHandlerSuspects();\n\n    this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));\n\n    let routeRegistry: RouteRegistry | undefined;\n    let registryVersion = -1;\n\n    // Rebuilt when the route table changes rather than per request. Building it\n    // inside the handler re-registered every route on every hit — and `all`\n    // routes expand into seven registrations each. Keyed on `routesVersion`\n    // rather than on the route count, so an HMR reload that swaps a route\n    // without changing the count still invalidates.\n    const resolveRouteRegistry = () => {\n      if (routeRegistry && registryVersion === this.routesVersion) {\n        return routeRegistry;\n      }\n\n      routeRegistry = new RouteRegistry();\n\n      routeRegistry.register(this.routes);\n\n      registryVersion = this.routesVersion;\n\n      return routeRegistry;\n    };\n\n    // Matching happens here, in Fastify's own onRequest phase, so a route's\n    // `serverOptions.onRequest` still runs BEFORE body parsing. Production\n    // `scan()` gets that from per-route registration; the wildcard dispatcher\n    // has no per-route slot, so without this the hook silently never runs.\n    server.addHook(\n      \"onRequest\",\n      async (fastifyRequest: FastifyRequest, fastifyReply: FastifyReply) => {\n        const match = resolveRouteRegistry().find(fastifyRequest.method, fastifyRequest.url);\n\n        if (!match) {\n          return undefined;\n        }\n\n        (fastifyRequest as DevDispatchRequest).matchedDevRoute = match;\n\n        fastifyRequest.params = match.params;\n\n        return runRouteHooks(match.route, \"onRequest\", fastifyRequest, fastifyReply);\n      },\n    );\n\n    for (const phase of FORWARDED_ROUTE_PHASES.filter((name) => name !== \"onRequest\")) {\n      server.addHook(phase, async (fastifyRequest: FastifyRequest, fastifyReply: FastifyReply) => {\n        const match = (fastifyRequest as DevDispatchRequest).matchedDevRoute;\n\n        if (!match) {\n          return undefined;\n        }\n\n        return runRouteHooks(match.route, phase, fastifyRequest, fastifyReply);\n      });\n    }\n\n    // Shared handler for wildcard routing\n    const wildcardHandler = async (fastifyRequest: FastifyRequest, fastifyReply: FastifyReply) => {\n      const match = (fastifyRequest as DevDispatchRequest).matchedDevRoute;\n\n      // No match found - return 404\n      if (!match) {\n        return fastifyReply.code(404).send({\n          error: \"Route not found\",\n          path: fastifyRequest.url,\n          method: fastifyRequest.method,\n        });\n      }\n\n      try {\n        // Call the matched route handler\n        const { output, response } = await this.handleRoute(match.route)(\n          fastifyRequest,\n          fastifyReply,\n        );\n\n        return output || response.baseResponse;\n      } catch (error) {\n        log.error(\"router\", \"dev-dispatch\", error as Error, {\n          method: fastifyRequest.method,\n          url: fastifyRequest.url,\n        });\n\n        throw error;\n      }\n    };\n\n    // Register wildcard route for all methods EXCEPT OPTIONS (to avoid conflict with CORS)\n    // OPTIONS is handled by @fastify/cors plugin for preflight requests\n    const methods = [\"GET\", \"POST\", \"PUT\", \"DELETE\", \"PATCH\"] as const;\n    for (const method of methods) {\n      server.route({\n        method,\n        url: \"*\",\n        handler: wildcardHandler,\n      });\n    }\n\n    // Register static directories\n    for (const directoryOptions of this.staticDirectories) {\n      server.register(fastifyStatic, {\n        ...directoryOptions,\n        decorateReply: false,\n      });\n    }\n\n    this.eventListeners.afterScanning?.forEach((callback) => callback(this, server));\n  }\n\n  /**\n   * Get the route path for the given route name\n   */\n  public getRoute(name: string, params: any = {}) {\n    const route = this.routes.find((route) => route.name === name);\n\n    if (!route) {\n      throw new Error(`Route name \"${name}\" not found`);\n    }\n\n    let path = route.path;\n\n    if (route.path.includes(\":\")) {\n      Object.keys(params).forEach((key) => {\n        path = path.replace(\":\" + key, params[key]);\n      });\n    }\n\n    return path;\n  }\n\n  /**\n   * Handle the given route\n   */\n  private handleRoute(route: Route) {\n    return async (fastifyRequest: FastifyRequest, fastifyResponse: FastifyReply) => {\n      const request = new Request();\n      const response = new Response();\n      response.setResponse(fastifyResponse);\n      request.response = response;\n\n      response.request = request;\n\n      request.setRequest(fastifyRequest).setRoute(route);\n\n      /*\n        Both ends of the entry, not just the start — see\n        `log-request-lifecycle.ts`. A start line on its own made a hung request\n        and an instant one look identical, and the completion line is what makes\n        a MISSING one legible as a hang.\n      */\n      const result = await logRequestLifecycle(\n        {\n          info: entry => log.info(entry),\n          warn: entry => log.warn(entry),\n          error: entry => log.error(entry),\n          now: () => performance.now(),\n        },\n        {\n          module: \"route\",\n          action: describeRouteForLog(route.method, route.path),\n          requestId: request.id,\n          context: { request, response },\n          // Read after the run: the status is decided during the request.\n          statusCode: () => fastifyResponse.statusCode,\n        },\n        () => request.execute(),\n      );\n\n      return {\n        output: result,\n        response,\n        request,\n      };\n    };\n  }\n}\n\nexport const router = Router.getInstance();\n\ncontainer.set(\"router\", router);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAoDA,MAAM,yBAAyB;CAAC;CAAa;CAAiB;AAAY;AAc1E,SAAS,WACP,MACsB;CACtB,IAAI,CAAC,MACH,OAAO,CAAC;CAGV,OAAO,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,IAAI;AAC3C;;;;;;;;AASA,eAAe,cACb,OACA,OACA,SACA,OACA;CACA,MAAM,QAAQ,WACZ,MAAM,gBAAgB,MACxB;CAEA,KAAK,MAAM,QAAQ,OAGjB,IAAI,MAFkB,KAAK,SAAS,KAAK,MAEzB,OACd,OAAO;AAKb;;;;;;;;;;;;;;AAeA,SAAS,sBAAsB,OAAc;CAC3C,MAAM,OAAO,MAAM,SAAS,eAAe;CAC3C,MAAM,SAAS,MAAM,aAAa,eAAe,MAAM,eAAe;CAEtE,OAAO,GAAG,KAAK,GAAG,MAAM,OAAO,GAAG,MAAM,KAAK,IAAI,OAAO;AAC1D;AAEA,IAAa,SAAb,MAAa,OAAO;;;;CA6ClB,OAAc,cAAc;EAC1B,IAAI,CAAC,OAAO,UACV,OAAO,WAAW,IAAI,OAAO;EAG/B,OAAO,OAAO;CAChB;CAEA,AAAQ,cAAc;gBAjDI,CAAC;uBAUH;2BAU8B,CAAC;wBAMrD,CAAC;gBAM8B;GAC/B,QAAQ,CAAC;GACT,MAAM,CAAC;GACP,YAAY,CAAC;EACf;CAeA;;;;CAKA,AAAO,eAAe,UAA6D;EACjF,KAAK,eAAe,aAAa,CAAC,GAAI,KAAK,eAAe,cAAc,CAAC,GAAI,QAAQ;EAErF,OAAO;CACT;;;;CAKA,AAAO,cAAc,UAA6D;EAChF,KAAK,eAAe,gBAAgB,CAAC,GAAI,KAAK,eAAe,iBAAiB,CAAC,GAAI,QAAQ;EAE3F,OAAO;CACT;;;;CAKA,AAAO,SAAS,MAAc,IAAY,eAA0C,aAAa;EAC/F,OAAO,KAAK,IAAI,OAAO,EAAE,eAAe;GACtC,SAAS,SAAS,IAAI,iBAAiB,cAAc,MAAM,GAAG;EAChE,CAAC;CACH;;;;CAKA,AAAO,UAAU,SAA+B;EAC9C,KAAK,kBAAkB,KAAK,OAAO;EAEnC,OAAO;CACT;;;;CAKA,AAAO,KAAK,MAAc,UAAkB,WAAoB;EAC9D,OAAO,KAAK,IAAI,OAAO,EAAE,eAAe;GACtC,SAAS,SAAS,UAAU,SAAS;EACvC,CAAC;CACH;;;;CAKA,AAAO,WAAW,MAAc,UAAkB,WAAoB;EACpE,OAAO,KAAK,IAAI,OAAO,EAAE,eAAe;GACtC,SAAS,eAAe,UAAU,SAAS;EAC7C,CAAC;CACH;;;;CAKA,AAAO,MAAM,OAA+B,WAAoB;EAC9D,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,KAAK,GACjD,KAAK,IAAI,OAAO,EAAE,eAAe;GAC/B,SAAS,SAAS,UAAU,SAAS;EACvC,CAAC;CAEL;;;;CAKA,AAAO,YAAY,OAA+B,WAAoB;EACpE,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,KAAK,GACjD,KAAK,IAAI,OAAO,EAAE,eAAe;GAC/B,SAAS,eAAe,UAAU,SAAS;EAC7C,CAAC;CAEL;CAWA,AAAO,MAAM,GAAG,MAAa;EAC3B,KAAK,gBAAgB,SAAS,WAAW;GACvC,IAAI,KAAK,WAAW,GAClB,OAAO,SAAS,OAAO,KAAK,EAAE;QAE9B,OAAO,SAAS,OAAO;IACrB,QAAQ,KAAK;IACb,UAAU,KAAK;IACf,GAAG,KAAK;GACV,CAAC;EAEL,CAAC;EAED,OAAO;CACT;;;;CAKA,AAAO,IACL,QACA,MACA,SACA,UAAwB,CAAC,GACzB;EACA,IAAI,MAAM,QAAQ,IAAI,GAAG;GACvB,KAAK,SAAS,MAAM,KAAK,IAAI,QAAQ,GAAG,SAAS,OAAO,CAAC;GACzD,OAAO;EACT;EAEA,MAAM,SAAS,KAAK,OAAO,OAAO,QAAQ,MAAM,WAAW;GACzD,OAAO,YAAY,MAAM,MAAM;EACjC,GAAG,EAAE;EAEL,MAAM,OAAO,KAAK,OAAO,KAAK,aAC3B,MAAM,eAAe;GACpB,OAAO,KAAK,aAAa,MAAM,MAAM,GAAG;EAC1C,GACA,QAAQ,QAAQ,KAAK,KAAK,QAAQ,OAAO,GAAG,GAAG,GAAG,CACpD;EAEA,OAAO,YAAY,QAAQ,IAAI;EAI/B,KAF6B,QAAQ,wBAAwB,aAEhC,UAC3B,QAAQ,aAAa,CAAC,GAAI,QAAQ,cAAc,CAAC,GAAI,GAAG,KAAK,OAAO,UAAU;OAE9E,QAAQ,aAAa,CAAC,GAAG,KAAK,OAAO,YAAY,GAAI,QAAQ,cAAc,CAAC,CAAE;EAGhF,IAAI,MAAM,QAAQ,OAAO,GAAG;GAC1B,MAAM,CAAC,YAAY,UAAU;GAE7B,IAAI,OAAO,WAAW,YAAY,YAChC,MAAM,IAAI,MACR,8BAA8B,OAAO,oBAAoB,WAAW,YAAY,KAAK,EACvF;GAGF,UAAU,WAAW,OAAO,CAAC,KAAK,UAAU;GAE5C,IAAI,CAAC,QAAQ,YAAY;IACvB,QAAQ,aAAa,CAAC;IACtB,IAAI,WAAW,GAAG,OAAO,oBACvB,QAAQ,WAAW,SAAS,WAAW,GAAG,OAAO,kBAAkB,CAAC;IAGtE,IAAI,WAAW,GAAG,OAAO,YACvB,QAAQ,WAAW,WAAW,WAAW,GAAG,OAAO;GAEvD;EACF;EAEA,MAAM,YAAmB;GACvB;GACA;GACA;GACA,GAAG;GACH;GACA,WAAW,QAAQ;GACnB,SAAS,UAAU;GAEnB,cAAc,CAAC,GAAG,KAAK,OAAO,MAAM;GAEpC,YAAY,KAAK,OAAO,cAAc;EACxC;EAEA,IAAI,UAAU,MAAM;GAElB,MAAM,QAAQ,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,UAAU,IAAI;GAEvE,IAAI,OAEF,IAAI,MAAM,WAAW,UAAU,QAC7B,MAAM,IAAI,MACR,eAAe,UAAU,KAAK,6CACH,sBAAsB,KAAK,EAAE,0BAC7B,sBAAsB,SAAS,EAAE,2IAG9D;QAEA,UAAU,QAAQ,IAAI,UAAU,OAAO,YAAY;EAGzD;EAOA,wBAAwB,UAAU,SAAS,SAAS;EAEpD,KAAK,OAAO,KAAK,SAAS;EAE1B,KAAK;EAEL,OAAO;CACT;;;;CAKA,AAAO,IAAI,MAAc,SAA6B,UAAwB,CAAC,GAAG;EAChF,OAAO,KAAK,IAAI,OAA0B,MAAM,SAAS,OAAO;CAClE;;;;CAKA,AAAO,IAAI,MAAc,SAA6B,UAAwB,CAAC,GAAG;EAChF,OAAO,KAAK,IAAI,OAAO,MAAM,SAAS,OAAO;CAC/C;;;;CAKA,AAAO,KAAK,MAAyB,SAA6B,UAAwB,CAAC,GAAG;EAC5F,OAAO,KAAK,IAAI,QAAQ,MAAM,SAAS,OAAO;CAChD;;;;CAKA,AAAO,IAAI,MAAc,SAA6B,UAAwB,CAAC,GAAG;EAChF,OAAO,KAAK,IAAI,OAAO,MAAM,SAAS,OAAO;CAC/C;;;;CAKA,AAAO,OAAO,MAAyB,SAA6B,UAAwB,CAAC,GAAG;EAC9F,OAAO,KAAK,IAAI,UAAU,MAAM,SAAS,OAAO;CAClD;;;;CAKA,AAAO,MAAM,MAAc,SAA6B,UAAwB,CAAC,GAAG;EAClF,OAAO,KAAK,IAAI,SAAS,MAAM,SAAS,OAAO;CACjD;;;;CAKA,AAAO,KAAK,MAAc,SAA6B,UAAwB,CAAC,GAAG;EACjF,OAAO,KAAK,IAAI,QAAQ,MAAM,SAAS,OAAO;CAChD;;;;CAKA,AAAO,QAAQ,MAAc,SAA6B,UAAwB,CAAC,GAAG;EACpF,OAAO,KAAK,IAAI,WAAW,MAAM,SAAS,OAAO;CACnD;;;;CAKA,AAAO,MAAM,MAAc,UAAwB,CAAC,GAAG;EACrD,OAAO,IAAI,aAAa,MAAM,MAAM,OAAO;CAC7C;;;;;;;;;;;CAYA,AAAO,gBACL,MACA,UACA,UAMI,CAAC,GACL;EAKA,MAAM,mBAAmB,QAAQ,QAAQ,YAAY,MAAM,MAAM,GAAG,CAAC;EAErE,OAAO,KAAK,MAAM;GAAE,QAAQ;GAAM,MAAM;EAAiB,SAAS;GAChE,MAAM,OAAO;GAGb,MAAM,gBAAgB;GAEtB,MAAM,wBAAwB,SAAyB;IACrD,OAAO,SAEJ,CAAC,QAAQ,UAAU,CAAC,QAAQ,OAAO,SAAS,IAAI,OAEhD,CAAC,QAAQ,QAAQ,QAAQ,KAAK,SAAS,IAAI,EAC9C;GACF;GAEA,IAAI,cAAc,QAAQ,qBAAqB,MAAM,GACnD,KAAK,IAAI,MAAM,QAAQ,SAAS,QAAQ,cAAc,KAAK,KAAK,aAAa,GAAG;IAC9E,GAAG;IACH,MAAM;IACN,SAAS;GACX,CAAC;GAGH,IAAI,cAAc,OAAO,qBAAqB,KAAK,GACjD,KAAK,IAAI,QAAe,QAAQ,SAAS,OAAO,cAAc,IAAI,KAAK,aAAa,GAAG;IACrF,GAAG;IACH,MAAM;IACN,SAAS;GACX,CAAC;GAGH,IAAI,cAAc,UAAU,qBAAqB,QAAQ,GAAG;IAC1D,MAAM,UAAU,QAAQ,SAAS,UAAU,KAAK,iBAAiB,eAAe,QAAQ;IAExF,KAAK,KAAK,MAAM,SAAS;KACvB,GAAG;KACH,MAAM;KACN,SAAS;IACX,CAAC;GACH;GAEA,IAAI,cAAc,UAAU,qBAAqB,QAAQ,GAAG;IAC1D,MAAM,UAAU,QAAQ,SAAS,UAAU,KAAK,iBAAiB,eAAe,QAAQ;IAExF,KAAK,IAAI,QAAe,SAAS;KAC/B,GAAG;KACH,MAAM;KACN,SAAS;IACX,CAAC;GACH;GAEA,IAAI,cAAc,SAAS,qBAAqB,OAAO,GAAG;IACxD,MAAM,UAAU,QAAQ,SAAS,SAAS,KAAK,iBAAiB,eAAe,OAAO;IAEtF,KAAK,MAAM,QAAe,SAAS;KACjC,GAAG;KACH,MAAM;KACN,SAAS;IACX,CAAC;GACH;GAEA,IAAI,cAAc,UAAU,qBAAqB,QAAQ,GACvD,KAAK,OACH,QACA,QAAQ,SAAS,UAAU,cAAc,OAAO,KAAK,aAAa,GAClE;IACE,GAAG;IACH,MAAM;IACN,SAAS;GACX,CACF;GAGF,IAAI,cAAc,cAAc,qBAAqB,QAAQ,GAC3D,KAAK,OACH,MACA,QAAQ,SAAS,cAAc,cAAc,WAAW,KAAK,aAAa,GAC1E;IACE,GAAG;IACH,MAAM;IACN,SAAS;GACX,CACF;GAGF,OAAO;EACT,CAAC;CACH;;;;CAKA,AAAO,MAAM,SAA+B,UAA+B;EACzE,MAAM,EACJ,QAOA,OAAO,SAAS,KAAK,OAAO,QAAQ,OAAO,GAAG,GAAG,GAAG,IAAI,QACxD,eACE;EAEJ,IAAI,QACF,KAAK,OAAO,OAAO,KAAK,MAAM;EAGhC,IAAI,MACF,KAAK,OAAO,KAAK,KAAK,IAAI;EAG5B,IAAI,YACF,KAAK,OAAO,WAAW,KAAK,GAAG,UAAU;EAG3C,IAAI;GACF,SAAS;EACX,UAAU;GAGR,IAAI,QACF,KAAK,OAAO,OAAO,IAAI;GAGzB,IAAI,MACF,KAAK,OAAO,KAAK,IAAI;GAGvB,IAAI,YACF,KAAK,OAAO,WAAW,OACrB,KAAK,OAAO,WAAW,SAAS,WAAW,QAC3C,WAAW,MACb;EAEJ;EAEA,OAAO;CACT;;;;CAKA,AAAO,OAAO,QAAgB,UAAsB;EAClD,OAAO,KAAK,MAAM,EAAE,OAAO,GAAG,QAAQ;CACxC;;;;;;;;;;;;;CAcA,AAAO,QAAQ,SAA0B,UAAsB;EAC7D,OAAO,KAAK,OAAO,KAAK,WAAW,QAAQ;CAC7C;;;;;;;CAQA,MAAa,eACX,YACA,UACwB;EAExB,KAAK,OAAO,aAAa;EAEzB,IAAI;GAEF,OAAO,MAAM,SAAS;EACxB,SAAS,OAAO;GAMd,IAAI,MAAM;IACR,QAAQ;IACR,QAAQ;IACR,SAAS,mCAAmC,WAAW;IACvD,SAAS;KAAE;KAAY;IAAM;GAC/B,CAAC;GAED,MAAM;EACR,UAAU;GAGR,OAAO,KAAK,OAAO;EACrB;CACF;;;;;;CAOA,AAAO,yBAAyB,YAA0B;EACxD,KAAK,SAAS,KAAK,OAAO,QAAQ,UAAU,MAAM,eAAe,UAAU;EAI3E,gCAAgC,UAAU;EAE1C,KAAK;CACP;;;;CAKA,AAAQ,iBAAiB,UAAyB,QAAuC;EACvF,MAAM,UAAU,SAAS,OAAO,EAAE,KAAK,QAAQ;EAE/C,MAAM,mBAAmB,UAAU,aAAa;EAEhD,IAAI,WAAW,SAAS;GACtB,QAAQ,aAAa;GAErB,IAAI,QAAQ,YAAY,UACtB,QAAQ,WAAW,WAAW,QAAQ,WAAW,SAAS,KAAK,QAAQ;GAGzE,IAAI,SAAS,YAAY,OACvB,QAAQ,aAAa,MAAM,SAAS,WAAW,OAAO,QAAQ,UAAU;GAG1E,OAAO;EACT;EAEA,IAAI,CAAC,SAAS,cAAe,CAAC,oBAAoB,CAAC,SAAS,WAAW,KAAM,OAAO;EAEpF,IAAI,SAAS,WAAW,KAAK;GAC3B,MAAM,oBAAoB;IACxB,KAAK,UAAU,YAAY,KAAK;KAC/B,SAAS,kBAAkB;GAC9B;GAEA,MAAM,aAAuC,CAAC;GAE9C,IAAI,SAAS,WAAW,IAAI,UAAU,kBAAkB,QACtD;QAAI,CAAC,kBAAkB,UAAU,SAAS,WAAW,IAAI,QAEvD,WAAW,SAAS,SAAS,WAAW,IAAI;SACvC,IAAI,kBAAkB,UAAU,SAAS,WAAW,IAAI,QAE7D,WAAW,SAAS,SAAS,WAAW,IAAI,OAAO,MAAM,iBAAiB,MAAM;SAC3E,IAAI,kBAAkB,UAAU,CAAC,SAAS,WAAW,IAAI,QAE9D,WAAW,SAAS,iBAAiB;GACvC;GAIF,IAAI,kBAAkB,OAAO,kBAAkB,SAC7C,WAAW,WAAW,OAAO,EAAE,SAAS,eAA4B;IAClE,IAAI,kBAAkB,KAAK;KACzB,MAAM,SAAS,MAAM,kBAAkB,IAAI,KAAK,UAAU;MAAE;MAAS;KAAS,CAAC;KAE/E,IAAI,QAAQ,OAAO;IACrB;IAEA,IAAI,kBAAkB,SACpB,OAAO,MAAM,kBAAkB,OAAO,EAAE,KAAK,UAAU;KAAE;KAAS;IAAS,CAAC;GAIhF;GAGF,IAAI,CAAC,QAAQ,UAAU,GACrB,QAAQ,aAAa;EAEzB,OAAO;GACL,QAAQ,aAAa,SAAS,WAAW;GAEzC,IAAI,QAAQ,YAAY,UACtB,QAAQ,WAAW,WAAW,QAAQ,WAAW,SAAS,KAAK,QAAQ;EAE3E;EAEA,OAAO;CACT;;;;CAKA,AAAO,OAAO;EACZ,OAAO,KAAK;CACd;;;;;;;;;CAUA,AAAO,aAAqB;EAC1B,OAAO,KAAK,OAAO;CACrB;;;;CAKA,AAAO,KAAK,QAAyB;EAInC,gCAAgC;EAEhC,KAAK,eAAe,YAAY,SAAS,aAAa,SAAS,MAAM,MAAM,CAAC;EAE5E,KAAK,OAAO,SAAS,UAAU;GAE7B,MAAM,wBAAwB,OADR,MAAM,OAAO,YACc,EAAE,CAAC,KAAK,MAAM;GAE/D,MAAM,UAAU;IACd,GAAG,MAAM;IACT,QAAQ;KACN,GAAG,MAAM,eAAe;KACxB,GAAI,MAAM,aAAa,EAAE,WAAW,MAAM,UAAU;IACtD;GACF;GAEA,sBACE,MAAM,MACN,SACA,OAAO,aAA6B,UAAwB;IAC1D,MAAM,EAAE,QAAQ,aAAa,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,aAAa,KAAK;IAE7E,OAAO,UAAU,SAAS;GAC5B,CACF;EACF,CAAC;EAED,KAAK,MAAM,oBAAoB,KAAK,mBAClC,OAAO,SAAS,eAAe;GAC7B,GAAG;GACH,eAAe;EACjB,CAAC;EAGH,KAAK,eAAe,eAAe,SAAS,aAAa,SAAS,MAAM,MAAM,CAAC;CACjF;;;;;CAMA,AAAO,cAAc,QAAyB;EAI5C,gCAAgC;EAEhC,KAAK,eAAe,YAAY,SAAS,aAAa,SAAS,MAAM,MAAM,CAAC;EAE5E,IAAI;EACJ,IAAI,kBAAkB;EAOtB,MAAM,6BAA6B;GACjC,IAAI,iBAAiB,oBAAoB,KAAK,eAC5C,OAAO;GAGT,gBAAgB,IAAI,cAAc;GAElC,cAAc,SAAS,KAAK,MAAM;GAElC,kBAAkB,KAAK;GAEvB,OAAO;EACT;EAMA,OAAO,QACL,aACA,OAAO,gBAAgC,iBAA+B;GACpE,MAAM,QAAQ,qBAAqB,CAAC,CAAC,KAAK,eAAe,QAAQ,eAAe,GAAG;GAEnF,IAAI,CAAC,OACH;GAGF,AAAC,eAAsC,kBAAkB;GAEzD,eAAe,SAAS,MAAM;GAE9B,OAAO,cAAc,MAAM,OAAO,aAAa,gBAAgB,YAAY;EAC7E,CACF;EAEA,KAAK,MAAM,SAAS,uBAAuB,QAAQ,SAAS,SAAS,WAAW,GAC9E,OAAO,QAAQ,OAAO,OAAO,gBAAgC,iBAA+B;GAC1F,MAAM,QAAS,eAAsC;GAErD,IAAI,CAAC,OACH;GAGF,OAAO,cAAc,MAAM,OAAO,OAAO,gBAAgB,YAAY;EACvE,CAAC;EAIH,MAAM,kBAAkB,OAAO,gBAAgC,iBAA+B;GAC5F,MAAM,QAAS,eAAsC;GAGrD,IAAI,CAAC,OACH,OAAO,aAAa,KAAK,GAAG,CAAC,CAAC,KAAK;IACjC,OAAO;IACP,MAAM,eAAe;IACrB,QAAQ,eAAe;GACzB,CAAC;GAGH,IAAI;IAEF,MAAM,EAAE,QAAQ,aAAa,MAAM,KAAK,YAAY,MAAM,KAAK,CAAC,CAC9D,gBACA,YACF;IAEA,OAAO,UAAU,SAAS;GAC5B,SAAS,OAAO;IACd,IAAI,MAAM,UAAU,gBAAgB,OAAgB;KAClD,QAAQ,eAAe;KACvB,KAAK,eAAe;IACtB,CAAC;IAED,MAAM;GACR;EACF;EAKA,KAAK,MAAM,UAAU;GADJ;GAAO;GAAQ;GAAO;GAAU;EACtB,GACzB,OAAO,MAAM;GACX;GACA,KAAK;GACL,SAAS;EACX,CAAC;EAIH,KAAK,MAAM,oBAAoB,KAAK,mBAClC,OAAO,SAAS,eAAe;GAC7B,GAAG;GACH,eAAe;EACjB,CAAC;EAGH,KAAK,eAAe,eAAe,SAAS,aAAa,SAAS,MAAM,MAAM,CAAC;CACjF;;;;CAKA,AAAO,SAAS,MAAc,SAAc,CAAC,GAAG;EAC9C,MAAM,QAAQ,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,IAAI;EAE7D,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,eAAe,KAAK,YAAY;EAGlD,IAAI,OAAO,MAAM;EAEjB,IAAI,MAAM,KAAK,SAAS,GAAG,GACzB,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,QAAQ;GACnC,OAAO,KAAK,QAAQ,MAAM,KAAK,OAAO,IAAI;EAC5C,CAAC;EAGH,OAAO;CACT;;;;CAKA,AAAQ,YAAY,OAAc;EAChC,OAAO,OAAO,gBAAgC,oBAAkC;GAC9E,MAAM,UAAU,IAAI,QAAQ;GAC5B,MAAM,WAAW,IAAI,SAAS;GAC9B,SAAS,YAAY,eAAe;GACpC,QAAQ,WAAW;GAEnB,SAAS,UAAU;GAEnB,QAAQ,WAAW,cAAc,CAAC,CAAC,SAAS,KAAK;GA0BjD,OAAO;IACL,QAAQ,MAnBW,oBACnB;KACE,OAAM,UAAS,IAAI,KAAK,KAAK;KAC7B,OAAM,UAAS,IAAI,KAAK,KAAK;KAC7B,QAAO,UAAS,IAAI,MAAM,KAAK;KAC/B,WAAW,YAAY,IAAI;IAC7B,GACA;KACE,QAAQ;KACR,QAAQ,oBAAoB,MAAM,QAAQ,MAAM,IAAI;KACpD,WAAW,QAAQ;KACnB,SAAS;MAAE;MAAS;KAAS;KAE7B,kBAAkB,gBAAgB;IACpC,SACM,QAAQ,QAAQ,CACxB;IAIE;IACA;GACF;EACF;CACF;AACF;AAEA,MAAa,SAAS,OAAO,YAAY;AAEzC,UAAU,IAAI,UAAU,MAAM"}

package/esm/router/types.d.mts

@@ -13,11 +13,12 @@ import { RouteShorthandOptions } from "fastify";
 type MiddlewareResponse = ReturnedResponse | undefined | void;
 /**
  * Middleware method
- * Receives the request and response objects
- * And returns a response object or undefined if the request should continue
+ * Receives the single context object (`{ request, response }`), same calling
+ * convention as `RequestHandler`, and returns a response object or undefined
+ * if the request should continue
  */
 type Middleware<MiddlewareRequest extends Request = Request> = {
-  (request: MiddlewareRequest, response: Response): MiddlewareResponse;
+  (context: HttpContext<MiddlewareRequest>): MiddlewareResponse;
 };
 type RouterGroupCallback = () => void;
 type RequestHandlerType = RequestHandler<any> | [GenericObject, string];
@@ -63,11 +64,28 @@ interface RequestControllerContract {
    */
   middleware?: () => Promise<MiddlewareResponse> | MiddlewareResponse;
 }
+/**
+ * The single context object a route handler receives.
+ *
+ * v5 handlers are written `async ({ request, response }) => …` — one
+ * parameter, destructured at the call site, replacing the v4 positional
+ * `(request, response)` pair.
+ */
+type HttpContext<TRequest extends Request = Request> = {
+  /**
+   * Request object
+   */
+  request: TRequest;
+  /**
+   * Response object
+   */
+  response: Response;
+};
 type RequestHandler<TRequest extends Request = Request> = {
   /**
    * Function Declaration
    */
-  (request: TRequest, response: Response): ReturnedResponse | void;
+  (context: HttpContext<TRequest>): ReturnedResponse | void;
   /**
    * Validation static object property which can be optional
    */
@@ -279,5 +297,5 @@ type RouterStacks = {
   sourceFile?: string;
 };
 //#endregion
-export { GroupedRoutesOptions, Middleware, MiddlewareResponse, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks };
+export { GroupedRoutesOptions, HttpContext, Middleware, MiddlewareResponse, PartialPick, RequestControllerContract, RequestHandler, RequestHandlerType, RequestHandlerValidation, RequestMethod, ResourceMethod, RestfulMiddleware, Route, RouteOptions, RouteResource, RouterGroupCallback, RouterStacks };
 //# sourceMappingURL=types.d.mts.map

package/esm/router/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/router/types.ts"],"mappings":";;;;;;;;;;;;KASY,kBAAA,GAAqB,gBAAgB;;AAAjD;;;;KAOY,UAAA,2BAAqC,OAAA,GAAU,OAAA;EAAA,CACxD,OAAA,EAAS,iBAAA,EAAmB,QAAA,EAAU,QAAA,GAAW,kBAAA;AAAA;AAAA,KAGxC,mBAAA;AAAA,KAEA,kBAAA,GAAqB,cAAA,SAAuB,aAAa;;;;KAKzD,cAAA;AAAA,KAEA,iBAAA,GAAoB,MAAM,UAAU,UAAA;AAAA,KAEpC,wBAAA,kBAA0C,OAAA,GAAU,OAAA;EAfzC;;;EAmBrB,QAAA,GAAW,UAAA,CAAW,QAAA;EAlBrB;;;;EAuBD,UAAA;EAvBoE;AAGtE;;EAwBE,MAAA,GAAS,eAAA;AAAA;AAAA,UAGM,yBAAA;EAzBL;;;EA6BV,OAAA,EAAS,OAAA;EA7B0D;AAKrE;;EA4BE,QAAA,EAAU,QAAA;EA5Bc;AAAA;AAE1B;EA8BE,OAAA,IAAW,OAAA,CAAQ,gBAAA;;;AA9BqC;EAkCxD,WAAA;EAhCkC;;;EAoClC,UAAA,SAAmB,OAAA,CAAQ,kBAAA,IAAsB,kBAAA;AAAA;AAAA,KAGvC,cAAA,kBAAgC,OAAA,GAAU,OAAA;EA1B3C;;;EAAA,CA8BR,OAAA,EAAS,QAAA,EAAU,QAAA,EAAU,QAAA,GAAW,gBAAA;EA3CW;;;EAgDpD,UAAA,GAAa,wBAAA,CAAyB,QAAA;EA5ChB;;;EAiDtB,WAAA;EAxCwB;AAAA;AAG1B;;EA2CE,cAAA,GAAiB,cAAA;AAAA;AAAA,UAGF,YAAA;EAlCI;;;EAsCnB,UAAA,GAAa,UAAA;EA9BoC;;;EAkCjD,oBAAA;EAlDS;;;EAsDT,IAAA;EA9CW;;;;EAmDX,WAAA;EA3C2B;;;AAAwC;AAGrE;;;;;;;;;;;;;;;;;;;;;;EAmEE,aAAA,GAAgB,qBAAqB;EA1DC;;;;;EAgEtC,KAAA;EAlDe;;;EAsDf,OAAA;EAlDA;;;EAsDA,MAAA;EAzCA;;;EA6CA,SAAA;IARA;;;IAYE,GAAA;IAIA;;;IAAA,UAAA;IAQQ;;;IAJR,YAAA;EAAA;AAAA;AAAA,KAIQ,aAAA;;;;KAaA,KAAA,GAAQ,YAAA;EAiCN;;;EA7BZ,MAAA,EAAQ,aAAA;EAAR;;;EAIA,UAAA;EASA;;;EALA,IAAA;EAqBA;;;AAAwB;EAhBxB,OAAA,EAAS,cAAA;EAmBY;;;;;EAbrB,OAAA;EAawE;;;;;EAPxE,YAAA;EAOsB;;;EAHtB,SAAA,GAAY,YAAA;AAAA;AAAA,KAGF,WAAA,oBAA+B,CAAA,IAAK,IAAA,CAAK,CAAA,EAAG,CAAA,IAAK,OAAA,CAAQ,IAAA,CAAK,CAAA,EAAG,CAAA;;;;KAKjE,oBAAA;EALkE;AAAA;AAK9E;EAIE,UAAA,GAAa,UAAU;;;;EAIvB,MAAA;EAAA;;;AAKI;EAAJ,IAAA;AAAA;;KAIU,aAAA;EAQJ;;;EAJN,IAAA,GAAO,cAAA;EAoBE;;;EAhBT,GAAA,GAAM,cAAA;EAoCK;;;EAhCX,MAAA,GAAS,cAAA;EART;;;EAYA,MAAA,GAAS,cAAA;EAJT;;;EAQA,KAAA,GAAQ,cAAA;EAAR;;;EAIA,MAAA,GAAS,cAAA;EAIT;;;EAAA,UAAA,GAAa,cAAA;EAQL;;;EAJR,UAAA;IAYW;;;IART,GAAA,GAAM,wBAAA;IAY0B;AAIpC;;IAZI,MAAA,GAAS,wBAAA;IAeW;;;IAXpB,MAAA,GAAS,wBAAA;IAWC;;;IAPV,KAAA,GAAQ,wBAAA;EAAA;AAAA;AAAA,KAIA,YAAA;EACV,MAAA;EACA,IAAA;EACA,UAAA,EAAY,UAAU;;;;EAItB,UAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/router/types.ts"],"mappings":"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"}

package/esm/storage/storage.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.mts","names":[],"sources":["../../../../../../../core/src/storage/storage.ts"],"mappings":"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"}
+{"version":3,"file":"storage.d.mts","names":[],"sources":["../../../../../../../core/src/storage/storage.ts"],"mappings":"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"}

package/esm/storage/storage.mjs

@@ -306,7 +306,7 @@ var Storage = class extends ScopedStorage {
 	* @internal
 	*/
 	async emit(event, payload) {
-		await events.triggerAll(`storage.${event}`, payload);
+		await events.triggerAllAsync(`storage.${event}`, payload);
 	}
 	/**
 	* Store a file in storage