@warlock.js/core 4.11.0 → 4.13.0

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\nexport class Router {\n  /**\n   * Routes list\n   */\n  private routes: Route[] = [];\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    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\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    // Shared handler for wildcard routing\n    const wildcardHandler = async (fastifyRequest: FastifyRequest, fastifyReply: FastifyReply) => {\n      // Initialize route registry once (will be rebuilt on HMR via rebuildRouteRegistry)\n      const routeRegistry = new RouteRegistry();\n\n      routeRegistry.register(this.routes);\n      // Find matching route using find-my-way\n      const match = routeRegistry.find(fastifyRequest.method, fastifyRequest.url);\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      // Inject extracted params into the request\n      fastifyRequest.params = match.params;\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        console.log(error);\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 { 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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"}

package/esm/router/types.d.mts

@@ -101,7 +101,30 @@ interface RouteOptions {
    */
   description?: string;
   /**
-   * Request server options
+   * Fastify route options, forwarded to the route's registration.
+   *
+   * **Dev server caveat.** The dev server registers wildcard routes and
+   * dispatches per request, so it has no per-route registration slot. It
+   * forwards the pre-handler hook phases — `onRequest`, `preValidation` and
+   * `preHandler` — by matching in Fastify's own `onRequest` phase and running
+   * the matched route's hooks there, which keeps `onRequest` running before the
+   * body is parsed, as it does in production.
+   *
+   * **Two things are NOT forwarded in dev, and cannot be:**
+   * - `bodyLimit` — Fastify reads it at registration time; no hook can bound a
+   *   body that is already being parsed.
+   * - `preParsing` — it must return the payload stream, so forwarding it
+   *   generically would corrupt the body rather than guard it.
+   *
+   * A route that relies on either of those behaves differently in dev than in
+   * production. For a pre-parse guarantee that holds in both modes, register a
+   * server-level hook through `router.beforeScanning((_router, server) =>
+   * server.addHook("onRequest", ...))` — it lands on the Fastify instance
+   * rather than in per-route options. That hook fires for **every** request, so
+   * it must discriminate on `request.method` and `request.url` itself, and it
+   * must be **idempotent per request**: `beforeScanning` runs once per scan and
+   * restarting the HTTP connector builds a new server, so the callback can run
+   * more than once against different instances.
    */
   serverOptions?: RouteShorthandOptions;
   /**

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;;;EA+C3B,aAAA,GAAgB,qBAAqB;EA5C3B;;;;;EAkDV,KAAA;EA9C8B;;;EAkD9B,OAAA;EAlCiB;;;EAsCjB,MAAA;EA1D0C;;;EA8D1C,SAAA;IA1D8B;;;IA8D5B,GAAA;IAzDW;;;IA6DX,UAAA;IAlDe;;AAAc;IAsD7B,YAAA;EAAA;AAAA;AAAA,KAIQ,aAAA;;;;KAaA,KAAA,GAAQ,YAAA;EAnDlB;;;EAuDA,MAAA,EAAQ,aAAA;EAzCR;;;EA6CA,UAAA;EA7BE;;;EAiCF,IAAA;EAzBU;;;;EA8BV,OAAA,EAAS,cAAA;EAjBC;;;;;EAuBV,OAAA;EAUY;;;;;EAJZ,YAAA;EArBA;;;EAyBA,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;EALA;;;EASV,UAAA,GAAa,UAAU;EAT4B;;;EAanD,MAAA;EAb2E;;;;EAkB3E,IAAA;AAAA;;KAIU,aAAA;EAtBoC;;;EA0B9C,IAAA,GAAO,cAAA;EA1B4D;;;EA8BnE,GAAA,GAAM,cAAA;EA9BsE;AAK9E;;EA6BE,MAAA,GAAS,cAAA;EAzBc;;;EA6BvB,MAAA,GAAS,cAAA;EApBT;;AAAI;EAwBJ,KAAA,GAAQ,cAAA;EApBe;;;EAwBvB,MAAA,GAAS,cAAA;EAZA;;;EAgBT,UAAA,GAAa,cAAA;EAAA;;;EAIb,UAAA;IAgBU;;;IAZR,GAAA,GAAM,wBAAA;IAhCD;;;IAoCL,MAAA,GAAS,wBAAA;IA5BF;;;IAgCP,MAAA,GAAS,wBAAA;IAxBH;;;IA4BN,KAAA,GAAQ,wBAAA;EAAA;AAAA;AAAA,KAIA,YAAA;EACV,MAAA;EACA,IAAA;EACA,UAAA,EAAY,UAAU;EAXpB;;;EAeF,UAAA;AAAA"}
+{"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"}

package/esm/tests/index.d.mts

@@ -1,4 +1,4 @@
 import { StartHttpTestServerOptions, isTestServerRunning, startHttpTestServer, stopHttpTestServer } from "./start-http-development-server.mjs";
 import { expectJson, getTestServerUrl, parseJsonResponse, testDelete, testGet, testPatch, testPost, testPut, testRequest } from "./test-helpers.mjs";
-import { TEST_SERVER_PORT_ENV_KEY, publishTestServerPort, withdrawTestServerPort } from "./test-server-port-channel.mjs";
-import { setupTest } from "./vitest-setup.mjs";
+import { setupTest } from "./vitest-setup.mjs";
+export { StartHttpTestServerOptions, expectJson, getTestServerUrl, isTestServerRunning, parseJsonResponse, setupTest, startHttpTestServer, stopHttpTestServer, testDelete, testGet, testPatch, testPost, testPut, testRequest };

package/esm/tests/index.mjs

@@ -1,6 +1,5 @@
-import { TEST_SERVER_PORT_ENV_KEY, publishTestServerPort, withdrawTestServerPort } from "./test-server-port-channel.mjs";
 import { isTestServerRunning, startHttpTestServer, stopHttpTestServer } from "./start-http-development-server.mjs";
 import { expectJson, getTestServerUrl, parseJsonResponse, testDelete, testGet, testPatch, testPost, testPut, testRequest } from "./test-helpers.mjs";
 import { setupTest } from "./vitest-setup.mjs";
 
-export {  };
+export { expectJson, getTestServerUrl, isTestServerRunning, parseJsonResponse, setupTest, startHttpTestServer, stopHttpTestServer, testDelete, testGet, testPatch, testPost, testPut, testRequest };

package/esm/tests/start-http-development-server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"start-http-development-server.d.mts","names":[],"sources":["../../../../../../../core/src/tests/start-http-development-server.ts"],"mappings":";KAwBY,0BAAA;EAAA;;;;AAON;AAuDN;EAvDE,IAAI;AAAA;;;;;;AAyDI;AA8CV;;iBAhDsB,mBAAA,CACpB,OAAA,GAAS,0BAAA,GACR,OAAO;;AA8CyC;AAoBnD;;iBApBsB,kBAAA,IAAsB,OAAO;;AAoBhB;;iBAAnB,mBAAA"}
+{"version":3,"file":"start-http-development-server.d.mts","names":[],"sources":["../../../../../../../core/src/tests/start-http-development-server.ts"],"mappings":";KAwBY,0BAAA;EAAA;;;;AAON;AA0EN;EA1EE,IAAI;AAAA;;;;;;AA4EI;AA+EV;;iBAjFsB,mBAAA,CACpB,OAAA,GAAS,0BAAA,GACR,OAAO;;AA+EyC;AA6BnD;;iBA7BsB,kBAAA,IAAsB,OAAO;;AA6BhB;;iBAAnB,mBAAA"}

package/esm/tests/start-http-development-server.mjs

@@ -41,7 +41,8 @@ async function applyTestServerPort(port) {
 	}
 	if (port !== void 0) config.set("http.port", port);
 	const resolvedPort = config.get("http.port");
-	if (typeof resolvedPort !== "number" || resolvedPort <= 0) return;
+	if (typeof resolvedPort !== "number") return;
+	if (resolvedPort <= 0) throw new Error(`startHttpTestServer() cannot run on port ${resolvedPort}. Pass an explicit port — e.g. startHttpTestServer({ port: 3999 }) — or set \`http.port\` in your config. Test workers are separate processes that resolve the server's URL from the port published at startup, and an OS-assigned port is not knowable to them.`);
 	await assertPortIsAvailable(resolvedPort, config.get("http.host") || "localhost");
 	publishTestServerPort(resolvedPort);
 }
@@ -59,18 +60,39 @@ async function startHttpTestServer(options = {}) {
 		return;
 	}
 	console.log("[test-server] Starting HTTP test server...");
-	Application.setRuntimeStrategy("development");
-	Application.setEnvironment("test");
-	await warlockConfigManager.load();
-	await bootstrap();
-	await filesOrchestrator.init();
-	await filesOrchestrator.initializeAll();
-	await loadConfigFiles(true);
-	await connectorsManager.startPhase("early");
-	await filesOrchestrator.moduleLoader.loadAll();
-	await applyTestServerPort(options.port);
-	await connectorsManager.startPhase("late");
-	isServerRunning = true;
+	try {
+		Application.setRuntimeStrategy("development");
+		Application.setEnvironment("test");
+		await warlockConfigManager.load();
+		await bootstrap();
+		await filesOrchestrator.init();
+		await filesOrchestrator.initializeAll();
+		await loadConfigFiles(true);
+		await connectorsManager.startPhase("early");
+		await filesOrchestrator.moduleLoader.loadAll();
+		await applyTestServerPort(options.port);
+		await connectorsManager.startPhase("late");
+		isServerRunning = true;
+	} catch (error) {
+		await unwindPartialStartup();
+		throw error;
+	}
+}
+/**
+* Best-effort teardown of whatever a failed {@link startHttpTestServer} managed
+* to start.
+*
+* Every step is independent and none may throw: this runs while an error is
+* already in flight, and the caller is about to rethrow it.
+*/
+async function unwindPartialStartup() {
+	try {
+		await connectorsManager.shutdown();
+	} catch (shutdownError) {
+		console.error("[test-server] Cleanup after a failed start did not complete:", shutdownError);
+	}
+	withdrawTestServerPort();
+	isServerRunning = false;
 }
 /**
 * Stop the HTTP test server
@@ -83,12 +105,13 @@ async function stopHttpTestServer() {
 	}
 	try {
 		await connectorsManager.shutdown();
-		withdrawTestServerPort();
-		isServerRunning = false;
 		console.log("[test-server] HTTP test server stopped");
 	} catch (error) {
 		console.error("[test-server] Error stopping HTTP server:", error);
 		throw error;
+	} finally {
+		withdrawTestServerPort();
+		isServerRunning = false;
 	}
 }
 /**

package/esm/tests/start-http-development-server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"start-http-development-server.mjs","names":[],"sources":["../../../../../../../core/src/tests/start-http-development-server.ts"],"sourcesContent":["/**\r\n * HTTP Test Server\r\n *\r\n * Starts a minimal HTTP server for testing.\r\n * Unlike the full DevelopmentServer, this:\r\n * - Does NOT watch files\r\n * - Does NOT do HMR\r\n * - Only starts connectors needed for HTTP requests\r\n *\r\n * Used in Vitest's globalSetup to start server once for all test workers.\r\n */\r\nimport config from \"@mongez/config\";\r\nimport { Application } from \"../application\";\r\nimport { bootstrap } from \"../bootstrap\";\r\nimport { loadConfigFiles } from \"../config/load-config-files\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\r\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\r\nimport { assertPortIsAvailable } from \"../http/port-preflight\";\r\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\r\nimport { publishTestServerPort, withdrawTestServerPort } from \"./test-server-port-channel\";\r\n\r\nlet isServerRunning = false;\r\n\r\nexport type StartHttpTestServerOptions = {\r\n  /**\r\n   * Port the test server binds to, overriding `http.port`.\r\n   *\r\n   * Needed because the server cannot be moved from outside: this function\r\n   * bootstraps the app itself, and that bootstrap re-reads `.env`.\r\n   */\r\n  port?: number;\r\n};\r\n\r\n/**\r\n * Apply the caller's port and preflight the bind.\r\n *\r\n * Called at the last moment before the HTTP connector binds, and that timing is\r\n * the fix: `bootstrap()` re-reads `.env` through `loadEnv()` (dotenv overrides\r\n * by default), and `src/config/http.ts` then resolves its port from that store,\r\n * so anything the caller set earlier is gone by the time the port is read.\r\n * Writing into `config` here is also the only channel that works — assigning\r\n * `process.env.HTTP_PORT` has no effect, since `env()` reads dotenv's own store\r\n * and never falls back to `process.env`.\r\n */\r\nasync function applyTestServerPort(port?: number): Promise<void> {\r\n  const httpConfig = config.get(\"http\");\r\n\r\n  if (!httpConfig) {\r\n    if (port !== undefined) {\r\n      throw new Error(\r\n        `startHttpTestServer({ port: ${port} }) was given a port, but this app has no \\`http\\` config, so no HTTP server is started. Add \\`src/config/http.ts\\` first.`,\r\n      );\r\n    }\r\n\r\n    return;\r\n  }\r\n\r\n  if (port !== undefined) {\r\n    config.set(\"http.port\", port);\r\n  }\r\n\r\n  const resolvedPort = config.get(\"http.port\");\r\n\r\n  // No configured port — or an explicit `0`, which is the OS's \"pick a free one\r\n  // for me\" idiom — means Fastify chooses the port, so there is nothing to\r\n  // preflight and nothing to publish: preflighting 0 would bind some unrelated\r\n  // ephemeral port and pass without proving anything, and publishing 0 would\r\n  // point every worker request at `http://host:0`.\r\n  if (typeof resolvedPort !== \"number\" || resolvedPort <= 0) {\r\n    return;\r\n  }\r\n\r\n  await assertPortIsAvailable(resolvedPort, config.get(\"http.host\") || \"localhost\");\r\n\r\n  publishTestServerPort(resolvedPort);\r\n}\r\n\r\n/**\r\n * Start the HTTP test server (minimal - no file watching)\r\n * Call this in Vitest's globalSetup\r\n *\r\n * @example\r\n * // run this suite on its own port, whatever `.env` says\r\n * await startHttpTestServer({ port: 3999 });\r\n */\r\nexport async function startHttpTestServer(\r\n  options: StartHttpTestServerOptions = {},\r\n): Promise<void> {\r\n  if (isServerRunning) {\r\n    console.log(\"[test-server] Server already running, skipping start\");\r\n    return;\r\n  }\r\n\r\n  console.log(\"[test-server] Starting HTTP test server...\");\r\n\r\n  // Set environment\r\n  Application.setRuntimeStrategy(\"development\");\r\n  Application.setEnvironment(\"test\");\r\n\r\n  // Bootstrap (env, etc.)\r\n  await warlockConfigManager.load();\r\n  await bootstrap();\r\n\r\n  // Initialize file orchestrator (but don't watch)\r\n  await filesOrchestrator.init();\r\n  await filesOrchestrator.initializeAll();\r\n\r\n  // Load config files\r\n  await loadConfigFiles(true);\r\n\r\n  // Early-phase connectors (database, cache, logger, storage, mailer,\r\n  // herald) must start BEFORE app modules load: a module's `main.ts` boot\r\n  // side-effect can query the DB at import time, so the data source has to\r\n  // be registered first. This mirrors the dev/prod boot order (see\r\n  // `cli-commands.manager`, `production-builder`, and `DevelopmentServer`).\r\n  await connectorsManager.startPhase(ConnectorLifecyclePhase.Early);\r\n\r\n  // Load application modules (their boot side-effects now see a live DB).\r\n  await filesOrchestrator.moduleLoader.loadAll();\r\n\r\n  await applyTestServerPort(options.port);\r\n\r\n  // Late-phase connectors (http, socket) bind after app code has\r\n  // registered its routes and listeners.\r\n  await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\r\n\r\n  isServerRunning = true;\r\n}\r\n\r\n/**\r\n * Stop the HTTP test server\r\n * Call this in Vitest's globalTeardown\r\n */\r\nexport async function stopHttpTestServer(): Promise<void> {\r\n  if (!isServerRunning) {\r\n    console.log(\"[test-server] No server to stop\");\r\n    return;\r\n  }\r\n\r\n  try {\r\n    await connectorsManager.shutdown();\r\n    withdrawTestServerPort();\r\n    isServerRunning = false;\r\n    console.log(\"[test-server] HTTP test server stopped\");\r\n  } catch (error) {\r\n    console.error(\"[test-server] Error stopping HTTP server:\", error);\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Check if test server is running\r\n */\r\nexport function isTestServerRunning(): boolean {\r\n  return isServerRunning;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAI,kBAAkB;;;;;;;;;;;;AAuBtB,eAAe,oBAAoB,MAA8B;CAG/D,IAAI,CAFe,OAAO,IAAI,MAEhB,GAAG;EACf,IAAI,SAAS,QACX,MAAM,IAAI,MACR,+BAA+B,KAAK,2HACtC;EAGF;CACF;CAEA,IAAI,SAAS,QACX,OAAO,IAAI,aAAa,IAAI;CAG9B,MAAM,eAAe,OAAO,IAAI,WAAW;CAO3C,IAAI,OAAO,iBAAiB,YAAY,gBAAgB,GACtD;CAGF,MAAM,sBAAsB,cAAc,OAAO,IAAI,WAAW,KAAK,WAAW;CAEhF,sBAAsB,YAAY;AACpC;;;;;;;;;AAUA,eAAsB,oBACpB,UAAsC,CAAC,GACxB;CACf,IAAI,iBAAiB;EACnB,QAAQ,IAAI,sDAAsD;EAClE;CACF;CAEA,QAAQ,IAAI,4CAA4C;CAGxD,YAAY,mBAAmB,aAAa;CAC5C,YAAY,eAAe,MAAM;CAGjC,MAAM,qBAAqB,KAAK;CAChC,MAAM,UAAU;CAGhB,MAAM,kBAAkB,KAAK;CAC7B,MAAM,kBAAkB,cAAc;CAGtC,MAAM,gBAAgB,IAAI;CAO1B,MAAM,kBAAkB,kBAAwC;CAGhE,MAAM,kBAAkB,aAAa,QAAQ;CAE7C,MAAM,oBAAoB,QAAQ,IAAI;CAItC,MAAM,kBAAkB,iBAAuC;CAE/D,kBAAkB;AACpB;;;;;AAMA,eAAsB,qBAAoC;CACxD,IAAI,CAAC,iBAAiB;EACpB,QAAQ,IAAI,iCAAiC;EAC7C;CACF;CAEA,IAAI;EACF,MAAM,kBAAkB,SAAS;EACjC,uBAAuB;EACvB,kBAAkB;EAClB,QAAQ,IAAI,wCAAwC;CACtD,SAAS,OAAO;EACd,QAAQ,MAAM,6CAA6C,KAAK;EAChE,MAAM;CACR;AACF;;;;AAKA,SAAgB,sBAA+B;CAC7C,OAAO;AACT"}
+{"version":3,"file":"start-http-development-server.mjs","names":[],"sources":["../../../../../../../core/src/tests/start-http-development-server.ts"],"sourcesContent":["/**\r\n * HTTP Test Server\r\n *\r\n * Starts a minimal HTTP server for testing.\r\n * Unlike the full DevelopmentServer, this:\r\n * - Does NOT watch files\r\n * - Does NOT do HMR\r\n * - Only starts connectors needed for HTTP requests\r\n *\r\n * Used in Vitest's globalSetup to start server once for all test workers.\r\n */\r\nimport config from \"@mongez/config\";\r\nimport { Application } from \"../application\";\r\nimport { bootstrap } from \"../bootstrap\";\r\nimport { loadConfigFiles } from \"../config/load-config-files\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\r\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\r\nimport { assertPortIsAvailable } from \"../http/port-preflight\";\r\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\r\nimport { publishTestServerPort, withdrawTestServerPort } from \"./test-server-port-channel\";\r\n\r\nlet isServerRunning = false;\r\n\r\nexport type StartHttpTestServerOptions = {\r\n  /**\r\n   * Port the test server binds to, overriding `http.port`.\r\n   *\r\n   * Needed because the server cannot be moved from outside: this function\r\n   * bootstraps the app itself, and that bootstrap re-reads `.env`.\r\n   */\r\n  port?: number;\r\n};\r\n\r\n/**\r\n * Apply the caller's port and preflight the bind.\r\n *\r\n * Called at the last moment before the HTTP connector binds, and that timing is\r\n * the fix: `bootstrap()` re-reads `.env` through `loadEnv()` (dotenv overrides\r\n * by default), and `src/config/http.ts` then resolves its port from that store,\r\n * so anything the caller set earlier is gone by the time the port is read.\r\n * Writing into `config` here is also the only channel that works — assigning\r\n * `process.env.HTTP_PORT` has no effect, since `env()` reads dotenv's own store\r\n * and never falls back to `process.env`.\r\n */\r\nasync function applyTestServerPort(port?: number): Promise<void> {\r\n  const httpConfig = config.get(\"http\");\r\n\r\n  if (!httpConfig) {\r\n    if (port !== undefined) {\r\n      throw new Error(\r\n        `startHttpTestServer({ port: ${port} }) was given a port, but this app has no \\`http\\` config, so no HTTP server is started. Add \\`src/config/http.ts\\` first.`,\r\n      );\r\n    }\r\n\r\n    return;\r\n  }\r\n\r\n  if (port !== undefined) {\r\n    config.set(\"http.port\", port);\r\n  }\r\n\r\n  const resolvedPort = config.get(\"http.port\");\r\n\r\n  // No configured port at all is fine: Fastify falls back to its own default and\r\n  // the workers resolve the same one from their own config, so both ends agree\r\n  // without the channel.\r\n  //\r\n  // ⚠ A non-numeric port also lands here, and that is NOT fine — it is just not\r\n  // this function's bug to fix. `env()` coerces a value only when it round-trips\r\n  // exactly (`String(Number(v)) === v`), so `HTTP_PORT=3999` and `HTTP_PORT=0`\r\n  // arrive as numbers, but `03999`, `+3999`, `1e3` and anything with stray\r\n  // whitespace stay strings. Those skip the preflight and the publish here, and\r\n  // reach `HttpConnector.start()`'s `listen({ port })` unchanged — a production\r\n  // path, not a test one. Tracked separately rather than widened into this fix.\r\n  if (typeof resolvedPort !== \"number\") {\r\n    return;\r\n  }\r\n\r\n  // `0` is the OS's \"pick a free one for me\" idiom, and the test server cannot\r\n  // support it. Preflighting 0 would bind some unrelated ephemeral port and pass\r\n  // without proving anything, and there is nothing meaningful to publish: the\r\n  // port Fastify ends up binding is never recorded — `HttpConnector.start()`\r\n  // stores the port it ASKED for, not the one it got. Accepting 0 silently is\r\n  // what left `getTestServerUrl()` resolving to `http://host:0` through its own\r\n  // config fallback, so every worker request went to a port nothing listens on.\r\n  if (resolvedPort <= 0) {\r\n    throw new Error(\r\n      `startHttpTestServer() cannot run on port ${resolvedPort}. Pass an explicit port — e.g. startHttpTestServer({ port: 3999 }) — or set \\`http.port\\` in your config. Test workers are separate processes that resolve the server's URL from the port published at startup, and an OS-assigned port is not knowable to them.`,\r\n    );\r\n  }\r\n\r\n  await assertPortIsAvailable(resolvedPort, config.get(\"http.host\") || \"localhost\");\r\n\r\n  publishTestServerPort(resolvedPort);\r\n}\r\n\r\n/**\r\n * Start the HTTP test server (minimal - no file watching)\r\n * Call this in Vitest's globalSetup\r\n *\r\n * @example\r\n * // run this suite on its own port, whatever `.env` says\r\n * await startHttpTestServer({ port: 3999 });\r\n */\r\nexport async function startHttpTestServer(\r\n  options: StartHttpTestServerOptions = {},\r\n): Promise<void> {\r\n  if (isServerRunning) {\r\n    console.log(\"[test-server] Server already running, skipping start\");\r\n    return;\r\n  }\r\n\r\n  console.log(\"[test-server] Starting HTTP test server...\");\r\n\r\n  try {\r\n    // Set environment\r\n    Application.setRuntimeStrategy(\"development\");\r\n    Application.setEnvironment(\"test\");\r\n\r\n    // Bootstrap (env, etc.)\r\n    await warlockConfigManager.load();\r\n    await bootstrap();\r\n\r\n    // Initialize file orchestrator (but don't watch)\r\n    await filesOrchestrator.init();\r\n    await filesOrchestrator.initializeAll();\r\n\r\n    // Load config files\r\n    await loadConfigFiles(true);\r\n\r\n    // Early-phase connectors (database, cache, logger, storage, mailer,\r\n    // herald) must start BEFORE app modules load: a module's `main.ts` boot\r\n    // side-effect can query the DB at import time, so the data source has to\r\n    // be registered first. This mirrors the dev/prod boot order (see\r\n    // `cli-commands.manager`, `production-builder`, and `DevelopmentServer`).\r\n    await connectorsManager.startPhase(ConnectorLifecyclePhase.Early);\r\n\r\n    // Load application modules (their boot side-effects now see a live DB).\r\n    await filesOrchestrator.moduleLoader.loadAll();\r\n\r\n    await applyTestServerPort(options.port);\r\n\r\n    // Late-phase connectors (http, socket) bind after app code has\r\n    // registered its routes and listeners.\r\n    await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\r\n\r\n    isServerRunning = true;\r\n  } catch (error) {\r\n    // This function owns the connectors it starts, so a failure part-way\r\n    // through has to leave nothing behind. Without this, `isServerRunning` was\r\n    // still `false` — it is only set on the last line — so `globalTeardown`'s\r\n    // `stopHttpTestServer()` reported \"No server to stop\" and walked away from\r\n    // live early-phase connectors and a published port that outlived them.\r\n    await unwindPartialStartup();\r\n\r\n    // Rethrown unchanged: the startup failure is the one the caller needs to\r\n    // read. A cleanup failure that replaced it would hide the actual cause.\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Best-effort teardown of whatever a failed {@link startHttpTestServer} managed\r\n * to start.\r\n *\r\n * Every step is independent and none may throw: this runs while an error is\r\n * already in flight, and the caller is about to rethrow it.\r\n */\r\nasync function unwindPartialStartup(): Promise<void> {\r\n  try {\r\n    await connectorsManager.shutdown();\r\n  } catch (shutdownError) {\r\n    // Reported, not thrown — it is secondary to the startup error being\r\n    // rethrown, and losing that one to this would be the worse outcome.\r\n    console.error(\"[test-server] Cleanup after a failed start did not complete:\", shutdownError);\r\n  }\r\n\r\n  withdrawTestServerPort();\r\n  isServerRunning = false;\r\n}\r\n\r\n/**\r\n * Stop the HTTP test server\r\n * Call this in Vitest's globalTeardown\r\n */\r\nexport async function stopHttpTestServer(): Promise<void> {\r\n  if (!isServerRunning) {\r\n    console.log(\"[test-server] No server to stop\");\r\n    return;\r\n  }\r\n\r\n  try {\r\n    await connectorsManager.shutdown();\r\n\r\n    console.log(\"[test-server] HTTP test server stopped\");\r\n  } catch (error) {\r\n    // Surfaced, never swallowed — cleaning up is not the same as the shutdown\r\n    // having succeeded, and a suite whose teardown failed should say so.\r\n    console.error(\"[test-server] Error stopping HTTP server:\", error);\r\n\r\n    throw error;\r\n  } finally {\r\n    // In a `finally` rather than after the `await`: when `shutdown()` threw,\r\n    // the published port survived the server it pointed at, so the next run in\r\n    // the same process inherited a stale one and sent every request to it.\r\n    withdrawTestServerPort();\r\n\r\n    isServerRunning = false;\r\n  }\r\n}\r\n\r\n/**\r\n * Check if test server is running\r\n */\r\nexport function isTestServerRunning(): boolean {\r\n  return isServerRunning;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAI,kBAAkB;;;;;;;;;;;;AAuBtB,eAAe,oBAAoB,MAA8B;CAG/D,IAAI,CAFe,OAAO,IAAI,MAEhB,GAAG;EACf,IAAI,SAAS,QACX,MAAM,IAAI,MACR,+BAA+B,KAAK,2HACtC;EAGF;CACF;CAEA,IAAI,SAAS,QACX,OAAO,IAAI,aAAa,IAAI;CAG9B,MAAM,eAAe,OAAO,IAAI,WAAW;CAa3C,IAAI,OAAO,iBAAiB,UAC1B;CAUF,IAAI,gBAAgB,GAClB,MAAM,IAAI,MACR,4CAA4C,aAAa,iQAC3D;CAGF,MAAM,sBAAsB,cAAc,OAAO,IAAI,WAAW,KAAK,WAAW;CAEhF,sBAAsB,YAAY;AACpC;;;;;;;;;AAUA,eAAsB,oBACpB,UAAsC,CAAC,GACxB;CACf,IAAI,iBAAiB;EACnB,QAAQ,IAAI,sDAAsD;EAClE;CACF;CAEA,QAAQ,IAAI,4CAA4C;CAExD,IAAI;EAEF,YAAY,mBAAmB,aAAa;EAC5C,YAAY,eAAe,MAAM;EAGjC,MAAM,qBAAqB,KAAK;EAChC,MAAM,UAAU;EAGhB,MAAM,kBAAkB,KAAK;EAC7B,MAAM,kBAAkB,cAAc;EAGtC,MAAM,gBAAgB,IAAI;EAO1B,MAAM,kBAAkB,kBAAwC;EAGhE,MAAM,kBAAkB,aAAa,QAAQ;EAE7C,MAAM,oBAAoB,QAAQ,IAAI;EAItC,MAAM,kBAAkB,iBAAuC;EAE/D,kBAAkB;CACpB,SAAS,OAAO;EAMd,MAAM,qBAAqB;EAI3B,MAAM;CACR;AACF;;;;;;;;AASA,eAAe,uBAAsC;CACnD,IAAI;EACF,MAAM,kBAAkB,SAAS;CACnC,SAAS,eAAe;EAGtB,QAAQ,MAAM,gEAAgE,aAAa;CAC7F;CAEA,uBAAuB;CACvB,kBAAkB;AACpB;;;;;AAMA,eAAsB,qBAAoC;CACxD,IAAI,CAAC,iBAAiB;EACpB,QAAQ,IAAI,iCAAiC;EAC7C;CACF;CAEA,IAAI;EACF,MAAM,kBAAkB,SAAS;EAEjC,QAAQ,IAAI,wCAAwC;CACtD,SAAS,OAAO;EAGd,QAAQ,MAAM,6CAA6C,KAAK;EAEhE,MAAM;CACR,UAAU;EAIR,uBAAuB;EAEvB,kBAAkB;CACpB;AACF;;;;AAKA,SAAgB,sBAA+B;CAC7C,OAAO;AACT"}

package/esm/tests/test-helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"test-helpers.d.mts","names":[],"sources":["../../../../../../../core/src/tests/test-helpers.ts"],"mappings":";;AAYA;;;;AAAgC;AAehC;;AAfgC,iBAAhB,gBAAA;;;;;iBAeM,WAAA,CAAY,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,QAAA;;;;iBAgB9D,OAAA,CAAQ,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,QAAA;;;AAhBY;iBAuBtE,QAAA,CACpB,IAAA,UACA,IAAA,YACA,OAAA,GAAS,WAAA,GACR,OAAA,CAAQ,QAAA;;;;iBAWW,OAAA,CACpB,IAAA,UACA,IAAA,YACA,OAAA,GAAS,WAAA,GACR,OAAA,CAAQ,QAAA;;;;iBAWW,UAAA,CAAW,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,QAAA;;;;iBAO7D,SAAA,CACpB,IAAA,UACA,IAAA,YACA,OAAA,GAAS,WAAA,GACR,OAAA,CAAQ,QAAA;;AAhD6E;AAOxF;iBAoDsB,iBAAA,IAAqB,QAAA,EAAU,QAAA,GAAW,OAAA,CAAQ,CAAA;;;;iBAOlD,UAAA,IAAc,QAAA,EAAU,QAAA,EAAU,cAAA,YAAuB,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"test-helpers.d.mts","names":[],"sources":["../../../../../../../core/src/tests/test-helpers.ts"],"mappings":";;AAYA;;;;AAAgC;AAehC;;AAfgC,iBAAhB,gBAAA;;;;;iBAeM,WAAA,CAAY,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,QAAA;;;;iBAgD9D,OAAA,CAAQ,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,QAAA;;;AAhDY;iBAuDtE,QAAA,CACpB,IAAA,UACA,IAAA,YACA,OAAA,GAAS,WAAA,GACR,OAAA,CAAQ,QAAA;;;;iBAOW,OAAA,CACpB,IAAA,UACA,IAAA,YACA,OAAA,GAAS,WAAA,GACR,OAAA,CAAQ,QAAA;;;;iBAOW,UAAA,CAAW,IAAA,UAAc,OAAA,GAAS,WAAA,GAAmB,OAAA,CAAQ,QAAA;;;;iBAO7D,SAAA,CACpB,IAAA,UACA,IAAA,YACA,OAAA,GAAS,WAAA,GACR,OAAA,CAAQ,QAAA;;AAxC6E;AAOxF;iBAwCsB,iBAAA,IAAqB,QAAA,EAAU,QAAA,GAAW,OAAA,CAAQ,CAAA;;;;iBAOlD,UAAA,IAAc,QAAA,EAAU,QAAA,EAAU,cAAA,YAAuB,OAAA,CAAQ,CAAA"}

package/esm/tests/test-helpers.mjs

@@ -20,17 +20,38 @@ function getTestServerUrl() {
 * Uses native fetch - lightweight, no extra dependencies
 */
 async function testRequest(path, options = {}) {
+	return sendRequest(path, options, false);
+}
+/**
+* The single place a request is actually built.
+*
+* `serializedJson` says whether THIS module turned the caller's value into a
+* JSON string. It is the only thing that justifies setting a JSON content type:
+* a `FormData` body carries a multipart boundary the runtime generates, and
+* labelling it `application/json` produces a request no server can parse.
+*/
+async function sendRequest(path, options, serializedJson) {
 	const baseUrl = getTestServerUrl();
 	const url = path.startsWith("/") ? `${baseUrl}${path}` : `${baseUrl}/${path}`;
+	const headers = new Headers(options.headers);
+	if (serializedJson && !headers.has("content-type")) headers.set("content-type", "application/json");
 	return fetch(url, {
 		...options,
-		headers: {
-			"Content-Type": "application/json",
-			...options.headers
-		}
+		headers
 	});
 }
 /**
+* Serialize a body for a JSON request.
+*
+* `undefined` means the caller omitted the argument; every other value —
+* including `false`, `0`, `""` and `null` — is a legal JSON document and must
+* be sent. The old check was `body ? JSON.stringify(body) : undefined`, which
+* dropped all four.
+*/
+function jsonBody(body) {
+	return body === void 0 ? void 0 : JSON.stringify(body);
+}
+/**
 * GET request helper
 */
 async function testGet(path, options = {}) {
@@ -43,21 +64,21 @@ async function testGet(path, options = {}) {
 * POST request helper
 */
 async function testPost(path, body, options = {}) {
-	return testRequest(path, {
+	return sendRequest(path, {
 		...options,
 		method: "POST",
-		body: body ? JSON.stringify(body) : void 0
-	});
+		body: jsonBody(body)
+	}, body !== void 0);
 }
 /**
 * PUT request helper
 */
 async function testPut(path, body, options = {}) {
-	return testRequest(path, {
+	return sendRequest(path, {
 		...options,
 		method: "PUT",
-		body: body ? JSON.stringify(body) : void 0
-	});
+		body: jsonBody(body)
+	}, body !== void 0);
 }
 /**
 * DELETE request helper
@@ -72,11 +93,11 @@ async function testDelete(path, options = {}) {
 * PATCH request helper
 */
 async function testPatch(path, body, options = {}) {
-	return testRequest(path, {
+	return sendRequest(path, {
 		...options,
 		method: "PATCH",
-		body: body ? JSON.stringify(body) : void 0
-	});
+		body: jsonBody(body)
+	}, body !== void 0);
 }
 /**
 * Parse JSON response with type safety

package/esm/tests/test-helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"test-helpers.mjs","names":[],"sources":["../../../../../../../core/src/tests/test-helpers.ts"],"sourcesContent":["/**\n * Warlock.js Test Helpers\n *\n * Utilities for testing Warlock.js applications.\n */\n\nimport { config } from \"../config\";\nimport { TEST_SERVER_PORT_ENV_KEY } from \"./test-server-port-channel\";\n\n/**\n * Get the test server base URL\n */\nexport function getTestServerUrl(): string {\n  // `startHttpTestServer` publishes the port it actually bound. Test workers are\n  // separate processes whose own config resolves `http.port` from `.env`, so\n  // without this a suite started on an explicit port would send every request to\n  // the `.env` port instead of the one the server is listening on.\n  const publishedPort = process.env[TEST_SERVER_PORT_ENV_KEY];\n  const port = publishedPort || config.key(\"http.port\", 2031);\n  const host = config.key(\"http.host\", \"localhost\");\n  return `http://${host}:${port}`;\n}\n\n/**\n * Simple HTTP request helper for test server\n * Uses native fetch - lightweight, no extra dependencies\n */\nexport async function testRequest(path: string, options: RequestInit = {}): Promise<Response> {\n  const baseUrl = getTestServerUrl();\n  const url = path.startsWith(\"/\") ? `${baseUrl}${path}` : `${baseUrl}/${path}`;\n\n  return fetch(url, {\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options.headers,\n    },\n  });\n}\n\n/**\n * GET request helper\n */\nexport async function testGet(path: string, options: RequestInit = {}): Promise<Response> {\n  return testRequest(path, { ...options, method: \"GET\" });\n}\n\n/**\n * POST request helper\n */\nexport async function testPost(\n  path: string,\n  body?: unknown,\n  options: RequestInit = {},\n): Promise<Response> {\n  return testRequest(path, {\n    ...options,\n    method: \"POST\",\n    body: body ? JSON.stringify(body) : undefined,\n  });\n}\n\n/**\n * PUT request helper\n */\nexport async function testPut(\n  path: string,\n  body?: unknown,\n  options: RequestInit = {},\n): Promise<Response> {\n  return testRequest(path, {\n    ...options,\n    method: \"PUT\",\n    body: body ? JSON.stringify(body) : undefined,\n  });\n}\n\n/**\n * DELETE request helper\n */\nexport async function testDelete(path: string, options: RequestInit = {}): Promise<Response> {\n  return testRequest(path, { ...options, method: \"DELETE\" });\n}\n\n/**\n * PATCH request helper\n */\nexport async function testPatch(\n  path: string,\n  body?: unknown,\n  options: RequestInit = {},\n): Promise<Response> {\n  return testRequest(path, {\n    ...options,\n    method: \"PATCH\",\n    body: body ? JSON.stringify(body) : undefined,\n  });\n}\n\n/**\n * Parse JSON response with type safety\n */\nexport async function parseJsonResponse<T>(response: Response): Promise<T> {\n  return response.json() as Promise<T>;\n}\n\n/**\n * Assert response status and return parsed JSON\n */\nexport async function expectJson<T>(response: Response, expectedStatus = 200): Promise<T> {\n  if (response.status !== expectedStatus) {\n    const text = await response.text();\n    throw new Error(`Expected status ${expectedStatus}, got ${response.status}. Body: ${text}`);\n  }\n  return parseJsonResponse<T>(response);\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAgB,mBAA2B;CAMzC,MAAM,OADgB,QAAQ,mCACA,OAAO,IAAI,aAAa,IAAI;CAE1D,OAAO,UADM,OAAO,IAAI,aAAa,WACjB,EAAE,GAAG;AAC3B;;;;;AAMA,eAAsB,YAAY,MAAc,UAAuB,CAAC,GAAsB;CAC5F,MAAM,UAAU,iBAAiB;CACjC,MAAM,MAAM,KAAK,WAAW,GAAG,IAAI,GAAG,UAAU,SAAS,GAAG,QAAQ,GAAG;CAEvE,OAAO,MAAM,KAAK;EAChB,GAAG;EACH,SAAS;GACP,gBAAgB;GAChB,GAAG,QAAQ;EACb;CACF,CAAC;AACH;;;;AAKA,eAAsB,QAAQ,MAAc,UAAuB,CAAC,GAAsB;CACxF,OAAO,YAAY,MAAM;EAAE,GAAG;EAAS,QAAQ;CAAM,CAAC;AACxD;;;;AAKA,eAAsB,SACpB,MACA,MACA,UAAuB,CAAC,GACL;CACnB,OAAO,YAAY,MAAM;EACvB,GAAG;EACH,QAAQ;EACR,MAAM,OAAO,KAAK,UAAU,IAAI,IAAI;CACtC,CAAC;AACH;;;;AAKA,eAAsB,QACpB,MACA,MACA,UAAuB,CAAC,GACL;CACnB,OAAO,YAAY,MAAM;EACvB,GAAG;EACH,QAAQ;EACR,MAAM,OAAO,KAAK,UAAU,IAAI,IAAI;CACtC,CAAC;AACH;;;;AAKA,eAAsB,WAAW,MAAc,UAAuB,CAAC,GAAsB;CAC3F,OAAO,YAAY,MAAM;EAAE,GAAG;EAAS,QAAQ;CAAS,CAAC;AAC3D;;;;AAKA,eAAsB,UACpB,MACA,MACA,UAAuB,CAAC,GACL;CACnB,OAAO,YAAY,MAAM;EACvB,GAAG;EACH,QAAQ;EACR,MAAM,OAAO,KAAK,UAAU,IAAI,IAAI;CACtC,CAAC;AACH;;;;AAKA,eAAsB,kBAAqB,UAAgC;CACzE,OAAO,SAAS,KAAK;AACvB;;;;AAKA,eAAsB,WAAc,UAAoB,iBAAiB,KAAiB;CACxF,IAAI,SAAS,WAAW,gBAAgB;EACtC,MAAM,OAAO,MAAM,SAAS,KAAK;EACjC,MAAM,IAAI,MAAM,mBAAmB,eAAe,QAAQ,SAAS,OAAO,UAAU,MAAM;CAC5F;CACA,OAAO,kBAAqB,QAAQ;AACtC"}
+{"version":3,"file":"test-helpers.mjs","names":[],"sources":["../../../../../../../core/src/tests/test-helpers.ts"],"sourcesContent":["/**\n * Warlock.js Test Helpers\n *\n * Utilities for testing Warlock.js applications.\n */\n\nimport { config } from \"../config\";\nimport { TEST_SERVER_PORT_ENV_KEY } from \"./test-server-port-channel\";\n\n/**\n * Get the test server base URL\n */\nexport function getTestServerUrl(): string {\n  // `startHttpTestServer` publishes the port it actually bound. Test workers are\n  // separate processes whose own config resolves `http.port` from `.env`, so\n  // without this a suite started on an explicit port would send every request to\n  // the `.env` port instead of the one the server is listening on.\n  const publishedPort = process.env[TEST_SERVER_PORT_ENV_KEY];\n  const port = publishedPort || config.key(\"http.port\", 2031);\n  const host = config.key(\"http.host\", \"localhost\");\n  return `http://${host}:${port}`;\n}\n\n/**\n * Simple HTTP request helper for test server\n * Uses native fetch - lightweight, no extra dependencies\n */\nexport async function testRequest(path: string, options: RequestInit = {}): Promise<Response> {\n  return sendRequest(path, options, false);\n}\n\n/**\n * The single place a request is actually built.\n *\n * `serializedJson` says whether THIS module turned the caller's value into a\n * JSON string. It is the only thing that justifies setting a JSON content type:\n * a `FormData` body carries a multipart boundary the runtime generates, and\n * labelling it `application/json` produces a request no server can parse.\n */\nasync function sendRequest(\n  path: string,\n  options: RequestInit,\n  serializedJson: boolean,\n): Promise<Response> {\n  const baseUrl = getTestServerUrl();\n  const url = path.startsWith(\"/\") ? `${baseUrl}${path}` : `${baseUrl}/${path}`;\n\n  // Normalised through `Headers` rather than object-spread: `RequestInit.headers`\n  // may be a record, a `Headers` instance, or a list of `[name, value]` tuples,\n  // and spreading the last two silently produces an object with numeric keys —\n  // the header is simply lost, with no error anywhere.\n  const headers = new Headers(options.headers);\n\n  if (serializedJson && !headers.has(\"content-type\")) {\n    headers.set(\"content-type\", \"application/json\");\n  }\n\n  return fetch(url, { ...options, headers });\n}\n\n/**\n * Serialize a body for a JSON request.\n *\n * `undefined` means the caller omitted the argument; every other value —\n * including `false`, `0`, `\"\"` and `null` — is a legal JSON document and must\n * be sent. The old check was `body ? JSON.stringify(body) : undefined`, which\n * dropped all four.\n */\nfunction jsonBody(body: unknown): string | undefined {\n  return body === undefined ? undefined : JSON.stringify(body);\n}\n\n/**\n * GET request helper\n */\nexport async function testGet(path: string, options: RequestInit = {}): Promise<Response> {\n  return testRequest(path, { ...options, method: \"GET\" });\n}\n\n/**\n * POST request helper\n */\nexport async function testPost(\n  path: string,\n  body?: unknown,\n  options: RequestInit = {},\n): Promise<Response> {\n  return sendRequest(path, { ...options, method: \"POST\", body: jsonBody(body) }, body !== undefined);\n}\n\n/**\n * PUT request helper\n */\nexport async function testPut(\n  path: string,\n  body?: unknown,\n  options: RequestInit = {},\n): Promise<Response> {\n  return sendRequest(path, { ...options, method: \"PUT\", body: jsonBody(body) }, body !== undefined);\n}\n\n/**\n * DELETE request helper\n */\nexport async function testDelete(path: string, options: RequestInit = {}): Promise<Response> {\n  return testRequest(path, { ...options, method: \"DELETE\" });\n}\n\n/**\n * PATCH request helper\n */\nexport async function testPatch(\n  path: string,\n  body?: unknown,\n  options: RequestInit = {},\n): Promise<Response> {\n  return sendRequest(path, { ...options, method: \"PATCH\", body: jsonBody(body) }, body !== undefined);\n}\n\n/**\n * Parse JSON response with type safety\n */\nexport async function parseJsonResponse<T>(response: Response): Promise<T> {\n  return response.json() as Promise<T>;\n}\n\n/**\n * Assert response status and return parsed JSON\n */\nexport async function expectJson<T>(response: Response, expectedStatus = 200): Promise<T> {\n  if (response.status !== expectedStatus) {\n    const text = await response.text();\n    throw new Error(`Expected status ${expectedStatus}, got ${response.status}. Body: ${text}`);\n  }\n  return parseJsonResponse<T>(response);\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAgB,mBAA2B;CAMzC,MAAM,OADgB,QAAQ,mCACA,OAAO,IAAI,aAAa,IAAI;CAE1D,OAAO,UADM,OAAO,IAAI,aAAa,WACjB,EAAE,GAAG;AAC3B;;;;;AAMA,eAAsB,YAAY,MAAc,UAAuB,CAAC,GAAsB;CAC5F,OAAO,YAAY,MAAM,SAAS,KAAK;AACzC;;;;;;;;;AAUA,eAAe,YACb,MACA,SACA,gBACmB;CACnB,MAAM,UAAU,iBAAiB;CACjC,MAAM,MAAM,KAAK,WAAW,GAAG,IAAI,GAAG,UAAU,SAAS,GAAG,QAAQ,GAAG;CAMvE,MAAM,UAAU,IAAI,QAAQ,QAAQ,OAAO;CAE3C,IAAI,kBAAkB,CAAC,QAAQ,IAAI,cAAc,GAC/C,QAAQ,IAAI,gBAAgB,kBAAkB;CAGhD,OAAO,MAAM,KAAK;EAAE,GAAG;EAAS;CAAQ,CAAC;AAC3C;;;;;;;;;AAUA,SAAS,SAAS,MAAmC;CACnD,OAAO,SAAS,SAAY,SAAY,KAAK,UAAU,IAAI;AAC7D;;;;AAKA,eAAsB,QAAQ,MAAc,UAAuB,CAAC,GAAsB;CACxF,OAAO,YAAY,MAAM;EAAE,GAAG;EAAS,QAAQ;CAAM,CAAC;AACxD;;;;AAKA,eAAsB,SACpB,MACA,MACA,UAAuB,CAAC,GACL;CACnB,OAAO,YAAY,MAAM;EAAE,GAAG;EAAS,QAAQ;EAAQ,MAAM,SAAS,IAAI;CAAE,GAAG,SAAS,MAAS;AACnG;;;;AAKA,eAAsB,QACpB,MACA,MACA,UAAuB,CAAC,GACL;CACnB,OAAO,YAAY,MAAM;EAAE,GAAG;EAAS,QAAQ;EAAO,MAAM,SAAS,IAAI;CAAE,GAAG,SAAS,MAAS;AAClG;;;;AAKA,eAAsB,WAAW,MAAc,UAAuB,CAAC,GAAsB;CAC3F,OAAO,YAAY,MAAM;EAAE,GAAG;EAAS,QAAQ;CAAS,CAAC;AAC3D;;;;AAKA,eAAsB,UACpB,MACA,MACA,UAAuB,CAAC,GACL;CACnB,OAAO,YAAY,MAAM;EAAE,GAAG;EAAS,QAAQ;EAAS,MAAM,SAAS,IAAI;CAAE,GAAG,SAAS,MAAS;AACpG;;;;AAKA,eAAsB,kBAAqB,UAAgC;CACzE,OAAO,SAAS,KAAK;AACvB;;;;AAKA,eAAsB,WAAc,UAAoB,iBAAiB,KAAiB;CACxF,IAAI,SAAS,WAAW,gBAAgB;EACtC,MAAM,OAAO,MAAM,SAAS,KAAK;EACjC,MAAM,IAAI,MAAM,mBAAmB,eAAe,QAAQ,SAAS,OAAO,UAAU,MAAM;CAC5F;CACA,OAAO,kBAAqB,QAAQ;AACtC"}

package/esm/tests/vitest-setup.d.mts

@@ -8,7 +8,7 @@ type TestSetup = {
  */
 declare function setupTest({
   connectors
-}: TestSetup): Promise<void>;
+}?: TestSetup): Promise<void>;
 //#endregion
 export { setupTest };
 //# sourceMappingURL=vitest-setup.d.mts.map

package/esm/tests/vitest-setup.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"vitest-setup.d.mts","names":[],"sources":["../../../../../../../core/src/tests/vitest-setup.ts"],"mappings":";;KAmBK,SAAA;EACH,UAAA,aAAuB,aAAa;AAAA;AAR2B;;;AAAA,iBAc3C,SAAA;EAAY;AAAA,GAAqB,SAAA,GAAS,OAAA"}
+{"version":3,"file":"vitest-setup.d.mts","names":[],"sources":["../../../../../../../core/src/tests/vitest-setup.ts"],"mappings":";;KAmBK,SAAA;EACH,UAAA,aAAuB,aAAa;AAAA;AAR2B;;;AAAA,iBAc3C,SAAA;EAAY;AAAA,IAAqB,SAAA,GAAc,OAAA"}

package/esm/tests/vitest-setup.mjs

@@ -13,7 +13,7 @@ let isSetupComplete = false;
 /**
 * Setup function that runs once per worker thread
 */
-async function setupTest({ connectors = true }) {
+async function setupTest({ connectors = true } = {}) {
 	if (isSetupComplete) return;
 	try {
 		Application.setEnvironment("test");
@@ -21,8 +21,8 @@ async function setupTest({ connectors = true }) {
 		await bootstrap();
 		await filesOrchestrator.init();
 		await loadConfigFiles(true);
-		const connectorsToStart = config.get("tests").connectors || connectors;
-		if (Array.isArray(connectorsToStart)) await connectorsManager.start(connectorsToStart);
+		const connectorsToStart = config.get("tests", {})?.connectors ?? connectors;
+		if (connectorsToStart !== false) if (Array.isArray(connectorsToStart)) await connectorsManager.start(connectorsToStart);
 		else await connectorsManager.startWithout(["http"]);
 		isSetupComplete = true;
 	} catch (error) {

package/esm/tests/vitest-setup.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vitest-setup.mjs","names":[],"sources":["../../../../../../../core/src/tests/vitest-setup.ts"],"sourcesContent":["/**\n * Vitest Setup File\n *\n * This file runs in each Vitest worker thread before tests execute.\n * It bootstraps the framework and starts necessary connectors so tests\n * have access to database connections and other shared resources.\n */\nimport { GenericObject } from \"@mongez/reinforcements\";\nimport { Application } from \"../application/application\";\nimport { bootstrap } from \"../bootstrap\";\nimport { config } from \"../config\";\nimport { loadConfigFiles } from \"../config/load-config-files\";\nimport { ConnectorName, connectorsManager } from \"../connectors\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\n\n// Global flag to prevent duplicate setup within the same worker\nlet isSetupComplete = false;\n\ntype TestSetup = {\n  connectors?: boolean | ConnectorName[];\n};\n\n/**\n * Setup function that runs once per worker thread\n */\nexport async function setupTest({ connectors = true }: TestSetup) {\n  // Skip if already set up in this worker\n  if (isSetupComplete) {\n    return;\n  }\n\n  try {\n    // 1. Set environment to test\n    Application.setEnvironment(\"test\");\n\n    await warlockConfigManager.load();\n    await bootstrap();\n\n    await filesOrchestrator.init();\n    await loadConfigFiles(true);\n\n    // 2. Load test configuration\n    const testConfig = config.get<GenericObject>(\"tests\");\n\n    // 3. Start connectors (database, cache, etc.)\n    const connectorsToStart = testConfig.connectors || connectors;\n\n    // force not starting http since it will be used globally over all\n    // tests files\n    if (Array.isArray(connectorsToStart)) {\n      await connectorsManager.start(connectorsToStart);\n    } else {\n      await connectorsManager.startWithout([\"http\"]);\n    }\n\n    isSetupComplete = true;\n  } catch (error) {\n    console.error(\"[vitest-setup] Failed to setup test environment:\", error);\n    throw error;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAiBA,IAAI,kBAAkB;;;;AAStB,eAAsB,UAAU,EAAE,aAAa,QAAmB;CAEhE,IAAI,iBACF;CAGF,IAAI;EAEF,YAAY,eAAe,MAAM;EAEjC,MAAM,qBAAqB,KAAK;EAChC,MAAM,UAAU;EAEhB,MAAM,kBAAkB,KAAK;EAC7B,MAAM,gBAAgB,IAAI;EAM1B,MAAM,oBAHa,OAAO,IAAmB,OAGV,CAAC,CAAC,cAAc;EAInD,IAAI,MAAM,QAAQ,iBAAiB,GACjC,MAAM,kBAAkB,MAAM,iBAAiB;OAE/C,MAAM,kBAAkB,aAAa,CAAC,MAAM,CAAC;EAG/C,kBAAkB;CACpB,SAAS,OAAO;EACd,QAAQ,MAAM,oDAAoD,KAAK;EACvE,MAAM;CACR;AACF"}
+{"version":3,"file":"vitest-setup.mjs","names":[],"sources":["../../../../../../../core/src/tests/vitest-setup.ts"],"sourcesContent":["/**\n * Vitest Setup File\n *\n * This file runs in each Vitest worker thread before tests execute.\n * It bootstraps the framework and starts necessary connectors so tests\n * have access to database connections and other shared resources.\n */\nimport { GenericObject } from \"@mongez/reinforcements\";\nimport { Application } from \"../application/application\";\nimport { bootstrap } from \"../bootstrap\";\nimport { config } from \"../config\";\nimport { loadConfigFiles } from \"../config/load-config-files\";\nimport { ConnectorName, connectorsManager } from \"../connectors\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\n\n// Global flag to prevent duplicate setup within the same worker\nlet isSetupComplete = false;\n\ntype TestSetup = {\n  connectors?: boolean | ConnectorName[];\n};\n\n/**\n * Setup function that runs once per worker thread\n */\nexport async function setupTest({ connectors = true }: TestSetup = {}) {\n  // Skip if already set up in this worker\n  if (isSetupComplete) {\n    return;\n  }\n\n  try {\n    // 1. Set environment to test\n    Application.setEnvironment(\"test\");\n\n    await warlockConfigManager.load();\n    await bootstrap();\n\n    await filesOrchestrator.init();\n    await loadConfigFiles(true);\n\n    // 2. Load test configuration.\n    //\n    // The default matters: `config.get` resolves an absent key to its default,\n    // and ITS default is `null` — not `{}`. `warlock add test` does not generate\n    // `src/config/tests.ts`, so reading `.connectors` off the result threw\n    // \"Cannot read properties of null\" on the generated default path.\n    const testConfig = config.get<GenericObject>(\"tests\", {});\n\n    // 3. Choose the connectors.\n    //\n    // `??`, not `||`: `false` is a meaningful configured value (\"start none\")\n    // and `||` discarded it, falling through to the branch that starts\n    // everything. The type and the skill both document `false` as \"start none\",\n    // so the old behaviour was the exact opposite of the promise.\n    const connectorsToStart = testConfig?.connectors ?? connectors;\n\n    // `false` means none at all. Everything else starts something: an array\n    // starts exactly those, and `true` starts all but http — http is the global\n    // setup's job, shared across every worker.\n    if (connectorsToStart !== false) {\n      if (Array.isArray(connectorsToStart)) {\n        await connectorsManager.start(connectorsToStart);\n      } else {\n        await connectorsManager.startWithout([\"http\"]);\n      }\n    }\n\n    // Set even when no connectors were started: setup DID complete, and a second\n    // call in the same worker must stay a no-op either way.\n    isSetupComplete = true;\n  } catch (error) {\n    console.error(\"[vitest-setup] Failed to setup test environment:\", error);\n    throw error;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAiBA,IAAI,kBAAkB;;;;AAStB,eAAsB,UAAU,EAAE,aAAa,SAAoB,CAAC,GAAG;CAErE,IAAI,iBACF;CAGF,IAAI;EAEF,YAAY,eAAe,MAAM;EAEjC,MAAM,qBAAqB,KAAK;EAChC,MAAM,UAAU;EAEhB,MAAM,kBAAkB,KAAK;EAC7B,MAAM,gBAAgB,IAAI;EAgB1B,MAAM,oBARa,OAAO,IAAmB,SAAS,CAAC,CAQpB,CAAC,EAAE,cAAc;EAKpD,IAAI,sBAAsB,OACxB,IAAI,MAAM,QAAQ,iBAAiB,GACjC,MAAM,kBAAkB,MAAM,iBAAiB;OAE/C,MAAM,kBAAkB,aAAa,CAAC,MAAM,CAAC;EAMjD,kBAAkB;CACpB,SAAS,OAAO;EACd,QAAQ,MAAM,oDAAoD,KAAK;EACvE,MAAM;CACR;AACF"}

package/esm/utils/framework-vesion.mjs

@@ -1,5 +1,5 @@
-import { getJsonFileAsync } from "@warlock.js/fs";
 import path from "node:path";
+import { getJsonFileAsync } from "@warlock.js/fs";
 
 //#region ../core/src/utils/framework-vesion.ts
 /**

package/esm/utils/index.d.mts

@@ -2,6 +2,7 @@ import { LocalizedObject, getLocalized } from "./get-localized.mjs";
 import { Environment, RuntimeStrategy, environment, setEnvironment } from "./environment.mjs";
 import { appLog } from "./app-log.mjs";
 import { DatabaseLog, DatabaseLogOptions } from "./database-log.mjs";
+import { Path } from "./normalized-path.mjs";
 import { fetchLatestVersion } from "./npm-registry.mjs";
 import { appPath, cachePath, configPath, logsPath, paths, publicPath, rootPath, sanitizePath, srcPath, storagePath, tempPath, uploadsPath, warlockPath } from "./paths.mjs";
 import { promiseAllObject } from "./promise-all-object.mjs";

package/esm/utils/index.mjs

@@ -2,6 +2,7 @@ import { appLog } from "./app-log.mjs";
 import { DatabaseLog } from "./database-log.mjs";
 import { environment, setEnvironment } from "./environment.mjs";
 import { getLocalized } from "./get-localized.mjs";
+import { Path } from "./normalized-path.mjs";
 import { fetchLatestVersion } from "./npm-registry.mjs";
 import { appPath, cachePath, configPath, logsPath, paths, publicPath, rootPath, sanitizePath, srcPath, storagePath, tempPath, uploadsPath, warlockPath } from "./paths.mjs";
 import { promiseAllObject } from "./promise-all-object.mjs";