@dr.pogodin/react-global-state 0.17.2 → 0.17.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -194,12 +194,12 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
194
194
  const {
195
195
  deps
196
196
  } = options;
197
- if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt(0) === 'S')) {
197
+ if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - (state2?.timestamp ?? 0) && (!state2?.operationId || state2.operationId.charAt(0) === 'S')) {
198
198
  if (!deps) globalState.dropDependencies(itemPath);
199
199
  // eslint-disable-next-line no-await-in-loop
200
- await (0, _useAsyncData.load)(itemPath, (...args) => loader(id, ...args), globalState, {
201
- data: state2.data,
202
- timestamp: state2.timestamp
200
+ await (0, _useAsyncData.load)(itemPath, (old, ...args) => loader(id, old, ...args), globalState, {
201
+ data: state2?.data,
202
+ timestamp: state2?.timestamp ?? 0
203
203
  });
204
204
  }
205
205
  }
@@ -1 +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","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","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>>();\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 const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n ForceT, AsyncDataEnvelopeT<DataT>>(itemPath);\n\n const { deps } = options;\n if (\n (deps && globalState.hasChangedDependencies(itemPath, deps))\n || (\n refreshAge < Date.now() - state2.timestamp\n && (!state2.operationId || state2.operationId.charAt(0) === 'S')\n )\n ) {\n if (!deps) globalState.dropDependencies(itemPath);\n // eslint-disable-next-line no-await-in-loop\n await load(itemPath, (...args) => loader(id, ...args), globalState, {\n data: state2.data,\n timestamp: state2.timestamp,\n });\n }\n }\n })();\n });\n }\n\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":[]}
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","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>>();\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":[]}
@@ -193,23 +193,25 @@ function useAsyncCollection(idOrIds, path, loader) {
193
193
  // eslint-disable-line react-hooks/rules-of-hooks
194
194
  (async () => {
195
195
  for (let i = 0; i < ids.length; ++i) {
196
+ var _state2$timestamp;
196
197
  const id = ids[i];
197
198
  const itemPath = path ? `${path}.${id}` : `${id}`;
198
199
  const state2 = globalState.get(itemPath);
199
200
  const {
200
201
  deps
201
202
  } = options;
202
- if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt(0) === 'S')) {
203
+ if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - ((_state2$timestamp = state2 === null || state2 === void 0 ? void 0 : state2.timestamp) !== null && _state2$timestamp !== void 0 ? _state2$timestamp : 0) && (!(state2 !== null && state2 !== void 0 && state2.operationId) || state2.operationId.charAt(0) === 'S')) {
204
+ var _state2$timestamp2;
203
205
  if (!deps) globalState.dropDependencies(itemPath);
204
206
  // eslint-disable-next-line no-await-in-loop
205
- await load(itemPath, function () {
206
- for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
207
- args[_key3] = arguments[_key3];
207
+ await load(itemPath, function (old) {
208
+ for (var _len3 = arguments.length, args = new Array(_len3 > 1 ? _len3 - 1 : 0), _key3 = 1; _key3 < _len3; _key3++) {
209
+ args[_key3 - 1] = arguments[_key3];
208
210
  }
209
- return loader(id, ...args);
211
+ return loader(id, old, ...args);
210
212
  }, globalState, {
211
- data: state2.data,
212
- timestamp: state2.timestamp
213
+ data: state2 === null || state2 === void 0 ? void 0 : state2.data,
214
+ timestamp: (_state2$timestamp2 = state2 === null || state2 === void 0 ? void 0 : state2.timestamp) !== null && _state2$timestamp2 !== void 0 ? _state2$timestamp2 : 0
213
215
  });
214
216
  }
215
217
  }
@@ -1 +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","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","oldData","meta","reloadSingle","_len","arguments","args","_key","useAsyncCollection","_options$maxage","_options$refreshAge","_options$garbageColle","options","undefined","maxage","refreshAge","garbageCollectAge","ssrContext","noSSR","operationId","state","initialValue","pending","push","_len2","_key2","data","idsHash","state2","deps","hasChangedDependencies","charAt","dropDependencies","_len3","_key3","localState","_e$timestamp","_e$data","e","loading","items","Number","MAX_VALUE","_e$timestamp2","_e$data2"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n type AsyncDataEnvelopeT,\n type AsyncDataReloaderT,\n type DataInEnvelopeAtPathT,\n type OperationIdT,\n type UseAsyncDataOptionsT,\n type UseAsyncDataResT,\n DEFAULT_MAXAGE,\n load,\n newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n type ForceT,\n type LockT,\n type TypeLock,\n hash,\n isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n DataT = unknown,\n IdT extends number | string = number | string,\n> = { [id in IdT]?: AsyncDataEnvelopeT<DataT> };\n\nexport type AsyncCollectionLoaderT<\n DataT,\n IdT extends number | string = number | string,\n> =\n (id: IdT, oldData: null | DataT, meta: {\n isAborted: () => boolean;\n oldDataTimestamp: number;\n 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>>();\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 const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n ForceT, AsyncDataEnvelopeT<DataT>>(itemPath);\n\n const { deps } = options;\n if (\n (deps && globalState.hasChangedDependencies(itemPath, deps))\n || (\n refreshAge < Date.now() - state2.timestamp\n && (!state2.operationId || state2.operationId.charAt(0) === 'S')\n )\n ) {\n if (!deps) globalState.dropDependencies(itemPath);\n // eslint-disable-next-line no-await-in-loop\n await load(itemPath, (...args) => loader(id, ...args), globalState, {\n data: state2.data,\n timestamp: state2.timestamp,\n });\n }\n }\n })();\n });\n }\n\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":[]}
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","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","oldData","meta","reloadSingle","_len","arguments","args","_key","useAsyncCollection","_options$maxage","_options$refreshAge","_options$garbageColle","options","undefined","maxage","refreshAge","garbageCollectAge","ssrContext","noSSR","operationId","state","initialValue","pending","push","_len2","_key2","data","idsHash","_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>>();\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":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dr.pogodin/react-global-state",
3
- "version": "0.17.2",
3
+ "version": "0.17.4",
4
4
  "description": "Hook-based global state for React",
5
5
  "main": "./build/common/index.js",
6
6
  "react-native": "src/index.ts",
@@ -361,23 +361,29 @@ function useAsyncCollection<
361
361
  for (let i = 0; i < ids.length; ++i) {
362
362
  const id = ids[i]!;
363
363
  const itemPath = path ? `${path}.${id}` : `${id}`;
364
- const state2: AsyncDataEnvelopeT<DataT> = globalState.get<
365
- ForceT, AsyncDataEnvelopeT<DataT>>(itemPath);
364
+
365
+ type EnvT = AsyncDataEnvelopeT<DataT> | undefined;
366
+ const state2: EnvT = globalState.get<ForceT, EnvT>(itemPath);
366
367
 
367
368
  const { deps } = options;
368
369
  if (
369
370
  (deps && globalState.hasChangedDependencies(itemPath, deps))
370
371
  || (
371
- refreshAge < Date.now() - state2.timestamp
372
- && (!state2.operationId || state2.operationId.charAt(0) === 'S')
372
+ refreshAge < Date.now() - (state2?.timestamp ?? 0)
373
+ && (!state2?.operationId || state2.operationId.charAt(0) === 'S')
373
374
  )
374
375
  ) {
375
376
  if (!deps) globalState.dropDependencies(itemPath);
376
377
  // eslint-disable-next-line no-await-in-loop
377
- await load(itemPath, (...args) => loader(id, ...args), globalState, {
378
- data: state2.data,
379
- timestamp: state2.timestamp,
380
- });
378
+ await load(
379
+ itemPath,
380
+ (old, ...args) => loader(id, old as DataT, ...args),
381
+ globalState,
382
+ {
383
+ data: state2?.data,
384
+ timestamp: state2?.timestamp ?? 0,
385
+ },
386
+ );
381
387
  }
382
388
  }
383
389
  })();