@milaboratories/pl-client 3.2.5 → 3.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/core/client.cjs +24 -56
- package/dist/core/client.cjs.map +1 -1
- package/dist/core/client.d.ts +12 -8
- package/dist/core/client.d.ts.map +1 -1
- package/dist/core/client.js +26 -58
- package/dist/core/client.js.map +1 -1
- package/dist/core/errors.cjs +20 -0
- package/dist/core/errors.cjs.map +1 -1
- package/dist/core/errors.d.ts +6 -1
- package/dist/core/errors.d.ts.map +1 -1
- package/dist/core/errors.js +19 -1
- package/dist/core/errors.js.map +1 -1
- package/dist/core/final.cjs +6 -5
- package/dist/core/final.cjs.map +1 -1
- package/dist/core/final.d.ts.map +1 -1
- package/dist/core/final.js +7 -6
- package/dist/core/final.js.map +1 -1
- package/dist/core/ll_client.cjs +18 -1
- package/dist/core/ll_client.cjs.map +1 -1
- package/dist/core/ll_client.d.ts +6 -2
- package/dist/core/ll_client.d.ts.map +1 -1
- package/dist/core/ll_client.js +19 -2
- package/dist/core/ll_client.js.map +1 -1
- package/dist/core/transaction.cjs +109 -75
- package/dist/core/transaction.cjs.map +1 -1
- package/dist/core/transaction.d.ts +30 -22
- package/dist/core/transaction.d.ts.map +1 -1
- package/dist/core/transaction.js +111 -76
- package/dist/core/transaction.js.map +1 -1
- package/dist/core/type_conversion.cjs +14 -6
- package/dist/core/type_conversion.cjs.map +1 -1
- package/dist/core/type_conversion.js +14 -6
- package/dist/core/type_conversion.js.map +1 -1
- package/dist/core/types.cjs +77 -17
- package/dist/core/types.cjs.map +1 -1
- package/dist/core/types.d.ts +49 -26
- package/dist/core/types.d.ts.map +1 -1
- package/dist/core/types.js +66 -14
- package/dist/core/types.js.map +1 -1
- package/dist/core/user_resources.cjs +181 -0
- package/dist/core/user_resources.cjs.map +1 -0
- package/dist/core/user_resources.d.ts +75 -0
- package/dist/core/user_resources.d.ts.map +1 -0
- package/dist/core/user_resources.js +180 -0
- package/dist/core/user_resources.js.map +1 -0
- package/dist/helpers/poll.cjs +4 -4
- package/dist/helpers/poll.cjs.map +1 -1
- package/dist/helpers/poll.d.ts +3 -3
- package/dist/helpers/poll.d.ts.map +1 -1
- package/dist/helpers/poll.js +5 -5
- package/dist/helpers/poll.js.map +1 -1
- package/dist/helpers/tx_helpers.cjs +1 -1
- package/dist/helpers/tx_helpers.cjs.map +1 -1
- package/dist/helpers/tx_helpers.d.ts +3 -3
- package/dist/helpers/tx_helpers.d.ts.map +1 -1
- package/dist/helpers/tx_helpers.js +2 -2
- package/dist/helpers/tx_helpers.js.map +1 -1
- package/dist/index.cjs +16 -5
- package/dist/index.d.ts +5 -4
- package/dist/index.js +5 -4
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.cjs +724 -188
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.cjs.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.client.cjs +34 -9
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.client.cjs.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.client.d.ts +37 -5
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.client.d.ts.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.client.js +34 -9
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.client.js.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.d.ts +326 -136
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.d.ts.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.js +724 -188
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.js.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types.cjs +18 -7
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types.cjs.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types.d.ts +11 -7
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types.d.ts.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types.js +18 -7
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types.js.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/base_types.cjs +57 -2
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/base_types.cjs.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/base_types.d.ts +26 -3
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/base_types.d.ts.map +1 -1
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/base_types.js +57 -3
- package/dist/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/base_types.js.map +1 -1
- package/dist/proto-rest/plapi.d.ts +421 -207
- package/dist/proto-rest/plapi.d.ts.map +1 -1
- package/dist/test/test_config.cjs +6 -3
- package/dist/test/test_config.cjs.map +1 -1
- package/dist/test/test_config.d.ts.map +1 -1
- package/dist/test/test_config.js +7 -4
- package/dist/test/test_config.js.map +1 -1
- package/package.json +5 -5
- package/src/core/client.ts +58 -103
- package/src/core/errors.ts +23 -0
- package/src/core/final.ts +16 -6
- package/src/core/ll_client.ts +39 -3
- package/src/core/ll_transaction.test.ts +41 -6
- package/src/core/transaction.ts +176 -86
- package/src/core/type_conversion.ts +24 -9
- package/src/core/types.ts +147 -41
- package/src/core/user_resources.ts +332 -0
- package/src/helpers/poll.ts +15 -8
- package/src/helpers/state_helpers.ts +2 -2
- package/src/helpers/tx_helpers.ts +5 -5
- package/src/index.ts +1 -0
- package/src/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.client.ts +61 -14
- package/src/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.ts +1045 -379
- package/src/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api_types.ts +33 -18
- package/src/proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/base_types.ts +75 -6
- package/src/proto-grpc/google/protobuf/descriptor.ts +5 -2
- package/src/proto-rest/plapi.ts +447 -225
- package/src/test/test_config.ts +8 -5
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transaction.cjs","names":["isLocalResourceId","isNullResourceId","isNotFoundError","PromiseTracker","initialTxStatWithoutTime","TxAPI_Open_Request_WritableTx","ensureResourceIdNotNull","protoToResource","JsonObject","JsonGzObject","ErrorResourceType","extractBasicResourceData","fieldTypeToProto","protoToField","toBytes","createLocalResourceId"],"sources":["../../src/core/transaction.ts"],"sourcesContent":["// TODO: fix this\n/* eslint-disable no-prototype-builtins */\nimport type {\n AnyResourceId,\n LocalResourceId,\n OptionalResourceId,\n BasicResourceData,\n FieldData,\n FieldType,\n ResourceData,\n ResourceId,\n ResourceType,\n FutureFieldType,\n} from \"./types\";\nimport {\n createLocalResourceId,\n ensureResourceIdNotNull,\n MaxTxId,\n isLocalResourceId,\n extractBasicResourceData,\n isNullResourceId,\n} from \"./types\";\nimport type {\n ClientMessageRequest,\n LLPlTransaction,\n OneOfKind,\n ServerMessageResponse,\n} from \"./ll_transaction\";\nimport { TxAPI_Open_Request_WritableTx } from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api\";\nimport type { NonUndefined } from \"utility-types\";\nimport { toBytes } from \"../util/util\";\nimport { fieldTypeToProto, protoToField, protoToResource } from \"./type_conversion\";\nimport {\n canonicalJsonBytes,\n canonicalJsonGzBytes,\n deepFreeze,\n notEmpty,\n} from \"@milaboratories/ts-helpers\";\nimport { isNotFoundError } from \"./errors\";\nimport type { FinalResourceDataPredicate } from \"./final\";\nimport type { LRUCache } from \"lru-cache\";\nimport type { ResourceDataCacheRecord } from \"./cache\";\nimport type { TxStat } from \"./stat\";\nimport { initialTxStatWithoutTime } from \"./stat\";\nimport type { ErrorResourceData } from \"./error_resource\";\nimport { ErrorResourceType } from \"./error_resource\";\nimport { JsonGzObject, JsonObject } from \"../helpers/pl\";\nimport { PromiseTracker } from \"./PromiseTracker\";\n\n/** Reference to resource, used only within transaction */\nexport interface ResourceRef {\n /** Global resource id of newly created resources, become available only\n * after response for the corresponding creation request is received. */\n readonly globalId: Promise<ResourceId>;\n\n /** Transaction-local resource id is assigned right after resource creation\n * request is sent, and can be used right away */\n readonly localId: LocalResourceId;\n}\n\n/** Key-Value pair from resource-attached KV storage */\nexport interface KeyValue {\n key: string;\n value: Uint8Array;\n}\n\n/** Key-Value pair from resource-attached KV storage */\nexport interface KeyValueString {\n key: string;\n value: string;\n}\n\ninterface _FieldId<RId> {\n /** Parent resource id */\n resourceId: RId;\n /** Field name */\n fieldName: string;\n}\n\nexport type FieldId = _FieldId<ResourceId>;\nexport type FieldRef = _FieldId<ResourceRef>;\nexport type LocalFieldId = _FieldId<LocalResourceId>;\nexport type AnyFieldId = FieldId | LocalFieldId;\n\nexport type AnyResourceRef = ResourceRef | ResourceId;\nexport type AnyFieldRef = _FieldId<AnyResourceRef>; // FieldRef | FieldId\nexport type AnyRef = AnyResourceRef | AnyFieldRef;\n\nexport function isField(ref: AnyRef): ref is AnyFieldRef {\n return ref.hasOwnProperty(\"resourceId\") && ref.hasOwnProperty(\"fieldName\");\n}\n\nexport function isResource(ref: AnyRef): ref is AnyResourceRef {\n return (\n typeof ref === \"bigint\" || (ref.hasOwnProperty(\"globalId\") && ref.hasOwnProperty(\"localId\"))\n );\n}\n\nexport function isResourceId(ref: AnyRef): ref is ResourceId {\n return typeof ref === \"bigint\" && !isLocalResourceId(ref) && !isNullResourceId(ref);\n}\n\nexport function isFieldRef(ref: AnyFieldRef): ref is FieldRef {\n return isResourceRef(ref.resourceId);\n}\n\nexport function isResourceRef(ref: AnyResourceRef): ref is ResourceRef {\n return ref.hasOwnProperty(\"globalId\") && ref.hasOwnProperty(\"localId\");\n}\n\nexport function toFieldId(ref: AnyFieldRef): AnyFieldId {\n if (isFieldRef(ref)) return { resourceId: ref.resourceId.localId, fieldName: ref.fieldName };\n else return ref as FieldId;\n}\n\nexport async function toGlobalFieldId(ref: AnyFieldRef): Promise<FieldId> {\n if (isFieldRef(ref))\n return { resourceId: await ref.resourceId.globalId, fieldName: ref.fieldName };\n else return ref as FieldId;\n}\n\nexport function toResourceId(ref: AnyResourceRef): AnyResourceId {\n if (isResourceRef(ref)) return ref.localId;\n else return ref;\n}\n\nexport async function toGlobalResourceId(ref: AnyResourceRef): Promise<ResourceId> {\n if (isResourceRef(ref)) return await ref.globalId;\n else return ref;\n}\n\nexport function field(resourceId: AnyResourceRef, fieldName: string): AnyFieldRef {\n return { resourceId, fieldName };\n}\n\n/** If transaction commit failed due to write conflicts */\nexport class TxCommitConflict extends Error {\n name = \"TxCommitConflict\";\n}\n\nasync function notFoundToUndefined<T>(cb: () => Promise<T>): Promise<T | undefined> {\n try {\n return await cb();\n } catch (e) {\n if (isNotFoundError(e)) return undefined;\n throw e;\n }\n}\n\n/**\n * Each platform transaction has 3 stages:\n * - initialization (txOpen message -> txInfo response)\n * - communication (create resources, fields, references and so on)\n * - finalization (txCommit or txDiscard message)\n *\n * This class encapsulates finalization stage and provides ready-to-communication transaction object.\n * */\nexport class PlTransaction {\n private readonly globalTxId: Promise<bigint>;\n private readonly localTxId: number = PlTransaction.nextLocalTxId();\n\n /** Used in caching */\n private readonly txOpenTimestamp = Date.now();\n\n private localResourceIdCounter = 0;\n\n /** Store logical tx open / closed state to prevent invalid sequence of requests.\n * True means output stream was completed.\n * Contract: there must be no async operations between setting this field to true and sending complete signal to stream. */\n private _completed = false;\n\n private globalTxIdWasAwaited: boolean = false;\n\n public readonly pending = new PromiseTracker();\n\n private readonly _startTime = Date.now();\n private readonly _stat = initialTxStatWithoutTime();\n public get stat(): TxStat {\n return {\n ...this._stat,\n timeMs: Date.now() - this._startTime,\n };\n }\n\n constructor(\n private readonly ll: LLPlTransaction,\n public readonly name: string,\n public readonly writable: boolean,\n private readonly _clientRoot: OptionalResourceId,\n private readonly finalPredicate: FinalResourceDataPredicate,\n private readonly sharedResourceDataCache: LRUCache<ResourceId, ResourceDataCacheRecord>,\n private readonly enableFormattedErrors: boolean = false,\n ) {\n // initiating transaction\n this.globalTxId = this.sendSingleAndParse(\n {\n oneofKind: \"txOpen\",\n txOpen: {\n name,\n enableFormattedErrors,\n writable: writable\n ? TxAPI_Open_Request_WritableTx.WRITABLE\n : TxAPI_Open_Request_WritableTx.NOT_WRITABLE,\n },\n },\n (r) => notEmpty(r.txOpen.tx?.id),\n );\n\n void this.track(this.globalTxId);\n\n // To avoid floating promise\n this.globalTxId.catch((err) => {\n if (!this.globalTxIdWasAwaited) {\n console.warn(err);\n }\n });\n\n // Adding stats\n this._stat.txCount++;\n }\n\n /**\n * Collect all pending promises for the transaction finalization.\n */\n public track<T>(promiseOrCallback: Promise<T> | (() => Promise<T>)): Promise<T> {\n return this.pending.track(promiseOrCallback);\n }\n\n private async drainAndAwaitPendingOps(): Promise<void> {\n // awaiting these pending operations first, to catch any errors\n await this.pending.awaitAll();\n }\n\n private sendSingleAndParse<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>, T>(\n r: OneOfKind<ClientMessageRequest, Kind>,\n parser: (resp: OneOfKind<ServerMessageResponse, Kind>) => T,\n ): Promise<T> {\n return this.pending.track(async () => {\n const rawResponsePromise = this.ll.send(r, false);\n\n void this.pending.track(rawResponsePromise);\n\n await this.drainAndAwaitPendingOps();\n\n // awaiting our result, and parsing the response\n return parser(await rawResponsePromise);\n });\n }\n\n private sendMultiAndParse<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>, T>(\n r: OneOfKind<ClientMessageRequest, Kind>,\n parser: (resp: OneOfKind<ServerMessageResponse, Kind>[]) => T,\n ): Promise<T> {\n return this.pending.track(async () => {\n const rawResponsePromise = this.ll.send(r, true);\n\n void this.pending.track(rawResponsePromise);\n\n await this.drainAndAwaitPendingOps();\n\n // awaiting our result, and parsing the response\n return parser(await rawResponsePromise);\n });\n }\n\n private async sendVoidSync<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>>(\n r: OneOfKind<ClientMessageRequest, Kind>,\n ): Promise<void> {\n await this.ll.send(r, false);\n }\n\n /** Requests sent with this method should never produce recoverable errors */\n private sendVoidAsync<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>>(\n r: OneOfKind<ClientMessageRequest, Kind>,\n ): void {\n void this.track(this.sendVoidSync(r));\n }\n\n private checkTxOpen() {\n if (this._completed) throw new Error(\"Transaction already closed\");\n }\n\n public get completed() {\n return this._completed;\n }\n\n /** Commit & closes transaction. {@link TxCommitConflict} is thrown on\n * commit conflicts. */\n public async commit() {\n this.checkTxOpen();\n\n // tx will accept no requests after this one\n this._completed = true;\n\n if (!this.writable) {\n // no need to explicitly commit or reject read-only tx\n const completeResult = this.track(this.ll.complete());\n await this.drainAndAwaitPendingOps();\n await completeResult;\n await this.ll.await();\n } else {\n const commitResponse = this.track(\n this.sendSingleAndParse({ oneofKind: \"txCommit\", txCommit: {} }, (r) => r.txCommit.success),\n );\n\n // send closing frame right after commit to save some time on round-trips\n const completeResult = this.track(this.ll.complete());\n\n // now when we pushed all packets into the stream, we should wait for any\n // pending void operations from before, to catch any errors\n await this.drainAndAwaitPendingOps();\n\n if (!(await commitResponse)) throw new TxCommitConflict();\n\n await completeResult;\n\n // await event-loop completion\n await this.ll.await();\n }\n }\n\n public async discard() {\n this.checkTxOpen();\n\n // tx will accept no requests after this one\n this._completed = true;\n\n const discardResponse = this.sendVoidSync({ oneofKind: \"txDiscard\", txDiscard: {} });\n void this.track(discardResponse);\n // send closing frame right after commit to save some time on round-trips\n const completeResult = this.track(this.ll.complete());\n\n // now when we pushed all packets into the stream, we should wait for any\n // pending void operations from before, to catch any errors\n await this.drainAndAwaitPendingOps();\n\n await discardResponse;\n await completeResult;\n await this.ll.await();\n }\n\n //\n // Main tx methods\n //\n\n public get clientRoot(): ResourceId {\n return ensureResourceIdNotNull(this._clientRoot);\n }\n\n //\n // Resources\n //\n\n public createSingleton(\n name: string,\n type: ResourceType,\n errorIfExists: boolean = false,\n ): ResourceRef {\n const localId = this.nextLocalResourceId(false);\n\n const globalId = this.sendSingleAndParse(\n {\n oneofKind: \"resourceCreateSingleton\",\n resourceCreateSingleton: {\n type,\n id: localId,\n data: Buffer.from(name),\n errorIfExists,\n colorProof: new Uint8Array(0),\n },\n },\n (r) => r.resourceCreateSingleton.resourceId as ResourceId,\n );\n\n void this.track(globalId);\n\n return { globalId, localId };\n }\n\n public getSingleton(name: string, loadFields: true): Promise<ResourceData>;\n public getSingleton(name: string, loadFields: false): Promise<BasicResourceData>;\n public getSingleton(\n name: string,\n loadFields: boolean = true,\n ): Promise<BasicResourceData | ResourceData> {\n return this.sendSingleAndParse(\n {\n oneofKind: \"resourceGetSingleton\",\n resourceGetSingleton: {\n data: Buffer.from(name),\n loadFields,\n },\n },\n (r) => protoToResource(notEmpty(r.resourceGetSingleton.resource)),\n );\n }\n\n private createResource<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>>(\n root: boolean,\n req: (localId: LocalResourceId) => OneOfKind<ClientMessageRequest, Kind>,\n parser: (resp: OneOfKind<ServerMessageResponse, Kind>) => bigint,\n ): ResourceRef {\n const localId = this.nextLocalResourceId(root);\n\n const globalId = this.sendSingleAndParse(req(localId), (r) => parser(r) as ResourceId);\n\n void this.track(globalId);\n\n return { globalId, localId };\n }\n\n public createRoot(type: ResourceType): ResourceRef {\n this._stat.rootsCreated++;\n return this.createResource(\n true,\n (localId) => ({ oneofKind: \"resourceCreateRoot\", resourceCreateRoot: { type, id: localId } }),\n (r) => r.resourceCreateRoot.resourceId,\n );\n }\n\n public createStruct(type: ResourceType, data?: Uint8Array | string): ResourceRef {\n this._stat.structsCreated++;\n this._stat.structsCreatedDataBytes += data?.length ?? 0;\n return this.createResource(\n false,\n (localId) => ({\n oneofKind: \"resourceCreateStruct\",\n resourceCreateStruct: {\n type,\n id: localId,\n data:\n data === undefined ? undefined : typeof data === \"string\" ? Buffer.from(data) : data,\n colorProof: new Uint8Array(0),\n },\n }),\n (r) => r.resourceCreateStruct.resourceId,\n );\n }\n\n public createEphemeral(type: ResourceType, data?: Uint8Array | string): ResourceRef {\n this._stat.ephemeralsCreated++;\n this._stat.ephemeralsCreatedDataBytes += data?.length ?? 0;\n return this.createResource(\n false,\n (localId) => ({\n oneofKind: \"resourceCreateEphemeral\",\n resourceCreateEphemeral: {\n type,\n id: localId,\n data:\n data === undefined ? undefined : typeof data === \"string\" ? Buffer.from(data) : data,\n colorProof: new Uint8Array(0),\n },\n }),\n (r) => r.resourceCreateEphemeral.resourceId,\n );\n }\n\n public createValue(\n type: ResourceType,\n data: Uint8Array | string,\n errorIfExists: boolean = false,\n ): ResourceRef {\n this._stat.valuesCreated++;\n this._stat.valuesCreatedDataBytes += data?.length ?? 0;\n return this.createResource(\n false,\n (localId) => ({\n oneofKind: \"resourceCreateValue\",\n resourceCreateValue: {\n type,\n id: localId,\n data: typeof data === \"string\" ? Buffer.from(data) : data,\n errorIfExists,\n colorProof: new Uint8Array(0),\n },\n }),\n (r) => r.resourceCreateValue.resourceId,\n );\n }\n\n public createJsonValue(data: unknown): ResourceRef {\n const jsonData = canonicalJsonBytes(data);\n return this.createValue(JsonObject, jsonData, false);\n }\n\n public createJsonGzValue(data: unknown, minSizeToGzip: number | undefined = 16_384): ResourceRef {\n const { data: jsonData, isGzipped } = canonicalJsonGzBytes(data, minSizeToGzip);\n return this.createValue(isGzipped ? JsonGzObject : JsonObject, jsonData, false);\n }\n\n public createError(message: string): ResourceRef {\n return this.createValue(\n ErrorResourceType,\n JSON.stringify({ message } satisfies ErrorResourceData),\n );\n }\n\n public setResourceName(name: string, rId: AnyResourceRef): void {\n this.sendVoidAsync({\n oneofKind: \"resourceNameSet\",\n resourceNameSet: { resourceId: toResourceId(rId), name },\n });\n }\n\n public deleteResourceName(name: string): void {\n this.sendVoidAsync({ oneofKind: \"resourceNameDelete\", resourceNameDelete: { name } });\n }\n\n public getResourceByName(name: string): Promise<ResourceId> {\n return this.sendSingleAndParse(\n { oneofKind: \"resourceNameGet\", resourceNameGet: { name } },\n (r) => ensureResourceIdNotNull(r.resourceNameGet.resourceId as OptionalResourceId),\n );\n }\n\n public checkResourceNameExists(name: string): Promise<boolean> {\n return this.sendSingleAndParse(\n { oneofKind: \"resourceNameExists\", resourceNameExists: { name } },\n (r) => r.resourceNameExists.exists,\n );\n }\n\n public removeResource(rId: ResourceId): void {\n this.sendVoidAsync({\n oneofKind: \"resourceRemove\",\n resourceRemove: { resourceId: rId },\n });\n }\n\n public resourceExists(rId: ResourceId): Promise<boolean> {\n return this.sendSingleAndParse(\n {\n oneofKind: \"resourceExists\",\n resourceExists: { resourceId: rId },\n },\n (r) => r.resourceExists.exists,\n );\n }\n\n /** This method may return stale resource state from cache if resource was removed */\n public async getResourceData(rId: AnyResourceRef, loadFields: true): Promise<ResourceData>;\n /** This method may return stale resource state from cache if resource was removed */\n public async getResourceData(rId: AnyResourceRef, loadFields: false): Promise<BasicResourceData>;\n /** This method may return stale resource state from cache if resource was removed */\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: boolean,\n ): Promise<BasicResourceData | ResourceData>;\n /** This method may return stale resource state from cache if ignoreCache == false if resource was removed */\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: true,\n ignoreCache: boolean,\n ): Promise<ResourceData>;\n /** This method may return stale resource state from cache if ignoreCache == false if resource was removed */\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: false,\n ignoreCache: boolean,\n ): Promise<BasicResourceData>;\n /** This method may return stale resource state from cache if ignoreCache == false if resource was removed */\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: boolean,\n ignoreCache: boolean,\n ): Promise<BasicResourceData | ResourceData>;\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: boolean = true,\n ignoreCache: boolean = false,\n ): Promise<BasicResourceData | ResourceData> {\n return this.track(async () => {\n if (!ignoreCache && !isResourceRef(rId) && !isLocalResourceId(rId)) {\n // checking if we can return result from cache\n const fromCache = this.sharedResourceDataCache.get(rId);\n if (fromCache && fromCache.cacheTxOpenTimestamp < this.txOpenTimestamp) {\n if (!loadFields) {\n this._stat.rGetDataCacheHits++;\n this._stat.rGetDataCacheBytes += fromCache.basicData.data?.length ?? 0;\n return fromCache.basicData;\n } else if (fromCache.data) {\n this._stat.rGetDataCacheHits++;\n this._stat.rGetDataCacheBytes += fromCache.basicData.data?.length ?? 0;\n this._stat.rGetDataCacheFields += fromCache.data.fields.length;\n return fromCache.data;\n }\n }\n }\n\n const result = await this.sendSingleAndParse(\n {\n oneofKind: \"resourceGet\",\n resourceGet: {\n resourceId: toResourceId(rId),\n loadFields: loadFields,\n },\n },\n (r) => protoToResource(notEmpty(r.resourceGet.resource)),\n );\n\n this._stat.rGetDataNetRequests++;\n this._stat.rGetDataNetBytes += result.data?.length ?? 0;\n this._stat.rGetDataNetFields += result.fields.length;\n\n // we will cache only final resource data states\n // caching result even if we were ignore the cache\n if (!isResourceRef(rId) && !isLocalResourceId(rId) && this.finalPredicate(result)) {\n deepFreeze(result);\n const fromCache = this.sharedResourceDataCache.get(rId);\n if (fromCache) {\n if (loadFields && !fromCache.data) {\n fromCache.data = result;\n // updating timestamp because we updated the record\n fromCache.cacheTxOpenTimestamp = this.txOpenTimestamp;\n }\n } else {\n const basicData = extractBasicResourceData(result);\n deepFreeze(basicData);\n if (loadFields)\n this.sharedResourceDataCache.set(rId, {\n basicData,\n data: result,\n cacheTxOpenTimestamp: this.txOpenTimestamp,\n });\n else\n this.sharedResourceDataCache.set(rId, {\n basicData,\n data: undefined,\n cacheTxOpenTimestamp: this.txOpenTimestamp,\n });\n }\n }\n\n return result;\n });\n }\n\n public async getResourceDataIfExists(\n rId: AnyResourceRef,\n loadFields: true,\n ): Promise<ResourceData | undefined>;\n public async getResourceDataIfExists(\n rId: AnyResourceRef,\n loadFields: false,\n ): Promise<BasicResourceData | undefined>;\n public async getResourceDataIfExists(\n rId: AnyResourceRef,\n loadFields: boolean,\n ): Promise<BasicResourceData | ResourceData | undefined>;\n public async getResourceDataIfExists(\n rId: AnyResourceRef,\n loadFields: boolean = true,\n ): Promise<BasicResourceData | ResourceData | undefined> {\n return this.track(async () => {\n // calling this method will ignore cache, because user intention is to detect resource absence\n // which cache will prevent\n const result = await notFoundToUndefined(\n async () => await this.getResourceData(rId, loadFields, true),\n );\n\n // cleaning cache record if resource was removed from the db\n if (result === undefined && !isResourceRef(rId) && !isLocalResourceId(rId))\n this.sharedResourceDataCache.delete(rId);\n\n return result;\n });\n }\n\n /**\n * Inform platform that resource will not get any new input fields.\n * This is required, when client creates resource without schema and wants\n * controller to start calculations.\n * Most controllers will not start calculations even when all inputs\n * have their values, if inputs list is not locked.\n */\n public lockInputs(rId: AnyResourceRef): void {\n this._stat.inputsLocked++;\n this.sendVoidAsync({\n oneofKind: \"resourceLockInputs\",\n resourceLockInputs: { resourceId: toResourceId(rId), resourceSignature: new Uint8Array(0) },\n });\n }\n\n /**\n * Inform platform that resource will not get any new output fields.\n * This is required for resource to pass deduplication.\n */\n public lockOutputs(rId: AnyResourceRef): void {\n this._stat.outputsLocked++;\n this.sendVoidAsync({\n oneofKind: \"resourceLockOutputs\",\n resourceLockOutputs: { resourceId: toResourceId(rId), resourceSignature: new Uint8Array(0) },\n });\n }\n\n public lock(rID: AnyResourceRef): void {\n this.lockInputs(rID);\n this.lockOutputs(rID);\n }\n\n public setResourceError(rId: AnyResourceRef, ref: AnyResourceRef): void {\n this.sendVoidAsync({\n oneofKind: \"resourceSetError\",\n resourceSetError: {\n resourceId: toResourceId(rId),\n errorResourceId: toResourceId(ref),\n },\n });\n }\n\n //\n // Fields\n //\n\n public createField(fId: AnyFieldRef, fieldType: FieldType, value?: AnyRef): void {\n this._stat.fieldsCreated++;\n this.sendVoidAsync({\n oneofKind: \"fieldCreate\",\n fieldCreate: { type: fieldTypeToProto(fieldType), id: toFieldId(fId) },\n });\n if (value !== undefined) this.setField(fId, value);\n }\n\n public fieldExists(fId: AnyFieldRef): Promise<boolean> {\n return this.sendSingleAndParse(\n {\n oneofKind: \"fieldExists\",\n fieldExists: { field: toFieldId(fId) },\n },\n (r) => r.fieldExists.exists,\n );\n }\n\n public setField(fId: AnyFieldRef, ref: AnyRef): void {\n this._stat.fieldsSet++;\n if (isResource(ref))\n this.sendVoidAsync({\n oneofKind: \"fieldSet\",\n fieldSet: {\n field: toFieldId(fId),\n value: {\n resourceId: toResourceId(ref),\n fieldName: \"\", // default value, read as undefined\n },\n },\n });\n else\n this.sendVoidAsync({\n oneofKind: \"fieldSet\",\n fieldSet: {\n field: toFieldId(fId),\n value: toFieldId(ref),\n },\n });\n }\n\n public setFieldError(fId: AnyFieldRef, ref: AnyResourceRef): void {\n this._stat.fieldsSet++;\n this.sendVoidAsync({\n oneofKind: \"fieldSetError\",\n fieldSetError: {\n field: toFieldId(fId),\n errorResourceId: toResourceId(ref),\n },\n });\n }\n\n public getField(fId: AnyFieldRef): Promise<FieldData> {\n this._stat.fieldsGet++;\n return this.sendSingleAndParse(\n { oneofKind: \"fieldGet\", fieldGet: { field: toFieldId(fId) } },\n (r) => protoToField(notEmpty(r.fieldGet.field)),\n );\n }\n\n public async getFieldIfExists(fId: AnyFieldRef): Promise<FieldData | undefined> {\n return this.track(notFoundToUndefined(async () => await this.getField(fId)));\n }\n\n public resetField(fId: AnyFieldRef): void {\n this.sendVoidAsync({ oneofKind: \"fieldReset\", fieldReset: { field: toFieldId(fId) } });\n }\n\n public removeField(fId: AnyFieldRef): void {\n this.sendVoidAsync({ oneofKind: \"fieldRemove\", fieldRemove: { field: toFieldId(fId) } });\n }\n\n //\n // KV\n //\n\n public async listKeyValues(rId: AnyResourceRef): Promise<KeyValue[]> {\n return this.track(async () => {\n const result = await this.sendMultiAndParse(\n {\n oneofKind: \"resourceKeyValueList\",\n resourceKeyValueList: {\n resourceId: toResourceId(rId),\n startFrom: \"\",\n limit: 0,\n },\n },\n (r) => r.map((e) => e.resourceKeyValueList.record!),\n );\n\n this._stat.kvListRequests++;\n this._stat.kvListEntries += result.length;\n for (const kv of result) this._stat.kvListBytes += kv.key.length + kv.value.length;\n\n return result;\n });\n }\n\n public async listKeyValuesString(rId: AnyResourceRef): Promise<KeyValueString[]> {\n return this.track(async () =>\n (await this.listKeyValues(rId)).map(({ key, value }) => ({\n key,\n value: Buffer.from(value).toString(),\n })),\n );\n }\n\n public async listKeyValuesIfResourceExists(rId: AnyResourceRef): Promise<KeyValue[] | undefined> {\n return this.track(notFoundToUndefined(async () => await this.listKeyValues(rId)));\n }\n\n public async listKeyValuesStringIfResourceExists(\n rId: AnyResourceRef,\n ): Promise<KeyValueString[] | undefined> {\n return this.track(notFoundToUndefined(async () => await this.listKeyValuesString(rId)));\n }\n\n public setKValue(rId: AnyResourceRef, key: string, value: Uint8Array | string): void {\n this._stat.kvSetRequests++;\n this._stat.kvSetBytes++;\n this.sendVoidAsync({\n oneofKind: \"resourceKeyValueSet\",\n resourceKeyValueSet: {\n resourceId: toResourceId(rId),\n resourceSignature: new Uint8Array(0),\n key,\n value: toBytes(value),\n },\n });\n }\n\n public deleteKValue(rId: AnyResourceRef, key: string): void {\n this.sendVoidAsync({\n oneofKind: \"resourceKeyValueDelete\",\n resourceKeyValueDelete: {\n resourceId: toResourceId(rId),\n resourceSignature: new Uint8Array(0),\n key,\n },\n });\n }\n\n public async getKValue(rId: AnyResourceRef, key: string): Promise<Uint8Array> {\n return this.track(async () => {\n const result = await this.sendSingleAndParse(\n {\n oneofKind: \"resourceKeyValueGet\",\n resourceKeyValueGet: {\n resourceId: toResourceId(rId),\n key,\n },\n },\n (r) => r.resourceKeyValueGet.value,\n );\n\n this._stat.kvGetRequests++;\n this._stat.kvGetBytes += result.length;\n\n return result;\n });\n }\n\n public async getKValueString(rId: AnyResourceRef, key: string): Promise<string> {\n return this.track(async () => Buffer.from(await this.getKValue(rId, key)).toString());\n }\n\n public async getKValueJson<T>(rId: AnyResourceRef, key: string): Promise<T> {\n return this.track(async () => JSON.parse(await this.getKValueString(rId, key)) as T);\n }\n\n public async getKValueIfExists(\n rId: AnyResourceRef,\n key: string,\n ): Promise<Uint8Array | undefined> {\n return this.track(async () => {\n const result = await this.sendSingleAndParse(\n {\n oneofKind: \"resourceKeyValueGetIfExists\",\n resourceKeyValueGetIfExists: {\n resourceId: toResourceId(rId),\n key,\n },\n },\n (r) =>\n r.resourceKeyValueGetIfExists.exists ? r.resourceKeyValueGetIfExists.value : undefined,\n );\n\n this._stat.kvGetRequests++;\n this._stat.kvGetBytes += result?.length ?? 0;\n\n return result;\n });\n }\n\n public async getKValueStringIfExists(\n rId: AnyResourceRef,\n key: string,\n ): Promise<string | undefined> {\n return this.track(async () => {\n const data = await this.getKValueIfExists(rId, key);\n return data === undefined ? undefined : Buffer.from(data).toString();\n });\n }\n\n public async getKValueJsonIfExists<T>(rId: AnyResourceRef, key: string): Promise<T | undefined> {\n return this.track(async () => {\n const str = await this.getKValueString(rId, key);\n if (str === undefined) return undefined;\n return JSON.parse(str) as T;\n });\n }\n\n //\n // Cache\n //\n // TODO\n\n //\n // High level ops\n //\n\n /** Resolves existing or create first level resource from */\n public getFutureFieldValue(rId: AnyRef, fieldName: string, fieldType: FutureFieldType): FieldRef {\n const data = Buffer.from(JSON.stringify({ fieldName, fieldType }));\n const getFieldResource = this.createEphemeral({ name: \"json/getField\", version: \"1\" }, data);\n this.setField({ resourceId: getFieldResource, fieldName: \"resource\" }, rId);\n return { resourceId: getFieldResource, fieldName: \"result\" };\n }\n\n //\n // Technical\n //\n\n public async getGlobalTxId() {\n this.globalTxIdWasAwaited = true;\n return await this.globalTxId;\n }\n\n /** Closes output event stream */\n public async complete() {\n if (this._completed) return;\n this._completed = true;\n const completeResult = this.track(this.ll.complete());\n await this.drainAndAwaitPendingOps();\n await completeResult;\n }\n\n /** Await incoming message loop termination and throw\n * any leftover errors if it was unsuccessful */\n public async await() {\n await this.ll.await();\n }\n\n //\n // Helpers\n //\n\n private nextLocalResourceId(root: boolean): LocalResourceId {\n return createLocalResourceId(root, ++this.localResourceIdCounter, this.localTxId);\n }\n\n private static localTxIdCounter = 0;\n\n private static nextLocalTxId() {\n PlTransaction.localTxIdCounter++;\n if (PlTransaction.localTxIdCounter === MaxTxId) PlTransaction.localTxIdCounter = 1;\n return PlTransaction.localTxIdCounter;\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"transaction.cjs","names":["isSignedResourceId","toResourceSignature","parseSignedResourceId","isLocalResourceId","createSignedResourceId","isNotFoundError","PromiseTracker","initialTxStatWithoutTime","TxAPI_Open_Request_WritableTx","ensureSignedResourceIdNotNull","protoToResource","JsonObject","JsonGzObject","ErrorResourceType","extractBasicResourceData","fieldTypeToProto","protoToField","toBytes","createLocalResourceId"],"sources":["../../src/core/transaction.ts"],"sourcesContent":["// TODO: fix this\n/* eslint-disable no-prototype-builtins */\nimport type {\n ColorProof,\n LocalResourceId,\n OptionalSignedResourceId,\n BasicResourceData,\n FieldData,\n FieldType,\n ResourceData,\n SignedResourceId,\n ResourceSignature,\n ResourceType,\n FutureFieldType,\n} from \"./types\";\nimport {\n createSignedResourceId,\n createLocalResourceId,\n isLocalResourceId,\n ensureSignedResourceIdNotNull,\n MaxTxId,\n extractBasicResourceData,\n parseSignedResourceId,\n toResourceSignature,\n isSignedResourceId,\n} from \"./types\";\nimport type {\n ClientMessageRequest,\n LLPlTransaction,\n OneOfKind,\n ServerMessageResponse,\n} from \"./ll_transaction\";\nimport { TxAPI_Open_Request_WritableTx } from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api\";\nimport type { NonUndefined } from \"utility-types\";\nimport { toBytes } from \"../util/util\";\nimport { fieldTypeToProto, protoToField, protoToResource } from \"./type_conversion\";\nimport {\n canonicalJsonBytes,\n canonicalJsonGzBytes,\n deepFreeze,\n notEmpty,\n} from \"@milaboratories/ts-helpers\";\nimport { isNotFoundError } from \"./errors\";\nimport type { FinalResourceDataPredicate } from \"./final\";\nimport type { LRUCache } from \"lru-cache\";\nimport type { ResourceDataCacheRecord } from \"./cache\";\nimport type { TxStat } from \"./stat\";\nimport { initialTxStatWithoutTime } from \"./stat\";\nimport type { ErrorResourceData } from \"./error_resource\";\nimport { ErrorResourceType } from \"./error_resource\";\nimport { JsonGzObject, JsonObject } from \"../helpers/pl\";\nimport { PromiseTracker } from \"./PromiseTracker\";\n\n/** Reference to resource, used only within transaction */\nexport interface ResourceRef {\n /** Global resource id of newly created resources, become available only\n * after response for the corresponding creation request is received. */\n readonly globalId: Promise<SignedResourceId>;\n\n /** Transaction-local resource id is assigned right after resource creation\n * request is sent, and can be used right away */\n readonly localId: LocalResourceId;\n}\n\n/** Key-Value pair from resource-attached KV storage */\nexport interface KeyValue {\n key: string;\n value: Uint8Array;\n}\n\n/** Key-Value pair from resource-attached KV storage */\nexport interface KeyValueString {\n key: string;\n value: string;\n}\n\ninterface _FieldId<RId> {\n /** Parent resource id */\n resourceId: RId;\n /** Field name */\n fieldName: string;\n}\n\nexport type FieldId = _FieldId<SignedResourceId>;\nexport type FieldRef = _FieldId<ResourceRef>;\nexport type LocalFieldId = _FieldId<LocalResourceId>;\nexport type AnyFieldId = FieldId | LocalFieldId;\n\nexport type AnyResourceRef = ResourceRef | LocalResourceId | SignedResourceId;\nexport type AnyFieldRef = _FieldId<AnyResourceRef>; // FieldRef | FieldId\nexport type AnyRef = AnyResourceRef | AnyFieldRef;\n\nexport function isField(ref: AnyRef): ref is AnyFieldRef {\n return ref.hasOwnProperty(\"resourceId\") && ref.hasOwnProperty(\"fieldName\");\n}\n\nexport function isResource(ref: AnyRef): ref is AnyResourceRef {\n if (typeof ref === \"bigint\") return true; // LocalResourceId\n if (typeof ref === \"string\") return true; // SignedResourceId\n return isResourceRef(ref);\n}\n\nexport function isResourceId(ref: AnyRef): ref is SignedResourceId {\n return typeof ref === \"string\" && isSignedResourceId(ref);\n}\n\nexport function isFieldRef(ref: AnyFieldRef): ref is FieldRef {\n return isResourceRef(ref.resourceId);\n}\n\nexport function isResourceRef(ref: AnyRef): ref is ResourceRef {\n return (\n typeof ref === \"object\" &&\n ref !== null &&\n ref.hasOwnProperty(\"globalId\") &&\n ref.hasOwnProperty(\"localId\")\n );\n}\n\nexport function toFieldId(ref: AnyFieldRef): AnyFieldId {\n if (isFieldRef(ref)) return { resourceId: ref.resourceId.localId, fieldName: ref.fieldName };\n else return ref as FieldId;\n}\n\nexport async function toGlobalFieldId(ref: FieldRef | FieldId): Promise<FieldId> {\n if (isFieldRef(ref))\n return { resourceId: await ref.resourceId.globalId, fieldName: ref.fieldName };\n return ref;\n}\n\nexport interface ResourceIdWithSignature {\n resourceId: bigint;\n resourceSignature: ResourceSignature;\n}\n\nconst emptySignature = toResourceSignature(new Uint8Array(0));\n\nfunction toResourceIdAndSignature(ref: AnyResourceRef): ResourceIdWithSignature {\n if (isResourceRef(ref)) {\n // Local ID — no signature yet\n return { resourceId: ref.localId, resourceSignature: emptySignature };\n }\n if (isResourceId(ref)) {\n // SignedResourceId — decompose\n const { globalId, signature } = parseSignedResourceId(ref);\n return { resourceId: globalId as bigint, resourceSignature: signature };\n }\n // Raw bigint (LocalResourceId)\n return { resourceId: ref as bigint, resourceSignature: emptySignature };\n}\n\nexport async function toGlobalResourceId(ref: AnyResourceRef): Promise<SignedResourceId> {\n if (isResourceRef(ref)) return await ref.globalId;\n if (isLocalResourceId(ref)) return createSignedResourceId(ref); // legacy path: loose security mode in backend\n return ref;\n}\n\nexport function field(resourceId: AnyResourceRef, fieldName: string): AnyFieldRef {\n return { resourceId, fieldName };\n}\n\n/** If transaction commit failed due to write conflicts */\nexport class TxCommitConflict extends Error {\n name = \"TxCommitConflict\";\n}\n\nasync function notFoundToUndefined<T>(cb: () => Promise<T>): Promise<T | undefined> {\n try {\n return await cb();\n } catch (e) {\n if (isNotFoundError(e)) return undefined;\n throw e;\n }\n}\n\n/**\n * Each platform transaction has 3 stages:\n * - initialization (txOpen message -> txInfo response)\n * - communication (create resources, fields, references and so on)\n * - finalization (txCommit or txDiscard message)\n *\n * This class encapsulates finalization stage and provides ready-to-communication transaction object.\n * */\nexport class PlTransaction {\n private readonly globalTxId: Promise<bigint>;\n private readonly localTxId: number = PlTransaction.nextLocalTxId();\n\n /** Used in caching */\n private readonly txOpenTimestamp = Date.now();\n\n private localResourceIdCounter = 0;\n\n /** Store logical tx open / closed state to prevent invalid sequence of requests.\n * True means output stream was completed.\n * Contract: there must be no async operations between setting this field to true and sending complete signal to stream. */\n private _completed = false;\n\n private globalTxIdWasAwaited: boolean = false;\n\n public readonly pending = new PromiseTracker();\n\n private readonly _startTime = Date.now();\n private readonly _stat = initialTxStatWithoutTime();\n public get stat(): TxStat {\n return {\n ...this._stat,\n timeMs: Date.now() - this._startTime,\n };\n }\n\n constructor(\n private readonly ll: LLPlTransaction,\n public readonly name: string,\n public readonly writable: boolean,\n private readonly _clientRoot: OptionalSignedResourceId,\n private readonly finalPredicate: FinalResourceDataPredicate,\n private readonly sharedResourceDataCache: LRUCache<SignedResourceId, ResourceDataCacheRecord>,\n private readonly enableFormattedErrors: boolean = false,\n ) {\n // initiating transaction\n this.globalTxId = this.sendSingleAndParse(\n {\n oneofKind: \"txOpen\",\n txOpen: {\n name,\n enableFormattedErrors,\n writable: writable\n ? TxAPI_Open_Request_WritableTx.WRITABLE\n : TxAPI_Open_Request_WritableTx.NOT_WRITABLE,\n },\n },\n (r) => notEmpty(r.txOpen.tx?.id),\n );\n\n void this.track(this.globalTxId);\n\n // To avoid floating promise\n this.globalTxId.catch((err) => {\n if (!this.globalTxIdWasAwaited) {\n console.warn(err);\n }\n });\n\n // Adding stats\n this._stat.txCount++;\n }\n\n /**\n * Collect all pending promises for the transaction finalization.\n */\n public track<T>(promiseOrCallback: Promise<T> | (() => Promise<T>)): Promise<T> {\n return this.pending.track(promiseOrCallback);\n }\n\n private async drainAndAwaitPendingOps(): Promise<void> {\n // awaiting these pending operations first, to catch any errors\n await this.pending.awaitAll();\n }\n\n private sendSingleAndParse<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>, T>(\n r: OneOfKind<ClientMessageRequest, Kind>,\n parser: (resp: OneOfKind<ServerMessageResponse, Kind>) => T,\n ): Promise<T> {\n return this.pending.track(async () => {\n const rawResponsePromise = this.ll.send(r, false);\n\n void this.pending.track(rawResponsePromise);\n\n await this.drainAndAwaitPendingOps();\n\n // awaiting our result, and parsing the response\n return parser(await rawResponsePromise);\n });\n }\n\n private sendMultiAndParse<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>, T>(\n r: OneOfKind<ClientMessageRequest, Kind>,\n parser: (resp: OneOfKind<ServerMessageResponse, Kind>[]) => T,\n ): Promise<T> {\n return this.pending.track(async () => {\n const rawResponsePromise = this.ll.send(r, true);\n\n void this.pending.track(rawResponsePromise);\n\n await this.drainAndAwaitPendingOps();\n\n // awaiting our result, and parsing the response\n return parser(await rawResponsePromise);\n });\n }\n\n private async sendVoidSync<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>>(\n r: OneOfKind<ClientMessageRequest, Kind>,\n ): Promise<void> {\n await this.ll.send(r, false);\n }\n\n /** Requests sent with this method should never produce recoverable errors */\n private sendVoidAsync<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>>(\n r: OneOfKind<ClientMessageRequest, Kind>,\n ): void {\n void this.track(this.sendVoidSync(r));\n }\n\n /** Set default color proof for subsequent resource creation requests */\n public setDefaultColor(colorProof: ColorProof): void {\n this.sendVoidAsync({\n oneofKind: \"setDefaultColor\",\n setDefaultColor: { colorProof },\n });\n }\n\n private toSignedResourceId(rId: AnyResourceRef): ResourceIdWithSignature {\n return toResourceIdAndSignature(rId);\n }\n\n private toSignedFieldId(fId: AnyFieldRef): {\n resourceId: bigint;\n resourceSignature: ResourceSignature;\n fieldName: string;\n } {\n const base = toFieldId(fId);\n const signed = toResourceIdAndSignature(base.resourceId);\n return {\n resourceId: signed.resourceId,\n fieldName: base.fieldName,\n resourceSignature: signed.resourceSignature,\n };\n }\n\n private toSignedErrorRef(rId: AnyResourceRef): {\n errorResourceId: bigint;\n errorResourceSignature: ResourceSignature;\n } {\n const { resourceId, resourceSignature } = this.toSignedResourceId(rId);\n return { errorResourceId: resourceId, errorResourceSignature: resourceSignature };\n }\n\n private checkTxOpen() {\n if (this._completed) throw new Error(\"Transaction already closed\");\n }\n\n public get completed() {\n return this._completed;\n }\n\n /** Commit & closes transaction. {@link TxCommitConflict} is thrown on\n * commit conflicts. */\n public async commit() {\n this.checkTxOpen();\n\n // tx will accept no requests after this one\n this._completed = true;\n\n if (!this.writable) {\n // no need to explicitly commit or reject read-only tx\n const completeResult = this.track(this.ll.complete());\n await this.drainAndAwaitPendingOps();\n await completeResult;\n await this.ll.await();\n } else {\n const commitResponse = this.track(\n this.sendSingleAndParse({ oneofKind: \"txCommit\", txCommit: {} }, (r) => r.txCommit.success),\n );\n\n // send closing frame right after commit to save some time on round-trips\n const completeResult = this.track(this.ll.complete());\n\n // now when we pushed all packets into the stream, we should wait for any\n // pending void operations from before, to catch any errors\n await this.drainAndAwaitPendingOps();\n\n if (!(await commitResponse)) throw new TxCommitConflict();\n\n await completeResult;\n\n // await event-loop completion\n await this.ll.await();\n }\n }\n\n public async discard() {\n this.checkTxOpen();\n\n // tx will accept no requests after this one\n this._completed = true;\n\n const discardResponse = this.sendVoidSync({ oneofKind: \"txDiscard\", txDiscard: {} });\n void this.track(discardResponse);\n // send closing frame right after commit to save some time on round-trips\n const completeResult = this.track(this.ll.complete());\n\n // now when we pushed all packets into the stream, we should wait for any\n // pending void operations from before, to catch any errors\n await this.drainAndAwaitPendingOps();\n\n await discardResponse;\n await completeResult;\n await this.ll.await();\n }\n\n //\n // Main tx methods\n //\n\n public get clientRoot(): SignedResourceId {\n return ensureSignedResourceIdNotNull(this._clientRoot);\n }\n\n //\n // Resources\n //\n\n public createSingleton(\n name: string,\n type: ResourceType,\n errorIfExists: boolean = false,\n color?: ColorProof,\n ): ResourceRef {\n return this.createResource(\n false,\n (localId) => ({\n oneofKind: \"resourceCreateSingleton\",\n resourceCreateSingleton: {\n type,\n id: localId,\n data: Buffer.from(name),\n errorIfExists,\n colorProof: color ?? emptySignature,\n },\n }),\n (r) => r.resourceCreateSingleton.resourceId,\n (r) => r.resourceCreateSingleton.resourceSignature,\n );\n }\n\n public getSingleton(name: string, loadFields: true): Promise<ResourceData>;\n public getSingleton(name: string, loadFields: false): Promise<BasicResourceData>;\n public getSingleton(\n name: string,\n loadFields: boolean = true,\n ): Promise<BasicResourceData | ResourceData> {\n return this.sendSingleAndParse(\n {\n oneofKind: \"resourceGetSingleton\",\n resourceGetSingleton: {\n data: Buffer.from(name),\n loadFields,\n },\n },\n (r) => protoToResource(notEmpty(r.resourceGetSingleton.resource)),\n );\n }\n\n private createResource<Kind extends NonUndefined<ClientMessageRequest[\"oneofKind\"]>>(\n root: boolean,\n req: (localId: LocalResourceId) => OneOfKind<ClientMessageRequest, Kind>,\n parser: (resp: OneOfKind<ServerMessageResponse, Kind>) => bigint,\n sigExtractor: (resp: OneOfKind<ServerMessageResponse, Kind>) => Uint8Array | undefined,\n ): ResourceRef {\n const localId = this.nextLocalResourceId(root);\n\n const globalId = this.sendSingleAndParse(req(localId), (r) => {\n const rawId = parser(r);\n const sig = sigExtractor ? toResourceSignature(sigExtractor(r)) : undefined;\n return createSignedResourceId(rawId, sig);\n });\n\n void this.track(globalId);\n\n return { globalId, localId };\n }\n\n public createRoot(type: ResourceType): ResourceRef {\n this._stat.rootsCreated++;\n return this.createResource(\n true,\n (localId) => ({ oneofKind: \"resourceCreateRoot\", resourceCreateRoot: { type, id: localId } }),\n (r) => r.resourceCreateRoot.resourceId,\n (r) => r.resourceCreateRoot.resourceSignature,\n );\n }\n\n public createStruct(\n type: ResourceType,\n data?: Uint8Array | string,\n color?: ColorProof,\n ): ResourceRef {\n this._stat.structsCreated++;\n this._stat.structsCreatedDataBytes += data?.length ?? 0;\n return this.createResource(\n false,\n (localId) => ({\n oneofKind: \"resourceCreateStruct\",\n resourceCreateStruct: {\n type,\n id: localId,\n data:\n data === undefined ? undefined : typeof data === \"string\" ? Buffer.from(data) : data,\n colorProof: color ?? emptySignature,\n },\n }),\n (r) => r.resourceCreateStruct.resourceId,\n (r) => r.resourceCreateStruct.resourceSignature,\n );\n }\n\n public createEphemeral(\n type: ResourceType,\n data?: Uint8Array | string,\n color?: ColorProof,\n ): ResourceRef {\n this._stat.ephemeralsCreated++;\n this._stat.ephemeralsCreatedDataBytes += data?.length ?? 0;\n return this.createResource(\n false,\n (localId) => ({\n oneofKind: \"resourceCreateEphemeral\",\n resourceCreateEphemeral: {\n type,\n id: localId,\n data:\n data === undefined ? undefined : typeof data === \"string\" ? Buffer.from(data) : data,\n colorProof: color ?? emptySignature,\n },\n }),\n (r) => r.resourceCreateEphemeral.resourceId,\n (r) => r.resourceCreateEphemeral.resourceSignature,\n );\n }\n\n public createValue(\n type: ResourceType,\n data: Uint8Array | string,\n errorIfExists: boolean = false,\n color?: ColorProof,\n ): ResourceRef {\n this._stat.valuesCreated++;\n this._stat.valuesCreatedDataBytes += data?.length ?? 0;\n return this.createResource(\n false,\n (localId) => ({\n oneofKind: \"resourceCreateValue\",\n resourceCreateValue: {\n type,\n id: localId,\n data: typeof data === \"string\" ? Buffer.from(data) : data,\n errorIfExists,\n colorProof: color ?? emptySignature,\n },\n }),\n (r) => r.resourceCreateValue.resourceId,\n (r) => r.resourceCreateValue.resourceSignature,\n );\n }\n\n public createJsonValue(data: unknown, color?: ColorProof): ResourceRef {\n const jsonData = canonicalJsonBytes(data);\n return this.createValue(JsonObject, jsonData, false, color);\n }\n\n public createJsonGzValue(\n data: unknown,\n minSizeToGzip: number | undefined = 16_384,\n color?: ColorProof,\n ): ResourceRef {\n const { data: jsonData, isGzipped } = canonicalJsonGzBytes(data, minSizeToGzip);\n return this.createValue(isGzipped ? JsonGzObject : JsonObject, jsonData, false, color);\n }\n\n public createError(message: string, color?: ColorProof): ResourceRef {\n return this.createValue(\n ErrorResourceType,\n JSON.stringify({ message } satisfies ErrorResourceData),\n false,\n color,\n );\n }\n\n public setResourceName(name: string, rId: AnyResourceRef): void {\n this.sendVoidAsync({\n oneofKind: \"resourceNameSet\",\n resourceNameSet: { ...this.toSignedResourceId(rId), name },\n });\n }\n\n public deleteResourceName(name: string): void {\n this.sendVoidAsync({ oneofKind: \"resourceNameDelete\", resourceNameDelete: { name } });\n }\n\n public getResourceByName(name: string): Promise<SignedResourceId> {\n return this.sendSingleAndParse(\n { oneofKind: \"resourceNameGet\", resourceNameGet: { name } },\n (r) => {\n const rawId = r.resourceNameGet.resourceId;\n if (rawId === 0n) throw new Error(\"null resource id from getResourceByName\");\n const sig = toResourceSignature(r.resourceNameGet.resourceSignature);\n return createSignedResourceId(rawId, sig);\n },\n );\n }\n\n public checkResourceNameExists(name: string): Promise<boolean> {\n return this.sendSingleAndParse(\n { oneofKind: \"resourceNameExists\", resourceNameExists: { name } },\n (r) => r.resourceNameExists.exists,\n );\n }\n\n public removeResource(rId: SignedResourceId): void {\n this.sendVoidAsync({\n oneofKind: \"resourceRemove\",\n resourceRemove: this.toSignedResourceId(rId),\n });\n }\n\n public resourceExists(rId: SignedResourceId): Promise<boolean> {\n return this.sendSingleAndParse(\n {\n oneofKind: \"resourceExists\",\n resourceExists: this.toSignedResourceId(rId),\n },\n (r) => r.resourceExists.exists,\n );\n }\n\n /** This method may return stale resource state from cache if resource was removed */\n public async getResourceData(rId: AnyResourceRef, loadFields: true): Promise<ResourceData>;\n /** This method may return stale resource state from cache if resource was removed */\n public async getResourceData(rId: AnyResourceRef, loadFields: false): Promise<BasicResourceData>;\n /** This method may return stale resource state from cache if resource was removed */\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: boolean,\n ): Promise<BasicResourceData | ResourceData>;\n /** This method may return stale resource state from cache if ignoreCache == false if resource was removed */\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: true,\n ignoreCache: boolean,\n ): Promise<ResourceData>;\n /** This method may return stale resource state from cache if ignoreCache == false if resource was removed */\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: false,\n ignoreCache: boolean,\n ): Promise<BasicResourceData>;\n /** This method may return stale resource state from cache if ignoreCache == false if resource was removed */\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: boolean,\n ignoreCache: boolean,\n ): Promise<BasicResourceData | ResourceData>;\n public async getResourceData(\n rId: AnyResourceRef,\n loadFields: boolean = true,\n ignoreCache: boolean = false,\n ): Promise<BasicResourceData | ResourceData> {\n return this.track(async () => {\n if (!ignoreCache && isResourceId(rId)) {\n // checking if we can return result from cache\n const fromCache = this.sharedResourceDataCache.get(rId);\n if (fromCache && fromCache.cacheTxOpenTimestamp < this.txOpenTimestamp) {\n if (!loadFields) {\n this._stat.rGetDataCacheHits++;\n this._stat.rGetDataCacheBytes += fromCache.basicData.data?.length ?? 0;\n return fromCache.basicData;\n } else if (fromCache.data) {\n this._stat.rGetDataCacheHits++;\n this._stat.rGetDataCacheBytes += fromCache.basicData.data?.length ?? 0;\n this._stat.rGetDataCacheFields += fromCache.data.fields.length;\n return fromCache.data;\n }\n }\n }\n\n const result = await this.sendSingleAndParse(\n {\n oneofKind: \"resourceGet\",\n resourceGet: {\n ...this.toSignedResourceId(rId),\n loadFields: loadFields,\n },\n },\n (r) => protoToResource(notEmpty(r.resourceGet.resource)),\n );\n\n this._stat.rGetDataNetRequests++;\n this._stat.rGetDataNetBytes += result.data?.length ?? 0;\n this._stat.rGetDataNetFields += result.fields.length;\n\n // we will cache only final resource data states\n // caching result even if we were ignore the cache\n if (isResourceId(rId) && this.finalPredicate(result)) {\n deepFreeze(result);\n const fromCache = this.sharedResourceDataCache.get(rId);\n if (fromCache) {\n if (loadFields && !fromCache.data) {\n fromCache.data = result;\n // updating timestamp because we updated the record\n fromCache.cacheTxOpenTimestamp = this.txOpenTimestamp;\n }\n } else {\n const basicData = extractBasicResourceData(result);\n deepFreeze(basicData);\n if (loadFields)\n this.sharedResourceDataCache.set(rId, {\n basicData,\n data: result,\n cacheTxOpenTimestamp: this.txOpenTimestamp,\n });\n else\n this.sharedResourceDataCache.set(rId, {\n basicData,\n data: undefined,\n cacheTxOpenTimestamp: this.txOpenTimestamp,\n });\n }\n }\n\n return result;\n });\n }\n\n public async getResourceDataIfExists(\n rId: AnyResourceRef,\n loadFields: true,\n ): Promise<ResourceData | undefined>;\n public async getResourceDataIfExists(\n rId: AnyResourceRef,\n loadFields: false,\n ): Promise<BasicResourceData | undefined>;\n public async getResourceDataIfExists(\n rId: AnyResourceRef,\n loadFields: boolean,\n ): Promise<BasicResourceData | ResourceData | undefined>;\n public async getResourceDataIfExists(\n rId: AnyResourceRef,\n loadFields: boolean = true,\n ): Promise<BasicResourceData | ResourceData | undefined> {\n return this.track(async () => {\n // calling this method will ignore cache, because user intention is to detect resource absence\n // which cache will prevent\n const result = await notFoundToUndefined(\n async () => await this.getResourceData(rId, loadFields, true),\n );\n\n // cleaning cache record if resource was removed from the db\n if (result === undefined && isResourceId(rId)) this.sharedResourceDataCache.delete(rId);\n\n return result;\n });\n }\n\n /**\n * Inform platform that resource will not get any new input fields.\n * This is required, when client creates resource without schema and wants\n * controller to start calculations.\n * Most controllers will not start calculations even when all inputs\n * have their values, if inputs list is not locked.\n */\n public lockInputs(rId: AnyResourceRef): void {\n this._stat.inputsLocked++;\n this.sendVoidAsync({\n oneofKind: \"resourceLockInputs\",\n resourceLockInputs: this.toSignedResourceId(rId),\n });\n }\n\n /**\n * Inform platform that resource will not get any new output fields.\n * This is required for resource to pass deduplication.\n */\n public lockOutputs(rId: AnyResourceRef): void {\n this._stat.outputsLocked++;\n this.sendVoidAsync({\n oneofKind: \"resourceLockOutputs\",\n resourceLockOutputs: this.toSignedResourceId(rId),\n });\n }\n\n public lock(rID: AnyResourceRef): void {\n this.lockInputs(rID);\n this.lockOutputs(rID);\n }\n\n public setResourceError(rId: AnyResourceRef, ref: AnyResourceRef): void {\n this.sendVoidAsync({\n oneofKind: \"resourceSetError\",\n resourceSetError: {\n ...this.toSignedResourceId(rId),\n ...this.toSignedErrorRef(ref),\n },\n });\n }\n\n //\n // Fields\n //\n\n public createField(fId: AnyFieldRef, fieldType: FieldType, value?: AnyRef): void {\n this._stat.fieldsCreated++;\n this.sendVoidAsync({\n oneofKind: \"fieldCreate\",\n fieldCreate: { type: fieldTypeToProto(fieldType), id: this.toSignedFieldId(fId) },\n });\n if (value !== undefined) this.setField(fId, value);\n }\n\n public fieldExists(fId: AnyFieldRef): Promise<boolean> {\n return this.sendSingleAndParse(\n {\n oneofKind: \"fieldExists\",\n fieldExists: { field: this.toSignedFieldId(fId) },\n },\n (r) => r.fieldExists.exists,\n );\n }\n\n public setField(fId: AnyFieldRef, ref: AnyRef): void {\n this._stat.fieldsSet++;\n if (isResource(ref)) {\n this.sendVoidAsync({\n oneofKind: \"fieldSet\",\n fieldSet: {\n field: this.toSignedFieldId(fId),\n value: {\n ...this.toSignedResourceId(ref),\n fieldName: \"\", // default value, read as undefined\n },\n },\n });\n } else {\n this.sendVoidAsync({\n oneofKind: \"fieldSet\",\n fieldSet: {\n field: this.toSignedFieldId(fId),\n value: this.toSignedFieldId(ref),\n },\n });\n }\n }\n\n public setFieldError(fId: AnyFieldRef, ref: AnyResourceRef): void {\n this._stat.fieldsSet++;\n this.sendVoidAsync({\n oneofKind: \"fieldSetError\",\n fieldSetError: {\n field: this.toSignedFieldId(fId),\n ...this.toSignedErrorRef(ref),\n },\n });\n }\n\n public getField(fId: AnyFieldRef): Promise<FieldData> {\n this._stat.fieldsGet++;\n return this.sendSingleAndParse(\n { oneofKind: \"fieldGet\", fieldGet: { field: this.toSignedFieldId(fId) } },\n (r) => protoToField(notEmpty(r.fieldGet.field)),\n );\n }\n\n public async getFieldIfExists(fId: AnyFieldRef): Promise<FieldData | undefined> {\n return this.track(notFoundToUndefined(async () => await this.getField(fId)));\n }\n\n public resetField(fId: AnyFieldRef): void {\n this.sendVoidAsync({\n oneofKind: \"fieldReset\",\n fieldReset: { field: this.toSignedFieldId(fId) },\n });\n }\n\n public removeField(fId: AnyFieldRef): void {\n this.sendVoidAsync({\n oneofKind: \"fieldRemove\",\n fieldRemove: { field: this.toSignedFieldId(fId) },\n });\n }\n\n //\n // KV\n //\n\n public async listKeyValues(rId: AnyResourceRef): Promise<KeyValue[]> {\n return this.track(async () => {\n const result = await this.sendMultiAndParse(\n {\n oneofKind: \"resourceKeyValueList\",\n resourceKeyValueList: {\n ...this.toSignedResourceId(rId),\n startFrom: \"\",\n limit: 0,\n },\n },\n (r) => r.map((e) => e.resourceKeyValueList.record!),\n );\n\n this._stat.kvListRequests++;\n this._stat.kvListEntries += result.length;\n for (const kv of result) this._stat.kvListBytes += kv.key.length + kv.value.length;\n\n return result;\n });\n }\n\n public async listKeyValuesString(rId: AnyResourceRef): Promise<KeyValueString[]> {\n return this.track(async () =>\n (await this.listKeyValues(rId)).map(({ key, value }) => ({\n key,\n value: Buffer.from(value).toString(),\n })),\n );\n }\n\n public async listKeyValuesIfResourceExists(rId: AnyResourceRef): Promise<KeyValue[] | undefined> {\n return this.track(notFoundToUndefined(async () => await this.listKeyValues(rId)));\n }\n\n public async listKeyValuesStringIfResourceExists(\n rId: AnyResourceRef,\n ): Promise<KeyValueString[] | undefined> {\n return this.track(notFoundToUndefined(async () => await this.listKeyValuesString(rId)));\n }\n\n public setKValue(rId: AnyResourceRef, key: string, value: Uint8Array | string): void {\n this._stat.kvSetRequests++;\n this._stat.kvSetBytes++;\n this.sendVoidAsync({\n oneofKind: \"resourceKeyValueSet\",\n resourceKeyValueSet: {\n ...this.toSignedResourceId(rId),\n key,\n value: toBytes(value),\n },\n });\n }\n\n public deleteKValue(rId: AnyResourceRef, key: string): void {\n this.sendVoidAsync({\n oneofKind: \"resourceKeyValueDelete\",\n resourceKeyValueDelete: {\n ...this.toSignedResourceId(rId),\n key,\n },\n });\n }\n\n public async getKValue(rId: AnyResourceRef, key: string): Promise<Uint8Array> {\n return this.track(async () => {\n const result = await this.sendSingleAndParse(\n {\n oneofKind: \"resourceKeyValueGet\",\n resourceKeyValueGet: {\n ...this.toSignedResourceId(rId),\n key,\n },\n },\n (r) => r.resourceKeyValueGet.value,\n );\n\n this._stat.kvGetRequests++;\n this._stat.kvGetBytes += result.length;\n\n return result;\n });\n }\n\n public async getKValueString(rId: AnyResourceRef, key: string): Promise<string> {\n return this.track(async () => Buffer.from(await this.getKValue(rId, key)).toString());\n }\n\n public async getKValueJson<T>(rId: AnyResourceRef, key: string): Promise<T> {\n return this.track(async () => JSON.parse(await this.getKValueString(rId, key)) as T);\n }\n\n public async getKValueIfExists(\n rId: AnyResourceRef,\n key: string,\n ): Promise<Uint8Array | undefined> {\n return this.track(async () => {\n const result = await this.sendSingleAndParse(\n {\n oneofKind: \"resourceKeyValueGetIfExists\",\n resourceKeyValueGetIfExists: {\n ...this.toSignedResourceId(rId),\n key,\n },\n },\n (r) =>\n r.resourceKeyValueGetIfExists.exists ? r.resourceKeyValueGetIfExists.value : undefined,\n );\n\n this._stat.kvGetRequests++;\n this._stat.kvGetBytes += result?.length ?? 0;\n\n return result;\n });\n }\n\n public async getKValueStringIfExists(\n rId: AnyResourceRef,\n key: string,\n ): Promise<string | undefined> {\n return this.track(async () => {\n const data = await this.getKValueIfExists(rId, key);\n return data === undefined ? undefined : Buffer.from(data).toString();\n });\n }\n\n public async getKValueJsonIfExists<T>(rId: AnyResourceRef, key: string): Promise<T | undefined> {\n return this.track(async () => {\n const str = await this.getKValueStringIfExists(rId, key);\n if (str === undefined) return undefined;\n return JSON.parse(str) as T;\n });\n }\n\n //\n // Cache\n //\n // TODO\n\n //\n // High level ops\n //\n\n /** Resolves existing or create first level resource from */\n public getFutureFieldValue(rId: AnyRef, fieldName: string, fieldType: FutureFieldType): FieldRef {\n const data = Buffer.from(JSON.stringify({ fieldName, fieldType }));\n const getFieldResource = this.createEphemeral({ name: \"json/getField\", version: \"1\" }, data);\n this.setField({ resourceId: getFieldResource, fieldName: \"resource\" }, rId);\n return { resourceId: getFieldResource, fieldName: \"result\" };\n }\n\n //\n // Technical\n //\n\n public async getGlobalTxId() {\n this.globalTxIdWasAwaited = true;\n return await this.globalTxId;\n }\n\n /** Closes output event stream */\n public async complete() {\n if (this._completed) return;\n this._completed = true;\n const completeResult = this.track(this.ll.complete());\n await this.drainAndAwaitPendingOps();\n await completeResult;\n }\n\n /** Await incoming message loop termination and throw\n * any leftover errors if it was unsuccessful */\n public async await() {\n await this.ll.await();\n }\n\n //\n // Helpers\n //\n\n private nextLocalResourceId(root: boolean): LocalResourceId {\n return createLocalResourceId(root, ++this.localResourceIdCounter, this.localTxId);\n }\n\n private static localTxIdCounter = 0;\n\n private static nextLocalTxId() {\n PlTransaction.localTxIdCounter++;\n if (PlTransaction.localTxIdCounter === MaxTxId) PlTransaction.localTxIdCounter = 1;\n return PlTransaction.localTxIdCounter;\n }\n}\n"],"mappings":";;;;;;;;;;;;AA4FA,SAAgB,QAAQ,KAAiC;AACvD,QAAO,IAAI,eAAe,aAAa,IAAI,IAAI,eAAe,YAAY;;AAG5E,SAAgB,WAAW,KAAoC;AAC7D,KAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,KAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,QAAO,cAAc,IAAI;;AAG3B,SAAgB,aAAa,KAAsC;AACjE,QAAO,OAAO,QAAQ,YAAYA,cAAAA,mBAAmB,IAAI;;AAG3D,SAAgB,WAAW,KAAmC;AAC5D,QAAO,cAAc,IAAI,WAAW;;AAGtC,SAAgB,cAAc,KAAiC;AAC7D,QACE,OAAO,QAAQ,YACf,QAAQ,QACR,IAAI,eAAe,WAAW,IAC9B,IAAI,eAAe,UAAU;;AAIjC,SAAgB,UAAU,KAA8B;AACtD,KAAI,WAAW,IAAI,CAAE,QAAO;EAAE,YAAY,IAAI,WAAW;EAAS,WAAW,IAAI;EAAW;KACvF,QAAO;;AAGd,eAAsB,gBAAgB,KAA2C;AAC/E,KAAI,WAAW,IAAI,CACjB,QAAO;EAAE,YAAY,MAAM,IAAI,WAAW;EAAU,WAAW,IAAI;EAAW;AAChF,QAAO;;AAQT,MAAM,iBAAiBC,cAAAA,oBAAoB,IAAI,WAAW,EAAE,CAAC;AAE7D,SAAS,yBAAyB,KAA8C;AAC9E,KAAI,cAAc,IAAI,CAEpB,QAAO;EAAE,YAAY,IAAI;EAAS,mBAAmB;EAAgB;AAEvE,KAAI,aAAa,IAAI,EAAE;EAErB,MAAM,EAAE,UAAU,cAAcC,cAAAA,sBAAsB,IAAI;AAC1D,SAAO;GAAE,YAAY;GAAoB,mBAAmB;GAAW;;AAGzE,QAAO;EAAE,YAAY;EAAe,mBAAmB;EAAgB;;AAGzE,eAAsB,mBAAmB,KAAgD;AACvF,KAAI,cAAc,IAAI,CAAE,QAAO,MAAM,IAAI;AACzC,KAAIC,cAAAA,kBAAkB,IAAI,CAAE,QAAOC,cAAAA,uBAAuB,IAAI;AAC9D,QAAO;;AAGT,SAAgB,MAAM,YAA4B,WAAgC;AAChF,QAAO;EAAE;EAAY;EAAW;;;AAIlC,IAAa,mBAAb,cAAsC,MAAM;CAC1C,OAAO;;AAGT,eAAe,oBAAuB,IAA8C;AAClF,KAAI;AACF,SAAO,MAAM,IAAI;UACV,GAAG;AACV,MAAIC,eAAAA,gBAAgB,EAAE,CAAE,QAAO,KAAA;AAC/B,QAAM;;;;;;;;;;;AAYV,IAAa,gBAAb,MAAa,cAAc;CACzB;CACA,YAAqC,cAAc,eAAe;;CAGlE,kBAAmC,KAAK,KAAK;CAE7C,yBAAiC;;;;CAKjC,aAAqB;CAErB,uBAAwC;CAExC,UAA0B,IAAIC,uBAAAA,gBAAgB;CAE9C,aAA8B,KAAK,KAAK;CACxC,QAAyBC,aAAAA,0BAA0B;CACnD,IAAW,OAAe;AACxB,SAAO;GACL,GAAG,KAAK;GACR,QAAQ,KAAK,KAAK,GAAG,KAAK;GAC3B;;CAGH,YACE,IACA,MACA,UACA,aACA,gBACA,yBACA,wBAAkD,OAClD;AAPiB,OAAA,KAAA;AACD,OAAA,OAAA;AACA,OAAA,WAAA;AACC,OAAA,cAAA;AACA,OAAA,iBAAA;AACA,OAAA,0BAAA;AACA,OAAA,wBAAA;AAGjB,OAAK,aAAa,KAAK,mBACrB;GACE,WAAW;GACX,QAAQ;IACN;IACA;IACA,UAAU,WACNC,YAAAA,8BAA8B,WAC9BA,YAAAA,8BAA8B;IACnC;GACF,GACA,OAAA,GAAA,2BAAA,UAAe,EAAE,OAAO,IAAI,GAAG,CACjC;AAEI,OAAK,MAAM,KAAK,WAAW;AAGhC,OAAK,WAAW,OAAO,QAAQ;AAC7B,OAAI,CAAC,KAAK,qBACR,SAAQ,KAAK,IAAI;IAEnB;AAGF,OAAK,MAAM;;;;;CAMb,MAAgB,mBAAgE;AAC9E,SAAO,KAAK,QAAQ,MAAM,kBAAkB;;CAG9C,MAAc,0BAAyC;AAErD,QAAM,KAAK,QAAQ,UAAU;;CAG/B,mBACE,GACA,QACY;AACZ,SAAO,KAAK,QAAQ,MAAM,YAAY;GACpC,MAAM,qBAAqB,KAAK,GAAG,KAAK,GAAG,MAAM;AAE5C,QAAK,QAAQ,MAAM,mBAAmB;AAE3C,SAAM,KAAK,yBAAyB;AAGpC,UAAO,OAAO,MAAM,mBAAmB;IACvC;;CAGJ,kBACE,GACA,QACY;AACZ,SAAO,KAAK,QAAQ,MAAM,YAAY;GACpC,MAAM,qBAAqB,KAAK,GAAG,KAAK,GAAG,KAAK;AAE3C,QAAK,QAAQ,MAAM,mBAAmB;AAE3C,SAAM,KAAK,yBAAyB;AAGpC,UAAO,OAAO,MAAM,mBAAmB;IACvC;;CAGJ,MAAc,aACZ,GACe;AACf,QAAM,KAAK,GAAG,KAAK,GAAG,MAAM;;;CAI9B,cACE,GACM;AACD,OAAK,MAAM,KAAK,aAAa,EAAE,CAAC;;;CAIvC,gBAAuB,YAA8B;AACnD,OAAK,cAAc;GACjB,WAAW;GACX,iBAAiB,EAAE,YAAY;GAChC,CAAC;;CAGJ,mBAA2B,KAA8C;AACvE,SAAO,yBAAyB,IAAI;;CAGtC,gBAAwB,KAItB;EACA,MAAM,OAAO,UAAU,IAAI;EAC3B,MAAM,SAAS,yBAAyB,KAAK,WAAW;AACxD,SAAO;GACL,YAAY,OAAO;GACnB,WAAW,KAAK;GAChB,mBAAmB,OAAO;GAC3B;;CAGH,iBAAyB,KAGvB;EACA,MAAM,EAAE,YAAY,sBAAsB,KAAK,mBAAmB,IAAI;AACtE,SAAO;GAAE,iBAAiB;GAAY,wBAAwB;GAAmB;;CAGnF,cAAsB;AACpB,MAAI,KAAK,WAAY,OAAM,IAAI,MAAM,6BAA6B;;CAGpE,IAAW,YAAY;AACrB,SAAO,KAAK;;;;CAKd,MAAa,SAAS;AACpB,OAAK,aAAa;AAGlB,OAAK,aAAa;AAElB,MAAI,CAAC,KAAK,UAAU;GAElB,MAAM,iBAAiB,KAAK,MAAM,KAAK,GAAG,UAAU,CAAC;AACrD,SAAM,KAAK,yBAAyB;AACpC,SAAM;AACN,SAAM,KAAK,GAAG,OAAO;SAChB;GACL,MAAM,iBAAiB,KAAK,MAC1B,KAAK,mBAAmB;IAAE,WAAW;IAAY,UAAU,EAAE;IAAE,GAAG,MAAM,EAAE,SAAS,QAAQ,CAC5F;GAGD,MAAM,iBAAiB,KAAK,MAAM,KAAK,GAAG,UAAU,CAAC;AAIrD,SAAM,KAAK,yBAAyB;AAEpC,OAAI,CAAE,MAAM,eAAiB,OAAM,IAAI,kBAAkB;AAEzD,SAAM;AAGN,SAAM,KAAK,GAAG,OAAO;;;CAIzB,MAAa,UAAU;AACrB,OAAK,aAAa;AAGlB,OAAK,aAAa;EAElB,MAAM,kBAAkB,KAAK,aAAa;GAAE,WAAW;GAAa,WAAW,EAAE;GAAE,CAAC;AAC/E,OAAK,MAAM,gBAAgB;EAEhC,MAAM,iBAAiB,KAAK,MAAM,KAAK,GAAG,UAAU,CAAC;AAIrD,QAAM,KAAK,yBAAyB;AAEpC,QAAM;AACN,QAAM;AACN,QAAM,KAAK,GAAG,OAAO;;CAOvB,IAAW,aAA+B;AACxC,SAAOC,cAAAA,8BAA8B,KAAK,YAAY;;CAOxD,gBACE,MACA,MACA,gBAAyB,OACzB,OACa;AACb,SAAO,KAAK,eACV,QACC,aAAa;GACZ,WAAW;GACX,yBAAyB;IACvB;IACA,IAAI;IACJ,MAAM,OAAO,KAAK,KAAK;IACvB;IACA,YAAY,SAAS;IACtB;GACF,IACA,MAAM,EAAE,wBAAwB,aAChC,MAAM,EAAE,wBAAwB,kBAClC;;CAKH,aACE,MACA,aAAsB,MACqB;AAC3C,SAAO,KAAK,mBACV;GACE,WAAW;GACX,sBAAsB;IACpB,MAAM,OAAO,KAAK,KAAK;IACvB;IACD;GACF,GACA,MAAMC,wBAAAA,iBAAAA,GAAAA,2BAAAA,UAAyB,EAAE,qBAAqB,SAAS,CAAC,CAClE;;CAGH,eACE,MACA,KACA,QACA,cACa;EACb,MAAM,UAAU,KAAK,oBAAoB,KAAK;EAE9C,MAAM,WAAW,KAAK,mBAAmB,IAAI,QAAQ,GAAG,MAAM;AAG5D,UAAON,cAAAA,uBAFO,OAAO,EAAE,EACX,eAAeH,cAAAA,oBAAoB,aAAa,EAAE,CAAC,GAAG,KAAA,EACzB;IACzC;AAEG,OAAK,MAAM,SAAS;AAEzB,SAAO;GAAE;GAAU;GAAS;;CAG9B,WAAkB,MAAiC;AACjD,OAAK,MAAM;AACX,SAAO,KAAK,eACV,OACC,aAAa;GAAE,WAAW;GAAsB,oBAAoB;IAAE;IAAM,IAAI;IAAS;GAAE,IAC3F,MAAM,EAAE,mBAAmB,aAC3B,MAAM,EAAE,mBAAmB,kBAC7B;;CAGH,aACE,MACA,MACA,OACa;AACb,OAAK,MAAM;AACX,OAAK,MAAM,2BAA2B,MAAM,UAAU;AACtD,SAAO,KAAK,eACV,QACC,aAAa;GACZ,WAAW;GACX,sBAAsB;IACpB;IACA,IAAI;IACJ,MACE,SAAS,KAAA,IAAY,KAAA,IAAY,OAAO,SAAS,WAAW,OAAO,KAAK,KAAK,GAAG;IAClF,YAAY,SAAS;IACtB;GACF,IACA,MAAM,EAAE,qBAAqB,aAC7B,MAAM,EAAE,qBAAqB,kBAC/B;;CAGH,gBACE,MACA,MACA,OACa;AACb,OAAK,MAAM;AACX,OAAK,MAAM,8BAA8B,MAAM,UAAU;AACzD,SAAO,KAAK,eACV,QACC,aAAa;GACZ,WAAW;GACX,yBAAyB;IACvB;IACA,IAAI;IACJ,MACE,SAAS,KAAA,IAAY,KAAA,IAAY,OAAO,SAAS,WAAW,OAAO,KAAK,KAAK,GAAG;IAClF,YAAY,SAAS;IACtB;GACF,IACA,MAAM,EAAE,wBAAwB,aAChC,MAAM,EAAE,wBAAwB,kBAClC;;CAGH,YACE,MACA,MACA,gBAAyB,OACzB,OACa;AACb,OAAK,MAAM;AACX,OAAK,MAAM,0BAA0B,MAAM,UAAU;AACrD,SAAO,KAAK,eACV,QACC,aAAa;GACZ,WAAW;GACX,qBAAqB;IACnB;IACA,IAAI;IACJ,MAAM,OAAO,SAAS,WAAW,OAAO,KAAK,KAAK,GAAG;IACrD;IACA,YAAY,SAAS;IACtB;GACF,IACA,MAAM,EAAE,oBAAoB,aAC5B,MAAM,EAAE,oBAAoB,kBAC9B;;CAGH,gBAAuB,MAAe,OAAiC;EACrE,MAAM,YAAA,GAAA,2BAAA,oBAA8B,KAAK;AACzC,SAAO,KAAK,YAAYU,WAAAA,YAAY,UAAU,OAAO,MAAM;;CAG7D,kBACE,MACA,gBAAoC,OACpC,OACa;EACb,MAAM,EAAE,MAAM,UAAU,eAAA,GAAA,2BAAA,sBAAmC,MAAM,cAAc;AAC/E,SAAO,KAAK,YAAY,YAAYC,WAAAA,eAAeD,WAAAA,YAAY,UAAU,OAAO,MAAM;;CAGxF,YAAmB,SAAiB,OAAiC;AACnE,SAAO,KAAK,YACVE,uBAAAA,mBACA,KAAK,UAAU,EAAE,SAAS,CAA6B,EACvD,OACA,MACD;;CAGH,gBAAuB,MAAc,KAA2B;AAC9D,OAAK,cAAc;GACjB,WAAW;GACX,iBAAiB;IAAE,GAAG,KAAK,mBAAmB,IAAI;IAAE;IAAM;GAC3D,CAAC;;CAGJ,mBAA0B,MAAoB;AAC5C,OAAK,cAAc;GAAE,WAAW;GAAsB,oBAAoB,EAAE,MAAM;GAAE,CAAC;;CAGvF,kBAAyB,MAAyC;AAChE,SAAO,KAAK,mBACV;GAAE,WAAW;GAAmB,iBAAiB,EAAE,MAAM;GAAE,GAC1D,MAAM;GACL,MAAM,QAAQ,EAAE,gBAAgB;AAChC,OAAI,UAAU,GAAI,OAAM,IAAI,MAAM,0CAA0C;AAE5E,UAAOT,cAAAA,uBAAuB,OADlBH,cAAAA,oBAAoB,EAAE,gBAAgB,kBAAkB,CAC3B;IAE5C;;CAGH,wBAA+B,MAAgC;AAC7D,SAAO,KAAK,mBACV;GAAE,WAAW;GAAsB,oBAAoB,EAAE,MAAM;GAAE,GAChE,MAAM,EAAE,mBAAmB,OAC7B;;CAGH,eAAsB,KAA6B;AACjD,OAAK,cAAc;GACjB,WAAW;GACX,gBAAgB,KAAK,mBAAmB,IAAI;GAC7C,CAAC;;CAGJ,eAAsB,KAAyC;AAC7D,SAAO,KAAK,mBACV;GACE,WAAW;GACX,gBAAgB,KAAK,mBAAmB,IAAI;GAC7C,GACA,MAAM,EAAE,eAAe,OACzB;;CA8BH,MAAa,gBACX,KACA,aAAsB,MACtB,cAAuB,OACoB;AAC3C,SAAO,KAAK,MAAM,YAAY;AAC5B,OAAI,CAAC,eAAe,aAAa,IAAI,EAAE;IAErC,MAAM,YAAY,KAAK,wBAAwB,IAAI,IAAI;AACvD,QAAI,aAAa,UAAU,uBAAuB,KAAK;SACjD,CAAC,YAAY;AACf,WAAK,MAAM;AACX,WAAK,MAAM,sBAAsB,UAAU,UAAU,MAAM,UAAU;AACrE,aAAO,UAAU;gBACR,UAAU,MAAM;AACzB,WAAK,MAAM;AACX,WAAK,MAAM,sBAAsB,UAAU,UAAU,MAAM,UAAU;AACrE,WAAK,MAAM,uBAAuB,UAAU,KAAK,OAAO;AACxD,aAAO,UAAU;;;;GAKvB,MAAM,SAAS,MAAM,KAAK,mBACxB;IACE,WAAW;IACX,aAAa;KACX,GAAG,KAAK,mBAAmB,IAAI;KACnB;KACb;IACF,GACA,MAAMS,wBAAAA,iBAAAA,GAAAA,2BAAAA,UAAyB,EAAE,YAAY,SAAS,CAAC,CACzD;AAED,QAAK,MAAM;AACX,QAAK,MAAM,oBAAoB,OAAO,MAAM,UAAU;AACtD,QAAK,MAAM,qBAAqB,OAAO,OAAO;AAI9C,OAAI,aAAa,IAAI,IAAI,KAAK,eAAe,OAAO,EAAE;AACpD,KAAA,GAAA,2BAAA,YAAW,OAAO;IAClB,MAAM,YAAY,KAAK,wBAAwB,IAAI,IAAI;AACvD,QAAI;SACE,cAAc,CAAC,UAAU,MAAM;AACjC,gBAAU,OAAO;AAEjB,gBAAU,uBAAuB,KAAK;;WAEnC;KACL,MAAM,YAAYI,cAAAA,yBAAyB,OAAO;AAClD,MAAA,GAAA,2BAAA,YAAW,UAAU;AACrB,SAAI,WACF,MAAK,wBAAwB,IAAI,KAAK;MACpC;MACA,MAAM;MACN,sBAAsB,KAAK;MAC5B,CAAC;SAEF,MAAK,wBAAwB,IAAI,KAAK;MACpC;MACA,MAAM,KAAA;MACN,sBAAsB,KAAK;MAC5B,CAAC;;;AAIR,UAAO;IACP;;CAeJ,MAAa,wBACX,KACA,aAAsB,MACiC;AACvD,SAAO,KAAK,MAAM,YAAY;GAG5B,MAAM,SAAS,MAAM,oBACnB,YAAY,MAAM,KAAK,gBAAgB,KAAK,YAAY,KAAK,CAC9D;AAGD,OAAI,WAAW,KAAA,KAAa,aAAa,IAAI,CAAE,MAAK,wBAAwB,OAAO,IAAI;AAEvF,UAAO;IACP;;;;;;;;;CAUJ,WAAkB,KAA2B;AAC3C,OAAK,MAAM;AACX,OAAK,cAAc;GACjB,WAAW;GACX,oBAAoB,KAAK,mBAAmB,IAAI;GACjD,CAAC;;;;;;CAOJ,YAAmB,KAA2B;AAC5C,OAAK,MAAM;AACX,OAAK,cAAc;GACjB,WAAW;GACX,qBAAqB,KAAK,mBAAmB,IAAI;GAClD,CAAC;;CAGJ,KAAY,KAA2B;AACrC,OAAK,WAAW,IAAI;AACpB,OAAK,YAAY,IAAI;;CAGvB,iBAAwB,KAAqB,KAA2B;AACtE,OAAK,cAAc;GACjB,WAAW;GACX,kBAAkB;IAChB,GAAG,KAAK,mBAAmB,IAAI;IAC/B,GAAG,KAAK,iBAAiB,IAAI;IAC9B;GACF,CAAC;;CAOJ,YAAmB,KAAkB,WAAsB,OAAsB;AAC/E,OAAK,MAAM;AACX,OAAK,cAAc;GACjB,WAAW;GACX,aAAa;IAAE,MAAMC,wBAAAA,iBAAiB,UAAU;IAAE,IAAI,KAAK,gBAAgB,IAAI;IAAE;GAClF,CAAC;AACF,MAAI,UAAU,KAAA,EAAW,MAAK,SAAS,KAAK,MAAM;;CAGpD,YAAmB,KAAoC;AACrD,SAAO,KAAK,mBACV;GACE,WAAW;GACX,aAAa,EAAE,OAAO,KAAK,gBAAgB,IAAI,EAAE;GAClD,GACA,MAAM,EAAE,YAAY,OACtB;;CAGH,SAAgB,KAAkB,KAAmB;AACnD,OAAK,MAAM;AACX,MAAI,WAAW,IAAI,CACjB,MAAK,cAAc;GACjB,WAAW;GACX,UAAU;IACR,OAAO,KAAK,gBAAgB,IAAI;IAChC,OAAO;KACL,GAAG,KAAK,mBAAmB,IAAI;KAC/B,WAAW;KACZ;IACF;GACF,CAAC;MAEF,MAAK,cAAc;GACjB,WAAW;GACX,UAAU;IACR,OAAO,KAAK,gBAAgB,IAAI;IAChC,OAAO,KAAK,gBAAgB,IAAI;IACjC;GACF,CAAC;;CAIN,cAAqB,KAAkB,KAA2B;AAChE,OAAK,MAAM;AACX,OAAK,cAAc;GACjB,WAAW;GACX,eAAe;IACb,OAAO,KAAK,gBAAgB,IAAI;IAChC,GAAG,KAAK,iBAAiB,IAAI;IAC9B;GACF,CAAC;;CAGJ,SAAgB,KAAsC;AACpD,OAAK,MAAM;AACX,SAAO,KAAK,mBACV;GAAE,WAAW;GAAY,UAAU,EAAE,OAAO,KAAK,gBAAgB,IAAI,EAAE;GAAE,GACxE,MAAMC,wBAAAA,cAAAA,GAAAA,2BAAAA,UAAsB,EAAE,SAAS,MAAM,CAAC,CAChD;;CAGH,MAAa,iBAAiB,KAAkD;AAC9E,SAAO,KAAK,MAAM,oBAAoB,YAAY,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC;;CAG9E,WAAkB,KAAwB;AACxC,OAAK,cAAc;GACjB,WAAW;GACX,YAAY,EAAE,OAAO,KAAK,gBAAgB,IAAI,EAAE;GACjD,CAAC;;CAGJ,YAAmB,KAAwB;AACzC,OAAK,cAAc;GACjB,WAAW;GACX,aAAa,EAAE,OAAO,KAAK,gBAAgB,IAAI,EAAE;GAClD,CAAC;;CAOJ,MAAa,cAAc,KAA0C;AACnE,SAAO,KAAK,MAAM,YAAY;GAC5B,MAAM,SAAS,MAAM,KAAK,kBACxB;IACE,WAAW;IACX,sBAAsB;KACpB,GAAG,KAAK,mBAAmB,IAAI;KAC/B,WAAW;KACX,OAAO;KACR;IACF,GACA,MAAM,EAAE,KAAK,MAAM,EAAE,qBAAqB,OAAQ,CACpD;AAED,QAAK,MAAM;AACX,QAAK,MAAM,iBAAiB,OAAO;AACnC,QAAK,MAAM,MAAM,OAAQ,MAAK,MAAM,eAAe,GAAG,IAAI,SAAS,GAAG,MAAM;AAE5E,UAAO;IACP;;CAGJ,MAAa,oBAAoB,KAAgD;AAC/E,SAAO,KAAK,MAAM,aACf,MAAM,KAAK,cAAc,IAAI,EAAE,KAAK,EAAE,KAAK,aAAa;GACvD;GACA,OAAO,OAAO,KAAK,MAAM,CAAC,UAAU;GACrC,EAAE,CACJ;;CAGH,MAAa,8BAA8B,KAAsD;AAC/F,SAAO,KAAK,MAAM,oBAAoB,YAAY,MAAM,KAAK,cAAc,IAAI,CAAC,CAAC;;CAGnF,MAAa,oCACX,KACuC;AACvC,SAAO,KAAK,MAAM,oBAAoB,YAAY,MAAM,KAAK,oBAAoB,IAAI,CAAC,CAAC;;CAGzF,UAAiB,KAAqB,KAAa,OAAkC;AACnF,OAAK,MAAM;AACX,OAAK,MAAM;AACX,OAAK,cAAc;GACjB,WAAW;GACX,qBAAqB;IACnB,GAAG,KAAK,mBAAmB,IAAI;IAC/B;IACA,OAAOC,aAAAA,QAAQ,MAAM;IACtB;GACF,CAAC;;CAGJ,aAAoB,KAAqB,KAAmB;AAC1D,OAAK,cAAc;GACjB,WAAW;GACX,wBAAwB;IACtB,GAAG,KAAK,mBAAmB,IAAI;IAC/B;IACD;GACF,CAAC;;CAGJ,MAAa,UAAU,KAAqB,KAAkC;AAC5E,SAAO,KAAK,MAAM,YAAY;GAC5B,MAAM,SAAS,MAAM,KAAK,mBACxB;IACE,WAAW;IACX,qBAAqB;KACnB,GAAG,KAAK,mBAAmB,IAAI;KAC/B;KACD;IACF,GACA,MAAM,EAAE,oBAAoB,MAC9B;AAED,QAAK,MAAM;AACX,QAAK,MAAM,cAAc,OAAO;AAEhC,UAAO;IACP;;CAGJ,MAAa,gBAAgB,KAAqB,KAA8B;AAC9E,SAAO,KAAK,MAAM,YAAY,OAAO,KAAK,MAAM,KAAK,UAAU,KAAK,IAAI,CAAC,CAAC,UAAU,CAAC;;CAGvF,MAAa,cAAiB,KAAqB,KAAyB;AAC1E,SAAO,KAAK,MAAM,YAAY,KAAK,MAAM,MAAM,KAAK,gBAAgB,KAAK,IAAI,CAAC,CAAM;;CAGtF,MAAa,kBACX,KACA,KACiC;AACjC,SAAO,KAAK,MAAM,YAAY;GAC5B,MAAM,SAAS,MAAM,KAAK,mBACxB;IACE,WAAW;IACX,6BAA6B;KAC3B,GAAG,KAAK,mBAAmB,IAAI;KAC/B;KACD;IACF,GACA,MACC,EAAE,4BAA4B,SAAS,EAAE,4BAA4B,QAAQ,KAAA,EAChF;AAED,QAAK,MAAM;AACX,QAAK,MAAM,cAAc,QAAQ,UAAU;AAE3C,UAAO;IACP;;CAGJ,MAAa,wBACX,KACA,KAC6B;AAC7B,SAAO,KAAK,MAAM,YAAY;GAC5B,MAAM,OAAO,MAAM,KAAK,kBAAkB,KAAK,IAAI;AACnD,UAAO,SAAS,KAAA,IAAY,KAAA,IAAY,OAAO,KAAK,KAAK,CAAC,UAAU;IACpE;;CAGJ,MAAa,sBAAyB,KAAqB,KAAqC;AAC9F,SAAO,KAAK,MAAM,YAAY;GAC5B,MAAM,MAAM,MAAM,KAAK,wBAAwB,KAAK,IAAI;AACxD,OAAI,QAAQ,KAAA,EAAW,QAAO,KAAA;AAC9B,UAAO,KAAK,MAAM,IAAI;IACtB;;;CAaJ,oBAA2B,KAAa,WAAmB,WAAsC;EAC/F,MAAM,OAAO,OAAO,KAAK,KAAK,UAAU;GAAE;GAAW;GAAW,CAAC,CAAC;EAClE,MAAM,mBAAmB,KAAK,gBAAgB;GAAE,MAAM;GAAiB,SAAS;GAAK,EAAE,KAAK;AAC5F,OAAK,SAAS;GAAE,YAAY;GAAkB,WAAW;GAAY,EAAE,IAAI;AAC3E,SAAO;GAAE,YAAY;GAAkB,WAAW;GAAU;;CAO9D,MAAa,gBAAgB;AAC3B,OAAK,uBAAuB;AAC5B,SAAO,MAAM,KAAK;;;CAIpB,MAAa,WAAW;AACtB,MAAI,KAAK,WAAY;AACrB,OAAK,aAAa;EAClB,MAAM,iBAAiB,KAAK,MAAM,KAAK,GAAG,UAAU,CAAC;AACrD,QAAM,KAAK,yBAAyB;AACpC,QAAM;;;;CAKR,MAAa,QAAQ;AACnB,QAAM,KAAK,GAAG,OAAO;;CAOvB,oBAA4B,MAAgC;AAC1D,SAAOC,cAAAA,sBAAsB,MAAM,EAAE,KAAK,wBAAwB,KAAK,UAAU;;CAGnF,OAAe,mBAAmB;CAElC,OAAe,gBAAgB;AAC7B,gBAAc;AACd,MAAI,cAAc,qBAAA,WAA8B,eAAc,mBAAmB;AACjF,SAAO,cAAc"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { BasicResourceData, ColorProof, FieldData, FieldType, FutureFieldType, LocalResourceId, OptionalSignedResourceId, ResourceData, ResourceSignature, ResourceType, SignedResourceId } from "./types.js";
|
|
2
2
|
import { LLPlTransaction } from "./ll_transaction.js";
|
|
3
3
|
import { FinalResourceDataPredicate } from "./final.js";
|
|
4
4
|
import { ResourceDataCacheRecord } from "./cache.js";
|
|
@@ -11,7 +11,7 @@ import { LRUCache } from "lru-cache";
|
|
|
11
11
|
interface ResourceRef {
|
|
12
12
|
/** Global resource id of newly created resources, become available only
|
|
13
13
|
* after response for the corresponding creation request is received. */
|
|
14
|
-
readonly globalId: Promise<
|
|
14
|
+
readonly globalId: Promise<SignedResourceId>;
|
|
15
15
|
/** Transaction-local resource id is assigned right after resource creation
|
|
16
16
|
* request is sent, and can be used right away */
|
|
17
17
|
readonly localId: LocalResourceId;
|
|
@@ -32,22 +32,25 @@ interface _FieldId<RId> {
|
|
|
32
32
|
/** Field name */
|
|
33
33
|
fieldName: string;
|
|
34
34
|
}
|
|
35
|
-
type FieldId = _FieldId<
|
|
35
|
+
type FieldId = _FieldId<SignedResourceId>;
|
|
36
36
|
type FieldRef = _FieldId<ResourceRef>;
|
|
37
37
|
type LocalFieldId = _FieldId<LocalResourceId>;
|
|
38
38
|
type AnyFieldId = FieldId | LocalFieldId;
|
|
39
|
-
type AnyResourceRef = ResourceRef |
|
|
39
|
+
type AnyResourceRef = ResourceRef | LocalResourceId | SignedResourceId;
|
|
40
40
|
type AnyFieldRef = _FieldId<AnyResourceRef>;
|
|
41
41
|
type AnyRef = AnyResourceRef | AnyFieldRef;
|
|
42
42
|
declare function isField(ref: AnyRef): ref is AnyFieldRef;
|
|
43
43
|
declare function isResource(ref: AnyRef): ref is AnyResourceRef;
|
|
44
|
-
declare function isResourceId(ref: AnyRef): ref is
|
|
44
|
+
declare function isResourceId(ref: AnyRef): ref is SignedResourceId;
|
|
45
45
|
declare function isFieldRef(ref: AnyFieldRef): ref is FieldRef;
|
|
46
|
-
declare function isResourceRef(ref:
|
|
46
|
+
declare function isResourceRef(ref: AnyRef): ref is ResourceRef;
|
|
47
47
|
declare function toFieldId(ref: AnyFieldRef): AnyFieldId;
|
|
48
|
-
declare function toGlobalFieldId(ref:
|
|
49
|
-
|
|
50
|
-
|
|
48
|
+
declare function toGlobalFieldId(ref: FieldRef | FieldId): Promise<FieldId>;
|
|
49
|
+
interface ResourceIdWithSignature {
|
|
50
|
+
resourceId: bigint;
|
|
51
|
+
resourceSignature: ResourceSignature;
|
|
52
|
+
}
|
|
53
|
+
declare function toGlobalResourceId(ref: AnyResourceRef): Promise<SignedResourceId>;
|
|
51
54
|
declare function field(resourceId: AnyResourceRef, fieldName: string): AnyFieldRef;
|
|
52
55
|
/** If transaction commit failed due to write conflicts */
|
|
53
56
|
declare class TxCommitConflict extends Error {
|
|
@@ -83,7 +86,7 @@ declare class PlTransaction {
|
|
|
83
86
|
private readonly _startTime;
|
|
84
87
|
private readonly _stat;
|
|
85
88
|
get stat(): TxStat;
|
|
86
|
-
constructor(ll: LLPlTransaction, name: string, writable: boolean, _clientRoot:
|
|
89
|
+
constructor(ll: LLPlTransaction, name: string, writable: boolean, _clientRoot: OptionalSignedResourceId, finalPredicate: FinalResourceDataPredicate, sharedResourceDataCache: LRUCache<SignedResourceId, ResourceDataCacheRecord>, enableFormattedErrors?: boolean);
|
|
87
90
|
/**
|
|
88
91
|
* Collect all pending promises for the transaction finalization.
|
|
89
92
|
*/
|
|
@@ -94,30 +97,35 @@ declare class PlTransaction {
|
|
|
94
97
|
private sendVoidSync;
|
|
95
98
|
/** Requests sent with this method should never produce recoverable errors */
|
|
96
99
|
private sendVoidAsync;
|
|
100
|
+
/** Set default color proof for subsequent resource creation requests */
|
|
101
|
+
setDefaultColor(colorProof: ColorProof): void;
|
|
102
|
+
private toSignedResourceId;
|
|
103
|
+
private toSignedFieldId;
|
|
104
|
+
private toSignedErrorRef;
|
|
97
105
|
private checkTxOpen;
|
|
98
106
|
get completed(): boolean;
|
|
99
107
|
/** Commit & closes transaction. {@link TxCommitConflict} is thrown on
|
|
100
108
|
* commit conflicts. */
|
|
101
109
|
commit(): Promise<void>;
|
|
102
110
|
discard(): Promise<void>;
|
|
103
|
-
get clientRoot():
|
|
104
|
-
createSingleton(name: string, type: ResourceType, errorIfExists?: boolean): ResourceRef;
|
|
111
|
+
get clientRoot(): SignedResourceId;
|
|
112
|
+
createSingleton(name: string, type: ResourceType, errorIfExists?: boolean, color?: ColorProof): ResourceRef;
|
|
105
113
|
getSingleton(name: string, loadFields: true): Promise<ResourceData>;
|
|
106
114
|
getSingleton(name: string, loadFields: false): Promise<BasicResourceData>;
|
|
107
115
|
private createResource;
|
|
108
116
|
createRoot(type: ResourceType): ResourceRef;
|
|
109
|
-
createStruct(type: ResourceType, data?: Uint8Array | string): ResourceRef;
|
|
110
|
-
createEphemeral(type: ResourceType, data?: Uint8Array | string): ResourceRef;
|
|
111
|
-
createValue(type: ResourceType, data: Uint8Array | string, errorIfExists?: boolean): ResourceRef;
|
|
112
|
-
createJsonValue(data: unknown): ResourceRef;
|
|
113
|
-
createJsonGzValue(data: unknown, minSizeToGzip?: number | undefined): ResourceRef;
|
|
114
|
-
createError(message: string): ResourceRef;
|
|
117
|
+
createStruct(type: ResourceType, data?: Uint8Array | string, color?: ColorProof): ResourceRef;
|
|
118
|
+
createEphemeral(type: ResourceType, data?: Uint8Array | string, color?: ColorProof): ResourceRef;
|
|
119
|
+
createValue(type: ResourceType, data: Uint8Array | string, errorIfExists?: boolean, color?: ColorProof): ResourceRef;
|
|
120
|
+
createJsonValue(data: unknown, color?: ColorProof): ResourceRef;
|
|
121
|
+
createJsonGzValue(data: unknown, minSizeToGzip?: number | undefined, color?: ColorProof): ResourceRef;
|
|
122
|
+
createError(message: string, color?: ColorProof): ResourceRef;
|
|
115
123
|
setResourceName(name: string, rId: AnyResourceRef): void;
|
|
116
124
|
deleteResourceName(name: string): void;
|
|
117
|
-
getResourceByName(name: string): Promise<
|
|
125
|
+
getResourceByName(name: string): Promise<SignedResourceId>;
|
|
118
126
|
checkResourceNameExists(name: string): Promise<boolean>;
|
|
119
|
-
removeResource(rId:
|
|
120
|
-
resourceExists(rId:
|
|
127
|
+
removeResource(rId: SignedResourceId): void;
|
|
128
|
+
resourceExists(rId: SignedResourceId): Promise<boolean>;
|
|
121
129
|
/** This method may return stale resource state from cache if resource was removed */
|
|
122
130
|
getResourceData(rId: AnyResourceRef, loadFields: true): Promise<ResourceData>;
|
|
123
131
|
/** This method may return stale resource state from cache if resource was removed */
|
|
@@ -181,5 +189,5 @@ declare class PlTransaction {
|
|
|
181
189
|
private static nextLocalTxId;
|
|
182
190
|
}
|
|
183
191
|
//#endregion
|
|
184
|
-
export { AnyFieldId, AnyFieldRef, AnyRef, AnyResourceRef, FieldId, FieldRef, KeyValue, KeyValueString, LocalFieldId, PlTransaction, ResourceRef, TxCommitConflict, field, isField, isFieldRef, isResource, isResourceId, isResourceRef, toFieldId, toGlobalFieldId, toGlobalResourceId
|
|
192
|
+
export { AnyFieldId, AnyFieldRef, AnyRef, AnyResourceRef, FieldId, FieldRef, KeyValue, KeyValueString, LocalFieldId, PlTransaction, ResourceIdWithSignature, ResourceRef, TxCommitConflict, field, isField, isFieldRef, isResource, isResourceId, isResourceRef, toFieldId, toGlobalFieldId, toGlobalResourceId };
|
|
185
193
|
//# sourceMappingURL=transaction.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"transaction.d.ts","names":[],"sources":["../../src/core/transaction.ts"],"mappings":";;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"transaction.d.ts","names":[],"sources":["../../src/core/transaction.ts"],"mappings":"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"}
|