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

package/build/common/useAsyncData.js

@@ -146,14 +146,18 @@ function useAsyncData(path, loader, options = {}) {
       return load(heap.path, localLoader, heap.globalState);
     };
   }
-  if (globalState.ssrContext && !options.noSSR) {
-    if (!state.timestamp && !state.operationId) {
+  if (globalState.ssrContext) {
+    if (!options.disabled && !options.noSSR && !state.operationId && !state.timestamp) {
       globalState.ssrContext.pending.push(load(path, loader, globalState, {
         data: state.data,
         timestamp: state.timestamp
       }, `S${(0, _uuid.v4)()}`));
     }
   } else {
+    const {
+      disabled
+    } = options;
+
     // This takes care about the client-side reference counting, and garbage
     // collection.
     //
@@ -166,26 +170,30 @@ function useAsyncData(path, loader, options = {}) {
     (0, _react.useEffect)(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
       const numRefsPath = path ? `${path}.numRefs` : 'numRefs';
-      const numRefs = globalState.get(numRefsPath);
-      globalState.set(numRefsPath, numRefs + 1);
+      if (!disabled) {
+        const numRefs = globalState.get(numRefsPath);
+        globalState.set(numRefsPath, numRefs + 1);
+      }
       return () => {
-        const state2 = globalState.get(path);
-        if (state2.numRefs === 1 && garbageCollectAge < Date.now() - state2.timestamp) {
-          if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
-            /* eslint-disable no-console */
-            console.log(`ReactGlobalState - useAsyncData garbage collected at path ${path || ''}`);
-            /* eslint-enable no-console */
-          }
-          globalState.dropDependencies(path || '');
-          globalState.set(path, {
-            ...state2,
-            data: null,
-            numRefs: 0,
-            timestamp: 0
-          });
-        } else globalState.set(numRefsPath, state2.numRefs - 1);
+        if (!disabled) {
+          const state2 = globalState.get(path);
+          if (state2.numRefs === 1 && garbageCollectAge < Date.now() - state2.timestamp) {
+            if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+              /* eslint-disable no-console */
+              console.log(`ReactGlobalState - useAsyncData garbage collected at path ${path || ''}`);
+              /* eslint-enable no-console */
+            }
+            globalState.dropDependencies(path || '');
+            globalState.set(path, {
+              ...state2,
+              data: null,
+              numRefs: 0,
+              timestamp: 0
+            });
+          } else globalState.set(numRefsPath, state2.numRefs - 1);
+        }
       };
-    }, [garbageCollectAge, globalState, path]);
+    }, [disabled, garbageCollectAge, globalState, path]);
 
     // Note: a bunch of Rules of Hooks ignored belows because in our very
     // special case the otherwise wrong behavior is actually what we need.
@@ -193,22 +201,24 @@ function useAsyncData(path, loader, options = {}) {
     // Data loading and refreshing.
     (0, _react.useEffect)(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
-      const state2 = globalState.get(path);
-      const {
-        deps
-      } = options;
-      if (
-      // The hook is called with a list of dependencies, that mismatch
-      // dependencies last used to retrieve the data at given path.
-      deps && globalState.hasChangedDependencies(path || '', deps)
+      if (!disabled) {
+        const state2 = globalState.get(path);
+        const {
+          deps
+        } = options;
+        if (
+        // The hook is called with a list of dependencies, that mismatch
+        // dependencies last used to retrieve the data at given path.
+        deps && globalState.hasChangedDependencies(path || '', deps)
 
-      // Data at the path are stale, and are not being loaded.
-      || refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt(0) === 'S')) {
-        if (!deps) globalState.dropDependencies(path || '');
-        load(path, loader, globalState, {
-          data: state2.data,
-          timestamp: state2.timestamp
-        });
+        // Data at the path are stale, and are not being loaded.
+        || refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt(0) === 'S')) {
+          if (!deps) globalState.dropDependencies(path || '');
+          load(path, loader, globalState, {
+            data: state2.data,
+            timestamp: state2.timestamp
+          });
+        }
       }
     });
   }

package/build/common/useAsyncData.js.map

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

package/build/module/useAsyncData.js

@@ -136,14 +136,18 @@ function useAsyncData(path, loader) {
       return load(heap.path, localLoader, heap.globalState);
     };
   }
-  if (globalState.ssrContext && !options.noSSR) {
-    if (!state.timestamp && !state.operationId) {
+  if (globalState.ssrContext) {
+    if (!options.disabled && !options.noSSR && !state.operationId && !state.timestamp) {
       globalState.ssrContext.pending.push(load(path, loader, globalState, {
         data: state.data,
         timestamp: state.timestamp
       }, `S${uuid()}`));
     }
   } else {
+    const {
+      disabled
+    } = options;
+
     // This takes care about the client-side reference counting, and garbage
     // collection.
     //
@@ -156,26 +160,30 @@ function useAsyncData(path, loader) {
     useEffect(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
       const numRefsPath = path ? `${path}.numRefs` : 'numRefs';
-      const numRefs = globalState.get(numRefsPath);
-      globalState.set(numRefsPath, numRefs + 1);
+      if (!disabled) {
+        const numRefs = globalState.get(numRefsPath);
+        globalState.set(numRefsPath, numRefs + 1);
+      }
       return () => {
-        const state2 = globalState.get(path);
-        if (state2.numRefs === 1 && garbageCollectAge < Date.now() - state2.timestamp) {
-          if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-            /* eslint-disable no-console */
-            console.log(`ReactGlobalState - useAsyncData garbage collected at path ${path || ''}`);
-            /* eslint-enable no-console */
-          }
-          globalState.dropDependencies(path || '');
-          globalState.set(path, {
-            ...state2,
-            data: null,
-            numRefs: 0,
-            timestamp: 0
-          });
-        } else globalState.set(numRefsPath, state2.numRefs - 1);
+        if (!disabled) {
+          const state2 = globalState.get(path);
+          if (state2.numRefs === 1 && garbageCollectAge < Date.now() - state2.timestamp) {
+            if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
+              /* eslint-disable no-console */
+              console.log(`ReactGlobalState - useAsyncData garbage collected at path ${path || ''}`);
+              /* eslint-enable no-console */
+            }
+            globalState.dropDependencies(path || '');
+            globalState.set(path, {
+              ...state2,
+              data: null,
+              numRefs: 0,
+              timestamp: 0
+            });
+          } else globalState.set(numRefsPath, state2.numRefs - 1);
+        }
       };
-    }, [garbageCollectAge, globalState, path]);
+    }, [disabled, garbageCollectAge, globalState, path]);
 
     // Note: a bunch of Rules of Hooks ignored belows because in our very
     // special case the otherwise wrong behavior is actually what we need.
@@ -183,22 +191,24 @@ function useAsyncData(path, loader) {
     // Data loading and refreshing.
     useEffect(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
-      const state2 = globalState.get(path);
-      const {
-        deps
-      } = options;
-      if (
-      // The hook is called with a list of dependencies, that mismatch
-      // dependencies last used to retrieve the data at given path.
-      deps && globalState.hasChangedDependencies(path || '', deps)
+      if (!disabled) {
+        const state2 = globalState.get(path);
+        const {
+          deps
+        } = options;
+        if (
+        // The hook is called with a list of dependencies, that mismatch
+        // dependencies last used to retrieve the data at given path.
+        deps && globalState.hasChangedDependencies(path || '', deps)
 
-      // Data at the path are stale, and are not being loaded.
-      || refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt(0) === 'S')) {
-        if (!deps) globalState.dropDependencies(path || '');
-        load(path, loader, globalState, {
-          data: state2.data,
-          timestamp: state2.timestamp
-        });
+        // Data at the path are stale, and are not being loaded.
+        || refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt(0) === 'S')) {
+          if (!deps) globalState.dropDependencies(path || '');
+          load(path, loader, globalState, {
+            data: state2.data,
+            timestamp: state2.timestamp
+          });
+        }
       }
     });
   }

package/build/module/useAsyncData.js.map

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

package/build/types/useAsyncData.d.ts

@@ -24,6 +24,7 @@ export declare function newAsyncDataEnvelope<DataT>(initialData?: DataT | null,
 }): AsyncDataEnvelopeT<DataT>;
 export type UseAsyncDataOptionsT = {
     deps?: unknown[];
+    disabled?: boolean;
     garbageCollectAge?: number;
     maxage?: number;
     noSSR?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dr.pogodin/react-global-state",
-  "version": "0.17.4",
+  "version": "0.17.5",
   "description": "Hook-based global state for React",
   "main": "./build/common/index.js",
   "react-native": "src/index.ts",
@@ -43,48 +43,47 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@babel/runtime": "^7.25.6",
+    "@babel/runtime": "^7.26.0",
     "@dr.pogodin/js-utils": "^0.0.12",
-    "@types/lodash": "^4.17.7",
+    "@types/lodash": "^4.17.13",
     "lodash": "^4.17.21",
-    "uuid": "^10.0.0"
+    "uuid": "^11.0.3"
   },
   "devDependencies": {
-    "@babel/cli": "^7.25.6",
-    "@babel/core": "^7.25.2",
-    "@babel/eslint-parser": "^7.25.1",
-    "@babel/eslint-plugin": "^7.25.1",
-    "@babel/node": "^7.25.0",
-    "@babel/plugin-transform-runtime": "^7.25.4",
-    "@babel/preset-env": "^7.25.4",
-    "@babel/preset-react": "^7.24.7",
-    "@babel/preset-typescript": "^7.24.7",
+    "@babel/cli": "^7.25.9",
+    "@babel/core": "^7.26.0",
+    "@babel/eslint-parser": "^7.25.9",
+    "@babel/eslint-plugin": "^7.25.9",
+    "@babel/node": "^7.26.0",
+    "@babel/plugin-transform-runtime": "^7.25.9",
+    "@babel/preset-env": "^7.26.0",
+    "@babel/preset-react": "^7.25.9",
+    "@babel/preset-typescript": "^7.26.0",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.0.1",
-    "@tsconfig/recommended": "^1.0.7",
-    "@types/jest": "^29.5.13",
+    "@tsconfig/recommended": "^1.0.8",
+    "@types/jest": "^29.5.14",
     "@types/pretty": "^2.0.3",
-    "@types/react": "^18.3.5",
-    "@types/react-dom": "^18.3.0",
-    "@types/uuid": "^10.0.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
     "babel-jest": "^29.7.0",
     "babel-plugin-module-resolver": "^5.0.2",
-    "eslint": "^8.57.0",
+    "eslint": "^8.57.1",
     "eslint-config-airbnb": "^19.0.4",
     "eslint-config-airbnb-typescript": "^18.0.0",
     "eslint-import-resolver-babel-module": "^5.3.2",
-    "eslint-plugin-import": "^2.30.0",
-    "eslint-plugin-jest": "^28.8.3",
-    "eslint-plugin-jsx-a11y": "^6.10.0",
-    "eslint-plugin-react": "^7.36.1",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jest": "^28.9.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-react": "^7.37.2",
     "eslint-plugin-react-hooks": "^4.6.2",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "mockdate": "^3.0.5",
     "rimraf": "^6.0.1",
-    "tstyche": "^2.1.1",
-    "typescript": "^5.6.2",
-    "typescript-eslint": "^8.5.0"
+    "tstyche": "^3.0.0",
+    "typescript": "^5.6.3",
+    "typescript-eslint": "^8.15.0"
   },
   "peerDependencies": {
     "react": "^18.3.1",

package/src/useAsyncData.ts

@@ -57,6 +57,7 @@ export function newAsyncDataEnvelope<DataT>(
 
 export type UseAsyncDataOptionsT = {
   deps?: unknown[];
+  disabled?: boolean;
   garbageCollectAge?: number;
   maxage?: number;
   noSSR?: boolean;
@@ -242,8 +243,8 @@ function useAsyncData<DataT>(
     };
   }
 
-  if (globalState.ssrContext && !options.noSSR) {
-    if (!state.timestamp && !state.operationId) {
+  if (globalState.ssrContext) {
+    if (!options.disabled && !options.noSSR && !state.operationId && !state.timestamp) {
       globalState.ssrContext.pending.push(
         load(path, loader, globalState, {
           data: state.data,
@@ -252,6 +253,8 @@ function useAsyncData<DataT>(
       );
     }
   } else {
+    const { disabled } = options;
+
     // This takes care about the client-side reference counting, and garbage
     // collection.
     //
@@ -263,62 +266,68 @@ function useAsyncData<DataT>(
     // The same applies to other useEffect() hooks below.
     useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks
       const numRefsPath = path ? `${path}.numRefs` : 'numRefs';
-      const numRefs = globalState.get<ForceT, number>(numRefsPath);
-      globalState.set<ForceT, number>(numRefsPath, numRefs + 1);
+      if (!disabled) {
+        const numRefs = globalState.get<ForceT, number>(numRefsPath);
+        globalState.set<ForceT, number>(numRefsPath, numRefs + 1);
+      }
       return () => {
-        const state2: AsyncDataEnvelopeT<DataT> = globalState.get<
-        ForceT, AsyncDataEnvelopeT<DataT>>(
-          path,
-        );
-        if (
-          state2.numRefs === 1
-          && garbageCollectAge < Date.now() - state2.timestamp
-        ) {
-          if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
-            /* eslint-disable no-console */
-            console.log(
-              `ReactGlobalState - useAsyncData garbage collected at path ${
-                path || ''
-              }`,
-            );
-            /* eslint-enable no-console */
-          }
-          globalState.dropDependencies(path || '');
-          globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {
-            ...state2,
-            data: null,
-            numRefs: 0,
-            timestamp: 0,
-          });
-        } else globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);
+        if (!disabled) {
+          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<
+          ForceT, AsyncDataEnvelopeT<DataT>>(
+            path,
+          );
+          if (
+            state2.numRefs === 1
+            && garbageCollectAge < Date.now() - state2.timestamp
+          ) {
+            if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
+              /* eslint-disable no-console */
+              console.log(
+                `ReactGlobalState - useAsyncData garbage collected at path ${
+                  path || ''
+                }`,
+              );
+              /* eslint-enable no-console */
+            }
+            globalState.dropDependencies(path || '');
+            globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(path, {
+              ...state2,
+              data: null,
+              numRefs: 0,
+              timestamp: 0,
+            });
+          } else globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);
+        }
       };
-    }, [garbageCollectAge, globalState, path]);
+    }, [disabled, garbageCollectAge, globalState, path]);
 
     // Note: a bunch of Rules of Hooks ignored belows because in our very
     // special case the otherwise wrong behavior is actually what we need.
 
     // Data loading and refreshing.
     useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks
-      const state2: AsyncDataEnvelopeT<DataT> = globalState.get<
-      ForceT, AsyncDataEnvelopeT<DataT>>(path);
-
-      const { deps } = options;
-      if (
-        // The hook is called with a list of dependencies, that mismatch
-        // dependencies last used to retrieve the data at given path.
-        (deps && globalState.hasChangedDependencies(path || '', deps))
-
-        // Data at the path are stale, and are not being loaded.
-        || (
-          refreshAge < Date.now() - state2.timestamp
-          && (!state2.operationId || state2.operationId.charAt(0) === 'S')
-        )
-      ) {
-        if (!deps) globalState.dropDependencies(path || '');
-        load(path, loader, globalState, {
-          data: state2.data,
-          timestamp: state2.timestamp,
-        });
+      if (!disabled) {
+        const state2: AsyncDataEnvelopeT<DataT> = globalState.get<
+        ForceT, AsyncDataEnvelopeT<DataT>>(path);
+
+        const { deps } = options;
+        if (
+          // The hook is called with a list of dependencies, that mismatch
+          // dependencies last used to retrieve the data at given path.
+          (deps && globalState.hasChangedDependencies(path || '', deps))
+
+          // Data at the path are stale, and are not being loaded.
+          || (
+            refreshAge < Date.now() - state2.timestamp
+            && (!state2.operationId || state2.operationId.charAt(0) === 'S')
+          )
+        ) {
+          if (!deps) globalState.dropDependencies(path || '');
+          load(path, loader, globalState, {
+            data: state2.data,
+            timestamp: state2.timestamp,
+          });
+        }
       }
     });
   }