react-browser-cache 1.0.0

package/README.md

@@ -0,0 +1,129 @@
+# react-browser-cache
+
+A production-ready, hook-based browser caching system for React with TTL, stale-while-revalidate, and cross-tab synchronization.
+
+## 🚀 Features
+
+- **Multi-Storage Support**: localStorage, sessionStorage, IndexedDB, and Memory.
+- **TTL & Expiration**: Automatic cache invalidation based on time-to-live.
+- **Stale-While-Revalidate**: Return cached data immediately while fetching fresh data in the background.
+- **Cross-Tab Sync**: Real-time synchronization across browser tabs using `BroadcastChannel`.
+- **TypeScript First**: Fully type-safe API.
+- **Lightweight**: Zero heavy dependencies, optimized for bundle size.
+- **JSON Safe**: Built-in support for `Date` objects in serialization.
+
+## 📦 Installation
+
+```bash
+npm install react-browser-cache
+```
+
+## 🛠️ Usage
+
+### 1. Wrap your app with `BrowserCacheProvider`
+
+```tsx
+import { BrowserCacheProvider } from 'react-browser-cache';
+
+function App() {
+  return (
+    <BrowserCacheProvider config={{ defaultStorage: 'local', defaultTTL: 1000 * 60 * 5 }}>
+      <MyComponent />
+    </BrowserCacheProvider>
+  );
+}
+```
+
+### 2. Use `useBrowserCache` for async data
+
+```tsx
+import { useBrowserCache } from 'react-browser-cache';
+
+const fetchUser = async () => {
+  const resp = await fetch('/api/user');
+  return resp.json();
+};
+
+function MyComponent() {
+  const { data, isLoading, error, refresh } = useBrowserCache({
+    key: 'user_profile',
+    fetcher: fetchUser,
+    storage: 'indexeddb',
+    ttl: 1000 * 60 * 60, // 1 hour
+    staleWhileRevalidate: true
+  });
+
+  if (isLoading) return <div>Loading...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+
+  return (
+    <div>
+      <h1>{data.name}</h1>
+      <button onClick={() => refresh()}>Refresh</button>
+    </div>
+  );
+}
+```
+
+### 3. Use `useCacheState` for persistent state
+
+```tsx
+import { useCacheState } from 'react-browser-cache';
+
+function Counter() {
+  const [count, setCount] = useCacheState('counter_key', 0, { storage: 'local' });
+
+  return (
+    <button onClick={() => setCount(c => c + 1)}>
+      Count is {count}
+    </button>
+  );
+}
+```
+
+### 4. Read-only access with `useCacheValue`
+
+```tsx
+const value = useCacheValue('my_key');
+```
+
+### 5. Manual Invalidation
+
+```tsx
+const { invalidate, clearAll } = useCacheInvalidate();
+
+// Invalidate specific key
+invalidate('user_profile');
+
+// Clear entire storage
+clearAll('indexeddb');
+```
+
+## 📖 API Reference
+
+### `BrowserCacheProvider` Props
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `config` | `GlobalCacheConfig` | - | Global configuration for the cache. |
+
+### `useBrowserCache` Options
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `key` | `string` | **Required** | Unique key for the cache entry. |
+| `fetcher` | `() => Promise<T>` | **Required** | Async function to fetch data. |
+| `storage` | `StorageType` | `'memory'` | Storage adapter to use. |
+| `ttl` | `number` | `300000` | Time to live in milliseconds. |
+| `staleWhileRevalidate` | `boolean` | `false` | Fallback to stale data while revalidating. |
+| `syncTabs` | `boolean` | `true` | Sync updates across tabs. |
+
+## 🤝 Comparison with SWR/React Query
+
+While SWR and React Query are excellent for server state, `react-browser-cache` focuses specifically on **browser storage abstraction**. 
+
+- **Persistence**: Unlike SWR which is primarily in-memory, this library is built to live in `localStorage` or `IndexedDB`.
+- **Offline First**: Optimized for scenarios where you want data to persist across sessions and survive page reloads naturally.
+- **Cross-Tab Sync**: Native support for keeping state in sync across multiple open tabs.
+
+## 📄 License
+
+MIT © Kloudz Computing

package/dist/cjs/core/broadcast.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BroadcastManager = void 0;
+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();
+    }
+}
+exports.BroadcastManager = BroadcastManager;
+//# sourceMappingURL=broadcast.js.map

package/dist/cjs/core/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","sourceRoot":"","sources":["../../../src/core/broadcast.ts"],"names":[],"mappings":";;;AAMA,MAAa,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;AAzCD,4CAyCC"}

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

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = void 0;
+const memory_1 = require("../storages/memory");
+const local_storage_1 = require("../storages/local-storage");
+const session_storage_1 = require("../storages/session-storage");
+const indexeddb_1 = require("../storages/indexeddb");
+const broadcast_1 = require("./broadcast");
+class CacheManager {
+    storages;
+    config;
+    broadcaster = null;
+    listeners = new Set();
+    constructor(config) {
+        this.config = config;
+        this.storages = {
+            memory: new memory_1.MemoryStorage(),
+            local: new local_storage_1.LocalStorageAdapter(config.prefix),
+            session: new session_storage_1.SessionStorageAdapter(config.prefix),
+            indexeddb: new indexeddb_1.IndexedDBAdapter()
+        };
+        if (typeof window !== 'undefined') {
+            this.broadcaster = new broadcast_1.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));
+    }
+}
+exports.CacheManager = CacheManager;
+//# sourceMappingURL=cache-manager.js.map

package/dist/cjs/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/cjs/core/serializer.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deserialize = exports.serialize = void 0;
+const serialize = (value) => {
+    return JSON.stringify(value, function (_key, val) {
+        if (this[_key] instanceof Date) {
+            return { __type: 'Date', value: this[_key].toISOString() };
+        }
+        return val;
+    });
+};
+exports.serialize = serialize;
+const deserialize = (value) => {
+    return JSON.parse(value, (_key, val) => {
+        if (val && typeof val === 'object' && val.__type === 'Date') {
+            return new Date(val.value);
+        }
+        return val;
+    });
+};
+exports.deserialize = deserialize;
+//# sourceMappingURL=serializer.js.map

package/dist/cjs/core/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../../src/core/serializer.ts"],"names":[],"mappings":";;;AAAO,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;AAPW,QAAA,SAAS,aAOpB;AAEK,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;AAPW,QAAA,WAAW,eAOtB"}

package/dist/cjs/hooks/useBrowserCache.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useBrowserCache = void 0;
+const react_1 = require("react");
+const BrowserCacheProvider_1 = require("../provider/BrowserCacheProvider");
+const useBrowserCache = ({ key, fetcher, enabled = true, ...options }) => {
+    const { cacheManager } = (0, BrowserCacheProvider_1.useCacheManager)();
+    const [data, setData] = (0, react_1.useState)(null);
+    const [error, setError] = (0, react_1.useState)(null);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(enabled);
+    const [isStale, setIsStale] = (0, react_1.useState)(false);
+    const isFetching = (0, react_1.useRef)(false);
+    const refresh = (0, react_1.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]);
+    (0, react_1.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)
+    (0, react_1.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
+    };
+};
+exports.useBrowserCache = useBrowserCache;
+//# sourceMappingURL=useBrowserCache.js.map

package/dist/cjs/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/cjs/hooks/useCacheInvalidate.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCacheInvalidate = void 0;
+const react_1 = require("react");
+const BrowserCacheProvider_1 = require("../provider/BrowserCacheProvider");
+const useCacheInvalidate = () => {
+    const { cacheManager } = (0, BrowserCacheProvider_1.useCacheManager)();
+    const invalidate = (0, react_1.useCallback)((key, options) => {
+        return cacheManager.remove(key, options);
+    }, [cacheManager]);
+    const invalidateTag = (0, react_1.useCallback)((tag) => {
+        return cacheManager.invalidateTag(tag);
+    }, [cacheManager]);
+    const clearAll = (0, react_1.useCallback)((storage) => {
+        return cacheManager.clear(storage);
+    }, [cacheManager]);
+    return {
+        invalidate,
+        invalidateTag,
+        clearAll
+    };
+};
+exports.useCacheInvalidate = useCacheInvalidate;
+//# sourceMappingURL=useCacheInvalidate.js.map

package/dist/cjs/hooks/useCacheInvalidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCacheInvalidate.js","sourceRoot":"","sources":["../../../src/hooks/useCacheInvalidate.ts"],"names":[],"mappings":";;;AAAA,iCAAoC;AACpC,2EAAmE;AAG5D,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAA,sCAAe,GAAE,CAAC;IAE3C,MAAM,UAAU,GAAG,IAAA,mBAAW,EAAC,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,IAAA,mBAAW,EAAC,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,IAAA,mBAAW,EAAC,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;AApBW,QAAA,kBAAkB,sBAoB7B"}

package/dist/cjs/hooks/useCacheState.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCacheState = void 0;
+const react_1 = require("react");
+const BrowserCacheProvider_1 = require("../provider/BrowserCacheProvider");
+const useCacheState = (key, initialValue, options) => {
+    const { cacheManager } = (0, BrowserCacheProvider_1.useCacheManager)();
+    const [value, setValueState] = (0, react_1.useState)(initialValue);
+    const [isExpired, setIsExpired] = (0, react_1.useState)(false);
+    (0, react_1.useEffect)(() => {
+        let mounted = true;
+        const load = async () => {
+            const cached = await cacheManager.get(key, options);
+            if (mounted) {
+                if (cached !== null) {
+                    setValueState(cached);
+                    setIsExpired(false);
+                }
+                else if (initialValue !== undefined) {
+                    await cacheManager.set(key, initialValue, options);
+                }
+            }
+        };
+        load();
+        return () => {
+            mounted = false;
+        };
+    }, [key, initialValue, cacheManager, options]);
+    // Subscribe to changes
+    (0, react_1.useEffect)(() => {
+        const unsubscribe = cacheManager.subscribe((updatedKey, newValue) => {
+            if (updatedKey === key) {
+                setValueState(newValue);
+                if (newValue === null)
+                    setIsExpired(true);
+            }
+        });
+        return () => unsubscribe();
+    }, [key, cacheManager]);
+    const setValue = (0, react_1.useCallback)(async (newValue) => {
+        const val = typeof newValue === 'function' ? newValue(value) : newValue;
+        await cacheManager.set(key, val, options);
+        setValueState(val);
+    }, [key, value, cacheManager, options]);
+    const clear = (0, react_1.useCallback)(() => cacheManager.remove(key, options), [key, cacheManager, options]);
+    const reset = (0, react_1.useCallback)(() => setValue(initialValue), [setValue, initialValue]);
+    return [
+        value,
+        setValue,
+        { clear, reset, isExpired }
+    ];
+};
+exports.useCacheState = useCacheState;
+//# sourceMappingURL=useCacheState.js.map

package/dist/cjs/hooks/useCacheState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCacheState.js","sourceRoot":"","sources":["../../../src/hooks/useCacheState.ts"],"names":[],"mappings":";;;AAAA,iCAAyD;AACzD,2EAAmE;AAG5D,MAAM,aAAa,GAAG,CAC3B,GAAW,EACX,YAAgB,EAChB,OAAsB,EACtB,EAAE;IACF,MAAM,EAAE,YAAY,EAAE,GAAG,IAAA,sCAAe,GAAE,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,IAAA,gBAAQ,EAAI,YAAiB,CAAC,CAAC;IAC9D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAElD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC;YACvD,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,aAAa,CAAC,MAAM,CAAC,CAAC;oBACtB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;qBAAM,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBACtC,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,EAAE,CAAC;QAEP,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/C,uBAAuB;IACvB,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE;YAClE,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACvB,aAAa,CAAC,QAAQ,CAAC,CAAC;gBACxB,IAAI,QAAQ,KAAK,IAAI;oBAAE,YAAY,CAAC,IAAI,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;IAExB,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,KAAK,EAAE,QAA8B,EAAE,EAAE;QACpE,MAAM,GAAG,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAE,QAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACtF,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1C,aAAa,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IACjG,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IAEvF,OAAO;QACL,KAAK;QACL,QAAQ;QACR,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;KACnB,CAAC;AACb,CAAC,CAAC;AAxDW,QAAA,aAAa,iBAwDxB"}

package/dist/cjs/hooks/useCacheValue.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCacheValue = void 0;
+const react_1 = require("react");
+const BrowserCacheProvider_1 = require("../provider/BrowserCacheProvider");
+const useCacheValue = (key, options) => {
+    const { cacheManager } = (0, BrowserCacheProvider_1.useCacheManager)();
+    const [value, setValue] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        let mounted = true;
+        const load = async () => {
+            const cached = await cacheManager.get(key, options);
+            if (mounted)
+                setValue(cached);
+        };
+        load();
+        return () => {
+            mounted = false;
+        };
+    }, [key, cacheManager, options]);
+    (0, react_1.useEffect)(() => {
+        const unsubscribe = cacheManager.subscribe((updatedKey, newValue) => {
+            if (updatedKey === key) {
+                setValue(newValue);
+            }
+        });
+        return () => unsubscribe();
+    }, [key, cacheManager]);
+    return value;
+};
+exports.useCacheValue = useCacheValue;
+//# sourceMappingURL=useCacheValue.js.map

package/dist/cjs/hooks/useCacheValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCacheValue.js","sourceRoot":"","sources":["../../../src/hooks/useCacheValue.ts"],"names":[],"mappings":";;;AAAA,iCAA4C;AAC5C,2EAAmE;AAG5D,MAAM,aAAa,GAAG,CAAI,GAAW,EAAE,OAAsB,EAAE,EAAE;IACtE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAA,sCAAe,GAAE,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAW,IAAI,CAAC,CAAC;IAEnD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,OAAO,GAAG,IAAI,CAAC;QAEnB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC;YACvD,IAAI,OAAO;gBAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC,CAAC;QAEF,IAAI,EAAE,CAAC;QAEP,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAEjC,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE;YAClE,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACvB,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;IAExB,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AA7BW,QAAA,aAAa,iBA6BxB"}

package/dist/cjs/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./core/cache-manager"), exports);
+__exportStar(require("./provider/BrowserCacheProvider"), exports);
+__exportStar(require("./hooks/useBrowserCache"), exports);
+__exportStar(require("./hooks/useCacheState"), exports);
+__exportStar(require("./hooks/useCacheValue"), exports);
+__exportStar(require("./hooks/useCacheInvalidate"), exports);
+__exportStar(require("./utils/prefetch"), exports);
+__exportStar(require("./utils/hydrate"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,uDAAqC;AACrC,kEAAgD;AAChD,0DAAwC;AACxC,wDAAsC;AACtC,wDAAsC;AACtC,6DAA2C;AAC3C,mDAAiC;AACjC,kDAAgC"}

package/dist/cjs/provider/BrowserCacheProvider.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCacheManager = exports.BrowserCacheProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const cache_manager_1 = require("../core/cache-manager");
+const BrowserCacheContext = (0, react_1.createContext)(null);
+const BrowserCacheProvider = ({ children, config = {} }) => {
+    const mergedConfig = {
+        defaultStorage: config.defaultStorage || 'memory',
+        defaultTTL: config.defaultTTL || 1000 * 60 * 5, // 5 minutes
+        prefix: config.prefix || 'rbc_',
+        ...config
+    };
+    const cacheManager = (0, react_1.useMemo)(() => new cache_manager_1.CacheManager(mergedConfig), [mergedConfig]);
+    const value = {
+        cacheManager,
+        defaultTTL: mergedConfig.defaultTTL,
+        defaultStorage: mergedConfig.defaultStorage
+    };
+    return ((0, jsx_runtime_1.jsx)(BrowserCacheContext.Provider, { value: value, children: children }));
+};
+exports.BrowserCacheProvider = BrowserCacheProvider;
+const useCacheManager = () => {
+    const context = (0, react_1.useContext)(BrowserCacheContext);
+    if (!context) {
+        throw new Error('useCacheManager must be used within a BrowserCacheProvider');
+    }
+    return context;
+};
+exports.useCacheManager = useCacheManager;
+//# sourceMappingURL=BrowserCacheProvider.js.map

package/dist/cjs/provider/BrowserCacheProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserCacheProvider.js","sourceRoot":"","sources":["../../../src/provider/BrowserCacheProvider.tsx"],"names":[],"mappings":";;;;AAAA,iCAA6E;AAC7E,yDAAqD;AASrD,MAAM,mBAAmB,GAAG,IAAA,qBAAa,EAAkC,IAAI,CAAC,CAAC;AAO1E,MAAM,oBAAoB,GAAwC,CAAC,EACxE,QAAQ,EACR,MAAM,GAAG,EAAE,EACZ,EAAE,EAAE;IACH,MAAM,YAAY,GAAsB;QACtC,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,QAAQ;QACjD,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,YAAY;QAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM;QAC/B,GAAG,MAAM;KACV,CAAC;IAEF,MAAM,YAAY,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,IAAI,4BAAY,CAAC,YAAY,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnF,MAAM,KAAK,GAA6B;QACtC,YAAY;QACZ,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,cAAc,EAAE,YAAY,CAAC,cAAc;KAC5C,CAAC;IAEF,OAAO,CACL,uBAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACvC,QAAQ,GACoB,CAChC,CAAC;AACJ,CAAC,CAAC;AAxBW,QAAA,oBAAoB,wBAwB/B;AAEK,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,mBAAmB,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AANW,QAAA,eAAe,mBAM1B"}