@explorins/pers-sdk 1.6.10 → 1.6.12

package/dist/chunks/index-60201NKa.js

@@ -0,0 +1,265 @@
+/**
+ * Centralized Cache Service for PERS SDK
+ * Provides unified caching with memory management and consistent policies
+ */
+// Default cache configuration constants
+const DEFAULT_CACHE_CONFIG = {
+    defaultTtl: 30 * 60 * 1000, // 30 minutes
+    maxMemoryMB: 50, // 50MB cache limit
+    cleanupInterval: 5 * 60 * 1000, // Cleanup every 5 minutes
+    enableLRU: true
+};
+class CacheService {
+    constructor(config) {
+        this.cache = new Map();
+        this.cleanupTimer = null;
+        this.config = { ...DEFAULT_CACHE_CONFIG, ...config };
+        this.startCleanupTimer();
+    }
+    /**
+     * Set a value in cache with optional TTL
+     */
+    set(key, value, ttl) {
+        if (!key || typeof key !== 'string') {
+            throw new Error('Cache key must be a non-empty string');
+        }
+        if (value === undefined) {
+            console.warn('Cache: Attempted to cache undefined value for key:', key);
+            return;
+        }
+        const entry = {
+            value,
+            timestamp: Date.now(),
+            ttl: ttl || this.config.defaultTtl,
+            accessCount: 1,
+            lastAccessed: Date.now()
+        };
+        this.cache.set(key, entry);
+        this.enforceMemoryLimit();
+    }
+    /**
+     * Get a value from cache
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        // Check if expired
+        const now = Date.now();
+        if (now - entry.timestamp > entry.ttl) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Update access statistics for LRU
+        entry.accessCount++;
+        entry.lastAccessed = now;
+        return entry.value;
+    }
+    /**
+     * Get or set pattern - common caching pattern
+     */
+    async getOrSet(key, fetcher, ttl) {
+        const cached = this.get(key);
+        if (cached !== null) {
+            return cached;
+        }
+        try {
+            const value = await fetcher();
+            // Only cache non-undefined values
+            if (value !== undefined) {
+                this.set(key, value, ttl);
+            }
+            return value;
+        }
+        catch (error) {
+            console.error(`Cache: Error in fetcher for key '${key}':`, error);
+            throw error;
+        }
+    }
+    /**
+     * Delete a specific key
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all keys matching a prefix
+     */
+    clearByPrefix(prefix) {
+        let count = 0;
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(prefix)) {
+                this.cache.delete(key);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Clear all cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const entries = Array.from(this.cache.values());
+        if (entries.length === 0) {
+            return {
+                size: 0,
+                memoryUsageMB: 0,
+                hitRate: 0,
+                oldestEntry: 0
+            };
+        }
+        const totalAccess = entries.reduce((sum, entry) => sum + entry.accessCount, 0);
+        const entriesWithHits = entries.filter(entry => entry.accessCount > 1).length;
+        return {
+            size: this.cache.size,
+            memoryUsageMB: this.estimateMemoryUsage(),
+            hitRate: totalAccess > entries.length ? entriesWithHits / entries.length : 0,
+            oldestEntry: Math.min(...entries.map(entry => entry.timestamp))
+        };
+    }
+    /**
+     * Force cleanup of expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let cleanedCount = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > entry.ttl) {
+                this.cache.delete(key);
+                cleanedCount++;
+            }
+        }
+        return cleanedCount;
+    }
+    /**
+     * Start automatic cleanup timer
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+            this.enforceMemoryLimit();
+        }, this.config.cleanupInterval);
+    }
+    /**
+     * Stop automatic cleanup timer
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.clear();
+    }
+    /**
+     * Estimate memory usage (rough calculation)
+     */
+    estimateMemoryUsage() {
+        let totalSize = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            try {
+                // Key size (UTF-16 characters)
+                totalSize += key.length * 2;
+                // Value size estimation
+                const serializedValue = JSON.stringify(entry.value);
+                totalSize += serializedValue.length * 2;
+                // Cache entry metadata overhead
+                totalSize += 64;
+            }
+            catch (error) {
+                // If JSON.stringify fails, use rough estimation
+                console.warn('Cache: Failed to serialize entry for size estimation:', error);
+                totalSize += key.length * 2 + 1024; // Conservative estimate
+            }
+        }
+        return totalSize / (1024 * 1024); // Convert to MB
+    }
+    /**
+     * Enforce memory limit using LRU eviction
+     */
+    enforceMemoryLimit() {
+        const memoryUsage = this.estimateMemoryUsage();
+        if (memoryUsage <= this.config.maxMemoryMB || !this.config.enableLRU) {
+            return;
+        }
+        // Target 80% of limit to avoid frequent evictions
+        const targetSize = this.config.maxMemoryMB * 0.8;
+        // Sort by last accessed time (LRU) - oldest first
+        const sortedEntries = Array.from(this.cache.entries())
+            .sort((a, b) => a[1].lastAccessed - b[1].lastAccessed);
+        // Remove oldest entries until memory is under target
+        let currentMemory = memoryUsage;
+        let evictedCount = 0;
+        for (const [key] of sortedEntries) {
+            if (currentMemory <= targetSize)
+                break;
+            this.cache.delete(key);
+            evictedCount++;
+            // Re-estimate periodically for performance
+            if (evictedCount % 10 === 0) {
+                currentMemory = this.estimateMemoryUsage();
+            }
+        }
+        if (evictedCount > 0) {
+            console.debug(`Cache: Evicted ${evictedCount} entries to enforce memory limit`);
+        }
+    }
+    /**
+     * Create a namespaced cache interface for services
+     */
+    createNamespace(namespace) {
+        if (!namespace || typeof namespace !== 'string') {
+            throw new Error('Namespace must be a non-empty string');
+        }
+        if (namespace.includes(':')) {
+            throw new Error('Namespace cannot contain colon (:) character');
+        }
+        return {
+            set: (key, value, ttl) => {
+                if (!key)
+                    throw new Error('Cache key cannot be empty');
+                return this.set(`${namespace}:${key}`, value, ttl);
+            },
+            get: (key) => {
+                if (!key)
+                    throw new Error('Cache key cannot be empty');
+                return this.get(`${namespace}:${key}`);
+            },
+            getOrSet: (key, fetcher, ttl) => {
+                if (!key)
+                    throw new Error('Cache key cannot be empty');
+                return this.getOrSet(`${namespace}:${key}`, fetcher, ttl);
+            },
+            delete: (key) => {
+                if (!key)
+                    throw new Error('Cache key cannot be empty');
+                return this.delete(`${namespace}:${key}`);
+            },
+            clear: () => this.clearByPrefix(`${namespace}:`)
+        };
+    }
+}
+// Singleton instance with default configuration
+const globalCacheService = new CacheService();
+
+/**
+ * Cache module exports
+ */
+// Predefined cache TTL constants
+const CacheTTL = {
+    SHORT: 5 * 60 * 1000, // 5 minutes
+    MEDIUM: 30 * 60 * 1000, // 30 minutes  
+    LONG: 24 * 60 * 60 * 1000, // 24 hours
+    METADATA: 24 * 60 * 60 * 1000, // 24 hours - IPFS metadata is immutable
+    GATEWAY: 30 * 60 * 1000, // 30 minutes - Gateway config can change
+    PROVIDER: 60 * 60 * 1000, // 1 hour - Provider connections with auth
+};
+
+export { CacheTTL as C, CacheService as a, globalCacheService as g };
+//# sourceMappingURL=index-60201NKa.js.map

package/dist/chunks/index-60201NKa.js.map

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

package/dist/chunks/index-CcQkbZBZ.cjs

@@ -0,0 +1,269 @@
+'use strict';
+
+/**
+ * Centralized Cache Service for PERS SDK
+ * Provides unified caching with memory management and consistent policies
+ */
+// Default cache configuration constants
+const DEFAULT_CACHE_CONFIG = {
+    defaultTtl: 30 * 60 * 1000, // 30 minutes
+    maxMemoryMB: 50, // 50MB cache limit
+    cleanupInterval: 5 * 60 * 1000, // Cleanup every 5 minutes
+    enableLRU: true
+};
+class CacheService {
+    constructor(config) {
+        this.cache = new Map();
+        this.cleanupTimer = null;
+        this.config = { ...DEFAULT_CACHE_CONFIG, ...config };
+        this.startCleanupTimer();
+    }
+    /**
+     * Set a value in cache with optional TTL
+     */
+    set(key, value, ttl) {
+        if (!key || typeof key !== 'string') {
+            throw new Error('Cache key must be a non-empty string');
+        }
+        if (value === undefined) {
+            console.warn('Cache: Attempted to cache undefined value for key:', key);
+            return;
+        }
+        const entry = {
+            value,
+            timestamp: Date.now(),
+            ttl: ttl || this.config.defaultTtl,
+            accessCount: 1,
+            lastAccessed: Date.now()
+        };
+        this.cache.set(key, entry);
+        this.enforceMemoryLimit();
+    }
+    /**
+     * Get a value from cache
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        // Check if expired
+        const now = Date.now();
+        if (now - entry.timestamp > entry.ttl) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Update access statistics for LRU
+        entry.accessCount++;
+        entry.lastAccessed = now;
+        return entry.value;
+    }
+    /**
+     * Get or set pattern - common caching pattern
+     */
+    async getOrSet(key, fetcher, ttl) {
+        const cached = this.get(key);
+        if (cached !== null) {
+            return cached;
+        }
+        try {
+            const value = await fetcher();
+            // Only cache non-undefined values
+            if (value !== undefined) {
+                this.set(key, value, ttl);
+            }
+            return value;
+        }
+        catch (error) {
+            console.error(`Cache: Error in fetcher for key '${key}':`, error);
+            throw error;
+        }
+    }
+    /**
+     * Delete a specific key
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all keys matching a prefix
+     */
+    clearByPrefix(prefix) {
+        let count = 0;
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(prefix)) {
+                this.cache.delete(key);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Clear all cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const entries = Array.from(this.cache.values());
+        if (entries.length === 0) {
+            return {
+                size: 0,
+                memoryUsageMB: 0,
+                hitRate: 0,
+                oldestEntry: 0
+            };
+        }
+        const totalAccess = entries.reduce((sum, entry) => sum + entry.accessCount, 0);
+        const entriesWithHits = entries.filter(entry => entry.accessCount > 1).length;
+        return {
+            size: this.cache.size,
+            memoryUsageMB: this.estimateMemoryUsage(),
+            hitRate: totalAccess > entries.length ? entriesWithHits / entries.length : 0,
+            oldestEntry: Math.min(...entries.map(entry => entry.timestamp))
+        };
+    }
+    /**
+     * Force cleanup of expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let cleanedCount = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > entry.ttl) {
+                this.cache.delete(key);
+                cleanedCount++;
+            }
+        }
+        return cleanedCount;
+    }
+    /**
+     * Start automatic cleanup timer
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+            this.enforceMemoryLimit();
+        }, this.config.cleanupInterval);
+    }
+    /**
+     * Stop automatic cleanup timer
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.clear();
+    }
+    /**
+     * Estimate memory usage (rough calculation)
+     */
+    estimateMemoryUsage() {
+        let totalSize = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            try {
+                // Key size (UTF-16 characters)
+                totalSize += key.length * 2;
+                // Value size estimation
+                const serializedValue = JSON.stringify(entry.value);
+                totalSize += serializedValue.length * 2;
+                // Cache entry metadata overhead
+                totalSize += 64;
+            }
+            catch (error) {
+                // If JSON.stringify fails, use rough estimation
+                console.warn('Cache: Failed to serialize entry for size estimation:', error);
+                totalSize += key.length * 2 + 1024; // Conservative estimate
+            }
+        }
+        return totalSize / (1024 * 1024); // Convert to MB
+    }
+    /**
+     * Enforce memory limit using LRU eviction
+     */
+    enforceMemoryLimit() {
+        const memoryUsage = this.estimateMemoryUsage();
+        if (memoryUsage <= this.config.maxMemoryMB || !this.config.enableLRU) {
+            return;
+        }
+        // Target 80% of limit to avoid frequent evictions
+        const targetSize = this.config.maxMemoryMB * 0.8;
+        // Sort by last accessed time (LRU) - oldest first
+        const sortedEntries = Array.from(this.cache.entries())
+            .sort((a, b) => a[1].lastAccessed - b[1].lastAccessed);
+        // Remove oldest entries until memory is under target
+        let currentMemory = memoryUsage;
+        let evictedCount = 0;
+        for (const [key] of sortedEntries) {
+            if (currentMemory <= targetSize)
+                break;
+            this.cache.delete(key);
+            evictedCount++;
+            // Re-estimate periodically for performance
+            if (evictedCount % 10 === 0) {
+                currentMemory = this.estimateMemoryUsage();
+            }
+        }
+        if (evictedCount > 0) {
+            console.debug(`Cache: Evicted ${evictedCount} entries to enforce memory limit`);
+        }
+    }
+    /**
+     * Create a namespaced cache interface for services
+     */
+    createNamespace(namespace) {
+        if (!namespace || typeof namespace !== 'string') {
+            throw new Error('Namespace must be a non-empty string');
+        }
+        if (namespace.includes(':')) {
+            throw new Error('Namespace cannot contain colon (:) character');
+        }
+        return {
+            set: (key, value, ttl) => {
+                if (!key)
+                    throw new Error('Cache key cannot be empty');
+                return this.set(`${namespace}:${key}`, value, ttl);
+            },
+            get: (key) => {
+                if (!key)
+                    throw new Error('Cache key cannot be empty');
+                return this.get(`${namespace}:${key}`);
+            },
+            getOrSet: (key, fetcher, ttl) => {
+                if (!key)
+                    throw new Error('Cache key cannot be empty');
+                return this.getOrSet(`${namespace}:${key}`, fetcher, ttl);
+            },
+            delete: (key) => {
+                if (!key)
+                    throw new Error('Cache key cannot be empty');
+                return this.delete(`${namespace}:${key}`);
+            },
+            clear: () => this.clearByPrefix(`${namespace}:`)
+        };
+    }
+}
+// Singleton instance with default configuration
+const globalCacheService = new CacheService();
+
+/**
+ * Cache module exports
+ */
+// Predefined cache TTL constants
+const CacheTTL = {
+    SHORT: 5 * 60 * 1000, // 5 minutes
+    MEDIUM: 30 * 60 * 1000, // 30 minutes  
+    LONG: 24 * 60 * 60 * 1000, // 24 hours
+    METADATA: 24 * 60 * 60 * 1000, // 24 hours - IPFS metadata is immutable
+    GATEWAY: 30 * 60 * 1000, // 30 minutes - Gateway config can change
+    PROVIDER: 60 * 60 * 1000, // 1 hour - Provider connections with auth
+};
+
+exports.CacheService = CacheService;
+exports.CacheTTL = CacheTTL;
+exports.globalCacheService = globalCacheService;
+//# sourceMappingURL=index-CcQkbZBZ.cjs.map

package/dist/chunks/index-CcQkbZBZ.cjs.map

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