@milaboratories/pl-client 2.17.7 → 2.17.8

package/dist/core/ll_transaction.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ll_transaction.cjs","sources":["../../src/core/ll_transaction.ts"],"sourcesContent":["import type {\n  TxAPI_ClientMessage,\n  TxAPI_ServerMessage,\n} from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api\";\nimport type { BiDiStream } from \"./abstract_stream\";\nimport Denque from \"denque\";\nimport type { Status } from \"../proto-grpc/github.com/googleapis/googleapis/google/rpc/status\";\nimport {\n  PlErrorCodeNotFound,\n  RecoverablePlError,\n  rethrowMeaningfulError,\n  UnrecoverablePlError,\n} from \"./errors\";\nimport { StatefulPromise } from \"./StatefulPromise\";\n\nexport type ClientMessageRequest = TxAPI_ClientMessage[\"request\"];\n\nexport type ServerMessageResponse = TxAPI_ServerMessage[\"response\"];\n\ntype TxStream = BiDiStream<TxAPI_ClientMessage, TxAPI_ServerMessage>;\n\nexport type OneOfKind<T extends { oneofKind: unknown }, Kind extends T[\"oneofKind\"]> = Extract<\n  T,\n  { oneofKind: Kind }\n>;\n\ninterface SingleResponseHandler<Kind extends ServerMessageResponse[\"oneofKind\"]> {\n  kind: Kind;\n  expectMultiResponse: false;\n  resolve: (v: OneOfKind<ServerMessageResponse, Kind>) => void;\n  reject: (e: Error) => void;\n}\n\ninterface MultiResponseHandler<Kind extends ServerMessageResponse[\"oneofKind\"]> {\n  kind: Kind;\n  expectMultiResponse: true;\n  resolve: (v: OneOfKind<ServerMessageResponse, Kind>[]) => void;\n  reject: (e: Error) => void;\n}\n\ntype AnySingleResponseHandler = SingleResponseHandler<ServerMessageResponse[\"oneofKind\"]>;\n\ntype AnyMultiResponseHandler = MultiResponseHandler<ServerMessageResponse[\"oneofKind\"]>;\n\ntype AnyResponseHandler =\n  | SingleResponseHandler<ServerMessageResponse[\"oneofKind\"]>\n  | MultiResponseHandler<ServerMessageResponse[\"oneofKind\"]>;\n\nfunction createResponseHandler<Kind extends ServerMessageResponse[\"oneofKind\"]>(\n  kind: Kind,\n  expectMultiResponse: boolean,\n  resolve:\n    | ((v: OneOfKind<ServerMessageResponse, Kind>) => void)\n    | ((v: OneOfKind<ServerMessageResponse, Kind>[]) => void),\n  reject: (e: Error) => void,\n): AnyResponseHandler {\n  return { kind, expectMultiResponse, resolve, reject } as AnyResponseHandler;\n}\n\nfunction isRecoverable(status: Status): boolean {\n  return status.code === PlErrorCodeNotFound;\n}\n\nexport class RethrowError extends Error {\n  name = \"RethrowError\";\n  constructor(public readonly rethrowLambda: () => never) {\n    super(\"Rethrow error, you should never see this one.\");\n  }\n}\n\nexport class LLPlTransaction {\n  /** Bidirectional channel through which transaction communicates with the server */\n  private readonly stream: TxStream;\n\n  /** Used to abort ongoing transaction stream */\n  private readonly abortController = new AbortController();\n\n  /** Counter of sent requests, used to calculate which future response will correspond to this request.\n   * Incremented on each sent request. */\n  private requestIdxCounter = 0;\n\n  /** Queue from which incoming message processor takes handlers to which pass incoming messages */\n  private readonly responseHandlerQueue = new Denque<AnyResponseHandler>();\n\n  /** Each new resource, created by the transaction, is assigned with virtual (local) resource id, to make it possible\n   * to populate its fields without awaiting actual resource id. This counter tracks those ids on client side, the\n   * same way it is tracked on the server, so client can synchronously return such ids to the user. */\n  private localResourceIdCounter = 0n;\n\n  /** Switches to true, when this transaction closes due to normal or exceptional conditions. Prevents any new messages\n   * to be sent to the stream. */\n  private closed = false;\n  /** Whether the outgoing stream was already closed. */\n  private completed = false;\n\n  /** If this transaction was terminated due to error, this is a generator to create new errors if corresponding response is required. */\n  private errorFactory?: () => never;\n\n  /** Timestamp when transaction was opened */\n  private readonly openTimestamp = Date.now();\n\n  private readonly incomingProcessorResult: Promise<(() => never) | null>;\n\n  constructor(streamFactory: (abortSignal: AbortSignal) => TxStream) {\n    this.stream = streamFactory(this.abortController.signal);\n\n    // Starting incoming event processor\n    this.incomingProcessorResult = this.incomingEventProcessor();\n  }\n\n  private assignErrorFactoryIfNotSet(\n    errorFactory: () => never,\n    reject?: (e: Error) => void,\n  ): () => never {\n    if (reject !== undefined) reject(new RethrowError(errorFactory));\n    if (this.errorFactory) return errorFactory;\n    this.errorFactory = errorFactory;\n    return errorFactory;\n  }\n\n  private async incomingEventProcessor(): Promise<(() => never) | null> {\n    /** Counter of received responses, used to check consistency of responses.\n     * Increments on each received message. */\n    let expectedId = -1;\n\n    // defined externally to make possible to communicate any processing errors\n    // to the specific request on which it happened\n    let currentHandler: AnyResponseHandler | undefined = undefined;\n    let responseAggregator: ServerMessageResponse[] | undefined = undefined;\n    try {\n      for await (const message of this.stream.responses) {\n        if (currentHandler === undefined) {\n          currentHandler = this.responseHandlerQueue.shift();\n\n          if (currentHandler === undefined) {\n            this.assignErrorFactoryIfNotSet(() => {\n              throw new Error(`orphan incoming message`);\n            });\n            break;\n          }\n\n          // allocating response aggregator array\n          if (currentHandler.expectMultiResponse) responseAggregator = [];\n\n          expectedId++;\n        }\n\n        if (message.requestId !== expectedId) {\n          const errorMessage = `out of order messages, ${message.requestId} !== ${expectedId}`;\n          this.assignErrorFactoryIfNotSet(() => {\n            throw new Error(errorMessage);\n          });\n          break;\n        }\n\n        if (message.error !== undefined) {\n          const status = message.error;\n\n          if (isRecoverable(status)) {\n            currentHandler.reject(\n              new RethrowError(() => {\n                throw new RecoverablePlError(status);\n              }),\n            );\n            currentHandler = undefined;\n\n            if (message.multiMessage !== undefined && !message.multiMessage.isLast) {\n              this.assignErrorFactoryIfNotSet(() => {\n                throw new Error(\"Unexpected message sequence.\");\n              });\n              break;\n            }\n\n            // We can continue to work after recoverable errors\n            continue;\n          } else {\n            this.assignErrorFactoryIfNotSet(() => {\n              throw new UnrecoverablePlError(status);\n            }, currentHandler.reject);\n            currentHandler = undefined;\n\n            // In case of unrecoverable errors we close the transaction\n            break;\n          }\n        }\n\n        if (\n          currentHandler.kind !== message.response.oneofKind &&\n          message?.multiMessage?.isEmpty !== true\n        ) {\n          const errorMessage = `inconsistent request response types: ${currentHandler.kind} !== ${message.response.oneofKind}`;\n\n          this.assignErrorFactoryIfNotSet(() => {\n            throw new Error(errorMessage);\n          }, currentHandler.reject);\n          currentHandler = undefined;\n\n          break;\n        }\n\n        if (currentHandler.expectMultiResponse !== (message.multiMessage !== undefined)) {\n          const errorMessage = `inconsistent multi state: ${currentHandler.expectMultiResponse} !== ${message.multiMessage !== undefined}`;\n\n          this.assignErrorFactoryIfNotSet(() => {\n            throw new Error(errorMessage);\n          }, currentHandler.reject);\n          currentHandler = undefined;\n\n          break;\n        }\n\n        // <- at this point we validated everything we can at this level\n\n        if (message.multiMessage !== undefined) {\n          if (!message.multiMessage.isEmpty) {\n            if (message.multiMessage.id !== responseAggregator!.length + 1) {\n              const errorMessage = `inconsistent multi id: ${message.multiMessage.id} !== ${responseAggregator!.length + 1}`;\n\n              this.assignErrorFactoryIfNotSet(() => {\n                throw new Error(errorMessage);\n              }, currentHandler.reject);\n              currentHandler = undefined;\n\n              break;\n            }\n\n            responseAggregator!.push(message.response);\n          }\n\n          if (message.multiMessage.isLast) {\n            (currentHandler as AnyMultiResponseHandler).resolve(responseAggregator!);\n            responseAggregator = undefined;\n            currentHandler = undefined;\n          }\n        } else {\n          (currentHandler as AnySingleResponseHandler).resolve(message.response);\n          currentHandler = undefined;\n        }\n\n        // After receiving a terminal response (txCommit or txDiscard), we proactively close the client stream.\n        // This ensures consistent behavior between the gRPC and WebSocket transports,\n        // since the server closes the connection automatically upon transaction completion in both cases.\n        if (this.isTerminalResponse(message) && this.responseHandlerQueue.length === 0) {\n          await this.stream.requests.complete();\n        }\n      }\n    } catch (e: any) {\n      return this.assignErrorFactoryIfNotSet(() => {\n        rethrowMeaningfulError(e, true);\n      }, currentHandler?.reject);\n    } finally {\n      await this.close();\n    }\n    return null;\n  }\n\n  /** Executed after termination of incoming message processor */\n  private async close(): Promise<void> {\n    if (this.closed) return;\n\n    this.closed = true;\n\n    // Rejecting all messages\n\n    while (true) {\n      const handler = this.responseHandlerQueue.shift();\n      if (!handler) break;\n      if (this.errorFactory) handler.reject(new RethrowError(this.errorFactory));\n      else handler.reject(new Error(\"no reply\"));\n    }\n\n    // closing outgoing stream\n    await this.stream.requests.complete();\n  }\n\n  /** Forcefully close the transaction, terminate all connections and reject all pending requests */\n  public abort(cause?: Error) {\n    this.assignErrorFactoryIfNotSet(() => {\n      throw new Error(`transaction aborted`, { cause });\n    });\n    this.abortController.abort(cause);\n  }\n\n  /** Await incoming message loop termination and throw any leftover errors if it was unsuccessful */\n  public async await(): Promise<void> {\n    // for those who want to understand \"why?\":\n    // this way there is no hanging promise that will complete with rejection\n    // until await is implicitly requested, the this.incomingProcessorResult\n    // always resolves with success\n\n    const processingResult = await this.incomingProcessorResult;\n    if (processingResult !== null) processingResult();\n  }\n\n  public async send<Kind extends ClientMessageRequest[\"oneofKind\"]>(\n    r: OneOfKind<ClientMessageRequest, Kind>,\n    expectMultiResponse: false,\n  ): Promise<OneOfKind<ServerMessageResponse, Kind>>;\n  public async send<Kind extends ClientMessageRequest[\"oneofKind\"]>(\n    r: OneOfKind<ClientMessageRequest, Kind>,\n    expectMultiResponse: true,\n  ): Promise<OneOfKind<ServerMessageResponse, Kind>[]>;\n  /** Generate proper client message and send it to the server, and returns a promise of future response. */\n  public async send<Kind extends ClientMessageRequest[\"oneofKind\"]>(\n    r: OneOfKind<ClientMessageRequest, Kind>,\n    expectMultiResponse: boolean,\n  ): Promise<OneOfKind<ServerMessageResponse, Kind> | OneOfKind<ServerMessageResponse, Kind>[]> {\n    if (this.errorFactory) return Promise.reject(new RethrowError(this.errorFactory));\n\n    if (this.closed) return Promise.reject(new Error(\"Transaction already closed\"));\n\n    // Note: Promise synchronously executes a callback passed to a constructor\n    const result = StatefulPromise.fromDeferredReject(\n      new Promise<OneOfKind<ServerMessageResponse, Kind>>((resolve, reject) => {\n        this.responseHandlerQueue.push(\n          createResponseHandler(r.oneofKind, expectMultiResponse, resolve, reject),\n        );\n      }),\n    );\n\n    // Awaiting message dispatch to catch any associated errors.\n    // There is no hurry, we are not going to receive a response until message is sent.\n    await this.stream.requests.send({\n      requestId: this.requestIdxCounter++,\n      request: r,\n    });\n\n    try {\n      return await result;\n    } catch (e: any) {\n      if (e instanceof RethrowError) e.rethrowLambda();\n      throw new Error(\"Error while waiting for response\", { cause: e });\n    }\n  }\n\n  private _completed = false;\n\n  /** Safe to call multiple times */\n  public async complete() {\n    if (this._completed) return;\n    this._completed = true;\n    await this.stream.requests.complete();\n  }\n\n  private isTerminalResponse(message: TxAPI_ServerMessage): boolean {\n    const kind = message.response.oneofKind;\n    return kind === \"txCommit\" || kind === \"txDiscard\";\n  }\n}\n"],"names":["PlErrorCodeNotFound","RecoverablePlError","UnrecoverablePlError","rethrowMeaningfulError","StatefulPromise"],"mappings":";;;;;;AAgDA,SAAS,qBAAqB,CAC5B,IAAU,EACV,mBAA4B,EAC5B,OAE2D,EAC3D,MAA0B,EAAA;IAE1B,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAwB;AAC7E;AAEA,SAAS,aAAa,CAAC,MAAc,EAAA;AACnC,IAAA,OAAO,MAAM,CAAC,IAAI,KAAKA,0BAAmB;AAC5C;AAEM,MAAO,YAAa,SAAQ,KAAK,CAAA;AAET,IAAA,aAAA;IAD5B,IAAI,GAAG,cAAc;AACrB,IAAA,WAAA,CAA4B,aAA0B,EAAA;QACpD,KAAK,CAAC,+CAA+C,CAAC;QAD5B,IAAA,CAAA,aAAa,GAAb,aAAa;IAEzC;AACD;MAEY,eAAe,CAAA;;AAET,IAAA,MAAM;;AAGN,IAAA,eAAe,GAAG,IAAI,eAAe,EAAE;AAExD;AACuC;IAC/B,iBAAiB,GAAG,CAAC;;AAGZ,IAAA,oBAAoB,GAAG,IAAI,MAAM,EAAsB;AAExE;;AAEoG;IAC5F,sBAAsB,GAAG,EAAE;AAEnC;AAC+B;IACvB,MAAM,GAAG,KAAK;;IAEd,SAAS,GAAG,KAAK;;AAGjB,IAAA,YAAY;;AAGH,IAAA,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE;AAE1B,IAAA,uBAAuB;AAExC,IAAA,WAAA,CAAY,aAAqD,EAAA;QAC/D,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;;AAGxD,QAAA,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,sBAAsB,EAAE;IAC9D;IAEQ,0BAA0B,CAChC,YAAyB,EACzB,MAA2B,EAAA;QAE3B,IAAI,MAAM,KAAK,SAAS;AAAE,YAAA,MAAM,CAAC,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC;QAChE,IAAI,IAAI,CAAC,YAAY;AAAE,YAAA,OAAO,YAAY;AAC1C,QAAA,IAAI,CAAC,YAAY,GAAG,YAAY;AAChC,QAAA,OAAO,YAAY;IACrB;AAEQ,IAAA,MAAM,sBAAsB,GAAA;AAClC;AAC0C;AAC1C,QAAA,IAAI,UAAU,GAAG,EAAE;;;QAInB,IAAI,cAAc,GAAmC,SAAS;QAC9D,IAAI,kBAAkB,GAAwC,SAAS;AACvE,QAAA,IAAI;YACF,WAAW,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;AACjD,gBAAA,IAAI,cAAc,KAAK,SAAS,EAAE;AAChC,oBAAA,cAAc,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE;AAElD,oBAAA,IAAI,cAAc,KAAK,SAAS,EAAE;AAChC,wBAAA,IAAI,CAAC,0BAA0B,CAAC,MAAK;AACnC,4BAAA,MAAM,IAAI,KAAK,CAAC,CAAA,uBAAA,CAAyB,CAAC;AAC5C,wBAAA,CAAC,CAAC;wBACF;oBACF;;oBAGA,IAAI,cAAc,CAAC,mBAAmB;wBAAE,kBAAkB,GAAG,EAAE;AAE/D,oBAAA,UAAU,EAAE;gBACd;AAEA,gBAAA,IAAI,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE;oBACpC,MAAM,YAAY,GAAG,CAAA,uBAAA,EAA0B,OAAO,CAAC,SAAS,CAAA,KAAA,EAAQ,UAAU,CAAA,CAAE;AACpF,oBAAA,IAAI,CAAC,0BAA0B,CAAC,MAAK;AACnC,wBAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;AAC/B,oBAAA,CAAC,CAAC;oBACF;gBACF;AAEA,gBAAA,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE;AAC/B,oBAAA,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK;AAE5B,oBAAA,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE;AACzB,wBAAA,cAAc,CAAC,MAAM,CACnB,IAAI,YAAY,CAAC,MAAK;AACpB,4BAAA,MAAM,IAAIC,yBAAkB,CAAC,MAAM,CAAC;wBACtC,CAAC,CAAC,CACH;wBACD,cAAc,GAAG,SAAS;AAE1B,wBAAA,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE;AACtE,4BAAA,IAAI,CAAC,0BAA0B,CAAC,MAAK;AACnC,gCAAA,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC;AACjD,4BAAA,CAAC,CAAC;4BACF;wBACF;;wBAGA;oBACF;yBAAO;AACL,wBAAA,IAAI,CAAC,0BAA0B,CAAC,MAAK;AACnC,4BAAA,MAAM,IAAIC,2BAAoB,CAAC,MAAM,CAAC;AACxC,wBAAA,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC;wBACzB,cAAc,GAAG,SAAS;;wBAG1B;oBACF;gBACF;gBAEA,IACE,cAAc,CAAC,IAAI,KAAK,OAAO,CAAC,QAAQ,CAAC,SAAS;AAClD,oBAAA,OAAO,EAAE,YAAY,EAAE,OAAO,KAAK,IAAI,EACvC;AACA,oBAAA,MAAM,YAAY,GAAG,CAAA,qCAAA,EAAwC,cAAc,CAAC,IAAI,CAAA,KAAA,EAAQ,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE;AAEpH,oBAAA,IAAI,CAAC,0BAA0B,CAAC,MAAK;AACnC,wBAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;AAC/B,oBAAA,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC;oBACzB,cAAc,GAAG,SAAS;oBAE1B;gBACF;AAEA,gBAAA,IAAI,cAAc,CAAC,mBAAmB,MAAM,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,EAAE;AAC/E,oBAAA,MAAM,YAAY,GAAG,CAAA,0BAAA,EAA6B,cAAc,CAAC,mBAAmB,CAAA,KAAA,EAAQ,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE;AAEhI,oBAAA,IAAI,CAAC,0BAA0B,CAAC,MAAK;AACnC,wBAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;AAC/B,oBAAA,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC;oBACzB,cAAc,GAAG,SAAS;oBAE1B;gBACF;;AAIA,gBAAA,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE;AACtC,oBAAA,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE;AACjC,wBAAA,IAAI,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,kBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE;AAC9D,4BAAA,MAAM,YAAY,GAAG,CAAA,uBAAA,EAA0B,OAAO,CAAC,YAAY,CAAC,EAAE,CAAA,KAAA,EAAQ,kBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE;AAE9G,4BAAA,IAAI,CAAC,0BAA0B,CAAC,MAAK;AACnC,gCAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;AAC/B,4BAAA,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC;4BACzB,cAAc,GAAG,SAAS;4BAE1B;wBACF;AAEA,wBAAA,kBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;oBAC5C;AAEA,oBAAA,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE;AAC9B,wBAAA,cAA0C,CAAC,OAAO,CAAC,kBAAmB,CAAC;wBACxE,kBAAkB,GAAG,SAAS;wBAC9B,cAAc,GAAG,SAAS;oBAC5B;gBACF;qBAAO;AACJ,oBAAA,cAA2C,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;oBACtE,cAAc,GAAG,SAAS;gBAC5B;;;;AAKA,gBAAA,IAAI,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE;oBAC9E,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE;gBACvC;YACF;QACF;QAAE,OAAO,CAAM,EAAE;AACf,YAAA,OAAO,IAAI,CAAC,0BAA0B,CAAC,MAAK;AAC1C,gBAAAC,6BAAsB,CAAC,CAAC,EAAE,IAAI,CAAC;AACjC,YAAA,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC;QAC5B;gBAAU;AACR,YAAA,MAAM,IAAI,CAAC,KAAK,EAAE;QACpB;AACA,QAAA,OAAO,IAAI;IACb;;AAGQ,IAAA,MAAM,KAAK,GAAA;QACjB,IAAI,IAAI,CAAC,MAAM;YAAE;AAEjB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI;;QAIlB,OAAO,IAAI,EAAE;YACX,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE;AACjD,YAAA,IAAI,CAAC,OAAO;gBAAE;YACd,IAAI,IAAI,CAAC,YAAY;gBAAE,OAAO,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;;gBACrE,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;QAC5C;;QAGA,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE;IACvC;;AAGO,IAAA,KAAK,CAAC,KAAa,EAAA;AACxB,QAAA,IAAI,CAAC,0BAA0B,CAAC,MAAK;YACnC,MAAM,IAAI,KAAK,CAAC,CAAA,mBAAA,CAAqB,EAAE,EAAE,KAAK,EAAE,CAAC;AACnD,QAAA,CAAC,CAAC;AACF,QAAA,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC;IACnC;;AAGO,IAAA,MAAM,KAAK,GAAA;;;;;AAMhB,QAAA,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,uBAAuB;QAC3D,IAAI,gBAAgB,KAAK,IAAI;AAAE,YAAA,gBAAgB,EAAE;IACnD;;AAWO,IAAA,MAAM,IAAI,CACf,CAAwC,EACxC,mBAA4B,EAAA;QAE5B,IAAI,IAAI,CAAC,YAAY;AAAE,YAAA,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEjF,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;;AAG/E,QAAA,MAAM,MAAM,GAAGC,+BAAe,CAAC,kBAAkB,CAC/C,IAAI,OAAO,CAAyC,CAAC,OAAO,EAAE,MAAM,KAAI;AACtE,YAAA,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAC5B,qBAAqB,CAAC,CAAC,CAAC,SAAS,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,CAAC,CACzE;QACH,CAAC,CAAC,CACH;;;AAID,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;AAC9B,YAAA,SAAS,EAAE,IAAI,CAAC,iBAAiB,EAAE;AACnC,YAAA,OAAO,EAAE,CAAC;AACX,SAAA,CAAC;AAEF,QAAA,IAAI;YACF,OAAO,MAAM,MAAM;QACrB;QAAE,OAAO,CAAM,EAAE;YACf,IAAI,CAAC,YAAY,YAAY;gBAAE,CAAC,CAAC,aAAa,EAAE;YAChD,MAAM,IAAI,KAAK,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACnE;IACF;IAEQ,UAAU,GAAG,KAAK;;AAGnB,IAAA,MAAM,QAAQ,GAAA;QACnB,IAAI,IAAI,CAAC,UAAU;YAAE;AACrB,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE;IACvC;AAEQ,IAAA,kBAAkB,CAAC,OAA4B,EAAA;AACrD,QAAA,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS;AACvC,QAAA,OAAO,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,WAAW;IACpD;AACD;;;;;"}
+{"version":3,"file":"ll_transaction.cjs","names":["PlErrorCodeNotFound","Denque","RecoverablePlError","UnrecoverablePlError","StatefulPromise"],"sources":["../../src/core/ll_transaction.ts"],"sourcesContent":["import type {\n  TxAPI_ClientMessage,\n  TxAPI_ServerMessage,\n} from \"../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api\";\nimport type { BiDiStream } from \"./abstract_stream\";\nimport Denque from \"denque\";\nimport type { Status } from \"../proto-grpc/github.com/googleapis/googleapis/google/rpc/status\";\nimport {\n  PlErrorCodeNotFound,\n  RecoverablePlError,\n  rethrowMeaningfulError,\n  UnrecoverablePlError,\n} from \"./errors\";\nimport { StatefulPromise } from \"./StatefulPromise\";\n\nexport type ClientMessageRequest = TxAPI_ClientMessage[\"request\"];\n\nexport type ServerMessageResponse = TxAPI_ServerMessage[\"response\"];\n\ntype TxStream = BiDiStream<TxAPI_ClientMessage, TxAPI_ServerMessage>;\n\nexport type OneOfKind<T extends { oneofKind: unknown }, Kind extends T[\"oneofKind\"]> = Extract<\n  T,\n  { oneofKind: Kind }\n>;\n\ninterface SingleResponseHandler<Kind extends ServerMessageResponse[\"oneofKind\"]> {\n  kind: Kind;\n  expectMultiResponse: false;\n  resolve: (v: OneOfKind<ServerMessageResponse, Kind>) => void;\n  reject: (e: Error) => void;\n}\n\ninterface MultiResponseHandler<Kind extends ServerMessageResponse[\"oneofKind\"]> {\n  kind: Kind;\n  expectMultiResponse: true;\n  resolve: (v: OneOfKind<ServerMessageResponse, Kind>[]) => void;\n  reject: (e: Error) => void;\n}\n\ntype AnySingleResponseHandler = SingleResponseHandler<ServerMessageResponse[\"oneofKind\"]>;\n\ntype AnyMultiResponseHandler = MultiResponseHandler<ServerMessageResponse[\"oneofKind\"]>;\n\ntype AnyResponseHandler =\n  | SingleResponseHandler<ServerMessageResponse[\"oneofKind\"]>\n  | MultiResponseHandler<ServerMessageResponse[\"oneofKind\"]>;\n\nfunction createResponseHandler<Kind extends ServerMessageResponse[\"oneofKind\"]>(\n  kind: Kind,\n  expectMultiResponse: boolean,\n  resolve:\n    | ((v: OneOfKind<ServerMessageResponse, Kind>) => void)\n    | ((v: OneOfKind<ServerMessageResponse, Kind>[]) => void),\n  reject: (e: Error) => void,\n): AnyResponseHandler {\n  return { kind, expectMultiResponse, resolve, reject } as AnyResponseHandler;\n}\n\nfunction isRecoverable(status: Status): boolean {\n  return status.code === PlErrorCodeNotFound;\n}\n\nexport class RethrowError extends Error {\n  name = \"RethrowError\";\n  constructor(public readonly rethrowLambda: () => never) {\n    super(\"Rethrow error, you should never see this one.\");\n  }\n}\n\nexport class LLPlTransaction {\n  /** Bidirectional channel through which transaction communicates with the server */\n  private readonly stream: TxStream;\n\n  /** Used to abort ongoing transaction stream */\n  private readonly abortController = new AbortController();\n\n  /** Counter of sent requests, used to calculate which future response will correspond to this request.\n   * Incremented on each sent request. */\n  private requestIdxCounter = 0;\n\n  /** Queue from which incoming message processor takes handlers to which pass incoming messages */\n  private readonly responseHandlerQueue = new Denque<AnyResponseHandler>();\n\n  /** Each new resource, created by the transaction, is assigned with virtual (local) resource id, to make it possible\n   * to populate its fields without awaiting actual resource id. This counter tracks those ids on client side, the\n   * same way it is tracked on the server, so client can synchronously return such ids to the user. */\n  private localResourceIdCounter = 0n;\n\n  /** Switches to true, when this transaction closes due to normal or exceptional conditions. Prevents any new messages\n   * to be sent to the stream. */\n  private closed = false;\n  /** Whether the outgoing stream was already closed. */\n  private completed = false;\n\n  /** If this transaction was terminated due to error, this is a generator to create new errors if corresponding response is required. */\n  private errorFactory?: () => never;\n\n  /** Timestamp when transaction was opened */\n  private readonly openTimestamp = Date.now();\n\n  private readonly incomingProcessorResult: Promise<(() => never) | null>;\n\n  constructor(streamFactory: (abortSignal: AbortSignal) => TxStream) {\n    this.stream = streamFactory(this.abortController.signal);\n\n    // Starting incoming event processor\n    this.incomingProcessorResult = this.incomingEventProcessor();\n  }\n\n  private assignErrorFactoryIfNotSet(\n    errorFactory: () => never,\n    reject?: (e: Error) => void,\n  ): () => never {\n    if (reject !== undefined) reject(new RethrowError(errorFactory));\n    if (this.errorFactory) return errorFactory;\n    this.errorFactory = errorFactory;\n    return errorFactory;\n  }\n\n  private async incomingEventProcessor(): Promise<(() => never) | null> {\n    /** Counter of received responses, used to check consistency of responses.\n     * Increments on each received message. */\n    let expectedId = -1;\n\n    // defined externally to make possible to communicate any processing errors\n    // to the specific request on which it happened\n    let currentHandler: AnyResponseHandler | undefined = undefined;\n    let responseAggregator: ServerMessageResponse[] | undefined = undefined;\n    try {\n      for await (const message of this.stream.responses) {\n        if (currentHandler === undefined) {\n          currentHandler = this.responseHandlerQueue.shift();\n\n          if (currentHandler === undefined) {\n            this.assignErrorFactoryIfNotSet(() => {\n              throw new Error(`orphan incoming message`);\n            });\n            break;\n          }\n\n          // allocating response aggregator array\n          if (currentHandler.expectMultiResponse) responseAggregator = [];\n\n          expectedId++;\n        }\n\n        if (message.requestId !== expectedId) {\n          const errorMessage = `out of order messages, ${message.requestId} !== ${expectedId}`;\n          this.assignErrorFactoryIfNotSet(() => {\n            throw new Error(errorMessage);\n          });\n          break;\n        }\n\n        if (message.error !== undefined) {\n          const status = message.error;\n\n          if (isRecoverable(status)) {\n            currentHandler.reject(\n              new RethrowError(() => {\n                throw new RecoverablePlError(status);\n              }),\n            );\n            currentHandler = undefined;\n\n            if (message.multiMessage !== undefined && !message.multiMessage.isLast) {\n              this.assignErrorFactoryIfNotSet(() => {\n                throw new Error(\"Unexpected message sequence.\");\n              });\n              break;\n            }\n\n            // We can continue to work after recoverable errors\n            continue;\n          } else {\n            this.assignErrorFactoryIfNotSet(() => {\n              throw new UnrecoverablePlError(status);\n            }, currentHandler.reject);\n            currentHandler = undefined;\n\n            // In case of unrecoverable errors we close the transaction\n            break;\n          }\n        }\n\n        if (\n          currentHandler.kind !== message.response.oneofKind &&\n          message?.multiMessage?.isEmpty !== true\n        ) {\n          const errorMessage = `inconsistent request response types: ${currentHandler.kind} !== ${message.response.oneofKind}`;\n\n          this.assignErrorFactoryIfNotSet(() => {\n            throw new Error(errorMessage);\n          }, currentHandler.reject);\n          currentHandler = undefined;\n\n          break;\n        }\n\n        if (currentHandler.expectMultiResponse !== (message.multiMessage !== undefined)) {\n          const errorMessage = `inconsistent multi state: ${currentHandler.expectMultiResponse} !== ${message.multiMessage !== undefined}`;\n\n          this.assignErrorFactoryIfNotSet(() => {\n            throw new Error(errorMessage);\n          }, currentHandler.reject);\n          currentHandler = undefined;\n\n          break;\n        }\n\n        // <- at this point we validated everything we can at this level\n\n        if (message.multiMessage !== undefined) {\n          if (!message.multiMessage.isEmpty) {\n            if (message.multiMessage.id !== responseAggregator!.length + 1) {\n              const errorMessage = `inconsistent multi id: ${message.multiMessage.id} !== ${responseAggregator!.length + 1}`;\n\n              this.assignErrorFactoryIfNotSet(() => {\n                throw new Error(errorMessage);\n              }, currentHandler.reject);\n              currentHandler = undefined;\n\n              break;\n            }\n\n            responseAggregator!.push(message.response);\n          }\n\n          if (message.multiMessage.isLast) {\n            (currentHandler as AnyMultiResponseHandler).resolve(responseAggregator!);\n            responseAggregator = undefined;\n            currentHandler = undefined;\n          }\n        } else {\n          (currentHandler as AnySingleResponseHandler).resolve(message.response);\n          currentHandler = undefined;\n        }\n\n        // After receiving a terminal response (txCommit or txDiscard), we proactively close the client stream.\n        // This ensures consistent behavior between the gRPC and WebSocket transports,\n        // since the server closes the connection automatically upon transaction completion in both cases.\n        if (this.isTerminalResponse(message) && this.responseHandlerQueue.length === 0) {\n          await this.stream.requests.complete();\n        }\n      }\n    } catch (e: any) {\n      return this.assignErrorFactoryIfNotSet(() => {\n        rethrowMeaningfulError(e, true);\n      }, currentHandler?.reject);\n    } finally {\n      await this.close();\n    }\n    return null;\n  }\n\n  /** Executed after termination of incoming message processor */\n  private async close(): Promise<void> {\n    if (this.closed) return;\n\n    this.closed = true;\n\n    // Rejecting all messages\n\n    while (true) {\n      const handler = this.responseHandlerQueue.shift();\n      if (!handler) break;\n      if (this.errorFactory) handler.reject(new RethrowError(this.errorFactory));\n      else handler.reject(new Error(\"no reply\"));\n    }\n\n    // closing outgoing stream\n    await this.stream.requests.complete();\n  }\n\n  /** Forcefully close the transaction, terminate all connections and reject all pending requests */\n  public abort(cause?: Error) {\n    this.assignErrorFactoryIfNotSet(() => {\n      throw new Error(`transaction aborted`, { cause });\n    });\n    this.abortController.abort(cause);\n  }\n\n  /** Await incoming message loop termination and throw any leftover errors if it was unsuccessful */\n  public async await(): Promise<void> {\n    // for those who want to understand \"why?\":\n    // this way there is no hanging promise that will complete with rejection\n    // until await is implicitly requested, the this.incomingProcessorResult\n    // always resolves with success\n\n    const processingResult = await this.incomingProcessorResult;\n    if (processingResult !== null) processingResult();\n  }\n\n  public async send<Kind extends ClientMessageRequest[\"oneofKind\"]>(\n    r: OneOfKind<ClientMessageRequest, Kind>,\n    expectMultiResponse: false,\n  ): Promise<OneOfKind<ServerMessageResponse, Kind>>;\n  public async send<Kind extends ClientMessageRequest[\"oneofKind\"]>(\n    r: OneOfKind<ClientMessageRequest, Kind>,\n    expectMultiResponse: true,\n  ): Promise<OneOfKind<ServerMessageResponse, Kind>[]>;\n  /** Generate proper client message and send it to the server, and returns a promise of future response. */\n  public async send<Kind extends ClientMessageRequest[\"oneofKind\"]>(\n    r: OneOfKind<ClientMessageRequest, Kind>,\n    expectMultiResponse: boolean,\n  ): Promise<OneOfKind<ServerMessageResponse, Kind> | OneOfKind<ServerMessageResponse, Kind>[]> {\n    if (this.errorFactory) return Promise.reject(new RethrowError(this.errorFactory));\n\n    if (this.closed) return Promise.reject(new Error(\"Transaction already closed\"));\n\n    // Note: Promise synchronously executes a callback passed to a constructor\n    const result = StatefulPromise.fromDeferredReject(\n      new Promise<OneOfKind<ServerMessageResponse, Kind>>((resolve, reject) => {\n        this.responseHandlerQueue.push(\n          createResponseHandler(r.oneofKind, expectMultiResponse, resolve, reject),\n        );\n      }),\n    );\n\n    // Awaiting message dispatch to catch any associated errors.\n    // There is no hurry, we are not going to receive a response until message is sent.\n    await this.stream.requests.send({\n      requestId: this.requestIdxCounter++,\n      request: r,\n    });\n\n    try {\n      return await result;\n    } catch (e: any) {\n      if (e instanceof RethrowError) e.rethrowLambda();\n      throw new Error(\"Error while waiting for response\", { cause: e });\n    }\n  }\n\n  private _completed = false;\n\n  /** Safe to call multiple times */\n  public async complete() {\n    if (this._completed) return;\n    this._completed = true;\n    await this.stream.requests.complete();\n  }\n\n  private isTerminalResponse(message: TxAPI_ServerMessage): boolean {\n    const kind = message.response.oneofKind;\n    return kind === \"txCommit\" || kind === \"txDiscard\";\n  }\n}\n"],"mappings":"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"}

package/dist/core/ll_transaction.d.ts

@@ -1,57 +1,55 @@
-import type { TxAPI_ClientMessage, TxAPI_ServerMessage } from "../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api";
-import type { BiDiStream } from "./abstract_stream";
-export type ClientMessageRequest = TxAPI_ClientMessage["request"];
-export type ServerMessageResponse = TxAPI_ServerMessage["response"];
+import { TxAPI_ClientMessage, TxAPI_ServerMessage } from "../proto-grpc/github.com/milaboratory/pl/plapi/plapiproto/api.js";
+import { BiDiStream } from "./abstract_stream.js";
+
+//#region src/core/ll_transaction.d.ts
+type ClientMessageRequest = TxAPI_ClientMessage["request"];
+type ServerMessageResponse = TxAPI_ServerMessage["response"];
 type TxStream = BiDiStream<TxAPI_ClientMessage, TxAPI_ServerMessage>;
-export type OneOfKind<T extends {
-    oneofKind: unknown;
+type OneOfKind<T extends {
+  oneofKind: unknown;
 }, Kind extends T["oneofKind"]> = Extract<T, {
-    oneofKind: Kind;
+  oneofKind: Kind;
 }>;
-export declare class RethrowError extends Error {
-    readonly rethrowLambda: () => never;
-    name: string;
-    constructor(rethrowLambda: () => never);
+declare class LLPlTransaction {
+  /** Bidirectional channel through which transaction communicates with the server */
+  private readonly stream;
+  /** Used to abort ongoing transaction stream */
+  private readonly abortController;
+  /** Counter of sent requests, used to calculate which future response will correspond to this request.
+   * Incremented on each sent request. */
+  private requestIdxCounter;
+  /** Queue from which incoming message processor takes handlers to which pass incoming messages */
+  private readonly responseHandlerQueue;
+  /** Each new resource, created by the transaction, is assigned with virtual (local) resource id, to make it possible
+   * to populate its fields without awaiting actual resource id. This counter tracks those ids on client side, the
+   * same way it is tracked on the server, so client can synchronously return such ids to the user. */
+  private localResourceIdCounter;
+  /** Switches to true, when this transaction closes due to normal or exceptional conditions. Prevents any new messages
+   * to be sent to the stream. */
+  private closed;
+  /** Whether the outgoing stream was already closed. */
+  private completed;
+  /** If this transaction was terminated due to error, this is a generator to create new errors if corresponding response is required. */
+  private errorFactory?;
+  /** Timestamp when transaction was opened */
+  private readonly openTimestamp;
+  private readonly incomingProcessorResult;
+  constructor(streamFactory: (abortSignal: AbortSignal) => TxStream);
+  private assignErrorFactoryIfNotSet;
+  private incomingEventProcessor;
+  /** Executed after termination of incoming message processor */
+  private close;
+  /** Forcefully close the transaction, terminate all connections and reject all pending requests */
+  abort(cause?: Error): void;
+  /** Await incoming message loop termination and throw any leftover errors if it was unsuccessful */
+  await(): Promise<void>;
+  send<Kind extends ClientMessageRequest["oneofKind"]>(r: OneOfKind<ClientMessageRequest, Kind>, expectMultiResponse: false): Promise<OneOfKind<ServerMessageResponse, Kind>>;
+  send<Kind extends ClientMessageRequest["oneofKind"]>(r: OneOfKind<ClientMessageRequest, Kind>, expectMultiResponse: true): Promise<OneOfKind<ServerMessageResponse, Kind>[]>;
+  private _completed;
+  /** Safe to call multiple times */
+  complete(): Promise<void>;
+  private isTerminalResponse;
 }
-export declare class LLPlTransaction {
-    /** Bidirectional channel through which transaction communicates with the server */
-    private readonly stream;
-    /** Used to abort ongoing transaction stream */
-    private readonly abortController;
-    /** Counter of sent requests, used to calculate which future response will correspond to this request.
-     * Incremented on each sent request. */
-    private requestIdxCounter;
-    /** Queue from which incoming message processor takes handlers to which pass incoming messages */
-    private readonly responseHandlerQueue;
-    /** Each new resource, created by the transaction, is assigned with virtual (local) resource id, to make it possible
-     * to populate its fields without awaiting actual resource id. This counter tracks those ids on client side, the
-     * same way it is tracked on the server, so client can synchronously return such ids to the user. */
-    private localResourceIdCounter;
-    /** Switches to true, when this transaction closes due to normal or exceptional conditions. Prevents any new messages
-     * to be sent to the stream. */
-    private closed;
-    /** Whether the outgoing stream was already closed. */
-    private completed;
-    /** If this transaction was terminated due to error, this is a generator to create new errors if corresponding response is required. */
-    private errorFactory?;
-    /** Timestamp when transaction was opened */
-    private readonly openTimestamp;
-    private readonly incomingProcessorResult;
-    constructor(streamFactory: (abortSignal: AbortSignal) => TxStream);
-    private assignErrorFactoryIfNotSet;
-    private incomingEventProcessor;
-    /** Executed after termination of incoming message processor */
-    private close;
-    /** Forcefully close the transaction, terminate all connections and reject all pending requests */
-    abort(cause?: Error): void;
-    /** Await incoming message loop termination and throw any leftover errors if it was unsuccessful */
-    await(): Promise<void>;
-    send<Kind extends ClientMessageRequest["oneofKind"]>(r: OneOfKind<ClientMessageRequest, Kind>, expectMultiResponse: false): Promise<OneOfKind<ServerMessageResponse, Kind>>;
-    send<Kind extends ClientMessageRequest["oneofKind"]>(r: OneOfKind<ClientMessageRequest, Kind>, expectMultiResponse: true): Promise<OneOfKind<ServerMessageResponse, Kind>[]>;
-    private _completed;
-    /** Safe to call multiple times */
-    complete(): Promise<void>;
-    private isTerminalResponse;
-}
-export {};
+//#endregion
+export { LLPlTransaction };
 //# sourceMappingURL=ll_transaction.d.ts.map

package/dist/core/ll_transaction.js

@@ -1,244 +1,211 @@
-import Denque from 'denque';
-import { RecoverablePlError, UnrecoverablePlError, rethrowMeaningfulError, PlErrorCodeNotFound } from './errors.js';
-import { StatefulPromise } from './StatefulPromise.js';
+import { PlErrorCodeNotFound, RecoverablePlError, UnrecoverablePlError, rethrowMeaningfulError } from "./errors.js";
+import { StatefulPromise } from "./StatefulPromise.js";
+import Denque from "denque";
 
+//#region src/core/ll_transaction.ts
 function createResponseHandler(kind, expectMultiResponse, resolve, reject) {
-    return { kind, expectMultiResponse, resolve, reject };
+	return {
+		kind,
+		expectMultiResponse,
+		resolve,
+		reject
+	};
 }
 function isRecoverable(status) {
-    return status.code === PlErrorCodeNotFound;
-}
-class RethrowError extends Error {
-    rethrowLambda;
-    name = "RethrowError";
-    constructor(rethrowLambda) {
-        super("Rethrow error, you should never see this one.");
-        this.rethrowLambda = rethrowLambda;
-    }
-}
-class LLPlTransaction {
-    /** Bidirectional channel through which transaction communicates with the server */
-    stream;
-    /** Used to abort ongoing transaction stream */
-    abortController = new AbortController();
-    /** Counter of sent requests, used to calculate which future response will correspond to this request.
-     * Incremented on each sent request. */
-    requestIdxCounter = 0;
-    /** Queue from which incoming message processor takes handlers to which pass incoming messages */
-    responseHandlerQueue = new Denque();
-    /** Each new resource, created by the transaction, is assigned with virtual (local) resource id, to make it possible
-     * to populate its fields without awaiting actual resource id. This counter tracks those ids on client side, the
-     * same way it is tracked on the server, so client can synchronously return such ids to the user. */
-    localResourceIdCounter = 0n;
-    /** Switches to true, when this transaction closes due to normal or exceptional conditions. Prevents any new messages
-     * to be sent to the stream. */
-    closed = false;
-    /** Whether the outgoing stream was already closed. */
-    completed = false;
-    /** If this transaction was terminated due to error, this is a generator to create new errors if corresponding response is required. */
-    errorFactory;
-    /** Timestamp when transaction was opened */
-    openTimestamp = Date.now();
-    incomingProcessorResult;
-    constructor(streamFactory) {
-        this.stream = streamFactory(this.abortController.signal);
-        // Starting incoming event processor
-        this.incomingProcessorResult = this.incomingEventProcessor();
-    }
-    assignErrorFactoryIfNotSet(errorFactory, reject) {
-        if (reject !== undefined)
-            reject(new RethrowError(errorFactory));
-        if (this.errorFactory)
-            return errorFactory;
-        this.errorFactory = errorFactory;
-        return errorFactory;
-    }
-    async incomingEventProcessor() {
-        /** Counter of received responses, used to check consistency of responses.
-         * Increments on each received message. */
-        let expectedId = -1;
-        // defined externally to make possible to communicate any processing errors
-        // to the specific request on which it happened
-        let currentHandler = undefined;
-        let responseAggregator = undefined;
-        try {
-            for await (const message of this.stream.responses) {
-                if (currentHandler === undefined) {
-                    currentHandler = this.responseHandlerQueue.shift();
-                    if (currentHandler === undefined) {
-                        this.assignErrorFactoryIfNotSet(() => {
-                            throw new Error(`orphan incoming message`);
-                        });
-                        break;
-                    }
-                    // allocating response aggregator array
-                    if (currentHandler.expectMultiResponse)
-                        responseAggregator = [];
-                    expectedId++;
-                }
-                if (message.requestId !== expectedId) {
-                    const errorMessage = `out of order messages, ${message.requestId} !== ${expectedId}`;
-                    this.assignErrorFactoryIfNotSet(() => {
-                        throw new Error(errorMessage);
-                    });
-                    break;
-                }
-                if (message.error !== undefined) {
-                    const status = message.error;
-                    if (isRecoverable(status)) {
-                        currentHandler.reject(new RethrowError(() => {
-                            throw new RecoverablePlError(status);
-                        }));
-                        currentHandler = undefined;
-                        if (message.multiMessage !== undefined && !message.multiMessage.isLast) {
-                            this.assignErrorFactoryIfNotSet(() => {
-                                throw new Error("Unexpected message sequence.");
-                            });
-                            break;
-                        }
-                        // We can continue to work after recoverable errors
-                        continue;
-                    }
-                    else {
-                        this.assignErrorFactoryIfNotSet(() => {
-                            throw new UnrecoverablePlError(status);
-                        }, currentHandler.reject);
-                        currentHandler = undefined;
-                        // In case of unrecoverable errors we close the transaction
-                        break;
-                    }
-                }
-                if (currentHandler.kind !== message.response.oneofKind &&
-                    message?.multiMessage?.isEmpty !== true) {
-                    const errorMessage = `inconsistent request response types: ${currentHandler.kind} !== ${message.response.oneofKind}`;
-                    this.assignErrorFactoryIfNotSet(() => {
-                        throw new Error(errorMessage);
-                    }, currentHandler.reject);
-                    currentHandler = undefined;
-                    break;
-                }
-                if (currentHandler.expectMultiResponse !== (message.multiMessage !== undefined)) {
-                    const errorMessage = `inconsistent multi state: ${currentHandler.expectMultiResponse} !== ${message.multiMessage !== undefined}`;
-                    this.assignErrorFactoryIfNotSet(() => {
-                        throw new Error(errorMessage);
-                    }, currentHandler.reject);
-                    currentHandler = undefined;
-                    break;
-                }
-                // <- at this point we validated everything we can at this level
-                if (message.multiMessage !== undefined) {
-                    if (!message.multiMessage.isEmpty) {
-                        if (message.multiMessage.id !== responseAggregator.length + 1) {
-                            const errorMessage = `inconsistent multi id: ${message.multiMessage.id} !== ${responseAggregator.length + 1}`;
-                            this.assignErrorFactoryIfNotSet(() => {
-                                throw new Error(errorMessage);
-                            }, currentHandler.reject);
-                            currentHandler = undefined;
-                            break;
-                        }
-                        responseAggregator.push(message.response);
-                    }
-                    if (message.multiMessage.isLast) {
-                        currentHandler.resolve(responseAggregator);
-                        responseAggregator = undefined;
-                        currentHandler = undefined;
-                    }
-                }
-                else {
-                    currentHandler.resolve(message.response);
-                    currentHandler = undefined;
-                }
-                // After receiving a terminal response (txCommit or txDiscard), we proactively close the client stream.
-                // This ensures consistent behavior between the gRPC and WebSocket transports,
-                // since the server closes the connection automatically upon transaction completion in both cases.
-                if (this.isTerminalResponse(message) && this.responseHandlerQueue.length === 0) {
-                    await this.stream.requests.complete();
-                }
-            }
-        }
-        catch (e) {
-            return this.assignErrorFactoryIfNotSet(() => {
-                rethrowMeaningfulError(e, true);
-            }, currentHandler?.reject);
-        }
-        finally {
-            await this.close();
-        }
-        return null;
-    }
-    /** Executed after termination of incoming message processor */
-    async close() {
-        if (this.closed)
-            return;
-        this.closed = true;
-        // Rejecting all messages
-        while (true) {
-            const handler = this.responseHandlerQueue.shift();
-            if (!handler)
-                break;
-            if (this.errorFactory)
-                handler.reject(new RethrowError(this.errorFactory));
-            else
-                handler.reject(new Error("no reply"));
-        }
-        // closing outgoing stream
-        await this.stream.requests.complete();
-    }
-    /** Forcefully close the transaction, terminate all connections and reject all pending requests */
-    abort(cause) {
-        this.assignErrorFactoryIfNotSet(() => {
-            throw new Error(`transaction aborted`, { cause });
-        });
-        this.abortController.abort(cause);
-    }
-    /** Await incoming message loop termination and throw any leftover errors if it was unsuccessful */
-    async await() {
-        // for those who want to understand "why?":
-        // this way there is no hanging promise that will complete with rejection
-        // until await is implicitly requested, the this.incomingProcessorResult
-        // always resolves with success
-        const processingResult = await this.incomingProcessorResult;
-        if (processingResult !== null)
-            processingResult();
-    }
-    /** Generate proper client message and send it to the server, and returns a promise of future response. */
-    async send(r, expectMultiResponse) {
-        if (this.errorFactory)
-            return Promise.reject(new RethrowError(this.errorFactory));
-        if (this.closed)
-            return Promise.reject(new Error("Transaction already closed"));
-        // Note: Promise synchronously executes a callback passed to a constructor
-        const result = StatefulPromise.fromDeferredReject(new Promise((resolve, reject) => {
-            this.responseHandlerQueue.push(createResponseHandler(r.oneofKind, expectMultiResponse, resolve, reject));
-        }));
-        // Awaiting message dispatch to catch any associated errors.
-        // There is no hurry, we are not going to receive a response until message is sent.
-        await this.stream.requests.send({
-            requestId: this.requestIdxCounter++,
-            request: r,
-        });
-        try {
-            return await result;
-        }
-        catch (e) {
-            if (e instanceof RethrowError)
-                e.rethrowLambda();
-            throw new Error("Error while waiting for response", { cause: e });
-        }
-    }
-    _completed = false;
-    /** Safe to call multiple times */
-    async complete() {
-        if (this._completed)
-            return;
-        this._completed = true;
-        await this.stream.requests.complete();
-    }
-    isTerminalResponse(message) {
-        const kind = message.response.oneofKind;
-        return kind === "txCommit" || kind === "txDiscard";
-    }
+	return status.code === PlErrorCodeNotFound;
 }
+var RethrowError = class extends Error {
+	name = "RethrowError";
+	constructor(rethrowLambda) {
+		super("Rethrow error, you should never see this one.");
+		this.rethrowLambda = rethrowLambda;
+	}
+};
+var LLPlTransaction = class {
+	/** Bidirectional channel through which transaction communicates with the server */
+	stream;
+	/** Used to abort ongoing transaction stream */
+	abortController = new AbortController();
+	/** Counter of sent requests, used to calculate which future response will correspond to this request.
+	* Incremented on each sent request. */
+	requestIdxCounter = 0;
+	/** Queue from which incoming message processor takes handlers to which pass incoming messages */
+	responseHandlerQueue = new Denque();
+	/** Each new resource, created by the transaction, is assigned with virtual (local) resource id, to make it possible
+	* to populate its fields without awaiting actual resource id. This counter tracks those ids on client side, the
+	* same way it is tracked on the server, so client can synchronously return such ids to the user. */
+	localResourceIdCounter = 0n;
+	/** Switches to true, when this transaction closes due to normal or exceptional conditions. Prevents any new messages
+	* to be sent to the stream. */
+	closed = false;
+	/** Whether the outgoing stream was already closed. */
+	completed = false;
+	/** If this transaction was terminated due to error, this is a generator to create new errors if corresponding response is required. */
+	errorFactory;
+	/** Timestamp when transaction was opened */
+	openTimestamp = Date.now();
+	incomingProcessorResult;
+	constructor(streamFactory) {
+		this.stream = streamFactory(this.abortController.signal);
+		this.incomingProcessorResult = this.incomingEventProcessor();
+	}
+	assignErrorFactoryIfNotSet(errorFactory, reject) {
+		if (reject !== void 0) reject(new RethrowError(errorFactory));
+		if (this.errorFactory) return errorFactory;
+		this.errorFactory = errorFactory;
+		return errorFactory;
+	}
+	async incomingEventProcessor() {
+		/** Counter of received responses, used to check consistency of responses.
+		* Increments on each received message. */
+		let expectedId = -1;
+		let currentHandler = void 0;
+		let responseAggregator = void 0;
+		try {
+			for await (const message of this.stream.responses) {
+				if (currentHandler === void 0) {
+					currentHandler = this.responseHandlerQueue.shift();
+					if (currentHandler === void 0) {
+						this.assignErrorFactoryIfNotSet(() => {
+							throw new Error(`orphan incoming message`);
+						});
+						break;
+					}
+					if (currentHandler.expectMultiResponse) responseAggregator = [];
+					expectedId++;
+				}
+				if (message.requestId !== expectedId) {
+					const errorMessage = `out of order messages, ${message.requestId} !== ${expectedId}`;
+					this.assignErrorFactoryIfNotSet(() => {
+						throw new Error(errorMessage);
+					});
+					break;
+				}
+				if (message.error !== void 0) {
+					const status = message.error;
+					if (isRecoverable(status)) {
+						currentHandler.reject(new RethrowError(() => {
+							throw new RecoverablePlError(status);
+						}));
+						currentHandler = void 0;
+						if (message.multiMessage !== void 0 && !message.multiMessage.isLast) {
+							this.assignErrorFactoryIfNotSet(() => {
+								throw new Error("Unexpected message sequence.");
+							});
+							break;
+						}
+						continue;
+					} else {
+						this.assignErrorFactoryIfNotSet(() => {
+							throw new UnrecoverablePlError(status);
+						}, currentHandler.reject);
+						currentHandler = void 0;
+						break;
+					}
+				}
+				if (currentHandler.kind !== message.response.oneofKind && message?.multiMessage?.isEmpty !== true) {
+					const errorMessage = `inconsistent request response types: ${currentHandler.kind} !== ${message.response.oneofKind}`;
+					this.assignErrorFactoryIfNotSet(() => {
+						throw new Error(errorMessage);
+					}, currentHandler.reject);
+					currentHandler = void 0;
+					break;
+				}
+				if (currentHandler.expectMultiResponse !== (message.multiMessage !== void 0)) {
+					const errorMessage = `inconsistent multi state: ${currentHandler.expectMultiResponse} !== ${message.multiMessage !== void 0}`;
+					this.assignErrorFactoryIfNotSet(() => {
+						throw new Error(errorMessage);
+					}, currentHandler.reject);
+					currentHandler = void 0;
+					break;
+				}
+				if (message.multiMessage !== void 0) {
+					if (!message.multiMessage.isEmpty) {
+						if (message.multiMessage.id !== responseAggregator.length + 1) {
+							const errorMessage = `inconsistent multi id: ${message.multiMessage.id} !== ${responseAggregator.length + 1}`;
+							this.assignErrorFactoryIfNotSet(() => {
+								throw new Error(errorMessage);
+							}, currentHandler.reject);
+							currentHandler = void 0;
+							break;
+						}
+						responseAggregator.push(message.response);
+					}
+					if (message.multiMessage.isLast) {
+						currentHandler.resolve(responseAggregator);
+						responseAggregator = void 0;
+						currentHandler = void 0;
+					}
+				} else {
+					currentHandler.resolve(message.response);
+					currentHandler = void 0;
+				}
+				if (this.isTerminalResponse(message) && this.responseHandlerQueue.length === 0) await this.stream.requests.complete();
+			}
+		} catch (e) {
+			return this.assignErrorFactoryIfNotSet(() => {
+				rethrowMeaningfulError(e, true);
+			}, currentHandler?.reject);
+		} finally {
+			await this.close();
+		}
+		return null;
+	}
+	/** Executed after termination of incoming message processor */
+	async close() {
+		if (this.closed) return;
+		this.closed = true;
+		while (true) {
+			const handler = this.responseHandlerQueue.shift();
+			if (!handler) break;
+			if (this.errorFactory) handler.reject(new RethrowError(this.errorFactory));
+			else handler.reject(/* @__PURE__ */ new Error("no reply"));
+		}
+		await this.stream.requests.complete();
+	}
+	/** Forcefully close the transaction, terminate all connections and reject all pending requests */
+	abort(cause) {
+		this.assignErrorFactoryIfNotSet(() => {
+			throw new Error(`transaction aborted`, { cause });
+		});
+		this.abortController.abort(cause);
+	}
+	/** Await incoming message loop termination and throw any leftover errors if it was unsuccessful */
+	async await() {
+		const processingResult = await this.incomingProcessorResult;
+		if (processingResult !== null) processingResult();
+	}
+	/** Generate proper client message and send it to the server, and returns a promise of future response. */
+	async send(r, expectMultiResponse) {
+		if (this.errorFactory) return Promise.reject(new RethrowError(this.errorFactory));
+		if (this.closed) return Promise.reject(/* @__PURE__ */ new Error("Transaction already closed"));
+		const result = StatefulPromise.fromDeferredReject(new Promise((resolve, reject) => {
+			this.responseHandlerQueue.push(createResponseHandler(r.oneofKind, expectMultiResponse, resolve, reject));
+		}));
+		await this.stream.requests.send({
+			requestId: this.requestIdxCounter++,
+			request: r
+		});
+		try {
+			return await result;
+		} catch (e) {
+			if (e instanceof RethrowError) e.rethrowLambda();
+			throw new Error("Error while waiting for response", { cause: e });
+		}
+	}
+	_completed = false;
+	/** Safe to call multiple times */
+	async complete() {
+		if (this._completed) return;
+		this._completed = true;
+		await this.stream.requests.complete();
+	}
+	isTerminalResponse(message) {
+		const kind = message.response.oneofKind;
+		return kind === "txCommit" || kind === "txDiscard";
+	}
+};
 
-export { LLPlTransaction, RethrowError };
-//# sourceMappingURL=ll_transaction.js.map
+//#endregion
+export { LLPlTransaction };
+//# sourceMappingURL=ll_transaction.js.map