@dr.pogodin/react-global-state 0.19.4 → 0.20.1

package/build/cjs/GlobalState.js

@@ -1,10 +1,16 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _lodash = require("lodash");
+var _get = _interopRequireDefault(require("lodash/get.js"));
+var _isFunction = _interopRequireDefault(require("lodash/isFunction.js"));
+var _isObject = _interopRequireDefault(require("lodash/isObject.js"));
+var _isNil = _interopRequireDefault(require("lodash/isNil.js"));
+var _set = _interopRequireDefault(require("lodash/set.js"));
+var _toPath = _interopRequireDefault(require("lodash/toPath.js"));
 var _utils = require("./utils");
 const ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';
 class GlobalState {
@@ -103,7 +109,7 @@ class GlobalState {
     let state = opts?.initialState ? this.#initialState : this.#currentState;
     if (state !== undefined || opts?.initialValue === undefined) return state;
     const iv = opts.initialValue;
-    state = (0, _lodash.isFunction)(iv) ? iv() : iv;
+    state = (0, _isFunction.default)(iv) ? iv() : iv;
     if (this.#currentState === undefined) this.setEntireState(state);
     return state;
   }
@@ -178,15 +184,15 @@ class GlobalState {
   // otherwise it allows to set the correct ValueT directly.
 
   get(path, opts) {
-    if ((0, _lodash.isNil)(path)) {
+    if ((0, _isNil.default)(path)) {
       const res = this.getEntireState(opts);
       return res;
     }
     const state = opts?.initialState ? this.#initialState : this.#currentState;
-    let res = (0, _lodash.get)(state, path);
+    let res = (0, _get.default)(state, path);
     if (res !== undefined || opts?.initialValue === undefined) return res;
     const iv = opts.initialValue;
-    res = (0, _lodash.isFunction)(iv) ? iv() : iv;
+    res = (0, _isFunction.default)(iv) ? iv() : iv;
 
     // TODO: Revise.
     // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression
@@ -210,7 +216,7 @@ class GlobalState {
   // expected value type explicitly.
 
   set(path, value) {
-    if ((0, _lodash.isNil)(path)) return this.setEntireState(value);
+    if ((0, _isNil.default)(path)) return this.setEntireState(value);
 
     // TODO: Revise.
     // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression
@@ -224,19 +230,19 @@ class GlobalState {
       // value as we travel through the state tree. To simplify the typing for
       // now, I guess, we can go with this record type, though.
       let pos = root;
-      const pathSegments = (0, _lodash.toPath)(`state.${path}`);
+      const pathSegments = (0, _toPath.default)(`state.${path}`);
       for (; segIdx < pathSegments.length - 1; segIdx += 1) {
         const seg = pathSegments[segIdx];
 
         // TODO: Revise: Typing is not quite correct here, but it works fine in the runtime.
         const next = pos[seg];
-        if (Array.isArray(next)) pos[seg] = [...next];else if ((0, _lodash.isObject)(next)) pos[seg] = {
+        if (Array.isArray(next)) pos[seg] = [...next];else if ((0, _isObject.default)(next)) pos[seg] = {
           ...next
         };else {
           // We arrived to a state sub-segment, where the remaining part of
           // the update path does not exist yet. We rely on lodash's set()
           // function to create the remaining path, and set the value.
-          (0, _lodash.set)(pos, pathSegments.slice(segIdx), value);
+          (0, _set.default)(pos, pathSegments.slice(segIdx), value);
           break;
         }
         pos = pos[seg];

package/build/cjs/GlobalState.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalState.js","names":["_lodash","require","_utils","ERR_NO_SSR_WATCH","GlobalState","asyncDataAbortCallbacks","dependencies","initialState","watchers","nextNotifierId","currentState","constructor","ssrContext","dirty","pending","state","process","env","NODE_ENV","isDebugMode","msg","console","groupCollapsed","log","cloneDeepForLog","groupEnd","numAsyncDataAbortCallbacks","Object","keys","length","asyncDataLoadDone","opid","aborted","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","i","freeze","getEntireState","opts","undefined","initialValue","iv","isFunction","setEntireState","notifyStateUpdate","value","p","setTimeout","watcher","setAsyncDataAbortCallback","cb","get","isNil","res","set","root","segIdx","pos","pathSegments","toPath","seg","next","Array","isArray","isObject","slice","unWatch","callback","Error","indexOf","pop","watch","includes","push","exports","default"],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import {\n  get,\n  isFunction,\n  isObject,\n  isNil,\n  set,\n  toPath,\n} from 'lodash';\n\nimport 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 || prevDeps.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies[path] = Object.freeze(deps);\n    return changed;\n  }\n\n  /**\n   * Gets entire state, the same way as .get(null, opts) would do.\n   * @param opts.initialState\n   * @param opts.initialValue\n   */\n  getEntireState(opts?: GetOptsT<StateT>): StateT {\n    let state = opts?.initialState ? this.#initialState : this.#currentState;\n    if (state !== undefined || opts?.initialValue === undefined) return state;\n\n    const iv = opts.initialValue;\n    state = isFunction(iv) ? iv() : iv;\n    if (this.#currentState === undefined) this.setEntireState(state);\n    return state;\n  }\n\n  /**\n   * Notifies all connected state watchers that a state update has happened.\n   */\n  private notifyStateUpdate(path: null | string | undefined, value: unknown) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      const p = typeof path === 'string'\n        ? `\"${path}\"` : 'none (entire state update)';\n      console.groupCollapsed(`ReactGlobalState update. Path: ${p}`);\n      console.log('New value:', cloneDeepForLog(value, path ?? ''));\n      console.log('New state:', cloneDeepForLog(this.#currentState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n\n    if (this.ssrContext) {\n      this.ssrContext.dirty = true;\n      this.ssrContext.state = this.#currentState;\n    } else if (!this.#nextNotifierId) {\n      this.#nextNotifierId = setTimeout(() => {\n        this.#nextNotifierId = undefined;\n        const watchers = [...this.#watchers];\n        for (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 (isNil(path)) {\n      const res = this.getEntireState((opts as unknown) as GetOptsT<StateT>);\n      return (res as unknown) as ValueT;\n    }\n\n    const state = opts?.initialState ? this.#initialState : this.#currentState;\n\n    let res = get(state, path) as ValueT;\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = isFunction(iv) ? iv() : 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 (isNil(path)) 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 (isObject(next)) pos[seg] = { ...next };\n        else {\n          // We arrived to a state sub-segment, where the remaining part of\n          // the update path does not exist yet. We rely on lodash's set()\n          // function to create the remaining path, and set the value.\n          set(pos, pathSegments.slice(segIdx), value);\n          break;\n        }\n        pos = pos[seg] 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","_interopRequireDefault","require","_isFunction","_isObject","_isNil","_set","_toPath","_utils","ERR_NO_SSR_WATCH","GlobalState","asyncDataAbortCallbacks","dependencies","initialState","watchers","nextNotifierId","currentState","constructor","ssrContext","dirty","pending","state","process","env","NODE_ENV","isDebugMode","msg","console","groupCollapsed","log","cloneDeepForLog","groupEnd","numAsyncDataAbortCallbacks","Object","keys","length","asyncDataLoadDone","opid","aborted","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","i","freeze","getEntireState","opts","undefined","initialValue","iv","isFunction","setEntireState","notifyStateUpdate","value","p","setTimeout","watcher","setAsyncDataAbortCallback","cb","get","isNil","res","set","root","segIdx","pos","pathSegments","toPath","seg","next","Array","isArray","isObject","slice","unWatch","callback","Error","indexOf","pop","watch","includes","push","exports","default"],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import get from 'lodash/get.js';\nimport isFunction from 'lodash/isFunction.js';\nimport isObject from 'lodash/isObject.js';\nimport isNil from 'lodash/isNil.js';\nimport set from 'lodash/set.js';\nimport toPath from 'lodash/toPath.js';\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 || prevDeps.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies[path] = Object.freeze(deps);\n    return changed;\n  }\n\n  /**\n   * Gets entire state, the same way as .get(null, opts) would do.\n   * @param opts.initialState\n   * @param opts.initialValue\n   */\n  getEntireState(opts?: GetOptsT<StateT>): StateT {\n    let state = opts?.initialState ? this.#initialState : this.#currentState;\n    if (state !== undefined || opts?.initialValue === undefined) return state;\n\n    const iv = opts.initialValue;\n    state = isFunction(iv) ? iv() : iv;\n    if (this.#currentState === undefined) this.setEntireState(state);\n    return state;\n  }\n\n  /**\n   * Notifies all connected state watchers that a state update has happened.\n   */\n  private notifyStateUpdate(path: null | string | undefined, value: unknown) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      const p = typeof path === 'string'\n        ? `\"${path}\"` : 'none (entire state update)';\n      console.groupCollapsed(`ReactGlobalState update. Path: ${p}`);\n      console.log('New value:', cloneDeepForLog(value, path ?? ''));\n      console.log('New state:', cloneDeepForLog(this.#currentState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n\n    if (this.ssrContext) {\n      this.ssrContext.dirty = true;\n      this.ssrContext.state = this.#currentState;\n    } else if (!this.#nextNotifierId) {\n      this.#nextNotifierId = setTimeout(() => {\n        this.#nextNotifierId = undefined;\n        const watchers = [...this.#watchers];\n        for (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 (isNil(path)) {\n      const res = this.getEntireState((opts as unknown) as GetOptsT<StateT>);\n      return (res as unknown) as ValueT;\n    }\n\n    const state = opts?.initialState ? this.#initialState : this.#currentState;\n\n    let res = get(state, path) as ValueT;\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = isFunction(iv) ? iv() : 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 (isNil(path)) 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 (isObject(next)) pos[seg] = { ...next };\n        else {\n          // We arrived to a state sub-segment, where the remaining part of\n          // the update path does not exist yet. We rely on lodash's set()\n          // function to create the remaining path, and set the value.\n          set(pos, pathSegments.slice(segIdx), value);\n          break;\n        }\n        pos = pos[seg] 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/cjs/GlobalStateProvider.js

@@ -7,7 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = void 0;
 exports.getGlobalState = getGlobalState;
 exports.getSsrContext = getSsrContext;
-var _lodash = require("lodash");
+var _isFunction = _interopRequireDefault(require("lodash/isFunction.js"));
 var _react = require("react");
 var _GlobalState = _interopRequireDefault(require("./GlobalState"));
 var _jsxRuntime = require("react/jsx-runtime");
@@ -71,22 +71,25 @@ const GlobalStateProvider = ({
   children,
   ...rest
 }) => {
-  const localStateRef = (0, _react.useRef)(undefined);
+  const [localState, setLocalState] = (0, _react.useState)();
   let state;
-  // TODO: Revise.
-  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+
+  // Below we cast `rest.stateProxy` as "boolean" for safe backward
+  // compatibility with plain JavaScript (as TypeScript typings only
+  // permit "true" or GlobalState value; while legacy codebase may
+  // pass in a boolean value here, occasionally equal "false").
   if ('stateProxy' in rest && rest.stateProxy) {
-    localStateRef.current = undefined;
+    if (localState) setLocalState(undefined);
     state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;
+  } else if (localState) {
+    state = localState;
   } else {
-    if (!localStateRef.current) {
-      const {
-        initialState,
-        ssrContext
-      } = rest;
-      localStateRef.current = new _GlobalState.default((0, _lodash.isFunction)(initialState) ? initialState() : initialState, ssrContext);
-    }
-    state = localStateRef.current;
+    const {
+      initialState,
+      ssrContext
+    } = rest;
+    state = new _GlobalState.default((0, _isFunction.default)(initialState) ? initialState() : initialState, ssrContext);
+    setLocalState(state);
   }
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(Context, {
     value: state,

package/build/cjs/GlobalStateProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalStateProvider.js","names":["_lodash","require","_react","_GlobalState","_interopRequireDefault","_jsxRuntime","Context","createContext","getGlobalState","globalState","use","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","rest","localStateRef","useRef","undefined","state","stateProxy","current","initialState","GlobalState","isFunction","jsx","value","_default","exports","default"],"sources":["../../src/GlobalStateProvider.tsx"],"sourcesContent":["import { isFunction } from 'lodash';\n\nimport {\n  type ReactNode,\n  createContext,\n  use,\n  useRef,\n} from 'react';\n\nimport GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nimport type { ValueOrInitializerT } from './utils';\n\nconst Context = createContext<GlobalState<unknown> | null>(null);\n\n/**\n * Gets {@link GlobalState} instance from the context. In most cases\n * you should use {@link useGlobalState}, and other hooks to interact with\n * the global state, instead of accessing it directly.\n * @return\n */\nexport function getGlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): GlobalState<StateT, SsrContextT> {\n  // TODO: Think about it: on one hand we on purpose called this function\n  // as getGlobalState(), so that ppl looking for the state hook prefer using\n  // useGlobalState(), while this getGlobalState() is reserved for nieche cases;\n  // on the other hand, perhaps we can rename it into useSomething, to both\n  // follow conventions, and to keep stuff clearly named at the same time.\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const globalState = use(Context);\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState as GlobalState<StateT, SsrContextT>;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param throwWithoutSsrContext If `true` (default),\n * this hook will throw if no SSR context is attached to the global state;\n * set `false` to not throw in such case. In either case the hook will throw\n * if the {@link &lt;GlobalStateProvider&gt;} (hence the state) is missing.\n * @returns SSR context.\n * @throws\n * - If current component has no parent {@link &lt;GlobalStateProvider&gt;}\n *   in the rendered React tree.\n * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached\n *   to the global state provided by {@link &lt;GlobalStateProvider&gt;}.\n */\nexport function getSsrContext<\n  SsrContextT extends SsrContext<unknown>,\n>(\n  throwWithoutSsrContext = true,\n): SsrContextT | undefined {\n  const { ssrContext } = getGlobalState<SsrContextT['state'], SsrContextT>();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\ntype NewStateProps<StateT, SsrContextT extends SsrContext<StateT>> = {\n  initialState: ValueOrInitializerT<StateT>;\n  ssrContext?: SsrContextT;\n};\n\ntype GlobalStateProviderProps<\n  StateT,\n  SsrContextT extends SsrContext<StateT>,\n> = {\n  children?: ReactNode;\n} & (NewStateProps<StateT, SsrContextT> | {\n  stateProxy: true | GlobalState<StateT, SsrContextT>;\n});\n\n/**\n * Provides global state to its children.\n * @param prop.children Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @param prop.initialState Initial content of the global state.\n * @param prop.ssrContext Server-side rendering (SSR) context.\n * @param prop.stateProxy This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nconst GlobalStateProvider = <\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(\n  { children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>,\n): ReactNode => {\n  type GST = GlobalState<StateT, SsrContextT>;\n  const localStateRef = useRef<GST>(undefined);\n  let state: GST;\n  // TODO: Revise.\n  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n  if ('stateProxy' in rest && rest.stateProxy) {\n    localStateRef.current = undefined;\n    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;\n  } else {\n    if (!localStateRef.current) {\n      const {\n        initialState,\n        ssrContext,\n      } = rest as NewStateProps<StateT, SsrContextT>;\n      localStateRef.current = new GlobalState(\n        isFunction(initialState) ? initialState() : initialState,\n        ssrContext,\n      );\n    }\n    state = localStateRef.current;\n  }\n  return <Context value={state}>{children}</Context>;\n};\n\nexport default GlobalStateProvider;\n"],"mappings":";;;;;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAEA,IAAAC,MAAA,GAAAD,OAAA;AAOA,IAAAE,YAAA,GAAAC,sBAAA,CAAAH,OAAA;AAAwC,IAAAI,WAAA,GAAAJ,OAAA;AAKxC,MAAMK,OAAO,gBAAG,IAAAC,oBAAa,EAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAAA,EAGQ;EACpC;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAG,IAAAC,UAAG,EAACJ,OAAO,CAAC;EAChC,IAAI,CAACG,WAAW,EAAE,MAAM,IAAIE,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOF,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,aAAaA,CAG3BC,sBAAsB,GAAG,IAAI,EACJ;EACzB,MAAM;IAAEC;EAAW,CAAC,GAAGN,cAAc,CAAoC,CAAC;EAC1E,IAAI,CAACM,UAAU,IAAID,sBAAsB,EAAE;IACzC,MAAM,IAAIF,KAAK,CAAC,sBAAsB,CAAC;EACzC;EACA,OAAOG,UAAU;AACnB;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAmB,GAAGA,CAI1B;EAAEC,QAAQ;EAAE,GAAGC;AAAoD,CAAC,KACtD;EAEd,MAAMC,aAAa,GAAG,IAAAC,aAAM,EAAMC,SAAS,CAAC;EAC5C,IAAIC,KAAU;EACd;EACA;EACA,IAAI,YAAY,IAAIJ,IAAI,IAAIA,IAAI,CAACK,UAAU,EAAE;IAC3CJ,aAAa,CAACK,OAAO,GAAGH,SAAS;IACjCC,KAAK,GAAGJ,IAAI,CAACK,UAAU,KAAK,IAAI,GAAGd,cAAc,CAAC,CAAC,GAAGS,IAAI,CAACK,UAAU;EACvE,CAAC,MAAM;IACL,IAAI,CAACJ,aAAa,CAACK,OAAO,EAAE;MAC1B,MAAM;QACJC,YAAY;QACZV;MACF,CAAC,GAAGG,IAA0C;MAC9CC,aAAa,CAACK,OAAO,GAAG,IAAIE,oBAAW,CACrC,IAAAC,kBAAU,EAACF,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDV,UACF,CAAC;IACH;IACAO,KAAK,GAAGH,aAAa,CAACK,OAAO;EAC/B;EACA,oBAAO,IAAAlB,WAAA,CAAAsB,GAAA,EAACrB,OAAO;IAACsB,KAAK,EAAEP,KAAM;IAAAL,QAAA,EAAEA;EAAQ,CAAU,CAAC;AACpD,CAAC;AAAC,IAAAa,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEahB,mBAAmB","ignoreList":[]}
+{"version":3,"file":"GlobalStateProvider.js","names":["_isFunction","_interopRequireDefault","require","_react","_GlobalState","_jsxRuntime","Context","createContext","getGlobalState","globalState","use","Error","getSsrContext","throwWithoutSsrContext","ssrContext","GlobalStateProvider","children","rest","localState","setLocalState","useState","state","stateProxy","undefined","initialState","GlobalState","isFunction","jsx","value","_default","exports","default"],"sources":["../../src/GlobalStateProvider.tsx"],"sourcesContent":["import isFunction from 'lodash/isFunction.js';\n\nimport {\n  type ReactNode,\n  createContext,\n  use,\n  useState,\n} from 'react';\n\nimport GlobalState from './GlobalState';\nimport type SsrContext from './SsrContext';\n\nimport type { ValueOrInitializerT } from './utils';\n\nconst Context = createContext<GlobalState<unknown> | null>(null);\n\n/**\n * Gets {@link GlobalState} instance from the context. In most cases\n * you should use {@link useGlobalState}, and other hooks to interact with\n * the global state, instead of accessing it directly.\n * @return\n */\nexport function getGlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(): GlobalState<StateT, SsrContextT> {\n  // TODO: Think about it: on one hand we on purpose called this function\n  // as getGlobalState(), so that ppl looking for the state hook prefer using\n  // useGlobalState(), while this getGlobalState() is reserved for nieche cases;\n  // on the other hand, perhaps we can rename it into useSomething, to both\n  // follow conventions, and to keep stuff clearly named at the same time.\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  const globalState = use(Context);\n  if (!globalState) throw new Error('Missing GlobalStateProvider');\n  return globalState as GlobalState<StateT, SsrContextT>;\n}\n\n/**\n * @category Hooks\n * @desc Gets SSR context.\n * @param throwWithoutSsrContext If `true` (default),\n * this hook will throw if no SSR context is attached to the global state;\n * set `false` to not throw in such case. In either case the hook will throw\n * if the {@link &lt;GlobalStateProvider&gt;} (hence the state) is missing.\n * @returns SSR context.\n * @throws\n * - If current component has no parent {@link &lt;GlobalStateProvider&gt;}\n *   in the rendered React tree.\n * - If `throwWithoutSsrContext` is `true`, and there is no SSR context attached\n *   to the global state provided by {@link &lt;GlobalStateProvider&gt;}.\n */\nexport function getSsrContext<\n  SsrContextT extends SsrContext<unknown>,\n>(\n  throwWithoutSsrContext = true,\n): SsrContextT | undefined {\n  const { ssrContext } = getGlobalState<SsrContextT['state'], SsrContextT>();\n  if (!ssrContext && throwWithoutSsrContext) {\n    throw new Error('No SSR context found');\n  }\n  return ssrContext;\n}\n\ntype NewStateProps<StateT, SsrContextT extends SsrContext<StateT>> = {\n  initialState: ValueOrInitializerT<StateT>;\n  ssrContext?: SsrContextT;\n};\n\ntype GlobalStateProviderProps<\n  StateT,\n  SsrContextT extends SsrContext<StateT>,\n> = {\n  children?: ReactNode;\n} & (NewStateProps<StateT, SsrContextT> | {\n  stateProxy: true | GlobalState<StateT, SsrContextT>;\n});\n\n/**\n * Provides global state to its children.\n * @param prop.children Component children, which will be provided with\n * the global state, and rendered in place of the provider.\n * @param prop.initialState Initial content of the global state.\n * @param prop.ssrContext Server-side rendering (SSR) context.\n * @param prop.stateProxy This option is useful for code\n * splitting and SSR implementation:\n * - If `true`, this provider instance will fetch and reuse the global state\n *   from a parent provider.\n * - If `GlobalState` instance, it will be used by this provider.\n * - If not given, a new `GlobalState` instance will be created and used.\n */\nconst GlobalStateProvider = <\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>(\n  { children, ...rest }: GlobalStateProviderProps<StateT, SsrContextT>,\n): ReactNode => {\n  type GST = GlobalState<StateT, SsrContextT>;\n\n  const [localState, setLocalState] = useState<GST>();\n\n  let state: GST;\n\n  // Below we cast `rest.stateProxy` as \"boolean\" for safe backward\n  // compatibility with plain JavaScript (as TypeScript typings only\n  // permit \"true\" or GlobalState value; while legacy codebase may\n  // pass in a boolean value here, occasionally equal \"false\").\n  if ('stateProxy' in rest && (rest.stateProxy as boolean)) {\n    if (localState) setLocalState(undefined);\n    state = rest.stateProxy === true ? getGlobalState() : rest.stateProxy;\n  } else if (localState) {\n    state = localState;\n  } else {\n    const {\n      initialState,\n      ssrContext,\n    } = rest as NewStateProps<StateT, SsrContextT>;\n\n    state = new GlobalState(\n      isFunction(initialState) ? initialState() : initialState,\n      ssrContext,\n    );\n\n    setLocalState(state);\n  }\n\n  return <Context value={state}>{children}</Context>;\n};\n\nexport default GlobalStateProvider;\n"],"mappings":";;;;;;;;;AAAA,IAAAA,WAAA,GAAAC,sBAAA,CAAAC,OAAA;AAEA,IAAAC,MAAA,GAAAD,OAAA;AAOA,IAAAE,YAAA,GAAAH,sBAAA,CAAAC,OAAA;AAAwC,IAAAG,WAAA,GAAAH,OAAA;AAKxC,MAAMI,OAAO,gBAAG,IAAAC,oBAAa,EAA8B,IAAI,CAAC;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAAA,EAGQ;EACpC;EACA;EACA;EACA;EACA;EACA;EACA,MAAMC,WAAW,GAAG,IAAAC,UAAG,EAACJ,OAAO,CAAC;EAChC,IAAI,CAACG,WAAW,EAAE,MAAM,IAAIE,KAAK,CAAC,6BAA6B,CAAC;EAChE,OAAOF,WAAW;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,aAAaA,CAG3BC,sBAAsB,GAAG,IAAI,EACJ;EACzB,MAAM;IAAEC;EAAW,CAAC,GAAGN,cAAc,CAAoC,CAAC;EAC1E,IAAI,CAACM,UAAU,IAAID,sBAAsB,EAAE;IACzC,MAAM,IAAIF,KAAK,CAAC,sBAAsB,CAAC;EACzC;EACA,OAAOG,UAAU;AACnB;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAmB,GAAGA,CAI1B;EAAEC,QAAQ;EAAE,GAAGC;AAAoD,CAAC,KACtD;EAGd,MAAM,CAACC,UAAU,EAAEC,aAAa,CAAC,GAAG,IAAAC,eAAQ,EAAM,CAAC;EAEnD,IAAIC,KAAU;;EAEd;EACA;EACA;EACA;EACA,IAAI,YAAY,IAAIJ,IAAI,IAAKA,IAAI,CAACK,UAAsB,EAAE;IACxD,IAAIJ,UAAU,EAAEC,aAAa,CAACI,SAAS,CAAC;IACxCF,KAAK,GAAGJ,IAAI,CAACK,UAAU,KAAK,IAAI,GAAGd,cAAc,CAAC,CAAC,GAAGS,IAAI,CAACK,UAAU;EACvE,CAAC,MAAM,IAAIJ,UAAU,EAAE;IACrBG,KAAK,GAAGH,UAAU;EACpB,CAAC,MAAM;IACL,MAAM;MACJM,YAAY;MACZV;IACF,CAAC,GAAGG,IAA0C;IAE9CI,KAAK,GAAG,IAAII,oBAAW,CACrB,IAAAC,mBAAU,EAACF,YAAY,CAAC,GAAGA,YAAY,CAAC,CAAC,GAAGA,YAAY,EACxDV,UACF,CAAC;IAEDK,aAAa,CAACE,KAAK,CAAC;EACtB;EAEA,oBAAO,IAAAhB,WAAA,CAAAsB,GAAA,EAACrB,OAAO;IAACsB,KAAK,EAAEP,KAAM;IAAAL,QAAA,EAAEA;EAAQ,CAAU,CAAC;AACpD,CAAC;AAAC,IAAAa,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEahB,mBAAmB","ignoreList":[]}

package/build/cjs/useAsyncCollection.js

@@ -89,72 +89,6 @@ function normalizeIds(idOrIds) {
   return [idOrIds];
 }
 
-/**
- * Inits/updates, and returns the heap.
- */
-function useHeap(ids, path, loader, gs) {
-  const ref = (0, _react.useRef)(undefined);
-  let heap = ref.current;
-  if (heap) {
-    // Update.
-    heap.ids = ids;
-    heap.path = path;
-    heap.loader = loader;
-    heap.globalState = gs;
-  } else {
-    // Initialization.
-    const reload = async customLoader => {
-      const heap2 = ref.current;
-      const localLoader = customLoader ?? heap2.loader;
-      // TODO: Revise - not sure all related typing is 100% correct,
-      // thus let's keep this runtime assertion.
-      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-      if (!localLoader || !heap2.globalState || !heap2.ids) {
-        throw Error('Internal error');
-      }
-      for (const id of heap2.ids) {
-        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;
-        const promiseOrVoid = (0, _useAsyncData.load)(itemPath,
-        // TODO: Revise! Most probably we don't have fully correct loader
-        // typing, as it may return either promise or value, and those two
-        // cases call for different runtime behavior, which in turns only
-        // happens if the outer function on the next line matches the same
-        // async / sync signature.
-        // eslint-disable-next-line @typescript-eslint/promise-function-async
-        (oldData, meta) => localLoader(id, oldData, meta), heap2.globalState);
-        if (promiseOrVoid instanceof Promise) await promiseOrVoid;
-      }
-    };
-    heap = {
-      globalState: gs,
-      ids,
-      loader,
-      path,
-      reload,
-      // TODO: Revise! Most probably we don't have fully correct loader
-      // typing, as it may return either promise or value, and those two
-      // cases call for different runtime behavior, which in turns only
-      // happens if the outer function on the next line matches the same
-      // async / sync signature.
-      // eslint-disable-next-line @typescript-eslint/promise-function-async
-      reloadSingle: customLoader => ref.current.reload(
-      // TODO: Revise! Most probably we don't have fully correct loader
-      // typing, as it may return either promise or value, and those two
-      // cases call for different runtime behavior, which in turns only
-      // happens if the outer function on the next line matches the same
-      // async / sync signature.
-      // eslint-disable-next-line @typescript-eslint/promise-function-async
-      customLoader && ((id, ...args) => customLoader(...args))),
-      // TODO: It should be revised it works correctly.
-      setSingle(data) {
-        void ref.current.reload(() => data);
-      }
-    };
-    ref.current = heap;
-  }
-  return heap;
-}
-
 /**
  * Resolves and stores at the given `path` of the global state elements of
  * an asynchronous data collection.
@@ -170,7 +104,6 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
   const refreshAge = options.refreshAge ?? maxage;
   const garbageCollectAge = options.garbageCollectAge ?? maxage;
   const globalState = (0, _GlobalStateProvider.getGlobalState)();
-  const heap = useHeap(ids, path, loader, globalState);
 
   // Server-side logic.
   if (globalState.ssrContext) {
@@ -249,6 +182,70 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     });
   }
   const [localState] = (0, _useGlobalState.default)(path, {});
+  const ref = (0, _react.useRef)(null);
+  ref.current ??= {
+    globalState,
+    ids,
+    loader,
+    path
+  };
+  (0, _react.useEffect)(() => {
+    ref.current = {
+      globalState,
+      ids,
+      loader,
+      path
+    };
+  }, [globalState, ids, loader, path]);
+  const [stable] = (0, _react.useState)(() => {
+    const reload = async customLoader => {
+      const rc = ref.current;
+      if (!rc) throw Error('Internal error');
+      const localLoader = customLoader ?? rc.loader;
+
+      // TODO: Revise - not sure all related typing is 100% correct,
+      // thus let's keep this runtime assertion.
+      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+      if (!localLoader || !rc.globalState || !rc.ids) {
+        throw Error('Internal error');
+      }
+      for (const id of rc.ids) {
+        const itemPath = rc.path ? `${rc.path}.${id}` : `${id}`;
+        const promiseOrVoid = (0, _useAsyncData.load)(itemPath,
+        // TODO: Revise! Most probably we don't have fully correct loader
+        // typing, as it may return either promise or value, and those two
+        // cases call for different runtime behavior, which in turns only
+        // happens if the outer function on the next line matches the same
+        // async / sync signature.
+        // eslint-disable-next-line @typescript-eslint/promise-function-async
+        (oldData, meta) => localLoader(id, oldData, meta), rc.globalState);
+        if (promiseOrVoid instanceof Promise) await promiseOrVoid;
+      }
+    };
+
+    // TODO: Revise! Most probably we don't have fully correct loader
+    // typing, as it may return either promise or value, and those two
+    // cases call for different runtime behavior, which in turns only
+    // happens if the outer function on the next line matches the same
+    // async / sync signature.
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
+    const reloadSingle = customLoader => reload(
+    // TODO: Revise! Most probably we don't have fully correct loader
+    // typing, as it may return either promise or value, and those two
+    // cases call for different runtime behavior, which in turns only
+    // happens if the outer function on the next line matches the same
+    // async / sync signature.
+    // eslint-disable-next-line @typescript-eslint/promise-function-async
+    customLoader && ((id, ...args) => customLoader(...args)));
+    const setSingle = data => {
+      void reload(() => data);
+    };
+    return {
+      reload,
+      reloadSingle,
+      setSingle
+    };
+  });
   if (!Array.isArray(idOrIds)) {
     // TODO: Revise related typings!
     const e = localState[idOrIds];
@@ -256,15 +253,15 @@ function useAsyncCollection(idOrIds, path, loader, options = {}) {
     return {
       data: maxage < Date.now() - timestamp ? null : e?.data ?? null,
       loading: !!e?.operationId,
-      reload: heap.reloadSingle,
-      set: heap.setSingle,
+      reload: stable.reloadSingle,
+      set: stable.setSingle,
       timestamp
     };
   }
   const res = {
     items: {},
     loading: false,
-    reload: heap.reload,
+    reload: stable.reload,
     timestamp: Number.MAX_VALUE
   };
   for (const id of ids) {

package/build/cjs/useAsyncCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncCollection.js","names":["_react","require","_uuid","_GlobalStateProvider","_useAsyncData","_useGlobalState","_interopRequireDefault","_utils","gcOnWithhold","ids","path","gs","collection","get","id","envelope","numRefs","newAsyncDataEnvelope","set","idsToStringSet","res","Set","add","toString","gcOnRelease","gcAge","entries","Object","now","Date","idSet","toBeReleased","has","timestamp","process","env","NODE_ENV","isDebugMode","console","log","normalizeIds","idOrIds","Array","isArray","from","sort","a","b","localeCompare","useHeap","loader","ref","useRef","undefined","heap","current","globalState","reload","customLoader","heap2","localLoader","Error","itemPath","promiseOrVoid","load","oldData","meta","Promise","reloadSingle","args","setSingle","data","useAsyncCollection","options","maxage","DEFAULT_MAXAGE","refreshAge","garbageCollectAge","getGlobalState","ssrContext","disabled","noSSR","operationId","uuid","state","initialValue","pending","push","idsHash","hash","useEffect","state2","deps","hasChangedDependencies","startsWith","dropDependencies","old","localState","useGlobalState","e","loading","items","Number","MAX_VALUE","_default","exports","default"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport type GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  DEFAULT_MAXAGE,\n  load,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  hash,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n  DataT = unknown,\n  IdT extends number | string = number | string,\n> = Record<IdT, AsyncDataEnvelopeT<DataT>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | Promise<void>;\n\ntype CollectionItemT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  timestamp: number;\n};\n\nexport type UseAsyncCollectionResT<\n  DataT,\n  IdT extends number | string = number | string,\n> = {\n  items: Record<IdT, CollectionItemT<DataT>>;\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype HeapT<\n  DataT,\n  IdT extends number | string,\n> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState: GlobalState<unknown>;\n  ids: IdT[];\n  path: null | string | undefined;\n  loader: AsyncCollectionLoaderT<DataT, IdT>;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadSingle: AsyncDataReloaderT<DataT>;\n  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 * Inits/updates, and returns the heap.\n */\nfunction useHeap<\n  DataT,\n  IdT extends number | string,\n>(\n  ids: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  gs: GlobalState<unknown>,\n): HeapT<DataT, IdT> {\n  const ref = useRef<HeapT<DataT, IdT>>(undefined);\n\n  let heap = ref.current;\n\n  if (heap) {\n    // Update.\n    heap.ids = ids;\n    heap.path = path;\n    heap.loader = loader;\n    heap.globalState = gs;\n  } else {\n    // Initialization.\n    const reload = async (\n      customLoader?: AsyncCollectionLoaderT<DataT, IdT>,\n    ) => {\n      const heap2 = ref.current!;\n\n      const localLoader = customLoader ?? heap2.loader;\n      // 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 || !heap2.globalState || !heap2.ids) {\n        throw Error('Internal error');\n      }\n\n      for (const id of heap2.ids) {\n        const itemPath = heap2.path ? `${heap2.path}.${id}` : `${id}`;\n\n        const promiseOrVoid = load(\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          heap2.globalState,\n        );\n\n        if (promiseOrVoid instanceof Promise) await promiseOrVoid;\n      }\n    };\n    heap = {\n      globalState: gs,\n      ids,\n      loader,\n      path,\n      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      reloadSingle: (customLoader) => ref.current!.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      // TODO: It should be revised it works correctly.\n      setSingle(data: DataT | null) {\n        void ref.current!.reload(() => data);\n      },\n    };\n    ref.current = heap;\n  }\n\n  return heap;\n}\n\n/**\n * Resolves and stores at the given `path` of the global state elements of\n * an asynchronous data collection.\n */\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> = 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): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT>;\n\n// TODO: This is largely similar to useAsyncData() logic, just more generic.\n// Perhaps, a bunch of logic blocks can be split into stand-alone functions,\n// and reused in both hooks.\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): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT> {\n  const ids = normalizeIds(idOrIds);\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  const globalState = getGlobalState();\n\n  const heap = useHeap(ids, path, loader, globalState);\n\n  // Server-side logic.\n  if (globalState.ssrContext) {\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 = load(\n            itemPath,\n            (...args):\n              DataT | null | Promise<DataT | 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 load(\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,\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  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: heap.reloadSingle,\n      set: heap.setSingle,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: heap.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (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  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>\n    | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"useAsyncCollection.js","names":["_react","require","_uuid","_GlobalStateProvider","_useAsyncData","_useGlobalState","_interopRequireDefault","_utils","gcOnWithhold","ids","path","gs","collection","get","id","envelope","numRefs","newAsyncDataEnvelope","set","idsToStringSet","res","Set","add","toString","gcOnRelease","gcAge","entries","Object","now","Date","idSet","toBeReleased","has","timestamp","process","env","NODE_ENV","isDebugMode","console","log","normalizeIds","idOrIds","Array","isArray","from","sort","a","b","localeCompare","useAsyncCollection","loader","options","maxage","DEFAULT_MAXAGE","refreshAge","garbageCollectAge","globalState","getGlobalState","ssrContext","disabled","noSSR","operationId","uuid","itemPath","state","initialValue","promiseOrVoid","load","args","data","Promise","pending","push","idsHash","hash","useEffect","state2","deps","hasChangedDependencies","startsWith","dropDependencies","old","localState","useGlobalState","ref","useRef","current","stable","useState","reload","customLoader","rc","Error","localLoader","oldData","meta","reloadSingle","setSingle","e","loading","items","Number","MAX_VALUE","_default","exports","default"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef, 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  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  DEFAULT_MAXAGE,\n  load,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  hash,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionT<\n  DataT = unknown,\n  IdT extends number | string = number | string,\n> = Record<IdT, AsyncDataEnvelopeT<DataT>>;\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (id: IdT, oldData: null | DataT, meta: {\n  isAborted: () => boolean;\n  oldDataTimestamp: number;\n  setAbortCallback: (cb: () => void) => void;\n}) => DataT | null | Promise<DataT | null>;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => void | Promise<void>;\n\ntype CollectionItemT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  timestamp: number;\n};\n\nexport type UseAsyncCollectionResT<\n  DataT,\n  IdT extends number | string = number | string,\n> = {\n  items: 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): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT>;\n\n// TODO: This is largely similar to useAsyncData() logic, just more generic.\n// Perhaps, a bunch of logic blocks can be split into stand-alone functions,\n// and reused in both hooks.\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): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT> {\n  const ids = normalizeIds(idOrIds);\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  const globalState = getGlobalState();\n\n  // 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 = load(\n            itemPath,\n            (...args):\n              DataT | null | Promise<DataT | 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 load(\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,\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 = load(\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  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>\n    | UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}