@dr.pogodin/react-global-state 0.17.0 → 0.17.1

package/build/common/GlobalState.js

@@ -8,6 +8,7 @@ var _lodash = require("lodash");
 var _utils = require("./utils");
 const ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';
 class GlobalState {
+  #asyncDataAbortCallbacks = {};
   #dependencies = {};
   #initialState;
 
@@ -47,6 +48,24 @@ class GlobalState {
     }
   }
 
+  /**
+   * Returns the number of currently registered async data abort callbacks,
+   * just for the sake of testing the library.
+   */
+  get numAsyncDataAbortCallbacks() {
+    return Object.keys(this.#asyncDataAbortCallbacks).length;
+  }
+
+  /**
+   * If `aborted` is "true" and there is an abort callback registered for
+   * the specified operation, it triggers the callback. Then, in any case,
+   * it drops the callback.
+   */
+  asyncDataLoadDone(opid, aborted) {
+    if (aborted) this.#asyncDataAbortCallbacks[opid]?.();
+    delete this.#asyncDataAbortCallbacks[opid];
+  }
+
   /**
    * Drops the record of dependencies, if any, for the given path.
    */
@@ -59,6 +78,11 @@ class GlobalState {
    * the given `path`. If they are, `deps` are recorded as the new deps for
    * the `path`, and also the array is frozen, to prevent it from being
    * modified.
+   *
+   * TODO: This may not work as expected if path string is not normalized,
+   * and the for the same path different alternative ways to spell it down
+   * are used. We should normalize given path here, I guess, or on a higher
+   * level in the logic?
    */
   hasChangedDependencies(path, deps) {
     const prevDeps = this.#dependencies[path];
@@ -111,6 +135,14 @@ class GlobalState {
     }
   }
 
+  /**
+   * Registers an abort callback for an async data retrieval operation with
+   * the given operation ID. Throws if already registered.
+   */
+  setAsyncDataAbortCallback(opid, cb) {
+    this.#asyncDataAbortCallbacks[opid] = cb;
+  }
+
   /**
    * Sets entire state, the same way as .set(null, value) would do.
    * @param value

package/build/common/GlobalState.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalState.js","names":["_lodash","require","_utils","ERR_NO_SSR_WATCH","GlobalState","dependencies","initialState","watchers","nextNotifierId","currentState","constructor","ssrContext","dirty","pending","state","process","env","NODE_ENV","isDebugMode","msg","console","groupCollapsed","log","cloneDeepForLog","groupEnd","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","length","i","Object","freeze","getEntireState","opts","undefined","initialValue","iv","isFunction","setEntireState","notifyStateUpdate","value","p","setTimeout","get","isNil","res","set","root","segIdx","pos","pathSegments","toPath","seg","next","Array","isArray","isObject","slice","unWatch","callback","Error","indexOf","pop","watch","push","exports","default"],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import {\n  get,\n  isFunction,\n  isObject,\n  isNil,\n  set,\n  toPath,\n} from 'lodash';\n\nimport SsrContext from './SsrContext';\n\nimport {\n  type CallbackT,\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  type ValueOrInitializerT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nconst ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';\n\ntype GetOptsT<T> = {\n  initialState?: boolean;\n  initialValue?: ValueOrInitializerT<T>;\n};\n\nexport default class GlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  readonly ssrContext?: SsrContextT;\n\n  #dependencies: { [key: string]: Readonly<any[]> } = {};\n\n  #initialState: StateT;\n\n  // TODO: It is tempting to replace watchers here by\n  // Emitter from @dr.pogodin/js-utils, but we need to clone\n  // current watchers for emitting later, and this is not something\n  // Emitter supports right now.\n  #watchers: CallbackT[] = [];\n\n  #nextNotifierId?: NodeJS.Timeout;\n\n  #currentState: StateT;\n\n  /**\n   * Creates a new global state object.\n   * @param initialState Intial global state content.\n   * @param ssrContext Server-side rendering context.\n   */\n  constructor(\n    initialState: StateT,\n    ssrContext?: SsrContextT,\n  ) {\n    this.#currentState = initialState;\n    this.#initialState = initialState;\n\n    if (ssrContext) {\n      /* eslint-disable no-param-reassign */\n      ssrContext.dirty = false;\n      ssrContext.pending = [];\n      ssrContext.state = this.#currentState;\n      /* eslint-enable no-param-reassign */\n\n      this.ssrContext = ssrContext;\n    }\n\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      let msg = 'New ReactGlobalState created';\n      if (ssrContext) msg += ' (SSR mode)';\n      console.groupCollapsed(msg);\n      console.log('Initial state:', cloneDeepForLog(initialState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n\n  /**\n   * Drops the record of dependencies, if any, for the given path.\n   */\n  dropDependencies(path: string) {\n    delete this.#dependencies[path];\n  }\n\n  /**\n   * Checks if given `deps` are different from previously recorded ones for\n   * the given `path`. If they are, `deps` are recorded as the new deps for\n   * the `path`, and also the array is frozen, to prevent it from being\n   * modified.\n   */\n  hasChangedDependencies(path: string, deps: any[]): boolean {\n    const prevDeps = this.#dependencies[path];\n    let changed = !prevDeps || prevDeps.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies[path] = Object.freeze(deps);\n    return changed;\n  }\n\n  /**\n   * Gets entire state, the same way as .get(null, opts) would do.\n   * @param opts.initialState\n   * @param opts.initialValue\n   */\n  getEntireState(opts?: GetOptsT<StateT>): StateT {\n    let state = opts?.initialState ? this.#initialState : this.#currentState;\n    if (state !== undefined || opts?.initialValue === undefined) return state;\n\n    const iv = opts.initialValue;\n    state = isFunction(iv) ? iv() : iv;\n    if (this.#currentState === undefined) this.setEntireState(state);\n    return state;\n  }\n\n  /**\n   * Notifies all connected state watchers that a state update has happened.\n   */\n  private notifyStateUpdate(path: null | string | undefined, value: unknown) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      const p = typeof path === 'string'\n        ? `\"${path}\"` : 'none (entire state update)';\n      console.groupCollapsed(`ReactGlobalState update. Path: ${p}`);\n      console.log('New value:', cloneDeepForLog(value, path ?? ''));\n      console.log('New state:', cloneDeepForLog(this.#currentState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n\n    if (this.ssrContext) {\n      this.ssrContext.dirty = true;\n      this.ssrContext.state = this.#currentState;\n    } else if (!this.#nextNotifierId) {\n      this.#nextNotifierId = setTimeout(() => {\n        this.#nextNotifierId = undefined;\n        const watchers = [...this.#watchers];\n        for (let i = 0; i < watchers.length; ++i) {\n          watchers[i]!();\n        }\n      });\n    }\n  }\n\n  /**\n   * Sets entire state, the same way as .set(null, value) would do.\n   * @param value\n   */\n  setEntireState(value: StateT): StateT {\n    if (this.#currentState !== value) {\n      this.#currentState = value;\n      this.notifyStateUpdate(null, value);\n    }\n    return value;\n  }\n\n  /**\n   * Gets current or initial value at the specified \"path\" of the global state.\n   * @param path Dot-delimitered state path.\n   * @param options Additional options.\n   * @param options.initialState If \"true\" the value will be read\n   *  from the initial state instead of the current one.\n   * @param options.initialValue If the value read from the \"path\" is\n   *  \"undefined\", this \"initialValue\" will be returned instead. In such case\n   *  \"initialValue\" will also be written to the \"path\" of the current global\n   *  state (no matter \"initialState\" flag), if \"undefined\" is stored there.\n   * @return Retrieved value.\n   */\n\n  // .get() without arguments just falls back to .getEntireState().\n  get(): StateT;\n\n  // This variant attempts to automatically resolve and check the type of value\n  // at the given path, as precise as the actual state and path types permit.\n  // If the automatic path resolution is not possible, the ValueT fallsback\n  // to `never` (or to `undefined` in some cases), effectively forbidding\n  // to use this .get() variant.\n  get<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, opts?: GetOptsT<ValueArgT>): ValueResT;\n\n  // This variant is not callable by default (without generic arguments),\n  // otherwise it allows to set the correct ValueT directly.\n  get<Forced extends ForceT | LockT = LockT, ValueT = void>(\n    path?: null | string,\n    opts?: GetOptsT<TypeLock<Forced, never, ValueT>>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  get<ValueT>(path?: null | string, opts?: GetOptsT<ValueT>): ValueT {\n    if (isNil(path)) {\n      const res = this.getEntireState((opts as unknown) as GetOptsT<StateT>);\n      return (res as unknown) as ValueT;\n    }\n\n    const state = opts?.initialState ? this.#initialState : this.#currentState;\n\n    let res = get(state, path);\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = isFunction(iv) ? iv() : iv;\n\n    if (!opts?.initialState || this.get(path) === undefined) {\n      this.set<ForceT, unknown>(path, res);\n    }\n\n    return res;\n  }\n\n  /**\n   * Writes the `value` to given global state `path`.\n   * @param path Dot-delimitered state path. If not given, entire\n   * global state content is replaced by the `value`.\n   * @param value The value.\n   * @return Given `value` itself.\n   */\n\n  // This variant attempts automatic value type resolution & checking.\n  set<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, value: ValueArgT): ValueResT;\n\n  // This variant is disabled by default, otherwise allows to give\n  // expected value type explicitly.\n  set<Forced extends ForceT | LockT = LockT, ValueT = never>(\n    path: null | string | undefined,\n    value: TypeLock<Forced, never, ValueT>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  set(path: null | string | undefined, value: unknown): unknown {\n    if (isNil(path)) return this.setEntireState(value as StateT);\n\n    if (value !== this.get(path)) {\n      const root = { state: this.#currentState };\n      let segIdx = 0;\n      let pos: any = root;\n      const pathSegments = toPath(`state.${path}`);\n      for (; segIdx < pathSegments.length - 1; segIdx += 1) {\n        const seg = pathSegments[segIdx]!;\n        const next = pos[seg];\n        if (Array.isArray(next)) pos[seg] = [...next];\n        else if (isObject(next)) pos[seg] = { ...next };\n        else {\n          // We arrived to a state sub-segment, where the remaining part of\n          // the update path does not exist yet. We rely on lodash's set()\n          // function to create the remaining path, and set the value.\n          set(pos, pathSegments.slice(segIdx), value);\n          break;\n        }\n        pos = pos[seg];\n      }\n\n      if (segIdx === pathSegments.length - 1) {\n        pos[pathSegments[segIdx]!] = value;\n      }\n\n      this.#currentState = root.state;\n\n      this.notifyStateUpdate(path, value);\n    }\n    return value;\n  }\n\n  /**\n   * Unsubscribes `callback` from watching state updates; no operation if\n   * `callback` is not subscribed to the state updates.\n   * @param callback\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  unWatch(callback: CallbackT) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    const pos = watchers.indexOf(callback);\n    if (pos >= 0) {\n      watchers[pos] = watchers[watchers.length - 1]!;\n      watchers.pop();\n    }\n  }\n\n  /**\n   * Subscribes `callback` to watch state updates; no operation if\n   * `callback` is already subscribed to this state instance.\n   * @param callback It will be called without any arguments every\n   * time the state content changes (note, howhever, separate state updates can\n   * be applied to the state at once, and watching callbacks will be called once\n   * after such bulk update).\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  watch(callback: CallbackT) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    if (watchers.indexOf(callback) < 0) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"GlobalState.js","names":["_lodash","require","_utils","ERR_NO_SSR_WATCH","GlobalState","asyncDataAbortCallbacks","dependencies","initialState","watchers","nextNotifierId","currentState","constructor","ssrContext","dirty","pending","state","process","env","NODE_ENV","isDebugMode","msg","console","groupCollapsed","log","cloneDeepForLog","groupEnd","numAsyncDataAbortCallbacks","Object","keys","length","asyncDataLoadDone","opid","aborted","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","i","freeze","getEntireState","opts","undefined","initialValue","iv","isFunction","setEntireState","notifyStateUpdate","value","p","setTimeout","setAsyncDataAbortCallback","cb","get","isNil","res","set","root","segIdx","pos","pathSegments","toPath","seg","next","Array","isArray","isObject","slice","unWatch","callback","Error","indexOf","pop","watch","push","exports","default"],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import {\n  get,\n  isFunction,\n  isObject,\n  isNil,\n  set,\n  toPath,\n} from 'lodash';\n\nimport SsrContext from './SsrContext';\n\nimport {\n  type CallbackT,\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  type ValueOrInitializerT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nconst ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';\n\ntype GetOptsT<T> = {\n  initialState?: boolean;\n  initialValue?: ValueOrInitializerT<T>;\n};\n\nexport default class GlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  readonly ssrContext?: SsrContextT;\n\n  #asyncDataAbortCallbacks: Record<string, () => void> = {};\n\n  #dependencies: { [key: string]: Readonly<any[]> } = {};\n\n  #initialState: StateT;\n\n  // TODO: It is tempting to replace watchers here by\n  // Emitter from @dr.pogodin/js-utils, but we need to clone\n  // current watchers for emitting later, and this is not something\n  // Emitter supports right now.\n  #watchers: CallbackT[] = [];\n\n  #nextNotifierId?: NodeJS.Timeout;\n\n  #currentState: StateT;\n\n  /**\n   * Creates a new global state object.\n   * @param initialState Intial global state content.\n   * @param ssrContext Server-side rendering context.\n   */\n  constructor(\n    initialState: StateT,\n    ssrContext?: SsrContextT,\n  ) {\n    this.#currentState = initialState;\n    this.#initialState = initialState;\n\n    if (ssrContext) {\n      /* eslint-disable no-param-reassign */\n      ssrContext.dirty = false;\n      ssrContext.pending = [];\n      ssrContext.state = this.#currentState;\n      /* eslint-enable no-param-reassign */\n\n      this.ssrContext = ssrContext;\n    }\n\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      let msg = 'New ReactGlobalState created';\n      if (ssrContext) msg += ' (SSR mode)';\n      console.groupCollapsed(msg);\n      console.log('Initial state:', cloneDeepForLog(initialState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n\n  /**\n   * Returns the number of currently registered async data abort callbacks,\n   * just for the sake of testing the library.\n   */\n  get numAsyncDataAbortCallbacks(): number {\n    return Object.keys(this.#asyncDataAbortCallbacks).length;\n  }\n\n  /**\n   * If `aborted` is \"true\" and there is an abort callback registered for\n   * the specified operation, it triggers the callback. Then, in any case,\n   * it drops the callback.\n   */\n  asyncDataLoadDone(opid: string, aborted: boolean) {\n    if (aborted) this.#asyncDataAbortCallbacks[opid]?.();\n    delete this.#asyncDataAbortCallbacks[opid];\n  }\n\n  /**\n   * Drops the record of dependencies, if any, for the given path.\n   */\n  dropDependencies(path: string) {\n    delete this.#dependencies[path];\n  }\n\n  /**\n   * Checks if given `deps` are different from previously recorded ones for\n   * the given `path`. If they are, `deps` are recorded as the new deps for\n   * the `path`, and also the array is frozen, to prevent it from being\n   * modified.\n   *\n   * TODO: This may not work as expected if path string is not normalized,\n   * and the for the same path different alternative ways to spell it down\n   * are used. We should normalize given path here, I guess, or on a higher\n   * level in the logic?\n   */\n  hasChangedDependencies(path: string, deps: any[]): boolean {\n    const prevDeps = this.#dependencies[path];\n    let changed = !prevDeps || prevDeps.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies[path] = Object.freeze(deps);\n    return changed;\n  }\n\n  /**\n   * Gets entire state, the same way as .get(null, opts) would do.\n   * @param opts.initialState\n   * @param opts.initialValue\n   */\n  getEntireState(opts?: GetOptsT<StateT>): StateT {\n    let state = opts?.initialState ? this.#initialState : this.#currentState;\n    if (state !== undefined || opts?.initialValue === undefined) return state;\n\n    const iv = opts.initialValue;\n    state = isFunction(iv) ? iv() : iv;\n    if (this.#currentState === undefined) this.setEntireState(state);\n    return state;\n  }\n\n  /**\n   * Notifies all connected state watchers that a state update has happened.\n   */\n  private notifyStateUpdate(path: null | string | undefined, value: unknown) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      const p = typeof path === 'string'\n        ? `\"${path}\"` : 'none (entire state update)';\n      console.groupCollapsed(`ReactGlobalState update. Path: ${p}`);\n      console.log('New value:', cloneDeepForLog(value, path ?? ''));\n      console.log('New state:', cloneDeepForLog(this.#currentState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n\n    if (this.ssrContext) {\n      this.ssrContext.dirty = true;\n      this.ssrContext.state = this.#currentState;\n    } else if (!this.#nextNotifierId) {\n      this.#nextNotifierId = setTimeout(() => {\n        this.#nextNotifierId = undefined;\n        const watchers = [...this.#watchers];\n        for (let i = 0; i < watchers.length; ++i) {\n          watchers[i]!();\n        }\n      });\n    }\n  }\n\n  /**\n   * Registers an abort callback for an async data retrieval operation with\n   * the given operation ID. Throws if already registered.\n   */\n  setAsyncDataAbortCallback(opid: string, cb: () => void) {\n    this.#asyncDataAbortCallbacks[opid] = cb;\n  }\n\n  /**\n   * Sets entire state, the same way as .set(null, value) would do.\n   * @param value\n   */\n  setEntireState(value: StateT): StateT {\n    if (this.#currentState !== value) {\n      this.#currentState = value;\n      this.notifyStateUpdate(null, value);\n    }\n    return value;\n  }\n\n  /**\n   * Gets current or initial value at the specified \"path\" of the global state.\n   * @param path Dot-delimitered state path.\n   * @param options Additional options.\n   * @param options.initialState If \"true\" the value will be read\n   *  from the initial state instead of the current one.\n   * @param options.initialValue If the value read from the \"path\" is\n   *  \"undefined\", this \"initialValue\" will be returned instead. In such case\n   *  \"initialValue\" will also be written to the \"path\" of the current global\n   *  state (no matter \"initialState\" flag), if \"undefined\" is stored there.\n   * @return Retrieved value.\n   */\n\n  // .get() without arguments just falls back to .getEntireState().\n  get(): StateT;\n\n  // This variant attempts to automatically resolve and check the type of value\n  // at the given path, as precise as the actual state and path types permit.\n  // If the automatic path resolution is not possible, the ValueT fallsback\n  // to `never` (or to `undefined` in some cases), effectively forbidding\n  // to use this .get() variant.\n  get<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, opts?: GetOptsT<ValueArgT>): ValueResT;\n\n  // This variant is not callable by default (without generic arguments),\n  // otherwise it allows to set the correct ValueT directly.\n  get<Forced extends ForceT | LockT = LockT, ValueT = void>(\n    path?: null | string,\n    opts?: GetOptsT<TypeLock<Forced, never, ValueT>>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  get<ValueT>(path?: null | string, opts?: GetOptsT<ValueT>): ValueT {\n    if (isNil(path)) {\n      const res = this.getEntireState((opts as unknown) as GetOptsT<StateT>);\n      return (res as unknown) as ValueT;\n    }\n\n    const state = opts?.initialState ? this.#initialState : this.#currentState;\n\n    let res = get(state, path);\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = isFunction(iv) ? iv() : iv;\n\n    if (!opts?.initialState || this.get(path) === undefined) {\n      this.set<ForceT, unknown>(path, res);\n    }\n\n    return res;\n  }\n\n  /**\n   * Writes the `value` to given global state `path`.\n   * @param path Dot-delimitered state path. If not given, entire\n   * global state content is replaced by the `value`.\n   * @param value The value.\n   * @return Given `value` itself.\n   */\n\n  // This variant attempts automatic value type resolution & checking.\n  set<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, value: ValueArgT): ValueResT;\n\n  // This variant is disabled by default, otherwise allows to give\n  // expected value type explicitly.\n  set<Forced extends ForceT | LockT = LockT, ValueT = never>(\n    path: null | string | undefined,\n    value: TypeLock<Forced, never, ValueT>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  set(path: null | string | undefined, value: unknown): unknown {\n    if (isNil(path)) return this.setEntireState(value as StateT);\n\n    if (value !== this.get(path)) {\n      const root = { state: this.#currentState };\n      let segIdx = 0;\n      let pos: any = root;\n      const pathSegments = toPath(`state.${path}`);\n      for (; segIdx < pathSegments.length - 1; segIdx += 1) {\n        const seg = pathSegments[segIdx]!;\n        const next = pos[seg];\n        if (Array.isArray(next)) pos[seg] = [...next];\n        else if (isObject(next)) pos[seg] = { ...next };\n        else {\n          // We arrived to a state sub-segment, where the remaining part of\n          // the update path does not exist yet. We rely on lodash's set()\n          // function to create the remaining path, and set the value.\n          set(pos, pathSegments.slice(segIdx), value);\n          break;\n        }\n        pos = pos[seg];\n      }\n\n      if (segIdx === pathSegments.length - 1) {\n        pos[pathSegments[segIdx]!] = value;\n      }\n\n      this.#currentState = root.state;\n\n      this.notifyStateUpdate(path, value);\n    }\n    return value;\n  }\n\n  /**\n   * Unsubscribes `callback` from watching state updates; no operation if\n   * `callback` is not subscribed to the state updates.\n   * @param callback\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  unWatch(callback: CallbackT) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    const pos = watchers.indexOf(callback);\n    if (pos >= 0) {\n      watchers[pos] = watchers[watchers.length - 1]!;\n      watchers.pop();\n    }\n  }\n\n  /**\n   * Subscribes `callback` to watch state updates; no operation if\n   * `callback` is already subscribed to this state instance.\n   * @param callback It will be called without any arguments every\n   * time the state content changes (note, howhever, separate state updates can\n   * be applied to the state at once, and watching callbacks will be called once\n   * after such bulk update).\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  watch(callback: CallbackT) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    if (watchers.indexOf(callback) < 0) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/common/useAsyncCollection.js

@@ -184,7 +184,6 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     // special case the otherwise wrong behavior is actually what we need.
 
     // Data loading and refreshing.
-    const loadTriggeredForIds = new Set();
     (0, _react.useEffect)(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
       (async () => {
@@ -197,7 +196,6 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
           } = options;
           if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt(0) === 'S')) {
             if (!deps) globalState.dropDependencies(itemPath);
-            loadTriggeredForIds.add(id);
             // eslint-disable-next-line no-await-in-loop
             await (0, _useAsyncData.load)(itemPath, (...args) => loader(id, ...args), globalState, {
               data: state2.data,
@@ -207,26 +205,6 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
         }
       })();
     });
-    (0, _react.useEffect)(() => {
-      // eslint-disable-line react-hooks/rules-of-hooks
-      (async () => {
-        const {
-          deps
-        } = options;
-        for (let i = 0; i < ids.length; ++i) {
-          const id = ids[i];
-          const itemPath = path ? `${path}.${id}` : `${id}`;
-          if (deps && globalState.hasChangedDependencies(itemPath || '', deps) && !loadTriggeredForIds.has(id)) {
-            // eslint-disable-next-line no-await-in-loop
-            await (0, _useAsyncData.load)(itemPath, (oldData, meta) => loader(id, oldData, meta), globalState);
-          }
-        }
-      })();
-
-      // Here we need to default to empty array, so that this hook is re-evaluated
-      // only when dependencies specified in options change, and it should not be
-      // re-evaluated at all if no `deps` option is used.
-    }, options.deps || []); // eslint-disable-line react-hooks/exhaustive-deps
   }
   const [localState] = (0, _useGlobalState.default)(path, {});
   if (!Array.isArray(idOrIds)) {

package/build/common/useAsyncCollection.js.map

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

package/build/common/useAsyncData.js

@@ -45,13 +45,22 @@ function newAsyncDataEnvelope(initialData = null, {
  * @return Resolves once the operation is done.
  * @ignore
  */
-async function load(path, loader, globalState, old, operationId = `C${(0, _uuid.v4)()}`) {
+async function load(path, loader, globalState, old,
+// TODO: Should this parameter be just a binary flag (client or server),
+// and UUID always generated inside this function? Or do we need it in
+// the caller methods as well, in some cases (see useAsyncCollection()
+// use case as well).
+operationId = `C${(0, _uuid.v4)()}`) {
   if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
     /* eslint-disable no-console */
     console.log(`ReactGlobalState: async data (re-)loading. Path: "${path || ''}"`);
     /* eslint-enable no-console */
   }
   const operationIdPath = path ? `${path}.operationId` : 'operationId';
+  {
+    const prevOperationId = globalState.get(operationIdPath);
+    if (prevOperationId) globalState.asyncDataLoadDone(prevOperationId, true);
+  }
   globalState.set(operationIdPath, operationId);
   let definedOld = old;
   if (!definedOld) {
@@ -68,9 +77,24 @@ async function load(path, loader, globalState, old, operationId = `C${(0, _uuid.
       const opid = globalState.get(path).operationId;
       return opid !== operationId;
     },
-    oldDataTimestamp: definedOld.timestamp
+    oldDataTimestamp: definedOld.timestamp,
+    setAbortCallback(cb) {
+      const opid = globalState.get(path).operationId;
+      if (opid !== operationId) {
+        throw Error(`Operation #${operationId} has completed already`);
+      }
+      globalState.setAsyncDataAbortCallback(operationId, cb);
+    }
   });
-  const data = dataOrPromise instanceof Promise ? await dataOrPromise : dataOrPromise;
+  let data;
+  try {
+    data = dataOrPromise instanceof Promise ? await dataOrPromise : dataOrPromise;
+  } finally {
+    // NOTE: We don't really mean that it hasn't been aborted,
+    // the "false" flag rather says we don't need to trigger "on aborted"
+    // callback for this operation, if any is registered - just drop it.
+    globalState.asyncDataLoadDone(operationId, false);
+  }
   const state = globalState.get(path);
   if (operationId === state.operationId) {
     if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
@@ -167,7 +191,6 @@ function useAsyncData(path, loader, options = {}) {
     // special case the otherwise wrong behavior is actually what we need.
 
     // Data loading and refreshing.
-    let loadTriggered = false;
     (0, _react.useEffect)(() => {
       // eslint-disable-line react-hooks/rules-of-hooks
       const state2 = globalState.get(path);
@@ -181,7 +204,6 @@ function useAsyncData(path, loader, options = {}) {
 
       // Data at the path are stale, and are not being loaded.
       || refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt(0) === 'S')) {
-        loadTriggered = true; // eslint-disable-line react-hooks/exhaustive-deps
         if (!deps) globalState.dropDependencies(path || '');
         load(path, loader, globalState, {
           data: state2.data,
@@ -189,19 +211,6 @@ function useAsyncData(path, loader, options = {}) {
         });
       }
     });
-    (0, _react.useEffect)(() => {
-      // eslint-disable-line react-hooks/rules-of-hooks
-      const {
-        deps
-      } = options;
-      if (deps && globalState.hasChangedDependencies(path || '', deps) && !loadTriggered) {
-        load(path, loader, globalState);
-      }
-
-      // Here we need to default to empty array, so that this hook is re-evaluated
-      // only when dependencies specified in options change, and it should not be
-      // re-evaluated at all if no `deps` option is used.
-    }, options.deps || []); // eslint-disable-line react-hooks/exhaustive-deps
   }
   const [localState] = (0, _useGlobalState.default)(path, newAsyncDataEnvelope());
   return {

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","set","definedOld","e","get","dataOrPromise","isAborted","opid","oldDataTimestamp","Promise","state","groupCollapsed","cloneDeepForLog","Date","now","groupEnd","useAsyncData","options","maxage","refreshAge","garbageCollectAge","getGlobalState","initialValue","current","heap","useRef","reload","customLoader","localLoader","Error","ssrContext","noSSR","pending","push","useEffect","numRefsPath","state2","dropDependencies","loadTriggered","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}) => 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  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  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  });\n\n  const data: DataT | null = dataOrPromise instanceof Promise\n    ? await dataOrPromise : dataOrPromise;\n\n  const state: AsyncDataEnvelopeT<DataT> = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path);\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    let loadTriggered = false;\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        loadTriggered = true; // eslint-disable-line react-hooks/exhaustive-deps\n        if (!deps) globalState.dropDependencies(path || '');\n        load(path, loader, globalState, {\n          data: state2.data,\n          timestamp: state2.timestamp,\n        });\n      }\n    });\n\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      const { deps } = options;\n      if (\n        deps\n        && globalState.hasChangedDependencies(path || '', deps)\n        && !loadTriggered\n      ) {\n        load(path, loader, globalState);\n      }\n\n    // Here we need to default to empty array, so that this hook is re-evaluated\n    // only when dependencies specified in options change, and it should not be\n    // re-evaluated at all if no `deps` option is used.\n    }, options.deps || []); // eslint-disable-line react-hooks/exhaustive-deps\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","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  const state: AsyncDataEnvelopeT<DataT> = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(path);\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":[]}

package/build/module/GlobalState.js

@@ -6,6 +6,7 @@ function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.h
 import { get, isFunction, isObject, isNil, set, toPath } from 'lodash';
 import { cloneDeepForLog, isDebugMode } from "./utils";
 const ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';
+var _asyncDataAbortCallbacks = /*#__PURE__*/new WeakMap();
 var _dependencies = /*#__PURE__*/new WeakMap();
 var _initialState = /*#__PURE__*/new WeakMap();
 var _watchers = /*#__PURE__*/new WeakMap();
@@ -18,6 +19,7 @@ export default class GlobalState {
    * @param ssrContext Server-side rendering context.
    */
   constructor(initialState, ssrContext) {
+    _classPrivateFieldInitSpec(this, _asyncDataAbortCallbacks, {});
     _classPrivateFieldInitSpec(this, _dependencies, {});
     _classPrivateFieldInitSpec(this, _initialState, void 0);
     // TODO: It is tempting to replace watchers here by
@@ -49,6 +51,25 @@ export default class GlobalState {
     }
   }
 
+  /**
+   * Returns the number of currently registered async data abort callbacks,
+   * just for the sake of testing the library.
+   */
+  get numAsyncDataAbortCallbacks() {
+    return Object.keys(_classPrivateFieldGet(_asyncDataAbortCallbacks, this)).length;
+  }
+
+  /**
+   * If `aborted` is "true" and there is an abort callback registered for
+   * the specified operation, it triggers the callback. Then, in any case,
+   * it drops the callback.
+   */
+  asyncDataLoadDone(opid, aborted) {
+    var _classPrivateFieldGet2, _classPrivateFieldGet3;
+    if (aborted) (_classPrivateFieldGet2 = (_classPrivateFieldGet3 = _classPrivateFieldGet(_asyncDataAbortCallbacks, this))[opid]) === null || _classPrivateFieldGet2 === void 0 || _classPrivateFieldGet2.call(_classPrivateFieldGet3);
+    delete _classPrivateFieldGet(_asyncDataAbortCallbacks, this)[opid];
+  }
+
   /**
    * Drops the record of dependencies, if any, for the given path.
    */
@@ -61,6 +82,11 @@ export default class GlobalState {
    * the given `path`. If they are, `deps` are recorded as the new deps for
    * the `path`, and also the array is frozen, to prevent it from being
    * modified.
+   *
+   * TODO: This may not work as expected if path string is not normalized,
+   * and the for the same path different alternative ways to spell it down
+   * are used. We should normalize given path here, I guess, or on a higher
+   * level in the logic?
    */
   hasChangedDependencies(path, deps) {
     const prevDeps = _classPrivateFieldGet(_dependencies, this)[path];
@@ -113,6 +139,14 @@ export default class GlobalState {
     }
   }
 
+  /**
+   * Registers an abort callback for an async data retrieval operation with
+   * the given operation ID. Throws if already registered.
+   */
+  setAsyncDataAbortCallback(opid, cb) {
+    _classPrivateFieldGet(_asyncDataAbortCallbacks, this)[opid] = cb;
+  }
+
   /**
    * Sets entire state, the same way as .set(null, value) would do.
    * @param value