@milaboratories/pl-client 3.2.4 → 3.3.0

package/dist/core/user_resources.js

@@ -0,0 +1,180 @@
+import { createSignedResourceId, isNotNullSignedResourceId, toResourceSignature } from "./types.js";
+import { isUnimplementedError } from "./errors.js";
+import { toGlobalResourceId } from "./transaction.js";
+import { ClientRoot } from "../helpers/pl.js";
+import { createHash } from "node:crypto";
+//#region src/core/user_resources.ts
+const AnonymousClientRoot = "AnonymousRoot";
+const LsStorageTypePrefix = "LS/";
+const LsProviderFieldPrefix = "storage/";
+/**
+* Abstracts user resource discovery with backward compatibility.
+*
+* Detects backend capability on the first getUserRoot() call and remembers
+* the result. Three-tier fallback:
+* 1. getUserRoot RPC (newest, supports doNotCreate)
+* 2. listUserResources RPC (streams all resources, picks userRoot)
+* 3. Named resource lookup/creation via transaction (legacy)
+*/
+var UserResources = class {
+	backendCapability;
+	constructor(ll, runTx, authUser) {
+		this.ll = ll;
+		this.runTx = runTx;
+		this.authUser = authUser;
+	}
+	async getUserRoot(opts = {}) {
+		if (this.backendCapability === void 0) return await this.detectAndGetUserRoot(opts);
+		return await this.getUserRootWith(this.backendCapability, opts);
+	}
+	async detectAndGetUserRoot(opts = {}) {
+		try {
+			const root = await this.getUserRootViaRpc(opts);
+			this.backendCapability = "getUserRoot";
+			return root;
+		} catch (err) {
+			if (!isUnimplementedError(err)) throw err;
+		}
+		try {
+			const root = await this.getUserRootViaList(opts);
+			this.backendCapability = "listUserResources";
+			return root;
+		} catch (err) {
+			if (!isUnimplementedError(err)) throw err;
+		}
+		this.backendCapability = "legacy";
+		return await this.getUserRootViaLegacy(opts);
+	}
+	async getUserRootWith(capability, opts = {}) {
+		switch (capability) {
+			case "getUserRoot": return await this.getUserRootViaRpc(opts);
+			case "listUserResources": return await this.getUserRootViaList(opts);
+			case "legacy": return await this.getUserRootViaLegacy(opts);
+		}
+	}
+	/**
+	* Returns all data libraries the user has access to.
+	* Always fetches fresh from the server (no caching).
+	*/
+	async getDataLibraries(opts = {}) {
+		if (this.backendCapability === void 0) try {
+			const libs = await this.getDataLibrariesViaList(opts);
+			this.backendCapability = "listUserResources";
+			return libs;
+		} catch (err) {
+			if (!isUnimplementedError(err)) throw err;
+			this.backendCapability = "legacy";
+			return await this.getDataLibrariesViaLegacy();
+		}
+		if (this.backendCapability !== "legacy") return await this.getDataLibrariesViaList(opts);
+		return await this.getDataLibrariesViaLegacy();
+	}
+	async getUserRootViaRpc(opts = {}) {
+		const resp = await this.ll.getUserRoot({
+			login: opts.login,
+			doNotCreate: opts.doNotCreate
+		});
+		if (resp.userRoot === void 0) {
+			if (opts.doNotCreate) return void 0;
+			throw new Error("getUserRoot returned no userRoot entry");
+		}
+		return createSignedResourceId(resp.userRoot.resourceId, toResourceSignature(resp.userRoot.resourceSignature));
+	}
+	async getUserRootViaList(opts = {}) {
+		const responses = await this.ll.listUserResources({
+			login: opts.login,
+			limit: 1
+		});
+		for (const msg of responses) if (msg.entry.oneofKind === "userRoot") return createSignedResourceId(msg.entry.userRoot.resourceId, toResourceSignature(msg.entry.userRoot.resourceSignature));
+		throw new Error("listUserResources returned no userRoot entry");
+	}
+	async getDataLibrariesViaList(opts = {}) {
+		const responses = await this.ll.listUserResources({ login: opts.login });
+		const v1Entries = [];
+		const v2ResourceIds = [];
+		for (const msg of responses) {
+			if (msg.entry.oneofKind !== "sharedResource") continue;
+			const sr = msg.entry.sharedResource;
+			if (!sr.resourceType) continue;
+			const typeName = sr.resourceType.name;
+			const typeVersion = sr.resourceType.version;
+			if (!typeName.startsWith(LsStorageTypePrefix)) continue;
+			const rId = createSignedResourceId(sr.resourceId, toResourceSignature(sr.resourceSignature));
+			const rType = {
+				name: typeName,
+				version: typeVersion
+			};
+			if (typeVersion === "2") v2ResourceIds.push({
+				resourceId: rId,
+				resourceType: rType
+			});
+			else {
+				const storageId = typeName.substring(3);
+				v1Entries.push({
+					storageId,
+					storageName: storageId,
+					resourceId: rId,
+					resourceType: rType
+				});
+			}
+		}
+		let v2Entries = [];
+		if (v2ResourceIds.length > 0) v2Entries = await this.runTx("ReadLsStorageV2Data", false, "", async (tx) => {
+			const entries = [];
+			for (const { resourceId, resourceType } of v2ResourceIds) {
+				const rd = await tx.getResourceData(resourceId, false);
+				if (rd.data) {
+					const v2Data = JSON.parse(Buffer.from(rd.data).toString("utf-8"));
+					entries.push({
+						storageId: v2Data.storageID,
+						storageName: v2Data.storageName,
+						resourceId,
+						resourceType
+					});
+				}
+			}
+			return entries;
+		});
+		const result = /* @__PURE__ */ new Map();
+		for (const entry of [...v1Entries, ...v2Entries]) result.set(entry.storageId, entry);
+		return result;
+	}
+	async getUserRootViaLegacy(opts = {}) {
+		const login = opts.login ?? this.authUser;
+		const mainRootName = login === null ? AnonymousClientRoot : createHash("sha256").update(login).digest("hex");
+		return await this.runTx("initialization", true, "", async (tx) => {
+			if (await tx.checkResourceNameExists(mainRootName)) return await tx.getResourceByName(mainRootName);
+			if (opts.doNotCreateUserRoot) return;
+			const mainRoot = tx.createRoot(ClientRoot);
+			tx.setResourceName(mainRootName, mainRoot);
+			await tx.commit();
+			return await toGlobalResourceId(mainRoot);
+		});
+	}
+	async getDataLibrariesViaLegacy() {
+		return await this.runTx("GetAvailableStorageIds", false, "", async (tx) => {
+			const lsProviderId = await tx.getResourceByName("LSProvider");
+			const provider = await tx.getResourceData(lsProviderId, true);
+			const result = /* @__PURE__ */ new Map();
+			for (const field of provider.fields) {
+				if (field.type !== "Dynamic" || !isNotNullSignedResourceId(field.value)) continue;
+				if (!field.name.startsWith(LsProviderFieldPrefix)) continue;
+				const storageId = field.name.substring(8);
+				result.set(storageId, {
+					storageId,
+					storageName: storageId,
+					resourceId: field.value,
+					resourceType: {
+						name: `${LsStorageTypePrefix}${storageId}`,
+						version: "1"
+					}
+				});
+			}
+			return result;
+		});
+	}
+};
+//#endregion
+export { UserResources };
+
+//# sourceMappingURL=user_resources.js.map

package/dist/core/user_resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user_resources.js","names":[],"sources":["../../src/core/user_resources.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport type { LLPlClient } from \"./ll_client\";\nimport type { PlTransaction } from \"./transaction\";\nimport { toGlobalResourceId } from \"./transaction\";\nimport type { OptionalSignedResourceId, SignedResourceId, ResourceType } from \"./types\";\nimport {\n  createSignedResourceId,\n  isNotNullSignedResourceId,\n  NullSignedResourceId,\n  toResourceSignature,\n} from \"./types\";\nimport { isUnimplementedError } from \"./errors\";\nimport { ClientRoot } from \"../helpers/pl\";\n\nconst AnonymousClientRoot = \"AnonymousRoot\";\nconst LsStorageTypePrefix = \"LS/\"; // implements ls API in particular storage\nconst LsProviderFieldPrefix = \"storage/\"; // provides access to storages list\n\n/** Information about a single data library (LS storage). */\nexport interface StorageInfo {\n  /** Machine-stable identifier, e.g. \"library\". Used for filtering and map keys. */\n  readonly storageId: string;\n  /** Human-readable display name. For V1/legacy equals storageId; for V2 from resource JSON data. */\n  readonly storageName: string;\n  /** Signed resource ID for this storage resource. */\n  readonly resourceId: SignedResourceId;\n  /** Full resource type including correct version (\"1\" or \"2\"). */\n  readonly resourceType: ResourceType;\n}\n\n/** V2 LsStorage resource JSON data shape (contract with backend). */\ninterface LsStorageV2Data {\n  storageName: string;\n  storageID: string;\n}\n\n/**\n * Callback type for running transactions. Matches PlClient._withTx signature\n * so the index can run transactions before PlClient is fully initialized.\n */\nexport type TxRunner = <T>(\n  name: string,\n  writable: boolean,\n  clientRoot: OptionalSignedResourceId,\n  body: (tx: PlTransaction) => Promise<T>,\n) => Promise<T>;\n\ntype BackendCapability = \"getUserRoot\" | \"listUserResources\" | \"legacy\";\n\n/**\n * Abstracts user resource discovery with backward compatibility.\n *\n * Detects backend capability on the first getUserRoot() call and remembers\n * the result. Three-tier fallback:\n * 1. getUserRoot RPC (newest, supports doNotCreate)\n * 2. listUserResources RPC (streams all resources, picks userRoot)\n * 3. Named resource lookup/creation via transaction (legacy)\n */\nexport class UserResources {\n  private backendCapability: BackendCapability | undefined;\n\n  constructor(\n    private readonly ll: LLPlClient,\n    private readonly runTx: TxRunner,\n    public readonly authUser: string | null,\n  ) {}\n\n  /**\n   * Returns the user's root resource ID.\n   *\n   * On first call, detects backend capability by trying methods in order:\n   * 1. getUserRoot RPC (newest)\n   * 2. listUserResources RPC\n   * 3. Named resource lookup/creation via transaction (legacy)\n   */\n  async getUserRoot(): Promise<SignedResourceId>;\n  async getUserRoot(opts: { login?: string }): Promise<SignedResourceId>;\n  async getUserRoot(opts: { login?: string; doNotCreate: false }): Promise<SignedResourceId>;\n  async getUserRoot(opts: {\n    login?: string;\n    doNotCreate: true;\n  }): Promise<SignedResourceId | undefined>;\n  async getUserRoot(\n    opts: { login?: string; doNotCreate?: boolean } = {},\n  ): Promise<SignedResourceId | undefined> {\n    if (this.backendCapability === undefined) {\n      return await this.detectAndGetUserRoot(opts);\n    }\n    return await this.getUserRootWith(this.backendCapability, opts);\n  }\n\n  private async detectAndGetUserRoot(\n    opts: { login?: string; doNotCreate?: boolean } = {},\n  ): Promise<SignedResourceId | undefined> {\n    // 1. Try getUserRoot RPC\n    try {\n      const root = await this.getUserRootViaRpc(opts);\n      this.backendCapability = \"getUserRoot\";\n      return root;\n    } catch (err) {\n      if (!isUnimplementedError(err)) throw err;\n    }\n\n    // 2. Try listUserResources\n    try {\n      const root = await this.getUserRootViaList(opts);\n      this.backendCapability = \"listUserResources\";\n      return root;\n    } catch (err) {\n      if (!isUnimplementedError(err)) throw err;\n    }\n\n    // 3. Legacy fallback\n    this.backendCapability = \"legacy\";\n    return await this.getUserRootViaLegacy(opts);\n  }\n\n  private async getUserRootWith(\n    capability: BackendCapability,\n    opts: { login?: string; doNotCreate?: boolean } = {},\n  ): Promise<SignedResourceId | undefined> {\n    switch (capability) {\n      case \"getUserRoot\":\n        return await this.getUserRootViaRpc(opts);\n      case \"listUserResources\":\n        return await this.getUserRootViaList(opts);\n      case \"legacy\":\n        return await this.getUserRootViaLegacy(opts);\n    }\n  }\n\n  /**\n   * Returns all data libraries the user has access to.\n   * Always fetches fresh from the server (no caching).\n   */\n  async getDataLibraries(\n    opts: { login?: string; doNotCreateUserRoot?: boolean } = {},\n  ): Promise<ReadonlyMap<string, StorageInfo>> {\n    if (this.backendCapability === undefined) {\n      // First call — detect backend capability\n      try {\n        const libs = await this.getDataLibrariesViaList(opts);\n        // getUserRoot RPC doesn't return libraries, but listUserResources does;\n        // record at least \"listUserResources\" so future getUserRoot calls don't re-detect.\n        this.backendCapability = \"listUserResources\";\n        return libs;\n      } catch (err) {\n        if (!isUnimplementedError(err)) throw err;\n        this.backendCapability = \"legacy\";\n        return await this.getDataLibrariesViaLegacy();\n      }\n    }\n\n    // A server that supports getUserRoot definitely supports listUserResources.\n    if (this.backendCapability !== \"legacy\") {\n      return await this.getDataLibrariesViaList(opts);\n    }\n    return await this.getDataLibrariesViaLegacy();\n  }\n\n  private async getUserRootViaRpc(opts: { login?: string }): Promise<SignedResourceId>;\n  private async getUserRootViaRpc(opts: {\n    login?: string;\n    doNotCreate: false;\n  }): Promise<SignedResourceId>;\n  private async getUserRootViaRpc(opts: {\n    login?: string;\n    doNotCreate: true;\n  }): Promise<SignedResourceId | undefined>;\n  private async getUserRootViaRpc(\n    opts: { login?: string; doNotCreate?: boolean } = {},\n  ): Promise<SignedResourceId | undefined> {\n    const resp = await this.ll.getUserRoot({\n      login: opts.login,\n      doNotCreate: opts.doNotCreate,\n    });\n    if (resp.userRoot === undefined) {\n      if (opts.doNotCreate) return undefined;\n      throw new Error(\"getUserRoot returned no userRoot entry\");\n    }\n    return createSignedResourceId(\n      resp.userRoot.resourceId,\n      toResourceSignature(resp.userRoot.resourceSignature),\n    );\n  }\n\n  private async getUserRootViaList(opts: { login?: string }): Promise<SignedResourceId>;\n  private async getUserRootViaList(opts: {\n    login?: string;\n    doNotCreate: false;\n  }): Promise<SignedResourceId>;\n  private async getUserRootViaList(opts: {\n    login?: string;\n    doNotCreate: true;\n  }): Promise<SignedResourceId | undefined>;\n  private async getUserRootViaList(\n    opts: { login?: string; doNotCreate?: boolean } = {},\n  ): Promise<SignedResourceId | undefined> {\n    const responses = await this.ll.listUserResources({ login: opts.login, limit: 1 });\n    for (const msg of responses) {\n      if (msg.entry.oneofKind === \"userRoot\") {\n        return createSignedResourceId(\n          msg.entry.userRoot.resourceId,\n          toResourceSignature(msg.entry.userRoot.resourceSignature),\n        );\n      }\n    }\n    throw new Error(\"listUserResources returned no userRoot entry\");\n  }\n\n  private async getDataLibrariesViaList(\n    opts: { login?: string } = {},\n  ): Promise<ReadonlyMap<string, StorageInfo>> {\n    const responses = await this.ll.listUserResources({ login: opts.login });\n\n    // Collect all LS/* shared resources, separating V1 and V2\n    const v1Entries: StorageInfo[] = [];\n    const v2ResourceIds: { resourceId: SignedResourceId; resourceType: ResourceType }[] = [];\n\n    for (const msg of responses) {\n      if (msg.entry.oneofKind !== \"sharedResource\") continue;\n      const sr = msg.entry.sharedResource;\n\n      if (!sr.resourceType) continue;\n      const typeName = sr.resourceType.name;\n      const typeVersion = sr.resourceType.version;\n      if (!typeName.startsWith(LsStorageTypePrefix)) continue;\n\n      const rId = createSignedResourceId(sr.resourceId, toResourceSignature(sr.resourceSignature));\n      const rType: ResourceType = { name: typeName, version: typeVersion };\n\n      if (typeVersion === \"2\") {\n        v2ResourceIds.push({ resourceId: rId, resourceType: rType });\n      } else {\n        // V1 or unknown version: derive storageId from type name\n        const storageId = typeName.substring(LsStorageTypePrefix.length);\n        v1Entries.push({\n          storageId,\n          storageName: storageId,\n          resourceId: rId,\n          resourceType: rType,\n        });\n      }\n    }\n\n    // Read V2 resource data in a single transaction\n    let v2Entries: StorageInfo[] = [];\n    if (v2ResourceIds.length > 0) {\n      v2Entries = await this.runTx(\n        \"ReadLsStorageV2Data\",\n        false,\n        NullSignedResourceId,\n        async (tx) => {\n          const entries: StorageInfo[] = [];\n          for (const { resourceId, resourceType } of v2ResourceIds) {\n            const rd = await tx.getResourceData(resourceId, false);\n            if (rd.data) {\n              const v2Data = JSON.parse(Buffer.from(rd.data).toString(\"utf-8\")) as LsStorageV2Data;\n              entries.push({\n                storageId: v2Data.storageID,\n                storageName: v2Data.storageName,\n                resourceId,\n                resourceType,\n              });\n            }\n          }\n          return entries;\n        },\n      );\n    }\n\n    const result = new Map<string, StorageInfo>();\n    for (const entry of [...v1Entries, ...v2Entries]) {\n      result.set(entry.storageId, entry);\n    }\n    return result;\n  }\n\n  private async getUserRootViaLegacy(opts: { login?: string }): Promise<SignedResourceId>;\n  private async getUserRootViaLegacy(opts: {\n    login?: string;\n    doNotCreateUserRoot: false;\n  }): Promise<SignedResourceId>;\n  private async getUserRootViaLegacy(opts: {\n    login?: string;\n    doNotCreateUserRoot: true;\n  }): Promise<SignedResourceId | undefined>;\n  private async getUserRootViaLegacy(\n    opts: { login?: string; doNotCreateUserRoot?: boolean } = {},\n  ): Promise<SignedResourceId | undefined> {\n    const login = opts.login ?? this.authUser;\n    const mainRootName =\n      login === null ? AnonymousClientRoot : createHash(\"sha256\").update(login).digest(\"hex\");\n\n    return await this.runTx(\"initialization\", true, NullSignedResourceId, async (tx) => {\n      if (await tx.checkResourceNameExists(mainRootName)) {\n        return await tx.getResourceByName(mainRootName);\n      }\n\n      if (opts.doNotCreateUserRoot) {\n        return undefined;\n      }\n\n      const mainRoot = tx.createRoot(ClientRoot);\n      tx.setResourceName(mainRootName, mainRoot);\n      await tx.commit();\n      return await toGlobalResourceId(mainRoot);\n    });\n  }\n\n  private async getDataLibrariesViaLegacy(): Promise<ReadonlyMap<string, StorageInfo>> {\n    return await this.runTx(\"GetAvailableStorageIds\", false, NullSignedResourceId, async (tx) => {\n      const lsProviderId = await tx.getResourceByName(\"LSProvider\");\n      const provider = await tx.getResourceData(lsProviderId, true);\n\n      const result = new Map<string, StorageInfo>();\n      for (const field of provider.fields) {\n        if (field.type !== \"Dynamic\" || !isNotNullSignedResourceId(field.value)) continue;\n        if (!field.name.startsWith(LsProviderFieldPrefix)) continue;\n\n        const storageId = field.name.substring(LsProviderFieldPrefix.length);\n        result.set(storageId, {\n          storageId,\n          storageName: storageId,\n          resourceId: field.value,\n          resourceType: { name: `${LsStorageTypePrefix}${storageId}`, version: \"1\" },\n        });\n      }\n      return result;\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/helpers/poll.cjs

@@ -23,7 +23,7 @@ var PollResourceAccessor = class {
 		return this;
 	}
 	async requireNoError() {
-		if (require_types.isNullResourceId(this.data.error)) return this;
+		if (require_types.isNullSignedResourceId(this.data.error)) return this;
 		await this.tx.throwError(this.data.error, this.path);
 		return this;
 	}
@@ -43,8 +43,8 @@ var PollResourceAccessor = class {
 		};
 		const path = [...this.path, name];
 		const fieldData = this.getFieldData(name, expectedType);
-		if (require_types.isNotNullResourceId(fieldData.error) && (failOnError || require_types.isNullResourceId(fieldData.value))) await this.tx.throwError(fieldData.error, path);
-		if (require_types.isNullResourceId(fieldData.value)) throw new ContinuePolling();
+		if (require_types.isNotNullSignedResourceId(fieldData.error) && (failOnError || require_types.isNullSignedResourceId(fieldData.value))) await this.tx.throwError(fieldData.error, path);
+		if (require_types.isNullSignedResourceId(fieldData.value)) throw new ContinuePolling();
 		return await this.tx.get(fieldData.value, failOnError, path);
 	}
 	async getMulti(ops, ...names) {
@@ -54,7 +54,7 @@ var PollResourceAccessor = class {
 		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 || require_types.isNotNullResourceId(f.error)).map((f) => f.name));
+		return await this.getMultiObj(ops, ...this.data.fields.filter((f) => f.valueIsFinal || require_types.isNotNullSignedResourceId(f.error)).map((f) => f.name));
 	}
 	async getKValue(key) {
 		const value = await this.tx.tx.getKValueStringIfExists(this.data.id, key);

package/dist/helpers/poll.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"poll.cjs","names":["isNullResourceId","isNotNullResourceId","resourceIdToString","tp"],"sources":["../../src/helpers/poll.ts"],"sourcesContent":["import type { PlClient } from \"../core/client\";\nimport type { RetryOptions } from \"@milaboratories/ts-helpers\";\nimport { createRetryState, nextRetryStateOrError, notEmpty } from \"@milaboratories/ts-helpers\";\nimport type { FieldData, FieldType, ResourceData, ResourceId } from \"../core/types\";\nimport { isNotNullResourceId, isNullResourceId, resourceIdToString } 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"],"mappings":"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"}
+{"version":3,"file":"poll.cjs","names":["isNullSignedResourceId","isNotNullSignedResourceId","resourceIdToString","tp"],"sources":["../../src/helpers/poll.ts"],"sourcesContent":["import type { PlClient } from \"../core/client\";\nimport type { RetryOptions } from \"@milaboratories/ts-helpers\";\nimport { createRetryState, nextRetryStateOrError, notEmpty } from \"@milaboratories/ts-helpers\";\nimport type { FieldData, FieldType, ResourceData, SignedResourceId } from \"../core/types\";\nimport {\n  isNotNullSignedResourceId,\n  isNullSignedResourceId,\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 (isNullSignedResourceId(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 (\n      isNotNullSignedResourceId(fieldData.error) &&\n      (failOnError || isNullSignedResourceId(fieldData.value))\n    )\n      await this.tx.throwError(fieldData.error, path);\n\n    if (isNullSignedResourceId(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 || isNotNullSignedResourceId(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: SignedResourceId,\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: SignedResourceId, 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"],"mappings":"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"}

package/dist/helpers/poll.d.ts

@@ -1,4 +1,4 @@
-import { FieldData, FieldType, ResourceData, ResourceId } from "../core/types.js";
+import { FieldData, FieldType, ResourceData, SignedResourceId } from "../core/types.js";
 import { PlTransaction } from "../core/transaction.js";
 import { PlClient } from "../core/client.js";
 import { RetryOptions } from "@milaboratories/ts-helpers";
@@ -33,8 +33,8 @@ declare class PollResourceAccessor {
 declare class PollTxAccessor {
   readonly tx: PlTransaction;
   constructor(tx: PlTransaction);
-  get(rid: ResourceId, failOnError?: boolean, path?: string[]): Promise<PollResourceAccessor>;
-  throwError(error: ResourceId, path?: string[]): Promise<never>;
+  get(rid: SignedResourceId, failOnError?: boolean, path?: string[]): Promise<PollResourceAccessor>;
+  throwError(error: SignedResourceId, path?: string[]): Promise<never>;
 }
 declare const DefaultPollingRetryOptions: RetryOptions;
 declare function poll<T>(cl: PlClient, cb: (tx: PollTxAccessor) => Promise<T>, retryOptions?: RetryOptions, txName?: string): Promise<T>;

package/dist/helpers/poll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"poll.d.ts","names":[],"sources":["../../src/helpers/poll.ts"],"mappings":";;;;;;;cASa,eAAA,SAAwB,KAAA;EACnC,IAAA;AAAA;AAAA,KAGU,oBAAA;EACV,YAAA,GAAe,SAAA;EAJX;AAGN;EAIE,WAAA;EAEA,SAAA;AAAA;AAAA,cAQW,oBAAA;EAAA,SAEO,EAAA,EAAI,cAAA;EAAA,SACJ,IAAA,EAAM,YAAA;EAAA,SACN,IAAA;cAFA,EAAA,EAAI,cAAA,EACJ,IAAA,EAAM,YAAA,EACN,IAAA;EAGX,KAAA,CAAA,GAAS,oBAAA;EAKH,cAAA,CAAA,GAAkB,OAAA,CAAQ,oBAAA;EAOhC,YAAA,CAAa,IAAA,UAAc,YAAA,GAAe,SAAA,GAAY,SAAA;EAqBhD,GAAA,CACX,IAAA,UACA,GAAA,GAAK,OAAA,CAAQ,oBAAA,IACZ,OAAA,CAAQ,oBAAA;EAaE,QAAA,CACX,GAAA,EAAK,OAAA,CAAQ,oBAAA,MACV,KAAA,aACF,OAAA,CAAQ,oBAAA;EAIE,WAAA,oBAAA,CACX,GAAA,EAAK,OAAA,CAAQ,oBAAA,MACV,KAAA,EAAO,GAAA,KACT,OAAA,CAAQ,MAAA,CAAO,GAAA,EAAK,oBAAA;EAMV,WAAA,CACX,GAAA,GAAK,OAAA,CAAQ,oBAAA,IACZ,OAAA,CAAQ,MAAA,SAAe,oBAAA;EASb,SAAA,CAAU,GAAA,WAAc,OAAA;EAMxB,YAAA,GAAA,CAAgB,GAAA,WAAc,OAAA,CAAQ,CAAA;AAAA;AAAA,cAKxC,cAAA;EAAA,SACiB,EAAA,EAAI,aAAA;cAAJ,EAAA,EAAI,aAAA;EAEnB,GAAA,CACX,GAAA,EAAK,UAAA,EACL,WAAA,YACA,IAAA,cACC,OAAA,CAAQ,oBAAA;EAOL,UAAA,CAAW,KAAA,EAAO,UAAA,EAAY,IAAA,cAAsB,OAAA;AAAA;AAAA,cAO/C,0BAAA,EAA4B,YAAA;AAAA,iBAQnB,IAAA,GAAA,CACpB,EAAA,EAAI,QAAA,EACJ,EAAA,GAAK,EAAA,EAAI,cAAA,KAAmB,OAAA,CAAQ,CAAA,GACpC,YAAA,GAAc,YAAA,EACd,MAAA,YACC,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"poll.d.ts","names":[],"sources":["../../src/helpers/poll.ts"],"mappings":";;;;;;;cAaa,eAAA,SAAwB,KAAA;EACnC,IAAA;AAAA;AAAA,KAGU,oBAAA;EACV,YAAA,GAAe,SAAA;EAJX;AAGN;EAIE,WAAA;EAEA,SAAA;AAAA;AAAA,cAQW,oBAAA;EAAA,SAEO,EAAA,EAAI,cAAA;EAAA,SACJ,IAAA,EAAM,YAAA;EAAA,SACN,IAAA;cAFA,EAAA,EAAI,cAAA,EACJ,IAAA,EAAM,YAAA,EACN,IAAA;EAGX,KAAA,CAAA,GAAS,oBAAA;EAKH,cAAA,CAAA,GAAkB,OAAA,CAAQ,oBAAA;EAOhC,YAAA,CAAa,IAAA,UAAc,YAAA,GAAe,SAAA,GAAY,SAAA;EAqBhD,GAAA,CACX,IAAA,UACA,GAAA,GAAK,OAAA,CAAQ,oBAAA,IACZ,OAAA,CAAQ,oBAAA;EAgBE,QAAA,CACX,GAAA,EAAK,OAAA,CAAQ,oBAAA,MACV,KAAA,aACF,OAAA,CAAQ,oBAAA;EAIE,WAAA,oBAAA,CACX,GAAA,EAAK,OAAA,CAAQ,oBAAA,MACV,KAAA,EAAO,GAAA,KACT,OAAA,CAAQ,MAAA,CAAO,GAAA,EAAK,oBAAA;EAMV,WAAA,CACX,GAAA,GAAK,OAAA,CAAQ,oBAAA,IACZ,OAAA,CAAQ,MAAA,SAAe,oBAAA;EASb,SAAA,CAAU,GAAA,WAAc,OAAA;EAMxB,YAAA,GAAA,CAAgB,GAAA,WAAc,OAAA,CAAQ,CAAA;AAAA;AAAA,cAKxC,cAAA;EAAA,SACiB,EAAA,EAAI,aAAA;cAAJ,EAAA,EAAI,aAAA;EAEnB,GAAA,CACX,GAAA,EAAK,gBAAA,EACL,WAAA,YACA,IAAA,cACC,OAAA,CAAQ,oBAAA;EAOL,UAAA,CAAW,KAAA,EAAO,gBAAA,EAAkB,IAAA,cAAsB,OAAA;AAAA;AAAA,cAOrD,0BAAA,EAA4B,YAAA;AAAA,iBAQnB,IAAA,GAAA,CACpB,EAAA,EAAI,QAAA,EACJ,EAAA,GAAK,EAAA,EAAI,cAAA,KAAmB,OAAA,CAAQ,CAAA,GACpC,YAAA,GAAc,YAAA,EACd,MAAA,YACC,OAAA,CAAQ,CAAA"}

package/dist/helpers/poll.js

@@ -1,4 +1,4 @@
-import { isNotNullResourceId, isNullResourceId, resourceIdToString } from "../core/types.js";
+import { isNotNullSignedResourceId, isNullSignedResourceId, resourceIdToString } from "../core/types.js";
 import { createRetryState, nextRetryStateOrError, notEmpty } from "@milaboratories/ts-helpers";
 import * as tp from "node:timers/promises";
 //#region src/helpers/poll.ts
@@ -21,7 +21,7 @@ var PollResourceAccessor = class {
 		return this;
 	}
 	async requireNoError() {
-		if (isNullResourceId(this.data.error)) return this;
+		if (isNullSignedResourceId(this.data.error)) return this;
 		await this.tx.throwError(this.data.error, this.path);
 		return this;
 	}
@@ -41,8 +41,8 @@ var PollResourceAccessor = class {
 		};
 		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();
+		if (isNotNullSignedResourceId(fieldData.error) && (failOnError || isNullSignedResourceId(fieldData.value))) await this.tx.throwError(fieldData.error, path);
+		if (isNullSignedResourceId(fieldData.value)) throw new ContinuePolling();
 		return await this.tx.get(fieldData.value, failOnError, path);
 	}
 	async getMulti(ops, ...names) {
@@ -52,7 +52,7 @@ var PollResourceAccessor = class {
 		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));
+		return await this.getMultiObj(ops, ...this.data.fields.filter((f) => f.valueIsFinal || isNotNullSignedResourceId(f.error)).map((f) => f.name));
 	}
 	async getKValue(key) {
 		const value = await this.tx.tx.getKValueStringIfExists(this.data.id, key);

package/dist/helpers/poll.js.map

@@ -1 +1 @@
-{"version":3,"file":"poll.js","names":[],"sources":["../../src/helpers/poll.ts"],"sourcesContent":["import type { PlClient } from \"../core/client\";\nimport type { RetryOptions } from \"@milaboratories/ts-helpers\";\nimport { createRetryState, nextRetryStateOrError, notEmpty } from \"@milaboratories/ts-helpers\";\nimport type { FieldData, FieldType, ResourceData, ResourceId } from \"../core/types\";\nimport { isNotNullResourceId, isNullResourceId, resourceIdToString } 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"],"mappings":"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"}
+{"version":3,"file":"poll.js","names":[],"sources":["../../src/helpers/poll.ts"],"sourcesContent":["import type { PlClient } from \"../core/client\";\nimport type { RetryOptions } from \"@milaboratories/ts-helpers\";\nimport { createRetryState, nextRetryStateOrError, notEmpty } from \"@milaboratories/ts-helpers\";\nimport type { FieldData, FieldType, ResourceData, SignedResourceId } from \"../core/types\";\nimport {\n  isNotNullSignedResourceId,\n  isNullSignedResourceId,\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 (isNullSignedResourceId(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 (\n      isNotNullSignedResourceId(fieldData.error) &&\n      (failOnError || isNullSignedResourceId(fieldData.value))\n    )\n      await this.tx.throwError(fieldData.error, path);\n\n    if (isNullSignedResourceId(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 || isNotNullSignedResourceId(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: SignedResourceId,\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: SignedResourceId, 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"],"mappings":"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"}

package/dist/helpers/tx_helpers.cjs

@@ -8,7 +8,7 @@ async function valErr(tx, f) {
 		errorId: f.error,
 		error: ""
 	};
-	if (require_types.isNotNullResourceId(f.error)) {
+	if (require_types.isNotNullSignedResourceId(f.error)) {
 		const e = await tx.getResourceData(f.error, true);
 		const deserializationResult = (0, _milaboratories_ts_helpers.cachedDeserialize)((0, _milaboratories_ts_helpers.notEmpty)(e.data));
 		if (typeof deserializationResult !== "string") {

package/dist/helpers/tx_helpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tx_helpers.cjs","names":["isNotNullResourceId"],"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(\n        `Unexpected error structure: ${dataStr.substring(0, Math.min(dataStr.length, 100))}...`,\n      );\n    }\n    result.error = deserializationResult;\n  }\n\n  return result;\n}\n"],"mappings":";;;;AAWA,eAAsB,OAAO,IAAmB,GAA+B;CAC7E,MAAM,SAAS;EACb,SAAS,EAAE;EACX,SAAS,EAAE;EACX,OAAO;EACR;AAED,KAAIA,cAAAA,oBAAoB,EAAE,MAAM,EAAE;EAChC,MAAM,IAAI,MAAM,GAAG,gBAAgB,EAAE,OAAO,KAAK;EACjD,MAAM,yBAAA,GAAA,2BAAA,oBAAA,GAAA,2BAAA,UAAmD,EAAE,KAAK,CAAC;AACjE,MAAI,OAAO,0BAA0B,UAAU;GAC7C,MAAM,WAAA,GAAA,2BAAA,UAAmB,EAAE,KAAK,CAAC,UAAU;AAC3C,SAAM,IAAI,MACR,+BAA+B,QAAQ,UAAU,GAAG,KAAK,IAAI,QAAQ,QAAQ,IAAI,CAAC,CAAC,KACpF;;AAEH,SAAO,QAAQ;;AAGjB,QAAO"}
+{"version":3,"file":"tx_helpers.cjs","names":["isNotNullSignedResourceId"],"sources":["../../src/helpers/tx_helpers.ts"],"sourcesContent":["import type { PlTransaction } from \"../core/transaction\";\nimport type { FieldData, OptionalSignedResourceId } from \"../core/types\";\nimport { isNotNullSignedResourceId } from \"../core/types\";\nimport { cachedDeserialize, notEmpty } from \"@milaboratories/ts-helpers\";\n\nexport interface ValErr {\n  valueId: OptionalSignedResourceId;\n  errorId: OptionalSignedResourceId;\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 (isNotNullSignedResourceId(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(\n        `Unexpected error structure: ${dataStr.substring(0, Math.min(dataStr.length, 100))}...`,\n      );\n    }\n    result.error = deserializationResult;\n  }\n\n  return result;\n}\n"],"mappings":";;;;AAWA,eAAsB,OAAO,IAAmB,GAA+B;CAC7E,MAAM,SAAS;EACb,SAAS,EAAE;EACX,SAAS,EAAE;EACX,OAAO;EACR;AAED,KAAIA,cAAAA,0BAA0B,EAAE,MAAM,EAAE;EACtC,MAAM,IAAI,MAAM,GAAG,gBAAgB,EAAE,OAAO,KAAK;EACjD,MAAM,yBAAA,GAAA,2BAAA,oBAAA,GAAA,2BAAA,UAAmD,EAAE,KAAK,CAAC;AACjE,MAAI,OAAO,0BAA0B,UAAU;GAC7C,MAAM,WAAA,GAAA,2BAAA,UAAmB,EAAE,KAAK,CAAC,UAAU;AAC3C,SAAM,IAAI,MACR,+BAA+B,QAAQ,UAAU,GAAG,KAAK,IAAI,QAAQ,QAAQ,IAAI,CAAC,CAAC,KACpF;;AAEH,SAAO,QAAQ;;AAGjB,QAAO"}

package/dist/helpers/tx_helpers.d.ts

@@ -1,10 +1,10 @@
-import { FieldData, OptionalResourceId } from "../core/types.js";
+import { FieldData, OptionalSignedResourceId } from "../core/types.js";
 import { PlTransaction } from "../core/transaction.js";
 
 //#region src/helpers/tx_helpers.d.ts
 interface ValErr {
-  valueId: OptionalResourceId;
-  errorId: OptionalResourceId;
+  valueId: OptionalSignedResourceId;
+  errorId: OptionalSignedResourceId;
   error?: string;
 }
 declare function valErr(tx: PlTransaction, f: FieldData): Promise<ValErr>;

package/dist/helpers/tx_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tx_helpers.d.ts","names":[],"sources":["../../src/helpers/tx_helpers.ts"],"mappings":";;;;UAKiB,MAAA;EACf,OAAA,EAAS,kBAAA;EACT,OAAA,EAAS,kBAAA;EACT,KAAA;AAAA;AAAA,iBAGoB,MAAA,CAAO,EAAA,EAAI,aAAA,EAAe,CAAA,EAAG,SAAA,GAAY,OAAA,CAAQ,MAAA"}
+{"version":3,"file":"tx_helpers.d.ts","names":[],"sources":["../../src/helpers/tx_helpers.ts"],"mappings":";;;;UAKiB,MAAA;EACf,OAAA,EAAS,wBAAA;EACT,OAAA,EAAS,wBAAA;EACT,KAAA;AAAA;AAAA,iBAGoB,MAAA,CAAO,EAAA,EAAI,aAAA,EAAe,CAAA,EAAG,SAAA,GAAY,OAAA,CAAQ,MAAA"}

package/dist/helpers/tx_helpers.js

@@ -1,4 +1,4 @@
-import { isNotNullResourceId } from "../core/types.js";
+import { isNotNullSignedResourceId } from "../core/types.js";
 import { cachedDeserialize, notEmpty } from "@milaboratories/ts-helpers";
 //#region src/helpers/tx_helpers.ts
 async function valErr(tx, f) {
@@ -7,7 +7,7 @@ async function valErr(tx, f) {
 		errorId: f.error,
 		error: ""
 	};
-	if (isNotNullResourceId(f.error)) {
+	if (isNotNullSignedResourceId(f.error)) {
 		const e = await tx.getResourceData(f.error, true);
 		const deserializationResult = cachedDeserialize(notEmpty(e.data));
 		if (typeof deserializationResult !== "string") {

package/dist/helpers/tx_helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"tx_helpers.js","names":[],"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(\n        `Unexpected error structure: ${dataStr.substring(0, Math.min(dataStr.length, 100))}...`,\n      );\n    }\n    result.error = deserializationResult;\n  }\n\n  return result;\n}\n"],"mappings":";;;AAWA,eAAsB,OAAO,IAAmB,GAA+B;CAC7E,MAAM,SAAS;EACb,SAAS,EAAE;EACX,SAAS,EAAE;EACX,OAAO;EACR;AAED,KAAI,oBAAoB,EAAE,MAAM,EAAE;EAChC,MAAM,IAAI,MAAM,GAAG,gBAAgB,EAAE,OAAO,KAAK;EACjD,MAAM,wBAAwB,kBAAkB,SAAS,EAAE,KAAK,CAAC;AACjE,MAAI,OAAO,0BAA0B,UAAU;GAC7C,MAAM,UAAU,SAAS,EAAE,KAAK,CAAC,UAAU;AAC3C,SAAM,IAAI,MACR,+BAA+B,QAAQ,UAAU,GAAG,KAAK,IAAI,QAAQ,QAAQ,IAAI,CAAC,CAAC,KACpF;;AAEH,SAAO,QAAQ;;AAGjB,QAAO"}
+{"version":3,"file":"tx_helpers.js","names":[],"sources":["../../src/helpers/tx_helpers.ts"],"sourcesContent":["import type { PlTransaction } from \"../core/transaction\";\nimport type { FieldData, OptionalSignedResourceId } from \"../core/types\";\nimport { isNotNullSignedResourceId } from \"../core/types\";\nimport { cachedDeserialize, notEmpty } from \"@milaboratories/ts-helpers\";\n\nexport interface ValErr {\n  valueId: OptionalSignedResourceId;\n  errorId: OptionalSignedResourceId;\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 (isNotNullSignedResourceId(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(\n        `Unexpected error structure: ${dataStr.substring(0, Math.min(dataStr.length, 100))}...`,\n      );\n    }\n    result.error = deserializationResult;\n  }\n\n  return result;\n}\n"],"mappings":";;;AAWA,eAAsB,OAAO,IAAmB,GAA+B;CAC7E,MAAM,SAAS;EACb,SAAS,EAAE;EACX,SAAS,EAAE;EACX,OAAO;EACR;AAED,KAAI,0BAA0B,EAAE,MAAM,EAAE;EACtC,MAAM,IAAI,MAAM,GAAG,gBAAgB,EAAE,OAAO,KAAK;EACjD,MAAM,wBAAwB,kBAAkB,SAAS,EAAE,KAAK,CAAC;AACjE,MAAI,OAAO,0BAA0B,UAAU;GAC7C,MAAM,UAAU,SAAS,EAAE,KAAK,CAAC,UAAU;AAC3C,SAAM,IAAI,MACR,+BAA+B,QAAQ,UAAU,GAAG,KAAK,IAAI,QAAQ,QAAQ,IAAI,CAAC,CAAC,KACpF;;AAEH,SAAO,QAAQ;;AAGjB,QAAO"}

package/dist/index.cjs

@@ -8,6 +8,7 @@ const require_config = require("./core/config.cjs");
 const require_auth = require("./core/auth.cjs");
 const require_index = require("./proto-rest/index.cjs");
 const require_final = require("./core/final.cjs");
+const require_user_resources = require("./core/user_resources.cjs");
 const require_client = require("./core/client.cjs");
 const require_driver = require("./core/driver.cjs");
 const require_unauth_client = require("./core/unauth_client.cjs");
@@ -37,6 +38,8 @@ exports.DisconnectedError = require_errors.DisconnectedError;
 exports.MaxLocalId = require_types.MaxLocalId;
 exports.MaxTxId = require_types.MaxTxId;
 exports.NullResourceId = require_types.NullResourceId;
+exports.NullSignedResourceId = require_types.NullSignedResourceId;
+exports.PermissionDeniedError = require_errors.PermissionDeniedError;
 Object.defineProperty(exports, "Pl", {
 	enumerable: true,
 	get: function() {
@@ -70,14 +73,17 @@ exports.TxCommitConflict = require_transaction.TxCommitConflict;
 exports.UnauthenticatedError = require_errors.UnauthenticatedError;
 exports.UnauthenticatedPlClient = require_unauth_client.UnauthenticatedPlClient;
 exports.UnrecoverablePlError = require_errors.UnrecoverablePlError;
+exports.UserResources = require_user_resources.UserResources;
 exports.addRTypeToMetadata = require_driver.addRTypeToMetadata;
-exports.bigintToResourceId = require_types.bigintToResourceId;
+exports.anyResourceIdToBigint = require_types.anyResourceIdToBigint;
+exports.base64UrlToSignature = require_types.base64UrlToSignature;
 exports.checkLocalityOfResourceId = require_types.checkLocalityOfResourceId;
 exports.createGlobalResourceId = require_types.createGlobalResourceId;
 exports.createLocalResourceId = require_types.createLocalResourceId;
 exports.createRTypeRoutingHeader = require_driver.createRTypeRoutingHeader;
+exports.createSignedResourceId = require_types.createSignedResourceId;
 exports.defaultPlClient = require_default_client.defaultPlClient;
-exports.ensureResourceIdNotNull = require_types.ensureResourceIdNotNull;
+exports.ensureSignedResourceIdNotNull = require_types.ensureSignedResourceIdNotNull;
 exports.expirationFromAuthInformation = require_auth.expirationFromAuthInformation;
 exports.extractBasicResourceData = require_types.extractBasicResourceData;
 exports.extractTxId = require_types.extractTxId;
@@ -92,17 +98,21 @@ exports.isField = require_transaction.isField;
 exports.isFieldRef = require_transaction.isFieldRef;
 exports.isLocalResourceId = require_types.isLocalResourceId;
 exports.isNotFoundError = require_errors.isNotFoundError;
-exports.isNotNullResourceId = require_types.isNotNullResourceId;
-exports.isNullResourceId = require_types.isNullResourceId;
+exports.isNotNullSignedResourceId = require_types.isNotNullSignedResourceId;
+exports.isNullSignedResourceId = require_types.isNullSignedResourceId;
+exports.isPermissionDenied = require_errors.isPermissionDenied;
 exports.isResource = require_transaction.isResource;
 exports.isResourceId = require_transaction.isResourceId;
 exports.isResourceRef = require_transaction.isResourceRef;
 exports.isRootResourceId = require_types.isRootResourceId;
+exports.isSignedResourceId = require_types.isSignedResourceId;
 exports.isTimeoutError = require_errors.isTimeoutError;
 exports.isTimeoutOrCancelError = require_errors.isTimeoutOrCancelError;
 exports.isUnauthenticated = require_errors.isUnauthenticated;
 exports.isUnimplementedError = require_errors.isUnimplementedError;
 exports.jsonToData = require_types.jsonToData;
+exports.parseResourceType = require_types.parseResourceType;
+exports.parseSignedResourceId = require_types.parseSignedResourceId;
 exports.plAddressToConfig = require_config.plAddressToConfig;
 exports.poll = require_poll.poll;
 exports.resDataToJson = require_types.resDataToJson;
@@ -112,11 +122,12 @@ exports.resourceType = require_types.resourceType;
 exports.resourceTypeToString = require_types.resourceTypeToString;
 exports.resourceTypesEqual = require_types.resourceTypesEqual;
 exports.rethrowMeaningfulError = require_errors.rethrowMeaningfulError;
+exports.signatureToBase64Url = require_types.signatureToBase64Url;
 exports.stringifyWithResourceId = require_types.stringifyWithResourceId;
 exports.throwPlNotFoundError = require_errors.throwPlNotFoundError;
 exports.toFieldId = require_transaction.toFieldId;
 exports.toGlobalFieldId = require_transaction.toGlobalFieldId;
 exports.toGlobalResourceId = require_transaction.toGlobalResourceId;
-exports.toResourceId = require_transaction.toResourceId;
+exports.toResourceSignature = require_types.toResourceSignature;
 exports.tryGetFileConfig = require_default_client.tryGetFileConfig;
 exports.valErr = require_tx_helpers.valErr;

package/dist/index.d.ts

@@ -1,17 +1,18 @@
-import { AnyResourceId, BasicResourceData, FieldData, FieldStatus, FieldType, FutureFieldType, LocalResourceId, MaxLocalId, MaxTxId, NullResourceId, OptionalAnyResourceId, OptionalResourceId, ResourceData, ResourceId, ResourceKind, ResourceType, bigintToResourceId, checkLocalityOfResourceId, createGlobalResourceId, createLocalResourceId, ensureResourceIdNotNull, extractBasicResourceData, extractTxId, getField, isAnyResourceId, isLocalResourceId, isNotNullResourceId, isNullResourceId, isRootResourceId, jsonToData, resDataToJson, resourceIdFromString, resourceIdToString, resourceType, resourceTypeToString, resourceTypesEqual, stringifyWithResourceId } from "./core/types.js";
+import { AnyResourceId, BasicResourceData, ColorProof, FieldData, FieldStatus, FieldType, FutureFieldType, GlobalResourceId, LocalResourceId, MaxLocalId, MaxTxId, NullResourceId, NullSignedResourceId, OptionalAnyResourceId, OptionalSignedResourceId, ResourceData, ResourceKind, ResourceSignature, ResourceType, SignedResourceId, anyResourceIdToBigint, base64UrlToSignature, checkLocalityOfResourceId, createGlobalResourceId, createLocalResourceId, createSignedResourceId, ensureSignedResourceIdNotNull, extractBasicResourceData, extractTxId, getField, isAnyResourceId, isLocalResourceId, isNotNullSignedResourceId, isNullSignedResourceId, isRootResourceId, isSignedResourceId, jsonToData, parseResourceType, parseSignedResourceId, resDataToJson, resourceIdFromString, resourceIdToString, resourceType, resourceTypeToString, resourceTypesEqual, signatureToBase64Url, stringifyWithResourceId, toResourceSignature } from "./core/types.js";
 import { DefaultFinalResourceDataPredicate, FinalResourceDataPredicate, ResourceTypeName, ResourceTypePrefix } from "./core/final.js";
-import { AnyFieldId, AnyFieldRef, AnyRef, AnyResourceRef, FieldId, FieldRef, KeyValue, KeyValueString, LocalFieldId, PlTransaction, ResourceRef, TxCommitConflict, field, isField, isFieldRef, isResource, isResourceId, isResourceRef, toFieldId, toGlobalFieldId, toGlobalResourceId, toResourceId } from "./core/transaction.js";
+import { AnyFieldId, AnyFieldRef, AnyRef, AnyResourceRef, FieldId, FieldRef, KeyValue, KeyValueString, LocalFieldId, PlTransaction, ResourceIdWithSignature, ResourceRef, TxCommitConflict, field, isField, isFieldRef, isResource, isResourceId, isResourceRef, toFieldId, toGlobalFieldId, toGlobalResourceId } from "./core/transaction.js";
 import { pl_d_exports } from "./helpers/pl.js";
 import { AnonymousAuthInformation, AuthInformation, AuthOps, DEFAULT_AUTH_MAX_REFRESH, DEFAULT_MAX_CACHE_BYTES, DEFAULT_REQUEST_TIMEOUT, DEFAULT_RETRY_BACKOFF_ALGORITHM, DEFAULT_RETRY_EXPONENTIAL_BACKOFF_MULTIPLIER, DEFAULT_RETRY_INITIAL_DELAY, DEFAULT_RETRY_JITTER, DEFAULT_RETRY_LINEAR_BACKOFF_STEP, DEFAULT_RETRY_MAX_ATTEMPTS, DEFAULT_RO_TX_TIMEOUT, DEFAULT_RW_TX_TIMEOUT, DEFAULT_TOKEN_TTL_SECONDS, DefaultRetryOptions, PlClientConfig, PlConnectionStatus, PlConnectionStatusListener, SUPPORTED_WIRE_PROTOCOLS, plAddressToConfig, wireProtocol } from "./core/config.js";
 import { GrpcConnection, RestConnection, WireClientProvider, WireClientProviderFactory, WireConnection } from "./core/wire.js";
 import { index_d_exports } from "./proto-rest/index.js";
 import { PlDriver, PlDriverDefinition, addRTypeToMetadata, createRTypeRoutingHeader } from "./core/driver.js";
+import { StorageInfo, TxRunner, UserResources } from "./core/user_resources.js";
 import { PlClient, TxOps } from "./core/client.js";
-import { DisconnectedError, PlError, PlErrorCodeNotFound, RESTError, RecoverablePlError, UnauthenticatedError, UnrecoverablePlError, isAbortedError, isCancelError, isConnectionProblem, isNotFoundError, isTimeoutError, isTimeoutOrCancelError, isUnauthenticated, isUnimplementedError, rethrowMeaningfulError, throwPlNotFoundError } from "./core/errors.js";
+import { DisconnectedError, PermissionDeniedError, PlError, PlErrorCodeNotFound, RESTError, RecoverablePlError, UnauthenticatedError, UnrecoverablePlError, isAbortedError, isCancelError, isConnectionProblem, isNotFoundError, isPermissionDenied, isTimeoutError, isTimeoutOrCancelError, isUnauthenticated, isUnimplementedError, rethrowMeaningfulError, throwPlNotFoundError } from "./core/errors.js";
 import { defaultPlClient, tryGetFileConfig } from "./core/default_client.js";
 import { UnauthenticatedPlClient } from "./core/unauth_client.js";
 import { expirationFromAuthInformation, inferAuthRefreshTime } from "./core/auth.js";
 import { ValErr, valErr } from "./helpers/tx_helpers.js";
 import { ContinuePolling, DefaultPollingRetryOptions, PollFieldTraverseOps, PollResourceAccessor, PollTxAccessor, poll } from "./helpers/poll.js";
 import { test_config_d_exports } from "./test/test_config.js";
-export { AnonymousAuthInformation, AnyFieldId, AnyFieldRef, AnyRef, AnyResourceId, AnyResourceRef, AuthInformation, AuthOps, BasicResourceData, ContinuePolling, DEFAULT_AUTH_MAX_REFRESH, DEFAULT_MAX_CACHE_BYTES, DEFAULT_REQUEST_TIMEOUT, DEFAULT_RETRY_BACKOFF_ALGORITHM, DEFAULT_RETRY_EXPONENTIAL_BACKOFF_MULTIPLIER, DEFAULT_RETRY_INITIAL_DELAY, DEFAULT_RETRY_JITTER, DEFAULT_RETRY_LINEAR_BACKOFF_STEP, DEFAULT_RETRY_MAX_ATTEMPTS, DEFAULT_RO_TX_TIMEOUT, DEFAULT_RW_TX_TIMEOUT, DEFAULT_TOKEN_TTL_SECONDS, DefaultFinalResourceDataPredicate, DefaultPollingRetryOptions, DefaultRetryOptions, DisconnectedError, FieldData, FieldId, FieldRef, FieldStatus, FieldType, FinalResourceDataPredicate, FutureFieldType, GrpcConnection, KeyValue, KeyValueString, LocalFieldId, LocalResourceId, MaxLocalId, MaxTxId, NullResourceId, OptionalAnyResourceId, OptionalResourceId, pl_d_exports as Pl, PlClient, PlClientConfig, PlConnectionStatus, PlConnectionStatusListener, PlDriver, PlDriverDefinition, PlError, PlErrorCodeNotFound, PlTransaction, PollFieldTraverseOps, PollResourceAccessor, PollTxAccessor, RESTError, RecoverablePlError, ResourceData, ResourceId, ResourceKind, ResourceRef, ResourceType, ResourceTypeName, ResourceTypePrefix, index_d_exports as RestAPI, RestConnection, SUPPORTED_WIRE_PROTOCOLS, test_config_d_exports as TestHelpers, TxCommitConflict, TxOps, UnauthenticatedError, UnauthenticatedPlClient, UnrecoverablePlError, ValErr, WireClientProvider, WireClientProviderFactory, WireConnection, addRTypeToMetadata, bigintToResourceId, checkLocalityOfResourceId, createGlobalResourceId, createLocalResourceId, createRTypeRoutingHeader, defaultPlClient, ensureResourceIdNotNull, expirationFromAuthInformation, extractBasicResourceData, extractTxId, field, getField, inferAuthRefreshTime, isAbortedError, isAnyResourceId, isCancelError, isConnectionProblem, isField, isFieldRef, isLocalResourceId, isNotFoundError, isNotNullResourceId, isNullResourceId, isResource, isResourceId, isResourceRef, isRootResourceId, isTimeoutError, isTimeoutOrCancelError, isUnauthenticated, isUnimplementedError, jsonToData, plAddressToConfig, poll, resDataToJson, resourceIdFromString, resourceIdToString, resourceType, resourceTypeToString, resourceTypesEqual, rethrowMeaningfulError, stringifyWithResourceId, throwPlNotFoundError, toFieldId, toGlobalFieldId, toGlobalResourceId, toResourceId, tryGetFileConfig, valErr, wireProtocol };
+export { AnonymousAuthInformation, AnyFieldId, AnyFieldRef, AnyRef, AnyResourceId, AnyResourceRef, AuthInformation, AuthOps, BasicResourceData, ColorProof, ContinuePolling, DEFAULT_AUTH_MAX_REFRESH, DEFAULT_MAX_CACHE_BYTES, DEFAULT_REQUEST_TIMEOUT, DEFAULT_RETRY_BACKOFF_ALGORITHM, DEFAULT_RETRY_EXPONENTIAL_BACKOFF_MULTIPLIER, DEFAULT_RETRY_INITIAL_DELAY, DEFAULT_RETRY_JITTER, DEFAULT_RETRY_LINEAR_BACKOFF_STEP, DEFAULT_RETRY_MAX_ATTEMPTS, DEFAULT_RO_TX_TIMEOUT, DEFAULT_RW_TX_TIMEOUT, DEFAULT_TOKEN_TTL_SECONDS, DefaultFinalResourceDataPredicate, DefaultPollingRetryOptions, DefaultRetryOptions, DisconnectedError, FieldData, FieldId, FieldRef, FieldStatus, FieldType, FinalResourceDataPredicate, FutureFieldType, GlobalResourceId, GrpcConnection, KeyValue, KeyValueString, LocalFieldId, LocalResourceId, MaxLocalId, MaxTxId, NullResourceId, NullSignedResourceId, OptionalAnyResourceId, OptionalSignedResourceId, PermissionDeniedError, pl_d_exports as Pl, PlClient, PlClientConfig, PlConnectionStatus, PlConnectionStatusListener, PlDriver, PlDriverDefinition, PlError, PlErrorCodeNotFound, PlTransaction, PollFieldTraverseOps, PollResourceAccessor, PollTxAccessor, RESTError, RecoverablePlError, ResourceData, ResourceIdWithSignature, ResourceKind, ResourceRef, ResourceSignature, ResourceType, ResourceTypeName, ResourceTypePrefix, index_d_exports as RestAPI, RestConnection, SUPPORTED_WIRE_PROTOCOLS, SignedResourceId, StorageInfo, test_config_d_exports as TestHelpers, TxCommitConflict, TxOps, TxRunner, UnauthenticatedError, UnauthenticatedPlClient, UnrecoverablePlError, UserResources, ValErr, WireClientProvider, WireClientProviderFactory, WireConnection, addRTypeToMetadata, anyResourceIdToBigint, base64UrlToSignature, checkLocalityOfResourceId, createGlobalResourceId, createLocalResourceId, createRTypeRoutingHeader, createSignedResourceId, defaultPlClient, ensureSignedResourceIdNotNull, expirationFromAuthInformation, extractBasicResourceData, extractTxId, field, getField, inferAuthRefreshTime, isAbortedError, isAnyResourceId, isCancelError, isConnectionProblem, isField, isFieldRef, isLocalResourceId, isNotFoundError, isNotNullSignedResourceId, isNullSignedResourceId, isPermissionDenied, isResource, isResourceId, isResourceRef, isRootResourceId, isSignedResourceId, isTimeoutError, isTimeoutOrCancelError, isUnauthenticated, isUnimplementedError, jsonToData, parseResourceType, parseSignedResourceId, plAddressToConfig, poll, resDataToJson, resourceIdFromString, resourceIdToString, resourceType, resourceTypeToString, resourceTypesEqual, rethrowMeaningfulError, signatureToBase64Url, stringifyWithResourceId, throwPlNotFoundError, toFieldId, toGlobalFieldId, toGlobalResourceId, toResourceSignature, tryGetFileConfig, valErr, wireProtocol };