@milaboratories/pl-tree 1.8.34 → 1.8.36

package/dist/synchronized_tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"synchronized_tree.d.ts","sourceRoot":"","sources":["../src/synchronized_tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EACV,0BAA0B,EAC1B,QAAQ,EACR,UAAU,EAEX,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,QAAQ,CAAC;AAOhB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,KAAK,eAAe,GAAG,YAAY,GAAG,aAAa,CAAC;AAEpD,MAAM,MAAM,mBAAmB,GAAG;IAChC,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,0BAA0B,CAAC;IAEpD;+CAC2C;IAC3C,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wEAAwE;IACxE,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B,qGAAqG;IACrG,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAOF,qBAAa,qBAAqB;IAU9B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAZ1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IAEzD,OAAO;IAoBP,sCAAsC;IAC/B,QAAQ,CAAC,GAAG,GAAE,UAAsB,GAAG,WAAW;IAKlD,KAAK,CAAC,GAAG,GAAE,UAAsB,GAAG,WAAW;IAKtD;wDACoD;IACvC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,OAAO,CAAC,yBAAyB,CAA0C;IAC3E,OAAO,CAAC,oBAAoB,CAA0B;IAEtD,iFAAiF;IACjF,OAAO,CAAC,mBAAmB;IAW3B,2BAA2B;IAC3B,OAAO,CAAC,aAAa;IAMrB,2BAA2B;IAC3B,OAAO,CAAC,YAAY;IAIpB,yDAAyD;IACzD,OAAO,CAAC,WAAW,CAAS;IAC5B,iCAAiC;IACjC,OAAO,CAAC,WAAW,CAAwC;IAE3D,iEAAiE;YACnD,OAAO;IASrB,wDAAwD;IACxD,OAAO,CAAC,UAAU,CAAS;YAEb,QAAQ;IA+EtB;;;OAGG;IACI,SAAS,IAAI,oBAAoB,EAAE;IAI1C;;;SAGK;IACQ,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAWvC,kBAAkB;IACL,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;WAKlC,IAAI,CACtB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,mBAAmB,EACxB,MAAM,CAAC,EAAE,QAAQ;CAuBpB"}
+{"version":3,"file":"synchronized_tree.d.ts","sourceRoot":"","sources":["../src/synchronized_tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EACV,0BAA0B,EAC1B,QAAQ,EACR,UAAU,EAEX,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAmB,MAAM,QAAQ,CAAC;AAG/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,KAAK,eAAe,GAAG,YAAY,GAAG,aAAa,CAAC;AAEpD,MAAM,MAAM,mBAAmB,GAAG;IAChC,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,0BAA0B,CAAC;IAEpD;+CAC2C;IAC3C,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wEAAwE;IACxE,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B,qGAAqG;IACrG,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAOF,qBAAa,qBAAqB;IAU9B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAZ1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IAEzD,OAAO;IAoBP,sCAAsC;IAC/B,QAAQ,CAAC,GAAG,GAAE,UAAsB,GAAG,WAAW;IAKlD,KAAK,CAAC,GAAG,GAAE,UAAsB,GAAG,WAAW;IAKtD;wDACoD;IACvC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1C,OAAO,CAAC,yBAAyB,CAA0C;IAC3E,OAAO,CAAC,oBAAoB,CAA0B;IAEtD,iFAAiF;IACjF,OAAO,CAAC,mBAAmB;IAW3B,2BAA2B;IAC3B,OAAO,CAAC,aAAa;IAMrB,2BAA2B;IAC3B,OAAO,CAAC,YAAY;IAIpB,yDAAyD;IACzD,OAAO,CAAC,WAAW,CAAS;IAC5B,iCAAiC;IACjC,OAAO,CAAC,WAAW,CAAwC;IAE3D,iEAAiE;YACnD,OAAO;IAarB,wDAAwD;IACxD,OAAO,CAAC,UAAU,CAAS;YAEb,QAAQ;IAuFtB;;;OAGG;IACI,SAAS,IAAI,oBAAoB,EAAE;IAI1C;;;SAGK;IACQ,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAWvC,kBAAkB;IACL,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;WAKlC,IAAI,CACtB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,mBAAmB,EACxB,MAAM,CAAC,EAAE,QAAQ;CAuBpB"}

package/dist/synchronized_tree.js

@@ -31,19 +31,19 @@ class SynchronizedTreeState {
     /** @deprecated use "entry" instead */
     accessor(rid = this.root) {
         if (this.terminated)
-            throw new Error('tree synchronization is terminated');
+            throw new Error("tree synchronization is terminated");
         return this.entry(rid);
     }
     entry(rid = this.root) {
         if (this.terminated)
-            throw new Error('tree synchronization is terminated');
+            throw new Error("tree synchronization is terminated");
         return new PlTreeEntry({ treeProvider: () => this.state, hooks: this.hooks }, rid);
     }
     /** Can be used to externally kick off the synchronization polling loop, and
      * await for the first synchronization to happen. */
     async refreshState() {
         if (this.terminated)
-            throw new Error('tree synchronization is terminated');
+            throw new Error("tree synchronization is terminated");
         await this.hooks.refreshState();
     }
     currentLoopDelayInterrupt = undefined;
@@ -51,7 +51,7 @@ class SynchronizedTreeState {
     /** Called from computable hooks when external observer asks for state refresh */
     scheduleOnNextState(resolve, reject) {
         if (this.terminated)
-            reject(new Error('tree synchronization is terminated'));
+            reject(new Error("tree synchronization is terminated"));
         else {
             this.scheduledOnNextState.push({ resolve, reject });
             if (this.currentLoopDelayInterrupt) {
@@ -79,9 +79,9 @@ class SynchronizedTreeState {
     /** Executed from the main loop, and initialization procedure. */
     async refresh(stats, txOps) {
         if (this.terminated)
-            throw new Error('tree synchronization is terminated');
+            throw new Error("tree synchronization is terminated");
         const request = constructTreeLoadingRequest(this.state, this.pruning);
-        const data = await this.pl.withReadTx('ReadingTree', async (tx) => {
+        const data = await this.pl.withReadTx("ReadingTree", async (tx) => {
             return await loadTreeState(tx, request, stats);
         }, txOps);
         this.state.updateFromResourceData(data, true);
@@ -105,7 +105,7 @@ class SynchronizedTreeState {
             }
             try {
                 // resetting stats if we were asked to collect non-cumulative stats
-                if (this.logStat === 'per-request')
+                if (this.logStat === "per-request")
                     stat = initialTreeLoadingStat();
                 // actual tree synchronization
                 await this.refresh(stat);
@@ -132,7 +132,7 @@ class SynchronizedTreeState {
                     // important error logging, this should never happen
                     this.logger?.error(e);
                     // marking everybody who used previous state as changed
-                    this.state.invalidateTree('stat update error');
+                    this.state.invalidateTree("stat update error");
                     // creating new tree
                     this.state = new PlTreeState(this.root, this.finalPredicate);
                     // scheduling state update without delay
@@ -154,7 +154,7 @@ class SynchronizedTreeState {
                 }
                 catch (e) {
                     if (!isTimeoutOrCancelError(e))
-                        throw new Error('Unexpected error', { cause: e });
+                        throw new Error("Unexpected error", { cause: e });
                     break;
                 }
                 finally {
@@ -183,7 +183,7 @@ class SynchronizedTreeState {
         if (this.currentLoop === undefined)
             return;
         await this.currentLoop;
-        this.state.invalidateTree('synchronization terminated for the tree');
+        this.state.invalidateTree("synchronization terminated for the tree");
     }
     /** @deprecated */
     async awaitSyncLoopTermination() {
@@ -204,7 +204,7 @@ class SynchronizedTreeState {
         finally {
             // logging stats if we were asked to (even if error occured)
             if (stat && logger)
-                logger.info(`Tree stat (initial load, ${ok ? 'success' : 'failure'}): ${JSON.stringify(stat)}`);
+                logger.info(`Tree stat (initial load, ${ok ? "success" : "failure"}): ${JSON.stringify(stat)}`);
         }
         return tree;
     }

package/dist/synchronized_tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"synchronized_tree.js","sources":["../src/synchronized_tree.ts"],"sourcesContent":["import { PollingComputableHooks } from '@milaboratories/computable';\nimport { PlTreeEntry } from './accessors';\nimport type {\n  FinalResourceDataPredicate,\n  PlClient,\n  ResourceId,\n  TxOps,\n} from '@milaboratories/pl-client';\nimport {\n  isTimeoutOrCancelError,\n} from '@milaboratories/pl-client';\nimport type { ExtendedResourceData } from './state';\nimport { PlTreeState, TreeStateUpdateError } from './state';\nimport type {\n  PruningFunction,\n  TreeLoadingStat,\n} from './sync';\nimport {\n  constructTreeLoadingRequest,\n  initialTreeLoadingStat,\n  loadTreeState,\n} from './sync';\nimport * as tp from 'node:timers/promises';\nimport type { MiLogger } from '@milaboratories/ts-helpers';\n\ntype StatLoggingMode = 'cumulative' | 'per-request';\n\nexport type SynchronizedTreeOps = {\n  /** Override final predicate from the PlClient */\n  finalPredicateOverride?: FinalResourceDataPredicate;\n\n  /** Pruning function to limit set of fields through which tree will\n   * traverse during state synchronization */\n  pruning?: PruningFunction;\n\n  /** Interval after last sync to sleep before the next one */\n  pollingInterval: number;\n  /** For how long to continue polling after the last derived value access */\n  stopPollingDelay: number;\n\n  /** If one of the values, tree will log stats of each polling request */\n  logStat?: StatLoggingMode;\n\n  /** Timeout for initial tree loading. If not specified, will use default for RO tx from pl-client. */\n  initialTreeLoadingTimeout?: number;\n};\n\ntype ScheduledRefresh = {\n  resolve: () => void;\n  reject: (err: any) => void;\n};\n\nexport class SynchronizedTreeState {\n  private readonly finalPredicate: FinalResourceDataPredicate;\n  private state: PlTreeState;\n  private readonly pollingInterval: number;\n  private readonly pruning?: PruningFunction;\n  private readonly logStat?: StatLoggingMode;\n  private readonly hooks: PollingComputableHooks;\n  private readonly abortController = new AbortController();\n\n  private constructor(\n    private readonly pl: PlClient,\n    private readonly root: ResourceId,\n    ops: SynchronizedTreeOps,\n    private readonly logger?: MiLogger,\n  ) {\n    const { finalPredicateOverride, pruning, pollingInterval, stopPollingDelay, logStat } = ops;\n    this.pruning = pruning;\n    this.pollingInterval = pollingInterval;\n    this.finalPredicate = finalPredicateOverride ?? pl.finalPredicate;\n    this.logStat = logStat;\n    this.state = new PlTreeState(root, this.finalPredicate);\n    this.hooks = new PollingComputableHooks(\n      () => this.startUpdating(),\n      () => this.stopUpdating(),\n      { stopDebounce: stopPollingDelay },\n      (resolve, reject) => this.scheduleOnNextState(resolve, reject),\n    );\n  }\n\n  /** @deprecated use \"entry\" instead */\n  public accessor(rid: ResourceId = this.root): PlTreeEntry {\n    if (this.terminated) throw new Error('tree synchronization is terminated');\n    return this.entry(rid);\n  }\n\n  public entry(rid: ResourceId = this.root): PlTreeEntry {\n    if (this.terminated) throw new Error('tree synchronization is terminated');\n    return new PlTreeEntry({ treeProvider: () => this.state, hooks: this.hooks }, rid);\n  }\n\n  /** Can be used to externally kick off the synchronization polling loop, and\n   * await for the first synchronization to happen. */\n  public async refreshState(): Promise<void> {\n    if (this.terminated) throw new Error('tree synchronization is terminated');\n    await this.hooks.refreshState();\n  }\n\n  private currentLoopDelayInterrupt: AbortController | undefined = undefined;\n  private scheduledOnNextState: ScheduledRefresh[] = [];\n\n  /** Called from computable hooks when external observer asks for state refresh */\n  private scheduleOnNextState(resolve: () => void, reject: (err: any) => void): void {\n    if (this.terminated) reject(new Error('tree synchronization is terminated'));\n    else {\n      this.scheduledOnNextState.push({ resolve, reject });\n      if (this.currentLoopDelayInterrupt) {\n        this.currentLoopDelayInterrupt.abort();\n        this.currentLoopDelayInterrupt = undefined;\n      }\n    }\n  }\n\n  /** Called from observer */\n  private startUpdating(): void {\n    if (this.terminated) return;\n    this.keepRunning = true;\n    if (this.currentLoop === undefined) this.currentLoop = this.mainLoop();\n  }\n\n  /** Called from observer */\n  private stopUpdating(): void {\n    this.keepRunning = false;\n  }\n\n  /** If true, main loop will continue polling pl state. */\n  private keepRunning = false;\n  /** Actual state of main loop. */\n  private currentLoop: Promise<void> | undefined = undefined;\n\n  /** Executed from the main loop, and initialization procedure. */\n  private async refresh(stats?: TreeLoadingStat, txOps?: TxOps): Promise<void> {\n    if (this.terminated) throw new Error('tree synchronization is terminated');\n    const request = constructTreeLoadingRequest(this.state, this.pruning);\n    const data = await this.pl.withReadTx('ReadingTree', async (tx) => {\n      return await loadTreeState(tx, request, stats);\n    }, txOps);\n    this.state.updateFromResourceData(data, true);\n  }\n\n  /** If true this tree state is permanently terminaed. */\n  private terminated = false;\n\n  private async mainLoop() {\n    // will hold request stats\n    let stat = this.logStat ? initialTreeLoadingStat() : undefined;\n\n    let lastUpdate = Date.now();\n\n    while (true) {\n      if (!this.keepRunning || this.terminated) break;\n\n      // saving those who want to be notified about new state here\n      // because those who will be added during the tree retrieval\n      // should be notified only on the next round\n      let toNotify: ScheduledRefresh[] | undefined = undefined;\n      if (this.scheduledOnNextState.length > 0) {\n        toNotify = this.scheduledOnNextState;\n        this.scheduledOnNextState = [];\n      }\n\n      try {\n        // resetting stats if we were asked to collect non-cumulative stats\n        if (this.logStat === 'per-request') stat = initialTreeLoadingStat();\n\n        // actual tree synchronization\n        await this.refresh(stat);\n\n        // logging stats if we were asked to\n        if (stat && this.logger) this.logger.info(`Tree stat (success, after ${Date.now() - lastUpdate}ms): ${JSON.stringify(stat)}`);\n        lastUpdate = Date.now();\n\n        // notifying that we got new state\n        if (toNotify !== undefined) for (const n of toNotify) n.resolve();\n      } catch (e: any) {\n        // logging stats if we were asked to (even if error occured)\n        if (stat && this.logger) this.logger.info(`Tree stat (error, after ${Date.now() - lastUpdate}ms): ${JSON.stringify(stat)}`);\n        lastUpdate = Date.now();\n\n        // notifying that we failed to refresh the state\n        if (toNotify !== undefined) for (const n of toNotify) n.reject(e);\n\n        // catching tree update errors, as they may leave our tree in inconsistent state\n        if (e instanceof TreeStateUpdateError) {\n          // important error logging, this should never happen\n          this.logger?.error(e);\n\n          // marking everybody who used previous state as changed\n          this.state.invalidateTree('stat update error');\n          // creating new tree\n          this.state = new PlTreeState(this.root, this.finalPredicate);\n\n          // scheduling state update without delay\n          continue;\n\n          // unfortunately external observer may still see tree in its default\n          // empty state, though this is best we can do in this exceptional\n          // situation, and hope on caching layers inside computables to present\n          // some stale state until we reconstruct the tree again\n        } else this.logger?.warn(e);\n      }\n\n      if (!this.keepRunning || this.terminated) break;\n\n      if (this.scheduledOnNextState.length === 0) {\n        try {\n          this.currentLoopDelayInterrupt = new AbortController();\n          await tp.setTimeout(this.pollingInterval,\n            AbortSignal.any([this.abortController.signal, this.currentLoopDelayInterrupt.signal]));\n        } catch (e: unknown) {\n          if (!isTimeoutOrCancelError(e)) throw new Error('Unexpected error', { cause: e });\n          break;\n        } finally {\n          this.currentLoopDelayInterrupt = undefined;\n        }\n      }\n    }\n\n    // reset only as a very last line\n    this.currentLoop = undefined;\n  }\n\n  /**\n   * Dumps the current state of the tree.\n   * @returns An array of ExtendedResourceData objects representing the current state of the tree.\n   */\n  public dumpState(): ExtendedResourceData[] {\n    return this.state.dumpState();\n  }\n\n  /**\n   * Terminates the internal loop, and permanently destoys all internal state, so\n   * all computables using this state will resolve to errors.\n   * */\n  public async terminate(): Promise<void> {\n    this.keepRunning = false;\n    this.terminated = true;\n    this.abortController.abort();\n\n    if (this.currentLoop === undefined) return;\n    await this.currentLoop;\n\n    this.state.invalidateTree('synchronization terminated for the tree');\n  }\n\n  /** @deprecated */\n  public async awaitSyncLoopTermination(): Promise<void> {\n    if (this.currentLoop === undefined) return;\n    await this.currentLoop;\n  }\n\n  public static async init(\n    pl: PlClient,\n    root: ResourceId,\n    ops: SynchronizedTreeOps,\n    logger?: MiLogger,\n  ) {\n    const tree = new SynchronizedTreeState(pl, root, ops, logger);\n\n    const stat = ops.logStat ? initialTreeLoadingStat() : undefined;\n\n    let ok = false;\n\n    try {\n      await tree.refresh(stat, {\n        timeout: ops.initialTreeLoadingTimeout,\n      });\n      ok = true;\n    } finally {\n      // logging stats if we were asked to (even if error occured)\n      if (stat && logger)\n        logger.info(\n          `Tree stat (initial load, ${ok ? 'success' : 'failure'}): ${JSON.stringify(stat)}`,\n        );\n    }\n\n    return tree;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"synchronized_tree.js","sources":["../src/synchronized_tree.ts"],"sourcesContent":["import { PollingComputableHooks } from \"@milaboratories/computable\";\nimport { PlTreeEntry } from \"./accessors\";\nimport type {\n  FinalResourceDataPredicate,\n  PlClient,\n  ResourceId,\n  TxOps,\n} from \"@milaboratories/pl-client\";\nimport { isTimeoutOrCancelError } from \"@milaboratories/pl-client\";\nimport type { ExtendedResourceData } from \"./state\";\nimport { PlTreeState, TreeStateUpdateError } from \"./state\";\nimport type { PruningFunction, TreeLoadingStat } from \"./sync\";\nimport { constructTreeLoadingRequest, initialTreeLoadingStat, loadTreeState } from \"./sync\";\nimport * as tp from \"node:timers/promises\";\nimport type { MiLogger } from \"@milaboratories/ts-helpers\";\n\ntype StatLoggingMode = \"cumulative\" | \"per-request\";\n\nexport type SynchronizedTreeOps = {\n  /** Override final predicate from the PlClient */\n  finalPredicateOverride?: FinalResourceDataPredicate;\n\n  /** Pruning function to limit set of fields through which tree will\n   * traverse during state synchronization */\n  pruning?: PruningFunction;\n\n  /** Interval after last sync to sleep before the next one */\n  pollingInterval: number;\n  /** For how long to continue polling after the last derived value access */\n  stopPollingDelay: number;\n\n  /** If one of the values, tree will log stats of each polling request */\n  logStat?: StatLoggingMode;\n\n  /** Timeout for initial tree loading. If not specified, will use default for RO tx from pl-client. */\n  initialTreeLoadingTimeout?: number;\n};\n\ntype ScheduledRefresh = {\n  resolve: () => void;\n  reject: (err: any) => void;\n};\n\nexport class SynchronizedTreeState {\n  private readonly finalPredicate: FinalResourceDataPredicate;\n  private state: PlTreeState;\n  private readonly pollingInterval: number;\n  private readonly pruning?: PruningFunction;\n  private readonly logStat?: StatLoggingMode;\n  private readonly hooks: PollingComputableHooks;\n  private readonly abortController = new AbortController();\n\n  private constructor(\n    private readonly pl: PlClient,\n    private readonly root: ResourceId,\n    ops: SynchronizedTreeOps,\n    private readonly logger?: MiLogger,\n  ) {\n    const { finalPredicateOverride, pruning, pollingInterval, stopPollingDelay, logStat } = ops;\n    this.pruning = pruning;\n    this.pollingInterval = pollingInterval;\n    this.finalPredicate = finalPredicateOverride ?? pl.finalPredicate;\n    this.logStat = logStat;\n    this.state = new PlTreeState(root, this.finalPredicate);\n    this.hooks = new PollingComputableHooks(\n      () => this.startUpdating(),\n      () => this.stopUpdating(),\n      { stopDebounce: stopPollingDelay },\n      (resolve, reject) => this.scheduleOnNextState(resolve, reject),\n    );\n  }\n\n  /** @deprecated use \"entry\" instead */\n  public accessor(rid: ResourceId = this.root): PlTreeEntry {\n    if (this.terminated) throw new Error(\"tree synchronization is terminated\");\n    return this.entry(rid);\n  }\n\n  public entry(rid: ResourceId = this.root): PlTreeEntry {\n    if (this.terminated) throw new Error(\"tree synchronization is terminated\");\n    return new PlTreeEntry({ treeProvider: () => this.state, hooks: this.hooks }, rid);\n  }\n\n  /** Can be used to externally kick off the synchronization polling loop, and\n   * await for the first synchronization to happen. */\n  public async refreshState(): Promise<void> {\n    if (this.terminated) throw new Error(\"tree synchronization is terminated\");\n    await this.hooks.refreshState();\n  }\n\n  private currentLoopDelayInterrupt: AbortController | undefined = undefined;\n  private scheduledOnNextState: ScheduledRefresh[] = [];\n\n  /** Called from computable hooks when external observer asks for state refresh */\n  private scheduleOnNextState(resolve: () => void, reject: (err: any) => void): void {\n    if (this.terminated) reject(new Error(\"tree synchronization is terminated\"));\n    else {\n      this.scheduledOnNextState.push({ resolve, reject });\n      if (this.currentLoopDelayInterrupt) {\n        this.currentLoopDelayInterrupt.abort();\n        this.currentLoopDelayInterrupt = undefined;\n      }\n    }\n  }\n\n  /** Called from observer */\n  private startUpdating(): void {\n    if (this.terminated) return;\n    this.keepRunning = true;\n    if (this.currentLoop === undefined) this.currentLoop = this.mainLoop();\n  }\n\n  /** Called from observer */\n  private stopUpdating(): void {\n    this.keepRunning = false;\n  }\n\n  /** If true, main loop will continue polling pl state. */\n  private keepRunning = false;\n  /** Actual state of main loop. */\n  private currentLoop: Promise<void> | undefined = undefined;\n\n  /** Executed from the main loop, and initialization procedure. */\n  private async refresh(stats?: TreeLoadingStat, txOps?: TxOps): Promise<void> {\n    if (this.terminated) throw new Error(\"tree synchronization is terminated\");\n    const request = constructTreeLoadingRequest(this.state, this.pruning);\n    const data = await this.pl.withReadTx(\n      \"ReadingTree\",\n      async (tx) => {\n        return await loadTreeState(tx, request, stats);\n      },\n      txOps,\n    );\n    this.state.updateFromResourceData(data, true);\n  }\n\n  /** If true this tree state is permanently terminaed. */\n  private terminated = false;\n\n  private async mainLoop() {\n    // will hold request stats\n    let stat = this.logStat ? initialTreeLoadingStat() : undefined;\n\n    let lastUpdate = Date.now();\n\n    while (true) {\n      if (!this.keepRunning || this.terminated) break;\n\n      // saving those who want to be notified about new state here\n      // because those who will be added during the tree retrieval\n      // should be notified only on the next round\n      let toNotify: ScheduledRefresh[] | undefined = undefined;\n      if (this.scheduledOnNextState.length > 0) {\n        toNotify = this.scheduledOnNextState;\n        this.scheduledOnNextState = [];\n      }\n\n      try {\n        // resetting stats if we were asked to collect non-cumulative stats\n        if (this.logStat === \"per-request\") stat = initialTreeLoadingStat();\n\n        // actual tree synchronization\n        await this.refresh(stat);\n\n        // logging stats if we were asked to\n        if (stat && this.logger)\n          this.logger.info(\n            `Tree stat (success, after ${Date.now() - lastUpdate}ms): ${JSON.stringify(stat)}`,\n          );\n        lastUpdate = Date.now();\n\n        // notifying that we got new state\n        if (toNotify !== undefined) for (const n of toNotify) n.resolve();\n      } catch (e: any) {\n        // logging stats if we were asked to (even if error occured)\n        if (stat && this.logger)\n          this.logger.info(\n            `Tree stat (error, after ${Date.now() - lastUpdate}ms): ${JSON.stringify(stat)}`,\n          );\n        lastUpdate = Date.now();\n\n        // notifying that we failed to refresh the state\n        if (toNotify !== undefined) for (const n of toNotify) n.reject(e);\n\n        // catching tree update errors, as they may leave our tree in inconsistent state\n        if (e instanceof TreeStateUpdateError) {\n          // important error logging, this should never happen\n          this.logger?.error(e);\n\n          // marking everybody who used previous state as changed\n          this.state.invalidateTree(\"stat update error\");\n          // creating new tree\n          this.state = new PlTreeState(this.root, this.finalPredicate);\n\n          // scheduling state update without delay\n          continue;\n\n          // unfortunately external observer may still see tree in its default\n          // empty state, though this is best we can do in this exceptional\n          // situation, and hope on caching layers inside computables to present\n          // some stale state until we reconstruct the tree again\n        } else this.logger?.warn(e);\n      }\n\n      if (!this.keepRunning || this.terminated) break;\n\n      if (this.scheduledOnNextState.length === 0) {\n        try {\n          this.currentLoopDelayInterrupt = new AbortController();\n          await tp.setTimeout(\n            this.pollingInterval,\n            AbortSignal.any([this.abortController.signal, this.currentLoopDelayInterrupt.signal]),\n          );\n        } catch (e: unknown) {\n          if (!isTimeoutOrCancelError(e)) throw new Error(\"Unexpected error\", { cause: e });\n          break;\n        } finally {\n          this.currentLoopDelayInterrupt = undefined;\n        }\n      }\n    }\n\n    // reset only as a very last line\n    this.currentLoop = undefined;\n  }\n\n  /**\n   * Dumps the current state of the tree.\n   * @returns An array of ExtendedResourceData objects representing the current state of the tree.\n   */\n  public dumpState(): ExtendedResourceData[] {\n    return this.state.dumpState();\n  }\n\n  /**\n   * Terminates the internal loop, and permanently destoys all internal state, so\n   * all computables using this state will resolve to errors.\n   * */\n  public async terminate(): Promise<void> {\n    this.keepRunning = false;\n    this.terminated = true;\n    this.abortController.abort();\n\n    if (this.currentLoop === undefined) return;\n    await this.currentLoop;\n\n    this.state.invalidateTree(\"synchronization terminated for the tree\");\n  }\n\n  /** @deprecated */\n  public async awaitSyncLoopTermination(): Promise<void> {\n    if (this.currentLoop === undefined) return;\n    await this.currentLoop;\n  }\n\n  public static async init(\n    pl: PlClient,\n    root: ResourceId,\n    ops: SynchronizedTreeOps,\n    logger?: MiLogger,\n  ) {\n    const tree = new SynchronizedTreeState(pl, root, ops, logger);\n\n    const stat = ops.logStat ? initialTreeLoadingStat() : undefined;\n\n    let ok = false;\n\n    try {\n      await tree.refresh(stat, {\n        timeout: ops.initialTreeLoadingTimeout,\n      });\n      ok = true;\n    } finally {\n      // logging stats if we were asked to (even if error occured)\n      if (stat && logger)\n        logger.info(\n          `Tree stat (initial load, ${ok ? \"success\" : \"failure\"}): ${JSON.stringify(stat)}`,\n        );\n    }\n\n    return tree;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/test_utils.d.ts

@@ -1,5 +1,5 @@
-import type { BasicResourceData, FieldData, FieldType, OptionalResourceId, ResourceId, ResourceType } from '@milaboratories/pl-client';
-import type { ExtendedResourceData } from './state';
+import type { BasicResourceData, FieldData, FieldType, OptionalResourceId, ResourceId, ResourceType } from "@milaboratories/pl-client";
+import type { ExtendedResourceData } from "./state";
 export declare const TestRootType1: ResourceType;
 export declare const TestRootType2: ResourceType;
 export declare const TestStructuralResourceType1: ResourceType;
@@ -7,18 +7,18 @@ export declare const TestStructuralResourceType2: ResourceType;
 export declare const TestValueResourceType1: ResourceType;
 export declare const TestValueResourceType2: ResourceType;
 export declare const TestErrorResourceType1: ResourceType;
-export declare const ResourceReady: Pick<BasicResourceData, 'inputsLocked' | 'outputsLocked' | 'resourceReady' | 'final'>;
-export declare const InitialStructuralResourceState: Omit<ExtendedResourceData, 'id' | 'type' | 'fields'>;
-export declare const InitialValueResourceState: Omit<ExtendedResourceData, 'id' | 'type' | 'data'>;
-export declare const TestStructuralResourceState1: Omit<ExtendedResourceData, 'id' | 'fields'>;
-export declare const TestStructuralResourceState2: Omit<ExtendedResourceData, 'id' | 'fields'>;
-export declare const TestValueResourceState1: Omit<ExtendedResourceData, 'id' | 'data'>;
-export declare const TestValueResourceState2: Omit<ExtendedResourceData, 'id' | 'data'>;
-export declare const TestErrorResourceState2: Omit<ExtendedResourceData, 'id' | 'data'>;
+export declare const ResourceReady: Pick<BasicResourceData, "inputsLocked" | "outputsLocked" | "resourceReady" | "final">;
+export declare const InitialStructuralResourceState: Omit<ExtendedResourceData, "id" | "type" | "fields">;
+export declare const InitialValueResourceState: Omit<ExtendedResourceData, "id" | "type" | "data">;
+export declare const TestStructuralResourceState1: Omit<ExtendedResourceData, "id" | "fields">;
+export declare const TestStructuralResourceState2: Omit<ExtendedResourceData, "id" | "fields">;
+export declare const TestValueResourceState1: Omit<ExtendedResourceData, "id" | "data">;
+export declare const TestValueResourceState2: Omit<ExtendedResourceData, "id" | "data">;
+export declare const TestErrorResourceState2: Omit<ExtendedResourceData, "id" | "data">;
 export declare const TestDynamicRootId1: ResourceId;
-export declare const TestDynamicRootState1: Omit<ExtendedResourceData, 'fields'>;
+export declare const TestDynamicRootState1: Omit<ExtendedResourceData, "fields">;
 export declare const TestDynamicRootId2: ResourceId;
-export declare const TestDynamicRootState2: Omit<ExtendedResourceData, 'fields'>;
+export declare const TestDynamicRootState2: Omit<ExtendedResourceData, "fields">;
 export declare function field(type: FieldType, name: string, value?: OptionalResourceId, error?: OptionalResourceId, valueIsFinal?: boolean): FieldData;
 export declare function dField(name: string, value?: OptionalResourceId, error?: OptionalResourceId): FieldData;
 export declare function iField(name: string, value?: OptionalResourceId, error?: OptionalResourceId): FieldData;

package/dist/test_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test_utils.d.ts","sourceRoot":"","sources":["../src/test_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,YAAY,EACb,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,eAAO,MAAM,aAAa,EAAE,YAG3B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,YAG3B,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,YAGzC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,YAGzC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,YAGpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,YAGpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,YAGpC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,IAAI,CAC9B,iBAAiB,EACjB,cAAc,GAAG,eAAe,GAAG,eAAe,GAAG,OAAO,CAM7D,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAU7F,CAAC;AAEJ,eAAO,MAAM,yBAAyB,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAOxF,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,QAAQ,CAGpF,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,QAAQ,CAGpF,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,CAG7E,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,CAG7E,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,CAG7E,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAe,UAAU,CAAC;AACzD,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAOtE,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAe,UAAU,CAAC;AACzD,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAOtE,CAAC;AAEF,wBAAgB,KAAK,CACnB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,kBAAmC,EAC1C,KAAK,GAAE,kBAAmC,EAC1C,YAAY,GAAE,OAAe,GAC5B,SAAS,CASX;AAED,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,kBAAmC,EAC1C,KAAK,GAAE,kBAAmC,GACzC,SAAS,CAEX;AAED,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,kBAAmC,EAC1C,KAAK,GAAE,kBAAmC,GACzC,SAAS,CAEX"}
+{"version":3,"file":"test_utils.d.ts","sourceRoot":"","sources":["../src/test_utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,eAAO,MAAM,aAAa,EAAE,YAG3B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,YAG3B,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,YAGzC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,YAGzC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,YAGpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,YAGpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,YAGpC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,IAAI,CAC9B,iBAAiB,EACjB,cAAc,GAAG,eAAe,GAAG,eAAe,GAAG,OAAO,CAM7D,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAU7F,CAAC;AAEJ,eAAO,MAAM,yBAAyB,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAOxF,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,QAAQ,CAGpF,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,QAAQ,CAGpF,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,CAG7E,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,CAG7E,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,MAAM,CAG7E,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAe,UAAU,CAAC;AACzD,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAOtE,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAe,UAAU,CAAC;AACzD,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAOtE,CAAC;AAEF,wBAAgB,KAAK,CACnB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,kBAAmC,EAC1C,KAAK,GAAE,kBAAmC,EAC1C,YAAY,GAAE,OAAe,GAC5B,SAAS,CASX;AAED,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,kBAAmC,EAC1C,KAAK,GAAE,kBAAmC,GACzC,SAAS,CAEX;AAED,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,kBAAmC,EAC1C,KAAK,GAAE,kBAAmC,GACzC,SAAS,CAEX"}

package/dist/traversal_ops.d.ts

@@ -1,4 +1,4 @@
-import type { FieldType, ResourceType } from '@milaboratories/pl-client';
+import type { FieldType, ResourceType } from "@milaboratories/pl-client";
 export type CommonTraversalOps = {
     /**
      * Don't terminate chain if current resource or field has an error associated

package/dist/value_or_error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value_or_error.d.ts","sourceRoot":"","sources":["../src/value_or_error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,IACzB;IACA,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,CAAC,CAAC;CACV,GACC;IACA,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,CAAC,CAAC;CACV,CAAC"}
+{"version":3,"file":"value_or_error.d.ts","sourceRoot":"","sources":["../src/value_or_error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,IACzB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,CAAC,CAAC;CACV,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,CAAC,CAAC;CACV,CAAC"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@milaboratories/pl-tree",
-  "version": "1.8.34",
+  "version": "1.8.36",
   "description": "Reactive pl tree state",
-  "engines": {
-    "node": ">=22.19.0"
-  },
-  "types": "./dist/index.d.ts",
+  "files": [
+    "./dist/**/*",
+    "./src/**/*"
+  ],
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -15,37 +16,37 @@
       "import": "./dist/index.js"
     }
   },
-  "files": [
-    "./dist/**/*",
-    "./src/**/*"
-  ],
   "dependencies": {
     "denque": "^2.1.0",
     "utility-types": "^3.11.0",
     "zod": "~3.23.8",
-    "@milaboratories/computable": "2.8.2",
-    "@milaboratories/pl-client": "2.16.26",
-    "@milaboratories/pl-error-like": "1.12.5",
-    "@milaboratories/pl-errors": "1.1.58",
-    "@milaboratories/ts-helpers": "1.7.0"
+    "@milaboratories/computable": "2.8.4",
+    "@milaboratories/pl-error-like": "1.12.7",
+    "@milaboratories/pl-client": "2.16.28",
+    "@milaboratories/ts-helpers": "1.7.2",
+    "@milaboratories/pl-errors": "1.1.60"
   },
   "devDependencies": {
-    "typescript": "~5.6.3",
     "@types/node": "~24.5.2",
     "@vitest/coverage-istanbul": "^4.0.16",
+    "typescript": "~5.6.3",
     "vitest": "^4.0.16",
-    "eslint": "^9.25.1",
-    "@milaboratories/ts-builder": "1.2.4",
-    "@milaboratories/build-configs": "1.4.0",
-    "@milaboratories/eslint-config": "1.0.5",
-    "@milaboratories/ts-configs": "1.2.0"
+    "@milaboratories/ts-builder": "1.2.6",
+    "@milaboratories/ts-configs": "1.2.1",
+    "@milaboratories/build-configs": "1.4.2"
+  },
+  "engines": {
+    "node": ">=22.19.0"
   },
   "scripts": {
-    "type-check": "ts-builder types --target node",
     "build": "ts-builder build --target node",
     "watch": "ts-builder build --target node --watch",
-    "lint": "eslint .",
+    "check": "ts-builder check --target node",
+    "formatter:check": "ts-builder formatter --check",
+    "linter:check": "ts-builder linter --check",
+    "types:check": "ts-builder type-check --target node",
     "test": "vitest run --coverage",
-    "do-pack": "rm -f *.tgz && pnpm pack && mv *.tgz package.tgz"
+    "do-pack": "rm -f *.tgz && pnpm pack && mv *.tgz package.tgz",
+    "fmt": "ts-builder format"
   }
 }

package/src/accessors.ts

@@ -1,32 +1,29 @@
-import type { PlTreeResource, PlTreeState } from './state';
+import type { PlTreeResource, PlTreeState } from "./state";
 import type {
   AccessorProvider,
   ComputableCtx,
   ComputableHooks,
   UsageGuard,
-} from '@milaboratories/computable';
-import type {
-  ResourceId,
-  ResourceType,
-  OptionalResourceId } from '@milaboratories/pl-client';
+} from "@milaboratories/computable";
+import type { ResourceId, ResourceType, OptionalResourceId } from "@milaboratories/pl-client";
 import {
   resourceIdToString,
   resourceTypesEqual,
   resourceTypeToString,
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   NullResourceId,
-} from '@milaboratories/pl-client';
-import type { ValueAndError } from './value_and_error';
-import { mapValueAndError } from './value_and_error';
+} from "@milaboratories/pl-client";
+import type { ValueAndError } from "./value_and_error";
+import { mapValueAndError } from "./value_and_error";
 import type {
   CommonFieldTraverseOps,
   FieldTraversalStep,
   GetFieldStep,
   ResourceTraversalOps,
-} from './traversal_ops';
-import type { ValueOrError } from './value_or_error';
-import { parsePlError } from '@milaboratories/pl-errors';
-import { notEmpty } from '@milaboratories/ts-helpers';
+} from "./traversal_ops";
+import type { ValueOrError } from "./value_or_error";
+import { parsePlError } from "@milaboratories/pl-errors";
+import { notEmpty } from "@milaboratories/ts-helpers";
 /** Error encountered during traversal in field or resource. */
 export class PlError extends Error {
   constructor(message: string) {
@@ -46,31 +43,31 @@ export type TreeAccessorInstanceData = {
 
 export function isPlTreeEntry(obj: unknown): obj is PlTreeEntry {
   return (
-    typeof obj === 'object'
-    && obj !== null
-    && (obj as any)['__pl_tree_type_marker__'] === 'PlTreeEntry'
+    typeof obj === "object" &&
+    obj !== null &&
+    (obj as any)["__pl_tree_type_marker__"] === "PlTreeEntry"
   );
 }
 
 export function isPlTreeEntryAccessor(obj: unknown): obj is PlTreeEntryAccessor {
   return (
-    typeof obj === 'object'
-    && obj !== null
-    && (obj as any)['__pl_tree_type_marker__'] === 'PlTreeEntryAccessor'
+    typeof obj === "object" &&
+    obj !== null &&
+    (obj as any)["__pl_tree_type_marker__"] === "PlTreeEntryAccessor"
   );
 }
 
 export function isPlTreeNodeAccessor(obj: unknown): obj is PlTreeNodeAccessor {
   return (
-    typeof obj === 'object'
-    && obj !== null
-    && (obj as any)['__pl_tree_type_marker__'] === 'PlTreeNodeAccessor'
+    typeof obj === "object" &&
+    obj !== null &&
+    (obj as any)["__pl_tree_type_marker__"] === "PlTreeNodeAccessor"
   );
 }
 
 /** Main entry point for using PlTree in reactive setting */
 export class PlTreeEntry implements AccessorProvider<PlTreeEntryAccessor> {
-  private readonly __pl_tree_type_marker__ = 'PlTreeEntry';
+  private readonly __pl_tree_type_marker__ = "PlTreeEntry";
 
   constructor(
     private readonly accessorData: TreeAccessorData,
@@ -114,8 +111,8 @@ function getResourceFromTree(
   }
 
   if (
-    ops.assertResourceType !== undefined
-    && (Array.isArray(ops.assertResourceType)
+    ops.assertResourceType !== undefined &&
+    (Array.isArray(ops.assertResourceType)
       ? ops.assertResourceType.findIndex((rt) => resourceTypesEqual(rt, acc.resourceType)) === -1
       : !resourceTypesEqual(ops.assertResourceType, acc.resourceType))
   )
@@ -128,7 +125,7 @@ function getResourceFromTree(
 }
 
 export class PlTreeEntryAccessor {
-  private readonly __pl_tree_type_marker__ = 'PlTreeEntryAccessor';
+  private readonly __pl_tree_type_marker__ = "PlTreeEntryAccessor";
 
   constructor(
     private readonly accessorData: TreeAccessorData,
@@ -174,7 +171,7 @@ export function treeEntryToResourceInfo(res: PlTreeEntry | ResourceInfo, ctx: Co
  * Important: never store instances of this class, always get fresh instance from {@link PlTreeState} accessor.
  * */
 export class PlTreeNodeAccessor {
-  private readonly __pl_tree_type_marker__ = 'PlTreeNodeAccessor';
+  private readonly __pl_tree_type_marker__ = "PlTreeNodeAccessor";
 
   constructor(
     private readonly accessorData: TreeAccessorData,
@@ -208,7 +205,7 @@ export class PlTreeNodeAccessor {
 
   public traverse(
     ...steps: [
-      Omit<FieldTraversalStep, 'errorIfFieldNotSet'> & {
+      Omit<FieldTraversalStep, "errorIfFieldNotSet"> & {
         errorIfFieldNotSet: true;
       },
     ]
@@ -220,7 +217,7 @@ export class PlTreeNodeAccessor {
 
   public traverseOrError(
     ...steps: [
-      Omit<FieldTraversalStep, 'errorIfFieldNotSet'> & {
+      Omit<FieldTraversalStep, "errorIfFieldNotSet"> & {
         errorIfFieldNotSet: true;
       },
     ]
@@ -253,8 +250,8 @@ export class PlTreeNodeAccessor {
     let current: PlTreeNodeAccessor = this;
 
     for (const _step of steps) {
-      const step: FieldTraversalStep
-        = typeof _step === 'string'
+      const step: FieldTraversalStep =
+        typeof _step === "string"
           ? {
               ...commonOptions,
               field: _step,
@@ -275,7 +272,9 @@ export class PlTreeNodeAccessor {
           // FIXME: in next tickets we'll allow Errors to be thrown.
           error: parsePlError(
             notEmpty(next.error.getDataAsString()),
-            current.id, current.resourceType, step.field,
+            current.id,
+            current.resourceType,
+            step.field,
           ),
         };
 
@@ -283,10 +282,12 @@ export class PlTreeNodeAccessor {
         if (step.errorIfFieldNotSet)
           return {
             ok: false,
-            error: new Error(`field have no assigned value ${step.field} of ${resourceIdToString(current.id)}`),
+            error: new Error(
+              `field have no assigned value ${step.field} of ${resourceIdToString(current.id)}`,
+            ),
           };
         // existing but unpopulated field is unstable because it must be resolved at some point
-        this.onUnstableLambda('unpopulated_field:' + step.field);
+        this.onUnstableLambda("unpopulated_field:" + step.field);
         return undefined;
       }
 
@@ -301,13 +302,13 @@ export class PlTreeNodeAccessor {
 
   public getField(
     _step:
-      | (Omit<GetFieldStep, 'errorIfFieldNotFound'> & { errorIfFieldNotFound: true })
-      | (Omit<GetFieldStep, 'errorIfFieldNotSet'> & { errorIfFieldNotSet: true })
+      | (Omit<GetFieldStep, "errorIfFieldNotFound"> & { errorIfFieldNotFound: true })
+      | (Omit<GetFieldStep, "errorIfFieldNotSet"> & { errorIfFieldNotSet: true }),
   ): ValueAndError<PlTreeNodeAccessor>;
   public getField(_step: GetFieldStep | string): ValueAndError<PlTreeNodeAccessor> | undefined;
   public getField(_step: GetFieldStep | string): ValueAndError<PlTreeNodeAccessor> | undefined {
     this.instanceData.guard();
-    const step: GetFieldStep = typeof _step === 'string' ? { field: _step } : _step;
+    const step: GetFieldStep = typeof _step === "string" ? { field: _step } : _step;
 
     const ve = this.resource.getField(this.instanceData.ctx.watcher, step, this.onUnstableLambda);
 
@@ -319,21 +320,21 @@ export class PlTreeNodeAccessor {
   public getInputsLocked(): boolean {
     this.instanceData.guard();
     const result = this.resource.getInputsLocked(this.instanceData.ctx.watcher);
-    if (!result) this.instanceData.ctx.markUnstable('inputs_unlocked:' + this.resourceType.name);
+    if (!result) this.instanceData.ctx.markUnstable("inputs_unlocked:" + this.resourceType.name);
     return result;
   }
 
   public getOutputsLocked(): boolean {
     this.instanceData.guard();
     const result = this.resource.getOutputsLocked(this.instanceData.ctx.watcher);
-    if (!result) this.instanceData.ctx.markUnstable('outputs_unlocked:' + this.resourceType.name);
+    if (!result) this.instanceData.ctx.markUnstable("outputs_unlocked:" + this.resourceType.name);
     return result;
   }
 
   public getIsReadyOrError(): boolean {
     this.instanceData.guard();
     const result = this.resource.getIsReadyOrError(this.instanceData.ctx.watcher);
-    if (!result) this.instanceData.ctx.markUnstable('not_ready:' + this.resourceType.name);
+    if (!result) this.instanceData.ctx.markUnstable("not_ready:" + this.resourceType.name);
     return result;
   }
 
@@ -384,7 +385,7 @@ export class PlTreeNodeAccessor {
     this.instanceData.guard();
     const result = this.resource.getKeyValue(this.instanceData.ctx.watcher, key);
     if (result === undefined && unstableIfNotFound)
-      this.instanceData.ctx.markUnstable('key_not_found_b:' + key);
+      this.instanceData.ctx.markUnstable("key_not_found_b:" + key);
     return result;
   }
 
@@ -397,7 +398,7 @@ export class PlTreeNodeAccessor {
     this.instanceData.guard();
     const result = this.resource.getKeyValueString(this.instanceData.ctx.watcher, key);
     if (result === undefined && unstableIfNotFound)
-      this.instanceData.ctx.markUnstable('key_not_found_s:' + key);
+      this.instanceData.ctx.markUnstable("key_not_found_s:" + key);
     return result;
   }
 
@@ -407,7 +408,7 @@ export class PlTreeNodeAccessor {
   ): T | undefined {
     const result = this.resource.getKeyValueAsJson<T>(this.instanceData.ctx.watcher, key);
     if (result === undefined) {
-      if (unstableIfNotFound) this.instanceData.ctx.markUnstable('key_not_found_j:' + key);
+      if (unstableIfNotFound) this.instanceData.ctx.markUnstable("key_not_found_j:" + key);
       return undefined;
     }
     return result;

package/src/dump.ts

@@ -1,4 +1,4 @@
-import type { ExtendedResourceData } from './state';
+import type { ExtendedResourceData } from "./state";
 
 export type ResourceStats = {
   /** Number of resources of this type */

package/src/index.ts

@@ -1,9 +1,9 @@
-export * from './traversal_ops';
-export * from './state';
-export * from './sync';
-export * from './accessors';
-export * from './snapshot';
-export * from './synchronized_tree';
-export * from './value_and_error';
-export * from './value_or_error';
-export * from './dump';
+export * from "./traversal_ops";
+export * from "./state";
+export * from "./sync";
+export * from "./accessors";
+export * from "./snapshot";
+export * from "./synchronized_tree";
+export * from "./value_and_error";
+export * from "./value_or_error";
+export * from "./dump";