alepha 0.20.5 → 0.20.7

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

@@ -382,9 +382,12 @@ function $cache(options = {}) {
 	const mw = (handler) => {
 		return (async (...args) => {
 			const key = instance.key(...args);
-			const cached = await instance.get(key);
-			if (cached !== void 0) return cached;
-			const result = await handler(...args);
+			const read = await instance.read(key);
+			if (read.value !== void 0) {
+				if (read.stale) instance.scheduleRefresh(key, () => handler(...args));
+				return read.value;
+			}
+			const result = await instance.runSingleFlight(key, () => handler(...args));
 			instance.set(key, result).catch(() => {});
 			return result;
 		});
@@ -415,10 +418,33 @@ const cacheOptions = $atom({
 		defaultTtl: 300
 	}
 });
+const DEFAULT_MEMORY_MAX = 500;
+const DEFAULT_MEMORY_TTL_MS = 3e4;
+const SWR_MARKER = "__swr";
 var CachePrimitive = class extends Primitive {
 	settings = $state(cacheOptions);
 	dateTimeProvider = $inject(DateTimeProvider);
 	provider = this.$provider();
+	memoryStore;
+	memoryMax = DEFAULT_MEMORY_MAX;
+	memoryTtlMs = 0;
+	negativeTtlMs = 0;
+	inflightRefreshes = /* @__PURE__ */ new Map();
+	constructor(args) {
+		super(args);
+		const mem = this.options.memory;
+		if (mem) {
+			this.memoryStore = /* @__PURE__ */ new Map();
+			const memOpts = mem === true ? {} : mem;
+			this.memoryMax = memOpts.max ?? DEFAULT_MEMORY_MAX;
+			if (memOpts.ttl !== void 0) this.memoryTtlMs = this.dateTimeProvider.duration(memOpts.ttl).as("milliseconds");
+			else {
+				const remoteTtlMs = this.options.ttl ? this.dateTimeProvider.duration(this.options.ttl).as("milliseconds") : 0;
+				this.memoryTtlMs = remoteTtlMs > 0 ? Math.min(remoteTtlMs, DEFAULT_MEMORY_TTL_MS) : DEFAULT_MEMORY_TTL_MS;
+			}
+			if (memOpts.negative !== void 0) this.negativeTtlMs = this.dateTimeProvider.duration(memOpts.negative).as("milliseconds");
+		}
+	}
 	get container() {
 		return this.options.name ?? `${this.config.service.name}:${this.config.propertyKey}`;
 	}
@@ -426,9 +452,12 @@ var CachePrimitive = class extends Primitive {
 		const handler = this.options.handler;
 		if (!handler) throw new AlephaError("Cache handler is not defined.");
 		const key = this.key(...args);
-		const cached = await this.get(key);
-		if (cached !== void 0) return cached;
-		const result = await handler(...args);
+		const read = await this.read(key);
+		if (read.value !== void 0) {
+			if (read.stale) this.scheduleRefresh(key, () => handler(...args));
+			return read.value;
+		}
+		const result = await this.runSingleFlight(key, () => handler(...args));
 		await this.set(key, result);
 		return result;
 	}
@@ -436,38 +465,175 @@ var CachePrimitive = class extends Primitive {
 		return this.options.key ? this.options.key(...args) : JSON.stringify(args);
 	}
 	async incr(key, amount = 1) {
-		return this.provider.incr(this.container, key, amount);
+		const result = await this.provider.incr(this.container, key, amount);
+		this.delL1(key);
+		return result;
 	}
 	async invalidate(...keys) {
+		if (this.memoryStore) if (keys.length === 0) this.memoryStore.clear();
+		else for (const key of keys) if (key.endsWith("*")) {
+			const prefix = key.slice(0, -1);
+			for (const k of this.memoryStore.keys()) if (k.startsWith(prefix)) this.memoryStore.delete(k);
+		} else this.memoryStore.delete(key);
 		await this.provider.invalidateKeys(this.container, keys);
 	}
 	async set(key, value, ttl) {
 		if (!this.alepha.isStarted() || this.options.disabled || !this.settings.enabled) return;
-		const px = this.dateTimeProvider.duration(ttl ?? this.options.ttl ?? [this.settings.defaultTtl, "seconds"]).as("milliseconds");
-		await this.provider.setTyped(this.container, key, value, {
-			ttl: px > 0 ? px : void 0,
+		const freshTtlMs = this.dateTimeProvider.duration(ttl ?? this.options.ttl ?? [this.settings.defaultTtl, "seconds"]).as("milliseconds");
+		const staleMs = this.options.stale ? this.dateTimeProvider.duration(this.options.stale).as("milliseconds") : 0;
+		const providerTtlMs = freshTtlMs > 0 ? freshTtlMs + staleMs : 0;
+		const now = this.dateTimeProvider.nowMillis();
+		const freshUntil = freshTtlMs > 0 ? now + freshTtlMs : 0;
+		const payload = this.options.stale && freshTtlMs > 0 ? {
+			[SWR_MARKER]: 1,
+			v: value,
+			f: freshUntil
+		} : value;
+		await this.provider.setTyped(this.container, key, payload, {
+			ttl: providerTtlMs > 0 ? providerTtlMs : void 0,
 			compress: this.options.compress
 		});
+		this.setL1(key, {
+			value,
+			expiresAt: this.memoryTtlMs > 0 ? now + this.memoryTtlMs : Number.POSITIVE_INFINITY,
+			negative: false
+		});
+		this.inflightRefreshes.delete(key);
 		await this.alepha.events.emit("cache:set", {
 			container: this.container,
 			key,
-			ttlMs: px > 0 ? px : void 0
+			ttlMs: providerTtlMs > 0 ? providerTtlMs : void 0
 		});
 	}
 	async get(key) {
-		if (!this.alepha.isStarted() || this.options.disabled || !this.settings.enabled) return;
-		const value = await this.provider.getTyped(this.container, key);
-		await this.alepha.events.emit(value === void 0 ? "cache:miss" : "cache:hit", {
+		return (await this.read(key)).value;
+	}
+	/**
+	* Internal read that also reports whether the value is stale (SWR
+	* grace window). Middleware and `run()` use this to decide whether to
+	* schedule a background refresh.
+	*/
+	async read(key) {
+		if (!this.alepha.isStarted() || this.options.disabled || !this.settings.enabled) return {
+			value: void 0,
+			stale: false
+		};
+		const now = this.dateTimeProvider.nowMillis();
+		if (this.memoryStore) {
+			const entry = this.memoryStore.get(key);
+			if (entry !== void 0) {
+				if (entry.expiresAt > now) {
+					this.memoryStore.delete(key);
+					this.memoryStore.set(key, entry);
+					await this.alepha.events.emit("cache:hit", {
+						container: this.container,
+						key
+					});
+					return {
+						value: entry.negative ? void 0 : entry.value,
+						stale: false
+					};
+				}
+				this.memoryStore.delete(key);
+			}
+		}
+		const raw = await this.provider.getTyped(this.container, key);
+		if (raw === void 0) {
+			if (this.memoryStore && this.negativeTtlMs > 0) this.setL1(key, {
+				value: void 0,
+				expiresAt: now + this.negativeTtlMs,
+				negative: true
+			});
+			await this.alepha.events.emit("cache:miss", {
+				container: this.container,
+				key
+			});
+			return {
+				value: void 0,
+				stale: false
+			};
+		}
+		let value;
+		let stale = false;
+		if (this.isSwrEnvelope(raw)) {
+			value = raw.v;
+			stale = raw.f > 0 && raw.f <= now;
+		} else value = raw;
+		if (this.memoryStore && this.memoryTtlMs > 0) this.setL1(key, {
+			value,
+			expiresAt: now + this.memoryTtlMs,
+			negative: false
+		});
+		await this.alepha.events.emit(stale ? "cache:stale" : "cache:hit", {
 			container: this.container,
 			key
 		});
-		return value;
+		return {
+			value,
+			stale
+		};
+	}
+	/**
+	* Run a handler under single-flight: concurrent callers for the same
+	* key share one in-flight promise.
+	*/
+	async runSingleFlight(key, handler) {
+		const existing = this.inflightRefreshes.get(key);
+		if (existing) return existing;
+		const promise = (async () => {
+			try {
+				return await handler();
+			} finally {
+				this.inflightRefreshes.delete(key);
+			}
+		})();
+		this.inflightRefreshes.set(key, promise);
+		return promise;
+	}
+	/**
+	* Schedule a background refresh for a stale key. At most one refresh
+	* per key is in-flight at any time; failures are swallowed (the stale
+	* value keeps being served until expiry).
+	*/
+	scheduleRefresh(key, handler) {
+		if (this.inflightRefreshes.has(key)) return;
+		const promise = (async () => {
+			try {
+				const result = await handler();
+				await this.set(key, result);
+				await this.alepha.events.emit("cache:revalidate", {
+					container: this.container,
+					key
+				});
+				return result;
+			} finally {
+				this.inflightRefreshes.delete(key);
+			}
+		})();
+		promise.catch(() => {});
+		this.inflightRefreshes.set(key, promise);
 	}
 	$provider() {
 		if (!this.options.provider) return this.alepha.inject(CacheProvider);
 		if (this.options.provider === "memory") return this.alepha.inject(MemoryCacheProvider);
 		return this.alepha.inject(this.options.provider);
 	}
+	isSwrEnvelope(value) {
+		return value !== null && typeof value === "object" && value[SWR_MARKER] === 1 && "f" in value && "v" in value;
+	}
+	setL1(key, entry) {
+		if (!this.memoryStore) return;
+		if (this.memoryStore.has(key)) this.memoryStore.delete(key);
+		this.memoryStore.set(key, entry);
+		while (this.memoryStore.size > this.memoryMax) {
+			const first = this.memoryStore.keys().next().value;
+			if (first === void 0) break;
+			this.memoryStore.delete(first);
+		}
+	}
+	delL1(key) {
+		this.memoryStore?.delete(key);
+	}
 };
 $cache[KIND] = CachePrimitive;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"index.workerd.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.workerd.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  type InstantiableClass,\n  KIND,\n  type MiddlewareMetadata,\n  OPTIONS,\n  Primitive,\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 cached = await instance.get(key);\n      if (cached !== undefined) return cached;\n\n      const result = await handler(...args);\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\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   * If not provided, the default store provider will be used.\n   */\n  provider?: InstantiableClass<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// ---------------------------------------------------------------------------------------------------------------------\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\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  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 cached = await this.get(key);\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    const result = await handler(...args);\n    // note: when exception occurs, don't cache the result\n\n    await this.set(key, result);\n\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    return this.provider.incr(this.container, key, amount);\n  }\n\n  public async invalidate(...keys: string[]): Promise<void> {\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 px = this.dateTimeProvider\n      .duration(\n        ttl ?? this.options.ttl ?? [this.settings.defaultTtl, \"seconds\"],\n      )\n      .as(\"milliseconds\");\n\n    await this.provider.setTyped(this.container, key, value, {\n      ttl: px > 0 ? px : undefined,\n      compress: this.options.compress,\n    });\n\n    await this.alepha.events.emit(\"cache:set\", {\n      container: this.container,\n      key,\n      ttlMs: px > 0 ? px : undefined,\n    });\n  }\n\n  public async get(key: string): Promise<TReturn | undefined> {\n    if (\n      !this.alepha.isStarted() ||\n      this.options.disabled ||\n      !this.settings.enabled\n    ) {\n      return undefined;\n    }\n\n    const value = await this.provider.getTyped<TReturn>(this.container, key);\n\n    await this.alepha.events.emit(\n      value === undefined ? \"cache:miss\" : \"cache:hit\",\n      { container: this.container, key },\n    );\n\n    return value;\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\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 { CloudflareKVProvider } from \"./providers/CloudflareKVProvider.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\nexport const AlephaCache = $module({\n  name: \"alepha.cache\",\n  primitives: [$cache],\n  services: [CacheProvider],\n  variants: [MemoryCacheProvider, CloudflareKVProvider],\n  register: (alepha) => {\n    alepha.with({\n      optional: true,\n      provide: CacheProvider,\n      use: CloudflareKVProvider,\n    });\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.workerd.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.workerd.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 { CloudflareKVProvider } from \"./providers/CloudflareKVProvider.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\nexport const AlephaCache = $module({\n  name: \"alepha.cache\",\n  primitives: [$cache],\n  services: [CacheProvider],\n  variants: [MemoryCacheProvider, CloudflareKVProvider],\n  register: (alepha) => {\n    alepha.with({\n      optional: true,\n      provide: CacheProvider,\n      use: CloudflareKVProvider,\n    });\n  },\n});\n"],"mappings":";;;;AAEA,IAAa,aAAb,cAAgC,YAAY;;;;;;;;;ACM5C,IAAsB,gBAAtB,MAAoC;CAClC,UAAiC,IAAI,aAAa;CAClD,UAAiC,IAAI,aAAa;CAClD,QAAkB;EAChB,QAAQ;EACR,MAAM;EACN,QAAQ;EACR,YAAY;EACb;;;;CAyED,MAAa,SACX,MACA,KACA,OACA,SACe;EACf,IAAI,OAAO,KAAK,UAAU,MAAM;EAChC,IAAI,SAAS,UACX,OAAO,MAAM,KAAK,SAAS,KAAK;EAElC,MAAM,KAAK,IAAI,MAAM,KAAK,MAAM,SAAS,IAAI;;;;;CAM/C,MAAa,SAAY,MAAc,KAAqC;EAC1E,MAAM,OAAO,MAAM,KAAK,IAAI,MAAM,IAAI;EACtC,IAAI,MAAM;GACR,IAAI,KAAK,OAAO,KAAK,MAAM,YAAY;IACrC,MAAM,eAAe,MAAM,KAAK,WAAW,KAAK,SAAS,EAAE,CAAC;IAC5D,OAAO,KAAK,YAAe,aAAa;;GAE1C,OAAO,KAAK,YAAe,KAAK;;;;;;;;;CAWpC,MAAa,eAAe,MAAc,MAA+B;EACvE,MAAM,eAAyB,EAAE;EAEjC,KAAK,MAAM,OAAO,MAChB,IAAI,IAAI,SAAS,IAAI,EAAE;GACrB,MAAM,SAAS,MAAM,KAAK,KAAK,MAAM,IAAI,MAAM,GAAG,GAAG,CAAC;GACtD,aAAa,KAAK,GAAG,OAAO;SAE5B,aAAa,KAAK,IAAI;EAI1B,MAAM,KAAK,IAAI,MAAM,GAAG,aAAa;;;;;CAMvC,UAAoB,OAA4B;EAC9C,IAAI,iBAAiB,YAAY;GAC/B,MAAM,SAAS,IAAI,WAAW,IAAI,MAAM,OAAO;GAC/C,OAAO,KAAK,KAAK,MAAM;GACvB,OAAO,IAAI,OAAO,EAAE;GACpB,OAAO;;EAGT,MAAM,UAAU,KAAK,QAAQ,OAC3B,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,MAAM,CAC1D;EACD,MAAM,OACJ,OAAO,UAAU,WAAW,KAAK,MAAM,SAAS,KAAK,MAAM;EAC7D,MAAM,SAAS,IAAI,WAAW,IAAI,QAAQ,OAAO;EACjD,OAAO,KAAK;EACZ,OAAO,IAAI,SAAS,EAAE;EACtB,OAAO;;;;;CAMT,YAAyB,YAA2B;EAClD,MAAM,OAAO,WAAW;EACxB,MAAM,UAAU,WAAW,MAAM,EAAE;EAEnC,IAAI,SAAS,KAAK,MAAM,QACtB,OAAO;EAET,IAAI,SAAS,KAAK,MAAM,MACtB,OAAO,KAAK,MAAM,KAAK,QAAQ,OAAO,QAAQ,CAAC;EAEjD,IAAI,SAAS,KAAK,MAAM,QACtB,OAAO,KAAK,QAAQ,OAAO,QAAQ;EAGrC,MAAM,IAAI,WAAW,+BAA+B,OAAO;;;;;CAM7D,MAAgB,SAAS,MAAuC;EAC9D,MAAM,MAAO,KAAK,OAAuB,MACvC,KAAK,YACL,KAAK,aAAa,KAAK,WACxB;EACD,MAAM,aAAa,IAAI,WACrB,MAAM,IAAI,SACR,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,IAAI,kBAAkB,OAAO,CAAC,CACpE,CAAC,aAAa,CAChB;EACD,MAAM,SAAS,IAAI,WAAW,IAAI,WAAW,OAAO;EACpD,OAAO,KAAK,KAAK,MAAM;EACvB,OAAO,IAAI,YAAY,EAAE;EACzB,OAAO;;;;;CAMT,MAAgB,WAAW,MAAuC;EAChE,MAAM,MAAO,KAAK,OAAuB,MACvC,KAAK,YACL,KAAK,aAAa,KAAK,WACxB;EACD,OAAO,IAAI,WACT,MAAM,IAAI,SACR,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,IAAI,oBAAoB,OAAO,CAAC,CACtE,CAAC,aAAa,CAChB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACnIL,IAAa,sBAAb,cAAyC,cAAc;CACrD,mBAAsC,QAAQ,iBAAiB;CAC/D,MAAyB,SAAS;CAElC,QAAmE,EAAE;;;;CASrE,WAAqC,EAAE;;;;CAKvC,WAAwC,EAAE;;;;CAK1C,WAAwC,EAAE;;;;CAK1C,SAAqC;EACnC,MAAM;EACN,QAAQ;EACR,MAAM;EACN,SAAS;EACV;;;;CAKD,WAAgC;;;;CAKhC,WAAgC;;;;CAKhC,WAAgC;CAEhC,YAAY,UAAsC,EAAE,EAAE;EACpD,OAAO;EACP,KAAK,WAAW,QAAQ,YAAY;EACpC,KAAK,WAAW,QAAQ,YAAY;EACpC,KAAK,WAAW,QAAQ,YAAY;;CAOtC,MAAa,IAAI,MAAc,KAA8C;EAC3E,KAAK,SAAS,KAAK;GACjB;GACA;GACA,WAAW,KAAK,iBAAiB,WAAW;GAC7C,CAAC;EAEF,IAAI,KAAK,UACP,MAAM,KAAK;EAGb,MAAM,OAAO,KAAK,MAAM,QAAQ,MAAM;EAEtC,IAAI,SAAS,KAAA,GACX,KAAK,OAAO;OAEZ,KAAK,OAAO;EAGd,OAAO;;CAGT,MAAa,IACX,MACA,KACA,OACA,KACqB;EACrB,KAAK,SAAS,KAAK;GACjB;GACA;GACA;GACA;GACA,WAAW,KAAK,iBAAiB,WAAW;GAC7C,CAAC;EACF,KAAK,OAAO;EAEZ,IAAI,KAAK,UACP,MAAM,KAAK;EAGb,IAAI,KAAK,MAAM,SAAS,MACtB,KAAK,MAAM,QAAQ,EAAE;EAGvB,KAAK,MAAM,MAAM,SAAS,EAAE;EAC5B,KAAK,MAAM,MAAM,KAAK,OAAO;EAE7B,KAAK,IAAI,MAAM,0BAA0B;GAAE;GAAM;GAAK;GAAK,CAAC;EAG5D,IAAI,KAAK,MAAM,MAAM,KAAK,SAAS;GACjC,KAAK,iBAAiB,aAAa,KAAK,MAAM,MAAM,KAAK,QAAQ;GACjE,KAAK,MAAM,MAAM,KAAK,UAAU,KAAA;;EAGlC,IAAI,KACF,KAAK,MAAM,MAAM,KAAK,UAAU,KAAK,iBAAiB,oBAC9C,KAAK,IAAI,MAAM,IAAI,EACzB,IACD;EAGH,OAAO,KAAK,MAAM,MAAM,KAAK;;CAG/B,MAAa,IAAI,MAAc,GAAG,MAA+B;EAC/D,KAAK,SAAS,KAAK;GACjB;GACA;GACA,WAAW,KAAK,iBAAiB,WAAW;GAC7C,CAAC;EACF,KAAK,OAAO;EAEZ,IAAI,KAAK,UACP,MAAM,KAAK;EAIb,IAAI,KAAK,WAAW,GAAG;GACrB,KAAK,IAAI,MAAM,+BAA+B,EAAE,MAAM,CAAC;GAEvD,IAAI,KAAK,MAAM,OACb,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,MAAM,MAAM,EAAE;IAC/C,MAAM,UAAU,KAAK,MAAM,MAAM,MAAM;IACvC,IAAI,SACF,KAAK,iBAAiB,aAAa,QAAQ;;GAIjD,OAAO,KAAK,MAAM;GAClB;;EAGF,KAAK,IAAI,MAAM,2BAA2B;GAAE;GAAM;GAAM,CAAC;EAGzD,KAAK,MAAM,OAAO,MAAM;GACtB,IAAI,KAAK,MAAM,SAAS,MAAM;GAE9B,MAAM,UAAU,KAAK,MAAM,MAAM,MAAM;GACvC,IAAI,SACF,KAAK,iBAAiB,aAAa,QAAQ;GAG7C,OAAO,KAAK,MAAM,MAAM;;EAG1B,IAAI,OAAO,KAAK,KAAK,MAAM,SAAS,EAAE,CAAC,CAAC,WAAW,GAEjD,OAAO,KAAK,MAAM;;CAItB,MAAa,IAAI,MAAc,KAA+B;EAC5D,OAAO,KAAK,MAAM,QAAQ,MAAM,QAAQ;;CAG1C,MAAa,KAAK,MAAc,QAAoC;EAClE,MAAM,QAAQ,KAAK,MAAM,SAAS,EAAE;EACpC,MAAM,OAAO,OAAO,KAAK,MAAM;EAC/B,IAAI,QACF,OAAO,KAAK,QAAQ,QAAQ,IAAI,WAAW,OAAO,CAAC;EAErD,OAAO;;CAGT,MAAa,QAAuB;EAClC,KAAK,IAAI,MAAM,qBAAqB;EAGpC,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,MAAM,EACxC,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,MAAM,MAAM,EAAE;GAC/C,MAAM,UAAU,KAAK,MAAM,MAAM,MAAM;GACvC,IAAI,SACF,KAAK,iBAAiB,aAAa,QAAQ;;EAKjD,KAAK,QAAQ,EAAE;;CAGjB,MAAa,KACX,MACA,KACA,QACiB;EACjB,IAAI,KAAK,MAAM,SAAS,MACtB,KAAK,MAAM,QAAQ,EAAE;EAGvB,MAAM,WAAW,KAAK,MAAM,MAAM,MAAM;EACxC,IAAI,UAAU;EAEd,IAAI,UACF,IAAI;GACF,UAAU,KAAK,YAAoB,SAAS;UACtC;GAEN,MAAM,MAAM,IAAI,aAAa,CAAC,OAAO,SAAS;GAC9C,UAAU,OAAO,SAAS,KAAK,GAAG,IAAI;;EAI1C,MAAM,WAAW,UAAU;EAC3B,KAAK,MAAM,MAAM,SAAS,EAAE;EAC5B,KAAK,MAAM,MAAM,KAAK,OAAO,KAAK,UAAU,SAAS;EAErD,OAAO;;;;;;;;;;;CAgBT,QAAiC;EAC/B,OAAO,EAAE,GAAG,KAAK,QAAQ;;;;;;;;;;CAW3B,OAAc,MAAc,KAAuB;EACjD,IAAI,QAAQ,KAAA,GACV,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,KAAK;EAEzD,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,QAAQ,KAAK,QAAQ,IAAI;;;;;;;;;;CAW7E,OAAc,MAAc,KAAuB;EACjD,IAAI,QAAQ,KAAA,GACV,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,KAAK;EAEzD,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,QAAQ,KAAK,QAAQ,IAAI;;;;;;;;;;CAW7E,WAAkB,MAAc,KAAuB;EACrD,IAAI,QAAQ,KAAA,GACV,OAAO,KAAK,SAAS,MAAM,SAAS,KAAK,SAAS,KAAK;EAEzD,OAAO,KAAK,SAAS,MAClB,SAAS,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,IAAI,CACxD;;;;;;;;;;CAWH,KAAY,MAAuB;EACjC,IAAI,SAAS,KAAA,GACX,OAAO,OAAO,OAAO,KAAK,MAAM,CAAC,QAC9B,OAAO,YAAY,QAAQ,OAAO,KAAK,QAAQ,CAAC,QACjD,EACD;EAEH,OAAO,OAAO,KAAK,KAAK,MAAM,SAAS,EAAE,CAAC,CAAC;;;;;;;;;;CAW7C,QAAyB;EACvB,OAAO,OAAO,KAAK,KAAK,MAAM;;;;;;;;;;;;CAahC,QAAqB;EAEnB,KAAK,MAAM,QAAQ,OAAO,KAAK,KAAK,MAAM,EACxC,KAAK,MAAM,OAAO,OAAO,KAAK,KAAK,MAAM,MAAM,EAAE;GAC/C,MAAM,UAAU,KAAK,MAAM,MAAM,MAAM;GACvC,IAAI,SACF,KAAK,iBAAiB,aAAa,QAAQ;;EAKjD,KAAK,QAAQ,EAAE;EACf,KAAK,WAAW,EAAE;EAClB,KAAK,WAAW,EAAE;EAClB,KAAK,WAAW,EAAE;EAClB,KAAK,SAAS;GAAE,MAAM;GAAG,QAAQ;GAAG,MAAM;GAAG,SAAS;GAAG;EACzD,KAAK,WAAW;EAChB,KAAK,WAAW;EAChB,KAAK,WAAW;;;;;AC3XpB,SAAgB,OAAO,UAAe,EAAE,EAAO;CAC7C,MAAM,WAAW,gBAAgB,gBAAgB,QAAQ;CAEzD,IAAI,QAAQ,SAAS;EACnB,MAAM,MAAM,GAAG,SAA8B,SAAS,IAAI,GAAG,KAAK;EAClE,OAAO,OAAO,eAAe,IAAI,SAAS;;CAI5C,MAAM,MAA8C,YAAkB;EACpE,QAAQ,OAAO,GAAG,SAAgB;GAChC,MAAM,MAAM,SAAS,IAAI,GAAG,KAAK;GACjC,MAAM,OAAO,MAAM,SAAS,KAAK,IAAI;GAErC,IAAI,KAAK,UAAU,KAAA,GAAW;IAC5B,IAAI,KAAK,OACP,SAAS,gBAAgB,WAAW,QAAQ,GAAG,KAAK,CAAC;IAEvD,OAAO,KAAK;;GAGd,MAAM,SAAS,MAAM,SAAS,gBAAgB,WAC5C,QAAQ,GAAG,KAAK,CACjB;GAED,SAAS,IAAI,KAAK,OAAO,CAAC,YAAY,GAAG;GACzC,OAAO;;;CAIX,GAAG,WAAW;EACZ,MAAM;EACG;EACV;CAED,OAAO,OAAO,eAAe,IAAI,SAAS;;;;;AAsI5C,MAAa,eAAe,MAAM;CAChC,MAAM;CACN,QAAQ,EAAE,OAAO;EACf,SAAS,EAAE,QAAQ;GACjB,SAAS;GACT,aAAa;GACd,CAAC;EACF,YAAY,EAAE,OAAO;GACnB,SAAS;GACT,aAAa;GACd,CAAC;EACH,CAAC;CACF,SAAS;EACP,SAAS;EACT,YAAY;EACb;CACF,CAAC;AAYF,MAAM,qBAAqB;AAC3B,MAAM,wBAAwB;AAC9B,MAAM,aAAa;AAmBnB,IAAa,iBAAb,cAGU,UAAsD;CAC9D,WAA8B,OAAO,aAAa;CAClD,mBAAsC,QAAQ,iBAAiB;CAC/D,WAA2B,KAAK,WAAW;CAE3C;CACA,YAAuC;CACvC,cAAyC;CACzC,gBAA2C;CAE3C,oCAAuC,IAAI,KAA+B;CAE1E,YACE,MAGA;EACA,MAAM,KAAK;EACX,MAAM,MAAM,KAAK,QAAQ;EACzB,IAAI,KAAK;GACP,KAAK,8BAAc,IAAI,KAAK;GAC5B,MAAM,UAAkC,QAAQ,OAAO,EAAE,GAAG;GAC5D,KAAK,YAAY,QAAQ,OAAO;GAEhC,IAAI,QAAQ,QAAQ,KAAA,GAClB,KAAK,cAAc,KAAK,iBACrB,SAAS,QAAQ,IAAI,CACrB,GAAG,eAAe;QAChB;IACL,MAAM,cAAc,KAAK,QAAQ,MAC7B,KAAK,iBAAiB,SAAS,KAAK,QAAQ,IAAI,CAAC,GAAG,eAAe,GACnE;IACJ,KAAK,cACH,cAAc,IACV,KAAK,IAAI,aAAa,sBAAsB,GAC5C;;GAER,IAAI,QAAQ,aAAa,KAAA,GACvB,KAAK,gBAAgB,KAAK,iBACvB,SAAS,QAAQ,SAAS,CAC1B,GAAG,eAAe;;;CAK3B,IAAW,YAAoB;EAC7B,OACE,KAAK,QAAQ,QACb,GAAG,KAAK,OAAO,QAAQ,KAAK,GAAG,KAAK,OAAO;;CAI/C,MAAa,IAAI,GAAG,MAAoC;EACtD,MAAM,UAAU,KAAK,QAAQ;EAC7B,IAAI,CAAC,SACH,MAAM,IAAI,YAAY,gCAAgC;EAGxD,MAAM,MAAM,KAAK,IAAI,GAAG,KAAK;EAC7B,MAAM,OAAO,MAAM,KAAK,KAAK,IAAI;EAEjC,IAAI,KAAK,UAAU,KAAA,GAAW;GAC5B,IAAI,KAAK,OACP,KAAK,gBAAgB,WAAW,QAAQ,GAAG,KAAK,CAAC;GAEnD,OAAO,KAAK;;EAGd,MAAM,SAAS,MAAM,KAAK,gBAAgB,WAAW,QAAQ,GAAG,KAAK,CAAC;EAEtE,MAAM,KAAK,IAAI,KAAK,OAAO;EAC3B,OAAO;;CAGT,IAAW,GAAG,MAA0B;EACtC,OAAO,KAAK,QAAQ,MAAM,KAAK,QAAQ,IAAI,GAAG,KAAK,GAAG,KAAK,UAAU,KAAK;;CAG5E,MAAa,KAAK,KAAa,SAAS,GAAoB;EAC1D,MAAM,SAAS,MAAM,KAAK,SAAS,KAAK,KAAK,WAAW,KAAK,OAAO;EAEpE,KAAK,MAAM,IAAI;EACf,OAAO;;CAGT,MAAa,WAAW,GAAG,MAA+B;EACxD,IAAI,KAAK,aACP,IAAI,KAAK,WAAW,GAClB,KAAK,YAAY,OAAO;OAExB,KAAK,MAAM,OAAO,MAChB,IAAI,IAAI,SAAS,IAAI,EAAE;GACrB,MAAM,SAAS,IAAI,MAAM,GAAG,GAAG;GAC/B,KAAK,MAAM,KAAK,KAAK,YAAY,MAAM,EACrC,IAAI,EAAE,WAAW,OAAO,EAAE,KAAK,YAAY,OAAO,EAAE;SAGtD,KAAK,YAAY,OAAO,IAAI;EAKpC,MAAM,KAAK,SAAS,eAAe,KAAK,WAAW,KAAK;;CAG1D,MAAa,IACX,KACA,OACA,KACe;EACf,IACE,CAAC,KAAK,OAAO,WAAW,IACxB,KAAK,QAAQ,YACb,CAAC,KAAK,SAAS,SAEf;EAGF,MAAM,aAAa,KAAK,iBACrB,SACC,OAAO,KAAK,QAAQ,OAAO,CAAC,KAAK,SAAS,YAAY,UAAU,CACjE,CACA,GAAG,eAAe;EAErB,MAAM,UAAU,KAAK,QAAQ,QACzB,KAAK,iBAAiB,SAAS,KAAK,QAAQ,MAAM,CAAC,GAAG,eAAe,GACrE;EAEJ,MAAM,gBAAgB,aAAa,IAAI,aAAa,UAAU;EAC9D,MAAM,MAAM,KAAK,iBAAiB,WAAW;EAC7C,MAAM,aAAa,aAAa,IAAI,MAAM,aAAa;EAEvD,MAAM,UACJ,KAAK,QAAQ,SAAS,aAAa,IAC9B;IAAG,aAAa;GAAG,GAAG;GAAO,GAAG;GAAY,GAC7C;EAEN,MAAM,KAAK,SAAS,SAAS,KAAK,WAAW,KAAK,SAAS;GACzD,KAAK,gBAAgB,IAAI,gBAAgB,KAAA;GACzC,UAAU,KAAK,QAAQ;GACxB,CAAC;EAGF,KAAK,MAAM,KAAK;GACd;GACA,WACE,KAAK,cAAc,IACf,MAAM,KAAK,cACX,OAAO;GACb,UAAU;GACX,CAAC;EAGF,KAAK,kBAAkB,OAAO,IAAI;EAElC,MAAM,KAAK,OAAO,OAAO,KAAK,aAAa;GACzC,WAAW,KAAK;GAChB;GACA,OAAO,gBAAgB,IAAI,gBAAgB,KAAA;GAC5C,CAAC;;CAGJ,MAAa,IAAI,KAA2C;EAE1D,QAAO,MADY,KAAK,KAAK,IAAI,EACrB;;;;;;;CAQd,MAAa,KAAK,KAA2C;EAC3D,IACE,CAAC,KAAK,OAAO,WAAW,IACxB,KAAK,QAAQ,YACb,CAAC,KAAK,SAAS,SAEf,OAAO;GAAE,OAAO,KAAA;GAAW,OAAO;GAAO;EAG3C,MAAM,MAAM,KAAK,iBAAiB,WAAW;EAG7C,IAAI,KAAK,aAAa;GACpB,MAAM,QAAQ,KAAK,YAAY,IAAI,IAAI;GACvC,IAAI,UAAU,KAAA,GAAW;IACvB,IAAI,MAAM,YAAY,KAAK;KAEzB,KAAK,YAAY,OAAO,IAAI;KAC5B,KAAK,YAAY,IAAI,KAAK,MAAM;KAChC,MAAM,KAAK,OAAO,OAAO,KAAK,aAAa;MACzC,WAAW,KAAK;MAChB;MACD,CAAC;KACF,OAAO;MACL,OAAO,MAAM,WAAW,KAAA,IAAY,MAAM;MAC1C,OAAO;MACR;;IAEH,KAAK,YAAY,OAAO,IAAI;;;EAKhC,MAAM,MAAM,MAAM,KAAK,SAAS,SAC9B,KAAK,WACL,IACD;EAED,IAAI,QAAQ,KAAA,GAAW;GAErB,IAAI,KAAK,eAAe,KAAK,gBAAgB,GAC3C,KAAK,MAAM,KAAK;IACd,OAAO,KAAA;IACP,WAAW,MAAM,KAAK;IACtB,UAAU;IACX,CAAC;GAEJ,MAAM,KAAK,OAAO,OAAO,KAAK,cAAc;IAC1C,WAAW,KAAK;IAChB;IACD,CAAC;GACF,OAAO;IAAE,OAAO,KAAA;IAAW,OAAO;IAAO;;EAG3C,IAAI;EACJ,IAAI,QAAQ;EAEZ,IAAI,KAAK,cAAc,IAAI,EAAE;GAC3B,QAAQ,IAAI;GACZ,QAAQ,IAAI,IAAI,KAAK,IAAI,KAAK;SAE9B,QAAQ;EAIV,IAAI,KAAK,eAAe,KAAK,cAAc,GACzC,KAAK,MAAM,KAAK;GACd;GACA,WAAW,MAAM,KAAK;GACtB,UAAU;GACX,CAAC;EAGJ,MAAM,KAAK,OAAO,OAAO,KAAK,QAAQ,gBAAgB,aAAa;GACjE,WAAW,KAAK;GAChB;GACD,CAAC;EAEF,OAAO;GAAE;GAAO;GAAO;;;;;;CAOzB,MAAa,gBACX,KACA,SACkB;EAClB,MAAM,WAAW,KAAK,kBAAkB,IAAI,IAAI;EAChD,IAAI,UACF,OAAO;EAET,MAAM,WAAW,YAAY;GAC3B,IAAI;IACF,OAAO,MAAM,SAAS;aACd;IACR,KAAK,kBAAkB,OAAO,IAAI;;MAElC;EACJ,KAAK,kBAAkB,IAAI,KAAK,QAAQ;EACxC,OAAO;;;;;;;CAQT,gBACE,KACA,SACM;EACN,IAAI,KAAK,kBAAkB,IAAI,IAAI,EACjC;EAEF,MAAM,WAAW,YAAY;GAC3B,IAAI;IACF,MAAM,SAAS,MAAM,SAAS;IAC9B,MAAM,KAAK,IAAI,KAAK,OAAO;IAC3B,MAAM,KAAK,OAAO,OAAO,KAAK,oBAAoB;KAChD,WAAW,KAAK;KAChB;KACD,CAAC;IACF,OAAO;aACC;IACR,KAAK,kBAAkB,OAAO,IAAI;;MAElC;EACJ,QAAQ,YAAY,GAElB;EACF,KAAK,kBAAkB,IAAI,KAAK,QAAQ;;CAG1C,YAAqC;EACnC,IAAI,CAAC,KAAK,QAAQ,UAChB,OAAO,KAAK,OAAO,OAAO,cAAc;EAG1C,IAAI,KAAK,QAAQ,aAAa,UAC5B,OAAO,KAAK,OAAO,OAAO,oBAAoB;EAGhD,OAAO,KAAK,OAAO,OAAO,KAAK,QAAQ,SAAS;;CAGlD,cAAwB,OAAsC;EAC5D,OACE,UAAU,QACV,OAAO,UAAU,YAChB,MAAkC,gBAAgB,KACnD,OAAQ,SACR,OAAQ;;CAIZ,MAAgB,KAAa,OAA+B;EAC1D,IAAI,CAAC,KAAK,aAAa;EACvB,IAAI,KAAK,YAAY,IAAI,IAAI,EAC3B,KAAK,YAAY,OAAO,IAAI;EAE9B,KAAK,YAAY,IAAI,KAAK,MAAM;EAChC,OAAO,KAAK,YAAY,OAAO,KAAK,WAAW;GAC7C,MAAM,QAAQ,KAAK,YAAY,MAAM,CAAC,MAAM,CAAC;GAC7C,IAAI,UAAU,KAAA,GAAW;GACzB,KAAK,YAAY,OAAO,MAAM;;;CAIlC,MAAgB,KAAmB;EACjC,KAAK,aAAa,OAAO,IAAI;;;AAwBjC,OAAO,QAAQ;;;;;;AChlBf,MAAa,qBAAqB;;;;;;;;;;;;;;;;;;AAqBlC,IAAa,uBAAb,cAA0C,cAAc;CACtD,SAA4B,QAAQ,OAAO;CAC3C,MAAyB,SAAS;CAElC;CAEA,UAA6B,MAAM;EACjC,IAAI;EACJ,SAAS,YAAY;GAKnB,IAJe,KAAK,OACjB,WAA2B,QAAQ,CACnC,QAAQ,OAAO,GAAG,aAAa,KAExB,CAAC,WAAW,GAAG;IACvB,KAAK,IAAI,KACP,uGACD;IACD;;GAGF,MAAM,gBAAgB,KAAK,OAAO,IAAI,iBAAiB;GAGvD,IAAI,CAAC,eACH,MAAM,IAAI,YACR,mFACD;GAGH,MAAM,UAAU,cAAc;GAG9B,IAAI,CAAC,SACH,MAAM,IAAI,YACR,eAAe,mBAAmB,gDACnC;GAGH,KAAK,KAAK;GAEV,KAAK,IAAI,KAAK,yBAAyB;;EAE1C,CAAC;CAEF,MAAa,IAAI,MAAc,KAA8C;EAC3E,IAAI,CAAC,KAAK,OAAO,WAAW,EAC1B;EAGF,MAAM,QAAQ,KAAK,OAAO,MAAM,IAAI;EACpC,MAAM,SAAS,MAAM,KAAK,OAAO,CAAC,IAAI,OAAO,cAAc;EAC3D,IAAI,CAAC,QACH;EAGF,KAAK,IAAI,MAAM,aAAa;GAC1B,MAAM,OAAO;GACb,KAAK;GACN,CAAC;EAEF,OAAO,IAAI,WAAW,OAAO;;CAG/B,MAAa,IACX,MACA,KACA,OACA,KACqB;EACrB,IAAI,CAAC,KAAK,OAAO,SAAS,EACxB,OAAO,IAAI,WAAW,MAAM;EAG9B,MAAM,QAAQ,KAAK,OAAO,MAAM,IAAI;EACpC,MAAM,UAAwB,EAAE;EAEhC,IAAI,KAEF,QAAQ,gBAAgB,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,IAAK,CAAC;EAG7D,MAAM,KAAK,OAAO,CAAC,IACjB,OACA,MAAM,OAAO,MACX,MAAM,YACN,MAAM,aAAa,MAAM,WAC1B,EACD,QACD;EACD,OAAO;;CAGT,MAAa,IAAI,MAAc,GAAG,MAA+B;EAC/D,MAAM,KAAK,KAAK,OAAO;EAEvB,IAAI,KAAK,WAAW,GAAG;GAErB,MAAM,SAAS,KAAK,OAAO,KAAK;GAChC,MAAM,UAAU,MAAM,KAAK,YAAY,GAAG,OAAO,GAAG;GACpD,KAAK,MAAM,KAAK,SACd,MAAM,GAAG,OAAO,EAAE;GAEpB;;EAGF,MAAM,UAAU,KAAK,OAAO,KAAK;EACjC,KAAK,MAAM,OAAO,MAAM;GACtB,MAAM,UAAU,IAAI,WAAW,QAAQ,GAAG,MAAM,KAAK,OAAO,MAAM,IAAI;GACtE,MAAM,GAAG,OAAO,QAAQ;;;CAI5B,MAAa,IAAI,MAAc,KAA+B;EAC5D,MAAM,QAAQ,KAAK,OAAO,MAAM,IAAI;EAEpC,OAAO,MADa,KAAK,OAAO,CAAC,IAAI,OAAO,OAAO,KAClC;;CAGnB,MAAa,KAAK,MAAc,QAAoC;EAClE,MAAM,SAAS,SACX,GAAG,KAAK,OAAO,KAAK,CAAC,GAAG,WACxB,GAAG,KAAK,OAAO,KAAK,CAAC;EAEzB,OAAO,KAAK,YAAY,OAAO;;CAGjC,MAAa,QAAuB;EAClC,KAAK,IAAI,MAAM,qBAAqB;EACpC,MAAM,KAAK,KAAK,OAAO;EACvB,MAAM,UAAU,MAAM,KAAK,YAAY,SAAS;EAChD,KAAK,MAAM,OAAO,SAChB,MAAM,GAAG,OAAO,IAAI;;CAIxB,MAAa,KACX,MACA,KACA,QACiB;EACjB,MAAM,QAAQ,KAAK,OAAO,MAAM,IAAI;EACpC,MAAM,KAAK,KAAK,OAAO;EAEvB,MAAM,WAAW,MAAM,GAAG,IAAI,OAAO,OAAO;EAC5C,IAAI,UAAU;EAEd,IAAI,aAAa,MACf,UAAU,OAAO,SAAS,UAAU,GAAG,IAAI;EAG7C,MAAM,WAAW,UAAU;EAC3B,MAAM,GAAG,IAAI,OAAO,OAAO,SAAS,CAAC;EACrC,OAAO;;;;;CAMT,OAAiB,GAAG,MAAwB;EAC1C,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI;;CAGrC,QAA+B;EAC7B,IAAI,CAAC,KAAK,IACR,MAAM,IAAI,YACR,oDACD;EAEH,OAAO,KAAK;;;;;CAMd,MAAgB,YAAY,QAAmC;EAC7D,MAAM,KAAK,KAAK,OAAO;EACvB,MAAM,UAAoB,EAAE;EAC5B,IAAI;EAEJ,GAAG;GACD,MAAM,SAAS,MAAM,GAAG,KAAK;IAC3B;IACA;IACD,CAAC;GAEF,KAAK,MAAM,OAAO,OAAO,MACvB,QAAQ,KAAK,IAAI,KAAK;GAGxB,SAAS,OAAO,gBAAgB,KAAA,IAAY,OAAO;WAC5C;EAET,OAAO;;;;;AC1PX,MAAa,cAAc,QAAQ;CACjC,MAAM;CACN,YAAY,CAAC,OAAO;CACpB,UAAU,CAAC,cAAc;CACzB,UAAU,CAAC,qBAAqB,qBAAqB;CACrD,WAAW,WAAW;EACpB,OAAO,KAAK;GACV,UAAU;GACV,SAAS;GACT,KAAK;GACN,CAAC;;CAEL,CAAC"}