@dr.pogodin/react-global-state 0.18.0 → 0.18.1

package/build/common/GlobalStateProvider.js

@@ -20,14 +20,7 @@ const Context = /*#__PURE__*/(0, _react.createContext)(null);
  * @return
  */
 function getGlobalState() {
-  // Here Rules of Hooks are violated because "getGlobalState()" does not follow
-  // convention that hook names should start with use... This is intentional in
-  // our case, as getGlobalState() hook is intended for advance scenarious,
-  // while the normal interaction with the global state should happen via
-  // another hook, useGlobalState().
-  /* eslint-disable react-hooks/rules-of-hooks */
   const globalState = (0, _react.use)(Context);
-  /* eslint-enable react-hooks/rules-of-hooks */
   if (!globalState) throw new Error('Missing GlobalStateProvider');
   return globalState;
 }
@@ -72,24 +65,23 @@ const GlobalStateProvider = ({
   children,
   ...rest
 }) => {
-  const state = (0, _react.useRef)(undefined);
-  if (!state.current) {
-    // NOTE: The last part of condition, "&& rest.stateProxy", is needed for
-    // graceful compatibility with JavaScript - if "undefined" stateProxy value
-    // is given, we want to follow the second branch, which creates a new
-    // GlobalState with whatever intiialState given.
-    if ('stateProxy' in rest && rest.stateProxy) {
-      if (rest.stateProxy === true) state.current = getGlobalState();else state.current = rest.stateProxy;
-    } else {
+  const localStateRef = (0, _react.useRef)(undefined);
+  let state;
+  if ('stateProxy' in rest && rest.stateProxy) {
+    localStateRef.current = undefined;
+    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;
+  } else {
+    if (!localStateRef.current) {
       const {
         initialState,
         ssrContext
       } = rest;
-      state.current = new _GlobalState.default((0, _lodash.isFunction)(initialState) ? initialState() : initialState, ssrContext);
+      localStateRef.current = new _GlobalState.default((0, _lodash.isFunction)(initialState) ? initialState() : initialState, ssrContext);
     }
+    state = localStateRef.current;
   }
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(Context, {
-    value: state.current,
+    value: state,
     children: children
   });
 };

package/build/common/GlobalStateProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalStateProvider.js","names":["_lodash","require","_react","_GlobalState","_interopRequireDefault","_jsxRuntime","Context","createContext","getGlobalState","globalState","use","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","rest","state","useRef","undefined","current","stateProxy","initialState","GlobalState","isFunction","jsx","value","_default","exports","default"],"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 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  // Here Rules of Hooks are violated because \"getGlobalState()\" does not follow\n  // convention that hook names should start with use... This is intentional in\n  // our case, as getGlobalState() hook is intended for advance scenarious,\n  // while the normal interaction with the global state should happen via\n  // another hook, useGlobalState().\n  /* eslint-disable react-hooks/rules-of-hooks */\n  const globalState = use(Context);\n  /* eslint-enable react-hooks/rules-of-hooks */\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>({ children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>) => {\n  const state = useRef<GlobalState<StateT, SsrContextT>>(undefined);\n  if (!state.current) {\n    // NOTE: The last part of condition, \"&& rest.stateProxy\", is needed for\n    // graceful compatibility with JavaScript - if \"undefined\" stateProxy value\n    // is given, we want to follow the second branch, which creates a new\n    // GlobalState with whatever intiialState given.\n    if ('stateProxy' in rest && rest.stateProxy) {\n      if (rest.stateProxy === true) state.current = getGlobalState();\n      else state.current = rest.stateProxy;\n    } else {\n      const { initialState, ssrContext } = rest as NewStateProps<StateT, SsrContextT>;\n\n      state.current = new GlobalState<StateT, SsrContextT>(\n        isFunction(initialState) ? initialState() : initialState,\n        ssrContext,\n      );\n    }\n  }\n  return <Context value={state.current}>{children}</Context>;\n};\n\nexport default GlobalStateProvider;\n"],"mappings":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,MAAA,GAAAD,OAAA;AAOA,IAAAE,YAAA,GAAAC,sBAAA,CAAAH,OAAA;AAAwC,IAAAI,WAAA,GAAAJ,OAAA;AAKxC,MAAMK,OAAO,gBAAG,IAAAC,oBAAa,EAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAAA,EAGQ;EACpC;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAG,IAAAC,UAAG,EAACJ,OAAO,CAAC;EAChC;EACA,IAAI,CAACG,WAAW,EAAE,MAAM,IAAIE,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOF,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,aAAaA,CAG3BC,sBAAsB,GAAG,IAAI,EACJ;EACzB,MAAM;IAAEC;EAAW,CAAC,GAAGN,cAAc,CAAoC,CAAC;EAC1E,IAAI,CAACM,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,CAG1B;EAAEC,QAAQ;EAAE,GAAGC;AAAoD,CAAC,KAAK;EACzE,MAAMC,KAAK,GAAG,IAAAC,aAAM,EAAmCC,SAAS,CAAC;EACjE,IAAI,CAACF,KAAK,CAACG,OAAO,EAAE;IAClB;IACA;IACA;IACA;IACA,IAAI,YAAY,IAAIJ,IAAI,IAAIA,IAAI,CAACK,UAAU,EAAE;MAC3C,IAAIL,IAAI,CAACK,UAAU,KAAK,IAAI,EAAEJ,KAAK,CAACG,OAAO,GAAGb,cAAc,CAAC,CAAC,CAAC,KAC1DU,KAAK,CAACG,OAAO,GAAGJ,IAAI,CAACK,UAAU;IACtC,CAAC,MAAM;MACL,MAAM;QAAEC,YAAY;QAAET;MAAW,CAAC,GAAGG,IAA0C;MAE/EC,KAAK,CAACG,OAAO,GAAG,IAAIG,oBAAW,CAC7B,IAAAC,kBAAU,EAACF,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDT,UACF,CAAC;IACH;EACF;EACA,oBAAO,IAAAT,WAAA,CAAAqB,GAAA,EAACpB,OAAO;IAACqB,KAAK,EAAET,KAAK,CAACG,OAAQ;IAAAL,QAAA,EAAEA;EAAQ,CAAU,CAAC;AAC5D,CAAC;AAAC,IAAAY,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEaf,mBAAmB","ignoreList":[]}
+{"version":3,"file":"GlobalStateProvider.js","names":["_lodash","require","_react","_GlobalState","_interopRequireDefault","_jsxRuntime","Context","createContext","getGlobalState","globalState","use","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","rest","localStateRef","useRef","undefined","state","stateProxy","current","initialState","GlobalState","isFunction","jsx","value","_default","exports","default"],"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 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  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>({ children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>) => {\n  type GST = GlobalState<StateT, SsrContextT>;\n  const localStateRef = useRef<GST>(undefined);\n  let state: GST;\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 { initialState, ssrContext } = 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,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,MAAA,GAAAD,OAAA;AAOA,IAAAE,YAAA,GAAAC,sBAAA,CAAAH,OAAA;AAAwC,IAAAI,WAAA,GAAAJ,OAAA;AAKxC,MAAMK,OAAO,gBAAG,IAAAC,oBAAa,EAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAAA,EAGQ;EACpC,MAAMC,WAAW,GAAG,IAAAC,UAAG,EAACJ,OAAO,CAAC;EAChC,IAAI,CAACG,WAAW,EAAE,MAAM,IAAIE,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOF,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,aAAaA,CAG3BC,sBAAsB,GAAG,IAAI,EACJ;EACzB,MAAM;IAAEC;EAAW,CAAC,GAAGN,cAAc,CAAoC,CAAC;EAC1E,IAAI,CAACM,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,CAG1B;EAAEC,QAAQ;EAAE,GAAGC;AAAoD,CAAC,KAAK;EAEzE,MAAMC,aAAa,GAAG,IAAAC,aAAM,EAAMC,SAAS,CAAC;EAC5C,IAAIC,KAAU;EACd,IAAI,YAAY,IAAIJ,IAAI,IAAIA,IAAI,CAACK,UAAU,EAAE;IAC3CJ,aAAa,CAACK,OAAO,GAAGH,SAAS;IACjCC,KAAK,GAAGJ,IAAI,CAACK,UAAU,KAAK,IAAI,GAAGd,cAAc,CAAC,CAAC,GAAGS,IAAI,CAACK,UAAU;EACvE,CAAC,MAAM;IACL,IAAI,CAACJ,aAAa,CAACK,OAAO,EAAE;MAC1B,MAAM;QAAEC,YAAY;QAAEV;MAAW,CAAC,GAAGG,IAA0C;MAC/EC,aAAa,CAACK,OAAO,GAAG,IAAIE,oBAAW,CACrC,IAAAC,kBAAU,EAACF,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDV,UACF,CAAC;IACH;IACAO,KAAK,GAAGH,aAAa,CAACK,OAAO;EAC/B;EACA,oBAAO,IAAAlB,WAAA,CAAAsB,GAAA,EAACrB,OAAO;IAACsB,KAAK,EAAEP,KAAM;IAAAL,QAAA,EAAEA;EAAQ,CAAU,CAAC;AACpD,CAAC;AAAC,IAAAa,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEahB,mBAAmB","ignoreList":[]}

package/build/common/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","i","length","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","useHeap","loader","ref","useRef","undefined","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","load","oldData","meta","reloadSingle","args","useAsyncCollection","options","maxage","DEFAULT_MAXAGE","refreshAge","garbageCollectAge","getGlobalState","ssrContext","noSSR","operationId","uuid","state","initialValue","pending","push","data","idsHash","hash","useEffect","state2","deps","hasChangedDependencies","charAt","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 GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  DEFAULT_MAXAGE,\n  load,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  hash,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n  DataT = unknown,\n  IdT extends number | string = number | string,\n> = { [id in IdT]?: AsyncDataEnvelopeT<DataT> };\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> =\n  (id: IdT, oldData: null | DataT, meta: {\n    isAborted: () => boolean;\n    oldDataTimestamp: number;\n    setAbortCallback: (cb: () => void) => void;\n  }) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void>;\n\ntype CollectionItemT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  timestamp: number;\n};\n\nexport type UseAsyncCollectionResT<\n  DataT,\n  IdT extends number | string = number | string,\n> = {\n  items: {\n    [id in IdT]: CollectionItemT<DataT>;\n  }\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype HeapT<\n  DataT,\n  IdT extends number | string,\n> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState: GlobalState<unknown>;\n  ids: IdT[];\n  path: null | string | undefined;\n  loader: AsyncCollectionLoaderT<DataT, IdT>;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadSingle: AsyncDataReloaderT<DataT>;\n};\n\n/**\n * GarbageCollector: the piece of logic executed on mounting of\n * an useAsyncCollection() hook, and on update of hook params, to update\n * the state according to the new param values. It increments by 1 `numRefs`\n * counters for the requested collection items.\n */\nfunction gcOnWithhold<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n) {\n  const collection = { ...gs.get<ForceT, AsyncCollectionT>(path) };\n\n  for (let i = 0; i < ids.length; ++i) {\n    const id = ids[i]!;\n    let envelope = collection[id];\n    if (envelope) envelope = { ...envelope, numRefs: 1 + envelope.numRefs };\n    else envelope = newAsyncDataEnvelope<unknown>(null, { numRefs: 1 });\n    collection[id] = envelope;\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction idsToStringSet<IdT extends number | string>(ids: IdT[]): Set<string> {\n  const res = new Set<string>();\n  for (let i = 0; i < ids.length; ++i) {\n    res.add(ids[i]!.toString());\n  }\n  return res;\n}\n\n/**\n * GarbageCollector: the piece of logic executed on un-mounting of\n * an useAsyncCollection() hook, and on update of hook params, to clean-up\n * after the previous param values. It decrements by 1 `numRefs` counters\n * for previously requested collection items, and also drops from the state\n * stale records.\n */\nfunction gcOnRelease<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n  gcAge: number,\n) {\n  type EnvelopeT = AsyncDataEnvelopeT<unknown>;\n\n  const entries = Object.entries<EnvelopeT | undefined>(\n    gs.get<ForceT, AsyncCollectionT>(path),\n  );\n\n  const now = Date.now();\n  const idSet = idsToStringSet(ids);\n  const collection: AsyncCollectionT = {};\n  for (let i = 0; i < entries.length; ++i) {\n    const [id, envelope] = entries[i]!;\n\n    if (envelope) {\n      const toBeReleased = idSet.has(id);\n\n      let { numRefs } = envelope;\n      if (toBeReleased) --numRefs;\n\n      if (gcAge > now - envelope.timestamp || numRefs > 0) {\n        collection[id as IdT] = toBeReleased\n          ? { ...envelope, numRefs }\n          : envelope;\n      } else if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        // eslint-disable-next-line no-console\n        console.log(\n          `useAsyncCollection(): Garbage collected at the path \"${\n            path}\", ID = ${id}`,\n        );\n      }\n    }\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction normalizeIds<IdT extends number | string>(\n  idOrIds: IdT | IdT[],\n): IdT[] {\n  if (Array.isArray(idOrIds)) {\n    const res = [...idOrIds];\n    res.sort();\n    return res;\n  }\n  return [idOrIds];\n}\n\n/**\n * Inits/updates, and returns the heap.\n */\nfunction useHeap<\n  DataT,\n  IdT extends number | string,\n>(\n  ids: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  gs: GlobalState<unknown>,\n): HeapT<DataT, IdT> {\n  const ref = useRef<HeapT<DataT, IdT>>(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      if (!localLoader || !heap2.globalState || !heap2.ids) {\n        throw Error('Internal error');\n      }\n\n      for (let i = 0; i < heap2.ids.length; ++i) {\n        const id = heap2.ids[i]!;\n        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;\n\n        // eslint-disable-next-line no-await-in-loop\n        await load(\n          itemPath,\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap2.globalState,\n        );\n      }\n    };\n    heap = {\n      globalState: gs,\n      ids,\n      path,\n      loader,\n      reload,\n      reloadSingle: (customLoader) => ref.current!.reload(\n        customLoader && ((id, ...args) => customLoader(...args)),\n      ),\n    };\n    ref.current = heap;\n  }\n\n  return heap;\n}\n\n/**\n * Resolves and stores at the given `path` of the global state elements of\n * an asynchronous data collection.\n */\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT,\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT,\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\n// TODO: This is largely similar to useAsyncData() logic, just more generic.\n// Perhaps, a bunch of logic blocks can be split into stand-alone functions,\n// and reused in both hooks.\nfunction useAsyncCollection<\n  DataT,\n  IdT extends number | string,\n>(\n  idOrIds: IdT | IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT> {\n  const ids = normalizeIds(idOrIds);\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  const globalState = getGlobalState();\n\n  const heap = useHeap(ids, path, loader, globalState);\n\n  // Server-side logic.\n  if (globalState.ssrContext && !options.noSSR) {\n    const operationId: OperationIdT = `S${uuid()}`;\n    for (let i = 0; i < ids.length; ++i) {\n      const id = ids[i]!;\n      const itemPath = path ? `${path}.${id}` : `${id}`;\n      const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(itemPath, {\n        initialValue: newAsyncDataEnvelope<DataT>(),\n      });\n      if (!state.timestamp && !state.operationId) {\n        globalState.ssrContext.pending.push(\n          load(itemPath, (...args) => loader(id, ...args), globalState, {\n            data: state.data,\n            timestamp: state.timestamp,\n          }, operationId),\n        );\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    // Reference-counting & garbage collection.\n\n    const idsHash = hash(ids);\n\n    // TODO: Violation of rules of hooks is fine here,\n    // but perhaps it can be refactored to avoid the need for it.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      gcOnWithhold(ids, path, globalState);\n      return () => gcOnRelease(ids, path, globalState, garbageCollectAge);\n\n      // `ids` are represented in the dependencies array by `idsHash` value,\n      // as useEffect() hook requires a constant size of dependencies array.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n      garbageCollectAge,\n      globalState,\n      idsHash,\n      path,\n    ]);\n\n    // NOTE: a bunch of Rules of Hooks ignored belows because in our very\n    // special case the otherwise wrong behavior is actually what we need.\n\n    // Data loading and refreshing.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      (async () => {\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i]!;\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n\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.charAt(0) === 'S')\n            )\n          ) {\n            if (!deps) globalState.dropDependencies(itemPath);\n            // eslint-disable-next-line no-await-in-loop\n            await load(\n              itemPath,\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, { [id: string]: AsyncDataEnvelopeT<DataT> }\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    const e = localState[idOrIds];\n    const timestamp = e?.timestamp ?? 0;\n    return {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading: !!e?.operationId,\n      reload: heap.reloadSingle!,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: heap.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (let i = 0; i < ids.length; ++i) {\n    const id = ids[i]!;\n    const e = localState[id];\n    const loading = !!e?.operationId;\n    const timestamp = e?.timestamp ?? 0;\n\n    res.items[id] = {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading,\n      timestamp,\n    };\n    res.loading ||= loading;\n    if (res.timestamp > timestamp) res.timestamp = timestamp;\n  }\n\n  return res;\n}\n\nexport default useAsyncCollection;\n\nexport interface UseAsyncCollectionI<StateT> {\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT,\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT,\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT[],\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataT, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useAsyncCollection.js","names":["_react","require","_uuid","_GlobalStateProvider","_useAsyncData","_useGlobalState","_interopRequireDefault","_utils","gcOnWithhold","ids","path","gs","collection","get","i","length","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","useHeap","loader","ref","useRef","undefined","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","load","oldData","meta","reloadSingle","args","useAsyncCollection","options","maxage","DEFAULT_MAXAGE","refreshAge","garbageCollectAge","getGlobalState","ssrContext","noSSR","operationId","uuid","state","initialValue","pending","push","data","idsHash","hash","useEffect","state2","deps","hasChangedDependencies","charAt","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 GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  DEFAULT_MAXAGE,\n  load,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  hash,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n  DataT = unknown,\n  IdT extends number | string = number | string,\n> = { [id in IdT]?: AsyncDataEnvelopeT<DataT> };\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> =\n  (id: IdT, oldData: null | DataT, meta: {\n    isAborted: () => boolean;\n    oldDataTimestamp: number;\n    setAbortCallback: (cb: () => void) => void;\n  }) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void>;\n\ntype CollectionItemT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  timestamp: number;\n};\n\nexport type UseAsyncCollectionResT<\n  DataT,\n  IdT extends number | string = number | string,\n> = {\n  items: {\n    [id in IdT]: CollectionItemT<DataT>;\n  }\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype HeapT<\n  DataT,\n  IdT extends number | string,\n> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState: GlobalState<unknown>;\n  ids: IdT[];\n  path: null | string | undefined;\n  loader: AsyncCollectionLoaderT<DataT, IdT>;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadSingle: AsyncDataReloaderT<DataT>;\n};\n\n/**\n * GarbageCollector: the piece of logic executed on mounting of\n * an useAsyncCollection() hook, and on update of hook params, to update\n * the state according to the new param values. It increments by 1 `numRefs`\n * counters for the requested collection items.\n */\nfunction gcOnWithhold<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n) {\n  const collection = { ...gs.get<ForceT, AsyncCollectionT>(path) };\n\n  for (let i = 0; i < ids.length; ++i) {\n    const id = ids[i]!;\n    let envelope = collection[id];\n    if (envelope) envelope = { ...envelope, numRefs: 1 + envelope.numRefs };\n    else envelope = newAsyncDataEnvelope<unknown>(null, { numRefs: 1 });\n    collection[id] = envelope;\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction idsToStringSet<IdT extends number | string>(ids: IdT[]): Set<string> {\n  const res = new Set<string>();\n  for (let i = 0; i < ids.length; ++i) {\n    res.add(ids[i]!.toString());\n  }\n  return res;\n}\n\n/**\n * GarbageCollector: the piece of logic executed on un-mounting of\n * an useAsyncCollection() hook, and on update of hook params, to clean-up\n * after the previous param values. It decrements by 1 `numRefs` counters\n * for previously requested collection items, and also drops from the state\n * stale records.\n */\nfunction gcOnRelease<IdT extends number | string>(\n  ids: IdT[],\n  path: null | string | undefined,\n  gs: GlobalState<unknown>,\n  gcAge: number,\n) {\n  type EnvelopeT = AsyncDataEnvelopeT<unknown>;\n\n  const entries = Object.entries<EnvelopeT | undefined>(\n    gs.get<ForceT, AsyncCollectionT>(path),\n  );\n\n  const now = Date.now();\n  const idSet = idsToStringSet(ids);\n  const collection: AsyncCollectionT = {};\n  for (let i = 0; i < entries.length; ++i) {\n    const [id, envelope] = entries[i]!;\n\n    if (envelope) {\n      const toBeReleased = idSet.has(id);\n\n      let { numRefs } = envelope;\n      if (toBeReleased) --numRefs;\n\n      if (gcAge > now - envelope.timestamp || numRefs > 0) {\n        collection[id as IdT] = toBeReleased\n          ? { ...envelope, numRefs }\n          : envelope;\n      } else if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n        // eslint-disable-next-line no-console\n        console.log(\n          `useAsyncCollection(): Garbage collected at the path \"${\n            path}\", ID = ${id}`,\n        );\n      }\n    }\n  }\n\n  gs.set<ForceT, AsyncCollectionT>(path, collection);\n}\n\nfunction normalizeIds<IdT extends number | string>(\n  idOrIds: IdT | IdT[],\n): IdT[] {\n  if (Array.isArray(idOrIds)) {\n    const res = [...idOrIds];\n    res.sort();\n    return res;\n  }\n  return [idOrIds];\n}\n\n/**\n * Inits/updates, and returns the heap.\n */\nfunction useHeap<\n  DataT,\n  IdT extends number | string,\n>(\n  ids: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  gs: GlobalState<unknown>,\n): HeapT<DataT, IdT> {\n  const ref = useRef<HeapT<DataT, IdT>>(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      if (!localLoader || !heap2.globalState || !heap2.ids) {\n        throw Error('Internal error');\n      }\n\n      for (let i = 0; i < heap2.ids.length; ++i) {\n        const id = heap2.ids[i]!;\n        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;\n\n        // eslint-disable-next-line no-await-in-loop\n        await load(\n          itemPath,\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap2.globalState,\n        );\n      }\n    };\n    heap = {\n      globalState: gs,\n      ids,\n      path,\n      loader,\n      reload,\n      reloadSingle: (customLoader) => ref.current!.reload(\n        customLoader && ((id, ...args) => customLoader(...args)),\n      ),\n    };\n    ref.current = heap;\n  }\n\n  return heap;\n}\n\n/**\n * Resolves and stores at the given `path` of the global state elements of\n * an asynchronous data collection.\n */\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT,\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT,\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT | 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.\nfunction useAsyncCollection<\n  DataT,\n  IdT extends number | string,\n>(\n  idOrIds: IdT | IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT> {\n  const ids = normalizeIds(idOrIds);\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  const globalState = getGlobalState();\n\n  const heap = useHeap(ids, path, loader, globalState);\n\n  // Server-side logic.\n  if (globalState.ssrContext && !options.noSSR) {\n    const operationId: OperationIdT = `S${uuid()}`;\n    for (let i = 0; i < ids.length; ++i) {\n      const id = ids[i]!;\n      const itemPath = path ? `${path}.${id}` : `${id}`;\n      const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(itemPath, {\n        initialValue: newAsyncDataEnvelope<DataT>(),\n      });\n      if (!state.timestamp && !state.operationId) {\n        globalState.ssrContext.pending.push(\n          load(itemPath, (...args) => loader(id, ...args), globalState, {\n            data: state.data,\n            timestamp: state.timestamp,\n          }, operationId),\n        );\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    // Reference-counting & garbage collection.\n\n    const idsHash = hash(ids);\n\n    // TODO: Violation of rules of hooks is fine here,\n    // but perhaps it can be refactored to avoid the need for it.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      gcOnWithhold(ids, path, globalState);\n      return () => gcOnRelease(ids, path, globalState, garbageCollectAge);\n\n      // `ids` are represented in the dependencies array by `idsHash` value,\n      // as useEffect() hook requires a constant size of dependencies array.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [\n      garbageCollectAge,\n      globalState,\n      idsHash,\n      path,\n    ]);\n\n    // NOTE: a bunch of Rules of Hooks ignored belows because in our very\n    // special case the otherwise wrong behavior is actually what we need.\n\n    // Data loading and refreshing.\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      (async () => {\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i]!;\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n\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.charAt(0) === 'S')\n            )\n          ) {\n            if (!deps) globalState.dropDependencies(itemPath);\n            // eslint-disable-next-line no-await-in-loop\n            await load(\n              itemPath,\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, { [id: string]: AsyncDataEnvelopeT<DataT> }\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    const e = localState[idOrIds];\n    const timestamp = e?.timestamp ?? 0;\n    return {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading: !!e?.operationId,\n      reload: heap.reloadSingle!,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: heap.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (let i = 0; i < ids.length; ++i) {\n    const id = ids[i]!;\n    const e = localState[id];\n    const loading = !!e?.operationId;\n    const timestamp = e?.timestamp ?? 0;\n\n    res.items[id] = {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading,\n      timestamp,\n    };\n    res.loading ||= loading;\n    if (res.timestamp > timestamp) res.timestamp = timestamp;\n  }\n\n  return res;\n}\n\nexport default useAsyncCollection;\n\nexport interface UseAsyncCollectionI<StateT> {\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT,\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT,\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT[],\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataT, IdT>;\n\n  <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/module/GlobalStateProvider.js

@@ -11,14 +11,7 @@ const Context = /*#__PURE__*/createContext(null);
  * @return
  */
 export function getGlobalState() {
-  // Here Rules of Hooks are violated because "getGlobalState()" does not follow
-  // convention that hook names should start with use... This is intentional in
-  // our case, as getGlobalState() hook is intended for advance scenarious,
-  // while the normal interaction with the global state should happen via
-  // another hook, useGlobalState().
-  /* eslint-disable react-hooks/rules-of-hooks */
   const globalState = use(Context);
-  /* eslint-enable react-hooks/rules-of-hooks */
   if (!globalState) throw new Error('Missing GlobalStateProvider');
   return globalState;
 }
@@ -65,24 +58,23 @@ const GlobalStateProvider = _ref => {
     children,
     ...rest
   } = _ref;
-  const state = useRef(undefined);
-  if (!state.current) {
-    // NOTE: The last part of condition, "&& rest.stateProxy", is needed for
-    // graceful compatibility with JavaScript - if "undefined" stateProxy value
-    // is given, we want to follow the second branch, which creates a new
-    // GlobalState with whatever intiialState given.
-    if ('stateProxy' in rest && rest.stateProxy) {
-      if (rest.stateProxy === true) state.current = getGlobalState();else state.current = rest.stateProxy;
-    } else {
+  const localStateRef = useRef(undefined);
+  let state;
+  if ('stateProxy' in rest && rest.stateProxy) {
+    localStateRef.current = undefined;
+    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;
+  } else {
+    if (!localStateRef.current) {
       const {
         initialState,
         ssrContext
       } = rest;
-      state.current = new GlobalState(isFunction(initialState) ? initialState() : initialState, ssrContext);
+      localStateRef.current = new GlobalState(isFunction(initialState) ? initialState() : initialState, ssrContext);
     }
+    state = localStateRef.current;
   }
   return /*#__PURE__*/_jsx(Context, {
-    value: state.current,
+    value: state,
     children: children
   });
 };

package/build/module/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","state","current","stateProxy","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 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  // Here Rules of Hooks are violated because \"getGlobalState()\" does not follow\n  // convention that hook names should start with use... This is intentional in\n  // our case, as getGlobalState() hook is intended for advance scenarious,\n  // while the normal interaction with the global state should happen via\n  // another hook, useGlobalState().\n  /* eslint-disable react-hooks/rules-of-hooks */\n  const globalState = use(Context);\n  /* eslint-enable react-hooks/rules-of-hooks */\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>({ children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>) => {\n  const state = useRef<GlobalState<StateT, SsrContextT>>(undefined);\n  if (!state.current) {\n    // NOTE: The last part of condition, \"&& rest.stateProxy\", is needed for\n    // graceful compatibility with JavaScript - if \"undefined\" stateProxy value\n    // is given, we want to follow the second branch, which creates a new\n    // GlobalState with whatever intiialState given.\n    if ('stateProxy' in rest && rest.stateProxy) {\n      if (rest.stateProxy === true) state.current = getGlobalState();\n      else state.current = rest.stateProxy;\n    } else {\n      const { initialState, ssrContext } = rest as NewStateProps<StateT, SsrContextT>;\n\n      state.current = new GlobalState<StateT, SsrContextT>(\n        isFunction(initialState) ? initialState() : initialState,\n        ssrContext,\n      );\n    }\n  }\n  return <Context value={state.current}>{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;EACA,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,IAG+C;EAAA,IAAzE;IAAEC,QAAQ;IAAE,GAAGC;EAAoD,CAAC,GAAAF,IAAA;EACpE,MAAMG,KAAK,GAAGlB,MAAM,CAAmCY,SAAS,CAAC;EACjE,IAAI,CAACM,KAAK,CAACC,OAAO,EAAE;IAClB;IACA;IACA;IACA;IACA,IAAI,YAAY,IAAIF,IAAI,IAAIA,IAAI,CAACG,UAAU,EAAE;MAC3C,IAAIH,IAAI,CAACG,UAAU,KAAK,IAAI,EAAEF,KAAK,CAACC,OAAO,GAAGd,cAAc,CAAC,CAAC,CAAC,KAC1Da,KAAK,CAACC,OAAO,GAAGF,IAAI,CAACG,UAAU;IACtC,CAAC,MAAM;MACL,MAAM;QAAEC,YAAY;QAAER;MAAW,CAAC,GAAGI,IAA0C;MAE/EC,KAAK,CAACC,OAAO,GAAG,IAAIlB,WAAW,CAC7BJ,UAAU,CAACwB,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDR,UACF,CAAC;IACH;EACF;EACA,oBAAOV,IAAA,CAACC,OAAO;IAACkB,KAAK,EAAEJ,KAAK,CAACC,OAAQ;IAAAH,QAAA,EAAEA;EAAQ,CAAU,CAAC;AAC5D,CAAC;AAED,eAAeF,mBAAmB","ignoreList":[]}
+{"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 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  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>({ children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>) => {\n  type GST = GlobalState<StateT, SsrContextT>;\n  const localStateRef = useRef<GST>(undefined);\n  let state: GST;\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 { initialState, ssrContext } = 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,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,IAG+C;EAAA,IAAzE;IAAEC,QAAQ;IAAE,GAAGC;EAAoD,CAAC,GAAAF,IAAA;EAEpE,MAAMG,aAAa,GAAGlB,MAAM,CAAMY,SAAS,CAAC;EAC5C,IAAIO,KAAU;EACd,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;QAAEC,YAAY;QAAET;MAAW,CAAC,GAAGI,IAA0C;MAC/EC,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":[]}

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

@@ -33,10 +33,12 @@ declare function useAsyncCollection<StateT, PathT extends null | string | undefi
 declare function useAsyncCollection<Forced extends ForceT | LockT = LockT, DataT = unknown, IdT extends number | string = number | string>(id: IdT, path: null | string | undefined, loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>, options?: UseAsyncDataOptionsT): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;
 declare function useAsyncCollection<StateT, PathT extends null | string | undefined, IdT extends number | string, DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>(id: IdT[], path: PathT, loader: AsyncCollectionLoaderT<DataT, IdT>, options?: UseAsyncDataOptionsT): UseAsyncCollectionResT<DataT, IdT>;
 declare function useAsyncCollection<Forced extends ForceT | LockT = LockT, DataT = unknown, IdT extends number | string = number | string>(id: IdT[], path: null | string | undefined, loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>, options?: UseAsyncDataOptionsT): UseAsyncCollectionResT<DataT, IdT>;
+declare function useAsyncCollection<StateT, PathT extends null | string | undefined, IdT extends number | string, DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>(id: IdT | IdT[], path: PathT, loader: AsyncCollectionLoaderT<DataT, IdT>, options?: UseAsyncDataOptionsT): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT>;
 export default useAsyncCollection;
 export interface UseAsyncCollectionI<StateT> {
     <PathT extends null | string | undefined, IdT extends number | string>(id: IdT, path: PathT, loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>, options?: UseAsyncDataOptionsT): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;
     <Forced extends ForceT | LockT = LockT, DataT = unknown, IdT extends number | string = number | string>(id: IdT, path: null | string | undefined, loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>, options?: UseAsyncDataOptionsT): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;
     <PathT extends null | string | undefined, IdT extends number | string>(id: IdT[], path: PathT, loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>, options?: UseAsyncDataOptionsT): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;
     <Forced extends ForceT | LockT = LockT, DataT = unknown, IdT extends number | string = number | string>(id: IdT[], path: null | string | undefined, loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>, options?: UseAsyncDataOptionsT): UseAsyncCollectionResT<DataT, IdT>;
+    <PathT extends null | string | undefined, IdT extends number | string>(id: IdT | IdT[], path: PathT, loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>, options?: UseAsyncDataOptionsT): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>> | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dr.pogodin/react-global-state",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "Hook-based global state for React",
   "main": "./build/common/index.js",
   "react-native": "src/index.ts",
@@ -81,9 +81,9 @@
     "jest-environment-jsdom": "^29.7.0",
     "mockdate": "^3.0.5",
     "rimraf": "^6.0.1",
-    "tstyche": "^3.2.0",
+    "tstyche": "^3.3.1",
     "typescript": "^5.7.2",
-    "typescript-eslint": "^8.18.2"
+    "typescript-eslint": "^8.19.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/GlobalStateProvider.tsx

@@ -24,14 +24,7 @@ export function getGlobalState<
   StateT,
   SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,
 >(): GlobalState<StateT, SsrContextT> {
-  // Here Rules of Hooks are violated because "getGlobalState()" does not follow
-  // convention that hook names should start with use... This is intentional in
-  // our case, as getGlobalState() hook is intended for advance scenarious,
-  // while the normal interaction with the global state should happen via
-  // another hook, useGlobalState().
-  /* eslint-disable react-hooks/rules-of-hooks */
   const globalState = use(Context);
-  /* eslint-enable react-hooks/rules-of-hooks */
   if (!globalState) throw new Error('Missing GlobalStateProvider');
   return globalState as GlobalState<StateT, SsrContextT>;
 }
@@ -93,25 +86,23 @@ const GlobalStateProvider = <
   StateT,
   SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,
 >({ children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>) => {
-  const state = useRef<GlobalState<StateT, SsrContextT>>(undefined);
-  if (!state.current) {
-    // NOTE: The last part of condition, "&& rest.stateProxy", is needed for
-    // graceful compatibility with JavaScript - if "undefined" stateProxy value
-    // is given, we want to follow the second branch, which creates a new
-    // GlobalState with whatever intiialState given.
-    if ('stateProxy' in rest && rest.stateProxy) {
-      if (rest.stateProxy === true) state.current = getGlobalState();
-      else state.current = rest.stateProxy;
-    } else {
+  type GST = GlobalState<StateT, SsrContextT>;
+  const localStateRef = useRef<GST>(undefined);
+  let state: GST;
+  if ('stateProxy' in rest && rest.stateProxy) {
+    localStateRef.current = undefined;
+    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;
+  } else {
+    if (!localStateRef.current) {
       const { initialState, ssrContext } = rest as NewStateProps<StateT, SsrContextT>;
-
-      state.current = new GlobalState<StateT, SsrContextT>(
+      localStateRef.current = new GlobalState(
         isFunction(initialState) ? initialState() : initialState,
         ssrContext,
       );
     }
+    state = localStateRef.current;
   }
-  return <Context value={state.current}>{children}</Context>;
+  return <Context value={state}>{children}</Context>;
 };
 
 export default GlobalStateProvider;

package/src/useAsyncCollection.ts

@@ -290,6 +290,20 @@ function useAsyncCollection<
   options?: UseAsyncDataOptionsT,
 ): UseAsyncCollectionResT<DataT, IdT>;
 
+function useAsyncCollection<
+  StateT,
+  PathT extends null | string | undefined,
+  IdT extends number | string,
+
+  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =
+  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,
+>(
+  id: IdT | IdT[],
+  path: PathT,
+  loader: AsyncCollectionLoaderT<DataT, IdT>,
+  options?: UseAsyncDataOptionsT,
+): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT>;
+
 // 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.
@@ -468,4 +482,12 @@ export interface UseAsyncCollectionI<StateT> {
     loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,
     options?: UseAsyncDataOptionsT,
   ): UseAsyncCollectionResT<DataT, IdT>;
+
+  <PathT extends null | string | undefined, IdT extends number | string>(
+    id: IdT | IdT[],
+    path: PathT,
+    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,
+    options?: UseAsyncDataOptionsT,
+  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>
+  | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;
 }