@lionrapid/core 0.6.1 → 0.6.3

package/dist/browser/storage/cache-storage-repository.d.ts

@@ -1,6 +1,9 @@
 /**
  * CacheStorageRepository - Cache API-based persistent storage (Browser Bundle Version)
  * Implements IAsyncRepository for asynchronous access to Cache API
+ *
+ * This provides Layer 3 caching in the handler chain:
+ * 1. Memory (sync) → 2. LocalStorage (sync) → 3. CacheStorage (async) → 4. Network (async)
  */
 import type { IAsyncRepository } from '../../interfaces/repository.interface.js';
 import type { StorageRepositoryConfig } from '../../config/repository.config.js';
@@ -10,12 +13,34 @@ import type { TranslationData } from '../../types/translation-data.types.js';
  */
 export interface CacheStorageRepositoryConfig extends StorageRepositoryConfig {
     options?: StorageRepositoryConfig['options'] & {
+        /** Cache name for the Cache API (default: 'lionrapid-v1') */
         cacheName?: string;
+        /** TTL in milliseconds (default: 7 days) */
         ttl?: number;
     };
 }
 /**
  * Cache API-based repository for persistent translation caching
+ *
+ * Features:
+ * - Asynchronous access (Cache API is async)
+ * - TTL-based expiration
+ * - Larger storage capacity than localStorage
+ * - Graceful fallback when Cache API unavailable (SSR, old browsers)
+ * - Works alongside Service Worker for offline support
+ *
+ * @example
+ * ```typescript
+ * import { CacheStorageRepository } from '@lionrapid/storage';
+ *
+ * const cacheRepo = new CacheStorageRepository({
+ *   enabled: true,
+ *   options: {
+ *     cacheName: 'my-app-translations',
+ *     ttl: 7 * 24 * 60 * 60 * 1000, // 7 days
+ *   },
+ * });
+ * ```
  */
 export declare class CacheStorageRepository implements IAsyncRepository<CacheStorageRepositoryConfig> {
     readonly name = "CacheStorageRepository";
@@ -25,17 +50,57 @@ export declare class CacheStorageRepository implements IAsyncRepository<CacheSto
     private defaultTTL;
     private available;
     constructor(config?: CacheStorageRepositoryConfig);
+    /**
+     * Check if Cache API is available
+     * Returns false in SSR, old browsers, or insecure contexts
+     */
     private checkAvailability;
+    /**
+     * Get a translation value by key
+     * @throws {TranslationNotFoundError} When translation doesn't exist or is expired
+     */
     get(key: string): Promise<string>;
+    /**
+     * Set a translation value
+     */
     set(key: string, value: string): Promise<void>;
+    /**
+     * Remove a translation by key
+     */
     remove(key: string): Promise<void>;
+    /**
+     * Clear all LionRapid entries from the cache
+     */
     clear(): Promise<void>;
+    /**
+     * Clear all entries for a specific namespace
+     */
     clearNamespace(locale: string, namespace: string): Promise<void>;
+    /**
+     * Get namespace translations
+     * @throws {TranslationNotFoundError} When namespace doesn't exist
+     */
     getNamespace(locale: string, namespace: string): Promise<TranslationData>;
+    /**
+     * Set namespace translations
+     */
     setNamespace(locale: string, namespace: string, translations: TranslationData): Promise<void>;
+    /**
+     * Get repository configuration
+     */
     getConfig(): CacheStorageRepositoryConfig;
+    /**
+     * Check if Cache API is available
+     */
     isAvailable(): boolean;
+    /**
+     * Get all cached entries (for debugging)
+     * Returns an object mapping keys to values
+     */
     getEntries(): Promise<Record<string, string>>;
+    /**
+     * Get cache statistics
+     */
     getCacheStats(): Promise<{
         size: number;
         cacheName: string;

package/dist/browser/storage/cache-storage-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-storage-repository.d.ts","sourceRoot":"","sources":["../../../src/browser/storage/cache-storage-repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAe7E;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,uBAAuB;IAC3E,OAAO,CAAC,EAAE,uBAAuB,CAAC,SAAS,CAAC,GAAG;QAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,sBACX,YAAW,gBAAgB,CAAC,4BAA4B,CAAC;IAEzD,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,IAAI,YAAsB;IACnC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAE9C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,GAAE,4BAAiC;IAgBrD,OAAO,CAAC,iBAAiB;IAInB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BjC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB9C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BhE,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC;IAYrB,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;IAKhB,SAAS,IAAI,4BAA4B;IAIzC,WAAW,IAAI,OAAO;IAIhB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA6B7C,aAAa,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAepE"}
+{"version":3,"file":"cache-storage-repository.d.ts","sourceRoot":"","sources":["../../../src/browser/storage/cache-storage-repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAoB7E;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,uBAAuB;IAC3E,OAAO,CAAC,EAAE,uBAAuB,CAAC,SAAS,CAAC,GAAG;QAC7C,6DAA6D;QAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,4CAA4C;QAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBACX,YAAW,gBAAgB,CAAC,4BAA4B,CAAC;IAEzD,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,IAAI,YAAsB;IACnC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAE9C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,GAAE,4BAAiC;IAgBrD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;OAGG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BvC;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpD;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BtE;;;OAGG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC;IAY3B;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACH,SAAS,IAAI,4BAA4B;IAIzC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA6BnD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAepE"}

package/dist/browser/storage/cache-storage-repository.js

@@ -1,12 +1,40 @@
 /**
  * CacheStorageRepository - Cache API-based persistent storage (Browser Bundle Version)
  * Implements IAsyncRepository for asynchronous access to Cache API
+ *
+ * This provides Layer 3 caching in the handler chain:
+ * 1. Memory (sync) → 2. LocalStorage (sync) → 3. CacheStorage (async) → 4. Network (async)
  */
 import { TranslationNotFoundError } from '../../errors/translation-errors.js';
 const CACHE_NAME = 'lionrapid-v1';
-const CACHE_PREFIX = 'lionrapid:';
+// The Cache API only accepts http/https request URLs as keys — `cache.put`
+// throws `TypeError: Request scheme '…' is unsupported` for a bare string like
+// `lionrapid:…`, which silently killed every write (caught by set()'s guard).
+// Use a synthetic https origin so keys are valid Requests. The host never
+// resolves; it only namespaces entries inside the named cache.
+const CACHE_PREFIX = 'https://cache.lionrapid.internal/';
 /**
  * Cache API-based repository for persistent translation caching
+ *
+ * Features:
+ * - Asynchronous access (Cache API is async)
+ * - TTL-based expiration
+ * - Larger storage capacity than localStorage
+ * - Graceful fallback when Cache API unavailable (SSR, old browsers)
+ * - Works alongside Service Worker for offline support
+ *
+ * @example
+ * ```typescript
+ * import { CacheStorageRepository } from '@lionrapid/storage';
+ *
+ * const cacheRepo = new CacheStorageRepository({
+ *   enabled: true,
+ *   options: {
+ *     cacheName: 'my-app-translations',
+ *     ttl: 7 * 24 * 60 * 60 * 1000, // 7 days
+ *   },
+ * });
+ * ```
  */
 export class CacheStorageRepository {
     name = 'CacheStorageRepository';
@@ -21,7 +49,7 @@ export class CacheStorageRepository {
             priority: config.priority ?? 0,
             options: {
                 cacheName: config.options?.cacheName ?? CACHE_NAME,
-                ttl: config.options?.ttl ?? 7 * 24 * 60 * 60 * 1000,
+                ttl: config.options?.ttl ?? 7 * 24 * 60 * 60 * 1000, // 7 days default
                 ...config.options,
             },
         };
@@ -29,9 +57,17 @@ export class CacheStorageRepository {
         this.defaultTTL = this.config.options?.ttl ?? 7 * 24 * 60 * 60 * 1000;
         this.available = this.checkAvailability();
     }
+    /**
+     * Check if Cache API is available
+     * Returns false in SSR, old browsers, or insecure contexts
+     */
     checkAvailability() {
         return typeof caches !== 'undefined';
     }
+    /**
+     * Get a translation value by key
+     * @throws {TranslationNotFoundError} When translation doesn't exist or is expired
+     */
     async get(key) {
         if (!this.available) {
             throw new TranslationNotFoundError(key);
@@ -43,6 +79,7 @@ export class CacheStorageRepository {
                 throw new TranslationNotFoundError(key);
             }
             const data = await response.json();
+            // Check TTL expiry
             if (data.expiry !== null && Date.now() > data.expiry) {
                 await cache.delete(CACHE_PREFIX + key);
                 throw new TranslationNotFoundError(key);
@@ -53,9 +90,13 @@ export class CacheStorageRepository {
             if (error instanceof TranslationNotFoundError) {
                 throw error;
             }
+            // Wrap any other error as not found
             throw new TranslationNotFoundError(key);
         }
     }
+    /**
+     * Set a translation value
+     */
     async set(key, value) {
         if (!this.available)
             return;
@@ -74,6 +115,9 @@ export class CacheStorageRepository {
             // Silently fail - cache is non-critical
         }
     }
+    /**
+     * Remove a translation by key
+     */
     async remove(key) {
         if (!this.available)
             return;
@@ -85,6 +129,9 @@ export class CacheStorageRepository {
             // Silently fail
         }
     }
+    /**
+     * Clear all LionRapid entries from the cache
+     */
     async clear() {
         if (!this.available)
             return;
@@ -92,13 +139,16 @@ export class CacheStorageRepository {
             const cache = await caches.open(this.cacheName);
             const keys = await cache.keys();
             await Promise.all(keys
-                .filter((request) => request.url.includes(CACHE_PREFIX))
-                .map((request) => cache.delete(request)));
+                .filter(request => request.url.includes(CACHE_PREFIX))
+                .map(request => cache.delete(request)));
         }
         catch {
             // Silently fail
         }
     }
+    /**
+     * Clear all entries for a specific namespace
+     */
     async clearNamespace(locale, namespace) {
         if (!this.available)
             return;
@@ -108,19 +158,23 @@ export class CacheStorageRepository {
             const cache = await caches.open(this.cacheName);
             const keys = await cache.keys();
             await Promise.all(keys
-                .filter((request) => {
+                .filter(request => {
                 const url = request.url;
                 const key = url.includes(CACHE_PREFIX)
                     ? url.substring(url.indexOf(CACHE_PREFIX) + CACHE_PREFIX.length)
                     : '';
                 return key === namespaceCacheKey || key.startsWith(keyPrefix);
             })
-                .map((request) => cache.delete(request)));
+                .map(request => cache.delete(request)));
         }
         catch {
             // Silently fail
         }
     }
+    /**
+     * Get namespace translations
+     * @throws {TranslationNotFoundError} When namespace doesn't exist
+     */
     async getNamespace(locale, namespace) {
         const namespaceCacheKey = `@${locale}:${namespace}`;
         const value = await this.get(namespaceCacheKey);
@@ -132,16 +186,29 @@ export class CacheStorageRepository {
             throw new TranslationNotFoundError(namespaceCacheKey);
         }
     }
+    /**
+     * Set namespace translations
+     */
     async setNamespace(locale, namespace, translations) {
         const namespaceCacheKey = `@${locale}:${namespace}`;
         await this.set(namespaceCacheKey, JSON.stringify(translations));
     }
+    /**
+     * Get repository configuration
+     */
     getConfig() {
         return this.config;
     }
+    /**
+     * Check if Cache API is available
+     */
     isAvailable() {
         return this.available;
     }
+    /**
+     * Get all cached entries (for debugging)
+     * Returns an object mapping keys to values
+     */
     async getEntries() {
         const entries = {};
         if (!this.available)
@@ -168,6 +235,9 @@ export class CacheStorageRepository {
         }
         return entries;
     }
+    /**
+     * Get cache statistics
+     */
     async getCacheStats() {
         if (!this.available) {
             return { size: 0, cacheName: this.cacheName };
@@ -175,7 +245,7 @@ export class CacheStorageRepository {
         try {
             const cache = await caches.open(this.cacheName);
             const keys = await cache.keys();
-            const size = keys.filter((r) => r.url.includes(CACHE_PREFIX)).length;
+            const size = keys.filter(r => r.url.includes(CACHE_PREFIX)).length;
             return { size, cacheName: this.cacheName };
         }
         catch {

package/dist/browser/storage/cache-storage-repository.js.map

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

package/dist/browser/storage/localstorage-repository.d.ts

@@ -10,13 +10,23 @@ import type { TranslationData } from '../../types/translation-data.types.js';
  */
 export interface LocalStorageRepositoryConfig extends MemoryRepositoryConfig {
     options?: MemoryRepositoryConfig['options'] & {
+        /** Storage key prefix (default: 'lionrapid:') */
         prefix?: string;
+        /** TTL in milliseconds (default: 24 hours) */
         ttl?: number;
+        /** Maximum number of entries before eviction (default: 500) */
         maxSize?: number;
     };
 }
 /**
  * LocalStorage-based repository for persistent translation caching
+ *
+ * Features:
+ * - Synchronous access (localStorage is sync)
+ * - TTL-based expiration
+ * - Graceful fallback when localStorage unavailable (SSR, private mode)
+ * - Automatic eviction when quota exceeded
+ * - Version migration support
  */
 export declare class LocalStorageRepository implements ISyncRepository<LocalStorageRepositoryConfig>, IStatsProvider {
     readonly name = "LocalStorageRepository";
@@ -27,21 +37,73 @@ export declare class LocalStorageRepository implements ISyncRepository<LocalStor
     private defaultTTL;
     private maxSize;
     constructor(config?: LocalStorageRepositoryConfig);
+    /**
+     * Check if localStorage is available
+     * Returns false in SSR, private browsing, or when quota is 0
+     */
     private checkAvailability;
+    /**
+     * Handle version migrations - clear cache when version changes
+     */
     private migrateIfNeeded;
+    /**
+     * Get a translation value by key
+     * Returns null if not found or expired
+     */
     get(key: string): string | null;
+    /**
+     * Set a translation value
+     * Automatically handles quota exceeded by evicting oldest entries
+     */
     set(key: string, value: string): void;
+    /**
+     * Remove a translation by key
+     */
     remove(key: string): void;
+    /**
+     * Clear all LionRapid entries from localStorage
+     * Preserves entries from other applications
+     */
     clear(): void;
+    /**
+     * Clear all entries for a specific namespace
+     */
     clearNamespace(locale: string, namespace: string): void;
+    /**
+     * Get namespace translations
+     */
     getNamespace(locale: string, namespace: string): TranslationData | null;
+    /**
+     * Set namespace translations
+     */
     setNamespace(locale: string, namespace: string, translations: TranslationData): void;
+    /**
+     * Get all cache entries for debugging
+     */
     getEntries(): Record<string, string>;
+    /**
+     * Get repository configuration
+     */
     getConfig(): LocalStorageRepositoryConfig;
+    /**
+     * Check if localStorage is available
+     */
     isAvailable(): boolean;
+    /**
+     * Get the number of entries in the cache
+     */
     private getEntryCount;
+    /**
+     * Check if error is a quota exceeded error
+     */
     private isQuotaError;
+    /**
+     * Evict oldest 25% of entries when quota is exceeded
+     */
     private evictOldest;
+    /**
+     * Get cache statistics
+     */
     getCacheStats(): {
         size: number;
         maxSize: number;

package/dist/browser/storage/localstorage-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localstorage-repository.d.ts","sourceRoot":"","sources":["../../../src/browser/storage/localstorage-repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAe7E;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E,OAAO,CAAC,EAAE,sBAAsB,CAAC,SAAS,CAAC,GAAG;QAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,sBACX,YAAW,eAAe,CAAC,4BAA4B,CAAC,EAAE,cAAc;IAExE,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,IAAI,WAAqB;IAClC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAE9C,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,4BAAiC;IAsBrD,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,eAAe;IAYvB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAqB/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA6BrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAUzB,KAAK,IAAI,IAAI;IAiBb,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAuBvD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAavE,YAAY,CACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,eAAe,GAC5B,IAAI;IAKP,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAwBpC,SAAS,IAAI,4BAA4B;IAIzC,WAAW,IAAI,OAAO;IAItB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,WAAW;IAkCnB,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAWlE"}
+{"version":3,"file":"localstorage-repository.d.ts","sourceRoot":"","sources":["../../../src/browser/storage/localstorage-repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAe7E;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,sBAAsB;IAC1E,OAAO,CAAC,EAAE,sBAAsB,CAAC,SAAS,CAAC,GAAG;QAC5C,iDAAiD;QACjD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,8CAA8C;QAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,+DAA+D;QAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,qBAAa,sBACX,YAAW,eAAe,CAAC,4BAA4B,CAAC,EAAE,cAAc;IAExE,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,IAAI,WAAqB;IAClC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAE9C,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,GAAE,4BAAiC;IAsBrD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAsB/B;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA+BrC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAUzB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAiBb;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAuBvD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAavE;;OAEG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,eAAe,GAC5B,IAAI;IAKP;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAwBpC;;OAEG;IACH,SAAS,IAAI,4BAA4B;IAIzC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsCnB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAWlE"}

package/dist/browser/storage/localstorage-repository.js

@@ -7,6 +7,13 @@ const VERSION_KEY = `${STORAGE_PREFIX}version`;
 const CURRENT_VERSION = '1';
 /**
  * LocalStorage-based repository for persistent translation caching
+ *
+ * Features:
+ * - Synchronous access (localStorage is sync)
+ * - TTL-based expiration
+ * - Graceful fallback when localStorage unavailable (SSR, private mode)
+ * - Automatic eviction when quota exceeded
+ * - Version migration support
  */
 export class LocalStorageRepository {
     name = 'LocalStorageRepository';
@@ -19,10 +26,10 @@ export class LocalStorageRepository {
     constructor(config = {}) {
         this.config = {
             enabled: config.enabled ?? true,
-            priority: config.priority ?? 0,
+            priority: config.priority ?? 0, // Use build sequence by default
             options: {
                 prefix: config.options?.prefix ?? STORAGE_PREFIX,
-                ttl: config.options?.ttl ?? 24 * 60 * 60 * 1000,
+                ttl: config.options?.ttl ?? 24 * 60 * 60 * 1000, // 24 hours default
                 maxSize: config.options?.maxSize ?? 500,
                 ...config.options,
             },
@@ -35,6 +42,10 @@ export class LocalStorageRepository {
             this.migrateIfNeeded();
         }
     }
+    /**
+     * Check if localStorage is available
+     * Returns false in SSR, private browsing, or when quota is 0
+     */
     checkAvailability() {
         if (typeof window === 'undefined') {
             return false;
@@ -49,6 +60,9 @@ export class LocalStorageRepository {
             return false;
         }
     }
+    /**
+     * Handle version migrations - clear cache when version changes
+     */
     migrateIfNeeded() {
         try {
             const storedVersion = window.localStorage.getItem(VERSION_KEY);
@@ -61,6 +75,10 @@ export class LocalStorageRepository {
             // Ignore migration errors
         }
     }
+    /**
+     * Get a translation value by key
+     * Returns null if not found or expired
+     */
     get(key) {
         if (!this.available)
             return null;
@@ -70,6 +88,7 @@ export class LocalStorageRepository {
             if (!itemStr)
                 return null;
             const item = JSON.parse(itemStr);
+            // Check TTL expiry
             if (item.expiry !== null && Date.now() > item.expiry) {
                 window.localStorage.removeItem(fullKey);
                 return null;
@@ -80,6 +99,10 @@ export class LocalStorageRepository {
             return null;
         }
     }
+    /**
+     * Set a translation value
+     * Automatically handles quota exceeded by evicting oldest entries
+     */
     set(key, value) {
         if (!this.available)
             return;
@@ -90,6 +113,7 @@ export class LocalStorageRepository {
             timestamp: Date.now(),
         };
         try {
+            // Check entry count and evict if needed
             const entryCount = this.getEntryCount();
             if (entryCount >= this.maxSize) {
                 this.evictOldest();
@@ -99,6 +123,7 @@ export class LocalStorageRepository {
         catch (error) {
             if (this.isQuotaError(error)) {
                 this.evictOldest();
+                // Retry once after eviction
                 try {
                     window.localStorage.setItem(fullKey, JSON.stringify(item));
                 }
@@ -108,6 +133,9 @@ export class LocalStorageRepository {
             }
         }
     }
+    /**
+     * Remove a translation by key
+     */
     remove(key) {
         if (!this.available)
             return;
@@ -118,6 +146,10 @@ export class LocalStorageRepository {
             // Ignore removal errors
         }
     }
+    /**
+     * Clear all LionRapid entries from localStorage
+     * Preserves entries from other applications
+     */
     clear() {
         if (!this.available)
             return;
@@ -129,12 +161,15 @@ export class LocalStorageRepository {
                     keysToRemove.push(key);
                 }
             }
-            keysToRemove.forEach((k) => window.localStorage.removeItem(k));
+            keysToRemove.forEach(k => window.localStorage.removeItem(k));
         }
         catch {
             // Ignore clear errors
         }
     }
+    /**
+     * Clear all entries for a specific namespace
+     */
     clearNamespace(locale, namespace) {
         if (!this.available)
             return;
@@ -151,12 +186,15 @@ export class LocalStorageRepository {
                     keysToRemove.push(key);
                 }
             }
-            keysToRemove.forEach((k) => window.localStorage.removeItem(k));
+            keysToRemove.forEach(k => window.localStorage.removeItem(k));
         }
         catch {
             // Ignore errors
         }
     }
+    /**
+     * Get namespace translations
+     */
     getNamespace(locale, namespace) {
         const namespaceCacheKey = `@${locale}:${namespace}`;
         const value = this.get(namespaceCacheKey);
@@ -170,10 +208,16 @@ export class LocalStorageRepository {
             return null;
         }
     }
+    /**
+     * Set namespace translations
+     */
     setNamespace(locale, namespace, translations) {
         const namespaceCacheKey = `@${locale}:${namespace}`;
         this.set(namespaceCacheKey, JSON.stringify(translations));
     }
+    /**
+     * Get all cache entries for debugging
+     */
     getEntries() {
         const entries = {};
         if (!this.available)
@@ -196,12 +240,21 @@ export class LocalStorageRepository {
         }
         return entries;
     }
+    /**
+     * Get repository configuration
+     */
     getConfig() {
         return this.config;
     }
+    /**
+     * Check if localStorage is available
+     */
     isAvailable() {
         return this.available;
     }
+    /**
+     * Get the number of entries in the cache
+     */
     getEntryCount() {
         if (!this.available)
             return 0;
@@ -219,17 +272,25 @@ export class LocalStorageRepository {
         }
         return count;
     }
+    /**
+     * Check if error is a quota exceeded error
+     */
     isQuotaError(error) {
         if (error instanceof DOMException) {
+            // Most browsers
             return (error.name === 'QuotaExceededError' ||
                 error.name === 'NS_ERROR_DOM_QUOTA_REACHED');
         }
         return false;
     }
+    /**
+     * Evict oldest 25% of entries when quota is exceeded
+     */
     evictOldest() {
         if (!this.available)
             return;
         try {
+            // Collect all entries with timestamps
             const entries = [];
             for (let i = 0; i < window.localStorage.length; i++) {
                 const fullKey = window.localStorage.key(i);
@@ -244,10 +305,13 @@ export class LocalStorageRepository {
                     }
                 }
                 catch {
+                    // Remove corrupted entry
                     window.localStorage.removeItem(fullKey);
                 }
             }
+            // Sort by timestamp (oldest first)
             entries.sort((a, b) => a.timestamp - b.timestamp);
+            // Remove oldest 25%
             const removeCount = Math.max(1, Math.floor(entries.length * 0.25));
             for (let i = 0; i < removeCount && i < entries.length; i++) {
                 window.localStorage.removeItem(entries[i].key);
@@ -257,6 +321,9 @@ export class LocalStorageRepository {
             // Ignore eviction errors
         }
     }
+    /**
+     * Get cache statistics
+     */
     getCacheStats() {
         const size = this.getEntryCount();
         const usage = this.maxSize > 0 ? `${Math.round((size / this.maxSize) * 100)}%` : '0%';