alepha 0.23.0 → 0.24.0

package/dist/cache/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/cache/core/errors/CacheError.ts","../../../src/cache/core/providers/CacheProvider.ts","../../../src/cache/core/providers/MemoryCacheProvider.ts","../../../src/cache/core/primitives/$cache.ts","../../../src/cache/core/providers/CloudflareKVProvider.ts","../../../src/cache/core/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class CacheError extends AlephaError {}\n","import { CacheError } from \"../errors/CacheError.ts\";\n\n/**\n * Cache provider interface.\n *\n * All methods are asynchronous and return promises.\n * Values are stored as Uint8Array.\n */\nexport abstract class CacheProvider {\n  protected encoder: TextEncoder = new TextEncoder();\n  protected decoder: TextDecoder = new TextDecoder();\n  protected codes = {\n    BINARY: 0x01,\n    JSON: 0x02,\n    STRING: 0x03,\n    COMPRESSED: 0x04,\n  };\n\n  /**\n   * Get the value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to get.\n   *\n   * @return The value of the key, or undefined if the key does not exist.\n   */\n  public abstract get(\n    name: string,\n    key: string,\n  ): Promise<Uint8Array | undefined>;\n\n  /**\n   * Set the string value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to set.\n   * @param value The value to set.\n   * @param ttl The time-to-live of the key, in milliseconds.\n   *\n   * @return The value of the key.\n   */\n  public abstract set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array>;\n\n  /**\n   * Remove the specified keys.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param keys The keys to delete.\n   */\n  public abstract del(name: string, ...keys: string[]): Promise<void>;\n\n  public abstract has(name: string, key: string): Promise<boolean>;\n\n  public abstract keys(name: string, filter?: string): Promise<string[]>;\n\n  /**\n   * Remove all keys from all cache names.\n   */\n  public abstract clear(): Promise<void>;\n\n  /**\n   * Increment the integer value of a key by the given amount.\n   *\n   * If the key does not exist, it is set to 0 before performing the operation.\n   * This operation is atomic when using Redis.\n   *\n   * @param name Cache name, used to group keys.\n   * @param key The key to increment.\n   * @param amount The amount to increment by.\n   * @returns The new value after incrementing.\n   */\n  public abstract incr(\n    name: string,\n    key: string,\n    amount: number,\n  ): Promise<number>;\n\n  // ---------------------------------------------------------------------------\n  // High-level methods — serialize/compress layer used by CachePrimitive\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Set a typed value with automatic serialization and optional compression.\n   */\n  public async setTyped(\n    name: string,\n    key: string,\n    value: unknown,\n    options?: { ttl?: number; compress?: boolean },\n  ): Promise<void> {\n    let data = this.serialize(value);\n    if (options?.compress) {\n      data = await this.compress(data);\n    }\n    await this.set(name, key, data, options?.ttl);\n  }\n\n  /**\n   * Get a typed value with automatic deserialization and optional decompression.\n   */\n  public async getTyped<T>(name: string, key: string): Promise<T | undefined> {\n    const data = await this.get(name, key);\n    if (data) {\n      if (data[0] === this.codes.COMPRESSED) {\n        const decompressed = await this.decompress(data.subarray(1));\n        return this.deserialize<T>(decompressed);\n      }\n      return this.deserialize<T>(data);\n    }\n    return undefined;\n  }\n\n  /**\n   * Invalidate cache keys with wildcard support.\n   *\n   * Keys ending in `*` are expanded via `this.keys()`.\n   * Called with no keys, delegates to `this.del(name)` which clears the entire container.\n   */\n  public async invalidateKeys(name: string, keys: string[]): Promise<void> {\n    const keysToDelete: string[] = [];\n\n    for (const key of keys) {\n      if (key.endsWith(\"*\")) {\n        const result = await this.keys(name, key.slice(0, -1));\n        keysToDelete.push(...result);\n      } else {\n        keysToDelete.push(key);\n      }\n    }\n\n    await this.del(name, ...keysToDelete);\n  }\n\n  /**\n   * Serialize a value to a typed Uint8Array with a leading type marker byte.\n   */\n  protected serialize(value: unknown): Uint8Array {\n    if (value instanceof Uint8Array) {\n      const result = new Uint8Array(1 + value.length);\n      result[0] = this.codes.BINARY;\n      result.set(value, 1);\n      return result;\n    }\n\n    const encoded = this.encoder.encode(\n      typeof value === \"string\" ? value : JSON.stringify(value),\n    );\n    const code =\n      typeof value === \"string\" ? this.codes.STRING : this.codes.JSON;\n    const result = new Uint8Array(1 + encoded.length);\n    result[0] = code;\n    result.set(encoded, 1);\n    return result;\n  }\n\n  /**\n   * Deserialize a typed Uint8Array back to the original value.\n   */\n  protected deserialize<T>(uint8Array: Uint8Array): T {\n    const type = uint8Array[0];\n    const payload = uint8Array.slice(1);\n\n    if (type === this.codes.BINARY) {\n      return payload as T;\n    }\n    if (type === this.codes.JSON) {\n      return JSON.parse(this.decoder.decode(payload)) as T;\n    }\n    if (type === this.codes.STRING) {\n      return this.decoder.decode(payload) as T;\n    }\n\n    throw new CacheError(`Unknown serialization type: ${type}`);\n  }\n\n  /**\n   * Compress data with gzip, prepending a COMPRESSED marker byte.\n   */\n  protected async compress(data: Uint8Array): Promise<Uint8Array> {\n    const buf = (data.buffer as ArrayBuffer).slice(\n      data.byteOffset,\n      data.byteOffset + data.byteLength,\n    );\n    const compressed = new Uint8Array(\n      await new Response(\n        new Blob([buf]).stream().pipeThrough(new CompressionStream(\"gzip\")),\n      ).arrayBuffer(),\n    );\n    const result = new Uint8Array(1 + compressed.length);\n    result[0] = this.codes.COMPRESSED;\n    result.set(compressed, 1);\n    return result;\n  }\n\n  /**\n   * Decompress gzipped data.\n   */\n  protected async decompress(data: Uint8Array): Promise<Uint8Array> {\n    const buf = (data.buffer as ArrayBuffer).slice(\n      data.byteOffset,\n      data.byteOffset + data.byteLength,\n    );\n    return new Uint8Array(\n      await new Response(\n        new Blob([buf]).stream().pipeThrough(new DecompressionStream(\"gzip\")),\n      ).arrayBuffer(),\n    );\n  }\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { CacheProvider } from \"./CacheProvider.ts\";\n\ntype CacheName = string;\ntype CacheKey = string;\ntype CacheValue = {\n  data?: Uint8Array;\n  timeout?: Timeout;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface MemoryCacheCall {\n  name: string;\n  key: string;\n  timestamp: number;\n}\n\nexport interface MemoryCacheSetCall extends MemoryCacheCall {\n  value: Uint8Array;\n  ttl?: number;\n}\n\nexport interface MemoryCacheDelCall {\n  name: string;\n  keys: string[];\n  timestamp: number;\n}\n\nexport interface MemoryCacheStats {\n  hits: number;\n  misses: number;\n  sets: number;\n  deletes: number;\n}\n\nexport interface MemoryCacheProviderOptions {\n  /**\n   * Error to throw on get operations (for testing error handling)\n   */\n  getError?: Error | null;\n  /**\n   * Error to throw on set operations (for testing error handling)\n   */\n  setError?: Error | null;\n  /**\n   * Error to throw on del operations (for testing error handling)\n   */\n  delError?: Error | null;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * In-memory implementation of CacheProvider for testing.\n *\n * This provider stores all cache entries in memory, making it ideal for\n * unit tests that need to verify cache operations without touching Redis or other backends.\n *\n * @example\n * ```typescript\n * // In tests, substitute the real CacheProvider with MemoryCacheProvider\n * const alepha = Alepha.create().with({\n *   provide: CacheProvider,\n *   use: MemoryCacheProvider,\n * });\n *\n * // Run code that uses caching\n * const service = alepha.inject(MyService);\n * await service.fetchWithCache(\"key\");\n *\n * // Verify cache behavior\n * const cache = alepha.inject(MemoryCacheProvider);\n * expect(cache.stats().misses).toBe(1);\n * await service.fetchWithCache(\"key\");\n * expect(cache.stats().hits).toBe(1);\n * ```\n */\nexport class MemoryCacheProvider extends CacheProvider {\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly log = $logger();\n\n  protected store: Record<CacheName, Record<CacheKey, CacheValue>> = {};\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Test tracking\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  /**\n   * All recorded get calls.\n   */\n  public getCalls: MemoryCacheCall[] = [];\n\n  /**\n   * All recorded set calls.\n   */\n  public setCalls: MemoryCacheSetCall[] = [];\n\n  /**\n   * All recorded del calls.\n   */\n  public delCalls: MemoryCacheDelCall[] = [];\n\n  /**\n   * Cache statistics.\n   */\n  protected _stats: MemoryCacheStats = {\n    hits: 0,\n    misses: 0,\n    sets: 0,\n    deletes: 0,\n  };\n\n  /**\n   * Error to throw on get (for testing error handling)\n   */\n  public getError: Error | null = null;\n\n  /**\n   * Error to throw on set (for testing error handling)\n   */\n  public setError: Error | null = null;\n\n  /**\n   * Error to throw on del (for testing error handling)\n   */\n  public delError: Error | null = null;\n\n  constructor(options: MemoryCacheProviderOptions = {}) {\n    super();\n    this.getError = options.getError ?? null;\n    this.setError = options.setError ?? null;\n    this.delError = options.delError ?? null;\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // CacheProvider implementation\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  public async get(name: string, key: string): Promise<Uint8Array | undefined> {\n    this.getCalls.push({\n      name,\n      key,\n      timestamp: this.dateTimeProvider.nowMillis(),\n    });\n\n    if (this.getError) {\n      throw this.getError;\n    }\n\n    const data = this.store[name]?.[key]?.data;\n\n    if (data !== undefined) {\n      this._stats.hits++;\n    } else {\n      this._stats.misses++;\n    }\n\n    return data;\n  }\n\n  public async set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array> {\n    this.setCalls.push({\n      name,\n      key,\n      value,\n      ttl,\n      timestamp: this.dateTimeProvider.nowMillis(),\n    });\n    this._stats.sets++;\n\n    if (this.setError) {\n      throw this.setError;\n    }\n\n    if (this.store[name] == null) {\n      this.store[name] = {};\n    }\n\n    this.store[name][key] ??= {};\n    this.store[name][key].data = value;\n\n    this.log.debug(`Setting cache for name`, { name, key, ttl });\n\n    // clear previous timeout if exists\n    if (this.store[name][key].timeout) {\n      this.dateTimeProvider.clearTimeout(this.store[name][key].timeout);\n      this.store[name][key].timeout = undefined;\n    }\n\n    if (ttl) {\n      this.store[name][key].timeout = this.dateTimeProvider.createTimeout(\n        () => this.del(name, key),\n        ttl,\n      );\n    }\n\n    return this.store[name][key].data;\n  }\n\n  public async del(name: string, ...keys: string[]): Promise<void> {\n    this.delCalls.push({\n      name,\n      keys,\n      timestamp: this.dateTimeProvider.nowMillis(),\n    });\n    this._stats.deletes++;\n\n    if (this.delError) {\n      throw this.delError;\n    }\n\n    // delete all keys in name\n    if (keys.length === 0) {\n      this.log.debug(`Deleting all cache for name`, { name });\n\n      if (this.store[name]) {\n        for (const key of Object.keys(this.store[name])) {\n          const timeout = this.store[name][key]?.timeout;\n          if (timeout) {\n            this.dateTimeProvider.clearTimeout(timeout);\n          }\n        }\n      }\n      delete this.store[name];\n      return;\n    }\n\n    this.log.debug(`Deleting cache for name`, { name, keys });\n\n    // delete specific keys in name\n    for (const key of keys) {\n      if (this.store[name] == null) break;\n\n      const timeout = this.store[name][key]?.timeout;\n      if (timeout) {\n        this.dateTimeProvider.clearTimeout(timeout);\n      }\n\n      delete this.store[name][key];\n    }\n\n    if (Object.keys(this.store[name] ?? {}).length === 0) {\n      // if name is empty, delete it\n      delete this.store[name];\n    }\n  }\n\n  public async has(name: string, key: string): Promise<boolean> {\n    return this.store[name]?.[key]?.data != null;\n  }\n\n  public async keys(name: string, filter?: string): Promise<string[]> {\n    const store = this.store[name] ?? {};\n    const keys = Object.keys(store);\n    if (filter) {\n      return keys.filter((key) => key.startsWith(filter));\n    }\n    return keys;\n  }\n\n  public async clear(): Promise<void> {\n    this.log.debug(\"Clearing all cache\");\n\n    // Clear all timeouts before clearing the store\n    for (const name of Object.keys(this.store)) {\n      for (const key of Object.keys(this.store[name])) {\n        const timeout = this.store[name][key]?.timeout;\n        if (timeout) {\n          this.dateTimeProvider.clearTimeout(timeout);\n        }\n      }\n    }\n\n    this.store = {};\n  }\n\n  public async incr(\n    name: string,\n    key: string,\n    amount: number,\n  ): Promise<number> {\n    if (this.store[name] == null) {\n      this.store[name] = {};\n    }\n\n    const existing = this.store[name][key]?.data;\n    let current = 0;\n\n    if (existing) {\n      try {\n        current = this.deserialize<number>(existing);\n      } catch {\n        // Fallback for raw bytes without type marker\n        const str = new TextDecoder().decode(existing);\n        current = Number.parseInt(str, 10) || 0;\n      }\n    }\n\n    const newValue = current + amount;\n    this.store[name][key] ??= {};\n    this.store[name][key].data = this.serialize(newValue);\n\n    return newValue;\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Test utilities\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Get cache statistics (hits, misses, sets, deletes).\n   *\n   * @example\n   * ```typescript\n   * expect(cache.stats().hits).toBe(1);\n   * expect(cache.stats().misses).toBe(0);\n   * ```\n   */\n  public stats(): MemoryCacheStats {\n    return { ...this._stats };\n  }\n\n  /**\n   * Check if a key was set during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.wasSet(\"my-cache\", \"user:123\")).toBe(true);\n   * ```\n   */\n  public wasSet(name: string, key?: string): boolean {\n    if (key === undefined) {\n      return this.setCalls.some((call) => call.name === name);\n    }\n    return this.setCalls.some((call) => call.name === name && call.key === key);\n  }\n\n  /**\n   * Check if a key was retrieved during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.wasGet(\"my-cache\", \"user:123\")).toBe(true);\n   * ```\n   */\n  public wasGet(name: string, key?: string): boolean {\n    if (key === undefined) {\n      return this.getCalls.some((call) => call.name === name);\n    }\n    return this.getCalls.some((call) => call.name === name && call.key === key);\n  }\n\n  /**\n   * Check if a key was deleted during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.wasDeleted(\"my-cache\", \"user:123\")).toBe(true);\n   * ```\n   */\n  public wasDeleted(name: string, key?: string): boolean {\n    if (key === undefined) {\n      return this.delCalls.some((call) => call.name === name);\n    }\n    return this.delCalls.some(\n      (call) => call.name === name && call.keys.includes(key),\n    );\n  }\n\n  /**\n   * Get the number of cached entries for a specific cache name.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.size(\"my-cache\")).toBe(5);\n   * ```\n   */\n  public size(name?: string): number {\n    if (name === undefined) {\n      return Object.values(this.store).reduce(\n        (total, entries) => total + Object.keys(entries).length,\n        0,\n      );\n    }\n    return Object.keys(this.store[name] ?? {}).length;\n  }\n\n  /**\n   * Get all cache names.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.names()).toContain(\"my-cache\");\n   * ```\n   */\n  public names(): string[] {\n    return Object.keys(this.store);\n  }\n\n  /**\n   * Reset all in-memory state (useful between tests).\n   *\n   * @example\n   * ```typescript\n   * beforeEach(() => {\n   *   cache.reset();\n   * });\n   * ```\n   */\n  public reset(): void {\n    // Clear all timeouts\n    for (const name of Object.keys(this.store)) {\n      for (const key of Object.keys(this.store[name])) {\n        const timeout = this.store[name][key]?.timeout;\n        if (timeout) {\n          this.dateTimeProvider.clearTimeout(timeout);\n        }\n      }\n    }\n\n    this.store = {};\n    this.getCalls = [];\n    this.setCalls = [];\n    this.delCalls = [];\n    this._stats = { hits: 0, misses: 0, sets: 0, deletes: 0 };\n    this.getError = null;\n    this.setError = null;\n    this.delError = null;\n  }\n}\n","import {\n  $atom,\n  $inject,\n  $state,\n  AlephaError,\n  createPrimitive,\n  KIND,\n  type MiddlewareMetadata,\n  OPTIONS,\n  Primitive,\n  type Service,\n  type Static,\n  t,\n} from \"alepha\";\nimport { DateTimeProvider, type DurationLike } from \"alepha/datetime\";\nimport { CacheProvider } from \"../providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"../providers/MemoryCacheProvider.ts\";\n\n/**\n * Creates a cache primitive for caching with automatic management.\n *\n * **Middleware mode** (no `handler`) — usable in `use` arrays AND as a store:\n * ```ts\n * class UserService {\n *   userCache = $cache({ name: \"users\", ttl: [10, \"minutes\"] });\n *\n *   fetchUser = $pipeline({\n *     use: [this.userCache],\n *     handler: async (userId: string) => this.repo.getById(userId),\n *   });\n *\n *   async invalidateUser(userId: string) {\n *     await this.userCache.invalidate(userId);\n *   }\n * }\n * ```\n *\n * **Primitive mode** (with `handler`) — standalone callable:\n * ```ts\n * getUserData = $cache({\n *   name: \"user-data\",\n *   ttl: [10, \"minutes\"],\n *   handler: async (userId: string) => {\n *     return await database.users.findById(userId);\n *   }\n * });\n * ```\n */\nexport function $cache<TReturn = string, TParameter extends any[] = any[]>(\n  options: CachePrimitiveOptions<TReturn, TParameter> & {\n    handler: (...args: TParameter) => TReturn;\n  },\n): CachePrimitiveFn<TReturn, TParameter>;\nexport function $cache<TReturn = any, TParameter extends any[] = any[]>(\n  options?: CachePrimitiveOptions<TReturn, TParameter>,\n): CacheMiddlewareFn<TReturn>;\nexport function $cache(options: any = {}): any {\n  const instance = createPrimitive(CachePrimitive, options);\n\n  if (options.handler) {\n    const fn = (...args: any[]): Promise<any> => instance.run(...args);\n    return Object.setPrototypeOf(fn, instance);\n  }\n\n  // Middleware mode: callable as (handler) => wrappedHandler, with store methods\n  const mw: any = <T extends (...args: any[]) => any>(handler: T): T => {\n    return (async (...args: any[]) => {\n      const key = instance.key(...args);\n      const read = await instance.read(key);\n\n      if (read.value !== undefined) {\n        if (read.stale) {\n          instance.scheduleRefresh(key, () => handler(...args));\n        }\n        return read.value;\n      }\n\n      const result = await instance.runSingleFlight(key, () =>\n        handler(...args),\n      );\n      // Fire-and-forget — cache write failures must not break the handler result\n      instance.set(key, result).catch(() => {});\n      return result;\n    }) as any as T;\n  };\n\n  mw[OPTIONS] = {\n    name: \"$cache\",\n    options: options as unknown as Record<string, unknown>,\n  } satisfies MiddlewareMetadata;\n\n  return Object.setPrototypeOf(mw, instance);\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Options for the in-memory L1 tier.\n */\nexport interface CacheMemoryTierOptions {\n  /**\n   * TTL for the in-memory tier. Should be ≤ the remote `ttl`.\n   * Bounds the cross-isolate staleness window after invalidation.\n   *\n   * @default min(ttl, 30s)\n   */\n  ttl?: DurationLike;\n\n  /**\n   * LRU bound — max entries kept in memory before eviction.\n   *\n   * @default 500\n   */\n  max?: number;\n\n  /**\n   * Also cache provider misses (`undefined`) in memory for this duration.\n   * Prevents hammering the remote tier on cold/unknown keys.\n   *\n   * @default off\n   */\n  negative?: DurationLike;\n}\n\nexport interface CachePrimitiveOptions<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> {\n  /**\n   * The cache name. This is useful for invalidating multiple caches at once.\n   *\n   * Store key as `cache:$name:$key`.\n   *\n   * @default Name of the key of the class.\n   */\n  name?: string;\n\n  /**\n   * Function which returns cached data.\n   */\n  handler?: (...args: TParameter) => TReturn;\n\n  /**\n   * The key generator for the cache.\n   * If not provided, the arguments will be json.stringify().\n   */\n  key?: (...args: TParameter) => string;\n\n  /**\n   * The store provider for the cache.\n   *\n   * Accepts:\n   * - `\"memory\"` — short-circuits to {@link MemoryCacheProvider} regardless\n   *   of the default `CacheProvider` binding. Useful for caches that must\n   *   stay process-local (e.g. ETag, HTTP client).\n   * - A {@link CacheProvider} class (concrete OR abstract) — resolved via\n   *   `alepha.inject(...)` at primitive construction. Use this to opt a\n   *   specific cache into a non-default backend (e.g.\n   *   `provider: DatabaseCacheProvider` to keep one cache in SQL while the\n   *   rest of the app uses Cloudflare KV).\n   * - `undefined` — falls back to whatever is bound to `CacheProvider` in\n   *   the container. On Cloudflare workers this is\n   *   {@link CloudflareKVProvider} by default; on Node it's\n   *   {@link MemoryCacheProvider}.\n   *\n   * Note: passing an *abstract* class works because Alepha's DI resolves\n   * through substitutions, e.g. `alepha.with({ provide: CacheProvider, use:\n   * MyCacheProvider })`.\n   */\n  provider?: Service<CacheProvider> | \"memory\";\n\n  /**\n   * The time-to-live for the cache in seconds.\n   * Set 0 to skip expiration.\n   *\n   * @default 300 (5 minutes).\n   */\n  ttl?: DurationLike;\n\n  /**\n   * If the cache is disabled.\n   */\n  disabled?: boolean;\n\n  /**\n   * Enable gzip compression for cached values.\n   * Reduces storage size by 60-80% for JSON payloads at the cost of CPU.\n   */\n  compress?: boolean;\n\n  /**\n   * Add an in-process L1 memory tier in front of `provider`.\n   *\n   * Reads check memory first, fall back to the provider on miss. Writes go\n   * to both tiers (write-through), so own-writes are immediately visible.\n   *\n   * Caveats:\n   * - Per-process only. Each Worker isolate / Node process has its own L1.\n   *   `invalidate()` clears the local L1 + the remote provider; other\n   *   processes keep their L1 until its TTL expires.\n   * - Use a short L1 TTL to bound the cross-isolate staleness window.\n   *\n   * @default off\n   */\n  memory?: true | CacheMemoryTierOptions;\n\n  /**\n   * Stale-while-revalidate window. After `ttl` expires, the cached value\n   * remains servable for `stale` longer; reads in this window return the\n   * stale value immediately and trigger ONE background refresh\n   * (single-flight per key).\n   *\n   * Requires a `handler` (primitive mode) OR middleware mode wrapping a\n   * handler — the cache needs to know how to recompute.\n   *\n   * @default off\n   */\n  stale?: DurationLike;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Cache configuration atom.\n */\nexport const cacheOptions = $atom({\n  name: \"alepha.cache.options\",\n  schema: t.object({\n    enabled: t.boolean({\n      default: true,\n      description: \"Whether caching is enabled.\",\n    }),\n    defaultTtl: t.number({\n      default: 300,\n      description: \"Default time to live for cache entries in seconds.\",\n    }),\n  }),\n  default: {\n    enabled: true,\n    defaultTtl: 300,\n  },\n});\n\nexport type CacheAtomOptions = Static<typeof cacheOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [cacheOptions.key]: CacheAtomOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst DEFAULT_MEMORY_MAX = 500;\nconst DEFAULT_MEMORY_TTL_MS = 30_000;\nconst SWR_MARKER = \"__swr\" as const;\n\ntype SwrEnvelope = {\n  [SWR_MARKER]: 1;\n  v: unknown;\n  f: number;\n};\n\ntype L1Entry<T> = {\n  value: T | undefined;\n  expiresAt: number;\n  negative: boolean;\n};\n\ntype ReadResult<T> = {\n  value: T | undefined;\n  stale: boolean;\n};\n\nexport class CachePrimitive<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends Primitive<CachePrimitiveOptions<TReturn, TParameter>> {\n  protected readonly settings = $state(cacheOptions);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  public readonly provider = this.$provider();\n\n  protected readonly memoryStore?: Map<string, L1Entry<TReturn>>;\n  protected readonly memoryMax: number = DEFAULT_MEMORY_MAX;\n  protected readonly memoryTtlMs: number = 0;\n  protected readonly negativeTtlMs: number = 0;\n\n  protected readonly inflightRefreshes = new Map<string, Promise<TReturn>>();\n\n  constructor(\n    args: ConstructorParameters<\n      typeof Primitive<CachePrimitiveOptions<TReturn, TParameter>>\n    >[0],\n  ) {\n    super(args);\n    const mem = this.options.memory;\n    if (mem) {\n      this.memoryStore = new Map();\n      const memOpts: CacheMemoryTierOptions = mem === true ? {} : mem;\n      this.memoryMax = memOpts.max ?? DEFAULT_MEMORY_MAX;\n      // Default L1 TTL: min(remote ttl, 30s). If remote ttl is 0/infinite, use 30s.\n      if (memOpts.ttl !== undefined) {\n        this.memoryTtlMs = this.dateTimeProvider\n          .duration(memOpts.ttl)\n          .as(\"milliseconds\");\n      } else {\n        const remoteTtlMs = this.options.ttl\n          ? this.dateTimeProvider.duration(this.options.ttl).as(\"milliseconds\")\n          : 0;\n        this.memoryTtlMs =\n          remoteTtlMs > 0\n            ? Math.min(remoteTtlMs, DEFAULT_MEMORY_TTL_MS)\n            : DEFAULT_MEMORY_TTL_MS;\n      }\n      if (memOpts.negative !== undefined) {\n        this.negativeTtlMs = this.dateTimeProvider\n          .duration(memOpts.negative)\n          .as(\"milliseconds\");\n      }\n    }\n  }\n\n  public get container(): string {\n    return (\n      this.options.name ??\n      `${this.config.service.name}:${this.config.propertyKey}`\n    );\n  }\n\n  public async run(...args: TParameter): Promise<TReturn> {\n    const handler = this.options.handler;\n    if (!handler) {\n      throw new AlephaError(\"Cache handler is not defined.\");\n    }\n\n    const key = this.key(...args);\n    const read = await this.read(key);\n\n    if (read.value !== undefined) {\n      if (read.stale) {\n        this.scheduleRefresh(key, () => handler(...args));\n      }\n      return read.value;\n    }\n\n    const result = await this.runSingleFlight(key, () => handler(...args));\n    // note: when exception occurs, don't cache the result\n    await this.set(key, result);\n    return result;\n  }\n\n  public key(...args: TParameter): string {\n    return this.options.key ? this.options.key(...args) : JSON.stringify(args);\n  }\n\n  public async incr(key: string, amount = 1): Promise<number> {\n    const result = await this.provider.incr(this.container, key, amount);\n    // L1 is no longer authoritative after atomic incr on remote.\n    this.delL1(key);\n    return result;\n  }\n\n  public async invalidate(...keys: string[]): Promise<void> {\n    if (this.memoryStore) {\n      if (keys.length === 0) {\n        this.memoryStore.clear();\n      } else {\n        for (const key of keys) {\n          if (key.endsWith(\"*\")) {\n            const prefix = key.slice(0, -1);\n            for (const k of this.memoryStore.keys()) {\n              if (k.startsWith(prefix)) this.memoryStore.delete(k);\n            }\n          } else {\n            this.memoryStore.delete(key);\n          }\n        }\n      }\n    }\n    await this.provider.invalidateKeys(this.container, keys);\n  }\n\n  public async set(\n    key: string,\n    value: TReturn,\n    ttl?: DurationLike,\n  ): Promise<void> {\n    if (\n      !this.alepha.isStarted() ||\n      this.options.disabled ||\n      !this.settings.enabled\n    ) {\n      return;\n    }\n\n    const freshTtlMs = this.dateTimeProvider\n      .duration(\n        ttl ?? this.options.ttl ?? [this.settings.defaultTtl, \"seconds\"],\n      )\n      .as(\"milliseconds\");\n\n    const staleMs = this.options.stale\n      ? this.dateTimeProvider.duration(this.options.stale).as(\"milliseconds\")\n      : 0;\n\n    const providerTtlMs = freshTtlMs > 0 ? freshTtlMs + staleMs : 0;\n    const now = this.dateTimeProvider.nowMillis();\n    const freshUntil = freshTtlMs > 0 ? now + freshTtlMs : 0;\n\n    const payload =\n      this.options.stale && freshTtlMs > 0\n        ? ({ [SWR_MARKER]: 1, v: value, f: freshUntil } satisfies SwrEnvelope)\n        : value;\n\n    await this.provider.setTyped(this.container, key, payload, {\n      ttl: providerTtlMs > 0 ? providerTtlMs : undefined,\n      compress: this.options.compress,\n    });\n\n    // Write-through to L1 (raw value, not wrapped).\n    this.setL1(key, {\n      value,\n      expiresAt:\n        this.memoryTtlMs > 0\n          ? now + this.memoryTtlMs\n          : Number.POSITIVE_INFINITY,\n      negative: false,\n    });\n\n    // A fresh write supersedes any pending refresh for this key.\n    this.inflightRefreshes.delete(key);\n\n    await this.alepha.events.emit(\"cache:set\", {\n      container: this.container,\n      key,\n      ttlMs: providerTtlMs > 0 ? providerTtlMs : undefined,\n    });\n  }\n\n  public async get(key: string): Promise<TReturn | undefined> {\n    const read = await this.read(key);\n    return read.value;\n  }\n\n  /**\n   * Internal read that also reports whether the value is stale (SWR\n   * grace window). Middleware and `run()` use this to decide whether to\n   * schedule a background refresh.\n   */\n  public async read(key: string): Promise<ReadResult<TReturn>> {\n    if (\n      !this.alepha.isStarted() ||\n      this.options.disabled ||\n      !this.settings.enabled\n    ) {\n      return { value: undefined, stale: false };\n    }\n\n    const now = this.dateTimeProvider.nowMillis();\n\n    // L1 check\n    if (this.memoryStore) {\n      const entry = this.memoryStore.get(key);\n      if (entry !== undefined) {\n        if (entry.expiresAt > now) {\n          // LRU touch\n          this.memoryStore.delete(key);\n          this.memoryStore.set(key, entry);\n          await this.alepha.events.emit(\"cache:hit\", {\n            container: this.container,\n            key,\n          });\n          return {\n            value: entry.negative ? undefined : entry.value,\n            stale: false,\n          };\n        }\n        this.memoryStore.delete(key);\n      }\n    }\n\n    // L2 check\n    const raw = await this.provider.getTyped<TReturn | SwrEnvelope>(\n      this.container,\n      key,\n    );\n\n    if (raw === undefined) {\n      // Negative caching\n      if (this.memoryStore && this.negativeTtlMs > 0) {\n        this.setL1(key, {\n          value: undefined,\n          expiresAt: now + this.negativeTtlMs,\n          negative: true,\n        });\n      }\n      await this.alepha.events.emit(\"cache:miss\", {\n        container: this.container,\n        key,\n      });\n      return { value: undefined, stale: false };\n    }\n\n    let value: TReturn;\n    let stale = false;\n\n    if (this.isSwrEnvelope(raw)) {\n      value = raw.v as TReturn;\n      stale = raw.f > 0 && raw.f <= now;\n    } else {\n      value = raw as TReturn;\n    }\n\n    // Populate L1 (write-back from L2 read)\n    if (this.memoryStore && this.memoryTtlMs > 0) {\n      this.setL1(key, {\n        value,\n        expiresAt: now + this.memoryTtlMs,\n        negative: false,\n      });\n    }\n\n    await this.alepha.events.emit(stale ? \"cache:stale\" : \"cache:hit\", {\n      container: this.container,\n      key,\n    });\n\n    return { value, stale };\n  }\n\n  /**\n   * Run a handler under single-flight: concurrent callers for the same\n   * key share one in-flight promise.\n   */\n  public async runSingleFlight(\n    key: string,\n    handler: () => Promise<TReturn> | TReturn,\n  ): Promise<TReturn> {\n    const existing = this.inflightRefreshes.get(key);\n    if (existing) {\n      return existing;\n    }\n    const promise = (async () => {\n      try {\n        return await handler();\n      } finally {\n        this.inflightRefreshes.delete(key);\n      }\n    })();\n    this.inflightRefreshes.set(key, promise);\n    return promise;\n  }\n\n  /**\n   * Schedule a background refresh for a stale key. At most one refresh\n   * per key is in-flight at any time; failures are swallowed (the stale\n   * value keeps being served until expiry).\n   */\n  public scheduleRefresh(\n    key: string,\n    handler: () => Promise<TReturn> | TReturn,\n  ): void {\n    if (this.inflightRefreshes.has(key)) {\n      return;\n    }\n    const promise = (async () => {\n      try {\n        const result = await handler();\n        await this.set(key, result);\n        await this.alepha.events.emit(\"cache:revalidate\", {\n          container: this.container,\n          key,\n        });\n        return result;\n      } finally {\n        this.inflightRefreshes.delete(key);\n      }\n    })();\n    promise.catch(() => {\n      // swallow: stale value keeps serving until expiry\n    });\n    this.inflightRefreshes.set(key, promise);\n  }\n\n  protected $provider(): CacheProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(CacheProvider);\n    }\n\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemoryCacheProvider);\n    }\n\n    return this.alepha.inject(this.options.provider);\n  }\n\n  protected isSwrEnvelope(value: unknown): value is SwrEnvelope {\n    return (\n      value !== null &&\n      typeof value === \"object\" &&\n      (value as Record<string, unknown>)[SWR_MARKER] === 1 &&\n      \"f\" in (value as Record<string, unknown>) &&\n      \"v\" in (value as Record<string, unknown>)\n    );\n  }\n\n  protected setL1(key: string, entry: L1Entry<TReturn>): void {\n    if (!this.memoryStore) return;\n    if (this.memoryStore.has(key)) {\n      this.memoryStore.delete(key);\n    }\n    this.memoryStore.set(key, entry);\n    while (this.memoryStore.size > this.memoryMax) {\n      const first = this.memoryStore.keys().next().value;\n      if (first === undefined) break;\n      this.memoryStore.delete(first);\n    }\n  }\n\n  protected delL1(key: string): void {\n    this.memoryStore?.delete(key);\n  }\n}\n\nexport interface CachePrimitiveFn<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends CachePrimitive<TReturn, TParameter> {\n  /**\n   * Run the cache primitive with the provided arguments.\n   */\n  (...args: TParameter): Promise<TReturn>;\n}\n\n/**\n * Cache middleware + store. Callable as middleware `(handler) => wrappedHandler`\n * AND exposes store methods (`.get()`, `.set()`, `.invalidate()`, `.incr()`).\n */\nexport interface CacheMiddlewareFn<TReturn = any>\n  extends CachePrimitive<TReturn, any[]> {\n  <T extends (...args: any[]) => any>(handler: T): T;\n  [OPTIONS]?: MiddlewareMetadata;\n}\n\n$cache[KIND] = CachePrimitive;\n","import { $hook, $inject, Alepha, AlephaError } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { CachePrimitive } from \"../primitives/$cache.ts\";\nimport { CacheProvider } from \"./CacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * KVNamespace interface matching Cloudflare's KV API.\n */\nexport interface KVNamespace {\n  get(key: string, type: \"arrayBuffer\"): Promise<ArrayBuffer | null>;\n  get(key: string, type: \"text\"): Promise<string | null>;\n  get(key: string, type?: \"text\"): Promise<string | null>;\n  put(\n    key: string,\n    value: string | ArrayBuffer | ReadableStream,\n    options?: KVPutOptions,\n  ): Promise<void>;\n  delete(key: string): Promise<void>;\n  list(options?: KVListOptions): Promise<KVListResult>;\n}\n\nexport interface KVPutOptions {\n  expiration?: number;\n  expirationTtl?: number;\n  metadata?: unknown;\n}\n\nexport interface KVListOptions {\n  prefix?: string;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface KVListResult {\n  keys: KVListKey[];\n  list_complete: boolean;\n  cursor?: string;\n}\n\nexport interface KVListKey {\n  name: string;\n  expiration?: number;\n  metadata?: unknown;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Default KV binding name used in wrangler configuration.\n */\nexport const KV_DEFAULT_BINDING = \"KV_CACHE\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Cloudflare KV cache provider.\n *\n * Uses a KV namespace binding for all cache operations.\n * Keys are stored as: `cache:{name}:{key}`\n *\n * **Required Cloudflare binding:**\n * - `KV_CACHE` - A KV namespace binding in wrangler configuration\n *\n * @example\n * ```toml\n * # wrangler.toml - automatically generated by alepha build\n * [[kv_namespaces]]\n * binding = \"KV_CACHE\"\n * id = \"abc123\"\n * ```\n */\nexport class CloudflareKVProvider extends CacheProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n\n  protected kv?: KVNamespace;\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      const caches = this.alepha\n        .primitives<CachePrimitive>(\"cache\")\n        .filter((it) => it.provider === this);\n\n      if (caches.length === 0) {\n        this.log.info(\n          \"CloudflareKVProvider is registered but no cache primitives are using it. Skipping KV initialization.\",\n        );\n        return;\n      }\n\n      const cloudflareEnv = this.alepha.get(\"cloudflare.env\") as\n        | Record<string, unknown>\n        | undefined;\n      if (!cloudflareEnv) {\n        throw new AlephaError(\n          \"Cloudflare Workers environment not found in Alepha store under 'cloudflare.env'.\",\n        );\n      }\n\n      const binding = cloudflareEnv[KV_DEFAULT_BINDING] as\n        | KVNamespace\n        | undefined;\n      if (!binding) {\n        throw new AlephaError(\n          `KV binding '${KV_DEFAULT_BINDING}' not found in Cloudflare Workers environment.`,\n        );\n      }\n\n      this.kv = binding;\n\n      this.log.info(\"Cloudflare KV cache OK\");\n    },\n  });\n\n  public async get(name: string, key: string): Promise<Uint8Array | undefined> {\n    if (!this.alepha.isStarted()) {\n      return;\n    }\n\n    const kvKey = this.prefix(name, key);\n    const buffer = await this.getKV().get(kvKey, \"arrayBuffer\");\n    if (!buffer) {\n      return;\n    }\n\n    this.log.debug(\"Cache hit\", {\n      size: buffer.byteLength,\n      key: kvKey,\n    });\n\n    return new Uint8Array(buffer);\n  }\n\n  public async set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array> {\n    if (!this.alepha.isReady()) {\n      return new Uint8Array(value);\n    }\n\n    const kvKey = this.prefix(name, key);\n    const options: KVPutOptions = {};\n\n    if (ttl) {\n      // KV expects TTL in seconds, we receive milliseconds\n      options.expirationTtl = Math.max(60, Math.ceil(ttl / 1000));\n    }\n\n    await this.getKV().put(\n      kvKey,\n      value.buffer.slice(\n        value.byteOffset,\n        value.byteOffset + value.byteLength,\n      ) as ArrayBuffer,\n      options,\n    );\n    return value;\n  }\n\n  public async del(name: string, ...keys: string[]): Promise<void> {\n    const kv = this.getKV();\n\n    if (keys.length === 0) {\n      // Delete all keys under this cache name\n      const prefix = this.prefix(name);\n      const allKeys = await this.listAllKeys(`${prefix}:`);\n      for (const k of allKeys) {\n        await kv.delete(k);\n      }\n      return;\n    }\n\n    const nameKey = this.prefix(name);\n    for (const key of keys) {\n      const fullKey = key.startsWith(nameKey) ? key : this.prefix(name, key);\n      await kv.delete(fullKey);\n    }\n  }\n\n  public async has(name: string, key: string): Promise<boolean> {\n    const kvKey = this.prefix(name, key);\n    const value = await this.getKV().get(kvKey, \"text\");\n    return value !== null;\n  }\n\n  public async keys(name: string, filter?: string): Promise<string[]> {\n    const prefix = filter\n      ? `${this.prefix(name)}:${filter}`\n      : `${this.prefix(name)}:`;\n\n    return this.listAllKeys(prefix);\n  }\n\n  public async clear(): Promise<void> {\n    this.log.debug(\"Clearing all cache\");\n    const kv = this.getKV();\n    const allKeys = await this.listAllKeys(\"cache:\");\n    for (const key of allKeys) {\n      await kv.delete(key);\n    }\n  }\n\n  public async incr(\n    name: string,\n    key: string,\n    amount: number,\n  ): Promise<number> {\n    const kvKey = this.prefix(name, key);\n    const kv = this.getKV();\n\n    const existing = await kv.get(kvKey, \"text\");\n    let current = 0;\n\n    if (existing !== null) {\n      current = Number.parseInt(existing, 10) || 0;\n    }\n\n    const newValue = current + amount;\n    await kv.put(kvKey, String(newValue));\n    return newValue;\n  }\n\n  /**\n   * Build the full KV key: `cache:{name}:{key}`\n   */\n  protected prefix(...path: string[]): string {\n    return [\"cache\", ...path].join(\":\");\n  }\n\n  protected getKV(): KVNamespace {\n    if (!this.kv) {\n      throw new AlephaError(\n        \"KV namespace not initialized. Call start() first.\",\n      );\n    }\n    return this.kv;\n  }\n\n  /**\n   * List all keys matching a prefix, handling pagination.\n   */\n  protected async listAllKeys(prefix: string): Promise<string[]> {\n    const kv = this.getKV();\n    const allKeys: string[] = [];\n    let cursor: string | undefined;\n\n    do {\n      const result = await kv.list({\n        prefix,\n        cursor,\n      });\n\n      for (const key of result.keys) {\n        allKeys.push(key.name);\n      }\n\n      cursor = result.list_complete ? undefined : result.cursor;\n    } while (cursor);\n\n    return allKeys;\n  }\n}\n","import { $module } from \"alepha\";\nimport { $cache } from \"./primitives/$cache.ts\";\nimport { CacheProvider } from \"./providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$cache.ts\";\nexport * from \"./providers/CacheProvider.ts\";\nexport * from \"./providers/CloudflareKVProvider.ts\";\nexport * from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    /**\n     * Fires when a cache lookup finds a value.\n     */\n    \"cache:hit\": {\n      container: string;\n      key: string;\n    };\n    /**\n     * Fires when a cache lookup does not find a value.\n     */\n    \"cache:miss\": {\n      container: string;\n      key: string;\n    };\n    /**\n     * Fires when a value is written to the cache.\n     */\n    \"cache:set\": {\n      container: string;\n      key: string;\n      ttlMs?: number;\n    };\n    /**\n     * Fires when a stale value (SWR grace window) is served and a\n     * background refresh is scheduled.\n     */\n    \"cache:stale\": {\n      container: string;\n      key: string;\n    };\n    /**\n     * Fires when a background SWR refresh completes successfully and\n     * the value has been written back to the cache.\n     */\n    \"cache:revalidate\": {\n      container: string;\n      key: string;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Type-safe caching with TTL support.\n *\n * **Features:**\n * - Cached computations with type-safe keys and values\n * - Configurable TTL\n * - Cache invalidation\n * - Automatic cache population\n * - Providers: Memory (default), Redis\n *\n * @module alepha.cache\n */\nexport const AlephaCache = $module({\n  name: \"alepha.cache\",\n  primitives: [$cache],\n  services: [CacheProvider],\n  variants: [MemoryCacheProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: CacheProvider,\n      use: MemoryCacheProvider,\n    }),\n});\n"],"mappings":";;;;AAEA,IAAa,aAAb,cAAgC,YAAY,CAAC;;;;;;;;;ACM7C,IAAsB,gBAAtB,MAAoC;CAClC,UAAiC,IAAI,YAAY;CACjD,UAAiC,IAAI,YAAY;CACjD,QAAkB;EAChB,QAAQ;EACR,MAAM;EACN,QAAQ;EACR,YAAY;CACd;;;;CAyEA,MAAa,SACX,MACA,KACA,OACA,SACe;EACf,IAAI,OAAO,KAAK,UAAU,KAAK;EAC/B,IAAI,SAAS,UACX,OAAO,MAAM,KAAK,SAAS,IAAI;EAEjC,MAAM,KAAK,IAAI,MAAM,KAAK,MAAM,SAAS,GAAG;CAC9C;;;;CAKA,MAAa,SAAY,MAAc,KAAqC;EAC1E,MAAM,OAAO,MAAM,KAAK,IAAI,MAAM,GAAG;EACrC,IAAI,MAAM;GACR,IAAI,KAAK,OAAO,KAAK,MAAM,YAAY;IACrC,MAAM,eAAe,MAAM,KAAK,WAAW,KAAK,SAAS,CAAC,CAAC;IAC3D,OAAO,KAAK,YAAe,YAAY;GACzC;GACA,OAAO,KAAK,YAAe,IAAI;EACjC;CAEF;;;;;;;CAQA,MAAa,eAAe,MAAc,MAA+B;EACvE,MAAM,eAAyB,CAAC;EAEhC,KAAK,MAAM,OAAO,MAChB,IAAI,IAAI,SAAS,GAAG,GAAG;GACrB,MAAM,SAAS,MAAM,KAAK,KAAK,MAAM,IAAI,MAAM,GAAG,EAAE,CAAC;GACrD,aAAa,KAAK,GAAG,MAAM;EAC7B,OACE,aAAa,KAAK,GAAG;EAIzB,MAAM,KAAK,IAAI,MAAM,GAAG,YAAY;CACtC;;;;CAKA,UAAoB,OAA4B;EAC9C,IAAI,iBAAiB,YAAY;GAC/B,MAAM,SAAS,IAAI,WAAW,IAAI,MAAM,MAAM;GAC9C,OAAO,KAAK,KAAK,MAAM;GACvB,OAAO,IAAI,OAAO,CAAC;GACnB,OAAO;EACT;EAEA,MAAM,UAAU,KAAK,QAAQ,OAC3B,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,KAAK,CAC1D;EACA,MAAM,OACJ,OAAO,UAAU,WAAW,KAAK,MAAM,SAAS,KAAK,MAAM;EAC7D,MAAM,SAAS,IAAI,WAAW,IAAI,QAAQ,MAAM;EAChD,OAAO,KAAK;EACZ,OAAO,IAAI,SAAS,CAAC;EACrB,OAAO;CACT;;;;CAKA,YAAyB,YAA2B;EAClD,MAAM,OAAO,WAAW;EACxB,MAAM,UAAU,WAAW,MAAM,CAAC;EAElC,IAAI,SAAS,KAAK,MAAM,QACtB,OAAO;EAET,IAAI,SAAS,KAAK,MAAM,MACtB,OAAO,KAAK,MAAM,KAAK,QAAQ,OAAO,OAAO,CAAC;EAEhD,IAAI,SAAS,KAAK,MAAM,QACtB,OAAO,KAAK,QAAQ,OAAO,OAAO;EAGpC,MAAM,IAAI,WAAW,+BAA+B,MAAM;CAC5D;;;;CAKA,MAAgB,SAAS,MAAuC;EAC9D,MAAM,MAAO,KAAK,OAAuB,MACvC,KAAK,YACL,KAAK,aAAa,KAAK,UACzB;EACA,MAAM,aAAa,IAAI,WACrB,MAAM,IAAI,SACR,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,YAAY,IAAI,kBAAkB,MAAM,CAAC,CACpE,EAAE,YAAY,CAChB;EACA,MAAM,SAAS,IAAI,WAAW,IAAI,WAAW,MAAM;EACnD,OAAO,KAAK,KAAK,MAAM;EACvB,OAAO,IAAI,YAAY,CAAC;EACxB,OAAO;CACT;;;;CAKA,MAAgB,WAAW,MAAuC;EAChE,MAAM,MAAO,KAAK,OAAuB,MACvC,KAAK,YACL,KAAK,aAAa,KAAK,UACzB;EACA,OAAO,IAAI,WACT,MAAM,IAAI,SACR,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,YAAY,IAAI,oBAAoB,MAAM,CAAC,CACtE,EAAE,YAAY,CAChB;CACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACrIA,IAAa,sBAAb,cAAyC,cAAc;CACrD,mBAAsC,QAAQ,gBAAgB;CAC9D,MAAyB,QAAQ;CAEjC,QAAmE,CAAC;;;;CASpE,WAAqC,CAAC;;;;CAKtC,WAAwC,CAAC;;;;CAKzC,WAAwC,CAAC;;;;CAKzC,SAAqC;EACnC,MAAM;EACN,QAAQ;EACR,MAAM;EACN,SAAS;CACX;;;;CAKA,WAAgC;;;;CAKhC,WAAgC;;;;CAKhC,WAAgC;CAEhC,YAAY,UAAsC,CAAC,GAAG;EACpD,MAAM;EACN,KAAK,WAAW,QAAQ,YAAY;EACpC,KAAK,WAAW,QAAQ,YAAY;EACpC,KAAK,WAAW,QAAQ,YAAY;CACtC;CAMA,MAAa,IAAI,MAAc,KAA8C;EAC3E,KAAK,SAAS,KAAK;GACjB;GACA;GACA,WAAW,KAAK,iBAAiB,UAAU;EAC7C,CAAC;EAED,IAAI,KAAK,UACP,MAAM,KAAK;EAGb,MAAM,OAAO,KAAK,MAAM,QAAQ,MAAM;EAEtC,IAAI,SAAS,KAAA,GACX,KAAK,OAAO;OAEZ,KAAK,OAAO;EAGd,OAAO;CACT;CAEA,MAAa,IACX,MACA,KACA,OACA,KACqB;EACrB,KAAK,SAAS,KAAK;GACjB;GACA;GACA;GACA;GACA,WAAW,KAAK,iBAAiB,UAAU;EAC7C,CAAC;EACD,KAAK,OAAO;EAEZ,IAAI,KAAK,UACP,MAAM,KAAK;EAGb,IAAI,KAAK,MAAM,SAAS,MACtB,KAAK,MAAM,QAAQ,CAAC;EAGtB,KAAK,MAAM,MAAM,SAAS,CAAC;EAC3B,KAAK,MAAM,MAAM,KAAK,OAAO;EAE7B,KAAK,IAAI,MAAM,0BAA0B;GAAE;GAAM;GAAK;EAAI,CAAC;EAG3D,IAAI,KAAK,MAAM,MAAM,KAAK,SAAS;GACjC,KAAK,iBAAiB,aAAa,KAAK,MAAM,MAAM,KAAK,OAAO;GAChE,KAAK,MAAM,MAAM,KAAK,UAAU,KAAA;EAClC;EAEA,IAAI,KACF,KAAK,MAAM,MAAM,KAAK,UAAU,KAAK,iBAAiB,oBAC9C,KAAK,IAAI,MAAM,GAAG,GACxB,GACF;EAGF,OAAO,KAAK,MAAM,MAAM,KAAK;CAC/B;CAEA,MAAa,IAAI,MAAc,GAAG,MAA+B;EAC/D,KAAK,SAAS,KAAK;GACjB;GACA;GACA,WAAW,KAAK,iBAAiB,UAAU;EAC7C,CAAC;EACD,KAAK,OAAO;EAEZ,IAAI,KAAK,UACP,MAAM,KAAK;EAIb,IAAI,KAAK,WAAW,GAAG;GACrB,KAAK,IAAI,MAAM,+BAA+B,EAAE,KAAK,CAAC;GAEtD,IAAI,KAAK,MAAM,OACb,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,MAAM,KAAK,GAAG;IAC/C,MAAM,UAAU,KAAK,MAAM,MAAM,MAAM;IACvC,IAAI,SACF,KAAK,iBAAiB,aAAa,OAAO;GAE9C;GAEF,OAAO,KAAK,MAAM;GAClB;EACF;EAEA,KAAK,IAAI,MAAM,2BAA2B;GAAE;GAAM;EAAK,CAAC;EAGxD,KAAK,MAAM,OAAO,MAAM;GACtB,IAAI,KAAK,MAAM,SAAS,MAAM;GAE9B,MAAM,UAAU,KAAK,MAAM,MAAM,MAAM;GACvC,IAAI,SACF,KAAK,iBAAiB,aAAa,OAAO;GAG5C,OAAO,KAAK,MAAM,MAAM;EAC1B;EAEA,IAAI,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC,CAAC,EAAE,WAAW,GAEjD,OAAO,KAAK,MAAM;CAEtB;CAEA,MAAa,IAAI,MAAc,KAA+B;EAC5D,OAAO,KAAK,MAAM,QAAQ,MAAM,QAAQ;CAC1C;CAEA,MAAa,KAAK,MAAc,QAAoC;EAClE,MAAM,QAAQ,KAAK,MAAM,SAAS,CAAC;EACnC,MAAM,OAAO,OAAO,KAAK,KAAK;EAC9B,IAAI,QACF,OAAO,KAAK,QAAQ,QAAQ,IAAI,WAAW,MAAM,CAAC;EAEpD,OAAO;CACT;CAEA,MAAa,QAAuB;EAClC,KAAK,IAAI,MAAM,oBAAoB;EAGnC,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,KAAK,GACvC,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,MAAM,KAAK,GAAG;GAC/C,MAAM,UAAU,KAAK,MAAM,MAAM,MAAM;GACvC,IAAI,SACF,KAAK,iBAAiB,aAAa,OAAO;EAE9C;EAGF,KAAK,QAAQ,CAAC;CAChB;CAEA,MAAa,KACX,MACA,KACA,QACiB;EACjB,IAAI,KAAK,MAAM,SAAS,MACtB,KAAK,MAAM,QAAQ,CAAC;EAGtB,MAAM,WAAW,KAAK,MAAM,MAAM,MAAM;EACxC,IAAI,UAAU;EAEd,IAAI,UACF,IAAI;GACF,UAAU,KAAK,YAAoB,QAAQ;EAC7C,QAAQ;GAEN,MAAM,MAAM,IAAI,YAAY,EAAE,OAAO,QAAQ;GAC7C,UAAU,OAAO,SAAS,KAAK,EAAE,KAAK;EACxC;EAGF,MAAM,WAAW,UAAU;EAC3B,KAAK,MAAM,MAAM,SAAS,CAAC;EAC3B,KAAK,MAAM,MAAM,KAAK,OAAO,KAAK,UAAU,QAAQ;EAEpD,OAAO;CACT;;;;;;;;;;CAeA,QAAiC;EAC/B,OAAO,EAAE,GAAG,KAAK,OAAO;CAC1B;;;;;;;;;CAUA,OAAc,MAAc,KAAuB;EACjD,IAAI,QAAQ,KAAA,GACV,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,IAAI;EAExD,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,QAAQ,KAAK,QAAQ,GAAG;CAC5E;;;;;;;;;CAUA,OAAc,MAAc,KAAuB;EACjD,IAAI,QAAQ,KAAA,GACV,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,IAAI;EAExD,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,QAAQ,KAAK,QAAQ,GAAG;CAC5E;;;;;;;;;CAUA,WAAkB,MAAc,KAAuB;EACrD,IAAI,QAAQ,KAAA,GACV,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,IAAI;EAExD,OAAO,KAAK,SAAS,MAClB,SAAS,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,GAAG,CACxD;CACF;;;;;;;;;CAUA,KAAY,MAAuB;EACjC,IAAI,SAAS,KAAA,GACX,OAAO,OAAO,OAAO,KAAK,KAAK,EAAE,QAC9B,OAAO,YAAY,QAAQ,OAAO,KAAK,OAAO,EAAE,QACjD,CACF;EAEF,OAAO,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC,CAAC,EAAE;CAC7C;;;;;;;;;CAUA,QAAyB;EACvB,OAAO,OAAO,KAAK,KAAK,KAAK;CAC/B;;;;;;;;;;;CAYA,QAAqB;EAEnB,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,KAAK,GACvC,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,MAAM,KAAK,GAAG;GAC/C,MAAM,UAAU,KAAK,MAAM,MAAM,MAAM;GACvC,IAAI,SACF,KAAK,iBAAiB,aAAa,OAAO;EAE9C;EAGF,KAAK,QAAQ,CAAC;EACd,KAAK,WAAW,CAAC;EACjB,KAAK,WAAW,CAAC;EACjB,KAAK,WAAW,CAAC;EACjB,KAAK,SAAS;GAAE,MAAM;GAAG,QAAQ;GAAG,MAAM;GAAG,SAAS;EAAE;EACxD,KAAK,WAAW;EAChB,KAAK,WAAW;EAChB,KAAK,WAAW;CAClB;AACF;;;AC7XA,SAAgB,OAAO,UAAe,CAAC,GAAQ;CAC7C,MAAM,WAAW,gBAAgB,gBAAgB,OAAO;CAExD,IAAI,QAAQ,SAAS;EACnB,MAAM,MAAM,GAAG,SAA8B,SAAS,IAAI,GAAG,IAAI;EACjE,OAAO,OAAO,eAAe,IAAI,QAAQ;CAC3C;CAGA,MAAM,MAA8C,YAAkB;EACpE,QAAQ,OAAO,GAAG,SAAgB;GAChC,MAAM,MAAM,SAAS,IAAI,GAAG,IAAI;GAChC,MAAM,OAAO,MAAM,SAAS,KAAK,GAAG;GAEpC,IAAI,KAAK,UAAU,KAAA,GAAW;IAC5B,IAAI,KAAK,OACP,SAAS,gBAAgB,WAAW,QAAQ,GAAG,IAAI,CAAC;IAEtD,OAAO,KAAK;GACd;GAEA,MAAM,SAAS,MAAM,SAAS,gBAAgB,WAC5C,QAAQ,GAAG,IAAI,CACjB;GAEA,SAAS,IAAI,KAAK,MAAM,EAAE,YAAY,CAAC,CAAC;GACxC,OAAO;EACT;CACF;CAEA,GAAG,WAAW;EACZ,MAAM;EACG;CACX;CAEA,OAAO,OAAO,eAAe,IAAI,QAAQ;AAC3C;;;;AAqIA,MAAa,eAAe,MAAM;CAChC,MAAM;CACN,QAAQ,EAAE,OAAO;EACf,SAAS,EAAE,QAAQ;GACjB,SAAS;GACT,aAAa;EACf,CAAC;EACD,YAAY,EAAE,OAAO;GACnB,SAAS;GACT,aAAa;EACf,CAAC;CACH,CAAC;CACD,SAAS;EACP,SAAS;EACT,YAAY;CACd;AACF,CAAC;AAYD,MAAM,qBAAqB;AAC3B,MAAM,wBAAwB;AAC9B,MAAM,aAAa;AAmBnB,IAAa,iBAAb,cAGU,UAAsD;CAC9D,WAA8B,OAAO,YAAY;CACjD,mBAAsC,QAAQ,gBAAgB;CAC9D,WAA2B,KAAK,UAAU;CAE1C;CACA,YAAuC;CACvC,cAAyC;CACzC,gBAA2C;CAE3C,oCAAuC,IAAI,IAA8B;CAEzE,YACE,MAGA;EACA,MAAM,IAAI;EACV,MAAM,MAAM,KAAK,QAAQ;EACzB,IAAI,KAAK;GACP,KAAK,8BAAc,IAAI,IAAI;GAC3B,MAAM,UAAkC,QAAQ,OAAO,CAAC,IAAI;GAC5D,KAAK,YAAY,QAAQ,OAAO;GAEhC,IAAI,QAAQ,QAAQ,KAAA,GAClB,KAAK,cAAc,KAAK,iBACrB,SAAS,QAAQ,GAAG,EACpB,GAAG,cAAc;QACf;IACL,MAAM,cAAc,KAAK,QAAQ,MAC7B,KAAK,iBAAiB,SAAS,KAAK,QAAQ,GAAG,EAAE,GAAG,cAAc,IAClE;IACJ,KAAK,cACH,cAAc,IACV,KAAK,IAAI,aAAa,qBAAqB,IAC3C;GACR;GACA,IAAI,QAAQ,aAAa,KAAA,GACvB,KAAK,gBAAgB,KAAK,iBACvB,SAAS,QAAQ,QAAQ,EACzB,GAAG,cAAc;EAExB;CACF;CAEA,IAAW,YAAoB;EAC7B,OACE,KAAK,QAAQ,QACb,GAAG,KAAK,OAAO,QAAQ,KAAK,GAAG,KAAK,OAAO;CAE/C;CAEA,MAAa,IAAI,GAAG,MAAoC;EACtD,MAAM,UAAU,KAAK,QAAQ;EAC7B,IAAI,CAAC,SACH,MAAM,IAAI,YAAY,+BAA+B;EAGvD,MAAM,MAAM,KAAK,IAAI,GAAG,IAAI;EAC5B,MAAM,OAAO,MAAM,KAAK,KAAK,GAAG;EAEhC,IAAI,KAAK,UAAU,KAAA,GAAW;GAC5B,IAAI,KAAK,OACP,KAAK,gBAAgB,WAAW,QAAQ,GAAG,IAAI,CAAC;GAElD,OAAO,KAAK;EACd;EAEA,MAAM,SAAS,MAAM,KAAK,gBAAgB,WAAW,QAAQ,GAAG,IAAI,CAAC;EAErE,MAAM,KAAK,IAAI,KAAK,MAAM;EAC1B,OAAO;CACT;CAEA,IAAW,GAAG,MAA0B;EACtC,OAAO,KAAK,QAAQ,MAAM,KAAK,QAAQ,IAAI,GAAG,IAAI,IAAI,KAAK,UAAU,IAAI;CAC3E;CAEA,MAAa,KAAK,KAAa,SAAS,GAAoB;EAC1D,MAAM,SAAS,MAAM,KAAK,SAAS,KAAK,KAAK,WAAW,KAAK,MAAM;EAEnE,KAAK,MAAM,GAAG;EACd,OAAO;CACT;CAEA,MAAa,WAAW,GAAG,MAA+B;EACxD,IAAI,KAAK,aACP,IAAI,KAAK,WAAW,GAClB,KAAK,YAAY,MAAM;OAEvB,KAAK,MAAM,OAAO,MAChB,IAAI,IAAI,SAAS,GAAG,GAAG;GACrB,MAAM,SAAS,IAAI,MAAM,GAAG,EAAE;GAC9B,KAAK,MAAM,KAAK,KAAK,YAAY,KAAK,GACpC,IAAI,EAAE,WAAW,MAAM,GAAG,KAAK,YAAY,OAAO,CAAC;EAEvD,OACE,KAAK,YAAY,OAAO,GAAG;EAKnC,MAAM,KAAK,SAAS,eAAe,KAAK,WAAW,IAAI;CACzD;CAEA,MAAa,IACX,KACA,OACA,KACe;EACf,IACE,CAAC,KAAK,OAAO,UAAU,KACvB,KAAK,QAAQ,YACb,CAAC,KAAK,SAAS,SAEf;EAGF,MAAM,aAAa,KAAK,iBACrB,SACC,OAAO,KAAK,QAAQ,OAAO,CAAC,KAAK,SAAS,YAAY,SAAS,CACjE,EACC,GAAG,cAAc;EAEpB,MAAM,UAAU,KAAK,QAAQ,QACzB,KAAK,iBAAiB,SAAS,KAAK,QAAQ,KAAK,EAAE,GAAG,cAAc,IACpE;EAEJ,MAAM,gBAAgB,aAAa,IAAI,aAAa,UAAU;EAC9D,MAAM,MAAM,KAAK,iBAAiB,UAAU;EAC5C,MAAM,aAAa,aAAa,IAAI,MAAM,aAAa;EAEvD,MAAM,UACJ,KAAK,QAAQ,SAAS,aAAa,IAC9B;IAAG,aAAa;GAAG,GAAG;GAAO,GAAG;EAAW,IAC5C;EAEN,MAAM,KAAK,SAAS,SAAS,KAAK,WAAW,KAAK,SAAS;GACzD,KAAK,gBAAgB,IAAI,gBAAgB,KAAA;GACzC,UAAU,KAAK,QAAQ;EACzB,CAAC;EAGD,KAAK,MAAM,KAAK;GACd;GACA,WACE,KAAK,cAAc,IACf,MAAM,KAAK,cACX,OAAO;GACb,UAAU;EACZ,CAAC;EAGD,KAAK,kBAAkB,OAAO,GAAG;EAEjC,MAAM,KAAK,OAAO,OAAO,KAAK,aAAa;GACzC,WAAW,KAAK;GAChB;GACA,OAAO,gBAAgB,IAAI,gBAAgB,KAAA;EAC7C,CAAC;CACH;CAEA,MAAa,IAAI,KAA2C;EAE1D,QAAO,MADY,KAAK,KAAK,GAAG,GACpB;CACd;;;;;;CAOA,MAAa,KAAK,KAA2C;EAC3D,IACE,CAAC,KAAK,OAAO,UAAU,KACvB,KAAK,QAAQ,YACb,CAAC,KAAK,SAAS,SAEf,OAAO;GAAE,OAAO,KAAA;GAAW,OAAO;EAAM;EAG1C,MAAM,MAAM,KAAK,iBAAiB,UAAU;EAG5C,IAAI,KAAK,aAAa;GACpB,MAAM,QAAQ,KAAK,YAAY,IAAI,GAAG;GACtC,IAAI,UAAU,KAAA,GAAW;IACvB,IAAI,MAAM,YAAY,KAAK;KAEzB,KAAK,YAAY,OAAO,GAAG;KAC3B,KAAK,YAAY,IAAI,KAAK,KAAK;KAC/B,MAAM,KAAK,OAAO,OAAO,KAAK,aAAa;MACzC,WAAW,KAAK;MAChB;KACF,CAAC;KACD,OAAO;MACL,OAAO,MAAM,WAAW,KAAA,IAAY,MAAM;MAC1C,OAAO;KACT;IACF;IACA,KAAK,YAAY,OAAO,GAAG;GAC7B;EACF;EAGA,MAAM,MAAM,MAAM,KAAK,SAAS,SAC9B,KAAK,WACL,GACF;EAEA,IAAI,QAAQ,KAAA,GAAW;GAErB,IAAI,KAAK,eAAe,KAAK,gBAAgB,GAC3C,KAAK,MAAM,KAAK;IACd,OAAO,KAAA;IACP,WAAW,MAAM,KAAK;IACtB,UAAU;GACZ,CAAC;GAEH,MAAM,KAAK,OAAO,OAAO,KAAK,cAAc;IAC1C,WAAW,KAAK;IAChB;GACF,CAAC;GACD,OAAO;IAAE,OAAO,KAAA;IAAW,OAAO;GAAM;EAC1C;EAEA,IAAI;EACJ,IAAI,QAAQ;EAEZ,IAAI,KAAK,cAAc,GAAG,GAAG;GAC3B,QAAQ,IAAI;GACZ,QAAQ,IAAI,IAAI,KAAK,IAAI,KAAK;EAChC,OACE,QAAQ;EAIV,IAAI,KAAK,eAAe,KAAK,cAAc,GACzC,KAAK,MAAM,KAAK;GACd;GACA,WAAW,MAAM,KAAK;GACtB,UAAU;EACZ,CAAC;EAGH,MAAM,KAAK,OAAO,OAAO,KAAK,QAAQ,gBAAgB,aAAa;GACjE,WAAW,KAAK;GAChB;EACF,CAAC;EAED,OAAO;GAAE;GAAO;EAAM;CACxB;;;;;CAMA,MAAa,gBACX,KACA,SACkB;EAClB,MAAM,WAAW,KAAK,kBAAkB,IAAI,GAAG;EAC/C,IAAI,UACF,OAAO;EAET,MAAM,WAAW,YAAY;GAC3B,IAAI;IACF,OAAO,MAAM,QAAQ;GACvB,UAAU;IACR,KAAK,kBAAkB,OAAO,GAAG;GACnC;EACF,GAAG;EACH,KAAK,kBAAkB,IAAI,KAAK,OAAO;EACvC,OAAO;CACT;;;;;;CAOA,gBACE,KACA,SACM;EACN,IAAI,KAAK,kBAAkB,IAAI,GAAG,GAChC;EAEF,MAAM,WAAW,YAAY;GAC3B,IAAI;IACF,MAAM,SAAS,MAAM,QAAQ;IAC7B,MAAM,KAAK,IAAI,KAAK,MAAM;IAC1B,MAAM,KAAK,OAAO,OAAO,KAAK,oBAAoB;KAChD,WAAW,KAAK;KAChB;IACF,CAAC;IACD,OAAO;GACT,UAAU;IACR,KAAK,kBAAkB,OAAO,GAAG;GACnC;EACF,GAAG;EACH,QAAQ,YAAY,CAEpB,CAAC;EACD,KAAK,kBAAkB,IAAI,KAAK,OAAO;CACzC;CAEA,YAAqC;EACnC,IAAI,CAAC,KAAK,QAAQ,UAChB,OAAO,KAAK,OAAO,OAAO,aAAa;EAGzC,IAAI,KAAK,QAAQ,aAAa,UAC5B,OAAO,KAAK,OAAO,OAAO,mBAAmB;EAG/C,OAAO,KAAK,OAAO,OAAO,KAAK,QAAQ,QAAQ;CACjD;CAEA,cAAwB,OAAsC;EAC5D,OACE,UAAU,QACV,OAAO,UAAU,YAChB,MAAkC,gBAAgB,KACnD,OAAQ,SACR,OAAQ;CAEZ;CAEA,MAAgB,KAAa,OAA+B;EAC1D,IAAI,CAAC,KAAK,aAAa;EACvB,IAAI,KAAK,YAAY,IAAI,GAAG,GAC1B,KAAK,YAAY,OAAO,GAAG;EAE7B,KAAK,YAAY,IAAI,KAAK,KAAK;EAC/B,OAAO,KAAK,YAAY,OAAO,KAAK,WAAW;GAC7C,MAAM,QAAQ,KAAK,YAAY,KAAK,EAAE,KAAK,EAAE;GAC7C,IAAI,UAAU,KAAA,GAAW;GACzB,KAAK,YAAY,OAAO,KAAK;EAC/B;CACF;CAEA,MAAgB,KAAmB;EACjC,KAAK,aAAa,OAAO,GAAG;CAC9B;AACF;AAsBA,OAAO,QAAQ;;;;;;AChlBf,MAAa,qBAAqB;;;;;;;;;;;;;;;;;;AAqBlC,IAAa,uBAAb,cAA0C,cAAc;CACtD,SAA4B,QAAQ,MAAM;CAC1C,MAAyB,QAAQ;CAEjC;CAEA,UAA6B,MAAM;EACjC,IAAI;EACJ,SAAS,YAAY;GAKnB,IAJe,KAAK,OACjB,WAA2B,OAAO,EAClC,QAAQ,OAAO,GAAG,aAAa,IAEzB,EAAE,WAAW,GAAG;IACvB,KAAK,IAAI,KACP,sGACF;IACA;GACF;GAEA,MAAM,gBAAgB,KAAK,OAAO,IAAI,gBAAgB;GAGtD,IAAI,CAAC,eACH,MAAM,IAAI,YACR,kFACF;GAGF,MAAM,UAAU,cAAc;GAG9B,IAAI,CAAC,SACH,MAAM,IAAI,YACR,eAAe,mBAAmB,+CACpC;GAGF,KAAK,KAAK;GAEV,KAAK,IAAI,KAAK,wBAAwB;EACxC;CACF,CAAC;CAED,MAAa,IAAI,MAAc,KAA8C;EAC3E,IAAI,CAAC,KAAK,OAAO,UAAU,GACzB;EAGF,MAAM,QAAQ,KAAK,OAAO,MAAM,GAAG;EACnC,MAAM,SAAS,MAAM,KAAK,MAAM,EAAE,IAAI,OAAO,aAAa;EAC1D,IAAI,CAAC,QACH;EAGF,KAAK,IAAI,MAAM,aAAa;GAC1B,MAAM,OAAO;GACb,KAAK;EACP,CAAC;EAED,OAAO,IAAI,WAAW,MAAM;CAC9B;CAEA,MAAa,IACX,MACA,KACA,OACA,KACqB;EACrB,IAAI,CAAC,KAAK,OAAO,QAAQ,GACvB,OAAO,IAAI,WAAW,KAAK;EAG7B,MAAM,QAAQ,KAAK,OAAO,MAAM,GAAG;EACnC,MAAM,UAAwB,CAAC;EAE/B,IAAI,KAEF,QAAQ,gBAAgB,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,GAAI,CAAC;EAG5D,MAAM,KAAK,MAAM,EAAE,IACjB,OACA,MAAM,OAAO,MACX,MAAM,YACN,MAAM,aAAa,MAAM,UAC3B,GACA,OACF;EACA,OAAO;CACT;CAEA,MAAa,IAAI,MAAc,GAAG,MAA+B;EAC/D,MAAM,KAAK,KAAK,MAAM;EAEtB,IAAI,KAAK,WAAW,GAAG;GAErB,MAAM,SAAS,KAAK,OAAO,IAAI;GAC/B,MAAM,UAAU,MAAM,KAAK,YAAY,GAAG,OAAO,EAAE;GACnD,KAAK,MAAM,KAAK,SACd,MAAM,GAAG,OAAO,CAAC;GAEnB;EACF;EAEA,MAAM,UAAU,KAAK,OAAO,IAAI;EAChC,KAAK,MAAM,OAAO,MAAM;GACtB,MAAM,UAAU,IAAI,WAAW,OAAO,IAAI,MAAM,KAAK,OAAO,MAAM,GAAG;GACrE,MAAM,GAAG,OAAO,OAAO;EACzB;CACF;CAEA,MAAa,IAAI,MAAc,KAA+B;EAC5D,MAAM,QAAQ,KAAK,OAAO,MAAM,GAAG;EAEnC,OAAO,MADa,KAAK,MAAM,EAAE,IAAI,OAAO,MAAM,MACjC;CACnB;CAEA,MAAa,KAAK,MAAc,QAAoC;EAClE,MAAM,SAAS,SACX,GAAG,KAAK,OAAO,IAAI,EAAE,GAAG,WACxB,GAAG,KAAK,OAAO,IAAI,EAAE;EAEzB,OAAO,KAAK,YAAY,MAAM;CAChC;CAEA,MAAa,QAAuB;EAClC,KAAK,IAAI,MAAM,oBAAoB;EACnC,MAAM,KAAK,KAAK,MAAM;EACtB,MAAM,UAAU,MAAM,KAAK,YAAY,QAAQ;EAC/C,KAAK,MAAM,OAAO,SAChB,MAAM,GAAG,OAAO,GAAG;CAEvB;CAEA,MAAa,KACX,MACA,KACA,QACiB;EACjB,MAAM,QAAQ,KAAK,OAAO,MAAM,GAAG;EACnC,MAAM,KAAK,KAAK,MAAM;EAEtB,MAAM,WAAW,MAAM,GAAG,IAAI,OAAO,MAAM;EAC3C,IAAI,UAAU;EAEd,IAAI,aAAa,MACf,UAAU,OAAO,SAAS,UAAU,EAAE,KAAK;EAG7C,MAAM,WAAW,UAAU;EAC3B,MAAM,GAAG,IAAI,OAAO,OAAO,QAAQ,CAAC;EACpC,OAAO;CACT;;;;CAKA,OAAiB,GAAG,MAAwB;EAC1C,OAAO,CAAC,SAAS,GAAG,IAAI,EAAE,KAAK,GAAG;CACpC;CAEA,QAA+B;EAC7B,IAAI,CAAC,KAAK,IACR,MAAM,IAAI,YACR,mDACF;EAEF,OAAO,KAAK;CACd;;;;CAKA,MAAgB,YAAY,QAAmC;EAC7D,MAAM,KAAK,KAAK,MAAM;EACtB,MAAM,UAAoB,CAAC;EAC3B,IAAI;EAEJ,GAAG;GACD,MAAM,SAAS,MAAM,GAAG,KAAK;IAC3B;IACA;GACF,CAAC;GAED,KAAK,MAAM,OAAO,OAAO,MACvB,QAAQ,KAAK,IAAI,IAAI;GAGvB,SAAS,OAAO,gBAAgB,KAAA,IAAY,OAAO;EACrD,SAAS;EAET,OAAO;CACT;AACF;;;;;;;;;;;;;;;ACpMA,MAAa,cAAc,QAAQ;CACjC,MAAM;CACN,YAAY,CAAC,MAAM;CACnB,UAAU,CAAC,aAAa;CACxB,UAAU,CAAC,mBAAmB;CAC9B,WAAW,WACT,OAAO,KAAK;EACV,UAAU;EACV,SAAS;EACT,KAAK;CACP,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/cache/core/errors/CacheError.ts","../../../src/cache/core/providers/CacheProvider.ts","../../../src/cache/core/providers/MemoryCacheProvider.ts","../../../src/cache/core/primitives/$cache.ts","../../../src/cache/core/providers/CloudflareKVProvider.ts","../../../src/cache/core/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class CacheError extends AlephaError {}\n","import { CacheError } from \"../errors/CacheError.ts\";\n\n/**\n * Cache provider interface.\n *\n * All methods are asynchronous and return promises.\n * Values are stored as Uint8Array.\n */\nexport abstract class CacheProvider {\n  protected encoder: TextEncoder = new TextEncoder();\n  protected decoder: TextDecoder = new TextDecoder();\n  protected codes = {\n    BINARY: 0x01,\n    JSON: 0x02,\n    STRING: 0x03,\n    COMPRESSED: 0x04,\n  };\n\n  /**\n   * Get the value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to get.\n   *\n   * @return The value of the key, or undefined if the key does not exist.\n   */\n  public abstract get(\n    name: string,\n    key: string,\n  ): Promise<Uint8Array | undefined>;\n\n  /**\n   * Set the string value of a key.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param key The key of the value to set.\n   * @param value The value to set.\n   * @param ttl The time-to-live of the key, in milliseconds.\n   *\n   * @return The value of the key.\n   */\n  public abstract set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array>;\n\n  /**\n   * Remove the specified keys.\n   *\n   * @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n   * @param keys The keys to delete.\n   */\n  public abstract del(name: string, ...keys: string[]): Promise<void>;\n\n  public abstract has(name: string, key: string): Promise<boolean>;\n\n  public abstract keys(name: string, filter?: string): Promise<string[]>;\n\n  /**\n   * Remove all keys from all cache names.\n   */\n  public abstract clear(): Promise<void>;\n\n  /**\n   * Increment the integer value of a key by the given amount.\n   *\n   * If the key does not exist, it is set to 0 before performing the operation.\n   * This operation is atomic when using Redis.\n   *\n   * @param name Cache name, used to group keys.\n   * @param key The key to increment.\n   * @param amount The amount to increment by.\n   * @returns The new value after incrementing.\n   */\n  public abstract incr(\n    name: string,\n    key: string,\n    amount: number,\n  ): Promise<number>;\n\n  // ---------------------------------------------------------------------------\n  // High-level methods — serialize/compress layer used by CachePrimitive\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Set a typed value with automatic serialization and optional compression.\n   */\n  public async setTyped(\n    name: string,\n    key: string,\n    value: unknown,\n    options?: { ttl?: number; compress?: boolean },\n  ): Promise<void> {\n    let data = this.serialize(value);\n    if (options?.compress) {\n      data = await this.compress(data);\n    }\n    await this.set(name, key, data, options?.ttl);\n  }\n\n  /**\n   * Get a typed value with automatic deserialization and optional decompression.\n   */\n  public async getTyped<T>(name: string, key: string): Promise<T | undefined> {\n    const data = await this.get(name, key);\n    if (data) {\n      if (data[0] === this.codes.COMPRESSED) {\n        const decompressed = await this.decompress(data.subarray(1));\n        return this.deserialize<T>(decompressed);\n      }\n      return this.deserialize<T>(data);\n    }\n    return undefined;\n  }\n\n  /**\n   * Invalidate cache keys with wildcard support.\n   *\n   * Keys ending in `*` are expanded via `this.keys()`.\n   * Called with no keys, delegates to `this.del(name)` which clears the entire container.\n   */\n  public async invalidateKeys(name: string, keys: string[]): Promise<void> {\n    const keysToDelete: string[] = [];\n\n    for (const key of keys) {\n      if (key.endsWith(\"*\")) {\n        const result = await this.keys(name, key.slice(0, -1));\n        keysToDelete.push(...result);\n      } else {\n        keysToDelete.push(key);\n      }\n    }\n\n    await this.del(name, ...keysToDelete);\n  }\n\n  /**\n   * Serialize a value to a typed Uint8Array with a leading type marker byte.\n   */\n  protected serialize(value: unknown): Uint8Array {\n    if (value instanceof Uint8Array) {\n      const result = new Uint8Array(1 + value.length);\n      result[0] = this.codes.BINARY;\n      result.set(value, 1);\n      return result;\n    }\n\n    const encoded = this.encoder.encode(\n      typeof value === \"string\" ? value : JSON.stringify(value),\n    );\n    const code =\n      typeof value === \"string\" ? this.codes.STRING : this.codes.JSON;\n    const result = new Uint8Array(1 + encoded.length);\n    result[0] = code;\n    result.set(encoded, 1);\n    return result;\n  }\n\n  /**\n   * Deserialize a typed Uint8Array back to the original value.\n   */\n  protected deserialize<T>(uint8Array: Uint8Array): T {\n    const type = uint8Array[0];\n    const payload = uint8Array.slice(1);\n\n    if (type === this.codes.BINARY) {\n      return payload as T;\n    }\n    if (type === this.codes.JSON) {\n      return JSON.parse(this.decoder.decode(payload)) as T;\n    }\n    if (type === this.codes.STRING) {\n      return this.decoder.decode(payload) as T;\n    }\n\n    throw new CacheError(`Unknown serialization type: ${type}`);\n  }\n\n  /**\n   * Compress data with gzip, prepending a COMPRESSED marker byte.\n   */\n  protected async compress(data: Uint8Array): Promise<Uint8Array> {\n    const buf = (data.buffer as ArrayBuffer).slice(\n      data.byteOffset,\n      data.byteOffset + data.byteLength,\n    );\n    const compressed = new Uint8Array(\n      await new Response(\n        new Blob([buf]).stream().pipeThrough(new CompressionStream(\"gzip\")),\n      ).arrayBuffer(),\n    );\n    const result = new Uint8Array(1 + compressed.length);\n    result[0] = this.codes.COMPRESSED;\n    result.set(compressed, 1);\n    return result;\n  }\n\n  /**\n   * Decompress gzipped data.\n   */\n  protected async decompress(data: Uint8Array): Promise<Uint8Array> {\n    const buf = (data.buffer as ArrayBuffer).slice(\n      data.byteOffset,\n      data.byteOffset + data.byteLength,\n    );\n    return new Uint8Array(\n      await new Response(\n        new Blob([buf]).stream().pipeThrough(new DecompressionStream(\"gzip\")),\n      ).arrayBuffer(),\n    );\n  }\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { CacheProvider } from \"./CacheProvider.ts\";\n\ntype CacheName = string;\ntype CacheKey = string;\ntype CacheValue = {\n  data?: Uint8Array;\n  timeout?: Timeout;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface MemoryCacheCall {\n  name: string;\n  key: string;\n  timestamp: number;\n}\n\nexport interface MemoryCacheSetCall extends MemoryCacheCall {\n  value: Uint8Array;\n  ttl?: number;\n}\n\nexport interface MemoryCacheDelCall {\n  name: string;\n  keys: string[];\n  timestamp: number;\n}\n\nexport interface MemoryCacheStats {\n  hits: number;\n  misses: number;\n  sets: number;\n  deletes: number;\n}\n\nexport interface MemoryCacheProviderOptions {\n  /**\n   * Error to throw on get operations (for testing error handling)\n   */\n  getError?: Error | null;\n  /**\n   * Error to throw on set operations (for testing error handling)\n   */\n  setError?: Error | null;\n  /**\n   * Error to throw on del operations (for testing error handling)\n   */\n  delError?: Error | null;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * In-memory implementation of CacheProvider for testing.\n *\n * This provider stores all cache entries in memory, making it ideal for\n * unit tests that need to verify cache operations without touching Redis or other backends.\n *\n * @example\n * ```typescript\n * // In tests, substitute the real CacheProvider with MemoryCacheProvider\n * const alepha = Alepha.create().with({\n *   provide: CacheProvider,\n *   use: MemoryCacheProvider,\n * });\n *\n * // Run code that uses caching\n * const service = alepha.inject(MyService);\n * await service.fetchWithCache(\"key\");\n *\n * // Verify cache behavior\n * const cache = alepha.inject(MemoryCacheProvider);\n * expect(cache.stats().misses).toBe(1);\n * await service.fetchWithCache(\"key\");\n * expect(cache.stats().hits).toBe(1);\n * ```\n */\nexport class MemoryCacheProvider extends CacheProvider {\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly log = $logger();\n\n  protected store: Record<CacheName, Record<CacheKey, CacheValue>> = {};\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Test tracking\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  /**\n   * All recorded get calls.\n   */\n  public getCalls: MemoryCacheCall[] = [];\n\n  /**\n   * All recorded set calls.\n   */\n  public setCalls: MemoryCacheSetCall[] = [];\n\n  /**\n   * All recorded del calls.\n   */\n  public delCalls: MemoryCacheDelCall[] = [];\n\n  /**\n   * Cache statistics.\n   */\n  protected _stats: MemoryCacheStats = {\n    hits: 0,\n    misses: 0,\n    sets: 0,\n    deletes: 0,\n  };\n\n  /**\n   * Error to throw on get (for testing error handling)\n   */\n  public getError: Error | null = null;\n\n  /**\n   * Error to throw on set (for testing error handling)\n   */\n  public setError: Error | null = null;\n\n  /**\n   * Error to throw on del (for testing error handling)\n   */\n  public delError: Error | null = null;\n\n  constructor(options: MemoryCacheProviderOptions = {}) {\n    super();\n    this.getError = options.getError ?? null;\n    this.setError = options.setError ?? null;\n    this.delError = options.delError ?? null;\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // CacheProvider implementation\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  public async get(name: string, key: string): Promise<Uint8Array | undefined> {\n    this.getCalls.push({\n      name,\n      key,\n      timestamp: this.dateTimeProvider.nowMillis(),\n    });\n\n    if (this.getError) {\n      throw this.getError;\n    }\n\n    const data = this.store[name]?.[key]?.data;\n\n    if (data !== undefined) {\n      this._stats.hits++;\n    } else {\n      this._stats.misses++;\n    }\n\n    return data;\n  }\n\n  public async set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array> {\n    this.setCalls.push({\n      name,\n      key,\n      value,\n      ttl,\n      timestamp: this.dateTimeProvider.nowMillis(),\n    });\n    this._stats.sets++;\n\n    if (this.setError) {\n      throw this.setError;\n    }\n\n    if (this.store[name] == null) {\n      this.store[name] = {};\n    }\n\n    this.store[name][key] ??= {};\n    this.store[name][key].data = value;\n\n    this.log.debug(`Setting cache for name`, { name, key, ttl });\n\n    // clear previous timeout if exists\n    if (this.store[name][key].timeout) {\n      this.dateTimeProvider.clearTimeout(this.store[name][key].timeout);\n      this.store[name][key].timeout = undefined;\n    }\n\n    if (ttl) {\n      this.store[name][key].timeout = this.dateTimeProvider.createTimeout(\n        () => this.del(name, key),\n        ttl,\n      );\n    }\n\n    return this.store[name][key].data;\n  }\n\n  public async del(name: string, ...keys: string[]): Promise<void> {\n    this.delCalls.push({\n      name,\n      keys,\n      timestamp: this.dateTimeProvider.nowMillis(),\n    });\n    this._stats.deletes++;\n\n    if (this.delError) {\n      throw this.delError;\n    }\n\n    // delete all keys in name\n    if (keys.length === 0) {\n      this.log.debug(`Deleting all cache for name`, { name });\n\n      if (this.store[name]) {\n        for (const key of Object.keys(this.store[name])) {\n          const timeout = this.store[name][key]?.timeout;\n          if (timeout) {\n            this.dateTimeProvider.clearTimeout(timeout);\n          }\n        }\n      }\n      delete this.store[name];\n      return;\n    }\n\n    this.log.debug(`Deleting cache for name`, { name, keys });\n\n    // delete specific keys in name\n    for (const key of keys) {\n      if (this.store[name] == null) break;\n\n      const timeout = this.store[name][key]?.timeout;\n      if (timeout) {\n        this.dateTimeProvider.clearTimeout(timeout);\n      }\n\n      delete this.store[name][key];\n    }\n\n    if (Object.keys(this.store[name] ?? {}).length === 0) {\n      // if name is empty, delete it\n      delete this.store[name];\n    }\n  }\n\n  public async has(name: string, key: string): Promise<boolean> {\n    return this.store[name]?.[key]?.data != null;\n  }\n\n  public async keys(name: string, filter?: string): Promise<string[]> {\n    const store = this.store[name] ?? {};\n    const keys = Object.keys(store);\n    if (filter) {\n      return keys.filter((key) => key.startsWith(filter));\n    }\n    return keys;\n  }\n\n  public async clear(): Promise<void> {\n    this.log.debug(\"Clearing all cache\");\n\n    // Clear all timeouts before clearing the store\n    for (const name of Object.keys(this.store)) {\n      for (const key of Object.keys(this.store[name])) {\n        const timeout = this.store[name][key]?.timeout;\n        if (timeout) {\n          this.dateTimeProvider.clearTimeout(timeout);\n        }\n      }\n    }\n\n    this.store = {};\n  }\n\n  public async incr(\n    name: string,\n    key: string,\n    amount: number,\n  ): Promise<number> {\n    if (this.store[name] == null) {\n      this.store[name] = {};\n    }\n\n    const existing = this.store[name][key]?.data;\n    let current = 0;\n\n    if (existing) {\n      try {\n        current = this.deserialize<number>(existing);\n      } catch {\n        // Fallback for raw bytes without type marker\n        const str = new TextDecoder().decode(existing);\n        current = Number.parseInt(str, 10) || 0;\n      }\n    }\n\n    const newValue = current + amount;\n    this.store[name][key] ??= {};\n    this.store[name][key].data = this.serialize(newValue);\n\n    return newValue;\n  }\n\n  // ─────────────────────────────────────────────────────────────────────────────\n  // Test utilities\n  // ─────────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Get cache statistics (hits, misses, sets, deletes).\n   *\n   * @example\n   * ```typescript\n   * expect(cache.stats().hits).toBe(1);\n   * expect(cache.stats().misses).toBe(0);\n   * ```\n   */\n  public stats(): MemoryCacheStats {\n    return { ...this._stats };\n  }\n\n  /**\n   * Check if a key was set during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.wasSet(\"my-cache\", \"user:123\")).toBe(true);\n   * ```\n   */\n  public wasSet(name: string, key?: string): boolean {\n    if (key === undefined) {\n      return this.setCalls.some((call) => call.name === name);\n    }\n    return this.setCalls.some((call) => call.name === name && call.key === key);\n  }\n\n  /**\n   * Check if a key was retrieved during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.wasGet(\"my-cache\", \"user:123\")).toBe(true);\n   * ```\n   */\n  public wasGet(name: string, key?: string): boolean {\n    if (key === undefined) {\n      return this.getCalls.some((call) => call.name === name);\n    }\n    return this.getCalls.some((call) => call.name === name && call.key === key);\n  }\n\n  /**\n   * Check if a key was deleted during the test.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.wasDeleted(\"my-cache\", \"user:123\")).toBe(true);\n   * ```\n   */\n  public wasDeleted(name: string, key?: string): boolean {\n    if (key === undefined) {\n      return this.delCalls.some((call) => call.name === name);\n    }\n    return this.delCalls.some(\n      (call) => call.name === name && call.keys.includes(key),\n    );\n  }\n\n  /**\n   * Get the number of cached entries for a specific cache name.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.size(\"my-cache\")).toBe(5);\n   * ```\n   */\n  public size(name?: string): number {\n    if (name === undefined) {\n      return Object.values(this.store).reduce(\n        (total, entries) => total + Object.keys(entries).length,\n        0,\n      );\n    }\n    return Object.keys(this.store[name] ?? {}).length;\n  }\n\n  /**\n   * Get all cache names.\n   *\n   * @example\n   * ```typescript\n   * expect(cache.names()).toContain(\"my-cache\");\n   * ```\n   */\n  public names(): string[] {\n    return Object.keys(this.store);\n  }\n\n  /**\n   * Reset all in-memory state (useful between tests).\n   *\n   * @example\n   * ```typescript\n   * beforeEach(() => {\n   *   cache.reset();\n   * });\n   * ```\n   */\n  public reset(): void {\n    // Clear all timeouts\n    for (const name of Object.keys(this.store)) {\n      for (const key of Object.keys(this.store[name])) {\n        const timeout = this.store[name][key]?.timeout;\n        if (timeout) {\n          this.dateTimeProvider.clearTimeout(timeout);\n        }\n      }\n    }\n\n    this.store = {};\n    this.getCalls = [];\n    this.setCalls = [];\n    this.delCalls = [];\n    this._stats = { hits: 0, misses: 0, sets: 0, deletes: 0 };\n    this.getError = null;\n    this.setError = null;\n    this.delError = null;\n  }\n}\n","import {\n  $atom,\n  $inject,\n  $state,\n  AlephaError,\n  createPrimitive,\n  KIND,\n  type MiddlewareMetadata,\n  OPTIONS,\n  Primitive,\n  type Service,\n  type Static,\n  z,\n} from \"alepha\";\nimport { DateTimeProvider, type DurationLike } from \"alepha/datetime\";\nimport { CacheProvider } from \"../providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"../providers/MemoryCacheProvider.ts\";\n\n/**\n * Creates a cache primitive for caching with automatic management.\n *\n * **Middleware mode** (no `handler`) — usable in `use` arrays AND as a store:\n * ```ts\n * class UserService {\n *   userCache = $cache({ name: \"users\", ttl: [10, \"minutes\"] });\n *\n *   fetchUser = $pipeline({\n *     use: [this.userCache],\n *     handler: async (userId: string) => this.repo.getById(userId),\n *   });\n *\n *   async invalidateUser(userId: string) {\n *     await this.userCache.invalidate(userId);\n *   }\n * }\n * ```\n *\n * **Primitive mode** (with `handler`) — standalone callable:\n * ```ts\n * getUserData = $cache({\n *   name: \"user-data\",\n *   ttl: [10, \"minutes\"],\n *   handler: async (userId: string) => {\n *     return await database.users.findById(userId);\n *   }\n * });\n * ```\n */\nexport function $cache<TReturn = string, TParameter extends any[] = any[]>(\n  options: CachePrimitiveOptions<TReturn, TParameter> & {\n    handler: (...args: TParameter) => TReturn;\n  },\n): CachePrimitiveFn<TReturn, TParameter>;\nexport function $cache<TReturn = any, TParameter extends any[] = any[]>(\n  options?: CachePrimitiveOptions<TReturn, TParameter>,\n): CacheMiddlewareFn<TReturn>;\nexport function $cache(options: any = {}): any {\n  const instance = createPrimitive(CachePrimitive, options);\n\n  if (options.handler) {\n    const fn = (...args: any[]): Promise<any> => instance.run(...args);\n    return Object.setPrototypeOf(fn, instance);\n  }\n\n  // Middleware mode: callable as (handler) => wrappedHandler, with store methods\n  const mw: any = <T extends (...args: any[]) => any>(handler: T): T => {\n    return (async (...args: any[]) => {\n      const key = instance.key(...args);\n      const read = await instance.read(key);\n\n      if (read.value !== undefined) {\n        if (read.stale) {\n          instance.scheduleRefresh(key, () => handler(...args));\n        }\n        return read.value;\n      }\n\n      const result = await instance.runSingleFlight(key, () =>\n        handler(...args),\n      );\n      // Fire-and-forget — cache write failures must not break the handler result\n      instance.set(key, result).catch(() => {});\n      return result;\n    }) as any as T;\n  };\n\n  mw[OPTIONS] = {\n    name: \"$cache\",\n    options: options as unknown as Record<string, unknown>,\n  } satisfies MiddlewareMetadata;\n\n  return Object.setPrototypeOf(mw, instance);\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Options for the in-memory L1 tier.\n */\nexport interface CacheMemoryTierOptions {\n  /**\n   * TTL for the in-memory tier. Should be ≤ the remote `ttl`.\n   * Bounds the cross-isolate staleness window after invalidation.\n   *\n   * @default min(ttl, 30s)\n   */\n  ttl?: DurationLike;\n\n  /**\n   * LRU bound — max entries kept in memory before eviction.\n   *\n   * @default 500\n   */\n  max?: number;\n\n  /**\n   * Also cache provider misses (`undefined`) in memory for this duration.\n   * Prevents hammering the remote tier on cold/unknown keys.\n   *\n   * @default off\n   */\n  negative?: DurationLike;\n}\n\nexport interface CachePrimitiveOptions<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> {\n  /**\n   * The cache name. This is useful for invalidating multiple caches at once.\n   *\n   * Store key as `cache:$name:$key`.\n   *\n   * @default Name of the key of the class.\n   */\n  name?: string;\n\n  /**\n   * Function which returns cached data.\n   */\n  handler?: (...args: TParameter) => TReturn;\n\n  /**\n   * The key generator for the cache.\n   * If not provided, the arguments will be json.stringify().\n   */\n  key?: (...args: TParameter) => string;\n\n  /**\n   * The store provider for the cache.\n   *\n   * Accepts:\n   * - `\"memory\"` — short-circuits to {@link MemoryCacheProvider} regardless\n   *   of the default `CacheProvider` binding. Useful for caches that must\n   *   stay process-local (e.g. ETag, HTTP client).\n   * - A {@link CacheProvider} class (concrete OR abstract) — resolved via\n   *   `alepha.inject(...)` at primitive construction. Use this to opt a\n   *   specific cache into a non-default backend (e.g.\n   *   `provider: DatabaseCacheProvider` to keep one cache in SQL while the\n   *   rest of the app uses Cloudflare KV).\n   * - `undefined` — falls back to whatever is bound to `CacheProvider` in\n   *   the container. On Cloudflare workers this is\n   *   {@link CloudflareKVProvider} by default; on Node it's\n   *   {@link MemoryCacheProvider}.\n   *\n   * Note: passing an *abstract* class works because Alepha's DI resolves\n   * through substitutions, e.g. `alepha.with({ provide: CacheProvider, use:\n   * MyCacheProvider })`.\n   */\n  provider?: Service<CacheProvider> | \"memory\";\n\n  /**\n   * The time-to-live for the cache in seconds.\n   * Set 0 to skip expiration.\n   *\n   * @default 300 (5 minutes).\n   */\n  ttl?: DurationLike;\n\n  /**\n   * If the cache is disabled.\n   */\n  disabled?: boolean;\n\n  /**\n   * Enable gzip compression for cached values.\n   * Reduces storage size by 60-80% for JSON payloads at the cost of CPU.\n   */\n  compress?: boolean;\n\n  /**\n   * Add an in-process L1 memory tier in front of `provider`.\n   *\n   * Reads check memory first, fall back to the provider on miss. Writes go\n   * to both tiers (write-through), so own-writes are immediately visible.\n   *\n   * Caveats:\n   * - Per-process only. Each Worker isolate / Node process has its own L1.\n   *   `invalidate()` clears the local L1 + the remote provider; other\n   *   processes keep their L1 until its TTL expires.\n   * - Use a short L1 TTL to bound the cross-isolate staleness window.\n   *\n   * @default off\n   */\n  memory?: true | CacheMemoryTierOptions;\n\n  /**\n   * Stale-while-revalidate window. After `ttl` expires, the cached value\n   * remains servable for `stale` longer; reads in this window return the\n   * stale value immediately and trigger ONE background refresh\n   * (single-flight per key).\n   *\n   * Requires a `handler` (primitive mode) OR middleware mode wrapping a\n   * handler — the cache needs to know how to recompute.\n   *\n   * @default off\n   */\n  stale?: DurationLike;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Cache configuration atom.\n */\nexport const cacheOptions = $atom({\n  name: \"alepha.cache.options\",\n  schema: z.object({\n    enabled: z.boolean().describe(\"Whether caching is enabled.\").default(true),\n    defaultTtl: z\n      .number()\n      .describe(\"Default time to live for cache entries in seconds.\")\n      .default(300),\n  }),\n  default: {\n    enabled: true,\n    defaultTtl: 300,\n  },\n});\n\nexport type CacheAtomOptions = Static<typeof cacheOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [cacheOptions.key]: CacheAtomOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst DEFAULT_MEMORY_MAX = 500;\nconst DEFAULT_MEMORY_TTL_MS = 30_000;\nconst SWR_MARKER = \"__swr\" as const;\n\ntype SwrEnvelope = {\n  [SWR_MARKER]: 1;\n  v: unknown;\n  f: number;\n};\n\ntype L1Entry<T> = {\n  value: T | undefined;\n  expiresAt: number;\n  negative: boolean;\n};\n\ntype ReadResult<T> = {\n  value: T | undefined;\n  stale: boolean;\n};\n\nexport class CachePrimitive<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends Primitive<CachePrimitiveOptions<TReturn, TParameter>> {\n  protected readonly settings = $state(cacheOptions);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  public readonly provider = this.$provider();\n\n  protected readonly memoryStore?: Map<string, L1Entry<TReturn>>;\n  protected readonly memoryMax: number = DEFAULT_MEMORY_MAX;\n  protected readonly memoryTtlMs: number = 0;\n  protected readonly negativeTtlMs: number = 0;\n\n  protected readonly inflightRefreshes = new Map<string, Promise<TReturn>>();\n\n  constructor(\n    args: ConstructorParameters<\n      typeof Primitive<CachePrimitiveOptions<TReturn, TParameter>>\n    >[0],\n  ) {\n    super(args);\n    const mem = this.options.memory;\n    if (mem) {\n      this.memoryStore = new Map();\n      const memOpts: CacheMemoryTierOptions = mem === true ? {} : mem;\n      this.memoryMax = memOpts.max ?? DEFAULT_MEMORY_MAX;\n      // Default L1 TTL: min(remote ttl, 30s). If remote ttl is 0/infinite, use 30s.\n      if (memOpts.ttl !== undefined) {\n        this.memoryTtlMs = this.dateTimeProvider\n          .duration(memOpts.ttl)\n          .as(\"milliseconds\");\n      } else {\n        const remoteTtlMs = this.options.ttl\n          ? this.dateTimeProvider.duration(this.options.ttl).as(\"milliseconds\")\n          : 0;\n        this.memoryTtlMs =\n          remoteTtlMs > 0\n            ? Math.min(remoteTtlMs, DEFAULT_MEMORY_TTL_MS)\n            : DEFAULT_MEMORY_TTL_MS;\n      }\n      if (memOpts.negative !== undefined) {\n        this.negativeTtlMs = this.dateTimeProvider\n          .duration(memOpts.negative)\n          .as(\"milliseconds\");\n      }\n    }\n  }\n\n  public get container(): string {\n    return (\n      this.options.name ??\n      `${this.config.service.name}:${this.config.propertyKey}`\n    );\n  }\n\n  public async run(...args: TParameter): Promise<TReturn> {\n    const handler = this.options.handler;\n    if (!handler) {\n      throw new AlephaError(\"Cache handler is not defined.\");\n    }\n\n    const key = this.key(...args);\n    const read = await this.read(key);\n\n    if (read.value !== undefined) {\n      if (read.stale) {\n        this.scheduleRefresh(key, () => handler(...args));\n      }\n      return read.value;\n    }\n\n    const result = await this.runSingleFlight(key, () => handler(...args));\n    // note: when exception occurs, don't cache the result\n    await this.set(key, result);\n    return result;\n  }\n\n  public key(...args: TParameter): string {\n    return this.options.key ? this.options.key(...args) : JSON.stringify(args);\n  }\n\n  public async incr(key: string, amount = 1): Promise<number> {\n    const result = await this.provider.incr(this.container, key, amount);\n    // L1 is no longer authoritative after atomic incr on remote.\n    this.delL1(key);\n    return result;\n  }\n\n  public async invalidate(...keys: string[]): Promise<void> {\n    if (this.memoryStore) {\n      if (keys.length === 0) {\n        this.memoryStore.clear();\n      } else {\n        for (const key of keys) {\n          if (key.endsWith(\"*\")) {\n            const prefix = key.slice(0, -1);\n            for (const k of this.memoryStore.keys()) {\n              if (k.startsWith(prefix)) this.memoryStore.delete(k);\n            }\n          } else {\n            this.memoryStore.delete(key);\n          }\n        }\n      }\n    }\n    await this.provider.invalidateKeys(this.container, keys);\n  }\n\n  public async set(\n    key: string,\n    value: TReturn,\n    ttl?: DurationLike,\n  ): Promise<void> {\n    if (\n      !this.alepha.isStarted() ||\n      this.options.disabled ||\n      !this.settings.enabled\n    ) {\n      return;\n    }\n\n    const freshTtlMs = this.dateTimeProvider\n      .duration(\n        ttl ?? this.options.ttl ?? [this.settings.defaultTtl, \"seconds\"],\n      )\n      .as(\"milliseconds\");\n\n    const staleMs = this.options.stale\n      ? this.dateTimeProvider.duration(this.options.stale).as(\"milliseconds\")\n      : 0;\n\n    const providerTtlMs = freshTtlMs > 0 ? freshTtlMs + staleMs : 0;\n    const now = this.dateTimeProvider.nowMillis();\n    const freshUntil = freshTtlMs > 0 ? now + freshTtlMs : 0;\n\n    const payload =\n      this.options.stale && freshTtlMs > 0\n        ? ({ [SWR_MARKER]: 1, v: value, f: freshUntil } satisfies SwrEnvelope)\n        : value;\n\n    await this.provider.setTyped(this.container, key, payload, {\n      ttl: providerTtlMs > 0 ? providerTtlMs : undefined,\n      compress: this.options.compress,\n    });\n\n    // Write-through to L1 (raw value, not wrapped).\n    this.setL1(key, {\n      value,\n      expiresAt:\n        this.memoryTtlMs > 0\n          ? now + this.memoryTtlMs\n          : Number.POSITIVE_INFINITY,\n      negative: false,\n    });\n\n    // A fresh write supersedes any pending refresh for this key.\n    this.inflightRefreshes.delete(key);\n\n    await this.alepha.events.emit(\"cache:set\", {\n      container: this.container,\n      key,\n      ttlMs: providerTtlMs > 0 ? providerTtlMs : undefined,\n    });\n  }\n\n  public async get(key: string): Promise<TReturn | undefined> {\n    const read = await this.read(key);\n    return read.value;\n  }\n\n  /**\n   * Internal read that also reports whether the value is stale (SWR\n   * grace window). Middleware and `run()` use this to decide whether to\n   * schedule a background refresh.\n   */\n  public async read(key: string): Promise<ReadResult<TReturn>> {\n    if (\n      !this.alepha.isStarted() ||\n      this.options.disabled ||\n      !this.settings.enabled\n    ) {\n      return { value: undefined, stale: false };\n    }\n\n    const now = this.dateTimeProvider.nowMillis();\n\n    // L1 check\n    if (this.memoryStore) {\n      const entry = this.memoryStore.get(key);\n      if (entry !== undefined) {\n        if (entry.expiresAt > now) {\n          // LRU touch\n          this.memoryStore.delete(key);\n          this.memoryStore.set(key, entry);\n          await this.alepha.events.emit(\"cache:hit\", {\n            container: this.container,\n            key,\n          });\n          return {\n            value: entry.negative ? undefined : entry.value,\n            stale: false,\n          };\n        }\n        this.memoryStore.delete(key);\n      }\n    }\n\n    // L2 check\n    const raw = await this.provider.getTyped<TReturn | SwrEnvelope>(\n      this.container,\n      key,\n    );\n\n    if (raw === undefined) {\n      // Negative caching\n      if (this.memoryStore && this.negativeTtlMs > 0) {\n        this.setL1(key, {\n          value: undefined,\n          expiresAt: now + this.negativeTtlMs,\n          negative: true,\n        });\n      }\n      await this.alepha.events.emit(\"cache:miss\", {\n        container: this.container,\n        key,\n      });\n      return { value: undefined, stale: false };\n    }\n\n    let value: TReturn;\n    let stale = false;\n\n    if (this.isSwrEnvelope(raw)) {\n      value = raw.v as TReturn;\n      stale = raw.f > 0 && raw.f <= now;\n    } else {\n      value = raw as TReturn;\n    }\n\n    // Populate L1 (write-back from L2 read)\n    if (this.memoryStore && this.memoryTtlMs > 0) {\n      this.setL1(key, {\n        value,\n        expiresAt: now + this.memoryTtlMs,\n        negative: false,\n      });\n    }\n\n    await this.alepha.events.emit(stale ? \"cache:stale\" : \"cache:hit\", {\n      container: this.container,\n      key,\n    });\n\n    return { value, stale };\n  }\n\n  /**\n   * Run a handler under single-flight: concurrent callers for the same\n   * key share one in-flight promise.\n   */\n  public async runSingleFlight(\n    key: string,\n    handler: () => Promise<TReturn> | TReturn,\n  ): Promise<TReturn> {\n    const existing = this.inflightRefreshes.get(key);\n    if (existing) {\n      return existing;\n    }\n    const promise = (async () => {\n      try {\n        return await handler();\n      } finally {\n        this.inflightRefreshes.delete(key);\n      }\n    })();\n    this.inflightRefreshes.set(key, promise);\n    return promise;\n  }\n\n  /**\n   * Schedule a background refresh for a stale key. At most one refresh\n   * per key is in-flight at any time; failures are swallowed (the stale\n   * value keeps being served until expiry).\n   */\n  public scheduleRefresh(\n    key: string,\n    handler: () => Promise<TReturn> | TReturn,\n  ): void {\n    if (this.inflightRefreshes.has(key)) {\n      return;\n    }\n    const promise = (async () => {\n      try {\n        const result = await handler();\n        await this.set(key, result);\n        await this.alepha.events.emit(\"cache:revalidate\", {\n          container: this.container,\n          key,\n        });\n        return result;\n      } finally {\n        this.inflightRefreshes.delete(key);\n      }\n    })();\n    promise.catch(() => {\n      // swallow: stale value keeps serving until expiry\n    });\n    this.inflightRefreshes.set(key, promise);\n  }\n\n  protected $provider(): CacheProvider {\n    if (!this.options.provider) {\n      return this.alepha.inject(CacheProvider);\n    }\n\n    if (this.options.provider === \"memory\") {\n      return this.alepha.inject(MemoryCacheProvider);\n    }\n\n    return this.alepha.inject(this.options.provider);\n  }\n\n  protected isSwrEnvelope(value: unknown): value is SwrEnvelope {\n    return (\n      value !== null &&\n      typeof value === \"object\" &&\n      (value as Record<string, unknown>)[SWR_MARKER] === 1 &&\n      \"f\" in (value as Record<string, unknown>) &&\n      \"v\" in (value as Record<string, unknown>)\n    );\n  }\n\n  protected setL1(key: string, entry: L1Entry<TReturn>): void {\n    if (!this.memoryStore) return;\n    if (this.memoryStore.has(key)) {\n      this.memoryStore.delete(key);\n    }\n    this.memoryStore.set(key, entry);\n    while (this.memoryStore.size > this.memoryMax) {\n      const first = this.memoryStore.keys().next().value;\n      if (first === undefined) break;\n      this.memoryStore.delete(first);\n    }\n  }\n\n  protected delL1(key: string): void {\n    this.memoryStore?.delete(key);\n  }\n}\n\nexport interface CachePrimitiveFn<\n  TReturn = any,\n  TParameter extends any[] = any[],\n> extends CachePrimitive<TReturn, TParameter> {\n  /**\n   * Run the cache primitive with the provided arguments.\n   */\n  (...args: TParameter): Promise<TReturn>;\n}\n\n/**\n * Cache middleware + store. Callable as middleware `(handler) => wrappedHandler`\n * AND exposes store methods (`.get()`, `.set()`, `.invalidate()`, `.incr()`).\n */\nexport interface CacheMiddlewareFn<TReturn = any>\n  extends CachePrimitive<TReturn, any[]> {\n  <T extends (...args: any[]) => any>(handler: T): T;\n  [OPTIONS]?: MiddlewareMetadata;\n}\n\n$cache[KIND] = CachePrimitive;\n","import { $hook, $inject, Alepha, AlephaError } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { CachePrimitive } from \"../primitives/$cache.ts\";\nimport { CacheProvider } from \"./CacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * KVNamespace interface matching Cloudflare's KV API.\n */\nexport interface KVNamespace {\n  get(key: string, type: \"arrayBuffer\"): Promise<ArrayBuffer | null>;\n  get(key: string, type: \"text\"): Promise<string | null>;\n  get(key: string, type?: \"text\"): Promise<string | null>;\n  put(\n    key: string,\n    value: string | ArrayBuffer | ReadableStream,\n    options?: KVPutOptions,\n  ): Promise<void>;\n  delete(key: string): Promise<void>;\n  list(options?: KVListOptions): Promise<KVListResult>;\n}\n\nexport interface KVPutOptions {\n  expiration?: number;\n  expirationTtl?: number;\n  metadata?: unknown;\n}\n\nexport interface KVListOptions {\n  prefix?: string;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface KVListResult {\n  keys: KVListKey[];\n  list_complete: boolean;\n  cursor?: string;\n}\n\nexport interface KVListKey {\n  name: string;\n  expiration?: number;\n  metadata?: unknown;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Default KV binding name used in wrangler configuration.\n */\nexport const KV_DEFAULT_BINDING = \"KV_CACHE\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Cloudflare KV cache provider.\n *\n * Uses a KV namespace binding for all cache operations.\n * Keys are stored as: `cache:{name}:{key}`\n *\n * **Required Cloudflare binding:**\n * - `KV_CACHE` - A KV namespace binding in wrangler configuration\n *\n * @example\n * ```toml\n * # wrangler.toml - automatically generated by alepha build\n * [[kv_namespaces]]\n * binding = \"KV_CACHE\"\n * id = \"abc123\"\n * ```\n */\nexport class CloudflareKVProvider extends CacheProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n\n  protected kv?: KVNamespace;\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      const caches = this.alepha\n        .primitives<CachePrimitive>(\"cache\")\n        .filter((it) => it.provider === this);\n\n      if (caches.length === 0) {\n        this.log.info(\n          \"CloudflareKVProvider is registered but no cache primitives are using it. Skipping KV initialization.\",\n        );\n        return;\n      }\n\n      const cloudflareEnv = this.alepha.get(\"cloudflare.env\") as\n        | Record<string, unknown>\n        | undefined;\n      if (!cloudflareEnv) {\n        throw new AlephaError(\n          \"Cloudflare Workers environment not found in Alepha store under 'cloudflare.env'.\",\n        );\n      }\n\n      const binding = cloudflareEnv[KV_DEFAULT_BINDING] as\n        | KVNamespace\n        | undefined;\n      if (!binding) {\n        throw new AlephaError(\n          `KV binding '${KV_DEFAULT_BINDING}' not found in Cloudflare Workers environment.`,\n        );\n      }\n\n      this.kv = binding;\n\n      this.log.info(\"Cloudflare KV cache OK\");\n    },\n  });\n\n  public async get(name: string, key: string): Promise<Uint8Array | undefined> {\n    if (!this.alepha.isStarted()) {\n      return;\n    }\n\n    const kvKey = this.prefix(name, key);\n    const buffer = await this.getKV().get(kvKey, \"arrayBuffer\");\n    if (!buffer) {\n      return;\n    }\n\n    this.log.debug(\"Cache hit\", {\n      size: buffer.byteLength,\n      key: kvKey,\n    });\n\n    return new Uint8Array(buffer);\n  }\n\n  public async set(\n    name: string,\n    key: string,\n    value: Uint8Array,\n    ttl?: number,\n  ): Promise<Uint8Array> {\n    if (!this.alepha.isReady()) {\n      return new Uint8Array(value);\n    }\n\n    const kvKey = this.prefix(name, key);\n    const options: KVPutOptions = {};\n\n    if (ttl) {\n      // KV expects TTL in seconds, we receive milliseconds\n      options.expirationTtl = Math.max(60, Math.ceil(ttl / 1000));\n    }\n\n    await this.getKV().put(\n      kvKey,\n      value.buffer.slice(\n        value.byteOffset,\n        value.byteOffset + value.byteLength,\n      ) as ArrayBuffer,\n      options,\n    );\n    return value;\n  }\n\n  public async del(name: string, ...keys: string[]): Promise<void> {\n    const kv = this.getKV();\n\n    if (keys.length === 0) {\n      // Delete all keys under this cache name\n      const prefix = this.prefix(name);\n      const allKeys = await this.listAllKeys(`${prefix}:`);\n      for (const k of allKeys) {\n        await kv.delete(k);\n      }\n      return;\n    }\n\n    const nameKey = this.prefix(name);\n    for (const key of keys) {\n      const fullKey = key.startsWith(nameKey) ? key : this.prefix(name, key);\n      await kv.delete(fullKey);\n    }\n  }\n\n  public async has(name: string, key: string): Promise<boolean> {\n    const kvKey = this.prefix(name, key);\n    const value = await this.getKV().get(kvKey, \"text\");\n    return value !== null;\n  }\n\n  public async keys(name: string, filter?: string): Promise<string[]> {\n    const prefix = filter\n      ? `${this.prefix(name)}:${filter}`\n      : `${this.prefix(name)}:`;\n\n    return this.listAllKeys(prefix);\n  }\n\n  public async clear(): Promise<void> {\n    this.log.debug(\"Clearing all cache\");\n    const kv = this.getKV();\n    const allKeys = await this.listAllKeys(\"cache:\");\n    for (const key of allKeys) {\n      await kv.delete(key);\n    }\n  }\n\n  public async incr(\n    name: string,\n    key: string,\n    amount: number,\n  ): Promise<number> {\n    const kvKey = this.prefix(name, key);\n    const kv = this.getKV();\n\n    const existing = await kv.get(kvKey, \"text\");\n    let current = 0;\n\n    if (existing !== null) {\n      current = Number.parseInt(existing, 10) || 0;\n    }\n\n    const newValue = current + amount;\n    await kv.put(kvKey, String(newValue));\n    return newValue;\n  }\n\n  /**\n   * Build the full KV key: `cache:{name}:{key}`\n   */\n  protected prefix(...path: string[]): string {\n    return [\"cache\", ...path].join(\":\");\n  }\n\n  protected getKV(): KVNamespace {\n    if (!this.kv) {\n      throw new AlephaError(\n        \"KV namespace not initialized. Call start() first.\",\n      );\n    }\n    return this.kv;\n  }\n\n  /**\n   * List all keys matching a prefix, handling pagination.\n   */\n  protected async listAllKeys(prefix: string): Promise<string[]> {\n    const kv = this.getKV();\n    const allKeys: string[] = [];\n    let cursor: string | undefined;\n\n    do {\n      const result = await kv.list({\n        prefix,\n        cursor,\n      });\n\n      for (const key of result.keys) {\n        allKeys.push(key.name);\n      }\n\n      cursor = result.list_complete ? undefined : result.cursor;\n    } while (cursor);\n\n    return allKeys;\n  }\n}\n","import { $module } from \"alepha\";\nimport { $cache } from \"./primitives/$cache.ts\";\nimport { CacheProvider } from \"./providers/CacheProvider.ts\";\nimport { MemoryCacheProvider } from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$cache.ts\";\nexport * from \"./providers/CacheProvider.ts\";\nexport * from \"./providers/CloudflareKVProvider.ts\";\nexport * from \"./providers/MemoryCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    /**\n     * Fires when a cache lookup finds a value.\n     */\n    \"cache:hit\": {\n      container: string;\n      key: string;\n    };\n    /**\n     * Fires when a cache lookup does not find a value.\n     */\n    \"cache:miss\": {\n      container: string;\n      key: string;\n    };\n    /**\n     * Fires when a value is written to the cache.\n     */\n    \"cache:set\": {\n      container: string;\n      key: string;\n      ttlMs?: number;\n    };\n    /**\n     * Fires when a stale value (SWR grace window) is served and a\n     * background refresh is scheduled.\n     */\n    \"cache:stale\": {\n      container: string;\n      key: string;\n    };\n    /**\n     * Fires when a background SWR refresh completes successfully and\n     * the value has been written back to the cache.\n     */\n    \"cache:revalidate\": {\n      container: string;\n      key: string;\n    };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Type-safe caching with TTL support.\n *\n * **Features:**\n * - Cached computations with type-safe keys and values\n * - Configurable TTL\n * - Cache invalidation\n * - Automatic cache population\n * - Providers: Memory (default), Redis\n *\n * @module alepha.cache\n */\nexport const AlephaCache = $module({\n  name: \"alepha.cache\",\n  primitives: [$cache],\n  services: [CacheProvider],\n  variants: [MemoryCacheProvider],\n  register: (alepha) =>\n    alepha.with({\n      optional: true,\n      provide: CacheProvider,\n      use: MemoryCacheProvider,\n    }),\n});\n"],"mappings":"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"}

package/dist/cache/core/index.workerd.js

@@ -1,4 +1,4 @@
-import { $atom, $hook, $inject, $module, $state, Alepha, AlephaError, KIND, OPTIONS, Primitive, createPrimitive, t } from "alepha";
+import { $atom, $hook, $inject, $module, $state, Alepha, AlephaError, KIND, OPTIONS, Primitive, createPrimitive, z } from "alepha";
 import { DateTimeProvider } from "alepha/datetime";
 import { $logger } from "alepha/logger";
 //#region ../../src/cache/core/errors/CacheError.ts
@@ -403,15 +403,9 @@ function $cache(options = {}) {
 */
 const cacheOptions = $atom({
 	name: "alepha.cache.options",
-	schema: t.object({
-		enabled: t.boolean({
-			default: true,
-			description: "Whether caching is enabled."
-		}),
-		defaultTtl: t.number({
-			default: 300,
-			description: "Default time to live for cache entries in seconds."
-		})
+	schema: z.object({
+		enabled: z.boolean().describe("Whether caching is enabled.").default(true),
+		defaultTtl: z.number().describe("Default time to live for cache entries in seconds.").default(300)
 	}),
 	default: {
 		enabled: true,