@warlock.js/core 4.1.14 → 4.2.0

package/esm/router/router.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"router.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/router/router.ts"],"sourcesContent":["import proxy, { type FastifyHttpProxyOptions } from \"@fastify/http-proxy\";\r\nimport fastifyStatic, { type FastifyStaticOptions } from \"@fastify/static\";\r\nimport concatRoute from \"@mongez/concat-route\";\r\nimport { ltrim, merge, toCamelCase, trim } from \"@mongez/reinforcements\";\r\nimport { isEmpty } from \"@mongez/supportive-is\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport type { FastifyReply, FastifyRequest } from \"fastify\";\r\nimport { container } from \"../container\";\r\nimport { Request } from \"../http/request\";\r\nimport { Response } from \"../http/response\";\r\nimport { type FastifyInstance } from \"../http/server\";\r\nimport { RouteBuilder } from \"./route-builder\";\r\nimport { RouteRegistry } from \"./route-registry\";\r\nimport type {\r\n  GroupedRoutesOptions,\r\n  RequestHandler,\r\n  RequestHandlerType,\r\n  RequestHandlerValidation,\r\n  ResourceMethod,\r\n  Route,\r\n  RouteOptions,\r\n  RouteResource,\r\n  RouterGroupCallback,\r\n  RouterStacks,\r\n} from \"./types\";\r\n\r\nexport class Router {\r\n  /**\r\n   * Routes list\r\n   */\r\n  private routes: Route[] = [];\r\n\r\n  /**\r\n   * Router Instance\r\n   */\r\n  private static instance: Router;\r\n\r\n  /**\r\n   * Static paths\r\n   */\r\n  protected staticDirectories: FastifyStaticOptions[] = [];\r\n\r\n  /**\r\n   * Event listeners\r\n   */\r\n  protected eventListeners: Record<string, ((router: Router, server: FastifyInstance) => void)[]> =\r\n    {};\r\n\r\n  /**\r\n   * Stacks\r\n   * Stacks will be used for grouping routes to add prefix, name or middleware\r\n   */\r\n  protected stacks: RouterStacks = {\r\n    prefix: [],\r\n    name: [],\r\n    middleware: [],\r\n  };\r\n\r\n  /**\r\n   * Get router instance\r\n   */\r\n  public static getInstance() {\r\n    if (!Router.instance) {\r\n      Router.instance = new Router();\r\n    }\r\n\r\n    return Router.instance;\r\n  }\r\n\r\n  private constructor() {\r\n    //\r\n  }\r\n\r\n  /**\r\n   * Listen to router before scan\r\n   */\r\n  public beforeScanning(callback: (router: Router, server: FastifyInstance) => void) {\r\n    this.eventListeners.beforeScan = [...(this.eventListeners.beforeScan || []), callback];\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Listen to router after scanning\r\n   */\r\n  public afterScanning(callback: (router: Router, server: FastifyInstance) => void) {\r\n    this.eventListeners.afterScanning = [...(this.eventListeners.afterScanning || []), callback];\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Redirect path to another path\r\n   */\r\n  public redirect(from: string, to: string, redirectMode: \"temporary\" | \"permanent\" = \"temporary\") {\r\n    return this.get(from, (_request, response) => {\r\n      response.redirect(to, redirectMode === \"temporary\" ? 302 : 301);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Server static folder\r\n   */\r\n  public directory(options: FastifyStaticOptions) {\r\n    this.staticDirectories.push(options);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Serve file\r\n   */\r\n  public file(path: string, location: string, cacheTime?: number) {\r\n    return this.get(path, (_request, response) => {\r\n      response.sendFile(location, cacheTime);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Serve cached file, it will cache the file to 1 year by default\r\n   */\r\n  public cachedFile(path: string, location: string, cacheTime?: number) {\r\n    return this.get(path, (_request, response) => {\r\n      response.sendCachedFile(location, cacheTime);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Serve list of files\r\n   */\r\n  public files(files: Record<string, string>, cacheTime?: number) {\r\n    for (const [path, location] of Object.entries(files)) {\r\n      this.get(path, (_request, response) => {\r\n        response.sendFile(location, cacheTime);\r\n      });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Serve list of cached files, it will cache the file to 1 year by default\r\n   */\r\n  public cachedFiles(files: Record<string, string>, cacheTime?: number) {\r\n    for (const [path, location] of Object.entries(files)) {\r\n      this.get(path, (_request, response) => {\r\n        response.sendCachedFile(location, cacheTime);\r\n      });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Add proxy route\r\n   */\r\n  public proxy(\r\n    path: string,\r\n    baseUrl: string,\r\n    options?: Omit<FastifyHttpProxyOptions, \"prefix\" | \"upstream\">,\r\n  ): this;\r\n  public proxy(options: FastifyHttpProxyOptions): this;\r\n  public proxy(...args: any[]) {\r\n    this.beforeScanning((_router, server) => {\r\n      if (args.length === 1) {\r\n        server.register(proxy, args[0]);\r\n      } else {\r\n        server.register(proxy, {\r\n          prefix: args[0],\r\n          upstream: args[1],\r\n          ...args[2],\r\n        });\r\n      }\r\n    });\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Add route to routes list\r\n   */\r\n  public add(\r\n    method: Route[\"method\"],\r\n    path: string | string[],\r\n    handler: RequestHandlerType,\r\n    options: RouteOptions = {},\r\n  ) {\r\n    if (Array.isArray(path)) {\r\n      path.forEach((p) => this.add(method, p, handler, options));\r\n      return this;\r\n    }\r\n\r\n    const prefix = this.stacks.prefix.reduce((path, prefix) => {\r\n      return concatRoute(path, prefix);\r\n    }, \"\");\r\n\r\n    const name = this.stacks.name.reduceRight(\r\n      (name, prefixName) => {\r\n        return trim(prefixName + \".\" + name, \".\");\r\n      },\r\n      options.name || trim(path.replace(/\\//g, \".\"), \".\"),\r\n    );\r\n\r\n    path = concatRoute(prefix, path);\r\n\r\n    const middlewarePrecedence = options.middlewarePrecedence || \"after\";\r\n\r\n    if (middlewarePrecedence === \"before\") {\r\n      options.middleware = [...(options.middleware || []), ...this.stacks.middleware];\r\n    } else {\r\n      options.middleware = [...this.stacks.middleware, ...(options.middleware || [])];\r\n    }\r\n\r\n    if (Array.isArray(handler)) {\r\n      const [controller, action] = handler;\r\n\r\n      if (typeof controller[action] !== \"function\") {\r\n        throw new Error(\r\n          `Invalid controller action \"${action}\" for controller \"${controller.constructor.name}\"`,\r\n        );\r\n      }\r\n\r\n      handler = controller[action].bind(controller) as RequestHandler;\r\n\r\n      if (!handler.validation) {\r\n        handler.validation = {};\r\n        if (controller[`${action}ValidationSchema`]) {\r\n          handler.validation.schema = controller[`${action}ValidationSchema`]();\r\n        }\r\n\r\n        if (controller[`${action}Validate`]) {\r\n          handler.validation.validate = controller[`${action}Validate`];\r\n        }\r\n      }\r\n    }\r\n\r\n    const routeData: Route = {\r\n      method,\r\n      path,\r\n      handler,\r\n      ...options,\r\n      name,\r\n      rateLimit: options.rateLimit,\r\n      $prefix: prefix || \"/\",\r\n      // it must be a new array to avoid modifying the original array\r\n      $prefixStack: [...this.stacks.prefix],\r\n      // Inject source file from stacks if set\r\n      sourceFile: this.stacks.sourceFile || \"\",\r\n    };\r\n\r\n    if (routeData.name) {\r\n      // check if the name exists\r\n      const route = this.routes.find((route) => route.name === routeData.name);\r\n\r\n      if (route) {\r\n        // check again if the route name exists with the same method\r\n        if (route.method === routeData.method) {\r\n          throw new Error(`Route name \"${routeData.name}\" already exists`);\r\n        } else {\r\n          routeData.name += `.${routeData.method.toLowerCase()}`;\r\n        }\r\n      }\r\n    }\r\n\r\n    this.routes.push(routeData);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Add a request that accepts all methods\r\n   */\r\n  public any(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"all\" as Route[\"method\"], path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add get request method\r\n   */\r\n  public get(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"GET\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add post request method\r\n   */\r\n  public post(path: string | string[], handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"POST\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add put request method\r\n   */\r\n  public put(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"PUT\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add delete request method\r\n   */\r\n  public delete(path: string | string[], handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"DELETE\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add patch request method\r\n   */\r\n  public patch(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"PATCH\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add head request method\r\n   */\r\n  public head(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"HEAD\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add options request method\r\n   */\r\n  public options(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"OPTIONS\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Get a chainable route builder for the same route path\r\n   */\r\n  public route(path: string, options: RouteOptions = {}) {\r\n    return new RouteBuilder(this, path, options);\r\n  }\r\n\r\n  /**\r\n   * Add full restful resource routes\r\n   * This method will generate the following routes:\r\n   * 1. GET /path: list all resources\r\n   * 2. GET /path/:id: get a single resource\r\n   * 3. POST /path: create a new resource\r\n   * 4. PUT /path/:id: update a resource\r\n   * 5. DELETE /path/:id: delete a resource\r\n   * 6. PATCH /path/:id: update a resource partially\r\n   */\r\n  public restfulResource(\r\n    path: string,\r\n    resource: RouteResource,\r\n    options: RouteOptions & {\r\n      only?: ResourceMethod[];\r\n      except?: ResourceMethod[];\r\n      replace?: Partial<Record<ResourceMethod, RequestHandler>> & {\r\n        bulkDelete?: RequestHandler;\r\n      };\r\n    } = {},\r\n  ) {\r\n    return this.prefix(path, () => {\r\n      path = \"\";\r\n      // get base resource name\r\n      const baseResourceName = options.name || toCamelCase(ltrim(path, \"/\"));\r\n\r\n      // clone the resource so we don't mess up with it\r\n      const routeResource = resource;\r\n\r\n      const isAcceptableResource = (type: ResourceMethod) => {\r\n        return Boolean(\r\n          // check if the route is not excluded\r\n          (!options.except || !options.except.includes(type)) &&\r\n          // check if the only option is set and the route is included\r\n          (!options.only || options.only.includes(type)),\r\n        );\r\n      };\r\n\r\n      if (routeResource.list && isAcceptableResource(\"list\")) {\r\n        const resourceName = baseResourceName + \".list\";\r\n        this.get(path, options.replace?.list || routeResource.list.bind(routeResource), {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.get && isAcceptableResource(\"get\")) {\r\n        const resourceName = baseResourceName + \".single\";\r\n\r\n        this.get(path + \"/:id\", options.replace?.get || routeResource.get.bind(routeResource), {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.create && isAcceptableResource(\"create\")) {\r\n        const resourceName = baseResourceName + \".create\";\r\n\r\n        const handler = options.replace?.create || this.manageValidation(routeResource, \"create\");\r\n\r\n        this.post(path, handler, {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.update && isAcceptableResource(\"update\")) {\r\n        const resourceName = baseResourceName + \".update\";\r\n\r\n        const handler = options.replace?.update || this.manageValidation(routeResource, \"update\");\r\n\r\n        this.put(path + \"/:id\", handler, {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.patch && isAcceptableResource(\"patch\")) {\r\n        const resourceName = baseResourceName + \".patch\";\r\n\r\n        const handler = options.replace?.patch || this.manageValidation(routeResource, \"patch\");\r\n\r\n        this.patch(path + \"/:id\", handler, {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.delete && isAcceptableResource(\"delete\")) {\r\n        const resourceName = baseResourceName + \".delete\";\r\n\r\n        this.delete(\r\n          path + \"/:id\",\r\n          options.replace?.delete || routeResource.delete.bind(routeResource),\r\n          {\r\n            ...options,\r\n            name: resourceName,\r\n            restful: true,\r\n          },\r\n        );\r\n      }\r\n\r\n      if (routeResource.bulkDelete && isAcceptableResource(\"delete\")) {\r\n        const resourceName = baseResourceName + \".bulkDelete\";\r\n\r\n        this.delete(\r\n          path,\r\n          options.replace?.bulkDelete || routeResource.bulkDelete.bind(routeResource),\r\n          {\r\n            ...options,\r\n            name: resourceName,\r\n            restful: true,\r\n          },\r\n        );\r\n      }\r\n\r\n      return this;\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Group routes with options\r\n   */\r\n  public group(options: GroupedRoutesOptions, callback: RouterGroupCallback) {\r\n    const {\r\n      prefix,\r\n      // name must always be defined because\r\n      // if there are multiple groups without name\r\n      // they might generate the same route name\r\n      // thus causing an error\r\n      // in this case we need always to make sure that\r\n      // the name is always defined.\r\n      name = prefix ? trim(prefix.replace(/\\//g, \".\"), \".\") : undefined,\r\n      middleware,\r\n    } = options;\r\n\r\n    if (prefix) {\r\n      this.stacks.prefix.push(prefix);\r\n    }\r\n\r\n    if (name) {\r\n      this.stacks.name.push(name);\r\n    }\r\n\r\n    if (middleware) {\r\n      this.stacks.middleware.push(...middleware);\r\n    }\r\n\r\n    callback();\r\n\r\n    if (prefix) {\r\n      this.stacks.prefix.pop();\r\n    }\r\n\r\n    if (name) {\r\n      this.stacks.name.pop();\r\n    }\r\n\r\n    if (middleware) {\r\n      this.stacks.middleware.splice(\r\n        this.stacks.middleware.length - middleware.length,\r\n        middleware.length,\r\n      );\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Add prefix to all routes in the given callback\r\n   */\r\n  public prefix(prefix: string, callback: () => void) {\r\n    return this.group({ prefix }, callback);\r\n  }\r\n\r\n  /**\r\n   * Add API version prefix to all routes in the given callback\r\n   * Automatically formats the version as /v{version}\r\n   * @example\r\n   * router.version(\"1\", () => {\r\n   *   router.get(\"/users\", getUsersV1); // /v1/users\r\n   * });\r\n   *\r\n   * router.version(\"2\", () => {\r\n   *   router.get(\"/users\", getUsersV2); // /v2/users\r\n   * });\r\n   */\r\n  public version(version: string | number, callback: () => void) {\r\n    return this.prefix(`/v${version}`, callback);\r\n  }\r\n\r\n  /**\r\n   * Wrap route additions with a source file path\r\n   * Used for tracking which routes come from which file (for HMR)\r\n   * @param sourceFile Relative path to the source file (e.g., \"src/app/users/routes.ts\")\r\n   * @param callback Function that adds routes (will have sourceFile injected)\r\n   */\r\n  public async withSourceFile<T = any>(\r\n    sourceFile: string,\r\n    callback: () => T | Promise<T>,\r\n  ): Promise<T | undefined> {\r\n    // Set source file in stacks\r\n    this.stacks.sourceFile = sourceFile;\r\n\r\n    try {\r\n      // Execute callback (routes added here will have sourceFile injected)\r\n      return await callback();\r\n    } catch (error) {\r\n      console.log(\"Error in withSourceFile\", error);\r\n    } finally {\r\n      // Always clear source file from stacks\r\n      delete this.stacks.sourceFile;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Remove all routes that belong to a specific source file\r\n   * Used when reloading routes files via HMR\r\n   * @param sourceFile Relative path to the source file\r\n   */\r\n  public removeRoutesBySourceFile(sourceFile: string): void {\r\n    this.routes = this.routes.filter((route) => route.sourceFile !== sourceFile);\r\n  }\r\n\r\n  /**\r\n   * Manage validation system for the given resource\r\n   */\r\n  private manageValidation(resource: RouteResource, method: \"create\" | \"update\" | \"patch\") {\r\n    const handler = resource[method]?.bind(resource) as RequestHandler;\r\n\r\n    const methodValidation = resource?.validation?.[method];\r\n\r\n    if (method === \"patch\") {\r\n      handler.validation = methodValidation;\r\n\r\n      if (handler.validation?.validate) {\r\n        handler.validation.validate = handler.validation.validate.bind(resource);\r\n      }\r\n\r\n      if (resource.validation?.patch) {\r\n        handler.validation = merge(resource.validation.patch, handler.validation);\r\n      }\r\n\r\n      return handler;\r\n    }\r\n\r\n    if (!resource.validation || (!methodValidation && !resource.validation.all)) return handler;\r\n\r\n    if (resource.validation.all) {\r\n      const validationMethods = {\r\n        all: resource?.validation?.all?.validate,\r\n        [method]: methodValidation?.validate,\r\n      };\r\n\r\n      const validation: RequestHandlerValidation = {};\r\n\r\n      if (resource.validation.all.schema || methodValidation?.schema) {\r\n        if (!methodValidation?.schema && resource.validation.all.schema) {\r\n          // Case 2: Only all.schema exists - clone it for this method\r\n          validation.schema = resource.validation.all.schema;\r\n        } else if (methodValidation?.schema && resource.validation.all.schema) {\r\n          // Case 3: Both exist - merge them (all is base, method overrides)\r\n          validation.schema = resource.validation.all.schema.merge(methodValidation.schema);\r\n        } else if (methodValidation?.schema && !resource.validation.all.schema) {\r\n          // Case 1: Only method schema exists - use it directly\r\n          validation.schema = methodValidation.schema;\r\n        }\r\n        // Case 4: Neither exists - handled by outer if being false\r\n      }\r\n\r\n      if (validationMethods.all || validationMethods[method]) {\r\n        validation.validate = async (request: Request, response: Response) => {\r\n          if (validationMethods.all) {\r\n            const output = await validationMethods.all.call(resource, request, response);\r\n\r\n            if (output) return output;\r\n          }\r\n\r\n          if (validationMethods[method]) {\r\n            return await validationMethods[method]?.call(resource, request, response);\r\n          }\r\n\r\n          return;\r\n        };\r\n      }\r\n\r\n      if (!isEmpty(validation)) {\r\n        handler.validation = validation;\r\n      }\r\n    } else {\r\n      handler.validation = resource.validation[method];\r\n\r\n      if (handler.validation?.validate) {\r\n        handler.validation.validate = handler.validation.validate.bind(resource);\r\n      }\r\n    }\r\n\r\n    return handler;\r\n  }\r\n\r\n  /**\r\n   * Get all routes list\r\n   */\r\n  public list() {\r\n    return this.routes;\r\n  }\r\n\r\n  /**\r\n   * Register routes to the server\r\n   */\r\n  public scan(server: FastifyInstance) {\r\n    this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));\r\n\r\n    this.routes.forEach((route) => {\r\n      const requestMethod = route.method.toLowerCase();\r\n      const requestMethodFunction = server[requestMethod].bind(server);\r\n\r\n      const options = {\r\n        ...route.serverOptions,\r\n        config: {\r\n          ...route.serverOptions?.config,\r\n          ...(route.rateLimit && { rateLimit: route.rateLimit }),\r\n        },\r\n      };\r\n\r\n      requestMethodFunction(\r\n        route.path,\r\n        options,\r\n        async (baseRequest: FastifyRequest, reply: FastifyReply) => {\r\n          const { output, response } = await this.handleRoute(route)(baseRequest, reply);\r\n\r\n          return output || response.baseResponse;\r\n        },\r\n      );\r\n    });\r\n\r\n    for (const directoryOptions of this.staticDirectories) {\r\n      server.register(fastifyStatic, {\r\n        ...directoryOptions,\r\n        decorateReply: false,\r\n      });\r\n    }\r\n\r\n    this.eventListeners.afterScanning?.forEach((callback) => callback(this, server));\r\n  }\r\n\r\n  /**\r\n   * Scan routes for the development server\r\n   * Uses wildcard routing with find-my-way for HMR support\r\n   */\r\n  public scanDevServer(server: FastifyInstance) {\r\n    this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));\r\n\r\n    // Shared handler for wildcard routing\r\n    const wildcardHandler = async (fastifyRequest: FastifyRequest, fastifyReply: FastifyReply) => {\r\n      // Initialize route registry once (will be rebuilt on HMR via rebuildRouteRegistry)\r\n      const routeRegistry = new RouteRegistry();\r\n\r\n      routeRegistry.register(this.routes);\r\n      // Find matching route using find-my-way\r\n      const match = routeRegistry.find(fastifyRequest.method, fastifyRequest.url);\r\n\r\n      // No match found - return 404\r\n      if (!match) {\r\n        return fastifyReply.code(404).send({\r\n          error: \"Route not found\",\r\n          path: fastifyRequest.url,\r\n          method: fastifyRequest.method,\r\n        });\r\n      }\r\n\r\n      // Inject extracted params into the request\r\n      fastifyRequest.params = match.params;\r\n\r\n      try {\r\n        // Call the matched route handler\r\n        const { output, response } = await this.handleRoute(match.route)(\r\n          fastifyRequest,\r\n          fastifyReply,\r\n        );\r\n\r\n        return output || response.baseResponse;\r\n      } catch (error) {\r\n        console.log(error);\r\n        throw error;\r\n      }\r\n    };\r\n\r\n    // Register wildcard route for all methods EXCEPT OPTIONS (to avoid conflict with CORS)\r\n    // OPTIONS is handled by @fastify/cors plugin for preflight requests\r\n    const methods = [\"GET\", \"POST\", \"PUT\", \"DELETE\", \"PATCH\"] as const;\r\n    for (const method of methods) {\r\n      server.route({\r\n        method,\r\n        url: \"*\",\r\n        handler: wildcardHandler,\r\n      });\r\n    }\r\n\r\n    // Register static directories\r\n    for (const directoryOptions of this.staticDirectories) {\r\n      server.register(fastifyStatic, {\r\n        ...directoryOptions,\r\n        decorateReply: false,\r\n      });\r\n    }\r\n\r\n    this.eventListeners.afterScanning?.forEach((callback) => callback(this, server));\r\n  }\r\n\r\n  /**\r\n   * Get the route path for the given route name\r\n   */\r\n  public getRoute(name: string, params: any = {}) {\r\n    const route = this.routes.find((route) => route.name === name);\r\n\r\n    if (!route) {\r\n      throw new Error(`Route name \"${name}\" not found`);\r\n    }\r\n\r\n    let path = route.path;\r\n\r\n    if (route.path.includes(\":\")) {\r\n      Object.keys(params).forEach((key) => {\r\n        path = path.replace(\":\" + key, params[key]);\r\n      });\r\n    }\r\n\r\n    return path;\r\n  }\r\n\r\n  /**\r\n   * Handle the given route\r\n   */\r\n  private handleRoute(route: Route) {\r\n    return async (fastifyRequest: FastifyRequest, fastifyResponse: FastifyReply) => {\r\n      const request = new Request();\r\n      const response = new Response();\r\n      response.setResponse(fastifyResponse);\r\n      request.response = response;\r\n\r\n      response.request = request;\r\n\r\n      request.setRequest(fastifyRequest).setRoute(route);\r\n\r\n      log.info({\r\n        module: \"route\",\r\n        action: route.method + \" \" + route.path.replace(\"/*\", \"\"),\r\n        message: `Starting Request: ${request.id}`,\r\n        context: {\r\n          request,\r\n          response,\r\n        },\r\n      });\r\n\r\n      const result = await request.execute();\r\n\r\n      return {\r\n        output: result,\r\n        response,\r\n        request,\r\n      };\r\n    };\r\n  }\r\n}\r\n\r\nexport const router = Router.getInstance();\r\n\r\ncontainer.set(\"router\", router);\r\n"],"mappings":"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"}
+{"version":3,"file":"router.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/router/router.ts"],"sourcesContent":["import proxy, { type FastifyHttpProxyOptions } from \"@fastify/http-proxy\";\r\nimport fastifyStatic, { type FastifyStaticOptions } from \"@fastify/static\";\r\nimport concatRoute from \"@mongez/concat-route\";\r\nimport { ltrim, merge, toCamelCase, trim } from \"@mongez/reinforcements\";\r\nimport { isEmpty } from \"@mongez/supportive-is\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport type { FastifyReply, FastifyRequest } from \"fastify\";\r\nimport { container } from \"../container\";\r\nimport { Request } from \"../http/request\";\r\nimport { Response } from \"../http/response\";\r\nimport { type FastifyInstance } from \"../http/server\";\r\nimport { RouteBuilder } from \"./route-builder\";\r\nimport { RouteRegistry } from \"./route-registry\";\r\nimport type {\r\n  GroupedRoutesOptions,\r\n  RequestHandler,\r\n  RequestHandlerType,\r\n  RequestHandlerValidation,\r\n  ResourceMethod,\r\n  Route,\r\n  RouteOptions,\r\n  RouteResource,\r\n  RouterGroupCallback,\r\n  RouterStacks,\r\n} from \"./types\";\r\n\r\nexport class Router {\r\n  /**\r\n   * Routes list\r\n   */\r\n  private routes: Route[] = [];\r\n\r\n  /**\r\n   * Router Instance\r\n   */\r\n  private static instance: Router;\r\n\r\n  /**\r\n   * Static paths\r\n   */\r\n  protected staticDirectories: FastifyStaticOptions[] = [];\r\n\r\n  /**\r\n   * Event listeners\r\n   */\r\n  protected eventListeners: Record<string, ((router: Router, server: FastifyInstance) => void)[]> =\r\n    {};\r\n\r\n  /**\r\n   * Stacks\r\n   * Stacks will be used for grouping routes to add prefix, name or middleware\r\n   */\r\n  protected stacks: RouterStacks = {\r\n    prefix: [],\r\n    name: [],\r\n    middleware: [],\r\n  };\r\n\r\n  /**\r\n   * Get router instance\r\n   */\r\n  public static getInstance() {\r\n    if (!Router.instance) {\r\n      Router.instance = new Router();\r\n    }\r\n\r\n    return Router.instance;\r\n  }\r\n\r\n  private constructor() {\r\n    //\r\n  }\r\n\r\n  /**\r\n   * Listen to router before scan\r\n   */\r\n  public beforeScanning(callback: (router: Router, server: FastifyInstance) => void) {\r\n    this.eventListeners.beforeScan = [...(this.eventListeners.beforeScan || []), callback];\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Listen to router after scanning\r\n   */\r\n  public afterScanning(callback: (router: Router, server: FastifyInstance) => void) {\r\n    this.eventListeners.afterScanning = [...(this.eventListeners.afterScanning || []), callback];\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Redirect path to another path\r\n   */\r\n  public redirect(from: string, to: string, redirectMode: \"temporary\" | \"permanent\" = \"temporary\") {\r\n    return this.get(from, (_request, response) => {\r\n      response.redirect(to, redirectMode === \"temporary\" ? 302 : 301);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Server static folder\r\n   */\r\n  public directory(options: FastifyStaticOptions) {\r\n    this.staticDirectories.push(options);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Serve file\r\n   */\r\n  public file(path: string, location: string, cacheTime?: number) {\r\n    return this.get(path, (_request, response) => {\r\n      response.sendFile(location, cacheTime);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Serve cached file, it will cache the file to 1 year by default\r\n   */\r\n  public cachedFile(path: string, location: string, cacheTime?: number) {\r\n    return this.get(path, (_request, response) => {\r\n      response.sendCachedFile(location, cacheTime);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Serve list of files\r\n   */\r\n  public files(files: Record<string, string>, cacheTime?: number) {\r\n    for (const [path, location] of Object.entries(files)) {\r\n      this.get(path, (_request, response) => {\r\n        response.sendFile(location, cacheTime);\r\n      });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Serve list of cached files, it will cache the file to 1 year by default\r\n   */\r\n  public cachedFiles(files: Record<string, string>, cacheTime?: number) {\r\n    for (const [path, location] of Object.entries(files)) {\r\n      this.get(path, (_request, response) => {\r\n        response.sendCachedFile(location, cacheTime);\r\n      });\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Add proxy route\r\n   */\r\n  public proxy(\r\n    path: string,\r\n    baseUrl: string,\r\n    options?: Omit<FastifyHttpProxyOptions, \"prefix\" | \"upstream\">,\r\n  ): this;\r\n  public proxy(options: FastifyHttpProxyOptions): this;\r\n  public proxy(...args: any[]) {\r\n    this.beforeScanning((_router, server) => {\r\n      if (args.length === 1) {\r\n        server.register(proxy, args[0]);\r\n      } else {\r\n        server.register(proxy, {\r\n          prefix: args[0],\r\n          upstream: args[1],\r\n          ...args[2],\r\n        });\r\n      }\r\n    });\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Add route to routes list\r\n   */\r\n  public add(\r\n    method: Route[\"method\"],\r\n    path: string | string[],\r\n    handler: RequestHandlerType,\r\n    options: RouteOptions = {},\r\n  ) {\r\n    if (Array.isArray(path)) {\r\n      path.forEach((p) => this.add(method, p, handler, options));\r\n      return this;\r\n    }\r\n\r\n    const prefix = this.stacks.prefix.reduce((path, prefix) => {\r\n      return concatRoute(path, prefix);\r\n    }, \"\");\r\n\r\n    const name = this.stacks.name.reduceRight(\r\n      (name, prefixName) => {\r\n        return trim(prefixName + \".\" + name, \".\");\r\n      },\r\n      options.name || trim(path.replace(/\\//g, \".\"), \".\"),\r\n    );\r\n\r\n    path = concatRoute(prefix, path);\r\n\r\n    const middlewarePrecedence = options.middlewarePrecedence || \"after\";\r\n\r\n    if (middlewarePrecedence === \"before\") {\r\n      options.middleware = [...(options.middleware || []), ...this.stacks.middleware];\r\n    } else {\r\n      options.middleware = [...this.stacks.middleware, ...(options.middleware || [])];\r\n    }\r\n\r\n    if (Array.isArray(handler)) {\r\n      const [controller, action] = handler;\r\n\r\n      if (typeof controller[action] !== \"function\") {\r\n        throw new Error(\r\n          `Invalid controller action \"${action}\" for controller \"${controller.constructor.name}\"`,\r\n        );\r\n      }\r\n\r\n      handler = controller[action].bind(controller) as RequestHandler;\r\n\r\n      if (!handler.validation) {\r\n        handler.validation = {};\r\n        if (controller[`${action}ValidationSchema`]) {\r\n          handler.validation.schema = controller[`${action}ValidationSchema`]();\r\n        }\r\n\r\n        if (controller[`${action}Validate`]) {\r\n          handler.validation.validate = controller[`${action}Validate`];\r\n        }\r\n      }\r\n    }\r\n\r\n    const routeData: Route = {\r\n      method,\r\n      path,\r\n      handler,\r\n      ...options,\r\n      name,\r\n      rateLimit: options.rateLimit,\r\n      $prefix: prefix || \"/\",\r\n      // it must be a new array to avoid modifying the original array\r\n      $prefixStack: [...this.stacks.prefix],\r\n      // Inject source file from stacks if set\r\n      sourceFile: this.stacks.sourceFile || \"\",\r\n    };\r\n\r\n    if (routeData.name) {\r\n      // check if the name exists\r\n      const route = this.routes.find((route) => route.name === routeData.name);\r\n\r\n      if (route) {\r\n        // check again if the route name exists with the same method\r\n        if (route.method === routeData.method) {\r\n          throw new Error(`Route name \"${routeData.name}\" already exists`);\r\n        } else {\r\n          routeData.name += `.${routeData.method.toLowerCase()}`;\r\n        }\r\n      }\r\n    }\r\n\r\n    this.routes.push(routeData);\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Add a request that accepts all methods\r\n   */\r\n  public any(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"all\" as Route[\"method\"], path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add get request method\r\n   */\r\n  public get(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"GET\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add post request method\r\n   */\r\n  public post(path: string | string[], handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"POST\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add put request method\r\n   */\r\n  public put(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"PUT\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add delete request method\r\n   */\r\n  public delete(path: string | string[], handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"DELETE\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add patch request method\r\n   */\r\n  public patch(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"PATCH\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add head request method\r\n   */\r\n  public head(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"HEAD\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Add options request method\r\n   */\r\n  public options(path: string, handler: RequestHandlerType, options: RouteOptions = {}) {\r\n    return this.add(\"OPTIONS\", path, handler, options);\r\n  }\r\n\r\n  /**\r\n   * Get a chainable route builder for the same route path\r\n   */\r\n  public route(path: string, options: RouteOptions = {}) {\r\n    return new RouteBuilder(this, path, options);\r\n  }\r\n\r\n  /**\r\n   * Add full restful resource routes\r\n   * This method will generate the following routes:\r\n   * 1. GET /path: list all resources\r\n   * 2. GET /path/:id: get a single resource\r\n   * 3. POST /path: create a new resource\r\n   * 4. PUT /path/:id: update a resource\r\n   * 5. DELETE /path/:id: delete a resource\r\n   * 6. PATCH /path/:id: update a resource partially\r\n   */\r\n  public restfulResource(\r\n    path: string,\r\n    resource: RouteResource,\r\n    options: RouteOptions & {\r\n      only?: ResourceMethod[];\r\n      except?: ResourceMethod[];\r\n      replace?: Partial<Record<ResourceMethod, RequestHandler>> & {\r\n        bulkDelete?: RequestHandler;\r\n      };\r\n    } = {},\r\n  ) {\r\n    return this.prefix(path, () => {\r\n      path = \"\";\r\n      // get base resource name\r\n      const baseResourceName = options.name || toCamelCase(ltrim(path, \"/\"));\r\n\r\n      // clone the resource so we don't mess up with it\r\n      const routeResource = resource;\r\n\r\n      const isAcceptableResource = (type: ResourceMethod) => {\r\n        return Boolean(\r\n          // check if the route is not excluded\r\n          (!options.except || !options.except.includes(type)) &&\r\n          // check if the only option is set and the route is included\r\n          (!options.only || options.only.includes(type)),\r\n        );\r\n      };\r\n\r\n      if (routeResource.list && isAcceptableResource(\"list\")) {\r\n        const resourceName = baseResourceName + \".list\";\r\n        this.get(path, options.replace?.list || routeResource.list.bind(routeResource), {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.get && isAcceptableResource(\"get\")) {\r\n        const resourceName = baseResourceName + \".single\";\r\n\r\n        this.get(path + \"/:id\", options.replace?.get || routeResource.get.bind(routeResource), {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.create && isAcceptableResource(\"create\")) {\r\n        const resourceName = baseResourceName + \".create\";\r\n\r\n        const handler = options.replace?.create || this.manageValidation(routeResource, \"create\");\r\n\r\n        this.post(path, handler, {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.update && isAcceptableResource(\"update\")) {\r\n        const resourceName = baseResourceName + \".update\";\r\n\r\n        const handler = options.replace?.update || this.manageValidation(routeResource, \"update\");\r\n\r\n        this.put(path + \"/:id\", handler, {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.patch && isAcceptableResource(\"patch\")) {\r\n        const resourceName = baseResourceName + \".patch\";\r\n\r\n        const handler = options.replace?.patch || this.manageValidation(routeResource, \"patch\");\r\n\r\n        this.patch(path + \"/:id\", handler, {\r\n          ...options,\r\n          name: resourceName,\r\n          restful: true,\r\n        });\r\n      }\r\n\r\n      if (routeResource.delete && isAcceptableResource(\"delete\")) {\r\n        const resourceName = baseResourceName + \".delete\";\r\n\r\n        this.delete(\r\n          path + \"/:id\",\r\n          options.replace?.delete || routeResource.delete.bind(routeResource),\r\n          {\r\n            ...options,\r\n            name: resourceName,\r\n            restful: true,\r\n          },\r\n        );\r\n      }\r\n\r\n      if (routeResource.bulkDelete && isAcceptableResource(\"delete\")) {\r\n        const resourceName = baseResourceName + \".bulkDelete\";\r\n\r\n        this.delete(\r\n          path,\r\n          options.replace?.bulkDelete || routeResource.bulkDelete.bind(routeResource),\r\n          {\r\n            ...options,\r\n            name: resourceName,\r\n            restful: true,\r\n          },\r\n        );\r\n      }\r\n\r\n      return this;\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Group routes with options\r\n   */\r\n  public group(options: GroupedRoutesOptions, callback: RouterGroupCallback) {\r\n    const {\r\n      prefix,\r\n      // name must always be defined because\r\n      // if there are multiple groups without name\r\n      // they might generate the same route name\r\n      // thus causing an error\r\n      // in this case we need always to make sure that\r\n      // the name is always defined.\r\n      name = prefix ? trim(prefix.replace(/\\//g, \".\"), \".\") : undefined,\r\n      middleware,\r\n    } = options;\r\n\r\n    if (prefix) {\r\n      this.stacks.prefix.push(prefix);\r\n    }\r\n\r\n    if (name) {\r\n      this.stacks.name.push(name);\r\n    }\r\n\r\n    if (middleware) {\r\n      this.stacks.middleware.push(...middleware);\r\n    }\r\n\r\n    callback();\r\n\r\n    if (prefix) {\r\n      this.stacks.prefix.pop();\r\n    }\r\n\r\n    if (name) {\r\n      this.stacks.name.pop();\r\n    }\r\n\r\n    if (middleware) {\r\n      this.stacks.middleware.splice(\r\n        this.stacks.middleware.length - middleware.length,\r\n        middleware.length,\r\n      );\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Add prefix to all routes in the given callback\r\n   */\r\n  public prefix(prefix: string, callback: () => void) {\r\n    return this.group({ prefix }, callback);\r\n  }\r\n\r\n  /**\r\n   * Add API version prefix to all routes in the given callback\r\n   * Automatically formats the version as /v{version}\r\n   * @example\r\n   * router.version(\"1\", () => {\r\n   *   router.get(\"/users\", getUsersV1); // /v1/users\r\n   * });\r\n   *\r\n   * router.version(\"2\", () => {\r\n   *   router.get(\"/users\", getUsersV2); // /v2/users\r\n   * });\r\n   */\r\n  public version(version: string | number, callback: () => void) {\r\n    return this.prefix(`/v${version}`, callback);\r\n  }\r\n\r\n  /**\r\n   * Wrap route additions with a source file path\r\n   * Used for tracking which routes come from which file (for HMR)\r\n   * @param sourceFile Relative path to the source file (e.g., \"src/app/users/routes.ts\")\r\n   * @param callback Function that adds routes (will have sourceFile injected)\r\n   */\r\n  public async withSourceFile<T = any>(\r\n    sourceFile: string,\r\n    callback: () => T | Promise<T>,\r\n  ): Promise<T | undefined> {\r\n    // Set source file in stacks\r\n    this.stacks.sourceFile = sourceFile;\r\n\r\n    try {\r\n      // Execute callback (routes added here will have sourceFile injected)\r\n      return await callback();\r\n    } catch (error) {\r\n      console.log(\"Error in withSourceFile\", error);\r\n    } finally {\r\n      // Always clear source file from stacks\r\n      delete this.stacks.sourceFile;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Remove all routes that belong to a specific source file\r\n   * Used when reloading routes files via HMR\r\n   * @param sourceFile Relative path to the source file\r\n   */\r\n  public removeRoutesBySourceFile(sourceFile: string): void {\r\n    this.routes = this.routes.filter((route) => route.sourceFile !== sourceFile);\r\n  }\r\n\r\n  /**\r\n   * Manage validation system for the given resource\r\n   */\r\n  private manageValidation(resource: RouteResource, method: \"create\" | \"update\" | \"patch\") {\r\n    const handler = resource[method]?.bind(resource) as RequestHandler;\r\n\r\n    const methodValidation = resource?.validation?.[method];\r\n\r\n    if (method === \"patch\") {\r\n      handler.validation = methodValidation;\r\n\r\n      if (handler.validation?.validate) {\r\n        handler.validation.validate = handler.validation.validate.bind(resource);\r\n      }\r\n\r\n      if (resource.validation?.patch) {\r\n        handler.validation = merge(resource.validation.patch, handler.validation);\r\n      }\r\n\r\n      return handler;\r\n    }\r\n\r\n    if (!resource.validation || (!methodValidation && !resource.validation.all)) return handler;\r\n\r\n    if (resource.validation.all) {\r\n      const validationMethods = {\r\n        all: resource?.validation?.all?.validate,\r\n        [method]: methodValidation?.validate,\r\n      };\r\n\r\n      const validation: RequestHandlerValidation = {};\r\n\r\n      if (resource.validation.all.schema || methodValidation?.schema) {\r\n        if (!methodValidation?.schema && resource.validation.all.schema) {\r\n          // Case 2: Only all.schema exists - clone it for this method\r\n          validation.schema = resource.validation.all.schema;\r\n        } else if (methodValidation?.schema && resource.validation.all.schema) {\r\n          // Case 3: Both exist - merge them (all is base, method overrides)\r\n          validation.schema = resource.validation.all.schema.merge(methodValidation.schema);\r\n        } else if (methodValidation?.schema && !resource.validation.all.schema) {\r\n          // Case 1: Only method schema exists - use it directly\r\n          validation.schema = methodValidation.schema;\r\n        }\r\n        // Case 4: Neither exists - handled by outer if being false\r\n      }\r\n\r\n      if (validationMethods.all || validationMethods[method]) {\r\n        validation.validate = async (request: Request, response: Response) => {\r\n          if (validationMethods.all) {\r\n            const output = await validationMethods.all.call(resource, request, response);\r\n\r\n            if (output) return output;\r\n          }\r\n\r\n          if (validationMethods[method]) {\r\n            return await validationMethods[method]?.call(resource, request, response);\r\n          }\r\n\r\n          return;\r\n        };\r\n      }\r\n\r\n      if (!isEmpty(validation)) {\r\n        handler.validation = validation;\r\n      }\r\n    } else {\r\n      handler.validation = resource.validation[method];\r\n\r\n      if (handler.validation?.validate) {\r\n        handler.validation.validate = handler.validation.validate.bind(resource);\r\n      }\r\n    }\r\n\r\n    return handler;\r\n  }\r\n\r\n  /**\r\n   * Get all routes list\r\n   */\r\n  public list() {\r\n    return this.routes;\r\n  }\r\n\r\n  /**\r\n   * Register routes to the server\r\n   */\r\n  public scan(server: FastifyInstance) {\r\n    this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));\r\n\r\n    this.routes.forEach((route) => {\r\n      const requestMethod = route.method.toLowerCase();\r\n      const requestMethodFunction = server[requestMethod].bind(server);\r\n\r\n      const options = {\r\n        ...route.serverOptions,\r\n        config: {\r\n          ...route.serverOptions?.config,\r\n          ...(route.rateLimit && { rateLimit: route.rateLimit }),\r\n        },\r\n      };\r\n\r\n      requestMethodFunction(\r\n        route.path,\r\n        options,\r\n        async (baseRequest: FastifyRequest, reply: FastifyReply) => {\r\n          const { output, response } = await this.handleRoute(route)(baseRequest, reply);\r\n\r\n          return output || response.baseResponse;\r\n        },\r\n      );\r\n    });\r\n\r\n    for (const directoryOptions of this.staticDirectories) {\r\n      server.register(fastifyStatic, {\r\n        ...directoryOptions,\r\n        decorateReply: false,\r\n      });\r\n    }\r\n\r\n    this.eventListeners.afterScanning?.forEach((callback) => callback(this, server));\r\n  }\r\n\r\n  /**\r\n   * Scan routes for the development server\r\n   * Uses wildcard routing with find-my-way for HMR support\r\n   */\r\n  public scanDevServer(server: FastifyInstance) {\r\n    this.eventListeners.beforeScan?.forEach((callback) => callback(this, server));\r\n\r\n    // Shared handler for wildcard routing\r\n    const wildcardHandler = async (fastifyRequest: FastifyRequest, fastifyReply: FastifyReply) => {\r\n      // Initialize route registry once (will be rebuilt on HMR via rebuildRouteRegistry)\r\n      const routeRegistry = new RouteRegistry();\r\n\r\n      routeRegistry.register(this.routes);\r\n      // Find matching route using find-my-way\r\n      const match = routeRegistry.find(fastifyRequest.method, fastifyRequest.url);\r\n\r\n      // No match found - return 404\r\n      if (!match) {\r\n        return fastifyReply.code(404).send({\r\n          error: \"Route not found\",\r\n          path: fastifyRequest.url,\r\n          method: fastifyRequest.method,\r\n        });\r\n      }\r\n\r\n      // Inject extracted params into the request\r\n      fastifyRequest.params = match.params;\r\n\r\n      try {\r\n        // Call the matched route handler\r\n        const { output, response } = await this.handleRoute(match.route)(\r\n          fastifyRequest,\r\n          fastifyReply,\r\n        );\r\n\r\n        return output || response.baseResponse;\r\n      } catch (error) {\r\n        console.log(error);\r\n        throw error;\r\n      }\r\n    };\r\n\r\n    // Register wildcard route for all methods EXCEPT OPTIONS (to avoid conflict with CORS)\r\n    // OPTIONS is handled by @fastify/cors plugin for preflight requests\r\n    const methods = [\"GET\", \"POST\", \"PUT\", \"DELETE\", \"PATCH\"] as const;\r\n    for (const method of methods) {\r\n      server.route({\r\n        method,\r\n        url: \"*\",\r\n        handler: wildcardHandler,\r\n      });\r\n    }\r\n\r\n    // Register static directories\r\n    for (const directoryOptions of this.staticDirectories) {\r\n      server.register(fastifyStatic, {\r\n        ...directoryOptions,\r\n        decorateReply: false,\r\n      });\r\n    }\r\n\r\n    this.eventListeners.afterScanning?.forEach((callback) => callback(this, server));\r\n  }\r\n\r\n  /**\r\n   * Get the route path for the given route name\r\n   */\r\n  public getRoute(name: string, params: any = {}) {\r\n    const route = this.routes.find((route) => route.name === name);\r\n\r\n    if (!route) {\r\n      throw new Error(`Route name \"${name}\" not found`);\r\n    }\r\n\r\n    let path = route.path;\r\n\r\n    if (route.path.includes(\":\")) {\r\n      Object.keys(params).forEach((key) => {\r\n        path = path.replace(\":\" + key, params[key]);\r\n      });\r\n    }\r\n\r\n    return path;\r\n  }\r\n\r\n  /**\r\n   * Handle the given route\r\n   */\r\n  private handleRoute(route: Route) {\r\n    return async (fastifyRequest: FastifyRequest, fastifyResponse: FastifyReply) => {\r\n      const request = new Request();\r\n      const response = new Response();\r\n      response.setResponse(fastifyResponse);\r\n      request.response = response;\r\n\r\n      response.request = request;\r\n\r\n      request.setRequest(fastifyRequest).setRoute(route);\r\n\r\n      log.info({\r\n        module: \"route\",\r\n        action: route.method + \" \" + route.path.replace(\"/*\", \"\"),\r\n        message: `Starting Request: ${request.id}`,\r\n        context: {\r\n          request,\r\n          response,\r\n        },\r\n      });\r\n\r\n      const result = await request.execute();\r\n\r\n      return {\r\n        output: result,\r\n        response,\r\n        request,\r\n      };\r\n    };\r\n  }\r\n}\r\n\r\nexport const router = Router.getInstance();\r\n\r\ncontainer.set(\"router\", router);\r\n"],"mappings":"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"}

package/esm/router/types.d.mts

@@ -6,7 +6,7 @@ import { ObjectValidator } from "@warlock.js/seal";
 import { GenericObject } from "@mongez/reinforcements";
 import { RouteShorthandOptions } from "fastify";
 
-//#region ../../@warlock.js/core/src/router/types.d.ts
+//#region ../@warlock.js/core/src/router/types.d.ts
 /**
  * Middleware response
  */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../@warlock.js/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":["../../../../../../../@warlock.js/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"}

package/esm/socket/types.d.mts

@@ -1,6 +1,6 @@
 import { ServerOptions } from "node:http";
 
-//#region ../../@warlock.js/core/src/socket/types.d.ts
+//#region ../@warlock.js/core/src/socket/types.d.ts
 /**
  * Socket options
  */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/socket/types.ts"],"mappings":";;;;;AAKA;KAAY,aAAA;;;;EAIV,IAAA;EAIU;;AAAa;EAAvB,OAAA,GAAU,aAAa;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/socket/types.ts"],"mappings":";;;;;AAKA;KAAY,aAAA;;;;EAIV,IAAA;EAIU;;AAAa;EAAvB,OAAA,GAAU,aAAa;AAAA"}

package/esm/socket/utils.d.mts

@@ -1,6 +1,6 @@
 import { Server } from "socket.io";
 
-//#region ../../@warlock.js/core/src/socket/utils.d.ts
+//#region ../@warlock.js/core/src/socket/utils.d.ts
 /**
  * Get socket server instance
  */

package/esm/socket/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/socket/utils.ts"],"mappings":";;;;;AAMA;iBAAgB,eAAA,CAAA,GAAmB,MAAM"}
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/socket/utils.ts"],"mappings":";;;;;AAMA;iBAAgB,eAAA,IAAmB,MAAM"}

package/esm/socket/utils.mjs

@@ -1,6 +1,6 @@
 import { container } from "../container/index.mjs";
 
-//#region ../../@warlock.js/core/src/socket/utils.ts
+//#region ../@warlock.js/core/src/socket/utils.ts
 /**
 * Get socket server instance
 */

package/esm/socket/utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"utils.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/socket/utils.ts"],"sourcesContent":["import { type Server } from \"socket.io\";\nimport { container } from \"../container\";\n\n/**\n * Get socket server instance\n */\nexport function getSocketServer(): Server | null {\n  if (container.has(\"socket\")) {\n    return container.get(\"socket\");\n  }\n\n  return null;\n}\n"],"mappings":";;;;;;AAMA,SAAgB,kBAAiC;CAC/C,IAAI,UAAU,IAAI,QAAQ,GACxB,OAAO,UAAU,IAAI,QAAQ;CAG/B,OAAO;AACT"}
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/socket/utils.ts"],"sourcesContent":["import { type Server } from \"socket.io\";\nimport { container } from \"../container\";\n\n/**\n * Get socket server instance\n */\nexport function getSocketServer(): Server | null {\n  if (container.has(\"socket\")) {\n    return container.get(\"socket\");\n  }\n\n  return null;\n}\n"],"mappings":";;;;;;AAMA,SAAgB,kBAAiC;CAC/C,IAAI,UAAU,IAAI,QAAQ,GACxB,OAAO,UAAU,IAAI,QAAQ;CAG/B,OAAO;AACT"}

package/esm/storage/config.d.mts

@@ -1,7 +1,7 @@
 import { CloudStorageDriverOptions, LocalStorageDriverOptions, R2StorageDriverOptions, StorageConfigurations, StorageDriverConfig } from "./types.mjs";
 import { S3ClientConfig } from "@aws-sdk/client-s3";
 
-//#region ../../@warlock.js/core/src/storage/config.d.ts
+//#region ../@warlock.js/core/src/storage/config.d.ts
 /**
  * Get storage configuration
  */

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/storage/config.ts"],"mappings":";;;;;;AAaA;iBAAgB,aAAA,CAAA,GAAiB,qBAAqB;AAAA,iBACtC,aAAA,SAAA,CAAuB,GAAA,WAAc,CAAC;AAAA,iBACtC,aAAA,SAAA,CAAuB,GAAA,UAAa,YAAA,EAAc,CAAA,GAAI,CAAC;AAAA,cAS1D,qBAAA;mBACM,yBAAA,KAA4B,mBAAA;iBAM9B,yBAAA,GAA4B,cAAA,KAAiB,mBAAA;gBAM9C,sBAAA,GAAyB,cAAA,KAAiB,mBAAA;oBAMtC,yBAAA,GAA4B,cAAA,KAAiB,mBAAA;AAAA"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/config.ts"],"mappings":";;;;;;AAaA;iBAAgB,aAAA,IAAiB,qBAAqB;AAAA,iBACtC,aAAA,UAAuB,GAAA,WAAc,CAAC;AAAA,iBACtC,aAAA,UAAuB,GAAA,UAAa,YAAA,EAAc,CAAA,GAAI,CAAC;AAAA,cAS1D,qBAAA;mBACM,yBAAA,KAA4B,mBAAA;iBAM9B,yBAAA,GAA4B,cAAA,KAAiB,mBAAA;gBAM9C,sBAAA,GAAyB,cAAA,KAAiB,mBAAA;oBAMtC,yBAAA,GAA4B,cAAA,KAAiB,mBAAA;AAAA"}

package/esm/storage/config.mjs

@@ -1,7 +1,7 @@
 import { config } from "../config/config-getter.mjs";
 import "../config/index.mjs";
 
-//#region ../../@warlock.js/core/src/storage/config.ts
+//#region ../@warlock.js/core/src/storage/config.ts
 function storageConfig(key, defaultValue) {
 	if (!key) return config.get("storage");
 	return config.get(`storage.${key}`, defaultValue);

package/esm/storage/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/storage/config.ts"],"sourcesContent":["import type { S3ClientConfig } from \"@aws-sdk/client-s3\";\nimport { config } from \"../config\";\nimport type {\n  CloudStorageDriverOptions,\n  LocalStorageDriverOptions,\n  R2StorageDriverOptions,\n  StorageConfigurations,\n  StorageDriverConfig,\n} from \"./types\";\n\n/**\n * Get storage configuration\n */\nexport function storageConfig(): StorageConfigurations;\nexport function storageConfig<T = any>(key: string): T;\nexport function storageConfig<T = any>(key: string, defaultValue: T): T;\nexport function storageConfig(key?: string, defaultValue?: any): any {\n  if (!key) {\n    return config.get(\"storage\");\n  }\n\n  return config.get(`storage.${key}`, defaultValue);\n}\n\nexport const storageConfigurations = {\n  local: (options: LocalStorageDriverOptions): StorageDriverConfig => {\n    return {\n      driver: \"local\",\n      ...options,\n    };\n  },\n  aws: (options: CloudStorageDriverOptions & S3ClientConfig): StorageDriverConfig => {\n    return {\n      driver: \"s3\",\n      ...options,\n    };\n  },\n  r2: (options: R2StorageDriverOptions & S3ClientConfig): StorageDriverConfig => {\n    return {\n      driver: \"r2\",\n      ...options,\n    };\n  },\n  spaces: (options: CloudStorageDriverOptions & S3ClientConfig): StorageDriverConfig => {\n    return {\n      driver: \"spaces\",\n      ...options,\n    };\n  },\n};\n"],"mappings":";;;;AAgBA,SAAgB,cAAc,KAAc,cAAyB;CACnE,IAAI,CAAC,KACH,OAAO,OAAO,IAAI,SAAS;CAG7B,OAAO,OAAO,IAAI,WAAW,OAAO,YAAY;AAClD;AAEA,MAAa,wBAAwB;CACnC,QAAQ,YAA4D;EAClE,OAAO;GACL,QAAQ;GACR,GAAG;EACL;CACF;CACA,MAAM,YAA6E;EACjF,OAAO;GACL,QAAQ;GACR,GAAG;EACL;CACF;CACA,KAAK,YAA0E;EAC7E,OAAO;GACL,QAAQ;GACR,GAAG;EACL;CACF;CACA,SAAS,YAA6E;EACpF,OAAO;GACL,QAAQ;GACR,GAAG;EACL;CACF;AACF"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/config.ts"],"sourcesContent":["import type { S3ClientConfig } from \"@aws-sdk/client-s3\";\nimport { config } from \"../config\";\nimport type {\n  CloudStorageDriverOptions,\n  LocalStorageDriverOptions,\n  R2StorageDriverOptions,\n  StorageConfigurations,\n  StorageDriverConfig,\n} from \"./types\";\n\n/**\n * Get storage configuration\n */\nexport function storageConfig(): StorageConfigurations;\nexport function storageConfig<T = any>(key: string): T;\nexport function storageConfig<T = any>(key: string, defaultValue: T): T;\nexport function storageConfig(key?: string, defaultValue?: any): any {\n  if (!key) {\n    return config.get(\"storage\");\n  }\n\n  return config.get(`storage.${key}`, defaultValue);\n}\n\nexport const storageConfigurations = {\n  local: (options: LocalStorageDriverOptions): StorageDriverConfig => {\n    return {\n      driver: \"local\",\n      ...options,\n    };\n  },\n  aws: (options: CloudStorageDriverOptions & S3ClientConfig): StorageDriverConfig => {\n    return {\n      driver: \"s3\",\n      ...options,\n    };\n  },\n  r2: (options: R2StorageDriverOptions & S3ClientConfig): StorageDriverConfig => {\n    return {\n      driver: \"r2\",\n      ...options,\n    };\n  },\n  spaces: (options: CloudStorageDriverOptions & S3ClientConfig): StorageDriverConfig => {\n    return {\n      driver: \"spaces\",\n      ...options,\n    };\n  },\n};\n"],"mappings":";;;;AAgBA,SAAgB,cAAc,KAAc,cAAyB;CACnE,IAAI,CAAC,KACH,OAAO,OAAO,IAAI,SAAS;CAG7B,OAAO,OAAO,IAAI,WAAW,OAAO,YAAY;AAClD;AAEA,MAAa,wBAAwB;CACnC,QAAQ,YAA4D;EAClE,OAAO;GACL,QAAQ;GACR,GAAG;EACL;CACF;CACA,MAAM,YAA6E;EACjF,OAAO;GACL,QAAQ;GACR,GAAG;EACL;CACF;CACA,KAAK,YAA0E;EAC7E,OAAO;GACL,QAAQ;GACR,GAAG;EACL;CACF;CACA,SAAS,YAA6E;EACpF,OAAO;GACL,QAAQ;GACR,GAAG;EACL;CACF;AACF"}

package/esm/storage/context/storage-driver-context.d.mts

@@ -1,7 +1,7 @@
 import { StorageDriverContract } from "../types.mjs";
 import { Context } from "@warlock.js/context";
 
-//#region ../../@warlock.js/core/src/storage/context/storage-driver-context.d.ts
+//#region ../@warlock.js/core/src/storage/context/storage-driver-context.d.ts
 type StorageDriverContextStore = {
   driver?: StorageDriverContract;
   prefix?: string;

package/esm/storage/context/storage-driver-context.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-driver-context.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/context/storage-driver-context.ts"],"mappings":";;;;KAGY,yBAAA;EACV,MAAA,GAAS,qBAAA;EACT,MAAA;EACA,QAAA,GAAW,MAAM;AAAA;;;;;;;;AAAA;AACjB;;;;;;;;;;cAoBI,oBAAA,SAA6B,OAAA,CAAQ,yBAAA;EAAD;;;EAIjC,SAAA,CAAA,GAAa,qBAAA;EAAA;;;EAOb,SAAA,CAAA;EAiBA;;;EAVA,WAAA,CAAA,GAAe,MAAA;EAYS;;;;;;EAFxB,SAAA,CACL,MAAA,EAAQ,qBAAA,EACR,OAAA;IAAY,MAAA;IAAiB,QAAA,GAAW,MAAA;EAAA;EAwC/B;;;;AAAiD;;;;EAvBrD,SAAA,CAAU,MAAA;;;;EAOV,WAAA,CAAA;;;;EAOA,UAAA,CAAA,GAAc,yBAAA;AAAA;AAAA,cASV,oBAAA,EAAoB,oBAA6B"}
+{"version":3,"file":"storage-driver-context.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/core/src/storage/context/storage-driver-context.ts"],"mappings":";;;;KAGY,yBAAA;EACV,MAAA,GAAS,qBAAA;EACT,MAAA;EACA,QAAA,GAAW,MAAM;AAAA;;;;;;;;AAAA;AACjB;;;;;;;;;;cAoBI,oBAAA,SAA6B,OAAA,CAAQ,yBAAA;EAAD;;;EAIjC,SAAA,IAAa,qBAAA;EAAA;;;EAOb,SAAA;EAiBA;;;EAVA,WAAA,IAAe,MAAA;EAYS;;;;;;EAFxB,SAAA,CACL,MAAA,EAAQ,qBAAA,EACR,OAAA;IAAY,MAAA;IAAiB,QAAA,GAAW,MAAA;EAAA;EAwC/B;;;;AAAiD;;;;EAvBrD,SAAA,CAAU,MAAA;;;;EAOV,WAAA;;;;EAOA,UAAA,IAAc,yBAAA;AAAA;AAAA,cASV,oBAAA,EAAoB,oBAA6B"}

package/esm/storage/context/storage-driver-context.mjs

@@ -1,6 +1,6 @@
 import { Context, contextManager } from "@warlock.js/context";
 
-//#region ../../@warlock.js/core/src/storage/context/storage-driver-context.ts
+//#region ../@warlock.js/core/src/storage/context/storage-driver-context.ts
 /**
 * Storage Driver Context
 *

package/esm/storage/context/storage-driver-context.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage-driver-context.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/context/storage-driver-context.ts"],"sourcesContent":["import { Context, contextManager } from \"@warlock.js/context\";\nimport type { StorageDriverContract } from \"../types\";\n\nexport type StorageDriverContextStore = {\n  driver?: StorageDriverContract;\n  prefix?: string;\n  metadata?: Record<string, any>;\n};\n\n/**\n * Storage Driver Context\n *\n * Manages the active storage driver and path prefix using AsyncLocalStorage.\n * Allows multi-tenant applications to switch drivers and isolate storage paths per request context.\n *\n * @example\n * ```typescript\n * // Set driver with tenant-specific prefix\n * storageDriverContext.setDriver(storage.getDriver(\"s3\"), {\n *   prefix: \"tenant-123\",\n *   metadata: { tenantId: \"123\" }\n * });\n *\n * // Or just set prefix for same driver\n * storageDriverContext.setPrefix(\"tenant-456\");\n * ```\n */\nclass StorageDriverContext extends Context<StorageDriverContextStore> {\n  /**\n   * Get the current storage driver\n   */\n  public getDriver(): StorageDriverContract | undefined {\n    return this.get(\"driver\");\n  }\n\n  /**\n   * Get the current path prefix (e.g., tenant-specific path)\n   */\n  public getPrefix(): string | undefined {\n    return this.get(\"prefix\");\n  }\n\n  /**\n   * Get context metadata (e.g., tenantId)\n   */\n  public getMetadata(): Record<string, any> | undefined {\n    return this.get(\"metadata\");\n  }\n\n  /**\n   * Set the active driver with optional prefix and metadata\n   *\n   * @param driver - Storage driver to use\n   * @param options - Optional prefix and metadata\n   */\n  public setDriver(\n    driver: StorageDriverContract,\n    options?: { prefix?: string; metadata?: Record<string, any> },\n  ): void {\n    this.update({\n      driver,\n      prefix: options?.prefix,\n      metadata: options?.metadata,\n    });\n  }\n\n  /**\n   * Set only the path prefix (keeps current driver)\n   *\n   * Useful for multi-tenant scenarios where you want to isolate\n   * storage paths without changing the driver.\n   *\n   * @param prefix - Path prefix to prepend to all operations\n   */\n  public setPrefix(prefix: string): void {\n    this.update({ prefix });\n  }\n\n  /**\n   * Clear the prefix\n   */\n  public clearPrefix(): void {\n    this.update({ prefix: undefined });\n  }\n\n  /**\n   * Build the initial storage store with defaults\n   */\n  public buildStore(): StorageDriverContextStore {\n    return {\n      driver: undefined,\n      prefix: undefined,\n      metadata: undefined,\n    };\n  }\n}\n\nexport const storageDriverContext = new StorageDriverContext();\n\ncontextManager.register(\"storage\", storageDriverContext);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,IAAM,uBAAN,cAAmC,QAAmC;;;;CAIpE,AAAO,YAA+C;EACpD,OAAO,KAAK,IAAI,QAAQ;CAC1B;;;;CAKA,AAAO,YAAgC;EACrC,OAAO,KAAK,IAAI,QAAQ;CAC1B;;;;CAKA,AAAO,cAA+C;EACpD,OAAO,KAAK,IAAI,UAAU;CAC5B;;;;;;;CAQA,AAAO,UACL,QACA,SACM;EACN,KAAK,OAAO;GACV;GACA,QAAQ,SAAS;GACjB,UAAU,SAAS;EACrB,CAAC;CACH;;;;;;;;;CAUA,AAAO,UAAU,QAAsB;EACrC,KAAK,OAAO,EAAE,OAAO,CAAC;CACxB;;;;CAKA,AAAO,cAAoB;EACzB,KAAK,OAAO,EAAE,QAAQ,OAAU,CAAC;CACnC;;;;CAKA,AAAO,aAAwC;EAC7C,OAAO;GACL,QAAQ;GACR,QAAQ;GACR,UAAU;EACZ;CACF;AACF;AAEA,MAAa,uBAAuB,IAAI,qBAAqB;AAE7D,eAAe,SAAS,WAAW,oBAAoB"}
+{"version":3,"file":"storage-driver-context.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/storage/context/storage-driver-context.ts"],"sourcesContent":["import { Context, contextManager } from \"@warlock.js/context\";\nimport type { StorageDriverContract } from \"../types\";\n\nexport type StorageDriverContextStore = {\n  driver?: StorageDriverContract;\n  prefix?: string;\n  metadata?: Record<string, any>;\n};\n\n/**\n * Storage Driver Context\n *\n * Manages the active storage driver and path prefix using AsyncLocalStorage.\n * Allows multi-tenant applications to switch drivers and isolate storage paths per request context.\n *\n * @example\n * ```typescript\n * // Set driver with tenant-specific prefix\n * storageDriverContext.setDriver(storage.getDriver(\"s3\"), {\n *   prefix: \"tenant-123\",\n *   metadata: { tenantId: \"123\" }\n * });\n *\n * // Or just set prefix for same driver\n * storageDriverContext.setPrefix(\"tenant-456\");\n * ```\n */\nclass StorageDriverContext extends Context<StorageDriverContextStore> {\n  /**\n   * Get the current storage driver\n   */\n  public getDriver(): StorageDriverContract | undefined {\n    return this.get(\"driver\");\n  }\n\n  /**\n   * Get the current path prefix (e.g., tenant-specific path)\n   */\n  public getPrefix(): string | undefined {\n    return this.get(\"prefix\");\n  }\n\n  /**\n   * Get context metadata (e.g., tenantId)\n   */\n  public getMetadata(): Record<string, any> | undefined {\n    return this.get(\"metadata\");\n  }\n\n  /**\n   * Set the active driver with optional prefix and metadata\n   *\n   * @param driver - Storage driver to use\n   * @param options - Optional prefix and metadata\n   */\n  public setDriver(\n    driver: StorageDriverContract,\n    options?: { prefix?: string; metadata?: Record<string, any> },\n  ): void {\n    this.update({\n      driver,\n      prefix: options?.prefix,\n      metadata: options?.metadata,\n    });\n  }\n\n  /**\n   * Set only the path prefix (keeps current driver)\n   *\n   * Useful for multi-tenant scenarios where you want to isolate\n   * storage paths without changing the driver.\n   *\n   * @param prefix - Path prefix to prepend to all operations\n   */\n  public setPrefix(prefix: string): void {\n    this.update({ prefix });\n  }\n\n  /**\n   * Clear the prefix\n   */\n  public clearPrefix(): void {\n    this.update({ prefix: undefined });\n  }\n\n  /**\n   * Build the initial storage store with defaults\n   */\n  public buildStore(): StorageDriverContextStore {\n    return {\n      driver: undefined,\n      prefix: undefined,\n      metadata: undefined,\n    };\n  }\n}\n\nexport const storageDriverContext = new StorageDriverContext();\n\ncontextManager.register(\"storage\", storageDriverContext);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,IAAM,uBAAN,cAAmC,QAAmC;;;;CAIpE,AAAO,YAA+C;EACpD,OAAO,KAAK,IAAI,QAAQ;CAC1B;;;;CAKA,AAAO,YAAgC;EACrC,OAAO,KAAK,IAAI,QAAQ;CAC1B;;;;CAKA,AAAO,cAA+C;EACpD,OAAO,KAAK,IAAI,UAAU;CAC5B;;;;;;;CAQA,AAAO,UACL,QACA,SACM;EACN,KAAK,OAAO;GACV;GACA,QAAQ,SAAS;GACjB,UAAU,SAAS;EACrB,CAAC;CACH;;;;;;;;;CAUA,AAAO,UAAU,QAAsB;EACrC,KAAK,OAAO,EAAE,OAAO,CAAC;CACxB;;;;CAKA,AAAO,cAAoB;EACzB,KAAK,OAAO,EAAE,QAAQ,OAAU,CAAC;CACnC;;;;CAKA,AAAO,aAAwC;EAC7C,OAAO;GACL,QAAQ;GACR,QAAQ;GACR,UAAU;EACZ;CACF;AACF;AAEA,MAAa,uBAAuB,IAAI,qBAAqB;AAE7D,eAAe,SAAS,WAAW,oBAAoB"}

package/esm/storage/drivers/cloud-driver.d.mts

@@ -1,7 +1,7 @@
 import { CloudStorageDriverContract, CloudStorageDriverOptions, CloudStorageFileData, DeleteManyResult, FileVisibility, ListOptions, PresignedOptions, PresignedUploadOptions, PutOptions, StorageDriverType, StorageFileInfo } from "../types.mjs";
 import { Readable } from "stream";
 
-//#region ../../@warlock.js/core/src/storage/drivers/cloud-driver.d.ts
+//#region ../@warlock.js/core/src/storage/drivers/cloud-driver.d.ts
 /**
  * Load S3 modules lazily
  *

package/esm/storage/drivers/cloud-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-driver.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/drivers/cloud-driver.ts"],"mappings":";;;;;;AA4DA;;;;AAAuC;AAoDvC;;iBApDsB,MAAA,CAAA,GAAU,OAAO;;;;;;;;;;;;;;;;;uBAoDjB,WAAA,kBACH,OAAA,CAAQ,yBAAA,IAA6B,yBAAA,aAC3C,0BAAA;EAgBe,OAAA,EAAS,QAAA;EA0OhC;;;EAAA,UAtPO,MAAA,EAAS,YAAA,qCAAiD,QAAA;EA6T1B;;;EAAA,UAxThC,WAAA;IACR,UAAA;IACA,cAAA;IACA,UAAA;IACA,iBAAA;EAAA;cAGwB,OAAA,EAAS,QAAA;EAwfhC;;;EAAA,kBA9dsB,IAAA,EAAM,iBAAA;EAqiBsB;;;;EAAA,SA/hBrC,GAAA,CAAI,QAAA;EAilBiD;;;;EAAA,UA3kB3D,WAAA,CAAA;EA2rB4C;;;;;;;;;EA1qB/C,WAAA,CAAY,QAAA;EAvER;;;;EAAA,UA+FD,aAAA,CAAc,IAAA;EA3F4C;;;;;;;;;;EAAA,UA4GpD,SAAA,GAAA,CACd,SAAA,QAAiB,OAAA,CAAQ,CAAA,GACzB,aAAA,YACC,OAAA,CAAQ,CAAA;EAnEK;;;;;;;;;;;;;;;;;;EAAA,UAqHN,gBAAA,CAAiB,KAAA;EAoCzB;;;EADW,GAAA,CACX,IAAA,EAAM,MAAA,EACN,QAAA,UACA,OAAA,GAAU,UAAA,GACT,OAAA,CAAQ,oBAAA;EAAR;;;;EA0CU,SAAA,CACX,MAAA,EAAQ,QAAA,EACR,QAAA,UACA,OAAA,GAAU,UAAA,GACT,OAAA,CAAQ,oBAAA;EAFT;;;EAgDW,GAAA,CAAI,QAAA,WAAmB,OAAA,CAAQ,MAAA;EA9CjC;;;EAuEE,SAAA,CAAU,QAAA,WAAmB,OAAA,CAAQ,QAAA;EAzBN;;;EAkD/B,MAAA,CAAO,QAAA,WAAmB,OAAA;EAzBW;;;EA8CrC,UAAA,CAAW,SAAA,aAAsB,OAAA,CAAQ,gBAAA;EAAzC;;;;;;;;;EAqDA,eAAA,CAAgB,aAAA,WAAwB,OAAA;EAoExC;;;EA3BA,MAAA,CAAO,QAAA,WAAmB,OAAA;EAkC1B;;;EAPA,YAAA,CAAa,QAAA,UAAkB,SAAA,YAAmB,OAAA;EAOa;;;EAA/D,eAAA,CAAgB,QAAA,UAAkB,OAAA,GAAU,gBAAA,GAAmB,OAAA;EAwB1E;;;EAFW,qBAAA,CACX,QAAA,UACA,OAAA,GAAU,sBAAA,GACT,OAAA;EA4BsC;;;EAA5B,QAAA,CAAS,QAAA,WAAmB,OAAA,CAAQ,eAAA;EA+BZ;;;EAAxB,IAAA,CAAK,QAAA,WAAmB,OAAA;EAYQ;;;EAAhC,IAAA,CAAK,IAAA,UAAc,EAAA,WAAa,OAAA,CAAQ,oBAAA;EAyCrB;;;EAAnB,IAAA,CAAK,IAAA,UAAc,EAAA,WAAa,OAAA,CAAQ,oBAAA;EASnC;;;EAAL,IAAA,CAAK,SAAA,UAAmB,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,eAAA;EAAA;;;EAwD9D,SAAA,CAAA;EAcsB;;;EAPtB,SAAA,CAAA;EA6BoB;;;EAtBd,eAAA,CAAgB,QAAA,UAAkB,YAAA,WAAuB,OAAA;EA0CzD;;;EApBA,aAAA,CAAc,QAAA,UAAkB,UAAA,EAAY,cAAA,GAAiB,OAAA;EAoDhE;;;EAhCG,aAAA,CAAc,QAAA,WAAmB,OAAA,CAAQ,cAAA;EAuC9B;;AAAgB;EAAhB,UAPd,aAAA,CAAc,MAAA,EAAQ,MAAA;;;;YAOtB,aAAA,CAAc,QAAA;AAAA"}
+{"version":3,"file":"cloud-driver.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/core/src/storage/drivers/cloud-driver.ts"],"mappings":";;;;;;AA4DA;;;;AAAuC;AAoDvC;;iBApDsB,MAAA,IAAU,OAAO;;;;;;;;;;;;;;;;;uBAoDjB,WAAA,kBACH,OAAA,CAAQ,yBAAA,IAA6B,yBAAA,aAC3C,0BAAA;EAgBe,OAAA,EAAS,QAAA;EA0OhC;;;EAAA,UAtPO,MAAA,EAAS,YAAA,qCAAiD,QAAA;EA6T1B;;;EAAA,UAxThC,WAAA;IACR,UAAA;IACA,cAAA;IACA,UAAA;IACA,iBAAA;EAAA;cAGwB,OAAA,EAAS,QAAA;EAwfhC;;;EAAA,kBA9dsB,IAAA,EAAM,iBAAA;EAqiBsB;;;;EAAA,SA/hBrC,GAAA,CAAI,QAAA;EAilBiD;;;;EAAA,UA3kB3D,WAAA;EA2rB4C;;;;;;;;;EA1qB/C,WAAA,CAAY,QAAA;EAvER;;;;EAAA,UA+FD,aAAA,CAAc,IAAA;EA3F4C;;;;;;;;;;EAAA,UA4GpD,SAAA,IACd,SAAA,QAAiB,OAAA,CAAQ,CAAA,GACzB,aAAA,YACC,OAAA,CAAQ,CAAA;EAnEK;;;;;;;;;;;;;;;;;;EAAA,UAqHN,gBAAA,CAAiB,KAAA;EAoCzB;;;EADW,GAAA,CACX,IAAA,EAAM,MAAA,EACN,QAAA,UACA,OAAA,GAAU,UAAA,GACT,OAAA,CAAQ,oBAAA;EAAR;;;;EA0CU,SAAA,CACX,MAAA,EAAQ,QAAA,EACR,QAAA,UACA,OAAA,GAAU,UAAA,GACT,OAAA,CAAQ,oBAAA;EAFT;;;EAgDW,GAAA,CAAI,QAAA,WAAmB,OAAA,CAAQ,MAAA;EA9CjC;;;EAuEE,SAAA,CAAU,QAAA,WAAmB,OAAA,CAAQ,QAAA;EAzBN;;;EAkD/B,MAAA,CAAO,QAAA,WAAmB,OAAA;EAzBW;;;EA8CrC,UAAA,CAAW,SAAA,aAAsB,OAAA,CAAQ,gBAAA;EAAzC;;;;;;;;;EAqDA,eAAA,CAAgB,aAAA,WAAwB,OAAA;EAoExC;;;EA3BA,MAAA,CAAO,QAAA,WAAmB,OAAA;EAkC1B;;;EAPA,YAAA,CAAa,QAAA,UAAkB,SAAA,YAAmB,OAAA;EAOa;;;EAA/D,eAAA,CAAgB,QAAA,UAAkB,OAAA,GAAU,gBAAA,GAAmB,OAAA;EAwB1E;;;EAFW,qBAAA,CACX,QAAA,UACA,OAAA,GAAU,sBAAA,GACT,OAAA;EA4BsC;;;EAA5B,QAAA,CAAS,QAAA,WAAmB,OAAA,CAAQ,eAAA;EA+BZ;;;EAAxB,IAAA,CAAK,QAAA,WAAmB,OAAA;EAYQ;;;EAAhC,IAAA,CAAK,IAAA,UAAc,EAAA,WAAa,OAAA,CAAQ,oBAAA;EAyCrB;;;EAAnB,IAAA,CAAK,IAAA,UAAc,EAAA,WAAa,OAAA,CAAQ,oBAAA;EASnC;;;EAAL,IAAA,CAAK,SAAA,UAAmB,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,eAAA;EAAA;;;EAwD9D,SAAA;EAcsB;;;EAPtB,SAAA;EA6BoB;;;EAtBd,eAAA,CAAgB,QAAA,UAAkB,YAAA,WAAuB,OAAA;EA0CzD;;;EApBA,aAAA,CAAc,QAAA,UAAkB,UAAA,EAAY,cAAA,GAAiB,OAAA;EAoDhE;;;EAhCG,aAAA,CAAc,QAAA,WAAmB,OAAA,CAAQ,cAAA;EAuC9B;;AAAgB;EAAhB,UAPd,aAAA,CAAc,MAAA,EAAQ,MAAA;;;;YAOtB,aAAA,CAAc,QAAA;AAAA"}

package/esm/storage/drivers/cloud-driver.mjs

@@ -2,7 +2,7 @@ import { storageDriverContext } from "../context/storage-driver-context.mjs";
 import { getMimeType } from "../utils/mime.mjs";
 import crypto from "crypto";
 
-//#region ../../@warlock.js/core/src/storage/drivers/cloud-driver.ts
+//#region ../@warlock.js/core/src/storage/drivers/cloud-driver.ts
 /**
 * Cached S3 SDK modules (loaded once, reused)
 */

package/esm/storage/drivers/cloud-driver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-driver.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/drivers/cloud-driver.ts"],"sourcesContent":["import crypto from \"crypto\";\nimport type { Readable } from \"stream\";\nimport { storageDriverContext } from \"../context/storage-driver-context\";\nimport type {\n  CloudStorageDriverContract,\n  CloudStorageDriverOptions,\n  CloudStorageFileData,\n  DeleteManyResult,\n  FileVisibility,\n  ListOptions,\n  PresignedOptions,\n  PresignedUploadOptions,\n  PutOptions,\n  StorageDriverType,\n  StorageFileInfo,\n} from \"../types\";\nimport { getMimeType } from \"../utils/mime\";\n\n// ============================================================\n// Lazy-loaded S3 SDK Types\n// ============================================================\n\n/**\n * Cached S3 SDK modules (loaded once, reused)\n */\nlet S3Client: typeof import(\"@aws-sdk/client-s3\");\nlet S3Storage: typeof import(\"@aws-sdk/lib-storage\");\nlet S3Presigner: typeof import(\"@aws-sdk/s3-request-presigner\");\n\nlet isModuleExists: boolean | null = null;\n\n/**\n * Installation instructions for S3 SDK packages\n */\nconst S3_INSTALL_INSTRUCTIONS = `\nCloud storage requires the AWS S3 SDK packages.\nInstall them with:\n\n  npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n\nOr with your preferred package manager:\n\n  pnpm add @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n  yarn add @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n`.trim();\n\n/**\n * Atomic initialization promise to handle concurrent calls to loadS3\n */\nlet initializationPromise: Promise<void> | null = null;\n\n/**\n * Load S3 modules lazily\n *\n * @example\n * await loadS3();\n * if (isModuleExists) {\n *   // Safe to use S3Client, S3Storage, S3Presigner\n * }\n */\nexport async function loadS3(): Promise<void> {\n  // If already successfully loaded, no need to do anything\n  if (isModuleExists === true) return;\n\n  // If currently loading, return the existing promise so the caller waits\n  if (initializationPromise) return initializationPromise;\n\n  initializationPromise = (async () => {\n    try {\n      // Use Promise.all to load modules in parallel for efficiency\n      const [client, storage, presigner] = await Promise.all([\n        import(\"@aws-sdk/client-s3\"),\n        import(\"@aws-sdk/lib-storage\"),\n        import(\"@aws-sdk/s3-request-presigner\"),\n      ]);\n\n      S3Client = client;\n      S3Storage = storage;\n      S3Presigner = presigner;\n\n      isModuleExists = true;\n    } catch {\n      // Mark as failed if any import fails (usually means packages aren't installed)\n      isModuleExists = false;\n    }\n  })();\n\n  return initializationPromise;\n}\n\nloadS3();\n\n// ============================================================\n// CloudDriver Base Class\n// ============================================================\n\n/**\n * Base abstract class for all S3-compatible cloud storage drivers\n *\n * This class contains all shared logic for S3-compatible storage services\n * including AWS S3, Cloudflare R2, DigitalOcean Spaces, and others.\n *\n * **Important:** S3 SDK packages are lazy-loaded on first use.\n * Users must install them separately:\n * ```\n * npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n * ```\n *\n * Subclasses must implement:\n * - `name`: Driver identifier (e.g., \"s3\", \"r2\", \"spaces\")\n * - `url()`: Returns the public URL for a file (provider-specific format)\n */\nexport abstract class CloudDriver<\n  TOptions extends Partial<CloudStorageDriverOptions> = CloudStorageDriverOptions,\n> implements CloudStorageDriverContract {\n  /**\n   * S3-compatible client (lazy-loaded)\n   */\n  protected client!: InstanceType<typeof import(\"@aws-sdk/client-s3\").S3Client>;\n\n  /**\n   * Retry configuration\n   */\n  protected retryConfig: {\n    maxRetries: number;\n    initialDelayMs: number;\n    maxDelayMs: number;\n    backoffMultiplier: number;\n  };\n\n  public constructor(public options: TOptions) {\n    if (!isModuleExists) {\n      throw new Error(S3_INSTALL_INSTRUCTIONS);\n    }\n\n    this.client = new S3Client.S3Client({\n      region: this.options.region!,\n      credentials: {\n        accessKeyId: this.options.accessKeyId!,\n        secretAccessKey: this.options.secretAccessKey!,\n      },\n      ...(this.getEndpoint() && { endpoint: this.getEndpoint() }),\n    });\n\n    // Initialize retry configuration\n    this.retryConfig = {\n      maxRetries: this.options.retry?.maxRetries ?? 3,\n      initialDelayMs: this.options.retry?.initialDelayMs ?? 1000,\n      maxDelayMs: this.options.retry?.maxDelayMs ?? 10000,\n      backoffMultiplier: this.options.retry?.backoffMultiplier ?? 2,\n    };\n  }\n\n  /**\n   * Driver name identifier\n   */\n  public abstract readonly name: StorageDriverType;\n\n  /**\n   * Get public URL for file\n   * Must be implemented by subclasses with provider-specific format\n   */\n  public abstract url(location: string): string;\n\n  /**\n   * Get endpoint URL\n   * Can be overridden by subclasses for provider-specific endpoints\n   */\n  protected getEndpoint(): string | undefined {\n    return this.options.endpoint;\n  }\n\n  // ============================================================\n  // Helper Methods\n  // ============================================================\n\n  /**\n   * Apply prefix to location path\n   *\n   * Priority: context prefix > driver options prefix > no prefix\n   * This allows multi-tenant scenarios where context overrides driver config.\n   *\n   * @param location - Original location path\n   * @returns Location with prefix applied if one exists\n   */\n  public applyPrefix(location: string): string {\n    // Check context prefix first (highest priority)\n    const contextPrefix = storageDriverContext.getPrefix();\n    const prefix = contextPrefix || this.options.prefix;\n\n    if (!prefix) {\n      return location;\n    }\n\n    const cleanPrefix = prefix.replace(/\\/+$/, \"\");\n    const cleanLocation = location.replace(/^\\/+/, \"\");\n\n    // Avoid double-prefixing\n    if (cleanLocation.startsWith(cleanPrefix + \"/\") || cleanLocation === cleanPrefix) {\n      return cleanLocation;\n    }\n\n    return `${cleanPrefix}/${cleanLocation}`;\n  }\n\n  /**\n   * Normalize storage path (remove double slashes, sanitize)\n   * @internal\n   */\n  protected normalizePath(path: string): string {\n    return path\n      .replace(/\\/+/g, \"/\") // Remove multiple slashes\n      .replace(/^\\//, \"\") // Remove leading slash\n      .trim();\n  }\n\n  /**\n   * Execute an operation with retry logic\n   *\n   * Retries on transient errors with exponential backoff.\n   *\n   * @param operation - Async operation to execute\n   * @param operationName - Name for logging\n   * @returns Result of the operation\n   * @internal\n   */\n  protected async withRetry<T>(\n    operation: () => Promise<T>,\n    operationName: string = \"operation\",\n  ): Promise<T> {\n    const { maxRetries, initialDelayMs, backoffMultiplier, maxDelayMs } = this.retryConfig;\n\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      try {\n        return await operation();\n      } catch (error) {\n        lastError = error as Error;\n\n        // Don't retry on the last attempt\n        if (attempt === maxRetries - 1) {\n          break;\n        }\n\n        // Check if error is retryable\n        if (!this.isRetryableError(error)) {\n          throw error; // Non-retryable error, fail immediately\n        }\n\n        // Calculate delay with exponential backoff\n        const delayMs = Math.min(initialDelayMs * Math.pow(backoffMultiplier, attempt), maxDelayMs);\n\n        // Wait before retrying\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n    }\n\n    throw new Error(`${operationName} failed after ${maxRetries} attempts: ${lastError?.message}`);\n  }\n\n  /**\n   * Check if an error is retryable\n   *\n   * Retries on:\n   * - Network errors\n   * - 5xx server errors\n   * - Rate limiting (429)\n   * - Timeout errors\n   *\n   * Does NOT retry on:\n   * - 4xx client errors (except 429)\n   * - Authentication errors\n   * - Not found errors\n   *\n   * @param error - Error to check\n   * @returns true if error is retryable\n   * @internal\n   */\n  protected isRetryableError(error: any): boolean {\n    // Network errors\n    if (error.code === \"ECONNRESET\" || error.code === \"ETIMEDOUT\" || error.code === \"ENOTFOUND\") {\n      return true;\n    }\n\n    // S3 SDK errors\n    if (error.name === \"NetworkingError\" || error.name === \"TimeoutError\") {\n      return true;\n    }\n\n    // HTTP status codes\n    const statusCode = error.$metadata?.httpStatusCode || error.statusCode;\n    if (statusCode) {\n      // 5xx server errors are retryable\n      if (statusCode >= 500 && statusCode < 600) {\n        return true;\n      }\n\n      // 429 Too Many Requests is retryable\n      if (statusCode === 429) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  // ============================================================\n  // Core File Operations\n  // ============================================================\n\n  /**\n   * Put file to cloud storage\n   */\n  public async put(\n    file: Buffer,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const hash = this.calculateHash(file);\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        Body: file,\n        ContentType: mimeType,\n        CacheControl: options?.cacheControl,\n        ContentDisposition: options?.contentDisposition,\n        Metadata: options?.metadata,\n        ACL: options?.visibility === \"public\" ? \"public-read\" : undefined,\n      });\n\n      const result = await this.client.send(command);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: file.length,\n        hash,\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"put\");\n  }\n\n  /**\n   * Put file from a readable stream (for large files)\n   * Uses S3 multipart upload for efficient streaming\n   */\n  public async putStream(\n    stream: Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { Upload } = S3Storage;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const upload = new Upload({\n        client: this.client,\n        params: {\n          Bucket: this.options.bucket,\n          Key: location,\n          Body: stream,\n          ContentType: mimeType,\n          CacheControl: options?.cacheControl,\n          ContentDisposition: options?.contentDisposition,\n          Metadata: options?.metadata,\n          ACL: options?.visibility === \"public\" ? \"public-read\" : undefined,\n        },\n      });\n\n      const result = await upload.done();\n\n      // Get file info for size and hash\n      const info = await this.metadata(location);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: info.size,\n        hash: info.etag?.replace(/\"/g, \"\") || \"\",\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"putStream\");\n  }\n\n  /**\n   * Get file contents as Buffer\n   */\n  public async get(location: string): Promise<Buffer> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return Buffer.from(await result.Body.transformToByteArray());\n    }, \"get\");\n  }\n\n  /**\n   * Get file as a readable stream (for large files)\n   */\n  public async getStream(location: string): Promise<Readable> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return result.Body as Readable;\n    }, \"getStream\");\n  }\n\n  /**\n   * Delete a file\n   */\n  public async delete(location: string): Promise<boolean> {\n    return this.withRetry(async () => {\n      const { DeleteObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new DeleteObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n\n      return true;\n    }, \"delete\");\n  }\n\n  /**\n   * Delete multiple files at once (uses batch delete for efficiency)\n   */\n  public async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    if (locations.length === 0) {\n      return [];\n    }\n\n    return this.withRetry(async () => {\n      const { DeleteObjectsCommand } = S3Client;\n\n      // Apply storage prefix to all locations\n      const prefixedLocations = locations.map((loc) => this.applyPrefix(loc));\n\n      const command = new DeleteObjectsCommand({\n        Bucket: this.options.bucket,\n        Delete: {\n          Objects: prefixedLocations.map((Key) => ({ Key })),\n          Quiet: false,\n        },\n      });\n\n      const result = await this.client.send(command);\n      const results: DeleteManyResult[] = [];\n\n      // Process successful deletes\n      for (const deleted of result.Deleted || []) {\n        if (deleted.Key) {\n          results.push({ location: deleted.Key, deleted: true });\n        }\n      }\n\n      // Process errors\n      for (const error of result.Errors || []) {\n        if (error.Key) {\n          results.push({\n            location: error.Key,\n            deleted: false,\n            error: error.Message || \"Unknown error\",\n          });\n        }\n      }\n\n      return results;\n    }, \"deleteMany\");\n  }\n\n  /**\n   * Delete directory (recursively deletes all objects with matching prefix)\n   *\n   * S3/R2 doesn't have true directories - only key prefixes.\n   * This method lists all objects with the prefix and deletes them in batches.\n   *\n   * @param directoryPath - Directory prefix to delete\n   * @returns true when all objects are deleted\n   */\n  public async deleteDirectory(directoryPath: string): Promise<boolean> {\n    // Apply storage prefix\n    directoryPath = this.applyPrefix(directoryPath);\n\n    // Ensure directory path ends with / for proper prefix matching\n    const prefix = directoryPath.endsWith(\"/\") ? directoryPath : `${directoryPath}/`;\n\n    let hasMore = true;\n\n    while (hasMore) {\n      // List up to 1000 objects (S3/R2 max per request)\n      const objects = await this.list(prefix, {\n        limit: 1000,\n        recursive: true,\n      });\n\n      if (objects.length === 0) {\n        break;\n      }\n\n      // Filter out directories (we only delete files)\n      const filePaths = objects.filter((obj) => !obj.isDirectory).map((obj) => obj.path);\n\n      if (filePaths.length === 0) {\n        break;\n      }\n\n      // Delete batch (deleteMany already has prefix applied, so paths already have it)\n      // Note: We pass the paths as-is since they already include the prefix from list()\n      const results = await this.deleteMany(filePaths);\n\n      // Continue if we got full batch (might be more)\n      hasMore = objects.length >= 1000;\n    }\n\n    return true;\n  }\n\n  /**\n   * Check if file exists\n   */\n  public async exists(location: string): Promise<boolean> {\n    // No retry for exists - it should be fast and failure means non-existent\n    try {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // ============================================================\n  // URL Operations\n  // ============================================================\n\n  /**\n   * Get a temporary presigned URL (alias for getPresignedUrl)\n   */\n  public async temporaryUrl(location: string, expiresIn = 3600): Promise<string> {\n    return this.getPresignedUrl(location, { expiresIn });\n  }\n\n  /**\n   * Get presigned URL for downloading\n   */\n  public async getPresignedUrl(location: string, options?: PresignedOptions): Promise<string> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUrl\");\n  }\n\n  /**\n   * Get presigned URL for uploading\n   */\n  public async getPresignedUploadUrl(\n    location: string,\n    options?: PresignedUploadOptions,\n  ): Promise<string> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ContentType: options?.contentType,\n        Metadata: options?.metadata,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUploadUrl\");\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file info/metadata without downloading\n   */\n  public async metadata(location: string): Promise<StorageFileInfo> {\n    return this.withRetry(async () => {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n      const name = location.split(\"/\").pop() || \"\";\n\n      return {\n        path: location,\n        name,\n        size: result.ContentLength || 0,\n        isDirectory: false,\n        lastModified: result.LastModified,\n        mimeType: result.ContentType || this.guessMimeType(location),\n        etag: result.ETag,\n        storageClass: result.StorageClass,\n      };\n    }, \"metadata\");\n  }\n\n  /**\n   * Get file size in bytes (shortcut for metadata().size)\n   */\n  public async size(location: string): Promise<number> {\n    const info = await this.metadata(location);\n    return info.size;\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Copy file to a new location\n   */\n  public async copy(from: string, to: string): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand, HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix to both paths\n      from = this.applyPrefix(from);\n      to = this.applyPrefix(to);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: `${this.options.bucket}/${from}`,\n        Key: to,\n      });\n\n      const result = await this.client.send(command);\n\n      // Get file metadata\n      const headCommand = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: to,\n      });\n      const headResult = await this.client.send(headCommand);\n\n      return {\n        path: to,\n        url: this.url(to),\n        size: headResult.ContentLength || 0,\n        hash: headResult.ETag?.replace(/\"/g, \"\") || \"\",\n        mimeType: headResult.ContentType || this.guessMimeType(to),\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.CopyObjectResult?.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"copy\");\n  }\n\n  /**\n   * Move file to a new location\n   */\n  public async move(from: string, to: string): Promise<CloudStorageFileData> {\n    const file = await this.copy(from, to);\n    await this.delete(from);\n    return file;\n  }\n\n  /**\n   * List files in a directory\n   */\n  public async list(directory: string, options?: ListOptions): Promise<StorageFileInfo[]> {\n    return this.withRetry(async () => {\n      const { ListObjectsV2Command } = S3Client;\n\n      // Apply storage prefix\n      directory = this.applyPrefix(directory);\n\n      const command = new ListObjectsV2Command({\n        Bucket: this.options.bucket,\n        Prefix: directory,\n        MaxKeys: options?.limit,\n        ContinuationToken: options?.cursor,\n        Delimiter: options?.recursive ? undefined : \"/\",\n      });\n\n      const result = await this.client.send(command);\n      const files: StorageFileInfo[] = [];\n\n      // Add files\n      for (const object of result.Contents || []) {\n        if (!object.Key) continue;\n\n        files.push({\n          path: object.Key,\n          name: object.Key.split(\"/\").pop() || \"\",\n          size: object.Size || 0,\n          isDirectory: false,\n          lastModified: object.LastModified,\n          etag: object.ETag,\n          storageClass: object.StorageClass,\n        });\n      }\n\n      // Add directories\n      for (const prefix of result.CommonPrefixes || []) {\n        if (!prefix.Prefix) continue;\n\n        files.push({\n          path: prefix.Prefix,\n          name: prefix.Prefix.split(\"/\").filter(Boolean).pop() || \"\",\n          size: 0,\n          isDirectory: true,\n        });\n      }\n\n      return files;\n    }, \"list\");\n  }\n\n  // ============================================================\n  // Cloud-Specific Operations\n  // ============================================================\n\n  /**\n   * Get bucket name\n   */\n  public getBucket(): string {\n    return this.options.bucket!;\n  }\n\n  /**\n   * Get region\n   */\n  public getRegion(): string {\n    return this.options.region!;\n  }\n\n  /**\n   * Set storage class (e.g., STANDARD, GLACIER, etc.)\n   */\n  public async setStorageClass(location: string, storageClass: string): Promise<void> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: `${this.options.bucket}/${location}`,\n        Key: location,\n        StorageClass: storageClass as any,\n        MetadataDirective: \"COPY\",\n      });\n\n      await this.client.send(command);\n    }, \"setStorageClass\");\n  }\n\n  /**\n   * Set file visibility (public or private)\n   */\n  public async setVisibility(location: string, visibility: FileVisibility): Promise<void> {\n    return this.withRetry(async () => {\n      const { PutObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ACL: visibility === \"public\" ? \"public-read\" : \"private\",\n      });\n\n      await this.client.send(command);\n    }, \"setVisibility\");\n  }\n\n  /**\n   * Get file visibility\n   */\n  public async getVisibility(location: string): Promise<FileVisibility> {\n    return this.withRetry(async () => {\n      const { GetObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      // Check if any grant allows public read\n      const hasPublicRead = result.Grants?.some(\n        (grant) =>\n          grant.Grantee?.URI === \"http://acs.amazonaws.com/groups/global/AllUsers\" &&\n          grant.Permission === \"READ\",\n      );\n\n      return hasPublicRead ? \"public\" : \"private\";\n    }, \"getVisibility\");\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Calculate SHA-256 hash\n   */\n  protected calculateHash(buffer: Buffer): string {\n    return crypto.createHash(\"sha256\").update(new Uint8Array(buffer)).digest(\"hex\");\n  }\n\n  /**\n   * Guess MIME type from file extension\n   */\n  protected guessMimeType(location: string): string {\n    return getMimeType(location);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cloud-driver.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/storage/drivers/cloud-driver.ts"],"sourcesContent":["import crypto from \"crypto\";\nimport type { Readable } from \"stream\";\nimport { storageDriverContext } from \"../context/storage-driver-context\";\nimport type {\n  CloudStorageDriverContract,\n  CloudStorageDriverOptions,\n  CloudStorageFileData,\n  DeleteManyResult,\n  FileVisibility,\n  ListOptions,\n  PresignedOptions,\n  PresignedUploadOptions,\n  PutOptions,\n  StorageDriverType,\n  StorageFileInfo,\n} from \"../types\";\nimport { getMimeType } from \"../utils/mime\";\n\n// ============================================================\n// Lazy-loaded S3 SDK Types\n// ============================================================\n\n/**\n * Cached S3 SDK modules (loaded once, reused)\n */\nlet S3Client: typeof import(\"@aws-sdk/client-s3\");\nlet S3Storage: typeof import(\"@aws-sdk/lib-storage\");\nlet S3Presigner: typeof import(\"@aws-sdk/s3-request-presigner\");\n\nlet isModuleExists: boolean | null = null;\n\n/**\n * Installation instructions for S3 SDK packages\n */\nconst S3_INSTALL_INSTRUCTIONS = `\nCloud storage requires the AWS S3 SDK packages.\nInstall them with:\n\n  npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n\nOr with your preferred package manager:\n\n  pnpm add @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n  yarn add @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n`.trim();\n\n/**\n * Atomic initialization promise to handle concurrent calls to loadS3\n */\nlet initializationPromise: Promise<void> | null = null;\n\n/**\n * Load S3 modules lazily\n *\n * @example\n * await loadS3();\n * if (isModuleExists) {\n *   // Safe to use S3Client, S3Storage, S3Presigner\n * }\n */\nexport async function loadS3(): Promise<void> {\n  // If already successfully loaded, no need to do anything\n  if (isModuleExists === true) return;\n\n  // If currently loading, return the existing promise so the caller waits\n  if (initializationPromise) return initializationPromise;\n\n  initializationPromise = (async () => {\n    try {\n      // Use Promise.all to load modules in parallel for efficiency\n      const [client, storage, presigner] = await Promise.all([\n        import(\"@aws-sdk/client-s3\"),\n        import(\"@aws-sdk/lib-storage\"),\n        import(\"@aws-sdk/s3-request-presigner\"),\n      ]);\n\n      S3Client = client;\n      S3Storage = storage;\n      S3Presigner = presigner;\n\n      isModuleExists = true;\n    } catch {\n      // Mark as failed if any import fails (usually means packages aren't installed)\n      isModuleExists = false;\n    }\n  })();\n\n  return initializationPromise;\n}\n\nloadS3();\n\n// ============================================================\n// CloudDriver Base Class\n// ============================================================\n\n/**\n * Base abstract class for all S3-compatible cloud storage drivers\n *\n * This class contains all shared logic for S3-compatible storage services\n * including AWS S3, Cloudflare R2, DigitalOcean Spaces, and others.\n *\n * **Important:** S3 SDK packages are lazy-loaded on first use.\n * Users must install them separately:\n * ```\n * npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n * ```\n *\n * Subclasses must implement:\n * - `name`: Driver identifier (e.g., \"s3\", \"r2\", \"spaces\")\n * - `url()`: Returns the public URL for a file (provider-specific format)\n */\nexport abstract class CloudDriver<\n  TOptions extends Partial<CloudStorageDriverOptions> = CloudStorageDriverOptions,\n> implements CloudStorageDriverContract {\n  /**\n   * S3-compatible client (lazy-loaded)\n   */\n  protected client!: InstanceType<typeof import(\"@aws-sdk/client-s3\").S3Client>;\n\n  /**\n   * Retry configuration\n   */\n  protected retryConfig: {\n    maxRetries: number;\n    initialDelayMs: number;\n    maxDelayMs: number;\n    backoffMultiplier: number;\n  };\n\n  public constructor(public options: TOptions) {\n    if (!isModuleExists) {\n      throw new Error(S3_INSTALL_INSTRUCTIONS);\n    }\n\n    this.client = new S3Client.S3Client({\n      region: this.options.region!,\n      credentials: {\n        accessKeyId: this.options.accessKeyId!,\n        secretAccessKey: this.options.secretAccessKey!,\n      },\n      ...(this.getEndpoint() && { endpoint: this.getEndpoint() }),\n    });\n\n    // Initialize retry configuration\n    this.retryConfig = {\n      maxRetries: this.options.retry?.maxRetries ?? 3,\n      initialDelayMs: this.options.retry?.initialDelayMs ?? 1000,\n      maxDelayMs: this.options.retry?.maxDelayMs ?? 10000,\n      backoffMultiplier: this.options.retry?.backoffMultiplier ?? 2,\n    };\n  }\n\n  /**\n   * Driver name identifier\n   */\n  public abstract readonly name: StorageDriverType;\n\n  /**\n   * Get public URL for file\n   * Must be implemented by subclasses with provider-specific format\n   */\n  public abstract url(location: string): string;\n\n  /**\n   * Get endpoint URL\n   * Can be overridden by subclasses for provider-specific endpoints\n   */\n  protected getEndpoint(): string | undefined {\n    return this.options.endpoint;\n  }\n\n  // ============================================================\n  // Helper Methods\n  // ============================================================\n\n  /**\n   * Apply prefix to location path\n   *\n   * Priority: context prefix > driver options prefix > no prefix\n   * This allows multi-tenant scenarios where context overrides driver config.\n   *\n   * @param location - Original location path\n   * @returns Location with prefix applied if one exists\n   */\n  public applyPrefix(location: string): string {\n    // Check context prefix first (highest priority)\n    const contextPrefix = storageDriverContext.getPrefix();\n    const prefix = contextPrefix || this.options.prefix;\n\n    if (!prefix) {\n      return location;\n    }\n\n    const cleanPrefix = prefix.replace(/\\/+$/, \"\");\n    const cleanLocation = location.replace(/^\\/+/, \"\");\n\n    // Avoid double-prefixing\n    if (cleanLocation.startsWith(cleanPrefix + \"/\") || cleanLocation === cleanPrefix) {\n      return cleanLocation;\n    }\n\n    return `${cleanPrefix}/${cleanLocation}`;\n  }\n\n  /**\n   * Normalize storage path (remove double slashes, sanitize)\n   * @internal\n   */\n  protected normalizePath(path: string): string {\n    return path\n      .replace(/\\/+/g, \"/\") // Remove multiple slashes\n      .replace(/^\\//, \"\") // Remove leading slash\n      .trim();\n  }\n\n  /**\n   * Execute an operation with retry logic\n   *\n   * Retries on transient errors with exponential backoff.\n   *\n   * @param operation - Async operation to execute\n   * @param operationName - Name for logging\n   * @returns Result of the operation\n   * @internal\n   */\n  protected async withRetry<T>(\n    operation: () => Promise<T>,\n    operationName: string = \"operation\",\n  ): Promise<T> {\n    const { maxRetries, initialDelayMs, backoffMultiplier, maxDelayMs } = this.retryConfig;\n\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      try {\n        return await operation();\n      } catch (error) {\n        lastError = error as Error;\n\n        // Don't retry on the last attempt\n        if (attempt === maxRetries - 1) {\n          break;\n        }\n\n        // Check if error is retryable\n        if (!this.isRetryableError(error)) {\n          throw error; // Non-retryable error, fail immediately\n        }\n\n        // Calculate delay with exponential backoff\n        const delayMs = Math.min(initialDelayMs * Math.pow(backoffMultiplier, attempt), maxDelayMs);\n\n        // Wait before retrying\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n    }\n\n    throw new Error(`${operationName} failed after ${maxRetries} attempts: ${lastError?.message}`);\n  }\n\n  /**\n   * Check if an error is retryable\n   *\n   * Retries on:\n   * - Network errors\n   * - 5xx server errors\n   * - Rate limiting (429)\n   * - Timeout errors\n   *\n   * Does NOT retry on:\n   * - 4xx client errors (except 429)\n   * - Authentication errors\n   * - Not found errors\n   *\n   * @param error - Error to check\n   * @returns true if error is retryable\n   * @internal\n   */\n  protected isRetryableError(error: any): boolean {\n    // Network errors\n    if (error.code === \"ECONNRESET\" || error.code === \"ETIMEDOUT\" || error.code === \"ENOTFOUND\") {\n      return true;\n    }\n\n    // S3 SDK errors\n    if (error.name === \"NetworkingError\" || error.name === \"TimeoutError\") {\n      return true;\n    }\n\n    // HTTP status codes\n    const statusCode = error.$metadata?.httpStatusCode || error.statusCode;\n    if (statusCode) {\n      // 5xx server errors are retryable\n      if (statusCode >= 500 && statusCode < 600) {\n        return true;\n      }\n\n      // 429 Too Many Requests is retryable\n      if (statusCode === 429) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  // ============================================================\n  // Core File Operations\n  // ============================================================\n\n  /**\n   * Put file to cloud storage\n   */\n  public async put(\n    file: Buffer,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const hash = this.calculateHash(file);\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        Body: file,\n        ContentType: mimeType,\n        CacheControl: options?.cacheControl,\n        ContentDisposition: options?.contentDisposition,\n        Metadata: options?.metadata,\n        ACL: options?.visibility === \"public\" ? \"public-read\" : undefined,\n      });\n\n      const result = await this.client.send(command);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: file.length,\n        hash,\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"put\");\n  }\n\n  /**\n   * Put file from a readable stream (for large files)\n   * Uses S3 multipart upload for efficient streaming\n   */\n  public async putStream(\n    stream: Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { Upload } = S3Storage;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const upload = new Upload({\n        client: this.client,\n        params: {\n          Bucket: this.options.bucket,\n          Key: location,\n          Body: stream,\n          ContentType: mimeType,\n          CacheControl: options?.cacheControl,\n          ContentDisposition: options?.contentDisposition,\n          Metadata: options?.metadata,\n          ACL: options?.visibility === \"public\" ? \"public-read\" : undefined,\n        },\n      });\n\n      const result = await upload.done();\n\n      // Get file info for size and hash\n      const info = await this.metadata(location);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: info.size,\n        hash: info.etag?.replace(/\"/g, \"\") || \"\",\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"putStream\");\n  }\n\n  /**\n   * Get file contents as Buffer\n   */\n  public async get(location: string): Promise<Buffer> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return Buffer.from(await result.Body.transformToByteArray());\n    }, \"get\");\n  }\n\n  /**\n   * Get file as a readable stream (for large files)\n   */\n  public async getStream(location: string): Promise<Readable> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return result.Body as Readable;\n    }, \"getStream\");\n  }\n\n  /**\n   * Delete a file\n   */\n  public async delete(location: string): Promise<boolean> {\n    return this.withRetry(async () => {\n      const { DeleteObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new DeleteObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n\n      return true;\n    }, \"delete\");\n  }\n\n  /**\n   * Delete multiple files at once (uses batch delete for efficiency)\n   */\n  public async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    if (locations.length === 0) {\n      return [];\n    }\n\n    return this.withRetry(async () => {\n      const { DeleteObjectsCommand } = S3Client;\n\n      // Apply storage prefix to all locations\n      const prefixedLocations = locations.map((loc) => this.applyPrefix(loc));\n\n      const command = new DeleteObjectsCommand({\n        Bucket: this.options.bucket,\n        Delete: {\n          Objects: prefixedLocations.map((Key) => ({ Key })),\n          Quiet: false,\n        },\n      });\n\n      const result = await this.client.send(command);\n      const results: DeleteManyResult[] = [];\n\n      // Process successful deletes\n      for (const deleted of result.Deleted || []) {\n        if (deleted.Key) {\n          results.push({ location: deleted.Key, deleted: true });\n        }\n      }\n\n      // Process errors\n      for (const error of result.Errors || []) {\n        if (error.Key) {\n          results.push({\n            location: error.Key,\n            deleted: false,\n            error: error.Message || \"Unknown error\",\n          });\n        }\n      }\n\n      return results;\n    }, \"deleteMany\");\n  }\n\n  /**\n   * Delete directory (recursively deletes all objects with matching prefix)\n   *\n   * S3/R2 doesn't have true directories - only key prefixes.\n   * This method lists all objects with the prefix and deletes them in batches.\n   *\n   * @param directoryPath - Directory prefix to delete\n   * @returns true when all objects are deleted\n   */\n  public async deleteDirectory(directoryPath: string): Promise<boolean> {\n    // Apply storage prefix\n    directoryPath = this.applyPrefix(directoryPath);\n\n    // Ensure directory path ends with / for proper prefix matching\n    const prefix = directoryPath.endsWith(\"/\") ? directoryPath : `${directoryPath}/`;\n\n    let hasMore = true;\n\n    while (hasMore) {\n      // List up to 1000 objects (S3/R2 max per request)\n      const objects = await this.list(prefix, {\n        limit: 1000,\n        recursive: true,\n      });\n\n      if (objects.length === 0) {\n        break;\n      }\n\n      // Filter out directories (we only delete files)\n      const filePaths = objects.filter((obj) => !obj.isDirectory).map((obj) => obj.path);\n\n      if (filePaths.length === 0) {\n        break;\n      }\n\n      // Delete batch (deleteMany already has prefix applied, so paths already have it)\n      // Note: We pass the paths as-is since they already include the prefix from list()\n      const results = await this.deleteMany(filePaths);\n\n      // Continue if we got full batch (might be more)\n      hasMore = objects.length >= 1000;\n    }\n\n    return true;\n  }\n\n  /**\n   * Check if file exists\n   */\n  public async exists(location: string): Promise<boolean> {\n    // No retry for exists - it should be fast and failure means non-existent\n    try {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // ============================================================\n  // URL Operations\n  // ============================================================\n\n  /**\n   * Get a temporary presigned URL (alias for getPresignedUrl)\n   */\n  public async temporaryUrl(location: string, expiresIn = 3600): Promise<string> {\n    return this.getPresignedUrl(location, { expiresIn });\n  }\n\n  /**\n   * Get presigned URL for downloading\n   */\n  public async getPresignedUrl(location: string, options?: PresignedOptions): Promise<string> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUrl\");\n  }\n\n  /**\n   * Get presigned URL for uploading\n   */\n  public async getPresignedUploadUrl(\n    location: string,\n    options?: PresignedUploadOptions,\n  ): Promise<string> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ContentType: options?.contentType,\n        Metadata: options?.metadata,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUploadUrl\");\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file info/metadata without downloading\n   */\n  public async metadata(location: string): Promise<StorageFileInfo> {\n    return this.withRetry(async () => {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n      const name = location.split(\"/\").pop() || \"\";\n\n      return {\n        path: location,\n        name,\n        size: result.ContentLength || 0,\n        isDirectory: false,\n        lastModified: result.LastModified,\n        mimeType: result.ContentType || this.guessMimeType(location),\n        etag: result.ETag,\n        storageClass: result.StorageClass,\n      };\n    }, \"metadata\");\n  }\n\n  /**\n   * Get file size in bytes (shortcut for metadata().size)\n   */\n  public async size(location: string): Promise<number> {\n    const info = await this.metadata(location);\n    return info.size;\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Copy file to a new location\n   */\n  public async copy(from: string, to: string): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand, HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix to both paths\n      from = this.applyPrefix(from);\n      to = this.applyPrefix(to);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: `${this.options.bucket}/${from}`,\n        Key: to,\n      });\n\n      const result = await this.client.send(command);\n\n      // Get file metadata\n      const headCommand = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: to,\n      });\n      const headResult = await this.client.send(headCommand);\n\n      return {\n        path: to,\n        url: this.url(to),\n        size: headResult.ContentLength || 0,\n        hash: headResult.ETag?.replace(/\"/g, \"\") || \"\",\n        mimeType: headResult.ContentType || this.guessMimeType(to),\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.CopyObjectResult?.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"copy\");\n  }\n\n  /**\n   * Move file to a new location\n   */\n  public async move(from: string, to: string): Promise<CloudStorageFileData> {\n    const file = await this.copy(from, to);\n    await this.delete(from);\n    return file;\n  }\n\n  /**\n   * List files in a directory\n   */\n  public async list(directory: string, options?: ListOptions): Promise<StorageFileInfo[]> {\n    return this.withRetry(async () => {\n      const { ListObjectsV2Command } = S3Client;\n\n      // Apply storage prefix\n      directory = this.applyPrefix(directory);\n\n      const command = new ListObjectsV2Command({\n        Bucket: this.options.bucket,\n        Prefix: directory,\n        MaxKeys: options?.limit,\n        ContinuationToken: options?.cursor,\n        Delimiter: options?.recursive ? undefined : \"/\",\n      });\n\n      const result = await this.client.send(command);\n      const files: StorageFileInfo[] = [];\n\n      // Add files\n      for (const object of result.Contents || []) {\n        if (!object.Key) continue;\n\n        files.push({\n          path: object.Key,\n          name: object.Key.split(\"/\").pop() || \"\",\n          size: object.Size || 0,\n          isDirectory: false,\n          lastModified: object.LastModified,\n          etag: object.ETag,\n          storageClass: object.StorageClass,\n        });\n      }\n\n      // Add directories\n      for (const prefix of result.CommonPrefixes || []) {\n        if (!prefix.Prefix) continue;\n\n        files.push({\n          path: prefix.Prefix,\n          name: prefix.Prefix.split(\"/\").filter(Boolean).pop() || \"\",\n          size: 0,\n          isDirectory: true,\n        });\n      }\n\n      return files;\n    }, \"list\");\n  }\n\n  // ============================================================\n  // Cloud-Specific Operations\n  // ============================================================\n\n  /**\n   * Get bucket name\n   */\n  public getBucket(): string {\n    return this.options.bucket!;\n  }\n\n  /**\n   * Get region\n   */\n  public getRegion(): string {\n    return this.options.region!;\n  }\n\n  /**\n   * Set storage class (e.g., STANDARD, GLACIER, etc.)\n   */\n  public async setStorageClass(location: string, storageClass: string): Promise<void> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: `${this.options.bucket}/${location}`,\n        Key: location,\n        StorageClass: storageClass as any,\n        MetadataDirective: \"COPY\",\n      });\n\n      await this.client.send(command);\n    }, \"setStorageClass\");\n  }\n\n  /**\n   * Set file visibility (public or private)\n   */\n  public async setVisibility(location: string, visibility: FileVisibility): Promise<void> {\n    return this.withRetry(async () => {\n      const { PutObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ACL: visibility === \"public\" ? \"public-read\" : \"private\",\n      });\n\n      await this.client.send(command);\n    }, \"setVisibility\");\n  }\n\n  /**\n   * Get file visibility\n   */\n  public async getVisibility(location: string): Promise<FileVisibility> {\n    return this.withRetry(async () => {\n      const { GetObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      // Check if any grant allows public read\n      const hasPublicRead = result.Grants?.some(\n        (grant) =>\n          grant.Grantee?.URI === \"http://acs.amazonaws.com/groups/global/AllUsers\" &&\n          grant.Permission === \"READ\",\n      );\n\n      return hasPublicRead ? \"public\" : \"private\";\n    }, \"getVisibility\");\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Calculate SHA-256 hash\n   */\n  protected calculateHash(buffer: Buffer): string {\n    return crypto.createHash(\"sha256\").update(new Uint8Array(buffer)).digest(\"hex\");\n  }\n\n  /**\n   * Guess MIME type from file extension\n   */\n  protected guessMimeType(location: string): string {\n    return getMimeType(location);\n  }\n}\n"],"mappings":"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"}

package/esm/storage/drivers/do-spaces-driver.d.mts

@@ -1,7 +1,7 @@
 import { CloudStorageDriverOptions } from "../types.mjs";
 import { CloudDriver } from "./cloud-driver.mjs";
 
-//#region ../../@warlock.js/core/src/storage/drivers/do-spaces-driver.d.ts
+//#region ../@warlock.js/core/src/storage/drivers/do-spaces-driver.d.ts
 /**
  * DigitalOcean Spaces Storage Driver
  *

package/esm/storage/drivers/do-spaces-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"do-spaces-driver.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/drivers/do-spaces-driver.ts"],"mappings":";;;;;;AA0BA;;;;;;;;;;;AAoB6B;;;;;;;;;cApBhB,cAAA,SAAuB,WAAW,CAAC,yBAAA;;;;WAI9B,IAAA;;;;;;YAON,WAAA,CAAA;;;;;;EASH,GAAA,CAAI,QAAA;AAAA"}
+{"version":3,"file":"do-spaces-driver.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/core/src/storage/drivers/do-spaces-driver.ts"],"mappings":";;;;;;AA0BA;;;;;;;;;;;AAoB6B;;;;;;;;;cApBhB,cAAA,SAAuB,WAAW,CAAC,yBAAA;;;;WAI9B,IAAA;;;;;;YAON,WAAA;;;;;;EASH,GAAA,CAAI,QAAA;AAAA"}

package/esm/storage/drivers/do-spaces-driver.mjs

@@ -1,7 +1,7 @@
 import { CloudDriver } from "./cloud-driver.mjs";
 import { ltrim } from "@mongez/reinforcements";
 
-//#region ../../@warlock.js/core/src/storage/drivers/do-spaces-driver.ts
+//#region ../@warlock.js/core/src/storage/drivers/do-spaces-driver.ts
 /**
 * DigitalOcean Spaces Storage Driver
 *

package/esm/storage/drivers/do-spaces-driver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"do-spaces-driver.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/drivers/do-spaces-driver.ts"],"sourcesContent":["import { ltrim } from \"@mongez/reinforcements\";\nimport type { CloudStorageDriverOptions } from \"../types\";\nimport { CloudDriver } from \"./cloud-driver\";\n\n/**\n * DigitalOcean Spaces Storage Driver\n *\n * Spaces is S3-compatible with a different URL structure.\n *\n * URL Patterns:\n * - With urlPrefix: {urlPrefix}/{key}\n * - CDN URL: https://{bucket}.{region}.cdn.digitaloceanspaces.com/{key}\n * - Origin URL: https://{bucket}.{region}.digitaloceanspaces.com/{key}\n *\n * Regions: nyc3, sfo3, ams3, sgp1, fra1, etc.\n *\n * @example\n * ```typescript\n * const driver = new DOSpacesDriver({\n *   bucket: \"my-space\",\n *   region: \"nyc3\",\n *   accessKeyId: process.env.DO_SPACES_KEY,\n *   secretAccessKey: process.env.DO_SPACES_SECRET,\n * });\n * ```\n */\nexport class DOSpacesDriver extends CloudDriver<CloudStorageDriverOptions> {\n  /**\n   * Driver name\n   */\n  public readonly name = \"spaces\";\n\n  /**\n   * Get Spaces endpoint URL\n   *\n   * Spaces endpoint format: https://{region}.digitaloceanspaces.com\n   */\n  protected getEndpoint(): string {\n    return this.options.endpoint || `https://${this.options.region}.digitaloceanspaces.com`;\n  }\n\n  /**\n   * Get public URL for file\n   *\n   * Note: DO Spaces includes automatic CDN with the `.cdn.` subdomain\n   */\n  public url(location: string): string {\n    // 1. Use urlPrefix if configured\n    if (this.options.urlPrefix) {\n      const prefix = this.options.urlPrefix.replace(/\\/+$/, \"\");\n      location = `${prefix}/${ltrim(location, \"/\")}`;\n    }\n\n    // 2. Default Spaces CDN URL\n    return `https://${this.options.bucket}.${this.options.region}.cdn.digitaloceanspaces.com/${location}`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAa,iBAAb,cAAoC,YAAuC;;;cAIlD;;;;;;;CAOvB,AAAU,cAAsB;EAC9B,OAAO,KAAK,QAAQ,YAAY,WAAW,KAAK,QAAQ,OAAO;CACjE;;;;;;CAOA,AAAO,IAAI,UAA0B;EAEnC,IAAI,KAAK,QAAQ,WAEf,WAAW,GADI,KAAK,QAAQ,UAAU,QAAQ,QAAQ,EACnC,EAAE,GAAG,MAAM,UAAU,GAAG;EAI7C,OAAO,WAAW,KAAK,QAAQ,OAAO,GAAG,KAAK,QAAQ,OAAO,8BAA8B;CAC7F;AACF"}
+{"version":3,"file":"do-spaces-driver.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/storage/drivers/do-spaces-driver.ts"],"sourcesContent":["import { ltrim } from \"@mongez/reinforcements\";\nimport type { CloudStorageDriverOptions } from \"../types\";\nimport { CloudDriver } from \"./cloud-driver\";\n\n/**\n * DigitalOcean Spaces Storage Driver\n *\n * Spaces is S3-compatible with a different URL structure.\n *\n * URL Patterns:\n * - With urlPrefix: {urlPrefix}/{key}\n * - CDN URL: https://{bucket}.{region}.cdn.digitaloceanspaces.com/{key}\n * - Origin URL: https://{bucket}.{region}.digitaloceanspaces.com/{key}\n *\n * Regions: nyc3, sfo3, ams3, sgp1, fra1, etc.\n *\n * @example\n * ```typescript\n * const driver = new DOSpacesDriver({\n *   bucket: \"my-space\",\n *   region: \"nyc3\",\n *   accessKeyId: process.env.DO_SPACES_KEY,\n *   secretAccessKey: process.env.DO_SPACES_SECRET,\n * });\n * ```\n */\nexport class DOSpacesDriver extends CloudDriver<CloudStorageDriverOptions> {\n  /**\n   * Driver name\n   */\n  public readonly name = \"spaces\";\n\n  /**\n   * Get Spaces endpoint URL\n   *\n   * Spaces endpoint format: https://{region}.digitaloceanspaces.com\n   */\n  protected getEndpoint(): string {\n    return this.options.endpoint || `https://${this.options.region}.digitaloceanspaces.com`;\n  }\n\n  /**\n   * Get public URL for file\n   *\n   * Note: DO Spaces includes automatic CDN with the `.cdn.` subdomain\n   */\n  public url(location: string): string {\n    // 1. Use urlPrefix if configured\n    if (this.options.urlPrefix) {\n      const prefix = this.options.urlPrefix.replace(/\\/+$/, \"\");\n      location = `${prefix}/${ltrim(location, \"/\")}`;\n    }\n\n    // 2. Default Spaces CDN URL\n    return `https://${this.options.bucket}.${this.options.region}.cdn.digitaloceanspaces.com/${location}`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAa,iBAAb,cAAoC,YAAuC;;;cAIlD;;;;;;;CAOvB,AAAU,cAAsB;EAC9B,OAAO,KAAK,QAAQ,YAAY,WAAW,KAAK,QAAQ,OAAO;CACjE;;;;;;CAOA,AAAO,IAAI,UAA0B;EAEnC,IAAI,KAAK,QAAQ,WAEf,WAAW,GADI,KAAK,QAAQ,UAAU,QAAQ,QAAQ,EACnC,EAAE,GAAG,MAAM,UAAU,GAAG;EAI7C,OAAO,WAAW,KAAK,QAAQ,OAAO,GAAG,KAAK,QAAQ,OAAO,8BAA8B;CAC7F;AACF"}

package/esm/storage/drivers/local-driver.d.mts

@@ -2,7 +2,7 @@ import { DeleteManyResult, ListOptions, LocalStorageDriverOptions, PutOptions, S
 import { UploadedFile } from "../../http/uploaded-file.mjs";
 import { Readable } from "stream";
 
-//#region ../../@warlock.js/core/src/storage/drivers/local-driver.d.ts
+//#region ../@warlock.js/core/src/storage/drivers/local-driver.d.ts
 /**
  * Local filesystem storage driver
  *