npm - alepha - Versions diffs - 0.19.1 → 0.19.2 - Mend

alepha 0.19.1 → 0.19.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (530) hide show

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

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","names":[],"sources":["../../../src/cache/core/errors/CacheError.ts","../../../src/cache/core/providers/CacheProvider.ts","../../../src/cache/core/providers/MemoryCacheProvider.ts","../../../src/cache/core/primitives/$cache.ts","../../../src/cache/core/providers/CloudflareKVProvider.ts","../../../src/cache/core/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class CacheError extends AlephaError {}\n","import { CacheError } from \"../errors/CacheError.ts\";\n\n/*\n Cache provider interface.\n \n All methods are asynchronous and return promises.\n * Values are stored as Uint8Array.\n /\nexport abstract class CacheProvider {\n protected encoder: TextEncoder = new TextEncoder();\n protected decoder: TextDecoder = new TextDecoder();\n protected codes = {\n BINARY: 0x01,\n JSON: 0x02,\n STRING: 0x03,\n COMPRESSED: 0x04,\n };\n\n /\n Get the value of a key.\n \n @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n * @param key The key of the value to get.\n \n @return The value of the key, or undefined if the key does not exist.\n /\n public abstract get(\n name: string,\n key: string,\n ): Promise<Uint8Array \| undefined>;\n\n /\n Set the string value of a key.\n \n @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n * @param key The key of the value to set.\n * @param value The value to set.\n * @param ttl The time-to-live of the key, in milliseconds.\n \n @return The value of the key.\n /\n public abstract set(\n name: string,\n key: string,\n value: Uint8Array,\n ttl?: number,\n ): Promise<Uint8Array>;\n\n /\n Remove the specified keys.\n \n @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n * @param keys The keys to delete.\n /\n public abstract del(name: string, ...keys: string[]): Promise<void>;\n\n public abstract has(name: string, key: string): Promise<boolean>;\n\n public abstract keys(name: string, filter?: string): Promise<string[]>;\n\n /\n Remove all keys from all cache names.\n /\n public abstract clear(): Promise<void>;\n\n /\n Increment the integer value of a key by the given amount.\n \n If the key does not exist, it is set to 0 before performing the operation.\n * This operation is atomic when using Redis.\n \n @param name Cache name, used to group keys.\n * @param key The key to increment.\n * @param amount The amount to increment by.\n * @returns The new value after incrementing.\n /\n public abstract incr(\n name: string,\n key: string,\n amount: number,\n ): Promise<number>;\n\n // ---------------------------------------------------------------------------\n // High-level methods — serialize/compress layer used by CachePrimitive\n // ---------------------------------------------------------------------------\n\n /\n Set a typed value with automatic serialization and optional compression.\n /\n public async setTyped(\n name: string,\n key: string,\n value: unknown,\n options?: { ttl?: number; compress?: boolean },\n ): Promise<void> {\n let data = this.serialize(value);\n if (options?.compress) {\n data = await this.compress(data);\n }\n await this.set(name, key, data, options?.ttl);\n }\n\n /\n Get a typed value with automatic deserialization and optional decompression.\n /\n public async getTyped<T>(name: string, key: string): Promise<T \| undefined> {\n const data = await this.get(name, key);\n if (data) {\n if (data[0] === this.codes.COMPRESSED) {\n const decompressed = await this.decompress(data.subarray(1));\n return this.deserialize<T>(decompressed);\n }\n return this.deserialize<T>(data);\n }\n return undefined;\n }\n\n /\n Invalidate cache keys with wildcard support.\n \n Keys ending in `` are expanded via `this.keys()`.\n Called with no keys, delegates to `this.del(name)` which clears the entire container.\n /\n public async invalidateKeys(name: string, keys: string[]): Promise<void> {\n const keysToDelete: string[] = [];\n\n for (const key of keys) {\n if (key.endsWith(\"\")) {\n const result = await this.keys(name, key.slice(0, -1));\n keysToDelete.push(...result);\n } else {\n keysToDelete.push(key);\n }\n }\n\n await this.del(name, ...keysToDelete);\n }\n\n /*\n Serialize a value to a typed Uint8Array with a leading type marker byte.\n /\n protected serialize(value: unknown): Uint8Array {\n if (value instanceof Uint8Array) {\n const result = new Uint8Array(1 + value.length);\n result[0] = this.codes.BINARY;\n result.set(value, 1);\n return result;\n }\n\n const encoded = this.encoder.encode(\n typeof value === \"string\" ? value : JSON.stringify(value),\n );\n const code =\n typeof value === \"string\" ? this.codes.STRING : this.codes.JSON;\n const result = new Uint8Array(1 + encoded.length);\n result[0] = code;\n result.set(encoded, 1);\n return result;\n }\n\n /\n Deserialize a typed Uint8Array back to the original value.\n /\n protected deserialize<T>(uint8Array: Uint8Array): T {\n const type = uint8Array[0];\n const payload = uint8Array.slice(1);\n\n if (type === this.codes.BINARY) {\n return payload as T;\n }\n if (type === this.codes.JSON) {\n return JSON.parse(this.decoder.decode(payload)) as T;\n }\n if (type === this.codes.STRING) {\n return this.decoder.decode(payload) as T;\n }\n\n throw new CacheError(`Unknown serialization type: ${type}`);\n }\n\n /\n Compress data with gzip, prepending a COMPRESSED marker byte.\n /\n protected async compress(data: Uint8Array): Promise<Uint8Array> {\n const buf = (data.buffer as ArrayBuffer).slice(\n data.byteOffset,\n data.byteOffset + data.byteLength,\n );\n const compressed = new Uint8Array(\n await new Response(\n new Blob([buf]).stream().pipeThrough(new CompressionStream(\"gzip\")),\n ).arrayBuffer(),\n );\n const result = new Uint8Array(1 + compressed.length);\n result[0] = this.codes.COMPRESSED;\n result.set(compressed, 1);\n return result;\n }\n\n /\n Decompress gzipped data.\n /\n protected async decompress(data: Uint8Array): Promise<Uint8Array> {\n const buf = (data.buffer as ArrayBuffer).slice(\n data.byteOffset,\n data.byteOffset + data.byteLength,\n );\n return new Uint8Array(\n await new Response(\n new Blob([buf]).stream().pipeThrough(new DecompressionStream(\"gzip\")),\n ).arrayBuffer(),\n );\n }\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { CacheProvider } from \"./CacheProvider.ts\";\n\ntype CacheName = string;\ntype CacheKey = string;\ntype CacheValue = {\n data?: Uint8Array;\n timeout?: Timeout;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface MemoryCacheCall {\n name: string;\n key: string;\n timestamp: number;\n}\n\nexport interface MemoryCacheSetCall extends MemoryCacheCall {\n value: Uint8Array;\n ttl?: number;\n}\n\nexport interface MemoryCacheDelCall {\n name: string;\n keys: string[];\n timestamp: number;\n}\n\nexport interface MemoryCacheStats {\n hits: number;\n misses: number;\n sets: number;\n deletes: number;\n}\n\nexport interface MemoryCacheProviderOptions {\n /\n Error to throw on get operations (for testing error handling)\n /\n getError?: Error \| null;\n /\n Error to throw on set operations (for testing error handling)\n /\n setError?: Error \| null;\n /\n Error to throw on del operations (for testing error handling)\n /\n delError?: Error \| null;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/\n In-memory implementation of CacheProvider for testing.\n \n This provider stores all cache entries in memory, making it ideal for\n * unit tests that need to verify cache operations without touching Redis or other backends.\n \n @example\n * ```typescript\n * // In tests, substitute the real CacheProvider with MemoryCacheProvider\n * const alepha = Alepha.create().with({\n * provide: CacheProvider,\n * use: MemoryCacheProvider,\n * });\n \n // Run code that uses caching\n * const service = alepha.inject(MyService);\n * await service.fetchWithCache(\"key\");\n \n // Verify cache behavior\n * const cache = alepha.inject(MemoryCacheProvider);\n * expect(cache.stats().misses).toBe(1);\n * await service.fetchWithCache(\"key\");\n * expect(cache.stats().hits).toBe(1);\n * ```\n /\nexport class MemoryCacheProvider extends CacheProvider {\n protected readonly dateTimeProvider = $inject(DateTimeProvider);\n protected readonly log = $logger();\n\n protected store: Record<CacheName, Record<CacheKey, CacheValue>> = {};\n\n // ─────────────────────────────────────────────────────────────────────────────\n // Test tracking\n // ─────────────────────────────────────────────────────────────────────────────\n\n /\n All recorded get calls.\n /\n public getCalls: MemoryCacheCall[] = [];\n\n /\n All recorded set calls.\n /\n public setCalls: MemoryCacheSetCall[] = [];\n\n /\n All recorded del calls.\n /\n public delCalls: MemoryCacheDelCall[] = [];\n\n /\n Cache statistics.\n /\n protected _stats: MemoryCacheStats = {\n hits: 0,\n misses: 0,\n sets: 0,\n deletes: 0,\n };\n\n /\n Error to throw on get (for testing error handling)\n /\n public getError: Error \| null = null;\n\n /\n Error to throw on set (for testing error handling)\n /\n public setError: Error \| null = null;\n\n /\n Error to throw on del (for testing error handling)\n /\n public delError: Error \| null = null;\n\n constructor(options: MemoryCacheProviderOptions = {}) {\n super();\n this.getError = options.getError ?? null;\n this.setError = options.setError ?? null;\n this.delError = options.delError ?? null;\n }\n\n // ─────────────────────────────────────────────────────────────────────────────\n // CacheProvider implementation\n // ─────────────────────────────────────────────────────────────────────────────\n\n public async get(name: string, key: string): Promise<Uint8Array \| undefined> {\n this.getCalls.push({\n name,\n key,\n timestamp: this.dateTimeProvider.nowMillis(),\n });\n\n if (this.getError) {\n throw this.getError;\n }\n\n const data = this.store[name]?.[key]?.data;\n\n if (data !== undefined) {\n this._stats.hits++;\n } else {\n this._stats.misses++;\n }\n\n return data;\n }\n\n public async set(\n name: string,\n key: string,\n value: Uint8Array,\n ttl?: number,\n ): Promise<Uint8Array> {\n this.setCalls.push({\n name,\n key,\n value,\n ttl,\n timestamp: this.dateTimeProvider.nowMillis(),\n });\n this._stats.sets++;\n\n if (this.setError) {\n throw this.setError;\n }\n\n if (this.store[name] == null) {\n this.store[name] = {};\n }\n\n this.store[name][key] ??= {};\n this.store[name][key].data = value;\n\n this.log.debug(`Setting cache for name`, { name, key, ttl });\n\n // clear previous timeout if exists\n if (this.store[name][key].timeout) {\n this.dateTimeProvider.clearTimeout(this.store[name][key].timeout);\n this.store[name][key].timeout = undefined;\n }\n\n if (ttl) {\n this.store[name][key].timeout = this.dateTimeProvider.createTimeout(\n () => this.del(name, key),\n ttl,\n );\n }\n\n return this.store[name][key].data;\n }\n\n public async del(name: string, ...keys: string[]): Promise<void> {\n this.delCalls.push({\n name,\n keys,\n timestamp: this.dateTimeProvider.nowMillis(),\n });\n this._stats.deletes++;\n\n if (this.delError) {\n throw this.delError;\n }\n\n // delete all keys in name\n if (keys.length === 0) {\n this.log.debug(`Deleting all cache for name`, { name });\n\n if (this.store[name]) {\n for (const key of Object.keys(this.store[name])) {\n const timeout = this.store[name][key]?.timeout;\n if (timeout) {\n this.dateTimeProvider.clearTimeout(timeout);\n }\n }\n }\n delete this.store[name];\n return;\n }\n\n this.log.debug(`Deleting cache for name`, { name, keys });\n\n // delete specific keys in name\n for (const key of keys) {\n if (this.store[name] == null) break;\n\n const timeout = this.store[name][key]?.timeout;\n if (timeout) {\n this.dateTimeProvider.clearTimeout(timeout);\n }\n\n delete this.store[name][key];\n }\n\n if (Object.keys(this.store[name] ?? {}).length === 0) {\n // if name is empty, delete it\n delete this.store[name];\n }\n }\n\n public async has(name: string, key: string): Promise<boolean> {\n return this.store[name]?.[key]?.data != null;\n }\n\n public async keys(name: string, filter?: string): Promise<string[]> {\n const store = this.store[name] ?? {};\n const keys = Object.keys(store);\n if (filter) {\n return keys.filter((key) => key.startsWith(filter));\n }\n return keys;\n }\n\n public async clear(): Promise<void> {\n this.log.debug(\"Clearing all cache\");\n\n // Clear all timeouts before clearing the store\n for (const name of Object.keys(this.store)) {\n for (const key of Object.keys(this.store[name])) {\n const timeout = this.store[name][key]?.timeout;\n if (timeout) {\n this.dateTimeProvider.clearTimeout(timeout);\n }\n }\n }\n\n this.store = {};\n }\n\n public async incr(\n name: string,\n key: string,\n amount: number,\n ): Promise<number> {\n if (this.store[name] == null) {\n this.store[name] = {};\n }\n\n const existing = this.store[name][key]?.data;\n let current = 0;\n\n if (existing) {\n try {\n current = this.deserialize<number>(existing);\n } catch {\n // Fallback for raw bytes without type marker\n const str = new TextDecoder().decode(existing);\n current = Number.parseInt(str, 10) \|\| 0;\n }\n }\n\n const newValue = current + amount;\n this.store[name][key] ??= {};\n this.store[name][key].data = this.serialize(newValue);\n\n return newValue;\n }\n\n // ─────────────────────────────────────────────────────────────────────────────\n // Test utilities\n // ─────────────────────────────────────────────────────────────────────────────\n\n /\n Get cache statistics (hits, misses, sets, deletes).\n \n @example\n * ```typescript\n * expect(cache.stats().hits).toBe(1);\n * expect(cache.stats().misses).toBe(0);\n * ```\n /\n public stats(): MemoryCacheStats {\n return { ...this._stats };\n }\n\n /\n Check if a key was set during the test.\n \n @example\n * ```typescript\n * expect(cache.wasSet(\"my-cache\", \"user:123\")).toBe(true);\n * ```\n /\n public wasSet(name: string, key?: string): boolean {\n if (key === undefined) {\n return this.setCalls.some((call) => call.name === name);\n }\n return this.setCalls.some((call) => call.name === name && call.key === key);\n }\n\n /\n Check if a key was retrieved during the test.\n \n @example\n * ```typescript\n * expect(cache.wasGet(\"my-cache\", \"user:123\")).toBe(true);\n * ```\n /\n public wasGet(name: string, key?: string): boolean {\n if (key === undefined) {\n return this.getCalls.some((call) => call.name === name);\n }\n return this.getCalls.some((call) => call.name === name && call.key === key);\n }\n\n /\n Check if a key was deleted during the test.\n \n @example\n * ```typescript\n * expect(cache.wasDeleted(\"my-cache\", \"user:123\")).toBe(true);\n * ```\n /\n public wasDeleted(name: string, key?: string): boolean {\n if (key === undefined) {\n return this.delCalls.some((call) => call.name === name);\n }\n return this.delCalls.some(\n (call) => call.name === name && call.keys.includes(key),\n );\n }\n\n /\n Get the number of cached entries for a specific cache name.\n \n @example\n * ```typescript\n * expect(cache.size(\"my-cache\")).toBe(5);\n * ```\n /\n public size(name?: string): number {\n if (name === undefined) {\n return Object.values(this.store).reduce(\n (total, entries) => total + Object.keys(entries).length,\n 0,\n );\n }\n return Object.keys(this.store[name] ?? {}).length;\n }\n\n /\n Get all cache names.\n \n @example\n * ```typescript\n * expect(cache.names()).toContain(\"my-cache\");\n * ```\n /\n public names(): string[] {\n return Object.keys(this.store);\n }\n\n /\n Reset all in-memory state (useful between tests).\n \n @example\n * ```typescript\n * beforeEach(() => {\n * cache.reset();\n * });\n * ```\n /\n public reset(): void {\n // Clear all timeouts\n for (const name of Object.keys(this.store)) {\n for (const key of Object.keys(this.store[name])) {\n const timeout = this.store[name][key]?.timeout;\n if (timeout) {\n this.dateTimeProvider.clearTimeout(timeout);\n }\n }\n }\n\n this.store = {};\n this.getCalls = [];\n this.setCalls = [];\n this.delCalls = [];\n this._stats = { hits: 0, misses: 0, sets: 0, deletes: 0 };\n this.getError = null;\n this.setError = null;\n this.delError = null;\n }\n}\n","import {\n $atom,\n $inject,\n $use,\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 = $use(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\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 return this.provider.getTyped<TReturn>(this.container, key);\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 { 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\n/*\n Type-safe caching with TTL support.\n \n Features:\n * - Cached computations with type-safe keys and values\n * - Configurable TTL\n * - Cache invalidation\n * - Automatic cache population\n * - Providers: Memory (default), Redis\n \n @module alepha.cache\n */\nexport const AlephaCache = $module({\n name: \"alepha.cache\",\n primitives: [$cache],\n services: [CacheProvider, MemoryCacheProvider],\n register: (alepha) =>\n alepha.with({\n optional: true,\n provide: CacheProvider,\n use: MemoryCacheProvider,\n }),\n});\n"],"mappings":"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"}
1	+ {"version":3,"file":"index.js","names":[],"sources":["../../../src/cache/core/errors/CacheError.ts","../../../src/cache/core/providers/CacheProvider.ts","../../../src/cache/core/providers/MemoryCacheProvider.ts","../../../src/cache/core/primitives/$cache.ts","../../../src/cache/core/providers/CloudflareKVProvider.ts","../../../src/cache/core/index.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\n\nexport class CacheError extends AlephaError {}\n","import { CacheError } from \"../errors/CacheError.ts\";\n\n/*\n Cache provider interface.\n \n All methods are asynchronous and return promises.\n * Values are stored as Uint8Array.\n /\nexport abstract class CacheProvider {\n protected encoder: TextEncoder = new TextEncoder();\n protected decoder: TextDecoder = new TextDecoder();\n protected codes = {\n BINARY: 0x01,\n JSON: 0x02,\n STRING: 0x03,\n COMPRESSED: 0x04,\n };\n\n /\n Get the value of a key.\n \n @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n * @param key The key of the value to get.\n \n @return The value of the key, or undefined if the key does not exist.\n /\n public abstract get(\n name: string,\n key: string,\n ): Promise<Uint8Array \| undefined>;\n\n /\n Set the string value of a key.\n \n @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n * @param key The key of the value to set.\n * @param value The value to set.\n * @param ttl The time-to-live of the key, in milliseconds.\n \n @return The value of the key.\n /\n public abstract set(\n name: string,\n key: string,\n value: Uint8Array,\n ttl?: number,\n ): Promise<Uint8Array>;\n\n /\n Remove the specified keys.\n \n @param name Cache name, used to group keys. Should be Redis-like \"some:group:name\" format.\n * @param keys The keys to delete.\n /\n public abstract del(name: string, ...keys: string[]): Promise<void>;\n\n public abstract has(name: string, key: string): Promise<boolean>;\n\n public abstract keys(name: string, filter?: string): Promise<string[]>;\n\n /\n Remove all keys from all cache names.\n /\n public abstract clear(): Promise<void>;\n\n /\n Increment the integer value of a key by the given amount.\n \n If the key does not exist, it is set to 0 before performing the operation.\n * This operation is atomic when using Redis.\n \n @param name Cache name, used to group keys.\n * @param key The key to increment.\n * @param amount The amount to increment by.\n * @returns The new value after incrementing.\n /\n public abstract incr(\n name: string,\n key: string,\n amount: number,\n ): Promise<number>;\n\n // ---------------------------------------------------------------------------\n // High-level methods — serialize/compress layer used by CachePrimitive\n // ---------------------------------------------------------------------------\n\n /\n Set a typed value with automatic serialization and optional compression.\n /\n public async setTyped(\n name: string,\n key: string,\n value: unknown,\n options?: { ttl?: number; compress?: boolean },\n ): Promise<void> {\n let data = this.serialize(value);\n if (options?.compress) {\n data = await this.compress(data);\n }\n await this.set(name, key, data, options?.ttl);\n }\n\n /\n Get a typed value with automatic deserialization and optional decompression.\n /\n public async getTyped<T>(name: string, key: string): Promise<T \| undefined> {\n const data = await this.get(name, key);\n if (data) {\n if (data[0] === this.codes.COMPRESSED) {\n const decompressed = await this.decompress(data.subarray(1));\n return this.deserialize<T>(decompressed);\n }\n return this.deserialize<T>(data);\n }\n return undefined;\n }\n\n /\n Invalidate cache keys with wildcard support.\n \n Keys ending in `` are expanded via `this.keys()`.\n Called with no keys, delegates to `this.del(name)` which clears the entire container.\n /\n public async invalidateKeys(name: string, keys: string[]): Promise<void> {\n const keysToDelete: string[] = [];\n\n for (const key of keys) {\n if (key.endsWith(\"\")) {\n const result = await this.keys(name, key.slice(0, -1));\n keysToDelete.push(...result);\n } else {\n keysToDelete.push(key);\n }\n }\n\n await this.del(name, ...keysToDelete);\n }\n\n /*\n Serialize a value to a typed Uint8Array with a leading type marker byte.\n /\n protected serialize(value: unknown): Uint8Array {\n if (value instanceof Uint8Array) {\n const result = new Uint8Array(1 + value.length);\n result[0] = this.codes.BINARY;\n result.set(value, 1);\n return result;\n }\n\n const encoded = this.encoder.encode(\n typeof value === \"string\" ? value : JSON.stringify(value),\n );\n const code =\n typeof value === \"string\" ? this.codes.STRING : this.codes.JSON;\n const result = new Uint8Array(1 + encoded.length);\n result[0] = code;\n result.set(encoded, 1);\n return result;\n }\n\n /\n Deserialize a typed Uint8Array back to the original value.\n /\n protected deserialize<T>(uint8Array: Uint8Array): T {\n const type = uint8Array[0];\n const payload = uint8Array.slice(1);\n\n if (type === this.codes.BINARY) {\n return payload as T;\n }\n if (type === this.codes.JSON) {\n return JSON.parse(this.decoder.decode(payload)) as T;\n }\n if (type === this.codes.STRING) {\n return this.decoder.decode(payload) as T;\n }\n\n throw new CacheError(`Unknown serialization type: ${type}`);\n }\n\n /\n Compress data with gzip, prepending a COMPRESSED marker byte.\n /\n protected async compress(data: Uint8Array): Promise<Uint8Array> {\n const buf = (data.buffer as ArrayBuffer).slice(\n data.byteOffset,\n data.byteOffset + data.byteLength,\n );\n const compressed = new Uint8Array(\n await new Response(\n new Blob([buf]).stream().pipeThrough(new CompressionStream(\"gzip\")),\n ).arrayBuffer(),\n );\n const result = new Uint8Array(1 + compressed.length);\n result[0] = this.codes.COMPRESSED;\n result.set(compressed, 1);\n return result;\n }\n\n /\n Decompress gzipped data.\n /\n protected async decompress(data: Uint8Array): Promise<Uint8Array> {\n const buf = (data.buffer as ArrayBuffer).slice(\n data.byteOffset,\n data.byteOffset + data.byteLength,\n );\n return new Uint8Array(\n await new Response(\n new Blob([buf]).stream().pipeThrough(new DecompressionStream(\"gzip\")),\n ).arrayBuffer(),\n );\n }\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider, type Timeout } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { CacheProvider } from \"./CacheProvider.ts\";\n\ntype CacheName = string;\ntype CacheKey = string;\ntype CacheValue = {\n data?: Uint8Array;\n timeout?: Timeout;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface MemoryCacheCall {\n name: string;\n key: string;\n timestamp: number;\n}\n\nexport interface MemoryCacheSetCall extends MemoryCacheCall {\n value: Uint8Array;\n ttl?: number;\n}\n\nexport interface MemoryCacheDelCall {\n name: string;\n keys: string[];\n timestamp: number;\n}\n\nexport interface MemoryCacheStats {\n hits: number;\n misses: number;\n sets: number;\n deletes: number;\n}\n\nexport interface MemoryCacheProviderOptions {\n /\n Error to throw on get operations (for testing error handling)\n /\n getError?: Error \| null;\n /\n Error to throw on set operations (for testing error handling)\n /\n setError?: Error \| null;\n /\n Error to throw on del operations (for testing error handling)\n /\n delError?: Error \| null;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/\n In-memory implementation of CacheProvider for testing.\n \n This provider stores all cache entries in memory, making it ideal for\n * unit tests that need to verify cache operations without touching Redis or other backends.\n \n @example\n * ```typescript\n * // In tests, substitute the real CacheProvider with MemoryCacheProvider\n * const alepha = Alepha.create().with({\n * provide: CacheProvider,\n * use: MemoryCacheProvider,\n * });\n \n // Run code that uses caching\n * const service = alepha.inject(MyService);\n * await service.fetchWithCache(\"key\");\n \n // Verify cache behavior\n * const cache = alepha.inject(MemoryCacheProvider);\n * expect(cache.stats().misses).toBe(1);\n * await service.fetchWithCache(\"key\");\n * expect(cache.stats().hits).toBe(1);\n * ```\n /\nexport class MemoryCacheProvider extends CacheProvider {\n protected readonly dateTimeProvider = $inject(DateTimeProvider);\n protected readonly log = $logger();\n\n protected store: Record<CacheName, Record<CacheKey, CacheValue>> = {};\n\n // ─────────────────────────────────────────────────────────────────────────────\n // Test tracking\n // ─────────────────────────────────────────────────────────────────────────────\n\n /\n All recorded get calls.\n /\n public getCalls: MemoryCacheCall[] = [];\n\n /\n All recorded set calls.\n /\n public setCalls: MemoryCacheSetCall[] = [];\n\n /\n All recorded del calls.\n /\n public delCalls: MemoryCacheDelCall[] = [];\n\n /\n Cache statistics.\n /\n protected _stats: MemoryCacheStats = {\n hits: 0,\n misses: 0,\n sets: 0,\n deletes: 0,\n };\n\n /\n Error to throw on get (for testing error handling)\n /\n public getError: Error \| null = null;\n\n /\n Error to throw on set (for testing error handling)\n /\n public setError: Error \| null = null;\n\n /\n Error to throw on del (for testing error handling)\n /\n public delError: Error \| null = null;\n\n constructor(options: MemoryCacheProviderOptions = {}) {\n super();\n this.getError = options.getError ?? null;\n this.setError = options.setError ?? null;\n this.delError = options.delError ?? null;\n }\n\n // ─────────────────────────────────────────────────────────────────────────────\n // CacheProvider implementation\n // ─────────────────────────────────────────────────────────────────────────────\n\n public async get(name: string, key: string): Promise<Uint8Array \| undefined> {\n this.getCalls.push({\n name,\n key,\n timestamp: this.dateTimeProvider.nowMillis(),\n });\n\n if (this.getError) {\n throw this.getError;\n }\n\n const data = this.store[name]?.[key]?.data;\n\n if (data !== undefined) {\n this._stats.hits++;\n } else {\n this._stats.misses++;\n }\n\n return data;\n }\n\n public async set(\n name: string,\n key: string,\n value: Uint8Array,\n ttl?: number,\n ): Promise<Uint8Array> {\n this.setCalls.push({\n name,\n key,\n value,\n ttl,\n timestamp: this.dateTimeProvider.nowMillis(),\n });\n this._stats.sets++;\n\n if (this.setError) {\n throw this.setError;\n }\n\n if (this.store[name] == null) {\n this.store[name] = {};\n }\n\n this.store[name][key] ??= {};\n this.store[name][key].data = value;\n\n this.log.debug(`Setting cache for name`, { name, key, ttl });\n\n // clear previous timeout if exists\n if (this.store[name][key].timeout) {\n this.dateTimeProvider.clearTimeout(this.store[name][key].timeout);\n this.store[name][key].timeout = undefined;\n }\n\n if (ttl) {\n this.store[name][key].timeout = this.dateTimeProvider.createTimeout(\n () => this.del(name, key),\n ttl,\n );\n }\n\n return this.store[name][key].data;\n }\n\n public async del(name: string, ...keys: string[]): Promise<void> {\n this.delCalls.push({\n name,\n keys,\n timestamp: this.dateTimeProvider.nowMillis(),\n });\n this._stats.deletes++;\n\n if (this.delError) {\n throw this.delError;\n }\n\n // delete all keys in name\n if (keys.length === 0) {\n this.log.debug(`Deleting all cache for name`, { name });\n\n if (this.store[name]) {\n for (const key of Object.keys(this.store[name])) {\n const timeout = this.store[name][key]?.timeout;\n if (timeout) {\n this.dateTimeProvider.clearTimeout(timeout);\n }\n }\n }\n delete this.store[name];\n return;\n }\n\n this.log.debug(`Deleting cache for name`, { name, keys });\n\n // delete specific keys in name\n for (const key of keys) {\n if (this.store[name] == null) break;\n\n const timeout = this.store[name][key]?.timeout;\n if (timeout) {\n this.dateTimeProvider.clearTimeout(timeout);\n }\n\n delete this.store[name][key];\n }\n\n if (Object.keys(this.store[name] ?? {}).length === 0) {\n // if name is empty, delete it\n delete this.store[name];\n }\n }\n\n public async has(name: string, key: string): Promise<boolean> {\n return this.store[name]?.[key]?.data != null;\n }\n\n public async keys(name: string, filter?: string): Promise<string[]> {\n const store = this.store[name] ?? {};\n const keys = Object.keys(store);\n if (filter) {\n return keys.filter((key) => key.startsWith(filter));\n }\n return keys;\n }\n\n public async clear(): Promise<void> {\n this.log.debug(\"Clearing all cache\");\n\n // Clear all timeouts before clearing the store\n for (const name of Object.keys(this.store)) {\n for (const key of Object.keys(this.store[name])) {\n const timeout = this.store[name][key]?.timeout;\n if (timeout) {\n this.dateTimeProvider.clearTimeout(timeout);\n }\n }\n }\n\n this.store = {};\n }\n\n public async incr(\n name: string,\n key: string,\n amount: number,\n ): Promise<number> {\n if (this.store[name] == null) {\n this.store[name] = {};\n }\n\n const existing = this.store[name][key]?.data;\n let current = 0;\n\n if (existing) {\n try {\n current = this.deserialize<number>(existing);\n } catch {\n // Fallback for raw bytes without type marker\n const str = new TextDecoder().decode(existing);\n current = Number.parseInt(str, 10) \|\| 0;\n }\n }\n\n const newValue = current + amount;\n this.store[name][key] ??= {};\n this.store[name][key].data = this.serialize(newValue);\n\n return newValue;\n }\n\n // ─────────────────────────────────────────────────────────────────────────────\n // Test utilities\n // ─────────────────────────────────────────────────────────────────────────────\n\n /\n Get cache statistics (hits, misses, sets, deletes).\n \n @example\n * ```typescript\n * expect(cache.stats().hits).toBe(1);\n * expect(cache.stats().misses).toBe(0);\n * ```\n /\n public stats(): MemoryCacheStats {\n return { ...this._stats };\n }\n\n /\n Check if a key was set during the test.\n \n @example\n * ```typescript\n * expect(cache.wasSet(\"my-cache\", \"user:123\")).toBe(true);\n * ```\n /\n public wasSet(name: string, key?: string): boolean {\n if (key === undefined) {\n return this.setCalls.some((call) => call.name === name);\n }\n return this.setCalls.some((call) => call.name === name && call.key === key);\n }\n\n /\n Check if a key was retrieved during the test.\n \n @example\n * ```typescript\n * expect(cache.wasGet(\"my-cache\", \"user:123\")).toBe(true);\n * ```\n /\n public wasGet(name: string, key?: string): boolean {\n if (key === undefined) {\n return this.getCalls.some((call) => call.name === name);\n }\n return this.getCalls.some((call) => call.name === name && call.key === key);\n }\n\n /\n Check if a key was deleted during the test.\n \n @example\n * ```typescript\n * expect(cache.wasDeleted(\"my-cache\", \"user:123\")).toBe(true);\n * ```\n /\n public wasDeleted(name: string, key?: string): boolean {\n if (key === undefined) {\n return this.delCalls.some((call) => call.name === name);\n }\n return this.delCalls.some(\n (call) => call.name === name && call.keys.includes(key),\n );\n }\n\n /\n Get the number of cached entries for a specific cache name.\n \n @example\n * ```typescript\n * expect(cache.size(\"my-cache\")).toBe(5);\n * ```\n /\n public size(name?: string): number {\n if (name === undefined) {\n return Object.values(this.store).reduce(\n (total, entries) => total + Object.keys(entries).length,\n 0,\n );\n }\n return Object.keys(this.store[name] ?? {}).length;\n }\n\n /\n Get all cache names.\n \n @example\n * ```typescript\n * expect(cache.names()).toContain(\"my-cache\");\n * ```\n /\n public names(): string[] {\n return Object.keys(this.store);\n }\n\n /\n Reset all in-memory state (useful between tests).\n \n @example\n * ```typescript\n * beforeEach(() => {\n * cache.reset();\n * });\n * ```\n /\n public reset(): void {\n // Clear all timeouts\n for (const name of Object.keys(this.store)) {\n for (const key of Object.keys(this.store[name])) {\n const timeout = this.store[name][key]?.timeout;\n if (timeout) {\n this.dateTimeProvider.clearTimeout(timeout);\n }\n }\n }\n\n this.store = {};\n this.getCalls = [];\n this.setCalls = [];\n this.delCalls = [];\n this._stats = { hits: 0, misses: 0, sets: 0, deletes: 0 };\n this.getError = null;\n this.setError = null;\n this.delError = null;\n }\n}\n","import {\n $atom,\n $inject,\n $state,\n AlephaError,\n createPrimitive,\n 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\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 return this.provider.getTyped<TReturn>(this.container, key);\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 { 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\n/*\n Type-safe caching with TTL support.\n \n Features:\n * - Cached computations with type-safe keys and values\n * - Configurable TTL\n * - Cache invalidation\n * - Automatic cache population\n * - Providers: Memory (default), Redis\n \n @module alepha.cache\n */\nexport const AlephaCache = $module({\n name: \"alepha.cache\",\n primitives: [$cache],\n services: [CacheProvider, MemoryCacheProvider],\n register: (alepha) =>\n alepha.with({\n optional: true,\n provide: CacheProvider,\n use: MemoryCacheProvider,\n }),\n});\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { $atom, $hook, $inject, $module, $use, Alepha, AlephaError, KIND, OPTIONS, Primitive, createPrimitive, t } from "alepha";
+import { $atom, $hook, $inject, $module, $state, Alepha, AlephaError, KIND, OPTIONS, Primitive, createPrimitive, t } from "alepha";
 import { DateTimeProvider } from "alepha/datetime";
 import { $logger } from "alepha/logger";
 //#region ../../src/cache/core/errors/CacheError.ts
@@ -416,7 +416,7 @@ const cacheOptions = $atom({
 	}
 });
 var CachePrimitive = class extends Primitive {
-	settings = $use(cacheOptions);
+	settings = $state(cacheOptions);
 	dateTimeProvider = $inject(DateTimeProvider);
 	provider = this.$provider();
 	get container() {

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

	@@ -1 +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 $use,\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 = $use(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\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 return this.provider.getTyped<TReturn>(this.container, key);\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, 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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"}
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\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 return this.provider.getTyped<TReturn>(this.container, key);\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, 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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"}

package/dist/cache/redis/index.d.ts CHANGED Viewed

@@ -1,15 +1,15 @@
-import * as alepha from "alepha";
+import * as _$alepha from "alepha";
 import { Alepha, Static } from "alepha";
 import { CacheProvider } from "alepha/cache";
-import * as alepha_logger0 from "alepha/logger";
+import * as _$alepha_logger0 from "alepha/logger";
 import { RedisProvider } from "alepha/redis";
 //#region ../../src/cache/redis/providers/RedisCacheProvider.d.ts
 /**
  * Redis cache configuration atom.
  */
-declare const redisCacheOptions: alepha.Atom<alepha.TObject<{
-  prefix: alepha.TOptional<alepha.TString>;
+declare const redisCacheOptions: _$alepha.Atom<_$alepha.TObject<{
+  prefix: _$alepha.TOptional<_$alepha.TString>;
 }>, "alepha.cache.redis.options">;
 type RedisCacheOptions = Static<typeof redisCacheOptions.schema>;
 declare module "alepha" {
@@ -18,7 +18,7 @@ declare module "alepha" {
   }
 }
 declare class RedisCacheProvider extends CacheProvider {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: _$alepha_logger0.Logger;
   protected readonly redisProvider: RedisProvider;
   protected readonly options: Readonly<{
     prefix?: string | undefined;
@@ -41,7 +41,7 @@ declare class RedisCacheProvider extends CacheProvider {
  * @see {@link RedisCacheProvider}
  * @module alepha.cache.redis
  */
-declare const AlephaCacheRedis: alepha.Service<alepha.Module>;
+declare const AlephaCacheRedis: _$alepha.Service<_$alepha.Module>;
 //#endregion
 export { AlephaCacheRedis, RedisCacheOptions, RedisCacheProvider, redisCacheOptions };
 //# sourceMappingURL=index.d.ts.map

package/dist/cache/redis/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cache/redis/providers/RedisCacheProvider.ts","../../../src/cache/redis/index.ts"],"mappings":";;;;;;;;;;cAUa,iBAAA,EAAiB,~~MAAA~~,CAAA,IAAA,~~QAAA~~,OAAA;~~2BAW5B~~,~~MAAA~~,CAAA,OAAA;AAAA;AAAA,KAEU,iBAAA,GAAoB,MAAA,QAAc,iBAAA,CAAkB,MAAA;AAAA;EAAA,UAGpD,KAAA;IAAA,CACP,iBAAA,CAAkB,GAAA,GAAM,iBAAA;EAAA;AAAA;AAAA,cAMhB,kBAAA,SAA2B,aAAA;EAAA,mBACnB,GAAA,EADW,~~cAAA~~,CACR,MAAA;EAAA,mBACH,aAAA,EAAa,aAAA;EAAA,mBACb,OAAA,EAAO,QAAA;;;qBACP,MAAA,EAAM,MAAA;EAEZ,GAAA,CAAI,IAAA,UAAc,GAAA,WAAc,OAAA,CAAQ,UAAA;EAmBxC,GAAA,CACX,IAAA,UACA,GAAA,UACA,KAAA,EAAO,UAAA,WACP,GAAA,YACC,OAAA,CAAQ,UAAA;EAmBE,GAAA,CAAI,IAAA,aAAiB,IAAA,aAAiB,OAAA;EAmBtC,GAAA,CAAI,IAAA,UAAc,GAAA,WAAc,OAAA;EAIhC,IAAA,CAAK,IAAA,UAAc,MAAA,YAAkB,OAAA;EAOrC,KAAA,CAAA,GAAS,OAAA;EAST,IAAA,CACX,IAAA,UACA,GAAA,UACA,MAAA,WACC,OAAA;EAAA,UAKO,MAAA,CAAA,GAAU,IAAA;AAAA;;;;;;;;;cClHT,gBAAA,EAAgB,~~MAAA~~,CAAA,OAAA,CAW3B,~~MAAA~~,CAX2B,MAAA"}
1	+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cache/redis/providers/RedisCacheProvider.ts","../../../src/cache/redis/index.ts"],"mappings":";;;;;;;;;;cAUa,iBAAA,EAAiB,QAAA,CAAA,IAAA,UAAA,OAAA;6BAW5B,QAAA,CAAA,OAAA;AAAA;AAAA,KAEU,iBAAA,GAAoB,MAAA,QAAc,iBAAA,CAAkB,MAAA;AAAA;EAAA,UAGpD,KAAA;IAAA,CACP,iBAAA,CAAkB,GAAA,GAAM,iBAAA;EAAA;AAAA;AAAA,cAMhB,kBAAA,SAA2B,aAAA;EAAA,mBACnB,GAAA,EADW,gBAAA,CACR,MAAA;EAAA,mBACH,aAAA,EAAa,aAAA;EAAA,mBACb,OAAA,EAAO,QAAA;;;qBACP,MAAA,EAAM,MAAA;EAEZ,GAAA,CAAI,IAAA,UAAc,GAAA,WAAc,OAAA,CAAQ,UAAA;EAmBxC,GAAA,CACX,IAAA,UACA,GAAA,UACA,KAAA,EAAO,UAAA,WACP,GAAA,YACC,OAAA,CAAQ,UAAA;EAmBE,GAAA,CAAI,IAAA,aAAiB,IAAA,aAAiB,OAAA;EAmBtC,GAAA,CAAI,IAAA,UAAc,GAAA,WAAc,OAAA;EAIhC,IAAA,CAAK,IAAA,UAAc,MAAA,YAAkB,OAAA;EAOrC,KAAA,CAAA,GAAS,OAAA;EAST,IAAA,CACX,IAAA,UACA,GAAA,UACA,MAAA,WACC,OAAA;EAAA,UAKO,MAAA,CAAA,GAAU,IAAA;AAAA;;;;;;;;;cClHT,gBAAA,EAAgB,QAAA,CAAA,OAAA,CAW3B,QAAA,CAX2B,MAAA"}

package/dist/cache/redis/index.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { $atom, $inject, $module, $use, Alepha, t } from "alepha";
+import { $atom, $inject, $module, $state, Alepha, t } from "alepha";
 import { AlephaCache, CacheProvider } from "alepha/cache";
 import { $logger } from "alepha/logger";
 import { RedisProvider } from "alepha/redis";
@@ -14,7 +14,7 @@ const redisCacheOptions = $atom({
 var RedisCacheProvider = class extends CacheProvider {
 	log = $logger();
 	redisProvider = $inject(RedisProvider);
-	options = $use(redisCacheOptions);
+	options = $state(redisCacheOptions);
 	alepha = $inject(Alepha);
 	async get(name, key) {
 		if (!this.alepha.isStarted()) return;

package/dist/cache/redis/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","names":[],"sources":["../../../src/cache/redis/providers/RedisCacheProvider.ts","../../../src/cache/redis/index.ts"],"sourcesContent":["import { $atom, $inject, $~~use~~, Alepha, type Static, t } from \"alepha\";\nimport { CacheProvider } from \"alepha/cache\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider } from \"alepha/redis\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/*\n Redis cache configuration atom.\n /\nexport const redisCacheOptions = $atom({\n name: \"alepha.cache.redis.options\",\n schema: t.object({\n prefix: t.optional(\n t.text({\n description:\n \"Prefix for all cache keys in Redis. Useful for testing or multi-tenant applications.\",\n }),\n ),\n }),\n default: {},\n});\n\nexport type RedisCacheOptions = Static<typeof redisCacheOptions.schema>;\n\ndeclare module \"alepha\" {\n interface State {\n [redisCacheOptions.key]: RedisCacheOptions;\n }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class RedisCacheProvider extends CacheProvider {\n protected readonly log = $logger();\n protected readonly redisProvider = $inject(RedisProvider);\n protected readonly options = $~~use~~(redisCacheOptions);\n protected readonly alepha = $inject(Alepha);\n\n public async get(name: string, key: string): Promise<Uint8Array \| undefined> {\n if (!this.alepha.isStarted()) {\n return;\n }\n\n const keyWithPrefix = this.prefix(name, key);\n const buffer = await this.redisProvider.get(keyWithPrefix);\n if (!buffer) {\n return;\n }\n\n this.log.debug(`Cache hit`, {\n size: buffer.byteLength,\n key: keyWithPrefix,\n });\n\n return new Uint8Array(buffer);\n }\n\n public async set(\n name: string,\n key: string,\n value: Uint8Array \| string,\n ttl?: number,\n ): Promise<Uint8Array> {\n if (!this.alepha.isReady()) {\n return new Uint8Array(Buffer.from(value));\n }\n\n const buffer = Buffer.from(value);\n const prefix = this.prefix(name, key);\n\n if (ttl) {\n return new Uint8Array(\n await this.redisProvider.set(prefix, buffer, {\n expiration: { type: \"PX\", value: ttl },\n }),\n );\n }\n\n return new Uint8Array(await this.redisProvider.set(prefix, buffer));\n }\n\n public async del(name: string, ...keys: string[]): Promise<void> {\n const nameKey = this.prefix(name);\n\n if (keys.length === 0) {\n const matched = await this.redisProvider.keys(`${nameKey}:`);\n if (matched.length > 0) {\n await this.redisProvider.del(matched);\n }\n return;\n }\n\n const prefixed = keys.map((key) =>\n key.startsWith(nameKey) ? key : this.prefix(name, key),\n );\n if (prefixed.length > 0) {\n await this.redisProvider.del(prefixed);\n }\n }\n\n public async has(name: string, key: string): Promise<boolean> {\n return this.redisProvider.has(this.prefix(name, key));\n }\n\n public async keys(name: string, filter?: string): Promise<string[]> {\n if (filter) {\n return await this.redisProvider.keys(`${this.prefix(name)}:${filter}`);\n }\n return this.redisProvider.keys(`${this.prefix(name)}:`);\n }\n\n public async clear(): Promise<void> {\n this.log.debug(\"Clearing all cache\");\n const pattern = `${this.prefix()}:`;\n const keys = await this.redisProvider.keys(pattern);\n if (keys.length > 0) {\n await this.redisProvider.del(keys);\n }\n }\n\n public async incr(\n name: string,\n key: string,\n amount: number,\n ): Promise<number> {\n const keyWithPrefix = this.prefix(name, key);\n return this.redisProvider.incr(keyWithPrefix, amount);\n }\n\n protected prefix(...path: string[]): string {\n const parts = [\"cache\", ...path];\n\n if (this.options.prefix) {\n parts.unshift(this.options.prefix);\n }\n\n return parts.join(\":\");\n }\n}\n","import { $module } from \"alepha\";\nimport { AlephaCache, CacheProvider } from \"alepha/cache\";\nimport { RedisCacheProvider } from \"./providers/RedisCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport from \"./providers/RedisCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/*\n Plugin for Alepha Cache that provides Redis caching capabilities.\n \n @see {@link RedisCacheProvider}\n * @module alepha.cache.redis\n */\nexport const AlephaCacheRedis = $module({\n name: \"alepha.cache.redis\",\n services: [RedisCacheProvider],\n register: (alepha) =>\n alepha\n .with({\n provide: CacheProvider,\n use: RedisCacheProvider,\n optional: true,\n })\n .with(AlephaCache),\n});\n"],"mappings":";;;;;;;;AAUA,MAAa,oBAAoB,MAAM;CACrC,MAAM;CACN,QAAQ,EAAE,OAAO,EACf,QAAQ,EAAE,SACR,EAAE,KAAK,EACL,aACE,wFACH,CAAC,CACH,EACF,CAAC;CACF,SAAS,EAAE;CACZ,CAAC;AAYF,IAAa,qBAAb,cAAwC,cAAc;CACpD,MAAyB,SAAS;CAClC,gBAAmC,QAAQ,cAAc;CACzD,UAA6B,~~KAAK~~,kBAAkB;~~CACpD~~,SAA4B,QAAQ,OAAO;CAE3C,MAAa,IAAI,MAAc,KAA8C;AAC3E,MAAI,CAAC,KAAK,OAAO,WAAW,CAC1B;EAGF,MAAM,gBAAgB,KAAK,OAAO,MAAM,IAAI;EAC5C,MAAM,SAAS,MAAM,KAAK,cAAc,IAAI,cAAc;AAC1D,MAAI,CAAC,OACH;AAGF,OAAK,IAAI,MAAM,aAAa;GAC1B,MAAM,OAAO;GACb,KAAK;GACN,CAAC;AAEF,SAAO,IAAI,WAAW,OAAO;;CAG/B,MAAa,IACX,MACA,KACA,OACA,KACqB;AACrB,MAAI,CAAC,KAAK,OAAO,SAAS,CACxB,QAAO,IAAI,WAAW,OAAO,KAAK,MAAM,CAAC;EAG3C,MAAM,SAAS,OAAO,KAAK,MAAM;EACjC,MAAM,SAAS,KAAK,OAAO,MAAM,IAAI;AAErC,MAAI,IACF,QAAO,IAAI,WACT,MAAM,KAAK,cAAc,IAAI,QAAQ,QAAQ,EAC3C,YAAY;GAAE,MAAM;GAAM,OAAO;GAAK,EACvC,CAAC,CACH;AAGH,SAAO,IAAI,WAAW,MAAM,KAAK,cAAc,IAAI,QAAQ,OAAO,CAAC;;CAGrE,MAAa,IAAI,MAAc,GAAG,MAA+B;EAC/D,MAAM,UAAU,KAAK,OAAO,KAAK;AAEjC,MAAI,KAAK,WAAW,GAAG;GACrB,MAAM,UAAU,MAAM,KAAK,cAAc,KAAK,GAAG,QAAQ,IAAI;AAC7D,OAAI,QAAQ,SAAS,EACnB,OAAM,KAAK,cAAc,IAAI,QAAQ;AAEvC;;EAGF,MAAM,WAAW,KAAK,KAAK,QACzB,IAAI,WAAW,QAAQ,GAAG,MAAM,KAAK,OAAO,MAAM,IAAI,CACvD;AACD,MAAI,SAAS,SAAS,EACpB,OAAM,KAAK,cAAc,IAAI,SAAS;;CAI1C,MAAa,IAAI,MAAc,KAA+B;AAC5D,SAAO,KAAK,cAAc,IAAI,KAAK,OAAO,MAAM,IAAI,CAAC;;CAGvD,MAAa,KAAK,MAAc,QAAoC;AAClE,MAAI,OACF,QAAO,MAAM,KAAK,cAAc,KAAK,GAAG,KAAK,OAAO,KAAK,CAAC,GAAG,OAAO,GAAG;AAEzE,SAAO,KAAK,cAAc,KAAK,GAAG,KAAK,OAAO,KAAK,CAAC,IAAI;;CAG1D,MAAa,QAAuB;AAClC,OAAK,IAAI,MAAM,qBAAqB;EACpC,MAAM,UAAU,GAAG,KAAK,QAAQ,CAAC;EACjC,MAAM,OAAO,MAAM,KAAK,cAAc,KAAK,QAAQ;AACnD,MAAI,KAAK,SAAS,EAChB,OAAM,KAAK,cAAc,IAAI,KAAK;;CAItC,MAAa,KACX,MACA,KACA,QACiB;EACjB,MAAM,gBAAgB,KAAK,OAAO,MAAM,IAAI;AAC5C,SAAO,KAAK,cAAc,KAAK,eAAe,OAAO;;CAGvD,OAAiB,GAAG,MAAwB;EAC1C,MAAM,QAAQ,CAAC,SAAS,GAAG,KAAK;AAEhC,MAAI,KAAK,QAAQ,OACf,OAAM,QAAQ,KAAK,QAAQ,OAAO;AAGpC,SAAO,MAAM,KAAK,IAAI;;;;;;;;;;;ACzH1B,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,UAAU,CAAC,mBAAmB;CAC9B,WAAW,WACT,OACG,KAAK;EACJ,SAAS;EACT,KAAK;EACL,UAAU;EACX,CAAC,CACD,KAAK,YAAY;CACvB,CAAC"}
1	+ {"version":3,"file":"index.js","names":[],"sources":["../../../src/cache/redis/providers/RedisCacheProvider.ts","../../../src/cache/redis/index.ts"],"sourcesContent":["import { $atom, $inject, $state, Alepha, type Static, t } from \"alepha\";\nimport { CacheProvider } from \"alepha/cache\";\nimport { $logger } from \"alepha/logger\";\nimport { RedisProvider } from \"alepha/redis\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/*\n Redis cache configuration atom.\n /\nexport const redisCacheOptions = $atom({\n name: \"alepha.cache.redis.options\",\n schema: t.object({\n prefix: t.optional(\n t.text({\n description:\n \"Prefix for all cache keys in Redis. Useful for testing or multi-tenant applications.\",\n }),\n ),\n }),\n default: {},\n});\n\nexport type RedisCacheOptions = Static<typeof redisCacheOptions.schema>;\n\ndeclare module \"alepha\" {\n interface State {\n [redisCacheOptions.key]: RedisCacheOptions;\n }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class RedisCacheProvider extends CacheProvider {\n protected readonly log = $logger();\n protected readonly redisProvider = $inject(RedisProvider);\n protected readonly options = $state(redisCacheOptions);\n protected readonly alepha = $inject(Alepha);\n\n public async get(name: string, key: string): Promise<Uint8Array \| undefined> {\n if (!this.alepha.isStarted()) {\n return;\n }\n\n const keyWithPrefix = this.prefix(name, key);\n const buffer = await this.redisProvider.get(keyWithPrefix);\n if (!buffer) {\n return;\n }\n\n this.log.debug(`Cache hit`, {\n size: buffer.byteLength,\n key: keyWithPrefix,\n });\n\n return new Uint8Array(buffer);\n }\n\n public async set(\n name: string,\n key: string,\n value: Uint8Array \| string,\n ttl?: number,\n ): Promise<Uint8Array> {\n if (!this.alepha.isReady()) {\n return new Uint8Array(Buffer.from(value));\n }\n\n const buffer = Buffer.from(value);\n const prefix = this.prefix(name, key);\n\n if (ttl) {\n return new Uint8Array(\n await this.redisProvider.set(prefix, buffer, {\n expiration: { type: \"PX\", value: ttl },\n }),\n );\n }\n\n return new Uint8Array(await this.redisProvider.set(prefix, buffer));\n }\n\n public async del(name: string, ...keys: string[]): Promise<void> {\n const nameKey = this.prefix(name);\n\n if (keys.length === 0) {\n const matched = await this.redisProvider.keys(`${nameKey}:`);\n if (matched.length > 0) {\n await this.redisProvider.del(matched);\n }\n return;\n }\n\n const prefixed = keys.map((key) =>\n key.startsWith(nameKey) ? key : this.prefix(name, key),\n );\n if (prefixed.length > 0) {\n await this.redisProvider.del(prefixed);\n }\n }\n\n public async has(name: string, key: string): Promise<boolean> {\n return this.redisProvider.has(this.prefix(name, key));\n }\n\n public async keys(name: string, filter?: string): Promise<string[]> {\n if (filter) {\n return await this.redisProvider.keys(`${this.prefix(name)}:${filter}`);\n }\n return this.redisProvider.keys(`${this.prefix(name)}:`);\n }\n\n public async clear(): Promise<void> {\n this.log.debug(\"Clearing all cache\");\n const pattern = `${this.prefix()}:`;\n const keys = await this.redisProvider.keys(pattern);\n if (keys.length > 0) {\n await this.redisProvider.del(keys);\n }\n }\n\n public async incr(\n name: string,\n key: string,\n amount: number,\n ): Promise<number> {\n const keyWithPrefix = this.prefix(name, key);\n return this.redisProvider.incr(keyWithPrefix, amount);\n }\n\n protected prefix(...path: string[]): string {\n const parts = [\"cache\", ...path];\n\n if (this.options.prefix) {\n parts.unshift(this.options.prefix);\n }\n\n return parts.join(\":\");\n }\n}\n","import { $module } from \"alepha\";\nimport { AlephaCache, CacheProvider } from \"alepha/cache\";\nimport { RedisCacheProvider } from \"./providers/RedisCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport from \"./providers/RedisCacheProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/*\n Plugin for Alepha Cache that provides Redis caching capabilities.\n \n @see {@link RedisCacheProvider}\n * @module alepha.cache.redis\n */\nexport const AlephaCacheRedis = $module({\n name: \"alepha.cache.redis\",\n services: [RedisCacheProvider],\n register: (alepha) =>\n alepha\n .with({\n provide: CacheProvider,\n use: RedisCacheProvider,\n optional: true,\n })\n .with(AlephaCache),\n});\n"],"mappings":"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"}