@dr.pogodin/react-global-state 0.21.4 → 0.23.0

package/build/code/GlobalState.js

@@ -19,8 +19,8 @@ export default class GlobalState {
    * @param ssrContext Server-side rendering context.
    */
   constructor(initialState, ssrContext) {
-    _classPrivateFieldInitSpec(this, _asyncDataAbortCallbacks, {});
-    _classPrivateFieldInitSpec(this, _dependencies, {});
+    _classPrivateFieldInitSpec(this, _asyncDataAbortCallbacks, new Map());
+    _classPrivateFieldInitSpec(this, _dependencies, new Map());
     _classPrivateFieldInitSpec(this, _initialState, void 0);
     // TODO: It is tempting to replace watchers here by
     // Emitter from @dr.pogodin/js-utils, but we need to clone
@@ -56,7 +56,7 @@ export default class GlobalState {
    * just for the sake of testing the library.
    */
   get numAsyncDataAbortCallbacks() {
-    return Object.keys(_classPrivateFieldGet(_asyncDataAbortCallbacks, this)).length;
+    return _classPrivateFieldGet(_asyncDataAbortCallbacks, this).size;
   }
 
   /**
@@ -65,16 +65,16 @@ export default class GlobalState {
    * 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];
+    var _classPrivateFieldGet2;
+    if (aborted) (_classPrivateFieldGet2 = _classPrivateFieldGet(_asyncDataAbortCallbacks, this).get(opid)) === null || _classPrivateFieldGet2 === void 0 || _classPrivateFieldGet2();
+    _classPrivateFieldGet(_asyncDataAbortCallbacks, this).delete(opid);
   }
 
   /**
    * Drops the record of dependencies, if any, for the given path.
    */
   dropDependencies(path) {
-    delete _classPrivateFieldGet(_dependencies, this)[path];
+    _classPrivateFieldGet(_dependencies, this).delete(path);
   }
 
   /**
@@ -89,12 +89,12 @@ export default class GlobalState {
    * level in the logic?
    */
   hasChangedDependencies(path, deps) {
-    const prevDeps = _classPrivateFieldGet(_dependencies, this)[path];
+    const prevDeps = _classPrivateFieldGet(_dependencies, this).get(path);
     let changed = (prevDeps === null || prevDeps === void 0 ? void 0 : prevDeps.length) !== deps.length;
     for (let i = 0; !changed && i < deps.length; ++i) {
       changed = prevDeps[i] !== deps[i];
     }
-    _classPrivateFieldGet(_dependencies, this)[path] = Object.freeze(deps);
+    _classPrivateFieldGet(_dependencies, this).set(path, Object.freeze(deps));
     return changed;
   }
 
@@ -142,7 +142,7 @@ export default class GlobalState {
    * the given operation ID. Throws if already registered.
    */
   setAsyncDataAbortCallback(opid, cb) {
-    _classPrivateFieldGet(_asyncDataAbortCallbacks, this)[opid] = cb;
+    _classPrivateFieldGet(_asyncDataAbortCallbacks, this).set(opid, cb);
   }
 
   /**

package/build/code/GlobalState.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalState.js","names":["get","set","toPath","cloneDeepForLog","isDebugMode","ERR_NO_SSR_WATCH","_asyncDataAbortCallbacks","WeakMap","_dependencies","_initialState","_watchers","_nextNotifierId","_currentState","GlobalState","constructor","initialState","ssrContext","_classPrivateFieldInitSpec","_classPrivateFieldSet","dirty","pending","state","_classPrivateFieldGet","process","env","NODE_ENV","msg","console","groupCollapsed","log","groupEnd","numAsyncDataAbortCallbacks","Object","keys","length","asyncDataLoadDone","opid","aborted","_classPrivateFieldGet2","_classPrivateFieldGet3","call","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","i","freeze","getEntireState","opts","undefined","initialValue","iv","setEntireState","notifyStateUpdate","value","p","setTimeout","watchers","watcher","setAsyncDataAbortCallback","cb","res","root","segIdx","pos","pathSegments","seg","next","Array","isArray","slice","unWatch","callback","Error","indexOf","pop","watch","includes","push"],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import { get, set, toPath } from 'lodash-es';\n\nimport type 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: Record<string, readonly unknown[]> = {};\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): void {\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): void {\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: unknown[]): boolean {\n    const prevDeps = this.#dependencies[path];\n    let changed = 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 = typeof iv === 'function' ? (iv as () => StateT)() : 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 (const watcher of watchers) watcher();\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): 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 (typeof path !== 'string') {\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) as ValueT;\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = typeof iv === 'function' ? (iv as () => ValueT)() : iv;\n\n    // TODO: Revise.\n    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n    if (!opts.initialState || (this.get(path) as unknown) === 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 (typeof path !== 'string') return this.setEntireState(value as StateT);\n\n    // TODO: Revise.\n    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n    if (value !== this.get(path)) {\n      const root = { state: this.#currentState };\n      let segIdx = 0;\n\n      // TODO: It is not 100% correct, as `pos` can be an array, or any other\n      // value as we travel through the state tree. To simplify the typing for\n      // now, I guess, we can go with this record type, though.\n      let pos: Record<string, unknown> = root;\n      const pathSegments = toPath(`state.${path}`);\n      for (; segIdx < pathSegments.length - 1; segIdx += 1) {\n        const seg = pathSegments[segIdx]!;\n\n        // TODO: Revise: Typing is not quite correct here, but it works fine in the runtime.\n        const next = pos[seg];\n        if (Array.isArray(next)) pos[seg] = [...(next as unknown[])];\n        else if (typeof next === 'object') 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] as Record<string, unknown>;\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): void {\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): void {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    if (!watchers.includes(callback)) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"GlobalState.js","names":["get","set","toPath","cloneDeepForLog","isDebugMode","ERR_NO_SSR_WATCH","_asyncDataAbortCallbacks","WeakMap","_dependencies","_initialState","_watchers","_nextNotifierId","_currentState","GlobalState","constructor","initialState","ssrContext","_classPrivateFieldInitSpec","Map","_classPrivateFieldSet","dirty","pending","state","_classPrivateFieldGet","process","env","NODE_ENV","msg","console","groupCollapsed","log","groupEnd","numAsyncDataAbortCallbacks","size","asyncDataLoadDone","opid","aborted","_classPrivateFieldGet2","delete","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","length","i","Object","freeze","getEntireState","opts","undefined","initialValue","iv","setEntireState","notifyStateUpdate","value","p","setTimeout","watchers","watcher","setAsyncDataAbortCallback","cb","res","root","segIdx","pos","pathSegments","seg","next","Array","isArray","slice","unWatch","callback","Error","indexOf","pop","watch","includes","push"],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import { get, set, toPath } from 'lodash-es';\n\nimport type 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 = new Map<string, () => void>();\n\n  #dependencies = new Map<string, readonly unknown[]>();\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 this.#asyncDataAbortCallbacks.size;\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): void {\n    if (aborted) this.#asyncDataAbortCallbacks.get(opid)?.();\n    this.#asyncDataAbortCallbacks.delete(opid);\n  }\n\n  /**\n   * Drops the record of dependencies, if any, for the given path.\n   */\n  dropDependencies(path: string): void {\n    this.#dependencies.delete(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: unknown[]): boolean {\n    const prevDeps = this.#dependencies.get(path);\n    let changed = prevDeps?.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies.set(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 = typeof iv === 'function' ? (iv as () => StateT)() : 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 (const watcher of watchers) watcher();\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): void {\n    this.#asyncDataAbortCallbacks.set(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 (typeof path !== 'string') {\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) as ValueT;\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = typeof iv === 'function' ? (iv as () => ValueT)() : iv;\n\n    // TODO: Revise.\n    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n    if (!opts.initialState || (this.get(path) as unknown) === 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 (typeof path !== 'string') return this.setEntireState(value as StateT);\n\n    // TODO: Revise.\n    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n    if (value !== this.get(path)) {\n      const root = { state: this.#currentState };\n      let segIdx = 0;\n\n      // TODO: It is not 100% correct, as `pos` can be an array, or any other\n      // value as we travel through the state tree. To simplify the typing for\n      // now, I guess, we can go with this record type, though.\n      let pos: Record<string, unknown> = root;\n      const pathSegments = toPath(`state.${path}`);\n      for (; segIdx < pathSegments.length - 1; segIdx += 1) {\n        const seg = pathSegments[segIdx]!;\n\n        // TODO: Revise: Typing is not quite correct here, but it works fine in the runtime.\n        const next = pos[seg];\n        if (Array.isArray(next)) pos[seg] = [...(next as unknown[])];\n        else if (typeof next === 'object') 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] as Record<string, unknown>;\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): void {\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): void {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    if (!watchers.includes(callback)) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/code/useAsyncCollection.js

@@ -3,7 +3,6 @@
  */
 
 import { useEffect, useRef, useState } from 'react';
-import { v4 as uuid } from 'uuid';
 import { getGlobalState } from "./GlobalStateProvider.js";
 import { DEFAULT_MAXAGE, loadAsyncData, newAsyncDataEnvelope } from "./useAsyncData.js";
 import useGlobalState from "./useGlobalState.js";
@@ -102,7 +101,7 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
   // Server-side logic.
   if (globalState.ssrContext) {
     if (!options.disabled && !options.noSSR) {
-      const operationId = `S${uuid()}`;
+      const operationId = `S${globalThis.crypto.randomUUID()}`;
       for (const id of ids) {
         const itemPath = path ? `${path}.${id}` : `${id}`;
         const state = globalState.get(itemPath, {

package/build/code/useAsyncCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncCollection.js","names":["useEffect","useRef","useState","v4","uuid","getGlobalState","DEFAULT_MAXAGE","loadAsyncData","newAsyncDataEnvelope","useGlobalState","hash","isDebugMode","gcOnWithhold","ids","path","gs","collection","get","id","envelope","numRefs","set","idsToStringSet","res","Set","add","toString","gcOnRelease","gcAge","entries","Object","now","Date","idSet","toBeReleased","has","timestamp","process","env","NODE_ENV","console","log","normalizeIds","idOrIds","Array","isArray","from","sort","a","b","localeCompare","useAsyncCollection","loader","options","_options$maxage","_options$refreshAge","_options$garbageColle","_ref$current","maxage","refreshAge","garbageCollectAge","globalState","ssrContext","disabled","noSSR","operationId","itemPath","state","initialValue","promiseOrVoid","args","data","Promise","pending","push","idsHash","_state2$timestamp","state2","deps","hasChangedDependencies","startsWith","_state2$data","_state2$timestamp2","dropDependencies","old","localState","ref","current","stable","reload","customLoader","rc","Error","localLoader","oldData","meta","reloadSingle","setSingle","_e$timestamp","_e$data","e","loading","items","Number","MAX_VALUE","_e$timestamp2","_e$data2"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef, useState } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport type GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  DEFAULT_MAXAGE,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  loadAsyncData,\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> = Partial<Record<IdT, AsyncDataEnvelopeT<DataT>>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: DataT | null, 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> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void> | 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: Record<IdT, CollectionItemT<DataT>>;\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype CurrentT<DataT, IdT extends number | string> = {\n  globalState: GlobalState<unknown>;\n  ids: IdT[];\n  loader: AsyncCollectionLoaderT<DataT, IdT>;\n  path: null | string | undefined;\n};\n\ntype StableT<DataT, IdT extends number | string> = {\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadSingle: AsyncDataReloaderT<DataT>;\n  setSingle: (data: DataT | null) => void;\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 (const id of ids) {\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 (const id of ids) {\n    res.add(id.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 (const [id, envelope] of entries) {\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    // Removes ID duplicates.\n    const res = Array.from(new Set(idOrIds));\n\n    // Ensures stable ID order.\n    res.sort((a, b) => a.toString().localeCompare(b.toString()));\n\n    return res;\n  }\n  return [idOrIds];\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}`> = 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}`> = 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\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT | IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT> | UseAsyncDataResT<DataT>;\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.\n// eslint-disable-next-line complexity\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): UseAsyncCollectionResT<DataT, IdT> | UseAsyncDataResT<DataT> {\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  // Server-side logic.\n  if (globalState.ssrContext) {\n    if (!options.disabled && !options.noSSR) {\n      const operationId: OperationIdT = `S${uuid()}`;\n      for (const id of ids) {\n        const itemPath = path ? `${path}.${id}` : `${id}`;\n        const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n          itemPath,\n          {\n            initialValue: newAsyncDataEnvelope<DataT>(),\n          },\n        );\n        if (!state.timestamp && !state.operationId) {\n          const promiseOrVoid = loadAsyncData<ForceT, DataT>(\n            itemPath,\n            (...args):\n              DataT | Promise<DataT | null> | null => loader(id, ...args),\n            globalState,\n            {\n              data: state.data,\n              timestamp: state.timestamp,\n            },\n            operationId,\n          );\n\n          if (promiseOrVoid instanceof Promise) {\n            globalState.ssrContext.pending.push(promiseOrVoid);\n          }\n        }\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    const { disabled } = options;\n\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      if (!disabled) gcOnWithhold(ids, path, globalState);\n      return () => {\n        if (!disabled) gcOnRelease(ids, path, globalState, garbageCollectAge);\n      };\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      disabled,\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      if (!disabled) {\n        void (async () => {\n          for (const id of ids) {\n            const itemPath = path ? `${path}.${id}` : `${id}`;\n\n            type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n            const state2: EnvT = globalState.get<ForceT, EnvT>(itemPath);\n\n            const { deps } = options;\n            if (\n              (deps && globalState.hasChangedDependencies(itemPath, deps))\n              || (\n                refreshAge < Date.now() - (state2?.timestamp ?? 0)\n                && (!state2?.operationId || state2.operationId.startsWith('S'))\n              )\n            ) {\n              if (!deps) globalState.dropDependencies(itemPath);\n              await loadAsyncData<ForceT, DataT>(\n                itemPath,\n                // TODO: I guess, the loader is not correctly typed here -\n                // it can be synchronous, and in that case the following method\n                // should be kept synchronous to not alter the sync logic.\n                // eslint-disable-next-line @typescript-eslint/promise-function-async\n                (old, ...args) => loader(id, old as DataT, ...args),\n                globalState,\n                {\n                  data: state2?.data ?? null,\n                  timestamp: state2?.timestamp ?? 0,\n                },\n              );\n            }\n          }\n        })();\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<\n    ForceT, Record<string, AsyncDataEnvelopeT<DataT>>\n  >(path, {});\n\n  const ref = useRef<CurrentT<DataT, IdT>>(null);\n\n  ref.current ??= {\n    globalState,\n    ids,\n    loader,\n    path,\n  };\n\n  useEffect(() => {\n    ref.current = {\n      globalState,\n      ids,\n      loader,\n      path,\n    };\n  }, [globalState, ids, loader, path]);\n\n  const [stable] = useState<StableT<DataT, IdT>>(() => {\n    const reload = async (\n      customLoader?: AsyncCollectionLoaderT<DataT, IdT>,\n    ) => {\n      const rc = ref.current;\n      if (!rc) throw Error('Internal error');\n\n      const localLoader = customLoader ?? rc.loader;\n\n      // TODO: Revise - not sure all related typing is 100% correct,\n      // thus let's keep this runtime assertion.\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!localLoader || !rc.globalState || !rc.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of rc.ids) {\n        const itemPath = rc.path ? `${rc.path}.${id}` : `${id}`;\n\n        const promiseOrVoid = loadAsyncData<ForceT, DataT>(\n          itemPath,\n          // TODO: Revise! Most probably we don't have fully correct loader\n          // typing, as it may return either promise or value, and those two\n          // cases call for different runtime behavior, which in turns only\n          // happens if the outer function on the next line matches the same\n          // async / sync signature.\n          // eslint-disable-next-line @typescript-eslint/promise-function-async\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          rc.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n\n    // TODO: Revise! Most probably we don't have fully correct loader\n    // typing, as it may return either promise or value, and those two\n    // cases call for different runtime behavior, which in turns only\n    // happens if the outer function on the next line matches the same\n    // async / sync signature.\n    // eslint-disable-next-line @typescript-eslint/promise-function-async\n    const reloadSingle: AsyncDataReloaderT<DataT> = (customLoader) => reload(\n      // TODO: Revise! Most probably we don't have fully correct loader\n      // typing, as it may return either promise or value, and those two\n      // cases call for different runtime behavior, which in turns only\n      // happens if the outer function on the next line matches the same\n      // async / sync signature.\n      // eslint-disable-next-line @typescript-eslint/promise-function-async\n      customLoader && ((id, ...args) => customLoader(...args)),\n    );\n\n    const setSingle = (data: DataT | null) => {\n      void reload(() => data);\n    };\n\n    return { reload, reloadSingle, setSingle };\n  });\n\n  if (!Array.isArray(idOrIds)) {\n    // TODO: Revise related typings!\n    const e = localState[idOrIds as string];\n    const timestamp = e?.timestamp ?? 0;\n    return {\n      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,\n      loading: !!e?.operationId,\n      reload: stable.reloadSingle,\n      set: stable.setSingle,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: stable.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (const id of ids) {\n    // TODO: Revise related typing. Should `localState` have a more specific type?\n    const e = localState[id as string];\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\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\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  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT | IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>\n    | UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useAsyncCollection.js","names":["useEffect","useRef","useState","getGlobalState","DEFAULT_MAXAGE","loadAsyncData","newAsyncDataEnvelope","useGlobalState","hash","isDebugMode","gcOnWithhold","ids","path","gs","collection","get","id","envelope","numRefs","set","idsToStringSet","res","Set","add","toString","gcOnRelease","gcAge","entries","Object","now","Date","idSet","toBeReleased","has","timestamp","process","env","NODE_ENV","console","log","normalizeIds","idOrIds","Array","isArray","from","sort","a","b","localeCompare","useAsyncCollection","loader","options","_options$maxage","_options$refreshAge","_options$garbageColle","_ref$current","maxage","refreshAge","garbageCollectAge","globalState","ssrContext","disabled","noSSR","operationId","globalThis","crypto","randomUUID","itemPath","state","initialValue","promiseOrVoid","args","data","Promise","pending","push","idsHash","_state2$timestamp","state2","deps","hasChangedDependencies","startsWith","_state2$data","_state2$timestamp2","dropDependencies","old","localState","ref","current","stable","reload","customLoader","rc","Error","localLoader","oldData","meta","reloadSingle","setSingle","_e$timestamp","_e$data","e","loading","items","Number","MAX_VALUE","_e$timestamp2","_e$data2"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef, useState } from 'react';\n\nimport type GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  DEFAULT_MAXAGE,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  loadAsyncData,\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> = Partial<Record<IdT, AsyncDataEnvelopeT<DataT>>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: DataT | null, meta: {\n  abortSignal: AbortSignal;\n  oldDataTimestamp: number;\n}) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void> | 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: Record<IdT, CollectionItemT<DataT>>;\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype CurrentT<DataT, IdT extends number | string> = {\n  globalState: GlobalState<unknown>;\n  ids: IdT[];\n  loader: AsyncCollectionLoaderT<DataT, IdT>;\n  path: null | string | undefined;\n};\n\ntype StableT<DataT, IdT extends number | string> = {\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadSingle: AsyncDataReloaderT<DataT>;\n  setSingle: (data: DataT | null) => void;\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 (const id of ids) {\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 (const id of ids) {\n    res.add(id.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 (const [id, envelope] of entries) {\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    // Removes ID duplicates.\n    const res = Array.from(new Set(idOrIds));\n\n    // Ensures stable ID order.\n    res.sort((a, b) => a.toString().localeCompare(b.toString()));\n\n    return res;\n  }\n  return [idOrIds];\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}`> = 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}`> = 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\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT | IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT> | UseAsyncDataResT<DataT>;\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.\n// eslint-disable-next-line complexity\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): UseAsyncCollectionResT<DataT, IdT> | UseAsyncDataResT<DataT> {\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  // Server-side logic.\n  if (globalState.ssrContext) {\n    if (!options.disabled && !options.noSSR) {\n      const operationId: OperationIdT = `S${globalThis.crypto.randomUUID()}`;\n      for (const id of ids) {\n        const itemPath = path ? `${path}.${id}` : `${id}`;\n        const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n          itemPath,\n          {\n            initialValue: newAsyncDataEnvelope<DataT>(),\n          },\n        );\n        if (!state.timestamp && !state.operationId) {\n          const promiseOrVoid = loadAsyncData<ForceT, DataT>(\n            itemPath,\n            (...args):\n              DataT | Promise<DataT | null> | null => loader(id, ...args),\n            globalState,\n            {\n              data: state.data,\n              timestamp: state.timestamp,\n            },\n            operationId,\n          );\n\n          if (promiseOrVoid instanceof Promise) {\n            globalState.ssrContext.pending.push(promiseOrVoid);\n          }\n        }\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    const { disabled } = options;\n\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      if (!disabled) gcOnWithhold(ids, path, globalState);\n      return () => {\n        if (!disabled) gcOnRelease(ids, path, globalState, garbageCollectAge);\n      };\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      disabled,\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      if (!disabled) {\n        void (async () => {\n          for (const id of ids) {\n            const itemPath = path ? `${path}.${id}` : `${id}`;\n\n            type EnvT = AsyncDataEnvelopeT<DataT> | undefined;\n            const state2: EnvT = globalState.get<ForceT, EnvT>(itemPath);\n\n            const { deps } = options;\n            if (\n              (deps && globalState.hasChangedDependencies(itemPath, deps))\n              || (\n                refreshAge < Date.now() - (state2?.timestamp ?? 0)\n                && (!state2?.operationId || state2.operationId.startsWith('S'))\n              )\n            ) {\n              if (!deps) globalState.dropDependencies(itemPath);\n              await loadAsyncData<ForceT, DataT>(\n                itemPath,\n                // TODO: I guess, the loader is not correctly typed here -\n                // it can be synchronous, and in that case the following method\n                // should be kept synchronous to not alter the sync logic.\n                // eslint-disable-next-line @typescript-eslint/promise-function-async\n                (old, ...args) => loader(id, old as DataT, ...args),\n                globalState,\n                {\n                  data: state2?.data ?? null,\n                  timestamp: state2?.timestamp ?? 0,\n                },\n              );\n            }\n          }\n        })();\n      }\n    });\n  }\n\n  const [localState] = useGlobalState<\n    ForceT, Record<string, AsyncDataEnvelopeT<DataT>>\n  >(path, {});\n\n  const ref = useRef<CurrentT<DataT, IdT>>(null);\n\n  ref.current ??= {\n    globalState,\n    ids,\n    loader,\n    path,\n  };\n\n  useEffect(() => {\n    ref.current = {\n      globalState,\n      ids,\n      loader,\n      path,\n    };\n  }, [globalState, ids, loader, path]);\n\n  const [stable] = useState<StableT<DataT, IdT>>(() => {\n    const reload = async (\n      customLoader?: AsyncCollectionLoaderT<DataT, IdT>,\n    ) => {\n      const rc = ref.current;\n      if (!rc) throw Error('Internal error');\n\n      const localLoader = customLoader ?? rc.loader;\n\n      // TODO: Revise - not sure all related typing is 100% correct,\n      // thus let's keep this runtime assertion.\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (!localLoader || !rc.globalState || !rc.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of rc.ids) {\n        const itemPath = rc.path ? `${rc.path}.${id}` : `${id}`;\n\n        const promiseOrVoid = loadAsyncData<ForceT, DataT>(\n          itemPath,\n          // TODO: Revise! Most probably we don't have fully correct loader\n          // typing, as it may return either promise or value, and those two\n          // cases call for different runtime behavior, which in turns only\n          // happens if the outer function on the next line matches the same\n          // async / sync signature.\n          // eslint-disable-next-line @typescript-eslint/promise-function-async\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          rc.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n\n    // TODO: Revise! Most probably we don't have fully correct loader\n    // typing, as it may return either promise or value, and those two\n    // cases call for different runtime behavior, which in turns only\n    // happens if the outer function on the next line matches the same\n    // async / sync signature.\n    // eslint-disable-next-line @typescript-eslint/promise-function-async\n    const reloadSingle: AsyncDataReloaderT<DataT> = (customLoader) => reload(\n      // TODO: Revise! Most probably we don't have fully correct loader\n      // typing, as it may return either promise or value, and those two\n      // cases call for different runtime behavior, which in turns only\n      // happens if the outer function on the next line matches the same\n      // async / sync signature.\n      // eslint-disable-next-line @typescript-eslint/promise-function-async\n      customLoader && ((id, ...args) => customLoader(...args)),\n    );\n\n    const setSingle = (data: DataT | null) => {\n      void reload(() => data);\n    };\n\n    return { reload, reloadSingle, setSingle };\n  });\n\n  if (!Array.isArray(idOrIds)) {\n    // TODO: Revise related typings!\n    const e = localState[idOrIds as string];\n    const timestamp = e?.timestamp ?? 0;\n    return {\n      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,\n      loading: !!e?.operationId,\n      reload: stable.reloadSingle,\n      set: stable.setSingle,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: stable.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (const id of ids) {\n    // TODO: Revise related typing. Should `localState` have a more specific type?\n    const e = localState[id as string];\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\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\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  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT | IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>\n    | UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/code/useAsyncData.js

@@ -3,7 +3,6 @@
  */
 
 import { useEffect, useRef } from 'react';
-import { v4 as uuid } from 'uuid';
 import { MIN_MS } from '@dr.pogodin/js-utils';
 import { getGlobalState } from "./GlobalStateProvider.js";
 import useGlobalState from "./useGlobalState.js";
@@ -83,7 +82,7 @@ export function loadAsyncData(path, loader, globalState, old,
 // 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${uuid()}`) {
+operationId = `C${globalThis.crypto.randomUUID()}`) {
   if (process.env.NODE_ENV !== 'production' && isDebugMode()) {
     /* eslint-disable no-console */
     console.log(`ReactGlobalState: async data (re-)loading. Path: "${path !== null && path !== void 0 ? path : ''}"`);
@@ -104,20 +103,13 @@ operationId = `C${uuid()}`) {
       timestamp: e.timestamp
     };
   }
+  const controller = new AbortController();
+  globalState.setAsyncDataAbortCallback(operationId, () => {
+    controller.abort();
+  });
   const dataOrPromise = loader(definedOld.data, {
-    isAborted: () => {
-      // TODO: Can we improve the typing, to avoid ForceT?
-      const opid = globalState.get(path).operationId;
-      return opid !== operationId;
-    },
-    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);
-    }
+    abortSignal: controller.signal,
+    oldDataTimestamp: definedOld.timestamp
   });
   if (dataOrPromise instanceof Promise) {
     return dataOrPromise.then(data => {
@@ -173,7 +165,7 @@ function useAsyncData(path, loader, options = {}) {
       const promiseOrVoid = loadAsyncData(path, loader, globalState, {
         data: state.data,
         timestamp: state.timestamp
-      }, `S${uuid()}`);
+      }, `S${globalThis.crypto.randomUUID()}`);
       if (promiseOrVoid instanceof Promise) {
         globalState.ssrContext.pending.push(promiseOrVoid);
       }

package/build/code/useAsyncData.js.map

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

package/build/types/useAsyncCollection.d.ts

@@ -5,9 +5,8 @@ import { type AsyncDataEnvelopeT, type DataInEnvelopeAtPathT, type UseAsyncDataO
 import { type ForceT, type LockT, type TypeLock } from './utils';
 export type AsyncCollectionT<DataT = unknown, IdT extends number | string = number | string> = Partial<Record<IdT, AsyncDataEnvelopeT<DataT>>>;
 export type AsyncCollectionLoaderT<DataT, IdT extends number | string = number | string> = (id: IdT, oldData: DataT | null, meta: {
-    isAborted: () => boolean;
+    abortSignal: AbortSignal;
     oldDataTimestamp: number;
-    setAbortCallback: (cb: () => void) => void;
 }) => DataT | Promise<DataT | null> | null;
 export type AsyncCollectionReloaderT<DataT, IdT extends number | string = number | string> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void> | void;
 type CollectionItemT<DataT> = {

package/build/types/useAsyncData.d.ts

@@ -6,9 +6,8 @@ import type SsrContext from './SsrContext';
 import { type ForceT, type LockT, type TypeLock, type ValueAtPathT } from './utils';
 export declare const DEFAULT_MAXAGE: number;
 export type AsyncDataLoaderT<DataT> = (oldData: DataT | null, meta: {
-    isAborted: () => boolean;
+    abortSignal: AbortSignal;
     oldDataTimestamp: number;
-    setAbortCallback: (cb: () => void) => void;
 }) => DataT | Promise<DataT | null> | null;
 export type AsyncDataReloaderT<DataT> = (loader?: AsyncDataLoaderT<DataT>) => Promise<void> | void;
 export type AsyncDataEnvelopeT<DataT> = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dr.pogodin/react-global-state",
-  "version": "0.21.4",
+  "version": "0.23.0",
   "description": "Hook-based global state for React",
   "main": "./build/code/index.js",
   "types": "./build/types/index.d.ts",
@@ -42,8 +42,7 @@
     "@babel/runtime": "^7.29.2",
     "@dr.pogodin/js-utils": "^0.1.6",
     "@types/lodash": "^4.17.24",
-    "lodash-es": "^4.17.23",
-    "uuid": "^13.0.0"
+    "lodash-es": "^4.18.1"
   },
   "devDependencies": {
     "@babel/cli": "^7.28.6",
@@ -53,7 +52,7 @@
     "@babel/preset-env": "^7.29.2",
     "@babel/preset-react": "^7.28.5",
     "@babel/preset-typescript": "^7.28.5",
-    "@dr.pogodin/eslint-configs": "^0.2.7",
+    "@dr.pogodin/eslint-configs": "^0.2.10",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@tsconfig/recommended": "^1.0.13",
@@ -69,11 +68,11 @@
     "jest-environment-jsdom": "^30.3.0",
     "mockdate": "^3.0.5",
     "rimraf": "^6.1.3",
-    "tstyche": "^6.2.0",
+    "tstyche": "^7.0.0",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4"
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5"
   }
 }