@xbg.solutions/backend-core 1.0.0

package/lib/utils-cache-connector/src/providers/firestore-cache-provider.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Firestore Cache Provider
+ *
+ * Firestore-based cache provider for distributed caching across function instances.
+ *
+ * Features:
+ * - Shared cache across all function instances
+ * - Persistent across cold starts
+ * - TTL-based expiration using Firestore timestamps
+ * - Tag-based invalidation
+ * - Automatic cleanup of expired entries
+ *
+ * Best for:
+ * - Medium-traffic repositories
+ * - Data that needs to be shared across instances
+ * - Cache data that should survive cold starts
+ *
+ * Trade-offs:
+ * - Latency: ~50-100ms (vs memory ~1-5ms)
+ * - Cost: Firestore read/write operations
+ * - Size limit: 1MB per document
+ */
+import { BaseCacheProvider } from './base-cache-provider';
+import { CacheProviderType, CacheSetOptions, CacheEntry, FirestoreCacheProviderConfig } from '../types';
+export declare class FirestoreCacheProvider extends BaseCacheProvider {
+    private config;
+    private db;
+    private cleanupInterval;
+    constructor(config: FirestoreCacheProviderConfig);
+    getType(): CacheProviderType;
+    /**
+     * Get collection reference
+     */
+    private getCollection;
+    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>;
+    /**
+     * Start automatic cleanup of expired entries
+     */
+    private startCleanup;
+    /**
+     * Stop automatic cleanup
+     */
+    stopCleanup(): void;
+    /**
+     * Cleanup on provider destruction
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=firestore-cache-provider.d.ts.map

package/lib/utils-cache-connector/src/providers/firestore-cache-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore-cache-provider.d.ts","sourceRoot":"","sources":["../../../../../utils-cache-connector/src/providers/firestore-cache-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,4BAA4B,EAC7B,MAAM,UAAU,CAAC;AAclB,qBAAa,sBAAuB,SAAQ,iBAAiB;IAI/C,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,eAAe,CAA+B;gBAElC,MAAM,EAAE,4BAA4B;IAaxD,OAAO,IAAI,iBAAiB;IAI5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAIf,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAkDtC,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAiD9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B3E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgClC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BjD,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,QAAQ,GAAG,QAAQ,GAAG,UAAqB,GAChD,OAAO,CAAC,MAAM,CAAC;IA6CZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBtB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAiC1B,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC;IA2B9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/lib/utils-cache-connector/src/providers/firestore-cache-provider.js

@@ -0,0 +1,418 @@
+"use strict";
+/**
+ * Firestore Cache Provider
+ *
+ * Firestore-based cache provider for distributed caching across function instances.
+ *
+ * Features:
+ * - Shared cache across all function instances
+ * - Persistent across cold starts
+ * - TTL-based expiration using Firestore timestamps
+ * - Tag-based invalidation
+ * - Automatic cleanup of expired entries
+ *
+ * Best for:
+ * - Medium-traffic repositories
+ * - Data that needs to be shared across instances
+ * - Cache data that should survive cold starts
+ *
+ * Trade-offs:
+ * - Latency: ~50-100ms (vs memory ~1-5ms)
+ * - Cost: Firestore read/write operations
+ * - Size limit: 1MB per document
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirestoreCacheProvider = void 0;
+const admin = __importStar(require("firebase-admin"));
+const firestore_1 = require("firebase-admin/firestore");
+const base_cache_provider_1 = require("./base-cache-provider");
+const utils_logger_1 = require("@xbg/utils-logger");
+class FirestoreCacheProvider extends base_cache_provider_1.BaseCacheProvider {
+    constructor(config) {
+        super();
+        this.config = config;
+        this.cleanupInterval = null;
+        // Get Firestore instance
+        // We use the default app's Firestore (configured via CACHE_FIRESTORE_DATABASE)
+        this.db = admin.firestore();
+        // Start automatic cleanup if enabled
+        if (config.enableCleanup) {
+            this.startCleanup();
+        }
+    }
+    getType() {
+        return 'firestore';
+    }
+    /**
+     * Get collection reference
+     */
+    getCollection() {
+        return this.db.collection(this.config.collection);
+    }
+    async get(key) {
+        try {
+            const docRef = this.getCollection().doc(key);
+            const doc = await docRef.get();
+            if (!doc.exists) {
+                this.recordMiss();
+                return null;
+            }
+            const data = doc.data();
+            if (!data) {
+                this.recordMiss();
+                return null;
+            }
+            // Check if expired
+            const expiresAt = data.expiresAt.toDate();
+            if (this.isExpired(expiresAt)) {
+                // Delete expired entry
+                await docRef.delete();
+                this.recordExpiration();
+                this.recordMiss();
+                return null;
+            }
+            // Update access metadata (fire and forget)
+            docRef.update({
+                hitCount: admin.firestore.FieldValue.increment(1),
+                lastAccessedAt: firestore_1.Timestamp.now(),
+            }).catch((error) => {
+                utils_logger_1.logger.warn('Failed to update cache access metadata', {
+                    operation: 'cache.get',
+                    key,
+                    error,
+                });
+            });
+            this.recordHit();
+            return data.value;
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error getting cache entry from Firestore', error, {
+                operation: 'cache.get',
+                key,
+            });
+            this.recordMiss();
+            return null;
+        }
+    }
+    async getWithMetadata(key) {
+        try {
+            const docRef = this.getCollection().doc(key);
+            const doc = await docRef.get();
+            if (!doc.exists) {
+                this.recordMiss();
+                return null;
+            }
+            const data = doc.data();
+            if (!data) {
+                this.recordMiss();
+                return null;
+            }
+            // Check if expired
+            const expiresAt = data.expiresAt.toDate();
+            if (this.isExpired(expiresAt)) {
+                await docRef.delete();
+                this.recordExpiration();
+                this.recordMiss();
+                return null;
+            }
+            this.recordHit();
+            return {
+                key,
+                value: data.value,
+                metadata: {
+                    createdAt: data.createdAt.toDate(),
+                    expiresAt: expiresAt,
+                    hitCount: data.hitCount,
+                    lastAccessedAt: data.lastAccessedAt.toDate(),
+                    tags: data.tags,
+                    size: data.size,
+                },
+            };
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error getting cache entry with metadata from Firestore', error, {
+                operation: 'cache.getWithMetadata',
+                key,
+            });
+            this.recordMiss();
+            return null;
+        }
+    }
+    async set(key, value, options = {}) {
+        try {
+            const ttl = options.ttl || 300; // Default 5 minutes
+            const tags = options.tags || [];
+            const size = this.estimateSize(value);
+            const now = firestore_1.Timestamp.now();
+            const expiresAt = firestore_1.Timestamp.fromDate(this.calculateExpiresAt(ttl));
+            const cacheDoc = {
+                key,
+                value,
+                createdAt: now,
+                expiresAt,
+                hitCount: 0,
+                lastAccessedAt: now,
+                tags,
+                size,
+            };
+            await this.getCollection().doc(key).set(cacheDoc);
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error setting cache entry in Firestore', error, {
+                operation: 'cache.set',
+                key,
+                ttl: options.ttl,
+            });
+            throw error;
+        }
+    }
+    async delete(key) {
+        try {
+            const docRef = this.getCollection().doc(key);
+            const doc = await docRef.get();
+            if (!doc.exists) {
+                return false;
+            }
+            await docRef.delete();
+            return true;
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error deleting cache entry from Firestore', error, {
+                operation: 'cache.delete',
+                key,
+            });
+            return false;
+        }
+    }
+    async has(key) {
+        try {
+            const docRef = this.getCollection().doc(key);
+            const doc = await docRef.get();
+            if (!doc.exists) {
+                return false;
+            }
+            const data = doc.data();
+            if (!data) {
+                return false;
+            }
+            // Check if expired
+            const expiresAt = data.expiresAt.toDate();
+            if (this.isExpired(expiresAt)) {
+                await docRef.delete();
+                this.recordExpiration();
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error checking cache entry in Firestore', error, {
+                operation: 'cache.has',
+                key,
+            });
+            return false;
+        }
+    }
+    async invalidateByTags(tags) {
+        try {
+            let count = 0;
+            // Query for documents with any of the specified tags
+            for (const tag of tags) {
+                const query = this.getCollection().where('tags', 'array-contains', tag);
+                const snapshot = await query.get();
+                // Delete matching documents in batch
+                const batch = this.db.batch();
+                snapshot.docs.forEach((doc) => {
+                    batch.delete(doc.ref);
+                    count++;
+                });
+                if (!snapshot.empty) {
+                    await batch.commit();
+                }
+            }
+            return count;
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error invalidating cache by tags in Firestore', error, {
+                operation: 'cache.invalidateByTags',
+                tags,
+            });
+            return 0;
+        }
+    }
+    async invalidateByPattern(pattern, mode = 'prefix') {
+        try {
+            let query;
+            if (mode === 'prefix') {
+                // Use Firestore range query for prefix matching
+                const endPattern = pattern.slice(0, -1) + String.fromCharCode(pattern.charCodeAt(pattern.length - 1) + 1);
+                query = this.getCollection()
+                    .where('key', '>=', pattern)
+                    .where('key', '<', endPattern);
+            }
+            else {
+                // For suffix and contains, we need to get all documents and filter
+                // This is inefficient but Firestore doesn't support these natively
+                query = this.getCollection();
+            }
+            const snapshot = await query.get();
+            let count = 0;
+            const batch = this.db.batch();
+            snapshot.docs.forEach((doc) => {
+                const key = doc.data().key;
+                // Apply pattern matching
+                if (mode === 'prefix' || this.matchPattern(key, pattern, mode)) {
+                    batch.delete(doc.ref);
+                    count++;
+                }
+            });
+            if (count > 0) {
+                await batch.commit();
+            }
+            return count;
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error invalidating cache by pattern in Firestore', error, {
+                operation: 'cache.invalidateByPattern',
+                pattern,
+                mode,
+            });
+            return 0;
+        }
+    }
+    async clear() {
+        try {
+            // Delete all documents in batches
+            const batchSize = 500;
+            let snapshot = await this.getCollection().limit(batchSize).get();
+            while (!snapshot.empty) {
+                const batch = this.db.batch();
+                snapshot.docs.forEach((doc) => {
+                    batch.delete(doc.ref);
+                });
+                await batch.commit();
+                // Get next batch
+                snapshot = await this.getCollection().limit(batchSize).get();
+            }
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error clearing cache in Firestore', error, {
+                operation: 'cache.clear',
+            });
+            throw error;
+        }
+    }
+    async cleanup() {
+        try {
+            const now = firestore_1.Timestamp.now();
+            const query = this.getCollection().where('expiresAt', '<', now);
+            const snapshot = await query.get();
+            if (snapshot.empty) {
+                return 0;
+            }
+            // Delete expired documents in batches
+            const batch = this.db.batch();
+            snapshot.docs.forEach((doc) => {
+                batch.delete(doc.ref);
+                this.recordExpiration();
+            });
+            await batch.commit();
+            utils_logger_1.logger.debug(`Cleaned up ${snapshot.size} expired cache entries`, {
+                operation: 'cache.cleanup',
+                count: snapshot.size,
+            });
+            return snapshot.size;
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error cleaning up expired cache entries in Firestore', error, {
+                operation: 'cache.cleanup',
+            });
+            return 0;
+        }
+    }
+    async getStats() {
+        try {
+            const snapshot = await this.getCollection().get();
+            let totalSize = 0;
+            let expiredCount = 0;
+            snapshot.docs.forEach((doc) => {
+                const data = doc.data();
+                totalSize += data.size || 0;
+                if (this.isExpired(data.expiresAt.toDate())) {
+                    expiredCount++;
+                }
+            });
+            this.updateEntryCount(snapshot.size - expiredCount);
+            this.updateSize(totalSize);
+            return super.getStats();
+        }
+        catch (error) {
+            utils_logger_1.logger.error('Error getting cache stats from Firestore', error, {
+                operation: 'cache.getStats',
+            });
+            return super.getStats();
+        }
+    }
+    /**
+     * Start automatic cleanup of expired entries
+     */
+    startCleanup() {
+        if (this.cleanupInterval) {
+            return;
+        }
+        this.cleanupInterval = setInterval(async () => {
+            await this.cleanup();
+        }, this.config.cleanupInterval * 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();
+    }
+}
+exports.FirestoreCacheProvider = FirestoreCacheProvider;
+//# sourceMappingURL=firestore-cache-provider.js.map

package/lib/utils-cache-connector/src/providers/firestore-cache-provider.js.map

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

package/lib/utils-cache-connector/src/providers/memory-cache-provider.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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
+ */
+import { BaseCacheProvider } from './base-cache-provider';
+import { CacheProviderType, CacheSetOptions, CacheEntry, MemoryCacheProviderConfig } from '../types';
+export declare class MemoryCacheProvider extends BaseCacheProvider {
+    private config;
+    private cache;
+    private cleanupInterval;
+    private currentSize;
+    constructor(config: MemoryCacheProviderConfig);
+    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>;
+    cleanup(): Promise<number>;
+    /**
+     * Evict least recently used entries to make space
+     */
+    private evictLRU;
+    /**
+     * Start automatic cleanup of expired entries
+     */
+    private startCleanup;
+    /**
+     * Stop automatic cleanup
+     */
+    stopCleanup(): void;
+    /**
+     * Cleanup on provider destruction
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=memory-cache-provider.d.ts.map

package/lib/utils-cache-connector/src/providers/memory-cache-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-cache-provider.d.ts","sourceRoot":"","sources":["../../../../../utils-cache-connector/src/providers/memory-cache-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,UAAU,EAEV,yBAAyB,EAC1B,MAAM,UAAU,CAAC;AAOlB,qBAAa,mBAAoB,SAAQ,iBAAiB;IAK5C,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,WAAW,CAAa;gBAEZ,MAAM,EAAE,yBAAyB;IAQrD,OAAO,IAAI,iBAAiB;IAItB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA8BtC,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAgB9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B3E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAerC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBlC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBjD,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,QAAQ,GAAG,QAAQ,GAAG,UAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBxG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBhC;;OAEG;YACW,QAAQ;IAwBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}