@warlock.js/cache 4.0.161 → 4.0.163

package/esm/drivers/null-cache-driver.d.ts

@@ -0,0 +1,58 @@
+import type { GenericObject } from "@mongez/reinforcements";
+import type { CacheDriver, CacheKey, NullCacheDriverOptions } from "../types";
+import { BaseCacheDriver } from "./base-cache-driver";
+export declare class NullCacheDriver extends BaseCacheDriver<NullCacheDriver, NullCacheDriverOptions> implements CacheDriver<NullCacheDriver, NullCacheDriverOptions> {
+    /**
+     * Options list
+     */
+    options: GenericObject;
+    /**
+     * {@inheritdoc}
+     */
+    name: string;
+    /**
+     * Cached data
+     */
+    data: GenericObject;
+    /**
+     * {@inheritdoc}
+     */
+    get client(): this;
+    /**
+     * Constructor
+     */
+    constructor(options?: GenericObject);
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options: GenericObject): this;
+    /**
+     * {@inheritdoc}
+     */
+    parseKey(_key: CacheKey): string;
+    /**
+     * {@inheritdoc}
+     */
+    removeNamespace(namespace: string): Promise<this>;
+    /**
+     * {@inheritdoc}
+     */
+    set(key: CacheKey, _value: any): Promise<this>;
+    /**
+     * {@inheritdoc}
+     */
+    get(key: CacheKey): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    remove(key: CacheKey): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    flush(): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    connect(): Promise<void>;
+}
+//# sourceMappingURL=null-cache-driver.d.ts.map

package/esm/drivers/null-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-cache-driver.d.ts","sourceRoot":"","sources":["../../src/drivers/null-cache-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qBAAa,eACX,SAAQ,eAAe,CAAC,eAAe,EAAE,sBAAsB,CAC/D,YAAW,WAAW,CAAC,eAAe,EAAE,sBAAsB,CAAC;IAE/D;;OAEG;IACI,OAAO,EAAE,aAAa,CAAM;IAEnC;;OAEG;IACI,IAAI,SAAU;IAErB;;OAEG;IACI,IAAI,EAAE,aAAa,CAAM;IAEhC;;OAEG;IACH,IAAW,MAAM,SAEhB;IAED;;OAEG;gBACgB,OAAO,GAAE,aAAkB;IAK9C;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,aAAa;IAKxC;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,QAAQ;IAI9B;;OAEG;IACU,eAAe,CAAC,SAAS,EAAE,MAAM;IAQ9C;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IAQ3C;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,QAAQ;IAQ9B;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,QAAQ;IAMjC;;OAEG;IACU,KAAK;IAMlB;;OAEG;IACU,OAAO;CAGrB"}

package/esm/drivers/null-cache-driver.js

@@ -0,0 +1,84 @@
+import {log}from'@warlock.js/logger';import {BaseCacheDriver}from'./base-cache-driver.js';class NullCacheDriver extends BaseCacheDriver {
+    /**
+     * Options list
+     */
+    options = {};
+    /**
+     * {@inheritdoc}
+     */
+    name = "null";
+    /**
+     * Cached data
+     */
+    data = {};
+    /**
+     * {@inheritdoc}
+     */
+    get client() {
+        return this;
+    }
+    /**
+     * Constructor
+     */
+    constructor(options = {}) {
+        super();
+        this.setOptions(options);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options) {
+        this.options = options;
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    parseKey(_key) {
+        return "";
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async removeNamespace(namespace) {
+        log.info("cache", "clearing namespace", namespace);
+        log.success("cache", "namespace cleared", namespace);
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async set(key, _value) {
+        log.info("cache", "setting key", key);
+        log.success("cache", "key set", key);
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async get(key) {
+        log.info("cache", "fetching", key);
+        log.success("cache", "fetched", key);
+        return null;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async remove(key) {
+        log.info("cache", "removing", key);
+        log.success("cache", "removed", key);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async flush() {
+        log.info("cache", "flushing", "all");
+        log.success("cache", "flushed", "all");
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async connect() {
+        log.success("cache", "connected", "Connected to null cache driver");
+    }
+}export{NullCacheDriver};//# sourceMappingURL=null-cache-driver.js.map

package/esm/drivers/null-cache-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-cache-driver.js","sources":["../../src/drivers/null-cache-driver.ts"],"sourcesContent":[null],"names":[],"mappings":"0FAKM,MAAO,eACX,SAAQ,eAAwD,CAAA;AAGhE;;AAEG;IACI,OAAO,GAAkB,EAAE,CAAC;AAEnC;;AAEG;IACI,IAAI,GAAG,MAAM,CAAC;AAErB;;AAEG;IACI,IAAI,GAAkB,EAAE,CAAC;AAEhC;;AAEG;AACH,IAAA,IAAW,MAAM,GAAA;AACf,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;AAEG;AACH,IAAA,WAAA,CAAmB,UAAyB,EAAE,EAAA;AAC5C,QAAA,KAAK,EAAE,CAAC;AACR,QAAA,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;KAC1B;AAED;;AAEG;AACI,IAAA,UAAU,CAAC,OAAsB,EAAA;AACtC,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;AACvB,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;AAEG;AACI,IAAA,QAAQ,CAAC,IAAc,EAAA;AAC5B,QAAA,OAAO,EAAE,CAAC;KACX;AAED;;AAEG;IACI,MAAM,eAAe,CAAC,SAAiB,EAAA;QAC5C,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,SAAS,CAAC,CAAC;QAEnD,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAAC;AAErD,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;AAEG;AACI,IAAA,MAAM,GAAG,CAAC,GAAa,EAAE,MAAW,EAAA;QACzC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAEtC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;AAErC,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;AAEG;IACI,MAAM,GAAG,CAAC,GAAa,EAAA;QAC5B,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAEnC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;AAErC,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;AAEG;IACI,MAAM,MAAM,CAAC,GAAa,EAAA;QAC/B,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QAEnC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;KACtC;AAED;;AAEG;AACI,IAAA,MAAM,KAAK,GAAA;QAChB,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAErC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;KACxC;AAED;;AAEG;AACI,IAAA,MAAM,OAAO,GAAA;QAClB,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,gCAAgC,CAAC,CAAC;KACrE;AACF"}

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

@@ -0,0 +1,57 @@
+import type { createClient } from "redis";
+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}
+     */
+    removeNamespace(namespace: string): Promise<any>;
+    /**
+     * {@inheritDoc}
+     */
+    set(key: CacheKey, value: any, ttl?: number): Promise<any>;
+    /**
+     * {@inheritDoc}
+     */
+    get(key: CacheKey): Promise<any>;
+    /**
+     * {@inheritDoc}
+     */
+    remove(key: CacheKey): Promise<void>;
+    /**
+     * {@inheritDoc}
+     */
+    flush(): Promise<void>;
+    /**
+     * {@inheritDoc}
+     */
+    connect(): Promise<void>;
+    /**
+     * {@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/esm/drivers/redis-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache-driver.d.ts","sourceRoot":"","sources":["../../src/drivers/redis-cache-driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA8CtD,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;IA4CpB;;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,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAmC9E"}

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

@@ -0,0 +1,263 @@
+import {log}from'@warlock.js/logger';import {CacheConfigurationError}from'../types.js';import {BaseCacheDriver}from'./base-cache-driver.js';// ============================================================
+// Lazy-loaded Redis SDK Types
+// ============================================================
+/**
+ * Cached Redis module (loaded once, reused)
+ */
+let RedisClient;
+let isModuleExists = null;
+/**
+ * Installation instructions for Redis package
+ */
+const REDIS_INSTALL_INSTRUCTIONS = `
+Redis cache driver requires the redis package.
+Install it with:
+
+  npm install redis
+
+Or with your preferred package manager:
+
+  pnpm add redis
+  yarn add redis
+`.trim();
+/**
+ * Load Redis module
+ */
+async function loadRedis() {
+    try {
+        RedisClient = await import('redis');
+        isModuleExists = true;
+    }
+    catch {
+        isModuleExists = false;
+    }
+}
+loadRedis();
+// ============================================================
+// RedisCacheDriver Class
+// ============================================================
+class RedisCacheDriver extends BaseCacheDriver {
+    /**
+     * Cache driver name
+     */
+    name = "redis";
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options) {
+        if (!options.url && !options.host) {
+            throw new CacheConfigurationError("Redis driver requires either 'url' or 'host' option to be configured.");
+        }
+        return super.setOptions(options);
+    }
+    /**
+     * {@inheritDoc}
+     */
+    async removeNamespace(namespace) {
+        namespace = this.parseKey(namespace);
+        this.log("clearing", namespace);
+        const keys = await this.client?.keys(`${namespace}*`);
+        if (!keys || keys.length === 0) {
+            this.log("notFound", namespace);
+            return;
+        }
+        await this.client?.del(keys);
+        this.log("cleared", namespace);
+        return keys;
+    }
+    /**
+     * {@inheritDoc}
+     */
+    async set(key, value, ttl) {
+        key = this.parseKey(key);
+        this.log("caching", key);
+        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 = 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;
+        }
+        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 = 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}
+     */
+    async flush() {
+        this.log("flushing");
+        if (this.options.globalPrefix) {
+            await this.removeNamespace("");
+        }
+        else {
+            await this.client?.flushAll();
+        }
+        this.log("flushed");
+        // Emit flushed event
+        await this.emit("flushed");
+    }
+    /**
+     * {@inheritDoc}
+     */
+    async connect() {
+        if (this.clientDriver)
+            return;
+        if (!isModuleExists) {
+            throw new Error(REDIS_INSTALL_INSTRUCTIONS);
+        }
+        const options = this.options;
+        if (options && !options.url && options.host) {
+            const auth = options.password || options.username ? `${options.username}:${options.password}@` : "";
+            if (!options.url) {
+                const host = options.host || "localhost";
+                const port = options.port || 6379;
+                options.url = `redis://${auth}${host}:${port}`;
+            }
+        }
+        const clientOptions = {
+            ...options,
+            ...(this.options.clientOptions || {}),
+        };
+        this.log("connecting");
+        const { createClient } = RedisClient;
+        this.client = createClient(clientOptions);
+        this.client.on("error", (error) => {
+            this.log("error", error.message);
+        });
+        try {
+            await this.client.connect();
+            this.log("connected");
+            await this.emit("connected");
+        }
+        catch (error) {
+            log.error("cache", "redis", error);
+            await this.emit("error", { error });
+        }
+    }
+    /**
+     * {@inheritDoc}
+     */
+    async disconnect() {
+        if (!this.client)
+            return;
+        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;
+    }
+}export{RedisCacheDriver};//# sourceMappingURL=redis-cache-driver.js.map

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

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

package/esm/index.d.ts

@@ -0,0 +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/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"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/esm/index.js

@@ -0,0 +1 @@
+export{CacheManager,cache}from'./cache-manager.js';export{BaseCacheDriver}from'./drivers/base-cache-driver.js';export{FileCacheDriver}from'./drivers/file-cache-driver.js';export{LRUMemoryCacheDriver}from'./drivers/lru-memory-cache-driver.js';export{MemoryCacheDriver}from'./drivers/memory-cache-driver.js';export{MemoryExtendedCacheDriver}from'./drivers/memory-extended-cache-driver.js';export{NullCacheDriver}from'./drivers/null-cache-driver.js';export{RedisCacheDriver}from'./drivers/redis-cache-driver.js';export{TaggedCache}from'./tagged-cache.js';export{CacheConfigurationError,CacheConnectionError,CacheDriverNotInitializedError,CacheError}from'./types.js';export{CACHE_FOR,parseCacheKey}from'./utils.js';//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/esm/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/esm/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"}