@zudojs/cache 0.0.1

package/dist/serializer.js

@@ -0,0 +1,74 @@
+/**
+ * @zudojs/cache — Serializer
+ *
+ * Provides serializer implementations for converting cache values
+ * to and from storable representations. Delegates to @zudojs/serialization
+ * for the actual JSON serialization with type preservation.
+ */
+import { JSONSerializer } from "@zudojs/serialization";
+/* -------------------------------------------------------------------------- */
+/* JSON Serializer                                                            */
+/* -------------------------------------------------------------------------- */
+/**
+ * Serializes values to JSON strings and deserializes them back.
+ *
+ * Uses @zudojs/serialization's JSONSerializer for type preservation
+ * (Date, BigInt, Map, Set, Uint8Array) when configured.
+ */
+export class JsonCacheSerializer {
+    inner;
+    preserveTypes;
+    constructor(options) {
+        this.preserveTypes = options?.preserveTypes ?? false;
+        this.inner = new JSONSerializer();
+    }
+    serialize(value) {
+        return this.inner.serialize(value, {
+            preserveTypes: this.preserveTypes,
+        });
+    }
+    deserialize(value) {
+        return this.inner.deserialize(value, {
+            preserveTypes: this.preserveTypes,
+        });
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Raw Serializer                                                             */
+/* -------------------------------------------------------------------------- */
+/**
+ * Pass-through serializer for values that are already in
+ * their storable form (e.g., strings, numbers).
+ */
+export class RawCacheSerializer {
+    serialize(value) {
+        return value;
+    }
+    deserialize(value) {
+        return value;
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Default Singleton                                                          */
+/* -------------------------------------------------------------------------- */
+/** Default JSON serializer instance. */
+export const defaultSerializer = new JsonCacheSerializer();
+/** Default raw (pass-through) serializer instance. */
+export const rawSerializer = new RawCacheSerializer();
+/**
+ * Returns the appropriate serializer for the given value type.
+ *
+ * - Objects, arrays, dates → JSON serializer
+ * - Strings, numbers, booleans, null → raw serializer
+ */
+export function getSerializer(value) {
+    if (value === null ||
+        value === undefined ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return rawSerializer;
+    }
+    return defaultSerializer;
+}
+//# sourceMappingURL=serializer.js.map

package/dist/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IACb,KAAK,CAAiB;IACtB,aAAa,CAAU;IAExC,YAAY,OAA8C;QACxD,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,KAAK,CAAC;QACrD,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,EAAE,CAAC;IACpC,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE;YACjC,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,KAAa;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE;YACnC,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,CAAC;CACF;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAC7B,SAAS,CAAC,KAAc;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW,CAAC,KAAc;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,wCAAwC;AACxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAE3D,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,kBAAkB,EAAE,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAc;IAEd,IACE,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,SAAS;QACnB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @zudojs/cache — Store
+ * Wraps a CacheAdapter with metrics, events, middleware, and error handling.
+ */
+import type { CacheAdapter, CacheClearOptions, CacheClearResult, CacheDeleteOptions, CacheDeleteResult, CacheEvent, CacheEventHandler, CacheEventSubscription, CacheGetManyOptions, CacheGetOptions, CacheGetResult, CacheHasOptions, CacheKeysOptions, CacheMiddleware, CacheMetrics, CacheSetManyOptions, CacheSetOptions, CacheSetResult, CacheStore } from "./types.js";
+export declare class DefaultCacheStore implements CacheStore {
+    readonly name: string;
+    private readonly adapter;
+    private readonly metrics?;
+    private readonly middlewares;
+    private readonly handlers;
+    constructor(options: {
+        readonly adapter: CacheAdapter;
+        readonly metrics?: CacheMetrics;
+        readonly middlewares?: readonly CacheMiddleware[];
+    });
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    get<TValue = unknown>(key: string, options?: CacheGetOptions): Promise<CacheGetResult<TValue>>;
+    has(key: string, options?: CacheHasOptions): Promise<boolean>;
+    keys(options?: CacheKeysOptions): Promise<readonly string[]>;
+    set<TValue = unknown>(key: string, value: TValue, options?: CacheSetOptions): Promise<CacheSetResult>;
+    delete(key: string, options?: CacheDeleteOptions): Promise<CacheDeleteResult>;
+    clear(options?: CacheClearOptions): Promise<CacheClearResult>;
+    getMany<TValue = unknown>(keys: readonly string[], options?: CacheGetManyOptions): Promise<ReadonlyMap<string, CacheGetResult<TValue>>>;
+    setMany<TValue = unknown>(entries: ReadonlyMap<string, TValue>, options?: CacheSetManyOptions): Promise<readonly CacheSetResult[]>;
+    deleteMany(keys: readonly string[], options?: {
+        readonly namespace?: string;
+    }): Promise<{
+        readonly deleted: number;
+        readonly keys: readonly string[];
+    }>;
+    subscribe(eventType: CacheEvent["type"] | "*", handler: CacheEventHandler): CacheEventSubscription;
+    private emit;
+    private executeWithMiddleware;
+}
+export declare function createCacheStore(options: {
+    readonly adapter: CacheAdapter;
+    readonly metrics?: CacheMetrics;
+    readonly middlewares?: readonly CacheMiddleware[];
+}): DefaultCacheStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/store.js

@@ -0,0 +1,180 @@
+/**
+ * @zudojs/cache — Store
+ * Wraps a CacheAdapter with metrics, events, middleware, and error handling.
+ */
+import { CacheError, CacheOperation } from "./errors.js";
+export class DefaultCacheStore {
+    name;
+    adapter;
+    metrics;
+    middlewares = [];
+    handlers = new Map();
+    constructor(options) {
+        this.adapter = options.adapter;
+        this.name = options.adapter.name;
+        this.metrics = options.metrics;
+        if (options.middlewares)
+            this.middlewares = [...options.middlewares];
+    }
+    connect() {
+        return this.adapter.connect?.() ?? Promise.resolve();
+    }
+    disconnect() {
+        return this.adapter.disconnect?.() ?? Promise.resolve();
+    }
+    async get(key, options) {
+        return this.executeWithMiddleware("get", key, () => this.adapter.get(key, options));
+    }
+    async has(key, options) {
+        return this.executeWithMiddleware("has", key, () => this.adapter.has(key, options));
+    }
+    async keys(options) {
+        return this.executeWithMiddleware("keys", "*", () => this.adapter.keys?.(options) ?? Promise.resolve([]));
+    }
+    async set(key, value, options) {
+        return this.executeWithMiddleware("set", key, () => this.adapter.set(key, value, options));
+    }
+    async delete(key, options) {
+        return this.executeWithMiddleware("delete", key, () => this.adapter.delete(key, options));
+    }
+    async clear(options) {
+        return this.executeWithMiddleware("clear", "*", () => this.adapter.clear(options));
+    }
+    async getMany(keys, options) {
+        if (this.adapter.getMany)
+            return this.adapter.getMany(keys, options);
+        const results = new Map();
+        for (const key of keys)
+            results.set(key, await this.get(key, options));
+        return results;
+    }
+    async setMany(entries, options) {
+        if (this.adapter.setMany)
+            return this.adapter.setMany(entries, options);
+        const results = [];
+        for (const [key, value] of entries)
+            results.push(await this.set(key, value, options));
+        return results;
+    }
+    async deleteMany(keys, options) {
+        if (this.adapter.deleteMany)
+            return this.adapter.deleteMany(keys, options);
+        let deleted = 0;
+        const deletedKeys = [];
+        for (const key of keys) {
+            const result = await this.delete(key, options);
+            if (result.deleted) {
+                deleted++;
+                deletedKeys.push(key);
+            }
+        }
+        return { deleted, keys: deletedKeys };
+    }
+    subscribe(eventType, handler) {
+        if (!this.handlers.has(eventType))
+            this.handlers.set(eventType, new Set());
+        this.handlers.get(eventType).add(handler);
+        return {
+            unsubscribe: () => {
+                this.handlers.get(eventType)?.delete(handler);
+            },
+        };
+    }
+    emit(event) {
+        const specific = this.handlers.get(event.type);
+        const wildcard = this.handlers.get("*");
+        const all = new Set([
+            ...(specific ?? []),
+            ...(wildcard ?? []),
+        ]);
+        for (const handler of all) {
+            try {
+                handler(event);
+            }
+            catch {
+                /* swallow */
+            }
+        }
+    }
+    async executeWithMiddleware(operation, key, fn) {
+        const context = {
+            key,
+            operation,
+            startedAt: new Date(),
+        };
+        const execute = async () => {
+            const start = performance.now();
+            try {
+                const result = await fn();
+                const latencyMs = performance.now() - start;
+                this.metrics?.observeLatency(operation, latencyMs);
+                if (operation === "get") {
+                    const hitResult = result;
+                    if (hitResult.hit) {
+                        this.metrics?.incrementHit(key);
+                        this.emit({
+                            type: "cache.hit",
+                            key,
+                            occurredAt: new Date(),
+                            latencyMs,
+                        });
+                    }
+                    else {
+                        this.metrics?.incrementMiss(key);
+                        this.emit({
+                            type: "cache.miss",
+                            key,
+                            occurredAt: new Date(),
+                            latencyMs,
+                        });
+                    }
+                }
+                else if (operation === "set") {
+                    this.metrics?.incrementSet(key);
+                    this.emit({ type: "cache.set", key, occurredAt: new Date() });
+                }
+                else if (operation === "delete") {
+                    this.metrics?.incrementDelete(key);
+                    this.emit({
+                        type: "cache.delete",
+                        key,
+                        occurredAt: new Date(),
+                        deleted: true,
+                    });
+                }
+                else if (operation === "clear") {
+                    this.emit({
+                        type: "cache.clear",
+                        occurredAt: new Date(),
+                        cleared: 0,
+                    });
+                }
+                return result;
+            }
+            catch (error) {
+                this.metrics?.incrementError(key);
+                this.emit({ type: "cache.error", key, occurredAt: new Date(), error });
+                throw new CacheError(`Cache ${operation} failed for key "${key}".`, {
+                    cause: error,
+                    operation,
+                    key,
+                });
+            }
+        };
+        let index = 0;
+        const chain = async () => {
+            if (index >= this.middlewares.length)
+                return execute();
+            const middleware = this.middlewares[index];
+            index++;
+            if (middleware === undefined)
+                return execute();
+            return middleware(context, chain);
+        };
+        return chain();
+    }
+}
+export function createCacheStore(options) {
+    return new DefaultCacheStore(options);
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/dist/tags.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @zudojs/cache — Tags
+ *
+ * Tag-based cache invalidation registry. Maps tags to cache keys,
+ * allowing bulk invalidation of related entries.
+ */
+import type { CacheClearResult, CacheKey, CacheTag, CacheTagOptions, CacheTagStore } from "./types.js";
+/**
+ * In-memory implementation of `CacheTagStore`.
+ *
+ * Maintains a bidirectional mapping between tags and cache keys.
+ * For production use, this should be backed by a persistent store
+ * (e.g., Redis SETs).
+ */
+export declare class InMemoryTagStore implements CacheTagStore {
+    /** Tag → Set of keys */
+    private readonly tagToKeys;
+    /** Key → Set of tags */
+    private readonly keyToTags;
+    add(key: CacheKey, tags: readonly CacheTag[], _options?: CacheTagOptions): Promise<void>;
+    remove(key: CacheKey, tags: readonly CacheTag[], _options?: CacheTagOptions): Promise<void>;
+    getKeys(tag: CacheTag, _options?: CacheTagOptions): Promise<readonly CacheKey[]>;
+    invalidate(tag: CacheTag, _options?: CacheTagOptions): Promise<CacheClearResult>;
+    /** Returns all registered tags. */
+    tags(): readonly CacheTag[];
+    /** Returns the number of keys mapped to a tag. */
+    count(tag: CacheTag): number;
+    /** Returns all tags for a given key. */
+    tagsForKey(key: CacheKey): readonly CacheTag[];
+    /** Clears all tag mappings. */
+    clear(): void;
+}
+/**
+ * Creates an in-memory tag store.
+ */
+export declare function createTagStore(): InMemoryTagStore;
+//# sourceMappingURL=tags.d.ts.map

package/dist/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,QAAQ,EAER,QAAQ,EACR,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAMpB;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACpD,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAEhE,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAI1D,GAAG,CACP,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAcf;IAIK,MAAM,CACV,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAQf;IAIK,OAAO,CACX,GAAG,EAAE,QAAQ,EACb,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAE9B;IAIK,UAAU,CACd,GAAG,EAAE,QAAQ,EACb,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAkB3B;IAID,mCAAmC;IACnC,IAAI,IAAI,SAAS,QAAQ,EAAE,CAE1B;IAED,kDAAkD;IAClD,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAE3B;IAED,wCAAwC;IACxC,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,QAAQ,EAAE,CAE7C;IAED,+BAA+B;IAC/B,KAAK,IAAI,IAAI,CAGZ;CACF;AAMD;;GAEG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAEjD"}

package/dist/tags.js

@@ -0,0 +1,93 @@
+/**
+ * @zudojs/cache — Tags
+ *
+ * Tag-based cache invalidation registry. Maps tags to cache keys,
+ * allowing bulk invalidation of related entries.
+ */
+/* -------------------------------------------------------------------------- */
+/* In-Memory Tag Store                                                        */
+/* -------------------------------------------------------------------------- */
+/**
+ * In-memory implementation of `CacheTagStore`.
+ *
+ * Maintains a bidirectional mapping between tags and cache keys.
+ * For production use, this should be backed by a persistent store
+ * (e.g., Redis SETs).
+ */
+export class InMemoryTagStore {
+    /** Tag → Set of keys */
+    tagToKeys = new Map();
+    /** Key → Set of tags */
+    keyToTags = new Map();
+    /* ---- Add Tags ---- */
+    async add(key, tags, _options) {
+        for (const tag of tags) {
+            if (!this.tagToKeys.has(tag)) {
+                this.tagToKeys.set(tag, new Set());
+            }
+            this.tagToKeys.get(tag).add(key);
+        }
+        if (!this.keyToTags.has(key)) {
+            this.keyToTags.set(key, new Set());
+        }
+        for (const tag of tags) {
+            this.keyToTags.get(key).add(tag);
+        }
+    }
+    /* ---- Remove Tags ---- */
+    async remove(key, tags, _options) {
+        for (const tag of tags) {
+            this.tagToKeys.get(tag)?.delete(key);
+        }
+        for (const tag of tags) {
+            this.keyToTags.get(key)?.delete(tag);
+        }
+    }
+    /* ---- Get Keys by Tag ---- */
+    async getKeys(tag, _options) {
+        return [...(this.tagToKeys.get(tag) ?? [])];
+    }
+    /* ---- Invalidate by Tag ---- */
+    async invalidate(tag, _options) {
+        const keys = this.tagToKeys.get(tag);
+        if (!keys) {
+            return { cleared: 0 };
+        }
+        const count = keys.size;
+        // Remove reverse mappings
+        for (const key of keys) {
+            this.keyToTags.get(key)?.delete(tag);
+        }
+        // Clear the tag
+        this.tagToKeys.delete(tag);
+        return { cleared: count };
+    }
+    /* ---- Utility ---- */
+    /** Returns all registered tags. */
+    tags() {
+        return [...this.tagToKeys.keys()];
+    }
+    /** Returns the number of keys mapped to a tag. */
+    count(tag) {
+        return this.tagToKeys.get(tag)?.size ?? 0;
+    }
+    /** Returns all tags for a given key. */
+    tagsForKey(key) {
+        return [...(this.keyToTags.get(key) ?? [])];
+    }
+    /** Clears all tag mappings. */
+    clear() {
+        this.tagToKeys.clear();
+        this.keyToTags.clear();
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* Factory                                                                    */
+/* -------------------------------------------------------------------------- */
+/**
+ * Creates an in-memory tag store.
+ */
+export function createTagStore() {
+    return new InMemoryTagStore();
+}
+//# sourceMappingURL=tags.js.map

package/dist/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../src/tags.ts"],"names":[],"mappings":"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"}

package/dist/types-adapter.d.ts

@@ -0,0 +1,24 @@
+import type { CacheKey } from "./types-keys.js";
+import type { CacheTTL } from "./types-values.js";
+import type { CacheClearOptions, CacheDeleteManyOptions, CacheDeleteOptions, CacheGetManyOptions, CacheGetOptions, CacheHasOptions, CacheKeysOptions, CacheSetManyOptions, CacheSetOptions } from "./types-operations.js";
+import type { CacheClearResult, CacheDeleteManyResult, CacheDeleteResult, CacheGetResult, CacheSetResult } from "./types-results.js";
+export interface CacheAdapter {
+    readonly name: string;
+    connect?(): Promise<void>;
+    disconnect?(): Promise<void>;
+    get<TValue = unknown>(key: CacheKey, options?: CacheGetOptions): Promise<CacheGetResult<TValue>>;
+    set<TValue = unknown>(key: CacheKey, value: TValue, options?: CacheSetOptions): Promise<CacheSetResult>;
+    delete(key: CacheKey, options?: CacheDeleteOptions): Promise<CacheDeleteResult>;
+    has(key: CacheKey, options?: CacheHasOptions): Promise<boolean>;
+    clear(options?: CacheClearOptions): Promise<CacheClearResult>;
+    keys?(options?: CacheKeysOptions): Promise<readonly CacheKey[]>;
+    getMany?<TValue = unknown>(keys: readonly CacheKey[], options?: CacheGetManyOptions): Promise<ReadonlyMap<CacheKey, CacheGetResult<TValue>>>;
+    setMany?<TValue = unknown>(entries: ReadonlyMap<CacheKey, TValue>, options?: CacheSetManyOptions): Promise<readonly CacheSetResult[]>;
+    deleteMany?(keys: readonly CacheKey[], options?: CacheDeleteManyOptions): Promise<CacheDeleteManyResult>;
+    ttl?(key: CacheKey, options?: CacheGetOptions): Promise<number | null>;
+    expire?(key: CacheKey, ttl: CacheTTL, options?: CacheGetOptions): Promise<boolean>;
+}
+export interface CacheStore extends CacheAdapter {
+}
+export type CacheAdapterFactory<TOptions = unknown> = (options: TOptions) => CacheAdapter | Promise<CacheAdapter>;
+//# sourceMappingURL=types-adapter.d.ts.map

package/dist/types-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-adapter.d.ts","sourceRoot":"","sources":["../src/types-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,GAAG,CAAC,MAAM,GAAG,OAAO,EAClB,GAAG,EAAE,QAAQ,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACnC,GAAG,CAAC,MAAM,GAAG,OAAO,EAClB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3B,MAAM,CACJ,GAAG,EAAE,QAAQ,EACb,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,KAAK,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9D,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,CAAC,MAAM,GAAG,OAAO,EACvB,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,CAAC,MAAM,GAAG,OAAO,EACvB,OAAO,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,EACtC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IACtC,UAAU,CAAC,CACT,IAAI,EAAE,SAAS,QAAQ,EAAE,EACzB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClC,GAAG,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvE,MAAM,CAAC,CACL,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,QAAQ,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;CAAG;AAEnD,MAAM,MAAM,mBAAmB,CAAC,QAAQ,GAAG,OAAO,IAAI,CACpD,OAAO,EAAE,QAAQ,KACd,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC"}

package/dist/types-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types-adapter.js.map

package/dist/types-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-adapter.js","sourceRoot":"","sources":["../src/types-adapter.ts"],"names":[],"mappings":""}

package/dist/types-config.d.ts

@@ -0,0 +1,21 @@
+import type { CacheNamespace } from "./types-keys.js";
+import type { CacheTTL } from "./types-values.js";
+import type { CacheOperation } from "./types-metrics.js";
+export interface CacheConfig {
+    readonly enabled?: boolean;
+    readonly defaultTtl?: CacheTTL;
+    readonly namespace?: CacheNamespace;
+    readonly prefix?: string;
+    readonly separator?: string;
+    readonly failSilently?: boolean;
+    readonly collectStats?: boolean;
+}
+export type CacheErrorCode = "CACHE_DISABLED" | "CACHE_CONNECTION_FAILED" | "CACHE_TIMEOUT" | "CACHE_SERIALIZATION_FAILED" | "CACHE_DESERIALIZATION_FAILED" | "CACHE_OPERATION_FAILED" | "CACHE_INVALID_KEY" | "CACHE_INVALID_TTL" | "CACHE_ADAPTER_NOT_CONFIGURED" | "CACHE_NOT_SUPPORTED";
+export interface CacheErrorOptions {
+    readonly cause?: unknown;
+    readonly details?: Readonly<Record<string, unknown>>;
+    readonly operation?: CacheOperation;
+    readonly key?: CacheKey;
+}
+import type { CacheKey } from "./types-keys.js";
+//# sourceMappingURL=types-config.d.ts.map

package/dist/types-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-config.d.ts","sourceRoot":"","sources":["../src/types-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,yBAAyB,GACzB,eAAe,GACf,4BAA4B,GAC5B,8BAA8B,GAC9B,wBAAwB,GACxB,mBAAmB,GACnB,mBAAmB,GACnB,8BAA8B,GAC9B,qBAAqB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;CACzB;AAED,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types-config.js.map

package/dist/types-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-config.js","sourceRoot":"","sources":["../src/types-config.ts"],"names":[],"mappings":""}

package/dist/types-events.d.ts

@@ -0,0 +1,38 @@
+import type { CacheKey } from "./types-keys.js";
+import type { CacheTTL } from "./types-values.js";
+export type CacheEventType = "cache.hit" | "cache.miss" | "cache.set" | "cache.delete" | "cache.clear" | "cache.error";
+export interface BaseCacheEvent {
+    readonly type: CacheEventType;
+    readonly key?: CacheKey;
+    readonly occurredAt: Date;
+}
+export interface CacheHitEvent extends BaseCacheEvent {
+    readonly type: "cache.hit";
+    readonly latencyMs?: number;
+}
+export interface CacheMissEvent extends BaseCacheEvent {
+    readonly type: "cache.miss";
+    readonly latencyMs?: number;
+}
+export interface CacheSetEvent extends BaseCacheEvent {
+    readonly type: "cache.set";
+    readonly ttl?: CacheTTL;
+}
+export interface CacheDeleteEvent extends BaseCacheEvent {
+    readonly type: "cache.delete";
+    readonly deleted: boolean;
+}
+export interface CacheClearEvent extends BaseCacheEvent {
+    readonly type: "cache.clear";
+    readonly cleared: number;
+}
+export interface CacheErrorEvent extends BaseCacheEvent {
+    readonly type: "cache.error";
+    readonly error: unknown;
+}
+export type CacheEvent = CacheHitEvent | CacheMissEvent | CacheSetEvent | CacheDeleteEvent | CacheClearEvent | CacheErrorEvent;
+export type CacheEventHandler<TEvent extends CacheEvent = CacheEvent> = (event: TEvent) => void | Promise<void>;
+export interface CacheEventSubscription {
+    readonly unsubscribe: () => void;
+}
+//# sourceMappingURL=types-events.d.ts.map

package/dist/types-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-events.d.ts","sourceRoot":"","sources":["../src/types-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,YAAY,GACZ,WAAW,GACX,cAAc,GACd,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,eAAe,CAAC;AAEpB,MAAM,MAAM,iBAAiB,CAAC,MAAM,SAAS,UAAU,GAAG,UAAU,IAAI,CACtE,KAAK,EAAE,MAAM,KACV,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;CAClC"}

package/dist/types-events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types-events.js.map

package/dist/types-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-events.js","sourceRoot":"","sources":["../src/types-events.ts"],"names":[],"mappings":""}

package/dist/types-health.d.ts

@@ -0,0 +1,20 @@
+export interface CacheHealth {
+    readonly healthy: boolean;
+    readonly adapter: string;
+    readonly latencyMs?: number;
+    readonly checkedAt: Date;
+    readonly error?: string;
+}
+export interface CacheHealthChecker {
+    healthCheck(): Promise<CacheHealth>;
+}
+export interface CacheSerializer<TValue = unknown, TSerialized = unknown> {
+    serialize(value: TValue): TSerialized;
+    deserialize(value: TSerialized): TValue;
+}
+export interface CacheSerializationOptions {
+    readonly serializer?: CacheSerializer;
+    readonly compress?: boolean;
+    readonly encryption?: boolean;
+}
+//# sourceMappingURL=types-health.d.ts.map

package/dist/types-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-health.d.ts","sourceRoot":"","sources":["../src/types-health.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,OAAO,EAAE,WAAW,GAAG,OAAO;IACtE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IACtC,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/dist/types-health.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types-health.js.map

package/dist/types-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-health.js","sourceRoot":"","sources":["../src/types-health.ts"],"names":[],"mappings":""}

package/dist/types-keys.d.ts

@@ -0,0 +1,15 @@
+export type CacheKey = string;
+export type CacheNamespace = string;
+export interface CacheKeyParts {
+    readonly namespace?: CacheNamespace;
+    readonly key: CacheKey;
+}
+export interface CacheKeyOptions {
+    readonly namespace?: CacheNamespace;
+    readonly prefix?: string;
+    readonly separator?: string;
+}
+export interface CacheKeyBuilder {
+    build(key: string, options?: CacheKeyOptions): CacheKey;
+}
+//# sourceMappingURL=types-keys.d.ts.map

package/dist/types-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-keys.d.ts","sourceRoot":"","sources":["../src/types-keys.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAC9B,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAAC;CACzD"}