@milaboratories/pl-client 2.17.6 → 2.17.8

package/dist/core/type_conversion.js.map

@@ -1 +1 @@
-{"version":3,"file":"type_conversion.js","sources":["../../src/core/type_conversion.ts"],"sourcesContent":["import type {\n  Field,\n  Resource,\n} from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types\";\nimport {\n  Field_ValueStatus,\n  Resource_Kind,\n} from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types\";\nimport { FieldType as GrpcFieldType } from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/base_types\";\nimport type {\n  FieldData,\n  FieldStatus,\n  OptionalResourceId,\n  FieldType,\n  ResourceData,\n  ResourceId,\n  ResourceKind,\n} from \"./types\";\nimport { NullResourceId } from \"./types\";\nimport { assertNever, notEmpty } from \"@milaboratories/ts-helpers\";\nimport { throwPlNotFoundError } from \"./errors\";\n\nconst ResourceErrorField = \"resourceError\";\n\nfunction resourceIsDeleted(proto: Resource): boolean {\n  return proto.deletedTime !== undefined && proto.deletedTime.seconds !== 0n;\n}\n\n/** Throws \"native\" pl not found error, if resource is marked as deleted. */\nexport function protoToResource(proto: Resource): ResourceData {\n  if (resourceIsDeleted(proto)) throwPlNotFoundError(\"resource deleted\");\n  return {\n    id: proto.id as ResourceId,\n    originalResourceId: proto.originalResourceId as OptionalResourceId,\n    type: notEmpty(proto.type),\n    data: proto.data,\n    inputsLocked: proto.inputsLocked,\n    outputsLocked: proto.outputsLocked,\n    resourceReady: proto.resourceReady,\n    kind: protoToResourceKind(proto.kind),\n    error: protoToError(proto),\n    final: proto.isFinal,\n    fields: proto.fields?.filter((f) => f.id!.fieldName !== ResourceErrorField).map(protoToField),\n  };\n}\n\nfunction protoToResourceKind(proto: Resource_Kind): ResourceKind {\n  switch (proto) {\n    case Resource_Kind.STRUCTURAL:\n      return \"Structural\";\n    case Resource_Kind.VALUE:\n      return \"Value\";\n  }\n\n  throw new Error(\"invalid ResourceKind: \" + proto);\n}\n\nfunction protoToError(proto: Resource): OptionalResourceId {\n  const f = proto.fields.find((f) => f?.id?.fieldName === ResourceErrorField);\n  return (f?.error ?? NullResourceId) as OptionalResourceId;\n}\n\nexport function protoToField(proto: Field): FieldData {\n  return {\n    name: notEmpty(proto.id?.fieldName),\n    type: protoToFieldType(proto.type),\n    status: protoToFieldStatus(proto.valueStatus),\n    value: proto.value as OptionalResourceId,\n    error: proto.error as OptionalResourceId,\n    valueIsFinal: proto.valueIsFinal,\n  };\n}\n\nfunction protoToFieldType(proto: GrpcFieldType): FieldType {\n  switch (proto) {\n    case GrpcFieldType.INPUT:\n      return \"Input\";\n    case GrpcFieldType.OUTPUT:\n      return \"Output\";\n    case GrpcFieldType.SERVICE:\n      return \"Service\";\n    case GrpcFieldType.ONE_TIME_WRITABLE:\n      return \"OTW\";\n    case GrpcFieldType.DYNAMIC:\n      return \"Dynamic\";\n    case GrpcFieldType.MULTIPLE_TIMES_WRITABLE:\n      return \"MTW\";\n    default:\n      throw new Error(\"invalid FieldType: \" + proto);\n  }\n}\n\nfunction protoToFieldStatus(proto: Field_ValueStatus): FieldStatus {\n  switch (proto) {\n    case Field_ValueStatus.EMPTY:\n      return \"Empty\";\n    case Field_ValueStatus.ASSIGNED:\n      return \"Assigned\";\n    case Field_ValueStatus.RESOLVED:\n      return \"Resolved\";\n    default:\n      throw new Error(\"invalid FieldStatus: \" + proto);\n  }\n}\n\nexport function fieldTypeToProto(type: FieldType): GrpcFieldType {\n  switch (type) {\n    case \"Input\":\n      return GrpcFieldType.INPUT;\n    case \"Output\":\n      return GrpcFieldType.OUTPUT;\n    case \"Dynamic\":\n      return GrpcFieldType.DYNAMIC;\n    case \"Service\":\n      return GrpcFieldType.SERVICE;\n    case \"MTW\":\n      return GrpcFieldType.MULTIPLE_TIMES_WRITABLE;\n    case \"OTW\":\n      return GrpcFieldType.ONE_TIME_WRITABLE;\n    default:\n      return assertNever(type);\n  }\n}\n"],"names":["GrpcFieldType"],"mappings":"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"}
+{"version":3,"file":"type_conversion.js","names":["GrpcFieldType"],"sources":["../../src/core/type_conversion.ts"],"sourcesContent":["import type {\n  Field,\n  Resource,\n} from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types\";\nimport {\n  Field_ValueStatus,\n  Resource_Kind,\n} from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types\";\nimport { FieldType as GrpcFieldType } from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/base_types\";\nimport type {\n  FieldData,\n  FieldStatus,\n  OptionalResourceId,\n  FieldType,\n  ResourceData,\n  ResourceId,\n  ResourceKind,\n} from \"./types\";\nimport { NullResourceId } from \"./types\";\nimport { assertNever, notEmpty } from \"@milaboratories/ts-helpers\";\nimport { throwPlNotFoundError } from \"./errors\";\n\nconst ResourceErrorField = \"resourceError\";\n\nfunction resourceIsDeleted(proto: Resource): boolean {\n  return proto.deletedTime !== undefined && proto.deletedTime.seconds !== 0n;\n}\n\n/** Throws \"native\" pl not found error, if resource is marked as deleted. */\nexport function protoToResource(proto: Resource): ResourceData {\n  if (resourceIsDeleted(proto)) throwPlNotFoundError(\"resource deleted\");\n  return {\n    id: proto.id as ResourceId,\n    originalResourceId: proto.originalResourceId as OptionalResourceId,\n    type: notEmpty(proto.type),\n    data: proto.data,\n    inputsLocked: proto.inputsLocked,\n    outputsLocked: proto.outputsLocked,\n    resourceReady: proto.resourceReady,\n    kind: protoToResourceKind(proto.kind),\n    error: protoToError(proto),\n    final: proto.isFinal,\n    fields: proto.fields?.filter((f) => f.id!.fieldName !== ResourceErrorField).map(protoToField),\n  };\n}\n\nfunction protoToResourceKind(proto: Resource_Kind): ResourceKind {\n  switch (proto) {\n    case Resource_Kind.STRUCTURAL:\n      return \"Structural\";\n    case Resource_Kind.VALUE:\n      return \"Value\";\n  }\n\n  throw new Error(\"invalid ResourceKind: \" + proto);\n}\n\nfunction protoToError(proto: Resource): OptionalResourceId {\n  const f = proto.fields.find((f) => f?.id?.fieldName === ResourceErrorField);\n  return (f?.error ?? NullResourceId) as OptionalResourceId;\n}\n\nexport function protoToField(proto: Field): FieldData {\n  return {\n    name: notEmpty(proto.id?.fieldName),\n    type: protoToFieldType(proto.type),\n    status: protoToFieldStatus(proto.valueStatus),\n    value: proto.value as OptionalResourceId,\n    error: proto.error as OptionalResourceId,\n    valueIsFinal: proto.valueIsFinal,\n  };\n}\n\nfunction protoToFieldType(proto: GrpcFieldType): FieldType {\n  switch (proto) {\n    case GrpcFieldType.INPUT:\n      return \"Input\";\n    case GrpcFieldType.OUTPUT:\n      return \"Output\";\n    case GrpcFieldType.SERVICE:\n      return \"Service\";\n    case GrpcFieldType.ONE_TIME_WRITABLE:\n      return \"OTW\";\n    case GrpcFieldType.DYNAMIC:\n      return \"Dynamic\";\n    case GrpcFieldType.MULTIPLE_TIMES_WRITABLE:\n      return \"MTW\";\n    default:\n      throw new Error(\"invalid FieldType: \" + proto);\n  }\n}\n\nfunction protoToFieldStatus(proto: Field_ValueStatus): FieldStatus {\n  switch (proto) {\n    case Field_ValueStatus.EMPTY:\n      return \"Empty\";\n    case Field_ValueStatus.ASSIGNED:\n      return \"Assigned\";\n    case Field_ValueStatus.RESOLVED:\n      return \"Resolved\";\n    default:\n      throw new Error(\"invalid FieldStatus: \" + proto);\n  }\n}\n\nexport function fieldTypeToProto(type: FieldType): GrpcFieldType {\n  switch (type) {\n    case \"Input\":\n      return GrpcFieldType.INPUT;\n    case \"Output\":\n      return GrpcFieldType.OUTPUT;\n    case \"Dynamic\":\n      return GrpcFieldType.DYNAMIC;\n    case \"Service\":\n      return GrpcFieldType.SERVICE;\n    case \"MTW\":\n      return GrpcFieldType.MULTIPLE_TIMES_WRITABLE;\n    case \"OTW\":\n      return GrpcFieldType.ONE_TIME_WRITABLE;\n    default:\n      return assertNever(type);\n  }\n}\n"],"mappings":";;;;;;;AAsBA,MAAM,qBAAqB;AAE3B,SAAS,kBAAkB,OAA0B;AACnD,QAAO,MAAM,gBAAgB,UAAa,MAAM,YAAY,YAAY;;;AAI1E,SAAgB,gBAAgB,OAA+B;AAC7D,KAAI,kBAAkB,MAAM,CAAE,sBAAqB,mBAAmB;AACtE,QAAO;EACL,IAAI,MAAM;EACV,oBAAoB,MAAM;EAC1B,MAAM,SAAS,MAAM,KAAK;EAC1B,MAAM,MAAM;EACZ,cAAc,MAAM;EACpB,eAAe,MAAM;EACrB,eAAe,MAAM;EACrB,MAAM,oBAAoB,MAAM,KAAK;EACrC,OAAO,aAAa,MAAM;EAC1B,OAAO,MAAM;EACb,QAAQ,MAAM,QAAQ,QAAQ,MAAM,EAAE,GAAI,cAAc,mBAAmB,CAAC,IAAI,aAAa;EAC9F;;AAGH,SAAS,oBAAoB,OAAoC;AAC/D,SAAQ,OAAR;EACE,KAAK,cAAc,WACjB,QAAO;EACT,KAAK,cAAc,MACjB,QAAO;;AAGX,OAAM,IAAI,MAAM,2BAA2B,MAAM;;AAGnD,SAAS,aAAa,OAAqC;AAEzD,QADU,MAAM,OAAO,MAAM,MAAM,GAAG,IAAI,cAAc,mBAAmB,EAChE,SAAS;;AAGtB,SAAgB,aAAa,OAAyB;AACpD,QAAO;EACL,MAAM,SAAS,MAAM,IAAI,UAAU;EACnC,MAAM,iBAAiB,MAAM,KAAK;EAClC,QAAQ,mBAAmB,MAAM,YAAY;EAC7C,OAAO,MAAM;EACb,OAAO,MAAM;EACb,cAAc,MAAM;EACrB;;AAGH,SAAS,iBAAiB,OAAiC;AACzD,SAAQ,OAAR;EACE,KAAKA,UAAc,MACjB,QAAO;EACT,KAAKA,UAAc,OACjB,QAAO;EACT,KAAKA,UAAc,QACjB,QAAO;EACT,KAAKA,UAAc,kBACjB,QAAO;EACT,KAAKA,UAAc,QACjB,QAAO;EACT,KAAKA,UAAc,wBACjB,QAAO;EACT,QACE,OAAM,IAAI,MAAM,wBAAwB,MAAM;;;AAIpD,SAAS,mBAAmB,OAAuC;AACjE,SAAQ,OAAR;EACE,KAAK,kBAAkB,MACrB,QAAO;EACT,KAAK,kBAAkB,SACrB,QAAO;EACT,KAAK,kBAAkB,SACrB,QAAO;EACT,QACE,OAAM,IAAI,MAAM,0BAA0B,MAAM;;;AAItD,SAAgB,iBAAiB,MAAgC;AAC/D,SAAQ,MAAR;EACE,KAAK,QACH,QAAOA,UAAc;EACvB,KAAK,SACH,QAAOA,UAAc;EACvB,KAAK,UACH,QAAOA,UAAc;EACvB,KAAK,UACH,QAAOA,UAAc;EACvB,KAAK,MACH,QAAOA,UAAc;EACvB,KAAK,MACH,QAAOA,UAAc;EACvB,QACE,QAAO,YAAY,KAAK"}

package/dist/core/types.cjs

@@ -1,137 +1,107 @@
-'use strict';
-
-var tsHelpers = require('@milaboratories/ts-helpers');
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
 
+//#region src/core/types.ts
 const NullResourceId = 0n;
 function isNullResourceId(resourceId) {
-    return resourceId === NullResourceId;
+	return resourceId === NullResourceId;
 }
 function isNotNullResourceId(resourceId) {
-    return resourceId !== NullResourceId;
+	return resourceId !== NullResourceId;
 }
 function ensureResourceIdNotNull(resourceId) {
-    if (!isNotNullResourceId(resourceId))
-        throw new Error("null resource id");
-    return resourceId;
+	if (!isNotNullResourceId(resourceId)) throw new Error("null resource id");
+	return resourceId;
 }
 function isAnyResourceId(resourceId) {
-    return resourceId !== 0n;
+	return resourceId !== 0n;
 }
 function resourceType(name, version) {
-    return { name, version };
+	return {
+		name,
+		version
+	};
 }
 function resourceTypeToString(rt) {
-    return `${rt.name}:${rt.version}`;
+	return `${rt.name}:${rt.version}`;
 }
 function resourceTypesEqual(type1, type2) {
-    return type1.name === type2.name && type1.version === type2.version;
+	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 { 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) => tsHelpers.cachedDeserialize(tsHelpers.notEmpty(res.data));
+const resDataToJson = (res) => (0, _milaboratories_ts_helpers.cachedDeserialize)((0, _milaboratories_ts_helpers.notEmpty)(res.data));
 function getField(r, name) {
-    return tsHelpers.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
+	return (0, _milaboratories_ts_helpers.notEmpty)(r.fields.find((f) => f.name === name));
+}
 const ResourceIdRootMask = 1n << 63n;
 const ResourceIdLocalMask = 1n << 62n;
-const NoFlagsIdMask = 0x3fffffffffffffffn;
+const NoFlagsIdMask = 4611686018427387903n;
 const LocalResourceIdTxIdOffset = 24n;
-const MaxLocalId = 0xffffff;
-const MaxTxId = 0xffffffff;
+const MaxLocalId = 16777215;
+const MaxTxId = 4294967295;
 /** 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;
+	return (id & ResourceIdRootMask) !== 0n;
 }
 function isLocalResourceId(id) {
-    return (id & ResourceIdLocalMask) !== 0n;
+	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));
+	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);
+	return (isRoot ? ResourceIdRootMask : 0n) | unmaskedId;
 }
 function extractTxId(localResourceId) {
-    return Number((localResourceId >> LocalResourceIdTxIdOffset) & TxIdMask);
+	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");
+	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));
+	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));
+	const match = str.match(resourceIdRegexp);
+	if (match === null) return void 0;
+	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;
+	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);
+	return JSON.stringify(object, (key, value) => typeof value === "bigint" ? resourceIdToString(value) : value);
 }
 
+//#endregion
 exports.MaxLocalId = MaxLocalId;
 exports.MaxTxId = MaxTxId;
 exports.NullResourceId = NullResourceId;
@@ -156,4 +126,4 @@ exports.resourceType = resourceType;
 exports.resourceTypeToString = resourceTypeToString;
 exports.resourceTypesEqual = resourceTypesEqual;
 exports.stringifyWithResourceId = stringifyWithResourceId;
-//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/core/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","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":["cachedDeserialize","notEmpty"],"mappings":"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"}
+{"version":3,"file":"types.cjs","names":[],"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"],"mappings":"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"}

package/dist/core/types.d.ts

@@ -1,78 +1,79 @@
+//#region src/core/types.d.ts
 declare const __resource_id_type__: unique symbol;
 type BrandResourceId<B> = bigint & {
-    [__resource_id_type__]: B;
+  [__resource_id_type__]: B;
 };
 /** Global resource id */
-export type ResourceId = BrandResourceId<"global">;
+type ResourceId = BrandResourceId<"global">;
 /** Null resource id */
-export type NullResourceId = BrandResourceId<"null">;
+type NullResourceId = BrandResourceId<"null">;
 /** Local resource id */
-export type LocalResourceId = BrandResourceId<"local">;
+type LocalResourceId = BrandResourceId<"local">;
 /** Any non-null resource id */
-export type AnyResourceId = ResourceId | LocalResourceId;
+type AnyResourceId = ResourceId | LocalResourceId;
 /** Any resource id */
-export type OptionalResourceId = NullResourceId | ResourceId;
+type OptionalResourceId = NullResourceId | ResourceId;
 /** All possible resource flavours */
-export type OptionalAnyResourceId = NullResourceId | ResourceId | LocalResourceId;
-export declare const NullResourceId: NullResourceId;
-export declare function isNullResourceId(resourceId: bigint): resourceId is NullResourceId;
-export declare function isNotNullResourceId(resourceId: OptionalResourceId): resourceId is ResourceId;
-export declare function ensureResourceIdNotNull(resourceId: OptionalResourceId): ResourceId;
-export declare function isAnyResourceId(resourceId: bigint): resourceId is AnyResourceId;
-export type ResourceKind = "Structural" | "Value";
-export type FieldType = "Input" | "Output" | "Service" | "OTW" | "Dynamic" | "MTW";
-export type FutureFieldType = "Output" | "Input" | "Service";
-export type FieldStatus = "Empty" | "Assigned" | "Resolved";
-export interface ResourceType {
-    readonly name: string;
-    readonly version: string;
+type OptionalAnyResourceId = NullResourceId | ResourceId | LocalResourceId;
+declare const NullResourceId: NullResourceId;
+declare function isNullResourceId(resourceId: bigint): resourceId is NullResourceId;
+declare function isNotNullResourceId(resourceId: OptionalResourceId): resourceId is ResourceId;
+declare function ensureResourceIdNotNull(resourceId: OptionalResourceId): ResourceId;
+declare function isAnyResourceId(resourceId: bigint): resourceId is AnyResourceId;
+type ResourceKind = "Structural" | "Value";
+type FieldType = "Input" | "Output" | "Service" | "OTW" | "Dynamic" | "MTW";
+type FutureFieldType = "Output" | "Input" | "Service";
+type FieldStatus = "Empty" | "Assigned" | "Resolved";
+interface ResourceType {
+  readonly name: string;
+  readonly version: string;
 }
-export declare function resourceType(name: string, version: string): ResourceType;
-export declare function resourceTypeToString(rt: ResourceType): string;
-export declare function resourceTypesEqual(type1: ResourceType, type2: ResourceType): boolean;
+declare function resourceType(name: string, version: string): ResourceType;
+declare function resourceTypeToString(rt: ResourceType): string;
+declare function resourceTypesEqual(type1: ResourceType, type2: ResourceType): boolean;
 /** Readonly fields here marks properties of resource that can't change according to pl's state machine. */
-export type BasicResourceData = {
-    readonly id: ResourceId;
-    readonly originalResourceId: OptionalResourceId;
-    readonly kind: ResourceKind;
-    readonly type: ResourceType;
-    readonly data?: Uint8Array;
-    readonly error: OptionalResourceId;
-    readonly inputsLocked: boolean;
-    readonly outputsLocked: boolean;
-    readonly resourceReady: boolean;
-    /** This value is derived from resource state by the server and can be used as
-     * a robust criteria to determine resource is in final state. */
-    readonly final: boolean;
+type BasicResourceData = {
+  readonly id: ResourceId;
+  readonly originalResourceId: OptionalResourceId;
+  readonly kind: ResourceKind;
+  readonly type: ResourceType;
+  readonly data?: Uint8Array;
+  readonly error: OptionalResourceId;
+  readonly inputsLocked: boolean;
+  readonly outputsLocked: boolean;
+  readonly resourceReady: boolean;
+  /** This value is derived from resource state by the server and can be used as
+   * a robust criteria to determine resource is in final state. */
+  readonly final: boolean;
 };
-export declare function extractBasicResourceData(rd: ResourceData): BasicResourceData;
-export declare const jsonToData: (data: unknown) => Buffer;
-export declare const resDataToJson: (res: ResourceData) => unknown;
-export type ResourceData = BasicResourceData & {
-    readonly fields: FieldData[];
+declare function extractBasicResourceData(rd: ResourceData): BasicResourceData;
+declare const jsonToData: (data: unknown) => Buffer<ArrayBuffer>;
+declare const resDataToJson: (res: ResourceData) => unknown;
+type ResourceData = BasicResourceData & {
+  readonly fields: FieldData[];
 };
-export declare function getField(r: ResourceData, name: string): FieldData;
-export type FieldData = {
-    readonly name: string;
-    readonly type: FieldType;
-    readonly status: FieldStatus;
-    readonly value: OptionalResourceId;
-    readonly error: OptionalResourceId;
-    /** True if value the fields points to is in final state. */
-    readonly valueIsFinal: boolean;
+declare function getField(r: ResourceData, name: string): FieldData;
+type FieldData = {
+  readonly name: string;
+  readonly type: FieldType;
+  readonly status: FieldStatus;
+  readonly value: OptionalResourceId;
+  readonly error: OptionalResourceId; /** True if value the fields points to is in final state. */
+  readonly valueIsFinal: boolean;
 };
-export declare const MaxLocalId = 16777215;
-export declare const MaxTxId = 4294967295;
-export declare function isRootResourceId(id: bigint): boolean;
-export declare function isLocalResourceId(id: bigint): id is LocalResourceId;
-export declare function createLocalResourceId(isRoot: boolean, localCounterValue: number, localTxId: number): LocalResourceId;
-export declare function createGlobalResourceId(isRoot: boolean, unmaskedId: bigint): ResourceId;
-export declare function extractTxId(localResourceId: LocalResourceId): number;
-export declare function checkLocalityOfResourceId(resourceId: AnyResourceId, expectedTxId: number): void;
-export declare function resourceIdToString(resourceId: OptionalAnyResourceId): string;
-export declare function resourceIdFromString(str: string): OptionalAnyResourceId | undefined;
+declare const MaxLocalId = 16777215;
+declare const MaxTxId = 4294967295;
+declare function isRootResourceId(id: bigint): boolean;
+declare function isLocalResourceId(id: bigint): id is LocalResourceId;
+declare function createLocalResourceId(isRoot: boolean, localCounterValue: number, localTxId: number): LocalResourceId;
+declare function createGlobalResourceId(isRoot: boolean, unmaskedId: bigint): ResourceId;
+declare function extractTxId(localResourceId: LocalResourceId): number;
+declare function checkLocalityOfResourceId(resourceId: AnyResourceId, expectedTxId: number): void;
+declare function resourceIdToString(resourceId: OptionalAnyResourceId): string;
+declare function resourceIdFromString(str: string): OptionalAnyResourceId | undefined;
 /** Converts bigint to global resource id */
-export declare function bigintToResourceId(resourceId: bigint): ResourceId;
-export declare function stringifyWithResourceId(object: unknown): string;
-export {};
+declare function bigintToResourceId(resourceId: bigint): ResourceId;
+declare function stringifyWithResourceId(object: unknown): string;
+//#endregion
+export { 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 };
 //# sourceMappingURL=types.d.ts.map

package/dist/core/types.js

@@ -1,134 +1,105 @@
-import { cachedDeserialize, notEmpty } from '@milaboratories/ts-helpers';
+import { cachedDeserialize, notEmpty } from "@milaboratories/ts-helpers";
 
+//#region src/core/types.ts
 const NullResourceId = 0n;
 function isNullResourceId(resourceId) {
-    return resourceId === NullResourceId;
+	return resourceId === NullResourceId;
 }
 function isNotNullResourceId(resourceId) {
-    return resourceId !== NullResourceId;
+	return resourceId !== NullResourceId;
 }
 function ensureResourceIdNotNull(resourceId) {
-    if (!isNotNullResourceId(resourceId))
-        throw new Error("null resource id");
-    return resourceId;
+	if (!isNotNullResourceId(resourceId)) throw new Error("null resource id");
+	return resourceId;
 }
 function isAnyResourceId(resourceId) {
-    return resourceId !== 0n;
+	return resourceId !== 0n;
 }
 function resourceType(name, version) {
-    return { name, version };
+	return {
+		name,
+		version
+	};
 }
 function resourceTypeToString(rt) {
-    return `${rt.name}:${rt.version}`;
+	return `${rt.name}:${rt.version}`;
 }
 function resourceTypesEqual(type1, type2) {
-    return type1.name === type2.name && type1.version === type2.version;
+	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 { 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
+	return notEmpty(r.fields.find((f) => f.name === name));
+}
 const ResourceIdRootMask = 1n << 63n;
 const ResourceIdLocalMask = 1n << 62n;
-const NoFlagsIdMask = 0x3fffffffffffffffn;
+const NoFlagsIdMask = 4611686018427387903n;
 const LocalResourceIdTxIdOffset = 24n;
-const MaxLocalId = 0xffffff;
-const MaxTxId = 0xffffffff;
+const MaxLocalId = 16777215;
+const MaxTxId = 4294967295;
 /** 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;
+	return (id & ResourceIdRootMask) !== 0n;
 }
 function isLocalResourceId(id) {
-    return (id & ResourceIdLocalMask) !== 0n;
+	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));
+	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);
+	return (isRoot ? ResourceIdRootMask : 0n) | unmaskedId;
 }
 function extractTxId(localResourceId) {
-    return Number((localResourceId >> LocalResourceIdTxIdOffset) & TxIdMask);
+	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");
+	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));
+	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));
+	const match = str.match(resourceIdRegexp);
+	if (match === null) return void 0;
+	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;
+	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);
+	return JSON.stringify(object, (key, value) => typeof value === "bigint" ? resourceIdToString(value) : value);
 }
 
+//#endregion
 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
+//# sourceMappingURL=types.js.map