@milaboratories/pl-tree 1.7.5 → 1.7.6

package/dist/accessors.cjs

@@ -0,0 +1,297 @@
+'use strict';
+
+var plClient = require('@milaboratories/pl-client');
+var value_and_error = require('./value_and_error.cjs');
+var plErrors = require('@milaboratories/pl-errors');
+var tsHelpers = require('@milaboratories/ts-helpers');
+
+/** Error encountered during traversal in field or resource. */
+class PlError extends Error {
+    constructor(message) {
+        super(message);
+    }
+}
+function isPlTreeEntry(obj) {
+    return (typeof obj === 'object'
+        && obj !== null
+        && obj['__pl_tree_type_marker__'] === 'PlTreeEntry');
+}
+function isPlTreeEntryAccessor(obj) {
+    return (typeof obj === 'object'
+        && obj !== null
+        && obj['__pl_tree_type_marker__'] === 'PlTreeEntryAccessor');
+}
+function isPlTreeNodeAccessor(obj) {
+    return (typeof obj === 'object'
+        && obj !== null
+        && obj['__pl_tree_type_marker__'] === 'PlTreeNodeAccessor');
+}
+/** Main entry point for using PlTree in reactive setting */
+class PlTreeEntry {
+    accessorData;
+    rid;
+    __pl_tree_type_marker__ = 'PlTreeEntry';
+    constructor(accessorData, rid) {
+        this.accessorData = accessorData;
+        this.rid = rid;
+    }
+    createAccessor(ctx, guard) {
+        return new PlTreeEntryAccessor(this.accessorData, this.accessorData.treeProvider(), this.rid, {
+            ctx,
+            guard,
+        });
+    }
+    toJSON() {
+        return this.toString();
+    }
+    toString() {
+        return `[ENTRY:${plClient.resourceIdToString(this.rid)}]`;
+    }
+}
+function getResourceFromTree(accessorData, tree, instanceData, rid, ops) {
+    const acc = new PlTreeNodeAccessor(accessorData, tree, tree.get(instanceData.ctx.watcher, rid), instanceData);
+    if (!ops.ignoreError) {
+        const err = acc.getError();
+        if (err !== undefined)
+            throw plErrors.parsePlError(tsHelpers.notEmpty(err.getDataAsString()), acc.id, acc.resourceType);
+    }
+    if (ops.assertResourceType !== undefined
+        && (Array.isArray(ops.assertResourceType)
+            ? ops.assertResourceType.findIndex((rt) => plClient.resourceTypesEqual(rt, acc.resourceType)) === -1
+            : !plClient.resourceTypesEqual(ops.assertResourceType, acc.resourceType)))
+        throw new Error(
+        // eslint-disable-next-line @typescript-eslint/no-base-to-string
+        `wrong resource type ${plClient.resourceTypeToString(acc.resourceType)} but expected ${ops.assertResourceType}`);
+    return acc;
+}
+class PlTreeEntryAccessor {
+    accessorData;
+    tree;
+    rid;
+    instanceData;
+    __pl_tree_type_marker__ = 'PlTreeEntryAccessor';
+    constructor(accessorData, tree, rid, instanceData) {
+        this.accessorData = accessorData;
+        this.tree = tree;
+        this.rid = rid;
+        this.instanceData = instanceData;
+    }
+    node(ops = {}) {
+        this.instanceData.guard();
+        // this is the only entry point to acquire a PlTreeNodeAccessor,
+        // so this is the only point where we should attach the hooks
+        if (this.accessorData.hooks !== undefined)
+            this.instanceData.ctx.attacheHooks(this.accessorData.hooks);
+        return getResourceFromTree(this.accessorData, this.tree, this.instanceData, this.rid, ops);
+    }
+}
+/**
+ * Can be called only when a ctx is provided, because pl tree entry is a computable entity.
+ * @deprecated
+ * */
+function treeEntryToResourceInfo(res, ctx) {
+    if (res instanceof PlTreeEntry)
+        return ctx.accessor(res).node().resourceInfo;
+    return res;
+}
+/**
+ * API contracts:
+ *   - API never return {@link NullResourceId}, absence of link is always modeled as `undefined`
+ *
+ * Important: never store instances of this class, always get fresh instance from {@link PlTreeState} accessor.
+ * */
+class PlTreeNodeAccessor {
+    accessorData;
+    tree;
+    resource;
+    instanceData;
+    __pl_tree_type_marker__ = 'PlTreeNodeAccessor';
+    constructor(accessorData, tree, resource, instanceData) {
+        this.accessorData = accessorData;
+        this.tree = tree;
+        this.resource = resource;
+        this.instanceData = instanceData;
+    }
+    get id() {
+        this.instanceData.guard();
+        return this.resource.id;
+    }
+    get originalId() {
+        this.instanceData.guard();
+        return this.resource.originalResourceId;
+    }
+    get resourceType() {
+        this.instanceData.guard();
+        return this.resource.type;
+    }
+    get resourceInfo() {
+        return { id: this.id, type: this.resourceType };
+    }
+    getResourceFromTree(rid, ops) {
+        return getResourceFromTree(this.accessorData, this.tree, this.instanceData, rid, ops);
+    }
+    traverse(...steps) {
+        return this.traverseWithCommon({}, ...steps);
+    }
+    traverseOrError(...steps) {
+        return this.traverseOrErrorWithCommon({}, ...steps);
+    }
+    traverseWithCommon(commonOptions, ...steps) {
+        const result = this.traverseOrErrorWithCommon(commonOptions, ...steps);
+        if (result === undefined)
+            return undefined;
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    traverseOrErrorWithCommon(commonOptions, ...steps) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        let current = this;
+        for (const _step of steps) {
+            const step = typeof _step === 'string'
+                ? {
+                    ...commonOptions,
+                    field: _step,
+                }
+                : { ...commonOptions, ..._step };
+            const next = current.getField(_step);
+            if (next === undefined)
+                return undefined;
+            if (step.pureFieldErrorToUndefined && next.value === undefined && next.error !== undefined)
+                return undefined;
+            if ((!step.ignoreError || next.value === undefined) && next.error !== undefined)
+                return {
+                    ok: false,
+                    // FIXME: in next tickets we'll allow Errors to be thrown.
+                    error: plErrors.parsePlError(tsHelpers.notEmpty(next.error.getDataAsString()), current.id, current.resourceType, step.field),
+                };
+            if (next.value === undefined) {
+                if (step.errorIfFieldNotSet)
+                    return {
+                        ok: false,
+                        error: new Error(`field have no assigned value ${step.field} of ${plClient.resourceIdToString(current.id)}`),
+                    };
+                // existing but unpopulated field is unstable because it must be resolved at some point
+                this.onUnstableLambda('unpopulated_field:' + step.field);
+                return undefined;
+            }
+            current = next.value;
+        }
+        return { ok: true, value: current };
+    }
+    onUnstableLambda = (marker) => {
+        this.instanceData.ctx.markUnstable(marker);
+    };
+    getField(_step) {
+        this.instanceData.guard();
+        const step = typeof _step === 'string' ? { field: _step } : _step;
+        const ve = this.resource.getField(this.instanceData.ctx.watcher, step, this.onUnstableLambda);
+        if (ve === undefined)
+            return undefined;
+        return value_and_error.mapValueAndError(ve, (rid) => this.getResourceFromTree(rid, { ignoreError: true }));
+    }
+    getInputsLocked() {
+        this.instanceData.guard();
+        const result = this.resource.getInputsLocked(this.instanceData.ctx.watcher);
+        if (!result)
+            this.instanceData.ctx.markUnstable('inputs_unlocked:' + this.resourceType.name);
+        return result;
+    }
+    getOutputsLocked() {
+        this.instanceData.guard();
+        const result = this.resource.getOutputsLocked(this.instanceData.ctx.watcher);
+        if (!result)
+            this.instanceData.ctx.markUnstable('outputs_unlocked:' + this.resourceType.name);
+        return result;
+    }
+    getIsReadyOrError() {
+        this.instanceData.guard();
+        const result = this.resource.getIsReadyOrError(this.instanceData.ctx.watcher);
+        if (!result)
+            this.instanceData.ctx.markUnstable('not_ready:' + this.resourceType.name);
+        return result;
+    }
+    getIsFinal() {
+        this.instanceData.guard();
+        return this.resource.getIsFinal(this.instanceData.ctx.watcher);
+    }
+    getError() {
+        this.instanceData.guard();
+        const rid = this.resource.getError(this.instanceData.ctx.watcher);
+        if (rid === undefined)
+            // absence of error always considered as stable
+            return undefined;
+        return this.getResourceFromTree(rid, {});
+    }
+    getData() {
+        return this.resource.data;
+    }
+    getDataAsString() {
+        return this.resource.getDataAsString();
+    }
+    getDataAsJson() {
+        return this.resource.getDataAsJson();
+    }
+    listInputFields() {
+        this.instanceData.guard();
+        this.getInputsLocked(); // will set unstable if not locked
+        return this.resource.listInputFields(this.instanceData.ctx.watcher);
+    }
+    listOutputFields() {
+        this.instanceData.guard();
+        this.getOutputsLocked(); // will set unstable if not locked
+        return this.resource.listOutputFields(this.instanceData.ctx.watcher);
+    }
+    listDynamicFields() {
+        this.instanceData.guard();
+        return this.resource.listDynamicFields(this.instanceData.ctx.watcher);
+    }
+    getKeyValue(key, unstableIfNotFound = false) {
+        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);
+        return result;
+    }
+    /** @deprecated */
+    getKeyValueString(key) {
+        return this.getKeyValueAsString(key);
+    }
+    getKeyValueAsString(key, unstableIfNotFound = false) {
+        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);
+        return result;
+    }
+    getKeyValueAsJson(key, unstableIfNotFound = false) {
+        const result = this.resource.getKeyValueAsJson(this.instanceData.ctx.watcher, key);
+        if (result === undefined) {
+            if (unstableIfNotFound)
+                this.instanceData.ctx.markUnstable('key_not_found_j:' + key);
+            return undefined;
+        }
+        return result;
+    }
+    /**
+     * Can be used to pass a higher level accessor that will wrap the resource and throw its
+     * errors on node resolution.
+     * */
+    toEntryAccessor() {
+        return new PlTreeEntryAccessor(this.accessorData, this.tree, this.id, this.instanceData);
+    }
+    /** Can be passed to nested computable. */
+    persist() {
+        return new PlTreeEntry(this.accessorData, this.resource.id);
+    }
+}
+
+exports.PlError = PlError;
+exports.PlTreeEntry = PlTreeEntry;
+exports.PlTreeEntryAccessor = PlTreeEntryAccessor;
+exports.PlTreeNodeAccessor = PlTreeNodeAccessor;
+exports.isPlTreeEntry = isPlTreeEntry;
+exports.isPlTreeEntryAccessor = isPlTreeEntryAccessor;
+exports.isPlTreeNodeAccessor = isPlTreeNodeAccessor;
+exports.treeEntryToResourceInfo = treeEntryToResourceInfo;
+//# sourceMappingURL=accessors.cjs.map

package/dist/accessors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessors.cjs","sources":["../src/accessors.ts"],"sourcesContent":["import type { PlTreeResource, PlTreeState } from './state';\nimport type {\n  AccessorProvider,\n  ComputableCtx,\n  ComputableHooks,\n  UsageGuard,\n} from '@milaboratories/computable';\nimport type {\n  ResourceId,\n  ResourceType,\n  OptionalResourceId } from '@milaboratories/pl-client';\nimport {\n  resourceIdToString,\n  resourceTypesEqual,\n  resourceTypeToString,\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  NullResourceId,\n} from '@milaboratories/pl-client';\nimport type { ValueAndError } from './value_and_error';\nimport { mapValueAndError } from './value_and_error';\nimport type {\n  CommonFieldTraverseOps,\n  FieldTraversalStep,\n  GetFieldStep,\n  ResourceTraversalOps,\n} from './traversal_ops';\nimport type { ValueOrError } from './value_or_error';\nimport { parsePlError } from '@milaboratories/pl-errors';\nimport { notEmpty } from '@milaboratories/ts-helpers';\n/** Error encountered during traversal in field or resource. */\nexport class PlError extends Error {\n  constructor(message: string) {\n    super(message);\n  }\n}\n\nexport type TreeAccessorData = {\n  readonly treeProvider: () => PlTreeState;\n  readonly hooks?: ComputableHooks;\n};\n\nexport type TreeAccessorInstanceData = {\n  readonly guard: UsageGuard;\n  readonly ctx: ComputableCtx;\n};\n\nexport function isPlTreeEntry(obj: unknown): obj is PlTreeEntry {\n  return (\n    typeof obj === 'object'\n    && obj !== null\n    && (obj as any)['__pl_tree_type_marker__'] === 'PlTreeEntry'\n  );\n}\n\nexport function isPlTreeEntryAccessor(obj: unknown): obj is PlTreeEntryAccessor {\n  return (\n    typeof obj === 'object'\n    && obj !== null\n    && (obj as any)['__pl_tree_type_marker__'] === 'PlTreeEntryAccessor'\n  );\n}\n\nexport function isPlTreeNodeAccessor(obj: unknown): obj is PlTreeNodeAccessor {\n  return (\n    typeof obj === 'object'\n    && obj !== null\n    && (obj as any)['__pl_tree_type_marker__'] === 'PlTreeNodeAccessor'\n  );\n}\n\n/** Main entry point for using PlTree in reactive setting */\nexport class PlTreeEntry implements AccessorProvider<PlTreeEntryAccessor> {\n  private readonly __pl_tree_type_marker__ = 'PlTreeEntry';\n\n  constructor(\n    private readonly accessorData: TreeAccessorData,\n    public readonly rid: ResourceId,\n  ) {}\n\n  public createAccessor(ctx: ComputableCtx, guard: UsageGuard): PlTreeEntryAccessor {\n    return new PlTreeEntryAccessor(this.accessorData, this.accessorData.treeProvider(), this.rid, {\n      ctx,\n      guard,\n    });\n  }\n\n  public toJSON(): string {\n    return this.toString();\n  }\n\n  public toString(): string {\n    return `[ENTRY:${resourceIdToString(this.rid)}]`;\n  }\n}\n\nfunction getResourceFromTree(\n  accessorData: TreeAccessorData,\n  tree: PlTreeState,\n  instanceData: TreeAccessorInstanceData,\n  rid: ResourceId,\n  ops: ResourceTraversalOps,\n): PlTreeNodeAccessor {\n  const acc = new PlTreeNodeAccessor(\n    accessorData,\n    tree,\n    tree.get(instanceData.ctx.watcher, rid),\n    instanceData,\n  );\n\n  if (!ops.ignoreError) {\n    const err = acc.getError();\n    if (err !== undefined)\n      throw parsePlError(notEmpty(err.getDataAsString()), acc.id, acc.resourceType);\n  }\n\n  if (\n    ops.assertResourceType !== undefined\n    && (Array.isArray(ops.assertResourceType)\n      ? ops.assertResourceType.findIndex((rt) => resourceTypesEqual(rt, acc.resourceType)) === -1\n      : !resourceTypesEqual(ops.assertResourceType, acc.resourceType))\n  )\n    throw new Error(\n      // eslint-disable-next-line @typescript-eslint/no-base-to-string\n      `wrong resource type ${resourceTypeToString(acc.resourceType)} but expected ${ops.assertResourceType}`,\n    );\n\n  return acc;\n}\n\nexport class PlTreeEntryAccessor {\n  private readonly __pl_tree_type_marker__ = 'PlTreeEntryAccessor';\n\n  constructor(\n    private readonly accessorData: TreeAccessorData,\n    private readonly tree: PlTreeState,\n    private readonly rid: ResourceId,\n    private readonly instanceData: TreeAccessorInstanceData,\n  ) {}\n\n  node(ops: ResourceTraversalOps = {}): PlTreeNodeAccessor {\n    this.instanceData.guard();\n\n    // this is the only entry point to acquire a PlTreeNodeAccessor,\n    // so this is the only point where we should attach the hooks\n    if (this.accessorData.hooks !== undefined)\n      this.instanceData.ctx.attacheHooks(this.accessorData.hooks);\n\n    return getResourceFromTree(this.accessorData, this.tree, this.instanceData, this.rid, ops);\n  }\n}\n\n/**\n * Helper type to simplify implementation of APIs requiring type information.\n * */\nexport type ResourceInfo = {\n  readonly id: ResourceId;\n  readonly type: ResourceType;\n};\n\n/**\n * Can be called only when a ctx is provided, because pl tree entry is a computable entity.\n * @deprecated\n * */\nexport function treeEntryToResourceInfo(res: PlTreeEntry | ResourceInfo, ctx: ComputableCtx) {\n  if (res instanceof PlTreeEntry) return ctx.accessor(res).node().resourceInfo;\n\n  return res;\n}\n\n/**\n * API contracts:\n *   - API never return {@link NullResourceId}, absence of link is always modeled as `undefined`\n *\n * Important: never store instances of this class, always get fresh instance from {@link PlTreeState} accessor.\n * */\nexport class PlTreeNodeAccessor {\n  private readonly __pl_tree_type_marker__ = 'PlTreeNodeAccessor';\n\n  constructor(\n    private readonly accessorData: TreeAccessorData,\n    private readonly tree: PlTreeState,\n    private readonly resource: PlTreeResource,\n    private readonly instanceData: TreeAccessorInstanceData,\n  ) {}\n\n  public get id(): ResourceId {\n    this.instanceData.guard();\n    return this.resource.id;\n  }\n\n  public get originalId(): OptionalResourceId {\n    this.instanceData.guard();\n    return this.resource.originalResourceId;\n  }\n\n  public get resourceType(): ResourceType {\n    this.instanceData.guard();\n    return this.resource.type;\n  }\n\n  public get resourceInfo(): ResourceInfo {\n    return { id: this.id, type: this.resourceType };\n  }\n\n  private getResourceFromTree(rid: ResourceId, ops: ResourceTraversalOps): PlTreeNodeAccessor {\n    return getResourceFromTree(this.accessorData, this.tree, this.instanceData, rid, ops);\n  }\n\n  public traverse(\n    ...steps: [\n      Omit<FieldTraversalStep, 'errorIfFieldNotSet'> & {\n        errorIfFieldNotSet: true;\n      },\n    ]\n  ): PlTreeNodeAccessor;\n  public traverse(...steps: (FieldTraversalStep | string)[]): PlTreeNodeAccessor | undefined;\n  public traverse(...steps: (FieldTraversalStep | string)[]): PlTreeNodeAccessor | undefined {\n    return this.traverseWithCommon({}, ...steps);\n  }\n\n  public traverseOrError(\n    ...steps: [\n      Omit<FieldTraversalStep, 'errorIfFieldNotSet'> & {\n        errorIfFieldNotSet: true;\n      },\n    ]\n  ): ValueOrError<PlTreeNodeAccessor, Error>;\n  public traverseOrError(\n    ...steps: (FieldTraversalStep | string)[]\n  ): ValueOrError<PlTreeNodeAccessor, Error> | undefined;\n  public traverseOrError(\n    ...steps: (FieldTraversalStep | string)[]\n  ): ValueOrError<PlTreeNodeAccessor, Error> | undefined {\n    return this.traverseOrErrorWithCommon({}, ...steps);\n  }\n\n  public traverseWithCommon(\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): PlTreeNodeAccessor | undefined {\n    const result = this.traverseOrErrorWithCommon(commonOptions, ...steps);\n    if (result === undefined) return undefined;\n\n    if (!result.ok) throw result.error;\n    return result.value;\n  }\n\n  public traverseOrErrorWithCommon(\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): ValueOrError<PlTreeNodeAccessor, Error> | undefined {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    let current: PlTreeNodeAccessor = this;\n\n    for (const _step of steps) {\n      const step: FieldTraversalStep\n        = typeof _step === 'string'\n          ? {\n              ...commonOptions,\n              field: _step,\n            }\n          : { ...commonOptions, ..._step };\n\n      const next = current.getField(_step);\n\n      if (next === undefined) return undefined;\n\n      if (step.pureFieldErrorToUndefined && next.value === undefined && next.error !== undefined)\n        return undefined;\n\n      if ((!step.ignoreError || next.value === undefined) && next.error !== undefined)\n        return {\n          ok: false,\n\n          // FIXME: in next tickets we'll allow Errors to be thrown.\n          error: parsePlError(\n            notEmpty(next.error.getDataAsString()),\n            current.id, current.resourceType, step.field,\n          ),\n        };\n\n      if (next.value === undefined) {\n        if (step.errorIfFieldNotSet)\n          return {\n            ok: false,\n            error: new Error(`field have no assigned value ${step.field} of ${resourceIdToString(current.id)}`),\n          };\n        // existing but unpopulated field is unstable because it must be resolved at some point\n        this.onUnstableLambda('unpopulated_field:' + step.field);\n        return undefined;\n      }\n\n      current = next.value;\n    }\n    return { ok: true, value: current };\n  }\n\n  private readonly onUnstableLambda = (marker: string) => {\n    this.instanceData.ctx.markUnstable(marker);\n  };\n\n  public getField(\n    _step:\n      | (Omit<GetFieldStep, 'errorIfFieldNotFound'> & { errorIfFieldNotFound: true })\n      | (Omit<GetFieldStep, 'errorIfFieldNotSet'> & { errorIfFieldNotSet: true })\n  ): ValueAndError<PlTreeNodeAccessor>;\n  public getField(_step: GetFieldStep | string): ValueAndError<PlTreeNodeAccessor> | undefined;\n  public getField(_step: GetFieldStep | string): ValueAndError<PlTreeNodeAccessor> | undefined {\n    this.instanceData.guard();\n    const step: GetFieldStep = typeof _step === 'string' ? { field: _step } : _step;\n\n    const ve = this.resource.getField(this.instanceData.ctx.watcher, step, this.onUnstableLambda);\n\n    if (ve === undefined) return undefined;\n\n    return mapValueAndError(ve, (rid) => this.getResourceFromTree(rid, { ignoreError: true }));\n  }\n\n  public getInputsLocked(): boolean {\n    this.instanceData.guard();\n    const result = this.resource.getInputsLocked(this.instanceData.ctx.watcher);\n    if (!result) this.instanceData.ctx.markUnstable('inputs_unlocked:' + this.resourceType.name);\n    return result;\n  }\n\n  public getOutputsLocked(): boolean {\n    this.instanceData.guard();\n    const result = this.resource.getOutputsLocked(this.instanceData.ctx.watcher);\n    if (!result) this.instanceData.ctx.markUnstable('outputs_unlocked:' + this.resourceType.name);\n    return result;\n  }\n\n  public getIsReadyOrError(): boolean {\n    this.instanceData.guard();\n    const result = this.resource.getIsReadyOrError(this.instanceData.ctx.watcher);\n    if (!result) this.instanceData.ctx.markUnstable('not_ready:' + this.resourceType.name);\n    return result;\n  }\n\n  public getIsFinal() {\n    this.instanceData.guard();\n    return this.resource.getIsFinal(this.instanceData.ctx.watcher);\n  }\n\n  public getError(): PlTreeNodeAccessor | undefined {\n    this.instanceData.guard();\n    const rid = this.resource.getError(this.instanceData.ctx.watcher);\n    if (rid === undefined)\n      // absence of error always considered as stable\n      return undefined;\n    return this.getResourceFromTree(rid, {});\n  }\n\n  public getData(): Uint8Array | undefined {\n    return this.resource.data;\n  }\n\n  public getDataAsString(): string | undefined {\n    return this.resource.getDataAsString();\n  }\n\n  public getDataAsJson<T = unknown>(): T | undefined {\n    return this.resource.getDataAsJson<T>();\n  }\n\n  public listInputFields(): string[] {\n    this.instanceData.guard();\n    this.getInputsLocked(); // will set unstable if not locked\n    return this.resource.listInputFields(this.instanceData.ctx.watcher);\n  }\n\n  public listOutputFields(): string[] {\n    this.instanceData.guard();\n    this.getOutputsLocked(); // will set unstable if not locked\n    return this.resource.listOutputFields(this.instanceData.ctx.watcher);\n  }\n\n  public listDynamicFields(): string[] {\n    this.instanceData.guard();\n    return this.resource.listDynamicFields(this.instanceData.ctx.watcher);\n  }\n\n  public getKeyValue(key: string, unstableIfNotFound: boolean = false): Uint8Array | undefined {\n    this.instanceData.guard();\n    const result = this.resource.getKeyValue(this.instanceData.ctx.watcher, key);\n    if (result === undefined && unstableIfNotFound)\n      this.instanceData.ctx.markUnstable('key_not_found_b:' + key);\n    return result;\n  }\n\n  /** @deprecated */\n  public getKeyValueString(key: string): string | undefined {\n    return this.getKeyValueAsString(key);\n  }\n\n  public getKeyValueAsString(key: string, unstableIfNotFound: boolean = false): string | undefined {\n    this.instanceData.guard();\n    const result = this.resource.getKeyValueString(this.instanceData.ctx.watcher, key);\n    if (result === undefined && unstableIfNotFound)\n      this.instanceData.ctx.markUnstable('key_not_found_s:' + key);\n    return result;\n  }\n\n  public getKeyValueAsJson<T = unknown>(\n    key: string,\n    unstableIfNotFound: boolean = false,\n  ): T | undefined {\n    const result = this.resource.getKeyValueAsJson<T>(this.instanceData.ctx.watcher, key);\n    if (result === undefined) {\n      if (unstableIfNotFound) this.instanceData.ctx.markUnstable('key_not_found_j:' + key);\n      return undefined;\n    }\n    return result;\n  }\n\n  /**\n   * Can be used to pass a higher level accessor that will wrap the resource and throw its\n   * errors on node resolution.\n   * */\n  public toEntryAccessor(): PlTreeEntryAccessor {\n    return new PlTreeEntryAccessor(this.accessorData, this.tree, this.id, this.instanceData);\n  }\n\n  /** Can be passed to nested computable. */\n  public persist(): PlTreeEntry {\n    return new PlTreeEntry(this.accessorData, this.resource.id);\n  }\n}\n"],"names":["resourceIdToString","parsePlError","notEmpty","resourceTypesEqual","resourceTypeToString","mapValueAndError"],"mappings":"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"}

package/dist/accessors.d.ts

@@ -113,4 +113,3 @@ export declare class PlTreeNodeAccessor {
     /** Can be passed to nested computable. */
     persist(): PlTreeEntry;
 }
-//# sourceMappingURL=accessors.d.ts.map

package/dist/accessors.js

@@ -0,0 +1,288 @@
+import { resourceIdToString, resourceTypesEqual, resourceTypeToString } from '@milaboratories/pl-client';
+import { mapValueAndError } from './value_and_error.js';
+import { parsePlError } from '@milaboratories/pl-errors';
+import { notEmpty } from '@milaboratories/ts-helpers';
+
+/** Error encountered during traversal in field or resource. */
+class PlError extends Error {
+    constructor(message) {
+        super(message);
+    }
+}
+function isPlTreeEntry(obj) {
+    return (typeof obj === 'object'
+        && obj !== null
+        && obj['__pl_tree_type_marker__'] === 'PlTreeEntry');
+}
+function isPlTreeEntryAccessor(obj) {
+    return (typeof obj === 'object'
+        && obj !== null
+        && obj['__pl_tree_type_marker__'] === 'PlTreeEntryAccessor');
+}
+function isPlTreeNodeAccessor(obj) {
+    return (typeof obj === 'object'
+        && obj !== null
+        && obj['__pl_tree_type_marker__'] === 'PlTreeNodeAccessor');
+}
+/** Main entry point for using PlTree in reactive setting */
+class PlTreeEntry {
+    accessorData;
+    rid;
+    __pl_tree_type_marker__ = 'PlTreeEntry';
+    constructor(accessorData, rid) {
+        this.accessorData = accessorData;
+        this.rid = rid;
+    }
+    createAccessor(ctx, guard) {
+        return new PlTreeEntryAccessor(this.accessorData, this.accessorData.treeProvider(), this.rid, {
+            ctx,
+            guard,
+        });
+    }
+    toJSON() {
+        return this.toString();
+    }
+    toString() {
+        return `[ENTRY:${resourceIdToString(this.rid)}]`;
+    }
+}
+function getResourceFromTree(accessorData, tree, instanceData, rid, ops) {
+    const acc = new PlTreeNodeAccessor(accessorData, tree, tree.get(instanceData.ctx.watcher, rid), instanceData);
+    if (!ops.ignoreError) {
+        const err = acc.getError();
+        if (err !== undefined)
+            throw parsePlError(notEmpty(err.getDataAsString()), acc.id, acc.resourceType);
+    }
+    if (ops.assertResourceType !== undefined
+        && (Array.isArray(ops.assertResourceType)
+            ? ops.assertResourceType.findIndex((rt) => resourceTypesEqual(rt, acc.resourceType)) === -1
+            : !resourceTypesEqual(ops.assertResourceType, acc.resourceType)))
+        throw new Error(
+        // eslint-disable-next-line @typescript-eslint/no-base-to-string
+        `wrong resource type ${resourceTypeToString(acc.resourceType)} but expected ${ops.assertResourceType}`);
+    return acc;
+}
+class PlTreeEntryAccessor {
+    accessorData;
+    tree;
+    rid;
+    instanceData;
+    __pl_tree_type_marker__ = 'PlTreeEntryAccessor';
+    constructor(accessorData, tree, rid, instanceData) {
+        this.accessorData = accessorData;
+        this.tree = tree;
+        this.rid = rid;
+        this.instanceData = instanceData;
+    }
+    node(ops = {}) {
+        this.instanceData.guard();
+        // this is the only entry point to acquire a PlTreeNodeAccessor,
+        // so this is the only point where we should attach the hooks
+        if (this.accessorData.hooks !== undefined)
+            this.instanceData.ctx.attacheHooks(this.accessorData.hooks);
+        return getResourceFromTree(this.accessorData, this.tree, this.instanceData, this.rid, ops);
+    }
+}
+/**
+ * Can be called only when a ctx is provided, because pl tree entry is a computable entity.
+ * @deprecated
+ * */
+function treeEntryToResourceInfo(res, ctx) {
+    if (res instanceof PlTreeEntry)
+        return ctx.accessor(res).node().resourceInfo;
+    return res;
+}
+/**
+ * API contracts:
+ *   - API never return {@link NullResourceId}, absence of link is always modeled as `undefined`
+ *
+ * Important: never store instances of this class, always get fresh instance from {@link PlTreeState} accessor.
+ * */
+class PlTreeNodeAccessor {
+    accessorData;
+    tree;
+    resource;
+    instanceData;
+    __pl_tree_type_marker__ = 'PlTreeNodeAccessor';
+    constructor(accessorData, tree, resource, instanceData) {
+        this.accessorData = accessorData;
+        this.tree = tree;
+        this.resource = resource;
+        this.instanceData = instanceData;
+    }
+    get id() {
+        this.instanceData.guard();
+        return this.resource.id;
+    }
+    get originalId() {
+        this.instanceData.guard();
+        return this.resource.originalResourceId;
+    }
+    get resourceType() {
+        this.instanceData.guard();
+        return this.resource.type;
+    }
+    get resourceInfo() {
+        return { id: this.id, type: this.resourceType };
+    }
+    getResourceFromTree(rid, ops) {
+        return getResourceFromTree(this.accessorData, this.tree, this.instanceData, rid, ops);
+    }
+    traverse(...steps) {
+        return this.traverseWithCommon({}, ...steps);
+    }
+    traverseOrError(...steps) {
+        return this.traverseOrErrorWithCommon({}, ...steps);
+    }
+    traverseWithCommon(commonOptions, ...steps) {
+        const result = this.traverseOrErrorWithCommon(commonOptions, ...steps);
+        if (result === undefined)
+            return undefined;
+        if (!result.ok)
+            throw result.error;
+        return result.value;
+    }
+    traverseOrErrorWithCommon(commonOptions, ...steps) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        let current = this;
+        for (const _step of steps) {
+            const step = typeof _step === 'string'
+                ? {
+                    ...commonOptions,
+                    field: _step,
+                }
+                : { ...commonOptions, ..._step };
+            const next = current.getField(_step);
+            if (next === undefined)
+                return undefined;
+            if (step.pureFieldErrorToUndefined && next.value === undefined && next.error !== undefined)
+                return undefined;
+            if ((!step.ignoreError || next.value === undefined) && next.error !== undefined)
+                return {
+                    ok: false,
+                    // FIXME: in next tickets we'll allow Errors to be thrown.
+                    error: parsePlError(notEmpty(next.error.getDataAsString()), current.id, current.resourceType, step.field),
+                };
+            if (next.value === undefined) {
+                if (step.errorIfFieldNotSet)
+                    return {
+                        ok: false,
+                        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);
+                return undefined;
+            }
+            current = next.value;
+        }
+        return { ok: true, value: current };
+    }
+    onUnstableLambda = (marker) => {
+        this.instanceData.ctx.markUnstable(marker);
+    };
+    getField(_step) {
+        this.instanceData.guard();
+        const step = typeof _step === 'string' ? { field: _step } : _step;
+        const ve = this.resource.getField(this.instanceData.ctx.watcher, step, this.onUnstableLambda);
+        if (ve === undefined)
+            return undefined;
+        return mapValueAndError(ve, (rid) => this.getResourceFromTree(rid, { ignoreError: true }));
+    }
+    getInputsLocked() {
+        this.instanceData.guard();
+        const result = this.resource.getInputsLocked(this.instanceData.ctx.watcher);
+        if (!result)
+            this.instanceData.ctx.markUnstable('inputs_unlocked:' + this.resourceType.name);
+        return result;
+    }
+    getOutputsLocked() {
+        this.instanceData.guard();
+        const result = this.resource.getOutputsLocked(this.instanceData.ctx.watcher);
+        if (!result)
+            this.instanceData.ctx.markUnstable('outputs_unlocked:' + this.resourceType.name);
+        return result;
+    }
+    getIsReadyOrError() {
+        this.instanceData.guard();
+        const result = this.resource.getIsReadyOrError(this.instanceData.ctx.watcher);
+        if (!result)
+            this.instanceData.ctx.markUnstable('not_ready:' + this.resourceType.name);
+        return result;
+    }
+    getIsFinal() {
+        this.instanceData.guard();
+        return this.resource.getIsFinal(this.instanceData.ctx.watcher);
+    }
+    getError() {
+        this.instanceData.guard();
+        const rid = this.resource.getError(this.instanceData.ctx.watcher);
+        if (rid === undefined)
+            // absence of error always considered as stable
+            return undefined;
+        return this.getResourceFromTree(rid, {});
+    }
+    getData() {
+        return this.resource.data;
+    }
+    getDataAsString() {
+        return this.resource.getDataAsString();
+    }
+    getDataAsJson() {
+        return this.resource.getDataAsJson();
+    }
+    listInputFields() {
+        this.instanceData.guard();
+        this.getInputsLocked(); // will set unstable if not locked
+        return this.resource.listInputFields(this.instanceData.ctx.watcher);
+    }
+    listOutputFields() {
+        this.instanceData.guard();
+        this.getOutputsLocked(); // will set unstable if not locked
+        return this.resource.listOutputFields(this.instanceData.ctx.watcher);
+    }
+    listDynamicFields() {
+        this.instanceData.guard();
+        return this.resource.listDynamicFields(this.instanceData.ctx.watcher);
+    }
+    getKeyValue(key, unstableIfNotFound = false) {
+        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);
+        return result;
+    }
+    /** @deprecated */
+    getKeyValueString(key) {
+        return this.getKeyValueAsString(key);
+    }
+    getKeyValueAsString(key, unstableIfNotFound = false) {
+        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);
+        return result;
+    }
+    getKeyValueAsJson(key, unstableIfNotFound = false) {
+        const result = this.resource.getKeyValueAsJson(this.instanceData.ctx.watcher, key);
+        if (result === undefined) {
+            if (unstableIfNotFound)
+                this.instanceData.ctx.markUnstable('key_not_found_j:' + key);
+            return undefined;
+        }
+        return result;
+    }
+    /**
+     * Can be used to pass a higher level accessor that will wrap the resource and throw its
+     * errors on node resolution.
+     * */
+    toEntryAccessor() {
+        return new PlTreeEntryAccessor(this.accessorData, this.tree, this.id, this.instanceData);
+    }
+    /** Can be passed to nested computable. */
+    persist() {
+        return new PlTreeEntry(this.accessorData, this.resource.id);
+    }
+}
+
+export { PlError, PlTreeEntry, PlTreeEntryAccessor, PlTreeNodeAccessor, isPlTreeEntry, isPlTreeEntryAccessor, isPlTreeNodeAccessor, treeEntryToResourceInfo };
+//# sourceMappingURL=accessors.js.map