@milaboratories/pl-tree 1.4.34 → 1.5.1

package/dist/index.mjs

@@ -1,30 +1,30 @@
-var M = Object.defineProperty;
-var U = (n, e, t) => e in n ? M(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
-var d = (n, e, t) => U(n, typeof e != "symbol" ? e + "" : e, t);
-import { resourceIdToString as S, resourceTypesEqual as A, resourceTypeToString as J, isNotNullResourceId as g, NullResourceId as D, isNullResourceId as V, stringifyWithResourceId as T, isTimeoutOrCancelError as q } from "@milaboratories/pl-client";
-import { ChangeSource as m, PollingComputableHooks as B } from "@milaboratories/computable";
-import { parsePlError as P } from "@milaboratories/pl-errors";
+var W = Object.defineProperty;
+var M = (o, e, t) => e in o ? W(o, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[e] = t;
+var d = (o, e, t) => M(o, typeof e != "symbol" ? e + "" : e, t);
+import { resourceIdToString as R, resourceTypesEqual as A, resourceTypeToString as U, isNotNullResourceId as g, NullResourceId as T, isNullResourceId as b, stringifyWithResourceId as D, isTimeoutOrCancelError as J } from "@milaboratories/pl-client";
+import { ChangeSource as m, PollingComputableHooks as q } from "@milaboratories/computable";
+import { parsePlError as V } from "@milaboratories/pl-errors";
 import { notEmpty as p, msToHumanReadable as z } from "@milaboratories/ts-helpers";
 import H from "denque";
 import * as j from "node:timers/promises";
-function ae(n, e) {
-  if (n !== void 0)
-    return b(n, e);
+function ae(o, e) {
+  if (o !== void 0)
+    return P(o, e);
 }
-function b(n, e) {
+function P(o, e) {
   const t = {};
-  return n.value !== void 0 && (t.value = e(n.value)), n.error !== void 0 && (t.error = e(n.error)), t;
+  return o.value !== void 0 && (t.value = e(o.value)), o.error !== void 0 && (t.error = e(o.error)), t;
 }
-function ne(n) {
-  return typeof n == "object" && n !== null && n.__pl_tree_type_marker__ === "PlTreeEntry";
+function ne(o) {
+  return typeof o == "object" && o !== null && o.__pl_tree_type_marker__ === "PlTreeEntry";
 }
-function oe(n) {
-  return typeof n == "object" && n !== null && n.__pl_tree_type_marker__ === "PlTreeEntryAccessor";
+function oe(o) {
+  return typeof o == "object" && o !== null && o.__pl_tree_type_marker__ === "PlTreeEntryAccessor";
 }
-function ue(n) {
-  return typeof n == "object" && n !== null && n.__pl_tree_type_marker__ === "PlTreeNodeAccessor";
+function ue(o) {
+  return typeof o == "object" && o !== null && o.__pl_tree_type_marker__ === "PlTreeNodeAccessor";
 }
-class R {
+class C {
   constructor(e, t) {
     d(this, "__pl_tree_type_marker__", "PlTreeEntry");
     this.accessorData = e, this.rid = t;
@@ -39,46 +39,46 @@ class R {
     return this.toString();
   }
   toString() {
-    return `[ENTRY:${S(this.rid)}]`;
+    return `[ENTRY:${R(this.rid)}]`;
   }
 }
-function N(n, e, t, i, s) {
-  const o = new Y(
-    n,
+function N(o, e, t, r, s) {
+  const n = new Y(
+    o,
     e,
-    e.get(t.ctx.watcher, i),
+    e.get(t.ctx.watcher, r),
     t
   );
   if (!s.ignoreError) {
-    const a = o.getError();
+    const a = n.getError();
     if (a !== void 0)
-      throw P(p(a.getDataAsString()), o.id, o.resourceType);
+      throw V(p(a.getDataAsString()), n.id, n.resourceType);
   }
-  if (s.assertResourceType !== void 0 && (Array.isArray(s.assertResourceType) ? s.assertResourceType.findIndex((a) => A(a, o.resourceType)) === -1 : !A(s.assertResourceType, o.resourceType)))
+  if (s.assertResourceType !== void 0 && (Array.isArray(s.assertResourceType) ? s.assertResourceType.findIndex((a) => A(a, n.resourceType)) === -1 : !A(s.assertResourceType, n.resourceType)))
     throw new Error(
-      `wrong resource type ${J(o.resourceType)} but expected ${s.assertResourceType}`
+      `wrong resource type ${U(n.resourceType)} but expected ${s.assertResourceType}`
     );
-  return o;
+  return n;
 }
 class E {
-  constructor(e, t, i, s) {
+  constructor(e, t, r, s) {
     d(this, "__pl_tree_type_marker__", "PlTreeEntryAccessor");
-    this.accessorData = e, this.tree = t, this.rid = i, this.instanceData = s;
+    this.accessorData = e, this.tree = t, this.rid = r, this.instanceData = s;
   }
   node(e = {}) {
     return this.instanceData.guard(), this.accessorData.hooks !== void 0 && this.instanceData.ctx.attacheHooks(this.accessorData.hooks), N(this.accessorData, this.tree, this.instanceData, this.rid, e);
   }
 }
-function de(n, e) {
-  return n instanceof R ? e.accessor(n).node().resourceInfo : n;
+function de(o, e) {
+  return o instanceof C ? e.accessor(o).node().resourceInfo : o;
 }
 class Y {
-  constructor(e, t, i, s) {
+  constructor(e, t, r, s) {
     d(this, "__pl_tree_type_marker__", "PlTreeNodeAccessor");
     d(this, "onUnstableLambda", (e) => {
       this.instanceData.ctx.markUnstable(e);
     });
-    this.accessorData = e, this.tree = t, this.resource = i, this.instanceData = s;
+    this.accessorData = e, this.tree = t, this.resource = r, this.instanceData = s;
   }
   get id() {
     return this.instanceData.guard(), this.resource.id;
@@ -102,50 +102,50 @@ class Y {
     return this.traverseOrErrorWithCommon({}, ...e);
   }
   traverseWithCommon(e, ...t) {
-    const i = this.traverseOrErrorWithCommon(e, ...t);
-    if (i !== void 0) {
-      if (!i.ok) throw i.error;
-      return i.value;
+    const r = this.traverseOrErrorWithCommon(e, ...t);
+    if (r !== void 0) {
+      if (!r.ok) throw r.error;
+      return r.value;
     }
   }
   traverseOrErrorWithCommon(e, ...t) {
-    let i = this;
+    let r = this;
     for (const s of t) {
-      const o = typeof s == "string" ? {
+      const n = typeof s == "string" ? {
         ...e,
         field: s
-      } : { ...e, ...s }, a = i.getField(s);
-      if (a === void 0 || o.pureFieldErrorToUndefined && a.value === void 0 && a.error !== void 0)
+      } : { ...e, ...s }, a = r.getField(s);
+      if (a === void 0 || n.pureFieldErrorToUndefined && a.value === void 0 && a.error !== void 0)
         return;
-      if ((!o.ignoreError || a.value === void 0) && a.error !== void 0)
+      if ((!n.ignoreError || a.value === void 0) && a.error !== void 0)
         return {
           ok: !1,
           // FIXME: in next tickets we'll allow Errors to be thrown.
-          error: P(
+          error: V(
             p(a.error.getDataAsString()),
-            i.id,
-            i.resourceType,
-            o.field
+            r.id,
+            r.resourceType,
+            n.field
           )
         };
       if (a.value === void 0) {
-        if (o.errorIfFieldNotSet)
+        if (n.errorIfFieldNotSet)
           return {
             ok: !1,
-            error: `field have no assigned value ${o.field} of ${S(i.id)}`
+            error: `field have no assigned value ${n.field} of ${R(r.id)}`
           };
-        this.onUnstableLambda("unpopulated_field:" + o.field);
+        this.onUnstableLambda("unpopulated_field:" + n.field);
         return;
       }
-      i = a.value;
+      r = a.value;
     }
-    return { ok: !0, value: i };
+    return { ok: !0, value: r };
   }
   getField(e) {
     this.instanceData.guard();
-    const t = typeof e == "string" ? { field: e } : e, i = this.resource.getField(this.instanceData.ctx.watcher, t, this.onUnstableLambda);
-    if (i !== void 0)
-      return b(i, (s) => this.getResourceFromTree(s, { ignoreError: !0 }));
+    const t = typeof e == "string" ? { field: e } : e, r = this.resource.getField(this.instanceData.ctx.watcher, t, this.onUnstableLambda);
+    if (r !== void 0)
+      return P(r, (s) => this.getResourceFromTree(s, { ignoreError: !0 }));
   }
   getInputsLocked() {
     this.instanceData.guard();
@@ -191,8 +191,8 @@ class Y {
   }
   getKeyValue(e, t = !1) {
     this.instanceData.guard();
-    const i = this.resource.getKeyValue(this.instanceData.ctx.watcher, e);
-    return i === void 0 && t && this.instanceData.ctx.markUnstable("key_not_found_b:" + e), i;
+    const r = this.resource.getKeyValue(this.instanceData.ctx.watcher, e);
+    return r === void 0 && t && this.instanceData.ctx.markUnstable("key_not_found_b:" + e), r;
   }
   /** @deprecated */
   getKeyValueString(e) {
@@ -200,16 +200,16 @@ class Y {
   }
   getKeyValueAsString(e, t = !1) {
     this.instanceData.guard();
-    const i = this.resource.getKeyValueString(this.instanceData.ctx.watcher, e);
-    return i === void 0 && t && this.instanceData.ctx.markUnstable("key_not_found_s:" + e), i;
+    const r = this.resource.getKeyValueString(this.instanceData.ctx.watcher, e);
+    return r === void 0 && t && this.instanceData.ctx.markUnstable("key_not_found_s:" + e), r;
   }
   getKeyValueAsJson(e, t = !1) {
-    const i = this.resource.getKeyValueString(this.instanceData.ctx.watcher, e);
-    if (i === void 0) {
+    const r = this.resource.getKeyValueString(this.instanceData.ctx.watcher, e);
+    if (r === void 0) {
       t && this.instanceData.ctx.markUnstable("key_not_found_j:" + e);
       return;
     }
-    return JSON.parse(i);
+    return JSON.parse(r);
   }
   /**
    * Can be used to pass a higher level accessor that will wrap the resource and throw its
@@ -220,18 +220,28 @@ class Y {
   }
   /** Can be passed to nested computable. */
   persist() {
-    return new R(this.accessorData, this.resource.id);
+    return new C(this.accessorData, this.resource.id);
   }
 }
-class C extends Error {
+class S extends Error {
   constructor(e) {
     super(e);
   }
 }
 class $ {
-  constructor(e, t, i, s, o, a, r) {
+  constructor(e, t, r, s, n, a, i) {
     d(this, "change", new m());
-    this.name = e, this.type = t, this.value = i, this.error = s, this.status = o, this.valueIsFinal = a, this.resourceVersion = r;
+    this.name = e, this.type = t, this.value = r, this.error = s, this.status = n, this.valueIsFinal = a, this.resourceVersion = i;
+  }
+  get state() {
+    return {
+      name: this.name,
+      type: this.type,
+      status: this.status,
+      value: this.value,
+      error: this.error,
+      valueIsFinal: this.valueIsFinal
+    };
   }
 }
 const L = 0, x = new TextDecoder();
@@ -287,14 +297,14 @@ class G {
   get fields() {
     return [...this.fieldsMap.values()];
   }
-  getField(e, t, i = () => {
+  getField(e, t, r = () => {
   }) {
-    var a, r, f;
-    const s = typeof t == "string" ? { field: t } : t, o = this.fieldsMap.get(s.field);
-    if (o === void 0) {
+    var a, i, f;
+    const s = typeof t == "string" ? { field: t } : t, n = this.fieldsMap.get(s.field);
+    if (n === void 0) {
       if (s.errorIfFieldNotFound || s.errorIfFieldNotSet)
         throw new Error(
-          `Field "${s.field}" not found in resource ${S(this.id)}`
+          `Field "${s.field}" not found in resource ${R(this.id)}`
         );
       if (!this.inputsLocked) (a = this.inputAndServiceFieldListChanged) == null || a.attachWatcher(e);
       else if (s.assertFieldType === "Service" || s.assertFieldType === "Input") {
@@ -302,21 +312,21 @@ class G {
           return;
         throw new Error(`Service or input field not found ${s.field}.`);
       }
-      if (!this.outputsLocked) (r = this.outputFieldListChanged) == null || r.attachWatcher(e);
+      if (!this.outputsLocked) (i = this.outputFieldListChanged) == null || i.attachWatcher(e);
       else if (s.assertFieldType === "Output") {
         if (s.allowPermanentAbsence)
           return;
         throw new Error(`Output field not found ${s.field}.`);
       }
-      (f = this.dynamicFieldListChanged) == null || f.attachWatcher(e), !this._finalState && !s.stableIfNotFound && i("field_not_found:" + s.field);
+      (f = this.dynamicFieldListChanged) == null || f.attachWatcher(e), !this._finalState && !s.stableIfNotFound && r("field_not_found:" + s.field);
       return;
     } else {
-      if (s.assertFieldType !== void 0 && o.type !== s.assertFieldType)
+      if (s.assertFieldType !== void 0 && n.type !== s.assertFieldType)
         throw new Error(
-          `Unexpected field type: expected ${s.assertFieldType} but got ${o.type} for the field name ${s.field}`
+          `Unexpected field type: expected ${s.assertFieldType} but got ${n.type} for the field name ${s.field}`
         );
       const l = {};
-      return g(o.value) && (l.value = o.value), g(o.error) && (l.error = o.error), l.value === void 0 && l.error === void 0 && i("field_not_resolved:" + s.field), o.change.attachWatcher(e), l;
+      return g(n.value) && (l.value = n.value), g(n.error) && (l.error = n.error), l.value === void 0 && l.error === void 0 && r("field_not_resolved:" + s.field), n.change.attachWatcher(e), l;
     }
   }
   getInputsLocked(e) {
@@ -328,7 +338,7 @@ class G {
     return this.outputsLocked || (t = this.resourceStateChange) == null || t.attachWatcher(e), this.outputsLocked;
   }
   get isReadyOrError() {
-    return this.error !== D || this.resourceReady || this.originalResourceId !== D;
+    return this.error !== T || this.resourceReady || this.originalResourceId !== T;
   }
   getIsFinal(e) {
     var t;
@@ -340,41 +350,41 @@ class G {
   }
   getError(e) {
     var t;
-    if (V(this.error)) {
+    if (b(this.error)) {
       (t = this.resourceStateChange) == null || t.attachWatcher(e);
       return;
     } else
       return this.error;
   }
   listInputFields(e) {
-    var i;
+    var r;
     const t = [];
-    return this.fieldsMap.forEach((s, o) => {
-      (s.type === "Input" || s.type === "Service") && t.push(o);
-    }), this.inputsLocked || (i = this.inputAndServiceFieldListChanged) == null || i.attachWatcher(e), t;
+    return this.fieldsMap.forEach((s, n) => {
+      (s.type === "Input" || s.type === "Service") && t.push(n);
+    }), this.inputsLocked || (r = this.inputAndServiceFieldListChanged) == null || r.attachWatcher(e), t;
   }
   listOutputFields(e) {
-    var i;
+    var r;
     const t = [];
-    return this.fieldsMap.forEach((s, o) => {
-      s.type === "Output" && t.push(o);
-    }), this.outputsLocked || (i = this.outputFieldListChanged) == null || i.attachWatcher(e), t;
+    return this.fieldsMap.forEach((s, n) => {
+      s.type === "Output" && t.push(n);
+    }), this.outputsLocked || (r = this.outputFieldListChanged) == null || r.attachWatcher(e), t;
   }
   listDynamicFields(e) {
-    var i;
+    var r;
     const t = [];
-    return this.fieldsMap.forEach((s, o) => {
-      s.type !== "Input" && s.type !== "Output" && t.push(o);
-    }), (i = this.dynamicFieldListChanged) == null || i.attachWatcher(e), t;
+    return this.fieldsMap.forEach((s, n) => {
+      s.type !== "Input" && s.type !== "Output" && t.push(n);
+    }), (r = this.dynamicFieldListChanged) == null || r.attachWatcher(e), t;
   }
   getKeyValue(e, t) {
-    var i;
-    return (i = this.kvChanged) == null || i.attachWatcher(e), this.kv.get(t);
+    var r;
+    return (r = this.kvChanged) == null || r.attachWatcher(e), this.kv.get(t);
   }
   getKeyValueString(e, t) {
-    const i = this.getKeyValue(e, t);
-    if (i !== void 0)
-      return x.decode(i);
+    const r = this.getKeyValue(e, t);
+    if (r !== void 0)
+      return x.decode(r);
   }
   getDataAsString() {
     if (this.data !== void 0)
@@ -386,9 +396,9 @@ class G {
   }
   verifyReadyState() {
     if (this.resourceReady && !this.inputsLocked)
-      throw new Error(`ready without input or output lock: ${T(this.state)}`);
+      throw new Error(`ready without input or output lock: ${D(this.basicState)}`);
   }
-  get state() {
+  get basicState() {
     return {
       id: this.id,
       kind: this.kind,
@@ -402,14 +412,21 @@ class G {
       final: this.finalFlag
     };
   }
+  get extendedState() {
+    return {
+      ...this.basicState,
+      fields: this.fields,
+      kv: Array.from(this.kv.entries()).map(([e, t]) => ({ key: e, value: t }))
+    };
+  }
   /** Called when {@link FinalResourceDataPredicate} returns true for the state. */
   markFinal() {
     this._finalState || (this._finalState = !0, p(this.finalChanged).markChanged(), this.finalChanged = void 0, this.resourceStateChange = void 0, this.dynamicFieldListChanged = void 0, this.inputAndServiceFieldListChanged = void 0, this.outputFieldListChanged = void 0, this.lockedChange = void 0);
   }
   /** Used for invalidation */
   markAllChanged() {
-    var e, t, i, s, o, a, r;
-    this.fieldsMap.forEach((f) => f.change.markChanged()), (e = this.finalChanged) == null || e.markChanged(), (t = this.resourceStateChange) == null || t.markChanged(), (i = this.lockedChange) == null || i.markChanged(), (s = this.inputAndServiceFieldListChanged) == null || s.markChanged(), (o = this.outputFieldListChanged) == null || o.markChanged(), (a = this.dynamicFieldListChanged) == null || a.markChanged(), (r = this.kvChanged) == null || r.markChanged(), this.resourceRemoved.markChanged();
+    var e, t, r, s, n, a, i;
+    this.fieldsMap.forEach((f) => f.change.markChanged()), (e = this.finalChanged) == null || e.markChanged(), (t = this.resourceStateChange) == null || t.markChanged(), (r = this.lockedChange) == null || r.markChanged(), (s = this.inputAndServiceFieldListChanged) == null || s.markChanged(), (n = this.outputFieldListChanged) == null || n.markChanged(), (a = this.dynamicFieldListChanged) == null || a.markChanged(), (i = this.kvChanged) == null || i.markChanged(), this.resourceRemoved.markChanged();
   }
 }
 class O {
@@ -431,70 +448,70 @@ class O {
   }
   get(e, t) {
     this.checkValid();
-    const i = this.resources.get(t);
-    if (i === void 0)
-      throw this.resourcesAdded.attachWatcher(e), new Error(`resource ${S(t)} not found in the tree`);
-    return i.resourceRemoved.attachWatcher(e), i;
+    const r = this.resources.get(t);
+    if (r === void 0)
+      throw this.resourcesAdded.attachWatcher(e), new Error(`resource ${R(t)} not found in the tree`);
+    return r.resourceRemoved.attachWatcher(e), r;
   }
   updateFromResourceData(e, t = !1) {
     this.checkValid();
-    const i = [], s = [];
+    const r = [], s = [];
     for (const a of e) {
-      let r = this.resources.get(a.id);
-      const f = r == null ? void 0 : r.state, l = (h) => {
+      let i = this.resources.get(a.id);
+      const f = i == null ? void 0 : i.basicState, l = (h) => {
         const { fields: k, ...u } = a;
-        throw this.invalidateTree(), new C(
-          `Unexpected resource state transition (${h}): ${T(
+        throw this.invalidateTree(), new S(
+          `Unexpected resource state transition (${h}): ${D(
             u
-          )} -> ${T(f)}`
+          )} -> ${D(f)}`
         );
       };
-      if (r !== void 0) {
-        r.finalState && l("resource state can	 be updated after it is marked as final");
+      if (i !== void 0) {
+        i.finalState && l("resource state can	 be updated after it is marked as final");
         let h = !1;
-        r.version += 1, r.originalResourceId !== a.originalResourceId && (r.originalResourceId !== D && l("originalResourceId can't change after it is set"), r.originalResourceId = a.originalResourceId, p(r.resourceStateChange).markChanged(), h = !0), r.error !== a.error && (g(r.error) && l("resource can't change attached error after it is set"), r.error = a.error, i.push(r.error), p(r.resourceStateChange).markChanged(), h = !0);
+        i.version += 1, i.originalResourceId !== a.originalResourceId && (i.originalResourceId !== T && l("originalResourceId can't change after it is set"), i.originalResourceId = a.originalResourceId, p(i.resourceStateChange).markChanged(), h = !0), i.error !== a.error && (g(i.error) && l("resource can't change attached error after it is set"), i.error = a.error, r.push(i.error), p(i.resourceStateChange).markChanged(), h = !0);
         for (const u of a.fields) {
-          let c = r.fieldsMap.get(u.name);
-          c ? (c.type !== u.type && (c.type !== "Dynamic" && l(`field changed type ${c.type} -> ${u.type}`), p(r.dynamicFieldListChanged).markChanged(), (c.type === "Input" || c.type === "Service") && (r.inputsLocked && l(
+          let c = i.fieldsMap.get(u.name);
+          c ? (c.type !== u.type && (c.type !== "Dynamic" && l(`field changed type ${c.type} -> ${u.type}`), p(i.dynamicFieldListChanged).markChanged(), (c.type === "Input" || c.type === "Service") && (i.inputsLocked && l(
             `adding input field "${u.name}", while corresponding list is locked`
-          ), p(r.inputAndServiceFieldListChanged).markChanged()), c.type === "Output" && (r.outputsLocked && l(
+          ), p(i.inputAndServiceFieldListChanged).markChanged()), c.type === "Output" && (i.outputsLocked && l(
             `adding output field "${u.name}", while corresponding list is locked`
-          ), p(r.outputFieldListChanged).markChanged()), c.type = u.type, c.change.markChanged(), h = !0), c.value !== u.value && (g(c.value) && s.push(c.value), c.value = u.value, g(u.value) && i.push(u.value), c.change.markChanged(), h = !0), c.error !== u.error && (g(c.error) && s.push(c.error), c.error = u.error, g(u.error) && i.push(u.error), c.change.markChanged(), h = !0), c.status !== u.status && (c.status = u.status, c.change.markChanged(), h = !0), c.valueIsFinal !== u.valueIsFinal && (c.valueIsFinal = u.valueIsFinal, c.change.markChanged(), h = !0), c.resourceVersion = r.version) : (c = new $(
+          ), p(i.outputFieldListChanged).markChanged()), c.type = u.type, c.change.markChanged(), h = !0), c.value !== u.value && (g(c.value) && s.push(c.value), c.value = u.value, g(u.value) && r.push(u.value), c.change.markChanged(), h = !0), c.error !== u.error && (g(c.error) && s.push(c.error), c.error = u.error, g(u.error) && r.push(u.error), c.change.markChanged(), h = !0), c.status !== u.status && (c.status = u.status, c.change.markChanged(), h = !0), c.valueIsFinal !== u.valueIsFinal && (c.valueIsFinal = u.valueIsFinal, c.change.markChanged(), h = !0), c.resourceVersion = i.version) : (c = new $(
             u.name,
             u.type,
             u.value,
             u.error,
             u.status,
             u.valueIsFinal,
-            r.version
-          ), g(u.value) && i.push(u.value), g(u.error) && i.push(u.error), u.type === "Input" || u.type === "Service" ? (r.inputsLocked && l(
+            i.version
+          ), g(u.value) && r.push(u.value), g(u.error) && r.push(u.error), u.type === "Input" || u.type === "Service" ? (i.inputsLocked && l(
             `adding ${u.type} (${u.name}) field while inputs locked`
-          ), p(r.inputAndServiceFieldListChanged).markChanged()) : u.type === "Output" ? (r.outputsLocked && l(
+          ), p(i.inputAndServiceFieldListChanged).markChanged()) : u.type === "Output" ? (i.outputsLocked && l(
             `adding ${u.type} (${u.name}) field while outputs locked`
-          ), p(r.outputFieldListChanged).markChanged()) : p(r.dynamicFieldListChanged).markChanged(), r.fieldsMap.set(u.name, c), h = !0);
+          ), p(i.outputFieldListChanged).markChanged()) : p(i.dynamicFieldListChanged).markChanged(), i.fieldsMap.set(u.name, c), h = !0);
         }
-        if (r.fieldsMap.forEach((u, c, v) => {
-          u.resourceVersion !== r.version && ((u.type === "Input" || u.type === "Service" || u.type === "Output") && l(`removal of ${u.type} field ${c}`), u.change.markChanged(), v.delete(c), g(u.value) && s.push(u.value), g(u.error) && s.push(u.error), p(r.dynamicFieldListChanged).markChanged());
-        }), r.inputsLocked !== a.inputsLocked && (r.inputsLocked && l("inputs unlocking is not permitted"), r.inputsLocked = a.inputsLocked, p(r.lockedChange).markChanged(), h = !0), r.outputsLocked !== a.outputsLocked && (r.outputsLocked && l("outputs unlocking is not permitted"), r.outputsLocked = a.outputsLocked, p(r.lockedChange).markChanged(), h = !0), r.resourceReady !== a.resourceReady) {
-          const u = r.resourceReady;
-          r.resourceReady = a.resourceReady, r.verifyReadyState(), r.isReadyOrError || l(
+        if (i.fieldsMap.forEach((u, c, v) => {
+          u.resourceVersion !== i.version && ((u.type === "Input" || u.type === "Service" || u.type === "Output") && l(`removal of ${u.type} field ${c}`), u.change.markChanged(), v.delete(c), g(u.value) && s.push(u.value), g(u.error) && s.push(u.error), p(i.dynamicFieldListChanged).markChanged());
+        }), i.inputsLocked !== a.inputsLocked && (i.inputsLocked && l("inputs unlocking is not permitted"), i.inputsLocked = a.inputsLocked, p(i.lockedChange).markChanged(), h = !0), i.outputsLocked !== a.outputsLocked && (i.outputsLocked && l("outputs unlocking is not permitted"), i.outputsLocked = a.outputsLocked, p(i.lockedChange).markChanged(), h = !0), i.resourceReady !== a.resourceReady) {
+          const u = i.resourceReady;
+          i.resourceReady = a.resourceReady, i.verifyReadyState(), i.isReadyOrError || l(
             `resource can't lose it's ready or error state (ready state before ${u})`
-          ), p(r.resourceStateChange).markChanged(), h = !0;
+          ), p(i.resourceStateChange).markChanged(), h = !0;
         }
         let k = !1;
         for (const u of a.kv) {
-          const c = r.kv.get(u.key);
-          (c === void 0 || Buffer.compare(c, u.value) !== 0) && (r.kv.set(u.key, u.value), k = !0);
+          const c = i.kv.get(u.key);
+          (c === void 0 || Buffer.compare(c, u.value) !== 0) && (i.kv.set(u.key, u.value), k = !0);
         }
-        if (r.kv.size > a.kv.length) {
+        if (i.kv.size > a.kv.length) {
           const u = new Set(a.kv.map((c) => c.key));
-          r.kv.forEach((c, v, y) => {
+          i.kv.forEach((c, v, y) => {
             u.has(v) || y.delete(v);
           }), k = !0;
         }
-        k && p(r.kvChanged).markChanged(), h && (r.dataVersion = r.version, this.isFinalPredicate(r) && r.markFinal());
+        k && p(i.kvChanged).markChanged(), h && (i.dataVersion = i.version, this.isFinalPredicate(i) && i.markFinal());
       } else {
-        r = new G(a), r.verifyReadyState(), g(r.error) && i.push(r.error);
+        i = new G(a), i.verifyReadyState(), g(i.error) && r.push(i.error);
         for (const h of a.fields) {
           const k = new $(
             h.name,
@@ -505,35 +522,35 @@ class O {
             h.valueIsFinal,
             L
           );
-          g(h.value) && i.push(h.value), g(h.error) && i.push(h.error), r.fieldsMap.set(h.name, k);
+          g(h.value) && r.push(h.value), g(h.error) && r.push(h.error), i.fieldsMap.set(h.name, k);
         }
-        for (const h of a.kv) r.kv.set(h.key, h.value);
-        this.isFinalPredicate(r) && r.markFinal(), this.resources.set(r.id, r), this.resourcesAdded.markChanged();
+        for (const h of a.kv) i.kv.set(h.key, h.value);
+        this.isFinalPredicate(i) && i.markFinal(), this.resources.set(i.id, i), this.resourcesAdded.markChanged();
       }
     }
-    for (const a of i) {
-      const r = this.resources.get(a);
-      if (!r)
-        throw this.invalidateTree(), new C(`orphan resource ${a}`);
-      r.refCount++;
+    for (const a of r) {
+      const i = this.resources.get(a);
+      if (!i)
+        throw this.invalidateTree(), new S(`orphan resource ${a}`);
+      i.refCount++;
     }
-    let o = s;
-    for (; o.length > 0; ) {
+    let n = s;
+    for (; n.length > 0; ) {
       const a = [];
-      for (const r of o) {
-        const f = this.resources.get(r);
+      for (const i of n) {
+        const f = this.resources.get(i);
         if (!f)
-          throw this.invalidateTree(), new C(`orphan resource ${r}`);
+          throw this.invalidateTree(), new S(`orphan resource ${i}`);
         f.refCount--, f.refCount === 0 && f.id !== this.root && (f.fieldsMap.forEach((l) => {
           g(l.value) && a.push(l.value), g(l.error) && a.push(l.error), l.change.markChanged();
-        }), g(f.error) && a.push(f.error), f.resourceRemoved.markChanged(), this.resources.delete(r));
+        }), g(f.error) && a.push(f.error), f.resourceRemoved.markChanged(), this.resources.delete(i));
       }
-      o = a;
+      n = a;
     }
     if (!t) {
       for (const a of e)
         if (!this.resources.has(a.id))
-          throw this.invalidateTree(), new C(`orphan input resource ${a.id}`);
+          throw this.invalidateTree(), new S(`orphan input resource ${a.id}`);
     }
   }
   /** @deprecated use "entry" instead */
@@ -541,19 +558,22 @@ class O {
     return this.checkValid(), this.entry(e);
   }
   entry(e = this.root) {
-    return this.checkValid(), new R({ treeProvider: () => this }, e);
+    return this.checkValid(), new C({ treeProvider: () => this }, e);
   }
   invalidateTree(e) {
     this._isValid = !1, this.invalidationMessage = e, this.resources.forEach((t) => {
       t.markAllChanged();
     });
   }
+  dumpState() {
+    return Array.from(this.resources.values()).map((e) => e.extendedState);
+  }
 }
-function Q(n, e) {
-  const t = [], i = /* @__PURE__ */ new Set();
-  return n.forEachResource((s) => {
-    s.finalState ? i.add(s.id) : t.push(s.id);
-  }), t.length === 0 && i.size === 0 && t.push(n.root), { seedResources: t, finalResources: i, pruningFunction: e };
+function Q(o, e) {
+  const t = [], r = /* @__PURE__ */ new Set();
+  return o.forEachResource((s) => {
+    s.finalState ? r.add(s.id) : t.push(s.id);
+  }), t.length === 0 && r.size === 0 && t.push(o.root), { seedResources: t, finalResources: r, pruningFunction: e };
 }
 function F() {
   return {
@@ -569,37 +589,37 @@ function F() {
     millisSpent: 0
   };
 }
-function ce(n) {
-  let e = `Requests: ${n.requests}
+function ce(o) {
+  let e = `Requests: ${o.requests}
 `;
-  return e += `Total time: ${z(n.millisSpent)}
-`, e += `Round-trips: ${n.roundTrips}
-`, e += `Resources: ${n.retrievedResources}
-`, e += `Fields: ${n.retrievedFields}
-`, e += `KV: ${n.retrievedKeyValues}
-`, e += `Data Bytes: ${n.retrievedResourceDataBytes}
-`, e += `KV Bytes: ${n.retrievedKeyValueBytes}
-`, e += `Pruned fields: ${n.prunedFields}
-`, e += `Final resources skipped: ${n.finalResourcesSkipped}`, e;
+  return e += `Total time: ${z(o.millisSpent)}
+`, e += `Round-trips: ${o.roundTrips}
+`, e += `Resources: ${o.retrievedResources}
+`, e += `Fields: ${o.retrievedFields}
+`, e += `KV: ${o.retrievedKeyValues}
+`, e += `Data Bytes: ${o.retrievedResourceDataBytes}
+`, e += `KV Bytes: ${o.retrievedKeyValueBytes}
+`, e += `Pruned fields: ${o.prunedFields}
+`, e += `Final resources skipped: ${o.finalResourcesSkipped}`, e;
 }
-async function X(n, e, t) {
+async function X(o, e, t) {
   var c;
-  const i = Date.now();
+  const r = Date.now();
   t && t.requests++;
-  const { seedResources: s, finalResources: o, pruningFunction: a } = e, r = new H();
+  const { seedResources: s, finalResources: n, pruningFunction: a } = e, i = new H();
   let f = !0, l = 0;
   const h = /* @__PURE__ */ new Set(), k = (v) => {
-    if (V(v) || h.has(v)) return;
-    if (o.has(v)) {
+    if (b(v) || h.has(v)) return;
+    if (n.has(v)) {
       t && t.finalResourcesSkipped++;
       return;
     }
     h.add(v);
-    const y = n.getResourceDataIfExists(v, !0), w = n.listKeyValuesIfResourceExists(v), W = f;
-    f && (f = !1), r.push(
+    const y = o.getResourceDataIfExists(v, !0), w = o.listKeyValuesIfResourceExists(v), B = f;
+    f && (f = !1), i.push(
       (async () => {
         const [I, _] = await Promise.all([y, w]);
-        if (W && (l++, f = !0), I !== void 0) {
+        if (B && (l++, f = !0), I !== void 0) {
           if (_ === void 0) throw new Error("Inconsistent replies");
           return { ...I, kv: _ };
         }
@@ -609,7 +629,7 @@ async function X(n, e, t) {
   s.forEach((v) => k(v));
   const u = [];
   for (; ; ) {
-    const v = r.shift();
+    const v = i.shift();
     if (v === void 0)
       break;
     let y = await v;
@@ -628,63 +648,63 @@ async function X(n, e, t) {
       u.push(y);
     }
   }
-  return t && (t.millisSpent += Date.now() - i, t.roundTrips += l), u;
+  return t && (t.millisSpent += Date.now() - r, t.roundTrips += l), u;
 }
-function he(n) {
-  return n;
+function he(o) {
+  return o;
 }
-function le(n, e, t) {
+function le(o, e, t) {
   var a;
-  const i = n instanceof R ? p(t).accessor(n).node() : n instanceof E ? n.node() : n, o = { ...i.resourceInfo };
-  if (e.data !== void 0 && (e.data === "raw" ? o.data = i.getData() : o.data = e.data.parse(i.getDataAsJson())), e.fields !== void 0) {
-    const r = {};
+  const r = o instanceof C ? p(t).accessor(o).node() : o instanceof E ? o.node() : o, n = { ...r.resourceInfo };
+  if (e.data !== void 0 && (e.data === "raw" ? n.data = r.getData() : n.data = e.data.parse(r.getDataAsJson())), e.fields !== void 0) {
+    const i = {};
     for (const [f, l] of Object.entries(e.fields))
-      r[f] = (a = i.traverse({
+      i[f] = (a = r.traverse({
         field: f,
         errorIfFieldNotSet: l,
         stableIfNotFound: !l
       })) == null ? void 0 : a.id;
-    o.fields = r;
+    n.fields = i;
   }
   if (e.kv !== void 0) {
-    const r = {};
+    const i = {};
     for (const [f, l] of Object.entries(e.kv)) {
-      const h = i.getKeyValue(f);
+      const h = r.getKeyValue(f);
       if (h === void 0)
         throw new Error(`Key not found ${f}`);
-      l === "raw" ? r[f] = h : r[f] = l.parse(JSON.parse(Buffer.from(h).toString("utf-8")));
+      l === "raw" ? i[f] = h : i[f] = l.parse(JSON.parse(Buffer.from(h).toString("utf-8")));
     }
-    o.kv = r;
+    n.kv = i;
   }
-  return o;
+  return n;
 }
-function fe(n, e, t) {
-  if (n instanceof R) {
-    const i = t.accessor(n).node(), s = i.resourceInfo, o = e.map((a) => {
-      var r, f;
+function fe(o, e, t) {
+  if (o instanceof C) {
+    const r = t.accessor(o).node(), s = r.resourceInfo, n = e.map((a) => {
+      var i, f;
       return [
         a,
-        (f = (r = i.getField(a)) == null ? void 0 : r.value) == null ? void 0 : f.id
+        (f = (i = r.getField(a)) == null ? void 0 : i.value) == null ? void 0 : f.id
       ];
     });
     return {
       ...s,
-      fields: new Map(o),
-      data: i.getData() ?? new Uint8Array()
+      fields: new Map(n),
+      data: r.getData() ?? new Uint8Array()
     };
   }
-  return n;
+  return o;
 }
-function ge(n, e, t) {
-  if (!(n instanceof R)) return n;
-  const i = t.accessor(n).node(), s = i.resourceInfo, o = e.map((a) => [a, i.getKeyValue(a)]);
+function ge(o, e, t) {
+  if (!(o instanceof C)) return o;
+  const r = t.accessor(o).node(), s = r.resourceInfo, n = e.map((a) => [a, r.getKeyValue(a)]);
   return {
     ...s,
-    metadata: Object.fromEntries(o)
+    metadata: Object.fromEntries(n)
   };
 }
 class K {
-  constructor(e, t, i, s) {
+  constructor(e, t, r, s) {
     d(this, "finalPredicate");
     d(this, "state");
     d(this, "pollingInterval");
@@ -700,8 +720,8 @@ class K {
     /** If true this tree state is permanently terminaed. */
     d(this, "terminated", !1);
     this.pl = e, this.root = t, this.logger = s;
-    const { finalPredicateOverride: o, pruning: a, pollingInterval: r, stopPollingDelay: f, logStat: l } = i;
-    this.pruning = a, this.pollingInterval = r, this.finalPredicate = o ?? e.finalPredicate, this.logStat = l, this.state = new O(t, this.finalPredicate), this.hooks = new B(
+    const { finalPredicateOverride: n, pruning: a, pollingInterval: i, stopPollingDelay: f, logStat: l } = r;
+    this.pruning = a, this.pollingInterval = i, this.finalPredicate = n ?? e.finalPredicate, this.logStat = l, this.state = new O(t, this.finalPredicate), this.hooks = new q(
       () => this.startUpdating(),
       () => this.stopUpdating(),
       { stopDebounce: f },
@@ -715,7 +735,7 @@ class K {
   }
   entry(e = this.root) {
     if (this.terminated) throw new Error("tree synchronization is terminated");
-    return new R({ treeProvider: () => this.state, hooks: this.hooks }, e);
+    return new C({ treeProvider: () => this.state, hooks: this.hooks }, e);
   }
   /** Can be used to externally kick off the synchronization polling loop, and
    * await for the first synchronization to happen. */
@@ -737,34 +757,41 @@ class K {
   /** Executed from the main loop, and initialization procedure. */
   async refresh(e, t) {
     if (this.terminated) throw new Error("tree synchronization is terminated");
-    const i = Q(this.state, this.pruning), s = await this.pl.withReadTx("ReadingTree", async (o) => await X(o, i, e), t);
+    const r = Q(this.state, this.pruning), s = await this.pl.withReadTx("ReadingTree", async (n) => await X(n, r, e), t);
     this.state.updateFromResourceData(s, !0);
   }
   async mainLoop() {
-    var t, i;
+    var t, r;
     let e = this.logStat ? F() : void 0;
     for (; this.keepRunning; ) {
       let s;
       this.scheduledOnNextState.length > 0 && (s = this.scheduledOnNextState, this.scheduledOnNextState = []);
       try {
-        if (this.logStat === "per-request" && (e = F()), await this.refresh(e), e && this.logger && this.logger.info(`Tree stat (success): ${JSON.stringify(e)}`), s !== void 0) for (const o of s) o.resolve();
-      } catch (o) {
-        if (e && this.logger && this.logger.info(`Tree stat (error): ${JSON.stringify(e)}`), s !== void 0) for (const a of s) a.reject(o);
-        if (o instanceof C) {
-          (t = this.logger) == null || t.error(o), this.state.invalidateTree("stat update error"), this.state = new O(this.root, this.finalPredicate);
+        if (this.logStat === "per-request" && (e = F()), await this.refresh(e), e && this.logger && this.logger.info(`Tree stat (success): ${JSON.stringify(e)}`), s !== void 0) for (const n of s) n.resolve();
+      } catch (n) {
+        if (e && this.logger && this.logger.info(`Tree stat (error): ${JSON.stringify(e)}`), s !== void 0) for (const a of s) a.reject(n);
+        if (n instanceof S) {
+          (t = this.logger) == null || t.error(n), this.state.invalidateTree("stat update error"), this.state = new O(this.root, this.finalPredicate);
           continue;
-        } else (i = this.logger) == null || i.warn(o);
+        } else (r = this.logger) == null || r.warn(n);
       }
       if (!this.keepRunning || this.terminated) break;
       try {
         await j.setTimeout(this.pollingInterval, this.abortController.signal);
-      } catch (o) {
-        if (!q(o)) throw new Error("Unexpected error", { cause: o });
+      } catch (n) {
+        if (!J(n)) throw new Error("Unexpected error", { cause: n });
         break;
       }
     }
     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.
@@ -776,29 +803,68 @@ class K {
   async awaitSyncLoopTermination() {
     this.currentLoop !== void 0 && await this.currentLoop;
   }
-  static async init(e, t, i, s) {
-    const o = new K(e, t, i, s);
-    let a = i.logStat ? F() : void 0, r = !1;
+  static async init(e, t, r, s) {
+    const n = new K(e, t, r, s);
+    let a = r.logStat ? F() : void 0, i = !1;
     try {
-      await o.refresh(a, {
-        timeout: i.initialTreeLoadingTimeout
-      }), r = !0;
+      await n.refresh(a, {
+        timeout: r.initialTreeLoadingTimeout
+      }), i = !0;
     } finally {
       a && s && s.info(
-        `Tree stat (initial load, ${r ? "success" : "failure"}): ${JSON.stringify(a)}`
+        `Tree stat (initial load, ${i ? "success" : "failure"}): ${JSON.stringify(a)}`
       );
     }
-    return o;
+    return n;
+  }
+}
+function pe(o) {
+  var t;
+  const e = {
+    total: {
+      count: 0,
+      fieldNameBytes: 0,
+      fieldsCount: 0,
+      dataBytes: 0,
+      kvCount: 0,
+      kvBytes: 0
+    },
+    byResourceType: {}
+  };
+  for (const r of o) {
+    const s = `${r.type.name}/${r.type.version}`;
+    e.byResourceType[s] || (e.byResourceType[s] = {
+      count: 0,
+      fieldNameBytes: 0,
+      fieldsCount: 0,
+      dataBytes: 0,
+      kvCount: 0,
+      kvBytes: 0
+    });
+    const n = e.byResourceType[s];
+    n.count++, e.total.count++;
+    for (const a of r.fields)
+      n.fieldNameBytes += a.name.length, n.fieldsCount++, e.total.fieldNameBytes += a.name.length, e.total.fieldsCount++;
+    if (r.data) {
+      const a = ((t = r.data) == null ? void 0 : t.length) ?? 0;
+      n.dataBytes += a, e.total.dataBytes += a;
+    }
+    n.kvCount += r.kv.length, e.total.kvCount += r.kv.length;
+    for (const a of r.kv) {
+      const i = a.key.length + a.value.length;
+      n.kvBytes += i, e.total.kvBytes += i;
+    }
   }
+  return e;
 }
 export {
-  R as PlTreeEntry,
+  C as PlTreeEntry,
   E as PlTreeEntryAccessor,
   Y as PlTreeNodeAccessor,
   G as PlTreeResource,
   O as PlTreeState,
   K as SynchronizedTreeState,
-  C as TreeStateUpdateError,
+  S as TreeStateUpdateError,
   Q as constructTreeLoadingRequest,
   ce as formatTreeLoadingStat,
   F as initialTreeLoadingStat,
@@ -807,9 +873,10 @@ export {
   ue as isPlTreeNodeAccessor,
   X as loadTreeState,
   le as makeResourceSnapshot,
-  b as mapValueAndError,
+  P as mapValueAndError,
   ae as mapValueAndErrorIfDefined,
   he as rsSchema,
+  pe as treeDumpStats,
   de as treeEntryToResourceInfo,
   fe as treeEntryToResourceWithData,
   ge as treeEntryToResourceWithMetadata