@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
|
|
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
|
|
202
|
-
timestamp: state2
|
|
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 =
|
|
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
|
@@ -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
|
-
|
|
365
|
-
|
|
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
|
|
372
|
-
&& (!state2
|
|
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(
|
|
378
|
-
|
|
379
|
-
|
|
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
|
})();
|