@warlock.js/cache 4.0.48 → 4.0.59

package/esm/tagged-cache.js

@@ -0,0 +1,160 @@
+/**
+ * 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);
+    }
+}export{TaggedCache};//# sourceMappingURL=tagged-cache.js.map

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

package/esm/types.d.ts

@@ -0,0 +1,381 @@
+import type { GenericObject } from "@mongez/reinforcements";
+import type { RedisClientOptions } from "redis";
+import type { BaseCacheDriver, FileCacheDriver, LRUMemoryCacheDriver, MemoryCacheDriver, MemoryExtendedCacheDriver, NullCacheDriver, RedisCacheDriver } from "./drivers";
+/**
+ * Base error class for cache-related errors
+ */
+export declare class CacheError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when cache connection fails
+ */
+export declare class CacheConnectionError extends CacheError {
+    constructor(message: string);
+}
+/**
+ * Error thrown when cache driver configuration is invalid
+ */
+export declare class CacheConfigurationError extends CacheError {
+    constructor(message: string);
+}
+/**
+ * Error thrown when cache driver is not initialized
+ */
+export declare class CacheDriverNotInitializedError extends CacheError {
+    constructor(message?: string);
+}
+/**
+ * Cache key type - can be a string or an object
+ */
+export type CacheKey = string | GenericObject;
+export type CacheOperationType = "fetching" | "fetched" | "caching" | "cached" | "flushing" | "flushed" | "removing" | "removed" | "clearing" | "cleared" | "expired" | "notFound" | "connecting" | "error" | "connected" | "disconnecting" | "disconnected";
+/**
+ * Cache event types for observability
+ */
+export type CacheEventType = "hit" | "miss" | "set" | "removed" | "flushed" | "expired" | "connected" | "disconnected" | "error";
+/**
+ * Cache event data structure
+ */
+export type CacheEventData = {
+    /**
+     * The cache key involved in the event
+     */
+    key?: string;
+    /**
+     * The value (for set/hit events)
+     */
+    value?: any;
+    /**
+     * TTL in seconds (for set events)
+     */
+    ttl?: number;
+    /**
+     * Driver name that emitted the event
+     */
+    driver: string;
+    /**
+     * Error object (for error events)
+     */
+    error?: any;
+    /**
+     * Namespace (for namespace operations)
+     */
+    namespace?: string;
+};
+/**
+ * Event handler function type
+ */
+export type CacheEventHandler = (eventData: CacheEventData) => void | Promise<void>;
+/**
+ * Tagged cache interface for working with cache tags
+ */
+export interface TaggedCacheDriver {
+    /**
+     * Set a value in cache with tags
+     */
+    set(key: CacheKey, value: any, ttl?: number): Promise<any>;
+    /**
+     * Get a value from cache (checks tags)
+     */
+    get(key: CacheKey): Promise<any | null>;
+    /**
+     * Remove a specific key
+     */
+    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
+     */
+    flush(): Promise<void>;
+    /**
+     * Check if a key exists
+     */
+    has(key: CacheKey): Promise<boolean>;
+    /**
+     * Remember pattern with tags
+     */
+    remember(key: CacheKey, ttl: number, callback: () => Promise<any>): Promise<any>;
+    /**
+     * Pull value with tags
+     */
+    pull(key: CacheKey): Promise<any | null>;
+    /**
+     * Forever with tags
+     */
+    forever(key: CacheKey, value: any): Promise<any>;
+    /**
+     * Increment with tags
+     */
+    increment(key: CacheKey, value?: number): Promise<number>;
+    /**
+     * Decrement with tags
+     */
+    decrement(key: CacheKey, value?: number): Promise<number>;
+}
+export type MemoryCacheOptions = {
+    /**
+     * The global prefix for the cache key
+     */
+    globalPrefix?: string | (() => string);
+    /**
+     * The default TTL for the cache in seconds
+     *
+     * @default Infinity
+     */
+    ttl?: number;
+    /**
+     * Maximum number of items in cache
+     * When exceeded, least recently used items will be evicted
+     *
+     * @default undefined (no limit)
+     */
+    maxSize?: number;
+};
+export type MemoryExtendedCacheOptions = MemoryCacheOptions;
+export type LRUMemoryCacheOptions = {
+    /**
+     * The maximum number of items in the cache
+     *
+     * @default 1000
+     */
+    capacity?: number;
+};
+export type FileCacheOptions = {
+    /**
+     * The global prefix for the cache key
+     */
+    globalPrefix?: string | (() => string);
+    /**
+     * The default TTL for the cache in seconds
+     *
+     * @default 0
+     */
+    ttl?: number;
+    /**
+     * Storage cache directory
+     *
+     * @default storagePath("cache")
+     */
+    directory: string | (() => string);
+    /**
+     * File name
+     *
+     * @default cache.json
+     */
+    fileName?: string | (() => string);
+};
+export type RedisOptions = {
+    /**
+     * Redis Port
+     *
+     * @default 6379
+     */
+    port?: number;
+    /**
+     * Redis Host
+     */
+    host?: string;
+    /**
+     * Redis Username
+     */
+    username?: string;
+    /**
+     * Redis Password
+     */
+    password?: string;
+    /**
+     * Redis URL
+     *
+     * If used, it will override the host and port options
+     */
+    url?: string;
+    /**
+     * Global prefix for the cache key
+     */
+    globalPrefix?: string | (() => string);
+    /**
+     * Time to live in seconds
+     *
+     * @default Infinity
+     */
+    ttl?: number;
+    /**
+     * Redis client options
+     */
+    clientOptions?: RedisClientOptions;
+};
+export type NullCacheDriverOptions = GenericObject;
+export interface CacheDriver<ClientType, Options> {
+    /**
+     * The cache driver options
+     */
+    options: Options;
+    /**
+     * Cache driver name
+     */
+    name: string;
+    /**
+     *  Remove all cached items by namespace
+     */
+    removeNamespace(namespace: string): Promise<any>;
+    /**
+     * Set the cache driver options
+     */
+    setOptions(options: Options): any;
+    /**
+     * Parse the key to be used in the cache
+     */
+    parseKey(key: CacheKey): string;
+    /**
+     * 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>;
+    /**
+     * Get a value from the cache
+     */
+    get(key: CacheKey): Promise<any | null>;
+    /**
+     * Remove a value from the cache
+     */
+    remove(key: CacheKey): Promise<void>;
+    /**
+     * Flush the entire cache
+     */
+    flush(): Promise<void>;
+    /**
+     * Connect to the cache driver
+     */
+    connect(): Promise<any>;
+    /**
+     * The cache client
+     */
+    client?: ClientType;
+    /**
+     * Disconnect the cache driver
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if a key exists in the cache without fetching its value
+     */
+    has(key: CacheKey): Promise<boolean>;
+    /**
+     * Get value from cache or execute callback and cache the result
+     *
+     * @param key The cache key
+     * @param ttl Time to live in seconds
+     * @param callback Function to execute if cache miss
+     */
+    remember(key: CacheKey, ttl: number, callback: () => Promise<any>): Promise<any>;
+    /**
+     * Get value and remove it from cache (atomic operation)
+     */
+    pull(key: CacheKey): Promise<any | null>;
+    /**
+     * Set a value in cache permanently (no expiration)
+     */
+    forever(key: CacheKey, value: any): Promise<any>;
+    /**
+     * Increment a numeric value in cache
+     *
+     * @param key The cache key
+     * @param value The value to increment by (default 1)
+     */
+    increment(key: CacheKey, value?: number): Promise<number>;
+    /**
+     * Decrement a numeric value in cache
+     *
+     * @param key The cache key
+     * @param value The value to decrement by (default 1)
+     */
+    decrement(key: CacheKey, value?: number): Promise<number>;
+    /**
+     * Get multiple values from cache at once
+     */
+    many(keys: CacheKey[]): Promise<any[]>;
+    /**
+     * Set multiple values in cache at once
+     */
+    setMany(items: Record<string, any>, ttl?: number): Promise<void>;
+    /**
+     * 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;
+    /**
+     * Set if not exists (atomic operation)
+     * Returns true if key was set, false if key already existed
+     * Note: Not all drivers support this operation
+     */
+    setNX?(key: CacheKey, value: any, ttl?: number): Promise<boolean>;
+    /**
+     * Create a tagged cache instance for the given tags
+     */
+    tags(tags: string[]): TaggedCacheDriver;
+}
+export type CacheData = {
+    /**
+     * Value stored in the cache
+     */
+    data: any;
+    /**
+     * The expiration date in milliseconds
+     */
+    expiresAt?: number;
+    /**
+     * Time to live in seconds
+     */
+    ttl?: number;
+};
+export type DriverClass = new () => CacheDriver<any, any>;
+type DefaultDrivers = "redis" | "file" | "memory" | "memoryExtended" | "null" | "lru";
+type MergeWithDefaultDrivers<T> = T extends undefined ? DefaultDrivers : DefaultDrivers | T;
+export type CacheConfigurations<T extends string | undefined = undefined, DriverName = MergeWithDefaultDrivers<T>> = {
+    /**
+     * The default cache driver name
+     */
+    default?: DriverName;
+    /**
+     * The cache drivers list
+     */
+    drivers: {
+        redis?: typeof RedisCacheDriver;
+        file?: typeof FileCacheDriver;
+        null?: typeof NullCacheDriver;
+        memory?: typeof MemoryCacheDriver;
+        memoryExtended?: typeof MemoryExtendedCacheDriver;
+        lru?: typeof LRUMemoryCacheDriver;
+    } & {
+        [key in Extract<T, string>]?: typeof BaseCacheDriver<any, any> | undefined;
+    };
+    /**
+     * The cache driver options
+     */
+    options: {
+        redis?: RedisOptions;
+        file?: FileCacheOptions;
+        memory?: MemoryCacheOptions;
+        memoryExtended?: MemoryExtendedCacheOptions;
+        null?: NullCacheDriverOptions;
+        lru?: LRUMemoryCacheOptions;
+    } & {
+        [key in Extract<T, string>]?: GenericObject;
+    };
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/esm/types.d.ts.map

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

package/esm/types.js

@@ -0,0 +1,36 @@
+/**
+ * Base error class for cache-related errors
+ */
+class CacheError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CacheError";
+    }
+}
+/**
+ * Error thrown when cache connection fails
+ */
+class CacheConnectionError extends CacheError {
+    constructor(message) {
+        super(message);
+        this.name = "CacheConnectionError";
+    }
+}
+/**
+ * Error thrown when cache driver configuration is invalid
+ */
+class CacheConfigurationError extends CacheError {
+    constructor(message) {
+        super(message);
+        this.name = "CacheConfigurationError";
+    }
+}
+/**
+ * Error thrown when cache driver is not initialized
+ */
+class CacheDriverNotInitializedError extends CacheError {
+    constructor(message = "No cache driver initialized. Call cache.init() or cache.use() first.") {
+        super(message);
+        this.name = "CacheDriverNotInitializedError";
+    }
+}export{CacheConfigurationError,CacheConnectionError,CacheDriverNotInitializedError,CacheError};//# sourceMappingURL=types.js.map

package/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../src/types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAYA;;AAEG;AACG,MAAO,UAAW,SAAQ,KAAK,CAAA;AACnC,IAAA,WAAA,CAAmB,OAAe,EAAA;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;AACf,QAAA,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;KAC1B;AACF,CAAA;AAED;;AAEG;AACG,MAAO,oBAAqB,SAAQ,UAAU,CAAA;AAClD,IAAA,WAAA,CAAmB,OAAe,EAAA;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;AACf,QAAA,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;KACpC;AACF,CAAA;AAED;;AAEG;AACG,MAAO,uBAAwB,SAAQ,UAAU,CAAA;AACrD,IAAA,WAAA,CAAmB,OAAe,EAAA;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;AACf,QAAA,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;KACvC;AACF,CAAA;AAED;;AAEG;AACG,MAAO,8BAA+B,SAAQ,UAAU,CAAA;AAC5D,IAAA,WAAA,CACE,UAAkB,sEAAsE,EAAA;QAExF,KAAK,CAAC,OAAO,CAAC,CAAC;AACf,QAAA,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;KAC9C;AACF"}

package/esm/utils.d.ts

@@ -0,0 +1,50 @@
+import type { CacheKey } from "./types";
+/**
+ * Make a proper key for the cache
+ */
+export declare function parseCacheKey(key: CacheKey, options?: {
+    globalPrefix?: string | (() => string);
+}): string;
+export declare enum CACHE_FOR {
+    /**
+     * Cache for 30 Minutes (in seconds)
+     */
+    HALF_HOUR = 1800,
+    /**
+     * Cache for 1 Hour (in seconds)
+     */
+    ONE_HOUR = 3600,
+    /**
+     * Cache for 12 Hours (in seconds)
+     */
+    HALF_DAY = 43200,
+    /**
+     * Cache for 24 Hours (in seconds)
+     */
+    ONE_DAY = 86400,
+    /**
+     * Cache for 7 Days (in seconds)
+     */
+    ONE_WEEK = 604800,
+    /**
+     * Cache for 15 Days (in seconds)
+     */
+    HALF_MONTH = 1296000,
+    /**
+     * Cache for 30 Days (in seconds)
+     */
+    ONE_MONTH = 2592000,
+    /**
+     * Cache for 60 Days (in seconds)
+     */
+    TWO_MONTHS = 5184000,
+    /**
+     * Cache for 180 Days (in seconds)
+     */
+    SIX_MONTHS = 15768000,
+    /**
+     * Cache for 365 Days (in seconds)
+     */
+    ONE_YEAR = 31536000
+}
+//# sourceMappingURL=utils.d.ts.map

package/esm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,QAAQ,EACb,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;CAAO,GACvD,MAAM,CAYR;AAED,oBAAY,SAAS;IACnB;;OAEG;IACH,SAAS,OAAO;IAChB;;OAEG;IACH,QAAQ,OAAO;IACf;;OAEG;IACH,QAAQ,QAAQ;IAChB;;OAEG;IACH,OAAO,QAAQ;IACf;;OAEG;IACH,QAAQ,SAAS;IACjB;;OAEG;IACH,UAAU,UAAU;IACpB;;OAEG;IACH,SAAS,UAAU;IACnB;;OAEG;IACH,UAAU,UAAU;IACpB;;OAEG;IACH,UAAU,WAAW;IACrB;;OAEG;IACH,QAAQ,WAAW;CACpB"}