@dr.pogodin/react-global-state 0.15.1 → 0.16.0

package/build/common/GlobalState.js.map

@@ -1 +1 @@
-{"version":3,"file":"GlobalState.js","names":["_lodash","require","_utils","ERR_NO_SSR_WATCH","GlobalState","dependencies","initialState","watchers","nextNotifierId","currentState","constructor","ssrContext","dirty","pending","state","process","env","NODE_ENV","isDebugMode","msg","console","groupCollapsed","log","cloneDeepForLog","groupEnd","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","length","i","Object","freeze","getEntireState","opts","undefined","initialValue","iv","isFunction","setEntireState","notifyStateUpdate","value","p","setTimeout","get","isNil","res","set","root","segIdx","pos","pathSegments","toPath","seg","next","Array","isArray","isObject","slice","unWatch","callback","Error","indexOf","pop","watch","push","exports","default"],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import {\n  get,\n  isFunction,\n  isObject,\n  isNil,\n  set,\n  toPath,\n} from 'lodash';\n\nimport SsrContext from './SsrContext';\n\nimport {\n  type CallbackT,\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  type ValueOrInitializerT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nconst ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';\n\ntype GetOptsT<T> = {\n  initialState?: boolean;\n  initialValue?: ValueOrInitializerT<T>;\n};\n\nexport default class GlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  readonly ssrContext?: SsrContextT;\n\n  #dependencies: { [key: string]: Readonly<any[]> } = {};\n\n  #initialState: StateT;\n\n  // TODO: It is tempting to replace watchers here by\n  // Emitter from @dr.pogodin/js-utils, but we need to clone\n  // current watchers for emitting later, and this is not something\n  // Emitter supports right now.\n  #watchers: CallbackT[] = [];\n\n  #nextNotifierId?: NodeJS.Timeout;\n\n  #currentState: StateT;\n\n  /**\n   * Creates a new global state object.\n   * @param initialState Intial global state content.\n   * @param ssrContext Server-side rendering context.\n   */\n  constructor(\n    initialState: StateT,\n    ssrContext?: SsrContextT,\n  ) {\n    this.#currentState = initialState;\n    this.#initialState = initialState;\n\n    if (ssrContext) {\n      /* eslint-disable no-param-reassign */\n      ssrContext.dirty = false;\n      ssrContext.pending = [];\n      ssrContext.state = this.#currentState;\n      /* eslint-enable no-param-reassign */\n\n      this.ssrContext = ssrContext;\n    }\n\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      let msg = 'New ReactGlobalState created';\n      if (ssrContext) msg += ' (SSR mode)';\n      console.groupCollapsed(msg);\n      console.log('Initial state:', cloneDeepForLog(initialState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n\n  /**\n   * Drops the record of dependencies, if any, for the given path.\n   */\n  dropDependencies(path: string) {\n    delete this.#dependencies[path];\n  }\n\n  /**\n   * Checks if given `deps` are different from previously recorded ones for\n   * the given `path`. If they are, `deps` are recorded as the new deps for\n   * the `path`, and also the array is frozen, to prevent it from being\n   * modified.\n   */\n  hasChangedDependencies(path: string, deps: any[]): boolean {\n    const prevDeps = this.#dependencies[path];\n    let changed = !prevDeps || prevDeps.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps[i] !== deps[i];\n    }\n    this.#dependencies[path] = Object.freeze(deps);\n    return changed;\n  }\n\n  /**\n   * Gets entire state, the same way as .get(null, opts) would do.\n   * @param opts.initialState\n   * @param opts.initialValue\n   */\n  getEntireState(opts?: GetOptsT<StateT>): StateT {\n    let state = opts?.initialState ? this.#initialState : this.#currentState;\n    if (state !== undefined || opts?.initialValue === undefined) return state;\n\n    const iv = opts.initialValue;\n    state = isFunction(iv) ? iv() : iv;\n    if (this.#currentState === undefined) this.setEntireState(state);\n    return state;\n  }\n\n  /**\n   * Notifies all connected state watchers that a state update has happened.\n   */\n  private notifyStateUpdate(path: null | string | undefined, value: unknown) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      const p = typeof path === 'string'\n        ? `\"${path}\"` : 'none (entire state update)';\n      console.groupCollapsed(`ReactGlobalState update. Path: ${p}`);\n      console.log('New value:', cloneDeepForLog(value, path ?? ''));\n      console.log('New state:', cloneDeepForLog(this.#currentState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n\n    if (this.ssrContext) {\n      this.ssrContext.dirty = true;\n      this.ssrContext.state = this.#currentState;\n    } else if (!this.#nextNotifierId) {\n      this.#nextNotifierId = setTimeout(() => {\n        this.#nextNotifierId = undefined;\n        const watchers = [...this.#watchers];\n        for (let i = 0; i < watchers.length; ++i) {\n          watchers[i]();\n        }\n      });\n    }\n  }\n\n  /**\n   * Sets entire state, the same way as .set(null, value) would do.\n   * @param value\n   */\n  setEntireState(value: StateT): StateT {\n    if (this.#currentState !== value) {\n      this.#currentState = value;\n      this.notifyStateUpdate(null, value);\n    }\n    return value;\n  }\n\n  /**\n   * Gets current or initial value at the specified \"path\" of the global state.\n   * @param path Dot-delimitered state path.\n   * @param options Additional options.\n   * @param options.initialState If \"true\" the value will be read\n   *  from the initial state instead of the current one.\n   * @param options.initialValue If the value read from the \"path\" is\n   *  \"undefined\", this \"initialValue\" will be returned instead. In such case\n   *  \"initialValue\" will also be written to the \"path\" of the current global\n   *  state (no matter \"initialState\" flag), if \"undefined\" is stored there.\n   * @return Retrieved value.\n   */\n\n  // .get() without arguments just falls back to .getEntireState().\n  get(): StateT;\n\n  // This variant attempts to automatically resolve and check the type of value\n  // at the given path, as precise as the actual state and path types permit.\n  // If the automatic path resolution is not possible, the ValueT fallsback\n  // to `never` (or to `undefined` in some cases), effectively forbidding\n  // to use this .get() variant.\n  get<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, opts?: GetOptsT<ValueArgT>): ValueResT;\n\n  // This variant is not callable by default (without generic arguments),\n  // otherwise it allows to set the correct ValueT directly.\n  get<Forced extends ForceT | LockT = LockT, ValueT = void>(\n    path?: null | string,\n    opts?: GetOptsT<TypeLock<Forced, never, ValueT>>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  get<ValueT>(path?: null | string, opts?: GetOptsT<ValueT>): ValueT {\n    if (isNil(path)) {\n      const res = this.getEntireState((opts as unknown) as GetOptsT<StateT>);\n      return (res as unknown) as ValueT;\n    }\n\n    const state = opts?.initialState ? this.#initialState : this.#currentState;\n\n    let res = get(state, path);\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = isFunction(iv) ? iv() : iv;\n\n    if (!opts?.initialState || this.get(path) === undefined) {\n      this.set<ForceT, unknown>(path, res);\n    }\n\n    return res;\n  }\n\n  /**\n   * Writes the `value` to given global state `path`.\n   * @param path Dot-delimitered state path. If not given, entire\n   * global state content is replaced by the `value`.\n   * @param value The value.\n   * @return Given `value` itself.\n   */\n\n  // This variant attempts automatic value type resolution & checking.\n  set<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, value: ValueArgT): ValueResT;\n\n  // This variant is disabled by default, otherwise allows to give\n  // expected value type explicitly.\n  set<Forced extends ForceT | LockT = LockT, ValueT = never>(\n    path: null | string | undefined,\n    value: TypeLock<Forced, never, ValueT>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  set(path: null | string | undefined, value: unknown): unknown {\n    if (isNil(path)) return this.setEntireState(value as StateT);\n\n    if (value !== this.get(path)) {\n      const root = { state: this.#currentState };\n      let segIdx = 0;\n      let pos: any = root;\n      const pathSegments = toPath(`state.${path}`);\n      for (; segIdx < pathSegments.length - 1; segIdx += 1) {\n        const seg = pathSegments[segIdx];\n        const next = pos[seg];\n        if (Array.isArray(next)) pos[seg] = [...next];\n        else if (isObject(next)) pos[seg] = { ...next };\n        else {\n          // We arrived to a state sub-segment, where the remaining part of\n          // the update path does not exist yet. We rely on lodash's set()\n          // function to create the remaining path, and set the value.\n          set(pos, pathSegments.slice(segIdx), value);\n          break;\n        }\n        pos = pos[seg];\n      }\n\n      if (segIdx === pathSegments.length - 1) {\n        pos[pathSegments[segIdx]] = value;\n      }\n\n      this.#currentState = root.state;\n\n      this.notifyStateUpdate(path, value);\n    }\n    return value;\n  }\n\n  /**\n   * Unsubscribes `callback` from watching state updates; no operation if\n   * `callback` is not subscribed to the state updates.\n   * @param callback\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  unWatch(callback: CallbackT) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    const pos = watchers.indexOf(callback);\n    if (pos >= 0) {\n      watchers[pos] = watchers[watchers.length - 1];\n      watchers.pop();\n    }\n  }\n\n  /**\n   * Subscribes `callback` to watch state updates; no operation if\n   * `callback` is already subscribed to this state instance.\n   * @param callback It will be called without any arguments every\n   * time the state content changes (note, howhever, separate state updates can\n   * be applied to the state at once, and watching callbacks will be called once\n   * after such bulk update).\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  watch(callback: CallbackT) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    if (watchers.indexOf(callback) < 0) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"mappings":";;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAWA,IAAAC,MAAA,GAAAD,OAAA;AAWA,MAAME,gBAAgB,GAAG,gDAAgD;AAO1D,MAAMC,WAAW,CAG9B;EAGA,CAACC,YAAY,GAAuC,CAAC,CAAC;EAEtD,CAACC,YAAY;;EAEb;EACA;EACA;EACA;EACA,CAACC,QAAQ,GAAgB,EAAE;EAE3B,CAACC,cAAc;EAEf,CAACC,YAAY;;EAEb;AACF;AACA;AACA;AACA;EACEC,WAAWA,CACTJ,YAAoB,EACpBK,UAAwB,EACxB;IACA,IAAI,CAAC,CAACF,YAAY,GAAGH,YAAY;IACjC,IAAI,CAAC,CAACA,YAAY,GAAGA,YAAY;IAEjC,IAAIK,UAAU,EAAE;MACd;MACAA,UAAU,CAACC,KAAK,GAAG,KAAK;MACxBD,UAAU,CAACE,OAAO,GAAG,EAAE;MACvBF,UAAU,CAACG,KAAK,GAAG,IAAI,CAAC,CAACL,YAAY;MACrC;;MAEA,IAAI,CAACE,UAAU,GAAGA,UAAU;IAC9B;IAEA,IAAII,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAI,IAAAC,kBAAW,EAAC,CAAC,EAAE;MAC1D;MACA,IAAIC,GAAG,GAAG,8BAA8B;MACxC,IAAIR,UAAU,EAAEQ,GAAG,IAAI,aAAa;MACpCC,OAAO,CAACC,cAAc,CAACF,GAAG,CAAC;MAC3BC,OAAO,CAACE,GAAG,CAAC,gBAAgB,EAAE,IAAAC,sBAAe,EAACjB,YAAY,CAAC,CAAC;MAC5Dc,OAAO,CAACI,QAAQ,CAAC,CAAC;MAClB;IACF;EACF;;EAEA;AACF;AACA;EACEC,gBAAgBA,CAACC,IAAY,EAAE;IAC7B,OAAO,IAAI,CAAC,CAACrB,YAAY,CAACqB,IAAI,CAAC;EACjC;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEC,sBAAsBA,CAACD,IAAY,EAAEE,IAAW,EAAW;IACzD,MAAMC,QAAQ,GAAG,IAAI,CAAC,CAACxB,YAAY,CAACqB,IAAI,CAAC;IACzC,IAAII,OAAO,GAAG,CAACD,QAAQ,IAAIA,QAAQ,CAACE,MAAM,KAAKH,IAAI,CAACG,MAAM;IAC1D,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAE,CAACF,OAAO,IAAIE,CAAC,GAAGJ,IAAI,CAACG,MAAM,EAAE,EAAEC,CAAC,EAAE;MAChDF,OAAO,GAAGD,QAAQ,CAACG,CAAC,CAAC,KAAKJ,IAAI,CAACI,CAAC,CAAC;IACnC;IACA,IAAI,CAAC,CAAC3B,YAAY,CAACqB,IAAI,CAAC,GAAGO,MAAM,CAACC,MAAM,CAACN,IAAI,CAAC;IAC9C,OAAOE,OAAO;EAChB;;EAEA;AACF;AACA;AACA;AACA;EACEK,cAAcA,CAACC,IAAuB,EAAU;IAC9C,IAAItB,KAAK,GAAGsB,IAAI,EAAE9B,YAAY,GAAG,IAAI,CAAC,CAACA,YAAY,GAAG,IAAI,CAAC,CAACG,YAAY;IACxE,IAAIK,KAAK,KAAKuB,SAAS,IAAID,IAAI,EAAEE,YAAY,KAAKD,SAAS,EAAE,OAAOvB,KAAK;IAEzE,MAAMyB,EAAE,GAAGH,IAAI,CAACE,YAAY;IAC5BxB,KAAK,GAAG,IAAA0B,kBAAU,EAACD,EAAE,CAAC,GAAGA,EAAE,CAAC,CAAC,GAAGA,EAAE;IAClC,IAAI,IAAI,CAAC,CAAC9B,YAAY,KAAK4B,SAAS,EAAE,IAAI,CAACI,cAAc,CAAC3B,KAAK,CAAC;IAChE,OAAOA,KAAK;EACd;;EAEA;AACF;AACA;EACU4B,iBAAiBA,CAAChB,IAA+B,EAAEiB,KAAc,EAAE;IACzE,IAAI5B,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,IAAI,IAAAC,kBAAW,EAAC,CAAC,EAAE;MAC1D;MACA,MAAM0B,CAAC,GAAG,OAAOlB,IAAI,KAAK,QAAQ,GAC9B,IAAIA,IAAI,GAAG,GAAG,4BAA4B;MAC9CN,OAAO,CAACC,cAAc,CAAC,kCAAkCuB,CAAC,EAAE,CAAC;MAC7DxB,OAAO,CAACE,GAAG,CAAC,YAAY,EAAE,IAAAC,sBAAe,EAACoB,KAAK,EAAEjB,IAAI,IAAI,EAAE,CAAC,CAAC;MAC7DN,OAAO,CAACE,GAAG,CAAC,YAAY,EAAE,IAAAC,sBAAe,EAAC,IAAI,CAAC,CAACd,YAAY,CAAC,CAAC;MAC9DW,OAAO,CAACI,QAAQ,CAAC,CAAC;MAClB;IACF;IAEA,IAAI,IAAI,CAACb,UAAU,EAAE;MACnB,IAAI,CAACA,UAAU,CAACC,KAAK,GAAG,IAAI;MAC5B,IAAI,CAACD,UAAU,CAACG,KAAK,GAAG,IAAI,CAAC,CAACL,YAAY;IAC5C,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAACD,cAAc,EAAE;MAChC,IAAI,CAAC,CAACA,cAAc,GAAGqC,UAAU,CAAC,MAAM;QACtC,IAAI,CAAC,CAACrC,cAAc,GAAG6B,SAAS;QAChC,MAAM9B,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,CAACA,QAAQ,CAAC;QACpC,KAAK,IAAIyB,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGzB,QAAQ,CAACwB,MAAM,EAAE,EAAEC,CAAC,EAAE;UACxCzB,QAAQ,CAACyB,CAAC,CAAC,CAAC,CAAC;QACf;MACF,CAAC,CAAC;IACJ;EACF;;EAEA;AACF;AACA;AACA;EACES,cAAcA,CAACE,KAAa,EAAU;IACpC,IAAI,IAAI,CAAC,CAAClC,YAAY,KAAKkC,KAAK,EAAE;MAChC,IAAI,CAAC,CAAClC,YAAY,GAAGkC,KAAK;MAC1B,IAAI,CAACD,iBAAiB,CAAC,IAAI,EAAEC,KAAK,CAAC;IACrC;IACA,OAAOA,KAAK;EACd;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;EAEE;;EAGA;EACA;EACA;EACA;EACA;;EAOA;EACA;;EAMAG,GAAGA,CAASpB,IAAoB,EAAEU,IAAuB,EAAU;IACjE,IAAI,IAAAW,aAAK,EAACrB,IAAI,CAAC,EAAE;MACf,MAAMsB,GAAG,GAAG,IAAI,CAACb,cAAc,CAAEC,IAAoC,CAAC;MACtE,OAAQY,GAAG;IACb;IAEA,MAAMlC,KAAK,GAAGsB,IAAI,EAAE9B,YAAY,GAAG,IAAI,CAAC,CAACA,YAAY,GAAG,IAAI,CAAC,CAACG,YAAY;IAE1E,IAAIuC,GAAG,GAAG,IAAAF,WAAG,EAAChC,KAAK,EAAEY,IAAI,CAAC;IAC1B,IAAIsB,GAAG,KAAKX,SAAS,IAAID,IAAI,EAAEE,YAAY,KAAKD,SAAS,EAAE,OAAOW,GAAG;IAErE,MAAMT,EAAE,GAAGH,IAAI,CAACE,YAAY;IAC5BU,GAAG,GAAG,IAAAR,kBAAU,EAACD,EAAE,CAAC,GAAGA,EAAE,CAAC,CAAC,GAAGA,EAAE;IAEhC,IAAI,CAACH,IAAI,EAAE9B,YAAY,IAAI,IAAI,CAACwC,GAAG,CAACpB,IAAI,CAAC,KAAKW,SAAS,EAAE;MACvD,IAAI,CAACY,GAAG,CAAkBvB,IAAI,EAAEsB,GAAG,CAAC;IACtC;IAEA,OAAOA,GAAG;EACZ;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;;EAEE;;EAOA;EACA;;EAMAC,GAAGA,CAACvB,IAA+B,EAAEiB,KAAc,EAAW;IAC5D,IAAI,IAAAI,aAAK,EAACrB,IAAI,CAAC,EAAE,OAAO,IAAI,CAACe,cAAc,CAACE,KAAe,CAAC;IAE5D,IAAIA,KAAK,KAAK,IAAI,CAACG,GAAG,CAACpB,IAAI,CAAC,EAAE;MAC5B,MAAMwB,IAAI,GAAG;QAAEpC,KAAK,EAAE,IAAI,CAAC,CAACL;MAAa,CAAC;MAC1C,IAAI0C,MAAM,GAAG,CAAC;MACd,IAAIC,GAAQ,GAAGF,IAAI;MACnB,MAAMG,YAAY,GAAG,IAAAC,cAAM,EAAC,SAAS5B,IAAI,EAAE,CAAC;MAC5C,OAAOyB,MAAM,GAAGE,YAAY,CAACtB,MAAM,GAAG,CAAC,EAAEoB,MAAM,IAAI,CAAC,EAAE;QACpD,MAAMI,GAAG,GAAGF,YAAY,CAACF,MAAM,CAAC;QAChC,MAAMK,IAAI,GAAGJ,GAAG,CAACG,GAAG,CAAC;QACrB,IAAIE,KAAK,CAACC,OAAO,CAACF,IAAI,CAAC,EAAEJ,GAAG,CAACG,GAAG,CAAC,GAAG,CAAC,GAAGC,IAAI,CAAC,CAAC,KACzC,IAAI,IAAAG,gBAAQ,EAACH,IAAI,CAAC,EAAEJ,GAAG,CAACG,GAAG,CAAC,GAAG;UAAE,GAAGC;QAAK,CAAC,CAAC,KAC3C;UACH;UACA;UACA;UACA,IAAAP,WAAG,EAACG,GAAG,EAAEC,YAAY,CAACO,KAAK,CAACT,MAAM,CAAC,EAAER,KAAK,CAAC;UAC3C;QACF;QACAS,GAAG,GAAGA,GAAG,CAACG,GAAG,CAAC;MAChB;MAEA,IAAIJ,MAAM,KAAKE,YAAY,CAACtB,MAAM,GAAG,CAAC,EAAE;QACtCqB,GAAG,CAACC,YAAY,CAACF,MAAM,CAAC,CAAC,GAAGR,KAAK;MACnC;MAEA,IAAI,CAAC,CAAClC,YAAY,GAAGyC,IAAI,CAACpC,KAAK;MAE/B,IAAI,CAAC4B,iBAAiB,CAAChB,IAAI,EAAEiB,KAAK,CAAC;IACrC;IACA,OAAOA,KAAK;EACd;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;EACEkB,OAAOA,CAACC,QAAmB,EAAE;IAC3B,IAAI,IAAI,CAACnD,UAAU,EAAE,MAAM,IAAIoD,KAAK,CAAC5D,gBAAgB,CAAC;IAEtD,MAAMI,QAAQ,GAAG,IAAI,CAAC,CAACA,QAAQ;IAC/B,MAAM6C,GAAG,GAAG7C,QAAQ,CAACyD,OAAO,CAACF,QAAQ,CAAC;IACtC,IAAIV,GAAG,IAAI,CAAC,EAAE;MACZ7C,QAAQ,CAAC6C,GAAG,CAAC,GAAG7C,QAAQ,CAACA,QAAQ,CAACwB,MAAM,GAAG,CAAC,CAAC;MAC7CxB,QAAQ,CAAC0D,GAAG,CAAC,CAAC;IAChB;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,KAAKA,CAACJ,QAAmB,EAAE;IACzB,IAAI,IAAI,CAACnD,UAAU,EAAE,MAAM,IAAIoD,KAAK,CAAC5D,gBAAgB,CAAC;IAEtD,MAAMI,QAAQ,GAAG,IAAI,CAAC,CAACA,QAAQ;IAC/B,IAAIA,QAAQ,CAACyD,OAAO,CAACF,QAAQ,CAAC,GAAG,CAAC,EAAE;MAClCvD,QAAQ,CAAC4D,IAAI,CAACL,QAAQ,CAAC;IACzB;EACF;AACF;AAACM,OAAA,CAAAC,OAAA,GAAAjE,WAAA","ignoreList":[]}
+{"version":3,"file":"GlobalState.js","names":["_lodash","require","_utils","ERR_NO_SSR_WATCH","GlobalState","dependencies","initialState","watchers","nextNotifierId","currentState","constructor","ssrContext","dirty","pending","state","process","env","NODE_ENV","isDebugMode","msg","console","groupCollapsed","log","cloneDeepForLog","groupEnd","dropDependencies","path","hasChangedDependencies","deps","prevDeps","changed","length","i","Object","freeze","getEntireState","opts","undefined","initialValue","iv","isFunction","setEntireState","notifyStateUpdate","value","p","setTimeout","get","isNil","res","set","root","segIdx","pos","pathSegments","toPath","seg","next","Array","isArray","isObject","slice","unWatch","callback","Error","indexOf","pop","watch","push","exports","default"],"sources":["../../src/GlobalState.ts"],"sourcesContent":["import {\n  get,\n  isFunction,\n  isObject,\n  isNil,\n  set,\n  toPath,\n} from 'lodash';\n\nimport SsrContext from './SsrContext';\n\nimport {\n  type CallbackT,\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  type ValueAtPathT,\n  type ValueOrInitializerT,\n  cloneDeepForLog,\n  isDebugMode,\n} from './utils';\n\nconst ERR_NO_SSR_WATCH = 'GlobalState must not be watched at server side';\n\ntype GetOptsT<T> = {\n  initialState?: boolean;\n  initialValue?: ValueOrInitializerT<T>;\n};\n\nexport default class GlobalState<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  readonly ssrContext?: SsrContextT;\n\n  #dependencies: { [key: string]: Readonly<any[]> } = {};\n\n  #initialState: StateT;\n\n  // TODO: It is tempting to replace watchers here by\n  // Emitter from @dr.pogodin/js-utils, but we need to clone\n  // current watchers for emitting later, and this is not something\n  // Emitter supports right now.\n  #watchers: CallbackT[] = [];\n\n  #nextNotifierId?: NodeJS.Timeout;\n\n  #currentState: StateT;\n\n  /**\n   * Creates a new global state object.\n   * @param initialState Intial global state content.\n   * @param ssrContext Server-side rendering context.\n   */\n  constructor(\n    initialState: StateT,\n    ssrContext?: SsrContextT,\n  ) {\n    this.#currentState = initialState;\n    this.#initialState = initialState;\n\n    if (ssrContext) {\n      /* eslint-disable no-param-reassign */\n      ssrContext.dirty = false;\n      ssrContext.pending = [];\n      ssrContext.state = this.#currentState;\n      /* eslint-enable no-param-reassign */\n\n      this.ssrContext = ssrContext;\n    }\n\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      let msg = 'New ReactGlobalState created';\n      if (ssrContext) msg += ' (SSR mode)';\n      console.groupCollapsed(msg);\n      console.log('Initial state:', cloneDeepForLog(initialState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n  }\n\n  /**\n   * Drops the record of dependencies, if any, for the given path.\n   */\n  dropDependencies(path: string) {\n    delete this.#dependencies[path];\n  }\n\n  /**\n   * Checks if given `deps` are different from previously recorded ones for\n   * the given `path`. If they are, `deps` are recorded as the new deps for\n   * the `path`, and also the array is frozen, to prevent it from being\n   * modified.\n   */\n  hasChangedDependencies(path: string, deps: any[]): boolean {\n    const prevDeps = this.#dependencies[path];\n    let changed = !prevDeps || prevDeps.length !== deps.length;\n    for (let i = 0; !changed && i < deps.length; ++i) {\n      changed = prevDeps![i] !== deps[i];\n    }\n    this.#dependencies[path] = Object.freeze(deps);\n    return changed;\n  }\n\n  /**\n   * Gets entire state, the same way as .get(null, opts) would do.\n   * @param opts.initialState\n   * @param opts.initialValue\n   */\n  getEntireState(opts?: GetOptsT<StateT>): StateT {\n    let state = opts?.initialState ? this.#initialState : this.#currentState;\n    if (state !== undefined || opts?.initialValue === undefined) return state;\n\n    const iv = opts.initialValue;\n    state = isFunction(iv) ? iv() : iv;\n    if (this.#currentState === undefined) this.setEntireState(state);\n    return state;\n  }\n\n  /**\n   * Notifies all connected state watchers that a state update has happened.\n   */\n  private notifyStateUpdate(path: null | string | undefined, value: unknown) {\n    if (process.env.NODE_ENV !== 'production' && isDebugMode()) {\n      /* eslint-disable no-console */\n      const p = typeof path === 'string'\n        ? `\"${path}\"` : 'none (entire state update)';\n      console.groupCollapsed(`ReactGlobalState update. Path: ${p}`);\n      console.log('New value:', cloneDeepForLog(value, path ?? ''));\n      console.log('New state:', cloneDeepForLog(this.#currentState));\n      console.groupEnd();\n      /* eslint-enable no-console */\n    }\n\n    if (this.ssrContext) {\n      this.ssrContext.dirty = true;\n      this.ssrContext.state = this.#currentState;\n    } else if (!this.#nextNotifierId) {\n      this.#nextNotifierId = setTimeout(() => {\n        this.#nextNotifierId = undefined;\n        const watchers = [...this.#watchers];\n        for (let i = 0; i < watchers.length; ++i) {\n          watchers[i]!();\n        }\n      });\n    }\n  }\n\n  /**\n   * Sets entire state, the same way as .set(null, value) would do.\n   * @param value\n   */\n  setEntireState(value: StateT): StateT {\n    if (this.#currentState !== value) {\n      this.#currentState = value;\n      this.notifyStateUpdate(null, value);\n    }\n    return value;\n  }\n\n  /**\n   * Gets current or initial value at the specified \"path\" of the global state.\n   * @param path Dot-delimitered state path.\n   * @param options Additional options.\n   * @param options.initialState If \"true\" the value will be read\n   *  from the initial state instead of the current one.\n   * @param options.initialValue If the value read from the \"path\" is\n   *  \"undefined\", this \"initialValue\" will be returned instead. In such case\n   *  \"initialValue\" will also be written to the \"path\" of the current global\n   *  state (no matter \"initialState\" flag), if \"undefined\" is stored there.\n   * @return Retrieved value.\n   */\n\n  // .get() without arguments just falls back to .getEntireState().\n  get(): StateT;\n\n  // This variant attempts to automatically resolve and check the type of value\n  // at the given path, as precise as the actual state and path types permit.\n  // If the automatic path resolution is not possible, the ValueT fallsback\n  // to `never` (or to `undefined` in some cases), effectively forbidding\n  // to use this .get() variant.\n  get<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, opts?: GetOptsT<ValueArgT>): ValueResT;\n\n  // This variant is not callable by default (without generic arguments),\n  // otherwise it allows to set the correct ValueT directly.\n  get<Forced extends ForceT | LockT = LockT, ValueT = void>(\n    path?: null | string,\n    opts?: GetOptsT<TypeLock<Forced, never, ValueT>>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  get<ValueT>(path?: null | string, opts?: GetOptsT<ValueT>): ValueT {\n    if (isNil(path)) {\n      const res = this.getEntireState((opts as unknown) as GetOptsT<StateT>);\n      return (res as unknown) as ValueT;\n    }\n\n    const state = opts?.initialState ? this.#initialState : this.#currentState;\n\n    let res = get(state, path);\n    if (res !== undefined || opts?.initialValue === undefined) return res;\n\n    const iv = opts.initialValue;\n    res = isFunction(iv) ? iv() : iv;\n\n    if (!opts?.initialState || this.get(path) === undefined) {\n      this.set<ForceT, unknown>(path, res);\n    }\n\n    return res;\n  }\n\n  /**\n   * Writes the `value` to given global state `path`.\n   * @param path Dot-delimitered state path. If not given, entire\n   * global state content is replaced by the `value`.\n   * @param value The value.\n   * @return Given `value` itself.\n   */\n\n  // This variant attempts automatic value type resolution & checking.\n  set<\n    PathT extends null | string | undefined,\n    ValueArgT extends ValueAtPathT<StateT, PathT, never>,\n    ValueResT extends ValueAtPathT<StateT, PathT, void>,\n  >(path: PathT, value: ValueArgT): ValueResT;\n\n  // This variant is disabled by default, otherwise allows to give\n  // expected value type explicitly.\n  set<Forced extends ForceT | LockT = LockT, ValueT = never>(\n    path: null | string | undefined,\n    value: TypeLock<Forced, never, ValueT>,\n  ): TypeLock<Forced, void, ValueT>;\n\n  set(path: null | string | undefined, value: unknown): unknown {\n    if (isNil(path)) return this.setEntireState(value as StateT);\n\n    if (value !== this.get(path)) {\n      const root = { state: this.#currentState };\n      let segIdx = 0;\n      let pos: any = root;\n      const pathSegments = toPath(`state.${path}`);\n      for (; segIdx < pathSegments.length - 1; segIdx += 1) {\n        const seg = pathSegments[segIdx]!;\n        const next = pos[seg];\n        if (Array.isArray(next)) pos[seg] = [...next];\n        else if (isObject(next)) pos[seg] = { ...next };\n        else {\n          // We arrived to a state sub-segment, where the remaining part of\n          // the update path does not exist yet. We rely on lodash's set()\n          // function to create the remaining path, and set the value.\n          set(pos, pathSegments.slice(segIdx), value);\n          break;\n        }\n        pos = pos[seg];\n      }\n\n      if (segIdx === pathSegments.length - 1) {\n        pos[pathSegments[segIdx]!] = value;\n      }\n\n      this.#currentState = root.state;\n\n      this.notifyStateUpdate(path, value);\n    }\n    return value;\n  }\n\n  /**\n   * Unsubscribes `callback` from watching state updates; no operation if\n   * `callback` is not subscribed to the state updates.\n   * @param callback\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  unWatch(callback: CallbackT) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    const pos = watchers.indexOf(callback);\n    if (pos >= 0) {\n      watchers[pos] = watchers[watchers.length - 1]!;\n      watchers.pop();\n    }\n  }\n\n  /**\n   * Subscribes `callback` to watch state updates; no operation if\n   * `callback` is already subscribed to this state instance.\n   * @param callback It will be called without any arguments every\n   * time the state content changes (note, howhever, separate state updates can\n   * be applied to the state at once, and watching callbacks will be called once\n   * after such bulk update).\n   * @throws if {@link SsrContext} is attached to the state instance: the state\n   * watching functionality is intended for client-side (non-SSR) only.\n   */\n  watch(callback: CallbackT) {\n    if (this.ssrContext) throw new Error(ERR_NO_SSR_WATCH);\n\n    const watchers = this.#watchers;\n    if (watchers.indexOf(callback) < 0) {\n      watchers.push(callback);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/build/common/index.js

@@ -4,16 +4,6 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-var _exportNames = {
-  withGlobalStateType: true,
-  GlobalState: true,
-  GlobalStateProvider: true,
-  getGlobalState: true,
-  getSsrContext: true,
-  SsrContext: true,
-  useAsyncCollection: true,
-  useGlobalState: true
-};
 Object.defineProperty(exports, "GlobalState", {
   enumerable: true,
   get: function () {
@@ -44,12 +34,24 @@ Object.defineProperty(exports, "getSsrContext", {
     return _GlobalStateProvider.getSsrContext;
   }
 });
+Object.defineProperty(exports, "newAsyncDataEnvelope", {
+  enumerable: true,
+  get: function () {
+    return _useAsyncData.newAsyncDataEnvelope;
+  }
+});
 Object.defineProperty(exports, "useAsyncCollection", {
   enumerable: true,
   get: function () {
     return _useAsyncCollection.default;
   }
 });
+Object.defineProperty(exports, "useAsyncData", {
+  enumerable: true,
+  get: function () {
+    return _useAsyncData.useAsyncData;
+  }
+});
 Object.defineProperty(exports, "useGlobalState", {
   enumerable: true,
   get: function () {
@@ -62,17 +64,6 @@ var _GlobalStateProvider = _interopRequireWildcard(require("./GlobalStateProvide
 var _SsrContext = _interopRequireDefault(require("./SsrContext"));
 var _useAsyncCollection = _interopRequireDefault(require("./useAsyncCollection"));
 var _useAsyncData = require("./useAsyncData");
-Object.keys(_useAsyncData).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _useAsyncData[key]) return;
-  Object.defineProperty(exports, key, {
-    enumerable: true,
-    get: function () {
-      return _useAsyncData[key];
-    }
-  });
-});
 var _useGlobalState = _interopRequireDefault(require("./useGlobalState"));
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }

package/build/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_GlobalState","_interopRequireDefault","require","_GlobalStateProvider","_interopRequireWildcard","_SsrContext","_useAsyncCollection","_useAsyncData","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_useGlobalState","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","n","__proto__","a","getOwnPropertyDescriptor","u","i","set","api","getGlobalState","getSsrContext","GlobalState","GlobalStateProvider","newAsyncDataEnvelope","SsrContext","useAsyncCollection","useAsyncData","useGlobalState","withGlobalStateType"],"sources":["../../src/index.ts"],"sourcesContent":["import GlobalState from './GlobalState';\n\nimport GlobalStateProvider, {\n  getGlobalState,\n  getSsrContext,\n} from './GlobalStateProvider';\n\nimport SsrContext from './SsrContext';\n\nimport useAsyncCollection, {\n  type UseAsyncCollectionI,\n} from './useAsyncCollection';\n\nimport {\n  type UseAsyncDataI,\n  newAsyncDataEnvelope,\n  useAsyncData,\n} from './useAsyncData';\n\nimport useGlobalState, { type UseGlobalStateI } from './useGlobalState';\n\nexport type { AsyncCollectionLoaderT } from './useAsyncCollection';\n\nexport * from './useAsyncData';\n\nexport type { SetterT, UseGlobalStateResT } from './useGlobalState';\n\nexport type { ForceT, ValueOrInitializerT } from './utils';\n\nexport {\n  getGlobalState,\n  getSsrContext,\n  GlobalState,\n  GlobalStateProvider,\n  SsrContext,\n  useAsyncCollection,\n  useGlobalState,\n};\n\ninterface API<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  getGlobalState: typeof getGlobalState<StateT, SsrContextT>;\n  getSsrContext: typeof getSsrContext<SsrContextT>,\n  GlobalState: typeof GlobalState<StateT, SsrContextT>,\n  GlobalStateProvider: typeof GlobalStateProvider<StateT, SsrContextT>,\n  newAsyncDataEnvelope: typeof newAsyncDataEnvelope,\n  SsrContext: typeof SsrContext<StateT>,\n  useAsyncCollection: UseAsyncCollectionI<StateT>,\n  useAsyncData: UseAsyncDataI<StateT>,\n  useGlobalState: UseGlobalStateI<StateT>,\n}\n\nconst api = {\n  getGlobalState,\n  getSsrContext,\n  GlobalState,\n  GlobalStateProvider,\n  newAsyncDataEnvelope,\n  SsrContext,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n};\n\nexport function withGlobalStateType<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>() {\n  return api as API<StateT, SsrContextT>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,sBAAA,CAAAC,OAAA;AAEA,IAAAC,oBAAA,GAAAC,uBAAA,CAAAF,OAAA;AAKA,IAAAG,WAAA,GAAAJ,sBAAA,CAAAC,OAAA;AAEA,IAAAI,mBAAA,GAAAL,sBAAA,CAAAC,OAAA;AAIA,IAAAK,aAAA,GAAAL,OAAA;AAUAM,MAAA,CAAAC,IAAA,CAAAF,aAAA,EAAAG,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAJ,aAAA,CAAAI,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAZ,aAAA,CAAAI,GAAA;IAAA;EAAA;AAAA;AAJA,IAAAS,eAAA,GAAAnB,sBAAA,CAAAC,OAAA;AAAwE,SAAAmB,yBAAAC,CAAA,6BAAAC,OAAA,mBAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,CAAAC,CAAA,WAAAA,CAAA,GAAAG,CAAA,GAAAD,CAAA,KAAAF,CAAA;AAAA,SAAAlB,wBAAAkB,CAAA,EAAAE,CAAA,SAAAA,CAAA,IAAAF,CAAA,IAAAA,CAAA,CAAAI,UAAA,SAAAJ,CAAA,eAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,WAAAK,OAAA,EAAAL,CAAA,QAAAG,CAAA,GAAAJ,wBAAA,CAAAG,CAAA,OAAAC,CAAA,IAAAA,CAAA,CAAAG,GAAA,CAAAN,CAAA,UAAAG,CAAA,CAAAN,GAAA,CAAAG,CAAA,OAAAO,CAAA,KAAAC,SAAA,UAAAC,CAAA,GAAAvB,MAAA,CAAAS,cAAA,IAAAT,MAAA,CAAAwB,wBAAA,WAAAC,CAAA,IAAAX,CAAA,oBAAAW,CAAA,OAAApB,cAAA,CAAAC,IAAA,CAAAQ,CAAA,EAAAW,CAAA,SAAAC,CAAA,GAAAH,CAAA,GAAAvB,MAAA,CAAAwB,wBAAA,CAAAV,CAAA,EAAAW,CAAA,UAAAC,CAAA,KAAAA,CAAA,CAAAf,GAAA,IAAAe,CAAA,CAAAC,GAAA,IAAA3B,MAAA,CAAAS,cAAA,CAAAY,CAAA,EAAAI,CAAA,EAAAC,CAAA,IAAAL,CAAA,CAAAI,CAAA,IAAAX,CAAA,CAAAW,CAAA,YAAAJ,CAAA,CAAAF,OAAA,GAAAL,CAAA,EAAAG,CAAA,IAAAA,CAAA,CAAAU,GAAA,CAAAb,CAAA,EAAAO,CAAA,GAAAA,CAAA;AAmCxE,MAAMO,GAAG,GAAG;EACVC,cAAc,EAAdA,mCAAc;EACdC,aAAa,EAAbA,kCAAa;EACbC,WAAW,EAAXA,oBAAW;EACXC,mBAAmB,EAAnBA,4BAAmB;EACnBC,oBAAoB,EAApBA,kCAAoB;EACpBC,UAAU,EAAVA,mBAAU;EACVC,kBAAkB,EAAlBA,2BAAkB;EAClBC,YAAY,EAAZA,0BAAY;EACZC,cAAc,EAAdA;AACF,CAAC;AAEM,SAASC,mBAAmBA,CAAA,EAG/B;EACF,OAAOV,GAAG;AACZ","ignoreList":[]}
+{"version":3,"file":"index.js","names":["_GlobalState","_interopRequireDefault","require","_GlobalStateProvider","_interopRequireWildcard","_SsrContext","_useAsyncCollection","_useAsyncData","_useGlobalState","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","api","getGlobalState","getSsrContext","GlobalState","GlobalStateProvider","newAsyncDataEnvelope","SsrContext","useAsyncCollection","useAsyncData","useGlobalState","withGlobalStateType"],"sources":["../../src/index.ts"],"sourcesContent":["import GlobalState from './GlobalState';\n\nimport GlobalStateProvider, {\n  getGlobalState,\n  getSsrContext,\n} from './GlobalStateProvider';\n\nimport SsrContext from './SsrContext';\n\nimport useAsyncCollection, {\n  type UseAsyncCollectionI,\n  type UseAsyncCollectionResT,\n} from './useAsyncCollection';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  type UseAsyncDataI,\n  type UseAsyncDataResT,\n  newAsyncDataEnvelope,\n  useAsyncData,\n} from './useAsyncData';\n\nimport useGlobalState, { type UseGlobalStateI } from './useGlobalState';\n\nexport type { AsyncCollectionLoaderT } from './useAsyncCollection';\n\nexport type { SetterT, UseGlobalStateResT } from './useGlobalState';\n\nexport type { ForceT, ValueOrInitializerT } from './utils';\n\nexport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type AsyncDataReloaderT,\n  type UseAsyncCollectionResT,\n  type UseAsyncDataResT,\n  getGlobalState,\n  getSsrContext,\n  GlobalState,\n  GlobalStateProvider,\n  newAsyncDataEnvelope,\n  SsrContext,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n};\n\ninterface API<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n> {\n  getGlobalState: typeof getGlobalState<StateT, SsrContextT>;\n  getSsrContext: typeof getSsrContext<SsrContextT>,\n  GlobalState: typeof GlobalState<StateT, SsrContextT>,\n  GlobalStateProvider: typeof GlobalStateProvider<StateT, SsrContextT>,\n  newAsyncDataEnvelope: typeof newAsyncDataEnvelope,\n  SsrContext: typeof SsrContext<StateT>,\n  useAsyncCollection: UseAsyncCollectionI<StateT>,\n  useAsyncData: UseAsyncDataI<StateT>,\n  useGlobalState: UseGlobalStateI<StateT>,\n}\n\nconst api = {\n  getGlobalState,\n  getSsrContext,\n  GlobalState,\n  GlobalStateProvider,\n  newAsyncDataEnvelope,\n  SsrContext,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n};\n\nexport function withGlobalStateType<\n  StateT,\n  SsrContextT extends SsrContext<StateT> = SsrContext<StateT>,\n>() {\n  return api as API<StateT, SsrContextT>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,sBAAA,CAAAC,OAAA;AAEA,IAAAC,oBAAA,GAAAC,uBAAA,CAAAF,OAAA;AAKA,IAAAG,WAAA,GAAAJ,sBAAA,CAAAC,OAAA;AAEA,IAAAI,mBAAA,GAAAL,sBAAA,CAAAC,OAAA;AAKA,IAAAK,aAAA,GAAAL,OAAA;AAUA,IAAAM,eAAA,GAAAP,sBAAA,CAAAC,OAAA;AAAwE,SAAAO,yBAAAC,CAAA,6BAAAC,OAAA,mBAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,CAAAC,CAAA,WAAAA,CAAA,GAAAG,CAAA,GAAAD,CAAA,KAAAF,CAAA;AAAA,SAAAN,wBAAAM,CAAA,EAAAE,CAAA,SAAAA,CAAA,IAAAF,CAAA,IAAAA,CAAA,CAAAI,UAAA,SAAAJ,CAAA,eAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,WAAAK,OAAA,EAAAL,CAAA,QAAAG,CAAA,GAAAJ,wBAAA,CAAAG,CAAA,OAAAC,CAAA,IAAAA,CAAA,CAAAG,GAAA,CAAAN,CAAA,UAAAG,CAAA,CAAAI,GAAA,CAAAP,CAAA,OAAAQ,CAAA,KAAAC,SAAA,UAAAC,CAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,CAAA,IAAAd,CAAA,oBAAAc,CAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAhB,CAAA,EAAAc,CAAA,SAAAG,CAAA,GAAAP,CAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAb,CAAA,EAAAc,CAAA,UAAAG,CAAA,KAAAA,CAAA,CAAAV,GAAA,IAAAU,CAAA,CAAAC,GAAA,IAAAP,MAAA,CAAAC,cAAA,CAAAJ,CAAA,EAAAM,CAAA,EAAAG,CAAA,IAAAT,CAAA,CAAAM,CAAA,IAAAd,CAAA,CAAAc,CAAA,YAAAN,CAAA,CAAAH,OAAA,GAAAL,CAAA,EAAAG,CAAA,IAAAA,CAAA,CAAAe,GAAA,CAAAlB,CAAA,EAAAQ,CAAA,GAAAA,CAAA;AAwCxE,MAAMW,GAAG,GAAG;EACVC,cAAc,EAAdA,mCAAc;EACdC,aAAa,EAAbA,kCAAa;EACbC,WAAW,EAAXA,oBAAW;EACXC,mBAAmB,EAAnBA,4BAAmB;EACnBC,oBAAoB,EAApBA,kCAAoB;EACpBC,UAAU,EAAVA,mBAAU;EACVC,kBAAkB,EAAlBA,2BAAkB;EAClBC,YAAY,EAAZA,0BAAY;EACZC,cAAc,EAAdA;AACF,CAAC;AAEM,SAASC,mBAAmBA,CAAA,EAG/B;EACF,OAAOV,GAAG;AACZ","ignoreList":[]}

package/build/common/useAsyncCollection.js

@@ -1,60 +1,206 @@
 "use strict";
 
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
+var _react = require("react");
+var _uuid = require("uuid");
+var _GlobalStateProvider = require("./GlobalStateProvider");
 var _useAsyncData = require("./useAsyncData");
+var _useGlobalState = _interopRequireDefault(require("./useGlobalState"));
+var _utils = require("./utils");
 /**
- * Loads and uses an item in an async collection.
+ * Loads and uses item(s) in an async collection.
  */
 
 /**
- * Resolves and stores at the given `path` of global state elements of
- * an asynchronous data collection. In other words, it is an auxiliar wrapper
- * around {@link useAsyncData}, which uses a loader which resolves to different
- * data, based on ID argument passed in, and stores data fetched for different
- * IDs in the state.
- * @param id ID of the collection item to load & use.
- * @param path The global state path where entire collection should be
- *  stored.
- * @param loader A loader function, which takes an
- * ID of data to load, and resolves to the corresponding data.
- * @param options Additional options.
- * @param options.deps An array of dependencies, which trigger
- * data reload when changed. Given dependency changes are watched shallowly
- * (similarly to the standard React's
- * [useEffect()](https://reactjs.org/docs/hooks-reference.html#useeffect)).
- * @param options.noSSR If `true`, this hook won't load data during
- * server-side rendering.
- * @param options.garbageCollectAge The maximum age of data
- * (in milliseconds), after which they are dropped from the state when the last
- * component referencing them via `useAsyncData()` hook unmounts. Defaults to
- * `maxage` option value.
- * @param options.maxage The maximum age of
- * data (in milliseconds) acceptable to the hook's caller. If loaded data are
- * older than this value, `null` is returned instead. Defaults to 5 minutes.
- * @param options.refreshAge The maximum age of data
- * (in milliseconds), after which their refreshment will be triggered when
- * any component referencing them via `useAsyncData()` hook (re-)renders.
- * Defaults to `maxage` value.
- * @return Returns an object with three fields: `data` holds the actual result of
- * last `loader` invokation, if any, and if satisfies `maxage` limit; `loading`
- * is a boolean flag, which is `true` if data are being loaded (the hook is
- * waiting for `loader` function resolution); `timestamp` (in milliseconds)
- * is Unix timestamp of related data currently loaded into the global state.
- *
- * Note that loaded data, if any, are stored at the given `path` of global state
- * along with related meta-information, using slightly different state segment
- * structure (see {@link AsyncDataEnvelope}). That segment of the global state
- * can be accessed, and even modified using other hooks,
- * _e.g._ {@link useGlobalState}, but doing so you may interfere with related
- * `useAsyncData()` hooks logic.
+ * Resolves and stores at the given `path` of the global state elements of
+ * an asynchronous data collection.
  */
 
-function useAsyncCollection(id, path, loader, options = {}) {
-  const itemPath = path ? `${path}.${id}` : id;
-  return (0, _useAsyncData.useAsyncData)(itemPath, oldData => loader(id, oldData), options);
+// TODO: This is largely similar to useAsyncData() logic, just more generic.
+// Perhaps, a bunch of logic blocks can be split into stand-alone functions,
+// and reused in both hooks.
+function useAsyncCollection(idOrIds, path, loader, options = {}) {
+  const ids = Array.isArray(idOrIds) ? idOrIds : [idOrIds];
+  const maxage = options.maxage ?? _useAsyncData.DEFAULT_MAXAGE;
+  const refreshAge = options.refreshAge ?? maxage;
+  const garbageCollectAge = options.garbageCollectAge ?? maxage;
+
+  // To avoid unnecessary work if consumer passes down the same IDs
+  // in an unstable order.
+  // TODO: Should we also filter out any duplicates? Or just assume consumer
+  // knows what he is doing, and won't place duplicates into IDs array?e
+  ids.sort();
+  const globalState = (0, _GlobalStateProvider.getGlobalState)();
+  const {
+    current: heap
+  } = (0, _react.useRef)({});
+  heap.globalState = globalState;
+  heap.ids = ids;
+  heap.path = path;
+  heap.loader = loader;
+  if (!heap.reload) {
+    heap.reload = async customLoader => {
+      const localLoader = customLoader || heap.loader;
+      if (!localLoader || !heap.globalState || !heap.ids) {
+        throw Error('Internal error');
+      }
+      for (let i = 0; i < heap.ids.length; ++i) {
+        const id = heap.ids[i];
+        const itemPath = heap.path ? `${heap.path}.${id}` : `${id}`;
+
+        // eslint-disable-next-line no-await-in-loop
+        await (0, _useAsyncData.load)(itemPath, (oldData, meta) => localLoader(id, oldData, meta), heap.globalState);
+      }
+    };
+  }
+  if (!Array.isArray(idOrIds)) {
+    heap.reloadD = customLoader => heap.reload(customLoader && ((id, ...args) => customLoader(...args)));
+  }
+
+  // Server-side logic.
+  if (globalState.ssrContext && !options.noSSR) {
+    const operationId = `S${(0, _uuid.v4)()}`;
+    for (let i = 0; i < ids.length; ++i) {
+      const id = ids[i];
+      const itemPath = path ? `${path}.${id}` : `${id}`;
+      const state = globalState.get(itemPath, {
+        initialValue: (0, _useAsyncData.newAsyncDataEnvelope)()
+      });
+      if (!state.timestamp && !state.operationId) {
+        globalState.ssrContext.pending.push((0, _useAsyncData.load)(itemPath, (...args) => loader(id, ...args), globalState, {
+          data: state.data,
+          timestamp: state.timestamp
+        }, operationId));
+      }
+    }
+
+    // Client-side logic.
+  } else {
+    // Reference-counting & garbage collection.
+
+    // TODO: Violation of rules of hooks is fine here,
+    // but perhaps it can be refactored to avoid the need for it.
+    (0, _react.useEffect)(() => {
+      // eslint-disable-line react-hooks/rules-of-hooks
+      for (let i = 0; i < ids.length; ++i) {
+        const id = ids[i];
+        const itemPath = path ? `${path}.${id}` : `${id}`;
+        const state = globalState.get(itemPath, {
+          initialValue: (0, _useAsyncData.newAsyncDataEnvelope)()
+        });
+        const numRefsPath = itemPath ? `${itemPath}.numRefs` : 'numRefs';
+        globalState.set(numRefsPath, state.numRefs + 1);
+      }
+      return () => {
+        for (let i = 0; i < ids.length; ++i) {
+          const id = ids[i];
+          const itemPath = path ? `${path}.${id}` : `${id}`;
+          const state2 = globalState.get(itemPath);
+          if (state2.numRefs === 1 && garbageCollectAge < Date.now() - state2.timestamp) {
+            if (process.env.NODE_ENV !== 'production' && (0, _utils.isDebugMode)()) {
+              /* eslint-disable no-console */
+              console.log(`ReactGlobalState - useAsyncCollection garbage collected at path ${itemPath || ''}`);
+              /* eslint-enable no-console */
+            }
+            globalState.dropDependencies(itemPath || '');
+            globalState.set(itemPath, {
+              ...state2,
+              data: null,
+              numRefs: 0,
+              timestamp: 0
+            });
+          } else {
+            const numRefsPath = itemPath ? `${itemPath}.numRefs` : 'numRefs';
+            globalState.set(numRefsPath, state2.numRefs - 1);
+          }
+        }
+      };
+      // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [garbageCollectAge, globalState, path, ...ids]);
+
+    // NOTE: a bunch of Rules of Hooks ignored belows because in our very
+    // special case the otherwise wrong behavior is actually what we need.
+
+    // Data loading and refreshing.
+    const loadTriggeredForIds = new Set();
+    (0, _react.useEffect)(() => {
+      // eslint-disable-line react-hooks/rules-of-hooks
+      (async () => {
+        for (let i = 0; i < ids.length; ++i) {
+          const id = ids[i];
+          const itemPath = path ? `${path}.${id}` : `${id}`;
+          const state2 = globalState.get(itemPath);
+          const {
+            deps
+          } = options;
+          if (deps && globalState.hasChangedDependencies(itemPath, deps) || refreshAge < Date.now() - state2.timestamp && (!state2.operationId || state2.operationId.charAt(0) === 'S')) {
+            if (!deps) globalState.dropDependencies(itemPath);
+            loadTriggeredForIds.add(id);
+            // eslint-disable-next-line no-await-in-loop
+            await (0, _useAsyncData.load)(itemPath, (...args) => loader(id, ...args), globalState, {
+              data: state2.data,
+              timestamp: state2.timestamp
+            });
+          }
+        }
+      })();
+    });
+    (0, _react.useEffect)(() => {
+      // eslint-disable-line react-hooks/rules-of-hooks
+      (async () => {
+        const {
+          deps
+        } = options;
+        for (let i = 0; i < ids.length; ++i) {
+          const id = ids[i];
+          const itemPath = path ? `${path}.${id}` : `${id}`;
+          if (deps && globalState.hasChangedDependencies(itemPath || '', deps) && !loadTriggeredForIds.has(id)) {
+            // eslint-disable-next-line no-await-in-loop
+            await (0, _useAsyncData.load)(itemPath, (oldData, meta) => loader(id, oldData, meta), globalState);
+          }
+        }
+      })();
+
+      // Here we need to default to empty array, so that this hook is re-evaluated
+      // only when dependencies specified in options change, and it should not be
+      // re-evaluated at all if no `deps` option is used.
+    }, options.deps || []); // eslint-disable-line react-hooks/exhaustive-deps
+  }
+  const [localState] = (0, _useGlobalState.default)(path, {});
+  if (!Array.isArray(idOrIds)) {
+    const e = localState[idOrIds];
+    const timestamp = e?.timestamp ?? 0;
+    return {
+      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,
+      loading: !!e?.operationId,
+      reload: heap.reloadD,
+      timestamp
+    };
+  }
+  const res = {
+    items: {},
+    loading: false,
+    reload: heap.reload,
+    timestamp: Number.MAX_VALUE
+  };
+  for (let i = 0; i < ids.length; ++i) {
+    const id = ids[i];
+    const e = localState[id];
+    const loading = !!e?.operationId;
+    const timestamp = e?.timestamp ?? 0;
+    res.items[id] = {
+      data: maxage < Date.now() - timestamp ? null : e?.data ?? null,
+      loading,
+      timestamp
+    };
+    res.loading ||= loading;
+    if (res.timestamp > timestamp) res.timestamp = timestamp;
+  }
+  return res;
 }
 var _default = exports.default = useAsyncCollection;
 //# sourceMappingURL=useAsyncCollection.js.map

package/build/common/useAsyncCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAsyncCollection.js","names":["_useAsyncData","require","useAsyncCollection","id","path","loader","options","itemPath","useAsyncData","oldData","_default","exports","default"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses an item in an async collection.\n */\n\nimport {\n  type DataInEnvelopeAtPathT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  useAsyncData,\n} from './useAsyncData';\n\nimport { type ForceT, type LockT, type TypeLock } from './utils';\n\nexport type AsyncCollectionLoaderT<DataT> =\n  (id: string, oldData: null | DataT) => DataT | Promise<DataT>;\n\n/**\n * Resolves and stores at the given `path` of global state elements of\n * an asynchronous data collection. In other words, it is an auxiliar wrapper\n * around {@link useAsyncData}, which uses a loader which resolves to different\n * data, based on ID argument passed in, and stores data fetched for different\n * IDs in the state.\n * @param id ID of the collection item to load & use.\n * @param path The global state path where entire collection should be\n *  stored.\n * @param loader A loader function, which takes an\n * ID of data to load, and resolves to the corresponding data.\n * @param options Additional options.\n * @param options.deps An array of dependencies, which trigger\n * data reload when changed. Given dependency changes are watched shallowly\n * (similarly to the standard React's\n * [useEffect()](https://reactjs.org/docs/hooks-reference.html#useeffect)).\n * @param options.noSSR If `true`, this hook won't load data during\n * server-side rendering.\n * @param options.garbageCollectAge The maximum age of data\n * (in milliseconds), after which they are dropped from the state when the last\n * component referencing them via `useAsyncData()` hook unmounts. Defaults to\n * `maxage` option value.\n * @param options.maxage The maximum age of\n * data (in milliseconds) acceptable to the hook's caller. If loaded data are\n * older than this value, `null` is returned instead. Defaults to 5 minutes.\n * @param options.refreshAge The maximum age of data\n * (in milliseconds), after which their refreshment will be triggered when\n * any component referencing them via `useAsyncData()` hook (re-)renders.\n * Defaults to `maxage` value.\n * @return Returns an object with three fields: `data` holds the actual result of\n * last `loader` invokation, if any, and if satisfies `maxage` limit; `loading`\n * is a boolean flag, which is `true` if data are being loaded (the hook is\n * waiting for `loader` function resolution); `timestamp` (in milliseconds)\n * is Unix timestamp of related data currently loaded into the global state.\n *\n * Note that loaded data, if any, are stored at the given `path` of global state\n * along with related meta-information, using slightly different state segment\n * structure (see {@link AsyncDataEnvelope}). That segment of the global state\n * can be accessed, and even modified using other hooks,\n * _e.g._ {@link useGlobalState}, but doing so you may interfere with related\n * `useAsyncData()` hooks logic.\n */\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT,\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n>(\n  id: string,\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncCollection<DataT>(\n  id: string,\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> {\n  const itemPath = path ? `${path}.${id}` : id;\n  return useAsyncData<ForceT, DataT>(\n    itemPath,\n    (oldData: null | DataT) => loader(id, oldData),\n    options,\n  );\n}\n\nexport default useAsyncCollection;\n\nexport interface UseAsyncCollectionI<StateT> {\n  <PathT extends null | string | undefined, IdT extends string>(\n    id: IdT,\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n\n  <Forced extends ForceT | LockT = LockT, DataT = unknown>(\n    id: string,\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n}\n"],"mappings":";;;;;;AAIA,IAAAA,aAAA,GAAAC,OAAA;AAJA;AACA;AACA;;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA0BA,SAASC,kBAAkBA,CACzBC,EAAU,EACVC,IAA+B,EAC/BC,MAAqC,EACrCC,OAA6B,GAAG,CAAC,CAAC,EACT;EACzB,MAAMC,QAAQ,GAAGH,IAAI,GAAG,GAAGA,IAAI,IAAID,EAAE,EAAE,GAAGA,EAAE;EAC5C,OAAO,IAAAK,0BAAY,EACjBD,QAAQ,EACPE,OAAqB,IAAKJ,MAAM,CAACF,EAAE,EAAEM,OAAO,CAAC,EAC9CH,OACF,CAAC;AACH;AAAC,IAAAI,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEcV,kBAAkB","ignoreList":[]}
+{"version":3,"file":"useAsyncCollection.js","names":["_react","require","_uuid","_GlobalStateProvider","_useAsyncData","_useGlobalState","_interopRequireDefault","_utils","useAsyncCollection","idOrIds","path","loader","options","ids","Array","isArray","maxage","DEFAULT_MAXAGE","refreshAge","garbageCollectAge","sort","globalState","getGlobalState","current","heap","useRef","reload","customLoader","localLoader","Error","i","length","id","itemPath","load","oldData","meta","reloadD","args","ssrContext","noSSR","operationId","uuid","state","get","initialValue","newAsyncDataEnvelope","timestamp","pending","push","data","useEffect","numRefsPath","set","numRefs","state2","Date","now","process","env","NODE_ENV","isDebugMode","console","log","dropDependencies","loadTriggeredForIds","Set","deps","hasChangedDependencies","charAt","add","has","localState","useGlobalState","e","loading","res","items","Number","MAX_VALUE","_default","exports","default"],"sources":["../../src/useAsyncCollection.ts"],"sourcesContent":["/**\n * Loads and uses item(s) in an async collection.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { v4 as uuid } from 'uuid';\n\nimport GlobalState from './GlobalState';\nimport { getGlobalState } from './GlobalStateProvider';\n\nimport {\n  type AsyncDataEnvelopeT,\n  type AsyncDataReloaderT,\n  type DataInEnvelopeAtPathT,\n  type OperationIdT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  DEFAULT_MAXAGE,\n  load,\n  newAsyncDataEnvelope,\n} from './useAsyncData';\n\nimport useGlobalState from './useGlobalState';\n\nimport {\n  type ForceT,\n  type LockT,\n  type TypeLock,\n  isDebugMode,\n} from './utils';\n\nexport type AsyncCollectionLoaderT<\n  DataT,\n  IdT extends number | string = number | string,\n> =\n  (id: IdT, oldData: null | DataT, meta: {\n    isAborted: () => boolean;\n    oldDataTimestamp: number;\n  }) => DataT | Promise<DataT | null> | null;\n\nexport type AsyncCollectionReloaderT<\n  DataT,\n  IdT extends number | string = number | string,\n>\n  = (loader?: AsyncCollectionLoaderT<DataT, IdT>) => Promise<void>;\n\ntype CollectionItemT<DataT> = {\n  data: DataT | null;\n  loading: boolean;\n  timestamp: number;\n};\n\nexport type UseAsyncCollectionResT<\n  DataT,\n  IdT extends number | string = number | string,\n> = {\n  items: {\n    [id in IdT]: CollectionItemT<DataT>;\n  }\n  loading: boolean;\n  reload: AsyncCollectionReloaderT<DataT, IdT>;\n  timestamp: number;\n};\n\ntype HeapT<\n  DataT,\n  IdT extends number | string,\n> = {\n  // Note: these heap fields are necessary to make reload() a stable function.\n  globalState?: GlobalState<unknown>;\n  ids?: IdT[];\n  path?: null | string;\n  loader?: AsyncCollectionLoaderT<DataT, IdT>;\n  reload?: AsyncCollectionReloaderT<DataT, IdT>;\n  reloadD?: AsyncDataReloaderT<DataT>;\n};\n\n/**\n * Resolves and stores at the given `path` of the global state elements of\n * an asynchronous data collection.\n */\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT,\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<DataT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT,\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\nfunction useAsyncCollection<\n  StateT,\n  PathT extends null | string | undefined,\n  IdT extends number | string,\n\n  DataT extends DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`> =\n  DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>,\n>(\n  id: IdT[],\n  path: PathT,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\nfunction useAsyncCollection<\n  Forced extends ForceT | LockT = LockT,\n  DataT = unknown,\n  IdT extends number | string = number | string,\n>(\n  id: IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n  options?: UseAsyncDataOptionsT,\n): UseAsyncCollectionResT<DataT, IdT>;\n\n// TODO: This is largely similar to useAsyncData() logic, just more generic.\n// Perhaps, a bunch of logic blocks can be split into stand-alone functions,\n// and reused in both hooks.\nfunction useAsyncCollection<\n  DataT,\n  IdT extends number | string,\n>(\n  idOrIds: IdT | IdT[],\n  path: null | string | undefined,\n  loader: AsyncCollectionLoaderT<DataT, IdT>,\n  options: UseAsyncDataOptionsT = {},\n): UseAsyncDataResT<DataT> | UseAsyncCollectionResT<DataT, IdT> {\n  const ids = Array.isArray(idOrIds) ? idOrIds : [idOrIds];\n\n  const maxage: number = options.maxage ?? DEFAULT_MAXAGE;\n  const refreshAge: number = options.refreshAge ?? maxage;\n  const garbageCollectAge: number = options.garbageCollectAge ?? maxage;\n\n  // To avoid unnecessary work if consumer passes down the same IDs\n  // in an unstable order.\n  // TODO: Should we also filter out any duplicates? Or just assume consumer\n  // knows what he is doing, and won't place duplicates into IDs array?e\n  ids.sort();\n\n  const globalState = getGlobalState();\n\n  const { current: heap } = useRef<HeapT<DataT, IdT>>({});\n\n  heap.globalState = globalState;\n  heap.ids = ids;\n  heap.path = path;\n  heap.loader = loader;\n\n  if (!heap.reload) {\n    heap.reload = async (customLoader?: AsyncCollectionLoaderT<DataT, IdT>) => {\n      const localLoader = customLoader || heap.loader;\n      if (!localLoader || !heap.globalState || !heap.ids) {\n        throw Error('Internal error');\n      }\n\n      for (let i = 0; i < heap.ids.length; ++i) {\n        const id = heap.ids[i]!;\n        const itemPath = heap.path ? `${heap.path}.${id}` : `${id}`;\n\n        // eslint-disable-next-line no-await-in-loop\n        await load(\n          itemPath,\n          (oldData: DataT | null, meta) => localLoader(id, oldData, meta),\n          heap.globalState,\n        );\n      }\n    };\n  }\n\n  if (!Array.isArray(idOrIds)) {\n    heap.reloadD = (customLoader) => heap.reload!(\n      customLoader && ((id, ...args) => customLoader(...args)),\n    );\n  }\n\n  // Server-side logic.\n  if (globalState.ssrContext && !options.noSSR) {\n    const operationId: OperationIdT = `S${uuid()}`;\n    for (let i = 0; i < ids.length; ++i) {\n      const id = ids[i]!;\n      const itemPath = path ? `${path}.${id}` : `${id}`;\n      const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(itemPath, {\n        initialValue: newAsyncDataEnvelope<DataT>(),\n      });\n      if (!state.timestamp && !state.operationId) {\n        globalState.ssrContext.pending.push(\n          load(itemPath, (...args) => loader(id, ...args), globalState, {\n            data: state.data,\n            timestamp: state.timestamp,\n          }, operationId),\n        );\n      }\n    }\n\n  // Client-side logic.\n  } else {\n    // Reference-counting & garbage collection.\n\n    // 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      for (let i = 0; i < ids.length; ++i) {\n        const id = ids[i];\n        const itemPath = path ? `${path}.${id}` : `${id}`;\n        const state = globalState.get<ForceT, AsyncDataEnvelopeT<DataT>>(\n          itemPath,\n          { initialValue: newAsyncDataEnvelope() },\n        );\n\n        const numRefsPath = itemPath ? `${itemPath}.numRefs` : 'numRefs';\n        globalState.set<ForceT, number>(numRefsPath, state.numRefs + 1);\n      }\n\n      return () => {\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i];\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>\n          >(itemPath);\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 - useAsyncCollection garbage collected at path ${\n                  itemPath || ''\n                }`,\n              );\n              /* eslint-enable no-console */\n            }\n            globalState.dropDependencies(itemPath || '');\n            globalState.set<ForceT, AsyncDataEnvelopeT<DataT>>(itemPath, {\n              ...state2,\n              data: null,\n              numRefs: 0,\n              timestamp: 0,\n            });\n          } else {\n            const numRefsPath = itemPath ? `${itemPath}.numRefs` : 'numRefs';\n            globalState.set<ForceT, number>(numRefsPath, state2.numRefs - 1);\n          }\n        }\n      };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [garbageCollectAge, globalState, path, ...ids]);\n\n    // NOTE: a bunch of Rules of Hooks ignored belows because in our very\n    // special case the otherwise wrong behavior is actually what we need.\n\n    // Data loading and refreshing.\n    const loadTriggeredForIds = new Set<IdT>();\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      (async () => {\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i]!;\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n          const state2: AsyncDataEnvelopeT<DataT> = globalState.get<\n          ForceT, AsyncDataEnvelopeT<DataT>>(itemPath);\n\n          const { deps } = options;\n          if (\n            (deps && globalState.hasChangedDependencies(itemPath, deps))\n            || (\n              refreshAge < Date.now() - state2.timestamp\n              && (!state2.operationId || state2.operationId.charAt(0) === 'S')\n            )\n          ) {\n            if (!deps) globalState.dropDependencies(itemPath);\n            loadTriggeredForIds.add(id);\n            // eslint-disable-next-line no-await-in-loop\n            await load(itemPath, (...args) => loader(id, ...args), globalState, {\n              data: state2.data,\n              timestamp: state2.timestamp,\n            });\n          }\n        }\n      })();\n    });\n\n    useEffect(() => { // eslint-disable-line react-hooks/rules-of-hooks\n      (async () => {\n        const { deps } = options;\n        for (let i = 0; i < ids.length; ++i) {\n          const id = ids[i]!;\n          const itemPath = path ? `${path}.${id}` : `${id}`;\n          if (\n            deps\n            && globalState.hasChangedDependencies(itemPath || '', deps)\n            && !loadTriggeredForIds.has(id)\n          ) {\n            // eslint-disable-next-line no-await-in-loop\n            await load(\n              itemPath,\n              (oldData: null | DataT, meta) => loader(id, oldData, meta),\n              globalState,\n            );\n          }\n        }\n      })();\n\n    // Here we need to default to empty array, so that this hook is re-evaluated\n    // only when dependencies specified in options change, and it should not be\n    // re-evaluated at all if no `deps` option is used.\n    }, options.deps || []); // eslint-disable-line react-hooks/exhaustive-deps\n  }\n\n  const [localState] = useGlobalState<\n  ForceT, { [id: string]: AsyncDataEnvelopeT<DataT> }\n  >(path, {});\n\n  if (!Array.isArray(idOrIds)) {\n    const e = localState[idOrIds];\n    const timestamp = e?.timestamp ?? 0;\n    return {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading: !!e?.operationId,\n      reload: heap.reloadD!,\n      timestamp,\n    };\n  }\n\n  const res: UseAsyncCollectionResT<DataT, IdT> = {\n    items: {} as Record<IdT, CollectionItemT<DataT>>,\n    loading: false,\n    reload: heap.reload,\n    timestamp: Number.MAX_VALUE,\n  };\n\n  for (let i = 0; i < ids.length; ++i) {\n    const id = ids[i]!;\n    const e = localState[id];\n    const loading = !!e?.operationId;\n    const timestamp = e?.timestamp ?? 0;\n\n    res.items[id] = {\n      data: maxage < Date.now() - timestamp ? null : (e?.data ?? null),\n      loading,\n      timestamp,\n    };\n    res.loading ||= loading;\n    if (res.timestamp > timestamp) res.timestamp = timestamp;\n  }\n\n  return res;\n}\n\nexport default useAsyncCollection;\n\nexport interface UseAsyncCollectionI<StateT> {\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT,\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT,\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncDataResT<TypeLock<Forced, void, DataT>>;\n\n  <PathT extends null | string | undefined, IdT extends number | string>(\n    id: IdT[],\n    path: PathT,\n    loader: AsyncCollectionLoaderT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataInEnvelopeAtPathT<StateT, `${PathT}.${IdT}`>, IdT>;\n\n  <\n    Forced extends ForceT | LockT = LockT,\n    DataT = unknown,\n    IdT extends number | string = number | string,\n  >(\n    id: IdT[],\n    path: null | string | undefined,\n    loader: AsyncCollectionLoaderT<TypeLock<Forced, void, DataT>, IdT>,\n    options?: UseAsyncDataOptionsT,\n  ): UseAsyncCollectionResT<DataT, IdT>;\n}\n"],"mappings":"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","ignoreList":[]}