@dr.pogodin/react-global-state 0.19.2 → 0.19.3

package/build/cjs/useAsyncCollection.js

@@ -79,7 +79,10 @@ function gcOnRelease(ids, path, gs, gcAge) {
 }
 function normalizeIds(idOrIds) {
   if (Array.isArray(idOrIds)) {
-    const res = [...idOrIds];
+    // Removes ID duplicates.
+    const res = Array.from(new Set(idOrIds));
+
+    // Ensures stable ID order.
     res.sort((a, b) => a.toString().localeCompare(b.toString()));
     return res;
   }
@@ -166,26 +169,32 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
   const heap = useHeap(ids, path, loader, globalState);
 
   // Server-side logic.
-  if (globalState.ssrContext && !options.noSSR) {
-    const operationId = `S${(0, _uuid.v4)()}`;
-    for (const id of ids) {
-      const itemPath = path ? `${path}.${id}` : `${id}`;
-      const state = globalState.get(itemPath, {
-        initialValue: (0, _useAsyncData.newAsyncDataEnvelope)()
-      });
-      if (!state.timestamp && !state.operationId) {
-        const promiseOrVoid = (0, _useAsyncData.load)(itemPath, (...args) => loader(id, ...args), globalState, {
-          data: state.data,
-          timestamp: state.timestamp
-        }, operationId);
-        if (promiseOrVoid instanceof Promise) {
-          globalState.ssrContext.pending.push(promiseOrVoid);
+  if (globalState.ssrContext) {
+    if (!options.disabled && !options.noSSR) {
+      const operationId = `S${(0, _uuid.v4)()}`;
+      for (const id of ids) {
+        const itemPath = path ? `${path}.${id}` : `${id}`;
+        const state = globalState.get(itemPath, {
+          initialValue: (0, _useAsyncData.newAsyncDataEnvelope)()
+        });
+        if (!state.timestamp && !state.operationId) {
+          const promiseOrVoid = (0, _useAsyncData.load)(itemPath, (...args) => loader(id, ...args), globalState, {
+            data: state.data,
+            timestamp: state.timestamp
+          }, operationId);
+          if (promiseOrVoid instanceof Promise) {
+            globalState.ssrContext.pending.push(promiseOrVoid);
+          }
         }
       }
     }
 
     // Client-side logic.
   } else {
+    const {
+      disabled
+    } = options;
+
     // Reference-counting & garbage collection.
 
     const idsHash = (0, _utils.hash)(ids);
@@ -194,15 +203,15 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     // but perhaps it can be refactored to avoid the need for it.
     (0, _react.useEffect)(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
-      gcOnWithhold(ids, path, globalState);
+      if (!disabled) gcOnWithhold(ids, path, globalState);
       return () => {
-        gcOnRelease(ids, path, globalState, garbageCollectAge);
+        if (!disabled) 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, idsHash, path]);
+    }, [disabled, 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.
@@ -210,27 +219,29 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     // Data loading and refreshing.
     (0, _react.useEffect)(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
-      void (async () => {
-        for (const id of ids) {
-          const itemPath = path ? `${path}.${id}` : `${id}`;
-          const state2 = globalState.get(itemPath);
-          const {
-            deps
-          } = options;
-          if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - (state2?.timestamp ?? 0) && (!state2?.operationId || state2.operationId.startsWith('S'))) {
-            if (!deps) globalState.dropDependencies(itemPath);
-            await (0, _useAsyncData.load)(itemPath,
-            // TODO: I guess, the loader is not correctly typed here -
-            // it can be synchronous, and in that case the following method
-            // should be kept synchronous to not alter the sync logic.
-            // eslint-disable-next-line @typescript-eslint/promise-function-async
-            (old, ...args) => loader(id, old, ...args), globalState, {
-              data: state2?.data,
-              timestamp: state2?.timestamp ?? 0
-            });
+      if (!disabled) {
+        void (async () => {
+          for (const id of ids) {
+            const itemPath = path ? `${path}.${id}` : `${id}`;
+            const state2 = globalState.get(itemPath);
+            const {
+              deps
+            } = options;
+            if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - (state2?.timestamp ?? 0) && (!state2?.operationId || state2.operationId.startsWith('S'))) {
+              if (!deps) globalState.dropDependencies(itemPath);
+              await (0, _useAsyncData.load)(itemPath,
+              // TODO: I guess, the loader is not correctly typed here -
+              // it can be synchronous, and in that case the following method
+              // should be kept synchronous to not alter the sync logic.
+              // eslint-disable-next-line @typescript-eslint/promise-function-async
+              (old, ...args) => loader(id, old, ...args), globalState, {
+                data: state2?.data,
+                timestamp: state2?.timestamp ?? 0
+              });
+            }
           }
-        }
-      })();
+        })();
+      }
     });
   }
   const [localState] = (0, _useGlobalState.default)(path, {});

package/build/cjs/useAsyncCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncCollection.js","names":["_react","require","_uuid","_GlobalStateProvider","_useAsyncData","_useGlobalState","_interopRequireDefault","_utils","gcOnWithhold","ids","path","gs","collection","get","id","envelope","numRefs","newAsyncDataEnvelope","set","idsToStringSet","res","Set","add","toString","gcOnRelease","gcAge","entries","Object","now","Date","idSet","toBeReleased","has","timestamp","process","env","NODE_ENV","isDebugMode","console","log","normalizeIds","idOrIds","Array","isArray","sort","a","b","localeCompare","useHeap","loader","ref","useRef","undefined","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","promiseOrVoid","load","oldData","meta","Promise","reloadSingle","args","useAsyncCollection","options","maxage","DEFAULT_MAXAGE","refreshAge","garbageCollectAge","getGlobalState","ssrContext","noSSR","operationId","uuid","state","initialValue","data","pending","push","idsHash","hash","useEffect","state2","deps","hasChangedDependencies","startsWith","dropDependencies","old","localState","useGlobalState","e","loading","items","Number","MAX_VALUE","_default","exports","default"],"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 type 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> = Record<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    setAbortCallback: (cb: () => void) => void;\n  }) => (DataT | null) | Promise<DataT | null>;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | 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: Record<IdT, CollectionItemT<DataT>>;\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 (const id of ids) {\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 (const id of ids) {\n    res.add(id.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 (const [id, envelope] of entries) {\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((a, b) => a.toString().localeCompare(b.toString()));\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>>(undefined);\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      // TODO: Revise - not sure all related typing is 100% correct,\n      // thus let's keep this runtime assertion.\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!localLoader || !heap2.globalState || !heap2.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of heap2.ids) {\n        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;\n\n        const promiseOrVoid = load(\n          itemPath,\n          // TODO: Revise! Most probably we don't have fully correct loader\n          // typing, as it may return either promise or value, and those two\n          // cases call for different runtime behavior, which in turns only\n          // happens if the outer function on the next line matches the same\n          // async / sync signature.\n          // eslint-disable-next-line @typescript-eslint/promise-function-async\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap2.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n    heap = {\n      globalState: gs,\n      ids,\n      loader,\n      path,\n      reload,\n      // TODO: Revise! Most probably we don't have fully correct loader\n      // typing, as it may return either promise or value, and those two\n      // cases call for different runtime behavior, which in turns only\n      // happens if the outer function on the next line matches the same\n      // async / sync signature.\n      // eslint-disable-next-line @typescript-eslint/promise-function-async\n      reloadSingle: (customLoader) => ref.current!.reload(\n        // TODO: Revise! Most probably we don't have fully correct loader\n        // typing, as it may return either promise or value, and those two\n        // cases call for different runtime behavior, which in turns only\n        // happens if the outer function on the next line matches the same\n        // async / sync signature.\n        // eslint-disable-next-line @typescript-eslint/promise-function-async\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}`> = 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}`> = 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\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT | IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT> | 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.\n// eslint-disable-next-line complexity\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 (const id of ids) {\n      const itemPath = path ? `${path}.${id}` : `${id}`;\n      const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n        itemPath,\n        {\n          initialValue: newAsyncDataEnvelope<DataT>(),\n        },\n      );\n      if (!state.timestamp && !state.operationId) {\n        const promiseOrVoid = load(\n          itemPath,\n          (...args):\n            DataT | null | Promise<DataT | null> => loader(id, ...args),\n          globalState,\n          {\n            data: state.data,\n            timestamp: state.timestamp,\n          },\n          operationId,\n        );\n\n        if (promiseOrVoid instanceof Promise) {\n          globalState.ssrContext.pending.push(promiseOrVoid);\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 () => {\n        gcOnRelease(ids, path, globalState, garbageCollectAge);\n      };\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      void (async () => {\n        for (const id of ids) {\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n\n          type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n          const state2: EnvT = globalState.get<ForceT, EnvT>(itemPath);\n\n          const { deps } = options;\n          if (\n            (deps && globalState.hasChangedDependencies(itemPath, deps))\n            || (\n              refreshAge < Date.now() - (state2?.timestamp ?? 0)\n              && (!state2?.operationId || state2.operationId.startsWith('S'))\n            )\n          ) {\n            if (!deps) globalState.dropDependencies(itemPath);\n            await load(\n              itemPath,\n              // TODO: I guess, the loader is not correctly typed here -\n              // it can be synchronous, and in that case the following method\n              // should be kept synchronous to not alter the sync logic.\n              // eslint-disable-next-line @typescript-eslint/promise-function-async\n              (old, ...args) => loader(id, old as DataT, ...args),\n              globalState,\n              {\n                data: state2?.data,\n                timestamp: state2?.timestamp ?? 0,\n              },\n            );\n          }\n        }\n      })();\n    });\n  }\n\n  const [localState] = useGlobalState<\n    ForceT, Record<string, AsyncDataEnvelopeT<DataT>>\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    // TODO: Revise related typings!\n    const e = localState[idOrIds as string];\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 (const id of ids) {\n    // TODO: Revise related typing. Should `localState` have a more specific type?\n    const e = localState[id as string];\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\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\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  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT | IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>\n    | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useAsyncCollection.js","names":["_react","require","_uuid","_GlobalStateProvider","_useAsyncData","_useGlobalState","_interopRequireDefault","_utils","gcOnWithhold","ids","path","gs","collection","get","id","envelope","numRefs","newAsyncDataEnvelope","set","idsToStringSet","res","Set","add","toString","gcOnRelease","gcAge","entries","Object","now","Date","idSet","toBeReleased","has","timestamp","process","env","NODE_ENV","isDebugMode","console","log","normalizeIds","idOrIds","Array","isArray","from","sort","a","b","localeCompare","useHeap","loader","ref","useRef","undefined","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","promiseOrVoid","load","oldData","meta","Promise","reloadSingle","args","useAsyncCollection","options","maxage","DEFAULT_MAXAGE","refreshAge","garbageCollectAge","getGlobalState","ssrContext","disabled","noSSR","operationId","uuid","state","initialValue","data","pending","push","idsHash","hash","useEffect","state2","deps","hasChangedDependencies","startsWith","dropDependencies","old","localState","useGlobalState","e","loading","items","Number","MAX_VALUE","_default","exports","default"],"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 type 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> = Record<IdT, AsyncDataEnvelopeT<DataT>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | 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: Record<IdT, CollectionItemT<DataT>>;\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 (const id of ids) {\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 (const id of ids) {\n    res.add(id.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 (const [id, envelope] of entries) {\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    // Removes ID duplicates.\n    const res = Array.from(new Set(idOrIds));\n\n    // Ensures stable ID order.\n    res.sort((a, b) => a.toString().localeCompare(b.toString()));\n\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>>(undefined);\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      // TODO: Revise - not sure all related typing is 100% correct,\n      // thus let's keep this runtime assertion.\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!localLoader || !heap2.globalState || !heap2.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of heap2.ids) {\n        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;\n\n        const promiseOrVoid = load(\n          itemPath,\n          // TODO: Revise! Most probably we don't have fully correct loader\n          // typing, as it may return either promise or value, and those two\n          // cases call for different runtime behavior, which in turns only\n          // happens if the outer function on the next line matches the same\n          // async / sync signature.\n          // eslint-disable-next-line @typescript-eslint/promise-function-async\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap2.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n    heap = {\n      globalState: gs,\n      ids,\n      loader,\n      path,\n      reload,\n      // TODO: Revise! Most probably we don't have fully correct loader\n      // typing, as it may return either promise or value, and those two\n      // cases call for different runtime behavior, which in turns only\n      // happens if the outer function on the next line matches the same\n      // async / sync signature.\n      // eslint-disable-next-line @typescript-eslint/promise-function-async\n      reloadSingle: (customLoader) => ref.current!.reload(\n        // TODO: Revise! Most probably we don't have fully correct loader\n        // typing, as it may return either promise or value, and those two\n        // cases call for different runtime behavior, which in turns only\n        // happens if the outer function on the next line matches the same\n        // async / sync signature.\n        // eslint-disable-next-line @typescript-eslint/promise-function-async\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}`> = 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}`> = 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\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT | IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT> | 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.\n// eslint-disable-next-line complexity\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) {\n    if (!options.disabled && !options.noSSR) {\n      const operationId: OperationIdT = `S${uuid()}`;\n      for (const id of ids) {\n        const itemPath = path ? `${path}.${id}` : `${id}`;\n        const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n          itemPath,\n          {\n            initialValue: newAsyncDataEnvelope<DataT>(),\n          },\n        );\n        if (!state.timestamp && !state.operationId) {\n          const promiseOrVoid = load(\n            itemPath,\n            (...args):\n              DataT | null | Promise<DataT | null> => loader(id, ...args),\n            globalState,\n            {\n              data: state.data,\n              timestamp: state.timestamp,\n            },\n            operationId,\n          );\n\n          if (promiseOrVoid instanceof Promise) {\n            globalState.ssrContext.pending.push(promiseOrVoid);\n          }\n        }\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    const { disabled } = options;\n\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      if (!disabled) gcOnWithhold(ids, path, globalState);\n      return () => {\n        if (!disabled) gcOnRelease(ids, path, globalState, garbageCollectAge);\n      };\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      disabled,\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) {\n        void (async () => {\n          for (const id of ids) {\n            const itemPath = path ? `${path}.${id}` : `${id}`;\n\n            type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n            const state2: EnvT = globalState.get<ForceT, EnvT>(itemPath);\n\n            const { deps } = options;\n            if (\n              (deps && globalState.hasChangedDependencies(itemPath, deps))\n              || (\n                refreshAge < Date.now() - (state2?.timestamp ?? 0)\n                && (!state2?.operationId || state2.operationId.startsWith('S'))\n              )\n            ) {\n              if (!deps) globalState.dropDependencies(itemPath);\n              await load(\n                itemPath,\n                // TODO: I guess, the loader is not correctly typed here -\n                // it can be synchronous, and in that case the following method\n                // should be kept synchronous to not alter the sync logic.\n                // eslint-disable-next-line @typescript-eslint/promise-function-async\n                (old, ...args) => loader(id, old as DataT, ...args),\n                globalState,\n                {\n                  data: state2?.data,\n                  timestamp: state2?.timestamp ?? 0,\n                },\n              );\n            }\n          }\n        })();\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<\n    ForceT, Record<string, AsyncDataEnvelopeT<DataT>>\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    // TODO: Revise related typings!\n    const e = localState[idOrIds as string];\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 (const id of ids) {\n    // TODO: Revise related typing. Should `localState` have a more specific type?\n    const e = localState[id as string];\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\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\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  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT | IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>\n    | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n}\n"],"mappings":";;;;;;;AAIA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,KAAA,GAAAD,OAAA;AAGA,IAAAE,oBAAA,GAAAF,OAAA;AAEA,IAAAG,aAAA,GAAAH,OAAA;AAYA,IAAAI,eAAA,GAAAC,sBAAA,CAAAL,OAAA;AAEA,IAAAM,MAAA,GAAAN,OAAA;AAxBA;AACA;AACA;;AA+EA;AACA;AACA;AACA;AACA;AACA;AACA,SAASO,YAAYA,CACnBC,GAAU,EACVC,IAA+B,EAC/BC,EAAwB,EACxB;EACA,MAAMC,UAAU,GAAG;IAAE,GAAGD,EAAE,CAACE,GAAG,CAA2BH,IAAI;EAAE,CAAC;EAEhE,KAAK,MAAMI,EAAE,IAAIL,GAAG,EAAE;IACpB,IAAIM,QAAQ,GAAGH,UAAU,CAACE,EAAE,CAAC;IAC7B,IAAIC,QAAQ,EAAEA,QAAQ,GAAG;MAAE,GAAGA,QAAQ;MAAEC,OAAO,EAAE,CAAC,GAAGD,QAAQ,CAACC;IAAQ,CAAC,CAAC,KACnED,QAAQ,GAAG,IAAAE,kCAAoB,EAAU,IAAI,EAAE;MAAED,OAAO,EAAE;IAAE,CAAC,CAAC;IACnEJ,UAAU,CAACE,EAAE,CAAC,GAAGC,QAAQ;EAC3B;EAEAJ,EAAE,CAACO,GAAG,CAA2BR,IAAI,EAAEE,UAAU,CAAC;AACpD;AAEA,SAASO,cAAcA,CAA8BV,GAAU,EAAe;EAC5E,MAAMW,GAAG,GAAG,IAAIC,GAAG,CAAS,CAAC;EAC7B,KAAK,MAAMP,EAAE,IAAIL,GAAG,EAAE;IACpBW,GAAG,CAACE,GAAG,CAACR,EAAE,CAACS,QAAQ,CAAC,CAAC,CAAC;EACxB;EACA,OAAOH,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASI,WAAWA,CAClBf,GAAU,EACVC,IAA+B,EAC/BC,EAAwB,EACxBc,KAAa,EACb;EAGA,MAAMC,OAAO,GAAGC,MAAM,CAACD,OAAO,CAC5Bf,EAAE,CAACE,GAAG,CAA2BH,IAAI,CACvC,CAAC;EAED,MAAMkB,GAAG,GAAGC,IAAI,CAACD,GAAG,CAAC,CAAC;EACtB,MAAME,KAAK,GAAGX,cAAc,CAACV,GAAG,CAAC;EACjC,MAAMG,UAA4B,GAAG,CAAC,CAAC;EACvC,KAAK,MAAM,CAACE,EAAE,EAAEC,QAAQ,CAAC,IAAIW,OAAO,EAAE;IACpC,IAAIX,QAAQ,EAAE;MACZ,MAAMgB,YAAY,GAAGD,KAAK,CAACE,GAAG,CAAClB,EAAE,CAAC;MAElC,IAAI;QAAEE;MAAQ,CAAC,GAAGD,QAAQ;MAC1B,IAAIgB,YAAY,EAAE,EAAEf,OAAO;MAE3B,IAAIS,KAAK,GAAGG,GAAG,GAAGb,QAAQ,CAACkB,SAAS,IAAIjB,OAAO,GAAG,CAAC,EAAE;QACnDJ,UAAU,CAACE,EAAE,CAAQ,GAAGiB,YAAY,GAChC;UAAE,GAAGhB,QAAQ;UAAEC;QAAQ,CAAC,GACxBD,QAAQ;MACd,CAAC,MAAM,IAAImB,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAI,IAAAC,kBAAW,EAAC,CAAC,EAAE;QACjE;QACAC,OAAO,CAACC,GAAG,CACT,wDACE7B,IAAI,WAAWI,EAAE,EACrB,CAAC;MACH;IACF;EACF;EAEAH,EAAE,CAACO,GAAG,CAA2BR,IAAI,EAAEE,UAAU,CAAC;AACpD;AAEA,SAAS4B,YAAYA,CACnBC,OAAoB,EACb;EACP,IAAIC,KAAK,CAACC,OAAO,CAACF,OAAO,CAAC,EAAE;IAC1B;IACA,MAAMrB,GAAG,GAAGsB,KAAK,CAACE,IAAI,CAAC,IAAIvB,GAAG,CAACoB,OAAO,CAAC,CAAC;;IAExC;IACArB,GAAG,CAACyB,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKD,CAAC,CAACvB,QAAQ,CAAC,CAAC,CAACyB,aAAa,CAACD,CAAC,CAACxB,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5D,OAAOH,GAAG;EACZ;EACA,OAAO,CAACqB,OAAO,CAAC;AAClB;;AAEA;AACA;AACA;AACA,SAASQ,OAAOA,CAIdxC,GAAU,EACVC,IAA+B,EAC/BwC,MAA0C,EAC1CvC,EAAwB,EACL;EACnB,MAAMwC,GAAG,GAAG,IAAAC,aAAM,EAAoBC,SAAS,CAAC;EAEhD,IAAIC,IAAI,GAAGH,GAAG,CAACI,OAAO;EAEtB,IAAID,IAAI,EAAE;IACR;IACAA,IAAI,CAAC7C,GAAG,GAAGA,GAAG;IACd6C,IAAI,CAAC5C,IAAI,GAAGA,IAAI;IAChB4C,IAAI,CAACJ,MAAM,GAAGA,MAAM;IACpBI,IAAI,CAACE,WAAW,GAAG7C,EAAE;EACvB,CAAC,MAAM;IACL;IACA,MAAM8C,MAAM,GAAG,MACbC,YAAiD,IAC9C;MACH,MAAMC,KAAK,GAAGR,GAAG,CAACI,OAAQ;MAE1B,MAAMK,WAAW,GAAGF,YAAY,IAAIC,KAAK,CAACT,MAAM;MAChD;MACA;MACA;MACA,IAAI,CAACU,WAAW,IAAI,CAACD,KAAK,CAACH,WAAW,IAAI,CAACG,KAAK,CAAClD,GAAG,EAAE;QACpD,MAAMoD,KAAK,CAAC,gBAAgB,CAAC;MAC/B;MAEA,KAAK,MAAM/C,EAAE,IAAI6C,KAAK,CAAClD,GAAG,EAAE;QAC1B,MAAMqD,QAAQ,GAAGH,KAAK,CAACjD,IAAI,GAAG,GAAGiD,KAAK,CAACjD,IAAI,IAAII,EAAE,EAAE,GAAG,GAAGA,EAAE,EAAE;QAE7D,MAAMiD,aAAa,GAAG,IAAAC,kBAAI,EACxBF,QAAQ;QACR;QACA;QACA;QACA;QACA;QACA;QACA,CAACG,OAAqB,EAAEC,IAAI,KAAKN,WAAW,CAAC9C,EAAE,EAAEmD,OAAO,EAAEC,IAAI,CAAC,EAC/DP,KAAK,CAACH,WACR,CAAC;QAED,IAAIO,aAAa,YAAYI,OAAO,EAAE,MAAMJ,aAAa;MAC3D;IACF,CAAC;IACDT,IAAI,GAAG;MACLE,WAAW,EAAE7C,EAAE;MACfF,GAAG;MACHyC,MAAM;MACNxC,IAAI;MACJ+C,MAAM;MACN;MACA;MACA;MACA;MACA;MACA;MACAW,YAAY,EAAGV,YAAY,IAAKP,GAAG,CAACI,OAAO,CAAEE,MAAM;MACjD;MACA;MACA;MACA;MACA;MACA;MACAC,YAAY,KAAK,CAAC5C,EAAE,EAAE,GAAGuD,IAAI,KAAKX,YAAY,CAAC,GAAGW,IAAI,CAAC,CACzD;IACF,CAAC;IACDlB,GAAG,CAACI,OAAO,GAAGD,IAAI;EACpB;EAEA,OAAOA,IAAI;AACb;;AAEA;AACA;AACA;AACA;;AA+DA;AACA;AACA;AACA;AACA,SAASgB,kBAAkBA,CAIzB7B,OAAoB,EACpB/B,IAA+B,EAC/BwC,MAA0C,EAC1CqB,OAA6B,GAAG,CAAC,CAAC,EAC4B;EAC9D,MAAM9D,GAAG,GAAG+B,YAAY,CAACC,OAAO,CAAC;EACjC,MAAM+B,MAAc,GAAGD,OAAO,CAACC,MAAM,IAAIC,4BAAc;EACvD,MAAMC,UAAkB,GAAGH,OAAO,CAACG,UAAU,IAAIF,MAAM;EACvD,MAAMG,iBAAyB,GAAGJ,OAAO,CAACI,iBAAiB,IAAIH,MAAM;EAErE,MAAMhB,WAAW,GAAG,IAAAoB,mCAAc,EAAC,CAAC;EAEpC,MAAMtB,IAAI,GAAGL,OAAO,CAACxC,GAAG,EAAEC,IAAI,EAAEwC,MAAM,EAAEM,WAAW,CAAC;;EAEpD;EACA,IAAIA,WAAW,CAACqB,UAAU,EAAE;IAC1B,IAAI,CAACN,OAAO,CAACO,QAAQ,IAAI,CAACP,OAAO,CAACQ,KAAK,EAAE;MACvC,MAAMC,WAAyB,GAAG,IAAI,IAAAC,QAAI,EAAC,CAAC,EAAE;MAC9C,KAAK,MAAMnE,EAAE,IAAIL,GAAG,EAAE;QACpB,MAAMqD,QAAQ,GAAGpD,IAAI,GAAG,GAAGA,IAAI,IAAII,EAAE,EAAE,GAAG,GAAGA,EAAE,EAAE;QACjD,MAAMoE,KAAK,GAAG1B,WAAW,CAAC3C,GAAG,CAC3BiD,QAAQ,EACR;UACEqB,YAAY,EAAE,IAAAlE,kCAAoB,EAAQ;QAC5C,CACF,CAAC;QACD,IAAI,CAACiE,KAAK,CAACjD,SAAS,IAAI,CAACiD,KAAK,CAACF,WAAW,EAAE;UAC1C,MAAMjB,aAAa,GAAG,IAAAC,kBAAI,EACxBF,QAAQ,EACR,CAAC,GAAGO,IAAI,KACkCnB,MAAM,CAACpC,EAAE,EAAE,GAAGuD,IAAI,CAAC,EAC7Db,WAAW,EACX;YACE4B,IAAI,EAAEF,KAAK,CAACE,IAAI;YAChBnD,SAAS,EAAEiD,KAAK,CAACjD;UACnB,CAAC,EACD+C,WACF,CAAC;UAED,IAAIjB,aAAa,YAAYI,OAAO,EAAE;YACpCX,WAAW,CAACqB,UAAU,CAACQ,OAAO,CAACC,IAAI,CAACvB,aAAa,CAAC;UACpD;QACF;MACF;IACF;;IAEF;EACA,CAAC,MAAM;IACL,MAAM;MAAEe;IAAS,CAAC,GAAGP,OAAO;;IAE5B;;IAEA,MAAMgB,OAAO,GAAG,IAAAC,WAAI,EAAC/E,GAAG,CAAC;;IAEzB;IACA;IACA,IAAAgF,gBAAS,EAAC,MAAM;MAAE;MAChB,IAAI,CAACX,QAAQ,EAAEtE,YAAY,CAACC,GAAG,EAAEC,IAAI,EAAE8C,WAAW,CAAC;MACnD,OAAO,MAAM;QACX,IAAI,CAACsB,QAAQ,EAAEtD,WAAW,CAACf,GAAG,EAAEC,IAAI,EAAE8C,WAAW,EAAEmB,iBAAiB,CAAC;MACvE,CAAC;;MAED;MACA;MACA;IACF,CAAC,EAAE,CACDG,QAAQ,EACRH,iBAAiB,EACjBnB,WAAW,EACX+B,OAAO,EACP7E,IAAI,CACL,CAAC;;IAEF;IACA;;IAEA;IACA,IAAA+E,gBAAS,EAAC,MAAM;MAAE;MAChB,IAAI,CAACX,QAAQ,EAAE;QACb,KAAK,CAAC,YAAY;UAChB,KAAK,MAAMhE,EAAE,IAAIL,GAAG,EAAE;YACpB,MAAMqD,QAAQ,GAAGpD,IAAI,GAAG,GAAGA,IAAI,IAAII,EAAE,EAAE,GAAG,GAAGA,EAAE,EAAE;YAGjD,MAAM4E,MAAY,GAAGlC,WAAW,CAAC3C,GAAG,CAAeiD,QAAQ,CAAC;YAE5D,MAAM;cAAE6B;YAAK,CAAC,GAAGpB,OAAO;YACxB,IACGoB,IAAI,IAAInC,WAAW,CAACoC,sBAAsB,CAAC9B,QAAQ,EAAE6B,IAAI,CAAC,IAEzDjB,UAAU,GAAG7C,IAAI,CAACD,GAAG,CAAC,CAAC,IAAI8D,MAAM,EAAEzD,SAAS,IAAI,CAAC,CAAC,KAC9C,CAACyD,MAAM,EAAEV,WAAW,IAAIU,MAAM,CAACV,WAAW,CAACa,UAAU,CAAC,GAAG,CAAC,CAC/D,EACD;cACA,IAAI,CAACF,IAAI,EAAEnC,WAAW,CAACsC,gBAAgB,CAAChC,QAAQ,CAAC;cACjD,MAAM,IAAAE,kBAAI,EACRF,QAAQ;cACR;cACA;cACA;cACA;cACA,CAACiC,GAAG,EAAE,GAAG1B,IAAI,KAAKnB,MAAM,CAACpC,EAAE,EAAEiF,GAAG,EAAW,GAAG1B,IAAI,CAAC,EACnDb,WAAW,EACX;gBACE4B,IAAI,EAAEM,MAAM,EAAEN,IAAI;gBAClBnD,SAAS,EAAEyD,MAAM,EAAEzD,SAAS,IAAI;cAClC,CACF,CAAC;YACH;UACF;QACF,CAAC,EAAE,CAAC;MACN;IACF,CAAC,CAAC;EACJ;EAEA,MAAM,CAAC+D,UAAU,CAAC,GAAG,IAAAC,uBAAc,EAEjCvF,IAAI,EAAE,CAAC,CAAC,CAAC;EAEX,IAAI,CAACgC,KAAK,CAACC,OAAO,CAACF,OAAO,CAAC,EAAE;IAC3B;IACA,MAAMyD,CAAC,GAAGF,UAAU,CAACvD,OAAO,CAAW;IACvC,MAAMR,SAAS,GAAGiE,CAAC,EAAEjE,SAAS,IAAI,CAAC;IACnC,OAAO;MACLmD,IAAI,EAAEZ,MAAM,GAAG3C,IAAI,CAACD,GAAG,CAAC,CAAC,GAAGK,SAAS,GAAG,IAAI,GAAGiE,CAAC,EAAEd,IAAI,IAAI,IAAI;MAC9De,OAAO,EAAE,CAAC,CAACD,CAAC,EAAElB,WAAW;MACzBvB,MAAM,EAAEH,IAAI,CAACc,YAAY;MACzBnC;IACF,CAAC;EACH;EAEA,MAAMb,GAAuC,GAAG;IAC9CgF,KAAK,EAAE,CAAC,CAAwC;IAChDD,OAAO,EAAE,KAAK;IACd1C,MAAM,EAAEH,IAAI,CAACG,MAAM;IACnBxB,SAAS,EAAEoE,MAAM,CAACC;EACpB,CAAC;EAED,KAAK,MAAMxF,EAAE,IAAIL,GAAG,EAAE;IACpB;IACA,MAAMyF,CAAC,GAAGF,UAAU,CAAClF,EAAE,CAAW;IAClC,MAAMqF,OAAO,GAAG,CAAC,CAACD,CAAC,EAAElB,WAAW;IAChC,MAAM/C,SAAS,GAAGiE,CAAC,EAAEjE,SAAS,IAAI,CAAC;IAEnCb,GAAG,CAACgF,KAAK,CAACtF,EAAE,CAAC,GAAG;MACdsE,IAAI,EAAEZ,MAAM,GAAG3C,IAAI,CAACD,GAAG,CAAC,CAAC,GAAGK,SAAS,GAAG,IAAI,GAAGiE,CAAC,EAAEd,IAAI,IAAI,IAAI;MAC9De,OAAO;MACPlE;IACF,CAAC;IACDb,GAAG,CAAC+E,OAAO,KAAKA,OAAO;IACvB,IAAI/E,GAAG,CAACa,SAAS,GAAGA,SAAS,EAAEb,GAAG,CAACa,SAAS,GAAGA,SAAS;EAC1D;EAEA,OAAOb,GAAG;AACZ;AAAC,IAAAmF,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEcnC,kBAAkB,EAEjC","ignoreList":[]}

package/build/cjs/useAsyncData.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncData.js","names":["_react","require","_uuid","_jsUtils","_GlobalStateProvider","_useGlobalState","_interopRequireDefault","_utils","DEFAULT_MAXAGE","exports","MIN_MS","newAsyncDataEnvelope","initialData","numRefs","timestamp","data","operationId","finalizeLoad","path","globalState","asyncDataLoadDone","state","get","process","env","NODE_ENV","isDebugMode","console","groupCollapsed","log","cloneDeepForLog","set","Date","now","groupEnd","load","loader","old","uuid","operationIdPath","prevOperationId","definedOld","e","dataOrPromise","isAborted","opid","oldDataTimestamp","setAbortCallback","cb","Error","setAsyncDataAbortCallback","Promise","then","finally","undefined","useAsyncData","options","maxage","refreshAge","garbageCollectAge","getGlobalState","initialValue","current","heap","useRef","reload","customLoader","localLoader","ssrContext","disabled","noSSR","promiseOrVoid","pending","push","useEffect","numRefsPath","state2","dropDependencies","deps","hasChangedDependencies","startsWith","localState","useGlobalState","loading","Boolean"],"sources":["../../src/useAsyncData.ts"],"sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport { MIN_MS } from '@dr.pogodin/js-utils';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nimport type GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nexport const DEFAULT_MAXAGE = 5 * MIN_MS; // 5 minutes.\n\n// NOTE: Here, and below it is important whether a loader and related\n// (re-)loading handlers return a promise or a value, as returning promises\n// mean the async mode, in which related global state values are updated\n// asynchronously (the new value comes into effect in a next rendering cycle),\n// while returning a non-promise value means a synchronous mode, in which\n// related global state values are updated immediately, within the current\n// rendering cycle.\n\nexport type AsyncDataLoaderT<DataT>\n= (oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => (DataT | null) | Promise<DataT | null>;\n\nexport type AsyncDataReloaderT<DataT>\n= (loader?: AsyncDataLoaderT<DataT>) => void | Promise<void>;\n\nexport type AsyncDataEnvelopeT<DataT> = {\n  data: null | DataT;\n  numRefs: number;\n  operationId: string;\n  timestamp: number;\n};\n\nexport type OperationIdT = `${'C' | 'S'}${string}`;\n\nexport function newAsyncDataEnvelope<DataT>(\n  initialData: DataT | null = null,\n  { numRefs = 0, timestamp = 0 } = {},\n): AsyncDataEnvelopeT<DataT> {\n  return {\n    data: initialData,\n    numRefs,\n    operationId: '',\n    timestamp,\n  };\n}\n\nexport type UseAsyncDataOptionsT = {\n  deps?: unknown[];\n  disabled?: boolean;\n  garbageCollectAge?: number;\n  maxage?: number;\n  noSSR?: boolean;\n  refreshAge?: number;\n};\n\nexport type UseAsyncDataResT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  reload: AsyncDataReloaderT<DataT>;\n  timestamp: number;\n};\n\nfunction finalizeLoad<DataT>(\n  data: DataT,\n  path: null | string | undefined,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  operationId: OperationIdT,\n): void {\n  // NOTE: We don't really mean that it hasn't been aborted,\n  // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n  // callback for this operation, if any is registered - just drop it.\n  //\n  // Also, in the synchronous state update mode, we don't really need to set up\n  // the abort callback at all (as there is no way to use it), but for now it is\n  // set up, thus it should be cleaned out here.\n  globalState.asyncDataLoadDone(operationId, false);\n\n  type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n  const state: EnvT = globalState.get<ForceT, EnvT>(path);\n\n  if (operationId === state?.operationId) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupCollapsed(\n        `ReactGlobalState: async data (re-)loaded. Path: \"${\n          path ?? ''\n        }\"`,\n      );\n      console.log('Data:', cloneDeepForLog(data, path ?? ''));\n      /* eslint-enable no-console */\n    }\n    globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n      ...state,\n      data,\n      operationId: '',\n      timestamp: Date.now(),\n    });\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n}\n\n/**\n * Executes the data loading operation.\n * @param path Data segment path inside the global state.\n * @param loader Data loader.\n * @param globalState The global state instance.\n * @param oldData Optional. Previously fetched data, currently stored in\n *  the state, if already fetched by the caller; otherwise, they will be fetched\n *  by the load() function itself.\n * @param opIdPrefix operationId prefix to use, which should be\n * 'C' at the client-side (default), or 'S' at the server-side (within SSR\n * context).\n * @return Resolves once the operation is done.\n * @ignore\n */\nexport function load<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  old?: { data: DataT | null; timestamp: number },\n\n  // TODO: Should this parameter be just a binary flag (client or server),\n  // and UUID always generated inside this function? Or do we need it in\n  // the caller methods as well, in some cases (see useAsyncCollection()\n  // use case as well).\n  operationId: OperationIdT = `C${uuid()}`,\n): void | Promise<void> {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.log(\n      `ReactGlobalState: async data (re-)loading. Path: \"${path ?? ''}\"`,\n    );\n    /* eslint-enable no-console */\n  }\n\n  const operationIdPath = path ? `${path}.operationId` : 'operationId';\n  {\n    const prevOperationId = globalState.get<ForceT, string>(operationIdPath);\n    if (prevOperationId) globalState.asyncDataLoadDone(prevOperationId, true);\n  }\n  globalState.set<ForceT, string>(operationIdPath, operationId);\n\n  let definedOld = old;\n  if (!definedOld) {\n    // TODO: Can we improve the typing, to avoid ForceT?\n    const e = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path);\n    definedOld = { data: e.data, timestamp: e.timestamp };\n  }\n\n  const dataOrPromise = loader(definedOld.data, {\n    isAborted: () => {\n      // TODO: Can we improve the typing, to avoid ForceT?\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      return opid !== operationId;\n    },\n    oldDataTimestamp: definedOld.timestamp,\n    setAbortCallback(cb: () => void) {\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      if (opid !== operationId) {\n        throw Error(`Operation #${operationId} has completed already`);\n      }\n      globalState.setAsyncDataAbortCallback(operationId, cb);\n    },\n  });\n\n  if (dataOrPromise instanceof Promise) {\n    return dataOrPromise.then((data) => {\n      finalizeLoad(data, path, globalState, operationId);\n    }).finally(() => {\n      // NOTE: We don't really mean that it hasn't been aborted,\n      // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n      // callback for this operation, if any is registered - just drop it.\n      globalState.asyncDataLoadDone(operationId, false);\n    });\n  }\n\n  finalizeLoad(dataOrPromise, path, globalState, operationId);\n  return undefined;\n}\n\n/**\n * Resolves asynchronous data, and stores them at given `path` of global\n * state.\n */\n\nexport type DataInEnvelopeAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n> = Exclude<Extract<ValueAtPathT<StateT, PathT, void>, AsyncDataEnvelopeT<unknown>>['data'], null>;\n\ntype HeapT<DataT> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState?: GlobalState<unknown>;\n  path?: null | string;\n  loader?: AsyncDataLoaderT<DataT>;\n  reload?: AsyncDataReloaderT<DataT>;\n};\n\nfunction useAsyncData<\n  StateT,\n  PathT extends null | string | undefined,\n\n  DataT extends DataInEnvelopeAtPathT<\n    StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n>(\n  path: PathT,\n  loader: AsyncDataLoaderT<DataT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncData<\n  Forced extends ForceT | LockT = LockT,\n  DataT = void,\n>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncData<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> {\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  // Note: here we can't depend on useGlobalState() to init the initial value,\n  // because that way we'll have issues with SSR (see details below).\n  const globalState = getGlobalState();\n  const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    initialValue: newAsyncDataEnvelope<DataT>(),\n  });\n\n  const { current: heap } = useRef<HeapT<DataT>>({});\n  heap.globalState = globalState;\n  heap.path = path;\n  heap.loader = loader;\n\n  heap.reload ??= (\n    customLoader?: AsyncDataLoaderT<DataT>,\n  ): void | Promise<void> => {\n    const localLoader = customLoader ?? heap.loader;\n    if (!localLoader || !heap.globalState) throw Error('Internal error');\n    return load(heap.path, localLoader, heap.globalState);\n  };\n\n  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\n      const promiseOrVoid = load(path, loader, globalState, {\n        data: state.data,\n        timestamp: state.timestamp,\n      }, `S${uuid()}`);\n      if (promiseOrVoid instanceof Promise) {\n        globalState.ssrContext.pending.push(promiseOrVoid);\n      }\n    }\n  } else {\n    const { disabled } = options;\n\n    // This takes care about the client-side reference counting, and garbage\n    // collection.\n    //\n    // Note: the Rules of Hook below are violated by conditional call to a hook,\n    // but as the condition is actually server-side or client-side environment,\n    // it is effectively non-conditional at the runtime.\n    //\n    // TODO: Though, maybe there is a way to refactor it into a cleaner code.\n    // The same applies to other useEffect() hooks below.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      const numRefsPath = path ? `${path}.numRefs` : 'numRefs';\n      if (!disabled) {\n        const numRefs = globalState.get<ForceT, number>(numRefsPath);\n        globalState.set<ForceT, number>(numRefsPath, numRefs + 1);\n      }\n      return () => {\n        if (!disabled) {\n          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n            ForceT, AsyncDataEnvelopeT<DataT>>(\n            path,\n          );\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 - useAsyncData garbage collected at path ${\n                  path ?? ''\n                }`,\n              );\n              /* eslint-enable no-console */\n            }\n            globalState.dropDependencies(path ?? '');\n            globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n              ...state2,\n              data: null,\n              numRefs: 0,\n              timestamp: 0,\n            });\n          } else {\n            globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n          }\n        }\n      };\n    }, [disabled, garbageCollectAge, globalState, path]);\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) {\n        const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>>(path);\n\n        const { deps } = options;\n        if (\n          // The hook is called with a list of dependencies, that mismatch\n          // dependencies last used to retrieve the data at given path.\n          (deps && globalState.hasChangedDependencies(path ?? '', deps))\n\n          // Data at the path are stale, and are not being loaded.\n          || (\n            refreshAge < Date.now() - state2.timestamp\n            && (!state2.operationId || state2.operationId.startsWith('S'))\n          )\n        ) {\n          if (!deps) globalState.dropDependencies(path ?? '');\n          void load(path, loader, globalState, {\n            data: state2.data,\n            timestamp: state2.timestamp,\n          });\n        }\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<ForceT, AsyncDataEnvelopeT<DataT>>(\n    path,\n    newAsyncDataEnvelope<DataT>(),\n  );\n\n  return {\n    data: maxage < Date.now() - localState.timestamp ? null : localState.data,\n    loading: Boolean(localState.operationId),\n    reload: heap.reload,\n    timestamp: localState.timestamp,\n  };\n}\n\nexport { useAsyncData };\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseAsyncDataI<StateT> {\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    loader: AsyncDataLoaderT<DataInEnvelopeAtPathT<StateT, PathT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, PathT>>;\n\n  <Forced extends ForceT | LockT = LockT, DataT = unknown>(\n    path: null | string | undefined,\n    loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useAsyncData.js","names":["_react","require","_uuid","_jsUtils","_GlobalStateProvider","_useGlobalState","_interopRequireDefault","_utils","DEFAULT_MAXAGE","exports","MIN_MS","newAsyncDataEnvelope","initialData","numRefs","timestamp","data","operationId","finalizeLoad","path","globalState","asyncDataLoadDone","state","get","process","env","NODE_ENV","isDebugMode","console","groupCollapsed","log","cloneDeepForLog","set","Date","now","groupEnd","load","loader","old","uuid","operationIdPath","prevOperationId","definedOld","e","dataOrPromise","isAborted","opid","oldDataTimestamp","setAbortCallback","cb","Error","setAsyncDataAbortCallback","Promise","then","finally","undefined","useAsyncData","options","maxage","refreshAge","garbageCollectAge","getGlobalState","initialValue","current","heap","useRef","reload","customLoader","localLoader","ssrContext","disabled","noSSR","promiseOrVoid","pending","push","useEffect","numRefsPath","state2","dropDependencies","deps","hasChangedDependencies","startsWith","localState","useGlobalState","loading","Boolean"],"sources":["../../src/useAsyncData.ts"],"sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport { MIN_MS } from '@dr.pogodin/js-utils';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nimport type GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nexport const DEFAULT_MAXAGE = 5 * MIN_MS; // 5 minutes.\n\n// NOTE: Here, and below it is important whether a loader and related\n// (re-)loading handlers return a promise or a value, as returning promises\n// mean the async mode, in which related global state values are updated\n// asynchronously (the new value comes into effect in a next rendering cycle),\n// while returning a non-promise value means a synchronous mode, in which\n// related global state values are updated immediately, within the current\n// rendering cycle.\n\nexport type AsyncDataLoaderT<DataT>\n= (oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncDataReloaderT<DataT>\n= (loader?: AsyncDataLoaderT<DataT>) => void | Promise<void>;\n\nexport type AsyncDataEnvelopeT<DataT> = {\n  data: null | DataT;\n  numRefs: number;\n  operationId: string;\n  timestamp: number;\n};\n\nexport type OperationIdT = `${'C' | 'S'}${string}`;\n\nexport function newAsyncDataEnvelope<DataT>(\n  initialData: DataT | null = null,\n  { numRefs = 0, timestamp = 0 } = {},\n): AsyncDataEnvelopeT<DataT> {\n  return {\n    data: initialData,\n    numRefs,\n    operationId: '',\n    timestamp,\n  };\n}\n\nexport type UseAsyncDataOptionsT = {\n  deps?: unknown[];\n  disabled?: boolean;\n  garbageCollectAge?: number;\n  maxage?: number;\n  noSSR?: boolean;\n  refreshAge?: number;\n};\n\nexport type UseAsyncDataResT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  reload: AsyncDataReloaderT<DataT>;\n  timestamp: number;\n};\n\nfunction finalizeLoad<DataT>(\n  data: DataT,\n  path: null | string | undefined,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  operationId: OperationIdT,\n): void {\n  // NOTE: We don't really mean that it hasn't been aborted,\n  // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n  // callback for this operation, if any is registered - just drop it.\n  //\n  // Also, in the synchronous state update mode, we don't really need to set up\n  // the abort callback at all (as there is no way to use it), but for now it is\n  // set up, thus it should be cleaned out here.\n  globalState.asyncDataLoadDone(operationId, false);\n\n  type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n  const state: EnvT = globalState.get<ForceT, EnvT>(path);\n\n  if (operationId === state?.operationId) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupCollapsed(\n        `ReactGlobalState: async data (re-)loaded. Path: \"${\n          path ?? ''\n        }\"`,\n      );\n      console.log('Data:', cloneDeepForLog(data, path ?? ''));\n      /* eslint-enable no-console */\n    }\n    globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n      ...state,\n      data,\n      operationId: '',\n      timestamp: Date.now(),\n    });\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n}\n\n/**\n * Executes the data loading operation.\n * @param path Data segment path inside the global state.\n * @param loader Data loader.\n * @param globalState The global state instance.\n * @param oldData Optional. Previously fetched data, currently stored in\n *  the state, if already fetched by the caller; otherwise, they will be fetched\n *  by the load() function itself.\n * @param opIdPrefix operationId prefix to use, which should be\n * 'C' at the client-side (default), or 'S' at the server-side (within SSR\n * context).\n * @return Resolves once the operation is done.\n * @ignore\n */\nexport function load<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  old?: { data: DataT | null; timestamp: number },\n\n  // TODO: Should this parameter be just a binary flag (client or server),\n  // and UUID always generated inside this function? Or do we need it in\n  // the caller methods as well, in some cases (see useAsyncCollection()\n  // use case as well).\n  operationId: OperationIdT = `C${uuid()}`,\n): void | Promise<void> {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.log(\n      `ReactGlobalState: async data (re-)loading. Path: \"${path ?? ''}\"`,\n    );\n    /* eslint-enable no-console */\n  }\n\n  const operationIdPath = path ? `${path}.operationId` : 'operationId';\n  {\n    const prevOperationId = globalState.get<ForceT, string>(operationIdPath);\n    if (prevOperationId) globalState.asyncDataLoadDone(prevOperationId, true);\n  }\n  globalState.set<ForceT, string>(operationIdPath, operationId);\n\n  let definedOld = old;\n  if (!definedOld) {\n    // TODO: Can we improve the typing, to avoid ForceT?\n    const e = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path);\n    definedOld = { data: e.data, timestamp: e.timestamp };\n  }\n\n  const dataOrPromise = loader(definedOld.data, {\n    isAborted: () => {\n      // TODO: Can we improve the typing, to avoid ForceT?\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      return opid !== operationId;\n    },\n    oldDataTimestamp: definedOld.timestamp,\n    setAbortCallback(cb: () => void) {\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      if (opid !== operationId) {\n        throw Error(`Operation #${operationId} has completed already`);\n      }\n      globalState.setAsyncDataAbortCallback(operationId, cb);\n    },\n  });\n\n  if (dataOrPromise instanceof Promise) {\n    return dataOrPromise.then((data) => {\n      finalizeLoad(data, path, globalState, operationId);\n    }).finally(() => {\n      // NOTE: We don't really mean that it hasn't been aborted,\n      // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n      // callback for this operation, if any is registered - just drop it.\n      globalState.asyncDataLoadDone(operationId, false);\n    });\n  }\n\n  finalizeLoad(dataOrPromise, path, globalState, operationId);\n  return undefined;\n}\n\n/**\n * Resolves asynchronous data, and stores them at given `path` of global\n * state.\n */\n\nexport type DataInEnvelopeAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n> = Exclude<Extract<ValueAtPathT<StateT, PathT, void>, AsyncDataEnvelopeT<unknown>>['data'], null>;\n\ntype HeapT<DataT> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState?: GlobalState<unknown>;\n  path?: null | string;\n  loader?: AsyncDataLoaderT<DataT>;\n  reload?: AsyncDataReloaderT<DataT>;\n};\n\nfunction useAsyncData<\n  StateT,\n  PathT extends null | string | undefined,\n\n  DataT extends DataInEnvelopeAtPathT<\n    StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n>(\n  path: PathT,\n  loader: AsyncDataLoaderT<DataT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncData<\n  Forced extends ForceT | LockT = LockT,\n  DataT = void,\n>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncData<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> {\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  // Note: here we can't depend on useGlobalState() to init the initial value,\n  // because that way we'll have issues with SSR (see details below).\n  const globalState = getGlobalState();\n  const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    initialValue: newAsyncDataEnvelope<DataT>(),\n  });\n\n  const { current: heap } = useRef<HeapT<DataT>>({});\n  heap.globalState = globalState;\n  heap.path = path;\n  heap.loader = loader;\n\n  heap.reload ??= (\n    customLoader?: AsyncDataLoaderT<DataT>,\n  ): void | Promise<void> => {\n    const localLoader = customLoader ?? heap.loader;\n    if (!localLoader || !heap.globalState) throw Error('Internal error');\n    return load(heap.path, localLoader, heap.globalState);\n  };\n\n  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\n      const promiseOrVoid = load(path, loader, globalState, {\n        data: state.data,\n        timestamp: state.timestamp,\n      }, `S${uuid()}`);\n      if (promiseOrVoid instanceof Promise) {\n        globalState.ssrContext.pending.push(promiseOrVoid);\n      }\n    }\n  } else {\n    const { disabled } = options;\n\n    // This takes care about the client-side reference counting, and garbage\n    // collection.\n    //\n    // Note: the Rules of Hook below are violated by conditional call to a hook,\n    // but as the condition is actually server-side or client-side environment,\n    // it is effectively non-conditional at the runtime.\n    //\n    // TODO: Though, maybe there is a way to refactor it into a cleaner code.\n    // The same applies to other useEffect() hooks below.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      const numRefsPath = path ? `${path}.numRefs` : 'numRefs';\n      if (!disabled) {\n        const numRefs = globalState.get<ForceT, number>(numRefsPath);\n        globalState.set<ForceT, number>(numRefsPath, numRefs + 1);\n      }\n      return () => {\n        if (!disabled) {\n          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n            ForceT, AsyncDataEnvelopeT<DataT>>(\n            path,\n          );\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 - useAsyncData garbage collected at path ${\n                  path ?? ''\n                }`,\n              );\n              /* eslint-enable no-console */\n            }\n            globalState.dropDependencies(path ?? '');\n            globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n              ...state2,\n              data: null,\n              numRefs: 0,\n              timestamp: 0,\n            });\n          } else {\n            globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n          }\n        }\n      };\n    }, [disabled, garbageCollectAge, globalState, path]);\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) {\n        const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>>(path);\n\n        const { deps } = options;\n        if (\n          // The hook is called with a list of dependencies, that mismatch\n          // dependencies last used to retrieve the data at given path.\n          (deps && globalState.hasChangedDependencies(path ?? '', deps))\n\n          // Data at the path are stale, and are not being loaded.\n          || (\n            refreshAge < Date.now() - state2.timestamp\n            && (!state2.operationId || state2.operationId.startsWith('S'))\n          )\n        ) {\n          if (!deps) globalState.dropDependencies(path ?? '');\n          void load(path, loader, globalState, {\n            data: state2.data,\n            timestamp: state2.timestamp,\n          });\n        }\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<ForceT, AsyncDataEnvelopeT<DataT>>(\n    path,\n    newAsyncDataEnvelope<DataT>(),\n  );\n\n  return {\n    data: maxage < Date.now() - localState.timestamp ? null : localState.data,\n    loading: Boolean(localState.operationId),\n    reload: heap.reload,\n    timestamp: localState.timestamp,\n  };\n}\n\nexport { useAsyncData };\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseAsyncDataI<StateT> {\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    loader: AsyncDataLoaderT<DataInEnvelopeAtPathT<StateT, PathT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, PathT>>;\n\n  <Forced extends ForceT | LockT = LockT, DataT = unknown>(\n    path: null | string | undefined,\n    loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/code/GlobalStateProvider.js

@@ -36,8 +36,7 @@ export function getGlobalState() {
  * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached
  *   to the global state provided by {@link <GlobalStateProvider>}.
  */
-export function getSsrContext() {
-  let throwWithoutSsrContext = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
+export function getSsrContext(throwWithoutSsrContext = true) {
   const {
     ssrContext
   } = getGlobalState();
@@ -59,11 +58,10 @@ export function getSsrContext() {
  * - If `GlobalState` instance, it will be used by this provider.
  * - If not given, a new `GlobalState` instance will be created and used.
  */
-const GlobalStateProvider = _ref => {
-  let {
-    children,
-    ...rest
-  } = _ref;
+const GlobalStateProvider = ({
+  children,
+  ...rest
+}) => {
   const localStateRef = useRef(undefined);
   let state;
   // TODO: Revise.

package/build/code/GlobalStateProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalStateProvider.js","names":["isFunction","createContext","use","useRef","GlobalState","jsx","_jsx","Context","getGlobalState","globalState","Error","getSsrContext","throwWithoutSsrContext","arguments","length","undefined","ssrContext","GlobalStateProvider","_ref","children","rest","localStateRef","state","stateProxy","current","initialState","value"],"sources":["../../src/GlobalStateProvider.tsx"],"sourcesContent":["import { isFunction } from 'lodash';\n\nimport {\n  type ReactNode,\n  createContext,\n  use,\n  useRef,\n} from 'react';\n\nimport GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nimport type { ValueOrInitializerT } from './utils';\n\nconst Context = createContext<GlobalState<unknown> | null>(null);\n\n/**\n * Gets {@link GlobalState} instance from the context. In most cases\n * you should use {@link useGlobalState}, and other hooks to interact with\n * the global state, instead of accessing it directly.\n * @return\n */\nexport function getGlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): GlobalState<StateT, SsrContextT> {\n  // TODO: Think about it: on one hand we on purpose called this function\n  // as getGlobalState(), so that ppl looking for the state hook prefer using\n  // useGlobalState(), while this getGlobalState() is reserved for nieche cases;\n  // on the other hand, perhaps we can rename it into useSomething, to both\n  // follow conventions, and to keep stuff clearly named at the same time.\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const globalState = use(Context);\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState as GlobalState<StateT, SsrContextT>;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param throwWithoutSsrContext If `true` (default),\n * this hook will throw if no SSR context is attached to the global state;\n * set `false` to not throw in such case. In either case the hook will throw\n * if the {@link &lt;GlobalStateProvider&gt;} (hence the state) is missing.\n * @returns SSR context.\n * @throws\n * - If current component has no parent {@link &lt;GlobalStateProvider&gt;}\n *   in the rendered React tree.\n * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached\n *   to the global state provided by {@link &lt;GlobalStateProvider&gt;}.\n */\nexport function getSsrContext<\n  SsrContextT extends SsrContext<unknown>,\n>(\n  throwWithoutSsrContext = true,\n): SsrContextT | undefined {\n  const { ssrContext } = getGlobalState<SsrContextT['state'], SsrContextT>();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\ntype NewStateProps<StateT, SsrContextT extends SsrContext<StateT>> = {\n  initialState: ValueOrInitializerT<StateT>;\n  ssrContext?: SsrContextT;\n};\n\ntype GlobalStateProviderProps<\n  StateT,\n  SsrContextT extends SsrContext<StateT>,\n> = {\n  children?: ReactNode;\n} & (NewStateProps<StateT, SsrContextT> | {\n  stateProxy: true | GlobalState<StateT, SsrContextT>;\n});\n\n/**\n * Provides global state to its children.\n * @param prop.children Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @param prop.initialState Initial content of the global state.\n * @param prop.ssrContext Server-side rendering (SSR) context.\n * @param prop.stateProxy This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nconst GlobalStateProvider = <\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(\n  { children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>,\n): ReactNode => {\n  type GST = GlobalState<StateT, SsrContextT>;\n  const localStateRef = useRef<GST>(undefined);\n  let state: GST;\n  // TODO: Revise.\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if ('stateProxy' in rest && rest.stateProxy) {\n    localStateRef.current = undefined;\n    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;\n  } else {\n    if (!localStateRef.current) {\n      const {\n        initialState,\n        ssrContext,\n      } = rest as NewStateProps<StateT, SsrContextT>;\n      localStateRef.current = new GlobalState(\n        isFunction(initialState) ? initialState() : initialState,\n        ssrContext,\n      );\n    }\n    state = localStateRef.current;\n  }\n  return <Context value={state}>{children}</Context>;\n};\n\nexport default GlobalStateProvider;\n"],"mappings":"AAAA,SAASA,UAAU,QAAQ,QAAQ;AAEnC,SAEEC,aAAa,EACbC,GAAG,EACHC,MAAM,QACD,OAAO;AAEd,OAAOC,WAAW;AAAsB,SAAAC,GAAA,IAAAC,IAAA;AAKxC,MAAMC,OAAO,gBAAGN,aAAa,CAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,cAAcA,CAAA,EAGQ;EACpC;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAGP,GAAG,CAACK,OAAO,CAAC;EAChC,IAAI,CAACE,WAAW,EAAE,MAAM,IAAIC,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOD,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAAA,EAIF;EAAA,IADzBC,sBAAsB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,IAAI;EAE7B,MAAM;IAAEG;EAAW,CAAC,GAAGR,cAAc,CAAoC,CAAC;EAC1E,IAAI,CAACQ,UAAU,IAAIJ,sBAAsB,EAAE;IACzC,MAAM,IAAIF,KAAK,CAAC,sBAAsB,CAAC;EACzC;EACA,OAAOM,UAAU;AACnB;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAmB,GAAGC,IAAA,IAKZ;EAAA,IADd;IAAEC,QAAQ;IAAE,GAAGC;EAAoD,CAAC,GAAAF,IAAA;EAGpE,MAAMG,aAAa,GAAGlB,MAAM,CAAMY,SAAS,CAAC;EAC5C,IAAIO,KAAU;EACd;EACA;EACA,IAAI,YAAY,IAAIF,IAAI,IAAIA,IAAI,CAACG,UAAU,EAAE;IAC3CF,aAAa,CAACG,OAAO,GAAGT,SAAS;IACjCO,KAAK,GAAGF,IAAI,CAACG,UAAU,KAAK,IAAI,GAAGf,cAAc,CAAC,CAAC,GAAGY,IAAI,CAACG,UAAU;EACvE,CAAC,MAAM;IACL,IAAI,CAACF,aAAa,CAACG,OAAO,EAAE;MAC1B,MAAM;QACJC,YAAY;QACZT;MACF,CAAC,GAAGI,IAA0C;MAC9CC,aAAa,CAACG,OAAO,GAAG,IAAIpB,WAAW,CACrCJ,UAAU,CAACyB,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDT,UACF,CAAC;IACH;IACAM,KAAK,GAAGD,aAAa,CAACG,OAAO;EAC/B;EACA,oBAAOlB,IAAA,CAACC,OAAO;IAACmB,KAAK,EAAEJ,KAAM;IAAAH,QAAA,EAAEA;EAAQ,CAAU,CAAC;AACpD,CAAC;AAED,eAAeF,mBAAmB","ignoreList":[]}
+{"version":3,"file":"GlobalStateProvider.js","names":["isFunction","createContext","use","useRef","GlobalState","jsx","_jsx","Context","getGlobalState","globalState","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","rest","localStateRef","undefined","state","stateProxy","current","initialState","value"],"sources":["../../src/GlobalStateProvider.tsx"],"sourcesContent":["import { isFunction } from 'lodash';\n\nimport {\n  type ReactNode,\n  createContext,\n  use,\n  useRef,\n} from 'react';\n\nimport GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nimport type { ValueOrInitializerT } from './utils';\n\nconst Context = createContext<GlobalState<unknown> | null>(null);\n\n/**\n * Gets {@link GlobalState} instance from the context. In most cases\n * you should use {@link useGlobalState}, and other hooks to interact with\n * the global state, instead of accessing it directly.\n * @return\n */\nexport function getGlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): GlobalState<StateT, SsrContextT> {\n  // TODO: Think about it: on one hand we on purpose called this function\n  // as getGlobalState(), so that ppl looking for the state hook prefer using\n  // useGlobalState(), while this getGlobalState() is reserved for nieche cases;\n  // on the other hand, perhaps we can rename it into useSomething, to both\n  // follow conventions, and to keep stuff clearly named at the same time.\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const globalState = use(Context);\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState as GlobalState<StateT, SsrContextT>;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param throwWithoutSsrContext If `true` (default),\n * this hook will throw if no SSR context is attached to the global state;\n * set `false` to not throw in such case. In either case the hook will throw\n * if the {@link &lt;GlobalStateProvider&gt;} (hence the state) is missing.\n * @returns SSR context.\n * @throws\n * - If current component has no parent {@link &lt;GlobalStateProvider&gt;}\n *   in the rendered React tree.\n * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached\n *   to the global state provided by {@link &lt;GlobalStateProvider&gt;}.\n */\nexport function getSsrContext<\n  SsrContextT extends SsrContext<unknown>,\n>(\n  throwWithoutSsrContext = true,\n): SsrContextT | undefined {\n  const { ssrContext } = getGlobalState<SsrContextT['state'], SsrContextT>();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\ntype NewStateProps<StateT, SsrContextT extends SsrContext<StateT>> = {\n  initialState: ValueOrInitializerT<StateT>;\n  ssrContext?: SsrContextT;\n};\n\ntype GlobalStateProviderProps<\n  StateT,\n  SsrContextT extends SsrContext<StateT>,\n> = {\n  children?: ReactNode;\n} & (NewStateProps<StateT, SsrContextT> | {\n  stateProxy: true | GlobalState<StateT, SsrContextT>;\n});\n\n/**\n * Provides global state to its children.\n * @param prop.children Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @param prop.initialState Initial content of the global state.\n * @param prop.ssrContext Server-side rendering (SSR) context.\n * @param prop.stateProxy This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nconst GlobalStateProvider = <\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(\n  { children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>,\n): ReactNode => {\n  type GST = GlobalState<StateT, SsrContextT>;\n  const localStateRef = useRef<GST>(undefined);\n  let state: GST;\n  // TODO: Revise.\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if ('stateProxy' in rest && rest.stateProxy) {\n    localStateRef.current = undefined;\n    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;\n  } else {\n    if (!localStateRef.current) {\n      const {\n        initialState,\n        ssrContext,\n      } = rest as NewStateProps<StateT, SsrContextT>;\n      localStateRef.current = new GlobalState(\n        isFunction(initialState) ? initialState() : initialState,\n        ssrContext,\n      );\n    }\n    state = localStateRef.current;\n  }\n  return <Context value={state}>{children}</Context>;\n};\n\nexport default GlobalStateProvider;\n"],"mappings":"AAAA,SAASA,UAAU,QAAQ,QAAQ;AAEnC,SAEEC,aAAa,EACbC,GAAG,EACHC,MAAM,QACD,OAAO;AAEd,OAAOC,WAAW;AAAsB,SAAAC,GAAA,IAAAC,IAAA;AAKxC,MAAMC,OAAO,gBAAGN,aAAa,CAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,cAAcA,CAAA,EAGQ;EACpC;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAGP,GAAG,CAACK,OAAO,CAAC;EAChC,IAAI,CAACE,WAAW,EAAE,MAAM,IAAIC,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOD,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAG3BC,sBAAsB,GAAG,IAAI,EACJ;EACzB,MAAM;IAAEC;EAAW,CAAC,GAAGL,cAAc,CAAoC,CAAC;EAC1E,IAAI,CAACK,UAAU,IAAID,sBAAsB,EAAE;IACzC,MAAM,IAAIF,KAAK,CAAC,sBAAsB,CAAC;EACzC;EACA,OAAOG,UAAU;AACnB;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAmB,GAAGA,CAI1B;EAAEC,QAAQ;EAAE,GAAGC;AAAoD,CAAC,KACtD;EAEd,MAAMC,aAAa,GAAGd,MAAM,CAAMe,SAAS,CAAC;EAC5C,IAAIC,KAAU;EACd;EACA;EACA,IAAI,YAAY,IAAIH,IAAI,IAAIA,IAAI,CAACI,UAAU,EAAE;IAC3CH,aAAa,CAACI,OAAO,GAAGH,SAAS;IACjCC,KAAK,GAAGH,IAAI,CAACI,UAAU,KAAK,IAAI,GAAGZ,cAAc,CAAC,CAAC,GAAGQ,IAAI,CAACI,UAAU;EACvE,CAAC,MAAM;IACL,IAAI,CAACH,aAAa,CAACI,OAAO,EAAE;MAC1B,MAAM;QACJC,YAAY;QACZT;MACF,CAAC,GAAGG,IAA0C;MAC9CC,aAAa,CAACI,OAAO,GAAG,IAAIjB,WAAW,CACrCJ,UAAU,CAACsB,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDT,UACF,CAAC;IACH;IACAM,KAAK,GAAGF,aAAa,CAACI,OAAO;EAC/B;EACA,oBAAOf,IAAA,CAACC,OAAO;IAACgB,KAAK,EAAEJ,KAAM;IAAAJ,QAAA,EAAEA;EAAQ,CAAU,CAAC;AACpD,CAAC;AAED,eAAeD,mBAAmB","ignoreList":[]}

package/build/code/useAsyncCollection.js

@@ -72,7 +72,10 @@ function gcOnRelease(ids, path, gs, gcAge) {
 }
 function normalizeIds(idOrIds) {
   if (Array.isArray(idOrIds)) {
-    const res = [...idOrIds];
+    // Removes ID duplicates.
+    const res = Array.from(new Set(idOrIds));
+
+    // Ensures stable ID order.
     res.sort((a, b) => a.toString().localeCompare(b.toString()));
     return res;
   }
@@ -134,12 +137,7 @@ function useHeap(ids, path, loader, gs) {
       // happens if the outer function on the next line matches the same
       // async / sync signature.
       // eslint-disable-next-line @typescript-eslint/promise-function-async
-      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);
-      })
+      customLoader && ((id, ...args) => customLoader(...args)))
     };
     ref.current = heap;
   }
@@ -155,9 +153,8 @@ function useHeap(ids, path, loader, gs) {
 // Perhaps, a bunch of logic blocks can be split into stand-alone functions,
 // and reused in both hooks.
 // eslint-disable-next-line complexity
-function useAsyncCollection(idOrIds, path, loader) {
+function useAsyncCollection(idOrIds, path, loader, options = {}) {
   var _options$maxage, _options$refreshAge, _options$garbageColle;
-  let options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
   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;
@@ -166,31 +163,32 @@ function useAsyncCollection(idOrIds, path, loader) {
   const heap = useHeap(ids, path, loader, globalState);
 
   // Server-side logic.
-  if (globalState.ssrContext && !options.noSSR) {
-    const operationId = `S${uuid()}`;
-    for (const id of ids) {
-      const itemPath = path ? `${path}.${id}` : `${id}`;
-      const state = globalState.get(itemPath, {
-        initialValue: newAsyncDataEnvelope()
-      });
-      if (!state.timestamp && !state.operationId) {
-        const promiseOrVoid = load(itemPath, function () {
-          for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-            args[_key2] = arguments[_key2];
+  if (globalState.ssrContext) {
+    if (!options.disabled && !options.noSSR) {
+      const operationId = `S${uuid()}`;
+      for (const id of ids) {
+        const itemPath = path ? `${path}.${id}` : `${id}`;
+        const state = globalState.get(itemPath, {
+          initialValue: newAsyncDataEnvelope()
+        });
+        if (!state.timestamp && !state.operationId) {
+          const promiseOrVoid = load(itemPath, (...args) => loader(id, ...args), globalState, {
+            data: state.data,
+            timestamp: state.timestamp
+          }, operationId);
+          if (promiseOrVoid instanceof Promise) {
+            globalState.ssrContext.pending.push(promiseOrVoid);
           }
-          return loader(id, ...args);
-        }, globalState, {
-          data: state.data,
-          timestamp: state.timestamp
-        }, operationId);
-        if (promiseOrVoid instanceof Promise) {
-          globalState.ssrContext.pending.push(promiseOrVoid);
         }
       }
     }
 
     // Client-side logic.
   } else {
+    const {
+      disabled
+    } = options;
+
     // Reference-counting & garbage collection.
 
     const idsHash = hash(ids);
@@ -199,15 +197,15 @@ function useAsyncCollection(idOrIds, path, loader) {
     // but perhaps it can be refactored to avoid the need for it.
     useEffect(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
-      gcOnWithhold(ids, path, globalState);
+      if (!disabled) gcOnWithhold(ids, path, globalState);
       return () => {
-        gcOnRelease(ids, path, globalState, garbageCollectAge);
+        if (!disabled) 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, idsHash, path]);
+    }, [disabled, 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.
@@ -215,34 +213,31 @@ function useAsyncCollection(idOrIds, path, loader) {
     // Data loading and refreshing.
     useEffect(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
-      void (async () => {
-        for (const id of ids) {
-          var _state2$timestamp;
-          const itemPath = path ? `${path}.${id}` : `${id}`;
-          const state2 = globalState.get(itemPath);
-          const {
-            deps
-          } = options;
-          if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - ((_state2$timestamp = state2 === null || state2 === void 0 ? void 0 : state2.timestamp) !== null && _state2$timestamp !== void 0 ? _state2$timestamp : 0) && (!(state2 !== null && state2 !== void 0 && state2.operationId) || state2.operationId.startsWith('S'))) {
-            var _state2$timestamp2;
-            if (!deps) globalState.dropDependencies(itemPath);
-            await load(itemPath,
-            // TODO: I guess, the loader is not correctly typed here -
-            // it can be synchronous, and in that case the following method
-            // should be kept synchronous to not alter the sync logic.
-            // eslint-disable-next-line @typescript-eslint/promise-function-async
-            function (old) {
-              for (var _len3 = arguments.length, args = new Array(_len3 > 1 ? _len3 - 1 : 0), _key3 = 1; _key3 < _len3; _key3++) {
-                args[_key3 - 1] = arguments[_key3];
-              }
-              return loader(id, old, ...args);
-            }, globalState, {
-              data: state2 === null || state2 === void 0 ? void 0 : state2.data,
-              timestamp: (_state2$timestamp2 = state2 === null || state2 === void 0 ? void 0 : state2.timestamp) !== null && _state2$timestamp2 !== void 0 ? _state2$timestamp2 : 0
-            });
+      if (!disabled) {
+        void (async () => {
+          for (const id of ids) {
+            var _state2$timestamp;
+            const itemPath = path ? `${path}.${id}` : `${id}`;
+            const state2 = globalState.get(itemPath);
+            const {
+              deps
+            } = options;
+            if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - ((_state2$timestamp = state2 === null || state2 === void 0 ? void 0 : state2.timestamp) !== null && _state2$timestamp !== void 0 ? _state2$timestamp : 0) && (!(state2 !== null && state2 !== void 0 && state2.operationId) || state2.operationId.startsWith('S'))) {
+              var _state2$timestamp2;
+              if (!deps) globalState.dropDependencies(itemPath);
+              await load(itemPath,
+              // TODO: I guess, the loader is not correctly typed here -
+              // it can be synchronous, and in that case the following method
+              // should be kept synchronous to not alter the sync logic.
+              // eslint-disable-next-line @typescript-eslint/promise-function-async
+              (old, ...args) => loader(id, old, ...args), globalState, {
+                data: state2 === null || state2 === void 0 ? void 0 : state2.data,
+                timestamp: (_state2$timestamp2 = state2 === null || state2 === void 0 ? void 0 : state2.timestamp) !== null && _state2$timestamp2 !== void 0 ? _state2$timestamp2 : 0
+              });
+            }
           }
-        }
-      })();
+        })();
+      }
     });
   }
   const [localState] = useGlobalState(path, {});

package/build/code/useAsyncCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncCollection.js","names":["useEffect","useRef","v4","uuid","getGlobalState","DEFAULT_MAXAGE","load","newAsyncDataEnvelope","useGlobalState","hash","isDebugMode","gcOnWithhold","ids","path","gs","collection","get","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","a","b","localeCompare","useHeap","loader","ref","undefined","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","promiseOrVoid","oldData","meta","Promise","reloadSingle","_len","arguments","length","args","_key","useAsyncCollection","_options$maxage","_options$refreshAge","_options$garbageColle","options","maxage","refreshAge","garbageCollectAge","ssrContext","noSSR","operationId","state","initialValue","_len2","_key2","data","pending","push","idsHash","_state2$timestamp","state2","deps","hasChangedDependencies","startsWith","_state2$timestamp2","dropDependencies","old","_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 type 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> = Record<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    setAbortCallback: (cb: () => void) => void;\n  }) => (DataT | null) | Promise<DataT | null>;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | 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: Record<IdT, CollectionItemT<DataT>>;\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 (const id of ids) {\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 (const id of ids) {\n    res.add(id.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 (const [id, envelope] of entries) {\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((a, b) => a.toString().localeCompare(b.toString()));\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>>(undefined);\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      // TODO: Revise - not sure all related typing is 100% correct,\n      // thus let's keep this runtime assertion.\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!localLoader || !heap2.globalState || !heap2.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of heap2.ids) {\n        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;\n\n        const promiseOrVoid = load(\n          itemPath,\n          // TODO: Revise! Most probably we don't have fully correct loader\n          // typing, as it may return either promise or value, and those two\n          // cases call for different runtime behavior, which in turns only\n          // happens if the outer function on the next line matches the same\n          // async / sync signature.\n          // eslint-disable-next-line @typescript-eslint/promise-function-async\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap2.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n    heap = {\n      globalState: gs,\n      ids,\n      loader,\n      path,\n      reload,\n      // TODO: Revise! Most probably we don't have fully correct loader\n      // typing, as it may return either promise or value, and those two\n      // cases call for different runtime behavior, which in turns only\n      // happens if the outer function on the next line matches the same\n      // async / sync signature.\n      // eslint-disable-next-line @typescript-eslint/promise-function-async\n      reloadSingle: (customLoader) => ref.current!.reload(\n        // TODO: Revise! Most probably we don't have fully correct loader\n        // typing, as it may return either promise or value, and those two\n        // cases call for different runtime behavior, which in turns only\n        // happens if the outer function on the next line matches the same\n        // async / sync signature.\n        // eslint-disable-next-line @typescript-eslint/promise-function-async\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}`> = 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}`> = 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\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT | IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT> | 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.\n// eslint-disable-next-line complexity\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 (const id of ids) {\n      const itemPath = path ? `${path}.${id}` : `${id}`;\n      const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n        itemPath,\n        {\n          initialValue: newAsyncDataEnvelope<DataT>(),\n        },\n      );\n      if (!state.timestamp && !state.operationId) {\n        const promiseOrVoid = load(\n          itemPath,\n          (...args):\n            DataT | null | Promise<DataT | null> => loader(id, ...args),\n          globalState,\n          {\n            data: state.data,\n            timestamp: state.timestamp,\n          },\n          operationId,\n        );\n\n        if (promiseOrVoid instanceof Promise) {\n          globalState.ssrContext.pending.push(promiseOrVoid);\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 () => {\n        gcOnRelease(ids, path, globalState, garbageCollectAge);\n      };\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      void (async () => {\n        for (const id of ids) {\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n\n          type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n          const state2: EnvT = globalState.get<ForceT, EnvT>(itemPath);\n\n          const { deps } = options;\n          if (\n            (deps && globalState.hasChangedDependencies(itemPath, deps))\n            || (\n              refreshAge < Date.now() - (state2?.timestamp ?? 0)\n              && (!state2?.operationId || state2.operationId.startsWith('S'))\n            )\n          ) {\n            if (!deps) globalState.dropDependencies(itemPath);\n            await load(\n              itemPath,\n              // TODO: I guess, the loader is not correctly typed here -\n              // it can be synchronous, and in that case the following method\n              // should be kept synchronous to not alter the sync logic.\n              // eslint-disable-next-line @typescript-eslint/promise-function-async\n              (old, ...args) => loader(id, old as DataT, ...args),\n              globalState,\n              {\n                data: state2?.data,\n                timestamp: state2?.timestamp ?? 0,\n              },\n            );\n          }\n        }\n      })();\n    });\n  }\n\n  const [localState] = useGlobalState<\n    ForceT, Record<string, AsyncDataEnvelopeT<DataT>>\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    // TODO: Revise related typings!\n    const e = localState[idOrIds as string];\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 (const id of ids) {\n    // TODO: Revise related typing. Should `localState` have a more specific type?\n    const e = localState[id as string];\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\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\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  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT | IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>\n    | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, 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","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","from","sort","a","b","localeCompare","useHeap","loader","ref","undefined","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","promiseOrVoid","oldData","meta","Promise","reloadSingle","args","useAsyncCollection","options","_options$maxage","_options$refreshAge","_options$garbageColle","maxage","refreshAge","garbageCollectAge","ssrContext","disabled","noSSR","operationId","state","initialValue","data","pending","push","idsHash","_state2$timestamp","state2","deps","hasChangedDependencies","startsWith","_state2$timestamp2","dropDependencies","old","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 type 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> = Record<IdT, AsyncDataEnvelopeT<DataT>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | 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: Record<IdT, CollectionItemT<DataT>>;\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 (const id of ids) {\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 (const id of ids) {\n    res.add(id.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 (const [id, envelope] of entries) {\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    // Removes ID duplicates.\n    const res = Array.from(new Set(idOrIds));\n\n    // Ensures stable ID order.\n    res.sort((a, b) => a.toString().localeCompare(b.toString()));\n\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>>(undefined);\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      // TODO: Revise - not sure all related typing is 100% correct,\n      // thus let's keep this runtime assertion.\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!localLoader || !heap2.globalState || !heap2.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of heap2.ids) {\n        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;\n\n        const promiseOrVoid = load(\n          itemPath,\n          // TODO: Revise! Most probably we don't have fully correct loader\n          // typing, as it may return either promise or value, and those two\n          // cases call for different runtime behavior, which in turns only\n          // happens if the outer function on the next line matches the same\n          // async / sync signature.\n          // eslint-disable-next-line @typescript-eslint/promise-function-async\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap2.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n    heap = {\n      globalState: gs,\n      ids,\n      loader,\n      path,\n      reload,\n      // TODO: Revise! Most probably we don't have fully correct loader\n      // typing, as it may return either promise or value, and those two\n      // cases call for different runtime behavior, which in turns only\n      // happens if the outer function on the next line matches the same\n      // async / sync signature.\n      // eslint-disable-next-line @typescript-eslint/promise-function-async\n      reloadSingle: (customLoader) => ref.current!.reload(\n        // TODO: Revise! Most probably we don't have fully correct loader\n        // typing, as it may return either promise or value, and those two\n        // cases call for different runtime behavior, which in turns only\n        // happens if the outer function on the next line matches the same\n        // async / sync signature.\n        // eslint-disable-next-line @typescript-eslint/promise-function-async\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}`> = 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}`> = 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\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT | IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT> | 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.\n// eslint-disable-next-line complexity\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) {\n    if (!options.disabled && !options.noSSR) {\n      const operationId: OperationIdT = `S${uuid()}`;\n      for (const id of ids) {\n        const itemPath = path ? `${path}.${id}` : `${id}`;\n        const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n          itemPath,\n          {\n            initialValue: newAsyncDataEnvelope<DataT>(),\n          },\n        );\n        if (!state.timestamp && !state.operationId) {\n          const promiseOrVoid = load(\n            itemPath,\n            (...args):\n              DataT | null | Promise<DataT | null> => loader(id, ...args),\n            globalState,\n            {\n              data: state.data,\n              timestamp: state.timestamp,\n            },\n            operationId,\n          );\n\n          if (promiseOrVoid instanceof Promise) {\n            globalState.ssrContext.pending.push(promiseOrVoid);\n          }\n        }\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    const { disabled } = options;\n\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      if (!disabled) gcOnWithhold(ids, path, globalState);\n      return () => {\n        if (!disabled) gcOnRelease(ids, path, globalState, garbageCollectAge);\n      };\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      disabled,\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) {\n        void (async () => {\n          for (const id of ids) {\n            const itemPath = path ? `${path}.${id}` : `${id}`;\n\n            type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n            const state2: EnvT = globalState.get<ForceT, EnvT>(itemPath);\n\n            const { deps } = options;\n            if (\n              (deps && globalState.hasChangedDependencies(itemPath, deps))\n              || (\n                refreshAge < Date.now() - (state2?.timestamp ?? 0)\n                && (!state2?.operationId || state2.operationId.startsWith('S'))\n              )\n            ) {\n              if (!deps) globalState.dropDependencies(itemPath);\n              await load(\n                itemPath,\n                // TODO: I guess, the loader is not correctly typed here -\n                // it can be synchronous, and in that case the following method\n                // should be kept synchronous to not alter the sync logic.\n                // eslint-disable-next-line @typescript-eslint/promise-function-async\n                (old, ...args) => loader(id, old as DataT, ...args),\n                globalState,\n                {\n                  data: state2?.data,\n                  timestamp: state2?.timestamp ?? 0,\n                },\n              );\n            }\n          }\n        })();\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<\n    ForceT, Record<string, AsyncDataEnvelopeT<DataT>>\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    // TODO: Revise related typings!\n    const e = localState[idOrIds as string];\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 (const id of ids) {\n    // TODO: Revise related typing. Should `localState` have a more specific type?\n    const e = localState[id as string];\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\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\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  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT | IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>\n    | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/code/useAsyncData.js

@@ -18,12 +18,10 @@ export const DEFAULT_MAXAGE = 5 * MIN_MS; // 5 minutes.
 // related global state values are updated immediately, within the current
 // rendering cycle.
 
-export function newAsyncDataEnvelope() {
-  let initialData = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : null;
-  let {
-    numRefs = 0,
-    timestamp = 0
-  } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+export function newAsyncDataEnvelope(initialData = null, {
+  numRefs = 0,
+  timestamp = 0
+} = {}) {
   return {
     data: initialData,
     numRefs,
@@ -76,8 +74,12 @@ function finalizeLoad(data, path, globalState, operationId) {
  * @return Resolves once the operation is done.
  * @ignore
  */
-export function load(path, loader, globalState, old) {
-  let operationId = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : `C${uuid()}`;
+export function load(path, loader, globalState, old,
+// TODO: Should this parameter be just a binary flag (client or server),
+// and UUID always generated inside this function? Or do we need it in
+// the caller methods as well, in some cases (see useAsyncCollection()
+// use case as well).
+operationId = `C${uuid()}`) {
   if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
     /* eslint-disable no-console */
     console.log(`ReactGlobalState: async data (re-)loading. Path: "${path !== null && path !== void 0 ? path : ''}"`);
@@ -132,9 +134,8 @@ export function load(path, loader, globalState, old) {
  * state.
  */
 
-function useAsyncData(path, loader) {
+function useAsyncData(path, loader, options = {}) {
   var _options$maxage, _options$refreshAge, _options$garbageColle, _heap$reload;
-  let options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
   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;

package/build/code/useAsyncData.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncData.js","names":["useEffect","useRef","v4","uuid","MIN_MS","getGlobalState","useGlobalState","cloneDeepForLog","isDebugMode","DEFAULT_MAXAGE","newAsyncDataEnvelope","initialData","arguments","length","undefined","numRefs","timestamp","data","operationId","finalizeLoad","path","globalState","asyncDataLoadDone","state","get","process","env","NODE_ENV","console","groupCollapsed","log","set","Date","now","groupEnd","load","loader","old","operationIdPath","prevOperationId","definedOld","e","dataOrPromise","isAborted","opid","oldDataTimestamp","setAbortCallback","cb","Error","setAsyncDataAbortCallback","Promise","then","finally","useAsyncData","_options$maxage","_options$refreshAge","_options$garbageColle","_heap$reload","options","maxage","refreshAge","garbageCollectAge","initialValue","current","heap","reload","customLoader","localLoader","ssrContext","disabled","noSSR","promiseOrVoid","pending","push","numRefsPath","state2","dropDependencies","deps","hasChangedDependencies","startsWith","localState","loading","Boolean"],"sources":["../../src/useAsyncData.ts"],"sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport { MIN_MS } from '@dr.pogodin/js-utils';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nimport type GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nexport const DEFAULT_MAXAGE = 5 * MIN_MS; // 5 minutes.\n\n// NOTE: Here, and below it is important whether a loader and related\n// (re-)loading handlers return a promise or a value, as returning promises\n// mean the async mode, in which related global state values are updated\n// asynchronously (the new value comes into effect in a next rendering cycle),\n// while returning a non-promise value means a synchronous mode, in which\n// related global state values are updated immediately, within the current\n// rendering cycle.\n\nexport type AsyncDataLoaderT<DataT>\n= (oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => (DataT | null) | Promise<DataT | null>;\n\nexport type AsyncDataReloaderT<DataT>\n= (loader?: AsyncDataLoaderT<DataT>) => void | Promise<void>;\n\nexport type AsyncDataEnvelopeT<DataT> = {\n  data: null | DataT;\n  numRefs: number;\n  operationId: string;\n  timestamp: number;\n};\n\nexport type OperationIdT = `${'C' | 'S'}${string}`;\n\nexport function newAsyncDataEnvelope<DataT>(\n  initialData: DataT | null = null,\n  { numRefs = 0, timestamp = 0 } = {},\n): AsyncDataEnvelopeT<DataT> {\n  return {\n    data: initialData,\n    numRefs,\n    operationId: '',\n    timestamp,\n  };\n}\n\nexport type UseAsyncDataOptionsT = {\n  deps?: unknown[];\n  disabled?: boolean;\n  garbageCollectAge?: number;\n  maxage?: number;\n  noSSR?: boolean;\n  refreshAge?: number;\n};\n\nexport type UseAsyncDataResT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  reload: AsyncDataReloaderT<DataT>;\n  timestamp: number;\n};\n\nfunction finalizeLoad<DataT>(\n  data: DataT,\n  path: null | string | undefined,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  operationId: OperationIdT,\n): void {\n  // NOTE: We don't really mean that it hasn't been aborted,\n  // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n  // callback for this operation, if any is registered - just drop it.\n  //\n  // Also, in the synchronous state update mode, we don't really need to set up\n  // the abort callback at all (as there is no way to use it), but for now it is\n  // set up, thus it should be cleaned out here.\n  globalState.asyncDataLoadDone(operationId, false);\n\n  type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n  const state: EnvT = globalState.get<ForceT, EnvT>(path);\n\n  if (operationId === state?.operationId) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupCollapsed(\n        `ReactGlobalState: async data (re-)loaded. Path: \"${\n          path ?? ''\n        }\"`,\n      );\n      console.log('Data:', cloneDeepForLog(data, path ?? ''));\n      /* eslint-enable no-console */\n    }\n    globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n      ...state,\n      data,\n      operationId: '',\n      timestamp: Date.now(),\n    });\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n}\n\n/**\n * Executes the data loading operation.\n * @param path Data segment path inside the global state.\n * @param loader Data loader.\n * @param globalState The global state instance.\n * @param oldData Optional. Previously fetched data, currently stored in\n *  the state, if already fetched by the caller; otherwise, they will be fetched\n *  by the load() function itself.\n * @param opIdPrefix operationId prefix to use, which should be\n * 'C' at the client-side (default), or 'S' at the server-side (within SSR\n * context).\n * @return Resolves once the operation is done.\n * @ignore\n */\nexport function load<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  old?: { data: DataT | null; timestamp: number },\n\n  // TODO: Should this parameter be just a binary flag (client or server),\n  // and UUID always generated inside this function? Or do we need it in\n  // the caller methods as well, in some cases (see useAsyncCollection()\n  // use case as well).\n  operationId: OperationIdT = `C${uuid()}`,\n): void | Promise<void> {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.log(\n      `ReactGlobalState: async data (re-)loading. Path: \"${path ?? ''}\"`,\n    );\n    /* eslint-enable no-console */\n  }\n\n  const operationIdPath = path ? `${path}.operationId` : 'operationId';\n  {\n    const prevOperationId = globalState.get<ForceT, string>(operationIdPath);\n    if (prevOperationId) globalState.asyncDataLoadDone(prevOperationId, true);\n  }\n  globalState.set<ForceT, string>(operationIdPath, operationId);\n\n  let definedOld = old;\n  if (!definedOld) {\n    // TODO: Can we improve the typing, to avoid ForceT?\n    const e = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path);\n    definedOld = { data: e.data, timestamp: e.timestamp };\n  }\n\n  const dataOrPromise = loader(definedOld.data, {\n    isAborted: () => {\n      // TODO: Can we improve the typing, to avoid ForceT?\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      return opid !== operationId;\n    },\n    oldDataTimestamp: definedOld.timestamp,\n    setAbortCallback(cb: () => void) {\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      if (opid !== operationId) {\n        throw Error(`Operation #${operationId} has completed already`);\n      }\n      globalState.setAsyncDataAbortCallback(operationId, cb);\n    },\n  });\n\n  if (dataOrPromise instanceof Promise) {\n    return dataOrPromise.then((data) => {\n      finalizeLoad(data, path, globalState, operationId);\n    }).finally(() => {\n      // NOTE: We don't really mean that it hasn't been aborted,\n      // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n      // callback for this operation, if any is registered - just drop it.\n      globalState.asyncDataLoadDone(operationId, false);\n    });\n  }\n\n  finalizeLoad(dataOrPromise, path, globalState, operationId);\n  return undefined;\n}\n\n/**\n * Resolves asynchronous data, and stores them at given `path` of global\n * state.\n */\n\nexport type DataInEnvelopeAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n> = Exclude<Extract<ValueAtPathT<StateT, PathT, void>, AsyncDataEnvelopeT<unknown>>['data'], null>;\n\ntype HeapT<DataT> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState?: GlobalState<unknown>;\n  path?: null | string;\n  loader?: AsyncDataLoaderT<DataT>;\n  reload?: AsyncDataReloaderT<DataT>;\n};\n\nfunction useAsyncData<\n  StateT,\n  PathT extends null | string | undefined,\n\n  DataT extends DataInEnvelopeAtPathT<\n    StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n>(\n  path: PathT,\n  loader: AsyncDataLoaderT<DataT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncData<\n  Forced extends ForceT | LockT = LockT,\n  DataT = void,\n>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncData<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> {\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  // Note: here we can't depend on useGlobalState() to init the initial value,\n  // because that way we'll have issues with SSR (see details below).\n  const globalState = getGlobalState();\n  const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    initialValue: newAsyncDataEnvelope<DataT>(),\n  });\n\n  const { current: heap } = useRef<HeapT<DataT>>({});\n  heap.globalState = globalState;\n  heap.path = path;\n  heap.loader = loader;\n\n  heap.reload ??= (\n    customLoader?: AsyncDataLoaderT<DataT>,\n  ): void | Promise<void> => {\n    const localLoader = customLoader ?? heap.loader;\n    if (!localLoader || !heap.globalState) throw Error('Internal error');\n    return load(heap.path, localLoader, heap.globalState);\n  };\n\n  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\n      const promiseOrVoid = load(path, loader, globalState, {\n        data: state.data,\n        timestamp: state.timestamp,\n      }, `S${uuid()}`);\n      if (promiseOrVoid instanceof Promise) {\n        globalState.ssrContext.pending.push(promiseOrVoid);\n      }\n    }\n  } else {\n    const { disabled } = options;\n\n    // This takes care about the client-side reference counting, and garbage\n    // collection.\n    //\n    // Note: the Rules of Hook below are violated by conditional call to a hook,\n    // but as the condition is actually server-side or client-side environment,\n    // it is effectively non-conditional at the runtime.\n    //\n    // TODO: Though, maybe there is a way to refactor it into a cleaner code.\n    // The same applies to other useEffect() hooks below.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      const numRefsPath = path ? `${path}.numRefs` : 'numRefs';\n      if (!disabled) {\n        const numRefs = globalState.get<ForceT, number>(numRefsPath);\n        globalState.set<ForceT, number>(numRefsPath, numRefs + 1);\n      }\n      return () => {\n        if (!disabled) {\n          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n            ForceT, AsyncDataEnvelopeT<DataT>>(\n            path,\n          );\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 - useAsyncData garbage collected at path ${\n                  path ?? ''\n                }`,\n              );\n              /* eslint-enable no-console */\n            }\n            globalState.dropDependencies(path ?? '');\n            globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n              ...state2,\n              data: null,\n              numRefs: 0,\n              timestamp: 0,\n            });\n          } else {\n            globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n          }\n        }\n      };\n    }, [disabled, garbageCollectAge, globalState, path]);\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) {\n        const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>>(path);\n\n        const { deps } = options;\n        if (\n          // The hook is called with a list of dependencies, that mismatch\n          // dependencies last used to retrieve the data at given path.\n          (deps && globalState.hasChangedDependencies(path ?? '', deps))\n\n          // Data at the path are stale, and are not being loaded.\n          || (\n            refreshAge < Date.now() - state2.timestamp\n            && (!state2.operationId || state2.operationId.startsWith('S'))\n          )\n        ) {\n          if (!deps) globalState.dropDependencies(path ?? '');\n          void load(path, loader, globalState, {\n            data: state2.data,\n            timestamp: state2.timestamp,\n          });\n        }\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<ForceT, AsyncDataEnvelopeT<DataT>>(\n    path,\n    newAsyncDataEnvelope<DataT>(),\n  );\n\n  return {\n    data: maxage < Date.now() - localState.timestamp ? null : localState.data,\n    loading: Boolean(localState.operationId),\n    reload: heap.reload,\n    timestamp: localState.timestamp,\n  };\n}\n\nexport { useAsyncData };\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseAsyncDataI<StateT> {\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    loader: AsyncDataLoaderT<DataInEnvelopeAtPathT<StateT, PathT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, PathT>>;\n\n  <Forced extends ForceT | LockT = LockT, DataT = unknown>(\n    path: null | string | undefined,\n    loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useAsyncData.js","names":["useEffect","useRef","v4","uuid","MIN_MS","getGlobalState","useGlobalState","cloneDeepForLog","isDebugMode","DEFAULT_MAXAGE","newAsyncDataEnvelope","initialData","numRefs","timestamp","data","operationId","finalizeLoad","path","globalState","asyncDataLoadDone","state","get","process","env","NODE_ENV","console","groupCollapsed","log","set","Date","now","groupEnd","load","loader","old","operationIdPath","prevOperationId","definedOld","e","dataOrPromise","isAborted","opid","oldDataTimestamp","setAbortCallback","cb","Error","setAsyncDataAbortCallback","Promise","then","finally","undefined","useAsyncData","options","_options$maxage","_options$refreshAge","_options$garbageColle","_heap$reload","maxage","refreshAge","garbageCollectAge","initialValue","current","heap","reload","customLoader","localLoader","ssrContext","disabled","noSSR","promiseOrVoid","pending","push","numRefsPath","state2","dropDependencies","deps","hasChangedDependencies","startsWith","localState","loading","Boolean"],"sources":["../../src/useAsyncData.ts"],"sourcesContent":["/**\n * Loads and uses async data into the GlobalState path.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport { MIN_MS } from '@dr.pogodin/js-utils';\n\nimport { getGlobalState } from './GlobalStateProvider';\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nimport type GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nexport const DEFAULT_MAXAGE = 5 * MIN_MS; // 5 minutes.\n\n// NOTE: Here, and below it is important whether a loader and related\n// (re-)loading handlers return a promise or a value, as returning promises\n// mean the async mode, in which related global state values are updated\n// asynchronously (the new value comes into effect in a next rendering cycle),\n// while returning a non-promise value means a synchronous mode, in which\n// related global state values are updated immediately, within the current\n// rendering cycle.\n\nexport type AsyncDataLoaderT<DataT>\n= (oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncDataReloaderT<DataT>\n= (loader?: AsyncDataLoaderT<DataT>) => void | Promise<void>;\n\nexport type AsyncDataEnvelopeT<DataT> = {\n  data: null | DataT;\n  numRefs: number;\n  operationId: string;\n  timestamp: number;\n};\n\nexport type OperationIdT = `${'C' | 'S'}${string}`;\n\nexport function newAsyncDataEnvelope<DataT>(\n  initialData: DataT | null = null,\n  { numRefs = 0, timestamp = 0 } = {},\n): AsyncDataEnvelopeT<DataT> {\n  return {\n    data: initialData,\n    numRefs,\n    operationId: '',\n    timestamp,\n  };\n}\n\nexport type UseAsyncDataOptionsT = {\n  deps?: unknown[];\n  disabled?: boolean;\n  garbageCollectAge?: number;\n  maxage?: number;\n  noSSR?: boolean;\n  refreshAge?: number;\n};\n\nexport type UseAsyncDataResT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  reload: AsyncDataReloaderT<DataT>;\n  timestamp: number;\n};\n\nfunction finalizeLoad<DataT>(\n  data: DataT,\n  path: null | string | undefined,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  operationId: OperationIdT,\n): void {\n  // NOTE: We don't really mean that it hasn't been aborted,\n  // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n  // callback for this operation, if any is registered - just drop it.\n  //\n  // Also, in the synchronous state update mode, we don't really need to set up\n  // the abort callback at all (as there is no way to use it), but for now it is\n  // set up, thus it should be cleaned out here.\n  globalState.asyncDataLoadDone(operationId, false);\n\n  type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n  const state: EnvT = globalState.get<ForceT, EnvT>(path);\n\n  if (operationId === state?.operationId) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupCollapsed(\n        `ReactGlobalState: async data (re-)loaded. Path: \"${\n          path ?? ''\n        }\"`,\n      );\n      console.log('Data:', cloneDeepForLog(data, path ?? ''));\n      /* eslint-enable no-console */\n    }\n    globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n      ...state,\n      data,\n      operationId: '',\n      timestamp: Date.now(),\n    });\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n}\n\n/**\n * Executes the data loading operation.\n * @param path Data segment path inside the global state.\n * @param loader Data loader.\n * @param globalState The global state instance.\n * @param oldData Optional. Previously fetched data, currently stored in\n *  the state, if already fetched by the caller; otherwise, they will be fetched\n *  by the load() function itself.\n * @param opIdPrefix operationId prefix to use, which should be\n * 'C' at the client-side (default), or 'S' at the server-side (within SSR\n * context).\n * @return Resolves once the operation is done.\n * @ignore\n */\nexport function load<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  old?: { data: DataT | null; timestamp: number },\n\n  // TODO: Should this parameter be just a binary flag (client or server),\n  // and UUID always generated inside this function? Or do we need it in\n  // the caller methods as well, in some cases (see useAsyncCollection()\n  // use case as well).\n  operationId: OperationIdT = `C${uuid()}`,\n): void | Promise<void> {\n  if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n    /* eslint-disable no-console */\n    console.log(\n      `ReactGlobalState: async data (re-)loading. Path: \"${path ?? ''}\"`,\n    );\n    /* eslint-enable no-console */\n  }\n\n  const operationIdPath = path ? `${path}.operationId` : 'operationId';\n  {\n    const prevOperationId = globalState.get<ForceT, string>(operationIdPath);\n    if (prevOperationId) globalState.asyncDataLoadDone(prevOperationId, true);\n  }\n  globalState.set<ForceT, string>(operationIdPath, operationId);\n\n  let definedOld = old;\n  if (!definedOld) {\n    // TODO: Can we improve the typing, to avoid ForceT?\n    const e = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path);\n    definedOld = { data: e.data, timestamp: e.timestamp };\n  }\n\n  const dataOrPromise = loader(definedOld.data, {\n    isAborted: () => {\n      // TODO: Can we improve the typing, to avoid ForceT?\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      return opid !== operationId;\n    },\n    oldDataTimestamp: definedOld.timestamp,\n    setAbortCallback(cb: () => void) {\n      const opid = globalState.get<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      if (opid !== operationId) {\n        throw Error(`Operation #${operationId} has completed already`);\n      }\n      globalState.setAsyncDataAbortCallback(operationId, cb);\n    },\n  });\n\n  if (dataOrPromise instanceof Promise) {\n    return dataOrPromise.then((data) => {\n      finalizeLoad(data, path, globalState, operationId);\n    }).finally(() => {\n      // NOTE: We don't really mean that it hasn't been aborted,\n      // the \"false\" flag rather says we don't need to trigger \"on aborted\"\n      // callback for this operation, if any is registered - just drop it.\n      globalState.asyncDataLoadDone(operationId, false);\n    });\n  }\n\n  finalizeLoad(dataOrPromise, path, globalState, operationId);\n  return undefined;\n}\n\n/**\n * Resolves asynchronous data, and stores them at given `path` of global\n * state.\n */\n\nexport type DataInEnvelopeAtPathT<\n  StateT,\n  PathT extends null | string | undefined,\n> = Exclude<Extract<ValueAtPathT<StateT, PathT, void>, AsyncDataEnvelopeT<unknown>>['data'], null>;\n\ntype HeapT<DataT> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState?: GlobalState<unknown>;\n  path?: null | string;\n  loader?: AsyncDataLoaderT<DataT>;\n  reload?: AsyncDataReloaderT<DataT>;\n};\n\nfunction useAsyncData<\n  StateT,\n  PathT extends null | string | undefined,\n\n  DataT extends DataInEnvelopeAtPathT<\n    StateT, PathT> = DataInEnvelopeAtPathT<StateT, PathT>,\n>(\n  path: PathT,\n  loader: AsyncDataLoaderT<DataT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncData<\n  Forced extends ForceT | LockT = LockT,\n  DataT = void,\n>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncData<DataT>(\n  path: null | string | undefined,\n  loader: AsyncDataLoaderT<DataT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> {\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  // Note: here we can't depend on useGlobalState() to init the initial value,\n  // because that way we'll have issues with SSR (see details below).\n  const globalState = getGlobalState();\n  const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n    initialValue: newAsyncDataEnvelope<DataT>(),\n  });\n\n  const { current: heap } = useRef<HeapT<DataT>>({});\n  heap.globalState = globalState;\n  heap.path = path;\n  heap.loader = loader;\n\n  heap.reload ??= (\n    customLoader?: AsyncDataLoaderT<DataT>,\n  ): void | Promise<void> => {\n    const localLoader = customLoader ?? heap.loader;\n    if (!localLoader || !heap.globalState) throw Error('Internal error');\n    return load(heap.path, localLoader, heap.globalState);\n  };\n\n  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\n      const promiseOrVoid = load(path, loader, globalState, {\n        data: state.data,\n        timestamp: state.timestamp,\n      }, `S${uuid()}`);\n      if (promiseOrVoid instanceof Promise) {\n        globalState.ssrContext.pending.push(promiseOrVoid);\n      }\n    }\n  } else {\n    const { disabled } = options;\n\n    // This takes care about the client-side reference counting, and garbage\n    // collection.\n    //\n    // Note: the Rules of Hook below are violated by conditional call to a hook,\n    // but as the condition is actually server-side or client-side environment,\n    // it is effectively non-conditional at the runtime.\n    //\n    // TODO: Though, maybe there is a way to refactor it into a cleaner code.\n    // The same applies to other useEffect() hooks below.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      const numRefsPath = path ? `${path}.numRefs` : 'numRefs';\n      if (!disabled) {\n        const numRefs = globalState.get<ForceT, number>(numRefsPath);\n        globalState.set<ForceT, number>(numRefsPath, numRefs + 1);\n      }\n      return () => {\n        if (!disabled) {\n          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n            ForceT, AsyncDataEnvelopeT<DataT>>(\n            path,\n          );\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 - useAsyncData garbage collected at path ${\n                  path ?? ''\n                }`,\n              );\n              /* eslint-enable no-console */\n            }\n            globalState.dropDependencies(path ?? '');\n            globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {\n              ...state2,\n              data: null,\n              numRefs: 0,\n              timestamp: 0,\n            });\n          } else {\n            globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n          }\n        }\n      };\n    }, [disabled, garbageCollectAge, globalState, path]);\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    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      if (!disabled) {\n        const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>>(path);\n\n        const { deps } = options;\n        if (\n          // The hook is called with a list of dependencies, that mismatch\n          // dependencies last used to retrieve the data at given path.\n          (deps && globalState.hasChangedDependencies(path ?? '', deps))\n\n          // Data at the path are stale, and are not being loaded.\n          || (\n            refreshAge < Date.now() - state2.timestamp\n            && (!state2.operationId || state2.operationId.startsWith('S'))\n          )\n        ) {\n          if (!deps) globalState.dropDependencies(path ?? '');\n          void load(path, loader, globalState, {\n            data: state2.data,\n            timestamp: state2.timestamp,\n          });\n        }\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<ForceT, AsyncDataEnvelopeT<DataT>>(\n    path,\n    newAsyncDataEnvelope<DataT>(),\n  );\n\n  return {\n    data: maxage < Date.now() - localState.timestamp ? null : localState.data,\n    loading: Boolean(localState.operationId),\n    reload: heap.reload,\n    timestamp: localState.timestamp,\n  };\n}\n\nexport { useAsyncData };\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport interface UseAsyncDataI<StateT> {\n  <PathT extends null | string | undefined>(\n    path: PathT,\n    loader: AsyncDataLoaderT<DataInEnvelopeAtPathT<StateT, PathT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, PathT>>;\n\n  <Forced extends ForceT | LockT = LockT, DataT = unknown>(\n    path: null | string | undefined,\n    loader: AsyncDataLoaderT<TypeLock<Forced, void, DataT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/code/utils.js

@@ -44,8 +44,7 @@ const cloneDeepBailKeys = new Set();
  * (to avoid situations when large payload in the global state slows down
  * development versions of the app due to the logging overhead).
  */
-export function cloneDeepForLog(value) {
-  let key = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+export function cloneDeepForLog(value, key = '') {
   if (cloneDeepBailKeys.has(key)) {
     // eslint-disable-next-line no-console
     console.warn(`The logged value won't be clonned (key "${key}").`);

package/build/code/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":["cloneDeep","isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","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\nexport declare const force: unique symbol;\nexport declare 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\n  // TODO: Revise later.\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\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\n  // TODO: Revise later.\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents, @typescript-eslint/no-invalid-void-type\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 {\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;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;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,MAAM;IACN,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,GAAGpB,SAAS,CAACS,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":[]}
+{"version":3,"file":"utils.js","names":["cloneDeep","isDebugMode","process","env","NODE_ENV","REACT_GLOBAL_STATE_DEBUG","cloneDeepBailKeys","Set","cloneDeepForLog","value","key","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\nexport declare const force: unique symbol;\nexport declare 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\n  // TODO: Revise later.\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\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\n  // TODO: Revise later.\n  // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents, @typescript-eslint/no-invalid-void-type\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 {\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;;AAiBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAmBA;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,MAAM;IACN,OAAO,KAAK;EACd;AACF;AAEA,MAAMC,iBAAiB,GAAG,IAAIC,GAAG,CAAS,CAAC;;AAE3C;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAIC,KAAQ,EAAEC,GAAW,GAAG,EAAE,EAAK;EAChE,IAAIJ,iBAAiB,CAACK,GAAG,CAACD,GAAG,CAAC,EAAE;IAC9B;IACAE,OAAO,CAACC,IAAI,CAAC,2CAA2CH,GAAG,KAAK,CAAC;IACjE,OAAOD,KAAK;EACd;EAEA,MAAMK,KAAK,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;EACxB,MAAMC,GAAG,GAAGjB,SAAS,CAACS,KAAK,CAAC;EAC5B,MAAMS,IAAI,GAAGH,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,KAAK;EAC/B,IAAII,IAAI,GAAG,GAAG,EAAE;IACd;IACAN,OAAO,CAACC,IAAI,CAAC,GAAGK,IAAI,4CAA4CR,GAAG,KAAK,CAAC;IACzEJ,iBAAiB,CAACa,GAAG,CAACT,GAAG,CAAC;EAC5B;EAEA,OAAOO,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/useAsyncCollection.d.ts

@@ -8,7 +8,7 @@ export type AsyncCollectionLoaderT<DataT, IdT extends number | string = number |
     isAborted: () => boolean;
     oldDataTimestamp: number;
     setAbortCallback: (cb: () => void) => void;
-}) => (DataT | null) | Promise<DataT | null>;
+}) => DataT | null | Promise<DataT | null>;
 export type AsyncCollectionReloaderT<DataT, IdT extends number | string = number | string> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | Promise<void>;
 type CollectionItemT<DataT> = {
     data: DataT | null;

package/build/types/useAsyncData.d.ts

@@ -9,7 +9,7 @@ export type AsyncDataLoaderT<DataT> = (oldData: null | DataT, meta: {
     isAborted: () => boolean;
     oldDataTimestamp: number;
     setAbortCallback: (cb: () => void) => void;
-}) => (DataT | null) | Promise<DataT | null>;
+}) => DataT | null | Promise<DataT | null>;
 export type AsyncDataReloaderT<DataT> = (loader?: AsyncDataLoaderT<DataT>) => void | Promise<void>;
 export type AsyncDataEnvelopeT<DataT> = {
     data: null | DataT;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dr.pogodin/react-global-state",
-  "version": "0.19.2",
+  "version": "0.19.3",
   "description": "Hook-based global state for React",
   "main": "./build/code/index.js",
   "types": "./build/types/index.d.ts",
@@ -40,35 +40,35 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@babel/runtime": "^7.27.1",
-    "@dr.pogodin/js-utils": "^0.0.18",
-    "@types/lodash": "^4.17.16",
+    "@babel/runtime": "^7.27.6",
+    "@dr.pogodin/js-utils": "^0.1.0",
+    "@types/lodash": "^4.17.20",
     "lodash": "^4.17.21",
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@babel/cli": "^7.27.2",
-    "@babel/core": "^7.27.1",
-    "@babel/node": "^7.27.1",
-    "@babel/plugin-transform-runtime": "^7.27.1",
-    "@babel/preset-env": "^7.27.2",
+    "@babel/cli": "^7.28.0",
+    "@babel/core": "^7.28.0",
+    "@babel/node": "^7.28.0",
+    "@babel/plugin-transform-runtime": "^7.28.0",
+    "@babel/preset-env": "^7.28.0",
     "@babel/preset-react": "^7.27.1",
     "@babel/preset-typescript": "^7.27.1",
-    "@dr.pogodin/eslint-configs": "^0.0.6",
+    "@dr.pogodin/eslint-configs": "^0.0.9",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
-    "@tsconfig/recommended": "^1.0.8",
-    "@types/jest": "^29.5.14",
+    "@tsconfig/recommended": "^1.0.10",
+    "@types/jest": "^30.0.0",
     "@types/pretty": "^2.0.3",
-    "@types/react": "^19.1.3",
-    "@types/react-dom": "^19.1.3",
-    "babel-jest": "^29.7.0",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "babel-jest": "^30.0.4",
     "babel-plugin-module-resolver": "^5.0.2",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
+    "jest": "^30.0.4",
+    "jest-environment-jsdom": "^30.0.4",
     "mockdate": "^3.0.5",
     "rimraf": "^6.0.1",
-    "tstyche": "^3.5.0",
+    "tstyche": "^4.3.0",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {

package/tstyche.config.json

@@ -1,6 +1,6 @@
 {
-  "testFileMatch": [
-    "__tests__/**/*.ts",
-    "__tests__/**/*.tsx"
-  ]
+  "$schema": "https://tstyche.org/schemas/config.json",
+  "checkSuppressedErrors": true,
+  "checkSourceFiles": false,
+  "testFileMatch": ["__tests__/**/*.{ts,tsx}"]
 }