@milaboratories/pl-client 2.11.8 → 2.11.10

package/dist/helpers/poll.cjs

@@ -0,0 +1,148 @@
+'use strict';
+
+var tsHelpers = require('@milaboratories/ts-helpers');
+var types = require('../core/types.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);
+
+/** This error tells state assertion mechanism that required state is not yet ready */
+class ContinuePolling extends Error {
+    name = 'ContinuePolling';
+}
+const DefaultPollFieldTraverseOps = {
+    failOnError: true,
+    onlyFinal: false,
+};
+class PollResourceAccessor {
+    tx;
+    data;
+    path;
+    constructor(tx, data, path) {
+        this.tx = tx;
+        this.data = data;
+        this.path = path;
+    }
+    final() {
+        if (!this.data.final)
+            throw new ContinuePolling();
+        return this;
+    }
+    async requireNoError() {
+        if (types.isNullResourceId(this.data.error))
+            return this;
+        await this.tx.throwError(this.data.error, this.path);
+        // hmm... https://github.com/microsoft/TypeScript/issues/34955
+        return this;
+    }
+    getFieldData(name, expectedType) {
+        const fieldData = this.data.fields.find((f) => f.name === name);
+        if (fieldData !== undefined) {
+            if (expectedType !== undefined && fieldData.type !== expectedType)
+                throw new Error(`Unexpected field type. Expected ${expectedType}, found ${fieldData.type}`);
+            return fieldData;
+        }
+        if (((expectedType === 'Input' || expectedType === 'Service') && this.data.inputsLocked)
+            || (expectedType === 'Output' && this.data.outputsLocked))
+            throw new Error(
+            // eslint-disable-next-line @typescript-eslint/no-base-to-string, @typescript-eslint/restrict-template-expressions
+            `Field "${name}" not found. Expected type: ${expectedType}, state: ${this.data}`);
+        throw new ContinuePolling();
+    }
+    async get(name, ops = {}) {
+        const { expectedType, failOnError } = { ...DefaultPollFieldTraverseOps, ...ops };
+        const path = [...this.path, name];
+        const fieldData = this.getFieldData(name, expectedType);
+        if (types.isNotNullResourceId(fieldData.error) && (failOnError || types.isNullResourceId(fieldData.value)))
+            await this.tx.throwError(fieldData.error, path);
+        if (types.isNullResourceId(fieldData.value))
+            throw new ContinuePolling();
+        return await this.tx.get(fieldData.value, failOnError, path);
+    }
+    async getMulti(ops, ...names) {
+        return await Promise.all(names.map((name) => this.get(name, ops)));
+    }
+    async getMultiObj(ops, ...names) {
+        return Object.fromEntries(await Promise.all(names.map(async (name) => [name, await this.get(name, ops)])));
+    }
+    async getAllFinal(ops = {}) {
+        return await this.getMultiObj(ops, ...this.data.fields
+            .filter((f) => f.valueIsFinal || types.isNotNullResourceId(f.error))
+            .map((f) => f.name));
+    }
+    async getKValue(key) {
+        const value = await this.tx.tx.getKValueStringIfExists(this.data.id, key);
+        if (value === undefined)
+            throw new ContinuePolling();
+        return value;
+    }
+    async getKValueObj(key) {
+        return JSON.parse(await this.getKValue(key));
+    }
+}
+class PollTxAccessor {
+    tx;
+    constructor(tx) {
+        this.tx = tx;
+    }
+    async get(rid, failOnError = true, path = []) {
+        const data = await this.tx.getResourceData(rid, true);
+        const accessor = new PollResourceAccessor(this, data, [...path, types.resourceIdToString(rid)]);
+        if (failOnError)
+            await accessor.requireNoError();
+        return accessor;
+    }
+    async throwError(error, path = []) {
+        const errorRes = await this.get(error);
+        const errorText = Buffer.from(tsHelpers.notEmpty(errorRes.data.data)).toString();
+        throw new Error(`${path.join(' -> ')} = ${errorText}`);
+    }
+}
+const DefaultPollingRetryOptions = {
+    type: 'linearBackoff',
+    jitter: 0,
+    maxAttempts: 100,
+    backoffStep: 10,
+    initialDelay: 10,
+};
+async function poll(cl, cb, retryOptions = DefaultPollingRetryOptions, txName = 'polling') {
+    let retryState = tsHelpers.createRetryState(retryOptions);
+    while (true) {
+        try {
+            return await cl.withReadTx(txName, async (tx) => {
+                return await cb(new PollTxAccessor(tx));
+            });
+        }
+        catch (e) {
+            // Rethrowing any error except the "not ready yet"
+            if (!(e instanceof ContinuePolling))
+                throw e;
+        }
+        await tp__namespace.setTimeout(retryState.nextDelay);
+        retryState = tsHelpers.nextRetryStateOrError(retryState);
+    }
+}
+
+exports.ContinuePolling = ContinuePolling;
+exports.DefaultPollingRetryOptions = DefaultPollingRetryOptions;
+exports.PollResourceAccessor = PollResourceAccessor;
+exports.PollTxAccessor = PollTxAccessor;
+exports.poll = poll;
+//# sourceMappingURL=poll.cjs.map

package/dist/helpers/poll.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.cjs","sources":["../../src/helpers/poll.ts"],"sourcesContent":["import type { PlClient } from '../core/client';\nimport type {\n  RetryOptions,\n} from '@milaboratories/ts-helpers';\nimport {\n  createRetryState,\n  nextRetryStateOrError,\n  notEmpty,\n} from '@milaboratories/ts-helpers';\nimport type {\n  FieldData,\n  FieldType,\n  ResourceData,\n  ResourceId } from '../core/types';\nimport {\n  isNotNullResourceId,\n  isNullResourceId,\n  resourceIdToString,\n} from '../core/types';\nimport type { PlTransaction } from '../core/transaction';\nimport * as tp from 'node:timers/promises';\n\n/** This error tells state assertion mechanism that required state is not yet ready */\nexport class ContinuePolling extends Error {\n  name = 'ContinuePolling';\n}\n\nexport type PollFieldTraverseOps = {\n  expectedType?: FieldType;\n  /** Fail if error present along with the value, if value not present,\n   * but error do, exception will be thrown anyway. */\n  failOnError: boolean;\n  /** Traverse only if field report its value as final. */\n  onlyFinal: boolean;\n};\n\nconst DefaultPollFieldTraverseOps: PollFieldTraverseOps = {\n  failOnError: true,\n  onlyFinal: false,\n};\n\nexport class PollResourceAccessor {\n  constructor(\n    public readonly tx: PollTxAccessor,\n    public readonly data: ResourceData,\n    public readonly path: string[],\n  ) {}\n\n  public final(): PollResourceAccessor {\n    if (!this.data.final) throw new ContinuePolling();\n    return this;\n  }\n\n  public async requireNoError(): Promise<PollResourceAccessor> {\n    if (isNullResourceId(this.data.error)) return this;\n    await this.tx.throwError(this.data.error, this.path);\n    // hmm... https://github.com/microsoft/TypeScript/issues/34955\n    return this;\n  }\n\n  public getFieldData(name: string, expectedType?: FieldType): FieldData {\n    const fieldData = this.data.fields.find((f) => f.name === name);\n\n    if (fieldData !== undefined) {\n      if (expectedType !== undefined && fieldData.type !== expectedType)\n        throw new Error(`Unexpected field type. Expected ${expectedType}, found ${fieldData.type}`);\n      return fieldData;\n    }\n\n    if (\n      ((expectedType === 'Input' || expectedType === 'Service') && this.data.inputsLocked)\n      || (expectedType === 'Output' && this.data.outputsLocked)\n    )\n      throw new Error(\n        // eslint-disable-next-line @typescript-eslint/no-base-to-string, @typescript-eslint/restrict-template-expressions\n        `Field \"${name}\" not found. Expected type: ${expectedType}, state: ${this.data}`,\n      );\n\n    throw new ContinuePolling();\n  }\n\n  public async get(\n    name: string,\n    ops: Partial<PollFieldTraverseOps> = {},\n  ): Promise<PollResourceAccessor> {\n    const { expectedType, failOnError } = { ...DefaultPollFieldTraverseOps, ...ops };\n    const path = [...this.path, name];\n\n    const fieldData = this.getFieldData(name, expectedType);\n    if (isNotNullResourceId(fieldData.error) && (failOnError || isNullResourceId(fieldData.value)))\n      await this.tx.throwError(fieldData.error, path);\n\n    if (isNullResourceId(fieldData.value)) throw new ContinuePolling();\n\n    return await this.tx.get(fieldData.value, failOnError, path);\n  }\n\n  public async getMulti(\n    ops: Partial<PollFieldTraverseOps>,\n    ...names: string[]\n  ): Promise<PollResourceAccessor[]> {\n    return await Promise.all(names.map((name) => this.get(name, ops)));\n  }\n\n  public async getMultiObj<Key extends string>(\n    ops: Partial<PollFieldTraverseOps>,\n    ...names: Key[]\n  ): Promise<Record<Key, PollResourceAccessor>> {\n    return Object.fromEntries(\n      await Promise.all(names.map(async (name) => [name, await this.get(name, ops)])),\n    );\n  }\n\n  public async getAllFinal(\n    ops: Partial<PollFieldTraverseOps> = {},\n  ): Promise<Record<string, PollResourceAccessor>> {\n    return await this.getMultiObj(\n      ops,\n      ...this.data.fields\n        .filter((f) => f.valueIsFinal || isNotNullResourceId(f.error))\n        .map((f) => f.name),\n    );\n  }\n\n  public async getKValue(key: string): Promise<string> {\n    const value = await this.tx.tx.getKValueStringIfExists(this.data.id, key);\n    if (value === undefined) throw new ContinuePolling();\n    return value;\n  }\n\n  public async getKValueObj<T>(key: string): Promise<T> {\n    return JSON.parse(await this.getKValue(key)) as T;\n  }\n}\n\nexport class PollTxAccessor {\n  constructor(public readonly tx: PlTransaction) {}\n\n  public async get(\n    rid: ResourceId,\n    failOnError: boolean = true,\n    path: string[] = [],\n  ): Promise<PollResourceAccessor> {\n    const data = await this.tx.getResourceData(rid, true);\n    const accessor = new PollResourceAccessor(this, data, [...path, resourceIdToString(rid)]);\n    if (failOnError) await accessor.requireNoError();\n    return accessor;\n  }\n\n  async throwError(error: ResourceId, path: string[] = []): Promise<never> {\n    const errorRes = await this.get(error);\n    const errorText = Buffer.from(notEmpty(errorRes.data.data)).toString();\n    throw new Error(`${path.join(' -> ')} = ${errorText}`);\n  }\n}\n\nexport const DefaultPollingRetryOptions: RetryOptions = {\n  type: 'linearBackoff',\n  jitter: 0,\n  maxAttempts: 100,\n  backoffStep: 10,\n  initialDelay: 10,\n};\n\nexport async function poll<T>(\n  cl: PlClient,\n  cb: (tx: PollTxAccessor) => Promise<T>,\n  retryOptions: RetryOptions = DefaultPollingRetryOptions,\n  txName: string = 'polling',\n): Promise<T> {\n  let retryState = createRetryState(retryOptions);\n  while (true) {\n    try {\n      return await cl.withReadTx(txName, async (tx) => {\n        return await cb(new PollTxAccessor(tx));\n      });\n    } catch (e: any) {\n      // Rethrowing any error except the \"not ready yet\"\n      if (!(e instanceof ContinuePolling)) throw e;\n    }\n    await tp.setTimeout(retryState.nextDelay);\n    retryState = nextRetryStateOrError(retryState);\n  }\n}\n"],"names":["isNullResourceId","isNotNullResourceId","resourceIdToString","notEmpty","createRetryState","tp","nextRetryStateOrError"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAsBA;AACM,MAAO,eAAgB,SAAQ,KAAK,CAAA;IACxC,IAAI,GAAG,iBAAiB;AACzB;AAWD,MAAM,2BAA2B,GAAyB;AACxD,IAAA,WAAW,EAAE,IAAI;AACjB,IAAA,SAAS,EAAE,KAAK;CACjB;MAEY,oBAAoB,CAAA;AAEb,IAAA,EAAA;AACA,IAAA,IAAA;AACA,IAAA,IAAA;AAHlB,IAAA,WAAA,CACkB,EAAkB,EAClB,IAAkB,EAClB,IAAc,EAAA;QAFd,IAAA,CAAA,EAAE,GAAF,EAAE;QACF,IAAA,CAAA,IAAI,GAAJ,IAAI;QACJ,IAAA,CAAA,IAAI,GAAJ,IAAI;IACnB;IAEI,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,eAAe,EAAE;AACjD,QAAA,OAAO,IAAI;IACb;AAEO,IAAA,MAAM,cAAc,GAAA;AACzB,QAAA,IAAIA,sBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;AAAE,YAAA,OAAO,IAAI;AAClD,QAAA,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;;AAEpD,QAAA,OAAO,IAAI;IACb;IAEO,YAAY,CAAC,IAAY,EAAE,YAAwB,EAAA;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;AAE/D,QAAA,IAAI,SAAS,KAAK,SAAS,EAAE;YAC3B,IAAI,YAAY,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY;gBAC/D,MAAM,IAAI,KAAK,CAAC,CAAA,gCAAA,EAAmC,YAAY,CAAA,QAAA,EAAW,SAAS,CAAC,IAAI,CAAA,CAAE,CAAC;AAC7F,YAAA,OAAO,SAAS;QAClB;AAEA,QAAA,IACE,CAAC,CAAC,YAAY,KAAK,OAAO,IAAI,YAAY,KAAK,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY;gBAC/E,YAAY,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;AAEzD,YAAA,MAAM,IAAI,KAAK;;YAEb,CAAA,OAAA,EAAU,IAAI,+BAA+B,YAAY,CAAA,SAAA,EAAY,IAAI,CAAC,IAAI,CAAA,CAAE,CACjF;QAEH,MAAM,IAAI,eAAe,EAAE;IAC7B;AAEO,IAAA,MAAM,GAAG,CACd,IAAY,EACZ,MAAqC,EAAE,EAAA;AAEvC,QAAA,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,2BAA2B,EAAE,GAAG,GAAG,EAAE;QAChF,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC;AACvD,QAAA,IAAIC,yBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,WAAW,IAAID,sBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC5F,YAAA,MAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC;AAEjD,QAAA,IAAIA,sBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,eAAe,EAAE;AAElE,QAAA,OAAO,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC;IAC9D;AAEO,IAAA,MAAM,QAAQ,CACnB,GAAkC,EAClC,GAAG,KAAe,EAAA;QAElB,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACpE;AAEO,IAAA,MAAM,WAAW,CACtB,GAAkC,EAClC,GAAG,KAAY,EAAA;AAEf,QAAA,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAChF;IACH;AAEO,IAAA,MAAM,WAAW,CACtB,GAAA,GAAqC,EAAE,EAAA;AAEvC,QAAA,OAAO,MAAM,IAAI,CAAC,WAAW,CAC3B,GAAG,EACH,GAAG,IAAI,CAAC,IAAI,CAAC;AACV,aAAA,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,YAAY,IAAIC,yBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC;aAC5D,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CACtB;IACH;IAEO,MAAM,SAAS,CAAC,GAAW,EAAA;AAChC,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC;QACzE,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,eAAe,EAAE;AACpD,QAAA,OAAO,KAAK;IACd;IAEO,MAAM,YAAY,CAAI,GAAW,EAAA;AACtC,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAM;IACnD;AACD;MAEY,cAAc,CAAA;AACG,IAAA,EAAA;AAA5B,IAAA,WAAA,CAA4B,EAAiB,EAAA;QAAjB,IAAA,CAAA,EAAE,GAAF,EAAE;IAAkB;IAEzC,MAAM,GAAG,CACd,GAAe,EACf,WAAA,GAAuB,IAAI,EAC3B,IAAA,GAAiB,EAAE,EAAA;AAEnB,QAAA,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC;AACrD,QAAA,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAEC,wBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;AACzF,QAAA,IAAI,WAAW;AAAE,YAAA,MAAM,QAAQ,CAAC,cAAc,EAAE;AAChD,QAAA,OAAO,QAAQ;IACjB;AAEA,IAAA,MAAM,UAAU,CAAC,KAAiB,EAAE,OAAiB,EAAE,EAAA;QACrD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AACtC,QAAA,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAACC,kBAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;AACtE,QAAA,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA,GAAA,EAAM,SAAS,CAAA,CAAE,CAAC;IACxD;AACD;AAEM,MAAM,0BAA0B,GAAiB;AACtD,IAAA,IAAI,EAAE,eAAe;AACrB,IAAA,MAAM,EAAE,CAAC;AACT,IAAA,WAAW,EAAE,GAAG;AAChB,IAAA,WAAW,EAAE,EAAE;AACf,IAAA,YAAY,EAAE,EAAE;;AAGX,eAAe,IAAI,CACxB,EAAY,EACZ,EAAsC,EACtC,YAAA,GAA6B,0BAA0B,EACvD,SAAiB,SAAS,EAAA;AAE1B,IAAA,IAAI,UAAU,GAAGC,0BAAgB,CAAC,YAAY,CAAC;IAC/C,OAAO,IAAI,EAAE;AACX,QAAA,IAAI;YACF,OAAO,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,KAAI;gBAC9C,OAAO,MAAM,EAAE,CAAC,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;AACzC,YAAA,CAAC,CAAC;QACJ;QAAE,OAAO,CAAM,EAAE;;AAEf,YAAA,IAAI,EAAE,CAAC,YAAY,eAAe,CAAC;AAAE,gBAAA,MAAM,CAAC;QAC9C;QACA,MAAMC,aAAE,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC;AACzC,QAAA,UAAU,GAAGC,+BAAqB,CAAC,UAAU,CAAC;IAChD;AACF;;;;;;;;"}

package/dist/helpers/poll.d.ts

@@ -1,7 +1,7 @@
-import { PlClient } from '../core/client';
-import { RetryOptions } from '@milaboratories/ts-helpers';
-import { FieldData, FieldType, ResourceData, ResourceId } from '../core/types';
-import { PlTransaction } from '../core/transaction';
+import type { PlClient } from '../core/client';
+import type { RetryOptions } from '@milaboratories/ts-helpers';
+import type { FieldData, FieldType, ResourceData, ResourceId } from '../core/types';
+import type { PlTransaction } from '../core/transaction';
 /** This error tells state assertion mechanism that required state is not yet ready */
 export declare class ContinuePolling extends Error {
     name: string;

package/dist/helpers/poll.js

@@ -0,0 +1,123 @@
+import { notEmpty, createRetryState, nextRetryStateOrError } from '@milaboratories/ts-helpers';
+import { isNullResourceId, isNotNullResourceId, resourceIdToString } from '../core/types.js';
+import * as tp from 'node:timers/promises';
+
+/** This error tells state assertion mechanism that required state is not yet ready */
+class ContinuePolling extends Error {
+    name = 'ContinuePolling';
+}
+const DefaultPollFieldTraverseOps = {
+    failOnError: true,
+    onlyFinal: false,
+};
+class PollResourceAccessor {
+    tx;
+    data;
+    path;
+    constructor(tx, data, path) {
+        this.tx = tx;
+        this.data = data;
+        this.path = path;
+    }
+    final() {
+        if (!this.data.final)
+            throw new ContinuePolling();
+        return this;
+    }
+    async requireNoError() {
+        if (isNullResourceId(this.data.error))
+            return this;
+        await this.tx.throwError(this.data.error, this.path);
+        // hmm... https://github.com/microsoft/TypeScript/issues/34955
+        return this;
+    }
+    getFieldData(name, expectedType) {
+        const fieldData = this.data.fields.find((f) => f.name === name);
+        if (fieldData !== undefined) {
+            if (expectedType !== undefined && fieldData.type !== expectedType)
+                throw new Error(`Unexpected field type. Expected ${expectedType}, found ${fieldData.type}`);
+            return fieldData;
+        }
+        if (((expectedType === 'Input' || expectedType === 'Service') && this.data.inputsLocked)
+            || (expectedType === 'Output' && this.data.outputsLocked))
+            throw new Error(
+            // eslint-disable-next-line @typescript-eslint/no-base-to-string, @typescript-eslint/restrict-template-expressions
+            `Field "${name}" not found. Expected type: ${expectedType}, state: ${this.data}`);
+        throw new ContinuePolling();
+    }
+    async get(name, ops = {}) {
+        const { expectedType, failOnError } = { ...DefaultPollFieldTraverseOps, ...ops };
+        const path = [...this.path, name];
+        const fieldData = this.getFieldData(name, expectedType);
+        if (isNotNullResourceId(fieldData.error) && (failOnError || isNullResourceId(fieldData.value)))
+            await this.tx.throwError(fieldData.error, path);
+        if (isNullResourceId(fieldData.value))
+            throw new ContinuePolling();
+        return await this.tx.get(fieldData.value, failOnError, path);
+    }
+    async getMulti(ops, ...names) {
+        return await Promise.all(names.map((name) => this.get(name, ops)));
+    }
+    async getMultiObj(ops, ...names) {
+        return Object.fromEntries(await Promise.all(names.map(async (name) => [name, await this.get(name, ops)])));
+    }
+    async getAllFinal(ops = {}) {
+        return await this.getMultiObj(ops, ...this.data.fields
+            .filter((f) => f.valueIsFinal || isNotNullResourceId(f.error))
+            .map((f) => f.name));
+    }
+    async getKValue(key) {
+        const value = await this.tx.tx.getKValueStringIfExists(this.data.id, key);
+        if (value === undefined)
+            throw new ContinuePolling();
+        return value;
+    }
+    async getKValueObj(key) {
+        return JSON.parse(await this.getKValue(key));
+    }
+}
+class PollTxAccessor {
+    tx;
+    constructor(tx) {
+        this.tx = tx;
+    }
+    async get(rid, failOnError = true, path = []) {
+        const data = await this.tx.getResourceData(rid, true);
+        const accessor = new PollResourceAccessor(this, data, [...path, resourceIdToString(rid)]);
+        if (failOnError)
+            await accessor.requireNoError();
+        return accessor;
+    }
+    async throwError(error, path = []) {
+        const errorRes = await this.get(error);
+        const errorText = Buffer.from(notEmpty(errorRes.data.data)).toString();
+        throw new Error(`${path.join(' -> ')} = ${errorText}`);
+    }
+}
+const DefaultPollingRetryOptions = {
+    type: 'linearBackoff',
+    jitter: 0,
+    maxAttempts: 100,
+    backoffStep: 10,
+    initialDelay: 10,
+};
+async function poll(cl, cb, retryOptions = DefaultPollingRetryOptions, txName = 'polling') {
+    let retryState = createRetryState(retryOptions);
+    while (true) {
+        try {
+            return await cl.withReadTx(txName, async (tx) => {
+                return await cb(new PollTxAccessor(tx));
+            });
+        }
+        catch (e) {
+            // Rethrowing any error except the "not ready yet"
+            if (!(e instanceof ContinuePolling))
+                throw e;
+        }
+        await tp.setTimeout(retryState.nextDelay);
+        retryState = nextRetryStateOrError(retryState);
+    }
+}
+
+export { ContinuePolling, DefaultPollingRetryOptions, PollResourceAccessor, PollTxAccessor, poll };
+//# sourceMappingURL=poll.js.map

package/dist/helpers/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sources":["../../src/helpers/poll.ts"],"sourcesContent":["import type { PlClient } from '../core/client';\nimport type {\n  RetryOptions,\n} from '@milaboratories/ts-helpers';\nimport {\n  createRetryState,\n  nextRetryStateOrError,\n  notEmpty,\n} from '@milaboratories/ts-helpers';\nimport type {\n  FieldData,\n  FieldType,\n  ResourceData,\n  ResourceId } from '../core/types';\nimport {\n  isNotNullResourceId,\n  isNullResourceId,\n  resourceIdToString,\n} from '../core/types';\nimport type { PlTransaction } from '../core/transaction';\nimport * as tp from 'node:timers/promises';\n\n/** This error tells state assertion mechanism that required state is not yet ready */\nexport class ContinuePolling extends Error {\n  name = 'ContinuePolling';\n}\n\nexport type PollFieldTraverseOps = {\n  expectedType?: FieldType;\n  /** Fail if error present along with the value, if value not present,\n   * but error do, exception will be thrown anyway. */\n  failOnError: boolean;\n  /** Traverse only if field report its value as final. */\n  onlyFinal: boolean;\n};\n\nconst DefaultPollFieldTraverseOps: PollFieldTraverseOps = {\n  failOnError: true,\n  onlyFinal: false,\n};\n\nexport class PollResourceAccessor {\n  constructor(\n    public readonly tx: PollTxAccessor,\n    public readonly data: ResourceData,\n    public readonly path: string[],\n  ) {}\n\n  public final(): PollResourceAccessor {\n    if (!this.data.final) throw new ContinuePolling();\n    return this;\n  }\n\n  public async requireNoError(): Promise<PollResourceAccessor> {\n    if (isNullResourceId(this.data.error)) return this;\n    await this.tx.throwError(this.data.error, this.path);\n    // hmm... https://github.com/microsoft/TypeScript/issues/34955\n    return this;\n  }\n\n  public getFieldData(name: string, expectedType?: FieldType): FieldData {\n    const fieldData = this.data.fields.find((f) => f.name === name);\n\n    if (fieldData !== undefined) {\n      if (expectedType !== undefined && fieldData.type !== expectedType)\n        throw new Error(`Unexpected field type. Expected ${expectedType}, found ${fieldData.type}`);\n      return fieldData;\n    }\n\n    if (\n      ((expectedType === 'Input' || expectedType === 'Service') && this.data.inputsLocked)\n      || (expectedType === 'Output' && this.data.outputsLocked)\n    )\n      throw new Error(\n        // eslint-disable-next-line @typescript-eslint/no-base-to-string, @typescript-eslint/restrict-template-expressions\n        `Field \"${name}\" not found. Expected type: ${expectedType}, state: ${this.data}`,\n      );\n\n    throw new ContinuePolling();\n  }\n\n  public async get(\n    name: string,\n    ops: Partial<PollFieldTraverseOps> = {},\n  ): Promise<PollResourceAccessor> {\n    const { expectedType, failOnError } = { ...DefaultPollFieldTraverseOps, ...ops };\n    const path = [...this.path, name];\n\n    const fieldData = this.getFieldData(name, expectedType);\n    if (isNotNullResourceId(fieldData.error) && (failOnError || isNullResourceId(fieldData.value)))\n      await this.tx.throwError(fieldData.error, path);\n\n    if (isNullResourceId(fieldData.value)) throw new ContinuePolling();\n\n    return await this.tx.get(fieldData.value, failOnError, path);\n  }\n\n  public async getMulti(\n    ops: Partial<PollFieldTraverseOps>,\n    ...names: string[]\n  ): Promise<PollResourceAccessor[]> {\n    return await Promise.all(names.map((name) => this.get(name, ops)));\n  }\n\n  public async getMultiObj<Key extends string>(\n    ops: Partial<PollFieldTraverseOps>,\n    ...names: Key[]\n  ): Promise<Record<Key, PollResourceAccessor>> {\n    return Object.fromEntries(\n      await Promise.all(names.map(async (name) => [name, await this.get(name, ops)])),\n    );\n  }\n\n  public async getAllFinal(\n    ops: Partial<PollFieldTraverseOps> = {},\n  ): Promise<Record<string, PollResourceAccessor>> {\n    return await this.getMultiObj(\n      ops,\n      ...this.data.fields\n        .filter((f) => f.valueIsFinal || isNotNullResourceId(f.error))\n        .map((f) => f.name),\n    );\n  }\n\n  public async getKValue(key: string): Promise<string> {\n    const value = await this.tx.tx.getKValueStringIfExists(this.data.id, key);\n    if (value === undefined) throw new ContinuePolling();\n    return value;\n  }\n\n  public async getKValueObj<T>(key: string): Promise<T> {\n    return JSON.parse(await this.getKValue(key)) as T;\n  }\n}\n\nexport class PollTxAccessor {\n  constructor(public readonly tx: PlTransaction) {}\n\n  public async get(\n    rid: ResourceId,\n    failOnError: boolean = true,\n    path: string[] = [],\n  ): Promise<PollResourceAccessor> {\n    const data = await this.tx.getResourceData(rid, true);\n    const accessor = new PollResourceAccessor(this, data, [...path, resourceIdToString(rid)]);\n    if (failOnError) await accessor.requireNoError();\n    return accessor;\n  }\n\n  async throwError(error: ResourceId, path: string[] = []): Promise<never> {\n    const errorRes = await this.get(error);\n    const errorText = Buffer.from(notEmpty(errorRes.data.data)).toString();\n    throw new Error(`${path.join(' -> ')} = ${errorText}`);\n  }\n}\n\nexport const DefaultPollingRetryOptions: RetryOptions = {\n  type: 'linearBackoff',\n  jitter: 0,\n  maxAttempts: 100,\n  backoffStep: 10,\n  initialDelay: 10,\n};\n\nexport async function poll<T>(\n  cl: PlClient,\n  cb: (tx: PollTxAccessor) => Promise<T>,\n  retryOptions: RetryOptions = DefaultPollingRetryOptions,\n  txName: string = 'polling',\n): Promise<T> {\n  let retryState = createRetryState(retryOptions);\n  while (true) {\n    try {\n      return await cl.withReadTx(txName, async (tx) => {\n        return await cb(new PollTxAccessor(tx));\n      });\n    } catch (e: any) {\n      // Rethrowing any error except the \"not ready yet\"\n      if (!(e instanceof ContinuePolling)) throw e;\n    }\n    await tp.setTimeout(retryState.nextDelay);\n    retryState = nextRetryStateOrError(retryState);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/helpers/rich_resource_types.d.ts

@@ -1 +1,2 @@
+export {};
 //# sourceMappingURL=rich_resource_types.d.ts.map

package/dist/helpers/smart_accessors.d.ts

@@ -1 +1,2 @@
+export {};
 //# sourceMappingURL=smart_accessors.d.ts.map

package/dist/helpers/state_helpers.d.ts

@@ -1,3 +1,3 @@
-import { FieldData } from '../core/types';
+import type { FieldData } from '../core/types';
 export declare function fieldResolved(data: Pick<FieldData, 'value' | 'error'>): boolean;
 //# sourceMappingURL=state_helpers.d.ts.map

package/dist/helpers/tx_helpers.cjs

@@ -0,0 +1,25 @@
+'use strict';
+
+var types = require('../core/types.cjs');
+var tsHelpers = require('@milaboratories/ts-helpers');
+
+async function valErr(tx, f) {
+    const result = {
+        valueId: f.value,
+        errorId: f.error,
+        error: '',
+    };
+    if (types.isNotNullResourceId(f.error)) {
+        const e = await tx.getResourceData(f.error, true);
+        const deserializationResult = tsHelpers.cachedDeserialize(tsHelpers.notEmpty(e.data));
+        if (typeof deserializationResult !== 'string') {
+            const dataStr = tsHelpers.notEmpty(e.data).toString();
+            throw new Error(`Unexpected error structure: ${dataStr.substring(0, Math.min(dataStr.length, 100))}...`);
+        }
+        result.error = deserializationResult;
+    }
+    return result;
+}
+
+exports.valErr = valErr;
+//# sourceMappingURL=tx_helpers.cjs.map

package/dist/helpers/tx_helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx_helpers.cjs","sources":["../../src/helpers/tx_helpers.ts"],"sourcesContent":["import type { PlTransaction } from '../core/transaction';\nimport type { FieldData, OptionalResourceId } from '../core/types';\nimport { isNotNullResourceId } from '../core/types';\nimport { cachedDeserialize, notEmpty } from '@milaboratories/ts-helpers';\n\nexport interface ValErr {\n  valueId: OptionalResourceId;\n  errorId: OptionalResourceId;\n  error?: string;\n}\n\nexport async function valErr(tx: PlTransaction, f: FieldData): Promise<ValErr> {\n  const result = {\n    valueId: f.value,\n    errorId: f.error,\n    error: '',\n  };\n\n  if (isNotNullResourceId(f.error)) {\n    const e = await tx.getResourceData(f.error, true);\n    const deserializationResult = cachedDeserialize(notEmpty(e.data));\n    if (typeof deserializationResult !== 'string') {\n      const dataStr = notEmpty(e.data).toString();\n      throw new Error(`Unexpected error structure: ${dataStr.substring(0, Math.min(dataStr.length, 100))}...`);\n    }\n    result.error = deserializationResult;\n  }\n\n  return result;\n}\n"],"names":["isNotNullResourceId","cachedDeserialize","notEmpty"],"mappings":";;;;;AAWO,eAAe,MAAM,CAAC,EAAiB,EAAE,CAAY,EAAA;AAC1D,IAAA,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,CAAC,CAAC,KAAK;QAChB,OAAO,EAAE,CAAC,CAAC,KAAK;AAChB,QAAA,KAAK,EAAE,EAAE;KACV;AAED,IAAA,IAAIA,yBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;AAChC,QAAA,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC;QACjD,MAAM,qBAAqB,GAAGC,2BAAiB,CAACC,kBAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACjE,QAAA,IAAI,OAAO,qBAAqB,KAAK,QAAQ,EAAE;YAC7C,MAAM,OAAO,GAAGA,kBAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;YAC3C,MAAM,IAAI,KAAK,CAAC,CAAA,4BAAA,EAA+B,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA,GAAA,CAAK,CAAC;QAC1G;AACA,QAAA,MAAM,CAAC,KAAK,GAAG,qBAAqB;IACtC;AAEA,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/helpers/tx_helpers.d.ts

@@ -1,5 +1,5 @@
-import { PlTransaction } from '../core/transaction';
-import { FieldData, OptionalResourceId } from '../core/types';
+import type { PlTransaction } from '../core/transaction';
+import type { FieldData, OptionalResourceId } from '../core/types';
 export interface ValErr {
     valueId: OptionalResourceId;
     errorId: OptionalResourceId;

package/dist/helpers/tx_helpers.js

@@ -0,0 +1,23 @@
+import { isNotNullResourceId } from '../core/types.js';
+import { cachedDeserialize, notEmpty } from '@milaboratories/ts-helpers';
+
+async function valErr(tx, f) {
+    const result = {
+        valueId: f.value,
+        errorId: f.error,
+        error: '',
+    };
+    if (isNotNullResourceId(f.error)) {
+        const e = await tx.getResourceData(f.error, true);
+        const deserializationResult = cachedDeserialize(notEmpty(e.data));
+        if (typeof deserializationResult !== 'string') {
+            const dataStr = notEmpty(e.data).toString();
+            throw new Error(`Unexpected error structure: ${dataStr.substring(0, Math.min(dataStr.length, 100))}...`);
+        }
+        result.error = deserializationResult;
+    }
+    return result;
+}
+
+export { valErr };
+//# sourceMappingURL=tx_helpers.js.map

package/dist/helpers/tx_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx_helpers.js","sources":["../../src/helpers/tx_helpers.ts"],"sourcesContent":["import type { PlTransaction } from '../core/transaction';\nimport type { FieldData, OptionalResourceId } from '../core/types';\nimport { isNotNullResourceId } from '../core/types';\nimport { cachedDeserialize, notEmpty } from '@milaboratories/ts-helpers';\n\nexport interface ValErr {\n  valueId: OptionalResourceId;\n  errorId: OptionalResourceId;\n  error?: string;\n}\n\nexport async function valErr(tx: PlTransaction, f: FieldData): Promise<ValErr> {\n  const result = {\n    valueId: f.value,\n    errorId: f.error,\n    error: '',\n  };\n\n  if (isNotNullResourceId(f.error)) {\n    const e = await tx.getResourceData(f.error, true);\n    const deserializationResult = cachedDeserialize(notEmpty(e.data));\n    if (typeof deserializationResult !== 'string') {\n      const dataStr = notEmpty(e.data).toString();\n      throw new Error(`Unexpected error structure: ${dataStr.substring(0, Math.min(dataStr.length, 100))}...`);\n    }\n    result.error = deserializationResult;\n  }\n\n  return result;\n}\n"],"names":[],"mappings":";;;AAWO,eAAe,MAAM,CAAC,EAAiB,EAAE,CAAY,EAAA;AAC1D,IAAA,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,CAAC,CAAC,KAAK;QAChB,OAAO,EAAE,CAAC,CAAC,KAAK;AAChB,QAAA,KAAK,EAAE,EAAE;KACV;AAED,IAAA,IAAI,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;AAChC,QAAA,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC;QACjD,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACjE,QAAA,IAAI,OAAO,qBAAqB,KAAK,QAAQ,EAAE;YAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;YAC3C,MAAM,IAAI,KAAK,CAAC,CAAA,4BAAA,EAA+B,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA,GAAA,CAAK,CAAC;QAC1G;AACA,QAAA,MAAM,CAAC,KAAK,GAAG,qBAAqB;IACtC;AAEA,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/index.cjs

@@ -0,0 +1,99 @@
+'use strict';
+
+var types = require('./core/types.cjs');
+var pl = require('./helpers/pl.cjs');
+var config = require('./core/config.cjs');
+var client = require('./core/client.cjs');
+var driver = require('./core/driver.cjs');
+var transaction = require('./core/transaction.cjs');
+var errors = require('./core/errors.cjs');
+var default_client = require('./core/default_client.cjs');
+var unauth_client = require('./core/unauth_client.cjs');
+var auth = require('./core/auth.cjs');
+var final = require('./core/final.cjs');
+var tx_helpers = require('./helpers/tx_helpers.cjs');
+var poll = require('./helpers/poll.cjs');
+var test_config = require('./test/test_config.cjs');
+
+
+
+exports.MaxLocalId = types.MaxLocalId;
+exports.MaxTxId = types.MaxTxId;
+exports.NullResourceId = types.NullResourceId;
+exports.bigintToResourceId = types.bigintToResourceId;
+exports.checkLocalityOfResourceId = types.checkLocalityOfResourceId;
+exports.createGlobalResourceId = types.createGlobalResourceId;
+exports.createLocalResourceId = types.createLocalResourceId;
+exports.ensureResourceIdNotNull = types.ensureResourceIdNotNull;
+exports.extractBasicResourceData = types.extractBasicResourceData;
+exports.extractTxId = types.extractTxId;
+exports.getField = types.getField;
+exports.isAnyResourceId = types.isAnyResourceId;
+exports.isLocalResourceId = types.isLocalResourceId;
+exports.isNotNullResourceId = types.isNotNullResourceId;
+exports.isNullResourceId = types.isNullResourceId;
+exports.isRootResourceId = types.isRootResourceId;
+exports.jsonToData = types.jsonToData;
+exports.resDataToJson = types.resDataToJson;
+exports.resourceIdFromString = types.resourceIdFromString;
+exports.resourceIdToString = types.resourceIdToString;
+exports.resourceType = types.resourceType;
+exports.resourceTypeToString = types.resourceTypeToString;
+exports.resourceTypesEqual = types.resourceTypesEqual;
+exports.stringifyWithResourceId = types.stringifyWithResourceId;
+exports.Pl = pl;
+exports.AnonymousAuthInformation = config.AnonymousAuthInformation;
+exports.DEFAULT_AUTH_MAX_REFRESH = config.DEFAULT_AUTH_MAX_REFRESH;
+exports.DEFAULT_MAX_CACHE_BYTES = config.DEFAULT_MAX_CACHE_BYTES;
+exports.DEFAULT_REQUEST_TIMEOUT = config.DEFAULT_REQUEST_TIMEOUT;
+exports.DEFAULT_RETRY_BACKOFF_ALGORITHM = config.DEFAULT_RETRY_BACKOFF_ALGORITHM;
+exports.DEFAULT_RETRY_EXPONENTIAL_BACKOFF_MULTIPLIER = config.DEFAULT_RETRY_EXPONENTIAL_BACKOFF_MULTIPLIER;
+exports.DEFAULT_RETRY_INITIAL_DELAY = config.DEFAULT_RETRY_INITIAL_DELAY;
+exports.DEFAULT_RETRY_JITTER = config.DEFAULT_RETRY_JITTER;
+exports.DEFAULT_RETRY_LINEAR_BACKOFF_STEP = config.DEFAULT_RETRY_LINEAR_BACKOFF_STEP;
+exports.DEFAULT_RETRY_MAX_ATTEMPTS = config.DEFAULT_RETRY_MAX_ATTEMPTS;
+exports.DEFAULT_RO_TX_TIMEOUT = config.DEFAULT_RO_TX_TIMEOUT;
+exports.DEFAULT_RW_TX_TIMEOUT = config.DEFAULT_RW_TX_TIMEOUT;
+exports.DEFAULT_TOKEN_TTL_SECONDS = config.DEFAULT_TOKEN_TTL_SECONDS;
+exports.DefaultRetryOptions = config.DefaultRetryOptions;
+exports.plAddressToConfig = config.plAddressToConfig;
+exports.PlClient = client.PlClient;
+exports.addRTypeToMetadata = driver.addRTypeToMetadata;
+exports.PlTransaction = transaction.PlTransaction;
+exports.TxCommitConflict = transaction.TxCommitConflict;
+exports.field = transaction.field;
+exports.isField = transaction.isField;
+exports.isFieldRef = transaction.isFieldRef;
+exports.isResource = transaction.isResource;
+exports.isResourceId = transaction.isResourceId;
+exports.isResourceRef = transaction.isResourceRef;
+exports.toFieldId = transaction.toFieldId;
+exports.toGlobalFieldId = transaction.toGlobalFieldId;
+exports.toGlobalResourceId = transaction.toGlobalResourceId;
+exports.toResourceId = transaction.toResourceId;
+exports.DisconnectedError = errors.DisconnectedError;
+exports.PlError = errors.PlError;
+exports.PlErrorCodeNotFound = errors.PlErrorCodeNotFound;
+exports.RecoverablePlError = errors.RecoverablePlError;
+exports.UnauthenticatedError = errors.UnauthenticatedError;
+exports.UnrecoverablePlError = errors.UnrecoverablePlError;
+exports.isConnectionProblem = errors.isConnectionProblem;
+exports.isNotFoundError = errors.isNotFoundError;
+exports.isTimeoutOrCancelError = errors.isTimeoutOrCancelError;
+exports.isUnauthenticated = errors.isUnauthenticated;
+exports.rethrowMeaningfulError = errors.rethrowMeaningfulError;
+exports.throwPlNotFoundError = errors.throwPlNotFoundError;
+exports.defaultPlClient = default_client.defaultPlClient;
+exports.tryGetFileConfig = default_client.tryGetFileConfig;
+exports.UnauthenticatedPlClient = unauth_client.UnauthenticatedPlClient;
+exports.expirationFromAuthInformation = auth.expirationFromAuthInformation;
+exports.inferAuthRefreshTime = auth.inferAuthRefreshTime;
+exports.DefaultFinalResourceDataPredicate = final.DefaultFinalResourceDataPredicate;
+exports.valErr = tx_helpers.valErr;
+exports.ContinuePolling = poll.ContinuePolling;
+exports.DefaultPollingRetryOptions = poll.DefaultPollingRetryOptions;
+exports.PollResourceAccessor = poll.PollResourceAccessor;
+exports.PollTxAccessor = poll.PollTxAccessor;
+exports.poll = poll.poll;
+exports.TestHelpers = test_config;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}