@milaboratories/pl-tree 1.8.47 → 1.8.49

package/dist/synchronized_tree.cjs

@@ -1,235 +1,170 @@
-'use strict';
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_accessors = require('./accessors.cjs');
+const require_state = require('./state.cjs');
+const require_sync = require('./sync.cjs');
+let _milaboratories_pl_client = require("@milaboratories/pl-client");
+let _milaboratories_computable = require("@milaboratories/computable");
+let node_timers_promises = require("node:timers/promises");
+node_timers_promises = require_runtime.__toESM(node_timers_promises);
 
-var computable = require('@milaboratories/computable');
-var accessors = require('./accessors.cjs');
-var plClient = require('@milaboratories/pl-client');
-var state = require('./state.cjs');
-var sync = require('./sync.cjs');
-var tp = require('node:timers/promises');
-
-function _interopNamespaceDefault(e) {
-    var n = Object.create(null);
-    if (e) {
-        Object.keys(e).forEach(function (k) {
-            if (k !== 'default') {
-                var d = Object.getOwnPropertyDescriptor(e, k);
-                Object.defineProperty(n, k, d.get ? d : {
-                    enumerable: true,
-                    get: function () { return e[k]; }
-                });
-            }
-        });
-    }
-    n.default = e;
-    return Object.freeze(n);
-}
-
-var tp__namespace = /*#__PURE__*/_interopNamespaceDefault(tp);
-
-class SynchronizedTreeState {
-    pl;
-    root;
-    logger;
-    finalPredicate;
-    state;
-    pollingInterval;
-    pruning;
-    logStat;
-    hooks;
-    abortController = new AbortController();
-    constructor(pl, root, ops, logger) {
-        this.pl = pl;
-        this.root = root;
-        this.logger = logger;
-        const { finalPredicateOverride, pruning, pollingInterval, stopPollingDelay, logStat } = ops;
-        this.pruning = pruning;
-        this.pollingInterval = pollingInterval;
-        this.finalPredicate = finalPredicateOverride ?? pl.finalPredicate;
-        this.logStat = logStat;
-        this.state = new state.PlTreeState(root, this.finalPredicate);
-        this.hooks = new computable.PollingComputableHooks(() => this.startUpdating(), () => this.stopUpdating(), { stopDebounce: stopPollingDelay }, (resolve, reject) => this.scheduleOnNextState(resolve, reject));
-    }
-    /** @deprecated use "entry" instead */
-    accessor(rid = this.root) {
-        if (this.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");
-        return new accessors.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");
-        await this.hooks.refreshState();
-    }
-    currentLoopDelayInterrupt = undefined;
-    scheduledOnNextState = [];
-    /** Called from computable hooks when external observer asks for state refresh */
-    scheduleOnNextState(resolve, reject) {
-        if (this.terminated)
-            reject(new Error("tree synchronization is terminated"));
-        else {
-            this.scheduledOnNextState.push({ resolve, reject });
-            if (this.currentLoopDelayInterrupt) {
-                this.currentLoopDelayInterrupt.abort();
-                this.currentLoopDelayInterrupt = undefined;
-            }
-        }
-    }
-    /** Called from observer */
-    startUpdating() {
-        if (this.terminated)
-            return;
-        this.keepRunning = true;
-        if (this.currentLoop === undefined)
-            this.currentLoop = this.mainLoop();
-    }
-    /** Called from observer */
-    stopUpdating() {
-        this.keepRunning = false;
-    }
-    /** If true, main loop will continue polling pl state. */
-    keepRunning = false;
-    /** Actual state of main loop. */
-    currentLoop = undefined;
-    /** Executed from the main loop, and initialization procedure. */
-    async refresh(stats, txOps) {
-        if (this.terminated)
-            throw new Error("tree synchronization is terminated");
-        const request = sync.constructTreeLoadingRequest(this.state, this.pruning);
-        const data = await this.pl.withReadTx("ReadingTree", async (tx) => {
-            return await sync.loadTreeState(tx, request, stats);
-        }, txOps);
-        this.state.updateFromResourceData(data, true);
-    }
-    /** If true this tree state is permanently terminaed. */
-    terminated = false;
-    async mainLoop() {
-        // will hold request stats
-        let stat = this.logStat ? sync.initialTreeLoadingStat() : undefined;
-        let lastUpdate = Date.now();
-        while (true) {
-            if (!this.keepRunning || this.terminated)
-                break;
-            // saving those who want to be notified about new state here
-            // because those who will be added during the tree retrieval
-            // should be notified only on the next round
-            let toNotify = undefined;
-            if (this.scheduledOnNextState.length > 0) {
-                toNotify = this.scheduledOnNextState;
-                this.scheduledOnNextState = [];
-            }
-            try {
-                // resetting stats if we were asked to collect non-cumulative stats
-                if (this.logStat === "per-request")
-                    stat = sync.initialTreeLoadingStat();
-                // actual tree synchronization
-                await this.refresh(stat);
-                // logging stats if we were asked to
-                if (stat && this.logger)
-                    this.logger.info(`Tree stat (success, after ${Date.now() - lastUpdate}ms): ${JSON.stringify(stat)}`);
-                lastUpdate = Date.now();
-                // notifying that we got new state
-                if (toNotify !== undefined)
-                    for (const n of toNotify)
-                        n.resolve();
-            }
-            catch (e) {
-                // logging stats if we were asked to (even if error occured)
-                if (stat && this.logger)
-                    this.logger.info(`Tree stat (error, after ${Date.now() - lastUpdate}ms): ${JSON.stringify(stat)}`);
-                lastUpdate = Date.now();
-                // notifying that we failed to refresh the state
-                if (toNotify !== undefined)
-                    for (const n of toNotify)
-                        n.reject(e);
-                // catching tree update errors, as they may leave our tree in inconsistent state
-                if (e instanceof state.TreeStateUpdateError) {
-                    // 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");
-                    // creating new tree
-                    this.state = new state.PlTreeState(this.root, this.finalPredicate);
-                    // scheduling state update without delay
-                    continue;
-                    // unfortunately external observer may still see tree in its default
-                    // empty state, though this is best we can do in this exceptional
-                    // situation, and hope on caching layers inside computables to present
-                    // some stale state until we reconstruct the tree again
-                }
-                else
-                    this.logger?.warn(e);
-            }
-            if (!this.keepRunning || this.terminated)
-                break;
-            if (this.scheduledOnNextState.length === 0) {
-                try {
-                    this.currentLoopDelayInterrupt = new AbortController();
-                    await tp__namespace.setTimeout(this.pollingInterval, AbortSignal.any([this.abortController.signal, this.currentLoopDelayInterrupt.signal]));
-                }
-                catch (e) {
-                    if (!plClient.isTimeoutOrCancelError(e))
-                        throw new Error("Unexpected error", { cause: e });
-                    break;
-                }
-                finally {
-                    this.currentLoopDelayInterrupt = undefined;
-                }
-            }
-        }
-        // reset only as a very last line
-        this.currentLoop = undefined;
-    }
-    /**
-     * Dumps the current state of the tree.
-     * @returns An array of ExtendedResourceData objects representing the current state of the tree.
-     */
-    dumpState() {
-        return this.state.dumpState();
-    }
-    /**
-     * Terminates the internal loop, and permanently destoys all internal state, so
-     * all computables using this state will resolve to errors.
-     * */
-    async terminate() {
-        this.keepRunning = false;
-        this.terminated = true;
-        this.abortController.abort();
-        if (this.currentLoop === undefined)
-            return;
-        await this.currentLoop;
-        this.state.invalidateTree("synchronization terminated for the tree");
-    }
-    /** @deprecated */
-    async awaitSyncLoopTermination() {
-        if (this.currentLoop === undefined)
-            return;
-        await this.currentLoop;
-    }
-    static async init(pl, root, ops, logger) {
-        const tree = new SynchronizedTreeState(pl, root, ops, logger);
-        const stat = ops.logStat ? sync.initialTreeLoadingStat() : undefined;
-        let ok = false;
-        try {
-            await tree.refresh(stat, {
-                timeout: ops.initialTreeLoadingTimeout,
-            });
-            ok = true;
-        }
-        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)}`);
-        }
-        return tree;
-    }
-}
+//#region src/synchronized_tree.ts
+var SynchronizedTreeState = class SynchronizedTreeState {
+	finalPredicate;
+	state;
+	pollingInterval;
+	pruning;
+	logStat;
+	hooks;
+	abortController = new AbortController();
+	constructor(pl, root, ops, logger) {
+		this.pl = pl;
+		this.root = root;
+		this.logger = logger;
+		const { finalPredicateOverride, pruning, pollingInterval, stopPollingDelay, logStat } = ops;
+		this.pruning = pruning;
+		this.pollingInterval = pollingInterval;
+		this.finalPredicate = finalPredicateOverride ?? pl.finalPredicate;
+		this.logStat = logStat;
+		this.state = new require_state.PlTreeState(root, this.finalPredicate);
+		this.hooks = new _milaboratories_computable.PollingComputableHooks(() => this.startUpdating(), () => this.stopUpdating(), { stopDebounce: stopPollingDelay }, (resolve, reject) => this.scheduleOnNextState(resolve, reject));
+	}
+	/** @deprecated use "entry" instead */
+	accessor(rid = this.root) {
+		if (this.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");
+		return new require_accessors.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");
+		await this.hooks.refreshState();
+	}
+	currentLoopDelayInterrupt = void 0;
+	scheduledOnNextState = [];
+	/** Called from computable hooks when external observer asks for state refresh */
+	scheduleOnNextState(resolve, reject) {
+		if (this.terminated) reject(/* @__PURE__ */ new Error("tree synchronization is terminated"));
+		else {
+			this.scheduledOnNextState.push({
+				resolve,
+				reject
+			});
+			if (this.currentLoopDelayInterrupt) {
+				this.currentLoopDelayInterrupt.abort();
+				this.currentLoopDelayInterrupt = void 0;
+			}
+		}
+	}
+	/** Called from observer */
+	startUpdating() {
+		if (this.terminated) return;
+		this.keepRunning = true;
+		if (this.currentLoop === void 0) this.currentLoop = this.mainLoop();
+	}
+	/** Called from observer */
+	stopUpdating() {
+		this.keepRunning = false;
+	}
+	/** If true, main loop will continue polling pl state. */
+	keepRunning = false;
+	/** Actual state of main loop. */
+	currentLoop = void 0;
+	/** Executed from the main loop, and initialization procedure. */
+	async refresh(stats, txOps) {
+		if (this.terminated) throw new Error("tree synchronization is terminated");
+		const request = require_sync.constructTreeLoadingRequest(this.state, this.pruning);
+		const data = await this.pl.withReadTx("ReadingTree", async (tx) => {
+			return await require_sync.loadTreeState(tx, request, stats);
+		}, txOps);
+		this.state.updateFromResourceData(data, true);
+	}
+	/** If true this tree state is permanently terminaed. */
+	terminated = false;
+	async mainLoop() {
+		let stat = this.logStat ? require_sync.initialTreeLoadingStat() : void 0;
+		let lastUpdate = Date.now();
+		while (true) {
+			if (!this.keepRunning || this.terminated) break;
+			let toNotify = void 0;
+			if (this.scheduledOnNextState.length > 0) {
+				toNotify = this.scheduledOnNextState;
+				this.scheduledOnNextState = [];
+			}
+			try {
+				if (this.logStat === "per-request") stat = require_sync.initialTreeLoadingStat();
+				await this.refresh(stat);
+				if (stat && this.logger) this.logger.info(`Tree stat (success, after ${Date.now() - lastUpdate}ms): ${JSON.stringify(stat)}`);
+				lastUpdate = Date.now();
+				if (toNotify !== void 0) for (const n of toNotify) n.resolve();
+			} catch (e) {
+				if (stat && this.logger) this.logger.info(`Tree stat (error, after ${Date.now() - lastUpdate}ms): ${JSON.stringify(stat)}`);
+				lastUpdate = Date.now();
+				if (toNotify !== void 0) for (const n of toNotify) n.reject(e);
+				if (e instanceof require_state.TreeStateUpdateError) {
+					this.logger?.error(e);
+					this.state.invalidateTree("stat update error");
+					this.state = new require_state.PlTreeState(this.root, this.finalPredicate);
+					continue;
+				} else this.logger?.warn(e);
+			}
+			if (!this.keepRunning || this.terminated) break;
+			if (this.scheduledOnNextState.length === 0) try {
+				this.currentLoopDelayInterrupt = new AbortController();
+				await node_timers_promises.setTimeout(this.pollingInterval, void 0, { signal: AbortSignal.any([this.abortController.signal, this.currentLoopDelayInterrupt.signal]) });
+			} catch (e) {
+				if (!(0, _milaboratories_pl_client.isTimeoutOrCancelError)(e)) throw new Error("Unexpected error", { cause: e });
+				if (this.abortController.signal.aborted) break;
+			} finally {
+				this.currentLoopDelayInterrupt = void 0;
+			}
+		}
+		this.currentLoop = void 0;
+	}
+	/**
+	* Dumps the current state of the tree.
+	* @returns An array of ExtendedResourceData objects representing the current state of the tree.
+	*/
+	dumpState() {
+		return this.state.dumpState();
+	}
+	/**
+	* Terminates the internal loop, and permanently destoys all internal state, so
+	* all computables using this state will resolve to errors.
+	* */
+	async terminate() {
+		this.keepRunning = false;
+		this.terminated = true;
+		this.abortController.abort();
+		if (this.currentLoop === void 0) return;
+		await this.currentLoop;
+		this.state.invalidateTree("synchronization terminated for the tree");
+	}
+	/** @deprecated */
+	async awaitSyncLoopTermination() {
+		if (this.currentLoop === void 0) return;
+		await this.currentLoop;
+	}
+	static async init(pl, root, ops, logger) {
+		const tree = new SynchronizedTreeState(pl, root, ops, logger);
+		const stat = ops.logStat ? require_sync.initialTreeLoadingStat() : void 0;
+		let ok = false;
+		try {
+			await tree.refresh(stat, { timeout: ops.initialTreeLoadingTimeout });
+			ok = true;
+		} finally {
+			if (stat && logger) logger.info(`Tree stat (initial load, ${ok ? "success" : "failure"}): ${JSON.stringify(stat)}`);
+		}
+		return tree;
+	}
+};
 
+//#endregion
 exports.SynchronizedTreeState = SynchronizedTreeState;
-//# sourceMappingURL=synchronized_tree.cjs.map
+//# sourceMappingURL=synchronized_tree.cjs.map

package/dist/synchronized_tree.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"synchronized_tree.cjs","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":["PlTreeState","PollingComputableHooks","PlTreeEntry","constructTreeLoadingRequest","loadTreeState","initialTreeLoadingStat","TreeStateUpdateError","tp","isTimeoutOrCancelError"],"mappings":"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"}
+{"version":3,"file":"synchronized_tree.cjs","names":["PlTreeState","PollingComputableHooks","PlTreeEntry","constructTreeLoadingRequest","loadTreeState","initialTreeLoadingStat","TreeStateUpdateError","tp"],"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(this.pollingInterval, undefined, {\n            signal: AbortSignal.any([\n              this.abortController.signal,\n              this.currentLoopDelayInterrupt.signal,\n            ]),\n          });\n        } catch (e: unknown) {\n          if (!isTimeoutOrCancelError(e)) throw new Error(\"Unexpected error\", { cause: e });\n          // If the main abort controller fired, this is a permanent termination\n          if (this.abortController.signal.aborted) break;\n          // Otherwise it was just the loop delay interrupt (scheduleOnNextState),\n          // continue to the next iteration\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"],"mappings":"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"}

package/dist/synchronized_tree.d.ts

@@ -1,72 +1,70 @@
-import { PlTreeEntry } from "./accessors";
-import type { FinalResourceDataPredicate, PlClient, ResourceId } from "@milaboratories/pl-client";
-import type { ExtendedResourceData } from "./state";
-import type { PruningFunction } from "./sync";
-import type { MiLogger } from "@milaboratories/ts-helpers";
+import { PlTreeEntry } from "./accessors.js";
+import { ExtendedResourceData } from "./state.js";
+import { PruningFunction } from "./sync.js";
+import { FinalResourceDataPredicate, PlClient, ResourceId } from "@milaboratories/pl-client";
+import { MiLogger } from "@milaboratories/ts-helpers";
+
+//#region src/synchronized_tree.d.ts
 type StatLoggingMode = "cumulative" | "per-request";
-export type SynchronizedTreeOps = {
-    /** Override final predicate from the PlClient */
-    finalPredicateOverride?: FinalResourceDataPredicate;
-    /** Pruning function to limit set of fields through which tree will
-     * traverse during state synchronization */
-    pruning?: PruningFunction;
-    /** Interval after last sync to sleep before the next one */
-    pollingInterval: number;
-    /** For how long to continue polling after the last derived value access */
-    stopPollingDelay: number;
-    /** If one of the values, tree will log stats of each polling request */
-    logStat?: StatLoggingMode;
-    /** Timeout for initial tree loading. If not specified, will use default for RO tx from pl-client. */
-    initialTreeLoadingTimeout?: number;
+type SynchronizedTreeOps = {
+  /** Override final predicate from the PlClient */finalPredicateOverride?: FinalResourceDataPredicate;
+  /** Pruning function to limit set of fields through which tree will
+   * traverse during state synchronization */
+  pruning?: PruningFunction; /** Interval after last sync to sleep before the next one */
+  pollingInterval: number; /** For how long to continue polling after the last derived value access */
+  stopPollingDelay: number; /** If one of the values, tree will log stats of each polling request */
+  logStat?: StatLoggingMode; /** Timeout for initial tree loading. If not specified, will use default for RO tx from pl-client. */
+  initialTreeLoadingTimeout?: number;
 };
-export declare class SynchronizedTreeState {
-    private readonly pl;
-    private readonly root;
-    private readonly logger?;
-    private readonly finalPredicate;
-    private state;
-    private readonly pollingInterval;
-    private readonly pruning?;
-    private readonly logStat?;
-    private readonly hooks;
-    private readonly abortController;
-    private constructor();
-    /** @deprecated use "entry" instead */
-    accessor(rid?: ResourceId): PlTreeEntry;
-    entry(rid?: ResourceId): PlTreeEntry;
-    /** Can be used to externally kick off the synchronization polling loop, and
-     * await for the first synchronization to happen. */
-    refreshState(): Promise<void>;
-    private currentLoopDelayInterrupt;
-    private scheduledOnNextState;
-    /** Called from computable hooks when external observer asks for state refresh */
-    private scheduleOnNextState;
-    /** Called from observer */
-    private startUpdating;
-    /** Called from observer */
-    private stopUpdating;
-    /** If true, main loop will continue polling pl state. */
-    private keepRunning;
-    /** Actual state of main loop. */
-    private currentLoop;
-    /** Executed from the main loop, and initialization procedure. */
-    private refresh;
-    /** If true this tree state is permanently terminaed. */
-    private terminated;
-    private mainLoop;
-    /**
-     * Dumps the current state of the tree.
-     * @returns An array of ExtendedResourceData objects representing the current state of the tree.
-     */
-    dumpState(): ExtendedResourceData[];
-    /**
-     * Terminates the internal loop, and permanently destoys all internal state, so
-     * all computables using this state will resolve to errors.
-     * */
-    terminate(): Promise<void>;
-    /** @deprecated */
-    awaitSyncLoopTermination(): Promise<void>;
-    static init(pl: PlClient, root: ResourceId, ops: SynchronizedTreeOps, logger?: MiLogger): Promise<SynchronizedTreeState>;
+declare class SynchronizedTreeState {
+  private readonly pl;
+  private readonly root;
+  private readonly logger?;
+  private readonly finalPredicate;
+  private state;
+  private readonly pollingInterval;
+  private readonly pruning?;
+  private readonly logStat?;
+  private readonly hooks;
+  private readonly abortController;
+  private constructor();
+  /** @deprecated use "entry" instead */
+  accessor(rid?: ResourceId): PlTreeEntry;
+  entry(rid?: ResourceId): PlTreeEntry;
+  /** Can be used to externally kick off the synchronization polling loop, and
+   * await for the first synchronization to happen. */
+  refreshState(): Promise<void>;
+  private currentLoopDelayInterrupt;
+  private scheduledOnNextState;
+  /** Called from computable hooks when external observer asks for state refresh */
+  private scheduleOnNextState;
+  /** Called from observer */
+  private startUpdating;
+  /** Called from observer */
+  private stopUpdating;
+  /** If true, main loop will continue polling pl state. */
+  private keepRunning;
+  /** Actual state of main loop. */
+  private currentLoop;
+  /** Executed from the main loop, and initialization procedure. */
+  private refresh;
+  /** If true this tree state is permanently terminaed. */
+  private terminated;
+  private mainLoop;
+  /**
+   * Dumps the current state of the tree.
+   * @returns An array of ExtendedResourceData objects representing the current state of the tree.
+   */
+  dumpState(): ExtendedResourceData[];
+  /**
+   * Terminates the internal loop, and permanently destoys all internal state, so
+   * all computables using this state will resolve to errors.
+   * */
+  terminate(): Promise<void>;
+  /** @deprecated */
+  awaitSyncLoopTermination(): Promise<void>;
+  static init(pl: PlClient, root: ResourceId, ops: SynchronizedTreeOps, logger?: MiLogger): Promise<SynchronizedTreeState>;
 }
-export {};
+//#endregion
+export { SynchronizedTreeOps, SynchronizedTreeState };
 //# sourceMappingURL=synchronized_tree.d.ts.map