@xbg.solutions/utils-cache-connector 1.0.0

package/lib/providers/memory-cache-provider.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Memory Cache Provider
+ *
+ * In-memory cache provider using Map data structure.
+ * Features:
+ * - TTL-based expiration
+ * - LRU eviction when max size is reached
+ * - Automatic cleanup of expired entries
+ * - Tag-based invalidation
+ *
+ * Best for:
+ * - Request-scoped caching
+ * - Hot data within a single function instance
+ * - Auth/permissions data
+ * - Configuration values
+ *
+ * Limitations:
+ * - Not shared across function instances
+ * - Lost on cold starts
+ * - Limited by instance memory
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryCacheProvider = void 0;
+const base_cache_provider_1 = require("./base-cache-provider");
+class MemoryCacheProvider extends base_cache_provider_1.BaseCacheProvider {
+    constructor(config) {
+        super();
+        this.config = config;
+        this.cleanupInterval = null;
+        this.currentSize = 0;
+        this.cache = new Map();
+        // Start automatic cleanup
+        this.startCleanup();
+    }
+    getType() {
+        return 'memory';
+    }
+    async get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.recordMiss();
+            return null;
+        }
+        // Check if expired
+        if (this.isExpired(entry.metadata.expiresAt)) {
+            this.cache.delete(key);
+            this.recordExpiration();
+            this.recordMiss();
+            return null;
+        }
+        // Update access metadata
+        entry.metadata.hitCount++;
+        entry.metadata.lastAccessedAt = new Date();
+        this.recordHit();
+        // Return clone if configured (prevents mutations)
+        if (this.config.useClones) {
+            return JSON.parse(JSON.stringify(entry.value));
+        }
+        return entry.value;
+    }
+    async getWithMetadata(key) {
+        const value = await this.get(key);
+        if (value === null) {
+            return null;
+        }
+        const entry = this.cache.get(key);
+        return {
+            key,
+            value,
+            metadata: Object.assign({}, entry.metadata),
+        };
+    }
+    async set(key, value, options = {}) {
+        const ttl = options.ttl || 300; // Default 5 minutes
+        const tags = options.tags || [];
+        // Estimate size
+        const size = this.estimateSize(value);
+        // Check if we need to evict (before adding new entry)
+        if (this.currentSize + size > this.config.maxSize) {
+            await this.evictLRU(size);
+        }
+        // Create entry
+        const entry = {
+            value: this.config.useClones ? JSON.parse(JSON.stringify(value)) : value,
+            metadata: Object.assign(Object.assign({}, this.createMetadata(ttl, tags)), { size }),
+        };
+        // Store in cache
+        this.cache.set(key, entry);
+        this.currentSize += size;
+        this.updateEntryCount(this.cache.size);
+        this.updateSize(this.currentSize);
+    }
+    async delete(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return false;
+        }
+        this.cache.delete(key);
+        this.currentSize -= entry.metadata.size || 0;
+        this.updateEntryCount(this.cache.size);
+        this.updateSize(this.currentSize);
+        return true;
+    }
+    async has(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return false;
+        }
+        // Check if expired
+        if (this.isExpired(entry.metadata.expiresAt)) {
+            this.cache.delete(key);
+            this.recordExpiration();
+            return false;
+        }
+        return true;
+    }
+    async invalidateByTags(tags) {
+        let count = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            // Check if entry has any of the specified tags
+            const hasTag = tags.some((tag) => entry.metadata.tags.includes(tag));
+            if (hasTag) {
+                this.cache.delete(key);
+                this.currentSize -= entry.metadata.size || 0;
+                count++;
+            }
+        }
+        this.updateEntryCount(this.cache.size);
+        this.updateSize(this.currentSize);
+        return count;
+    }
+    async invalidateByPattern(pattern, mode = 'prefix') {
+        let count = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (this.matchPattern(key, pattern, mode)) {
+                this.cache.delete(key);
+                this.currentSize -= entry.metadata.size || 0;
+                count++;
+            }
+        }
+        this.updateEntryCount(this.cache.size);
+        this.updateSize(this.currentSize);
+        return count;
+    }
+    async clear() {
+        this.cache.clear();
+        this.currentSize = 0;
+        this.updateEntryCount(0);
+        this.updateSize(0);
+    }
+    async cleanup() {
+        let count = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (this.isExpired(entry.metadata.expiresAt)) {
+                this.cache.delete(key);
+                this.currentSize -= entry.metadata.size || 0;
+                this.recordExpiration();
+                count++;
+            }
+        }
+        this.updateEntryCount(this.cache.size);
+        this.updateSize(this.currentSize);
+        return count;
+    }
+    /**
+     * Evict least recently used entries to make space
+     */
+    async evictLRU(requiredSpace) {
+        // Sort entries by last accessed time
+        const entries = Array.from(this.cache.entries()).sort((a, b) => a[1].metadata.lastAccessedAt.getTime() - b[1].metadata.lastAccessedAt.getTime());
+        let freedSpace = 0;
+        for (const [key, entry] of entries) {
+            if (freedSpace >= requiredSpace) {
+                break;
+            }
+            this.cache.delete(key);
+            const entrySize = entry.metadata.size || 0;
+            this.currentSize -= entrySize;
+            freedSpace += entrySize;
+            this.recordEviction();
+        }
+        this.updateEntryCount(this.cache.size);
+        this.updateSize(this.currentSize);
+    }
+    /**
+     * Start automatic cleanup of expired entries
+     */
+    startCleanup() {
+        if (this.cleanupInterval) {
+            return;
+        }
+        this.cleanupInterval = setInterval(async () => {
+            await this.cleanup();
+        }, this.config.checkPeriod * 1000);
+        // Don't prevent Node.js from exiting
+        this.cleanupInterval.unref();
+    }
+    /**
+     * Stop automatic cleanup
+     */
+    stopCleanup() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+    /**
+     * Cleanup on provider destruction
+     */
+    destroy() {
+        this.stopCleanup();
+        this.cache.clear();
+    }
+}
+exports.MemoryCacheProvider = MemoryCacheProvider;
+//# sourceMappingURL=memory-cache-provider.js.map

package/lib/providers/memory-cache-provider.js.map

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

package/lib/providers/noop-cache-provider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * NoOp Cache Provider
+ *
+ * A no-operation cache provider used when caching is globally disabled.
+ * All operations are no-ops that return immediately without doing anything.
+ * This ensures zero performance overhead when caching is turned off.
+ */
+import { BaseCacheProvider } from './base-cache-provider';
+import { CacheProviderType, CacheSetOptions, CacheEntry } from '../types';
+export declare class NoOpCacheProvider extends BaseCacheProvider {
+    getType(): CacheProviderType;
+    get<T>(_key: string): Promise<T | null>;
+    getWithMetadata<T>(_key: string): Promise<CacheEntry<T> | null>;
+    set<T>(_key: string, _value: T, _options?: CacheSetOptions): Promise<void>;
+    delete(_key: string): Promise<boolean>;
+    has(_key: string): Promise<boolean>;
+    invalidateByTags(_tags: string[]): Promise<number>;
+    invalidateByPattern(_pattern: string, _mode?: 'prefix' | 'suffix' | 'contains'): Promise<number>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=noop-cache-provider.d.ts.map

package/lib/providers/noop-cache-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-cache-provider.d.ts","sourceRoot":"","sources":["../../src/providers/noop-cache-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE1E,qBAAa,iBAAkB,SAAQ,iBAAiB;IACtD,OAAO,IAAI,iBAAiB;IAItB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAIvC,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAI/D,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/lib/providers/noop-cache-provider.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * NoOp Cache Provider
+ *
+ * A no-operation cache provider used when caching is globally disabled.
+ * All operations are no-ops that return immediately without doing anything.
+ * This ensures zero performance overhead when caching is turned off.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoOpCacheProvider = void 0;
+const base_cache_provider_1 = require("./base-cache-provider");
+class NoOpCacheProvider extends base_cache_provider_1.BaseCacheProvider {
+    getType() {
+        return 'noop';
+    }
+    async get(_key) {
+        return null;
+    }
+    async getWithMetadata(_key) {
+        return null;
+    }
+    async set(_key, _value, _options) {
+        // No-op
+    }
+    async delete(_key) {
+        return false;
+    }
+    async has(_key) {
+        return false;
+    }
+    async invalidateByTags(_tags) {
+        return 0;
+    }
+    async invalidateByPattern(_pattern, _mode) {
+        return 0;
+    }
+    async clear() {
+        // No-op
+    }
+}
+exports.NoOpCacheProvider = NoOpCacheProvider;
+//# sourceMappingURL=noop-cache-provider.js.map

package/lib/providers/noop-cache-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-cache-provider.js","sourceRoot":"","sources":["../../src/providers/noop-cache-provider.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,+DAA0D;AAG1D,MAAa,iBAAkB,SAAQ,uCAAiB;IACtD,OAAO;QACL,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,eAAe,CAAI,IAAY;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,MAAS,EAAE,QAA0B;QAC9D,QAAQ;IACV,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAAe;QACpC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,QAAgB,EAAE,KAAwC;QAClF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK,CAAC,KAAK;QACT,QAAQ;IACV,CAAC;CACF;AApCD,8CAoCC"}

package/lib/providers/redis-cache-provider.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Redis Cache Provider
+ *
+ * Redis-based cache provider for high-performance distributed caching.
+ *
+ * Features:
+ * - Sub-10ms response times
+ * - Distributed caching across all instances
+ * - Pub/sub for distributed invalidation
+ * - Advanced data structures (Sets for tags)
+ * - Connection pooling
+ * - Automatic reconnection
+ *
+ * Best for:
+ * - High-traffic applications (>1M requests/month)
+ * - Sub-10ms response time requirements
+ * - Large cache sizes exceeding Firestore limits
+ * - Advanced caching patterns
+ *
+ * Trade-offs:
+ * - Cost: ~$50/month minimum (Google Cloud Memorystore)
+ * - Infrastructure: Requires Redis server
+ * - Complexity: Additional service to manage
+ */
+import { BaseCacheProvider } from './base-cache-provider';
+import { CacheProviderType, CacheSetOptions, CacheEntry, RedisCacheProviderConfig } from '../types';
+export declare class RedisCacheProvider extends BaseCacheProvider {
+    private config;
+    private client;
+    private isConnected;
+    constructor(config: RedisCacheProviderConfig);
+    /**
+     * Setup Redis event handlers
+     */
+    private setupEventHandlers;
+    getType(): CacheProviderType;
+    /**
+     * Build tag set key
+     */
+    private buildTagKey;
+    /**
+     * Build metadata key
+     */
+    private buildMetaKey;
+    get<T>(key: string): Promise<T | null>;
+    getWithMetadata<T>(key: string): Promise<CacheEntry<T> | null>;
+    set<T>(key: string, value: T, options?: CacheSetOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    invalidateByTags(tags: string[]): Promise<number>;
+    invalidateByPattern(pattern: string, mode?: 'prefix' | 'suffix' | 'contains'): Promise<number>;
+    clear(): Promise<void>;
+    cleanup(): Promise<number>;
+    getStats(): Promise<any>;
+    /**
+     * Check if Redis is connected
+     */
+    isReady(): boolean;
+    /**
+     * Cleanup on provider destruction
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=redis-cache-provider.d.ts.map

package/lib/providers/redis-cache-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache-provider.d.ts","sourceRoot":"","sources":["../../src/providers/redis-cache-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,wBAAwB,EACzB,MAAM,UAAU,CAAC;AAelB,qBAAa,kBAAmB,SAAQ,iBAAiB;IAI3C,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAkB;gBAEjB,MAAM,EAAE,wBAAwB;IAqBpD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA8B1B,OAAO,IAAI,iBAAiB;IAI5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,YAAY;IAId,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA4DtC,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAkD9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiD3E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoCrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBlC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA2CjD,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,QAAQ,GAAG,QAAQ,GAAG,UAAqB,GAChD,OAAO,CAAC,MAAM,CAAC;IA4DZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBtB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAM1B,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;IAwB9B;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB"}