react-browser-cache 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (162) hide show
  1. package/README.md +129 -0
  2. package/dist/cjs/core/broadcast.js +47 -0
  3. package/dist/cjs/core/broadcast.js.map +1 -0
  4. package/dist/cjs/core/cache-manager.js +101 -0
  5. package/dist/cjs/core/cache-manager.js.map +1 -0
  6. package/dist/cjs/core/serializer.js +22 -0
  7. package/dist/cjs/core/serializer.js.map +1 -0
  8. package/dist/cjs/hooks/useBrowserCache.js +91 -0
  9. package/dist/cjs/hooks/useBrowserCache.js.map +1 -0
  10. package/dist/cjs/hooks/useCacheInvalidate.js +24 -0
  11. package/dist/cjs/hooks/useCacheInvalidate.js.map +1 -0
  12. package/dist/cjs/hooks/useCacheState.js +54 -0
  13. package/dist/cjs/hooks/useCacheState.js.map +1 -0
  14. package/dist/cjs/hooks/useCacheValue.js +32 -0
  15. package/dist/cjs/hooks/useCacheValue.js.map +1 -0
  16. package/dist/cjs/index.js +26 -0
  17. package/dist/cjs/index.js.map +1 -0
  18. package/dist/cjs/provider/BrowserCacheProvider.js +32 -0
  19. package/dist/cjs/provider/BrowserCacheProvider.js.map +1 -0
  20. package/dist/cjs/storages/indexeddb.js +68 -0
  21. package/dist/cjs/storages/indexeddb.js.map +1 -0
  22. package/dist/cjs/storages/local-storage.js +40 -0
  23. package/dist/cjs/storages/local-storage.js.map +1 -0
  24. package/dist/cjs/storages/memory.js +28 -0
  25. package/dist/cjs/storages/memory.js.map +1 -0
  26. package/dist/cjs/storages/session-storage.js +40 -0
  27. package/dist/cjs/storages/session-storage.js.map +1 -0
  28. package/dist/cjs/types/index.js +3 -0
  29. package/dist/cjs/types/index.js.map +1 -0
  30. package/dist/cjs/utils/hydrate.js +8 -0
  31. package/dist/cjs/utils/hydrate.js.map +1 -0
  32. package/dist/cjs/utils/prefetch.js +14 -0
  33. package/dist/cjs/utils/prefetch.js.map +1 -0
  34. package/dist/core/broadcast.d.ts +14 -0
  35. package/dist/core/broadcast.d.ts.map +1 -0
  36. package/dist/core/broadcast.js +43 -0
  37. package/dist/core/broadcast.js.map +1 -0
  38. package/dist/core/cache-manager.d.ts +17 -0
  39. package/dist/core/cache-manager.d.ts.map +1 -0
  40. package/dist/core/cache-manager.js +97 -0
  41. package/dist/core/cache-manager.js.map +1 -0
  42. package/dist/core/serializer.d.ts +3 -0
  43. package/dist/core/serializer.d.ts.map +1 -0
  44. package/dist/core/serializer.js +17 -0
  45. package/dist/core/serializer.js.map +1 -0
  46. package/dist/hooks/useBrowserCache.d.ts +16 -0
  47. package/dist/hooks/useBrowserCache.d.ts.map +1 -0
  48. package/dist/hooks/useBrowserCache.js +87 -0
  49. package/dist/hooks/useBrowserCache.js.map +1 -0
  50. package/dist/hooks/useCacheInvalidate.d.ts +9 -0
  51. package/dist/hooks/useCacheInvalidate.d.ts.map +1 -0
  52. package/dist/hooks/useCacheInvalidate.js +20 -0
  53. package/dist/hooks/useCacheInvalidate.js.map +1 -0
  54. package/dist/hooks/useCacheState.d.ts +7 -0
  55. package/dist/hooks/useCacheState.d.ts.map +1 -0
  56. package/dist/hooks/useCacheState.js +50 -0
  57. package/dist/hooks/useCacheState.js.map +1 -0
  58. package/dist/hooks/useCacheValue.d.ts +3 -0
  59. package/dist/hooks/useCacheValue.d.ts.map +1 -0
  60. package/dist/hooks/useCacheValue.js +28 -0
  61. package/dist/hooks/useCacheValue.js.map +1 -0
  62. package/dist/index.d.ts +10 -0
  63. package/dist/index.d.ts.map +1 -0
  64. package/dist/index.js +10 -0
  65. package/dist/index.js.map +1 -0
  66. package/dist/provider/BrowserCacheProvider.d.ts +16 -0
  67. package/dist/provider/BrowserCacheProvider.d.ts.map +1 -0
  68. package/dist/provider/BrowserCacheProvider.js +27 -0
  69. package/dist/provider/BrowserCacheProvider.js.map +1 -0
  70. package/dist/src/core/broadcast.d.ts +14 -0
  71. package/dist/src/core/broadcast.d.ts.map +1 -0
  72. package/dist/src/core/broadcast.js +43 -0
  73. package/dist/src/core/broadcast.js.map +1 -0
  74. package/dist/src/core/cache-manager.d.ts +17 -0
  75. package/dist/src/core/cache-manager.d.ts.map +1 -0
  76. package/dist/src/core/cache-manager.js +97 -0
  77. package/dist/src/core/cache-manager.js.map +1 -0
  78. package/dist/src/core/serializer.d.ts +3 -0
  79. package/dist/src/core/serializer.d.ts.map +1 -0
  80. package/dist/src/core/serializer.js +17 -0
  81. package/dist/src/core/serializer.js.map +1 -0
  82. package/dist/src/hooks/useBrowserCache.d.ts +16 -0
  83. package/dist/src/hooks/useBrowserCache.d.ts.map +1 -0
  84. package/dist/src/hooks/useBrowserCache.js +87 -0
  85. package/dist/src/hooks/useBrowserCache.js.map +1 -0
  86. package/dist/src/hooks/useCacheInvalidate.d.ts +9 -0
  87. package/dist/src/hooks/useCacheInvalidate.d.ts.map +1 -0
  88. package/dist/src/hooks/useCacheInvalidate.js +20 -0
  89. package/dist/src/hooks/useCacheInvalidate.js.map +1 -0
  90. package/dist/src/hooks/useCacheState.d.ts +7 -0
  91. package/dist/src/hooks/useCacheState.d.ts.map +1 -0
  92. package/dist/src/hooks/useCacheState.js +50 -0
  93. package/dist/src/hooks/useCacheState.js.map +1 -0
  94. package/dist/src/hooks/useCacheValue.d.ts +3 -0
  95. package/dist/src/hooks/useCacheValue.d.ts.map +1 -0
  96. package/dist/src/hooks/useCacheValue.js +28 -0
  97. package/dist/src/hooks/useCacheValue.js.map +1 -0
  98. package/dist/src/index.d.ts +10 -0
  99. package/dist/src/index.d.ts.map +1 -0
  100. package/dist/src/index.js +10 -0
  101. package/dist/src/index.js.map +1 -0
  102. package/dist/src/provider/BrowserCacheProvider.d.ts +16 -0
  103. package/dist/src/provider/BrowserCacheProvider.d.ts.map +1 -0
  104. package/dist/src/provider/BrowserCacheProvider.js +27 -0
  105. package/dist/src/provider/BrowserCacheProvider.js.map +1 -0
  106. package/dist/src/storages/indexeddb.d.ts +13 -0
  107. package/dist/src/storages/indexeddb.d.ts.map +1 -0
  108. package/dist/src/storages/indexeddb.js +64 -0
  109. package/dist/src/storages/indexeddb.js.map +1 -0
  110. package/dist/src/storages/local-storage.d.ts +11 -0
  111. package/dist/src/storages/local-storage.d.ts.map +1 -0
  112. package/dist/src/storages/local-storage.js +36 -0
  113. package/dist/src/storages/local-storage.js.map +1 -0
  114. package/dist/src/storages/memory.d.ts +9 -0
  115. package/dist/src/storages/memory.d.ts.map +1 -0
  116. package/dist/src/storages/memory.js +24 -0
  117. package/dist/src/storages/memory.js.map +1 -0
  118. package/dist/src/storages/session-storage.d.ts +11 -0
  119. package/dist/src/storages/session-storage.d.ts.map +1 -0
  120. package/dist/src/storages/session-storage.js +36 -0
  121. package/dist/src/storages/session-storage.js.map +1 -0
  122. package/dist/src/types/index.d.ts +31 -0
  123. package/dist/src/types/index.d.ts.map +1 -0
  124. package/dist/src/types/index.js +2 -0
  125. package/dist/src/types/index.js.map +1 -0
  126. package/dist/src/utils/hydrate.d.ts +9 -0
  127. package/dist/src/utils/hydrate.d.ts.map +1 -0
  128. package/dist/src/utils/hydrate.js +4 -0
  129. package/dist/src/utils/hydrate.js.map +1 -0
  130. package/dist/src/utils/prefetch.d.ts +4 -0
  131. package/dist/src/utils/prefetch.d.ts.map +1 -0
  132. package/dist/src/utils/prefetch.js +10 -0
  133. package/dist/src/utils/prefetch.js.map +1 -0
  134. package/dist/storages/indexeddb.d.ts +13 -0
  135. package/dist/storages/indexeddb.d.ts.map +1 -0
  136. package/dist/storages/indexeddb.js +64 -0
  137. package/dist/storages/indexeddb.js.map +1 -0
  138. package/dist/storages/local-storage.d.ts +11 -0
  139. package/dist/storages/local-storage.d.ts.map +1 -0
  140. package/dist/storages/local-storage.js +36 -0
  141. package/dist/storages/local-storage.js.map +1 -0
  142. package/dist/storages/memory.d.ts +9 -0
  143. package/dist/storages/memory.d.ts.map +1 -0
  144. package/dist/storages/memory.js +24 -0
  145. package/dist/storages/memory.js.map +1 -0
  146. package/dist/storages/session-storage.d.ts +11 -0
  147. package/dist/storages/session-storage.d.ts.map +1 -0
  148. package/dist/storages/session-storage.js +36 -0
  149. package/dist/storages/session-storage.js.map +1 -0
  150. package/dist/types/index.d.ts +31 -0
  151. package/dist/types/index.d.ts.map +1 -0
  152. package/dist/types/index.js +2 -0
  153. package/dist/types/index.js.map +1 -0
  154. package/dist/utils/hydrate.d.ts +9 -0
  155. package/dist/utils/hydrate.d.ts.map +1 -0
  156. package/dist/utils/hydrate.js +4 -0
  157. package/dist/utils/hydrate.js.map +1 -0
  158. package/dist/utils/prefetch.d.ts +4 -0
  159. package/dist/utils/prefetch.d.ts.map +1 -0
  160. package/dist/utils/prefetch.js +10 -0
  161. package/dist/utils/prefetch.js.map +1 -0
  162. package/package.json +55 -0
@@ -0,0 +1,50 @@
1
+ import { useState, useEffect, useCallback } from 'react';
2
+ import { useCacheManager } from '../provider/BrowserCacheProvider';
3
+ export const useCacheState = (key, initialValue, options) => {
4
+ const { cacheManager } = useCacheManager();
5
+ const [value, setValueState] = useState(initialValue);
6
+ const [isExpired, setIsExpired] = useState(false);
7
+ useEffect(() => {
8
+ let mounted = true;
9
+ const load = async () => {
10
+ const cached = await cacheManager.get(key, options);
11
+ if (mounted) {
12
+ if (cached !== null) {
13
+ setValueState(cached);
14
+ setIsExpired(false);
15
+ }
16
+ else if (initialValue !== undefined) {
17
+ await cacheManager.set(key, initialValue, options);
18
+ }
19
+ }
20
+ };
21
+ load();
22
+ return () => {
23
+ mounted = false;
24
+ };
25
+ }, [key, initialValue, cacheManager, options]);
26
+ // Subscribe to changes
27
+ useEffect(() => {
28
+ const unsubscribe = cacheManager.subscribe((updatedKey, newValue) => {
29
+ if (updatedKey === key) {
30
+ setValueState(newValue);
31
+ if (newValue === null)
32
+ setIsExpired(true);
33
+ }
34
+ });
35
+ return () => unsubscribe();
36
+ }, [key, cacheManager]);
37
+ const setValue = useCallback(async (newValue) => {
38
+ const val = typeof newValue === 'function' ? newValue(value) : newValue;
39
+ await cacheManager.set(key, val, options);
40
+ setValueState(val);
41
+ }, [key, value, cacheManager, options]);
42
+ const clear = useCallback(() => cacheManager.remove(key, options), [key, cacheManager, options]);
43
+ const reset = useCallback(() => setValue(initialValue), [setValue, initialValue]);
44
+ return [
45
+ value,
46
+ setValue,
47
+ { clear, reset, isExpired }
48
+ ];
49
+ };
50
+ //# sourceMappingURL=useCacheState.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useCacheState.js","sourceRoot":"","sources":["../../src/hooks/useCacheState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,GAAW,EACX,YAAgB,EAChB,OAAsB,EACtB,EAAE;IACF,MAAM,EAAE,YAAY,EAAE,GAAG,eAAe,EAAE,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAI,YAAiB,CAAC,CAAC;IAC9D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,SAAS,CAAC,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,SAAS,CAAC,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,WAAW,CAAC,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,WAAW,CAAC,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,WAAW,CAAC,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"}
@@ -0,0 +1,3 @@
1
+ import { CacheOptions } from '../types';
2
+ export declare const useCacheValue: <T>(key: string, options?: CacheOptions) => T | null;
3
+ //# sourceMappingURL=useCacheValue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useCacheValue.d.ts","sourceRoot":"","sources":["../../src/hooks/useCacheValue.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,KAAK,MAAM,EAAE,UAAU,YAAY,aA6BnE,CAAC"}
@@ -0,0 +1,28 @@
1
+ import { useState, useEffect } from 'react';
2
+ import { useCacheManager } from '../provider/BrowserCacheProvider';
3
+ export const useCacheValue = (key, options) => {
4
+ const { cacheManager } = useCacheManager();
5
+ const [value, setValue] = useState(null);
6
+ useEffect(() => {
7
+ let mounted = true;
8
+ const load = async () => {
9
+ const cached = await cacheManager.get(key, options);
10
+ if (mounted)
11
+ setValue(cached);
12
+ };
13
+ load();
14
+ return () => {
15
+ mounted = false;
16
+ };
17
+ }, [key, cacheManager, options]);
18
+ useEffect(() => {
19
+ const unsubscribe = cacheManager.subscribe((updatedKey, newValue) => {
20
+ if (updatedKey === key) {
21
+ setValue(newValue);
22
+ }
23
+ });
24
+ return () => unsubscribe();
25
+ }, [key, cacheManager]);
26
+ return value;
27
+ };
28
+ //# sourceMappingURL=useCacheValue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useCacheValue.js","sourceRoot":"","sources":["../../src/hooks/useCacheValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,GAAW,EAAE,OAAsB,EAAE,EAAE;IACtE,MAAM,EAAE,YAAY,EAAE,GAAG,eAAe,EAAE,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAC;IAEnD,SAAS,CAAC,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,SAAS,CAAC,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"}
@@ -0,0 +1,10 @@
1
+ export * from './types';
2
+ export * from './core/cache-manager';
3
+ export * from './provider/BrowserCacheProvider';
4
+ export * from './hooks/useBrowserCache';
5
+ export * from './hooks/useCacheState';
6
+ export * from './hooks/useCacheValue';
7
+ export * from './hooks/useCacheInvalidate';
8
+ export * from './utils/prefetch';
9
+ export * from './utils/hydrate';
10
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,10 @@
1
+ export * from './types';
2
+ export * from './core/cache-manager';
3
+ export * from './provider/BrowserCacheProvider';
4
+ export * from './hooks/useBrowserCache';
5
+ export * from './hooks/useCacheState';
6
+ export * from './hooks/useCacheValue';
7
+ export * from './hooks/useCacheInvalidate';
8
+ export * from './utils/prefetch';
9
+ export * from './utils/hydrate';
10
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}
@@ -0,0 +1,16 @@
1
+ import React, { ReactNode } from 'react';
2
+ import { CacheManager } from '../core/cache-manager';
3
+ import { GlobalCacheConfig, StorageType } from '../types';
4
+ interface BrowserCacheContextValue {
5
+ cacheManager: CacheManager;
6
+ defaultTTL: number;
7
+ defaultStorage: StorageType;
8
+ }
9
+ export interface BrowserCacheProviderProps {
10
+ children: ReactNode;
11
+ config?: Partial<GlobalCacheConfig>;
12
+ }
13
+ export declare const BrowserCacheProvider: React.FC<BrowserCacheProviderProps>;
14
+ export declare const useCacheManager: () => BrowserCacheContextValue;
15
+ export {};
16
+ //# sourceMappingURL=BrowserCacheProvider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BrowserCacheProvider.d.ts","sourceRoot":"","sources":["../../src/provider/BrowserCacheProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsC,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE1D,UAAU,wBAAwB;IAChC,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,WAAW,CAAC;CAC7B;AAID,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAwBpE,CAAC;AAEF,eAAO,MAAM,eAAe,gCAM3B,CAAC"}
@@ -0,0 +1,27 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { createContext, useContext, useMemo } from 'react';
3
+ import { CacheManager } from '../core/cache-manager';
4
+ const BrowserCacheContext = createContext(null);
5
+ export const BrowserCacheProvider = ({ children, config = {} }) => {
6
+ const mergedConfig = {
7
+ defaultStorage: config.defaultStorage || 'memory',
8
+ defaultTTL: config.defaultTTL || 1000 * 60 * 5, // 5 minutes
9
+ prefix: config.prefix || 'rbc_',
10
+ ...config
11
+ };
12
+ const cacheManager = useMemo(() => new CacheManager(mergedConfig), [mergedConfig]);
13
+ const value = {
14
+ cacheManager,
15
+ defaultTTL: mergedConfig.defaultTTL,
16
+ defaultStorage: mergedConfig.defaultStorage
17
+ };
18
+ return (_jsx(BrowserCacheContext.Provider, { value: value, children: children }));
19
+ };
20
+ export const useCacheManager = () => {
21
+ const context = useContext(BrowserCacheContext);
22
+ if (!context) {
23
+ throw new Error('useCacheManager must be used within a BrowserCacheProvider');
24
+ }
25
+ return context;
26
+ };
27
+ //# sourceMappingURL=BrowserCacheProvider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BrowserCacheProvider.js","sourceRoot":"","sources":["../../src/provider/BrowserCacheProvider.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAa,MAAM,OAAO,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AASrD,MAAM,mBAAmB,GAAG,aAAa,CAAkC,IAAI,CAAC,CAAC;AAOjF,MAAM,CAAC,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,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,YAAY,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,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACvC,QAAQ,GACoB,CAChC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,MAAM,OAAO,GAAG,UAAU,CAAC,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"}
@@ -0,0 +1,14 @@
1
+ type BroadcastMessage = {
2
+ type: 'invalidate' | 'update';
3
+ key: string;
4
+ payload?: any;
5
+ };
6
+ export declare class BroadcastManager {
7
+ private channel;
8
+ private onMessage;
9
+ constructor(channelName: string, onMessage: (message: BroadcastMessage) => void);
10
+ postMessage(message: BroadcastMessage): void;
11
+ close(): void;
12
+ }
13
+ export {};
14
+ //# sourceMappingURL=broadcast.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,43 @@
1
+ export class BroadcastManager {
2
+ channel = null;
3
+ onMessage;
4
+ constructor(channelName, onMessage) {
5
+ this.onMessage = onMessage;
6
+ if (typeof window !== 'undefined' && window.BroadcastChannel) {
7
+ this.channel = new BroadcastChannel(channelName);
8
+ this.channel.onmessage = (event) => {
9
+ this.onMessage(event.data);
10
+ };
11
+ }
12
+ else if (typeof window !== 'undefined') {
13
+ // Fallback to storage event
14
+ window.addEventListener('storage', (event) => {
15
+ if (event.key === channelName && event.newValue) {
16
+ try {
17
+ const data = JSON.parse(event.newValue);
18
+ this.onMessage(data);
19
+ }
20
+ catch {
21
+ // Ignore malformed data
22
+ }
23
+ }
24
+ });
25
+ }
26
+ }
27
+ postMessage(message) {
28
+ if (this.channel) {
29
+ this.channel.postMessage(message);
30
+ }
31
+ else if (typeof window !== 'undefined') {
32
+ // Fallback: use localStorage for cross-tab communication
33
+ // We set a temporary key and then remove it to trigger storage event
34
+ const channelName = 'rbc_sync'; // Use a consistent name for manual fallback
35
+ localStorage.setItem(channelName, JSON.stringify(message));
36
+ localStorage.removeItem(channelName);
37
+ }
38
+ }
39
+ close() {
40
+ this.channel?.close();
41
+ }
42
+ }
43
+ //# sourceMappingURL=broadcast.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,17 @@
1
+ import { CacheOptions, GlobalCacheConfig, StorageType } from '../types';
2
+ export declare class CacheManager {
3
+ private storages;
4
+ private config;
5
+ private broadcaster;
6
+ private listeners;
7
+ constructor(config: GlobalCacheConfig);
8
+ private getStorage;
9
+ get<T>(key: string, options?: CacheOptions): Promise<T | null>;
10
+ set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
11
+ remove(key: string, options?: CacheOptions): Promise<void>;
12
+ clear(type?: StorageType): Promise<void>;
13
+ invalidateTag(tag: string): Promise<void>;
14
+ subscribe(listener: (key: string, value: any) => void): () => void;
15
+ private notify;
16
+ }
17
+ //# sourceMappingURL=cache-manager.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,97 @@
1
+ import { MemoryStorage } from '../storages/memory';
2
+ import { LocalStorageAdapter } from '../storages/local-storage';
3
+ import { SessionStorageAdapter } from '../storages/session-storage';
4
+ import { IndexedDBAdapter } from '../storages/indexeddb';
5
+ import { BroadcastManager } from './broadcast';
6
+ export class CacheManager {
7
+ storages;
8
+ config;
9
+ broadcaster = null;
10
+ listeners = new Set();
11
+ constructor(config) {
12
+ this.config = config;
13
+ this.storages = {
14
+ memory: new MemoryStorage(),
15
+ local: new LocalStorageAdapter(config.prefix),
16
+ session: new SessionStorageAdapter(config.prefix),
17
+ indexeddb: new IndexedDBAdapter()
18
+ };
19
+ if (typeof window !== 'undefined') {
20
+ this.broadcaster = new BroadcastManager('rbc_sync', (msg) => {
21
+ if (msg.type === 'invalidate') {
22
+ this.notify(msg.key, null);
23
+ }
24
+ else if (msg.type === 'update') {
25
+ this.notify(msg.key, msg.payload);
26
+ }
27
+ });
28
+ }
29
+ }
30
+ getStorage(type) {
31
+ return this.storages[type || this.config.defaultStorage];
32
+ }
33
+ async get(key, options) {
34
+ const storage = this.getStorage(options?.storage);
35
+ const entry = await storage.get(key);
36
+ if (!entry)
37
+ return null;
38
+ const now = Date.now();
39
+ const isExpired = entry.expiresAt !== null && now > entry.expiresAt;
40
+ if (isExpired) {
41
+ if (options?.staleWhileRevalidate) {
42
+ return { ...entry.value, __isStale: true };
43
+ }
44
+ await this.remove(key, options);
45
+ return null;
46
+ }
47
+ return entry.value;
48
+ }
49
+ async set(key, value, options) {
50
+ const storage = this.getStorage(options?.storage);
51
+ const now = Date.now();
52
+ const ttl = options?.ttl ?? this.config.defaultTTL;
53
+ const entry = {
54
+ value,
55
+ createdAt: now,
56
+ expiresAt: ttl > 0 ? now + ttl : null,
57
+ tags: options?.tags,
58
+ version: options?.version ?? 1
59
+ };
60
+ await storage.set(key, entry);
61
+ if (options?.syncTabs && this.broadcaster) {
62
+ this.broadcaster.postMessage({ type: 'update', key, payload: value });
63
+ }
64
+ this.notify(key, value);
65
+ }
66
+ async remove(key, options) {
67
+ const storage = this.getStorage(options?.storage);
68
+ await storage.remove(key);
69
+ if (options?.syncTabs && this.broadcaster) {
70
+ this.broadcaster.postMessage({ type: 'invalidate', key });
71
+ }
72
+ this.notify(key, null);
73
+ }
74
+ async clear(type) {
75
+ const storage = this.getStorage(type);
76
+ await storage.clear();
77
+ }
78
+ async invalidateTag(tag) {
79
+ // This is expensive as it requires scanning or a separate index.
80
+ // For simplicity, we clear and notify.
81
+ // In a more complex implementation, we'd have a tag-to-key index.
82
+ // For now, we'll notify that 'tag invalidation' occurred.
83
+ if (this.broadcaster) {
84
+ this.broadcaster.postMessage({ type: 'invalidate', key: `tag:${tag}` });
85
+ }
86
+ }
87
+ subscribe(listener) {
88
+ this.listeners.add(listener);
89
+ return () => {
90
+ this.listeners.delete(listener);
91
+ };
92
+ }
93
+ notify(key, value) {
94
+ this.listeners.forEach(l => l(key, value));
95
+ }
96
+ }
97
+ //# sourceMappingURL=cache-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-manager.js","sourceRoot":"","sources":["../../../src/core/cache-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ export declare const serialize: (value: any) => string;
2
+ export declare const deserialize: (value: string) => any;
3
+ //# sourceMappingURL=serializer.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,17 @@
1
+ export const serialize = (value) => {
2
+ return JSON.stringify(value, function (_key, val) {
3
+ if (this[_key] instanceof Date) {
4
+ return { __type: 'Date', value: this[_key].toISOString() };
5
+ }
6
+ return val;
7
+ });
8
+ };
9
+ export const deserialize = (value) => {
10
+ return JSON.parse(value, (_key, val) => {
11
+ if (val && typeof val === 'object' && val.__type === 'Date') {
12
+ return new Date(val.value);
13
+ }
14
+ return val;
15
+ });
16
+ };
17
+ //# sourceMappingURL=serializer.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,16 @@
1
+ import { CacheOptions } from '../types';
2
+ export interface UseBrowserCacheOptions<T> extends CacheOptions {
3
+ key: string;
4
+ fetcher: () => Promise<T>;
5
+ enabled?: boolean;
6
+ }
7
+ export declare const useBrowserCache: <T>({ key, fetcher, enabled, ...options }: UseBrowserCacheOptions<T>) => {
8
+ data: T | null;
9
+ error: Error | null;
10
+ isLoading: boolean;
11
+ isStale: boolean;
12
+ refresh: (isManual?: boolean) => Promise<void>;
13
+ mutate: (newValue: T | ((prev: T | null) => T)) => void;
14
+ clear: () => Promise<void>;
15
+ };
16
+ //# sourceMappingURL=useBrowserCache.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,87 @@
1
+ import { useState, useEffect, useCallback, useRef } from 'react';
2
+ import { useCacheManager } from '../provider/BrowserCacheProvider';
3
+ export const useBrowserCache = ({ key, fetcher, enabled = true, ...options }) => {
4
+ const { cacheManager } = useCacheManager();
5
+ const [data, setData] = useState(null);
6
+ const [error, setError] = useState(null);
7
+ const [isLoading, setIsLoading] = useState(enabled);
8
+ const [isStale, setIsStale] = useState(false);
9
+ const isFetching = useRef(false);
10
+ const refresh = useCallback(async (isManual = true) => {
11
+ if (isFetching.current)
12
+ return;
13
+ isFetching.current = true;
14
+ if (isManual)
15
+ setIsLoading(true);
16
+ try {
17
+ const result = await fetcher();
18
+ await cacheManager.set(key, result, options);
19
+ setData(result);
20
+ setError(null);
21
+ setIsStale(false);
22
+ }
23
+ catch (err) {
24
+ setError(err instanceof Error ? err : new Error(String(err)));
25
+ }
26
+ finally {
27
+ setIsLoading(false);
28
+ isFetching.current = false;
29
+ }
30
+ }, [key, fetcher, cacheManager, options]);
31
+ useEffect(() => {
32
+ let mounted = true;
33
+ const load = async () => {
34
+ const cached = await cacheManager.get(key, options);
35
+ if (!mounted)
36
+ return;
37
+ if (cached !== null) {
38
+ if (cached.__isStale) {
39
+ setData(cached);
40
+ setIsStale(true);
41
+ // Revalidate in background
42
+ refresh(false);
43
+ }
44
+ else {
45
+ setData(cached);
46
+ setIsLoading(false);
47
+ }
48
+ }
49
+ else if (enabled) {
50
+ refresh();
51
+ }
52
+ };
53
+ if (enabled) {
54
+ load();
55
+ }
56
+ return () => {
57
+ mounted = false;
58
+ };
59
+ }, [key, enabled, cacheManager, options, refresh]);
60
+ // Subscribe to external updates (cross-tab sync)
61
+ useEffect(() => {
62
+ const unsubscribe = cacheManager.subscribe((updatedKey, newValue) => {
63
+ if (updatedKey === key) {
64
+ setData(newValue);
65
+ if (newValue === null) {
66
+ setIsStale(false);
67
+ }
68
+ }
69
+ });
70
+ return () => unsubscribe();
71
+ }, [key, cacheManager]);
72
+ const mutate = (newValue) => {
73
+ const value = typeof newValue === 'function' ? newValue(data) : newValue;
74
+ cacheManager.set(key, value, options);
75
+ };
76
+ const clear = () => cacheManager.remove(key, options);
77
+ return {
78
+ data,
79
+ error,
80
+ isLoading,
81
+ isStale,
82
+ refresh,
83
+ mutate,
84
+ clear
85
+ };
86
+ };
87
+ //# sourceMappingURL=useBrowserCache.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useBrowserCache.js","sourceRoot":"","sources":["../../../src/hooks/useBrowserCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AASnE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,EACjC,GAAG,EACH,OAAO,EACP,OAAO,GAAG,IAAI,EACd,GAAG,OAAO,EACgB,EAAE,EAAE;IAC9B,MAAM,EAAE,YAAY,EAAE,GAAG,eAAe,EAAE,CAAC;IAC3C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjC,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,EAAE;QACpD,IAAI,UAAU,CAAC,OAAO;YAAE,OAAO;QAC/B,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,IAAI,QAAQ;YAAE,YAAY,CAAC,IAAI,CAAC,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;YAC/B,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,CAAC,MAAM,CAAC,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAE1C,SAAS,CAAC,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;YAEvD,IAAI,CAAC,OAAO;gBAAE,OAAO;YAErB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,IAAK,MAAc,CAAC,SAAS,EAAE,CAAC;oBAC9B,OAAO,CAAC,MAAa,CAAC,CAAC;oBACvB,UAAU,CAAC,IAAI,CAAC,CAAC;oBACjB,2BAA2B;oBAC3B,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,CAAC,CAAC;oBAChB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,EAAE,CAAC;gBACnB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,EAAE,CAAC;QACT,CAAC;QAED,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnD,iDAAiD;IACjD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE;YAClE,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACvB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAClB,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACtB,UAAU,CAAC,KAAK,CAAC,CAAC;gBACpB,CAAC;YACH,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,MAAM,GAAG,CAAC,QAAqC,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAE,QAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACvF,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAEtD,OAAO;QACL,IAAI;QACJ,KAAK;QACL,SAAS;QACT,OAAO;QACP,OAAO;QACP,MAAM;QACN,KAAK;KACN,CAAC;AACJ,CAAC,CAAC"}
@@ -0,0 +1,9 @@
1
+ import { StorageType } from '../types';
2
+ export declare const useCacheInvalidate: () => {
3
+ invalidate: (key: string, options?: {
4
+ storage?: StorageType;
5
+ }) => Promise<void>;
6
+ invalidateTag: (tag: string) => Promise<void>;
7
+ clearAll: (storage?: StorageType) => Promise<void>;
8
+ };
9
+ //# sourceMappingURL=useCacheInvalidate.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,20 @@
1
+ import { useCallback } from 'react';
2
+ import { useCacheManager } from '../provider/BrowserCacheProvider';
3
+ export const useCacheInvalidate = () => {
4
+ const { cacheManager } = useCacheManager();
5
+ const invalidate = useCallback((key, options) => {
6
+ return cacheManager.remove(key, options);
7
+ }, [cacheManager]);
8
+ const invalidateTag = useCallback((tag) => {
9
+ return cacheManager.invalidateTag(tag);
10
+ }, [cacheManager]);
11
+ const clearAll = useCallback((storage) => {
12
+ return cacheManager.clear(storage);
13
+ }, [cacheManager]);
14
+ return {
15
+ invalidate,
16
+ invalidateTag,
17
+ clearAll
18
+ };
19
+ };
20
+ //# sourceMappingURL=useCacheInvalidate.js.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,7 @@
1
+ import { CacheOptions } from '../types';
2
+ export declare const useCacheState: <T>(key: string, initialValue?: T, options?: CacheOptions) => readonly [T, (newValue: T | ((prev: T) => T)) => Promise<void>, {
3
+ readonly clear: () => Promise<void>;
4
+ readonly reset: () => Promise<void>;
5
+ readonly isExpired: boolean;
6
+ }];
7
+ //# sourceMappingURL=useCacheState.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,50 @@
1
+ import { useState, useEffect, useCallback } from 'react';
2
+ import { useCacheManager } from '../provider/BrowserCacheProvider';
3
+ export const useCacheState = (key, initialValue, options) => {
4
+ const { cacheManager } = useCacheManager();
5
+ const [value, setValueState] = useState(initialValue);
6
+ const [isExpired, setIsExpired] = useState(false);
7
+ useEffect(() => {
8
+ let mounted = true;
9
+ const load = async () => {
10
+ const cached = await cacheManager.get(key, options);
11
+ if (mounted) {
12
+ if (cached !== null) {
13
+ setValueState(cached);
14
+ setIsExpired(false);
15
+ }
16
+ else if (initialValue !== undefined) {
17
+ await cacheManager.set(key, initialValue, options);
18
+ }
19
+ }
20
+ };
21
+ load();
22
+ return () => {
23
+ mounted = false;
24
+ };
25
+ }, [key, initialValue, cacheManager, options]);
26
+ // Subscribe to changes
27
+ useEffect(() => {
28
+ const unsubscribe = cacheManager.subscribe((updatedKey, newValue) => {
29
+ if (updatedKey === key) {
30
+ setValueState(newValue);
31
+ if (newValue === null)
32
+ setIsExpired(true);
33
+ }
34
+ });
35
+ return () => unsubscribe();
36
+ }, [key, cacheManager]);
37
+ const setValue = useCallback(async (newValue) => {
38
+ const val = typeof newValue === 'function' ? newValue(value) : newValue;
39
+ await cacheManager.set(key, val, options);
40
+ setValueState(val);
41
+ }, [key, value, cacheManager, options]);
42
+ const clear = useCallback(() => cacheManager.remove(key, options), [key, cacheManager, options]);
43
+ const reset = useCallback(() => setValue(initialValue), [setValue, initialValue]);
44
+ return [
45
+ value,
46
+ setValue,
47
+ { clear, reset, isExpired }
48
+ ];
49
+ };
50
+ //# sourceMappingURL=useCacheState.js.map