@milaboratories/pl-client 2.16.1 → 2.16.3

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/github.com/milaboratory/pl/plapi/plapiproto/api';\nimport type { DuplexStreamingCall } from '@protobuf-ts/runtime-rpc';\nimport Denque from 'denque';\nimport type { Status } from '../proto/github.com/googleapis/googleapis/google/rpc/status';\nimport {\n  PlErrorCodeNotFound,\n  RecoverablePlError,\n  rethrowMeaningfulError,\n  UnrecoverablePlError,\n} from './errors';\n\nexport type ClientMessageRequest = TxAPI_ClientMessage['request'];\n\nexport type ServerMessageResponse = TxAPI_ServerMessage['response'];\n\ntype TxStream = DuplexStreamingCall<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    } 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 = new Promise<OneOfKind<ServerMessageResponse, Kind>>((resolve, reject) => {\n      this.responseHandlerQueue.push(\n        createResponseHandler(r.oneofKind, expectMultiResponse, resolve, reject),\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"],"names":["PlErrorCodeNotFound","RecoverablePlError","UnrecoverablePlError","rethrowMeaningfulError"],"mappings":"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"}
+{"version":3,"file":"ll_transaction.cjs","sources":["../../src/core/ll_transaction.ts"],"sourcesContent":["import type {\n  TxAPI_ClientMessage,\n  TxAPI_ServerMessage,\n} from '../proto/github.com/milaboratory/pl/plapi/plapiproto/api';\nimport type { DuplexStreamingCall } from '@protobuf-ts/runtime-rpc';\nimport Denque from 'denque';\nimport type { Status } from '../proto/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 = DuplexStreamingCall<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    } 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(new Promise<OneOfKind<ServerMessageResponse, Kind>>((resolve, reject) => {\n      this.responseHandlerQueue.push(\n        createResponseHandler(r.oneofKind, expectMultiResponse, resolve, reject),\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"],"names":["PlErrorCodeNotFound","RecoverablePlError","UnrecoverablePlError","rethrowMeaningfulError","StatefulPromise"],"mappings":"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"}

package/dist/core/ll_transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ll_transaction.d.ts","sourceRoot":"","sources":["../../src/core/ll_transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,0DAA0D,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAUpE,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;AAEpE,KAAK,QAAQ,GAAG,mBAAmB,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC;AAE9E,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,EAAE,IAAI,SAAS,CAAC,CAAC,WAAW,CAAC,IAAI,OAAO,CAC5F,CAAC,EACD;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,CACpB,CAAC;AAuCF,qBAAa,YAAa,SAAQ,KAAK;aAET,aAAa,EAAE,MAAM,KAAK;IADtD,IAAI,SAAkB;gBACM,aAAa,EAAE,MAAM,KAAK;CAGvD;AAED,qBAAa,eAAe;IAC1B,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAElC,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IAEzD;2CACuC;IACvC,OAAO,CAAC,iBAAiB,CAAK;IAE9B,iGAAiG;IACjG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAoC;IAEzE;;wGAEoG;IACpG,OAAO,CAAC,sBAAsB,CAAM;IAEpC;mCAC+B;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAS;IAE1B,uIAAuI;IACvI,OAAO,CAAC,YAAY,CAAC,CAAc;IAEnC,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAE5C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAgC;gBAE5D,aAAa,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,QAAQ;IAOjE,OAAO,CAAC,0BAA0B;YAUpB,sBAAsB;IAiIpC,+DAA+D;YACjD,KAAK;IAkBnB,kGAAkG;IAC3F,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK;IAO1B,mGAAmG;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,IAAI,CAAC,IAAI,SAAS,oBAAoB,CAAC,WAAW,CAAC,EAC9D,CAAC,EAAE,SAAS,CAAC,oBAAoB,EAAE,IAAI,CAAC,EACxC,mBAAmB,EAAE,KAAK,GACzB,OAAO,CAAC,SAAS,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,SAAS,oBAAoB,CAAC,WAAW,CAAC,EAC9D,CAAC,EAAE,SAAS,CAAC,oBAAoB,EAAE,IAAI,CAAC,EACxC,mBAAmB,EAAE,IAAI,GACxB,OAAO,CAAC,SAAS,CAAC,qBAAqB,EAAE,IAAI,CAAC,EAAE,CAAC;IAgCpD,OAAO,CAAC,UAAU,CAAS;IAE3B,kCAAkC;IACrB,QAAQ;CAKtB"}
+{"version":3,"file":"ll_transaction.d.ts","sourceRoot":"","sources":["../../src/core/ll_transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,0DAA0D,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAWpE,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;AAEpE,KAAK,QAAQ,GAAG,mBAAmB,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC;AAE9E,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,EAAE,IAAI,SAAS,CAAC,CAAC,WAAW,CAAC,IAAI,OAAO,CAC5F,CAAC,EACD;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,CACpB,CAAC;AAuCF,qBAAa,YAAa,SAAQ,KAAK;aAET,aAAa,EAAE,MAAM,KAAK;IADtD,IAAI,SAAkB;gBACM,aAAa,EAAE,MAAM,KAAK;CAGvD;AAED,qBAAa,eAAe;IAC1B,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAElC,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IAEzD;2CACuC;IACvC,OAAO,CAAC,iBAAiB,CAAK;IAE9B,iGAAiG;IACjG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAoC;IAEzE;;wGAEoG;IACpG,OAAO,CAAC,sBAAsB,CAAM;IAEpC;mCAC+B;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAS;IAE1B,uIAAuI;IACvI,OAAO,CAAC,YAAY,CAAC,CAAc;IAEnC,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAE5C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAgC;gBAE5D,aAAa,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,QAAQ;IAOjE,OAAO,CAAC,0BAA0B;YAUpB,sBAAsB;IAiIpC,+DAA+D;YACjD,KAAK;IAkBnB,kGAAkG;IAC3F,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK;IAO1B,mGAAmG;IACtF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,IAAI,CAAC,IAAI,SAAS,oBAAoB,CAAC,WAAW,CAAC,EAC9D,CAAC,EAAE,SAAS,CAAC,oBAAoB,EAAE,IAAI,CAAC,EACxC,mBAAmB,EAAE,KAAK,GACzB,OAAO,CAAC,SAAS,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,SAAS,oBAAoB,CAAC,WAAW,CAAC,EAC9D,CAAC,EAAE,SAAS,CAAC,oBAAoB,EAAE,IAAI,CAAC,EACxC,mBAAmB,EAAE,IAAI,GACxB,OAAO,CAAC,SAAS,CAAC,qBAAqB,EAAE,IAAI,CAAC,EAAE,CAAC;IAgCpD,OAAO,CAAC,UAAU,CAAS;IAE3B,kCAAkC;IACrB,QAAQ;CAKtB"}

package/dist/core/ll_transaction.js

@@ -1,5 +1,6 @@
 import Denque from 'denque';
 import { RecoverablePlError, UnrecoverablePlError, rethrowMeaningfulError, PlErrorCodeNotFound } from './errors.js';
+import { StatefulPromise } from './StatefulPromise.js';
 
 function createResponseHandler(kind, expectMultiResponse, resolve, reject) {
     return { kind, expectMultiResponse, resolve, reject };
@@ -201,9 +202,9 @@ class LLPlTransaction {
         if (this.closed)
             return Promise.reject(new Error('Transaction already closed'));
         // Note: Promise synchronously executes a callback passed to a constructor
-        const result = new Promise((resolve, reject) => {
+        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({

package/dist/core/ll_transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"ll_transaction.js","sources":["../../src/core/ll_transaction.ts"],"sourcesContent":["import type {\n  TxAPI_ClientMessage,\n  TxAPI_ServerMessage,\n} from '../proto/github.com/milaboratory/pl/plapi/plapiproto/api';\nimport type { DuplexStreamingCall } from '@protobuf-ts/runtime-rpc';\nimport Denque from 'denque';\nimport type { Status } from '../proto/github.com/googleapis/googleapis/google/rpc/status';\nimport {\n  PlErrorCodeNotFound,\n  RecoverablePlError,\n  rethrowMeaningfulError,\n  UnrecoverablePlError,\n} from './errors';\n\nexport type ClientMessageRequest = TxAPI_ClientMessage['request'];\n\nexport type ServerMessageResponse = TxAPI_ServerMessage['response'];\n\ntype TxStream = DuplexStreamingCall<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    } 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 = new Promise<OneOfKind<ServerMessageResponse, Kind>>((resolve, reject) => {\n      this.responseHandlerQueue.push(\n        createResponseHandler(r.oneofKind, expectMultiResponse, resolve, reject),\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"],"names":[],"mappings":"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"}
+{"version":3,"file":"ll_transaction.js","sources":["../../src/core/ll_transaction.ts"],"sourcesContent":["import type {\n  TxAPI_ClientMessage,\n  TxAPI_ServerMessage,\n} from '../proto/github.com/milaboratory/pl/plapi/plapiproto/api';\nimport type { DuplexStreamingCall } from '@protobuf-ts/runtime-rpc';\nimport Denque from 'denque';\nimport type { Status } from '../proto/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 = DuplexStreamingCall<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    } 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(new Promise<OneOfKind<ServerMessageResponse, Kind>>((resolve, reject) => {\n      this.responseHandlerQueue.push(\n        createResponseHandler(r.oneofKind, expectMultiResponse, resolve, reject),\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"],"names":[],"mappings":"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"}