@azure/service-bus 7.10.0-beta.1 → 7.10.0-beta.3

package/dist/commonjs/core/streamingReceiver.js

@@ -0,0 +1,526 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamingReceiver = void 0;
+const messageReceiver_js_1 = require("./messageReceiver.js");
+const receiverHelper_js_1 = require("./receiverHelper.js");
+const errors_js_1 = require("../util/errors.js");
+const core_amqp_1 = require("@azure/core-amqp");
+const log_js_1 = require("../log.js");
+const serviceBusMessage_js_1 = require("../serviceBusMessage.js");
+const serviceBusError_js_1 = require("../serviceBusError.js");
+const receiverCommon_js_1 = require("../receivers/receiverCommon.js");
+const instrumentServiceBusMessage_js_1 = require("../diagnostics/instrumentServiceBusMessage.js");
+const abort_controller_1 = require("@azure/abort-controller");
+const tracing_js_1 = require("../diagnostics/tracing.js");
+/**
+ * @internal
+ * Describes the streaming receiver where the user can receive the message
+ * by providing handler functions.
+ */
+class StreamingReceiver extends messageReceiver_js_1.MessageReceiver {
+    /**
+     * The maximum number of messages that should be
+     * processed concurrently while in streaming mode. Once this limit has been reached, more
+     * messages will not be received until the user's message handler has completed processing current message.
+     * Default: 1
+     */
+    maxConcurrentCalls = 1;
+    /**
+     * Indicates whether the receiver is already actively
+     * running `onDetached`.
+     * This is expected to be true while the receiver attempts
+     * to bring its link back up due to a retryable issue.
+     */
+    _isDetaching = false;
+    /**
+     *Retry policy options that determine the mode, number of retries, retry interval etc.
+     */
+    _retryOptions;
+    _receiverHelper;
+    /**
+     * The user's message handlers, wrapped so any thrown exceptions are properly logged
+     * or forwarded to the user's processError handler.
+     */
+    _messageHandlers = () => {
+        throw new Error("messageHandlers are not set.");
+    };
+    /**
+     * The subscribe(options) passed when the subscribe call originally happened. Stored
+     * so _subscribeImpl() can re-use them later if we have to restart our subscription
+     * when detach/reattaching.
+     */
+    _subscribeOptions;
+    /**
+     * Used so we can stub out retry in tests.
+     */
+    _retryForeverFn = receiverCommon_js_1.retryForever;
+    /**
+     * The message handler that will be set as the handler on the
+     * underlying rhea receiver for the "receiver_close" event.
+     */
+    _onAmqpClose;
+    /**
+     * The message handler that will be set as the handler on
+     * the underlying rhea receiver's session for the "session_close" event.
+     */
+    _onSessionClose;
+    /**
+     * The message handler that will be set as the handler on
+     * the underlying rhea receiver's session for the "session_error" event.
+     */
+    _onSessionError;
+    /**
+     * The message handler that will be set as the handler on the
+     * underlying rhea receiver for the "receiver_error" event.
+     */
+    _onAmqpError;
+    /**
+     * The message handler that will be set as the handler on the
+     * underlying rhea receiver for the "message" event.
+     */
+    _onAmqpMessage;
+    /**
+     * Whether we are currently subscribed (or subscribing) for receiving messages.
+     * (this is irrespective of receiver state, etc... - it's just a simple flag to prevent
+     * multiple subscribe() calls from happening on this instance)
+     */
+    get isSubscribeActive() {
+        return !this._receiverHelper.isSuspended();
+    }
+    /**
+     * Instantiate a new Streaming receiver for receiving messages with handlers.
+     *
+     * @param identifier - the name used to identifier the receiver
+     * @param connectionContext - The client entity context.
+     * @param options - Options for how you'd like to connect.
+     */
+    constructor(identifier, connectionContext, entityPath, options) {
+        super(identifier, connectionContext, entityPath, "streaming", options);
+        if (typeof options?.maxConcurrentCalls === "number" && options?.maxConcurrentCalls > 0) {
+            this.maxConcurrentCalls = options.maxConcurrentCalls;
+        }
+        this._retryOptions = options?.retryOptions || {};
+        this._receiverHelper = new receiverHelper_js_1.ReceiverHelper(() => ({
+            receiver: this.link,
+            logPrefix: this.logPrefix,
+        }));
+        this._onAmqpClose = async (context) => {
+            const receiverError = context.receiver && context.receiver.error;
+            const receiver = this.link || context.receiver;
+            log_js_1.receiverLogger.logError(receiverError, `${this.logPrefix} 'receiver_close' event occurred. The associated error is`);
+            this._lockRenewer?.stopAll(this);
+            if (receiver && !receiver.isItselfClosed()) {
+                await this.onDetached(receiverError);
+            }
+            else {
+                log_js_1.receiverLogger.verbose("%s 'receiver_close' event occurred on the receiver '%s' with address '%s' " +
+                    "because the sdk initiated it. Hence not calling detached from the _onAmqpClose" +
+                    "() handler.", this.logPrefix, this.name, this.address);
+            }
+        };
+        this._onSessionClose = async (context) => {
+            const receiver = this.link || context.receiver;
+            const sessionError = context.session && context.session.error;
+            log_js_1.receiverLogger.logError(sessionError, `${this.logPrefix} 'session_close' event occurred. The associated error is`);
+            this._lockRenewer?.stopAll(this);
+            if (receiver && !receiver.isSessionItselfClosed()) {
+                await this.onDetached(sessionError);
+            }
+            else {
+                log_js_1.receiverLogger.verbose("%s 'session_close' event occurred on the session of receiver '%s' with address " +
+                    "'%s' because the sdk initiated it. Hence not calling detached from the _onSessionClose" +
+                    "() handler.", this.logPrefix, this.name, this.address);
+            }
+        };
+        this._onAmqpError = (context) => {
+            const receiverError = context.receiver && context.receiver.error;
+            if (receiverError) {
+                const sbError = (0, serviceBusError_js_1.translateServiceBusError)(receiverError);
+                log_js_1.receiverLogger.logError(sbError, `${this.logPrefix} 'receiver_error' event occurred. The associated error is`);
+                this._messageHandlers().processError({
+                    error: sbError,
+                    errorSource: "receive",
+                    entityPath: this.entityPath,
+                    fullyQualifiedNamespace: this._context.config.host,
+                    identifier,
+                });
+            }
+        };
+        this._onSessionError = (context) => {
+            const sessionError = context.session && context.session.error;
+            if (sessionError) {
+                const sbError = (0, serviceBusError_js_1.translateServiceBusError)(sessionError);
+                log_js_1.receiverLogger.logError(sbError, `${this.logPrefix} 'session_error' event occurred. The associated error is`);
+                this._messageHandlers().processError({
+                    error: sbError,
+                    errorSource: "receive",
+                    entityPath: this.entityPath,
+                    fullyQualifiedNamespace: this._context.config.host,
+                    identifier,
+                });
+            }
+        };
+        this._onAmqpMessage = async (context) => {
+            // If the receiver got closed in PeekLock mode, avoid processing the message as we
+            // cannot settle the message.
+            if (this.receiveMode === "peekLock" && (!this.link || !this.link.isOpen())) {
+                log_js_1.receiverLogger.verbose("%s Not calling the user's message handler for the current message " +
+                    "as the receiver is closed", this.logPrefix);
+                return;
+            }
+            const bMessage = new serviceBusMessage_js_1.ServiceBusMessageImpl(context.message, context.delivery, true, this.receiveMode, options.skipParsingBodyAsJson ?? false, options.skipConvertingDate ?? false);
+            this._lockRenewer?.start(this, bMessage, (err) => {
+                this._messageHandlers().processError({
+                    error: err,
+                    errorSource: "renewLock",
+                    entityPath: this.entityPath,
+                    fullyQualifiedNamespace: this._context.config.host,
+                    identifier,
+                });
+            });
+            try {
+                await this._messageHandlers().processMessage(bMessage);
+            }
+            catch (err) {
+                log_js_1.receiverLogger.logError(err, "%s An error occurred while running user's message handler for the message " +
+                    "with id '%s' on the receiver '%s'", this.logPrefix, bMessage.messageId, this.name);
+                // Do not want renewLock to happen unnecessarily, while abandoning the message. Hence,
+                // doing this here. Otherwise, this should be done in finally.
+                this._lockRenewer?.stop(this, bMessage);
+                const error = (0, serviceBusError_js_1.translateServiceBusError)(err);
+                // Nothing much to do if user's message handler throws. Let us try abandoning the message.
+                if (!bMessage.delivery.remote_settled &&
+                    error.code !== core_amqp_1.ConditionErrorNameMapper["com.microsoft:message-lock-lost"] &&
+                    this.receiveMode === "peekLock" &&
+                    this.isOpen() // only try to abandon the messages if the connection is still open
+                ) {
+                    try {
+                        log_js_1.receiverLogger.logError(error, "%s Abandoning the message with id '%s' on the receiver '%s' since " +
+                            "an error occured: %O.", this.logPrefix, bMessage.messageId, this.name, error);
+                        await (0, receiverCommon_js_1.abandonMessage)(bMessage, this._context, entityPath, undefined, this._retryOptions);
+                    }
+                    catch (abandonError) {
+                        const translatedError = (0, serviceBusError_js_1.translateServiceBusError)(abandonError);
+                        log_js_1.receiverLogger.logError(translatedError, "%s An error occurred while abandoning the message with id '%s' on the " +
+                            "receiver '%s'", this.logPrefix, bMessage.messageId, this.name);
+                        this._messageHandlers().processError({
+                            error: translatedError,
+                            errorSource: "abandon",
+                            entityPath: this.entityPath,
+                            fullyQualifiedNamespace: this._context.config.host,
+                            identifier,
+                        });
+                    }
+                }
+                return;
+            }
+            finally {
+                try {
+                    this._receiverHelper.addCredit(1);
+                }
+                catch (err) {
+                    // if we're aborting out of the receive operation we don't need to report it (the user already
+                    // knows the link is being torn down or stopped)
+                    if (err.name !== "AbortError") {
+                        log_js_1.receiverLogger.logError(err, `[${this.logPrefix}] Failed to add credit after receiving message`);
+                        await this._reportInternalError(err);
+                    }
+                }
+            }
+            // If we've made it this far, then user's message handler completed fine. Let us try
+            // completing the message.
+            if (this.autoComplete &&
+                this.receiveMode === "peekLock" &&
+                !bMessage.delivery.remote_settled) {
+                try {
+                    log_js_1.receiverLogger.verbose("%s Auto completing the message with id '%s' on " + "the receiver.", this.logPrefix, bMessage.messageId);
+                    await (0, receiverCommon_js_1.completeMessage)(bMessage, this._context, entityPath, this._retryOptions);
+                }
+                catch (completeError) {
+                    const translatedError = (0, serviceBusError_js_1.translateServiceBusError)(completeError);
+                    log_js_1.receiverLogger.logError(translatedError, "%s An error occurred while completing the message with id '%s' on the " +
+                        "receiver '%s'", this.logPrefix, bMessage.messageId, this.name);
+                    this._messageHandlers().processError({
+                        error: translatedError,
+                        errorSource: "complete",
+                        entityPath: this.entityPath,
+                        fullyQualifiedNamespace: this._context.config.host,
+                        identifier,
+                    });
+                }
+            }
+        };
+    }
+    _reportInternalError(error) {
+        const messageHandlers = this._messageHandlers();
+        if (messageHandlers.forwardInternalErrors) {
+            const errorArgs = {
+                error,
+                entityPath: this.entityPath,
+                errorSource: "internal",
+                fullyQualifiedNamespace: this._context.config.host,
+                identifier: this.identifier,
+            };
+            return messageHandlers.processError(errorArgs);
+        }
+        return Promise.resolve();
+    }
+    _getHandlers() {
+        return {
+            onMessage: (context) => this._onAmqpMessage(context).catch((err) => this._reportInternalError(err)),
+            onClose: (context) => this._onAmqpClose(context).catch((err) => this._reportInternalError(err)),
+            onSessionClose: (context) => this._onSessionClose(context).catch((err) => this._reportInternalError(err)),
+            onError: this._onAmqpError,
+            onSessionError: this._onSessionError,
+        };
+    }
+    async stopReceivingMessages() {
+        await this._receiverHelper.suspend();
+        if (this._subscribeCallPromise) {
+            await this._subscribeCallPromise;
+        }
+    }
+    async close() {
+        await this._receiverHelper.suspend();
+        return super.close();
+    }
+    _subscribeCallPromise;
+    /**
+     * Starts the receiver by establishing an AMQP session and an AMQP receiver link on the session.
+     *
+     * Any errors thrown by this function will also be sent to the messageHandlers.processError function
+     * _and_ thrown, ultimately from this method.
+     *
+     * NOTE: This function retries _infinitely_ until success! It is completely up to the user to break
+     * out of this retry cycle otherwise by:
+     * 1. closing the receiver
+     * 2. Calling `close` on the subscription instance they received when they initially called subscribe().
+     * 3. aborting the abortSignal they passed in when calling subscribe (this also applies to initialization calls in onDetach)
+     *
+     * @param onMessage - The message handler to receive servicebus messages.
+     * @param onError - The error handler to receive an error that occurs while receivin messages.
+     */
+    async subscribe(messageHandlers, subscribeOptions) {
+        // these options and message handlers will be re-used if/when onDetach is called.
+        this._subscribeOptions = subscribeOptions;
+        this._setMessageHandlers(messageHandlers, subscribeOptions);
+        let promiseResolve;
+        this._subscribeCallPromise = new Promise((resolve) => {
+            promiseResolve = resolve;
+        });
+        try {
+            this._receiverHelper.resume();
+            return await this._subscribeImpl("subscribe");
+        }
+        catch (err) {
+            // callers aren't going to be in a good position to forward this error properly
+            // so we do it here.
+            await this._messageHandlers().processError({
+                entityPath: this.entityPath,
+                fullyQualifiedNamespace: this._context.config.host,
+                errorSource: "receive",
+                error: err,
+                identifier: this.identifier,
+            });
+            throw err;
+        }
+        finally {
+            promiseResolve?.();
+            this._subscribeCallPromise = undefined;
+        }
+    }
+    /**
+     * Wraps the individual message handlers with tracing and proper error handling
+     * and assigns them to `this._messageHandlers`
+     *
+     * @param userHandlers - The user's message handlers
+     * @param operationOptions - The subscribe(options)
+     */
+    _setMessageHandlers(userHandlers, operationOptions) {
+        const messageHandlers = {
+            processError: async (args) => {
+                try {
+                    args.error = (0, serviceBusError_js_1.translateServiceBusError)(args.error);
+                    await userHandlers.processError(args);
+                }
+                catch (err) {
+                    await this._reportInternalError(err);
+                    log_js_1.receiverLogger.logError(err, `An error was thrown from the user's processError handler`);
+                }
+            },
+            processMessage: async (message) => {
+                try {
+                    await tracing_js_1.tracingClient.withSpan("StreamReceiver.process", operationOptions ?? {}, () => userHandlers.processMessage(message), (0, instrumentServiceBusMessage_js_1.toProcessingSpanOptions)(message, this, this._context.config, "process"));
+                }
+                catch (err) {
+                    this._messageHandlers().processError({
+                        error: err,
+                        errorSource: "processMessageCallback",
+                        entityPath: this.entityPath,
+                        fullyQualifiedNamespace: this._context.config.host,
+                        identifier: this.identifier,
+                    });
+                    throw err;
+                }
+            },
+            postInitialize: async () => {
+                if (!userHandlers.postInitialize) {
+                    return;
+                }
+                return userHandlers.postInitialize().catch((err) => this._messageHandlers().processError({
+                    error: err,
+                    errorSource: "processMessageCallback",
+                    entityPath: this.entityPath,
+                    fullyQualifiedNamespace: this._context.config.host,
+                    identifier: this.identifier,
+                }));
+            },
+            preInitialize: async () => {
+                if (!userHandlers.preInitialize) {
+                    return;
+                }
+                return userHandlers.preInitialize().catch((err) => this._messageHandlers().processError({
+                    error: err,
+                    errorSource: "processMessageCallback",
+                    entityPath: this.entityPath,
+                    fullyQualifiedNamespace: this._context.config.host,
+                    identifier: this.identifier,
+                }));
+            },
+            forwardInternalErrors: userHandlers.forwardInternalErrors ?? false,
+        };
+        this._messageHandlers = () => messageHandlers;
+    }
+    /**
+     * Subscribes using the already assigned `this._messageHandlers` and `this._subscribeOptions`
+     *
+     * @returns A promise that will resolve when a link is created and we successfully add credits to it.
+     */
+    async _subscribeImpl(caller) {
+        try {
+            // we don't expect to ever get an error from retryForever but bugs
+            // do happen.
+            return await this._retryForeverFn({
+                retryConfig: {
+                    connectionId: this._context.connection.id,
+                    operationType: core_amqp_1.RetryOperationType.receiverLink,
+                    abortSignal: this._subscribeOptions?.abortSignal,
+                    retryOptions: this._retryOptions,
+                    operation: () => this._initAndAddCreditOperation(caller),
+                },
+                onError: (err) => this._messageHandlers().processError({
+                    error: err,
+                    errorSource: "receive",
+                    entityPath: this.entityPath,
+                    fullyQualifiedNamespace: this._context.config.host,
+                    identifier: this.identifier,
+                }),
+                logPrefix: this.logPrefix,
+                logger: log_js_1.receiverLogger,
+            });
+        }
+        catch (err) {
+            try {
+                await this._receiverHelper.suspend();
+            }
+            catch (error) {
+                log_js_1.receiverLogger.logError(error, `${this.logPrefix} receiver.suspend threw an error`);
+            }
+            throw err;
+        }
+    }
+    /**
+     * Initializes the link and adds credits. If any of these operations fail any created link will
+     * be closed.
+     *
+     * @param caller - The caller which dictates whether or not we create a new name for our created link.
+     * @param catchAndReportError - A function and reports an error but does not throw it.
+     */
+    async _initAndAddCreditOperation(caller) {
+        if (this._receiverHelper.isSuspended()) {
+            // user has suspended us while we were initializing
+            // the connection. Abort this attempt - if they attempt
+            // resubscribe we'll just reinitialize.
+            // This checks should happen before throwErrorIfConnectionClosed(); otherwise
+            // we won't be able to break out of the retry-for-ever loops when user suspend us.
+            throw new abort_controller_1.AbortError("Receiver was suspended during initialization.");
+        }
+        (0, errors_js_1.throwErrorIfConnectionClosed)(this._context);
+        await this._messageHandlers().preInitialize();
+        if (this._receiverHelper.isSuspended()) {
+            // Need to check again as user can suspend us in preInitialize()
+            throw new abort_controller_1.AbortError("Receiver was suspended during initialization.");
+        }
+        await this._init(this._createReceiverOptions(caller === "detach", this._getHandlers()), this._subscribeOptions?.abortSignal);
+        try {
+            await this._messageHandlers().postInitialize();
+            this._receiverHelper.addCredit(this.maxConcurrentCalls);
+        }
+        catch (err) {
+            try {
+                await this.closeLink();
+            }
+            catch (error) {
+                await this._messageHandlers().processError({
+                    error,
+                    errorSource: "receive",
+                    entityPath: this.entityPath,
+                    fullyQualifiedNamespace: this._context.config.host,
+                    identifier: this.identifier,
+                });
+            }
+            throw err;
+        }
+    }
+    /**
+     * Will reconnect the receiver link if necessary.
+     * @param receiverError - The receiver error or connection error, if any.
+     */
+    async onDetached(receiverError) {
+        try {
+            log_js_1.receiverLogger.verbose(`${this.logPrefix} onDetached: reinitializing link.`);
+            // User explicitly called `close` on the receiver, so link is already closed
+            // and we can exit early.
+            if (this.wasClosedPermanently) {
+                log_js_1.receiverLogger.verbose(`${this.logPrefix} onDetached: link has been closed permanently, not reinitializing. `);
+                return;
+            }
+            // Prevent multiple onDetached invocations from running concurrently.
+            if (this._isDetaching) {
+                // This can happen when the network connection goes down for some amount of time.
+                // The first connection `disconnect` will trigger `onDetached` and attempt to retry
+                // creating the connection/receiver link.
+                // While those retry attempts fail (until the network connection comes back up),
+                // we'll continue to see connection `disconnect` errors.
+                // These should be ignored until the already running `onDetached` completes
+                // its retry attempts or errors.
+                log_js_1.receiverLogger.verbose(`${this.logPrefix} onDetached: Call to detached on streaming receiver '${this.name}' is already in progress.`);
+                return;
+            }
+            this._isDetaching = true;
+            const translatedError = receiverError
+                ? (0, serviceBusError_js_1.translateServiceBusError)(receiverError)
+                : receiverError;
+            log_js_1.receiverLogger.logError(translatedError, `${this.logPrefix} onDetached: Reinitializing receiver because of error`);
+            // Clears the token renewal timer. Closes the link and its session if they are open.
+            // Removes the link and its session if they are present in rhea's cache.
+            await this.closeLink();
+        }
+        catch (err) {
+            log_js_1.receiverLogger.verbose(`${this.logPrefix} onDetached: Encountered an error when closing the previous link: `, err);
+        }
+        try {
+            await this._subscribeImpl("detach");
+        }
+        finally {
+            this._isDetaching = false;
+        }
+    }
+    removeLinkFromContext() {
+        delete this._context.messageReceivers[this.name];
+    }
+}
+exports.StreamingReceiver = StreamingReceiver;
+//# sourceMappingURL=streamingReceiver.js.map

package/dist/commonjs/core/streamingReceiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamingReceiver.js","sourceRoot":"","sources":["../../../src/core/streamingReceiver.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAGlC,6DAAuD;AAGvD,2DAAqD;AAErD,iDAAiE;AAEjE,gDAAgF;AAEhF,sCAAqD;AAErD,kEAAgE;AAChE,8DAAiE;AACjE,sEAA+F;AAS/F,kGAAwF;AACxF,8DAAqD;AACrD,0DAA0D;AAW1D;;;;GAIG;AACH,MAAa,iBAAkB,SAAQ,oCAAe;IACpD;;;;;OAKG;IACH,kBAAkB,GAAW,CAAC,CAAC;IAE/B;;;;;OAKG;IACK,YAAY,GAAY,KAAK,CAAC;IACtC;;OAEG;IACK,aAAa,CAAe;IAE5B,eAAe,CAAiB;IAExC;;;OAGG;IACK,gBAAgB,GAA4C,GAAG,EAAE;QACvE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF;;;;OAIG;IACK,iBAAiB,CAA+B;IAExD;;OAEG;IACK,eAAe,GAAwB,gCAAY,CAAC;IAE5D;;;OAGG;IACK,YAAY,CAAuB;IAE3C;;;OAGG;IACK,eAAe,CAAuB;IAE9C;;;OAGG;IACK,eAAe,CAAc;IACrC;;;OAGG;IACK,YAAY,CAAc;IAElC;;;OAGG;IACO,cAAc,CAAuB;IAE/C;;;;OAIG;IACH,IAAW,iBAAiB;QAC1B,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,YACE,UAAkB,EAClB,iBAAoC,EACpC,UAAkB,EAClB,OAAuB;QAEvB,KAAK,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAEvE,IAAI,OAAO,OAAO,EAAE,kBAAkB,KAAK,QAAQ,IAAI,OAAO,EAAE,kBAAkB,GAAG,CAAC,EAAE,CAAC;YACvF,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,OAAO,EAAE,YAAY,IAAI,EAAE,CAAC;QAEjD,IAAI,CAAC,eAAe,GAAG,IAAI,kCAAc,CAAC,GAAG,EAAE,CAAC,CAAC;YAC/C,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,YAAY,GAAG,KAAK,EAAE,OAAqB,EAAE,EAAE;YAClD,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,QAAS,CAAC;YAEhD,uBAAM,CAAC,QAAQ,CACb,aAAa,EACb,GAAG,IAAI,CAAC,SAAS,2DAA2D,CAC7E,CAAC;YAEF,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAEjC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;gBAC3C,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,uBAAM,CAAC,OAAO,CACZ,4EAA4E;oBAC1E,gFAAgF;oBAChF,aAAa,EACf,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,OAAO,CACb,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,eAAe,GAAG,KAAK,EAAE,OAAqB,EAAE,EAAE;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,QAAS,CAAC;YAChD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;YAE9D,uBAAM,CAAC,QAAQ,CACb,YAAY,EACZ,GAAG,IAAI,CAAC,SAAS,0DAA0D,CAC5E,CAAC;YAEF,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAEjC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE,EAAE,CAAC;gBAClD,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,uBAAM,CAAC,OAAO,CACZ,iFAAiF;oBAC/E,wFAAwF;oBACxF,aAAa,EACf,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,OAAO,CACb,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG,CAAC,OAAqB,EAAE,EAAE;YAC5C,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjE,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,OAAO,GAAG,IAAA,6CAAwB,EAAC,aAAa,CAAmB,CAAC;gBAC1E,uBAAM,CAAC,QAAQ,CACb,OAAO,EACP,GAAG,IAAI,CAAC,SAAS,2DAA2D,CAC7E,CAAC;gBACF,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;oBACnC,KAAK,EAAE,OAAO;oBACd,WAAW,EAAE,SAAS;oBACtB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;oBAClD,UAAU;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,eAAe,GAAG,CAAC,OAAqB,EAAE,EAAE;YAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;YAC9D,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,OAAO,GAAG,IAAA,6CAAwB,EAAC,YAAY,CAAmB,CAAC;gBACzE,uBAAM,CAAC,QAAQ,CACb,OAAO,EACP,GAAG,IAAI,CAAC,SAAS,0DAA0D,CAC5E,CAAC;gBACF,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;oBACnC,KAAK,EAAE,OAAO;oBACd,WAAW,EAAE,SAAS;oBACtB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;oBAClD,UAAU;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,cAAc,GAAG,KAAK,EAAE,OAAqB,EAAE,EAAE;YACpD,kFAAkF;YAClF,6BAA6B;YAC7B,IAAI,IAAI,CAAC,WAAW,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;gBAC3E,uBAAM,CAAC,OAAO,CACZ,oEAAoE;oBAClE,2BAA2B,EAC7B,IAAI,CAAC,SAAS,CACf,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAA0B,IAAI,4CAAqB,CAC/D,OAAO,CAAC,OAAQ,EAChB,OAAO,CAAC,QAAS,EACjB,IAAI,EACJ,IAAI,CAAC,WAAW,EAChB,OAAO,CAAC,qBAAqB,IAAI,KAAK,EACtC,OAAO,CAAC,kBAAkB,IAAI,KAAK,CACpC,CAAC;YAEF,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC/C,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;oBACnC,KAAK,EAAE,GAAG;oBACV,WAAW,EAAE,WAAW;oBACxB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;oBAClD,UAAU;iBACX,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACzD,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,uBAAM,CAAC,QAAQ,CACb,GAAG,EACH,4EAA4E;oBAC1E,mCAAmC,EACrC,IAAI,CAAC,SAAS,EACd,QAAQ,CAAC,SAAS,EAClB,IAAI,CAAC,IAAI,CACV,CAAC;gBAEF,sFAAsF;gBACtF,8DAA8D;gBAC9D,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACxC,MAAM,KAAK,GAAG,IAAA,6CAAwB,EAAC,GAAG,CAAmB,CAAC;gBAC9D,0FAA0F;gBAC1F,IACE,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc;oBACjC,KAAK,CAAC,IAAI,KAAK,oCAAwB,CAAC,iCAAiC,CAAC;oBAC1E,IAAI,CAAC,WAAW,KAAK,UAAU;oBAC/B,IAAI,CAAC,MAAM,EAAE,CAAC,mEAAmE;kBACjF,CAAC;oBACD,IAAI,CAAC;wBACH,uBAAM,CAAC,QAAQ,CACb,KAAK,EACL,oEAAoE;4BAClE,uBAAuB,EACzB,IAAI,CAAC,SAAS,EACd,QAAQ,CAAC,SAAS,EAClB,IAAI,CAAC,IAAI,EACT,KAAK,CACN,CAAC;wBACF,MAAM,IAAA,kCAAc,EAClB,QAAQ,EACR,IAAI,CAAC,QAAQ,EACb,UAAU,EACV,SAAS,EACT,IAAI,CAAC,aAAa,CACnB,CAAC;oBACJ,CAAC;oBAAC,OAAO,YAAiB,EAAE,CAAC;wBAC3B,MAAM,eAAe,GAAG,IAAA,6CAAwB,EAAC,YAAY,CAAC,CAAC;wBAC/D,uBAAM,CAAC,QAAQ,CACb,eAAe,EACf,wEAAwE;4BACtE,eAAe,EACjB,IAAI,CAAC,SAAS,EACd,QAAQ,CAAC,SAAS,EAClB,IAAI,CAAC,IAAI,CACV,CAAC;wBACF,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;4BACnC,KAAK,EAAE,eAAe;4BACtB,WAAW,EAAE,SAAS;4BACtB,UAAU,EAAE,IAAI,CAAC,UAAU;4BAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;4BAClD,UAAU;yBACX,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBACD,OAAO;YACT,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC;oBACH,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,8FAA8F;oBAC9F,gDAAgD;oBAChD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBAC9B,uBAAM,CAAC,QAAQ,CACb,GAAG,EACH,IAAI,IAAI,CAAC,SAAS,gDAAgD,CACnE,CAAC;wBACF,MAAM,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;oBACvC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,oFAAoF;YACpF,0BAA0B;YAC1B,IACE,IAAI,CAAC,YAAY;gBACjB,IAAI,CAAC,WAAW,KAAK,UAAU;gBAC/B,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EACjC,CAAC;gBACD,IAAI,CAAC;oBACH,uBAAM,CAAC,OAAO,CACZ,iDAAiD,GAAG,eAAe,EACnE,IAAI,CAAC,SAAS,EACd,QAAQ,CAAC,SAAS,CACnB,CAAC;oBACF,MAAM,IAAA,mCAAe,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;gBACjF,CAAC;gBAAC,OAAO,aAAkB,EAAE,CAAC;oBAC5B,MAAM,eAAe,GAAG,IAAA,6CAAwB,EAAC,aAAa,CAAC,CAAC;oBAChE,uBAAM,CAAC,QAAQ,CACb,eAAe,EACf,wEAAwE;wBACtE,eAAe,EACjB,IAAI,CAAC,SAAS,EACd,QAAQ,CAAC,SAAS,EAClB,IAAI,CAAC,IAAI,CACV,CAAC;oBACF,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;wBACnC,KAAK,EAAE,eAAe;wBACtB,WAAW,EAAE,UAAU;wBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;wBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;wBAClD,UAAU;qBACX,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,KAAY;QACvC,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAEhD,IAAI,eAAe,CAAC,qBAAqB,EAAE,CAAC;YAC1C,MAAM,SAAS,GAA6B;gBAC1C,KAAK;gBACL,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,WAAW,EAAE,UAAU;gBACvB,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;gBAClD,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;YAEF,OAAO,eAAe,CAAC,YAAY,CAAC,SAA6B,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAEO,YAAY;QAClB,OAAO;YACL,SAAS,EAAE,CAAC,OAAqB,EAAE,EAAE,CACnC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;YAC7E,OAAO,EAAE,CAAC,OAAqB,EAAE,EAAE,CACjC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;YAC3E,cAAc,EAAE,CAAC,OAAqB,EAAE,EAAE,CACxC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;YAC9E,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,cAAc,EAAE,IAAI,CAAC,eAAe;SACrC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAErC,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,qBAAqB,CAAC;QACnC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAEO,qBAAqB,CAA4B;IAEzD;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,SAAS,CACb,eAAwC,EACxC,gBAA8C;QAE9C,iFAAiF;QACjF,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;QAC1C,IAAI,CAAC,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,CAAC,CAAC;QAE5D,IAAI,cAAwC,CAAC;QAC7C,IAAI,CAAC,qBAAqB,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACnD,cAAc,GAAG,OAAO,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;YAC9B,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,+EAA+E;YAC/E,oBAAoB;YACpB,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;gBACzC,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;gBAClD,WAAW,EAAE,SAAS;gBACtB,KAAK,EAAE,GAAG;gBACV,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAC;YAEH,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,cAAc,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,mBAAmB,CACzB,YAAqC,EACrC,gBAAkD;QAElD,MAAM,eAAe,GAAG;YACtB,YAAY,EAAE,KAAK,EAAE,IAAsB,EAAE,EAAE;gBAC7C,IAAI,CAAC;oBACH,IAAI,CAAC,KAAK,GAAG,IAAA,6CAAwB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAClD,MAAM,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBACxC,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,MAAM,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;oBACrC,uBAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,0DAA0D,CAAC,CAAC;gBACnF,CAAC;YACH,CAAC;YACD,cAAc,EAAE,KAAK,EAAE,OAA8B,EAAE,EAAE;gBACvD,IAAI,CAAC;oBACH,MAAM,0BAAa,CAAC,QAAQ,CAC1B,wBAAwB,EACxB,gBAAgB,IAAI,EAAE,EACtB,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,OAAO,CAAC,EAC1C,IAAA,wDAAuB,EAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CACxE,CAAC;gBACJ,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;wBACnC,KAAK,EAAE,GAAG;wBACV,WAAW,EAAE,wBAAwB;wBACrC,UAAU,EAAE,IAAI,CAAC,UAAU;wBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;wBAClD,UAAU,EAAE,IAAI,CAAC,UAAU;qBAC5B,CAAC,CAAC;oBACH,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;YACD,cAAc,EAAE,KAAK,IAAI,EAAE;gBACzB,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC;oBACjC,OAAO;gBACT,CAAC;gBAED,OAAO,YAAY,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACjD,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;oBACnC,KAAK,EAAE,GAAG;oBACV,WAAW,EAAE,wBAAwB;oBACrC,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;oBAClD,UAAU,EAAE,IAAI,CAAC,UAAU;iBAC5B,CAAC,CACH,CAAC;YACJ,CAAC;YACD,aAAa,EAAE,KAAK,IAAI,EAAE;gBACxB,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC;oBAChC,OAAO;gBACT,CAAC;gBAED,OAAO,YAAY,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAChD,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;oBACnC,KAAK,EAAE,GAAG;oBACV,WAAW,EAAE,wBAAwB;oBACrC,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;oBAClD,UAAU,EAAE,IAAI,CAAC,UAAU;iBAC5B,CAAC,CACH,CAAC;YACJ,CAAC;YACD,qBAAqB,EAAE,YAAY,CAAC,qBAAqB,IAAI,KAAK;SACnE,CAAC;QAEF,IAAI,CAAC,gBAAgB,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,cAAc,CAAC,MAA8B;QACzD,IAAI,CAAC;YACH,kEAAkE;YAClE,aAAa;YACb,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC;gBAChC,WAAW,EAAE;oBACX,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;oBACzC,aAAa,EAAE,8BAAkB,CAAC,YAAY;oBAC9C,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW;oBAChD,YAAY,EAAE,IAAI,CAAC,aAAa;oBAChC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,MAAM,CAAC;iBACzD;gBACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CACf,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;oBACnC,KAAK,EAAE,GAAG;oBACV,WAAW,EAAE,SAAS;oBACtB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;oBAClD,UAAU,EAAE,IAAI,CAAC,UAAU;iBAC5B,CAAC;gBACJ,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,MAAM,EAAN,uBAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YACvC,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,uBAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,SAAS,kCAAkC,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,0BAA0B,CAAC,MAA8B;QACrE,IAAI,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;YACvC,mDAAmD;YACnD,uDAAuD;YACvD,uCAAuC;YACvC,6EAA6E;YAC7E,kFAAkF;YAClF,MAAM,IAAI,6BAAU,CAAC,+CAA+C,CAAC,CAAC;QACxE,CAAC;QAED,IAAA,wCAA4B,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE5C,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,aAAa,EAAE,CAAC;QAE9C,IAAI,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;YACvC,gEAAgE;YAChE,MAAM,IAAI,6BAAU,CAAC,+CAA+C,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,CACd,IAAI,CAAC,sBAAsB,CAAC,MAAM,KAAK,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,EACrE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CACpC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,cAAc,EAAE,CAAC;YAC/C,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;oBACzC,KAAK;oBACL,WAAW,EAAE,SAAS;oBACtB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI;oBAClD,UAAU,EAAE,IAAI,CAAC,UAAU;iBAC5B,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,aAAiC;QAChD,IAAI,CAAC;YACH,uBAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,mCAAmC,CAAC,CAAC;YAErE,4EAA4E;YAC5E,yBAAyB;YACzB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAC9B,uBAAM,CAAC,OAAO,CACZ,GAAG,IAAI,CAAC,SAAS,qEAAqE,CACvF,CAAC;gBACF,OAAO;YACT,CAAC;YAED,qEAAqE;YACrE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,iFAAiF;gBACjF,mFAAmF;gBACnF,yCAAyC;gBACzC,gFAAgF;gBAChF,wDAAwD;gBACxD,2EAA2E;gBAC3E,gCAAgC;gBAChC,uBAAM,CAAC,OAAO,CACZ,GAAG,IAAI,CAAC,SAAS,wDAAwD,IAAI,CAAC,IAAI,2BAA2B,CAC9G,CAAC;gBACF,OAAO;YACT,CAAC;YAED,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAEzB,MAAM,eAAe,GAAG,aAAa;gBACnC,CAAC,CAAC,IAAA,6CAAwB,EAAC,aAAa,CAAC;gBACzC,CAAC,CAAC,aAAa,CAAC;YAClB,uBAAM,CAAC,QAAQ,CACb,eAAe,EACf,GAAG,IAAI,CAAC,SAAS,uDAAuD,CACzE,CAAC;YAEF,oFAAoF;YACpF,wEAAwE;YACxE,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,uBAAM,CAAC,OAAO,CACZ,GAAG,IAAI,CAAC,SAAS,oEAAoE,EACrF,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAES,qBAAqB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;CACF;AAjpBD,8CAipBC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { OnAmqpEventAsPromise, ReceiveOptions } from \"./messageReceiver.js\";\nimport { MessageReceiver } from \"./messageReceiver.js\";\nimport type { ConnectionContext } from \"../connectionContext.js\";\n\nimport { ReceiverHelper } from \"./receiverHelper.js\";\n\nimport { throwErrorIfConnectionClosed } from \"../util/errors.js\";\nimport type { MessagingError, RetryOptions } from \"@azure/core-amqp\";\nimport { RetryOperationType, ConditionErrorNameMapper } from \"@azure/core-amqp\";\nimport type { OperationOptionsBase } from \"../modelsToBeSharedWithEventHubs.js\";\nimport { receiverLogger as logger } from \"../log.js\";\nimport type { AmqpError, EventContext, OnAmqpEvent } from \"rhea-promise\";\nimport { ServiceBusMessageImpl } from \"../serviceBusMessage.js\";\nimport { translateServiceBusError } from \"../serviceBusError.js\";\nimport { abandonMessage, completeMessage, retryForever } from \"../receivers/receiverCommon.js\";\nimport type { ReceiverHandlers } from \"./shared.js\";\nimport type {\n  InternalMessageHandlers,\n  InternalProcessErrorArgs,\n  MessageHandlers,\n  ProcessErrorArgs,\n  SubscribeOptions,\n} from \"../models.js\";\nimport { toProcessingSpanOptions } from \"../diagnostics/instrumentServiceBusMessage.js\";\nimport { AbortError } from \"@azure/abort-controller\";\nimport { tracingClient } from \"../diagnostics/tracing.js\";\n\n/**\n * @internal\n */\nexport interface StreamingReceiverInitArgs\n  extends ReceiveOptions,\n    Pick<OperationOptionsBase, \"abortSignal\"> {\n  messageHandlers: MessageHandlers;\n}\n\n/**\n * @internal\n * Describes the streaming receiver where the user can receive the message\n * by providing handler functions.\n */\nexport class StreamingReceiver extends MessageReceiver {\n  /**\n   * The maximum number of messages that should be\n   * processed concurrently while in streaming mode. Once this limit has been reached, more\n   * messages will not be received until the user's message handler has completed processing current message.\n   * Default: 1\n   */\n  maxConcurrentCalls: number = 1;\n\n  /**\n   * Indicates whether the receiver is already actively\n   * running `onDetached`.\n   * This is expected to be true while the receiver attempts\n   * to bring its link back up due to a retryable issue.\n   */\n  private _isDetaching: boolean = false;\n  /**\n   *Retry policy options that determine the mode, number of retries, retry interval etc.\n   */\n  private _retryOptions: RetryOptions;\n\n  private _receiverHelper: ReceiverHelper;\n\n  /**\n   * The user's message handlers, wrapped so any thrown exceptions are properly logged\n   * or forwarded to the user's processError handler.\n   */\n  private _messageHandlers: () => Required<InternalMessageHandlers> = () => {\n    throw new Error(\"messageHandlers are not set.\");\n  };\n\n  /**\n   * The subscribe(options) passed when the subscribe call originally happened. Stored\n   * so _subscribeImpl() can re-use them later if we have to restart our subscription\n   * when detach/reattaching.\n   */\n  private _subscribeOptions: SubscribeOptions | undefined;\n\n  /**\n   * Used so we can stub out retry in tests.\n   */\n  private _retryForeverFn: typeof retryForever = retryForever;\n\n  /**\n   * The message handler that will be set as the handler on the\n   * underlying rhea receiver for the \"receiver_close\" event.\n   */\n  private _onAmqpClose: OnAmqpEventAsPromise;\n\n  /**\n   * The message handler that will be set as the handler on\n   * the underlying rhea receiver's session for the \"session_close\" event.\n   */\n  private _onSessionClose: OnAmqpEventAsPromise;\n\n  /**\n   * The message handler that will be set as the handler on\n   * the underlying rhea receiver's session for the \"session_error\" event.\n   */\n  private _onSessionError: OnAmqpEvent;\n  /**\n   * The message handler that will be set as the handler on the\n   * underlying rhea receiver for the \"receiver_error\" event.\n   */\n  private _onAmqpError: OnAmqpEvent;\n\n  /**\n   * The message handler that will be set as the handler on the\n   * underlying rhea receiver for the \"message\" event.\n   */\n  protected _onAmqpMessage: OnAmqpEventAsPromise;\n\n  /**\n   * Whether we are currently subscribed (or subscribing) for receiving messages.\n   * (this is irrespective of receiver state, etc... - it's just a simple flag to prevent\n   * multiple subscribe() calls from happening on this instance)\n   */\n  public get isSubscribeActive(): boolean {\n    return !this._receiverHelper.isSuspended();\n  }\n\n  /**\n   * Instantiate a new Streaming receiver for receiving messages with handlers.\n   *\n   * @param identifier - the name used to identifier the receiver\n   * @param connectionContext - The client entity context.\n   * @param options - Options for how you'd like to connect.\n   */\n  constructor(\n    identifier: string,\n    connectionContext: ConnectionContext,\n    entityPath: string,\n    options: ReceiveOptions,\n  ) {\n    super(identifier, connectionContext, entityPath, \"streaming\", options);\n\n    if (typeof options?.maxConcurrentCalls === \"number\" && options?.maxConcurrentCalls > 0) {\n      this.maxConcurrentCalls = options.maxConcurrentCalls;\n    }\n\n    this._retryOptions = options?.retryOptions || {};\n\n    this._receiverHelper = new ReceiverHelper(() => ({\n      receiver: this.link,\n      logPrefix: this.logPrefix,\n    }));\n\n    this._onAmqpClose = async (context: EventContext) => {\n      const receiverError = context.receiver && context.receiver.error;\n      const receiver = this.link || context.receiver!;\n\n      logger.logError(\n        receiverError,\n        `${this.logPrefix} 'receiver_close' event occurred. The associated error is`,\n      );\n\n      this._lockRenewer?.stopAll(this);\n\n      if (receiver && !receiver.isItselfClosed()) {\n        await this.onDetached(receiverError);\n      } else {\n        logger.verbose(\n          \"%s 'receiver_close' event occurred on the receiver '%s' with address '%s' \" +\n            \"because the sdk initiated it. Hence not calling detached from the _onAmqpClose\" +\n            \"() handler.\",\n          this.logPrefix,\n          this.name,\n          this.address,\n        );\n      }\n    };\n\n    this._onSessionClose = async (context: EventContext) => {\n      const receiver = this.link || context.receiver!;\n      const sessionError = context.session && context.session.error;\n\n      logger.logError(\n        sessionError,\n        `${this.logPrefix} 'session_close' event occurred. The associated error is`,\n      );\n\n      this._lockRenewer?.stopAll(this);\n\n      if (receiver && !receiver.isSessionItselfClosed()) {\n        await this.onDetached(sessionError);\n      } else {\n        logger.verbose(\n          \"%s 'session_close' event occurred on the session of receiver '%s' with address \" +\n            \"'%s' because the sdk initiated it. Hence not calling detached from the _onSessionClose\" +\n            \"() handler.\",\n          this.logPrefix,\n          this.name,\n          this.address,\n        );\n      }\n    };\n\n    this._onAmqpError = (context: EventContext) => {\n      const receiverError = context.receiver && context.receiver.error;\n      if (receiverError) {\n        const sbError = translateServiceBusError(receiverError) as MessagingError;\n        logger.logError(\n          sbError,\n          `${this.logPrefix} 'receiver_error' event occurred. The associated error is`,\n        );\n        this._messageHandlers().processError({\n          error: sbError,\n          errorSource: \"receive\",\n          entityPath: this.entityPath,\n          fullyQualifiedNamespace: this._context.config.host,\n          identifier,\n        });\n      }\n    };\n\n    this._onSessionError = (context: EventContext) => {\n      const sessionError = context.session && context.session.error;\n      if (sessionError) {\n        const sbError = translateServiceBusError(sessionError) as MessagingError;\n        logger.logError(\n          sbError,\n          `${this.logPrefix} 'session_error' event occurred. The associated error is`,\n        );\n        this._messageHandlers().processError({\n          error: sbError,\n          errorSource: \"receive\",\n          entityPath: this.entityPath,\n          fullyQualifiedNamespace: this._context.config.host,\n          identifier,\n        });\n      }\n    };\n\n    this._onAmqpMessage = async (context: EventContext) => {\n      // If the receiver got closed in PeekLock mode, avoid processing the message as we\n      // cannot settle the message.\n      if (this.receiveMode === \"peekLock\" && (!this.link || !this.link.isOpen())) {\n        logger.verbose(\n          \"%s Not calling the user's message handler for the current message \" +\n            \"as the receiver is closed\",\n          this.logPrefix,\n        );\n        return;\n      }\n\n      const bMessage: ServiceBusMessageImpl = new ServiceBusMessageImpl(\n        context.message!,\n        context.delivery!,\n        true,\n        this.receiveMode,\n        options.skipParsingBodyAsJson ?? false,\n        options.skipConvertingDate ?? false,\n      );\n\n      this._lockRenewer?.start(this, bMessage, (err) => {\n        this._messageHandlers().processError({\n          error: err,\n          errorSource: \"renewLock\",\n          entityPath: this.entityPath,\n          fullyQualifiedNamespace: this._context.config.host,\n          identifier,\n        });\n      });\n\n      try {\n        await this._messageHandlers().processMessage(bMessage);\n      } catch (err: any) {\n        logger.logError(\n          err,\n          \"%s An error occurred while running user's message handler for the message \" +\n            \"with id '%s' on the receiver '%s'\",\n          this.logPrefix,\n          bMessage.messageId,\n          this.name,\n        );\n\n        // Do not want renewLock to happen unnecessarily, while abandoning the message. Hence,\n        // doing this here. Otherwise, this should be done in finally.\n        this._lockRenewer?.stop(this, bMessage);\n        const error = translateServiceBusError(err) as MessagingError;\n        // Nothing much to do if user's message handler throws. Let us try abandoning the message.\n        if (\n          !bMessage.delivery.remote_settled &&\n          error.code !== ConditionErrorNameMapper[\"com.microsoft:message-lock-lost\"] &&\n          this.receiveMode === \"peekLock\" &&\n          this.isOpen() // only try to abandon the messages if the connection is still open\n        ) {\n          try {\n            logger.logError(\n              error,\n              \"%s Abandoning the message with id '%s' on the receiver '%s' since \" +\n                \"an error occured: %O.\",\n              this.logPrefix,\n              bMessage.messageId,\n              this.name,\n              error,\n            );\n            await abandonMessage(\n              bMessage,\n              this._context,\n              entityPath,\n              undefined,\n              this._retryOptions,\n            );\n          } catch (abandonError: any) {\n            const translatedError = translateServiceBusError(abandonError);\n            logger.logError(\n              translatedError,\n              \"%s An error occurred while abandoning the message with id '%s' on the \" +\n                \"receiver '%s'\",\n              this.logPrefix,\n              bMessage.messageId,\n              this.name,\n            );\n            this._messageHandlers().processError({\n              error: translatedError,\n              errorSource: \"abandon\",\n              entityPath: this.entityPath,\n              fullyQualifiedNamespace: this._context.config.host,\n              identifier,\n            });\n          }\n        }\n        return;\n      } finally {\n        try {\n          this._receiverHelper.addCredit(1);\n        } catch (err: any) {\n          // if we're aborting out of the receive operation we don't need to report it (the user already\n          // knows the link is being torn down or stopped)\n          if (err.name !== \"AbortError\") {\n            logger.logError(\n              err,\n              `[${this.logPrefix}] Failed to add credit after receiving message`,\n            );\n            await this._reportInternalError(err);\n          }\n        }\n      }\n\n      // If we've made it this far, then user's message handler completed fine. Let us try\n      // completing the message.\n      if (\n        this.autoComplete &&\n        this.receiveMode === \"peekLock\" &&\n        !bMessage.delivery.remote_settled\n      ) {\n        try {\n          logger.verbose(\n            \"%s Auto completing the message with id '%s' on \" + \"the receiver.\",\n            this.logPrefix,\n            bMessage.messageId,\n          );\n          await completeMessage(bMessage, this._context, entityPath, this._retryOptions);\n        } catch (completeError: any) {\n          const translatedError = translateServiceBusError(completeError);\n          logger.logError(\n            translatedError,\n            \"%s An error occurred while completing the message with id '%s' on the \" +\n              \"receiver '%s'\",\n            this.logPrefix,\n            bMessage.messageId,\n            this.name,\n          );\n          this._messageHandlers().processError({\n            error: translatedError,\n            errorSource: \"complete\",\n            entityPath: this.entityPath,\n            fullyQualifiedNamespace: this._context.config.host,\n            identifier,\n          });\n        }\n      }\n    };\n  }\n\n  private _reportInternalError(error: Error): Promise<void> {\n    const messageHandlers = this._messageHandlers();\n\n    if (messageHandlers.forwardInternalErrors) {\n      const errorArgs: InternalProcessErrorArgs = {\n        error,\n        entityPath: this.entityPath,\n        errorSource: \"internal\",\n        fullyQualifiedNamespace: this._context.config.host,\n        identifier: this.identifier,\n      };\n\n      return messageHandlers.processError(errorArgs as ProcessErrorArgs);\n    }\n\n    return Promise.resolve();\n  }\n\n  private _getHandlers(): ReceiverHandlers {\n    return {\n      onMessage: (context: EventContext) =>\n        this._onAmqpMessage(context).catch((err) => this._reportInternalError(err)),\n      onClose: (context: EventContext) =>\n        this._onAmqpClose(context).catch((err) => this._reportInternalError(err)),\n      onSessionClose: (context: EventContext) =>\n        this._onSessionClose(context).catch((err) => this._reportInternalError(err)),\n      onError: this._onAmqpError,\n      onSessionError: this._onSessionError,\n    };\n  }\n\n  async stopReceivingMessages(): Promise<void> {\n    await this._receiverHelper.suspend();\n\n    if (this._subscribeCallPromise) {\n      await this._subscribeCallPromise;\n    }\n  }\n\n  async close(): Promise<void> {\n    await this._receiverHelper.suspend();\n    return super.close();\n  }\n\n  private _subscribeCallPromise: Promise<void> | undefined;\n\n  /**\n   * Starts the receiver by establishing an AMQP session and an AMQP receiver link on the session.\n   *\n   * Any errors thrown by this function will also be sent to the messageHandlers.processError function\n   * _and_ thrown, ultimately from this method.\n   *\n   * NOTE: This function retries _infinitely_ until success! It is completely up to the user to break\n   * out of this retry cycle otherwise by:\n   * 1. closing the receiver\n   * 2. Calling `close` on the subscription instance they received when they initially called subscribe().\n   * 3. aborting the abortSignal they passed in when calling subscribe (this also applies to initialization calls in onDetach)\n   *\n   * @param onMessage - The message handler to receive servicebus messages.\n   * @param onError - The error handler to receive an error that occurs while receivin messages.\n   */\n  async subscribe(\n    messageHandlers: InternalMessageHandlers,\n    subscribeOptions: SubscribeOptions | undefined,\n  ): Promise<void> {\n    // these options and message handlers will be re-used if/when onDetach is called.\n    this._subscribeOptions = subscribeOptions;\n    this._setMessageHandlers(messageHandlers, subscribeOptions);\n\n    let promiseResolve: (() => void) | undefined;\n    this._subscribeCallPromise = new Promise((resolve) => {\n      promiseResolve = resolve;\n    });\n\n    try {\n      this._receiverHelper.resume();\n      return await this._subscribeImpl(\"subscribe\");\n    } catch (err: any) {\n      // callers aren't going to be in a good position to forward this error properly\n      // so we do it here.\n      await this._messageHandlers().processError({\n        entityPath: this.entityPath,\n        fullyQualifiedNamespace: this._context.config.host,\n        errorSource: \"receive\",\n        error: err,\n        identifier: this.identifier,\n      });\n\n      throw err;\n    } finally {\n      promiseResolve?.();\n      this._subscribeCallPromise = undefined;\n    }\n  }\n\n  /**\n   * Wraps the individual message handlers with tracing and proper error handling\n   * and assigns them to `this._messageHandlers`\n   *\n   * @param userHandlers - The user's message handlers\n   * @param operationOptions - The subscribe(options)\n   */\n  private _setMessageHandlers(\n    userHandlers: InternalMessageHandlers,\n    operationOptions: OperationOptionsBase | undefined,\n  ): void {\n    const messageHandlers = {\n      processError: async (args: ProcessErrorArgs) => {\n        try {\n          args.error = translateServiceBusError(args.error);\n          await userHandlers.processError(args);\n        } catch (err: any) {\n          await this._reportInternalError(err);\n          logger.logError(err, `An error was thrown from the user's processError handler`);\n        }\n      },\n      processMessage: async (message: ServiceBusMessageImpl) => {\n        try {\n          await tracingClient.withSpan(\n            \"StreamReceiver.process\",\n            operationOptions ?? {},\n            () => userHandlers.processMessage(message),\n            toProcessingSpanOptions(message, this, this._context.config, \"process\"),\n          );\n        } catch (err: any) {\n          this._messageHandlers().processError({\n            error: err,\n            errorSource: \"processMessageCallback\",\n            entityPath: this.entityPath,\n            fullyQualifiedNamespace: this._context.config.host,\n            identifier: this.identifier,\n          });\n          throw err;\n        }\n      },\n      postInitialize: async () => {\n        if (!userHandlers.postInitialize) {\n          return;\n        }\n\n        return userHandlers.postInitialize().catch((err) =>\n          this._messageHandlers().processError({\n            error: err,\n            errorSource: \"processMessageCallback\",\n            entityPath: this.entityPath,\n            fullyQualifiedNamespace: this._context.config.host,\n            identifier: this.identifier,\n          }),\n        );\n      },\n      preInitialize: async () => {\n        if (!userHandlers.preInitialize) {\n          return;\n        }\n\n        return userHandlers.preInitialize().catch((err) =>\n          this._messageHandlers().processError({\n            error: err,\n            errorSource: \"processMessageCallback\",\n            entityPath: this.entityPath,\n            fullyQualifiedNamespace: this._context.config.host,\n            identifier: this.identifier,\n          }),\n        );\n      },\n      forwardInternalErrors: userHandlers.forwardInternalErrors ?? false,\n    };\n\n    this._messageHandlers = () => messageHandlers;\n  }\n\n  /**\n   * Subscribes using the already assigned `this._messageHandlers` and `this._subscribeOptions`\n   *\n   * @returns A promise that will resolve when a link is created and we successfully add credits to it.\n   */\n  private async _subscribeImpl(caller: \"detach\" | \"subscribe\"): Promise<void> {\n    try {\n      // we don't expect to ever get an error from retryForever but bugs\n      // do happen.\n      return await this._retryForeverFn({\n        retryConfig: {\n          connectionId: this._context.connection.id,\n          operationType: RetryOperationType.receiverLink,\n          abortSignal: this._subscribeOptions?.abortSignal,\n          retryOptions: this._retryOptions,\n          operation: () => this._initAndAddCreditOperation(caller),\n        },\n        onError: (err) =>\n          this._messageHandlers().processError({\n            error: err,\n            errorSource: \"receive\",\n            entityPath: this.entityPath,\n            fullyQualifiedNamespace: this._context.config.host,\n            identifier: this.identifier,\n          }),\n        logPrefix: this.logPrefix,\n        logger,\n      });\n    } catch (err: any) {\n      try {\n        await this._receiverHelper.suspend();\n      } catch (error: any) {\n        logger.logError(error, `${this.logPrefix} receiver.suspend threw an error`);\n      }\n\n      throw err;\n    }\n  }\n\n  /**\n   * Initializes the link and adds credits. If any of these operations fail any created link will\n   * be closed.\n   *\n   * @param caller - The caller which dictates whether or not we create a new name for our created link.\n   * @param catchAndReportError - A function and reports an error but does not throw it.\n   */\n  private async _initAndAddCreditOperation(caller: \"detach\" | \"subscribe\"): Promise<void> {\n    if (this._receiverHelper.isSuspended()) {\n      // user has suspended us while we were initializing\n      // the connection. Abort this attempt - if they attempt\n      // resubscribe we'll just reinitialize.\n      // This checks should happen before throwErrorIfConnectionClosed(); otherwise\n      // we won't be able to break out of the retry-for-ever loops when user suspend us.\n      throw new AbortError(\"Receiver was suspended during initialization.\");\n    }\n\n    throwErrorIfConnectionClosed(this._context);\n\n    await this._messageHandlers().preInitialize();\n\n    if (this._receiverHelper.isSuspended()) {\n      // Need to check again as user can suspend us in preInitialize()\n      throw new AbortError(\"Receiver was suspended during initialization.\");\n    }\n    await this._init(\n      this._createReceiverOptions(caller === \"detach\", this._getHandlers()),\n      this._subscribeOptions?.abortSignal,\n    );\n\n    try {\n      await this._messageHandlers().postInitialize();\n      this._receiverHelper.addCredit(this.maxConcurrentCalls);\n    } catch (err: any) {\n      try {\n        await this.closeLink();\n      } catch (error: any) {\n        await this._messageHandlers().processError({\n          error,\n          errorSource: \"receive\",\n          entityPath: this.entityPath,\n          fullyQualifiedNamespace: this._context.config.host,\n          identifier: this.identifier,\n        });\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * Will reconnect the receiver link if necessary.\n   * @param receiverError - The receiver error or connection error, if any.\n   */\n  async onDetached(receiverError?: AmqpError | Error): Promise<void> {\n    try {\n      logger.verbose(`${this.logPrefix} onDetached: reinitializing link.`);\n\n      // User explicitly called `close` on the receiver, so link is already closed\n      // and we can exit early.\n      if (this.wasClosedPermanently) {\n        logger.verbose(\n          `${this.logPrefix} onDetached: link has been closed permanently, not reinitializing. `,\n        );\n        return;\n      }\n\n      // Prevent multiple onDetached invocations from running concurrently.\n      if (this._isDetaching) {\n        // This can happen when the network connection goes down for some amount of time.\n        // The first connection `disconnect` will trigger `onDetached` and attempt to retry\n        // creating the connection/receiver link.\n        // While those retry attempts fail (until the network connection comes back up),\n        // we'll continue to see connection `disconnect` errors.\n        // These should be ignored until the already running `onDetached` completes\n        // its retry attempts or errors.\n        logger.verbose(\n          `${this.logPrefix} onDetached: Call to detached on streaming receiver '${this.name}' is already in progress.`,\n        );\n        return;\n      }\n\n      this._isDetaching = true;\n\n      const translatedError = receiverError\n        ? translateServiceBusError(receiverError)\n        : receiverError;\n      logger.logError(\n        translatedError,\n        `${this.logPrefix} onDetached: Reinitializing receiver because of error`,\n      );\n\n      // Clears the token renewal timer. Closes the link and its session if they are open.\n      // Removes the link and its session if they are present in rhea's cache.\n      await this.closeLink();\n    } catch (err: any) {\n      logger.verbose(\n        `${this.logPrefix} onDetached: Encountered an error when closing the previous link: `,\n        err,\n      );\n    }\n\n    try {\n      await this._subscribeImpl(\"detach\");\n    } finally {\n      this._isDetaching = false;\n    }\n  }\n\n  protected removeLinkFromContext(): void {\n    delete this._context.messageReceivers[this.name];\n  }\n}\n"]}