@milaboratories/pl-client 2.11.8 → 2.11.9

package/dist/core/types.js

@@ -0,0 +1,134 @@
+import { cachedDeserialize, notEmpty } from '@milaboratories/ts-helpers';
+
+const NullResourceId = 0n;
+function isNullResourceId(resourceId) {
+    return resourceId === NullResourceId;
+}
+function isNotNullResourceId(resourceId) {
+    return resourceId !== NullResourceId;
+}
+function ensureResourceIdNotNull(resourceId) {
+    if (!isNotNullResourceId(resourceId))
+        throw new Error('null resource id');
+    return resourceId;
+}
+function isAnyResourceId(resourceId) {
+    return resourceId !== 0n;
+}
+function resourceType(name, version) {
+    return { name, version };
+}
+function resourceTypeToString(rt) {
+    return `${rt.name}:${rt.version}`;
+}
+function resourceTypesEqual(type1, type2) {
+    return type1.name === type2.name && type1.version === type2.version;
+}
+function extractBasicResourceData(rd) {
+    const { id, originalResourceId, kind, type, data, error, inputsLocked, outputsLocked, resourceReady, final, } = rd;
+    return {
+        id,
+        originalResourceId,
+        kind,
+        type,
+        data,
+        error,
+        inputsLocked,
+        outputsLocked,
+        resourceReady,
+        final,
+    };
+}
+const jsonToData = (data) => Buffer.from(JSON.stringify(data));
+const resDataToJson = (res) => cachedDeserialize(notEmpty(res.data));
+function getField(r, name) {
+    return notEmpty(r.fields.find((f) => f.name === name));
+}
+//
+// Local / Global ResourceId arithmetics
+//
+// Note: txId and other numerical values are made numbers but not bigint intentionally,
+//       after implementing security model based on signed resource ids this will make
+//       much more sense
+const ResourceIdRootMask = 1n << 63n;
+const ResourceIdLocalMask = 1n << 62n;
+const NoFlagsIdMask = 0x3fffffffffffffffn;
+const LocalResourceIdTxIdOffset = 24n;
+const MaxLocalId = 0xffffff;
+const MaxTxId = 0xffffffff;
+/** Mask valid after applying shift */
+const TxIdMask = BigInt(MaxTxId);
+const LocalIdMask = BigInt(MaxLocalId);
+// /** Basically removes embedded tx id */
+// const LocalIdCleanMask = 0xFF00000000FFFFFFn;
+function isRootResourceId(id) {
+    return (id & ResourceIdRootMask) !== 0n;
+}
+function isLocalResourceId(id) {
+    return (id & ResourceIdLocalMask) !== 0n;
+}
+function createLocalResourceId(isRoot, localCounterValue, localTxId) {
+    if (localCounterValue > MaxLocalId
+        || localTxId > MaxTxId
+        || localCounterValue < 0
+        || localTxId <= 0)
+        throw Error('wrong local id or tx id');
+    return ((isRoot ? ResourceIdRootMask : 0n)
+        | ResourceIdLocalMask
+        | BigInt(localCounterValue)
+        | (BigInt(localTxId) << LocalResourceIdTxIdOffset));
+}
+function createGlobalResourceId(isRoot, unmaskedId) {
+    return ((isRoot ? ResourceIdRootMask : 0n) | unmaskedId);
+}
+function extractTxId(localResourceId) {
+    return Number((localResourceId >> LocalResourceIdTxIdOffset) & TxIdMask);
+}
+function checkLocalityOfResourceId(resourceId, expectedTxId) {
+    if (!isLocalResourceId(resourceId))
+        return;
+    if (extractTxId(resourceId) !== expectedTxId)
+        throw Error('local id from another transaction, globalize id before leaking it from the transaction');
+}
+function resourceIdToString(resourceId) {
+    if (isNullResourceId(resourceId))
+        return 'XX:0x0';
+    if (isLocalResourceId(resourceId))
+        return ((isRootResourceId(resourceId) ? 'R' : 'N')
+            + 'L:0x'
+            + (LocalIdMask & resourceId).toString(16)
+            + '[0x'
+            + extractTxId(resourceId).toString(16)
+            + ']');
+    else
+        return ((isRootResourceId(resourceId) ? 'R' : 'N')
+            + 'G:0x'
+            + (NoFlagsIdMask & resourceId).toString(16));
+}
+const resourceIdRegexp = /^(?:(?<xx>XX)|(?<rn>[XRN])(?<lg>[XLG])):0x(?<rid>[0-9a-fA-F]+)(?:\[0x(?<txid>[0-9a-fA-F]+)])?$/;
+function resourceIdFromString(str) {
+    const match = str.match(resourceIdRegexp);
+    if (match === null)
+        return undefined;
+    const { xx, rn, lg, rid, txid } = match.groups;
+    if (xx)
+        return NullResourceId;
+    if (lg === 'L')
+        return createLocalResourceId(rn === 'R', Number.parseInt(rid, 16), Number.parseInt(txid, 16));
+    else
+        return createGlobalResourceId(rn === 'R', BigInt('0x' + rid));
+}
+/** Converts bigint to global resource id */
+function bigintToResourceId(resourceId) {
+    if (isLocalResourceId(resourceId))
+        throw new Error(`Local resource id: ${resourceIdToString(resourceId)}`);
+    if (isNullResourceId(resourceId))
+        throw new Error(`Null resource id.`);
+    return resourceId;
+}
+function stringifyWithResourceId(object) {
+    return JSON.stringify(object, (key, value) => typeof value === 'bigint' ? resourceIdToString(value) : value);
+}
+
+export { MaxLocalId, MaxTxId, NullResourceId, bigintToResourceId, checkLocalityOfResourceId, createGlobalResourceId, createLocalResourceId, ensureResourceIdNotNull, extractBasicResourceData, extractTxId, getField, isAnyResourceId, isLocalResourceId, isNotNullResourceId, isNullResourceId, isRootResourceId, jsonToData, resDataToJson, resourceIdFromString, resourceIdToString, resourceType, resourceTypeToString, resourceTypesEqual, stringifyWithResourceId };
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../src/core/types.ts"],"sourcesContent":["import { cachedDeserialize, notEmpty } from '@milaboratories/ts-helpers';\n\n// more details here: https://egghead.io/blog/using-branded-types-in-typescript\ndeclare const __resource_id_type__: unique symbol;\ntype BrandResourceId<B> = bigint & { [__resource_id_type__]: B };\n\n/** Global resource id */\nexport type ResourceId = BrandResourceId<'global'>;\n\n/** Null resource id */\nexport type NullResourceId = BrandResourceId<'null'>;\n\n/** Local resource id */\nexport type LocalResourceId = BrandResourceId<'local'>;\n\n/** Any non-null resource id */\nexport type AnyResourceId = ResourceId | LocalResourceId;\n\n/** Any resource id */\nexport type OptionalResourceId = NullResourceId | ResourceId;\n\n/** All possible resource flavours */\nexport type OptionalAnyResourceId = NullResourceId | ResourceId | LocalResourceId;\n\nexport const NullResourceId = 0n as NullResourceId;\n\nexport function isNullResourceId(resourceId: bigint): resourceId is NullResourceId {\n  return resourceId === NullResourceId;\n}\n\nexport function isNotNullResourceId(resourceId: OptionalResourceId): resourceId is ResourceId {\n  return resourceId !== NullResourceId;\n}\n\nexport function ensureResourceIdNotNull(resourceId: OptionalResourceId): ResourceId {\n  if (!isNotNullResourceId(resourceId)) throw new Error('null resource id');\n  return resourceId;\n}\n\nexport function isAnyResourceId(resourceId: bigint): resourceId is AnyResourceId {\n  return resourceId !== 0n;\n}\n\n// see local / global resource logic below...\n\nexport type ResourceKind = 'Structural' | 'Value';\n\nexport type FieldType = 'Input' | 'Output' | 'Service' | 'OTW' | 'Dynamic' | 'MTW';\n\nexport type FutureFieldType = 'Output' | 'Input' | 'Service';\n\nexport type FieldStatus = 'Empty' | 'Assigned' | 'Resolved';\n\nexport interface ResourceType {\n  readonly name: string;\n  readonly version: string;\n}\n\nexport function resourceType(name: string, version: string): ResourceType {\n  return { name, version };\n}\n\nexport function resourceTypeToString(rt: ResourceType): string {\n  return `${rt.name}:${rt.version}`;\n}\n\nexport function resourceTypesEqual(type1: ResourceType, type2: ResourceType): boolean {\n  return type1.name === type2.name && type1.version === type2.version;\n}\n\n/** Readonly fields here marks properties of resource that can't change according to pl's state machine. */\nexport type BasicResourceData = {\n  readonly id: ResourceId;\n  readonly originalResourceId: OptionalResourceId;\n\n  readonly kind: ResourceKind;\n  readonly type: ResourceType;\n\n  readonly data?: Uint8Array;\n\n  readonly error: OptionalResourceId;\n\n  readonly inputsLocked: boolean;\n  readonly outputsLocked: boolean;\n  readonly resourceReady: boolean;\n\n  /** This value is derived from resource state by the server and can be used as\n   * a robust criteria to determine resource is in final state. */\n  readonly final: boolean;\n};\n\nexport function extractBasicResourceData(rd: ResourceData): BasicResourceData {\n  const {\n    id,\n    originalResourceId,\n    kind,\n    type,\n    data,\n    error,\n    inputsLocked,\n    outputsLocked,\n    resourceReady,\n    final,\n  } = rd;\n  return {\n    id,\n    originalResourceId,\n    kind,\n    type,\n    data,\n    error,\n    inputsLocked,\n    outputsLocked,\n    resourceReady,\n    final,\n  };\n}\n\nexport const jsonToData = (data: unknown) => Buffer.from(JSON.stringify(data));\n\nexport const resDataToJson = (res: ResourceData) => cachedDeserialize(notEmpty(res.data));\n\nexport type ResourceData = BasicResourceData & {\n  readonly fields: FieldData[];\n};\n\nexport function getField(r: ResourceData, name: string): FieldData {\n  return notEmpty(r.fields.find((f) => f.name === name));\n}\n\nexport type FieldData = {\n  readonly name: string;\n  readonly type: FieldType;\n  readonly status: FieldStatus;\n  readonly value: OptionalResourceId;\n  readonly error: OptionalResourceId;\n\n  /** True if value the fields points to is in final state. */\n  readonly valueIsFinal: boolean;\n};\n\n//\n// Local / Global ResourceId arithmetics\n//\n\n// Note: txId and other numerical values are made numbers but not bigint intentionally,\n//       after implementing security model based on signed resource ids this will make\n//       much more sense\n\nconst ResourceIdRootMask = 1n << 63n;\nconst ResourceIdLocalMask = 1n << 62n;\nconst NoFlagsIdMask = 0x3fffffffffffffffn;\nconst LocalResourceIdTxIdOffset = 24n;\nexport const MaxLocalId = 0xffffff;\nexport const MaxTxId = 0xffffffff;\n/** Mask valid after applying shift */\nconst TxIdMask = BigInt(MaxTxId);\nconst LocalIdMask = BigInt(MaxLocalId);\n\n// /** Basically removes embedded tx id */\n// const LocalIdCleanMask = 0xFF00000000FFFFFFn;\n\nexport function isRootResourceId(id: bigint) {\n  return (id & ResourceIdRootMask) !== 0n;\n}\n\nexport function isLocalResourceId(id: bigint): id is LocalResourceId {\n  return (id & ResourceIdLocalMask) !== 0n;\n}\n\nexport function createLocalResourceId(\n  isRoot: boolean,\n  localCounterValue: number,\n  localTxId: number,\n): LocalResourceId {\n  if (\n    localCounterValue > MaxLocalId\n    || localTxId > MaxTxId\n    || localCounterValue < 0\n    || localTxId <= 0\n  )\n    throw Error('wrong local id or tx id');\n  return ((isRoot ? ResourceIdRootMask : 0n)\n    | ResourceIdLocalMask\n    | BigInt(localCounterValue)\n    | (BigInt(localTxId) << LocalResourceIdTxIdOffset)) as LocalResourceId;\n}\n\nexport function createGlobalResourceId(isRoot: boolean, unmaskedId: bigint): ResourceId {\n  return ((isRoot ? ResourceIdRootMask : 0n) | unmaskedId) as ResourceId;\n}\n\nexport function extractTxId(localResourceId: LocalResourceId): number {\n  return Number((localResourceId >> LocalResourceIdTxIdOffset) & TxIdMask);\n}\n\nexport function checkLocalityOfResourceId(resourceId: AnyResourceId, expectedTxId: number): void {\n  if (!isLocalResourceId(resourceId)) return;\n  if (extractTxId(resourceId) !== expectedTxId)\n    throw Error(\n      'local id from another transaction, globalize id before leaking it from the transaction',\n    );\n}\n\nexport function resourceIdToString(resourceId: OptionalAnyResourceId): string {\n  if (isNullResourceId(resourceId)) return 'XX:0x0';\n  if (isLocalResourceId(resourceId))\n    return (\n      (isRootResourceId(resourceId) ? 'R' : 'N')\n      + 'L:0x'\n      + (LocalIdMask & resourceId).toString(16)\n      + '[0x'\n      + extractTxId(resourceId).toString(16)\n      + ']'\n    );\n  else\n    return (\n      (isRootResourceId(resourceId) ? 'R' : 'N')\n      + 'G:0x'\n      + (NoFlagsIdMask & resourceId).toString(16)\n    );\n}\n\nconst resourceIdRegexp\n  = /^(?:(?<xx>XX)|(?<rn>[XRN])(?<lg>[XLG])):0x(?<rid>[0-9a-fA-F]+)(?:\\[0x(?<txid>[0-9a-fA-F]+)])?$/;\n\nexport function resourceIdFromString(str: string): OptionalAnyResourceId | undefined {\n  const match = str.match(resourceIdRegexp);\n  if (match === null) return undefined;\n  const { xx, rn, lg, rid, txid } = match.groups!;\n  if (xx) return NullResourceId;\n  if (lg === 'L')\n    return createLocalResourceId(rn === 'R', Number.parseInt(rid, 16), Number.parseInt(txid, 16));\n  else return createGlobalResourceId(rn === 'R', BigInt('0x' + rid));\n}\n\n/** Converts bigint to global resource id */\nexport function bigintToResourceId(resourceId: bigint): ResourceId {\n  if (isLocalResourceId(resourceId))\n    throw new Error(`Local resource id: ${resourceIdToString(resourceId)}`);\n  if (isNullResourceId(resourceId)) throw new Error(`Null resource id.`);\n  return resourceId as ResourceId;\n}\n\nexport function stringifyWithResourceId(object: unknown): string {\n  return JSON.stringify(object, (key, value) =>\n    typeof value === 'bigint' ? resourceIdToString(value as OptionalAnyResourceId) : value,\n  );\n}\n"],"names":[],"mappings":";;AAwBO,MAAM,cAAc,GAAG;AAExB,SAAU,gBAAgB,CAAC,UAAkB,EAAA;IACjD,OAAO,UAAU,KAAK,cAAc;AACtC;AAEM,SAAU,mBAAmB,CAAC,UAA8B,EAAA;IAChE,OAAO,UAAU,KAAK,cAAc;AACtC;AAEM,SAAU,uBAAuB,CAAC,UAA8B,EAAA;AACpE,IAAA,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC;AACzE,IAAA,OAAO,UAAU;AACnB;AAEM,SAAU,eAAe,CAAC,UAAkB,EAAA;IAChD,OAAO,UAAU,KAAK,EAAE;AAC1B;AAiBM,SAAU,YAAY,CAAC,IAAY,EAAE,OAAe,EAAA;AACxD,IAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;AAC1B;AAEM,SAAU,oBAAoB,CAAC,EAAgB,EAAA;IACnD,OAAO,CAAA,EAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,CAAA,CAAE;AACnC;AAEM,SAAU,kBAAkB,CAAC,KAAmB,EAAE,KAAmB,EAAA;AACzE,IAAA,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;AACrE;AAuBM,SAAU,wBAAwB,CAAC,EAAgB,EAAA;IACvD,MAAM,EACJ,EAAE,EACF,kBAAkB,EAClB,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,KAAK,GACN,GAAG,EAAE;IACN,OAAO;QACL,EAAE;QACF,kBAAkB;QAClB,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,YAAY;QACZ,aAAa;QACb,aAAa;QACb,KAAK;KACN;AACH;MAEa,UAAU,GAAG,CAAC,IAAa,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;AAEtE,MAAM,aAAa,GAAG,CAAC,GAAiB,KAAK,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;AAMlF,SAAU,QAAQ,CAAC,CAAe,EAAE,IAAY,EAAA;IACpD,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACxD;AAaA;AACA;AACA;AAEA;AACA;AACA;AAEA,MAAM,kBAAkB,GAAG,EAAE,IAAI,GAAG;AACpC,MAAM,mBAAmB,GAAG,EAAE,IAAI,GAAG;AACrC,MAAM,aAAa,GAAG,mBAAmB;AACzC,MAAM,yBAAyB,GAAG,GAAG;AAC9B,MAAM,UAAU,GAAG;AACnB,MAAM,OAAO,GAAG;AACvB;AACA,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;AAChC,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;AAEtC;AACA;AAEM,SAAU,gBAAgB,CAAC,EAAU,EAAA;AACzC,IAAA,OAAO,CAAC,EAAE,GAAG,kBAAkB,MAAM,EAAE;AACzC;AAEM,SAAU,iBAAiB,CAAC,EAAU,EAAA;AAC1C,IAAA,OAAO,CAAC,EAAE,GAAG,mBAAmB,MAAM,EAAE;AAC1C;SAEgB,qBAAqB,CACnC,MAAe,EACf,iBAAyB,EACzB,SAAiB,EAAA;IAEjB,IACE,iBAAiB,GAAG;AACjB,WAAA,SAAS,GAAG;AACZ,WAAA,iBAAiB,GAAG;AACpB,WAAA,SAAS,IAAI,CAAC;AAEjB,QAAA,MAAM,KAAK,CAAC,yBAAyB,CAAC;IACxC,QAAQ,CAAC,MAAM,GAAG,kBAAkB,GAAG,EAAE;UACrC;UACA,MAAM,CAAC,iBAAiB;WACvB,MAAM,CAAC,SAAS,CAAC,IAAI,yBAAyB,CAAC;AACtD;AAEM,SAAU,sBAAsB,CAAC,MAAe,EAAE,UAAkB,EAAA;AACxE,IAAA,QAAQ,CAAC,MAAM,GAAG,kBAAkB,GAAG,EAAE,IAAI,UAAU;AACzD;AAEM,SAAU,WAAW,CAAC,eAAgC,EAAA;IAC1D,OAAO,MAAM,CAAC,CAAC,eAAe,IAAI,yBAAyB,IAAI,QAAQ,CAAC;AAC1E;AAEM,SAAU,yBAAyB,CAAC,UAAyB,EAAE,YAAoB,EAAA;AACvF,IAAA,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC;QAAE;AACpC,IAAA,IAAI,WAAW,CAAC,UAAU,CAAC,KAAK,YAAY;AAC1C,QAAA,MAAM,KAAK,CACT,wFAAwF,CACzF;AACL;AAEM,SAAU,kBAAkB,CAAC,UAAiC,EAAA;IAClE,IAAI,gBAAgB,CAAC,UAAU,CAAC;AAAE,QAAA,OAAO,QAAQ;IACjD,IAAI,iBAAiB,CAAC,UAAU,CAAC;AAC/B,QAAA,QACE,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,GAAG;cACvC;cACA,CAAC,WAAW,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE;cACtC;AACA,cAAA,WAAW,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,EAAE;AACnC,cAAA,GAAG;;AAGP,QAAA,QACE,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,GAAG;cACvC;cACA,CAAC,aAAa,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;AAEjD;AAEA,MAAM,gBAAgB,GAClB,gGAAgG;AAE9F,SAAU,oBAAoB,CAAC,GAAW,EAAA;IAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACzC,IAAI,KAAK,KAAK,IAAI;AAAE,QAAA,OAAO,SAAS;AACpC,IAAA,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,MAAO;AAC/C,IAAA,IAAI,EAAE;AAAE,QAAA,OAAO,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG;QACZ,OAAO,qBAAqB,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;;AAC1F,QAAA,OAAO,sBAAsB,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;AACpE;AAEA;AACM,SAAU,kBAAkB,CAAC,UAAkB,EAAA;IACnD,IAAI,iBAAiB,CAAC,UAAU,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,CAAA,mBAAA,EAAsB,kBAAkB,CAAC,UAAU,CAAC,CAAA,CAAE,CAAC;IACzE,IAAI,gBAAgB,CAAC,UAAU,CAAC;AAAE,QAAA,MAAM,IAAI,KAAK,CAAC,CAAA,iBAAA,CAAmB,CAAC;AACtE,IAAA,OAAO,UAAwB;AACjC;AAEM,SAAU,uBAAuB,CAAC,MAAe,EAAA;AACrD,IAAA,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,KACvC,OAAO,KAAK,KAAK,QAAQ,GAAG,kBAAkB,CAAC,KAA8B,CAAC,GAAG,KAAK,CACvF;AACH;;;;"}

package/dist/core/unauth_client.cjs

@@ -0,0 +1,43 @@
+'use strict';
+
+var ll_client = require('./ll_client.cjs');
+var tsHelpers = require('@milaboratories/ts-helpers');
+var errors = require('./errors.cjs');
+
+/** Primarily used for initial authentication (login) */
+class UnauthenticatedPlClient {
+    ll;
+    constructor(configOrAddress) {
+        this.ll = new ll_client.LLPlClient(configOrAddress);
+    }
+    async ping() {
+        return (await this.ll.grpcPl.get().ping({})).response;
+    }
+    async authMethods() {
+        return (await this.ll.grpcPl.get().authMethods({})).response;
+    }
+    async requireAuth() {
+        return (await this.authMethods()).methods.length > 0;
+    }
+    async login(user, password) {
+        try {
+            const response = await this.ll.grpcPl.get().getJWTToken({ expiration: { seconds: BigInt(this.ll.conf.authTTLSeconds), nanos: 0 } }, {
+                meta: {
+                    authorization: 'Basic ' + Buffer.from(user + ':' + password).toString('base64'),
+                },
+            }).response;
+            const jwtToken = tsHelpers.notEmpty(response.token);
+            if (jwtToken === '')
+                throw new Error('empty token');
+            return { jwtToken };
+        }
+        catch (e) {
+            if (e.code === 'UNAUTHENTICATED')
+                throw new errors.UnauthenticatedError(e.message);
+            throw new Error(e);
+        }
+    }
+}
+
+exports.UnauthenticatedPlClient = UnauthenticatedPlClient;
+//# sourceMappingURL=unauth_client.cjs.map

package/dist/core/unauth_client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unauth_client.cjs","sources":["../../src/core/unauth_client.ts"],"sourcesContent":["import type { AuthInformation, PlClientConfig } from './config';\nimport type {\n  AuthAPI_ListMethods_Response,\n  MaintenanceAPI_Ping_Response,\n} from '../proto/github.com/milaboratory/pl/plapi/plapiproto/api';\nimport { LLPlClient } from './ll_client';\nimport { notEmpty } from '@milaboratories/ts-helpers';\nimport { UnauthenticatedError } from './errors';\n\n/** Primarily used for initial authentication (login) */\nexport class UnauthenticatedPlClient {\n  public readonly ll: LLPlClient;\n\n  constructor(configOrAddress: PlClientConfig | string) {\n    this.ll = new LLPlClient(configOrAddress);\n  }\n\n  public async ping(): Promise<MaintenanceAPI_Ping_Response> {\n    return (await this.ll.grpcPl.get().ping({})).response;\n  }\n\n  public async authMethods(): Promise<AuthAPI_ListMethods_Response> {\n    return (await this.ll.grpcPl.get().authMethods({})).response;\n  }\n\n  public async requireAuth(): Promise<boolean> {\n    return (await this.authMethods()).methods.length > 0;\n  }\n\n  public async login(user: string, password: string): Promise<AuthInformation> {\n    try {\n      const response = await this.ll.grpcPl.get().getJWTToken(\n        { expiration: { seconds: BigInt(this.ll.conf.authTTLSeconds), nanos: 0 } },\n        {\n          meta: {\n            authorization: 'Basic ' + Buffer.from(user + ':' + password).toString('base64'),\n          },\n        },\n      ).response;\n      const jwtToken = notEmpty(response.token);\n      if (jwtToken === '') throw new Error('empty token');\n      return { jwtToken };\n    } catch (e: any) {\n      if (e.code === 'UNAUTHENTICATED') throw new UnauthenticatedError(e.message);\n      throw new Error(e);\n    }\n  }\n}\n"],"names":["LLPlClient","notEmpty","UnauthenticatedError"],"mappings":";;;;;;AASA;MACa,uBAAuB,CAAA;AAClB,IAAA,EAAE;AAElB,IAAA,WAAA,CAAY,eAAwC,EAAA;QAClD,IAAI,CAAC,EAAE,GAAG,IAAIA,oBAAU,CAAC,eAAe,CAAC;IAC3C;AAEO,IAAA,MAAM,IAAI,GAAA;AACf,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ;IACvD;AAEO,IAAA,MAAM,WAAW,GAAA;AACtB,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,QAAQ;IAC9D;AAEO,IAAA,MAAM,WAAW,GAAA;AACtB,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;IACtD;AAEO,IAAA,MAAM,KAAK,CAAC,IAAY,EAAE,QAAgB,EAAA;AAC/C,QAAA,IAAI;AACF,YAAA,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CACrD,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAC1E;AACE,gBAAA,IAAI,EAAE;AACJ,oBAAA,aAAa,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,GAAG,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;AAChF,iBAAA;aACF,CACF,CAAC,QAAQ;YACV,MAAM,QAAQ,GAAGC,kBAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;YACzC,IAAI,QAAQ,KAAK,EAAE;AAAE,gBAAA,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE;QACrB;QAAE,OAAO,CAAM,EAAE;AACf,YAAA,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB;AAAE,gBAAA,MAAM,IAAIC,2BAAoB,CAAC,CAAC,CAAC,OAAO,CAAC;AAC3E,YAAA,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC;QACpB;IACF;AACD;;;;"}

package/dist/core/unauth_client.d.ts

@@ -10,4 +10,3 @@ export declare class UnauthenticatedPlClient {
     requireAuth(): Promise<boolean>;
     login(user: string, password: string): Promise<AuthInformation>;
 }
-//# sourceMappingURL=unauth_client.d.ts.map

package/dist/core/unauth_client.js

@@ -0,0 +1,41 @@
+import { LLPlClient } from './ll_client.js';
+import { notEmpty } from '@milaboratories/ts-helpers';
+import { UnauthenticatedError } from './errors.js';
+
+/** Primarily used for initial authentication (login) */
+class UnauthenticatedPlClient {
+    ll;
+    constructor(configOrAddress) {
+        this.ll = new LLPlClient(configOrAddress);
+    }
+    async ping() {
+        return (await this.ll.grpcPl.get().ping({})).response;
+    }
+    async authMethods() {
+        return (await this.ll.grpcPl.get().authMethods({})).response;
+    }
+    async requireAuth() {
+        return (await this.authMethods()).methods.length > 0;
+    }
+    async login(user, password) {
+        try {
+            const response = await this.ll.grpcPl.get().getJWTToken({ expiration: { seconds: BigInt(this.ll.conf.authTTLSeconds), nanos: 0 } }, {
+                meta: {
+                    authorization: 'Basic ' + Buffer.from(user + ':' + password).toString('base64'),
+                },
+            }).response;
+            const jwtToken = notEmpty(response.token);
+            if (jwtToken === '')
+                throw new Error('empty token');
+            return { jwtToken };
+        }
+        catch (e) {
+            if (e.code === 'UNAUTHENTICATED')
+                throw new UnauthenticatedError(e.message);
+            throw new Error(e);
+        }
+    }
+}
+
+export { UnauthenticatedPlClient };
+//# sourceMappingURL=unauth_client.js.map

package/dist/core/unauth_client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unauth_client.js","sources":["../../src/core/unauth_client.ts"],"sourcesContent":["import type { AuthInformation, PlClientConfig } from './config';\nimport type {\n  AuthAPI_ListMethods_Response,\n  MaintenanceAPI_Ping_Response,\n} from '../proto/github.com/milaboratory/pl/plapi/plapiproto/api';\nimport { LLPlClient } from './ll_client';\nimport { notEmpty } from '@milaboratories/ts-helpers';\nimport { UnauthenticatedError } from './errors';\n\n/** Primarily used for initial authentication (login) */\nexport class UnauthenticatedPlClient {\n  public readonly ll: LLPlClient;\n\n  constructor(configOrAddress: PlClientConfig | string) {\n    this.ll = new LLPlClient(configOrAddress);\n  }\n\n  public async ping(): Promise<MaintenanceAPI_Ping_Response> {\n    return (await this.ll.grpcPl.get().ping({})).response;\n  }\n\n  public async authMethods(): Promise<AuthAPI_ListMethods_Response> {\n    return (await this.ll.grpcPl.get().authMethods({})).response;\n  }\n\n  public async requireAuth(): Promise<boolean> {\n    return (await this.authMethods()).methods.length > 0;\n  }\n\n  public async login(user: string, password: string): Promise<AuthInformation> {\n    try {\n      const response = await this.ll.grpcPl.get().getJWTToken(\n        { expiration: { seconds: BigInt(this.ll.conf.authTTLSeconds), nanos: 0 } },\n        {\n          meta: {\n            authorization: 'Basic ' + Buffer.from(user + ':' + password).toString('base64'),\n          },\n        },\n      ).response;\n      const jwtToken = notEmpty(response.token);\n      if (jwtToken === '') throw new Error('empty token');\n      return { jwtToken };\n    } catch (e: any) {\n      if (e.code === 'UNAUTHENTICATED') throw new UnauthenticatedError(e.message);\n      throw new Error(e);\n    }\n  }\n}\n"],"names":[],"mappings":";;;;AASA;MACa,uBAAuB,CAAA;AAClB,IAAA,EAAE;AAElB,IAAA,WAAA,CAAY,eAAwC,EAAA;QAClD,IAAI,CAAC,EAAE,GAAG,IAAI,UAAU,CAAC,eAAe,CAAC;IAC3C;AAEO,IAAA,MAAM,IAAI,GAAA;AACf,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ;IACvD;AAEO,IAAA,MAAM,WAAW,GAAA;AACtB,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,QAAQ;IAC9D;AAEO,IAAA,MAAM,WAAW,GAAA;AACtB,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;IACtD;AAEO,IAAA,MAAM,KAAK,CAAC,IAAY,EAAE,QAAgB,EAAA;AAC/C,QAAA,IAAI;AACF,YAAA,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CACrD,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAC1E;AACE,gBAAA,IAAI,EAAE;AACJ,oBAAA,aAAa,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,GAAG,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;AAChF,iBAAA;aACF,CACF,CAAC,QAAQ;YACV,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;YACzC,IAAI,QAAQ,KAAK,EAAE;AAAE,gBAAA,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC;YACnD,OAAO,EAAE,QAAQ,EAAE;QACrB;QAAE,OAAO,CAAM,EAAE;AACf,YAAA,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB;AAAE,gBAAA,MAAM,IAAI,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC;AAC3E,YAAA,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC;QACpB;IACF;AACD;;;;"}

package/dist/helpers/pl.cjs

@@ -0,0 +1,124 @@
+'use strict';
+
+var transaction = require('../core/transaction.cjs');
+
+/**
+ * @packageDocumentation
+ *
+ * This file is exported under Pl "namespace" to the client users.
+ *
+ * It defines well known pl types, and methods to manipulate them.
+ *
+ */
+function rt(name, version) {
+    return { name, version };
+}
+const ClientRoot = rt('ClientRoot', '1');
+const StructTestResource = rt('StructTest', '1');
+const ValueTestResource = rt('ValueTest', '1');
+const JsonString = rt('json/string', '1');
+const JsonBool = rt('json/bool', '1');
+const JsonObject = rt('json/object', '1');
+const JsonGzObject = rt('json-gz/object', '1');
+const JsonArray = rt('json/array', '1');
+const JsonNumber = rt('json/number', '1');
+const JsonNull = rt('json/null', '1');
+const RNull = rt('Null', '1');
+const EphStdMap = rt('EphStdMap', '1');
+const StdMap = rt('StdMap', '1');
+//
+// Standard value resources
+//
+function createPlNull(tx) {
+    return tx.createValue(JsonNull, Buffer.from(JSON.stringify(null)));
+}
+function createPlBool(tx, val) {
+    return tx.createValue(JsonBool, Buffer.from(JSON.stringify(val)));
+}
+function createPlNumber(tx, val) {
+    return tx.createValue(JsonNumber, Buffer.from(JSON.stringify(val)));
+}
+function createPlString(tx, val) {
+    return tx.createValue(JsonString, Buffer.from(JSON.stringify(val)));
+}
+function createPlArray(tx, val) {
+    return tx.createValue(JsonArray, Buffer.from(JSON.stringify(val)));
+}
+function createPlObject(tx, val) {
+    return tx.createValue(JsonObject, Buffer.from(JSON.stringify(val)));
+}
+function plEntry(key, ref) {
+    return [key, ref];
+}
+function plEntries(record, fields) {
+    return fields === undefined
+        ? Object.entries(record)
+        : fields.map((key) => plEntry(key, record[key]));
+}
+/** Helper method to build standard pl map from a set of entries */
+function createPlMap(tx, entries, ephemeral, type) {
+    const actualType = type ?? (ephemeral ? EphStdMap : StdMap);
+    const rId = ephemeral ? tx.createEphemeral(actualType) : tx.createStruct(actualType);
+    for (const [name, value] of Array.isArray(entries) ? entries : plEntries(entries))
+        tx.createField(transaction.field(rId, name), 'Input', value);
+    tx.lock(rId);
+    return rId;
+}
+function futureRecord(tx, rId, keys, fieldType, prefix = '') {
+    return Object.fromEntries(keys.map((k) => plEntry(k, tx.getFutureFieldValue(rId, `${prefix}${k}`, fieldType))));
+}
+//
+// Holder
+//
+/** Name of the field in block holder, that references the actual block-pack. */
+const Holder = StdMap;
+const EphHolder = EphStdMap;
+const HolderRefField = 'ref';
+function wrapInHolder(tx, ref) {
+    const holder = tx.createStruct(Holder);
+    const mainHolderField = transaction.field(holder, HolderRefField);
+    tx.createField(mainHolderField, 'Input', ref);
+    tx.lock(holder);
+    return holder;
+}
+function wrapInEphHolder(tx, ref) {
+    const holder = tx.createEphemeral(EphHolder);
+    const mainHolderField = transaction.field(holder, HolderRefField);
+    tx.createField(mainHolderField, 'Input', ref);
+    tx.lock(holder);
+    return holder;
+}
+function unwrapHolder(tx, ref) {
+    return tx.getFutureFieldValue(ref, HolderRefField, 'Input');
+}
+
+exports.ClientRoot = ClientRoot;
+exports.EphHolder = EphHolder;
+exports.EphStdMap = EphStdMap;
+exports.Holder = Holder;
+exports.HolderRefField = HolderRefField;
+exports.JsonArray = JsonArray;
+exports.JsonBool = JsonBool;
+exports.JsonGzObject = JsonGzObject;
+exports.JsonNull = JsonNull;
+exports.JsonNumber = JsonNumber;
+exports.JsonObject = JsonObject;
+exports.JsonString = JsonString;
+exports.RNull = RNull;
+exports.StdMap = StdMap;
+exports.StructTestResource = StructTestResource;
+exports.ValueTestResource = ValueTestResource;
+exports.createPlArray = createPlArray;
+exports.createPlBool = createPlBool;
+exports.createPlMap = createPlMap;
+exports.createPlNull = createPlNull;
+exports.createPlNumber = createPlNumber;
+exports.createPlObject = createPlObject;
+exports.createPlString = createPlString;
+exports.futureRecord = futureRecord;
+exports.plEntries = plEntries;
+exports.plEntry = plEntry;
+exports.unwrapHolder = unwrapHolder;
+exports.wrapInEphHolder = wrapInEphHolder;
+exports.wrapInHolder = wrapInHolder;
+//# sourceMappingURL=pl.cjs.map

package/dist/helpers/pl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pl.cjs","sources":["../../src/helpers/pl.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * This file is exported under Pl \"namespace\" to the client users.\n *\n * It defines well known pl types, and methods to manipulate them.\n *\n */\n\nimport type { FutureFieldType, ResourceType } from '../core/types';\nimport type { AnyRef, FieldRef, PlTransaction, ResourceRef } from '../core/transaction';\nimport { field } from '../core/transaction';\n\nfunction rt(name: string, version: string): ResourceType {\n  return { name, version };\n}\n\nexport const ClientRoot = rt('ClientRoot', '1');\n\nexport const StructTestResource = rt('StructTest', '1');\nexport const ValueTestResource = rt('ValueTest', '1');\n\nexport const JsonString = rt('json/string', '1');\nexport const JsonBool = rt('json/bool', '1');\nexport const JsonObject = rt('json/object', '1');\nexport const JsonGzObject = rt('json-gz/object', '1');\nexport const JsonArray = rt('json/array', '1');\nexport const JsonNumber = rt('json/number', '1');\nexport const JsonNull = rt('json/null', '1');\n\nexport const RNull = rt('Null', '1');\n\nexport const EphStdMap: ResourceType = rt('EphStdMap', '1');\nexport const StdMap: ResourceType = rt('StdMap', '1');\n\n//\n// Standard value resources\n//\n\nexport function createPlNull(tx: PlTransaction): ResourceRef {\n  return tx.createValue(JsonNull, Buffer.from(JSON.stringify(null)));\n}\n\nexport function createPlBool(tx: PlTransaction, val: boolean): ResourceRef {\n  return tx.createValue(JsonBool, Buffer.from(JSON.stringify(val)));\n}\n\nexport function createPlNumber(tx: PlTransaction, val: number): ResourceRef {\n  return tx.createValue(JsonNumber, Buffer.from(JSON.stringify(val)));\n}\n\nexport function createPlString(tx: PlTransaction, val: string): ResourceRef {\n  return tx.createValue(JsonString, Buffer.from(JSON.stringify(val)));\n}\n\nexport function createPlArray(tx: PlTransaction, val: any[]): ResourceRef {\n  return tx.createValue(JsonArray, Buffer.from(JSON.stringify(val)));\n}\n\nexport function createPlObject(tx: PlTransaction, val: object): ResourceRef {\n  return tx.createValue(JsonObject, Buffer.from(JSON.stringify(val)));\n}\n\n//\n// Pl Map\n//\n\nexport type PlRecordEntry<Key extends string = string, Ref extends AnyRef = AnyRef> = [Key, Ref];\n\nexport type PlRecord<Key extends string = string, Ref extends AnyRef = AnyRef> = Record<Key, Ref>;\n\nexport function plEntry<Key extends string = string, Ref extends AnyRef = AnyRef>(\n  key: Key,\n  ref: Ref,\n): PlRecordEntry<Key, Ref> {\n  return [key, ref];\n}\n\nexport function plEntries<Key extends string = string, Ref extends AnyRef = AnyRef>(\n  record: PlRecord<Key, Ref>,\n  fields?: Key[],\n): PlRecordEntry<Key, Ref>[] {\n  return fields === undefined\n    ? (Object.entries(record) as PlRecordEntry<Key, Ref>[])\n    : fields.map((key) => plEntry(key, record[key]));\n}\n\n/** Helper method to build standard pl map from a set of entries */\nexport function createPlMap(\n  tx: PlTransaction,\n  entries: PlRecordEntry[] | PlRecord,\n  ephemeral: boolean,\n  type?: ResourceType,\n): ResourceRef {\n  const actualType = type ?? (ephemeral ? EphStdMap : StdMap);\n  const rId = ephemeral ? tx.createEphemeral(actualType) : tx.createStruct(actualType);\n\n  for (const [name, value] of Array.isArray(entries) ? entries : plEntries(entries))\n    tx.createField(field(rId, name), 'Input', value);\n\n  tx.lock(rId);\n\n  return rId;\n}\n\nexport function futureRecord<Key extends string>(\n  tx: PlTransaction,\n  rId: AnyRef,\n  keys: Key[],\n  fieldType: FutureFieldType,\n  prefix: string = '',\n): PlRecord<Key, FieldRef> {\n  return Object.fromEntries(\n    keys.map((k) => plEntry(k, tx.getFutureFieldValue(rId, `${prefix}${k}`, fieldType))),\n  ) as PlRecord<Key, FieldRef>;\n}\n\n//\n// Holder\n//\n\n/** Name of the field in block holder, that references the actual block-pack. */\nexport const Holder = StdMap;\nexport const EphHolder = EphStdMap;\nexport const HolderRefField = 'ref';\n\nexport function wrapInHolder(tx: PlTransaction, ref: AnyRef): ResourceRef {\n  const holder = tx.createStruct(Holder);\n  const mainHolderField = field(holder, HolderRefField);\n  tx.createField(mainHolderField, 'Input', ref);\n  tx.lock(holder);\n  return holder;\n}\n\nexport function wrapInEphHolder(tx: PlTransaction, ref: AnyRef): ResourceRef {\n  const holder = tx.createEphemeral(EphHolder);\n  const mainHolderField = field(holder, HolderRefField);\n  tx.createField(mainHolderField, 'Input', ref);\n  tx.lock(holder);\n  return holder;\n}\n\nexport function unwrapHolder(tx: PlTransaction, ref: AnyRef): FieldRef {\n  return tx.getFutureFieldValue(ref, HolderRefField, 'Input');\n}\n"],"names":["field"],"mappings":"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"}

package/dist/helpers/pl.d.ts

@@ -33,4 +33,3 @@ export declare const HolderRefField = "ref";
 export declare function wrapInHolder(tx: PlTransaction, ref: AnyRef): ResourceRef;
 export declare function wrapInEphHolder(tx: PlTransaction, ref: AnyRef): ResourceRef;
 export declare function unwrapHolder(tx: PlTransaction, ref: AnyRef): FieldRef;
-//# sourceMappingURL=pl.d.ts.map

package/dist/helpers/pl.js

@@ -0,0 +1,94 @@
+import { field } from '../core/transaction.js';
+
+/**
+ * @packageDocumentation
+ *
+ * This file is exported under Pl "namespace" to the client users.
+ *
+ * It defines well known pl types, and methods to manipulate them.
+ *
+ */
+function rt(name, version) {
+    return { name, version };
+}
+const ClientRoot = rt('ClientRoot', '1');
+const StructTestResource = rt('StructTest', '1');
+const ValueTestResource = rt('ValueTest', '1');
+const JsonString = rt('json/string', '1');
+const JsonBool = rt('json/bool', '1');
+const JsonObject = rt('json/object', '1');
+const JsonGzObject = rt('json-gz/object', '1');
+const JsonArray = rt('json/array', '1');
+const JsonNumber = rt('json/number', '1');
+const JsonNull = rt('json/null', '1');
+const RNull = rt('Null', '1');
+const EphStdMap = rt('EphStdMap', '1');
+const StdMap = rt('StdMap', '1');
+//
+// Standard value resources
+//
+function createPlNull(tx) {
+    return tx.createValue(JsonNull, Buffer.from(JSON.stringify(null)));
+}
+function createPlBool(tx, val) {
+    return tx.createValue(JsonBool, Buffer.from(JSON.stringify(val)));
+}
+function createPlNumber(tx, val) {
+    return tx.createValue(JsonNumber, Buffer.from(JSON.stringify(val)));
+}
+function createPlString(tx, val) {
+    return tx.createValue(JsonString, Buffer.from(JSON.stringify(val)));
+}
+function createPlArray(tx, val) {
+    return tx.createValue(JsonArray, Buffer.from(JSON.stringify(val)));
+}
+function createPlObject(tx, val) {
+    return tx.createValue(JsonObject, Buffer.from(JSON.stringify(val)));
+}
+function plEntry(key, ref) {
+    return [key, ref];
+}
+function plEntries(record, fields) {
+    return fields === undefined
+        ? Object.entries(record)
+        : fields.map((key) => plEntry(key, record[key]));
+}
+/** Helper method to build standard pl map from a set of entries */
+function createPlMap(tx, entries, ephemeral, type) {
+    const actualType = type ?? (ephemeral ? EphStdMap : StdMap);
+    const rId = ephemeral ? tx.createEphemeral(actualType) : tx.createStruct(actualType);
+    for (const [name, value] of Array.isArray(entries) ? entries : plEntries(entries))
+        tx.createField(field(rId, name), 'Input', value);
+    tx.lock(rId);
+    return rId;
+}
+function futureRecord(tx, rId, keys, fieldType, prefix = '') {
+    return Object.fromEntries(keys.map((k) => plEntry(k, tx.getFutureFieldValue(rId, `${prefix}${k}`, fieldType))));
+}
+//
+// Holder
+//
+/** Name of the field in block holder, that references the actual block-pack. */
+const Holder = StdMap;
+const EphHolder = EphStdMap;
+const HolderRefField = 'ref';
+function wrapInHolder(tx, ref) {
+    const holder = tx.createStruct(Holder);
+    const mainHolderField = field(holder, HolderRefField);
+    tx.createField(mainHolderField, 'Input', ref);
+    tx.lock(holder);
+    return holder;
+}
+function wrapInEphHolder(tx, ref) {
+    const holder = tx.createEphemeral(EphHolder);
+    const mainHolderField = field(holder, HolderRefField);
+    tx.createField(mainHolderField, 'Input', ref);
+    tx.lock(holder);
+    return holder;
+}
+function unwrapHolder(tx, ref) {
+    return tx.getFutureFieldValue(ref, HolderRefField, 'Input');
+}
+
+export { ClientRoot, EphHolder, EphStdMap, Holder, HolderRefField, JsonArray, JsonBool, JsonGzObject, JsonNull, JsonNumber, JsonObject, JsonString, RNull, StdMap, StructTestResource, ValueTestResource, createPlArray, createPlBool, createPlMap, createPlNull, createPlNumber, createPlObject, createPlString, futureRecord, plEntries, plEntry, unwrapHolder, wrapInEphHolder, wrapInHolder };
+//# sourceMappingURL=pl.js.map

package/dist/helpers/pl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pl.js","sources":["../../src/helpers/pl.ts"],"sourcesContent":["/**\n * @packageDocumentation\n *\n * This file is exported under Pl \"namespace\" to the client users.\n *\n * It defines well known pl types, and methods to manipulate them.\n *\n */\n\nimport type { FutureFieldType, ResourceType } from '../core/types';\nimport type { AnyRef, FieldRef, PlTransaction, ResourceRef } from '../core/transaction';\nimport { field } from '../core/transaction';\n\nfunction rt(name: string, version: string): ResourceType {\n  return { name, version };\n}\n\nexport const ClientRoot = rt('ClientRoot', '1');\n\nexport const StructTestResource = rt('StructTest', '1');\nexport const ValueTestResource = rt('ValueTest', '1');\n\nexport const JsonString = rt('json/string', '1');\nexport const JsonBool = rt('json/bool', '1');\nexport const JsonObject = rt('json/object', '1');\nexport const JsonGzObject = rt('json-gz/object', '1');\nexport const JsonArray = rt('json/array', '1');\nexport const JsonNumber = rt('json/number', '1');\nexport const JsonNull = rt('json/null', '1');\n\nexport const RNull = rt('Null', '1');\n\nexport const EphStdMap: ResourceType = rt('EphStdMap', '1');\nexport const StdMap: ResourceType = rt('StdMap', '1');\n\n//\n// Standard value resources\n//\n\nexport function createPlNull(tx: PlTransaction): ResourceRef {\n  return tx.createValue(JsonNull, Buffer.from(JSON.stringify(null)));\n}\n\nexport function createPlBool(tx: PlTransaction, val: boolean): ResourceRef {\n  return tx.createValue(JsonBool, Buffer.from(JSON.stringify(val)));\n}\n\nexport function createPlNumber(tx: PlTransaction, val: number): ResourceRef {\n  return tx.createValue(JsonNumber, Buffer.from(JSON.stringify(val)));\n}\n\nexport function createPlString(tx: PlTransaction, val: string): ResourceRef {\n  return tx.createValue(JsonString, Buffer.from(JSON.stringify(val)));\n}\n\nexport function createPlArray(tx: PlTransaction, val: any[]): ResourceRef {\n  return tx.createValue(JsonArray, Buffer.from(JSON.stringify(val)));\n}\n\nexport function createPlObject(tx: PlTransaction, val: object): ResourceRef {\n  return tx.createValue(JsonObject, Buffer.from(JSON.stringify(val)));\n}\n\n//\n// Pl Map\n//\n\nexport type PlRecordEntry<Key extends string = string, Ref extends AnyRef = AnyRef> = [Key, Ref];\n\nexport type PlRecord<Key extends string = string, Ref extends AnyRef = AnyRef> = Record<Key, Ref>;\n\nexport function plEntry<Key extends string = string, Ref extends AnyRef = AnyRef>(\n  key: Key,\n  ref: Ref,\n): PlRecordEntry<Key, Ref> {\n  return [key, ref];\n}\n\nexport function plEntries<Key extends string = string, Ref extends AnyRef = AnyRef>(\n  record: PlRecord<Key, Ref>,\n  fields?: Key[],\n): PlRecordEntry<Key, Ref>[] {\n  return fields === undefined\n    ? (Object.entries(record) as PlRecordEntry<Key, Ref>[])\n    : fields.map((key) => plEntry(key, record[key]));\n}\n\n/** Helper method to build standard pl map from a set of entries */\nexport function createPlMap(\n  tx: PlTransaction,\n  entries: PlRecordEntry[] | PlRecord,\n  ephemeral: boolean,\n  type?: ResourceType,\n): ResourceRef {\n  const actualType = type ?? (ephemeral ? EphStdMap : StdMap);\n  const rId = ephemeral ? tx.createEphemeral(actualType) : tx.createStruct(actualType);\n\n  for (const [name, value] of Array.isArray(entries) ? entries : plEntries(entries))\n    tx.createField(field(rId, name), 'Input', value);\n\n  tx.lock(rId);\n\n  return rId;\n}\n\nexport function futureRecord<Key extends string>(\n  tx: PlTransaction,\n  rId: AnyRef,\n  keys: Key[],\n  fieldType: FutureFieldType,\n  prefix: string = '',\n): PlRecord<Key, FieldRef> {\n  return Object.fromEntries(\n    keys.map((k) => plEntry(k, tx.getFutureFieldValue(rId, `${prefix}${k}`, fieldType))),\n  ) as PlRecord<Key, FieldRef>;\n}\n\n//\n// Holder\n//\n\n/** Name of the field in block holder, that references the actual block-pack. */\nexport const Holder = StdMap;\nexport const EphHolder = EphStdMap;\nexport const HolderRefField = 'ref';\n\nexport function wrapInHolder(tx: PlTransaction, ref: AnyRef): ResourceRef {\n  const holder = tx.createStruct(Holder);\n  const mainHolderField = field(holder, HolderRefField);\n  tx.createField(mainHolderField, 'Input', ref);\n  tx.lock(holder);\n  return holder;\n}\n\nexport function wrapInEphHolder(tx: PlTransaction, ref: AnyRef): ResourceRef {\n  const holder = tx.createEphemeral(EphHolder);\n  const mainHolderField = field(holder, HolderRefField);\n  tx.createField(mainHolderField, 'Input', ref);\n  tx.lock(holder);\n  return holder;\n}\n\nexport function unwrapHolder(tx: PlTransaction, ref: AnyRef): FieldRef {\n  return tx.getFutureFieldValue(ref, HolderRefField, 'Input');\n}\n"],"names":[],"mappings":"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"}