react-browser-cache 1.0.0

package/dist/cjs/storages/indexeddb.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexedDBAdapter = void 0;
+class IndexedDBAdapter {
+    dbName;
+    storeName;
+    version;
+    constructor(dbName = 'rbc_db', storeName = 'cache', version = 1) {
+        this.dbName = dbName;
+        this.storeName = storeName;
+        this.version = version;
+    }
+    async getDB() {
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open(this.dbName, this.version);
+            request.onerror = () => reject(request.error);
+            request.onsuccess = () => resolve(request.result);
+            request.onupgradeneeded = () => {
+                const db = request.result;
+                if (!db.objectStoreNames.contains(this.storeName)) {
+                    db.createObjectStore(this.storeName);
+                }
+            };
+        });
+    }
+    async get(key) {
+        const db = await this.getDB();
+        return new Promise((resolve, reject) => {
+            const transaction = db.transaction(this.storeName, 'readonly');
+            const store = transaction.objectStore(this.storeName);
+            const request = store.get(key);
+            request.onerror = () => reject(request.error);
+            request.onsuccess = () => resolve(request.result || null);
+        });
+    }
+    async set(key, value) {
+        const db = await this.getDB();
+        return new Promise((resolve, reject) => {
+            const transaction = db.transaction(this.storeName, 'readwrite');
+            const store = transaction.objectStore(this.storeName);
+            const request = store.put(value, key);
+            request.onerror = () => reject(request.error);
+            request.onsuccess = () => resolve();
+        });
+    }
+    async remove(key) {
+        const db = await this.getDB();
+        return new Promise((resolve, reject) => {
+            const transaction = db.transaction(this.storeName, 'readwrite');
+            const store = transaction.objectStore(this.storeName);
+            const request = store.delete(key);
+            request.onerror = () => reject(request.error);
+            request.onsuccess = () => resolve();
+        });
+    }
+    async clear() {
+        const db = await this.getDB();
+        return new Promise((resolve, reject) => {
+            const transaction = db.transaction(this.storeName, 'readwrite');
+            const store = transaction.objectStore(this.storeName);
+            const request = store.clear();
+            request.onerror = () => reject(request.error);
+            request.onsuccess = () => resolve();
+        });
+    }
+}
+exports.IndexedDBAdapter = IndexedDBAdapter;
+//# sourceMappingURL=indexeddb.js.map

package/dist/cjs/storages/indexeddb.js.map

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

package/dist/cjs/storages/local-storage.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalStorageAdapter = void 0;
+const serializer_1 = require("../core/serializer");
+class LocalStorageAdapter {
+    prefix;
+    constructor(prefix = 'rbc_') {
+        this.prefix = prefix;
+    }
+    getKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    async get(key) {
+        const value = localStorage.getItem(this.getKey(key));
+        if (!value)
+            return null;
+        try {
+            return (0, serializer_1.deserialize)(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value) {
+        localStorage.setItem(this.getKey(key), (0, serializer_1.serialize)(value));
+    }
+    async remove(key) {
+        localStorage.removeItem(this.getKey(key));
+    }
+    async clear() {
+        const keys = Object.keys(localStorage);
+        for (const key of keys) {
+            if (key.startsWith(this.prefix)) {
+                localStorage.removeItem(key);
+            }
+        }
+    }
+}
+exports.LocalStorageAdapter = LocalStorageAdapter;
+//# sourceMappingURL=local-storage.js.map

package/dist/cjs/storages/local-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.js","sourceRoot":"","sources":["../../../src/storages/local-storage.ts"],"names":[],"mappings":";;;AACA,mDAA4D;AAE5D,MAAa,mBAAmB;IACtB,MAAM,CAAS;IAEvB,YAAY,SAAiB,MAAM;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,IAAA,wBAAW,EAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAoB;QAC5C,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAA,sBAAS,EAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;CACF;AArCD,kDAqCC"}

package/dist/cjs/storages/memory.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStorage = void 0;
+class MemoryStorage {
+    cache = new Map();
+    async get(key) {
+        const value = this.cache.get(key);
+        if (!value)
+            return null;
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value) {
+        this.cache.set(key, JSON.stringify(value));
+    }
+    async remove(key) {
+        this.cache.delete(key);
+    }
+    async clear() {
+        this.cache.clear();
+    }
+}
+exports.MemoryStorage = MemoryStorage;
+//# sourceMappingURL=memory.js.map

package/dist/cjs/storages/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/storages/memory.ts"],"names":[],"mappings":";;;AAEA,MAAa,aAAa;IAChB,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAoB;QAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAxBD,sCAwBC"}

package/dist/cjs/storages/session-storage.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionStorageAdapter = void 0;
+const serializer_1 = require("../core/serializer");
+class SessionStorageAdapter {
+    prefix;
+    constructor(prefix = 'rbc_') {
+        this.prefix = prefix;
+    }
+    getKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    async get(key) {
+        const value = sessionStorage.getItem(this.getKey(key));
+        if (!value)
+            return null;
+        try {
+            return (0, serializer_1.deserialize)(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value) {
+        sessionStorage.setItem(this.getKey(key), (0, serializer_1.serialize)(value));
+    }
+    async remove(key) {
+        sessionStorage.removeItem(this.getKey(key));
+    }
+    async clear() {
+        const keys = Object.keys(sessionStorage);
+        for (const key of keys) {
+            if (key.startsWith(this.prefix)) {
+                sessionStorage.removeItem(key);
+            }
+        }
+    }
+}
+exports.SessionStorageAdapter = SessionStorageAdapter;
+//# sourceMappingURL=session-storage.js.map

package/dist/cjs/storages/session-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-storage.js","sourceRoot":"","sources":["../../../src/storages/session-storage.ts"],"names":[],"mappings":";;;AACA,mDAA4D;AAE5D,MAAa,qBAAqB;IACxB,MAAM,CAAS;IAEvB,YAAY,SAAiB,MAAM;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,IAAA,wBAAW,EAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAoB;QAC5C,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAA,sBAAS,EAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;CACF;AArCD,sDAqCC"}

package/dist/cjs/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/cjs/utils/hydrate.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hydrate = void 0;
+const hydrate = async (cacheManager, entries) => {
+    await Promise.all(entries.map(entry => cacheManager.set(entry.key, entry.value, entry.options)));
+};
+exports.hydrate = hydrate;
+//# sourceMappingURL=hydrate.js.map

package/dist/cjs/utils/hydrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.js","sourceRoot":"","sources":["../../../src/utils/hydrate.ts"],"names":[],"mappings":";;;AASO,MAAM,OAAO,GAAG,KAAK,EAC1B,YAA0B,EAC1B,OAA4B,EAC5B,EAAE;IACF,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAClB,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CACxD,CACF,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,OAAO,WASlB"}

package/dist/cjs/utils/prefetch.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prefetch = void 0;
+const prefetch = async (cacheManager, key, fetcher, options) => {
+    const cached = await cacheManager.get(key, options);
+    if (cached !== null && !cached.__isStale) {
+        return cached;
+    }
+    const data = await fetcher();
+    await cacheManager.set(key, data, options);
+    return data;
+};
+exports.prefetch = prefetch;
+//# sourceMappingURL=prefetch.js.map

package/dist/cjs/utils/prefetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.js","sourceRoot":"","sources":["../../../src/utils/prefetch.ts"],"names":[],"mappings":";;;AAGO,MAAM,QAAQ,GAAG,KAAK,EAC3B,YAA0B,EAC1B,GAAW,EACX,OAAyB,EACzB,OAAsB,EACV,EAAE;IACd,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,MAAM,KAAK,IAAI,IAAI,CAAE,MAAc,CAAC,SAAS,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;IAC7B,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAdW,QAAA,QAAQ,YAcnB"}

package/dist/core/broadcast.d.ts

@@ -0,0 +1,14 @@
+type BroadcastMessage = {
+    type: 'invalidate' | 'update';
+    key: string;
+    payload?: any;
+};
+export declare class BroadcastManager {
+    private channel;
+    private onMessage;
+    constructor(channelName: string, onMessage: (message: BroadcastMessage) => void);
+    postMessage(message: BroadcastMessage): void;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=broadcast.d.ts.map

package/dist/core/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../src/core/broadcast.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,GAAG,CAAC;CACf,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,SAAS,CAAsC;gBAE3C,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI;IAsB/E,WAAW,CAAC,OAAO,EAAE,gBAAgB;IAYrC,KAAK;CAGN"}

package/dist/core/broadcast.js

@@ -0,0 +1,43 @@
+export class BroadcastManager {
+    channel = null;
+    onMessage;
+    constructor(channelName, onMessage) {
+        this.onMessage = onMessage;
+        if (typeof window !== 'undefined' && window.BroadcastChannel) {
+            this.channel = new BroadcastChannel(channelName);
+            this.channel.onmessage = (event) => {
+                this.onMessage(event.data);
+            };
+        }
+        else if (typeof window !== 'undefined') {
+            // Fallback to storage event
+            window.addEventListener('storage', (event) => {
+                if (event.key === channelName && event.newValue) {
+                    try {
+                        const data = JSON.parse(event.newValue);
+                        this.onMessage(data);
+                    }
+                    catch {
+                        // Ignore malformed data
+                    }
+                }
+            });
+        }
+    }
+    postMessage(message) {
+        if (this.channel) {
+            this.channel.postMessage(message);
+        }
+        else if (typeof window !== 'undefined') {
+            // Fallback: use localStorage for cross-tab communication
+            // We set a temporary key and then remove it to trigger storage event
+            const channelName = 'rbc_sync'; // Use a consistent name for manual fallback
+            localStorage.setItem(channelName, JSON.stringify(message));
+            localStorage.removeItem(channelName);
+        }
+    }
+    close() {
+        this.channel?.close();
+    }
+}
+//# sourceMappingURL=broadcast.js.map

package/dist/core/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","sourceRoot":"","sources":["../../src/core/broadcast.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,gBAAgB;IACnB,OAAO,GAA4B,IAAI,CAAC;IACxC,SAAS,CAAsC;IAEvD,YAAY,WAAmB,EAAE,SAA8C;QAC7E,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC7D,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;gBACjC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YACzC,4BAA4B;YAC5B,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC3C,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBAChD,IAAI,CAAC;wBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;wBACxC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;oBACvB,CAAC;oBAAC,MAAM,CAAC;wBACP,wBAAwB;oBAC1B,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,WAAW,CAAC,OAAyB;QACnC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YACzC,yDAAyD;YACzD,qEAAqE;YACrE,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,4CAA4C;YAC5E,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3D,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/core/cache-manager.d.ts

@@ -0,0 +1,17 @@
+import { CacheOptions, GlobalCacheConfig, StorageType } from '../types';
+export declare class CacheManager {
+    private storages;
+    private config;
+    private broadcaster;
+    private listeners;
+    constructor(config: GlobalCacheConfig);
+    private getStorage;
+    get<T>(key: string, options?: CacheOptions): Promise<T | null>;
+    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    remove(key: string, options?: CacheOptions): Promise<void>;
+    clear(type?: StorageType): Promise<void>;
+    invalidateTag(tag: string): Promise<void>;
+    subscribe(listener: (key: string, value: any) => void): () => void;
+    private notify;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/core/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/core/cache-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,iBAAiB,EAAkB,WAAW,EAAE,MAAM,UAAU,CAAC;AAOpG,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,SAAS,CAAqD;gBAE1D,MAAM,EAAE,iBAAiB;IAoBrC,OAAO,CAAC,UAAU;IAIZ,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAoB9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBpE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1D,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/C,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI;IAOrD,OAAO,CAAC,MAAM;CAGf"}

package/dist/core/cache-manager.js

@@ -0,0 +1,97 @@
+import { MemoryStorage } from '../storages/memory';
+import { LocalStorageAdapter } from '../storages/local-storage';
+import { SessionStorageAdapter } from '../storages/session-storage';
+import { IndexedDBAdapter } from '../storages/indexeddb';
+import { BroadcastManager } from './broadcast';
+export class CacheManager {
+    storages;
+    config;
+    broadcaster = null;
+    listeners = new Set();
+    constructor(config) {
+        this.config = config;
+        this.storages = {
+            memory: new MemoryStorage(),
+            local: new LocalStorageAdapter(config.prefix),
+            session: new SessionStorageAdapter(config.prefix),
+            indexeddb: new IndexedDBAdapter()
+        };
+        if (typeof window !== 'undefined') {
+            this.broadcaster = new BroadcastManager('rbc_sync', (msg) => {
+                if (msg.type === 'invalidate') {
+                    this.notify(msg.key, null);
+                }
+                else if (msg.type === 'update') {
+                    this.notify(msg.key, msg.payload);
+                }
+            });
+        }
+    }
+    getStorage(type) {
+        return this.storages[type || this.config.defaultStorage];
+    }
+    async get(key, options) {
+        const storage = this.getStorage(options?.storage);
+        const entry = await storage.get(key);
+        if (!entry)
+            return null;
+        const now = Date.now();
+        const isExpired = entry.expiresAt !== null && now > entry.expiresAt;
+        if (isExpired) {
+            if (options?.staleWhileRevalidate) {
+                return { ...entry.value, __isStale: true };
+            }
+            await this.remove(key, options);
+            return null;
+        }
+        return entry.value;
+    }
+    async set(key, value, options) {
+        const storage = this.getStorage(options?.storage);
+        const now = Date.now();
+        const ttl = options?.ttl ?? this.config.defaultTTL;
+        const entry = {
+            value,
+            createdAt: now,
+            expiresAt: ttl > 0 ? now + ttl : null,
+            tags: options?.tags,
+            version: options?.version ?? 1
+        };
+        await storage.set(key, entry);
+        if (options?.syncTabs && this.broadcaster) {
+            this.broadcaster.postMessage({ type: 'update', key, payload: value });
+        }
+        this.notify(key, value);
+    }
+    async remove(key, options) {
+        const storage = this.getStorage(options?.storage);
+        await storage.remove(key);
+        if (options?.syncTabs && this.broadcaster) {
+            this.broadcaster.postMessage({ type: 'invalidate', key });
+        }
+        this.notify(key, null);
+    }
+    async clear(type) {
+        const storage = this.getStorage(type);
+        await storage.clear();
+    }
+    async invalidateTag(tag) {
+        // This is expensive as it requires scanning or a separate index.
+        // For simplicity, we clear and notify.
+        // In a more complex implementation, we'd have a tag-to-key index.
+        // For now, we'll notify that 'tag invalidation' occurred.
+        if (this.broadcaster) {
+            this.broadcaster.postMessage({ type: 'invalidate', key: `tag:${tag}` });
+        }
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    notify(key, value) {
+        this.listeners.forEach(l => l(key, value));
+    }
+}
+//# sourceMappingURL=cache-manager.js.map

package/dist/core/cache-manager.js.map

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

package/dist/core/serializer.d.ts

@@ -0,0 +1,3 @@
+export declare const serialize: (value: any) => string;
+export declare const deserialize: (value: string) => any;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/core/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../src/core/serializer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAI,OAAO,GAAG,KAAG,MAOtC,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,GAO3C,CAAC"}

package/dist/core/serializer.js

@@ -0,0 +1,17 @@
+export const serialize = (value) => {
+    return JSON.stringify(value, function (_key, val) {
+        if (this[_key] instanceof Date) {
+            return { __type: 'Date', value: this[_key].toISOString() };
+        }
+        return val;
+    });
+};
+export const deserialize = (value) => {
+    return JSON.parse(value, (_key, val) => {
+        if (val && typeof val === 'object' && val.__type === 'Date') {
+            return new Date(val.value);
+        }
+        return val;
+    });
+};
+//# sourceMappingURL=serializer.js.map

package/dist/core/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../src/core/serializer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAU,EAAU,EAAE;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,UAAS,IAAI,EAAE,GAAG;QAC7C,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAO,EAAE;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACrC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5D,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/hooks/useBrowserCache.d.ts

@@ -0,0 +1,16 @@
+import { CacheOptions } from '../types';
+export interface UseBrowserCacheOptions<T> extends CacheOptions {
+    key: string;
+    fetcher: () => Promise<T>;
+    enabled?: boolean;
+}
+export declare const useBrowserCache: <T>({ key, fetcher, enabled, ...options }: UseBrowserCacheOptions<T>) => {
+    data: T | null;
+    error: Error | null;
+    isLoading: boolean;
+    isStale: boolean;
+    refresh: (isManual?: boolean) => Promise<void>;
+    mutate: (newValue: T | ((prev: T | null) => T)) => void;
+    clear: () => Promise<void>;
+};
+//# sourceMappingURL=useBrowserCache.d.ts.map

package/dist/hooks/useBrowserCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBrowserCache.d.ts","sourceRoot":"","sources":["../../src/hooks/useBrowserCache.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,sBAAsB,CAAC,CAAC,CAAE,SAAQ,YAAY;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,uCAKhC,sBAAsB,CAAC,CAAC,CAAC;;;;;;uBAwEA,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;;CAgBtD,CAAC"}

package/dist/hooks/useBrowserCache.js

@@ -0,0 +1,87 @@
+import { useState, useEffect, useCallback, useRef } from 'react';
+import { useCacheManager } from '../provider/BrowserCacheProvider';
+export const useBrowserCache = ({ key, fetcher, enabled = true, ...options }) => {
+    const { cacheManager } = useCacheManager();
+    const [data, setData] = useState(null);
+    const [error, setError] = useState(null);
+    const [isLoading, setIsLoading] = useState(enabled);
+    const [isStale, setIsStale] = useState(false);
+    const isFetching = useRef(false);
+    const refresh = useCallback(async (isManual = true) => {
+        if (isFetching.current)
+            return;
+        isFetching.current = true;
+        if (isManual)
+            setIsLoading(true);
+        try {
+            const result = await fetcher();
+            await cacheManager.set(key, result, options);
+            setData(result);
+            setError(null);
+            setIsStale(false);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            setIsLoading(false);
+            isFetching.current = false;
+        }
+    }, [key, fetcher, cacheManager, options]);
+    useEffect(() => {
+        let mounted = true;
+        const load = async () => {
+            const cached = await cacheManager.get(key, options);
+            if (!mounted)
+                return;
+            if (cached !== null) {
+                if (cached.__isStale) {
+                    setData(cached);
+                    setIsStale(true);
+                    // Revalidate in background
+                    refresh(false);
+                }
+                else {
+                    setData(cached);
+                    setIsLoading(false);
+                }
+            }
+            else if (enabled) {
+                refresh();
+            }
+        };
+        if (enabled) {
+            load();
+        }
+        return () => {
+            mounted = false;
+        };
+    }, [key, enabled, cacheManager, options, refresh]);
+    // Subscribe to external updates (cross-tab sync)
+    useEffect(() => {
+        const unsubscribe = cacheManager.subscribe((updatedKey, newValue) => {
+            if (updatedKey === key) {
+                setData(newValue);
+                if (newValue === null) {
+                    setIsStale(false);
+                }
+            }
+        });
+        return () => unsubscribe();
+    }, [key, cacheManager]);
+    const mutate = (newValue) => {
+        const value = typeof newValue === 'function' ? newValue(data) : newValue;
+        cacheManager.set(key, value, options);
+    };
+    const clear = () => cacheManager.remove(key, options);
+    return {
+        data,
+        error,
+        isLoading,
+        isStale,
+        refresh,
+        mutate,
+        clear
+    };
+};
+//# sourceMappingURL=useBrowserCache.js.map

package/dist/hooks/useBrowserCache.js.map

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

package/dist/hooks/useCacheInvalidate.d.ts

@@ -0,0 +1,9 @@
+import { StorageType } from '../types';
+export declare const useCacheInvalidate: () => {
+    invalidate: (key: string, options?: {
+        storage?: StorageType;
+    }) => Promise<void>;
+    invalidateTag: (tag: string) => Promise<void>;
+    clearAll: (storage?: StorageType) => Promise<void>;
+};
+//# sourceMappingURL=useCacheInvalidate.d.ts.map

package/dist/hooks/useCacheInvalidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCacheInvalidate.d.ts","sourceRoot":"","sources":["../../src/hooks/useCacheInvalidate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,eAAO,MAAM,kBAAkB;sBAGQ,MAAM,YAAY;QAAE,OAAO,CAAC,EAAE,WAAW,CAAA;KAAE;yBAIxC,MAAM;yBAIN,WAAW;CASpD,CAAC"}

package/dist/hooks/useCacheInvalidate.js

@@ -0,0 +1,20 @@
+import { useCallback } from 'react';
+import { useCacheManager } from '../provider/BrowserCacheProvider';
+export const useCacheInvalidate = () => {
+    const { cacheManager } = useCacheManager();
+    const invalidate = useCallback((key, options) => {
+        return cacheManager.remove(key, options);
+    }, [cacheManager]);
+    const invalidateTag = useCallback((tag) => {
+        return cacheManager.invalidateTag(tag);
+    }, [cacheManager]);
+    const clearAll = useCallback((storage) => {
+        return cacheManager.clear(storage);
+    }, [cacheManager]);
+    return {
+        invalidate,
+        invalidateTag,
+        clearAll
+    };
+};
+//# sourceMappingURL=useCacheInvalidate.js.map

package/dist/hooks/useCacheInvalidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCacheInvalidate.js","sourceRoot":"","sources":["../../src/hooks/useCacheInvalidate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,MAAM,EAAE,YAAY,EAAE,GAAG,eAAe,EAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,GAAW,EAAE,OAAmC,EAAE,EAAE;QAClF,OAAO,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,GAAW,EAAE,EAAE;QAChD,OAAO,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,OAAqB,EAAE,EAAE;QACrD,OAAO,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,OAAO;QACL,UAAU;QACV,aAAa;QACb,QAAQ;KACT,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/useCacheState.d.ts

@@ -0,0 +1,7 @@
+import { CacheOptions } from '../types';
+export declare const useCacheState: <T>(key: string, initialValue?: T, options?: CacheOptions) => readonly [T, (newValue: T | ((prev: T) => T)) => Promise<void>, {
+    readonly clear: () => Promise<void>;
+    readonly reset: () => Promise<void>;
+    readonly isExpired: boolean;
+}];
+//# sourceMappingURL=useCacheState.d.ts.map

package/dist/hooks/useCacheState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCacheState.d.ts","sourceRoot":"","sources":["../../src/hooks/useCacheState.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,aAAa,GAAI,CAAC,EAC7B,KAAK,MAAM,EACX,eAAe,CAAC,EAChB,UAAU,YAAY,6BAuCwB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;;;;EAcnE,CAAC"}