@dr.pogodin/react-global-state 0.19.0 → 0.19.2

package/build/code/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","_heap$reload","options","maxage","refreshAge","garbageCollectAge","initialValue","current","heap","reload","customLoader","localLoader","ssrContext","disabled","noSSR","pending","push","numRefsPath","state2","dropDependencies","deps","hasChangedDependencies","startsWith","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 type GlobalState from './GlobalState';\nimport type 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<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      return opid !== operationId;\n    },\n    oldDataTimestamp: definedOld.timestamp,\n    setAbortCallback(cb: () => void) {\n      const opid = globalState.get<\n        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<\n    StateT, PathT> = 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  heap.reload ??= async (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  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\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 {\n            globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n          }\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.startsWith('S'))\n          )\n        ) {\n          if (!deps) globalState.dropDependencies(path ?? '');\n          void 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\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\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":"AAAA;AACA;AACA;;AAEA,SAASA,SAAS,EAAEC,MAAM,QAAQ,OAAO;AACzC,SAASC,EAAE,IAAIC,IAAI,QAAQ,MAAM;AAEjC,SAASC,MAAM,QAAQ,sBAAsB;AAE7C,SAASC,cAAc;AACvB,OAAOC,cAAc;AAErB,SAKEC,eAAe,EACfC,WAAW;AAMb,OAAO,MAAMC,cAAc,GAAG,CAAC,GAAGL,MAAM,CAAC,CAAC;;AAqB1C,OAAO,SAASM,oBAAoBA,CAAA,EAGP;EAAA,IAF3BC,WAAyB,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,IAAI;EAAA,IAChC;IAAEG,OAAO,GAAG,CAAC;IAAEC,SAAS,GAAG;EAAE,CAAC,GAAAJ,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAEnC,OAAO;IACLK,IAAI,EAAEN,WAAW;IACjBI,OAAO;IACPG,WAAW,EAAE,EAAE;IACfF;EACF,CAAC;AACH;AAkBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeG,IAAIA,CACxBC,IAA+B,EAC/BC,MAA+B,EAC/BC,WAAsD,EACtDC,GAA+C,EAOhC;EAAA,IADfL,WAAyB,GAAAN,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,IAAIT,IAAI,CAAC,CAAC,EAAE;EAExC,IAAIqB,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAIlB,WAAW,CAAC,CAAC,EAAE;IAC1D;IACAmB,OAAO,CAACC,GAAG,CACT,qDAAqDR,IAAI,aAAJA,IAAI,cAAJA,IAAI,GAAI,EAAE,GACjE,CAAC;IACD;EACF;EAEA,MAAMS,eAAe,GAAGT,IAAI,GAAG,GAAGA,IAAI,cAAc,GAAG,aAAa;EACpE;IACE,MAAMU,eAAe,GAAGR,WAAW,CAACS,GAAG,CAAiBF,eAAe,CAAC;IACxE,IAAIC,eAAe,EAAER,WAAW,CAACU,iBAAiB,CAACF,eAAe,EAAE,IAAI,CAAC;EAC3E;EACAR,WAAW,CAACW,GAAG,CAAiBJ,eAAe,EAAEX,WAAW,CAAC;EAE7D,IAAIgB,UAAU,GAAGX,GAAG;EACpB,IAAI,CAACW,UAAU,EAAE;IACf;IACA,MAAMC,CAAC,GAAGb,WAAW,CAACS,GAAG,CAAoCX,IAAI,CAAC;IAClEc,UAAU,GAAG;MAAEjB,IAAI,EAAEkB,CAAC,CAAClB,IAAI;MAAED,SAAS,EAAEmB,CAAC,CAACnB;IAAU,CAAC;EACvD;EAEA,MAAMoB,aAAa,GAAGf,MAAM,CAACa,UAAU,CAACjB,IAAI,EAAE;IAC5CoB,SAAS,EAAEA,CAAA,KAAM;MACf;MACA,MAAMC,IAAI,GAAGhB,WAAW,CAACS,GAAG,CACSX,IAAI,CAAC,CAACF,WAAW;MACtD,OAAOoB,IAAI,KAAKpB,WAAW;IAC7B,CAAC;IACDqB,gBAAgB,EAAEL,UAAU,CAAClB,SAAS;IACtCwB,gBAAgBA,CAACC,EAAc,EAAE;MAC/B,MAAMH,IAAI,GAAGhB,WAAW,CAACS,GAAG,CACSX,IAAI,CAAC,CAACF,WAAW;MACtD,IAAIoB,IAAI,KAAKpB,WAAW,EAAE;QACxB,MAAMwB,KAAK,CAAC,cAAcxB,WAAW,wBAAwB,CAAC;MAChE;MACAI,WAAW,CAACqB,yBAAyB,CAACzB,WAAW,EAAEuB,EAAE,CAAC;IACxD;EACF,CAAC,CAAC;EAEF,IAAIxB,IAAkB;EAEtB,IAAI;IACFA,IAAI,GAAGmB,aAAa,YAAYQ,OAAO,GACnC,MAAMR,aAAa,GAAGA,aAAa;EACzC,CAAC,SAAS;IACR;IACA;IACA;IACAd,WAAW,CAACU,iBAAiB,CAACd,WAAW,EAAE,KAAK,CAAC;EACnD;EAGA,MAAM2B,KAAW,GAAGvB,WAAW,CAACS,GAAG,CAAeX,IAAI,CAAC;EAEvD,IAAIF,WAAW,MAAK2B,KAAK,aAALA,KAAK,uBAALA,KAAK,CAAE3B,WAAW,GAAE;IACtC,IAAIM,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAIlB,WAAW,CAAC,CAAC,EAAE;MAC1D;MACAmB,OAAO,CAACmB,cAAc,CACpB,oDACE1B,IAAI,aAAJA,IAAI,cAAJA,IAAI,GAAI,EAAE,GAEd,CAAC;MACDO,OAAO,CAACC,GAAG,CAAC,OAAO,EAAErB,eAAe,CAACU,IAAI,EAAEG,IAAI,aAAJA,IAAI,cAAJA,IAAI,GAAI,EAAE,CAAC,CAAC;MACvD;IACF;IACAE,WAAW,CAACW,GAAG,CAAoCb,IAAI,EAAE;MACvD,GAAGyB,KAAK;MACR5B,IAAI;MACJC,WAAW,EAAE,EAAE;MACfF,SAAS,EAAE+B,IAAI,CAACC,GAAG,CAAC;IACtB,CAAC,CAAC;IACF,IAAIxB,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAIlB,WAAW,CAAC,CAAC,EAAE;MAC1D;MACAmB,OAAO,CAACsB,QAAQ,CAAC,CAAC;MAClB;IACF;EACF;AACF;;AAEA;AACA;AACA;AACA;;AAoCA,SAASC,YAAYA,CACnB9B,IAA+B,EAC/BC,MAA+B,EAEN;EAAA,IAAA8B,eAAA,EAAAC,mBAAA,EAAAC,qBAAA,EAAAC,YAAA;EAAA,IADzBC,OAA6B,GAAA3C,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,CAAC,CAAC;EAElC,MAAM4C,MAAc,IAAAL,eAAA,GAAGI,OAAO,CAACC,MAAM,cAAAL,eAAA,cAAAA,eAAA,GAAI1C,cAAc;EACvD,MAAMgD,UAAkB,IAAAL,mBAAA,GAAGG,OAAO,CAACE,UAAU,cAAAL,mBAAA,cAAAA,mBAAA,GAAII,MAAM;EACvD,MAAME,iBAAyB,IAAAL,qBAAA,GAAGE,OAAO,CAACG,iBAAiB,cAAAL,qBAAA,cAAAA,qBAAA,GAAIG,MAAM;;EAErE;EACA;EACA,MAAMlC,WAAW,GAAGjB,cAAc,CAAC,CAAC;EACpC,MAAMwC,KAAK,GAAGvB,WAAW,CAACS,GAAG,CAAoCX,IAAI,EAAE;IACrEuC,YAAY,EAAEjD,oBAAoB,CAAQ;EAC5C,CAAC,CAAC;EAEF,MAAM;IAAEkD,OAAO,EAAEC;EAAK,CAAC,GAAG5D,MAAM,CAAe,CAAC,CAAC,CAAC;EAClD4D,IAAI,CAACvC,WAAW,GAAGA,WAAW;EAC9BuC,IAAI,CAACzC,IAAI,GAAGA,IAAI;EAChByC,IAAI,CAACxC,MAAM,GAAGA,MAAM;EAEpB,CAAAiC,YAAA,GAAAO,IAAI,CAACC,MAAM,cAAAR,YAAA,cAAAA,YAAA,GAAXO,IAAI,CAACC,MAAM,GAAK,MAAOC,YAAsC,IAAK;IAChE,MAAMC,WAAW,GAAGD,YAAY,aAAZA,YAAY,cAAZA,YAAY,GAAIF,IAAI,CAACxC,MAAM;IAC/C,IAAI,CAAC2C,WAAW,IAAI,CAACH,IAAI,CAACvC,WAAW,EAAE,MAAMoB,KAAK,CAAC,gBAAgB,CAAC;IACpE,OAAOvB,IAAI,CAAC0C,IAAI,CAACzC,IAAI,EAAE4C,WAAW,EAAEH,IAAI,CAACvC,WAAW,CAAC;EACvD,CAAC;EAED,IAAIA,WAAW,CAAC2C,UAAU,EAAE;IAC1B,IACE,CAACV,OAAO,CAACW,QAAQ,IAAI,CAACX,OAAO,CAACY,KAAK,IAChC,CAACtB,KAAK,CAAC3B,WAAW,IAAI,CAAC2B,KAAK,CAAC7B,SAAS,EACzC;MACAM,WAAW,CAAC2C,UAAU,CAACG,OAAO,CAACC,IAAI,CACjClD,IAAI,CAACC,IAAI,EAAEC,MAAM,EAAEC,WAAW,EAAE;QAC9BL,IAAI,EAAE4B,KAAK,CAAC5B,IAAI;QAChBD,SAAS,EAAE6B,KAAK,CAAC7B;MACnB,CAAC,EAAE,IAAIb,IAAI,CAAC,CAAC,EAAE,CACjB,CAAC;IACH;EACF,CAAC,MAAM;IACL,MAAM;MAAE+D;IAAS,CAAC,GAAGX,OAAO;;IAE5B;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACAvD,SAAS,CAAC,MAAM;MAAE;MAChB,MAAMsE,WAAW,GAAGlD,IAAI,GAAG,GAAGA,IAAI,UAAU,GAAG,SAAS;MACxD,IAAI,CAAC8C,QAAQ,EAAE;QACb,MAAMnD,OAAO,GAAGO,WAAW,CAACS,GAAG,CAAiBuC,WAAW,CAAC;QAC5DhD,WAAW,CAACW,GAAG,CAAiBqC,WAAW,EAAEvD,OAAO,GAAG,CAAC,CAAC;MAC3D;MACA,OAAO,MAAM;QACX,IAAI,CAACmD,QAAQ,EAAE;UACb,MAAMK,MAAiC,GAAGjD,WAAW,CAACS,GAAG,CAEvDX,IACF,CAAC;UACD,IACEmD,MAAM,CAACxD,OAAO,KAAK,CAAC,IACjB2C,iBAAiB,GAAGX,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGuB,MAAM,CAACvD,SAAS,EACpD;YACA,IAAIQ,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAIlB,WAAW,CAAC,CAAC,EAAE;cAC1D;cACAmB,OAAO,CAACC,GAAG,CACT,6DACER,IAAI,aAAJA,IAAI,cAAJA,IAAI,GAAI,EAAE,EAEd,CAAC;cACD;YACF;YACAE,WAAW,CAACkD,gBAAgB,CAACpD,IAAI,aAAJA,IAAI,cAAJA,IAAI,GAAI,EAAE,CAAC;YACxCE,WAAW,CAACW,GAAG,CAAoCb,IAAI,EAAE;cACvD,GAAGmD,MAAM;cACTtD,IAAI,EAAE,IAAI;cACVF,OAAO,EAAE,CAAC;cACVC,SAAS,EAAE;YACb,CAAC,CAAC;UACJ,CAAC,MAAM;YACLM,WAAW,CAACW,GAAG,CAAiBqC,WAAW,EAAEC,MAAM,CAACxD,OAAO,GAAG,CAAC,CAAC;UAClE;QACF;MACF,CAAC;IACH,CAAC,EAAE,CAACmD,QAAQ,EAAER,iBAAiB,EAAEpC,WAAW,EAAEF,IAAI,CAAC,CAAC;;IAEpD;IACA;;IAEA;IACApB,SAAS,CAAC,MAAM;MAAE;MAChB,IAAI,CAACkE,QAAQ,EAAE;QACb,MAAMK,MAAiC,GAAGjD,WAAW,CAACS,GAAG,CACpBX,IAAI,CAAC;QAE1C,MAAM;UAAEqD;QAAK,CAAC,GAAGlB,OAAO;QACxB;QACE;QACA;QACCkB,IAAI,IAAInD,WAAW,CAACoD,sBAAsB,CAACtD,IAAI,aAAJA,IAAI,cAAJA,IAAI,GAAI,EAAE,EAAEqD,IAAI;;QAE5D;QAAA,GAEEhB,UAAU,GAAGV,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGuB,MAAM,CAACvD,SAAS,KACtC,CAACuD,MAAM,CAACrD,WAAW,IAAIqD,MAAM,CAACrD,WAAW,CAACyD,UAAU,CAAC,GAAG,CAAC,CAC9D,EACD;UACA,IAAI,CAACF,IAAI,EAAEnD,WAAW,CAACkD,gBAAgB,CAACpD,IAAI,aAAJA,IAAI,cAAJA,IAAI,GAAI,EAAE,CAAC;UACnD,KAAKD,IAAI,CAACC,IAAI,EAAEC,MAAM,EAAEC,WAAW,EAAE;YACnCL,IAAI,EAAEsD,MAAM,CAACtD,IAAI;YACjBD,SAAS,EAAEuD,MAAM,CAACvD;UACpB,CAAC,CAAC;QACJ;MACF;IACF,CAAC,CAAC;EACJ;EAEA,MAAM,CAAC4D,UAAU,CAAC,GAAGtE,cAAc,CACjCc,IAAI,EACJV,oBAAoB,CAAQ,CAC9B,CAAC;EAED,OAAO;IACLO,IAAI,EAAEuC,MAAM,GAAGT,IAAI,CAACC,GAAG,CAAC,CAAC,GAAG4B,UAAU,CAAC5D,SAAS,GAAG,IAAI,GAAG4D,UAAU,CAAC3D,IAAI;IACzE4D,OAAO,EAAEC,OAAO,CAACF,UAAU,CAAC1D,WAAW,CAAC;IACxC4C,MAAM,EAAED,IAAI,CAACC,MAAM;IACnB9C,SAAS,EAAE4D,UAAU,CAAC5D;EACxB,CAAC;AACH;AAEA,SAASkC,YAAY;;AAErB","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","finalizeLoad","path","globalState","asyncDataLoadDone","state","get","process","env","NODE_ENV","console","groupCollapsed","log","set","Date","now","groupEnd","load","loader","old","operationIdPath","prevOperationId","definedOld","e","dataOrPromise","isAborted","opid","oldDataTimestamp","setAbortCallback","cb","Error","setAsyncDataAbortCallback","Promise","then","finally","useAsyncData","_options$maxage","_options$refreshAge","_options$garbageColle","_heap$reload","options","maxage","refreshAge","garbageCollectAge","initialValue","current","heap","reload","customLoader","localLoader","ssrContext","disabled","noSSR","promiseOrVoid","pending","push","numRefsPath","state2","dropDependencies","deps","hasChangedDependencies","startsWith","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 type GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nexport const DEFAULT_MAXAGE = 5 * MIN_MS; // 5 minutes.\n\n// NOTE: Here, and below it is important whether a loader and related\n// (re-)loading handlers return a promise or a value, as returning promises\n// mean the async mode, in which related global state values are updated\n// asynchronously (the new value comes into effect in a next rendering cycle),\n// while returning a non-promise value means a synchronous mode, in which\n// related global state values are updated immediately, within the current\n// rendering cycle.\n\nexport type AsyncDataLoaderT<DataT>\n= (oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => (DataT | null) | Promise<DataT | null>;\n\nexport type AsyncDataReloaderT<DataT>\n= (loader?: AsyncDataLoaderT<DataT>) => void | 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\nfunction finalizeLoad<DataT>(\n  data: DataT,\n  path: null | string | undefined,\n  globalState: GlobalState<unknown, SsrContext<unknown>>,\n  operationId: OperationIdT,\n): void {\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  //\n  // Also, in the synchronous state update mode, we don't really need to set up\n  // the abort callback at all (as there is no way to use it), but for now it is\n  // set up, thus it should be cleaned out here.\n  globalState.asyncDataLoadDone(operationId, false);\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 * 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 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): void | 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<\n        ForceT, AsyncDataEnvelopeT<DataT>>(path).operationId;\n      return opid !== operationId;\n    },\n    oldDataTimestamp: definedOld.timestamp,\n    setAbortCallback(cb: () => void) {\n      const opid = globalState.get<\n        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  if (dataOrPromise instanceof Promise) {\n    return dataOrPromise.then((data) => {\n      finalizeLoad(data, path, globalState, operationId);\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\n  finalizeLoad(dataOrPromise, path, globalState, operationId);\n  return undefined;\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<\n    StateT, PathT> = 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  heap.reload ??= (\n    customLoader?: AsyncDataLoaderT<DataT>,\n  ): void | Promise<void> => {\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  if (globalState.ssrContext) {\n    if (\n      !options.disabled && !options.noSSR\n      && !state.operationId && !state.timestamp\n    ) {\n      const promiseOrVoid = load(path, loader, globalState, {\n        data: state.data,\n        timestamp: state.timestamp,\n      }, `S${uuid()}`);\n      if (promiseOrVoid instanceof Promise) {\n        globalState.ssrContext.pending.push(promiseOrVoid);\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 {\n            globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n          }\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.startsWith('S'))\n          )\n        ) {\n          if (!deps) globalState.dropDependencies(path ?? '');\n          void 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\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\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/useAsyncCollection.d.ts

@@ -8,8 +8,8 @@ export type AsyncCollectionLoaderT<DataT, IdT extends number | string = number |
     isAborted: () => boolean;
     oldDataTimestamp: number;
     setAbortCallback: (cb: () => void) => void;
-}) => DataT | Promise<DataT | null> | null;
-export type AsyncCollectionReloaderT<DataT, IdT extends number | string = number | string> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void>;
+}) => (DataT | null) | Promise<DataT | null>;
+export type AsyncCollectionReloaderT<DataT, IdT extends number | string = number | string> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | Promise<void>;
 type CollectionItemT<DataT> = {
     data: DataT | null;
     loading: boolean;

package/build/types/useAsyncData.d.ts

@@ -9,8 +9,8 @@ export type AsyncDataLoaderT<DataT> = (oldData: null | DataT, meta: {
     isAborted: () => boolean;
     oldDataTimestamp: number;
     setAbortCallback: (cb: () => void) => void;
-}) => DataT | Promise<DataT | null> | null;
-export type AsyncDataReloaderT<DataT> = (loader?: AsyncDataLoaderT<DataT>) => Promise<void>;
+}) => (DataT | null) | Promise<DataT | null>;
+export type AsyncDataReloaderT<DataT> = (loader?: AsyncDataLoaderT<DataT>) => void | Promise<void>;
 export type AsyncDataEnvelopeT<DataT> = {
     data: null | DataT;
     numRefs: number;
@@ -53,7 +53,7 @@ export type UseAsyncDataResT<DataT> = {
 export declare function load<DataT>(path: null | string | undefined, loader: AsyncDataLoaderT<DataT>, globalState: GlobalState<unknown, SsrContext<unknown>>, old?: {
     data: DataT | null;
     timestamp: number;
-}, operationId?: OperationIdT): Promise<void>;
+}, operationId?: OperationIdT): void | Promise<void>;
 /**
  * Resolves asynchronous data, and stores them at given `path` of global
  * state.

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@dr.pogodin/react-global-state",
-  "version": "0.19.0",
+  "version": "0.19.2",
   "description": "Hook-based global state for React",
   "main": "./build/code/index.js",
   "types": "./build/types/index.d.ts",
   "exports": {
+    "require": "./build/cjs/index.js",
     "default": "./build/code/index.js"
   },
   "scripts": {
-    "build": "rimraf build && npm run build:types && npm run build:code",
+    "build": "rimraf build && npm run build:types && npm run build:code && npm run build:cjs",
+    "build:cjs": "rimraf buidl/cjs && babel src -x .ts,.tsx --out-dir build/cjs --source-maps",
     "build:code": "rimraf build/code && babel src -x .ts,.tsx --out-dir build/code --source-maps --config-file ./babel.module.config.js",
     "build:types": "rimraf build/types && tsc --project tsconfig.types.json",
     "jest": "npm run jest:types && npm run jest:logic",