@dr.pogodin/react-global-state 0.20.1 → 0.21.1

package/build/cjs/useAsyncCollection.js

@@ -1,283 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = void 0;
-var _react = require("react");
-var _uuid = require("uuid");
-var _GlobalStateProvider = require("./GlobalStateProvider");
-var _useAsyncData = require("./useAsyncData");
-var _useGlobalState = _interopRequireDefault(require("./useGlobalState"));
-var _utils = require("./utils");
-/**
- * Loads and uses item(s) in an async collection.
- */
-
-/**
- * GarbageCollector: the piece of logic executed on mounting of
- * an useAsyncCollection() hook, and on update of hook params, to update
- * the state according to the new param values. It increments by 1 `numRefs`
- * counters for the requested collection items.
- */
-function gcOnWithhold(ids, path, gs) {
-  const collection = {
-    ...gs.get(path)
-  };
-  for (const id of ids) {
-    let envelope = collection[id];
-    if (envelope) envelope = {
-      ...envelope,
-      numRefs: 1 + envelope.numRefs
-    };else envelope = (0, _useAsyncData.newAsyncDataEnvelope)(null, {
-      numRefs: 1
-    });
-    collection[id] = envelope;
-  }
-  gs.set(path, collection);
-}
-function idsToStringSet(ids) {
-  const res = new Set();
-  for (const id of ids) {
-    res.add(id.toString());
-  }
-  return res;
-}
-
-/**
- * GarbageCollector: the piece of logic executed on un-mounting of
- * an useAsyncCollection() hook, and on update of hook params, to clean-up
- * after the previous param values. It decrements by 1 `numRefs` counters
- * for previously requested collection items, and also drops from the state
- * stale records.
- */
-function gcOnRelease(ids, path, gs, gcAge) {
-  const entries = Object.entries(gs.get(path));
-  const now = Date.now();
-  const idSet = idsToStringSet(ids);
-  const collection = {};
-  for (const [id, envelope] of entries) {
-    if (envelope) {
-      const toBeReleased = idSet.has(id);
-      let {
-        numRefs
-      } = envelope;
-      if (toBeReleased) --numRefs;
-      if (gcAge > now - envelope.timestamp || numRefs > 0) {
-        collection[id] = toBeReleased ? {
-          ...envelope,
-          numRefs
-        } : envelope;
-      } else if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
-        // eslint-disable-next-line no-console
-        console.log(`useAsyncCollection(): Garbage collected at the path "${path}", ID = ${id}`);
-      }
-    }
-  }
-  gs.set(path, collection);
-}
-function normalizeIds(idOrIds) {
-  if (Array.isArray(idOrIds)) {
-    // 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;
-  }
-  return [idOrIds];
-}
-
-/**
- * Resolves and stores at the given `path` of the global state elements of
- * an asynchronous data collection.
- */
-
-// TODO: This is largely similar to useAsyncData() logic, just more generic.
-// 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, options = {}) {
-  const ids = normalizeIds(idOrIds);
-  const maxage = options.maxage ?? _useAsyncData.DEFAULT_MAXAGE;
-  const refreshAge = options.refreshAge ?? maxage;
-  const garbageCollectAge = options.garbageCollectAge ?? maxage;
-  const globalState = (0, _GlobalStateProvider.getGlobalState)();
-
-  // Server-side logic.
-  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);
-
-    // TODO: Violation of rules of hooks is fine here,
-    // but perhaps it can be refactored to avoid the need for it.
-    (0, _react.useEffect)(() => {
-      // eslint-disable-line react-hooks/rules-of-hooks
-      if (!disabled) gcOnWithhold(ids, path, globalState);
-      return () => {
-        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
-    }, [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.
-
-    // Data loading and refreshing.
-    (0, _react.useEffect)(() => {
-      // eslint-disable-line react-hooks/rules-of-hooks
-      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, {});
-  const ref = (0, _react.useRef)(null);
-  ref.current ??= {
-    globalState,
-    ids,
-    loader,
-    path
-  };
-  (0, _react.useEffect)(() => {
-    ref.current = {
-      globalState,
-      ids,
-      loader,
-      path
-    };
-  }, [globalState, ids, loader, path]);
-  const [stable] = (0, _react.useState)(() => {
-    const reload = async customLoader => {
-      const rc = ref.current;
-      if (!rc) throw Error('Internal error');
-      const localLoader = customLoader ?? rc.loader;
-
-      // TODO: Revise - not sure all related typing is 100% correct,
-      // thus let's keep this runtime assertion.
-      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-      if (!localLoader || !rc.globalState || !rc.ids) {
-        throw Error('Internal error');
-      }
-      for (const id of rc.ids) {
-        const itemPath = rc.path ? `${rc.path}.${id}` : `${id}`;
-        const promiseOrVoid = (0, _useAsyncData.load)(itemPath,
-        // TODO: Revise! Most probably we don't have fully correct loader
-        // typing, as it may return either promise or value, and those two
-        // cases call for different runtime behavior, which in turns only
-        // happens if the outer function on the next line matches the same
-        // async / sync signature.
-        // eslint-disable-next-line @typescript-eslint/promise-function-async
-        (oldData, meta) => localLoader(id, oldData, meta), rc.globalState);
-        if (promiseOrVoid instanceof Promise) await promiseOrVoid;
-      }
-    };
-
-    // TODO: Revise! Most probably we don't have fully correct loader
-    // typing, as it may return either promise or value, and those two
-    // cases call for different runtime behavior, which in turns only
-    // happens if the outer function on the next line matches the same
-    // async / sync signature.
-    // eslint-disable-next-line @typescript-eslint/promise-function-async
-    const reloadSingle = customLoader => reload(
-    // TODO: Revise! Most probably we don't have fully correct loader
-    // typing, as it may return either promise or value, and those two
-    // cases call for different runtime behavior, which in turns only
-    // 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 && ((id, ...args) => customLoader(...args)));
-    const setSingle = data => {
-      void reload(() => data);
-    };
-    return {
-      reload,
-      reloadSingle,
-      setSingle
-    };
-  });
-  if (!Array.isArray(idOrIds)) {
-    // TODO: Revise related typings!
-    const e = localState[idOrIds];
-    const timestamp = e?.timestamp ?? 0;
-    return {
-      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,
-      loading: !!e?.operationId,
-      reload: stable.reloadSingle,
-      set: stable.setSingle,
-      timestamp
-    };
-  }
-  const res = {
-    items: {},
-    loading: false,
-    reload: stable.reload,
-    timestamp: Number.MAX_VALUE
-  };
-  for (const id of ids) {
-    // TODO: Revise related typing. Should `localState` have a more specific type?
-    const e = localState[id];
-    const loading = !!e?.operationId;
-    const timestamp = e?.timestamp ?? 0;
-    res.items[id] = {
-      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,
-      loading,
-      timestamp
-    };
-    res.loading ||= loading;
-    if (res.timestamp > timestamp) res.timestamp = timestamp;
-  }
-  return res;
-}
-var _default = exports.default = useAsyncCollection; // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
-//# sourceMappingURL=useAsyncCollection.js.map

package/build/cjs/useAsyncCollection.js.map

@@ -1 +0,0 @@
-{"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","useAsyncCollection","loader","options","maxage","DEFAULT_MAXAGE","refreshAge","garbageCollectAge","globalState","getGlobalState","ssrContext","disabled","noSSR","operationId","uuid","itemPath","state","initialValue","promiseOrVoid","load","args","data","Promise","pending","push","idsHash","hash","useEffect","state2","deps","hasChangedDependencies","startsWith","dropDependencies","old","localState","useGlobalState","ref","useRef","current","stable","useState","reload","customLoader","rc","Error","localLoader","oldData","meta","reloadSingle","setSingle","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, useState } 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> = (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 CurrentT<DataT, IdT extends number | string> = {\n  globalState: GlobalState<unknown>;\n  ids: IdT[];\n  loader: AsyncCollectionLoaderT<DataT, IdT>;\n  path: null | string | undefined;\n};\n\ntype StableT<DataT, IdT extends number | string> = {\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadSingle: AsyncDataReloaderT<DataT>;\n  setSingle: (data: DataT | null) => void;\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 * 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  // 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  const ref = useRef<CurrentT<DataT, IdT>>(null);\n\n  ref.current ??= {\n    globalState,\n    ids,\n    loader,\n    path,\n  };\n\n  useEffect(() => {\n    ref.current = {\n      globalState,\n      ids,\n      loader,\n      path,\n    };\n  }, [globalState, ids, loader, path]);\n\n  const [stable] = useState<StableT<DataT, IdT>>(() => {\n    const reload = async (\n      customLoader?: AsyncCollectionLoaderT<DataT, IdT>,\n    ) => {\n      const rc = ref.current;\n      if (!rc) throw Error('Internal error');\n\n      const localLoader = customLoader ?? rc.loader;\n\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 || !rc.globalState || !rc.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of rc.ids) {\n        const itemPath = rc.path ? `${rc.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          rc.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n\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    const reloadSingle: AsyncDataReloaderT<DataT> = (customLoader) => 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    const setSingle = (data: DataT | null) => {\n      void reload(() => data);\n    };\n\n    return { reload, reloadSingle, setSingle };\n  });\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: stable.reloadSingle,\n      set: stable.setSingle,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: stable.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;;AA8EA;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;;AA+DA;AACA;AACA;AACA;AACA,SAASQ,kBAAkBA,CAIzBR,OAAoB,EACpB/B,IAA+B,EAC/BwC,MAA0C,EAC1CC,OAA6B,GAAG,CAAC,CAAC,EAC4B;EAC9D,MAAM1C,GAAG,GAAG+B,YAAY,CAACC,OAAO,CAAC;EACjC,MAAMW,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,MAAMI,WAAW,GAAG,IAAAC,mCAAc,EAAC,CAAC;;EAEpC;EACA,IAAID,WAAW,CAACE,UAAU,EAAE;IAC1B,IAAI,CAACP,OAAO,CAACQ,QAAQ,IAAI,CAACR,OAAO,CAACS,KAAK,EAAE;MACvC,MAAMC,WAAyB,GAAG,IAAI,IAAAC,QAAI,EAAC,CAAC,EAAE;MAC9C,KAAK,MAAMhD,EAAE,IAAIL,GAAG,EAAE;QACpB,MAAMsD,QAAQ,GAAGrD,IAAI,GAAG,GAAGA,IAAI,IAAII,EAAE,EAAE,GAAG,GAAGA,EAAE,EAAE;QACjD,MAAMkD,KAAK,GAAGR,WAAW,CAAC3C,GAAG,CAC3BkD,QAAQ,EACR;UACEE,YAAY,EAAE,IAAAhD,kCAAoB,EAAQ;QAC5C,CACF,CAAC;QACD,IAAI,CAAC+C,KAAK,CAAC/B,SAAS,IAAI,CAAC+B,KAAK,CAACH,WAAW,EAAE;UAC1C,MAAMK,aAAa,GAAG,IAAAC,kBAAI,EACxBJ,QAAQ,EACR,CAAC,GAAGK,IAAI,KACkClB,MAAM,CAACpC,EAAE,EAAE,GAAGsD,IAAI,CAAC,EAC7DZ,WAAW,EACX;YACEa,IAAI,EAAEL,KAAK,CAACK,IAAI;YAChBpC,SAAS,EAAE+B,KAAK,CAAC/B;UACnB,CAAC,EACD4B,WACF,CAAC;UAED,IAAIK,aAAa,YAAYI,OAAO,EAAE;YACpCd,WAAW,CAACE,UAAU,CAACa,OAAO,CAACC,IAAI,CAACN,aAAa,CAAC;UACpD;QACF;MACF;IACF;;IAEF;EACA,CAAC,MAAM;IACL,MAAM;MAAEP;IAAS,CAAC,GAAGR,OAAO;;IAE5B;;IAEA,MAAMsB,OAAO,GAAG,IAAAC,WAAI,EAACjE,GAAG,CAAC;;IAEzB;IACA;IACA,IAAAkE,gBAAS,EAAC,MAAM;MAAE;MAChB,IAAI,CAAChB,QAAQ,EAAEnD,YAAY,CAACC,GAAG,EAAEC,IAAI,EAAE8C,WAAW,CAAC;MACnD,OAAO,MAAM;QACX,IAAI,CAACG,QAAQ,EAAEnC,WAAW,CAACf,GAAG,EAAEC,IAAI,EAAE8C,WAAW,EAAED,iBAAiB,CAAC;MACvE,CAAC;;MAED;MACA;MACA;IACF,CAAC,EAAE,CACDI,QAAQ,EACRJ,iBAAiB,EACjBC,WAAW,EACXiB,OAAO,EACP/D,IAAI,CACL,CAAC;;IAEF;IACA;;IAEA;IACA,IAAAiE,gBAAS,EAAC,MAAM;MAAE;MAChB,IAAI,CAAChB,QAAQ,EAAE;QACb,KAAK,CAAC,YAAY;UAChB,KAAK,MAAM7C,EAAE,IAAIL,GAAG,EAAE;YACpB,MAAMsD,QAAQ,GAAGrD,IAAI,GAAG,GAAGA,IAAI,IAAII,EAAE,EAAE,GAAG,GAAGA,EAAE,EAAE;YAGjD,MAAM8D,MAAY,GAAGpB,WAAW,CAAC3C,GAAG,CAAekD,QAAQ,CAAC;YAE5D,MAAM;cAAEc;YAAK,CAAC,GAAG1B,OAAO;YACxB,IACG0B,IAAI,IAAIrB,WAAW,CAACsB,sBAAsB,CAACf,QAAQ,EAAEc,IAAI,CAAC,IAEzDvB,UAAU,GAAGzB,IAAI,CAACD,GAAG,CAAC,CAAC,IAAIgD,MAAM,EAAE3C,SAAS,IAAI,CAAC,CAAC,KAC9C,CAAC2C,MAAM,EAAEf,WAAW,IAAIe,MAAM,CAACf,WAAW,CAACkB,UAAU,CAAC,GAAG,CAAC,CAC/D,EACD;cACA,IAAI,CAACF,IAAI,EAAErB,WAAW,CAACwB,gBAAgB,CAACjB,QAAQ,CAAC;cACjD,MAAM,IAAAI,kBAAI,EACRJ,QAAQ;cACR;cACA;cACA;cACA;cACA,CAACkB,GAAG,EAAE,GAAGb,IAAI,KAAKlB,MAAM,CAACpC,EAAE,EAAEmE,GAAG,EAAW,GAAGb,IAAI,CAAC,EACnDZ,WAAW,EACX;gBACEa,IAAI,EAAEO,MAAM,EAAEP,IAAI;gBAClBpC,SAAS,EAAE2C,MAAM,EAAE3C,SAAS,IAAI;cAClC,CACF,CAAC;YACH;UACF;QACF,CAAC,EAAE,CAAC;MACN;IACF,CAAC,CAAC;EACJ;EAEA,MAAM,CAACiD,UAAU,CAAC,GAAG,IAAAC,uBAAc,EAEjCzE,IAAI,EAAE,CAAC,CAAC,CAAC;EAEX,MAAM0E,GAAG,GAAG,IAAAC,aAAM,EAAuB,IAAI,CAAC;EAE9CD,GAAG,CAACE,OAAO,KAAK;IACd9B,WAAW;IACX/C,GAAG;IACHyC,MAAM;IACNxC;EACF,CAAC;EAED,IAAAiE,gBAAS,EAAC,MAAM;IACdS,GAAG,CAACE,OAAO,GAAG;MACZ9B,WAAW;MACX/C,GAAG;MACHyC,MAAM;MACNxC;IACF,CAAC;EACH,CAAC,EAAE,CAAC8C,WAAW,EAAE/C,GAAG,EAAEyC,MAAM,EAAExC,IAAI,CAAC,CAAC;EAEpC,MAAM,CAAC6E,MAAM,CAAC,GAAG,IAAAC,eAAQ,EAAsB,MAAM;IACnD,MAAMC,MAAM,GAAG,MACbC,YAAiD,IAC9C;MACH,MAAMC,EAAE,GAAGP,GAAG,CAACE,OAAO;MACtB,IAAI,CAACK,EAAE,EAAE,MAAMC,KAAK,CAAC,gBAAgB,CAAC;MAEtC,MAAMC,WAAW,GAAGH,YAAY,IAAIC,EAAE,CAACzC,MAAM;;MAE7C;MACA;MACA;MACA,IAAI,CAAC2C,WAAW,IAAI,CAACF,EAAE,CAACnC,WAAW,IAAI,CAACmC,EAAE,CAAClF,GAAG,EAAE;QAC9C,MAAMmF,KAAK,CAAC,gBAAgB,CAAC;MAC/B;MAEA,KAAK,MAAM9E,EAAE,IAAI6E,EAAE,CAAClF,GAAG,EAAE;QACvB,MAAMsD,QAAQ,GAAG4B,EAAE,CAACjF,IAAI,GAAG,GAAGiF,EAAE,CAACjF,IAAI,IAAII,EAAE,EAAE,GAAG,GAAGA,EAAE,EAAE;QAEvD,MAAMoD,aAAa,GAAG,IAAAC,kBAAI,EACxBJ,QAAQ;QACR;QACA;QACA;QACA;QACA;QACA;QACA,CAAC+B,OAAqB,EAAEC,IAAI,KAAKF,WAAW,CAAC/E,EAAE,EAAEgF,OAAO,EAAEC,IAAI,CAAC,EAC/DJ,EAAE,CAACnC,WACL,CAAC;QAED,IAAIU,aAAa,YAAYI,OAAO,EAAE,MAAMJ,aAAa;MAC3D;IACF,CAAC;;IAED;IACA;IACA;IACA;IACA;IACA;IACA,MAAM8B,YAAuC,GAAIN,YAAY,IAAKD,MAAM;IACtE;IACA;IACA;IACA;IACA;IACA;IACAC,YAAY,KAAK,CAAC5E,EAAE,EAAE,GAAGsD,IAAI,KAAKsB,YAAY,CAAC,GAAGtB,IAAI,CAAC,CACzD,CAAC;IAED,MAAM6B,SAAS,GAAI5B,IAAkB,IAAK;MACxC,KAAKoB,MAAM,CAAC,MAAMpB,IAAI,CAAC;IACzB,CAAC;IAED,OAAO;MAAEoB,MAAM;MAAEO,YAAY;MAAEC;IAAU,CAAC;EAC5C,CAAC,CAAC;EAEF,IAAI,CAACvD,KAAK,CAACC,OAAO,CAACF,OAAO,CAAC,EAAE;IAC3B;IACA,MAAMyD,CAAC,GAAGhB,UAAU,CAACzC,OAAO,CAAW;IACvC,MAAMR,SAAS,GAAGiE,CAAC,EAAEjE,SAAS,IAAI,CAAC;IACnC,OAAO;MACLoC,IAAI,EAAEjB,MAAM,GAAGvB,IAAI,CAACD,GAAG,CAAC,CAAC,GAAGK,SAAS,GAAG,IAAI,GAAGiE,CAAC,EAAE7B,IAAI,IAAI,IAAI;MAC9D8B,OAAO,EAAE,CAAC,CAACD,CAAC,EAAErC,WAAW;MACzB4B,MAAM,EAAEF,MAAM,CAACS,YAAY;MAC3B9E,GAAG,EAAEqE,MAAM,CAACU,SAAS;MACrBhE;IACF,CAAC;EACH;EAEA,MAAMb,GAAuC,GAAG;IAC9CgF,KAAK,EAAE,CAAC,CAAwC;IAChDD,OAAO,EAAE,KAAK;IACdV,MAAM,EAAEF,MAAM,CAACE,MAAM;IACrBxD,SAAS,EAAEoE,MAAM,CAACC;EACpB,CAAC;EAED,KAAK,MAAMxF,EAAE,IAAIL,GAAG,EAAE;IACpB;IACA,MAAMyF,CAAC,GAAGhB,UAAU,CAACpE,EAAE,CAAW;IAClC,MAAMqF,OAAO,GAAG,CAAC,CAACD,CAAC,EAAErC,WAAW;IAChC,MAAM5B,SAAS,GAAGiE,CAAC,EAAEjE,SAAS,IAAI,CAAC;IAEnCb,GAAG,CAACgF,KAAK,CAACtF,EAAE,CAAC,GAAG;MACduD,IAAI,EAAEjB,MAAM,GAAGvB,IAAI,CAACD,GAAG,CAAC,CAAC,GAAGK,SAAS,GAAG,IAAI,GAAGiE,CAAC,EAAE7B,IAAI,IAAI,IAAI;MAC9D8B,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,GAEcxD,kBAAkB,EAEjC","ignoreList":[]}

package/build/cjs/useAsyncData.js

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