@choksheak/react-utils 0.4.6 → 0.4.8

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 (107) hide show
  1. package/NoSSR.cjs +7 -30
  2. package/{NoSSR.mjs → NoSSR.js} +2 -0
  3. package/NoSSR.min.cjs +14 -1
  4. package/NoSSR.min.cjs.map +1 -1
  5. package/NoSSR.min.js +15 -0
  6. package/{NoSSR.min.mjs.map → NoSSR.min.js.map} +1 -1
  7. package/chunk-4YV72T4D.min.js +105 -0
  8. package/{storage.min.mjs.map → chunk-4YV72T4D.min.js.map} +1 -1
  9. package/chunk-5PDGU37E.cjs +104 -0
  10. package/{storage.mjs → chunk-7CPBZFDV.js} +3 -2
  11. package/{stringify.mjs → chunk-7XC6EVMX.js} +1 -0
  12. package/chunk-AXDXFCZV.min.js +35 -0
  13. package/{stringify.min.mjs.map → chunk-AXDXFCZV.min.js.map} +1 -1
  14. package/chunk-C6X4GPZ4.min.cjs +596 -0
  15. package/chunk-C6X4GPZ4.min.cjs.map +1 -0
  16. package/{sharedState.mjs → chunk-CIDQGOPA.js} +18 -104
  17. package/chunk-CYTO5EZE.cjs +34 -0
  18. package/chunk-HFIQE4XZ.cjs +595 -0
  19. package/chunk-IS3BZTWE.cjs +35 -0
  20. package/{sharedQuery.mjs → chunk-JYZY2SHD.min.js} +19 -342
  21. package/chunk-JYZY2SHD.min.js.map +1 -0
  22. package/chunk-K2L3OVGY.min.cjs +18 -0
  23. package/chunk-K2L3OVGY.min.cjs.map +1 -0
  24. package/chunk-KGDXU6Q2.min.cjs +222 -0
  25. package/chunk-KGDXU6Q2.min.cjs.map +1 -0
  26. package/chunk-MNWSPF5J.min.js +18 -0
  27. package/{useDeepMemo.min.mjs.map → chunk-MNWSPF5J.min.js.map} +1 -1
  28. package/chunk-P2E73RBM.min.cjs +35 -0
  29. package/chunk-P2E73RBM.min.cjs.map +1 -0
  30. package/chunk-PCGGKBOL.min.js +222 -0
  31. package/chunk-PCGGKBOL.min.js.map +1 -0
  32. package/chunk-PHITDXZT.min.js +36 -0
  33. package/chunk-PHITDXZT.min.js.map +1 -0
  34. package/{index.mjs → chunk-RFKUMDNU.js} +19 -364
  35. package/chunk-RRQBFF4W.min.cjs +105 -0
  36. package/chunk-RRQBFF4W.min.cjs.map +1 -0
  37. package/chunk-TST6JKQ5.min.cjs +36 -0
  38. package/chunk-TST6JKQ5.min.cjs.map +1 -0
  39. package/chunk-U67V476Y.js +35 -0
  40. package/chunk-UNDIVFP5.cjs +221 -0
  41. package/chunk-WXLUEDBO.cjs +17 -0
  42. package/{useDeepMemo.mjs → chunk-YTXGK6BR.js} +1 -0
  43. package/dist-4BDJ7HYS.min.js +546 -0
  44. package/dist-4BDJ7HYS.min.js.map +1 -0
  45. package/dist-HKOCAKHU.min.cjs +546 -0
  46. package/dist-HKOCAKHU.min.cjs.map +1 -0
  47. package/dist-RQU6CWRG.js +545 -0
  48. package/dist-UKP7SPWZ.cjs +545 -0
  49. package/index.cjs +43 -985
  50. package/index.d.cts +2 -2
  51. package/index.d.ts +2 -2
  52. package/index.js +43 -0
  53. package/index.min.cjs +43 -1
  54. package/index.min.cjs.map +1 -1
  55. package/index.min.js +44 -0
  56. package/index.min.js.map +1 -0
  57. package/magic-string.es-2AQNCEBL.min.js +1309 -0
  58. package/magic-string.es-2AQNCEBL.min.js.map +1 -0
  59. package/magic-string.es-HC5PDAU3.cjs +1308 -0
  60. package/magic-string.es-KDMUXKGI.js +1308 -0
  61. package/magic-string.es-XJ27RPMN.min.cjs +1309 -0
  62. package/magic-string.es-XJ27RPMN.min.cjs.map +1 -0
  63. package/package.json +48 -8
  64. package/sharedQuery.cjs +10 -944
  65. package/sharedQuery.d.cts +7 -92
  66. package/sharedQuery.d.ts +7 -92
  67. package/sharedQuery.js +17 -0
  68. package/sharedQuery.min.cjs +17 -1
  69. package/sharedQuery.min.cjs.map +1 -1
  70. package/sharedQuery.min.js +18 -0
  71. package/sharedQuery.min.js.map +1 -0
  72. package/sharedState.cjs +15 -334
  73. package/sharedState.d.cts +12 -57
  74. package/sharedState.d.ts +12 -57
  75. package/sharedState.js +18 -0
  76. package/sharedState.min.cjs +18 -1
  77. package/sharedState.min.cjs.map +1 -1
  78. package/sharedState.min.js +19 -0
  79. package/sharedState.min.js.map +1 -0
  80. package/storage.cjs +10 -129
  81. package/storage.js +11 -0
  82. package/storage.min.cjs +11 -1
  83. package/storage.min.cjs.map +1 -1
  84. package/storage.min.js +12 -0
  85. package/storage.min.js.map +1 -0
  86. package/stringify.cjs +6 -57
  87. package/stringify.js +7 -0
  88. package/stringify.min.cjs +7 -1
  89. package/stringify.min.cjs.map +1 -1
  90. package/stringify.min.js +8 -0
  91. package/stringify.min.js.map +1 -0
  92. package/useDeepMemo.cjs +6 -40
  93. package/useDeepMemo.js +7 -0
  94. package/useDeepMemo.min.cjs +7 -1
  95. package/useDeepMemo.min.cjs.map +1 -1
  96. package/useDeepMemo.min.js +8 -0
  97. package/useDeepMemo.min.js.map +1 -0
  98. package/NoSSR.min.mjs +0 -2
  99. package/index.min.mjs +0 -2
  100. package/index.min.mjs.map +0 -1
  101. package/sharedQuery.min.mjs +0 -2
  102. package/sharedQuery.min.mjs.map +0 -1
  103. package/sharedState.min.mjs +0 -2
  104. package/sharedState.min.mjs.map +0 -1
  105. package/storage.min.mjs +0 -2
  106. package/stringify.min.mjs +0 -2
  107. package/useDeepMemo.min.mjs +0 -2
@@ -1,3 +1,14 @@
1
+ import {
2
+ sharedState,
3
+ useSharedState
4
+ } from "./chunk-CIDQGOPA.js";
5
+ import {
6
+ stringifyDeterministicForKeys
7
+ } from "./chunk-7XC6EVMX.js";
8
+ import {
9
+ useDeepMemo
10
+ } from "./chunk-YTXGK6BR.js";
11
+
1
12
  // src/sharedQuery.ts
2
13
  import { http, retries } from "@choksheak/ts-utils/http";
3
14
  import { nonNil } from "@choksheak/ts-utils/nonNil";
@@ -5,358 +16,11 @@ import getByteSize from "object-sizeof";
5
16
  import {
6
17
  useCallback,
7
18
  useEffect,
8
- useMemo as useMemo2,
19
+ useMemo,
9
20
  useRef,
10
- useState as useState2
21
+ useState
11
22
  } from "react";
12
23
  import XXH from "xxhashjs";
13
-
14
- // src/sharedState.ts
15
- import { MS_PER_DAY } from "@choksheak/ts-utils/timeConstants";
16
- import { useSyncExternalStore } from "react";
17
-
18
- // src/storage.ts
19
- import { kvStore } from "@choksheak/ts-utils/kvStore";
20
- import { createLocalStore } from "@choksheak/ts-utils/localStore";
21
- var IS_NOT_BROWSER = typeof window === "undefined";
22
- function getStorageAdapter(options, defaultStoreExpiryMs) {
23
- const { store } = options ?? {};
24
- if (!store) {
25
- return null;
26
- }
27
- if ("persistTo" in store && typeof store.persistTo === "string" && "key" in store && typeof store.key === "string") {
28
- const expiryMs = store.expiryMs || defaultStoreExpiryMs;
29
- const config = { ...store, expiryMs };
30
- switch (store.persistTo) {
31
- case "localStorage":
32
- return localStoreAdapter(config);
33
- case "indexedDb":
34
- return kvStoreAdapter(config);
35
- default:
36
- store.persistTo;
37
- throw new Error(`Unknown store.adapter ${store.persistTo}`);
38
- }
39
- }
40
- return store;
41
- }
42
- function localStoreAdapter({
43
- key,
44
- expiryMs,
45
- isValid
46
- }) {
47
- const STORE_NAME = "react-utils";
48
- const adapter = createLocalStore(STORE_NAME, {
49
- defaultExpiryMs: expiryMs
50
- });
51
- const keyPrefix = key + ":";
52
- return {
53
- set: (key2, value) => {
54
- if (IS_NOT_BROWSER) return;
55
- adapter.set(keyPrefix + key2, value);
56
- },
57
- get: (key2) => {
58
- if (IS_NOT_BROWSER) return void 0;
59
- const fullKey = keyPrefix + key2;
60
- const value = adapter.get(fullKey);
61
- if (value !== void 0 && isValid && !isValid(value)) {
62
- console.warn(
63
- `localStorage adapter: Auto-discard invalid value for ${fullKey}: ${JSON.stringify(value)}`
64
- );
65
- adapter.delete(fullKey);
66
- return void 0;
67
- }
68
- return value;
69
- },
70
- delete: (key2) => {
71
- if (IS_NOT_BROWSER) return;
72
- adapter.delete(keyPrefix + key2);
73
- },
74
- /** Note that this will clear all keys in all shared states. */
75
- clear: () => {
76
- if (IS_NOT_BROWSER) return;
77
- adapter.clear();
78
- }
79
- };
80
- }
81
- function kvStoreAdapter({
82
- key,
83
- expiryMs,
84
- isValid
85
- }) {
86
- const keyPrefix = key + ":";
87
- return {
88
- set: async (key2, value) => {
89
- if (IS_NOT_BROWSER) return;
90
- await kvStore.set(keyPrefix + key2, value, expiryMs);
91
- },
92
- get: async (key2) => {
93
- if (IS_NOT_BROWSER) return void 0;
94
- const fullKey = keyPrefix + key2;
95
- const value = await kvStore.get(fullKey);
96
- if (value !== void 0 && isValid && !isValid(value)) {
97
- console.warn(
98
- `indexedDb adapter: Auto-discard invalid value for ${key2}:`,
99
- value
100
- );
101
- await kvStore.delete(fullKey);
102
- return void 0;
103
- }
104
- return value;
105
- },
106
- delete: async (key2) => {
107
- if (IS_NOT_BROWSER) return;
108
- await kvStore.delete(keyPrefix + key2);
109
- },
110
- clear: async () => {
111
- if (IS_NOT_BROWSER) return;
112
- await kvStore.clear();
113
- }
114
- };
115
- }
116
-
117
- // src/sharedState.ts
118
- var SharedStateConfig = {
119
- /**
120
- * Default duration for storage expiration in milliseconds. Initial value
121
- * is 30 days, but can be changed to anything.
122
- */
123
- storeExpiryMs: 30 * MS_PER_DAY,
124
- /**
125
- * True to load from storage only on mount, false (default) to load in
126
- * the top level scope when the shared state is defined.
127
- */
128
- lazyLoad: false
129
- };
130
- function configureSharedState(config) {
131
- Object.assign(SharedStateConfig, config);
132
- }
133
- function createPubSubStore() {
134
- const dataByKey = /* @__PURE__ */ new Map();
135
- const subscribersByKey = /* @__PURE__ */ new Map();
136
- function notify(key, next, prev) {
137
- const subscribers = subscribersByKey.get(key);
138
- if (!subscribers) return;
139
- const copy = Array.from(subscribers.values());
140
- for (const subscriber of copy) {
141
- try {
142
- subscriber(next, prev);
143
- } catch (e) {
144
- console.error(`Error invoking subscriber:`, e);
145
- }
146
- }
147
- }
148
- return {
149
- // This could be undefined if T includes undefined, else it should never
150
- // return undefined because the user has to always specify the default value.
151
- get(key) {
152
- return dataByKey.get(key);
153
- },
154
- set(key, value) {
155
- const prev = dataByKey.get(key);
156
- if (prev === value) return;
157
- dataByKey.set(key, value);
158
- notify(key, value, prev);
159
- },
160
- delete(key) {
161
- dataByKey.delete(key);
162
- },
163
- setNoNotify(key, value) {
164
- dataByKey.set(key, value);
165
- },
166
- // Subscribe to changes of a specific key
167
- subscribe(key, subscriber) {
168
- let subscribers = subscribersByKey.get(key);
169
- if (!subscribers) {
170
- subscribers = /* @__PURE__ */ new Set();
171
- subscribersByKey.set(key, subscribers);
172
- }
173
- subscribers.add(subscriber);
174
- return () => {
175
- subscribers.delete(subscriber);
176
- if (subscribers.size === 0) subscribersByKey.delete(key);
177
- };
178
- }
179
- };
180
- }
181
- function getOrCreatePubSubStore() {
182
- if (typeof window !== "undefined") {
183
- const t = window.globalThis;
184
- return t.reactUtilsPubSubStore || (t.reactUtilsPubSubStore = createPubSubStore());
185
- }
186
- return createPubSubStore();
187
- }
188
- var pubSubStore = getOrCreatePubSubStore();
189
- var STORAGE_KEY = "state";
190
- var stateKey = 0;
191
- function getNextStateKey() {
192
- if (typeof window !== "undefined") {
193
- const t = window.globalThis;
194
- t.reactUtilsStateKey = (t.reactUtilsStateKey ?? 0) + 1;
195
- return t.reactUtilsStateKey;
196
- }
197
- return ++stateKey;
198
- }
199
- function sharedState(defaultValue, options) {
200
- let readyResolve = () => {
201
- };
202
- const readyPromise = new Promise((resolve) => {
203
- readyResolve = resolve;
204
- });
205
- const resolveReadyPromise = readyResolve;
206
- const pubSubKey = String(getNextStateKey());
207
- const storageAdapter = getStorageAdapter(
208
- options,
209
- SharedStateConfig.storeExpiryMs
210
- );
211
- pubSubStore.setNoNotify(pubSubKey, defaultValue);
212
- const lazyLoad = options?.lazyLoad;
213
- const lazy = lazyLoad !== void 0 ? lazyLoad : SharedStateConfig.lazyLoad;
214
- function completeInit(stored) {
215
- const value = stored !== void 0 ? stored : defaultValue;
216
- pubSubStore.set(pubSubKey, value);
217
- obj.initDone = true;
218
- resolveReadyPromise();
219
- }
220
- const obj = {
221
- defaultValue,
222
- /** Allow users to await for the completion of data init. */
223
- readyPromise,
224
- lazy,
225
- initStarted: false,
226
- initDone: false,
227
- /** `subscribe` function required by useSyncExternalStore. */
228
- subscribe(subscriber) {
229
- return pubSubStore.subscribe(pubSubKey, () => subscriber());
230
- },
231
- /** Returns true if there is a backing store. */
232
- hasStore() {
233
- return Boolean(storageAdapter);
234
- },
235
- /**
236
- * Set a value directly into the store. Does nothing if there is no
237
- * backing store.
238
- *
239
- * Warning: If you want to set the value properly, you should use
240
- * `setValue()` instead which also updates the in-memory copy.
241
- */
242
- setInStore(value) {
243
- return storageAdapter?.set(STORAGE_KEY, value);
244
- },
245
- /**
246
- * Get a value directly from the store. Returns undefined if there is no
247
- * backing store.
248
- */
249
- getFromStore() {
250
- return storageAdapter?.get(STORAGE_KEY);
251
- },
252
- /**
253
- * Get the value of the shared state.
254
- * `getSnapshot` function — must return same ref if value unchanged.
255
- * Note that this would return the default value if data init from store is
256
- * not completed yet.
257
- */
258
- getSnapshot() {
259
- return pubSubStore.get(pubSubKey);
260
- },
261
- /** Set the value of the shared state. */
262
- setValue(next) {
263
- if (typeof next === "function") {
264
- const prev = pubSubStore.get(pubSubKey);
265
- next = next(prev);
266
- }
267
- pubSubStore.set(pubSubKey, next);
268
- void obj.setInStore(next);
269
- },
270
- /**
271
- * Remove the value of the shared state. Actually this just sets the value
272
- * back to the given default value.
273
- */
274
- delete() {
275
- pubSubStore.set(pubSubKey, defaultValue);
276
- return storageAdapter?.set(STORAGE_KEY, defaultValue);
277
- },
278
- /** Initial default handling. */
279
- initDefaultValueOnce() {
280
- if (obj.initDone || obj.initStarted) return;
281
- obj.initStarted = true;
282
- const maybePromise = obj.getFromStore();
283
- if (maybePromise instanceof Promise) {
284
- return maybePromise.then(completeInit);
285
- } else {
286
- const stored = maybePromise;
287
- completeInit(stored);
288
- }
289
- }
290
- };
291
- if (!lazy) {
292
- obj.initDefaultValueOnce();
293
- }
294
- return obj;
295
- }
296
- function useSharedState(state) {
297
- void state.initDefaultValueOnce();
298
- const value = useSyncExternalStore(
299
- (onStoreChange) => state.subscribe(onStoreChange),
300
- () => state.getSnapshot(),
301
- // getServerSnapshot is needed to prevent SSR dev errors in nextjs.
302
- () => state.getSnapshot()
303
- );
304
- return [value, state.setValue];
305
- }
306
- function useSharedStateValue(state) {
307
- return useSharedState(state)[0];
308
- }
309
- function useSharedStateSetter(state) {
310
- void state.initDefaultValueOnce();
311
- return state.setValue;
312
- }
313
-
314
- // src/stringify.ts
315
- function stringifyDeterministicForKeys(params) {
316
- const cache = /* @__PURE__ */ new Set();
317
- return JSON.stringify(params, (_, value) => {
318
- if (typeof value === "function") {
319
- throw new Error(`Functions should not be passed into query parameters`);
320
- }
321
- if (!value || typeof value !== "object" || Array.isArray(value)) {
322
- return value;
323
- }
324
- if (cache.has(value)) {
325
- return "[Circular]";
326
- }
327
- cache.add(value);
328
- if (value !== params) {
329
- try {
330
- JSON.stringify(value);
331
- } catch {
332
- return "[Unserializable]";
333
- }
334
- }
335
- return Object.keys(value).sort().reduce(
336
- (result, key) => {
337
- result[key] = value[key];
338
- return result;
339
- },
340
- {}
341
- );
342
- });
343
- }
344
-
345
- // src/useDeepMemo.ts
346
- import { isEqual } from "lodash-es";
347
- import { useMemo, useState } from "react";
348
- function useDeepMemo(value) {
349
- const [state, setState] = useState(value);
350
- return useMemo(() => {
351
- if (isEqual(state, value)) {
352
- return state;
353
- }
354
- setState(value);
355
- return value;
356
- }, [state, value]);
357
- }
358
-
359
- // src/sharedQuery.ts
360
24
  var SharedQueryConfig = {
361
25
  /** Refetch on every page load. */
362
26
  staleMs: 0,
@@ -486,6 +150,7 @@ function sharedQuery2(options) {
486
150
  const maxBytes = options?.maxBytes ?? SharedQueryConfig.maxBytes;
487
151
  const keepLastNonEmptyData = Boolean(options?.keepLastNonEmptyData);
488
152
  const log = options?.log ?? SharedQueryConfig.log;
153
+ options.name = queryName;
489
154
  const queryState = sharedState(
490
155
  {},
491
156
  // defaultValue
@@ -806,7 +471,7 @@ function useSharedQuery(query, ...args) {
806
471
  const stableArgs = useDeepMemo(args);
807
472
  const [queryState, setQueryState] = useSharedState(query.queryState);
808
473
  const isMounted = useRef(true);
809
- const queryKey = useMemo2(
474
+ const queryKey = useMemo(
810
475
  () => query.getQueryKey(stableArgs),
811
476
  [query, stableArgs]
812
477
  );
@@ -821,7 +486,7 @@ function useSharedQuery(query, ...args) {
821
486
  },
822
487
  [queryKey, setQueryState]
823
488
  );
824
- const [lastNonEmptyData, setLastNonEmptyData] = useState2();
489
+ const [lastNonEmptyData, setLastNonEmptyData] = useState();
825
490
  useEffect(() => {
826
491
  if (query.keepLastNonEmptyData && queryStateValue.data !== void 0) {
827
492
  setLastNonEmptyData(queryStateValue.data);
@@ -881,7 +546,7 @@ function useSharedQuery(query, ...args) {
881
546
  query.unmount(queryKey);
882
547
  };
883
548
  }, [executeQuery, query, queryKey]);
884
- return useMemo2(() => {
549
+ return useMemo(() => {
885
550
  return {
886
551
  ...queryStateValue,
887
552
  // Fill with lastNonEmptyData when data is undefined.
@@ -921,20 +586,10 @@ function useSharedQuery(query, ...args) {
921
586
  stableArgs
922
587
  ]);
923
588
  }
589
+
924
590
  export {
925
591
  SharedQueryConfig,
926
- SharedStateConfig,
927
592
  configureSharedQuery,
928
- configureSharedState,
929
- getStorageAdapter,
930
- kvStoreAdapter,
931
- localStoreAdapter,
932
593
  sharedQuery,
933
- sharedState,
934
- stringifyDeterministicForKeys,
935
- useDeepMemo,
936
- useSharedQuery,
937
- useSharedState,
938
- useSharedStateSetter,
939
- useSharedStateValue
594
+ useSharedQuery
940
595
  };
@@ -0,0 +1,105 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/storage.ts
2
+ var _kvStore = require('@choksheak/ts-utils/kvStore');
3
+ var _localStore = require('@choksheak/ts-utils/localStore');
4
+ var IS_NOT_BROWSER = typeof window === "undefined";
5
+ function getStorageAdapter(options, defaultStoreExpiryMs) {
6
+ const { store } = _nullishCoalesce(options, () => ( {}));
7
+ if (!store) {
8
+ return null;
9
+ }
10
+ if ("persistTo" in store && typeof store.persistTo === "string" && "key" in store && typeof store.key === "string") {
11
+ const expiryMs = store.expiryMs || defaultStoreExpiryMs;
12
+ const config = { ...store, expiryMs };
13
+ switch (store.persistTo) {
14
+ case "localStorage":
15
+ return localStoreAdapter(config);
16
+ case "indexedDb":
17
+ return kvStoreAdapter(config);
18
+ default:
19
+ store.persistTo;
20
+ throw new Error(`Unknown store.adapter ${store.persistTo}`);
21
+ }
22
+ }
23
+ return store;
24
+ }
25
+ function localStoreAdapter({
26
+ key,
27
+ expiryMs,
28
+ isValid
29
+ }) {
30
+ const STORE_NAME = "react-utils";
31
+ const adapter = _localStore.createLocalStore.call(void 0, STORE_NAME, {
32
+ defaultExpiryMs: expiryMs
33
+ });
34
+ const keyPrefix = key + ":";
35
+ return {
36
+ set: (key2, value) => {
37
+ if (IS_NOT_BROWSER) return;
38
+ adapter.set(keyPrefix + key2, value);
39
+ },
40
+ get: (key2) => {
41
+ if (IS_NOT_BROWSER) return void 0;
42
+ const fullKey = keyPrefix + key2;
43
+ const value = adapter.get(fullKey);
44
+ if (value !== void 0 && isValid && !isValid(value)) {
45
+ console.warn(
46
+ `localStorage adapter: Auto-discard invalid value for ${fullKey}: ${JSON.stringify(value)}`
47
+ );
48
+ adapter.delete(fullKey);
49
+ return void 0;
50
+ }
51
+ return value;
52
+ },
53
+ delete: (key2) => {
54
+ if (IS_NOT_BROWSER) return;
55
+ adapter.delete(keyPrefix + key2);
56
+ },
57
+ /** Note that this will clear all keys in all shared states. */
58
+ clear: () => {
59
+ if (IS_NOT_BROWSER) return;
60
+ adapter.clear();
61
+ }
62
+ };
63
+ }
64
+ function kvStoreAdapter({
65
+ key,
66
+ expiryMs,
67
+ isValid
68
+ }) {
69
+ const keyPrefix = key + ":";
70
+ return {
71
+ set: async (key2, value) => {
72
+ if (IS_NOT_BROWSER) return;
73
+ await _kvStore.kvStore.set(keyPrefix + key2, value, expiryMs);
74
+ },
75
+ get: async (key2) => {
76
+ if (IS_NOT_BROWSER) return void 0;
77
+ const fullKey = keyPrefix + key2;
78
+ const value = await _kvStore.kvStore.get(fullKey);
79
+ if (value !== void 0 && isValid && !isValid(value)) {
80
+ console.warn(
81
+ `indexedDb adapter: Auto-discard invalid value for ${key2}:`,
82
+ value
83
+ );
84
+ await _kvStore.kvStore.delete(fullKey);
85
+ return void 0;
86
+ }
87
+ return value;
88
+ },
89
+ delete: async (key2) => {
90
+ if (IS_NOT_BROWSER) return;
91
+ await _kvStore.kvStore.delete(keyPrefix + key2);
92
+ },
93
+ clear: async () => {
94
+ if (IS_NOT_BROWSER) return;
95
+ await _kvStore.kvStore.clear();
96
+ }
97
+ };
98
+ }
99
+
100
+
101
+
102
+
103
+
104
+ exports.getStorageAdapter = getStorageAdapter; exports.localStoreAdapter = localStoreAdapter; exports.kvStoreAdapter = kvStoreAdapter;
105
+ //# sourceMappingURL=chunk-RRQBFF4W.min.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/choksheaklau/src/react-utils/dist/chunk-RRQBFF4W.min.cjs","../src/storage.ts"],"names":["key"],"mappings":"AAAA;ACYA,sDAAwB;AACxB,4DAAiC;AAkCjC,IAAM,eAAA,EAAiB,OAAO,OAAA,IAAW,WAAA;AAMlC,SAAS,iBAAA,CACd,OAAA,EACA,oBAAA,EAC0B;AAC1B,EAAA,MAAM,EAAE,MAAM,EAAA,mBAAI,OAAA,UAAW,CAAC,GAAA;AAE9B,EAAA,GAAA,CAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,GAAA,CACE,YAAA,GAAe,MAAA,GACf,OAAO,KAAA,CAAM,UAAA,IAAc,SAAA,GAC3B,MAAA,GAAS,MAAA,GACT,OAAO,KAAA,CAAM,IAAA,IAAQ,QAAA,EACrB;AACA,IAAA,MAAM,SAAA,EAAW,KAAA,CAAM,SAAA,GAAY,oBAAA;AACnC,IAAA,MAAM,OAAA,EAAS,EAAE,GAAG,KAAA,EAAO,SAAS,CAAA;AAEpC,IAAA,OAAA,CAAQ,KAAA,CAAM,SAAA,EAAW;AAAA,MACvB,KAAK,cAAA;AACH,QAAA,OAAO,iBAAA,CAAqB,MAAM,CAAA;AAAA,MAEpC,KAAK,WAAA;AACH,QAAA,OAAO,cAAA,CAAkB,MAAM,CAAA;AAAA,MAEjC,OAAA;AACE,QAAA,KAAA,CAAM,SAAA;AACN,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,sBAAA,EAAyB,KAAA,CAAM,SAAS,CAAA,CAAA;AAC5D,IAAA;AACF,EAAA;AAEO,EAAA;AACT;AAMqC;AACnC,EAAA;AACA,EAAA;AACA,EAAA;AACuB;AAEJ,EAAA;AAE0B,EAAA;AAC1B,IAAA;AAClB,EAAA;AAGuB,EAAA;AAEjB,EAAA;AACiC,IAAA;AAChB,MAAA;AAGc,MAAA;AACpC,IAAA;AAEqC,IAAA;AACR,MAAA;AAECA,MAAAA;AACQ,MAAA;AAGmB,MAAA;AAC7C,QAAA;AACN,UAAA;AACF,QAAA;AACsB,QAAA;AACf,QAAA;AACT,MAAA;AAEO,MAAA;AACT,IAAA;AAE+B,IAAA;AACT,MAAA;AAEU,MAAA;AAChC,IAAA;AAAA;AAGmB,IAAA;AACG,MAAA;AAEN,MAAA;AAChB,IAAA;AACF,EAAA;AACF;AAMkC;AAChC,EAAA;AACA,EAAA;AACA,EAAA;AACuB;AAEC,EAAA;AAKjB,EAAA;AACgD,IAAA;AAC/B,MAAA;AAG8B,MAAA;AACpD,IAAA;AACoD,IAAA;AACvB,MAAA;AAECA,MAAAA;AACc,MAAA;AAGa,MAAA;AAC7C,QAAA;AAC+CA,UAAAA;AACrD,UAAA;AACF,QAAA;AAC4B,QAAA;AACrB,QAAA;AACT,MAAA;AAEO,MAAA;AACT,IAAA;AAC8C,IAAA;AACxB,MAAA;AAEgB,MAAA;AACtC,IAAA;AACkC,IAAA;AACZ,MAAA;AAEA,MAAA;AACtB,IAAA;AACF,EAAA;AACF;ADrGiE;AACA;AACA;AACA;AACA;AACA","file":"/Users/choksheaklau/src/react-utils/dist/chunk-RRQBFF4W.min.cjs","sourcesContent":[null,"/**\n * @packageDocumentation\n *\n * Backing storage implementation for the shared state. Note that this uses the\n * LocalStore and KvStore from package \"@choksheak/ts-utils\", but is customized\n * to be used for shared states.\n *\n * Normally you will not need to use this module directly, but if you have a\n * need for it, feel free to use it.\n */\n\nimport { Duration } from \"@choksheak/ts-utils/duration\";\nimport { kvStore } from \"@choksheak/ts-utils/kvStore\";\nimport { createLocalStore } from \"@choksheak/ts-utils/localStore\";\nimport { StorageAdapter } from \"@choksheak/ts-utils/storageAdapter\";\n\n/** List of all available pre-built persistence options. */\nexport type PersistTo = \"localStorage\" | \"indexedDb\";\n\n/** Options to configure a pre-built store adapter. */\nexport type StoreOptions = {\n /** Choose which pre-built store adapter to use. */\n persistTo: PersistTo;\n\n /** Storage key to act as a namespace to store the data. */\n key: string;\n\n /** How long to wait before the value is considered expired. */\n expiryMs?: number | Duration;\n\n /** Returns true if the given value supposed to be of type T is valid. */\n isValid?: (u: unknown) => boolean;\n};\n\nexport type StoreConstructorArgs = Omit<StoreOptions, \"persistTo\">;\n\n/** Either use a pre-built store, or a custom one you provide. */\nexport type StorageOptions<T> = {\n /**\n * You can either specify the storage adapter directly to use a custom\n * store, or specify the properties to use the pre-built ones.\n */\n store?: StorageAdapter<T> | StoreOptions;\n};\n\n// In SSR (Server-Side Rendering) mode, we never want to use our storage\n// adapters for anything.\nconst IS_NOT_BROWSER = typeof window === \"undefined\";\n\n/**\n * Convert a StorageOptions<T> config object into an actual storage adapter, or\n * returns null if a storage adapter is not configured.\n */\nexport function getStorageAdapter<T>(\n options: StorageOptions<T> | undefined,\n defaultStoreExpiryMs: number,\n): StorageAdapter<T> | null {\n const { store } = options ?? {};\n\n if (!store) {\n return null;\n }\n\n if (\n \"persistTo\" in store &&\n typeof store.persistTo === \"string\" &&\n \"key\" in store &&\n typeof store.key === \"string\"\n ) {\n const expiryMs = store.expiryMs || defaultStoreExpiryMs;\n const config = { ...store, expiryMs };\n\n switch (store.persistTo) {\n case \"localStorage\":\n return localStoreAdapter<T>(config);\n\n case \"indexedDb\":\n return kvStoreAdapter<T>(config);\n\n default:\n store.persistTo satisfies never;\n throw new Error(`Unknown store.adapter ${store.persistTo}`);\n }\n }\n\n return store as StorageAdapter<T>;\n}\n\n/**\n * Create a new SSR-safe local store adapter, which allows users to reuse the\n * same adapter in multiple shared states or shared queries.\n */\nexport function localStoreAdapter<T>({\n key,\n expiryMs,\n isValid,\n}: StoreConstructorArgs) {\n // Put everything in the same store so that we can GC properly.\n const STORE_NAME = \"react-utils\";\n\n const adapter = createLocalStore(STORE_NAME, {\n defaultExpiryMs: expiryMs,\n });\n\n // Use the key prefix as a unique namespace for this store.\n const keyPrefix = key + \":\";\n\n return {\n set: (key: string, value: T): void => {\n if (IS_NOT_BROWSER) return; // handle SSR\n\n // Also apply the custom expiryMs on every item in this store.\n adapter.set(keyPrefix + key, value);\n },\n\n get: (key: string): T | undefined => {\n if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n const fullKey = keyPrefix + key;\n const value = adapter.get<T>(fullKey);\n\n // If there is no value, don't try to check for validatity.\n if (value !== undefined && isValid && !isValid(value)) {\n console.warn(\n `localStorage adapter: Auto-discard invalid value for ${fullKey}: ${JSON.stringify(value)}`,\n );\n adapter.delete(fullKey);\n return undefined;\n }\n\n return value;\n },\n\n delete: (key: string): void => {\n if (IS_NOT_BROWSER) return; // handle SSR\n\n adapter.delete(keyPrefix + key);\n },\n\n /** Note that this will clear all keys in all shared states. */\n clear: (): void => {\n if (IS_NOT_BROWSER) return; // handle SSR\n\n adapter.clear();\n },\n };\n}\n\n/**\n * Create a new SSR-safe indexed DB KV store adapter, which allows users to\n * reuse the same adapter in multiple shared states or shared queries.\n */\nexport function kvStoreAdapter<T>({\n key,\n expiryMs,\n isValid,\n}: StoreConstructorArgs) {\n // Use the key prefix as a unique namespace for this store.\n const keyPrefix = key + \":\";\n\n // Prefix all keys using `keyPrefix` so that we can keep all data in\n // the same store in the same DB. If we keep the data in different\n // DB stores, then GC will not be able to clean up abandoned stores.\n return {\n set: async (key: string, value: T): Promise<void> => {\n if (IS_NOT_BROWSER) return; // handle SSR\n\n // Also apply the custom expiryMs on every item in this store.\n await kvStore.set(keyPrefix + key, value, expiryMs);\n },\n get: async (key: string): Promise<T | undefined> => {\n if (IS_NOT_BROWSER) return undefined; // handle SSR\n\n const fullKey = keyPrefix + key;\n const value = await kvStore.get<T>(fullKey);\n\n // If there is no value, don't try to check for validatity.\n if (value !== undefined && isValid && !isValid(value)) {\n console.warn(\n `indexedDb adapter: Auto-discard invalid value for ${key}:`,\n value,\n );\n await kvStore.delete(fullKey);\n return undefined;\n }\n\n return value;\n },\n delete: async (key: string): Promise<void> => {\n if (IS_NOT_BROWSER) return; // handle SSR\n\n await kvStore.delete(keyPrefix + key);\n },\n clear: async (): Promise<void> => {\n if (IS_NOT_BROWSER) return; // handle SSR\n\n await kvStore.clear();\n },\n };\n}\n"]}
@@ -0,0 +1,36 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true});var __create = Object.create;
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __getProtoOf = Object.getPrototypeOf;
6
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
7
+ var __commonJS = (cb, mod) => function __require() {
8
+ return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
9
+ };
10
+ var __export = (target, all) => {
11
+ for (var name in all)
12
+ __defProp(target, name, { get: all[name], enumerable: true });
13
+ };
14
+ var __copyProps = (to, from, except, desc) => {
15
+ if (from && typeof from === "object" || typeof from === "function") {
16
+ for (let key of __getOwnPropNames(from))
17
+ if (!__hasOwnProp.call(to, key) && key !== except)
18
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
19
+ }
20
+ return to;
21
+ };
22
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
23
+ // If the importer is in node compatibility mode or this is not an ESM
24
+ // file that has been converted to a CommonJS file using a Babel-
25
+ // compatible transform (i.e. "__esModule" has not been set), then set
26
+ // "default" to the CommonJS "module.exports" for node compatibility.
27
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
28
+ mod
29
+ ));
30
+
31
+
32
+
33
+
34
+
35
+ exports.__commonJS = __commonJS; exports.__export = __export; exports.__toESM = __toESM;
36
+ //# sourceMappingURL=chunk-TST6JKQ5.min.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/choksheaklau/src/react-utils/dist/chunk-TST6JKQ5.min.cjs"],"names":[],"mappings":"AAAA,6EAAI,SAAS,EAAE,MAAM,CAAC,MAAM;AAC5B,IAAI,UAAU,EAAE,MAAM,CAAC,cAAc;AACrC,IAAI,iBAAiB,EAAE,MAAM,CAAC,wBAAwB;AACtD,IAAI,kBAAkB,EAAE,MAAM,CAAC,mBAAmB;AAClD,IAAI,aAAa,EAAE,MAAM,CAAC,cAAc;AACxC,IAAI,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,cAAc;AAClD,IAAI,WAAW,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,SAAS,SAAS,CAAC,EAAE;AACnD,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,OAAO;AACpG,CAAC;AACD,IAAI,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG;AAChC,EAAE,IAAI,CAAC,IAAI,KAAK,GAAG,GAAG;AACtB,IAAI,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC;AACD,IAAI,YAAY,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;AAC9C,EAAE,GAAG,CAAC,KAAK,GAAG,OAAO,KAAK,IAAI,SAAS,GAAG,OAAO,KAAK,IAAI,UAAU,EAAE;AACtE,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC;AAC3C,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,MAAM;AACvD,QAAQ,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;AAC1H,EAAE;AACF,EAAE,OAAO,EAAE;AACX,CAAC;AACD,IAAI,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW;AAChH;AACA;AACA;AACA;AACA,EAAE,WAAW,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM;AACjH,EAAE;AACF,CAAC,CAAC;AACF;AACA;AACE;AACA;AACA;AACF,wFAAC","file":"/Users/choksheaklau/src/react-utils/dist/chunk-TST6JKQ5.min.cjs"}
@@ -0,0 +1,35 @@
1
+ var __create = Object.create;
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __getProtoOf = Object.getPrototypeOf;
6
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
7
+ var __commonJS = (cb, mod) => function __require() {
8
+ return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
9
+ };
10
+ var __export = (target, all) => {
11
+ for (var name in all)
12
+ __defProp(target, name, { get: all[name], enumerable: true });
13
+ };
14
+ var __copyProps = (to, from, except, desc) => {
15
+ if (from && typeof from === "object" || typeof from === "function") {
16
+ for (let key of __getOwnPropNames(from))
17
+ if (!__hasOwnProp.call(to, key) && key !== except)
18
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
19
+ }
20
+ return to;
21
+ };
22
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
23
+ // If the importer is in node compatibility mode or this is not an ESM
24
+ // file that has been converted to a CommonJS file using a Babel-
25
+ // compatible transform (i.e. "__esModule" has not been set), then set
26
+ // "default" to the CommonJS "module.exports" for node compatibility.
27
+ isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
28
+ mod
29
+ ));
30
+
31
+ export {
32
+ __commonJS,
33
+ __export,
34
+ __toESM
35
+ };