@warlock.js/cache 3.0.19 → 3.0.22

package/cjs/drivers/redis-cache-driver.d.ts

@@ -1,12 +1,15 @@
-import type { GenericObject } from "@mongez/reinforcements";
 import { createClient } from "redis";
-import type { CacheDriver, RedisOptions } from "../types";
+import type { CacheDriver, CacheKey, RedisOptions } from "../types";
 import { BaseCacheDriver } from "./base-cache-driver";
 export declare class RedisCacheDriver extends BaseCacheDriver<ReturnType<typeof createClient>, RedisOptions> implements CacheDriver<ReturnType<typeof createClient>, RedisOptions> {
     /**
      * Cache driver name
      */
     name: string;
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options: RedisOptions): this;
     /**
      * {@inheritDoc}
      */
@@ -14,15 +17,15 @@ export declare class RedisCacheDriver extends BaseCacheDriver<ReturnType<typeof
     /**
      * {@inheritDoc}
      */
-    set(key: string | GenericObject, value: any, ttl?: number): Promise<any>;
+    set(key: CacheKey, value: any, ttl?: number): Promise<any>;
     /**
      * {@inheritDoc}
      */
-    get(key: string | GenericObject): Promise<any>;
+    get(key: CacheKey): Promise<any>;
     /**
      * {@inheritDoc}
      */
-    remove(key: string | GenericObject): Promise<void>;
+    remove(key: CacheKey): Promise<void>;
     /**
      * {@inheritDoc}
      */
@@ -35,5 +38,20 @@ export declare class RedisCacheDriver extends BaseCacheDriver<ReturnType<typeof
      * {@inheritDoc}
      */
     disconnect(): Promise<void>;
+    /**
+     * Atomic increment using Redis native INCRBY command
+     * {@inheritdoc}
+     */
+    increment(key: CacheKey, value?: number): Promise<number>;
+    /**
+     * Atomic decrement using Redis native DECRBY command
+     * {@inheritdoc}
+     */
+    decrement(key: CacheKey, value?: number): Promise<number>;
+    /**
+     * Set if not exists (atomic operation)
+     * Returns true if key was set, false if key already existed
+     */
+    setNX(key: CacheKey, value: any, ttl?: number): Promise<boolean>;
 }
 //# sourceMappingURL=redis-cache-driver.d.ts.map

package/cjs/drivers/redis-cache-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-cache-driver.d.ts","sourceRoot":"","sources":["../../src/drivers/redis-cache-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAa,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qBAAa,gBACX,SAAQ,eAAe,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,YAAY,CACrE,YAAW,WAAW,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,YAAY,CAAC;IAErE;;OAEG;IACI,IAAI,SAAW;IAEtB;;OAEG;IACU,eAAe,CAAC,SAAS,EAAE,MAAM;IAmB9C;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM;IAgBtE;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAiB5C;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAU/C;;OAEG;IACU,KAAK;IAYlB;;OAEG;IACU,OAAO;IAuCpB;;OAEG;IACU,UAAU;CASxB"}
+{"version":3,"file":"redis-cache-driver.d.ts","sourceRoot":"","sources":["../../src/drivers/redis-cache-driver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qBAAa,gBACX,SAAQ,eAAe,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,YAAY,CACrE,YAAW,WAAW,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,EAAE,YAAY,CAAC;IAErE;;OAEG;IACI,IAAI,SAAW;IAEtB;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,YAAY;IAUvC;;OAEG;IACU,eAAe,CAAC,SAAS,EAAE,MAAM;IAmB9C;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM;IAwBxD;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ;IA4C9B;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,QAAQ;IAajC;;OAEG;IACU,KAAK;IAelB;;OAEG;IACU,OAAO;IAyCpB;;OAEG;IACU,UAAU;IAWvB;;;OAGG;IACU,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAezE;;;OAGG;IACU,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAezE;;;OAGG;IACU,KAAK,CAChB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,GAAG,EACV,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC;CAmCpB"}

package/cjs/drivers/redis-cache-driver.js

@@ -1,13 +1,22 @@
-'use strict';var logger=require('@warlock.js/logger'),redis=require('redis'),baseCacheDriver=require('./base-cache-driver.js');class RedisCacheDriver extends baseCacheDriver.BaseCacheDriver {
+'use strict';var logger=require('@warlock.js/logger'),redis=require('redis'),types=require('../types.js'),baseCacheDriver=require('./base-cache-driver.js');class RedisCacheDriver extends baseCacheDriver.BaseCacheDriver {
     /**
      * Cache driver name
      */
     name = "redis";
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options) {
+        if (!options.url && !options.host) {
+            throw new types.CacheConfigurationError("Redis driver requires either 'url' or 'host' option to be configured.");
+        }
+        return super.setOptions(options);
+    }
     /**
      * {@inheritDoc}
      */
     async removeNamespace(namespace) {
-        namespace = await this.parseKey(namespace);
+        namespace = this.parseKey(namespace);
         this.log("clearing", namespace);
         const keys = await this.client?.keys(`${namespace}*`);
         if (!keys || keys.length === 0) {
@@ -22,36 +31,72 @@
      * {@inheritDoc}
      */
     async set(key, value, ttl) {
-        key = await this.parseKey(key);
+        key = this.parseKey(key);
         this.log("caching", key);
-        ttl = this.getExpiresAt(ttl);
-        const data = this.prepareDataForStorage(value, ttl);
-        await this.client?.set(key, JSON.stringify(data));
+        if (ttl === undefined) {
+            ttl = this.ttl;
+        }
+        // Use Redis native expiration instead of manual checking
+        if (ttl && ttl !== Infinity) {
+            await this.client?.set(key, JSON.stringify(value), { EX: ttl });
+        }
+        else {
+            await this.client?.set(key, JSON.stringify(value));
+        }
         this.log("cached", key);
+        // Emit set event
+        await this.emit("set", { key, value, ttl });
         return value;
     }
     /**
      * {@inheritDoc}
      */
     async get(key) {
-        key = await this.parseKey(key);
+        key = this.parseKey(key);
         this.log("fetching", key);
         const value = await this.client?.get(key);
         if (!value) {
             this.log("notFound", key);
+            // Emit miss event
+            await this.emit("miss", { key });
             return null;
         }
-        const data = JSON.parse(value);
-        return this.parseCachedData(key, data);
+        this.log("fetched", key);
+        // Parse and return the value directly (Redis handles expiration natively)
+        const parsedValue = JSON.parse(value);
+        // Apply cloning for immutability protection
+        if (parsedValue === null || parsedValue === undefined) {
+            // Emit hit event
+            await this.emit("hit", { key, value: parsedValue });
+            return parsedValue;
+        }
+        const type = typeof parsedValue;
+        if (type === "string" || type === "number" || type === "boolean") {
+            // Emit hit event
+            await this.emit("hit", { key, value: parsedValue });
+            return parsedValue;
+        }
+        try {
+            const clonedValue = structuredClone(parsedValue);
+            // Emit hit event
+            await this.emit("hit", { key, value: clonedValue });
+            return clonedValue;
+        }
+        catch (error) {
+            this.logError(`Failed to clone cached value for ${key}`, error);
+            throw error;
+        }
     }
     /**
      * {@inheritDoc}
      */
     async remove(key) {
-        key = await this.parseKey(key);
+        key = this.parseKey(key);
         this.log("removing", key);
         await this.client?.del(key);
         this.log("removed", key);
+        // Emit removed event
+        await this.emit("removed", { key });
     }
     /**
      * {@inheritDoc}
@@ -65,6 +110,8 @@
             await this.client?.flushAll();
         }
         this.log("flushed");
+        // Emit flushed event
+        await this.emit("flushed");
     }
     /**
      * {@inheritDoc}
@@ -95,9 +142,11 @@
         try {
             await this.client.connect();
             this.log("connected");
+            await this.emit("connected");
         }
         catch (error) {
             logger.log.error("cache", "redis", error);
+            await this.emit("error", { error });
         }
     }
     /**
@@ -109,5 +158,66 @@
         this.log("disconnecting");
         await this.client.quit();
         this.log("disconnected");
+        await this.emit("disconnected");
+    }
+    /**
+     * Atomic increment using Redis native INCRBY command
+     * {@inheritdoc}
+     */
+    async increment(key, value = 1) {
+        const parsedKey = this.parseKey(key);
+        this.log("caching", parsedKey);
+        const result = await this.client?.incrBy(parsedKey, value);
+        this.log("cached", parsedKey);
+        // Emit set event
+        await this.emit("set", { key: parsedKey, value: result, ttl: undefined });
+        return result || 0;
+    }
+    /**
+     * Atomic decrement using Redis native DECRBY command
+     * {@inheritdoc}
+     */
+    async decrement(key, value = 1) {
+        const parsedKey = this.parseKey(key);
+        this.log("caching", parsedKey);
+        const result = await this.client?.decrBy(parsedKey, value);
+        this.log("cached", parsedKey);
+        // Emit set event
+        await this.emit("set", { key: parsedKey, value: result, ttl: undefined });
+        return result || 0;
+    }
+    /**
+     * Set if not exists (atomic operation)
+     * Returns true if key was set, false if key already existed
+     */
+    async setNX(key, value, ttl) {
+        const parsedKey = this.parseKey(key);
+        this.log("caching", parsedKey);
+        if (ttl === undefined) {
+            ttl = this.ttl;
+        }
+        let result;
+        // Use Redis native SET with NX option
+        if (ttl && ttl !== Infinity) {
+            result = await this.client?.set(parsedKey, JSON.stringify(value), {
+                NX: true,
+                EX: ttl,
+            });
+        }
+        else {
+            result = await this.client?.set(parsedKey, JSON.stringify(value), {
+                NX: true,
+            });
+        }
+        const wasSet = result === "OK";
+        if (wasSet) {
+            this.log("cached", parsedKey);
+            // Emit set event
+            await this.emit("set", { key: parsedKey, value, ttl });
+        }
+        else {
+            this.log("notFound", parsedKey);
+        }
+        return wasSet;
     }
 }exports.RedisCacheDriver=RedisCacheDriver;//# sourceMappingURL=redis-cache-driver.js.map

package/cjs/drivers/redis-cache-driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"redis-cache-driver.js","sources":["../../src/drivers/redis-cache-driver.ts"],"sourcesContent":[null],"names":["BaseCacheDriver","createClient","log"],"mappings":"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"}
+{"version":3,"file":"redis-cache-driver.js","sources":["../../src/drivers/redis-cache-driver.ts"],"sourcesContent":[null],"names":["BaseCacheDriver","CacheConfigurationError","createClient","log"],"mappings":"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"}

package/cjs/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./cache-manager";
 export * from "./drivers";
+export * from "./tagged-cache";
 export * from "./types";
 export * from "./utils";
 //# sourceMappingURL=index.d.ts.map

package/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/cjs/index.js

@@ -1 +1 @@
-'use strict';var cacheManager=require('./cache-manager.js'),baseCacheDriver=require('./drivers/base-cache-driver.js'),databaseCacheDriver=require('./drivers/database-cache-driver.js'),fileCacheDriver=require('./drivers/file-cache-driver.js'),lruMemoryCacheDriver=require('./drivers/lru-memory-cache-driver.js'),memoryCacheDriver=require('./drivers/memory-cache-driver.js'),memoryExtendedCacheDriver=require('./drivers/memory-extended-cache-driver.js'),nullCacheDriver=require('./drivers/null-cache-driver.js'),redisCacheDriver=require('./drivers/redis-cache-driver.js'),utils=require('./utils.js');exports.CacheManager=cacheManager.CacheManager;exports.cache=cacheManager.cache;exports.BaseCacheDriver=baseCacheDriver.BaseCacheDriver;exports.DatabaseCacheDriver=databaseCacheDriver.DatabaseCacheDriver;exports.FileCacheDriver=fileCacheDriver.FileCacheDriver;exports.LRUMemoryCacheDriver=lruMemoryCacheDriver.LRUMemoryCacheDriver;exports.MemoryCacheDriver=memoryCacheDriver.MemoryCacheDriver;exports.MemoryExtendedCacheDriver=memoryExtendedCacheDriver.MemoryExtendedCacheDriver;exports.NullCacheDriver=nullCacheDriver.NullCacheDriver;exports.RedisCacheDriver=redisCacheDriver.RedisCacheDriver;Object.defineProperty(exports,'EXPIRES_AFTER',{enumerable:true,get:function(){return utils.EXPIRES_AFTER}});exports.parseCacheKey=utils.parseCacheKey;//# sourceMappingURL=index.js.map
+'use strict';var cacheManager=require('./cache-manager.js'),baseCacheDriver=require('./drivers/base-cache-driver.js'),fileCacheDriver=require('./drivers/file-cache-driver.js'),lruMemoryCacheDriver=require('./drivers/lru-memory-cache-driver.js'),memoryCacheDriver=require('./drivers/memory-cache-driver.js'),memoryExtendedCacheDriver=require('./drivers/memory-extended-cache-driver.js'),nullCacheDriver=require('./drivers/null-cache-driver.js'),redisCacheDriver=require('./drivers/redis-cache-driver.js'),taggedCache=require('./tagged-cache.js'),types=require('./types.js'),utils=require('./utils.js');exports.CacheManager=cacheManager.CacheManager;exports.cache=cacheManager.cache;exports.BaseCacheDriver=baseCacheDriver.BaseCacheDriver;exports.FileCacheDriver=fileCacheDriver.FileCacheDriver;exports.LRUMemoryCacheDriver=lruMemoryCacheDriver.LRUMemoryCacheDriver;exports.MemoryCacheDriver=memoryCacheDriver.MemoryCacheDriver;exports.MemoryExtendedCacheDriver=memoryExtendedCacheDriver.MemoryExtendedCacheDriver;exports.NullCacheDriver=nullCacheDriver.NullCacheDriver;exports.RedisCacheDriver=redisCacheDriver.RedisCacheDriver;exports.TaggedCache=taggedCache.TaggedCache;exports.CacheConfigurationError=types.CacheConfigurationError;exports.CacheConnectionError=types.CacheConnectionError;exports.CacheDriverNotInitializedError=types.CacheDriverNotInitializedError;exports.CacheError=types.CacheError;Object.defineProperty(exports,'CACHE_FOR',{enumerable:true,get:function(){return utils.CACHE_FOR}});exports.parseCacheKey=utils.parseCacheKey;//# sourceMappingURL=index.js.map

package/cjs/tagged-cache.d.ts

@@ -0,0 +1,77 @@
+import type { CacheDriver, CacheKey, TaggedCacheDriver } from "./types";
+/**
+ * Tagged Cache Wrapper
+ * Wraps a cache driver to automatically manage tag relationships
+ */
+export declare class TaggedCache implements TaggedCacheDriver {
+    /**
+     * The tags associated with this tagged cache instance
+     */
+    protected cacheTags: string[];
+    /**
+     * The underlying cache driver
+     */
+    protected driver: CacheDriver<any, any>;
+    /**
+     * Constructor
+     */
+    constructor(tags: string[], driver: CacheDriver<any, any>);
+    /**
+     * Get the tag key prefix for storing tag-key relationships
+     */
+    protected tagKey(tag: string): string;
+    /**
+     * Store tag-key relationship
+     */
+    protected storeTaggedKey(key: string): Promise<void>;
+    /**
+     * Get all keys associated with tags
+     */
+    protected getTaggedKeys(): Promise<Set<string>>;
+    /**
+     * {@inheritdoc}
+     */
+    set(key: CacheKey, value: any, ttl?: number): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    get(key: CacheKey): Promise<any | null>;
+    /**
+     * {@inheritdoc}
+     */
+    remove(key: CacheKey): Promise<void>;
+    /**
+     * Invalidate (clear) all keys associated with the current tags
+     */
+    invalidate(): Promise<void>;
+    /**
+     * Flush all keys associated with the current tags
+     * @deprecated Use invalidate() instead for better semantics
+     */
+    flush(): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    has(key: CacheKey): Promise<boolean>;
+    /**
+     * {@inheritdoc}
+     */
+    remember(key: CacheKey, ttl: number, callback: () => Promise<any>): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    pull(key: CacheKey): Promise<any | null>;
+    /**
+     * {@inheritdoc}
+     */
+    forever(key: CacheKey, value: any): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    increment(key: CacheKey, value?: number): Promise<number>;
+    /**
+     * {@inheritdoc}
+     */
+    decrement(key: CacheKey, value?: number): Promise<number>;
+}
+//# sourceMappingURL=tagged-cache.d.ts.map

package/cjs/tagged-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tagged-cache.d.ts","sourceRoot":"","sources":["../src/tagged-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAExE;;;GAGG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IACnD;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAExC;;OAEG;gBACgB,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;IAKhE;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;cACa,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1D;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAerD;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAYvE;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAIpD;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcxC;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD;;OAEG;IACU,QAAQ,CACnB,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAC3B,OAAO,CAAC,GAAG,CAAC;IAaf;;OAEG;IACU,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAUrD;;OAEG;IACU,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAI7D;;OAEG;IACU,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAezE;;OAEG;IACU,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAG1E"}

package/cjs/tagged-cache.js

@@ -0,0 +1,160 @@
+'use strict';/**
+ * Tagged Cache Wrapper
+ * Wraps a cache driver to automatically manage tag relationships
+ */
+class TaggedCache {
+    /**
+     * The tags associated with this tagged cache instance
+     */
+    cacheTags;
+    /**
+     * The underlying cache driver
+     */
+    driver;
+    /**
+     * Constructor
+     */
+    constructor(tags, driver) {
+        this.cacheTags = tags;
+        this.driver = driver;
+    }
+    /**
+     * Get the tag key prefix for storing tag-key relationships
+     */
+    tagKey(tag) {
+        return `cache:tags:${tag}`;
+    }
+    /**
+     * Store tag-key relationship
+     */
+    async storeTaggedKey(key) {
+        for (const tag of this.cacheTags) {
+            const tagKey = this.tagKey(tag);
+            const keys = (await this.driver.get(tagKey)) || [];
+            if (!keys.includes(key)) {
+                keys.push(key);
+                // Store tag relationships permanently
+                await this.driver.set(tagKey, keys, Infinity);
+            }
+        }
+    }
+    /**
+     * Get all keys associated with tags
+     */
+    async getTaggedKeys() {
+        const allKeys = new Set();
+        for (const tag of this.cacheTags) {
+            const tagKey = this.tagKey(tag);
+            const keys = (await this.driver.get(tagKey)) || [];
+            for (const key of keys) {
+                allKeys.add(key);
+            }
+        }
+        return allKeys;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async set(key, value, ttl) {
+        const parsedKey = this.driver.parseKey(key);
+        // Store the value
+        await this.driver.set(key, value, ttl);
+        // Store tag-key relationship
+        await this.storeTaggedKey(parsedKey);
+        return value;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async get(key) {
+        return this.driver.get(key);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async remove(key) {
+        const parsedKey = this.driver.parseKey(key);
+        // Remove the value
+        await this.driver.remove(key);
+        // Remove from all tag relationships
+        for (const tag of this.cacheTags) {
+            const tagKey = this.tagKey(tag);
+            const keys = (await this.driver.get(tagKey)) || [];
+            const updatedKeys = keys.filter((k) => k !== parsedKey);
+            await this.driver.set(tagKey, updatedKeys, Infinity);
+        }
+    }
+    /**
+     * Invalidate (clear) all keys associated with the current tags
+     */
+    async invalidate() {
+        const keysToRemove = await this.getTaggedKeys();
+        // Remove all tagged keys
+        for (const key of keysToRemove) {
+            await this.driver.remove(key);
+        }
+        // Clear tag relationship keys
+        for (const tag of this.cacheTags) {
+            await this.driver.remove(this.tagKey(tag));
+        }
+    }
+    /**
+     * Flush all keys associated with the current tags
+     * @deprecated Use invalidate() instead for better semantics
+     */
+    async flush() {
+        return this.invalidate();
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async has(key) {
+        return this.driver.has(key);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async remember(key, ttl, callback) {
+        const value = await this.get(key);
+        if (value !== null) {
+            return value;
+        }
+        const result = await callback();
+        await this.set(key, result, ttl);
+        return result;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async pull(key) {
+        const value = await this.get(key);
+        if (value !== null) {
+            await this.remove(key);
+        }
+        return value;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async forever(key, value) {
+        return this.set(key, value, Infinity);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async increment(key, value = 1) {
+        const current = (await this.get(key)) || 0;
+        if (typeof current !== "number") {
+            throw new Error(`Cannot increment non-numeric value for key: ${this.driver.parseKey(key)}`);
+        }
+        const newValue = current + value;
+        await this.set(key, newValue);
+        return newValue;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async decrement(key, value = 1) {
+        return this.increment(key, -value);
+    }
+}exports.TaggedCache=TaggedCache;//# sourceMappingURL=tagged-cache.js.map

package/cjs/tagged-cache.js.map

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