@warlock.js/cache 4.0.48 → 4.0.59

package/cjs/utils.js

@@ -0,0 +1,55 @@
+'use strict';var reinforcements=require('@mongez/reinforcements');/**
+ * Make a proper key for the cache
+ */
+function parseCacheKey(key, options = {}) {
+    if (typeof key === "object") {
+        key = JSON.stringify(key);
+    }
+    // remove any curly braces and double quotes along with []
+    key = key.replace(/[{}"[\]]/g, "").replaceAll(/[:,]/g, ".");
+    const cachePrefix = typeof options.globalPrefix === "function" ? options.globalPrefix() : options.globalPrefix;
+    return reinforcements.rtrim(String(cachePrefix ? reinforcements.rtrim(cachePrefix, ".") + "." + key : key), ".");
+}
+exports.CACHE_FOR=void 0;
+(function (CACHE_FOR) {
+    /**
+     * Cache for 30 Minutes (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["HALF_HOUR"] = 1800] = "HALF_HOUR";
+    /**
+     * Cache for 1 Hour (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["ONE_HOUR"] = 3600] = "ONE_HOUR";
+    /**
+     * Cache for 12 Hours (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["HALF_DAY"] = 43200] = "HALF_DAY";
+    /**
+     * Cache for 24 Hours (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["ONE_DAY"] = 86400] = "ONE_DAY";
+    /**
+     * Cache for 7 Days (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["ONE_WEEK"] = 604800] = "ONE_WEEK";
+    /**
+     * Cache for 15 Days (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["HALF_MONTH"] = 1296000] = "HALF_MONTH";
+    /**
+     * Cache for 30 Days (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["ONE_MONTH"] = 2592000] = "ONE_MONTH";
+    /**
+     * Cache for 60 Days (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["TWO_MONTHS"] = 5184000] = "TWO_MONTHS";
+    /**
+     * Cache for 180 Days (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["SIX_MONTHS"] = 15768000] = "SIX_MONTHS";
+    /**
+     * Cache for 365 Days (in seconds)
+     */
+    CACHE_FOR[CACHE_FOR["ONE_YEAR"] = 31536000] = "ONE_YEAR";
+})(exports.CACHE_FOR || (exports.CACHE_FOR = {}));exports.parseCacheKey=parseCacheKey;//# sourceMappingURL=utils.js.map

package/cjs/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../src/utils.ts"],"sourcesContent":[null],"names":["rtrim","CACHE_FOR"],"mappings":"kEAGA;;AAEG;SACa,aAAa,CAC3B,GAAa,EACb,UAAsD,EAAE,EAAA;AAExD,IAAA,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AAC3B,QAAA,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC3B,KAAA;;AAGD,IAAA,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAE5D,MAAM,WAAW,GACf,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAE7F,OAAOA,oBAAK,CAAC,MAAM,CAAC,WAAW,GAAGA,oBAAK,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AACrF,CAAC;AAEWC,yBAyCX;AAzCD,CAAA,UAAY,SAAS,EAAA;AACnB;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,WAAA,CAAA,GAAA,IAAA,CAAA,GAAA,WAAgB,CAAA;AAChB;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,UAAA,CAAA,GAAA,IAAA,CAAA,GAAA,UAAe,CAAA;AACf;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,UAAA,CAAA,GAAA,KAAA,CAAA,GAAA,UAAgB,CAAA;AAChB;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,SAAA,CAAA,GAAA,KAAA,CAAA,GAAA,SAAe,CAAA;AACf;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,UAAA,CAAA,GAAA,MAAA,CAAA,GAAA,UAAiB,CAAA;AACjB;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,YAAA,CAAA,GAAA,OAAA,CAAA,GAAA,YAAoB,CAAA;AACpB;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,WAAA,CAAA,GAAA,OAAA,CAAA,GAAA,WAAmB,CAAA;AACnB;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,YAAA,CAAA,GAAA,OAAA,CAAA,GAAA,YAAoB,CAAA;AACpB;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,YAAA,CAAA,GAAA,QAAA,CAAA,GAAA,YAAqB,CAAA;AACrB;;AAEG;AACH,IAAA,SAAA,CAAA,SAAA,CAAA,UAAA,CAAA,GAAA,QAAA,CAAA,GAAA,UAAmB,CAAA;AACrB,CAAC,EAzCWA,iBAAS,KAATA,iBAAS,GAyCpB,EAAA,CAAA,CAAA"}

package/esm/cache-manager.d.ts

@@ -0,0 +1,159 @@
+import type { CacheConfigurations, CacheDriver, CacheEventHandler, CacheEventType, CacheKey, DriverClass, TaggedCacheDriver } from "./types";
+export declare class CacheManager implements CacheDriver<any, any> {
+    /**
+     * Cache Driver
+     */
+    currentDriver?: CacheDriver<any, any>;
+    /**
+     * Loaded drivers
+     */
+    loadedDrivers: Record<string, CacheDriver<any, any>>;
+    /**
+     * Configurations list
+     */
+    protected configurations: CacheConfigurations;
+    /**
+     * Global event listeners
+     */
+    protected globalEventListeners: Map<CacheEventType, Set<CacheEventHandler>>;
+    /**
+     * {@inheritdoc}
+     */
+    name: string;
+    /**
+     * {@inheritdoc}
+     */
+    get client(): any;
+    /**
+     * Set the cache configurations
+     */
+    setCacheConfigurations(configurations: CacheConfigurations): void;
+    /**
+     * Use the given driver
+     */
+    use(driver: string | CacheDriver<any, any>): Promise<this>;
+    /**
+     * Ensure driver is initialized before operations
+     */
+    protected ensureDriverInitialized(): void;
+    /**
+     * {@inheritdoc}
+     */
+    get(key: CacheKey): Promise<any>;
+    /**
+     * Set a value in the cache
+     *
+     * @param key The cache key, could be an object or string
+     * @param value The value to be stored in the cache
+     * @param ttl The time to live in seconds
+     */
+    set(key: CacheKey, value: any, ttl?: number): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    remove(key: CacheKey): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    removeNamespace(namespace: string): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    flush(): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    connect(): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    parseKey(key: CacheKey): string;
+    /**
+     * {@inheritdoc}
+     */
+    get options(): any;
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options: Record<string, any>): any;
+    /**
+     * Get an instance of the cache driver
+     */
+    driver(driverName: string): Promise<CacheDriver<any, any>>;
+    /**
+     * Initialize the cache manager and pick the default driver
+     */
+    init(): Promise<void>;
+    /**
+     * Load the given cache driver name
+     */
+    load(driver: string): Promise<CacheDriver<any, any>>;
+    /**
+     * Register and bind a driver
+     */
+    registerDriver(driverName: string, driverClass: DriverClass): void;
+    /**
+     * Disconnect the cache manager
+     */
+    disconnect(): 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>;
+    /**
+     * {@inheritdoc}
+     */
+    many(keys: CacheKey[]): Promise<any[]>;
+    /**
+     * {@inheritdoc}
+     */
+    setMany(items: Record<string, any>, ttl?: number): Promise<void>;
+    /**
+     * Register a global event listener (applies to all drivers)
+     */
+    on(event: CacheEventType, handler: CacheEventHandler): this;
+    /**
+     * Remove a global event listener
+     */
+    off(event: CacheEventType, handler: CacheEventHandler): this;
+    /**
+     * Register a one-time global event listener
+     */
+    once(event: CacheEventType, handler: CacheEventHandler): this;
+    /**
+     * Attach global listeners to a driver
+     */
+    protected attachGlobalListeners(driver: CacheDriver<any, any>): void;
+    /**
+     * Set if not exists (atomic operation)
+     * Returns true if key was set, false if key already existed
+     * Note: Only supported by drivers that implement setNX (e.g., Redis)
+     */
+    setNX(key: CacheKey, value: any, ttl?: number): Promise<boolean>;
+    /**
+     * Create a tagged cache instance for the given tags
+     */
+    tags(tags: string[]): TaggedCacheDriver;
+}
+export declare const cache: CacheManager;
+//# sourceMappingURL=cache-manager.d.ts.map

package/esm/cache-manager.d.ts.map

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

package/esm/cache-manager.js

@@ -0,0 +1,312 @@
+import {CacheConfigurationError,CacheDriverNotInitializedError}from'./types.js';class CacheManager {
+    /**
+     * Cache Driver
+     */
+    currentDriver;
+    /**
+     * Loaded drivers
+     */
+    loadedDrivers = {};
+    /**
+     * Configurations list
+     */
+    configurations = {
+        drivers: {},
+        options: {},
+    };
+    /**
+     * Global event listeners
+     */
+    globalEventListeners = new Map();
+    /**
+     * {@inheritdoc}
+     */
+    name = "cacheManager";
+    /**
+     * {@inheritdoc}
+     */
+    get client() {
+        return this.currentDriver?.client;
+    }
+    /**
+     * Set the cache configurations
+     */
+    setCacheConfigurations(configurations) {
+        this.configurations.default = configurations.default;
+        this.configurations.drivers = configurations.drivers;
+        this.configurations.options = configurations.options;
+    }
+    /**
+     * Use the given driver
+     */
+    async use(driver) {
+        if (typeof driver === "string") {
+            const driverInstance = await this.load(driver);
+            if (!driverInstance) {
+                throw new CacheConfigurationError(`Cache driver ${driver} is not found, please declare it in the cache drivers in the configurations list.`);
+            }
+            driver = driverInstance;
+        }
+        // Attach global listeners to the new driver
+        this.attachGlobalListeners(driver);
+        this.currentDriver = driver;
+        return this;
+    }
+    /**
+     * Ensure driver is initialized before operations
+     */
+    ensureDriverInitialized() {
+        if (!this.currentDriver) {
+            throw new CacheDriverNotInitializedError();
+        }
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async get(key) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.get(key);
+    }
+    /**
+     * Set a value in the cache
+     *
+     * @param key The cache key, could be an object or string
+     * @param value The value to be stored in the cache
+     * @param ttl The time to live in seconds
+     */
+    async set(key, value, ttl) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.set(key, value, ttl);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async remove(key) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.remove(key);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async removeNamespace(namespace) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.removeNamespace(namespace);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async flush() {
+        this.ensureDriverInitialized();
+        return this.currentDriver.flush();
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async connect() {
+        this.ensureDriverInitialized();
+        return this.currentDriver.connect();
+    }
+    /**
+     * {@inheritdoc}
+     */
+    parseKey(key) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.parseKey(key);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    get options() {
+        this.ensureDriverInitialized();
+        return this.currentDriver.options;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.setOptions(options || {});
+    }
+    /**
+     * Get an instance of the cache driver
+     */
+    async driver(driverName) {
+        return this.loadedDrivers[driverName] || (await this.load(driverName));
+    }
+    /**
+     * Initialize the cache manager and pick the default driver
+     */
+    async init() {
+        const defaultCacheDriverName = this.configurations.default;
+        if (!defaultCacheDriverName) {
+            return;
+        }
+        const driver = await this.driver(defaultCacheDriverName);
+        await this.use(driver);
+    }
+    /**
+     * Load the given cache driver name
+     */
+    async load(driver) {
+        if (this.loadedDrivers[driver])
+            return this.loadedDrivers[driver];
+        const Driver = this.configurations.drivers[driver];
+        if (!Driver) {
+            throw new CacheConfigurationError(`Cache driver ${driver} is not found, please declare it in the cache drivers in the configurations list.`);
+        }
+        const driverInstance = new Driver();
+        driverInstance.setOptions(this.configurations.options[driver] || {});
+        await driverInstance.connect();
+        // Attach global listeners to newly loaded driver
+        this.attachGlobalListeners(driverInstance);
+        this.loadedDrivers[driver] = driverInstance;
+        return driverInstance;
+    }
+    /**
+     * Register and bind a driver
+     */
+    registerDriver(driverName, driverClass) {
+        this.configurations.drivers[driverName] =
+            driverClass;
+    }
+    /**
+     * Disconnect the cache manager
+     */
+    async disconnect() {
+        if (this.currentDriver) {
+            await this.currentDriver.disconnect();
+        }
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async has(key) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.has(key);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async remember(key, ttl, callback) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.remember(key, ttl, callback);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async pull(key) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.pull(key);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async forever(key, value) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.forever(key, value);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async increment(key, value) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.increment(key, value);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async decrement(key, value) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.decrement(key, value);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async many(keys) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.many(keys);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async setMany(items, ttl) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.setMany(items, ttl);
+    }
+    /**
+     * Register a global event listener (applies to all drivers)
+     */
+    on(event, handler) {
+        if (!this.globalEventListeners.has(event)) {
+            this.globalEventListeners.set(event, new Set());
+        }
+        this.globalEventListeners.get(event).add(handler);
+        // Also attach to current driver if exists
+        if (this.currentDriver) {
+            this.currentDriver.on(event, handler);
+        }
+        // Attach to all loaded drivers
+        for (const driver of Object.values(this.loadedDrivers)) {
+            driver.on(event, handler);
+        }
+        return this;
+    }
+    /**
+     * Remove a global event listener
+     */
+    off(event, handler) {
+        const handlers = this.globalEventListeners.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+        }
+        // Also remove from current driver
+        if (this.currentDriver) {
+            this.currentDriver.off(event, handler);
+        }
+        // Remove from all loaded drivers
+        for (const driver of Object.values(this.loadedDrivers)) {
+            driver.off(event, handler);
+        }
+        return this;
+    }
+    /**
+     * Register a one-time global event listener
+     */
+    once(event, handler) {
+        const onceHandler = async (data) => {
+            await handler(data);
+            this.off(event, onceHandler);
+        };
+        return this.on(event, onceHandler);
+    }
+    /**
+     * Attach global listeners to a driver
+     */
+    attachGlobalListeners(driver) {
+        for (const [event, handlers] of this.globalEventListeners) {
+            for (const handler of handlers) {
+                driver.on(event, handler);
+            }
+        }
+    }
+    /**
+     * Set if not exists (atomic operation)
+     * Returns true if key was set, false if key already existed
+     * Note: Only supported by drivers that implement setNX (e.g., Redis)
+     */
+    async setNX(key, value, ttl) {
+        this.ensureDriverInitialized();
+        if (!this.currentDriver.setNX) {
+            throw new Error(`setNX is not supported by the current cache driver: ${this.currentDriver.name}`);
+        }
+        return this.currentDriver.setNX(key, value, ttl);
+    }
+    /**
+     * Create a tagged cache instance for the given tags
+     */
+    tags(tags) {
+        this.ensureDriverInitialized();
+        return this.currentDriver.tags(tags);
+    }
+}
+const cache = new CacheManager();export{CacheManager,cache};//# sourceMappingURL=cache-manager.js.map

package/esm/cache-manager.js.map

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

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

@@ -0,0 +1,144 @@
+import type { CacheData, CacheDriver, CacheEventData, CacheEventHandler, CacheEventType, CacheKey, CacheOperationType } from "../types";
+export declare abstract class BaseCacheDriver<ClientType, Options extends Record<string, any>> implements CacheDriver<ClientType, Options> {
+    /**
+     * CLient driver
+     */
+    protected clientDriver: ClientType;
+    /**
+     * {@inheritdoc}
+     */
+    get client(): ClientType;
+    /**
+     * Set client driver
+     */
+    set client(client: ClientType);
+    /**
+     * Get the cache driver name
+     */
+    abstract name: string;
+    /**
+     * Options list
+     */
+    options: Options;
+    /**
+     * Event listeners storage
+     */
+    protected eventListeners: Map<CacheEventType, Set<CacheEventHandler>>;
+    /**
+     * {@inheritdoc}
+     */
+    parseKey(key: CacheKey): string;
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options: Options): this;
+    /**
+     * Register an event listener
+     */
+    on(event: CacheEventType, handler: CacheEventHandler): this;
+    /**
+     * Remove an event listener
+     */
+    off(event: CacheEventType, handler: CacheEventHandler): this;
+    /**
+     * Register a one-time event listener
+     */
+    once(event: CacheEventType, handler: CacheEventHandler): this;
+    /**
+     * Emit an event to all registered listeners
+     */
+    protected emit(event: CacheEventType, data?: Partial<CacheEventData>): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    abstract removeNamespace(namespace: string): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    abstract set(key: CacheKey, value: any, ttl?: number): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    abstract get(key: CacheKey): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    abstract remove(key: CacheKey): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    abstract flush(): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    has(key: CacheKey): Promise<boolean>;
+    /**
+     * Lock storage for preventing cache stampede
+     */
+    protected locks: Map<string, Promise<any>>;
+    /**
+     * {@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>;
+    /**
+     * {@inheritdoc}
+     */
+    many(keys: CacheKey[]): Promise<any[]>;
+    /**
+     * {@inheritdoc}
+     */
+    setMany(items: Record<string, any>, ttl?: number): Promise<void>;
+    /**
+     * Log the operation
+     */
+    protected log(operation: CacheOperationType, key?: string): any;
+    /**
+     * Log error message
+     */
+    protected logError(message: string, error?: any): void;
+    /**
+     * Get time to live value
+     */
+    get ttl(): any;
+    /**
+     * Get time to live value in milliseconds
+     */
+    getExpiresAt(ttl?: number): number;
+    /**
+     * Prepare data for storage
+     */
+    protected prepareDataForStorage(data: any, ttl?: number): CacheData;
+    /**
+     * Parse fetched data from cache
+     */
+    protected parseCachedData(key: string, data: CacheData): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    connect(): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Create a tagged cache instance for the given tags
+     */
+    tags(tags: string[]): any;
+}
+//# sourceMappingURL=base-cache-driver.d.ts.map