@dr.pogodin/react-global-state 0.16.0 → 0.17.0

package/build/module/useAsyncCollection.js

@@ -7,7 +7,125 @@ import { v4 as uuid } from 'uuid';
 import { getGlobalState } from "./GlobalStateProvider";
 import { DEFAULT_MAXAGE, load, newAsyncDataEnvelope } from "./useAsyncData";
 import useGlobalState from "./useGlobalState";
-import { isDebugMode } from "./utils";
+import { hash, isDebugMode } from "./utils";
+/**
+ * GarbageCollector: the piece of logic executed on mounting of
+ * an useAsyncCollection() hook, and on update of hook params, to update
+ * the state according to the new param values. It increments by 1 `numRefs`
+ * counters for the requested collection items.
+ */
+function gcOnWithhold(ids, path, gs) {
+  const collection = {
+    ...gs.get(path)
+  };
+  for (let i = 0; i < ids.length; ++i) {
+    const id = ids[i];
+    let envelope = collection[id];
+    if (envelope) envelope = {
+      ...envelope,
+      numRefs: 1 + envelope.numRefs
+    };else envelope = newAsyncDataEnvelope(null, {
+      numRefs: 1
+    });
+    collection[id] = envelope;
+  }
+  gs.set(path, collection);
+}
+function idsToStringSet(ids) {
+  const res = new Set();
+  for (let i = 0; i < ids.length; ++i) {
+    res.add(ids[i].toString());
+  }
+  return res;
+}
+
+/**
+ * GarbageCollector: the piece of logic executed on un-mounting of
+ * an useAsyncCollection() hook, and on update of hook params, to clean-up
+ * after the previous param values. It decrements by 1 `numRefs` counters
+ * for previously requested collection items, and also drops from the state
+ * stale records.
+ */
+function gcOnRelease(ids, path, gs, gcAge) {
+  const entries = Object.entries(gs.get(path));
+  const now = Date.now();
+  const idSet = idsToStringSet(ids);
+  const collection = {};
+  for (let i = 0; i < entries.length; ++i) {
+    const [id, envelope] = entries[i];
+    if (envelope) {
+      const toBeReleased = idSet.has(id);
+      let {
+        numRefs
+      } = envelope;
+      if (toBeReleased) --numRefs;
+      if (gcAge > now - envelope.timestamp || numRefs > 0) {
+        collection[id] = toBeReleased ? {
+          ...envelope,
+          numRefs
+        } : envelope;
+      } else if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
+        // eslint-disable-next-line no-console
+        console.log(`useAsyncCollection(): Garbage collected at the path "${path}", ID = ${id}`);
+      }
+    }
+  }
+  gs.set(path, collection);
+}
+function normalizeIds(idOrIds) {
+  if (Array.isArray(idOrIds)) {
+    const res = [...idOrIds];
+    res.sort();
+    return res;
+  }
+  return [idOrIds];
+}
+
+/**
+ * Inits/updates, and returns the heap.
+ */
+function useHeap(ids, path, loader, gs) {
+  const ref = useRef();
+  let heap = ref.current;
+  if (heap) {
+    // Update.
+    heap.ids = ids;
+    heap.path = path;
+    heap.loader = loader;
+    heap.globalState = gs;
+  } else {
+    // Initialization.
+    const reload = async customLoader => {
+      const heap2 = ref.current;
+      const localLoader = customLoader || heap2.loader;
+      if (!localLoader || !heap2.globalState || !heap2.ids) {
+        throw Error('Internal error');
+      }
+      for (let i = 0; i < heap2.ids.length; ++i) {
+        const id = heap2.ids[i];
+        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;
+
+        // eslint-disable-next-line no-await-in-loop
+        await load(itemPath, (oldData, meta) => localLoader(id, oldData, meta), heap2.globalState);
+      }
+    };
+    heap = {
+      globalState: gs,
+      ids,
+      path,
+      loader,
+      reload,
+      reloadSingle: customLoader => ref.current.reload(customLoader && function (id) {
+        for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+          args[_key - 1] = arguments[_key];
+        }
+        return customLoader(...args);
+      })
+    };
+    ref.current = heap;
+  }
+  return heap;
+}
 
 /**
  * Resolves and stores at the given `path` of the global state elements of
@@ -20,47 +138,12 @@ import { isDebugMode } from "./utils";
 function useAsyncCollection(idOrIds, path, loader) {
   var _options$maxage, _options$refreshAge, _options$garbageColle;
   let options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
-  const ids = Array.isArray(idOrIds) ? idOrIds : [idOrIds];
+  const ids = normalizeIds(idOrIds);
   const maxage = (_options$maxage = options.maxage) !== null && _options$maxage !== void 0 ? _options$maxage : DEFAULT_MAXAGE;
   const refreshAge = (_options$refreshAge = options.refreshAge) !== null && _options$refreshAge !== void 0 ? _options$refreshAge : maxage;
   const garbageCollectAge = (_options$garbageColle = options.garbageCollectAge) !== null && _options$garbageColle !== void 0 ? _options$garbageColle : maxage;
-
-  // To avoid unnecessary work if consumer passes down the same IDs
-  // in an unstable order.
-  // TODO: Should we also filter out any duplicates? Or just assume consumer
-  // knows what he is doing, and won't place duplicates into IDs array?e
-  ids.sort();
   const globalState = getGlobalState();
-  const {
-    current: heap
-  } = useRef({});
-  heap.globalState = globalState;
-  heap.ids = ids;
-  heap.path = path;
-  heap.loader = loader;
-  if (!heap.reload) {
-    heap.reload = async customLoader => {
-      const localLoader = customLoader || heap.loader;
-      if (!localLoader || !heap.globalState || !heap.ids) {
-        throw Error('Internal error');
-      }
-      for (let i = 0; i < heap.ids.length; ++i) {
-        const id = heap.ids[i];
-        const itemPath = heap.path ? `${heap.path}.${id}` : `${id}`;
-
-        // eslint-disable-next-line no-await-in-loop
-        await load(itemPath, (oldData, meta) => localLoader(id, oldData, meta), heap.globalState);
-      }
-    };
-  }
-  if (!Array.isArray(idOrIds)) {
-    heap.reloadD = customLoader => heap.reload(customLoader && function (id) {
-      for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
-        args[_key - 1] = arguments[_key];
-      }
-      return customLoader(...args);
-    });
-  }
+  const heap = useHeap(ids, path, loader, globalState);
 
   // Server-side logic.
   if (globalState.ssrContext && !options.noSSR) {
@@ -88,45 +171,19 @@ function useAsyncCollection(idOrIds, path, loader) {
   } else {
     // Reference-counting & garbage collection.
 
+    const idsHash = hash(ids);
+
     // TODO: Violation of rules of hooks is fine here,
     // but perhaps it can be refactored to avoid the need for it.
     useEffect(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
-      for (let i = 0; i < ids.length; ++i) {
-        const id = ids[i];
-        const itemPath = path ? `${path}.${id}` : `${id}`;
-        const state = globalState.get(itemPath, {
-          initialValue: newAsyncDataEnvelope()
-        });
-        const numRefsPath = itemPath ? `${itemPath}.numRefs` : 'numRefs';
-        globalState.set(numRefsPath, state.numRefs + 1);
-      }
-      return () => {
-        for (let i = 0; i < ids.length; ++i) {
-          const id = ids[i];
-          const itemPath = path ? `${path}.${id}` : `${id}`;
-          const state2 = globalState.get(itemPath);
-          if (state2.numRefs === 1 && garbageCollectAge < Date.now() - state2.timestamp) {
-            if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-              /* eslint-disable no-console */
-              console.log(`ReactGlobalState - useAsyncCollection garbage collected at path ${itemPath || ''}`);
-              /* eslint-enable no-console */
-            }
-            globalState.dropDependencies(itemPath || '');
-            globalState.set(itemPath, {
-              ...state2,
-              data: null,
-              numRefs: 0,
-              timestamp: 0
-            });
-          } else {
-            const numRefsPath = itemPath ? `${itemPath}.numRefs` : 'numRefs';
-            globalState.set(numRefsPath, state2.numRefs - 1);
-          }
-        }
-      };
+      gcOnWithhold(ids, path, globalState);
+      return () => gcOnRelease(ids, path, globalState, garbageCollectAge);
+
+      // `ids` are represented in the dependencies array by `idsHash` value,
+      // as useEffect() hook requires a constant size of dependencies array.
       // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [garbageCollectAge, globalState, path, ...ids]);
+    }, [garbageCollectAge, globalState, idsHash, path]);
 
     // NOTE: a bunch of Rules of Hooks ignored belows because in our very
     // special case the otherwise wrong behavior is actually what we need.
@@ -189,7 +246,7 @@ function useAsyncCollection(idOrIds, path, loader) {
     return {
       data: maxage < Date.now() - timestamp ? null : (_e$data = e === null || e === void 0 ? void 0 : e.data) !== null && _e$data !== void 0 ? _e$data : null,
       loading: !!(e !== null && e !== void 0 && e.operationId),
-      reload: heap.reloadD,
+      reload: heap.reloadSingle,
       timestamp
     };
   }

package/build/module/useAsyncCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncCollection.js","names":["useEffect","useRef","v4","uuid","getGlobalState","DEFAULT_MAXAGE","load","newAsyncDataEnvelope","useGlobalState","isDebugMode","useAsyncCollection","idOrIds","path","loader","_options$maxage","_options$refreshAge","_options$garbageColle","options","arguments","length","undefined","ids","Array","isArray","maxage","refreshAge","garbageCollectAge","sort","globalState","current","heap","reload","customLoader","localLoader","Error","i","id","itemPath","oldData","meta","reloadD","_len","args","_key","ssrContext","noSSR","operationId","state","get","initialValue","timestamp","pending","push","_len2","_key2","data","numRefsPath","set","numRefs","state2","Date","now","process","env","NODE_ENV","console","log","dropDependencies","loadTriggeredForIds","Set","deps","hasChangedDependencies","charAt","add","_len3","_key3","has","localState","_e$timestamp","_e$data","e","loading","res","items","Number","MAX_VALUE","_e$timestamp2","_e$data2"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  DEFAULT_MAXAGE,\n  load,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> =\n  (id: IdT, oldData: null | DataT, meta: {\n    isAborted: () => boolean;\n    oldDataTimestamp: number;\n  }) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void>;\n\ntype CollectionItemT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  timestamp: number;\n};\n\nexport type UseAsyncCollectionResT<\n  DataT,\n  IdT extends number | string = number | string,\n> = {\n  items: {\n    [id in IdT]: CollectionItemT<DataT>;\n  }\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype HeapT<\n  DataT,\n  IdT extends number | string,\n> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState?: GlobalState<unknown>;\n  ids?: IdT[];\n  path?: null | string;\n  loader?: AsyncCollectionLoaderT<DataT, IdT>;\n  reload?: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadD?: AsyncDataReloaderT<DataT>;\n};\n\n/**\n * Resolves and stores at the given `path` of the global state elements of\n * an asynchronous data collection.\n */\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT,\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT,\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\n// TODO: This is largely similar to useAsyncData() logic, just more generic.\n// Perhaps, a bunch of logic blocks can be split into stand-alone functions,\n// and reused in both hooks.\nfunction useAsyncCollection<\n  DataT,\n  IdT extends number | string,\n>(\n  idOrIds: IdT | IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT> {\n  const ids = Array.isArray(idOrIds) ? idOrIds : [idOrIds];\n\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  // To avoid unnecessary work if consumer passes down the same IDs\n  // in an unstable order.\n  // TODO: Should we also filter out any duplicates? Or just assume consumer\n  // knows what he is doing, and won't place duplicates into IDs array?e\n  ids.sort();\n\n  const globalState = getGlobalState();\n\n  const { current: heap } = useRef<HeapT<DataT, IdT>>({});\n\n  heap.globalState = globalState;\n  heap.ids = ids;\n  heap.path = path;\n  heap.loader = loader;\n\n  if (!heap.reload) {\n    heap.reload = async (customLoader?: AsyncCollectionLoaderT<DataT, IdT>) => {\n      const localLoader = customLoader || heap.loader;\n      if (!localLoader || !heap.globalState || !heap.ids) {\n        throw Error('Internal error');\n      }\n\n      for (let i = 0; i < heap.ids.length; ++i) {\n        const id = heap.ids[i]!;\n        const itemPath = heap.path ? `${heap.path}.${id}` : `${id}`;\n\n        // eslint-disable-next-line no-await-in-loop\n        await load(\n          itemPath,\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap.globalState,\n        );\n      }\n    };\n  }\n\n  if (!Array.isArray(idOrIds)) {\n    heap.reloadD = (customLoader) => heap.reload!(\n      customLoader && ((id, ...args) => customLoader(...args)),\n    );\n  }\n\n  // Server-side logic.\n  if (globalState.ssrContext && !options.noSSR) {\n    const operationId: OperationIdT = `S${uuid()}`;\n    for (let i = 0; i < ids.length; ++i) {\n      const id = ids[i]!;\n      const itemPath = path ? `${path}.${id}` : `${id}`;\n      const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(itemPath, {\n        initialValue: newAsyncDataEnvelope<DataT>(),\n      });\n      if (!state.timestamp && !state.operationId) {\n        globalState.ssrContext.pending.push(\n          load(itemPath, (...args) => loader(id, ...args), globalState, {\n            data: state.data,\n            timestamp: state.timestamp,\n          }, operationId),\n        );\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    // Reference-counting & garbage collection.\n\n    // TODO: Violation of rules of hooks is fine here,\n    // but perhaps it can be refactored to avoid the need for it.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      for (let i = 0; i < ids.length; ++i) {\n        const id = ids[i];\n        const itemPath = path ? `${path}.${id}` : `${id}`;\n        const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n          itemPath,\n          { initialValue: newAsyncDataEnvelope() },\n        );\n\n        const numRefsPath = itemPath ? `${itemPath}.numRefs` : 'numRefs';\n        globalState.set<ForceT, number>(numRefsPath, state.numRefs + 1);\n      }\n\n      return () => {\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i];\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>\n          >(itemPath);\n          if (\n            state2.numRefs === 1\n            && garbageCollectAge < Date.now() - state2.timestamp\n          ) {\n            if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n              /* eslint-disable no-console */\n              console.log(\n                `ReactGlobalState - useAsyncCollection garbage collected at path ${\n                  itemPath || ''\n                }`,\n              );\n              /* eslint-enable no-console */\n            }\n            globalState.dropDependencies(itemPath || '');\n            globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(itemPath, {\n              ...state2,\n              data: null,\n              numRefs: 0,\n              timestamp: 0,\n            });\n          } else {\n            const numRefsPath = itemPath ? `${itemPath}.numRefs` : 'numRefs';\n            globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n          }\n        }\n      };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [garbageCollectAge, globalState, path, ...ids]);\n\n    // NOTE: a bunch of Rules of Hooks ignored belows because in our very\n    // special case the otherwise wrong behavior is actually what we need.\n\n    // Data loading and refreshing.\n    const loadTriggeredForIds = new Set<IdT>();\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      (async () => {\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i]!;\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>>(itemPath);\n\n          const { deps } = options;\n          if (\n            (deps && globalState.hasChangedDependencies(itemPath, deps))\n            || (\n              refreshAge < Date.now() - state2.timestamp\n              && (!state2.operationId || state2.operationId.charAt(0) === 'S')\n            )\n          ) {\n            if (!deps) globalState.dropDependencies(itemPath);\n            loadTriggeredForIds.add(id);\n            // eslint-disable-next-line no-await-in-loop\n            await load(itemPath, (...args) => loader(id, ...args), globalState, {\n              data: state2.data,\n              timestamp: state2.timestamp,\n            });\n          }\n        }\n      })();\n    });\n\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      (async () => {\n        const { deps } = options;\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i]!;\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n          if (\n            deps\n            && globalState.hasChangedDependencies(itemPath || '', deps)\n            && !loadTriggeredForIds.has(id)\n          ) {\n            // eslint-disable-next-line no-await-in-loop\n            await load(\n              itemPath,\n              (oldData: null | DataT, meta) => loader(id, oldData, meta),\n              globalState,\n            );\n          }\n        }\n      })();\n\n    // Here we need to default to empty array, so that this hook is re-evaluated\n    // only when dependencies specified in options change, and it should not be\n    // re-evaluated at all if no `deps` option is used.\n    }, options.deps || []); // eslint-disable-line react-hooks/exhaustive-deps\n  }\n\n  const [localState] = useGlobalState<\n  ForceT, { [id: string]: AsyncDataEnvelopeT<DataT> }\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    const e = localState[idOrIds];\n    const timestamp = e?.timestamp ?? 0;\n    return {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading: !!e?.operationId,\n      reload: heap.reloadD!,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: heap.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (let i = 0; i < ids.length; ++i) {\n    const id = ids[i]!;\n    const e = localState[id];\n    const loading = !!e?.operationId;\n    const timestamp = e?.timestamp ?? 0;\n\n    res.items[id] = {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading,\n      timestamp,\n    };\n    res.loading ||= loading;\n    if (res.timestamp > timestamp) res.timestamp = timestamp;\n  }\n\n  return res;\n}\n\nexport default useAsyncCollection;\n\nexport interface UseAsyncCollectionI<StateT> {\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT,\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT,\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT[],\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataT, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useAsyncCollection.js","names":["useEffect","useRef","v4","uuid","getGlobalState","DEFAULT_MAXAGE","load","newAsyncDataEnvelope","useGlobalState","hash","isDebugMode","gcOnWithhold","ids","path","gs","collection","get","i","length","id","envelope","numRefs","set","idsToStringSet","res","Set","add","toString","gcOnRelease","gcAge","entries","Object","now","Date","idSet","toBeReleased","has","timestamp","process","env","NODE_ENV","console","log","normalizeIds","idOrIds","Array","isArray","sort","useHeap","loader","ref","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","oldData","meta","reloadSingle","_len","arguments","args","_key","useAsyncCollection","_options$maxage","_options$refreshAge","_options$garbageColle","options","undefined","maxage","refreshAge","garbageCollectAge","ssrContext","noSSR","operationId","state","initialValue","pending","push","_len2","_key2","data","idsHash","loadTriggeredForIds","state2","deps","hasChangedDependencies","charAt","dropDependencies","_len3","_key3","localState","_e$timestamp","_e$data","e","loading","items","Number","MAX_VALUE","_e$timestamp2","_e$data2"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  DEFAULT_MAXAGE,\n  load,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  hash,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n  DataT = unknown,\n  IdT extends number | string = number | string,\n> = { [id in IdT]?: AsyncDataEnvelopeT<DataT> };\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> =\n  (id: IdT, oldData: null | DataT, meta: {\n    isAborted: () => boolean;\n    oldDataTimestamp: number;\n  }) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void>;\n\ntype CollectionItemT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  timestamp: number;\n};\n\nexport type UseAsyncCollectionResT<\n  DataT,\n  IdT extends number | string = number | string,\n> = {\n  items: {\n    [id in IdT]: CollectionItemT<DataT>;\n  }\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype HeapT<\n  DataT,\n  IdT extends number | string,\n> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState: GlobalState<unknown>;\n  ids: IdT[];\n  path: null | string | undefined;\n  loader: AsyncCollectionLoaderT<DataT, IdT>;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadSingle: AsyncDataReloaderT<DataT>;\n};\n\n/**\n * GarbageCollector: the piece of logic executed on mounting of\n * an useAsyncCollection() hook, and on update of hook params, to update\n * the state according to the new param values. It increments by 1 `numRefs`\n * counters for the requested collection items.\n */\nfunction gcOnWithhold<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n) {\n  const collection = { ...gs.get<ForceT, AsyncCollectionT>(path) };\n\n  for (let i = 0; i < ids.length; ++i) {\n    const id = ids[i]!;\n    let envelope = collection[id];\n    if (envelope) envelope = { ...envelope, numRefs: 1 + envelope.numRefs };\n    else envelope = newAsyncDataEnvelope<unknown>(null, { numRefs: 1 });\n    collection[id] = envelope;\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction idsToStringSet<IdT extends number | string>(ids: IdT[]): Set<string> {\n  const res = new Set<string>();\n  for (let i = 0; i < ids.length; ++i) {\n    res.add(ids[i]!.toString());\n  }\n  return res;\n}\n\n/**\n * GarbageCollector: the piece of logic executed on un-mounting of\n * an useAsyncCollection() hook, and on update of hook params, to clean-up\n * after the previous param values. It decrements by 1 `numRefs` counters\n * for previously requested collection items, and also drops from the state\n * stale records.\n */\nfunction gcOnRelease<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n  gcAge: number,\n) {\n  type EnvelopeT = AsyncDataEnvelopeT<unknown>;\n\n  const entries = Object.entries<EnvelopeT | undefined>(\n    gs.get<ForceT, AsyncCollectionT>(path),\n  );\n\n  const now = Date.now();\n  const idSet = idsToStringSet(ids);\n  const collection: AsyncCollectionT = {};\n  for (let i = 0; i < entries.length; ++i) {\n    const [id, envelope] = entries[i]!;\n\n    if (envelope) {\n      const toBeReleased = idSet.has(id);\n\n      let { numRefs } = envelope;\n      if (toBeReleased) --numRefs;\n\n      if (gcAge > now - envelope.timestamp || numRefs > 0) {\n        collection[id as IdT] = toBeReleased\n          ? { ...envelope, numRefs }\n          : envelope;\n      } else if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        // eslint-disable-next-line no-console\n        console.log(\n          `useAsyncCollection(): Garbage collected at the path \"${\n            path}\", ID = ${id}`,\n        );\n      }\n    }\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction normalizeIds<IdT extends number | string>(\n  idOrIds: IdT | IdT[],\n): IdT[] {\n  if (Array.isArray(idOrIds)) {\n    const res = [...idOrIds];\n    res.sort();\n    return res;\n  }\n  return [idOrIds];\n}\n\n/**\n * Inits/updates, and returns the heap.\n */\nfunction useHeap<\n  DataT,\n  IdT extends number | string,\n>(\n  ids: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  gs: GlobalState<unknown>,\n): HeapT<DataT, IdT> {\n  const ref = useRef<HeapT<DataT, IdT>>();\n\n  let heap = ref.current;\n\n  if (heap) {\n    // Update.\n    heap.ids = ids;\n    heap.path = path;\n    heap.loader = loader;\n    heap.globalState = gs;\n  } else {\n    // Initialization.\n    const reload = async (\n      customLoader?: AsyncCollectionLoaderT<DataT, IdT>,\n    ) => {\n      const heap2 = ref.current!;\n\n      const localLoader = customLoader || heap2.loader;\n      if (!localLoader || !heap2.globalState || !heap2.ids) {\n        throw Error('Internal error');\n      }\n\n      for (let i = 0; i < heap2.ids.length; ++i) {\n        const id = heap2.ids[i]!;\n        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;\n\n        // eslint-disable-next-line no-await-in-loop\n        await load(\n          itemPath,\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap2.globalState,\n        );\n      }\n    };\n    heap = {\n      globalState: gs,\n      ids,\n      path,\n      loader,\n      reload,\n      reloadSingle: (customLoader) => ref.current!.reload(\n        customLoader && ((id, ...args) => customLoader(...args)),\n      ),\n    };\n    ref.current = heap;\n  }\n\n  return heap;\n}\n\n/**\n * Resolves and stores at the given `path` of the global state elements of\n * an asynchronous data collection.\n */\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT,\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT,\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\n// TODO: This is largely similar to useAsyncData() logic, just more generic.\n// Perhaps, a bunch of logic blocks can be split into stand-alone functions,\n// and reused in both hooks.\nfunction useAsyncCollection<\n  DataT,\n  IdT extends number | string,\n>(\n  idOrIds: IdT | IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT> {\n  const ids = normalizeIds(idOrIds);\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  const globalState = getGlobalState();\n\n  const heap = useHeap(ids, path, loader, globalState);\n\n  // Server-side logic.\n  if (globalState.ssrContext && !options.noSSR) {\n    const operationId: OperationIdT = `S${uuid()}`;\n    for (let i = 0; i < ids.length; ++i) {\n      const id = ids[i]!;\n      const itemPath = path ? `${path}.${id}` : `${id}`;\n      const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(itemPath, {\n        initialValue: newAsyncDataEnvelope<DataT>(),\n      });\n      if (!state.timestamp && !state.operationId) {\n        globalState.ssrContext.pending.push(\n          load(itemPath, (...args) => loader(id, ...args), globalState, {\n            data: state.data,\n            timestamp: state.timestamp,\n          }, operationId),\n        );\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    // Reference-counting & garbage collection.\n\n    const idsHash = hash(ids);\n\n    // TODO: Violation of rules of hooks is fine here,\n    // but perhaps it can be refactored to avoid the need for it.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      gcOnWithhold(ids, path, globalState);\n      return () => gcOnRelease(ids, path, globalState, garbageCollectAge);\n\n      // `ids` are represented in the dependencies array by `idsHash` value,\n      // as useEffect() hook requires a constant size of dependencies array.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n      garbageCollectAge,\n      globalState,\n      idsHash,\n      path,\n    ]);\n\n    // NOTE: a bunch of Rules of Hooks ignored belows because in our very\n    // special case the otherwise wrong behavior is actually what we need.\n\n    // Data loading and refreshing.\n    const loadTriggeredForIds = new Set<IdT>();\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      (async () => {\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i]!;\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>>(itemPath);\n\n          const { deps } = options;\n          if (\n            (deps && globalState.hasChangedDependencies(itemPath, deps))\n            || (\n              refreshAge < Date.now() - state2.timestamp\n              && (!state2.operationId || state2.operationId.charAt(0) === 'S')\n            )\n          ) {\n            if (!deps) globalState.dropDependencies(itemPath);\n            loadTriggeredForIds.add(id);\n            // eslint-disable-next-line no-await-in-loop\n            await load(itemPath, (...args) => loader(id, ...args), globalState, {\n              data: state2.data,\n              timestamp: state2.timestamp,\n            });\n          }\n        }\n      })();\n    });\n\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      (async () => {\n        const { deps } = options;\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i]!;\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n          if (\n            deps\n            && globalState.hasChangedDependencies(itemPath || '', deps)\n            && !loadTriggeredForIds.has(id)\n          ) {\n            // eslint-disable-next-line no-await-in-loop\n            await load(\n              itemPath,\n              (oldData: null | DataT, meta) => loader(id, oldData, meta),\n              globalState,\n            );\n          }\n        }\n      })();\n\n    // Here we need to default to empty array, so that this hook is re-evaluated\n    // only when dependencies specified in options change, and it should not be\n    // re-evaluated at all if no `deps` option is used.\n    }, options.deps || []); // eslint-disable-line react-hooks/exhaustive-deps\n  }\n\n  const [localState] = useGlobalState<\n  ForceT, { [id: string]: AsyncDataEnvelopeT<DataT> }\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    const e = localState[idOrIds];\n    const timestamp = e?.timestamp ?? 0;\n    return {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading: !!e?.operationId,\n      reload: heap.reloadSingle!,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: heap.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (let i = 0; i < ids.length; ++i) {\n    const id = ids[i]!;\n    const e = localState[id];\n    const loading = !!e?.operationId;\n    const timestamp = e?.timestamp ?? 0;\n\n    res.items[id] = {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading,\n      timestamp,\n    };\n    res.loading ||= loading;\n    if (res.timestamp > timestamp) res.timestamp = timestamp;\n  }\n\n  return res;\n}\n\nexport default useAsyncCollection;\n\nexport interface UseAsyncCollectionI<StateT> {\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT,\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT,\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT[],\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataT, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/module/utils.js

@@ -47,6 +47,7 @@ const cloneDeepBailKeys = new Set();
 export function cloneDeepForLog(value) {
   let key = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
   if (cloneDeepBailKeys.has(key)) {
+    // eslint-disable-next-line no-console
     console.warn(`The logged value won't be clonned (key "${key}").`);
     return value;
   }
@@ -54,9 +55,30 @@ export function cloneDeepForLog(value) {
   const res = cloneDeep(value);
   const time = Date.now() - start;
   if (time > 300) {
+    // eslint-disable-next-line no-console
     console.warn(`${time}ms spent to clone the logged value (key "${key}").`);
     cloneDeepBailKeys.add(key);
   }
   return res;
 }
+
+/**
+ * Converts given value to an escaped string. For now, we are good with the most
+ * trivial escape logic:
+ *  - '%' characters are replaced by '%0' code pair;
+ *  - '/' characters are replaced by '%1' code pair.
+ */
+export function escape(x) {
+  return typeof x === 'string' ? x.replace(/%/g, '%0').replace(/\//g, '%1') : x.toString();
+}
+
+/**
+ * Hashes given string array. For our current needs we are fine to go with
+ * the most trivial implementation, which probably should not be called "hash"
+ * in the strict sense: we just escape each given string to not include '/'
+ * characters, and then we join all those strings using '/' as the separator.
+ */
+export function hash(items) {
+  return items.map(escape).join('/');
+}
 //# sourceMappingURL=utils.js.map

package/build/module/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["cloneDeep","isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","error","cloneDeepBailKeys","Set","cloneDeepForLog","value","key","arguments","length","undefined","has","console","warn","start","Date","now","res","time","add"],"sources":["../../src/utils.ts"],"sourcesContent":["import { type GetFieldType, cloneDeep } from 'lodash';\n\nexport type CallbackT = () => void;\n\n// TODO: This (ForceT, LockT, and TypeLock) probably should be moved to JS Utils\n// lib.\n\ndeclare const force: unique symbol;\ndeclare const lock: unique symbol;\n\nexport type ForceT = typeof force;\nexport type LockT = typeof lock;\n\nexport type TypeLock<\n  Unlocked extends ForceT | LockT,\n  LockedT extends never | void,\n  UnlockedT,\n> = Unlocked extends ForceT ? UnlockedT : LockedT;\n\n/**\n * Given the type of state, `StateT`, and the type of state path, `PathT`,\n * it evaluates the type of value at that path of the state, if it can be\n * evaluated from the path type (it is possible when `PathT` is a string\n * literal type, and `StateT` elements along this path have appropriate\n * types); otherwise it falls back to the specified `UnknownT` type,\n * which should be set either `never` (for input arguments), or `void`\n * (for return types) - `never` and `void` in those places forbid assignments,\n * and are not auto-inferred to more permissible types.\n *\n * BEWARE: When StateT is any the construct resolves to any for any string\n * paths.\n */\nexport type ValueAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n  UnknownT extends never | undefined | void,\n> = unknown extends StateT\n  ? UnknownT\n  : string extends PathT\n    ? UnknownT\n    : PathT extends null | undefined\n      ? StateT\n      : GetFieldType<StateT, PathT> extends undefined\n        ? UnknownT : GetFieldType<StateT, PathT>;\n\nexport type ValueOrInitializerT<ValueT> = ValueT | (() => ValueT);\n\n/**\n * Returns 'true' if debug logging should be performed; 'false' otherwise.\n *\n * BEWARE: The actual safeguards for the debug logging still should read\n *  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n *    // Some debug logging\n *  }\n * to ensure that debug code is stripped out by Webpack in production mode.\n *\n * @returns\n * @ignore\n */\nexport function isDebugMode(): boolean {\n  try {\n    return process.env.NODE_ENV !== 'production'\n      && !!process.env.REACT_GLOBAL_STATE_DEBUG;\n  } catch (error) {\n    return false;\n  }\n}\n\nconst cloneDeepBailKeys = new Set<string>();\n\n/**\n * Deep-clones given value for logging purposes, or returns the value itself\n * if the previous clone attempt, with the same key, took more than 300ms\n * (to avoid situations when large payload in the global state slows down\n * development versions of the app due to the logging overhead).\n */\nexport function cloneDeepForLog<T>(value: T, key: string = ''): T {\n  if (cloneDeepBailKeys.has(key)) {\n    console.warn(`The logged value won't be clonned (key \"${key}\").`);\n    return value;\n  }\n\n  const start = Date.now();\n  const res = cloneDeep(value);\n  const time = Date.now() - start;\n  if (time > 300) {\n    console.warn(`${time}ms spent to clone the logged value (key \"${key}\").`);\n    cloneDeepBailKeys.add(key);\n  }\n\n  return res;\n}\n"],"mappings":"AAAA,SAA4BA,SAAS,QAAQ,QAAQ;;AAIrD;AACA;;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAY;EACrC,IAAI;IACF,OAAOC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IACvC,CAAC,CAACF,OAAO,CAACC,GAAG,CAACE,wBAAwB;EAC7C,CAAC,CAAC,OAAOC,KAAK,EAAE;IACd,OAAO,KAAK;EACd;AACF;AAEA,MAAMC,iBAAiB,GAAG,IAAIC,GAAG,CAAS,CAAC;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAIC,KAAQ,EAAuB;EAAA,IAArBC,GAAW,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,EAAE;EAC3D,IAAIL,iBAAiB,CAACQ,GAAG,CAACJ,GAAG,CAAC,EAAE;IAC9BK,OAAO,CAACC,IAAI,CAAC,2CAA2CN,GAAG,KAAK,CAAC;IACjE,OAAOD,KAAK;EACd;EAEA,MAAMQ,KAAK,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;EACxB,MAAMC,GAAG,GAAGrB,SAAS,CAACU,KAAK,CAAC;EAC5B,MAAMY,IAAI,GAAGH,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,KAAK;EAC/B,IAAII,IAAI,GAAG,GAAG,EAAE;IACdN,OAAO,CAACC,IAAI,CAAC,GAAGK,IAAI,4CAA4CX,GAAG,KAAK,CAAC;IACzEJ,iBAAiB,CAACgB,GAAG,CAACZ,GAAG,CAAC;EAC5B;EAEA,OAAOU,GAAG;AACZ","ignoreList":[]}
+{"version":3,"file":"utils.js","names":["cloneDeep","isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","error","cloneDeepBailKeys","Set","cloneDeepForLog","value","key","arguments","length","undefined","has","console","warn","start","Date","now","res","time","add","escape","x","replace","toString","hash","items","map","join"],"sources":["../../src/utils.ts"],"sourcesContent":["import { type GetFieldType, cloneDeep } from 'lodash';\n\nexport type CallbackT = () => void;\n\n// TODO: This (ForceT, LockT, and TypeLock) probably should be moved to JS Utils\n// lib.\n\ndeclare const force: unique symbol;\ndeclare const lock: unique symbol;\n\nexport type ForceT = typeof force;\nexport type LockT = typeof lock;\n\nexport type TypeLock<\n  Unlocked extends ForceT | LockT,\n  LockedT extends never | void,\n  UnlockedT,\n> = Unlocked extends ForceT ? UnlockedT : LockedT;\n\n/**\n * Given the type of state, `StateT`, and the type of state path, `PathT`,\n * it evaluates the type of value at that path of the state, if it can be\n * evaluated from the path type (it is possible when `PathT` is a string\n * literal type, and `StateT` elements along this path have appropriate\n * types); otherwise it falls back to the specified `UnknownT` type,\n * which should be set either `never` (for input arguments), or `void`\n * (for return types) - `never` and `void` in those places forbid assignments,\n * and are not auto-inferred to more permissible types.\n *\n * BEWARE: When StateT is any the construct resolves to any for any string\n * paths.\n */\nexport type ValueAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n  UnknownT extends never | undefined | void,\n> = unknown extends StateT\n  ? UnknownT\n  : string extends PathT\n    ? UnknownT\n    : PathT extends null | undefined\n      ? StateT\n      : GetFieldType<StateT, PathT> extends undefined\n        ? UnknownT : GetFieldType<StateT, PathT>;\n\nexport type ValueOrInitializerT<ValueT> = ValueT | (() => ValueT);\n\n/**\n * Returns 'true' if debug logging should be performed; 'false' otherwise.\n *\n * BEWARE: The actual safeguards for the debug logging still should read\n *  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n *    // Some debug logging\n *  }\n * to ensure that debug code is stripped out by Webpack in production mode.\n *\n * @returns\n * @ignore\n */\nexport function isDebugMode(): boolean {\n  try {\n    return process.env.NODE_ENV !== 'production'\n      && !!process.env.REACT_GLOBAL_STATE_DEBUG;\n  } catch (error) {\n    return false;\n  }\n}\n\nconst cloneDeepBailKeys = new Set<string>();\n\n/**\n * Deep-clones given value for logging purposes, or returns the value itself\n * if the previous clone attempt, with the same key, took more than 300ms\n * (to avoid situations when large payload in the global state slows down\n * development versions of the app due to the logging overhead).\n */\nexport function cloneDeepForLog<T>(value: T, key: string = ''): T {\n  if (cloneDeepBailKeys.has(key)) {\n    // eslint-disable-next-line no-console\n    console.warn(`The logged value won't be clonned (key \"${key}\").`);\n    return value;\n  }\n\n  const start = Date.now();\n  const res = cloneDeep(value);\n  const time = Date.now() - start;\n  if (time > 300) {\n    // eslint-disable-next-line no-console\n    console.warn(`${time}ms spent to clone the logged value (key \"${key}\").`);\n    cloneDeepBailKeys.add(key);\n  }\n\n  return res;\n}\n\n/**\n * Converts given value to an escaped string. For now, we are good with the most\n * trivial escape logic:\n *  - '%' characters are replaced by '%0' code pair;\n *  - '/' characters are replaced by '%1' code pair.\n */\nexport function escape(x: number | string): string {\n  return typeof x === 'string'\n    ? x.replace(/%/g, '%0').replace(/\\//g, '%1')\n    : x.toString();\n}\n\n/**\n * Hashes given string array. For our current needs we are fine to go with\n * the most trivial implementation, which probably should not be called \"hash\"\n * in the strict sense: we just escape each given string to not include '/'\n * characters, and then we join all those strings using '/' as the separator.\n */\nexport function hash(items: Array<number | string>): string {\n  return items.map(escape).join('/');\n}\n"],"mappings":"AAAA,SAA4BA,SAAS,QAAQ,QAAQ;;AAIrD;AACA;;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAAA,EAAY;EACrC,IAAI;IACF,OAAOC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IACvC,CAAC,CAACF,OAAO,CAACC,GAAG,CAACE,wBAAwB;EAC7C,CAAC,CAAC,OAAOC,KAAK,EAAE;IACd,OAAO,KAAK;EACd;AACF;AAEA,MAAMC,iBAAiB,GAAG,IAAIC,GAAG,CAAS,CAAC;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAIC,KAAQ,EAAuB;EAAA,IAArBC,GAAW,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,EAAE;EAC3D,IAAIL,iBAAiB,CAACQ,GAAG,CAACJ,GAAG,CAAC,EAAE;IAC9B;IACAK,OAAO,CAACC,IAAI,CAAC,2CAA2CN,GAAG,KAAK,CAAC;IACjE,OAAOD,KAAK;EACd;EAEA,MAAMQ,KAAK,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;EACxB,MAAMC,GAAG,GAAGrB,SAAS,CAACU,KAAK,CAAC;EAC5B,MAAMY,IAAI,GAAGH,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,KAAK;EAC/B,IAAII,IAAI,GAAG,GAAG,EAAE;IACd;IACAN,OAAO,CAACC,IAAI,CAAC,GAAGK,IAAI,4CAA4CX,GAAG,KAAK,CAAC;IACzEJ,iBAAiB,CAACgB,GAAG,CAACZ,GAAG,CAAC;EAC5B;EAEA,OAAOU,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,MAAMA,CAACC,CAAkB,EAAU;EACjD,OAAO,OAAOA,CAAC,KAAK,QAAQ,GACxBA,CAAC,CAACC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAACA,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAC1CD,CAAC,CAACE,QAAQ,CAAC,CAAC;AAClB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAACC,KAA6B,EAAU;EAC1D,OAAOA,KAAK,CAACC,GAAG,CAACN,MAAM,CAAC,CAACO,IAAI,CAAC,GAAG,CAAC;AACpC","ignoreList":[]}

package/build/types/index.d.ts

@@ -2,12 +2,12 @@ import GlobalState from './GlobalState';
 import GlobalStateProvider, { getGlobalState, getSsrContext } from './GlobalStateProvider';
 import SsrContext from './SsrContext';
 import useAsyncCollection, { type UseAsyncCollectionI, type UseAsyncCollectionResT } from './useAsyncCollection';
-import { type AsyncDataEnvelopeT, type AsyncDataLoaderT, type AsyncDataReloaderT, type UseAsyncDataI, type UseAsyncDataResT, newAsyncDataEnvelope, useAsyncData } from './useAsyncData';
+import { type AsyncDataEnvelopeT, type AsyncDataLoaderT, type AsyncDataReloaderT, type UseAsyncDataI, type UseAsyncDataOptionsT, type UseAsyncDataResT, newAsyncDataEnvelope, useAsyncData } from './useAsyncData';
 import useGlobalState, { type UseGlobalStateI } from './useGlobalState';
-export type { AsyncCollectionLoaderT } from './useAsyncCollection';
+export type { AsyncCollectionLoaderT, AsyncCollectionT } from './useAsyncCollection';
 export type { SetterT, UseGlobalStateResT } from './useGlobalState';
 export type { ForceT, ValueOrInitializerT } from './utils';
-export { type AsyncDataEnvelopeT, type AsyncDataLoaderT, type AsyncDataReloaderT, type UseAsyncCollectionResT, type UseAsyncDataResT, getGlobalState, getSsrContext, GlobalState, GlobalStateProvider, newAsyncDataEnvelope, SsrContext, useAsyncCollection, useAsyncData, useGlobalState, };
+export { type AsyncDataEnvelopeT, type AsyncDataLoaderT, type AsyncDataReloaderT, type UseAsyncCollectionResT, type UseAsyncDataOptionsT, type UseAsyncDataResT, getGlobalState, getSsrContext, GlobalState, GlobalStateProvider, newAsyncDataEnvelope, SsrContext, useAsyncCollection, useAsyncData, useGlobalState, };
 interface API<StateT, SsrContextT extends SsrContext<StateT> = SsrContext<StateT>> {
     getGlobalState: typeof getGlobalState<StateT, SsrContextT>;
     getSsrContext: typeof getSsrContext<SsrContextT>;

package/build/types/useAsyncCollection.d.ts

@@ -1,8 +1,11 @@
 /**
  * Loads and uses item(s) in an async collection.
  */
-import { type DataInEnvelopeAtPathT, type UseAsyncDataOptionsT, type UseAsyncDataResT } from './useAsyncData';
+import { type AsyncDataEnvelopeT, type DataInEnvelopeAtPathT, type UseAsyncDataOptionsT, type UseAsyncDataResT } from './useAsyncData';
 import { type ForceT, type LockT, type TypeLock } from './utils';
+export type AsyncCollectionT<DataT = unknown, IdT extends number | string = number | string> = {
+    [id in IdT]?: AsyncDataEnvelopeT<DataT>;
+};
 export type AsyncCollectionLoaderT<DataT, IdT extends number | string = number | string> = (id: IdT, oldData: null | DataT, meta: {
     isAborted: () => boolean;
     oldDataTimestamp: number;

package/build/types/utils.d.ts

@@ -40,4 +40,18 @@ export declare function isDebugMode(): boolean;
  * development versions of the app due to the logging overhead).
  */
 export declare function cloneDeepForLog<T>(value: T, key?: string): T;
+/**
+ * Converts given value to an escaped string. For now, we are good with the most
+ * trivial escape logic:
+ *  - '%' characters are replaced by '%0' code pair;
+ *  - '/' characters are replaced by '%1' code pair.
+ */
+export declare function escape(x: number | string): string;
+/**
+ * Hashes given string array. For our current needs we are fine to go with
+ * the most trivial implementation, which probably should not be called "hash"
+ * in the strict sense: we just escape each given string to not include '/'
+ * characters, and then we join all those strings using '/' as the separator.
+ */
+export declare function hash(items: Array<number | string>): string;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dr.pogodin/react-global-state",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Hook-based global state for React",
   "main": "./build/common/index.js",
   "react-native": "src/index.ts",
@@ -74,7 +74,7 @@
     "eslint-config-airbnb-typescript": "^18.0.0",
     "eslint-import-resolver-babel-module": "^5.3.2",
     "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-jest": "^28.6.0",
+    "eslint-plugin-jest": "^28.8.0",
     "eslint-plugin-jsx-a11y": "^6.9.0",
     "eslint-plugin-react": "^7.35.0",
     "eslint-plugin-react-hooks": "^4.6.2",
@@ -84,7 +84,7 @@
     "rimraf": "^6.0.1",
     "tstyche": "^2.1.1",
     "typescript": "^5.5.4",
-    "typescript-eslint": "^8.0.0"
+    "typescript-eslint": "^8.0.1"
   },
   "peerDependencies": {
     "react": "^18.3.1",

package/src/index.ts

@@ -17,6 +17,7 @@ import {
   type AsyncDataLoaderT,
   type AsyncDataReloaderT,
   type UseAsyncDataI,
+  type UseAsyncDataOptionsT,
   type UseAsyncDataResT,
   newAsyncDataEnvelope,
   useAsyncData,
@@ -24,7 +25,7 @@ import {
 
 import useGlobalState, { type UseGlobalStateI } from './useGlobalState';
 
-export type { AsyncCollectionLoaderT } from './useAsyncCollection';
+export type { AsyncCollectionLoaderT, AsyncCollectionT } from './useAsyncCollection';
 
 export type { SetterT, UseGlobalStateResT } from './useGlobalState';
 
@@ -35,6 +36,7 @@ export {
   type AsyncDataLoaderT,
   type AsyncDataReloaderT,
   type UseAsyncCollectionResT,
+  type UseAsyncDataOptionsT,
   type UseAsyncDataResT,
   getGlobalState,
   getSsrContext,