@warlock.js/cache 5.2.3 → 5.3.0

package/esm/cache-manager.d.mts.map

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

package/esm/cache-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cache-manager.mjs","names":[],"sources":["../../../../../../cache/src/cache-manager.ts"],"sourcesContent":["import { CacheMetricsCollector } from \"./metrics\";\r\nimport { ScopedCache } from \"./scoped-cache\";\r\nimport type {\r\n  CacheConfigurations,\r\n  CacheDriver,\r\n  CacheEventHandler,\r\n  CacheEventType,\r\n  CacheKey,\r\n  CacheListAccessor,\r\n  CacheMetricsSnapshot,\r\n  CacheNamespaceOptions,\r\n  CacheSetOptions,\r\n  CacheSimilarHit,\r\n  CacheSimilarOptions,\r\n  CacheSwrOptions,\r\n  CacheTtl,\r\n  DriverClass,\r\n  LockOptions,\r\n  LockOutcome,\r\n  RememberOptions,\r\n  ScopedCacheContract,\r\n  TaggedCacheDriver,\r\n} from \"./types\";\r\nimport { CacheConfigurationError, CacheDriverNotInitializedError } from \"./types\";\r\n\r\nexport class CacheManager implements CacheDriver<any, any> {\r\n  /**\r\n   * Cache Driver\r\n   */\r\n  public currentDriver?: CacheDriver<any, any>;\r\n\r\n  /**\r\n   * Loaded drivers\r\n   */\r\n  public loadedDrivers: Record<string, CacheDriver<any, any>> = {};\r\n\r\n  /**\r\n   * Configurations list\r\n   */\r\n  protected configurations: CacheConfigurations = {\r\n    drivers: {},\r\n    options: {},\r\n  };\r\n\r\n  /**\r\n   * Global event listeners\r\n   */\r\n  protected globalEventListeners: Map<CacheEventType, Set<CacheEventHandler>> = new Map();\r\n\r\n  /**\r\n   * Metrics collector — lazy on first {@link metrics} call so apps that\r\n   * never read metrics pay zero cost. Once instantiated, it stays\r\n   * subscribed to events for the manager's lifetime.\r\n   */\r\n  protected metricsCollector?: CacheMetricsCollector;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public name = \"cacheManager\";\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public get client() {\r\n    return this.currentDriver?.client;\r\n  }\r\n\r\n  /**\r\n   * Set the cache configurations\r\n   */\r\n  public setCacheConfigurations(configurations: CacheConfigurations) {\r\n    this.configurations.default = configurations.default;\r\n    this.configurations.drivers = configurations.drivers;\r\n    this.configurations.options = configurations.options;\r\n    this.configurations.logging = configurations.logging;\r\n  }\r\n\r\n  /**\r\n   * Set logging state\r\n   */\r\n  public setLoggingState(loggingState: boolean) {\r\n    this.ensureDriverInitialized();\r\n\r\n    this.currentDriver!.setLoggingState(loggingState);\r\n  }\r\n\r\n  /**\r\n   * Switch the manager to a registered driver, optionally injecting runtime\r\n   * options that merge over the static config.\r\n   *\r\n   * The string form looks the driver up in `setCacheConfigurations({ drivers })`,\r\n   * loads it (or returns the cached instance), and sets it as `currentDriver`.\r\n   * The instance form takes a pre-built driver and bypasses the registry; the\r\n   * `runtimeOptions` argument is silently ignored in that case because the\r\n   * instance was constructed externally.\r\n   *\r\n   * Runtime options merge over `config.options[name]` per-key — runtime wins.\r\n   * Use this for constructor-only knobs that can't live in static config\r\n   * (e.g. `pg`'s `client: pg.Pool`).\r\n   *\r\n   * @example\r\n   * const pool = new Pool({ connectionString });\r\n   * await cache.use(\"pg\", { client: pool });\r\n   */\r\n  public async use(\r\n    driver: string | CacheDriver<any, any>,\r\n    runtimeOptions?: Record<string, any>,\r\n  ) {\r\n    if (typeof driver === \"string\") {\r\n      const driverInstance = await this.load(driver, runtimeOptions);\r\n\r\n      if (!driverInstance) {\r\n        throw new CacheConfigurationError(\r\n          `Cache driver ${driver} is not found, please declare it in the cache drivers in the configurations list.`,\r\n        );\r\n      }\r\n\r\n      driver = driverInstance;\r\n    }\r\n\r\n    this.attachGlobalListeners(driver);\r\n\r\n    if (this.configurations.logging !== undefined) {\r\n      driver.setLoggingState(this.configurations.logging);\r\n    }\r\n\r\n    this.currentDriver = driver;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Ensure driver is initialized before operations\r\n   */\r\n  protected ensureDriverInitialized(): void {\r\n    if (!this.currentDriver) {\r\n      throw new CacheDriverNotInitializedError();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Return the running metrics snapshot — counters, hit-rate, latency\r\n   * percentiles, per-driver breakdowns. Lazy-attaches the collector on\r\n   * first call so apps that never read metrics pay zero cost.\r\n   *\r\n   * @example\r\n   * const m = cache.metrics();\r\n   * console.log(`hit rate: ${(m.hitRate * 100).toFixed(1)}%`);\r\n   * console.log(`p95: ${m.latencyMs.p95.toFixed(2)}ms`);\r\n   */\r\n  public metrics(): CacheMetricsSnapshot {\r\n    return this.ensureMetricsCollector().snapshot();\r\n  }\r\n\r\n  /**\r\n   * Wipe every counter + latency sample and reset `startedAt` to now.\r\n   * The collector itself stays subscribed to events.\r\n   */\r\n  public resetMetrics(): void {\r\n    this.ensureMetricsCollector().reset();\r\n  }\r\n\r\n  /**\r\n   * Lazy-construct the metrics collector and wire it to the global event\r\n   * bus. Subsequent calls return the same instance — survives `cache.use()`\r\n   * driver switches because handlers attach via `on()` and re-bind to every\r\n   * loaded driver.\r\n   */\r\n  protected ensureMetricsCollector(): CacheMetricsCollector {\r\n    if (this.metricsCollector) {\r\n      return this.metricsCollector;\r\n    }\r\n\r\n    const collector = new CacheMetricsCollector();\r\n\r\n    this.on(\"hit\", (data) => collector.recordEvent(\"hit\", data));\r\n    this.on(\"miss\", (data) => collector.recordEvent(\"miss\", data));\r\n    this.on(\"set\", (data) => collector.recordEvent(\"set\", data));\r\n    this.on(\"removed\", (data) => collector.recordEvent(\"removed\", data));\r\n    this.on(\"error\", (data) => collector.recordEvent(\"error\", data));\r\n\r\n    this.metricsCollector = collector;\r\n\r\n    return collector;\r\n  }\r\n\r\n  /**\r\n   * Time the body, record the elapsed milliseconds against the metrics\r\n   * collector for the given driver (defaults to the current driver's name).\r\n   * Pass-through if the collector hasn't been instantiated yet — apps that\r\n   * don't read metrics never pay for sample collection.\r\n   */\r\n  protected async timed<T>(\r\n    body: () => Promise<T>,\r\n    driverName?: string,\r\n  ): Promise<T> {\r\n    if (!this.metricsCollector) {\r\n      return body();\r\n    }\r\n\r\n    const start = performance.now();\r\n\r\n    try {\r\n      return await body();\r\n    } finally {\r\n      const elapsed = performance.now() - start;\r\n      const name = driverName ?? this.currentDriver?.name ?? \"unknown\";\r\n      this.metricsCollector.recordLatency(name, elapsed);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async get<T = any>(key: CacheKey): Promise<T | null> {\r\n    this.ensureDriverInitialized();\r\n    return this.timed(() => this.currentDriver!.get<T>(key));\r\n  }\r\n\r\n  /**\r\n   * Set a value in the cache.\r\n   *\r\n   * Accepts a positional TTL (number of seconds or duration string like `\"1h\"`)\r\n   * or a rich {@link CacheSetOptions} object supporting `ttl`, `expiresAt`,\r\n   * `tags`, `onConflict`, `namespace`, and per-call `driver` overrides.\r\n   */\r\n  public async set(key: CacheKey, value: any, ttlOrOptions?: CacheTtl | CacheSetOptions) {\r\n    this.ensureDriverInitialized();\r\n\r\n    const driverOverride =\r\n      ttlOrOptions && typeof ttlOrOptions === \"object\" && \"driver\" in ttlOrOptions\r\n        ? ttlOrOptions.driver\r\n        : undefined;\r\n\r\n    if (driverOverride) {\r\n      const driver = await this.load(driverOverride);\r\n      return this.timed(() => driver.set(key, value, ttlOrOptions), driver.name);\r\n    }\r\n\r\n    return this.timed(() => this.currentDriver!.set(key, value, ttlOrOptions));\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async remove(key: CacheKey) {\r\n    this.ensureDriverInitialized();\r\n    return this.timed(() => this.currentDriver!.remove(key));\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async removeNamespace(namespace: string) {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.removeNamespace(namespace);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async flush() {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.flush();\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async connect() {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.connect();\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public parseKey(key: CacheKey) {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.parseKey(key);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public get options() {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.options;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public setOptions(options: Record<string, any>) {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.setOptions(options || {});\r\n  }\r\n\r\n  /**\r\n   * Return the loaded driver instance for `driverName`, loading it on first\r\n   * call. Optional `runtimeOptions` follow the same merge-over-config rules\r\n   * as {@link load}; passing options after the driver has already been\r\n   * loaded throws to avoid silent swallowing.\r\n   */\r\n  public async driver(driverName: string, runtimeOptions?: Record<string, any>) {\r\n    if (this.loadedDrivers[driverName]) {\r\n      this.assertNoConflictingReload(driverName, runtimeOptions);\r\n\r\n      return this.loadedDrivers[driverName];\r\n    }\r\n\r\n    return this.load(driverName, runtimeOptions);\r\n  }\r\n\r\n  /**\r\n   * Initialize the cache manager and pick the default driver\r\n   */\r\n  public async init() {\r\n    const defaultCacheDriverName = this.configurations.default;\r\n\r\n    if (!defaultCacheDriverName) {\r\n      return;\r\n    }\r\n\r\n    const driver = await this.driver(defaultCacheDriverName);\r\n\r\n    await this.use(driver);\r\n  }\r\n\r\n  /**\r\n   * Load and connect the registered driver named `driver`. First-call wins —\r\n   * subsequent calls without `runtimeOptions` return the cached instance, and\r\n   * subsequent calls *with* `runtimeOptions` throw {@link CacheConfigurationError}\r\n   * to avoid silently dropping the new options.\r\n   *\r\n   * `runtimeOptions` merge over `config.options[driver]` per-key (runtime wins),\r\n   * letting consumers split static knobs (table, ttl, globalPrefix) from\r\n   * constructor-only ones (pg's `client`, custom adapters, etc.).\r\n   *\r\n   * @example\r\n   * const pool = new Pool({ connectionString });\r\n   * const pg = await cache.load(\"pg\", { client: pool });\r\n   */\r\n  public async load(driver: string, runtimeOptions?: Record<string, any>) {\r\n    if (this.loadedDrivers[driver]) {\r\n      this.assertNoConflictingReload(driver, runtimeOptions);\r\n\r\n      return this.loadedDrivers[driver];\r\n    }\r\n\r\n    const Driver = this.configurations.drivers[\r\n      driver as keyof typeof this.configurations.drivers\r\n    ] as DriverClass | undefined;\r\n\r\n    if (!Driver) {\r\n      throw new CacheConfigurationError(\r\n        `Cache driver ${driver} is not found, please declare it in the cache drivers in the configurations list.`,\r\n      );\r\n    }\r\n\r\n    const driverInstance = new Driver();\r\n    const configOptions =\r\n      this.configurations.options[driver as keyof typeof this.configurations.options] || {};\r\n\r\n    driverInstance.setOptions({ ...configOptions, ...(runtimeOptions ?? {}) });\r\n\r\n    await driverInstance.connect();\r\n\r\n    this.attachGlobalListeners(driverInstance);\r\n\r\n    this.loadedDrivers[driver] = driverInstance;\r\n\r\n    return driverInstance as CacheDriver<any, any>;\r\n  }\r\n\r\n  /**\r\n   * Guard against silently dropping runtime options on a re-load. Once a\r\n   * driver has been instantiated, its options are frozen — calling `load` /\r\n   * `driver` / `use` again with a non-empty `runtimeOptions` would otherwise\r\n   * appear to work but actually use the original options. We throw instead\r\n   * so the misuse surfaces at the call site.\r\n   */\r\n  protected assertNoConflictingReload(\r\n    driverName: string,\r\n    runtimeOptions: Record<string, any> | undefined,\r\n  ): void {\r\n    if (runtimeOptions === undefined) {\r\n      return;\r\n    }\r\n\r\n    if (Object.keys(runtimeOptions).length === 0) {\r\n      return;\r\n    }\r\n\r\n    throw new CacheConfigurationError(\r\n      `Cache driver '${driverName}' is already loaded; runtime options on subsequent calls are ignored — register a second driver name if you need a different configuration.`,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Register and bind a driver\r\n   */\r\n  public registerDriver(driverName: string, driverClass: DriverClass) {\r\n    (this.configurations.drivers as Record<string, DriverClass>)[driverName] = driverClass;\r\n  }\r\n\r\n  /**\r\n   * Disconnect the cache manager\r\n   */\r\n  public async disconnect() {\r\n    if (this.currentDriver) {\r\n      await this.currentDriver.disconnect();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async has(key: CacheKey): Promise<boolean> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.has(key);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async remember<T = any>(\r\n    key: CacheKey,\r\n    ttlOrOptions: CacheTtl | RememberOptions,\r\n    callback: () => Promise<T>,\r\n  ): Promise<T> {\r\n    this.ensureDriverInitialized();\r\n\r\n    const driverOverride =\r\n      ttlOrOptions && typeof ttlOrOptions === \"object\" && \"driver\" in ttlOrOptions\r\n        ? ttlOrOptions.driver\r\n        : undefined;\r\n\r\n    if (driverOverride) {\r\n      const driver = await this.load(driverOverride);\r\n      return driver.remember(key, ttlOrOptions, callback);\r\n    }\r\n\r\n    return this.currentDriver!.remember(key, ttlOrOptions, callback);\r\n  }\r\n\r\n  /**\r\n   * Stale-while-revalidate. Returns cached when fresh, returns the stale\r\n   * value plus a background refresh when within `freshTtl..staleTtl`,\r\n   * blocks like a normal miss past `staleTtl`. Honors per-call `driver`\r\n   * override the same way `remember()` does.\r\n   *\r\n   * @example\r\n   * const product = await cache.swr(\r\n   *   \"product.42\",\r\n   *   { freshTtl: \"1m\", staleTtl: \"1h\" },\r\n   *   () => db.products.find(42),\r\n   * );\r\n   */\r\n  public async swr<T = any>(\r\n    key: CacheKey,\r\n    options: CacheSwrOptions,\r\n    callback: () => Promise<T>,\r\n  ): Promise<T> {\r\n    this.ensureDriverInitialized();\r\n\r\n    const driverOverride = options.driver;\r\n\r\n    if (driverOverride) {\r\n      const driver = await this.load(driverOverride);\r\n\r\n      return driver.swr<T>(key, options, callback);\r\n    }\r\n\r\n    return this.currentDriver!.swr<T>(key, options, callback);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async pull(key: CacheKey): Promise<any | null> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.pull(key);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async forever(key: CacheKey, value: any): Promise<any> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.forever(key, value);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async increment(key: CacheKey, value?: number): Promise<number> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.increment(key, value);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async decrement(key: CacheKey, value?: number): Promise<number> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.decrement(key, value);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async many(keys: CacheKey[]): Promise<any[]> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.many(keys);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async setMany(items: Record<string, any>, ttl?: number): Promise<void> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.setMany(items, ttl);\r\n  }\r\n\r\n  /**\r\n   * Register a global event listener (applies to all drivers)\r\n   */\r\n  public on(event: CacheEventType, handler: CacheEventHandler): this {\r\n    if (!this.globalEventListeners.has(event)) {\r\n      this.globalEventListeners.set(event, new Set());\r\n    }\r\n    this.globalEventListeners.get(event)!.add(handler);\r\n\r\n    // Also attach to current driver if exists\r\n    if (this.currentDriver) {\r\n      this.currentDriver.on(event, handler);\r\n    }\r\n\r\n    // Attach to all loaded drivers\r\n    for (const driver of Object.values(this.loadedDrivers)) {\r\n      driver.on(event, handler);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Remove a global event listener\r\n   */\r\n  public off(event: CacheEventType, handler: CacheEventHandler): this {\r\n    const handlers = this.globalEventListeners.get(event);\r\n    if (handlers) {\r\n      handlers.delete(handler);\r\n    }\r\n\r\n    // Also remove from current driver\r\n    if (this.currentDriver) {\r\n      this.currentDriver.off(event, handler);\r\n    }\r\n\r\n    // Remove from all loaded drivers\r\n    for (const driver of Object.values(this.loadedDrivers)) {\r\n      driver.off(event, handler);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Register a one-time global event listener\r\n   */\r\n  public once(event: CacheEventType, handler: CacheEventHandler): this {\r\n    const onceHandler: CacheEventHandler = async (data) => {\r\n      await handler(data);\r\n      this.off(event, onceHandler);\r\n    };\r\n    return this.on(event, onceHandler);\r\n  }\r\n\r\n  /**\r\n   * Attach global listeners to a driver\r\n   */\r\n  protected attachGlobalListeners(driver: CacheDriver<any, any>) {\r\n    for (const [event, handlers] of this.globalEventListeners) {\r\n      for (const handler of handlers) {\r\n        driver.on(event, handler);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Set if not exists (atomic operation)\r\n   * Returns true if key was set, false if key already existed\r\n   * Note: Only supported by drivers that implement setNX (e.g., Redis)\r\n   */\r\n  public async setNX(key: CacheKey, value: any, ttl?: number): Promise<boolean> {\r\n    this.ensureDriverInitialized();\r\n\r\n    if (!this.currentDriver!.setNX) {\r\n      throw new Error(\r\n        `setNX is not supported by the current cache driver: ${this.currentDriver!.name}`,\r\n      );\r\n    }\r\n\r\n    return this.currentDriver!.setNX(key, value, ttl);\r\n  }\r\n\r\n  /**\r\n   * Create a tagged cache instance for the given tags\r\n   */\r\n  public tags(tags: string[]): TaggedCacheDriver {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.tags(tags);\r\n  }\r\n\r\n  /**\r\n   * Atomically read, transform, and write a cached value. Delegates to the current driver.\r\n   */\r\n  public async update<T = any>(\r\n    key: CacheKey,\r\n    fn: (current: T | null) => T | null | Promise<T | null>,\r\n    options?: { ttl?: CacheTtl },\r\n  ): Promise<T | null> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.update<T>(key, fn, options);\r\n  }\r\n\r\n  /**\r\n   * Shallow-merge a partial object into a cached value.\r\n   */\r\n  public async merge<T extends Record<string, any> = Record<string, any>>(\r\n    key: CacheKey,\r\n    partial: Partial<T>,\r\n    options?: { ttl?: CacheTtl },\r\n  ): Promise<T> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.merge<T>(key, partial, options);\r\n  }\r\n\r\n  /**\r\n   * Obtain a list accessor bound to the current driver.\r\n   */\r\n  public list<T = any>(key: CacheKey): CacheListAccessor<T> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.list<T>(key);\r\n  }\r\n\r\n  /**\r\n   * Acquire a distributed lock, run `fn`, and auto-release. Returns a\r\n   * {@link LockOutcome} discriminated union so callers can distinguish\r\n   * \"ran and got this value\" from \"skipped because someone else holds it\".\r\n   *\r\n   * Honors the `driver` option for per-call driver override, same as `set`\r\n   * and `remember`.\r\n   *\r\n   * @example\r\n   * const outcome = await cache.lock(\"lock.import\", \"5m\", async () => {\r\n   *   await runImport();\r\n   *   return \"done\";\r\n   * });\r\n   * if (!outcome.acquired) {\r\n   *   console.log(\"another worker is already importing\");\r\n   * }\r\n   */\r\n  public async lock<T>(\r\n    key: CacheKey,\r\n    ttlOrOptions: CacheTtl | LockOptions,\r\n    fn: () => Promise<T>,\r\n  ): Promise<LockOutcome<T>> {\r\n    this.ensureDriverInitialized();\r\n\r\n    const driverOverride =\r\n      ttlOrOptions && typeof ttlOrOptions === \"object\" && \"driver\" in ttlOrOptions\r\n        ? ttlOrOptions.driver\r\n        : undefined;\r\n\r\n    const driver = driverOverride\r\n      ? await this.load(driverOverride)\r\n      : this.currentDriver!;\r\n\r\n    return driver.lock<T>(key, ttlOrOptions as CacheTtl | Omit<LockOptions, \"driver\">, fn);\r\n  }\r\n\r\n  /**\r\n   * Similarity retrieval. Delegates to the current driver's `similar()` impl.\r\n   *\r\n   * Drivers that lack a similarity index throw {@link CacheUnsupportedError}.\r\n   *\r\n   * @example\r\n   * const hits = await cache.similar(await embed(query), { topK: 5, threshold: 0.7 });\r\n   */\r\n  /**\r\n   * Create a scoped view over the cache. Every key written through the\r\n   * returned scope is automatically prefixed with `prefix`; optional defaults\r\n   * (`ttl`, `tags`) flow through every write inside the scope.\r\n   *\r\n   * Per-call options always win over scope defaults. Scope tags merge\r\n   * additively with per-call tags. Nested scopes inherit from the parent.\r\n   *\r\n   * @example\r\n   * const chat = cache.namespace(\"chats.10\", { ttl: \"30d\" });\r\n   * await chat.set(\"messages.1\", msg);          // → \"chats.10.messages.1\", 30d\r\n   * await chat.set(\"draft\", d, { ttl: \"1h\" });  // per-call ttl wins\r\n   * await chat.namespace(\"typing\", { ttl: \"5s\" }).set(\"user.42\", true);\r\n   * await chat.clear();                          // wipe the whole scope\r\n   */\r\n  public namespace(prefix: string, options?: CacheNamespaceOptions): ScopedCacheContract {\r\n    this.ensureDriverInitialized();\r\n    return new ScopedCache(this, prefix, options);\r\n  }\r\n\r\n  public async similar<T = any>(\r\n    vector: number[],\r\n    options: CacheSimilarOptions,\r\n  ): Promise<CacheSimilarHit<T>[]> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.similar<T>(vector, options);\r\n  }\r\n}\r\n\r\nexport const cache = new CacheManager();\r\n"],"mappings":"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"}
+{"version":3,"file":"cache-manager.mjs","names":[],"sources":["../../../../../../cache/src/cache-manager.ts"],"sourcesContent":["import { CacheMetricsCollector } from \"./metrics\";\r\nimport { ScopedCache } from \"./scoped-cache\";\r\nimport type {\r\n  CacheConfigurations,\r\n  CacheDriver,\r\n  CacheEventHandler,\r\n  CacheEventType,\r\n  CacheKey,\r\n  CacheListAccessor,\r\n  CacheMetricsSnapshot,\r\n  CacheNamespaceOptions,\r\n  CacheSetOptions,\r\n  CacheSimilarHit,\r\n  CacheSimilarOptions,\r\n  CacheSwrOptions,\r\n  CacheTtl,\r\n  DriverClass,\r\n  LockOptions,\r\n  LockOutcome,\r\n  RememberOptions,\r\n  ScopedCacheContract,\r\n  TaggedCacheDriver,\r\n} from \"./types\";\r\nimport { CacheConfigurationError, CacheDriverNotInitializedError } from \"./types\";\r\n\r\nexport class CacheManager implements CacheDriver<any, any> {\r\n  /**\r\n   * Cache Driver\r\n   */\r\n  public currentDriver?: CacheDriver<any, any>;\r\n\r\n  /**\r\n   * Loaded drivers\r\n   */\r\n  public loadedDrivers: Record<string, CacheDriver<any, any>> = {};\r\n\r\n  /**\r\n   * Configurations list\r\n   */\r\n  protected configurations: CacheConfigurations = {\r\n    drivers: {},\r\n    options: {},\r\n  };\r\n\r\n  /**\r\n   * Global event listeners\r\n   */\r\n  protected globalEventListeners: Map<CacheEventType, Set<CacheEventHandler>> = new Map();\r\n\r\n  /**\r\n   * Metrics collector — lazy on first {@link metrics} call so apps that\r\n   * never read metrics pay zero cost. Once instantiated, it stays\r\n   * subscribed to events for the manager's lifetime.\r\n   */\r\n  protected metricsCollector?: CacheMetricsCollector;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public name = \"cacheManager\";\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public get client() {\r\n    return this.currentDriver?.client;\r\n  }\r\n\r\n  /**\r\n   * Set the cache configurations\r\n   */\r\n  public setCacheConfigurations(configurations: CacheConfigurations) {\r\n    this.configurations.default = configurations.default;\r\n    this.configurations.drivers = configurations.drivers;\r\n    this.configurations.options = configurations.options;\r\n    this.configurations.logging = configurations.logging;\r\n  }\r\n\r\n  /**\r\n   * Set logging state\r\n   */\r\n  public setLoggingState(loggingState: boolean) {\r\n    this.ensureDriverInitialized();\r\n\r\n    this.currentDriver!.setLoggingState(loggingState);\r\n  }\r\n\r\n  /**\r\n   * Switch the manager to a registered driver, optionally injecting runtime\r\n   * options that merge over the static config.\r\n   *\r\n   * The string form looks the driver up in `setCacheConfigurations({ drivers })`,\r\n   * loads it (or returns the cached instance), and sets it as `currentDriver`.\r\n   * The instance form takes a pre-built driver and bypasses the registry; the\r\n   * `runtimeOptions` argument is silently ignored in that case because the\r\n   * instance was constructed externally.\r\n   *\r\n   * Runtime options merge over `config.options[name]` per-key — runtime wins.\r\n   * Use this for constructor-only knobs that can't live in static config\r\n   * (e.g. `pg`'s `client: pg.Pool`).\r\n   *\r\n   * @example\r\n   * const pool = new Pool({ connectionString });\r\n   * await cache.use(\"pg\", { client: pool });\r\n   */\r\n  public async use(\r\n    driver: string | CacheDriver<any, any>,\r\n    runtimeOptions?: Record<string, any>,\r\n  ) {\r\n    if (typeof driver === \"string\") {\r\n      const driverInstance = await this.load(driver, runtimeOptions);\r\n\r\n      if (!driverInstance) {\r\n        throw new CacheConfigurationError(\r\n          `Cache driver ${driver} is not found, please declare it in the cache drivers in the configurations list.`,\r\n        );\r\n      }\r\n\r\n      driver = driverInstance;\r\n    }\r\n\r\n    this.attachGlobalListeners(driver);\r\n\r\n    if (this.configurations.logging !== undefined) {\r\n      driver.setLoggingState(this.configurations.logging);\r\n    }\r\n\r\n    this.currentDriver = driver;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Ensure driver is initialized before operations\r\n   */\r\n  protected ensureDriverInitialized(): void {\r\n    if (!this.currentDriver) {\r\n      throw new CacheDriverNotInitializedError();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Return the running metrics snapshot — counters, hit-rate, latency\r\n   * percentiles, per-driver breakdowns. Lazy-attaches the collector on\r\n   * first call so apps that never read metrics pay zero cost.\r\n   *\r\n   * @example\r\n   * const m = cache.metrics();\r\n   * console.log(`hit rate: ${(m.hitRate * 100).toFixed(1)}%`);\r\n   * console.log(`p95: ${m.latencyMs.p95.toFixed(2)}ms`);\r\n   */\r\n  public metrics(): CacheMetricsSnapshot {\r\n    return this.ensureMetricsCollector().snapshot();\r\n  }\r\n\r\n  /**\r\n   * Wipe every counter + latency sample and reset `startedAt` to now.\r\n   * The collector itself stays subscribed to events.\r\n   */\r\n  public resetMetrics(): void {\r\n    this.ensureMetricsCollector().reset();\r\n  }\r\n\r\n  /**\r\n   * Lazy-construct the metrics collector and wire it to the global event\r\n   * bus. Subsequent calls return the same instance — survives `cache.use()`\r\n   * driver switches because handlers attach via `on()` and re-bind to every\r\n   * loaded driver.\r\n   */\r\n  protected ensureMetricsCollector(): CacheMetricsCollector {\r\n    if (this.metricsCollector) {\r\n      return this.metricsCollector;\r\n    }\r\n\r\n    const collector = new CacheMetricsCollector();\r\n\r\n    this.on(\"hit\", (data) => collector.recordEvent(\"hit\", data));\r\n    this.on(\"miss\", (data) => collector.recordEvent(\"miss\", data));\r\n    this.on(\"set\", (data) => collector.recordEvent(\"set\", data));\r\n    this.on(\"removed\", (data) => collector.recordEvent(\"removed\", data));\r\n    this.on(\"error\", (data) => collector.recordEvent(\"error\", data));\r\n\r\n    this.metricsCollector = collector;\r\n\r\n    return collector;\r\n  }\r\n\r\n  /**\r\n   * Time the body, record the elapsed milliseconds against the metrics\r\n   * collector for the given driver (defaults to the current driver's name).\r\n   * Pass-through if the collector hasn't been instantiated yet — apps that\r\n   * don't read metrics never pay for sample collection.\r\n   */\r\n  protected async timed<T>(\r\n    body: () => Promise<T>,\r\n    driverName?: string,\r\n  ): Promise<T> {\r\n    if (!this.metricsCollector) {\r\n      return body();\r\n    }\r\n\r\n    const start = performance.now();\r\n\r\n    try {\r\n      return await body();\r\n    } finally {\r\n      const elapsed = performance.now() - start;\r\n      const name = driverName ?? this.currentDriver?.name ?? \"unknown\";\r\n      this.metricsCollector.recordLatency(name, elapsed);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async get<T = any>(key: CacheKey): Promise<T | null> {\r\n    this.ensureDriverInitialized();\r\n    return this.timed(() => this.currentDriver!.get<T>(key));\r\n  }\r\n\r\n  /**\r\n   * Set a value in the cache.\r\n   *\r\n   * Accepts a positional TTL (number of seconds or duration string like `\"1h\"`)\r\n   * or a rich {@link CacheSetOptions} object supporting `ttl`, `expiresAt`,\r\n   * `tags`, `onConflict`, `namespace`, and per-call `driver` overrides.\r\n   */\r\n  public async set(key: CacheKey, value: any, ttlOrOptions?: CacheTtl | CacheSetOptions) {\r\n    this.ensureDriverInitialized();\r\n\r\n    const driverOverride =\r\n      ttlOrOptions && typeof ttlOrOptions === \"object\" && \"driver\" in ttlOrOptions\r\n        ? ttlOrOptions.driver\r\n        : undefined;\r\n\r\n    if (driverOverride) {\r\n      const driver = await this.load(driverOverride);\r\n      return this.timed(() => driver.set(key, value, ttlOrOptions), driver.name);\r\n    }\r\n\r\n    return this.timed(() => this.currentDriver!.set(key, value, ttlOrOptions));\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async remove(key: CacheKey) {\r\n    this.ensureDriverInitialized();\r\n    return this.timed(() => this.currentDriver!.remove(key));\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async removeNamespace(namespace: string) {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.removeNamespace(namespace);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async flush() {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.flush();\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async connect() {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.connect();\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public parseKey(key: CacheKey) {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.parseKey(key);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public get options() {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.options;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public setOptions(options: Record<string, any>) {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.setOptions(options || {});\r\n  }\r\n\r\n  /**\r\n   * Return the loaded driver instance for `driverName`, loading it on first\r\n   * call. Optional `runtimeOptions` follow the same merge-over-config rules\r\n   * as {@link load}; passing options after the driver has already been\r\n   * loaded throws to avoid silent swallowing.\r\n   */\r\n  public async driver(driverName: string, runtimeOptions?: Record<string, any>) {\r\n    if (this.loadedDrivers[driverName]) {\r\n      this.assertNoConflictingReload(driverName, runtimeOptions);\r\n\r\n      return this.loadedDrivers[driverName];\r\n    }\r\n\r\n    return this.load(driverName, runtimeOptions);\r\n  }\r\n\r\n  /**\r\n   * Initialize the cache manager and pick the default driver\r\n   */\r\n  public async init() {\r\n    const defaultCacheDriverName = this.configurations.default;\r\n\r\n    if (!defaultCacheDriverName) {\r\n      return;\r\n    }\r\n\r\n    const driver = await this.driver(defaultCacheDriverName);\r\n\r\n    await this.use(driver);\r\n  }\r\n\r\n  /**\r\n   * Load and connect the registered driver named `driver`. First-call wins —\r\n   * subsequent calls without `runtimeOptions` return the cached instance, and\r\n   * subsequent calls *with* `runtimeOptions` throw {@link CacheConfigurationError}\r\n   * to avoid silently dropping the new options.\r\n   *\r\n   * `runtimeOptions` merge over `config.options[driver]` per-key (runtime wins),\r\n   * letting consumers split static knobs (table, ttl, globalPrefix) from\r\n   * constructor-only ones (pg's `client`, custom adapters, etc.).\r\n   *\r\n   * @example\r\n   * const pool = new Pool({ connectionString });\r\n   * const pg = await cache.load(\"pg\", { client: pool });\r\n   */\r\n  public async load(driver: string, runtimeOptions?: Record<string, any>) {\r\n    if (this.loadedDrivers[driver]) {\r\n      this.assertNoConflictingReload(driver, runtimeOptions);\r\n\r\n      return this.loadedDrivers[driver];\r\n    }\r\n\r\n    const Driver = this.configurations.drivers[\r\n      driver as keyof typeof this.configurations.drivers\r\n    ] as DriverClass | undefined;\r\n\r\n    if (!Driver) {\r\n      throw new CacheConfigurationError(\r\n        `Cache driver ${driver} is not found, please declare it in the cache drivers in the configurations list.`,\r\n      );\r\n    }\r\n\r\n    const driverInstance = new Driver();\r\n    const configOptions =\r\n      this.configurations.options[driver as keyof typeof this.configurations.options] || {};\r\n\r\n    driverInstance.setOptions({ ...configOptions, ...(runtimeOptions ?? {}) });\r\n\r\n    await driverInstance.connect();\r\n\r\n    this.attachGlobalListeners(driverInstance);\r\n\r\n    this.loadedDrivers[driver] = driverInstance;\r\n\r\n    return driverInstance as CacheDriver<any, any>;\r\n  }\r\n\r\n  /**\r\n   * Guard against silently dropping runtime options on a re-load. Once a\r\n   * driver has been instantiated, its options are frozen — calling `load` /\r\n   * `driver` / `use` again with a non-empty `runtimeOptions` would otherwise\r\n   * appear to work but actually use the original options. We throw instead\r\n   * so the misuse surfaces at the call site.\r\n   */\r\n  protected assertNoConflictingReload(\r\n    driverName: string,\r\n    runtimeOptions: Record<string, any> | undefined,\r\n  ): void {\r\n    if (runtimeOptions === undefined) {\r\n      return;\r\n    }\r\n\r\n    if (Object.keys(runtimeOptions).length === 0) {\r\n      return;\r\n    }\r\n\r\n    throw new CacheConfigurationError(\r\n      `Cache driver '${driverName}' is already loaded; runtime options on subsequent calls are ignored — register a second driver name if you need a different configuration.`,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Register and bind a driver\r\n   */\r\n  public registerDriver(driverName: string, driverClass: DriverClass) {\r\n    (this.configurations.drivers as Record<string, DriverClass>)[driverName] = driverClass;\r\n  }\r\n\r\n  /**\r\n   * Disconnect the cache manager\r\n   */\r\n  public async disconnect() {\r\n    if (this.currentDriver) {\r\n      await this.currentDriver.disconnect();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async has(key: CacheKey): Promise<boolean> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.has(key);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async remember<T = any>(\r\n    key: CacheKey,\r\n    ttlOrOptions: CacheTtl | RememberOptions,\r\n    callback: () => Promise<T>,\r\n  ): Promise<T> {\r\n    this.ensureDriverInitialized();\r\n\r\n    const driverOverride =\r\n      ttlOrOptions && typeof ttlOrOptions === \"object\" && \"driver\" in ttlOrOptions\r\n        ? ttlOrOptions.driver\r\n        : undefined;\r\n\r\n    if (driverOverride) {\r\n      const driver = await this.load(driverOverride);\r\n      return driver.remember(key, ttlOrOptions, callback);\r\n    }\r\n\r\n    return this.currentDriver!.remember(key, ttlOrOptions, callback);\r\n  }\r\n\r\n  /**\r\n   * Stale-while-revalidate. Returns cached when fresh, returns the stale\r\n   * value plus a background refresh when within `freshTtl..staleTtl`,\r\n   * blocks like a normal miss past `staleTtl`. Honors per-call `driver`\r\n   * override the same way `remember()` does.\r\n   *\r\n   * @example\r\n   * const product = await cache.swr(\r\n   *   \"product.42\",\r\n   *   { freshTtl: \"1m\", staleTtl: \"1h\" },\r\n   *   () => db.products.find(42),\r\n   * );\r\n   */\r\n  public async swr<T = any>(\r\n    key: CacheKey,\r\n    options: CacheSwrOptions,\r\n    callback: () => Promise<T>,\r\n  ): Promise<T> {\r\n    this.ensureDriverInitialized();\r\n\r\n    const driverOverride = options.driver;\r\n\r\n    if (driverOverride) {\r\n      const driver = await this.load(driverOverride);\r\n\r\n      return driver.swr<T>(key, options, callback);\r\n    }\r\n\r\n    return this.currentDriver!.swr<T>(key, options, callback);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async pull(key: CacheKey): Promise<any | null> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.pull(key);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async forever(key: CacheKey, value: any): Promise<any> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.forever(key, value);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async increment(key: CacheKey, value?: number): Promise<number> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.increment(key, value);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async decrement(key: CacheKey, value?: number): Promise<number> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.decrement(key, value);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async many(keys: CacheKey[]): Promise<any[]> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.many(keys);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async setMany(items: Record<string, any>, ttl?: number): Promise<void> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.setMany(items, ttl);\r\n  }\r\n\r\n  /**\r\n   * Register a global event listener (applies to all drivers)\r\n   */\r\n  public on(event: CacheEventType, handler: CacheEventHandler): this {\r\n    if (!this.globalEventListeners.has(event)) {\r\n      this.globalEventListeners.set(event, new Set());\r\n    }\r\n    this.globalEventListeners.get(event)!.add(handler);\r\n\r\n    // Also attach to current driver if exists\r\n    if (this.currentDriver) {\r\n      this.currentDriver.on(event, handler);\r\n    }\r\n\r\n    // Attach to all loaded drivers\r\n    for (const driver of Object.values(this.loadedDrivers)) {\r\n      driver.on(event, handler);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Remove a global event listener\r\n   */\r\n  public off(event: CacheEventType, handler: CacheEventHandler): this {\r\n    const handlers = this.globalEventListeners.get(event);\r\n    if (handlers) {\r\n      handlers.delete(handler);\r\n    }\r\n\r\n    // Also remove from current driver\r\n    if (this.currentDriver) {\r\n      this.currentDriver.off(event, handler);\r\n    }\r\n\r\n    // Remove from all loaded drivers\r\n    for (const driver of Object.values(this.loadedDrivers)) {\r\n      driver.off(event, handler);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Register a one-time global event listener\r\n   */\r\n  public once(event: CacheEventType, handler: CacheEventHandler): this {\r\n    const onceHandler: CacheEventHandler = async (data) => {\r\n      await handler(data);\r\n      this.off(event, onceHandler);\r\n    };\r\n    return this.on(event, onceHandler);\r\n  }\r\n\r\n  /**\r\n   * Attach global listeners to a driver\r\n   */\r\n  protected attachGlobalListeners(driver: CacheDriver<any, any>) {\r\n    for (const [event, handlers] of this.globalEventListeners) {\r\n      for (const handler of handlers) {\r\n        driver.on(event, handler);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Set if not exists (atomic operation)\r\n   * Returns true if key was set, false if key already existed\r\n   * Note: Only supported by drivers that implement setNX (e.g., Redis)\r\n   */\r\n  public async setNX(key: CacheKey, value: any, ttl?: number): Promise<boolean> {\r\n    this.ensureDriverInitialized();\r\n\r\n    if (!this.currentDriver!.setNX) {\r\n      throw new Error(\r\n        `setNX is not supported by the current cache driver: ${this.currentDriver!.name}`,\r\n      );\r\n    }\r\n\r\n    return this.currentDriver!.setNX(key, value, ttl);\r\n  }\r\n\r\n  /**\r\n   * Create a tagged cache instance for the given tags\r\n   */\r\n  public tags(tags: string[]): TaggedCacheDriver {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.tags(tags);\r\n  }\r\n\r\n  /**\r\n   * Atomically read, transform, and write a cached value. Delegates to the current driver.\r\n   */\r\n  public async update<T = any>(\r\n    key: CacheKey,\r\n    fn: (current: T | null) => T | null | Promise<T | null>,\r\n    options?: { ttl?: CacheTtl },\r\n  ): Promise<T | null> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.update<T>(key, fn, options);\r\n  }\r\n\r\n  /**\r\n   * Shallow-merge a partial object into a cached value.\r\n   */\r\n  public async merge<T extends Record<string, any> = Record<string, any>>(\r\n    key: CacheKey,\r\n    partial: Partial<T>,\r\n    options?: { ttl?: CacheTtl },\r\n  ): Promise<T> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.merge<T>(key, partial, options);\r\n  }\r\n\r\n  /**\r\n   * Obtain a list accessor bound to the current driver.\r\n   */\r\n  public list<T = any>(key: CacheKey): CacheListAccessor<T> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.list<T>(key);\r\n  }\r\n\r\n  /**\r\n   * Acquire a distributed lock, run `fn`, and auto-release. Returns a\r\n   * {@link LockOutcome} discriminated union so callers can distinguish\r\n   * \"ran and got this value\" from \"skipped because someone else holds it\".\r\n   *\r\n   * Honors the `driver` option for per-call driver override, same as `set`\r\n   * and `remember`.\r\n   *\r\n   * @example\r\n   * const outcome = await cache.lock(\"lock.import\", \"5m\", async () => {\r\n   *   await runImport();\r\n   *   return \"done\";\r\n   * });\r\n   * if (!outcome.acquired) {\r\n   *   console.log(\"another worker is already importing\");\r\n   * }\r\n   */\r\n  public async lock<T>(\r\n    key: CacheKey,\r\n    ttlOrOptions: CacheTtl | LockOptions,\r\n    fn: () => Promise<T>,\r\n  ): Promise<LockOutcome<T>> {\r\n    this.ensureDriverInitialized();\r\n\r\n    const driverOverride =\r\n      ttlOrOptions && typeof ttlOrOptions === \"object\" && \"driver\" in ttlOrOptions\r\n        ? ttlOrOptions.driver\r\n        : undefined;\r\n\r\n    const driver = driverOverride\r\n      ? await this.load(driverOverride)\r\n      : this.currentDriver!;\r\n\r\n    return driver.lock<T>(key, ttlOrOptions as CacheTtl | Omit<LockOptions, \"driver\">, fn);\r\n  }\r\n\r\n  /**\r\n   * Similarity retrieval. Delegates to the current driver's `similar()` impl.\r\n   *\r\n   * Drivers that lack a similarity index throw {@link CacheUnsupportedError}.\r\n   *\r\n   * @example\r\n   * const hits = await cache.similar(await embed(query), { topK: 5, threshold: 0.7 });\r\n   */\r\n  /**\r\n   * Create a scoped view over the cache. Every key written through the\r\n   * returned scope is automatically prefixed with `prefix`; optional defaults\r\n   * (`ttl`, `tags`) flow through every write inside the scope.\r\n   *\r\n   * Per-call options always win over scope defaults. Scope tags merge\r\n   * additively with per-call tags. Nested scopes inherit from the parent.\r\n   *\r\n   * @example\r\n   * const chat = cache.namespace(\"chats.10\", { ttl: \"30d\" });\r\n   * await chat.set(\"messages.1\", msg);          // → \"chats.10.messages.1\", 30d\r\n   * await chat.set(\"draft\", d, { ttl: \"1h\" });  // per-call ttl wins\r\n   * await chat.namespace(\"typing\", { ttl: \"5s\" }).set(\"user.42\", true);\r\n   * await chat.clear();                          // wipe the whole scope\r\n   */\r\n  public namespace(prefix: string, options?: CacheNamespaceOptions): ScopedCacheContract {\r\n    this.ensureDriverInitialized();\r\n    return new ScopedCache(this, prefix, options);\r\n  }\r\n\r\n  public async similar<T = any>(\r\n    vector: number[],\r\n    options: CacheSimilarOptions,\r\n  ): Promise<CacheSimilarHit<T>[]> {\r\n    this.ensureDriverInitialized();\r\n    return this.currentDriver!.similar<T>(vector, options);\r\n  }\r\n}\r\n\r\nexport const cache = new CacheManager();\r\n"],"mappings":";;;;;AAyBA,IAAa,eAAb,MAA2D;;uBASK,CAAC;wBAKf;GAC9C,SAAS,CAAC;GACV,SAAS,CAAC;EACZ;8CAK8E,IAAI,IAAI;cAYxE;;;;;CAKd,IAAW,SAAS;EAClB,OAAO,KAAK,eAAe;CAC7B;;;;CAKA,AAAO,uBAAuB,gBAAqC;EACjE,KAAK,eAAe,UAAU,eAAe;EAC7C,KAAK,eAAe,UAAU,eAAe;EAC7C,KAAK,eAAe,UAAU,eAAe;EAC7C,KAAK,eAAe,UAAU,eAAe;CAC/C;;;;CAKA,AAAO,gBAAgB,cAAuB;EAC5C,KAAK,wBAAwB;EAE7B,KAAK,cAAe,gBAAgB,YAAY;CAClD;;;;;;;;;;;;;;;;;;;CAoBA,MAAa,IACX,QACA,gBACA;EACA,IAAI,OAAO,WAAW,UAAU;GAC9B,MAAM,iBAAiB,MAAM,KAAK,KAAK,QAAQ,cAAc;GAE7D,IAAI,CAAC,gBACH,MAAM,IAAI,wBACR,gBAAgB,OAAO,kFACzB;GAGF,SAAS;EACX;EAEA,KAAK,sBAAsB,MAAM;EAEjC,IAAI,KAAK,eAAe,YAAY,QAClC,OAAO,gBAAgB,KAAK,eAAe,OAAO;EAGpD,KAAK,gBAAgB;EAErB,OAAO;CACT;;;;CAKA,AAAU,0BAAgC;EACxC,IAAI,CAAC,KAAK,eACR,MAAM,IAAI,+BAA+B;CAE7C;;;;;;;;;;;CAYA,AAAO,UAAgC;EACrC,OAAO,KAAK,uBAAuB,CAAC,CAAC,SAAS;CAChD;;;;;CAMA,AAAO,eAAqB;EAC1B,KAAK,uBAAuB,CAAC,CAAC,MAAM;CACtC;;;;;;;CAQA,AAAU,yBAAgD;EACxD,IAAI,KAAK,kBACP,OAAO,KAAK;EAGd,MAAM,YAAY,IAAI,sBAAsB;EAE5C,KAAK,GAAG,QAAQ,SAAS,UAAU,YAAY,OAAO,IAAI,CAAC;EAC3D,KAAK,GAAG,SAAS,SAAS,UAAU,YAAY,QAAQ,IAAI,CAAC;EAC7D,KAAK,GAAG,QAAQ,SAAS,UAAU,YAAY,OAAO,IAAI,CAAC;EAC3D,KAAK,GAAG,YAAY,SAAS,UAAU,YAAY,WAAW,IAAI,CAAC;EACnE,KAAK,GAAG,UAAU,SAAS,UAAU,YAAY,SAAS,IAAI,CAAC;EAE/D,KAAK,mBAAmB;EAExB,OAAO;CACT;;;;;;;CAQA,MAAgB,MACd,MACA,YACY;EACZ,IAAI,CAAC,KAAK,kBACR,OAAO,KAAK;EAGd,MAAM,QAAQ,YAAY,IAAI;EAE9B,IAAI;GACF,OAAO,MAAM,KAAK;EACpB,UAAU;GACR,MAAM,UAAU,YAAY,IAAI,IAAI;GACpC,MAAM,OAAO,cAAc,KAAK,eAAe,QAAQ;GACvD,KAAK,iBAAiB,cAAc,MAAM,OAAO;EACnD;CACF;;;;CAKA,MAAa,IAAa,KAAkC;EAC1D,KAAK,wBAAwB;EAC7B,OAAO,KAAK,YAAY,KAAK,cAAe,IAAO,GAAG,CAAC;CACzD;;;;;;;;CASA,MAAa,IAAI,KAAe,OAAY,cAA2C;EACrF,KAAK,wBAAwB;EAE7B,MAAM,iBACJ,gBAAgB,OAAO,iBAAiB,YAAY,YAAY,eAC5D,aAAa,SACb;EAEN,IAAI,gBAAgB;GAClB,MAAM,SAAS,MAAM,KAAK,KAAK,cAAc;GAC7C,OAAO,KAAK,YAAY,OAAO,IAAI,KAAK,OAAO,YAAY,GAAG,OAAO,IAAI;EAC3E;EAEA,OAAO,KAAK,YAAY,KAAK,cAAe,IAAI,KAAK,OAAO,YAAY,CAAC;CAC3E;;;;CAKA,MAAa,OAAO,KAAe;EACjC,KAAK,wBAAwB;EAC7B,OAAO,KAAK,YAAY,KAAK,cAAe,OAAO,GAAG,CAAC;CACzD;;;;CAKA,MAAa,gBAAgB,WAAmB;EAC9C,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,gBAAgB,SAAS;CACtD;;;;CAKA,MAAa,QAAQ;EACnB,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,MAAM;CACnC;;;;CAKA,MAAa,UAAU;EACrB,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,QAAQ;CACrC;;;;CAKA,AAAO,SAAS,KAAe;EAC7B,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,SAAS,GAAG;CACzC;;;;CAKA,IAAW,UAAU;EACnB,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe;CAC7B;;;;CAKA,AAAO,WAAW,SAA8B;EAC9C,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,WAAW,WAAW,CAAC,CAAC;CACrD;;;;;;;CAQA,MAAa,OAAO,YAAoB,gBAAsC;EAC5E,IAAI,KAAK,cAAc,aAAa;GAClC,KAAK,0BAA0B,YAAY,cAAc;GAEzD,OAAO,KAAK,cAAc;EAC5B;EAEA,OAAO,KAAK,KAAK,YAAY,cAAc;CAC7C;;;;CAKA,MAAa,OAAO;EAClB,MAAM,yBAAyB,KAAK,eAAe;EAEnD,IAAI,CAAC,wBACH;EAGF,MAAM,SAAS,MAAM,KAAK,OAAO,sBAAsB;EAEvD,MAAM,KAAK,IAAI,MAAM;CACvB;;;;;;;;;;;;;;;CAgBA,MAAa,KAAK,QAAgB,gBAAsC;EACtE,IAAI,KAAK,cAAc,SAAS;GAC9B,KAAK,0BAA0B,QAAQ,cAAc;GAErD,OAAO,KAAK,cAAc;EAC5B;EAEA,MAAM,SAAS,KAAK,eAAe,QACjC;EAGF,IAAI,CAAC,QACH,MAAM,IAAI,wBACR,gBAAgB,OAAO,kFACzB;EAGF,MAAM,iBAAiB,IAAI,OAAO;EAClC,MAAM,gBACJ,KAAK,eAAe,QAAQ,WAAuD,CAAC;EAEtF,eAAe,WAAW;GAAE,GAAG;GAAe,GAAI,kBAAkB,CAAC;EAAG,CAAC;EAEzE,MAAM,eAAe,QAAQ;EAE7B,KAAK,sBAAsB,cAAc;EAEzC,KAAK,cAAc,UAAU;EAE7B,OAAO;CACT;;;;;;;;CASA,AAAU,0BACR,YACA,gBACM;EACN,IAAI,mBAAmB,QACrB;EAGF,IAAI,OAAO,KAAK,cAAc,CAAC,CAAC,WAAW,GACzC;EAGF,MAAM,IAAI,wBACR,iBAAiB,WAAW,4IAC9B;CACF;;;;CAKA,AAAO,eAAe,YAAoB,aAA0B;EAClE,AAAC,KAAK,eAAe,QAAwC,cAAc;CAC7E;;;;CAKA,MAAa,aAAa;EACxB,IAAI,KAAK,eACP,MAAM,KAAK,cAAc,WAAW;CAExC;;;;CAKA,MAAa,IAAI,KAAiC;EAChD,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,IAAI,GAAG;CACpC;;;;CAKA,MAAa,SACX,KACA,cACA,UACY;EACZ,KAAK,wBAAwB;EAE7B,MAAM,iBACJ,gBAAgB,OAAO,iBAAiB,YAAY,YAAY,eAC5D,aAAa,SACb;EAEN,IAAI,gBAEF,QAAO,MADc,KAAK,KAAK,cAAc,EAChC,CAAC,SAAS,KAAK,cAAc,QAAQ;EAGpD,OAAO,KAAK,cAAe,SAAS,KAAK,cAAc,QAAQ;CACjE;;;;;;;;;;;;;;CAeA,MAAa,IACX,KACA,SACA,UACY;EACZ,KAAK,wBAAwB;EAE7B,MAAM,iBAAiB,QAAQ;EAE/B,IAAI,gBAGF,QAAO,MAFc,KAAK,KAAK,cAAc,EAEhC,CAAC,IAAO,KAAK,SAAS,QAAQ;EAG7C,OAAO,KAAK,cAAe,IAAO,KAAK,SAAS,QAAQ;CAC1D;;;;CAKA,MAAa,KAAK,KAAoC;EACpD,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,KAAK,GAAG;CACrC;;;;CAKA,MAAa,QAAQ,KAAe,OAA0B;EAC5D,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,QAAQ,KAAK,KAAK;CAC/C;;;;CAKA,MAAa,UAAU,KAAe,OAAiC;EACrE,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,UAAU,KAAK,KAAK;CACjD;;;;CAKA,MAAa,UAAU,KAAe,OAAiC;EACrE,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,UAAU,KAAK,KAAK;CACjD;;;;CAKA,MAAa,KAAK,MAAkC;EAClD,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,KAAK,IAAI;CACtC;;;;CAKA,MAAa,QAAQ,OAA4B,KAA6B;EAC5E,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,QAAQ,OAAO,GAAG;CAC/C;;;;CAKA,AAAO,GAAG,OAAuB,SAAkC;EACjE,IAAI,CAAC,KAAK,qBAAqB,IAAI,KAAK,GACtC,KAAK,qBAAqB,IAAI,uBAAO,IAAI,IAAI,CAAC;EAEhD,KAAK,qBAAqB,IAAI,KAAK,CAAC,CAAE,IAAI,OAAO;EAGjD,IAAI,KAAK,eACP,KAAK,cAAc,GAAG,OAAO,OAAO;EAItC,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,aAAa,GACnD,OAAO,GAAG,OAAO,OAAO;EAG1B,OAAO;CACT;;;;CAKA,AAAO,IAAI,OAAuB,SAAkC;EAClE,MAAM,WAAW,KAAK,qBAAqB,IAAI,KAAK;EACpD,IAAI,UACF,SAAS,OAAO,OAAO;EAIzB,IAAI,KAAK,eACP,KAAK,cAAc,IAAI,OAAO,OAAO;EAIvC,KAAK,MAAM,UAAU,OAAO,OAAO,KAAK,aAAa,GACnD,OAAO,IAAI,OAAO,OAAO;EAG3B,OAAO;CACT;;;;CAKA,AAAO,KAAK,OAAuB,SAAkC;EACnE,MAAM,cAAiC,OAAO,SAAS;GACrD,MAAM,QAAQ,IAAI;GAClB,KAAK,IAAI,OAAO,WAAW;EAC7B;EACA,OAAO,KAAK,GAAG,OAAO,WAAW;CACnC;;;;CAKA,AAAU,sBAAsB,QAA+B;EAC7D,KAAK,MAAM,CAAC,OAAO,aAAa,KAAK,sBACnC,KAAK,MAAM,WAAW,UACpB,OAAO,GAAG,OAAO,OAAO;CAG9B;;;;;;CAOA,MAAa,MAAM,KAAe,OAAY,KAAgC;EAC5E,KAAK,wBAAwB;EAE7B,IAAI,CAAC,KAAK,cAAe,OACvB,MAAM,IAAI,MACR,uDAAuD,KAAK,cAAe,MAC7E;EAGF,OAAO,KAAK,cAAe,MAAM,KAAK,OAAO,GAAG;CAClD;;;;CAKA,AAAO,KAAK,MAAmC;EAC7C,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,KAAK,IAAI;CACtC;;;;CAKA,MAAa,OACX,KACA,IACA,SACmB;EACnB,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,OAAU,KAAK,IAAI,OAAO;CACvD;;;;CAKA,MAAa,MACX,KACA,SACA,SACY;EACZ,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,MAAS,KAAK,SAAS,OAAO;CAC3D;;;;CAKA,AAAO,KAAc,KAAqC;EACxD,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,KAAQ,GAAG;CACxC;;;;;;;;;;;;;;;;;;CAmBA,MAAa,KACX,KACA,cACA,IACyB;EACzB,KAAK,wBAAwB;EAE7B,MAAM,iBACJ,gBAAgB,OAAO,iBAAiB,YAAY,YAAY,eAC5D,aAAa,SACb;EAMN,QAJe,iBACX,MAAM,KAAK,KAAK,cAAc,IAC9B,KAAK,cAEI,CAAC,KAAQ,KAAK,cAAwD,EAAE;CACvF;;;;;;;;;;;;;;;;;;;;;;;;CAyBA,AAAO,UAAU,QAAgB,SAAsD;EACrF,KAAK,wBAAwB;EAC7B,OAAO,IAAI,YAAY,MAAM,QAAQ,OAAO;CAC9C;CAEA,MAAa,QACX,QACA,SAC+B;EAC/B,KAAK,wBAAwB;EAC7B,OAAO,KAAK,cAAe,QAAW,QAAQ,OAAO;CACvD;AACF;AAEA,MAAa,QAAQ,IAAI,aAAa"}

package/esm/cached/auto-key.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"auto-key.mjs","names":[],"sources":["../../../../../../../cache/src/cached/auto-key.ts"],"sourcesContent":["import { CacheConfigurationError } from \"../types\";\n\n/**\n * Derive a cache key from a prefix and a set of function arguments.\n *\n * Rules (in order of precedence):\n * 1. No args → prefix alone.\n * 2. All primitives (`string`, `number`, `boolean`) or `null` / `undefined` /\n *    `bigint` → joined onto the prefix with dots.\n * 3. Any non-primitive arg present → the full args array is `JSON.stringify`-ed\n *    and appended to the prefix.\n * 4. Serialization throws (circular refs, `BigInt` nested in an object) → we\n *    re-throw as `CacheConfigurationError` so the caller sees a cache-scoped\n *    error rather than a cryptic `TypeError`.\n *\n * @example\n * deriveAutoKey(\"user\", [42]);                         // \"user.42\"\n * deriveAutoKey(\"orders\", [42, \"abc\"]);                // \"orders.42.abc\"\n * deriveAutoKey(\"featured\", []);                       // \"featured\"\n * deriveAutoKey(\"search\", [{ q: \"hello\" }]);           // \"search.[{\\\"q\\\":\\\"hello\\\"}]\"\n * deriveAutoKey(\"user\", [null, undefined]);            // \"user.null.undefined\"\n */\nexport function deriveAutoKey(prefix: string, args: readonly unknown[]): string {\n  if (args.length === 0) {\n    return prefix;\n  }\n\n  if (args.every(isPrimitiveOrNullish)) {\n    return prefix + \".\" + args.map(serializePrimitive).join(\".\");\n  }\n\n  try {\n    return prefix + \".\" + JSON.stringify(args);\n  } catch (error) {\n    throw new CacheConfigurationError(\n      `cached(): could not derive an auto-key from args for prefix \"${prefix}\". ` +\n        `The args include a value that is not JSON-serializable (circular reference, ` +\n        `BigInt nested inside an object, or similar). Use the options form with a custom ` +\n        `key function. Original error: ${(error as Error).message}`,\n    );\n  }\n}\n\n/**\n * Primitives and nullish values can be concatenated directly onto a key without\n * JSON serialization. Adding `bigint` here avoids the `JSON.stringify` throw on\n * top-level bigint args.\n */\nfunction isPrimitiveOrNullish(value: unknown): boolean {\n  if (value === null || value === undefined) {\n    return true;\n  }\n\n  const type = typeof value;\n  return type === \"string\" || type === \"number\" || type === \"boolean\" || type === \"bigint\";\n}\n\n/**\n * Serialize a single primitive or nullish value to its string key-segment form.\n */\nfunction serializePrimitive(value: unknown): string {\n  if (value === null) return \"null\";\n  if (value === undefined) return \"undefined\";\n  if (typeof value === \"bigint\") return value.toString();\n  return String(value);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,cAAc,QAAgB,MAAkC;CAC9E,IAAI,KAAK,WAAW,GAClB,OAAO;CAGT,IAAI,KAAK,MAAM,oBAAoB,GACjC,OAAO,SAAS,MAAM,KAAK,IAAI,kBAAkB,EAAE,KAAK,GAAG;CAG7D,IAAI;EACF,OAAO,SAAS,MAAM,KAAK,UAAU,IAAI;CAC3C,SAAS,OAAO;EACd,MAAM,IAAI,wBACR,gEAAgE,OAAO,+LAGnC,MAAgB,SACtD;CACF;AACF;;;;;;AAOA,SAAS,qBAAqB,OAAyB;CACrD,IAAI,UAAU,QAAQ,UAAU,QAC9B,OAAO;CAGT,MAAM,OAAO,OAAO;CACpB,OAAO,SAAS,YAAY,SAAS,YAAY,SAAS,aAAa,SAAS;AAClF;;;;AAKA,SAAS,mBAAmB,OAAwB;CAClD,IAAI,UAAU,MAAM,OAAO;CAC3B,IAAI,UAAU,QAAW,OAAO;CAChC,IAAI,OAAO,UAAU,UAAU,OAAO,MAAM,SAAS;CACrD,OAAO,OAAO,KAAK;AACrB"}
+{"version":3,"file":"auto-key.mjs","names":[],"sources":["../../../../../../../cache/src/cached/auto-key.ts"],"sourcesContent":["import { CacheConfigurationError } from \"../types\";\n\n/**\n * Derive a cache key from a prefix and a set of function arguments.\n *\n * Rules (in order of precedence):\n * 1. No args → prefix alone.\n * 2. All primitives (`string`, `number`, `boolean`) or `null` / `undefined` /\n *    `bigint` → joined onto the prefix with dots.\n * 3. Any non-primitive arg present → the full args array is `JSON.stringify`-ed\n *    and appended to the prefix.\n * 4. Serialization throws (circular refs, `BigInt` nested in an object) → we\n *    re-throw as `CacheConfigurationError` so the caller sees a cache-scoped\n *    error rather than a cryptic `TypeError`.\n *\n * @example\n * deriveAutoKey(\"user\", [42]);                         // \"user.42\"\n * deriveAutoKey(\"orders\", [42, \"abc\"]);                // \"orders.42.abc\"\n * deriveAutoKey(\"featured\", []);                       // \"featured\"\n * deriveAutoKey(\"search\", [{ q: \"hello\" }]);           // \"search.[{\\\"q\\\":\\\"hello\\\"}]\"\n * deriveAutoKey(\"user\", [null, undefined]);            // \"user.null.undefined\"\n */\nexport function deriveAutoKey(prefix: string, args: readonly unknown[]): string {\n  if (args.length === 0) {\n    return prefix;\n  }\n\n  if (args.every(isPrimitiveOrNullish)) {\n    return prefix + \".\" + args.map(serializePrimitive).join(\".\");\n  }\n\n  try {\n    return prefix + \".\" + JSON.stringify(args);\n  } catch (error) {\n    throw new CacheConfigurationError(\n      `cached(): could not derive an auto-key from args for prefix \"${prefix}\". ` +\n        `The args include a value that is not JSON-serializable (circular reference, ` +\n        `BigInt nested inside an object, or similar). Use the options form with a custom ` +\n        `key function. Original error: ${(error as Error).message}`,\n    );\n  }\n}\n\n/**\n * Primitives and nullish values can be concatenated directly onto a key without\n * JSON serialization. Adding `bigint` here avoids the `JSON.stringify` throw on\n * top-level bigint args.\n */\nfunction isPrimitiveOrNullish(value: unknown): boolean {\n  if (value === null || value === undefined) {\n    return true;\n  }\n\n  const type = typeof value;\n  return type === \"string\" || type === \"number\" || type === \"boolean\" || type === \"bigint\";\n}\n\n/**\n * Serialize a single primitive or nullish value to its string key-segment form.\n */\nfunction serializePrimitive(value: unknown): string {\n  if (value === null) return \"null\";\n  if (value === undefined) return \"undefined\";\n  if (typeof value === \"bigint\") return value.toString();\n  return String(value);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,cAAc,QAAgB,MAAkC;CAC9E,IAAI,KAAK,WAAW,GAClB,OAAO;CAGT,IAAI,KAAK,MAAM,oBAAoB,GACjC,OAAO,SAAS,MAAM,KAAK,IAAI,kBAAkB,CAAC,CAAC,KAAK,GAAG;CAG7D,IAAI;EACF,OAAO,SAAS,MAAM,KAAK,UAAU,IAAI;CAC3C,SAAS,OAAO;EACd,MAAM,IAAI,wBACR,gEAAgE,OAAO,+LAGnC,MAAgB,SACtD;CACF;AACF;;;;;;AAOA,SAAS,qBAAqB,OAAyB;CACrD,IAAI,UAAU,QAAQ,UAAU,QAC9B,OAAO;CAGT,MAAM,OAAO,OAAO;CACpB,OAAO,SAAS,YAAY,SAAS,YAAY,SAAS,aAAa,SAAS;AAClF;;;;AAKA,SAAS,mBAAmB,OAAwB;CAClD,IAAI,UAAU,MAAM,OAAO;CAC3B,IAAI,UAAU,QAAW,OAAO;CAChC,IAAI,OAAO,UAAU,UAAU,OAAO,MAAM,SAAS;CACrD,OAAO,OAAO,KAAK;AACrB"}

package/esm/cached/cached.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cached.d.mts","names":[],"sources":["../../../../../../../cache/src/cached/cached.ts"],"mappings":";;;;;;AASA;;KAAY,QAAA,mCAA2C,IAAA,EAAM,IAAA,KAAS,OAAA,CAAQ,CAAA;EAAjB;;;;;;;EAQ3D,UAAA,IAAc,IAAA,EAAM,IAAA,GAAO,OAAA;AAAA;;;;;;;;;;AAAO;AAiCpC;;;;;;;;;;;;;;;;;;;;iBAAgB,MAAA,2BAAA,CACd,EAAA,MAAQ,IAAA,EAAM,IAAA,KAAS,OAAA,CAAQ,CAAA,GAC/B,MAAA,WACC,QAAA,CAAS,IAAA,EAAM,CAAA;AAAA,iBACF,MAAA,2BAAA,CACd,EAAA,MAAQ,IAAA,EAAM,IAAA,KAAS,OAAA,CAAQ,CAAA,GAC/B,MAAA,UACA,GAAA,EAAK,QAAA,GACJ,QAAA,CAAS,IAAA,EAAM,CAAA;AAAA,iBACF,MAAA,2BAAA,CACd,EAAA,MAAQ,IAAA,EAAM,IAAA,KAAS,OAAA,CAAQ,CAAA,GAC/B,OAAA,EAAS,aAAA,CAAc,IAAA,IACtB,QAAA,CAAS,IAAA,EAAM,CAAA"}
+{"version":3,"file":"cached.d.mts","names":[],"sources":["../../../../../../../cache/src/cached/cached.ts"],"mappings":";;;;;;AASA;;KAAY,QAAA,mCAA2C,IAAA,EAAM,IAAA,KAAS,OAAA,CAAQ,CAAA;EAAjB;;;;;;;EAQ3D,UAAA,IAAc,IAAA,EAAM,IAAA,GAAO,OAAA;AAAA;;;;;;;;;;AAAO;AAiCpC;;;;;;;;;;;;;;;;;;;;iBAAgB,MAAA,4BACd,EAAA,MAAQ,IAAA,EAAM,IAAA,KAAS,OAAA,CAAQ,CAAA,GAC/B,MAAA,WACC,QAAA,CAAS,IAAA,EAAM,CAAA;AAAA,iBACF,MAAA,4BACd,EAAA,MAAQ,IAAA,EAAM,IAAA,KAAS,OAAA,CAAQ,CAAA,GAC/B,MAAA,UACA,GAAA,EAAK,QAAA,GACJ,QAAA,CAAS,IAAA,EAAM,CAAA;AAAA,iBACF,MAAA,4BACd,EAAA,MAAQ,IAAA,EAAM,IAAA,KAAS,OAAA,CAAQ,CAAA,GAC/B,OAAA,EAAS,aAAA,CAAc,IAAA,IACtB,QAAA,CAAS,IAAA,EAAM,CAAA"}

package/esm/cached/normalize-args.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-args.d.mts","names":[],"sources":["../../../../../../../cache/src/cached/normalize-args.ts"],"mappings":";;;;;AASA;;;;KAAY,aAAA;EAMV;;;;;EAAA,GAAA,MAAS,IAAA,EAAM,IAAA;EAcf;;AAAM;EAVN,GAAA,GAAM,QAAQ;EAmBkB;;;;EAdhC,IAAA;EAeS;;;;EAVT,MAAA;AAAA;;AAaM;AAOR;;;;KAXY,sBAAA;EACV,GAAA,MAAS,IAAA,EAAM,IAAA;EACf,GAAA,GAAM,QAAQ;EACd,IAAA;EACA,MAAA;AAAA;;;;;iBAOc,mBAAA,wBAAA,CACd,eAAA,WAA0B,aAAA,CAAc,IAAA,GACxC,QAAA,GAAW,QAAA,GACV,sBAAA,CAAuB,IAAA"}
+{"version":3,"file":"normalize-args.d.mts","names":[],"sources":["../../../../../../../cache/src/cached/normalize-args.ts"],"mappings":";;;;;AASA;;;;KAAY,aAAA;EAMV;;;;;EAAA,GAAA,MAAS,IAAA,EAAM,IAAA;EAcf;;AAAM;EAVN,GAAA,GAAM,QAAQ;EAmBkB;;;;EAdhC,IAAA;EAeS;;;;EAVT,MAAA;AAAA;;AAaM;AAOR;;;;KAXY,sBAAA;EACV,GAAA,MAAS,IAAA,EAAM,IAAA;EACf,GAAA,GAAM,QAAQ;EACd,IAAA;EACA,MAAA;AAAA;;;;;iBAOc,mBAAA,yBACd,eAAA,WAA0B,aAAA,CAAc,IAAA,GACxC,QAAA,GAAW,QAAA,GACV,sBAAA,CAAuB,IAAA"}

package/esm/drivers/base-cache-driver.d.mts.map

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

package/esm/drivers/base-cache-driver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"base-cache-driver.mjs","names":[],"sources":["../../../../../../../cache/src/drivers/base-cache-driver.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\r\nimport { MemoryCacheList } from \"../list/memory-cache-list\";\r\nimport { TaggedCache } from \"../tagged-cache\";\r\nimport type {\r\n  CacheConflictPolicy,\r\n  CacheData,\r\n  CacheDriver,\r\n  CacheEventData,\r\n  CacheEventHandler,\r\n  CacheEventType,\r\n  CacheKey,\r\n  CacheListAccessor,\r\n  CacheOperationType,\r\n  CacheSetOptions,\r\n  CacheSetResult,\r\n  CacheSimilarHit,\r\n  CacheSimilarOptions,\r\n  CacheSwrOptions,\r\n  CacheTtl,\r\n  LockOptions,\r\n  LockOutcome,\r\n  RememberOptions,\r\n} from \"../types\";\r\nimport { CacheUnsupportedError } from \"../types\";\r\nimport {\r\n  normalizeToOptions,\r\n  parseCacheKey,\r\n  parseTtl,\r\n  resolveTtl,\r\n  safeErrorInfo,\r\n} from \"../utils\";\r\n\r\n/**\r\n * Normalized form of the 3rd `set` argument.\r\n *\r\n * All drivers operate on this shape internally regardless of whether the caller\r\n * passed a positional TTL, a duration string, or a rich options object.\r\n */\r\nexport type NormalizedSetOptions = {\r\n  /**\r\n   * Final TTL in seconds — already merged with the driver-level default\r\n   * (`this.options.ttl`). `Infinity` means \"no expiration\".\r\n   *\r\n   * Always populated. Drivers do NOT need to fall back to `this.ttl`\r\n   * themselves — `resolveSetOptions` does the merge centrally so that\r\n   * every driver respects the configured default without ceremony.\r\n   */\r\n  ttl: number;\r\n  /**\r\n   * Inline tag list, or undefined when none were provided.\r\n   */\r\n  tags?: string[];\r\n  /**\r\n   * Conflict policy. Defaults to `\"upsert\"`.\r\n   */\r\n  onConflict: CacheConflictPolicy;\r\n  /**\r\n   * Optional embedding vector for similarity retrieval. Drivers that do not\r\n   * support similarity must throw {@link CacheUnsupportedError} when this is\r\n   * present (rather than silently dropping it).\r\n   */\r\n  vector?: number[];\r\n  /**\r\n   * Optional freshness deadline as a millisecond timestamp. Set by `swr()`\r\n   * to mark when the entry stops being \"fresh\" and becomes\r\n   * \"stale-but-revalidatable.\" Drivers route this through\r\n   * `prepareDataForStorage` so it persists in the wrapper.\r\n   */\r\n  staleAt?: number;\r\n};\r\n\r\nconst messages = {\r\n  clearing: \"Clearing namespace\",\r\n  cleared: \"Namespace cleared\",\r\n  fetching: \"Fetching key\",\r\n  fetched: \"Key fetched\",\r\n  caching: \"Caching key\",\r\n  cached: \"Key cached\",\r\n  flushing: \"Flushing cache\",\r\n  flushed: \"Cache flushed\",\r\n  removing: \"Removing key\",\r\n  removed: \"Key removed\",\r\n  expired: \"Key expired\",\r\n  notFound: \"Key not found\",\r\n  connecting: \"Connecting to the cache engine.\",\r\n  connected: \"Connected to the cache engine.\",\r\n  disconnecting: \"Disconnecting from the cache engine.\",\r\n  disconnected: \"Disconnected from the cache engine.\",\r\n  connectionFailed: \"Failed to connect to the cache engine.\",\r\n  error: \"Error occurred\",\r\n};\r\n\r\nexport abstract class BaseCacheDriver<\r\n  ClientType,\r\n  Options extends Record<string, any>,\r\n> implements CacheDriver<ClientType, Options> {\r\n  /**\r\n   * CLient driver\r\n   */\r\n  protected clientDriver!: ClientType;\r\n\r\n  /**\r\n   * Determine whether to log or not\r\n   */\r\n  protected shouldLog: boolean = true;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public get client() {\r\n    return (this.clientDriver || this) as unknown as ClientType;\r\n  }\r\n\r\n  /**\r\n   * Set logging state\r\n   */\r\n  public setLoggingState(shouldLog: boolean) {\r\n    this.shouldLog = shouldLog;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Set client driver\r\n   */\r\n  public set client(client: ClientType) {\r\n    this.clientDriver = client;\r\n  }\r\n\r\n  /**\r\n   * Get the cache driver name\r\n   */\r\n  public abstract name: string;\r\n\r\n  /**\r\n   * Options list\r\n   */\r\n  public options!: Options;\r\n\r\n  /**\r\n   * Event listeners storage\r\n   */\r\n  protected eventListeners: Map<CacheEventType, Set<CacheEventHandler>> =\r\n    new Map();\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public parseKey(key: CacheKey) {\r\n    return parseCacheKey(key, this.options);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public setOptions(options: Options) {\r\n    this.options = options || {};\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Register an event listener\r\n   */\r\n  public on(event: CacheEventType, handler: CacheEventHandler): this {\r\n    if (!this.eventListeners.has(event)) {\r\n      this.eventListeners.set(event, new Set());\r\n    }\r\n    this.eventListeners.get(event)!.add(handler);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Remove an event listener\r\n   */\r\n  public off(event: CacheEventType, handler: CacheEventHandler): this {\r\n    const handlers = this.eventListeners.get(event);\r\n    if (handlers) {\r\n      handlers.delete(handler);\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Register a one-time event listener\r\n   */\r\n  public once(event: CacheEventType, handler: CacheEventHandler): this {\r\n    const onceHandler: CacheEventHandler = async (data) => {\r\n      await handler(data);\r\n      this.off(event, onceHandler);\r\n    };\r\n    return this.on(event, onceHandler);\r\n  }\r\n\r\n  /**\r\n   * Emit an event to all registered listeners\r\n   */\r\n  protected async emit(\r\n    event: CacheEventType,\r\n    data: Partial<CacheEventData> = {},\r\n  ): Promise<void> {\r\n    const handlers = this.eventListeners.get(event);\r\n    if (!handlers || handlers.size === 0) return;\r\n\r\n    const eventData: CacheEventData = {\r\n      driver: this.name,\r\n      ...data,\r\n    };\r\n\r\n    // Execute all handlers\r\n    const promises: Promise<void>[] = [];\r\n    for (const handler of handlers) {\r\n      try {\r\n        const result = handler(eventData);\r\n        if (result instanceof Promise) {\r\n          promises.push(result);\r\n        }\r\n      } catch (error) {\r\n        this.logError(`Error in event handler for '${event}'`, error);\r\n      }\r\n    }\r\n\r\n    // Wait for all async handlers\r\n    if (promises.length > 0) {\r\n      await Promise.allSettled(promises);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract removeNamespace(namespace: string): Promise<any>;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract set(\r\n    key: CacheKey,\r\n    value: any,\r\n    ttlOrOptions?: CacheTtl | CacheSetOptions,\r\n  ): Promise<any>;\r\n\r\n  /**\r\n   * Normalize the 3rd argument of a `set` call into a single shape every driver\r\n   * can act on. Handles TTL parsing (number | string | Infinity), `expiresAt` →\r\n   * relative TTL conversion, and mutual-exclusion validation.\r\n   *\r\n   * @throws {CacheConfigurationError} when `ttl` and `expiresAt` are passed together\r\n   * or an unparseable duration string is supplied.\r\n   */\r\n  protected resolveSetOptions(\r\n    ttlOrOptions?: CacheTtl | CacheSetOptions,\r\n  ): NormalizedSetOptions {\r\n    const options = normalizeToOptions(ttlOrOptions);\r\n\r\n    return {\r\n      ttl: resolveTtl(options.ttl, options.expiresAt, this.ttl),\r\n      tags: options.tags,\r\n      onConflict: options.onConflict ?? \"upsert\",\r\n      vector: options.vector,\r\n      staleAt: options.staleAt,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Resolve the union of cache keys associated with any of the given tags.\r\n   * Used by `similar()` to narrow the candidate pool before similarity ranking.\r\n   *\r\n   * Returns `null` when no tags are passed (callers should treat that as \"no filter\").\r\n   */\r\n  protected async getKeysForTags(\r\n    tags: string[] | undefined,\r\n  ): Promise<Set<string> | null> {\r\n    if (!tags || tags.length === 0) {\r\n      return null;\r\n    }\r\n\r\n    const allKeys = new Set<string>();\r\n    for (const tag of tags) {\r\n      const tagKey = `cache:tags:${tag}`;\r\n      const keys = ((await this.get(tagKey)) as string[] | null) || [];\r\n      for (const k of keys) {\r\n        allKeys.add(k);\r\n      }\r\n    }\r\n\r\n    return allKeys;\r\n  }\r\n\r\n  /**\r\n   * Apply tag relationships after a successful write. Called by drivers once\r\n   * the value is in storage.\r\n   */\r\n  protected async applyTags(parsedKey: string, tags: string[]): Promise<void> {\r\n    if (tags.length === 0) {\r\n      return;\r\n    }\r\n\r\n    const tagged = this.tags(tags);\r\n    await (tagged as TaggedCache).storeTagRelationship(parsedKey);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract get(key: CacheKey): Promise<any>;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract remove(key: CacheKey): Promise<void>;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract flush(): Promise<void>;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async has(key: CacheKey): Promise<boolean> {\r\n    const value = await this.get(key);\r\n    // Event is emitted by get() method\r\n    return value !== null;\r\n  }\r\n\r\n  /**\r\n   * Lock storage for preventing cache stampede\r\n   */\r\n  protected locks: Map<string, Promise<any>> = new Map();\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async remember(\r\n    key: CacheKey,\r\n    ttlOrOptions: CacheTtl | RememberOptions,\r\n    callback: () => Promise<any>,\r\n  ): Promise<any> {\r\n    const parsedKey = this.parseKey(key);\r\n\r\n    // The options-form lets callers forward tags / driver-override through to\r\n    // the cache-miss write. Normalize both shapes into a single CacheSetOptions\r\n    // blob so there's one path from here on.\r\n    const setOptions = this.normalizeRememberOptions(ttlOrOptions);\r\n\r\n    const cachedValue = await this.get(key);\r\n    if (cachedValue) {\r\n      return cachedValue;\r\n    }\r\n\r\n    const existingLock = this.locks.get(parsedKey);\r\n    if (existingLock) {\r\n      return existingLock;\r\n    }\r\n\r\n    const promise = callback()\r\n      .then(async (result) => {\r\n        await this.set(key, result, setOptions);\r\n        this.locks.delete(parsedKey);\r\n        return result;\r\n      })\r\n      .catch((err) => {\r\n        this.locks.delete(parsedKey);\r\n        throw err;\r\n      });\r\n\r\n    this.locks.set(parsedKey, promise);\r\n    return promise;\r\n  }\r\n\r\n  /**\r\n   * Resolve the TTL-or-options arg of `remember` into a `CacheSetOptions` object\r\n   * that can be passed straight to `set()`. Keeps the implementation unbranched.\r\n   */\r\n  protected normalizeRememberOptions(\r\n    ttlOrOptions: CacheTtl | RememberOptions,\r\n  ): CacheSetOptions {\r\n    if (typeof ttlOrOptions === \"number\" || typeof ttlOrOptions === \"string\") {\r\n      return { ttl: ttlOrOptions };\r\n    }\r\n\r\n    return {\r\n      ttl: ttlOrOptions.ttl,\r\n      tags: ttlOrOptions.tags,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Default implementation: read raw entry, branch on freshness/staleness,\r\n   * trigger background refresh in the stale window, fall through to\r\n   * `callback` on miss/expiry. Concurrent stale-window callers share a\r\n   * single in-flight refresh via {@link locks}.\r\n   *\r\n   * Drivers without a real {@link getEntry} override degrade gracefully —\r\n   * the synthetic entry has no `staleAt`, which the freshness check treats\r\n   * as \"always fresh,\" so SWR behaves like a TTL-only cached read on those\r\n   * drivers (no background refresh, but no double-fetch either).\r\n   */\r\n  public async swr<T = any>(\r\n    key: CacheKey,\r\n    options: CacheSwrOptions,\r\n    callback: () => Promise<T>,\r\n  ): Promise<T> {\r\n    const parsedKey = this.parseKey(key);\r\n    const freshSeconds = parseTtl(options.freshTtl);\r\n    const staleSeconds = parseTtl(options.staleTtl);\r\n\r\n    if (staleSeconds <= freshSeconds) {\r\n      throw new Error(\r\n        `cache.swr: 'staleTtl' (${staleSeconds}s) must be greater than 'freshTtl' (${freshSeconds}s).`,\r\n      );\r\n    }\r\n\r\n    const entry = await this.getEntry(key);\r\n    const now = Date.now();\r\n\r\n    const isExpired = entry?.expiresAt !== undefined && entry.expiresAt <= now;\r\n\r\n    if (!entry || isExpired) {\r\n      return this.swrFetchAndStore<T>(\r\n        key,\r\n        options,\r\n        callback,\r\n        freshSeconds,\r\n        staleSeconds,\r\n      );\r\n    }\r\n\r\n    const isFresh = entry.staleAt === undefined || entry.staleAt > now;\r\n\r\n    if (isFresh) {\r\n      return entry.data as T;\r\n    }\r\n\r\n    this.scheduleSwrRefresh<T>(\r\n      parsedKey,\r\n      key,\r\n      options,\r\n      callback,\r\n      freshSeconds,\r\n      staleSeconds,\r\n    );\r\n\r\n    return entry.data as T;\r\n  }\r\n\r\n  /**\r\n   * Read the raw {@link CacheData} wrapper for a key, including any\r\n   * `expiresAt` / `staleAt` metadata. Default implementation falls back to\r\n   * `get()` and synthesizes a metadata-less wrapper — drivers that store\r\n   * the wrapper directly (memory, lru, file, redis, pg, mock) override\r\n   * this to return real metadata so SWR can branch on freshness.\r\n   */\r\n  protected async getEntry(key: CacheKey): Promise<CacheData | null> {\r\n    const value = await this.get(key);\r\n\r\n    if (value === null) {\r\n      return null;\r\n    }\r\n\r\n    return { data: value };\r\n  }\r\n\r\n  /**\r\n   * Remaining lifetime of an existing entry, in seconds — used by TTL-preserving\r\n   * writes such as `update()` / `merge()` when the caller passes no explicit\r\n   * `ttl`.\r\n   *\r\n   * - `Infinity` — the entry exists with no expiry (preserve \"never expires\").\r\n   * - positive number — seconds left before the entry expires.\r\n   * - `undefined` — the key is missing or already past its deadline; the caller\r\n   *   should fall back to the driver default TTL.\r\n   *\r\n   * Default reads `expiresAt` from {@link getEntry}, which the metadata-aware\r\n   * drivers (memory, lru, mock, pg) populate. Drivers that track TTL natively\r\n   * and don't carry `expiresAt` in their payload (Redis) override this.\r\n   */\r\n  protected async getRemainingTtl(key: CacheKey): Promise<number | undefined> {\r\n    const entry = await this.getEntry(key);\r\n\r\n    if (!entry) {\r\n      return undefined;\r\n    }\r\n\r\n    if (!entry.expiresAt || entry.expiresAt === Infinity) {\r\n      return Infinity;\r\n    }\r\n\r\n    const remainingSeconds = Math.ceil((entry.expiresAt - Date.now()) / 1000);\r\n\r\n    return remainingSeconds > 0 ? remainingSeconds : undefined;\r\n  }\r\n\r\n  /**\r\n   * Block-and-fetch path of `swr()`: invoked on miss or past-`staleTtl`\r\n   * expiry. Writes through `set()` with the SWR options translated into\r\n   * standard `CacheSetOptions` (ttl = staleTtl, staleAt = now + freshTtl).\r\n   */\r\n  protected async swrFetchAndStore<T>(\r\n    key: CacheKey,\r\n    options: CacheSwrOptions,\r\n    callback: () => Promise<T>,\r\n    freshSeconds: number,\r\n    staleSeconds: number,\r\n  ): Promise<T> {\r\n    const result = await callback();\r\n\r\n    await this.set(key, result, {\r\n      ttl: staleSeconds,\r\n      staleAt: Date.now() + freshSeconds * 1000,\r\n      tags: options.tags,\r\n    });\r\n\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Stale-window background refresh. Registers a single in-flight promise\r\n   * per parsed key so concurrent SWR callers share one refresh. Failed\r\n   * refreshes preserve the stale entry, log via `logError`, and emit on\r\n   * `error` — the stale-returning caller never sees the failure.\r\n   */\r\n  protected scheduleSwrRefresh<T>(\r\n    parsedKey: string,\r\n    key: CacheKey,\r\n    options: CacheSwrOptions,\r\n    callback: () => Promise<T>,\r\n    freshSeconds: number,\r\n    staleSeconds: number,\r\n  ): void {\r\n    if (this.locks.has(parsedKey)) {\r\n      return;\r\n    }\r\n\r\n    let refresh!: Promise<void>;\r\n    refresh = (async () => {\r\n      try {\r\n        const result = await callback();\r\n\r\n        await this.set(key, result, {\r\n          ttl: staleSeconds,\r\n          staleAt: Date.now() + freshSeconds * 1000,\r\n          tags: options.tags,\r\n        });\r\n      } catch (error) {\r\n        this.logError(`SWR background refresh failed for ${parsedKey}`, error);\r\n        await this.emit(\"error\", { key: parsedKey, error });\r\n      } finally {\r\n        if (this.locks.get(parsedKey) === refresh) {\r\n          this.locks.delete(parsedKey);\r\n        }\r\n      }\r\n    })();\r\n\r\n    this.locks.set(parsedKey, refresh);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async pull(key: CacheKey): Promise<any | null> {\r\n    const value = await this.get(key);\r\n    if (value !== null) {\r\n      await this.remove(key);\r\n    }\r\n    // Events are emitted by get() and remove() methods\r\n    return value;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async forever(key: CacheKey, value: any): Promise<any> {\r\n    // Event is emitted by set() method\r\n    return this.set(key, value, Infinity);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async increment(key: CacheKey, value: number = 1): Promise<number> {\r\n    const current = (await this.get(key)) || 0;\r\n\r\n    if (typeof current !== \"number\") {\r\n      throw new Error(\r\n        `Cannot increment non-numeric value for key: ${this.parseKey(key)}`,\r\n      );\r\n    }\r\n\r\n    const newValue = current + value;\r\n    await this.set(key, newValue);\r\n    return newValue;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async decrement(key: CacheKey, value: number = 1): Promise<number> {\r\n    return this.increment(key, -value);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async many(keys: CacheKey[]): Promise<any[]> {\r\n    return Promise.all(keys.map((key) => this.get(key)));\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async setMany(\r\n    items: Record<string, any>,\r\n    ttl?: number,\r\n  ): Promise<void> {\r\n    await Promise.all(\r\n      Object.entries(items).map(([key, value]) => this.set(key, value, ttl)),\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Log the operation\r\n   */\r\n  protected log(operation: CacheOperationType, key?: string | any) {\r\n    if (!this.shouldLog) return;\r\n\r\n    if (typeof key === \"string\") {\r\n      // this will be likely used with file cache driver as it will convert the dot to slash\r\n      // to make it consistent and not to confuse developers we will output the key by making sure it's a dot\r\n      key = key.replace(/\\//g, \".\");\r\n    }\r\n\r\n    if (operation === \"connectionFailed\") {\r\n      log.fatal(`cache.${this.name}`, operation, key);\r\n    }\r\n\r\n    if (operation == \"notFound\" || operation == \"expired\") {\r\n      return log.warn(\r\n        \"cache.\" + this.name,\r\n        operation,\r\n        (key ? key + \" \" : \"\") + messages[operation],\r\n      );\r\n    }\r\n\r\n    if (operation.endsWith(\"ed\")) {\r\n      return log.success(\r\n        \"cache.\" + this.name,\r\n        operation,\r\n        (key ? key + \" \" : \"\") + messages[operation],\r\n      );\r\n    }\r\n\r\n    log.info(\r\n      \"cache.\" + this.name,\r\n      operation,\r\n      (key ? key + \" \" : \"\") + messages[operation],\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Log error message\r\n   *\r\n   * Never logs the raw `error` object — driver connection errors (Redis,\r\n   * Postgres, ...) can carry the connection string, including the password,\r\n   * in the message/cause. Only a redacted `{ message, code }` shape is\r\n   * passed to the structured logger.\r\n   */\r\n  protected logError(message: string, error?: any) {\r\n    if (error) {\r\n      log.error(\"cache.\" + this.name, \"error\", message, safeErrorInfo(error));\r\n    } else {\r\n      log.error(\"cache.\" + this.name, \"error\", message);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get the default TTL in seconds. Parses human-readable strings (`\"1h\"`, `\"30m\"`)\r\n   * from driver options if present; falls back to `Infinity` when no default is set.\r\n   */\r\n  public get ttl() {\r\n    if (this.options.ttl === undefined) {\r\n      return Infinity;\r\n    }\r\n\r\n    return parseTtl(this.options.ttl);\r\n  }\r\n\r\n  /**\r\n   * Get time to live value in milliseconds\r\n   */\r\n  public getExpiresAt(ttl: number = this.ttl) {\r\n    if (ttl) {\r\n      return new Date().getTime() + ttl * 1000;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Wrap a value with TTL and optional freshness metadata for backend\r\n   * storage. `staleAt` persists alongside `expiresAt` when supplied — used\r\n   * by the SWR flow to mark when the entry stops being fresh.\r\n   */\r\n  protected prepareDataForStorage(data: any, ttl?: number, staleAt?: number) {\r\n    const preparedData: CacheData = {\r\n      data,\r\n    };\r\n\r\n    if (ttl) {\r\n      preparedData.ttl = ttl;\r\n      preparedData.expiresAt = this.getExpiresAt(ttl);\r\n    }\r\n\r\n    if (staleAt !== undefined) {\r\n      preparedData.staleAt = staleAt;\r\n    }\r\n\r\n    return preparedData;\r\n  }\r\n\r\n  /**\r\n   * Parse fetched data from cache\r\n   */\r\n  protected async parseCachedData(key: string, data: CacheData) {\r\n    this.log(\"fetched\", key);\r\n\r\n    if (data.expiresAt && data.expiresAt < Date.now()) {\r\n      this.remove(key);\r\n      return null;\r\n    }\r\n\r\n    const value = data.data;\r\n\r\n    // Skip cloning for primitives (immutable types)\r\n    if (value === null || value === undefined) {\r\n      return value;\r\n    }\r\n\r\n    const type = typeof value;\r\n    if (type === \"string\" || type === \"number\" || type === \"boolean\") {\r\n      return value;\r\n    }\r\n\r\n    // Deep clone objects/arrays to prevent cache mutation\r\n    try {\r\n      return structuredClone(value);\r\n    } catch (error) {\r\n      this.logError(\r\n        `Failed to clone cached value for ${key}, typeof value: ${typeof value}`,\r\n        error,\r\n      );\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async connect() {\r\n    this.log(\"connecting\");\r\n    this.log(\"connected\");\r\n    await this.emit(\"connected\");\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async disconnect() {\r\n    this.log(\"disconnected\");\r\n    await this.emit(\"disconnected\");\r\n  }\r\n\r\n  /**\r\n   * Create a tagged cache instance for the given tags\r\n   */\r\n  public tags(tags: string[]): any {\r\n    return new TaggedCache(tags, this);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Default implementation: read → transform → write under a per-key in-process\r\n   * lock. Drivers that can offer stronger semantics (Redis via `WATCH`/`MULTI`)\r\n   * should override.\r\n   */\r\n  public async update<T = any>(\r\n    key: CacheKey,\r\n    fn: (current: T | null) => T | null | Promise<T | null>,\r\n    options: { ttl?: CacheTtl } = {},\r\n  ): Promise<T | null> {\r\n    const parsedKey = this.parseKey(key);\r\n\r\n    // Chain each update onto the previous one for the same key so concurrent\r\n    // callers are serialized end-to-end, not merely awakened together when an\r\n    // earlier lock resolves.\r\n    const previous = this.locks.get(parsedKey) ?? Promise.resolve();\r\n\r\n    const next = previous\r\n      .catch(() => undefined)\r\n      .then(async () => {\r\n        const current = (await this.get(key)) as T | null;\r\n        const result = await fn(current);\r\n\r\n        if (result === null) {\r\n          await this.remove(key);\r\n          return null;\r\n        }\r\n\r\n        if (options.ttl !== undefined) {\r\n          await this.set(key, result, { ttl: options.ttl });\r\n\r\n          return result;\r\n        }\r\n\r\n        // No explicit TTL → preserve the existing entry's remaining lifetime\r\n        // rather than resetting it to the driver default.\r\n        const remainingTtl = await this.getRemainingTtl(key);\r\n\r\n        if (remainingTtl !== undefined) {\r\n          await this.set(key, result, { ttl: remainingTtl });\r\n        } else {\r\n          await this.set(key, result);\r\n        }\r\n\r\n        return result;\r\n      });\r\n\r\n    this.locks.set(parsedKey, next);\r\n\r\n    // Clean up the slot once this link finishes — but only if nobody chained\r\n    // a follow-up onto it in the meantime.\r\n    next.finally(() => {\r\n      if (this.locks.get(parsedKey) === next) {\r\n        this.locks.delete(parsedKey);\r\n      }\r\n    });\r\n\r\n    return next;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async merge<T extends Record<string, any> = Record<string, any>>(\r\n    key: CacheKey,\r\n    partial: Partial<T>,\r\n    options: { ttl?: CacheTtl } = {},\r\n  ): Promise<T> {\r\n    const result = await this.update<T>(\r\n      key,\r\n      (current) => {\r\n        const base = (current ?? {}) as T;\r\n        return { ...base, ...partial } as T;\r\n      },\r\n      options,\r\n    );\r\n\r\n    return result as T;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Default implementation: read-mutate-write array backed by the underlying\r\n   * cache entry. Concrete drivers (e.g. Redis) override with native commands.\r\n   */\r\n  public list<T = any>(key: CacheKey): CacheListAccessor<T> {\r\n    return new MemoryCacheList<T>(this, key);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Built on top of `set({ onConflict: \"create\" })` — Redis-native `SET … NX EX`\r\n   * under the hood on Redis, emulated via key-existence check on other drivers.\r\n   * The lock value is the resolved `owner` (defaults to `pid.<process.pid>`).\r\n   *\r\n   * Always releases in `finally`, even if `fn` throws — the thrown error\r\n   * propagates to the caller unchanged.\r\n   */\r\n  public async lock<T>(\r\n    key: CacheKey,\r\n    ttlOrOptions: CacheTtl | Omit<LockOptions, \"driver\">,\r\n    fn: () => Promise<T>,\r\n  ): Promise<LockOutcome<T>> {\r\n    const { ttl, owner } = this.normalizeLockOptions(ttlOrOptions);\r\n    const lockOwner = owner ?? `pid.${process.pid}`;\r\n\r\n    const setResult = (await this.set(key, lockOwner, {\r\n      onConflict: \"create\",\r\n      ttl,\r\n    })) as CacheSetResult | unknown;\r\n\r\n    // `onConflict` drivers return CacheSetResult. Drivers that no-op on set\r\n    // (e.g. the null driver) may return anything else — treat that as\r\n    // \"acquired\" since there's nothing to collide with.\r\n    const wasSet =\r\n      typeof setResult === \"object\" &&\r\n      setResult !== null &&\r\n      \"wasSet\" in setResult\r\n        ? (setResult as CacheSetResult).wasSet\r\n        : true;\r\n\r\n    if (!wasSet) {\r\n      return { acquired: false };\r\n    }\r\n\r\n    try {\r\n      const value = await fn();\r\n      return { acquired: true, value };\r\n    } finally {\r\n      await this.remove(key);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Default implementation throws {@link CacheUnsupportedError}. Drivers that\r\n   * support similarity retrieval (memory family, `pg`, `redis` w/ RediSearch)\r\n   * override this with a real impl.\r\n   */\r\n  public async similar<T = any>(\r\n    _vector: number[],\r\n    _options: CacheSimilarOptions,\r\n  ): Promise<CacheSimilarHit<T>[]> {\r\n    throw new CacheUnsupportedError(\r\n      `'${this.name}' driver does not support similarity retrieval. Use a memory driver, 'pg' (with pgvector), or 'redis' (with RediSearch).`,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Resolve the TTL-or-options arg of `lock` into a uniform shape.\r\n   */\r\n  protected normalizeLockOptions(\r\n    ttlOrOptions: CacheTtl | Omit<LockOptions, \"driver\">,\r\n  ): {\r\n    ttl: CacheTtl;\r\n    owner?: string;\r\n  } {\r\n    if (typeof ttlOrOptions === \"number\" || typeof ttlOrOptions === \"string\") {\r\n      return { ttl: ttlOrOptions };\r\n    }\r\n\r\n    return { ttl: ttlOrOptions.ttl, owner: ttlOrOptions.owner };\r\n  }\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"base-cache-driver.mjs","names":[],"sources":["../../../../../../../cache/src/drivers/base-cache-driver.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\r\nimport { MemoryCacheList } from \"../list/memory-cache-list\";\r\nimport { TaggedCache } from \"../tagged-cache\";\r\nimport type {\r\n  CacheConflictPolicy,\r\n  CacheData,\r\n  CacheDriver,\r\n  CacheEventData,\r\n  CacheEventHandler,\r\n  CacheEventType,\r\n  CacheKey,\r\n  CacheListAccessor,\r\n  CacheOperationType,\r\n  CacheSetOptions,\r\n  CacheSetResult,\r\n  CacheSimilarHit,\r\n  CacheSimilarOptions,\r\n  CacheSwrOptions,\r\n  CacheTtl,\r\n  LockOptions,\r\n  LockOutcome,\r\n  RememberOptions,\r\n} from \"../types\";\r\nimport { CacheUnsupportedError } from \"../types\";\r\nimport {\r\n  normalizeToOptions,\r\n  parseCacheKey,\r\n  parseTtl,\r\n  resolveTtl,\r\n  safeErrorInfo,\r\n} from \"../utils\";\r\n\r\n/**\r\n * Normalized form of the 3rd `set` argument.\r\n *\r\n * All drivers operate on this shape internally regardless of whether the caller\r\n * passed a positional TTL, a duration string, or a rich options object.\r\n */\r\nexport type NormalizedSetOptions = {\r\n  /**\r\n   * Final TTL in seconds — already merged with the driver-level default\r\n   * (`this.options.ttl`). `Infinity` means \"no expiration\".\r\n   *\r\n   * Always populated. Drivers do NOT need to fall back to `this.ttl`\r\n   * themselves — `resolveSetOptions` does the merge centrally so that\r\n   * every driver respects the configured default without ceremony.\r\n   */\r\n  ttl: number;\r\n  /**\r\n   * Inline tag list, or undefined when none were provided.\r\n   */\r\n  tags?: string[];\r\n  /**\r\n   * Conflict policy. Defaults to `\"upsert\"`.\r\n   */\r\n  onConflict: CacheConflictPolicy;\r\n  /**\r\n   * Optional embedding vector for similarity retrieval. Drivers that do not\r\n   * support similarity must throw {@link CacheUnsupportedError} when this is\r\n   * present (rather than silently dropping it).\r\n   */\r\n  vector?: number[];\r\n  /**\r\n   * Optional freshness deadline as a millisecond timestamp. Set by `swr()`\r\n   * to mark when the entry stops being \"fresh\" and becomes\r\n   * \"stale-but-revalidatable.\" Drivers route this through\r\n   * `prepareDataForStorage` so it persists in the wrapper.\r\n   */\r\n  staleAt?: number;\r\n};\r\n\r\nconst messages = {\r\n  clearing: \"Clearing namespace\",\r\n  cleared: \"Namespace cleared\",\r\n  fetching: \"Fetching key\",\r\n  fetched: \"Key fetched\",\r\n  caching: \"Caching key\",\r\n  cached: \"Key cached\",\r\n  flushing: \"Flushing cache\",\r\n  flushed: \"Cache flushed\",\r\n  removing: \"Removing key\",\r\n  removed: \"Key removed\",\r\n  expired: \"Key expired\",\r\n  notFound: \"Key not found\",\r\n  connecting: \"Connecting to the cache engine.\",\r\n  connected: \"Connected to the cache engine.\",\r\n  disconnecting: \"Disconnecting from the cache engine.\",\r\n  disconnected: \"Disconnected from the cache engine.\",\r\n  connectionFailed: \"Failed to connect to the cache engine.\",\r\n  error: \"Error occurred\",\r\n};\r\n\r\nexport abstract class BaseCacheDriver<\r\n  ClientType,\r\n  Options extends Record<string, any>,\r\n> implements CacheDriver<ClientType, Options> {\r\n  /**\r\n   * CLient driver\r\n   */\r\n  protected clientDriver!: ClientType;\r\n\r\n  /**\r\n   * Determine whether to log or not\r\n   */\r\n  protected shouldLog: boolean = true;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public get client() {\r\n    return (this.clientDriver || this) as unknown as ClientType;\r\n  }\r\n\r\n  /**\r\n   * Set logging state\r\n   */\r\n  public setLoggingState(shouldLog: boolean) {\r\n    this.shouldLog = shouldLog;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Set client driver\r\n   */\r\n  public set client(client: ClientType) {\r\n    this.clientDriver = client;\r\n  }\r\n\r\n  /**\r\n   * Get the cache driver name\r\n   */\r\n  public abstract name: string;\r\n\r\n  /**\r\n   * Options list\r\n   */\r\n  public options!: Options;\r\n\r\n  /**\r\n   * Event listeners storage\r\n   */\r\n  protected eventListeners: Map<CacheEventType, Set<CacheEventHandler>> =\r\n    new Map();\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public parseKey(key: CacheKey) {\r\n    return parseCacheKey(key, this.options);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public setOptions(options: Options) {\r\n    this.options = options || {};\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Register an event listener\r\n   */\r\n  public on(event: CacheEventType, handler: CacheEventHandler): this {\r\n    if (!this.eventListeners.has(event)) {\r\n      this.eventListeners.set(event, new Set());\r\n    }\r\n    this.eventListeners.get(event)!.add(handler);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Remove an event listener\r\n   */\r\n  public off(event: CacheEventType, handler: CacheEventHandler): this {\r\n    const handlers = this.eventListeners.get(event);\r\n    if (handlers) {\r\n      handlers.delete(handler);\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Register a one-time event listener\r\n   */\r\n  public once(event: CacheEventType, handler: CacheEventHandler): this {\r\n    const onceHandler: CacheEventHandler = async (data) => {\r\n      await handler(data);\r\n      this.off(event, onceHandler);\r\n    };\r\n    return this.on(event, onceHandler);\r\n  }\r\n\r\n  /**\r\n   * Emit an event to all registered listeners\r\n   */\r\n  protected async emit(\r\n    event: CacheEventType,\r\n    data: Partial<CacheEventData> = {},\r\n  ): Promise<void> {\r\n    const handlers = this.eventListeners.get(event);\r\n    if (!handlers || handlers.size === 0) return;\r\n\r\n    const eventData: CacheEventData = {\r\n      driver: this.name,\r\n      ...data,\r\n    };\r\n\r\n    // Execute all handlers\r\n    const promises: Promise<void>[] = [];\r\n    for (const handler of handlers) {\r\n      try {\r\n        const result = handler(eventData);\r\n        if (result instanceof Promise) {\r\n          promises.push(result);\r\n        }\r\n      } catch (error) {\r\n        this.logError(`Error in event handler for '${event}'`, error);\r\n      }\r\n    }\r\n\r\n    // Wait for all async handlers\r\n    if (promises.length > 0) {\r\n      await Promise.allSettled(promises);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract removeNamespace(namespace: string): Promise<any>;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract set(\r\n    key: CacheKey,\r\n    value: any,\r\n    ttlOrOptions?: CacheTtl | CacheSetOptions,\r\n  ): Promise<any>;\r\n\r\n  /**\r\n   * Normalize the 3rd argument of a `set` call into a single shape every driver\r\n   * can act on. Handles TTL parsing (number | string | Infinity), `expiresAt` →\r\n   * relative TTL conversion, and mutual-exclusion validation.\r\n   *\r\n   * @throws {CacheConfigurationError} when `ttl` and `expiresAt` are passed together\r\n   * or an unparseable duration string is supplied.\r\n   */\r\n  protected resolveSetOptions(\r\n    ttlOrOptions?: CacheTtl | CacheSetOptions,\r\n  ): NormalizedSetOptions {\r\n    const options = normalizeToOptions(ttlOrOptions);\r\n\r\n    return {\r\n      ttl: resolveTtl(options.ttl, options.expiresAt, this.ttl),\r\n      tags: options.tags,\r\n      onConflict: options.onConflict ?? \"upsert\",\r\n      vector: options.vector,\r\n      staleAt: options.staleAt,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Resolve the union of cache keys associated with any of the given tags.\r\n   * Used by `similar()` to narrow the candidate pool before similarity ranking.\r\n   *\r\n   * Returns `null` when no tags are passed (callers should treat that as \"no filter\").\r\n   */\r\n  protected async getKeysForTags(\r\n    tags: string[] | undefined,\r\n  ): Promise<Set<string> | null> {\r\n    if (!tags || tags.length === 0) {\r\n      return null;\r\n    }\r\n\r\n    const allKeys = new Set<string>();\r\n    for (const tag of tags) {\r\n      const tagKey = `cache:tags:${tag}`;\r\n      const keys = ((await this.get(tagKey)) as string[] | null) || [];\r\n      for (const k of keys) {\r\n        allKeys.add(k);\r\n      }\r\n    }\r\n\r\n    return allKeys;\r\n  }\r\n\r\n  /**\r\n   * Apply tag relationships after a successful write. Called by drivers once\r\n   * the value is in storage.\r\n   */\r\n  protected async applyTags(parsedKey: string, tags: string[]): Promise<void> {\r\n    if (tags.length === 0) {\r\n      return;\r\n    }\r\n\r\n    const tagged = this.tags(tags);\r\n    await (tagged as TaggedCache).storeTagRelationship(parsedKey);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract get(key: CacheKey): Promise<any>;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract remove(key: CacheKey): Promise<void>;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public abstract flush(): Promise<void>;\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async has(key: CacheKey): Promise<boolean> {\r\n    const value = await this.get(key);\r\n    // Event is emitted by get() method\r\n    return value !== null;\r\n  }\r\n\r\n  /**\r\n   * Lock storage for preventing cache stampede\r\n   */\r\n  protected locks: Map<string, Promise<any>> = new Map();\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async remember(\r\n    key: CacheKey,\r\n    ttlOrOptions: CacheTtl | RememberOptions,\r\n    callback: () => Promise<any>,\r\n  ): Promise<any> {\r\n    const parsedKey = this.parseKey(key);\r\n\r\n    // The options-form lets callers forward tags / driver-override through to\r\n    // the cache-miss write. Normalize both shapes into a single CacheSetOptions\r\n    // blob so there's one path from here on.\r\n    const setOptions = this.normalizeRememberOptions(ttlOrOptions);\r\n\r\n    const cachedValue = await this.get(key);\r\n    if (cachedValue) {\r\n      return cachedValue;\r\n    }\r\n\r\n    const existingLock = this.locks.get(parsedKey);\r\n    if (existingLock) {\r\n      return existingLock;\r\n    }\r\n\r\n    const promise = callback()\r\n      .then(async (result) => {\r\n        await this.set(key, result, setOptions);\r\n        this.locks.delete(parsedKey);\r\n        return result;\r\n      })\r\n      .catch((err) => {\r\n        this.locks.delete(parsedKey);\r\n        throw err;\r\n      });\r\n\r\n    this.locks.set(parsedKey, promise);\r\n    return promise;\r\n  }\r\n\r\n  /**\r\n   * Resolve the TTL-or-options arg of `remember` into a `CacheSetOptions` object\r\n   * that can be passed straight to `set()`. Keeps the implementation unbranched.\r\n   */\r\n  protected normalizeRememberOptions(\r\n    ttlOrOptions: CacheTtl | RememberOptions,\r\n  ): CacheSetOptions {\r\n    if (typeof ttlOrOptions === \"number\" || typeof ttlOrOptions === \"string\") {\r\n      return { ttl: ttlOrOptions };\r\n    }\r\n\r\n    return {\r\n      ttl: ttlOrOptions.ttl,\r\n      tags: ttlOrOptions.tags,\r\n    };\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Default implementation: read raw entry, branch on freshness/staleness,\r\n   * trigger background refresh in the stale window, fall through to\r\n   * `callback` on miss/expiry. Concurrent stale-window callers share a\r\n   * single in-flight refresh via {@link locks}.\r\n   *\r\n   * Drivers without a real {@link getEntry} override degrade gracefully —\r\n   * the synthetic entry has no `staleAt`, which the freshness check treats\r\n   * as \"always fresh,\" so SWR behaves like a TTL-only cached read on those\r\n   * drivers (no background refresh, but no double-fetch either).\r\n   */\r\n  public async swr<T = any>(\r\n    key: CacheKey,\r\n    options: CacheSwrOptions,\r\n    callback: () => Promise<T>,\r\n  ): Promise<T> {\r\n    const parsedKey = this.parseKey(key);\r\n    const freshSeconds = parseTtl(options.freshTtl);\r\n    const staleSeconds = parseTtl(options.staleTtl);\r\n\r\n    if (staleSeconds <= freshSeconds) {\r\n      throw new Error(\r\n        `cache.swr: 'staleTtl' (${staleSeconds}s) must be greater than 'freshTtl' (${freshSeconds}s).`,\r\n      );\r\n    }\r\n\r\n    const entry = await this.getEntry(key);\r\n    const now = Date.now();\r\n\r\n    const isExpired = entry?.expiresAt !== undefined && entry.expiresAt <= now;\r\n\r\n    if (!entry || isExpired) {\r\n      return this.swrFetchAndStore<T>(\r\n        key,\r\n        options,\r\n        callback,\r\n        freshSeconds,\r\n        staleSeconds,\r\n      );\r\n    }\r\n\r\n    const isFresh = entry.staleAt === undefined || entry.staleAt > now;\r\n\r\n    if (isFresh) {\r\n      return entry.data as T;\r\n    }\r\n\r\n    this.scheduleSwrRefresh<T>(\r\n      parsedKey,\r\n      key,\r\n      options,\r\n      callback,\r\n      freshSeconds,\r\n      staleSeconds,\r\n    );\r\n\r\n    return entry.data as T;\r\n  }\r\n\r\n  /**\r\n   * Read the raw {@link CacheData} wrapper for a key, including any\r\n   * `expiresAt` / `staleAt` metadata. Default implementation falls back to\r\n   * `get()` and synthesizes a metadata-less wrapper — drivers that store\r\n   * the wrapper directly (memory, lru, file, redis, pg, mock) override\r\n   * this to return real metadata so SWR can branch on freshness.\r\n   */\r\n  protected async getEntry(key: CacheKey): Promise<CacheData | null> {\r\n    const value = await this.get(key);\r\n\r\n    if (value === null) {\r\n      return null;\r\n    }\r\n\r\n    return { data: value };\r\n  }\r\n\r\n  /**\r\n   * Remaining lifetime of an existing entry, in seconds — used by TTL-preserving\r\n   * writes such as `update()` / `merge()` when the caller passes no explicit\r\n   * `ttl`.\r\n   *\r\n   * - `Infinity` — the entry exists with no expiry (preserve \"never expires\").\r\n   * - positive number — seconds left before the entry expires.\r\n   * - `undefined` — the key is missing or already past its deadline; the caller\r\n   *   should fall back to the driver default TTL.\r\n   *\r\n   * Default reads `expiresAt` from {@link getEntry}, which the metadata-aware\r\n   * drivers (memory, lru, mock, pg) populate. Drivers that track TTL natively\r\n   * and don't carry `expiresAt` in their payload (Redis) override this.\r\n   */\r\n  protected async getRemainingTtl(key: CacheKey): Promise<number | undefined> {\r\n    const entry = await this.getEntry(key);\r\n\r\n    if (!entry) {\r\n      return undefined;\r\n    }\r\n\r\n    if (!entry.expiresAt || entry.expiresAt === Infinity) {\r\n      return Infinity;\r\n    }\r\n\r\n    const remainingSeconds = Math.ceil((entry.expiresAt - Date.now()) / 1000);\r\n\r\n    return remainingSeconds > 0 ? remainingSeconds : undefined;\r\n  }\r\n\r\n  /**\r\n   * Block-and-fetch path of `swr()`: invoked on miss or past-`staleTtl`\r\n   * expiry. Writes through `set()` with the SWR options translated into\r\n   * standard `CacheSetOptions` (ttl = staleTtl, staleAt = now + freshTtl).\r\n   */\r\n  protected async swrFetchAndStore<T>(\r\n    key: CacheKey,\r\n    options: CacheSwrOptions,\r\n    callback: () => Promise<T>,\r\n    freshSeconds: number,\r\n    staleSeconds: number,\r\n  ): Promise<T> {\r\n    const result = await callback();\r\n\r\n    await this.set(key, result, {\r\n      ttl: staleSeconds,\r\n      staleAt: Date.now() + freshSeconds * 1000,\r\n      tags: options.tags,\r\n    });\r\n\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Stale-window background refresh. Registers a single in-flight promise\r\n   * per parsed key so concurrent SWR callers share one refresh. Failed\r\n   * refreshes preserve the stale entry, log via `logError`, and emit on\r\n   * `error` — the stale-returning caller never sees the failure.\r\n   */\r\n  protected scheduleSwrRefresh<T>(\r\n    parsedKey: string,\r\n    key: CacheKey,\r\n    options: CacheSwrOptions,\r\n    callback: () => Promise<T>,\r\n    freshSeconds: number,\r\n    staleSeconds: number,\r\n  ): void {\r\n    if (this.locks.has(parsedKey)) {\r\n      return;\r\n    }\r\n\r\n    let refresh!: Promise<void>;\r\n    refresh = (async () => {\r\n      try {\r\n        const result = await callback();\r\n\r\n        await this.set(key, result, {\r\n          ttl: staleSeconds,\r\n          staleAt: Date.now() + freshSeconds * 1000,\r\n          tags: options.tags,\r\n        });\r\n      } catch (error) {\r\n        this.logError(`SWR background refresh failed for ${parsedKey}`, error);\r\n        await this.emit(\"error\", { key: parsedKey, error });\r\n      } finally {\r\n        if (this.locks.get(parsedKey) === refresh) {\r\n          this.locks.delete(parsedKey);\r\n        }\r\n      }\r\n    })();\r\n\r\n    this.locks.set(parsedKey, refresh);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async pull(key: CacheKey): Promise<any | null> {\r\n    const value = await this.get(key);\r\n    if (value !== null) {\r\n      await this.remove(key);\r\n    }\r\n    // Events are emitted by get() and remove() methods\r\n    return value;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async forever(key: CacheKey, value: any): Promise<any> {\r\n    // Event is emitted by set() method\r\n    return this.set(key, value, Infinity);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async increment(key: CacheKey, value: number = 1): Promise<number> {\r\n    const current = (await this.get(key)) || 0;\r\n\r\n    if (typeof current !== \"number\") {\r\n      throw new Error(\r\n        `Cannot increment non-numeric value for key: ${this.parseKey(key)}`,\r\n      );\r\n    }\r\n\r\n    const newValue = current + value;\r\n    await this.set(key, newValue);\r\n    return newValue;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async decrement(key: CacheKey, value: number = 1): Promise<number> {\r\n    return this.increment(key, -value);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async many(keys: CacheKey[]): Promise<any[]> {\r\n    return Promise.all(keys.map((key) => this.get(key)));\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async setMany(\r\n    items: Record<string, any>,\r\n    ttl?: number,\r\n  ): Promise<void> {\r\n    await Promise.all(\r\n      Object.entries(items).map(([key, value]) => this.set(key, value, ttl)),\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Log the operation\r\n   */\r\n  protected log(operation: CacheOperationType, key?: string | any) {\r\n    if (!this.shouldLog) return;\r\n\r\n    if (typeof key === \"string\") {\r\n      // this will be likely used with file cache driver as it will convert the dot to slash\r\n      // to make it consistent and not to confuse developers we will output the key by making sure it's a dot\r\n      key = key.replace(/\\//g, \".\");\r\n    }\r\n\r\n    if (operation === \"connectionFailed\") {\r\n      log.fatal(`cache.${this.name}`, operation, key);\r\n    }\r\n\r\n    if (operation == \"notFound\" || operation == \"expired\") {\r\n      return log.warn(\r\n        \"cache.\" + this.name,\r\n        operation,\r\n        (key ? key + \" \" : \"\") + messages[operation],\r\n      );\r\n    }\r\n\r\n    if (operation.endsWith(\"ed\")) {\r\n      return log.success(\r\n        \"cache.\" + this.name,\r\n        operation,\r\n        (key ? key + \" \" : \"\") + messages[operation],\r\n      );\r\n    }\r\n\r\n    log.info(\r\n      \"cache.\" + this.name,\r\n      operation,\r\n      (key ? key + \" \" : \"\") + messages[operation],\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Log error message\r\n   *\r\n   * Never logs the raw `error` object — driver connection errors (Redis,\r\n   * Postgres, ...) can carry the connection string, including the password,\r\n   * in the message/cause. Only a redacted `{ message, code }` shape is\r\n   * passed to the structured logger.\r\n   */\r\n  protected logError(message: string, error?: any) {\r\n    if (error) {\r\n      log.error(\"cache.\" + this.name, \"error\", message, safeErrorInfo(error));\r\n    } else {\r\n      log.error(\"cache.\" + this.name, \"error\", message);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get the default TTL in seconds. Parses human-readable strings (`\"1h\"`, `\"30m\"`)\r\n   * from driver options if present; falls back to `Infinity` when no default is set.\r\n   */\r\n  public get ttl() {\r\n    if (this.options.ttl === undefined) {\r\n      return Infinity;\r\n    }\r\n\r\n    return parseTtl(this.options.ttl);\r\n  }\r\n\r\n  /**\r\n   * Get time to live value in milliseconds\r\n   */\r\n  public getExpiresAt(ttl: number = this.ttl) {\r\n    if (ttl) {\r\n      return new Date().getTime() + ttl * 1000;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Wrap a value with TTL and optional freshness metadata for backend\r\n   * storage. `staleAt` persists alongside `expiresAt` when supplied — used\r\n   * by the SWR flow to mark when the entry stops being fresh.\r\n   */\r\n  protected prepareDataForStorage(data: any, ttl?: number, staleAt?: number) {\r\n    const preparedData: CacheData = {\r\n      data,\r\n    };\r\n\r\n    if (ttl) {\r\n      preparedData.ttl = ttl;\r\n      preparedData.expiresAt = this.getExpiresAt(ttl);\r\n    }\r\n\r\n    if (staleAt !== undefined) {\r\n      preparedData.staleAt = staleAt;\r\n    }\r\n\r\n    return preparedData;\r\n  }\r\n\r\n  /**\r\n   * Parse fetched data from cache\r\n   */\r\n  protected async parseCachedData(key: string, data: CacheData) {\r\n    this.log(\"fetched\", key);\r\n\r\n    if (data.expiresAt && data.expiresAt < Date.now()) {\r\n      this.remove(key);\r\n      return null;\r\n    }\r\n\r\n    const value = data.data;\r\n\r\n    // Skip cloning for primitives (immutable types)\r\n    if (value === null || value === undefined) {\r\n      return value;\r\n    }\r\n\r\n    const type = typeof value;\r\n    if (type === \"string\" || type === \"number\" || type === \"boolean\") {\r\n      return value;\r\n    }\r\n\r\n    // Deep clone objects/arrays to prevent cache mutation\r\n    try {\r\n      return structuredClone(value);\r\n    } catch (error) {\r\n      this.logError(\r\n        `Failed to clone cached value for ${key}, typeof value: ${typeof value}`,\r\n        error,\r\n      );\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async connect() {\r\n    this.log(\"connecting\");\r\n    this.log(\"connected\");\r\n    await this.emit(\"connected\");\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async disconnect() {\r\n    this.log(\"disconnected\");\r\n    await this.emit(\"disconnected\");\r\n  }\r\n\r\n  /**\r\n   * Create a tagged cache instance for the given tags\r\n   */\r\n  public tags(tags: string[]): any {\r\n    return new TaggedCache(tags, this);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Default implementation: read → transform → write under a per-key in-process\r\n   * lock. Drivers that can offer stronger semantics (Redis via `WATCH`/`MULTI`)\r\n   * should override.\r\n   */\r\n  public async update<T = any>(\r\n    key: CacheKey,\r\n    fn: (current: T | null) => T | null | Promise<T | null>,\r\n    options: { ttl?: CacheTtl } = {},\r\n  ): Promise<T | null> {\r\n    const parsedKey = this.parseKey(key);\r\n\r\n    // Chain each update onto the previous one for the same key so concurrent\r\n    // callers are serialized end-to-end, not merely awakened together when an\r\n    // earlier lock resolves.\r\n    const previous = this.locks.get(parsedKey) ?? Promise.resolve();\r\n\r\n    const next = previous\r\n      .catch(() => undefined)\r\n      .then(async () => {\r\n        const current = (await this.get(key)) as T | null;\r\n        const result = await fn(current);\r\n\r\n        if (result === null) {\r\n          await this.remove(key);\r\n          return null;\r\n        }\r\n\r\n        if (options.ttl !== undefined) {\r\n          await this.set(key, result, { ttl: options.ttl });\r\n\r\n          return result;\r\n        }\r\n\r\n        // No explicit TTL → preserve the existing entry's remaining lifetime\r\n        // rather than resetting it to the driver default.\r\n        const remainingTtl = await this.getRemainingTtl(key);\r\n\r\n        if (remainingTtl !== undefined) {\r\n          await this.set(key, result, { ttl: remainingTtl });\r\n        } else {\r\n          await this.set(key, result);\r\n        }\r\n\r\n        return result;\r\n      });\r\n\r\n    this.locks.set(parsedKey, next);\r\n\r\n    // Clean up the slot once this link finishes — but only if nobody chained\r\n    // a follow-up onto it in the meantime.\r\n    next.finally(() => {\r\n      if (this.locks.get(parsedKey) === next) {\r\n        this.locks.delete(parsedKey);\r\n      }\r\n    });\r\n\r\n    return next;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async merge<T extends Record<string, any> = Record<string, any>>(\r\n    key: CacheKey,\r\n    partial: Partial<T>,\r\n    options: { ttl?: CacheTtl } = {},\r\n  ): Promise<T> {\r\n    const result = await this.update<T>(\r\n      key,\r\n      (current) => {\r\n        const base = (current ?? {}) as T;\r\n        return { ...base, ...partial } as T;\r\n      },\r\n      options,\r\n    );\r\n\r\n    return result as T;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Default implementation: read-mutate-write array backed by the underlying\r\n   * cache entry. Concrete drivers (e.g. Redis) override with native commands.\r\n   */\r\n  public list<T = any>(key: CacheKey): CacheListAccessor<T> {\r\n    return new MemoryCacheList<T>(this, key);\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Built on top of `set({ onConflict: \"create\" })` — Redis-native `SET … NX EX`\r\n   * under the hood on Redis, emulated via key-existence check on other drivers.\r\n   * The lock value is the resolved `owner` (defaults to `pid.<process.pid>`).\r\n   *\r\n   * Always releases in `finally`, even if `fn` throws — the thrown error\r\n   * propagates to the caller unchanged.\r\n   */\r\n  public async lock<T>(\r\n    key: CacheKey,\r\n    ttlOrOptions: CacheTtl | Omit<LockOptions, \"driver\">,\r\n    fn: () => Promise<T>,\r\n  ): Promise<LockOutcome<T>> {\r\n    const { ttl, owner } = this.normalizeLockOptions(ttlOrOptions);\r\n    const lockOwner = owner ?? `pid.${process.pid}`;\r\n\r\n    const setResult = (await this.set(key, lockOwner, {\r\n      onConflict: \"create\",\r\n      ttl,\r\n    })) as CacheSetResult | unknown;\r\n\r\n    // `onConflict` drivers return CacheSetResult. Drivers that no-op on set\r\n    // (e.g. the null driver) may return anything else — treat that as\r\n    // \"acquired\" since there's nothing to collide with.\r\n    const wasSet =\r\n      typeof setResult === \"object\" &&\r\n      setResult !== null &&\r\n      \"wasSet\" in setResult\r\n        ? (setResult as CacheSetResult).wasSet\r\n        : true;\r\n\r\n    if (!wasSet) {\r\n      return { acquired: false };\r\n    }\r\n\r\n    try {\r\n      const value = await fn();\r\n      return { acquired: true, value };\r\n    } finally {\r\n      await this.remove(key);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Default implementation throws {@link CacheUnsupportedError}. Drivers that\r\n   * support similarity retrieval (memory family, `pg`, `redis` w/ RediSearch)\r\n   * override this with a real impl.\r\n   */\r\n  public async similar<T = any>(\r\n    _vector: number[],\r\n    _options: CacheSimilarOptions,\r\n  ): Promise<CacheSimilarHit<T>[]> {\r\n    throw new CacheUnsupportedError(\r\n      `'${this.name}' driver does not support similarity retrieval. Use a memory driver, 'pg' (with pgvector), or 'redis' (with RediSearch).`,\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Resolve the TTL-or-options arg of `lock` into a uniform shape.\r\n   */\r\n  protected normalizeLockOptions(\r\n    ttlOrOptions: CacheTtl | Omit<LockOptions, \"driver\">,\r\n  ): {\r\n    ttl: CacheTtl;\r\n    owner?: string;\r\n  } {\r\n    if (typeof ttlOrOptions === \"number\" || typeof ttlOrOptions === \"string\") {\r\n      return { ttl: ttlOrOptions };\r\n    }\r\n\r\n    return { ttl: ttlOrOptions.ttl, owner: ttlOrOptions.owner };\r\n  }\r\n}\r\n"],"mappings":"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"}

package/esm/drivers/file-cache-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-cache-driver.d.mts","names":[],"sources":["../../../../../../../cache/src/drivers/file-cache-driver.ts"],"mappings":";;;;cAoBa,eAAA,SACH,eAAA,CAAgB,eAAA,EAAiB,gBAAA,aAC9B,WAAA,CAAY,eAAA,EAAiB,gBAAA;;AAF1C;;EAOS,IAAA;EANiB;;;EAWjB,UAAA,CAAW,OAAA,EAAS,gBAAA;EAAA;;;EAAA,IAahB,SAAA,CAAA;EA2IiB;;;EAAA,IA5HjB,QAAA,CAAA;EA0MmB;;;;;;;;;;EAAA,UAtLpB,YAAA,CAAa,SAAA;EA1DD;;;;EAAA,UAkEZ,gBAAA,CAAiB,SAAA;EAlEhB;;;;;;;EAAA,UAgFD,gBAAA,CAAiB,OAAA;EA1ChB;;;;;EAAA,UAsDD,aAAA,CAAc,OAAA;EAZG;;;;;;;;;;;EAyCd,eAAA,CAAgB,SAAA,WAAiB,OAAA;EAyC5C;;;EAHW,GAAA,CACX,GAAA,EAAK,QAAA,EACL,KAAA,OACA,YAAA,GAAe,QAAA,GAAW,eAAA,GACzB,OAAA;EAkEU;;;;;;;;EATA,MAAA,CAAA,GAAU,OAAA;EA8CN;;;EArCJ,KAAA,CAAA,GAAS,OAAA;EA0EF;;;;;EAAA,UA/DJ,QAAA,CAAS,GAAA,EAAK,QAAA,GAAW,OAAA,CAAQ,SAAA;EAqG7B;AAAA;;EA3EP,GAAA,CAAI,GAAA,EAAK,QAAA,GAAQ,OAAA;;;;EAqCjB,MAAA,CAAO,GAAA,EAAK,QAAA,GAAQ,OAAA;;;;EAoBpB,KAAA,CAAA,GAAK,OAAA;;;;EAkBL,OAAA,CAAA,GAAO,OAAA;AAAA"}
+{"version":3,"file":"file-cache-driver.d.mts","names":[],"sources":["../../../../../../../cache/src/drivers/file-cache-driver.ts"],"mappings":";;;;cAoBa,eAAA,SACH,eAAA,CAAgB,eAAA,EAAiB,gBAAA,aAC9B,WAAA,CAAY,eAAA,EAAiB,gBAAA;;AAF1C;;EAOS,IAAA;EANiB;;;EAWjB,UAAA,CAAW,OAAA,EAAS,gBAAA;EAAA;;;EAAA,IAahB,SAAA;EA2IiB;;;EAAA,IA5HjB,QAAA;EA0MmB;;;;;;;;;;EAAA,UAtLpB,YAAA,CAAa,SAAA;EA1DD;;;;EAAA,UAkEZ,gBAAA,CAAiB,SAAA;EAlEhB;;;;;;;EAAA,UAgFD,gBAAA,CAAiB,OAAA;EA1ChB;;;;;EAAA,UAsDD,aAAA,CAAc,OAAA;EAZG;;;;;;;;;;;EAyCd,eAAA,CAAgB,SAAA,WAAiB,OAAA;EAyC5C;;;EAHW,GAAA,CACX,GAAA,EAAK,QAAA,EACL,KAAA,OACA,YAAA,GAAe,QAAA,GAAW,eAAA,GACzB,OAAA;EAkEU;;;;;;;;EATA,MAAA,IAAU,OAAA;EA8CN;;;EArCJ,KAAA,IAAS,OAAA;EA0EF;;;;;EAAA,UA/DJ,QAAA,CAAS,GAAA,EAAK,QAAA,GAAW,OAAA,CAAQ,SAAA;EAqG7B;AAAA;;EA3EP,GAAA,CAAI,GAAA,EAAK,QAAA,GAAQ,OAAA;;;;EAqCjB,MAAA,CAAO,GAAA,EAAK,QAAA,GAAQ,OAAA;;;;EAoBpB,KAAA,IAAK,OAAA;;;;EAkBL,OAAA,IAAO,OAAA;AAAA"}

package/esm/drivers/file-cache-driver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"file-cache-driver.mjs","names":[],"sources":["../../../../../../../cache/src/drivers/file-cache-driver.ts"],"sourcesContent":["import {\r\n  ensureDirectoryAsync,\r\n  getJsonFileAsync,\r\n  listDirectoriesAsync,\r\n  putJsonFileAsync,\r\n  removeDirectoryAsync,\r\n} from \"@warlock.js/fs\";\r\nimport path from \"path\";\r\nimport type {\r\n  CacheData,\r\n  CacheDriver,\r\n  CacheKey,\r\n  CacheSetOptions,\r\n  CacheSetResult,\r\n  CacheTtl,\r\n  FileCacheOptions,\r\n} from \"../types\";\r\nimport { CacheConfigurationError, CacheError, CacheUnsupportedError } from \"../types\";\r\nimport { BaseCacheDriver } from \"./base-cache-driver\";\r\n\r\nexport class FileCacheDriver\r\n  extends BaseCacheDriver<FileCacheDriver, FileCacheOptions>\r\n  implements CacheDriver<FileCacheDriver, FileCacheOptions>\r\n{\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public name = \"file\";\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public setOptions(options: FileCacheOptions) {\r\n    if (!options.directory) {\r\n      throw new CacheConfigurationError(\r\n        \"File driver requires 'directory' option to be configured.\",\r\n      );\r\n    }\r\n\r\n    return super.setOptions(options);\r\n  }\r\n\r\n  /**\r\n   * Get the cache directory\r\n   */\r\n  public get directory() {\r\n    const directory = this.options.directory;\r\n\r\n    if (typeof directory === \"function\") {\r\n      return directory();\r\n    }\r\n\r\n    throw new CacheConfigurationError(\r\n      \"Cache directory is not defined, please define it in the file driver options\",\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get file name\r\n   */\r\n  public get fileName() {\r\n    const fileName = this.options.fileName;\r\n\r\n    if (typeof fileName === \"function\") {\r\n      return fileName();\r\n    }\r\n\r\n    return \"cache.json\";\r\n  }\r\n\r\n  /**\r\n   * Map a parsed cache key (or namespace) to its on-disk directory.\r\n   *\r\n   * The key must become exactly one directory component: `%` and the path\r\n   * separators are percent-encoded so a hostile key (`../../etc`,\r\n   * `..\\\\..\\\\evil`) turns into an inert directory name instead of a path\r\n   * traversal, while distinct keys can never collide after encoding. Dots are\r\n   * left untouched — the `.`-delimited namespace scheme is purely logical and\r\n   * only ever produces a single filesystem component here.\r\n   */\r\n  protected keyDirectory(parsedKey: string): string {\r\n    return this.containedPath(this.encodeKeySegment(parsedKey));\r\n  }\r\n\r\n  /**\r\n   * Percent-encode a parsed key into an inert, single-component directory\r\n   * name. Dots are left untouched — see {@link keyDirectory}.\r\n   */\r\n  protected encodeKeySegment(parsedKey: string): string {\r\n    return parsedKey\r\n      .replace(/%/g, \"%25\")\r\n      .replace(/\\//g, \"%2F\")\r\n      .replace(/\\\\/g, \"%5C\");\r\n  }\r\n\r\n  /**\r\n   * Reverse of {@link encodeKeySegment} — recovers the logical, dot-delimited\r\n   * parsed key from an on-disk directory name. Used by {@link removeNamespace}\r\n   * to test which sibling directories logically belong to a namespace, since\r\n   * dotted keys (`ns.a`) are stored as sibling directories rather than nested\r\n   * ones (see {@link keyDirectory}'s doc comment).\r\n   */\r\n  protected decodeKeySegment(encoded: string): string {\r\n    return encoded\r\n      .replace(/%2F/g, \"/\")\r\n      .replace(/%5C/g, \"\\\\\")\r\n      .replace(/%25/g, \"%\");\r\n  }\r\n\r\n  /**\r\n   * Resolve `segment` against the cache root and throw when the result lands\r\n   * outside it — the last line of defense against path traversal, independent\r\n   * of how the key was encoded.\r\n   */\r\n  protected containedPath(segment: string): string {\r\n    const base = path.resolve(this.directory);\r\n    const resolved = path.resolve(base, segment);\r\n    const relative = path.relative(base, resolved);\r\n\r\n    if (\r\n      relative === \"..\" ||\r\n      relative.startsWith(`..${path.sep}`) ||\r\n      path.isAbsolute(relative)\r\n    ) {\r\n      throw new CacheError(\r\n        `Cache key resolves outside the cache directory: \"${segment}\"`,\r\n      );\r\n    }\r\n\r\n    return resolved;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Dotted keys (`ns.a`) are stored as sibling directories, not nested ones\r\n   * (see {@link keyDirectory}) — a directory literally named `<namespace>`\r\n   * rarely exists on its own. Namespace removal therefore has to scan the\r\n   * cache root's immediate children and remove every directory whose\r\n   * *logical* (decoded) name equals the namespace or starts with\r\n   * `<namespace>.`, mirroring the `key = $1 OR key LIKE $2` boundary\r\n   * semantics the `pg` driver already uses for the same contract.\r\n   */\r\n  public async removeNamespace(namespace: string) {\r\n    const parsedNamespace = this.parseKey(namespace);\r\n\r\n    this.log(\"clearing\", namespace);\r\n\r\n    try {\r\n      const root = this.containedPath(\"\");\r\n\r\n      if (parsedNamespace === \"\") {\r\n        await removeDirectoryAsync(root);\r\n        this.log(\"cleared\", namespace);\r\n        return this;\r\n      }\r\n\r\n      const prefix = `${parsedNamespace}.`;\r\n      const entries = await listDirectoriesAsync(root).catch(() => [] as string[]);\r\n\r\n      await Promise.all(\r\n        entries.map(async (entryPath) => {\r\n          const decoded = this.decodeKeySegment(path.basename(entryPath));\r\n\r\n          if (decoded === parsedNamespace || decoded.startsWith(prefix)) {\r\n            await removeDirectoryAsync(entryPath);\r\n          }\r\n        }),\r\n      );\r\n\r\n      this.log(\"cleared\", namespace);\r\n    } catch (error) {\r\n      //\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async set(\r\n    key: CacheKey,\r\n    value: any,\r\n    ttlOrOptions?: CacheTtl | CacheSetOptions,\r\n  ): Promise<any> {\r\n    const parsedKey = this.parseKey(key);\r\n    const { ttl, tags, onConflict, vector, staleAt } = this.resolveSetOptions(ttlOrOptions);\r\n\r\n    if (vector) {\r\n      throw new CacheUnsupportedError(\r\n        \"'file' driver does not support similarity retrieval — use a memory driver, 'pg' (with pgvector), or 'redis' (with RediSearch).\",\r\n      );\r\n    }\r\n\r\n    this.log(\"caching\", parsedKey);\r\n\r\n    const existing = onConflict === \"upsert\" ? null : await this.get(key);\r\n    const exists = existing !== null;\r\n\r\n    if (onConflict === \"create\" && exists) {\r\n      const result: CacheSetResult = { wasSet: false, existing };\r\n      return result;\r\n    }\r\n\r\n    if (onConflict === \"update\" && !exists) {\r\n      const result: CacheSetResult = { wasSet: false, existing: null };\r\n      return result;\r\n    }\r\n\r\n    const data = this.prepareDataForStorage(value, ttl, staleAt);\r\n\r\n    const fileDirectory = this.keyDirectory(parsedKey);\r\n\r\n    await ensureDirectoryAsync(fileDirectory);\r\n\r\n    await putJsonFileAsync(path.resolve(fileDirectory, this.fileName), data);\r\n\r\n    if (tags && tags.length > 0) {\r\n      await this.applyTags(parsedKey, tags);\r\n    }\r\n\r\n    this.log(\"cached\", parsedKey);\r\n\r\n    await this.emit(\"set\", { key: parsedKey, value, ttl });\r\n\r\n    if (onConflict === \"create\" || onConflict === \"update\") {\r\n      const result: CacheSetResult = { wasSet: true, existing: null };\r\n      return result;\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * File driver does not yet ship with a file-lock primitive, so concurrent\r\n   * writers could clobber each other. Rather than ship an unsafe default, we\r\n   * throw — consumers can fall back to memory/redis for `update` until a\r\n   * proper file lock lands (tracked in `domains/cache/backlog.md`).\r\n   */\r\n  public async update(): Promise<never> {\r\n    throw new CacheUnsupportedError(\r\n      \"`update()` is not supported on the file driver. Use the memory or redis driver, or wait for the file-lock primitive (see domains/cache/backlog.md).\",\r\n    );\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async merge(): Promise<never> {\r\n    throw new CacheUnsupportedError(\r\n      \"`merge()` is not supported on the file driver. Use the memory or redis driver.\",\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Read the raw {@link CacheData} wrapper from disk, including `staleAt`\r\n   * metadata. Returns `null` for missing or expired files — `swr()`\r\n   * consumes this to branch on freshness.\r\n   */\r\n  protected async getEntry(key: CacheKey): Promise<CacheData | null> {\r\n    const parsedKey = this.parseKey(key);\r\n    const fileDirectory = this.keyDirectory(parsedKey);\r\n\r\n    try {\r\n      const entry = (await getJsonFileAsync(path.resolve(fileDirectory, this.fileName))) as\r\n        | CacheData\r\n        | undefined;\r\n\r\n      if (!entry) {\r\n        return null;\r\n      }\r\n\r\n      if (entry.expiresAt !== undefined && entry.expiresAt <= Date.now()) {\r\n        return null;\r\n      }\r\n\r\n      return entry;\r\n    } catch {\r\n      return null;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async get(key: CacheKey) {\r\n    const parsedKey = this.parseKey(key);\r\n\r\n    this.log(\"fetching\", parsedKey);\r\n\r\n    const fileDirectory = this.keyDirectory(parsedKey);\r\n\r\n    try {\r\n      const value = await getJsonFileAsync(path.resolve(fileDirectory, this.fileName));\r\n\r\n      const result = await this.parseCachedData(parsedKey, value as CacheData);\r\n\r\n      if (result === null) {\r\n        // Expired\r\n        await this.emit(\"miss\", { key: parsedKey });\r\n      } else {\r\n        // Emit hit event\r\n        await this.emit(\"hit\", { key: parsedKey, value: result });\r\n      }\r\n\r\n      return result;\r\n    } catch (error) {\r\n      this.log(\"notFound\", parsedKey);\r\n      // Emit miss event\r\n      await this.emit(\"miss\", { key: parsedKey });\r\n      // Await the cleanup so it fully settles before returning. Leaving this\r\n      // fire-and-forget let the async directory removal race a follow-up write\r\n      // to the same key (e.g. the existence probe inside a `set({ onConflict })`\r\n      // call), surfacing as an ENOENT mkdir/rm collision on Windows.\r\n      await this.remove(key);\r\n      return null;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async remove(key: CacheKey) {\r\n    const parsedKey = this.parseKey(key);\r\n    this.log(\"removing\", parsedKey);\r\n\r\n    const fileDirectory = this.keyDirectory(parsedKey);\r\n\r\n    try {\r\n      await removeDirectoryAsync(fileDirectory);\r\n\r\n      this.log(\"removed\", parsedKey);\r\n      // Emit removed event\r\n      await this.emit(\"removed\", { key: parsedKey });\r\n    } catch (error) {\r\n      //\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async flush() {\r\n    this.log(\"flushing\");\r\n\r\n    if (this.options.globalPrefix) {\r\n      await this.removeNamespace(\"\");\r\n    } else {\r\n      await removeDirectoryAsync(this.directory);\r\n    }\r\n\r\n    this.log(\"flushed\");\r\n\r\n    // Emit flushed event\r\n    await this.emit(\"flushed\");\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async connect() {\r\n    this.log(\"connecting\");\r\n    await ensureDirectoryAsync(this.directory);\r\n    this.log(\"connected\");\r\n    await this.emit(\"connected\");\r\n  }\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"file-cache-driver.mjs","names":[],"sources":["../../../../../../../cache/src/drivers/file-cache-driver.ts"],"sourcesContent":["import {\r\n  ensureDirectoryAsync,\r\n  getJsonFileAsync,\r\n  listDirectoriesAsync,\r\n  putJsonFileAsync,\r\n  removeDirectoryAsync,\r\n} from \"@warlock.js/fs\";\r\nimport path from \"path\";\r\nimport type {\r\n  CacheData,\r\n  CacheDriver,\r\n  CacheKey,\r\n  CacheSetOptions,\r\n  CacheSetResult,\r\n  CacheTtl,\r\n  FileCacheOptions,\r\n} from \"../types\";\r\nimport { CacheConfigurationError, CacheError, CacheUnsupportedError } from \"../types\";\r\nimport { BaseCacheDriver } from \"./base-cache-driver\";\r\n\r\nexport class FileCacheDriver\r\n  extends BaseCacheDriver<FileCacheDriver, FileCacheOptions>\r\n  implements CacheDriver<FileCacheDriver, FileCacheOptions>\r\n{\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public name = \"file\";\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public setOptions(options: FileCacheOptions) {\r\n    if (!options.directory) {\r\n      throw new CacheConfigurationError(\r\n        \"File driver requires 'directory' option to be configured.\",\r\n      );\r\n    }\r\n\r\n    return super.setOptions(options);\r\n  }\r\n\r\n  /**\r\n   * Get the cache directory\r\n   */\r\n  public get directory() {\r\n    const directory = this.options.directory;\r\n\r\n    if (typeof directory === \"function\") {\r\n      return directory();\r\n    }\r\n\r\n    throw new CacheConfigurationError(\r\n      \"Cache directory is not defined, please define it in the file driver options\",\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get file name\r\n   */\r\n  public get fileName() {\r\n    const fileName = this.options.fileName;\r\n\r\n    if (typeof fileName === \"function\") {\r\n      return fileName();\r\n    }\r\n\r\n    return \"cache.json\";\r\n  }\r\n\r\n  /**\r\n   * Map a parsed cache key (or namespace) to its on-disk directory.\r\n   *\r\n   * The key must become exactly one directory component: `%` and the path\r\n   * separators are percent-encoded so a hostile key (`../../etc`,\r\n   * `..\\\\..\\\\evil`) turns into an inert directory name instead of a path\r\n   * traversal, while distinct keys can never collide after encoding. Dots are\r\n   * left untouched — the `.`-delimited namespace scheme is purely logical and\r\n   * only ever produces a single filesystem component here.\r\n   */\r\n  protected keyDirectory(parsedKey: string): string {\r\n    return this.containedPath(this.encodeKeySegment(parsedKey));\r\n  }\r\n\r\n  /**\r\n   * Percent-encode a parsed key into an inert, single-component directory\r\n   * name. Dots are left untouched — see {@link keyDirectory}.\r\n   */\r\n  protected encodeKeySegment(parsedKey: string): string {\r\n    return parsedKey\r\n      .replace(/%/g, \"%25\")\r\n      .replace(/\\//g, \"%2F\")\r\n      .replace(/\\\\/g, \"%5C\");\r\n  }\r\n\r\n  /**\r\n   * Reverse of {@link encodeKeySegment} — recovers the logical, dot-delimited\r\n   * parsed key from an on-disk directory name. Used by {@link removeNamespace}\r\n   * to test which sibling directories logically belong to a namespace, since\r\n   * dotted keys (`ns.a`) are stored as sibling directories rather than nested\r\n   * ones (see {@link keyDirectory}'s doc comment).\r\n   */\r\n  protected decodeKeySegment(encoded: string): string {\r\n    return encoded\r\n      .replace(/%2F/g, \"/\")\r\n      .replace(/%5C/g, \"\\\\\")\r\n      .replace(/%25/g, \"%\");\r\n  }\r\n\r\n  /**\r\n   * Resolve `segment` against the cache root and throw when the result lands\r\n   * outside it — the last line of defense against path traversal, independent\r\n   * of how the key was encoded.\r\n   */\r\n  protected containedPath(segment: string): string {\r\n    const base = path.resolve(this.directory);\r\n    const resolved = path.resolve(base, segment);\r\n    const relative = path.relative(base, resolved);\r\n\r\n    if (\r\n      relative === \"..\" ||\r\n      relative.startsWith(`..${path.sep}`) ||\r\n      path.isAbsolute(relative)\r\n    ) {\r\n      throw new CacheError(\r\n        `Cache key resolves outside the cache directory: \"${segment}\"`,\r\n      );\r\n    }\r\n\r\n    return resolved;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * Dotted keys (`ns.a`) are stored as sibling directories, not nested ones\r\n   * (see {@link keyDirectory}) — a directory literally named `<namespace>`\r\n   * rarely exists on its own. Namespace removal therefore has to scan the\r\n   * cache root's immediate children and remove every directory whose\r\n   * *logical* (decoded) name equals the namespace or starts with\r\n   * `<namespace>.`, mirroring the `key = $1 OR key LIKE $2` boundary\r\n   * semantics the `pg` driver already uses for the same contract.\r\n   */\r\n  public async removeNamespace(namespace: string) {\r\n    const parsedNamespace = this.parseKey(namespace);\r\n\r\n    this.log(\"clearing\", namespace);\r\n\r\n    try {\r\n      const root = this.containedPath(\"\");\r\n\r\n      if (parsedNamespace === \"\") {\r\n        await removeDirectoryAsync(root);\r\n        this.log(\"cleared\", namespace);\r\n        return this;\r\n      }\r\n\r\n      const prefix = `${parsedNamespace}.`;\r\n      const entries = await listDirectoriesAsync(root).catch(() => [] as string[]);\r\n\r\n      await Promise.all(\r\n        entries.map(async (entryPath) => {\r\n          const decoded = this.decodeKeySegment(path.basename(entryPath));\r\n\r\n          if (decoded === parsedNamespace || decoded.startsWith(prefix)) {\r\n            await removeDirectoryAsync(entryPath);\r\n          }\r\n        }),\r\n      );\r\n\r\n      this.log(\"cleared\", namespace);\r\n    } catch (error) {\r\n      //\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async set(\r\n    key: CacheKey,\r\n    value: any,\r\n    ttlOrOptions?: CacheTtl | CacheSetOptions,\r\n  ): Promise<any> {\r\n    const parsedKey = this.parseKey(key);\r\n    const { ttl, tags, onConflict, vector, staleAt } = this.resolveSetOptions(ttlOrOptions);\r\n\r\n    if (vector) {\r\n      throw new CacheUnsupportedError(\r\n        \"'file' driver does not support similarity retrieval — use a memory driver, 'pg' (with pgvector), or 'redis' (with RediSearch).\",\r\n      );\r\n    }\r\n\r\n    this.log(\"caching\", parsedKey);\r\n\r\n    const existing = onConflict === \"upsert\" ? null : await this.get(key);\r\n    const exists = existing !== null;\r\n\r\n    if (onConflict === \"create\" && exists) {\r\n      const result: CacheSetResult = { wasSet: false, existing };\r\n      return result;\r\n    }\r\n\r\n    if (onConflict === \"update\" && !exists) {\r\n      const result: CacheSetResult = { wasSet: false, existing: null };\r\n      return result;\r\n    }\r\n\r\n    const data = this.prepareDataForStorage(value, ttl, staleAt);\r\n\r\n    const fileDirectory = this.keyDirectory(parsedKey);\r\n\r\n    await ensureDirectoryAsync(fileDirectory);\r\n\r\n    await putJsonFileAsync(path.resolve(fileDirectory, this.fileName), data);\r\n\r\n    if (tags && tags.length > 0) {\r\n      await this.applyTags(parsedKey, tags);\r\n    }\r\n\r\n    this.log(\"cached\", parsedKey);\r\n\r\n    await this.emit(\"set\", { key: parsedKey, value, ttl });\r\n\r\n    if (onConflict === \"create\" || onConflict === \"update\") {\r\n      const result: CacheSetResult = { wasSet: true, existing: null };\r\n      return result;\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   *\r\n   * File driver does not yet ship with a file-lock primitive, so concurrent\r\n   * writers could clobber each other. Rather than ship an unsafe default, we\r\n   * throw — consumers can fall back to memory/redis for `update` until a\r\n   * proper file lock lands (tracked in `domains/cache/backlog.md`).\r\n   */\r\n  public async update(): Promise<never> {\r\n    throw new CacheUnsupportedError(\r\n      \"`update()` is not supported on the file driver. Use the memory or redis driver, or wait for the file-lock primitive (see domains/cache/backlog.md).\",\r\n    );\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async merge(): Promise<never> {\r\n    throw new CacheUnsupportedError(\r\n      \"`merge()` is not supported on the file driver. Use the memory or redis driver.\",\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Read the raw {@link CacheData} wrapper from disk, including `staleAt`\r\n   * metadata. Returns `null` for missing or expired files — `swr()`\r\n   * consumes this to branch on freshness.\r\n   */\r\n  protected async getEntry(key: CacheKey): Promise<CacheData | null> {\r\n    const parsedKey = this.parseKey(key);\r\n    const fileDirectory = this.keyDirectory(parsedKey);\r\n\r\n    try {\r\n      const entry = (await getJsonFileAsync(path.resolve(fileDirectory, this.fileName))) as\r\n        | CacheData\r\n        | undefined;\r\n\r\n      if (!entry) {\r\n        return null;\r\n      }\r\n\r\n      if (entry.expiresAt !== undefined && entry.expiresAt <= Date.now()) {\r\n        return null;\r\n      }\r\n\r\n      return entry;\r\n    } catch {\r\n      return null;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async get(key: CacheKey) {\r\n    const parsedKey = this.parseKey(key);\r\n\r\n    this.log(\"fetching\", parsedKey);\r\n\r\n    const fileDirectory = this.keyDirectory(parsedKey);\r\n\r\n    try {\r\n      const value = await getJsonFileAsync(path.resolve(fileDirectory, this.fileName));\r\n\r\n      const result = await this.parseCachedData(parsedKey, value as CacheData);\r\n\r\n      if (result === null) {\r\n        // Expired\r\n        await this.emit(\"miss\", { key: parsedKey });\r\n      } else {\r\n        // Emit hit event\r\n        await this.emit(\"hit\", { key: parsedKey, value: result });\r\n      }\r\n\r\n      return result;\r\n    } catch (error) {\r\n      this.log(\"notFound\", parsedKey);\r\n      // Emit miss event\r\n      await this.emit(\"miss\", { key: parsedKey });\r\n      // Await the cleanup so it fully settles before returning. Leaving this\r\n      // fire-and-forget let the async directory removal race a follow-up write\r\n      // to the same key (e.g. the existence probe inside a `set({ onConflict })`\r\n      // call), surfacing as an ENOENT mkdir/rm collision on Windows.\r\n      await this.remove(key);\r\n      return null;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async remove(key: CacheKey) {\r\n    const parsedKey = this.parseKey(key);\r\n    this.log(\"removing\", parsedKey);\r\n\r\n    const fileDirectory = this.keyDirectory(parsedKey);\r\n\r\n    try {\r\n      await removeDirectoryAsync(fileDirectory);\r\n\r\n      this.log(\"removed\", parsedKey);\r\n      // Emit removed event\r\n      await this.emit(\"removed\", { key: parsedKey });\r\n    } catch (error) {\r\n      //\r\n    }\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async flush() {\r\n    this.log(\"flushing\");\r\n\r\n    if (this.options.globalPrefix) {\r\n      await this.removeNamespace(\"\");\r\n    } else {\r\n      await removeDirectoryAsync(this.directory);\r\n    }\r\n\r\n    this.log(\"flushed\");\r\n\r\n    // Emit flushed event\r\n    await this.emit(\"flushed\");\r\n  }\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public async connect() {\r\n    this.log(\"connecting\");\r\n    await ensureDirectoryAsync(this.directory);\r\n    this.log(\"connected\");\r\n    await this.emit(\"connected\");\r\n  }\r\n}\r\n"],"mappings":"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"}

package/esm/drivers/lru-memory-cache-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"lru-memory-cache-driver.d.mts","names":[],"sources":["../../../../../../../cache/src/drivers/lru-memory-cache-driver.ts"],"mappings":";;;;cAcM,SAAA;EAeK,GAAA;EACA,KAAA;EAfF,IAAA,EAAM,SAAA;EACN,IAAA,EAAM,SAAS;EACf,SAAA;EAYE;;;;EAPF,OAAA;EANM;;;;EAWN,MAAA;cAEE,GAAA,UACA,KAAA,OACP,GAAA;EAAA,IAOS,SAAA,CAAA;AAAA;;;AAAS;AAWtB;;;cAAa,oBAAA,SACH,eAAA,CAAgB,oBAAA,EAAsB,qBAAA,aACnC,WAAA,CAAY,oBAAA,EAAsB,qBAAA;EADC;;;EAMvC,IAAA;EAKU;;;EAAA,UAAP,KAAA,EAAO,GAAA,SAAY,SAAA;EA8EiB;;;EAAA,UAzEpC,IAAA,EAAM,SAAA;EAmHb;;;EAAA,UA9GO,IAAA,EAAM,SAAA;EAoOc;;;EAAA,UA/NpB,eAAA,GAAkB,MAAA,CAAO,OAAA;EAiPL;;;;EA6GnB;;;EA/UJ,IAAA,CAAA;EA+XgB;;;EAvXhB,YAAA,CAAA;EAhDe;;;;;;;;EAwFT,eAAA,CAAgB,SAAA,WAAiB,OAAA;EA9E7B;;;EAoHJ,GAAA,CACX,GAAA,EAAK,QAAA,EACL,KAAA,OACA,YAAA,GAAe,QAAA,GAAW,eAAA,GACzB,OAAA;EA9GO;;;EAAA,UA4LA,QAAA,CAAS,IAAA,EAAM,SAAA;EAvLU;;;EAAA,UA+LzB,UAAA,CAAW,IAAA,EAAM,SAAA;EAhId;;;EAAA,UAwIH,OAAA,CAAQ,IAAA,EAAM,SAAA;EAjGjB;;;EAAA,UA2GG,UAAA,CAAA;EAzGkB;;;;;;EAAA,UAuHZ,QAAA,CAAS,GAAA,EAAK,QAAA,GAAW,OAAA,CAAQ,SAAA;EAhCtB;;;EAkDd,GAAA,CAAI,GAAA,EAAK,QAAA,GAAQ,OAAA;EA1CZ;;;EAoGL,MAAA,CAAO,GAAA,EAAK,QAAA,GAAQ,OAAA;EA5ER;;;;;;;EAqGZ,KAAA,CAAA,GAAK,OAAA;EAzBO;;;;;;;;;EAiDZ,OAAA,SAAA,CACX,MAAA,YACA,OAAA,EAAS,mBAAA,GACR,OAAA,CAAQ,eAAA,CAAgB,CAAA;EAAxB;;;EAAA,IAwCQ,QAAA,CAAA;EAOE;;;EAAA,UAAA,CAAA,GAAU,OAAA;AAAA"}
+{"version":3,"file":"lru-memory-cache-driver.d.mts","names":[],"sources":["../../../../../../../cache/src/drivers/lru-memory-cache-driver.ts"],"mappings":";;;;cAcM,SAAA;EAeK,GAAA;EACA,KAAA;EAfF,IAAA,EAAM,SAAA;EACN,IAAA,EAAM,SAAS;EACf,SAAA;EAYE;;;;EAPF,OAAA;EANM;;;;EAWN,MAAA;cAEE,GAAA,UACA,KAAA,OACP,GAAA;EAAA,IAOS,SAAA;AAAA;;;AAAS;AAWtB;;;cAAa,oBAAA,SACH,eAAA,CAAgB,oBAAA,EAAsB,qBAAA,aACnC,WAAA,CAAY,oBAAA,EAAsB,qBAAA;EADC;;;EAMvC,IAAA;EAKU;;;EAAA,UAAP,KAAA,EAAO,GAAA,SAAY,SAAA;EA8EiB;;;EAAA,UAzEpC,IAAA,EAAM,SAAA;EAmHb;;;EAAA,UA9GO,IAAA,EAAM,SAAA;EAoOc;;;EAAA,UA/NpB,eAAA,GAAkB,MAAA,CAAO,OAAA;EAiPL;;;;EA6GnB;;;EA/UJ,IAAA;EA+XgB;;;EAvXhB,YAAA;EAhDe;;;;;;;;EAwFT,eAAA,CAAgB,SAAA,WAAiB,OAAA;EA9E7B;;;EAoHJ,GAAA,CACX,GAAA,EAAK,QAAA,EACL,KAAA,OACA,YAAA,GAAe,QAAA,GAAW,eAAA,GACzB,OAAA;EA9GO;;;EAAA,UA4LA,QAAA,CAAS,IAAA,EAAM,SAAA;EAvLU;;;EAAA,UA+LzB,UAAA,CAAW,IAAA,EAAM,SAAA;EAhId;;;EAAA,UAwIH,OAAA,CAAQ,IAAA,EAAM,SAAA;EAjGjB;;;EAAA,UA2GG,UAAA;EAzGkB;;;;;;EAAA,UAuHZ,QAAA,CAAS,GAAA,EAAK,QAAA,GAAW,OAAA,CAAQ,SAAA;EAhCtB;;;EAkDd,GAAA,CAAI,GAAA,EAAK,QAAA,GAAQ,OAAA;EA1CZ;;;EAoGL,MAAA,CAAO,GAAA,EAAK,QAAA,GAAQ,OAAA;EA5ER;;;;;;;EAqGZ,KAAA,IAAK,OAAA;EAzBO;;;;;;;;;EAiDZ,OAAA,UACX,MAAA,YACA,OAAA,EAAS,mBAAA,GACR,OAAA,CAAQ,eAAA,CAAgB,CAAA;EAAxB;;;EAAA,IAwCQ,QAAA;EAOE;;;EAAA,UAAA,IAAU,OAAA;AAAA"}

package/esm/drivers/memory-cache-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-cache-driver.d.mts","names":[],"sources":["../../../../../../../cache/src/drivers/memory-cache-driver.ts"],"mappings":";;;;;cAgBa,iBAAA,SACH,eAAA,CAAgB,iBAAA,EAAmB,kBAAA,aAChC,WAAA,CAAY,iBAAA,EAAmB,kBAAA;;AAF5C;;EAOS,IAAA;EANiB;;;EAWjB,IAAA,EAAM,aAAA;EAAA;;;EAAA,UAKH,aAAA,EAAe,MAAA;IAGrB,GAAA;IACA,SAAA;EAAA;EA2FwB;;;EAAA,UApFlB,eAAA,GAAkB,MAAA,CAAO,OAAA;EAkLL;;;EAAA,UA7KpB,WAAA;EA+LuB;;;;;EAAA,UAxLvB,WAAA,EAAa,GAAA;EAuTZ;;;;EA7VA;;;EAoDJ,YAAA,CAAA;EArDiB;;;EAiFX,eAAA,CAAgB,SAAA,WAAiB,OAAA;EAhFJ;;;EA2G7B,GAAA,CACX,GAAA,EAAK,QAAA,EACL,KAAA,OACA,YAAA,GAAe,QAAA,GAAW,eAAA,GACzB,OAAA;EAhGO;;;EA2JG,GAAA,CAAI,GAAA,EAAK,QAAA,GAAQ,OAAA;EAhJpB;;;;;EAAA,UAkLM,QAAA,CAAS,GAAA,EAAK,QAAA,GAAW,OAAA,CAAQ,SAAA;;;;EAkBpC,MAAA,CAAO,GAAA,EAAK,QAAA,GAAQ,OAAA;EA9Ia;;;EAuKjC,KAAA,CAAA,GAAK,OAAA;EA1IhB;;;EAAA,UA6JQ,gBAAA,CAAiB,GAAA,EAAK,QAAA,EAAU,SAAA,UAAmB,GAAA;EA3J1D;;;EAAA,UAqKO,WAAA,CAAY,GAAA;EA1GQ;;;EAAA,UA0HpB,qBAAA,CAAsB,GAAA;EAxFS;;;;;;;EAAA,UAsGzB,cAAA,CAAA,GAAc,OAAA;EAxCpB;;;EAAA,UAiEA,YAAA,CAAA;EAjEmD;;;;;;;;;;EAgFhD,OAAA,SAAA,CACX,MAAA,YACA,OAAA,EAAS,mBAAA,GACR,OAAA,CAAQ,eAAA,CAAgB,CAAA;EADhB;;;EAuCE,UAAA,CAAA,GAAU,OAAA;AAAA"}
+{"version":3,"file":"memory-cache-driver.d.mts","names":[],"sources":["../../../../../../../cache/src/drivers/memory-cache-driver.ts"],"mappings":";;;;;cAgBa,iBAAA,SACH,eAAA,CAAgB,iBAAA,EAAmB,kBAAA,aAChC,WAAA,CAAY,iBAAA,EAAmB,kBAAA;;AAF5C;;EAOS,IAAA;EANiB;;;EAWjB,IAAA,EAAM,aAAA;EAAA;;;EAAA,UAKH,aAAA,EAAe,MAAA;IAGrB,GAAA;IACA,SAAA;EAAA;EA2FwB;;;EAAA,UApFlB,eAAA,GAAkB,MAAA,CAAO,OAAA;EAkLL;;;EAAA,UA7KpB,WAAA;EA+LuB;;;;;EAAA,UAxLvB,WAAA,EAAa,GAAA;EAuTZ;;;;EA7VA;;;EAoDJ,YAAA;EArDiB;;;EAiFX,eAAA,CAAgB,SAAA,WAAiB,OAAA;EAhFJ;;;EA2G7B,GAAA,CACX,GAAA,EAAK,QAAA,EACL,KAAA,OACA,YAAA,GAAe,QAAA,GAAW,eAAA,GACzB,OAAA;EAhGO;;;EA2JG,GAAA,CAAI,GAAA,EAAK,QAAA,GAAQ,OAAA;EAhJpB;;;;;EAAA,UAkLM,QAAA,CAAS,GAAA,EAAK,QAAA,GAAW,OAAA,CAAQ,SAAA;;;;EAkBpC,MAAA,CAAO,GAAA,EAAK,QAAA,GAAQ,OAAA;EA9Ia;;;EAuKjC,KAAA,IAAK,OAAA;EA1IhB;;;EAAA,UA6JQ,gBAAA,CAAiB,GAAA,EAAK,QAAA,EAAU,SAAA,UAAmB,GAAA;EA3J1D;;;EAAA,UAqKO,WAAA,CAAY,GAAA;EA1GQ;;;EAAA,UA0HpB,qBAAA,CAAsB,GAAA;EAxFS;;;;;;;EAAA,UAsGzB,cAAA,IAAc,OAAA;EAxCpB;;;EAAA,UAiEA,YAAA;EAjEmD;;;;;;;;;;EAgFhD,OAAA,UACX,MAAA,YACA,OAAA,EAAS,mBAAA,GACR,OAAA,CAAQ,eAAA,CAAgB,CAAA;EADhB;;;EAuCE,UAAA,IAAU,OAAA;AAAA"}