@xbg.solutions/bpsk-utils-api-client 1.2.3

package/lib/services/caching/api-cache.service.d.ts

@@ -0,0 +1,97 @@
+/**
+ * API Response Caching Service
+ *
+ * Provides intelligent caching for API responses with support for
+ * different caching strategies and automatic cache invalidation.
+ */
+import { type CacheOptions } from './cache.service';
+export interface APIResponse<T = any> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    cached?: boolean;
+    cacheTimestamp?: number;
+}
+export interface APICacheOptions extends Omit<CacheOptions, 'storage'> {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: any;
+    strategy?: 'cache-first' | 'network-first' | 'cache-only' | 'network-only';
+    staleWhileRevalidate?: boolean;
+    storage?: 'memory' | 'localStorage' | 'sessionStorage' | 'indexedDB';
+    keyPrefix?: string;
+}
+declare class APICacheService {
+    private logger;
+    /**
+     * Generate cache key for request
+     */
+    private generateCacheKey;
+    /**
+     * Check if response should be cached
+     */
+    private shouldCache;
+    /**
+     * Get TTL from response headers
+     */
+    private getTTLFromHeaders;
+    /**
+     * Create response object from Response
+     */
+    private createAPIResponse;
+    /**
+     * Fetch with caching
+     */
+    fetch<T = any>(url: string, options?: APICacheOptions): Promise<APIResponse<T>>;
+    /**
+     * Fetch from network
+     */
+    private fetchFromNetwork;
+    /**
+     * Cache response if appropriate
+     */
+    private cacheResponse;
+    /**
+     * Invalidate cache for URL pattern
+     */
+    invalidate(urlPattern: string, options?: Partial<APICacheOptions>): Promise<void>;
+    /**
+     * Invalidate by URL pattern with wildcards
+     */
+    private invalidateByPattern;
+    /**
+     * Invalidate cache by tags
+     */
+    invalidateByTags(tags: string[], storage?: string): Promise<void>;
+    /**
+     * Prefetch and cache API responses
+     */
+    prefetch<T = any>(urls: string[], options?: APICacheOptions): Promise<void>;
+    /**
+     * Warmup cache with common requests
+     */
+    warmup(requests: Array<{
+        url: string;
+        options?: APICacheOptions;
+    }>): Promise<void>;
+    /**
+     * GET request with caching
+     */
+    get<T = any>(url: string, options?: Omit<APICacheOptions, 'method'>): Promise<APIResponse<T>>;
+    /**
+     * POST request (typically not cached)
+     */
+    post<T = any>(url: string, body?: any, options?: Omit<APICacheOptions, 'method' | 'body'>): Promise<APIResponse<T>>;
+    /**
+     * PUT request with cache invalidation
+     */
+    put<T = any>(url: string, body?: any, options?: Omit<APICacheOptions, 'method' | 'body'>): Promise<APIResponse<T>>;
+    /**
+     * DELETE request with cache invalidation
+     */
+    delete<T = any>(url: string, options?: Omit<APICacheOptions, 'method'>): Promise<APIResponse<T>>;
+}
+export declare const apiCacheService: APICacheService;
+export {};
+//# sourceMappingURL=api-cache.service.d.ts.map

package/lib/services/caching/api-cache.service.d.ts.map

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

package/lib/services/caching/api-cache.service.js

@@ -0,0 +1,294 @@
+/**
+ * API Response Caching Service
+ *
+ * Provides intelligent caching for API responses with support for
+ * different caching strategies and automatic cache invalidation.
+ */
+import { cacheService } from './cache.service';
+import { loggerService } from '@xbg.solutions/bpsk-core';
+class APICacheService {
+    constructor() {
+        this.logger = loggerService.withContext('APICacheService');
+    }
+    /**
+     * Generate cache key for request
+     */
+    generateCacheKey(url, options) {
+        const key = `${options.keyPrefix || 'api'}:${options.method || 'GET'}:${url}`;
+        // Include body and relevant headers in key for uniqueness
+        if (options.body) {
+            const bodyKey = typeof options.body === 'string'
+                ? options.body
+                : JSON.stringify(options.body);
+            return `${key}:${btoa(bodyKey).substring(0, 16)}`;
+        }
+        return key;
+    }
+    /**
+     * Check if response should be cached
+     */
+    shouldCache(response, options) {
+        // Don't cache errors by default
+        if (!response.ok) {
+            return false;
+        }
+        // Don't cache non-GET requests by default
+        const method = options.method?.toUpperCase() || 'GET';
+        if (method !== 'GET' && method !== 'HEAD') {
+            return false;
+        }
+        // Check cache-control headers
+        const cacheControl = response.headers.get('cache-control');
+        if (cacheControl?.includes('no-cache') || cacheControl?.includes('no-store')) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get TTL from response headers
+     */
+    getTTLFromHeaders(response, defaultTTL = 5 * 60 * 1000) {
+        const cacheControl = response.headers.get('cache-control');
+        if (cacheControl) {
+            const maxAgeMatch = cacheControl.match(/max-age=(\d+)/);
+            if (maxAgeMatch) {
+                return parseInt(maxAgeMatch[1]) * 1000; // Convert seconds to milliseconds
+            }
+        }
+        const expires = response.headers.get('expires');
+        if (expires) {
+            const expiresTime = new Date(expires).getTime();
+            const now = Date.now();
+            if (expiresTime > now) {
+                return expiresTime - now;
+            }
+        }
+        return defaultTTL;
+    }
+    /**
+     * Create response object from Response
+     */
+    async createAPIResponse(response, cached = false, cacheTimestamp) {
+        const data = await response.json();
+        const headers = {};
+        response.headers.forEach((value, key) => {
+            headers[key] = value;
+        });
+        return {
+            data,
+            status: response.status,
+            statusText: response.statusText,
+            headers,
+            cached,
+            cacheTimestamp
+        };
+    }
+    /**
+     * Fetch with caching
+     */
+    async fetch(url, options = {}) {
+        const cacheKey = this.generateCacheKey(url, options);
+        const strategy = options.strategy || 'cache-first';
+        const storage = options.storage || 'memory';
+        // Cache-only strategy
+        if (strategy === 'cache-only') {
+            const cached = await cacheService.get(cacheKey, storage);
+            if (cached) {
+                this.logger.debug('Cache hit (cache-only)', { url, cacheKey });
+                return { ...cached, cached: true };
+            }
+            throw new Error(`No cached response for ${url}`);
+        }
+        // Network-only strategy
+        if (strategy === 'network-only') {
+            return this.fetchFromNetwork(url, options);
+        }
+        // Cache-first strategy
+        if (strategy === 'cache-first') {
+            const cached = await cacheService.get(cacheKey, storage);
+            if (cached) {
+                this.logger.debug('Cache hit (cache-first)', { url, cacheKey });
+                // Stale while revalidate
+                if (options.staleWhileRevalidate) {
+                    this.fetchFromNetwork(url, options).then(response => {
+                        this.cacheResponse(cacheKey, response, options);
+                    }).catch(error => {
+                        this.logger.warn('Background revalidation failed', error);
+                    });
+                }
+                return { ...cached, cached: true };
+            }
+            this.logger.debug('Cache miss (cache-first)', { url, cacheKey });
+            const response = await this.fetchFromNetwork(url, options);
+            await this.cacheResponse(cacheKey, response, options);
+            return response;
+        }
+        // Network-first strategy
+        if (strategy === 'network-first') {
+            try {
+                const response = await this.fetchFromNetwork(url, options);
+                await this.cacheResponse(cacheKey, response, options);
+                return response;
+            }
+            catch (error) {
+                this.logger.warn('Network request failed, falling back to cache', error);
+                const cached = await cacheService.get(cacheKey, storage);
+                if (cached) {
+                    this.logger.debug('Cache hit (network-first fallback)', { url, cacheKey });
+                    return { ...cached, cached: true };
+                }
+                throw error;
+            }
+        }
+        throw new Error(`Unknown cache strategy: ${strategy}`);
+    }
+    /**
+     * Fetch from network
+     */
+    async fetchFromNetwork(url, options) {
+        const fetchOptions = {
+            method: options.method || 'GET',
+            headers: options.headers,
+            body: options.body
+        };
+        const response = await fetch(url, fetchOptions);
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return this.createAPIResponse(response);
+    }
+    /**
+     * Cache response if appropriate
+     */
+    async cacheResponse(cacheKey, response, options) {
+        const mockResponse = new Response(JSON.stringify(response.data), {
+            status: response.status,
+            statusText: response.statusText,
+            headers: response.headers
+        });
+        if (!this.shouldCache(mockResponse, options)) {
+            return;
+        }
+        const ttl = options.ttl || this.getTTLFromHeaders(mockResponse);
+        const cacheOptions = {
+            ttl,
+            tags: options.tags,
+            storage: options.storage || 'memory'
+        };
+        await cacheService.set(cacheKey, response, cacheOptions);
+        this.logger.debug('Response cached', {
+            cacheKey,
+            ttl,
+            storage: cacheOptions.storage
+        });
+    }
+    /**
+     * Invalidate cache for URL pattern
+     */
+    async invalidate(urlPattern, options = {}) {
+        const storage = options.storage || 'memory';
+        const keyPrefix = options.keyPrefix || 'api';
+        // Simple pattern matching - could be enhanced with regex
+        const pattern = `${keyPrefix}:${options.method || 'GET'}:${urlPattern}`;
+        if (pattern.includes('*')) {
+            // Wildcard invalidation
+            await this.invalidateByPattern(pattern, storage);
+        }
+        else {
+            // Exact match invalidation
+            await cacheService.delete(pattern, storage);
+        }
+    }
+    /**
+     * Invalidate by URL pattern with wildcards
+     */
+    async invalidateByPattern(pattern, storage) {
+        // Convert pattern to regex
+        const regexPattern = pattern.replace(/\*/g, '.*');
+        const regex = new RegExp(`^${regexPattern}$`);
+        // This is a simplified implementation
+        // In a production system, you might want to use tags for more efficient invalidation
+        const allKeys = await cacheService.keys(storage);
+        const matchingKeys = allKeys.filter(key => regex.test(key));
+        await Promise.all(matchingKeys.map(key => cacheService.delete(key, storage)));
+        this.logger.info(`Invalidated ${matchingKeys.length} cached responses`, { pattern, storage });
+    }
+    /**
+     * Invalidate cache by tags
+     */
+    async invalidateByTags(tags, storage = 'memory') {
+        await cacheService.invalidateByTags(tags, storage);
+        this.logger.info('Invalidated cache by tags', { tags, storage });
+    }
+    /**
+     * Prefetch and cache API responses
+     */
+    async prefetch(urls, options = {}) {
+        const prefetchOptions = {
+            ...options,
+            strategy: 'network-first'
+        };
+        const promises = urls.map(url => this.fetch(url, prefetchOptions).catch(error => {
+            this.logger.warn(`Prefetch failed for ${url}`, error);
+        }));
+        await Promise.allSettled(promises);
+        this.logger.info(`Prefetched ${urls.length} URLs`);
+    }
+    /**
+     * Warmup cache with common requests
+     */
+    async warmup(requests) {
+        const promises = requests.map(({ url, options = {} }) => this.fetch(url, { ...options, strategy: 'network-first' }).catch(error => {
+            this.logger.warn(`Warmup failed for ${url}`, error);
+        }));
+        await Promise.allSettled(promises);
+        this.logger.info(`Warmed up cache with ${requests.length} requests`);
+    }
+    /**
+     * GET request with caching
+     */
+    async get(url, options = {}) {
+        return this.fetch(url, { ...options, method: 'GET' });
+    }
+    /**
+     * POST request (typically not cached)
+     */
+    async post(url, body, options = {}) {
+        return this.fetch(url, {
+            ...options,
+            method: 'POST',
+            body: typeof body === 'string' ? body : JSON.stringify(body),
+            strategy: 'network-only' // POST requests shouldn't be cached by default
+        });
+    }
+    /**
+     * PUT request with cache invalidation
+     */
+    async put(url, body, options = {}) {
+        const response = await this.fetch(url, {
+            ...options,
+            method: 'PUT',
+            body: typeof body === 'string' ? body : JSON.stringify(body),
+            strategy: 'network-only'
+        });
+        // Invalidate related cache entries
+        await this.invalidate(url.split('?')[0] + '*', options);
+        return response;
+    }
+    /**
+     * DELETE request with cache invalidation
+     */
+    async delete(url, options = {}) {
+        const response = await this.fetch(url, {
+            ...options,
+            method: 'DELETE',
+            strategy: 'network-only'
+        });
+        // Invalidate related cache entries
+        await this.invalidate(url.split('?')[0] + '*', options);
+        return response;
+    }
+}
+// Export singleton instance
+export const apiCacheService = new APICacheService();
+//# sourceMappingURL=api-cache.service.js.map

package/lib/services/caching/api-cache.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-cache.service.js","sourceRoot":"","sources":["../../../src/services/caching/api-cache.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAqB,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAqBzD,MAAM,eAAe;IAArB;QACU,WAAM,GAAG,aAAa,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAyVhE,CAAC;IAvVC;;OAEG;IACK,gBAAgB,CAAC,GAAW,EAAE,OAAwB;QAC5D,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QAE9E,0DAA0D;QAC1D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAC9C,CAAC,CAAC,OAAO,CAAC,IAAI;gBACd,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACpD,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,QAAkB,EAAE,OAAwB;QAC9D,gCAAgC;QAChC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,0CAA0C;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;QACtD,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,8BAA8B;QAC9B,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC3D,IAAI,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7E,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,QAAkB,EAAE,aAAqB,CAAC,GAAG,EAAE,GAAG,IAAI;QAC9E,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC3D,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACxD,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,kCAAkC;YAC5E,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,WAAW,GAAG,GAAG,EAAE,CAAC;gBACtB,OAAO,WAAW,GAAG,GAAG,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAC7B,QAAkB,EAClB,SAAkB,KAAK,EACvB,cAAuB;QAEvB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAO,CAAC;QACxC,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACtC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,OAAO;YACP,MAAM;YACN,cAAc;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAU,GAAW,EAAE,UAA2B,EAAE;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC;QAE5C,sBAAsB;QACtB,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAiB,QAAQ,EAAE,OAAO,CAAC,CAAC;YACzE,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC/D,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACrC,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,wBAAwB;QACxB,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,gBAAgB,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,uBAAuB;QACvB,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAiB,QAAQ,EAAE,OAAO,CAAC,CAAC;YACzE,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAEhE,yBAAyB;gBACzB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;oBACjC,IAAI,CAAC,gBAAgB,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE;wBACrD,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;oBAClD,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;wBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;oBAC5D,CAAC,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACrC,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC;YAC9D,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,yBAAyB;QACzB,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC;gBAC9D,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACtD,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE,KAAgC,CAAC,CAAC;gBAEpG,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAiB,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACzE,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC3E,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACrC,CAAC;gBAED,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAI,GAAW,EAAE,OAAwB;QACrE,MAAM,YAAY,GAAgB;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;YAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAI,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CACzB,QAAgB,EAChB,QAAwB,EACxB,OAAwB;QAExB,MAAM,YAAY,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAC/D,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAChE,MAAM,YAAY,GAAiB;YACjC,GAAG;YACH,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,QAAQ;SACrC,CAAC;QAEF,MAAM,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAEzD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;YACnC,QAAQ;YACR,GAAG;YACH,OAAO,EAAE,YAAY,CAAC,OAAO;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,UAAoC,EAAE;QACzE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC;QAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAE7C,yDAAyD;QACzD,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,IAAI,UAAU,EAAE,CAAC;QAExE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,wBAAwB;YACxB,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,MAAM,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB,CAAC,OAAe,EAAE,OAAe;QAChE,2BAA2B;QAC3B,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAE9C,sCAAsC;QACtC,qFAAqF;QACrF,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAE5D,MAAM,OAAO,CAAC,GAAG,CACf,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAC3D,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,YAAY,CAAC,MAAM,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAAc,EAAE,UAAkB,QAAQ;QAC/D,MAAM,YAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAU,IAAc,EAAE,UAA2B,EAAE;QACnE,MAAM,eAAe,GAAG;YACtB,GAAG,OAAO;YACV,QAAQ,EAAE,eAAwB;SACnC,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAC9B,IAAI,CAAC,KAAK,CAAI,GAAG,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuB,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,QAA2D;QACtE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,EAAE,CACtD,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YACvE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAU,GAAW,EAAE,UAA2C,EAAE;QAC3E,OAAO,IAAI,CAAC,KAAK,CAAI,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAU,GAAW,EAAE,IAAU,EAAE,UAAoD,EAAE;QACjG,OAAO,IAAI,CAAC,KAAK,CAAI,GAAG,EAAE;YACxB,GAAG,OAAO;YACV,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC5D,QAAQ,EAAE,cAAc,CAAC,+CAA+C;SACzE,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAU,GAAW,EAAE,IAAU,EAAE,UAAoD,EAAE;QAChG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAI,GAAG,EAAE;YACxC,GAAG,OAAO;YACV,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC5D,QAAQ,EAAE,cAAc;SACzB,CAAC,CAAC;QAEH,mCAAmC;QACnC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC;QAExD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAU,GAAW,EAAE,UAA2C,EAAE;QAC9E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAI,GAAG,EAAE;YACxC,GAAG,OAAO;YACV,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,cAAc;SACzB,CAAC,CAAC;QAEH,mCAAmC;QACnC,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC;QAExD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/lib/services/caching/cache.service.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Caching Service
+ *
+ * Provides multiple levels of caching: memory, localStorage, sessionStorage,
+ * and IndexedDB for different use cases and data sizes.
+ */
+import { type Writable } from 'svelte/store';
+export interface CacheItem<T = any> {
+    key: string;
+    value: T;
+    expiresAt: number;
+    createdAt: number;
+    tags?: string[];
+    size?: number;
+}
+export interface CacheOptions {
+    ttl?: number;
+    tags?: string[];
+    storage?: 'memory' | 'localStorage' | 'sessionStorage' | 'indexedDB';
+    compress?: boolean;
+    maxSize?: number;
+}
+export interface CacheStats {
+    hitCount: number;
+    missCount: number;
+    hitRate: number;
+    itemCount: number;
+    totalSize: number;
+    evictedCount: number;
+}
+/**
+ * Main cache service
+ */
+declare class CacheService {
+    private storages;
+    private stats;
+    private logger;
+    constructor();
+    /**
+     * Get item from cache
+     */
+    get<T = any>(key: string, storage?: string): Promise<T | null>;
+    /**
+     * Set item in cache
+     */
+    set<T = any>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    /**
+     * Delete item from cache
+     */
+    delete(key: string, storage?: string): Promise<void>;
+    /**
+     * Clear all items from cache
+     */
+    clear(storage?: string): Promise<void>;
+    /**
+     * Get or set cached value
+     */
+    getOrSet<T = any>(key: string, factory: () => Promise<T> | T, options?: CacheOptions): Promise<T>;
+    /**
+     * Invalidate cache by tags
+     */
+    invalidateByTags(tags: string[], storage?: string): Promise<void>;
+    /**
+     * Clean up expired items
+     */
+    cleanupExpired(): Promise<void>;
+    /**
+     * Get all keys from a specific storage
+     */
+    keys(storage?: string): Promise<string[]>;
+    /**
+     * Get cache statistics
+     */
+    getStats(): Writable<CacheStats>;
+    /**
+     * Estimate object size in bytes
+     */
+    private estimateSize;
+    /**
+     * Update cache statistics
+     */
+    private updateStats;
+}
+export declare const cacheService: CacheService;
+export {};
+//# sourceMappingURL=cache.service.d.ts.map

package/lib/services/caching/cache.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.service.d.ts","sourceRoot":"","sources":["../../../src/services/caching/cache.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGvD,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,gBAAgB,GAAG,WAAW,CAAC;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AA2UD;;GAEG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,KAAK,CAOV;IACH,OAAO,CAAC,MAAM,CAA6C;;IAc3D;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA+B9E;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BpF;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE;;OAEG;IACG,KAAK,CAAC,OAAO,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC7B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC;IAWb;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBjF;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BrC;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE,MAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMzD;;OAEG;IACH,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC;IAIhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,WAAW;CAcpB;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}