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

package/dist/esm/receivers/sessionReceiver.js

@@ -0,0 +1,428 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { getAlreadyReceivingErrorMsg, getReceiverClosedErrorMsg, InvalidMaxMessageCountError, throwErrorIfConnectionClosed, throwTypeErrorIfParameterMissing, throwTypeErrorIfParameterNotLong, throwErrorIfInvalidOperationOnMessage, throwTypeErrorIfParameterTypeMismatch, } from "../util/errors.js";
+import { abandonMessage, assertValidMessageHandlers, completeMessage, deadLetterMessage, deferMessage, getMessageIterator, wrapProcessErrorHandler, } from "./receiverCommon.js";
+import { defaultMaxTimeAfterFirstMessageForBatchingMs, MaxDeleteMessageCount } from "./receiver.js";
+import { Constants, RetryOperationType, retry, ErrorNameConditionMapper } from "@azure/core-amqp";
+import { toProcessingSpanOptions } from "../diagnostics/instrumentServiceBusMessage.js";
+import { tracingClient } from "../diagnostics/tracing.js";
+import { receiverLogger as logger } from "../log.js";
+import { translateServiceBusError } from "../serviceBusError.js";
+/**
+ * @internal
+ */
+export class ServiceBusSessionReceiverImpl {
+    _messageSession;
+    _context;
+    entityPath;
+    receiveMode;
+    _skipParsingBodyAsJson;
+    _skipConvertingDate;
+    _retryOptions;
+    sessionId;
+    identifier;
+    /**
+     * Denotes if close() was called on this receiver
+     */
+    _isClosed = false;
+    get logPrefix() {
+        return `[${this._context.connectionId}|session:${this.entityPath}]`;
+    }
+    /**
+     * @internal
+     * @throws Error if the underlying connection is closed.
+     * @throws Error if an open receiver is already existing for given sessionId.
+     */
+    constructor(_messageSession, _context, entityPath, receiveMode, _skipParsingBodyAsJson, _skipConvertingDate, _retryOptions = {}) {
+        this._messageSession = _messageSession;
+        this._context = _context;
+        this.entityPath = entityPath;
+        this.receiveMode = receiveMode;
+        this._skipParsingBodyAsJson = _skipParsingBodyAsJson;
+        this._skipConvertingDate = _skipConvertingDate;
+        this._retryOptions = _retryOptions;
+        throwErrorIfConnectionClosed(_context);
+        this.sessionId = _messageSession.sessionId;
+        this.identifier = _messageSession.identifier;
+    }
+    _throwIfReceiverOrConnectionClosed() {
+        throwErrorIfConnectionClosed(this._context);
+        if (this.isClosed) {
+            if (this._isClosed) {
+                const errorMessage = getReceiverClosedErrorMsg(this.entityPath, this.sessionId);
+                const error = new Error(errorMessage);
+                logger.logError(error, `${this.logPrefix} already closed`);
+                throw error;
+            }
+            const amqpError = {
+                condition: ErrorNameConditionMapper.SessionLockLostError,
+                description: `The session lock has expired on the session with id ${this.sessionId}`,
+            };
+            throw translateServiceBusError(amqpError);
+        }
+    }
+    _throwIfAlreadyReceiving() {
+        if (this._isReceivingMessages()) {
+            const errorMessage = getAlreadyReceivingErrorMsg(this.entityPath, this.sessionId);
+            const error = new Error(errorMessage);
+            logger.logError(error, `${this.logPrefix} is already receiving.`);
+            throw error;
+        }
+    }
+    get isClosed() {
+        return (this._isClosed ||
+            !this._context.messageSessions[this._messageSession.name] ||
+            !this._messageSession.isOpen());
+    }
+    /**
+     * The time in UTC until which the session is locked.
+     * Every time `renewSessionLock()` is called, this time gets updated to current time plus the lock
+     * duration as specified during the Queue/Subscription creation.
+     *
+     * When the lock on the session expires
+     * - The current receiver can no longer be used to receive more messages.
+     * Create a new receiver using `ServiceBusClient.acceptSession()` or `ServiceBusClient.acceptNextSession()`.
+     * - Messages that were received in `peekLock` mode with this receiver but not yet settled
+     * will land back in the Queue/Subscription with their delivery count incremented.
+     *
+     * @readonly
+     */
+    get sessionLockedUntilUtc() {
+        return this._messageSession.sessionLockedUntilUtc;
+    }
+    /**
+     * Renews the lock on the session for the duration as specified during the Queue/Subscription
+     * creation. You can check the `sessionLockedUntilUtc` property for the time when the lock expires.
+     *
+     * When the lock on the session expires
+     * - The current receiver can no longer be used to receive mode messages.
+     * Create a new receiver using `ServiceBusClient.acceptSession()` or `ServiceBusClient.acceptNextSession()`.
+     * - Messages that were received in `peekLock` mode with this receiver but not yet settled
+     * will land back in the Queue/Subscription with their delivery count incremented.
+     *
+     * @param options - Options bag to pass an abort signal or tracing options.
+     * @returns New lock token expiry date and time in UTC format.
+     * @throws Error if the underlying connection or receiver is closed.
+     * @throws `ServiceBusError` if the service returns an error while renewing session lock.
+     */
+    async renewSessionLock(options) {
+        this._throwIfReceiverOrConnectionClosed();
+        return tracingClient.withSpan("ServiceBusSessionReceiver.renewSessionLock", options ?? {}, (updatedOptions) => {
+            const renewSessionLockOperationPromise = async () => {
+                this._messageSession.sessionLockedUntilUtc = await this._context
+                    .getManagementClient(this.entityPath)
+                    .renewSessionLock(this.sessionId, {
+                    ...updatedOptions,
+                    associatedLinkName: this._messageSession.name,
+                    requestName: "renewSessionLock",
+                    timeoutInMs: this._retryOptions.timeoutInMs,
+                });
+                return this._messageSession.sessionLockedUntilUtc;
+            };
+            const config = {
+                operation: renewSessionLockOperationPromise,
+                connectionId: this._context.connectionId,
+                operationType: RetryOperationType.management,
+                retryOptions: this._retryOptions,
+                abortSignal: options?.abortSignal,
+            };
+            return retry(config);
+        });
+    }
+    /**
+     * Sets the state on the Session. For more on session states, see
+     * {@link https://learn.microsoft.com/azure/service-bus-messaging/message-sessions#message-session-state | Session State}
+     * @param state - The state that needs to be set.
+     * @param options - Options bag to pass an abort signal or tracing options.
+     * @throws Error if the underlying connection or receiver is closed.
+     * @throws `ServiceBusError` if the service returns an error while setting the session state.
+     */
+    async setSessionState(state, options = {}) {
+        this._throwIfReceiverOrConnectionClosed();
+        return tracingClient.withSpan("ServiceBusSessionReceiver.setSessionState", options ?? {}, (updatedOptions) => {
+            const setSessionStateOperationPromise = async () => {
+                await this._context
+                    .getManagementClient(this.entityPath)
+                    .setSessionState(this.sessionId, state, {
+                    ...updatedOptions,
+                    associatedLinkName: this._messageSession.name,
+                    requestName: "setState",
+                    timeoutInMs: this._retryOptions.timeoutInMs,
+                });
+                return;
+            };
+            const config = {
+                operation: setSessionStateOperationPromise,
+                connectionId: this._context.connectionId,
+                operationType: RetryOperationType.management,
+                retryOptions: this._retryOptions,
+                abortSignal: options?.abortSignal,
+            };
+            return retry(config);
+        });
+    }
+    /**
+     * Gets the state of the Session. For more on session states, see
+     * {@link https://learn.microsoft.com/azure/service-bus-messaging/message-sessions#message-session-state | Session State}
+     * @param options - Options bag to pass an abort signal or tracing options.
+     * @returns The state of that session
+     * @throws Error if the underlying connection or receiver is closed.
+     * @throws `ServiceBusError` if the service returns an error while retrieving session state.
+     */
+    async getSessionState(options = {}) {
+        this._throwIfReceiverOrConnectionClosed();
+        return tracingClient.withSpan("ServiceBusSessionReceiver.getSessionState", options ?? {}, (updatedOptions) => {
+            const getSessionStateOperationPromise = async () => {
+                return this._context
+                    .getManagementClient(this.entityPath)
+                    .getSessionState(this.sessionId, {
+                    ...updatedOptions,
+                    associatedLinkName: this._messageSession.name,
+                    requestName: "getState",
+                    timeoutInMs: this._retryOptions.timeoutInMs,
+                });
+            };
+            const config = {
+                operation: getSessionStateOperationPromise,
+                connectionId: this._context.connectionId,
+                operationType: RetryOperationType.management,
+                retryOptions: this._retryOptions,
+                abortSignal: options?.abortSignal,
+            };
+            return retry(config);
+        });
+    }
+    async peekMessages(maxMessageCount, options = {}) {
+        this._throwIfReceiverOrConnectionClosed();
+        const managementRequestOptions = {
+            ...options,
+            associatedLinkName: this._messageSession.name,
+            requestName: "peekMessages",
+            timeoutInMs: this._retryOptions?.timeoutInMs,
+            skipParsingBodyAsJson: this._skipParsingBodyAsJson,
+            skipConvertingDate: this._skipConvertingDate,
+        };
+        // omitMessageBody is available at runtime, but only exported in experimental subpath
+        const { fromSequenceNumber, omitMessageBody } = options;
+        const peekOperationPromise = async () => {
+            if (fromSequenceNumber !== undefined) {
+                return this._context
+                    .getManagementClient(this.entityPath)
+                    .peekBySequenceNumber(fromSequenceNumber, maxMessageCount, this.sessionId, omitMessageBody, managementRequestOptions);
+            }
+            else {
+                return this._context
+                    .getManagementClient(this.entityPath)
+                    .peekMessagesBySession(this.sessionId, maxMessageCount, omitMessageBody, managementRequestOptions);
+            }
+        };
+        const config = {
+            operation: peekOperationPromise,
+            connectionId: this._context.connectionId,
+            operationType: RetryOperationType.management,
+            retryOptions: this._retryOptions,
+            abortSignal: options?.abortSignal,
+        };
+        return retry(config);
+    }
+    async receiveDeferredMessages(sequenceNumbers, options = {}) {
+        this._throwIfReceiverOrConnectionClosed();
+        throwTypeErrorIfParameterMissing(this._context.connectionId, "sequenceNumbers", sequenceNumbers);
+        throwTypeErrorIfParameterNotLong(this._context.connectionId, "sequenceNumbers", sequenceNumbers);
+        const deferredSequenceNumbers = Array.isArray(sequenceNumbers)
+            ? sequenceNumbers
+            : [sequenceNumbers];
+        const receiveDeferredMessagesOperationPromise = async () => {
+            const deferredMessages = await this._context
+                .getManagementClient(this.entityPath)
+                .receiveDeferredMessages(deferredSequenceNumbers, this.receiveMode, this.sessionId, {
+                ...options,
+                associatedLinkName: this._messageSession.name,
+                requestName: "receiveDeferredMessages",
+                timeoutInMs: this._retryOptions.timeoutInMs,
+                skipParsingBodyAsJson: this._skipParsingBodyAsJson,
+                skipConvertingDate: this._skipConvertingDate,
+            });
+            return deferredMessages;
+        };
+        const config = {
+            operation: receiveDeferredMessagesOperationPromise,
+            connectionId: this._context.connectionId,
+            operationType: RetryOperationType.management,
+            retryOptions: this._retryOptions,
+            abortSignal: options?.abortSignal,
+        };
+        return retry(config);
+    }
+    async deleteMessages(options) {
+        this._throwIfReceiverOrConnectionClosed();
+        const deleteMessagesOperationPromise = () => {
+            return this._context
+                .getManagementClient(this.entityPath)
+                .deleteMessages(options.maxMessageCount, options?.beforeEnqueueTime, this.sessionId, {
+                ...options,
+                associatedLinkName: this._messageSession.name,
+                requestName: "deleteMessages",
+                timeoutInMs: this._retryOptions.timeoutInMs,
+            });
+        };
+        const config = {
+            operation: deleteMessagesOperationPromise,
+            connectionId: this._context.connectionId,
+            operationType: RetryOperationType.management,
+            retryOptions: this._retryOptions,
+            abortSignal: options?.abortSignal,
+        };
+        return retry(config);
+    }
+    async purgeMessages(options) {
+        let deletedCount = await this.deleteMessages({
+            maxMessageCount: MaxDeleteMessageCount,
+            beforeEnqueueTime: options?.beforeEnqueueTime,
+        });
+        if (deletedCount === MaxDeleteMessageCount) {
+            let batchCount = MaxDeleteMessageCount;
+            while (batchCount === MaxDeleteMessageCount) {
+                batchCount = await this.deleteMessages({
+                    maxMessageCount: MaxDeleteMessageCount,
+                    beforeEnqueueTime: options?.beforeEnqueueTime,
+                });
+                deletedCount += batchCount;
+            }
+        }
+        return deletedCount;
+    }
+    async receiveMessages(maxMessageCount, options) {
+        this._throwIfReceiverOrConnectionClosed();
+        this._throwIfAlreadyReceiving();
+        throwTypeErrorIfParameterMissing(this._context.connectionId, "maxMessageCount", maxMessageCount);
+        throwTypeErrorIfParameterTypeMismatch(this._context.connectionId, "maxMessageCount", maxMessageCount, "number");
+        if (isNaN(maxMessageCount) || maxMessageCount < 1) {
+            throw new TypeError(InvalidMaxMessageCountError);
+        }
+        const receiveBatchOperationPromise = async () => {
+            const receivedMessages = await this._messageSession.receiveMessages(maxMessageCount, options?.maxWaitTimeInMs ?? Constants.defaultOperationTimeoutInMs, defaultMaxTimeAfterFirstMessageForBatchingMs, options ?? {});
+            return receivedMessages;
+        };
+        const config = {
+            operation: receiveBatchOperationPromise,
+            connectionId: this._context.connectionId,
+            operationType: RetryOperationType.receiveMessage,
+            retryOptions: this._retryOptions,
+            abortSignal: options?.abortSignal,
+        };
+        return retry(config).catch((err) => {
+            throw translateServiceBusError(err);
+        });
+    }
+    subscribe(handlers, options) {
+        // TODO - receiverOptions for subscribe??
+        assertValidMessageHandlers(handlers);
+        options = options ?? {};
+        const processError = wrapProcessErrorHandler(handlers);
+        this._registerMessageHandler(async (message) => {
+            return tracingClient.withSpan("SessionReceiver.process", options ?? {}, () => handlers.processMessage(message), toProcessingSpanOptions(message, this, this._context.config, "process"));
+        }, processError, options);
+        return {
+            close: async () => {
+                return this._messageSession?.receiverHelper.suspend();
+            },
+        };
+    }
+    /**
+     * Registers handlers to deal with the incoming stream of messages over an AMQP receiver link
+     * from a Queue/Subscription.
+     * To stop receiving messages, call `close()` on the SessionReceiver.
+     *
+     * Throws an error if there is another receive operation in progress on the same receiver. If you
+     * are not sure whether there is another receive operation running, check the `isReceivingMessages`
+     * property on the receiver.
+     *
+     * @param onMessage - Handler for processing each incoming message.
+     * @param onError - Handler for any error that occurs while receiving or processing messages.
+     * @param options - Options to control whether messages should be automatically completed
+     * or if the lock on the session should be automatically renewed. You can control the
+     * maximum number of messages that should be concurrently processed. You can
+     * also provide a timeout in milliseconds to denote the amount of time to wait for a new message
+     * before closing the receiver.
+     *
+     * @throws Error if the underlying connection or receiver is closed.
+     * @throws Error if the receiver is already in state of receiving messages.
+     * @throws `ServiceBusError` if the service returns an error while receiving messages. These are bubbled up to be handled by user provided `onError` handler.
+     */
+    _registerMessageHandler(onMessage, onError, options) {
+        this._throwIfReceiverOrConnectionClosed();
+        this._throwIfAlreadyReceiving();
+        const connId = this._context.connectionId;
+        throwTypeErrorIfParameterMissing(connId, "onMessage", onMessage);
+        throwTypeErrorIfParameterMissing(connId, "onError", onError);
+        if (typeof onMessage !== "function") {
+            throw new TypeError("The parameter 'onMessage' must be of type 'function'.");
+        }
+        if (typeof onError !== "function") {
+            throw new TypeError("The parameter 'onError' must be of type 'function'.");
+        }
+        try {
+            this._messageSession.subscribe(onMessage, onError, options);
+        }
+        catch (err) {
+            onError({
+                error: err,
+                errorSource: "receive",
+                entityPath: this.entityPath,
+                fullyQualifiedNamespace: this._context.config.host,
+                identifier: this.identifier,
+            });
+        }
+    }
+    getMessageIterator(options) {
+        return getMessageIterator(this, options);
+    }
+    async completeMessage(message) {
+        this._throwIfReceiverOrConnectionClosed();
+        throwErrorIfInvalidOperationOnMessage(message, this.receiveMode, this._context.connectionId);
+        const msgImpl = message;
+        return completeMessage(msgImpl, this._context, this.entityPath, this._retryOptions);
+    }
+    async abandonMessage(message, propertiesToModify) {
+        this._throwIfReceiverOrConnectionClosed();
+        throwErrorIfInvalidOperationOnMessage(message, this.receiveMode, this._context.connectionId);
+        const msgImpl = message;
+        return abandonMessage(msgImpl, this._context, this.entityPath, propertiesToModify, this._retryOptions);
+    }
+    async deferMessage(message, propertiesToModify) {
+        this._throwIfReceiverOrConnectionClosed();
+        throwErrorIfInvalidOperationOnMessage(message, this.receiveMode, this._context.connectionId);
+        const msgImpl = message;
+        return deferMessage(msgImpl, this._context, this.entityPath, propertiesToModify, this._retryOptions);
+    }
+    async deadLetterMessage(message, options) {
+        this._throwIfReceiverOrConnectionClosed();
+        throwErrorIfInvalidOperationOnMessage(message, this.receiveMode, this._context.connectionId);
+        const msgImpl = message;
+        return deadLetterMessage(msgImpl, this._context, this.entityPath, options, this._retryOptions);
+    }
+    async renewMessageLock() {
+        throw new Error("Renewing message lock is an invalid operation when working with sessions.");
+    }
+    async close() {
+        try {
+            await this._messageSession.close();
+        }
+        catch (err) {
+            logger.logError(err, "%s An error occurred while closing the SessionReceiver for session %s", this.logPrefix, this.sessionId);
+            throw err;
+        }
+        finally {
+            this._isClosed = true;
+        }
+    }
+    /**
+     * Indicates whether the receiver is currently receiving messages or not.
+     * When this returns true, new `registerMessageHandler()` or `receiveMessages()` calls cannot be made.
+     */
+    _isReceivingMessages() {
+        return this._messageSession ? this._messageSession.isReceivingMessages : false;
+    }
+}
+//# sourceMappingURL=sessionReceiver.js.map

package/dist/esm/receivers/sessionReceiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionReceiver.js","sourceRoot":"","sources":["../../../src/receivers/sessionReceiver.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { ConnectionContext } from \"../connectionContext.js\";\nimport type {\n  MessageHandlers,\n  ReceiveMessagesOptions,\n  ServiceBusReceivedMessage,\n} from \"../index.js\";\nimport type {\n  PeekMessagesOptions,\n  GetMessageIteratorOptions,\n  SubscribeOptions,\n  DeleteMessagesOptions,\n  PurgeMessagesOptions,\n} from \"../models.js\";\nimport type { MessageSession } from \"../session/messageSession.js\";\nimport {\n  getAlreadyReceivingErrorMsg,\n  getReceiverClosedErrorMsg,\n  InvalidMaxMessageCountError,\n  throwErrorIfConnectionClosed,\n  throwTypeErrorIfParameterMissing,\n  throwTypeErrorIfParameterNotLong,\n  throwErrorIfInvalidOperationOnMessage,\n  throwTypeErrorIfParameterTypeMismatch,\n} from \"../util/errors.js\";\nimport type { OnError, OnMessage } from \"../core/messageReceiver.js\";\nimport {\n  abandonMessage,\n  assertValidMessageHandlers,\n  completeMessage,\n  deadLetterMessage,\n  deferMessage,\n  getMessageIterator,\n  wrapProcessErrorHandler,\n} from \"./receiverCommon.js\";\nimport type { ServiceBusReceiver } from \"./receiver.js\";\nimport { defaultMaxTimeAfterFirstMessageForBatchingMs, MaxDeleteMessageCount } from \"./receiver.js\";\nimport type Long from \"long\";\nimport type { ServiceBusMessageImpl, DeadLetterOptions } from \"../serviceBusMessage.js\";\nimport type { RetryConfig, RetryOptions } from \"@azure/core-amqp\";\nimport { Constants, RetryOperationType, retry, ErrorNameConditionMapper } from \"@azure/core-amqp\";\nimport type { OperationOptionsBase } from \"../modelsToBeSharedWithEventHubs.js\";\nimport type { AmqpError } from \"rhea-promise\";\nimport { toProcessingSpanOptions } from \"../diagnostics/instrumentServiceBusMessage.js\";\nimport { tracingClient } from \"../diagnostics/tracing.js\";\nimport { receiverLogger as logger } from \"../log.js\";\nimport { translateServiceBusError } from \"../serviceBusError.js\";\n\n/**\n *A receiver that handles sessions, including renewing the session lock.\n */\nexport interface ServiceBusSessionReceiver extends ServiceBusReceiver {\n  /**\n   * The session ID.\n   */\n  readonly sessionId: string;\n\n  /**\n   * The time in UTC until which the session is locked.\n   * Every time `renewSessionLock()` is called, this time gets updated to current time plus the lock\n   * duration as specified during the Queue/Subscription creation.\n   *\n   * Will return undefined until a AMQP receiver link has been successfully set up for the session.\n   *\n   * @readonly\n   */\n  readonly sessionLockedUntilUtc: Date;\n\n  /**\n   * Streams messages to message handlers.\n   * @param handlers - A handler that gets called for messages and errors.\n   * @param options - Options for subscribe.\n   * @returns An object that can be closed, sending any remaining messages to `handlers` and\n   * stopping new messages from arriving.\n   */\n  subscribe(\n    handlers: MessageHandlers,\n    options?: SubscribeOptions,\n  ): {\n    /**\n     * Causes the subscriber to stop receiving new messages.\n     */\n    close(): Promise<void>;\n  };\n\n  /**\n   * Renews the lock on the session.\n   */\n  renewSessionLock(options?: OperationOptionsBase): Promise<Date>;\n\n  /**\n   * Gets the state of the Session. For more on session states, see\n   * {@link https://learn.microsoft.com/azure/service-bus-messaging/message-sessions#message-session-state | Session State}\n   * @param options - Options bag to pass an abort signal or tracing options.\n   * @returns The state of that session\n   * @throws Error if the underlying connection or receiver is closed.\n   * @throws `ServiceBusError` if the service returns an error while retrieving session state.\n   */\n  getSessionState(options?: OperationOptionsBase): Promise<any>;\n\n  /**\n   * Sets the state on the Session. For more on session states, see\n   * {@link https://learn.microsoft.com/azure/service-bus-messaging/message-sessions#message-session-state | Session State}\n   * @param state - The state that needs to be set.\n   * @param options - Options bag to pass an abort signal or tracing options.\n   * @throws Error if the underlying connection or receiver is closed.\n   * @throws `ServiceBusError` if the service returns an error while setting the session state.\n   *\n   */\n  setSessionState(state: any, options?: OperationOptionsBase): Promise<void>;\n}\n\n/**\n * @internal\n */\nexport class ServiceBusSessionReceiverImpl implements ServiceBusSessionReceiver {\n  public sessionId: string;\n  public identifier: string;\n\n  /**\n   * Denotes if close() was called on this receiver\n   */\n  private _isClosed: boolean = false;\n\n  private get logPrefix(): string {\n    return `[${this._context.connectionId}|session:${this.entityPath}]`;\n  }\n\n  /**\n   * @internal\n   * @throws Error if the underlying connection is closed.\n   * @throws Error if an open receiver is already existing for given sessionId.\n   */\n  constructor(\n    private _messageSession: MessageSession,\n    private _context: ConnectionContext,\n    public entityPath: string,\n    public receiveMode: \"peekLock\" | \"receiveAndDelete\",\n    private _skipParsingBodyAsJson: boolean,\n    private _skipConvertingDate: boolean,\n    private _retryOptions: RetryOptions = {},\n  ) {\n    throwErrorIfConnectionClosed(_context);\n    this.sessionId = _messageSession.sessionId;\n    this.identifier = _messageSession.identifier;\n  }\n\n  private _throwIfReceiverOrConnectionClosed(): void {\n    throwErrorIfConnectionClosed(this._context);\n    if (this.isClosed) {\n      if (this._isClosed) {\n        const errorMessage = getReceiverClosedErrorMsg(this.entityPath, this.sessionId);\n        const error = new Error(errorMessage);\n        logger.logError(error, `${this.logPrefix} already closed`);\n        throw error;\n      }\n      const amqpError: AmqpError = {\n        condition: ErrorNameConditionMapper.SessionLockLostError,\n        description: `The session lock has expired on the session with id ${this.sessionId}`,\n      };\n      throw translateServiceBusError(amqpError);\n    }\n  }\n\n  private _throwIfAlreadyReceiving(): void {\n    if (this._isReceivingMessages()) {\n      const errorMessage = getAlreadyReceivingErrorMsg(this.entityPath, this.sessionId);\n      const error = new Error(errorMessage);\n      logger.logError(error, `${this.logPrefix} is already receiving.`);\n      throw error;\n    }\n  }\n\n  public get isClosed(): boolean {\n    return (\n      this._isClosed ||\n      !this._context.messageSessions[this._messageSession.name] ||\n      !this._messageSession.isOpen()\n    );\n  }\n\n  /**\n   * The time in UTC until which the session is locked.\n   * Every time `renewSessionLock()` is called, this time gets updated to current time plus the lock\n   * duration as specified during the Queue/Subscription creation.\n   *\n   * When the lock on the session expires\n   * - The current receiver can no longer be used to receive more messages.\n   * Create a new receiver using `ServiceBusClient.acceptSession()` or `ServiceBusClient.acceptNextSession()`.\n   * - Messages that were received in `peekLock` mode with this receiver but not yet settled\n   * will land back in the Queue/Subscription with their delivery count incremented.\n   *\n   * @readonly\n   */\n  public get sessionLockedUntilUtc(): Date {\n    return this._messageSession.sessionLockedUntilUtc;\n  }\n\n  /**\n   * Renews the lock on the session for the duration as specified during the Queue/Subscription\n   * creation. You can check the `sessionLockedUntilUtc` property for the time when the lock expires.\n   *\n   * When the lock on the session expires\n   * - The current receiver can no longer be used to receive mode messages.\n   * Create a new receiver using `ServiceBusClient.acceptSession()` or `ServiceBusClient.acceptNextSession()`.\n   * - Messages that were received in `peekLock` mode with this receiver but not yet settled\n   * will land back in the Queue/Subscription with their delivery count incremented.\n   *\n   * @param options - Options bag to pass an abort signal or tracing options.\n   * @returns New lock token expiry date and time in UTC format.\n   * @throws Error if the underlying connection or receiver is closed.\n   * @throws `ServiceBusError` if the service returns an error while renewing session lock.\n   */\n  async renewSessionLock(options?: OperationOptionsBase): Promise<Date> {\n    this._throwIfReceiverOrConnectionClosed();\n\n    return tracingClient.withSpan(\n      \"ServiceBusSessionReceiver.renewSessionLock\",\n      options ?? {},\n      (updatedOptions) => {\n        const renewSessionLockOperationPromise = async (): Promise<Date> => {\n          this._messageSession!.sessionLockedUntilUtc = await this._context\n            .getManagementClient(this.entityPath)\n            .renewSessionLock(this.sessionId, {\n              ...updatedOptions,\n              associatedLinkName: this._messageSession.name,\n              requestName: \"renewSessionLock\",\n              timeoutInMs: this._retryOptions.timeoutInMs,\n            });\n          return this._messageSession!.sessionLockedUntilUtc!;\n        };\n        const config: RetryConfig<Date> = {\n          operation: renewSessionLockOperationPromise,\n          connectionId: this._context.connectionId,\n          operationType: RetryOperationType.management,\n          retryOptions: this._retryOptions,\n          abortSignal: options?.abortSignal,\n        };\n        return retry<Date>(config);\n      },\n    );\n  }\n\n  /**\n   * Sets the state on the Session. For more on session states, see\n   * {@link https://learn.microsoft.com/azure/service-bus-messaging/message-sessions#message-session-state | Session State}\n   * @param state - The state that needs to be set.\n   * @param options - Options bag to pass an abort signal or tracing options.\n   * @throws Error if the underlying connection or receiver is closed.\n   * @throws `ServiceBusError` if the service returns an error while setting the session state.\n   */\n  async setSessionState(state: unknown, options: OperationOptionsBase = {}): Promise<void> {\n    this._throwIfReceiverOrConnectionClosed();\n\n    return tracingClient.withSpan(\n      \"ServiceBusSessionReceiver.setSessionState\",\n      options ?? {},\n      (updatedOptions) => {\n        const setSessionStateOperationPromise = async (): Promise<void> => {\n          await this._context\n            .getManagementClient(this.entityPath)\n            .setSessionState(this.sessionId!, state, {\n              ...updatedOptions,\n              associatedLinkName: this._messageSession.name,\n              requestName: \"setState\",\n              timeoutInMs: this._retryOptions.timeoutInMs,\n            });\n          return;\n        };\n        const config: RetryConfig<void> = {\n          operation: setSessionStateOperationPromise,\n          connectionId: this._context.connectionId,\n          operationType: RetryOperationType.management,\n          retryOptions: this._retryOptions,\n          abortSignal: options?.abortSignal,\n        };\n        return retry<void>(config);\n      },\n    );\n  }\n\n  /**\n   * Gets the state of the Session. For more on session states, see\n   * {@link https://learn.microsoft.com/azure/service-bus-messaging/message-sessions#message-session-state | Session State}\n   * @param options - Options bag to pass an abort signal or tracing options.\n   * @returns The state of that session\n   * @throws Error if the underlying connection or receiver is closed.\n   * @throws `ServiceBusError` if the service returns an error while retrieving session state.\n   */\n  async getSessionState(options: OperationOptionsBase = {}): Promise<any> {\n    this._throwIfReceiverOrConnectionClosed();\n\n    return tracingClient.withSpan(\n      \"ServiceBusSessionReceiver.getSessionState\",\n      options ?? {},\n      (updatedOptions) => {\n        const getSessionStateOperationPromise = async (): Promise<any> => {\n          return this._context\n            .getManagementClient(this.entityPath)\n            .getSessionState(this.sessionId, {\n              ...updatedOptions,\n              associatedLinkName: this._messageSession.name,\n              requestName: \"getState\",\n              timeoutInMs: this._retryOptions.timeoutInMs,\n            });\n        };\n        const config: RetryConfig<any> = {\n          operation: getSessionStateOperationPromise,\n          connectionId: this._context.connectionId,\n          operationType: RetryOperationType.management,\n          retryOptions: this._retryOptions,\n          abortSignal: options?.abortSignal,\n        };\n        return retry<any>(config);\n      },\n    );\n  }\n\n  async peekMessages(\n    maxMessageCount: number,\n    options: PeekMessagesOptions = {},\n  ): Promise<ServiceBusReceivedMessage[]> {\n    this._throwIfReceiverOrConnectionClosed();\n\n    const managementRequestOptions = {\n      ...options,\n      associatedLinkName: this._messageSession.name,\n      requestName: \"peekMessages\",\n      timeoutInMs: this._retryOptions?.timeoutInMs,\n      skipParsingBodyAsJson: this._skipParsingBodyAsJson,\n      skipConvertingDate: this._skipConvertingDate,\n    };\n    // omitMessageBody is available at runtime, but only exported in experimental subpath\n    const { fromSequenceNumber, omitMessageBody } = options as PeekMessagesOptions & {\n      omitMessageBody: boolean;\n    };\n    const peekOperationPromise = async (): Promise<ServiceBusReceivedMessage[]> => {\n      if (fromSequenceNumber !== undefined) {\n        return this._context\n          .getManagementClient(this.entityPath)\n          .peekBySequenceNumber(\n            fromSequenceNumber,\n            maxMessageCount,\n            this.sessionId,\n            omitMessageBody,\n            managementRequestOptions,\n          );\n      } else {\n        return this._context\n          .getManagementClient(this.entityPath)\n          .peekMessagesBySession(\n            this.sessionId,\n            maxMessageCount,\n            omitMessageBody,\n            managementRequestOptions,\n          );\n      }\n    };\n\n    const config: RetryConfig<ServiceBusReceivedMessage[]> = {\n      operation: peekOperationPromise,\n      connectionId: this._context.connectionId,\n      operationType: RetryOperationType.management,\n      retryOptions: this._retryOptions,\n      abortSignal: options?.abortSignal,\n    };\n    return retry<ServiceBusReceivedMessage[]>(config);\n  }\n\n  async receiveDeferredMessages(\n    sequenceNumbers: Long | Long[],\n    options: OperationOptionsBase = {},\n  ): Promise<ServiceBusReceivedMessage[]> {\n    this._throwIfReceiverOrConnectionClosed();\n    throwTypeErrorIfParameterMissing(\n      this._context.connectionId,\n      \"sequenceNumbers\",\n      sequenceNumbers,\n    );\n    throwTypeErrorIfParameterNotLong(\n      this._context.connectionId,\n      \"sequenceNumbers\",\n      sequenceNumbers,\n    );\n\n    const deferredSequenceNumbers = Array.isArray(sequenceNumbers)\n      ? sequenceNumbers\n      : [sequenceNumbers];\n    const receiveDeferredMessagesOperationPromise = async (): Promise<\n      ServiceBusReceivedMessage[]\n    > => {\n      const deferredMessages = await this._context\n        .getManagementClient(this.entityPath)\n        .receiveDeferredMessages(deferredSequenceNumbers, this.receiveMode, this.sessionId, {\n          ...options,\n          associatedLinkName: this._messageSession.name,\n          requestName: \"receiveDeferredMessages\",\n          timeoutInMs: this._retryOptions.timeoutInMs,\n          skipParsingBodyAsJson: this._skipParsingBodyAsJson,\n          skipConvertingDate: this._skipConvertingDate,\n        });\n      return deferredMessages;\n    };\n    const config: RetryConfig<ServiceBusReceivedMessage[]> = {\n      operation: receiveDeferredMessagesOperationPromise,\n      connectionId: this._context.connectionId,\n      operationType: RetryOperationType.management,\n      retryOptions: this._retryOptions,\n      abortSignal: options?.abortSignal,\n    };\n    return retry<ServiceBusReceivedMessage[]>(config);\n  }\n\n  async deleteMessages(options: DeleteMessagesOptions): Promise<number> {\n    this._throwIfReceiverOrConnectionClosed();\n\n    const deleteMessagesOperationPromise = (): Promise<number> => {\n      return this._context\n        .getManagementClient(this.entityPath)\n        .deleteMessages(options.maxMessageCount, options?.beforeEnqueueTime, this.sessionId, {\n          ...options,\n          associatedLinkName: this._messageSession.name,\n          requestName: \"deleteMessages\",\n          timeoutInMs: this._retryOptions.timeoutInMs,\n        });\n    };\n    const config: RetryConfig<number> = {\n      operation: deleteMessagesOperationPromise,\n      connectionId: this._context.connectionId,\n      operationType: RetryOperationType.management,\n      retryOptions: this._retryOptions,\n      abortSignal: options?.abortSignal,\n    };\n    return retry<number>(config);\n  }\n\n  async purgeMessages(options?: PurgeMessagesOptions): Promise<number> {\n    let deletedCount = await this.deleteMessages({\n      maxMessageCount: MaxDeleteMessageCount,\n      beforeEnqueueTime: options?.beforeEnqueueTime,\n    });\n    if (deletedCount === MaxDeleteMessageCount) {\n      let batchCount = MaxDeleteMessageCount;\n      while (batchCount === MaxDeleteMessageCount) {\n        batchCount = await this.deleteMessages({\n          maxMessageCount: MaxDeleteMessageCount,\n          beforeEnqueueTime: options?.beforeEnqueueTime,\n        });\n        deletedCount += batchCount;\n      }\n    }\n    return deletedCount;\n  }\n\n  async receiveMessages(\n    maxMessageCount: number,\n    options?: ReceiveMessagesOptions,\n  ): Promise<ServiceBusReceivedMessage[]> {\n    this._throwIfReceiverOrConnectionClosed();\n    this._throwIfAlreadyReceiving();\n    throwTypeErrorIfParameterMissing(\n      this._context.connectionId,\n      \"maxMessageCount\",\n      maxMessageCount,\n    );\n    throwTypeErrorIfParameterTypeMismatch(\n      this._context.connectionId,\n      \"maxMessageCount\",\n      maxMessageCount,\n      \"number\",\n    );\n\n    if (isNaN(maxMessageCount) || maxMessageCount < 1) {\n      throw new TypeError(InvalidMaxMessageCountError);\n    }\n\n    const receiveBatchOperationPromise = async (): Promise<ServiceBusReceivedMessage[]> => {\n      const receivedMessages = await this._messageSession!.receiveMessages(\n        maxMessageCount,\n        options?.maxWaitTimeInMs ?? Constants.defaultOperationTimeoutInMs,\n        defaultMaxTimeAfterFirstMessageForBatchingMs,\n        options ?? {},\n      );\n\n      return receivedMessages;\n    };\n    const config: RetryConfig<ServiceBusReceivedMessage[]> = {\n      operation: receiveBatchOperationPromise,\n      connectionId: this._context.connectionId,\n      operationType: RetryOperationType.receiveMessage,\n      retryOptions: this._retryOptions,\n      abortSignal: options?.abortSignal,\n    };\n    return retry<ServiceBusReceivedMessage[]>(config).catch((err) => {\n      throw translateServiceBusError(err);\n    });\n  }\n\n  subscribe(\n    handlers: MessageHandlers,\n    options?: SubscribeOptions,\n  ): {\n    close(): Promise<void>;\n  } {\n    // TODO - receiverOptions for subscribe??\n    assertValidMessageHandlers(handlers);\n\n    options = options ?? {};\n\n    const processError = wrapProcessErrorHandler(handlers);\n\n    this._registerMessageHandler(\n      async (message: ServiceBusMessageImpl) => {\n        return tracingClient.withSpan(\n          \"SessionReceiver.process\",\n          options ?? {},\n          () => handlers.processMessage(message),\n          toProcessingSpanOptions(message, this, this._context.config, \"process\"),\n        );\n      },\n      processError,\n      options,\n    );\n\n    return {\n      close: async (): Promise<void> => {\n        return this._messageSession?.receiverHelper.suspend();\n      },\n    };\n  }\n\n  /**\n   * Registers handlers to deal with the incoming stream of messages over an AMQP receiver link\n   * from a Queue/Subscription.\n   * To stop receiving messages, call `close()` on the SessionReceiver.\n   *\n   * Throws an error if there is another receive operation in progress on the same receiver. If you\n   * are not sure whether there is another receive operation running, check the `isReceivingMessages`\n   * property on the receiver.\n   *\n   * @param onMessage - Handler for processing each incoming message.\n   * @param onError - Handler for any error that occurs while receiving or processing messages.\n   * @param options - Options to control whether messages should be automatically completed\n   * or if the lock on the session should be automatically renewed. You can control the\n   * maximum number of messages that should be concurrently processed. You can\n   * also provide a timeout in milliseconds to denote the amount of time to wait for a new message\n   * before closing the receiver.\n   *\n   * @throws Error if the underlying connection or receiver is closed.\n   * @throws Error if the receiver is already in state of receiving messages.\n   * @throws `ServiceBusError` if the service returns an error while receiving messages. These are bubbled up to be handled by user provided `onError` handler.\n   */\n  private _registerMessageHandler(\n    onMessage: OnMessage,\n    onError: OnError,\n    options: SubscribeOptions,\n  ): void {\n    this._throwIfReceiverOrConnectionClosed();\n    this._throwIfAlreadyReceiving();\n    const connId = this._context.connectionId;\n    throwTypeErrorIfParameterMissing(connId, \"onMessage\", onMessage);\n    throwTypeErrorIfParameterMissing(connId, \"onError\", onError);\n    if (typeof onMessage !== \"function\") {\n      throw new TypeError(\"The parameter 'onMessage' must be of type 'function'.\");\n    }\n    if (typeof onError !== \"function\") {\n      throw new TypeError(\"The parameter 'onError' must be of type 'function'.\");\n    }\n\n    try {\n      this._messageSession.subscribe(onMessage, onError, options);\n    } catch (err: any) {\n      onError({\n        error: err,\n        errorSource: \"receive\",\n        entityPath: this.entityPath,\n        fullyQualifiedNamespace: this._context.config.host,\n        identifier: this.identifier,\n      });\n    }\n  }\n\n  getMessageIterator(\n    options?: GetMessageIteratorOptions,\n  ): AsyncIterableIterator<ServiceBusReceivedMessage> {\n    return getMessageIterator(this, options);\n  }\n\n  async completeMessage(message: ServiceBusReceivedMessage): Promise<void> {\n    this._throwIfReceiverOrConnectionClosed();\n    throwErrorIfInvalidOperationOnMessage(message, this.receiveMode, this._context.connectionId);\n    const msgImpl = message as ServiceBusMessageImpl;\n    return completeMessage(msgImpl, this._context, this.entityPath, this._retryOptions);\n  }\n\n  async abandonMessage(\n    message: ServiceBusReceivedMessage,\n    propertiesToModify?: { [key: string]: number | boolean | string | Date | null },\n  ): Promise<void> {\n    this._throwIfReceiverOrConnectionClosed();\n    throwErrorIfInvalidOperationOnMessage(message, this.receiveMode, this._context.connectionId);\n    const msgImpl = message as ServiceBusMessageImpl;\n    return abandonMessage(\n      msgImpl,\n      this._context,\n      this.entityPath,\n      propertiesToModify,\n      this._retryOptions,\n    );\n  }\n\n  async deferMessage(\n    message: ServiceBusReceivedMessage,\n    propertiesToModify?: { [key: string]: number | boolean | string | Date | null },\n  ): Promise<void> {\n    this._throwIfReceiverOrConnectionClosed();\n    throwErrorIfInvalidOperationOnMessage(message, this.receiveMode, this._context.connectionId);\n    const msgImpl = message as ServiceBusMessageImpl;\n    return deferMessage(\n      msgImpl,\n      this._context,\n      this.entityPath,\n      propertiesToModify,\n      this._retryOptions,\n    );\n  }\n\n  async deadLetterMessage(\n    message: ServiceBusReceivedMessage,\n    options?: DeadLetterOptions & { [key: string]: number | boolean | string | Date | null },\n  ): Promise<void> {\n    this._throwIfReceiverOrConnectionClosed();\n    throwErrorIfInvalidOperationOnMessage(message, this.receiveMode, this._context.connectionId);\n    const msgImpl = message as ServiceBusMessageImpl;\n    return deadLetterMessage(msgImpl, this._context, this.entityPath, options, this._retryOptions);\n  }\n\n  async renewMessageLock(): Promise<Date> {\n    throw new Error(\"Renewing message lock is an invalid operation when working with sessions.\");\n  }\n\n  async close(): Promise<void> {\n    try {\n      await this._messageSession.close();\n    } catch (err: any) {\n      logger.logError(\n        err,\n        \"%s An error occurred while closing the SessionReceiver for session %s\",\n        this.logPrefix,\n        this.sessionId,\n      );\n      throw err;\n    } finally {\n      this._isClosed = true;\n    }\n  }\n\n  /**\n   * Indicates whether the receiver is currently receiving messages or not.\n   * When this returns true, new `registerMessageHandler()` or `receiveMessages()` calls cannot be made.\n   */\n  private _isReceivingMessages(): boolean {\n    return this._messageSession ? this._messageSession.isReceivingMessages : false;\n  }\n}\n"]}

package/dist/esm/sender.d.ts

@@ -0,0 +1,125 @@
+import type Long from "long";
+import type { ServiceBusMessage } from "./serviceBusMessage.js";
+import type { ConnectionContext } from "./connectionContext.js";
+import type { ServiceBusMessageBatch } from "./serviceBusMessageBatch.js";
+import type { CreateMessageBatchOptions } from "./models.js";
+import type { RetryOptions, AmqpAnnotatedMessage } from "@azure/core-amqp";
+import type { OperationOptionsBase } from "./modelsToBeSharedWithEventHubs.js";
+/**
+ * A Sender can be used to send messages, schedule messages to be sent at a later time
+ * and cancel such scheduled messages.
+ * Use the `createSender` function on the ServiceBusClient to instantiate a Sender.
+ * The Sender class is an abstraction over the underlying AMQP sender link.
+ */
+export interface ServiceBusSender {
+    /**
+     * A name used to identify the sender. This can be used to correlate logs and exceptions.
+     * If not specified or empty, a random unique one will be generated.
+     */
+    identifier: string;
+    /**
+     * Sends the given messages after creating an AMQP Sender link if it doesn't already exist.
+     *
+     * - To send messages to a `session` and/or `partition` enabled Queue/Topic, set the `sessionId`
+     * and/or `partitionKey` properties respectively on the messages.
+     * - All messages passed to the same sendMessages() call should have the same `sessionId` (if using
+     *  sessions) and the same `partitionKey` (if using partitions).
+     *
+     * **Note:**
+     *
+     *    __If you want to send messages of size greater than 1MB, please send individual messages instead of sending a batched message or an array of messages like below.__
+     *
+     *  `await sender.sendMessages(message);`
+     *
+     * __This is because the batched messages are not capable of sending the larger messages yet. You'll hit the `force detached` error in this case otherwise. Read [service-bus-premium-messaging#large-messages-support](https://learn.microsoft.com/azure/service-bus-messaging/service-bus-premium-messaging#large-messages-support). More info at [#23014](https://github.com/Azure/azure-sdk-for-js/pull/23014).__
+     *
+     * @param messages - A single message or an array of messages or a batch of messages created via the createBatch()
+     * method to send.
+     * @param options - Options bag to pass an abort signal or tracing options.
+     * @throws `ServiceBusError` with the code `MessageSizeExceeded` if the provided messages do not fit in a single `ServiceBusMessageBatch`.
+     * @throws Error if the underlying connection, client or sender is closed.
+     * @throws `ServiceBusError` if the service returns an error while sending messages to the service.
+     */
+    sendMessages(messages: ServiceBusMessage | ServiceBusMessage[] | ServiceBusMessageBatch | AmqpAnnotatedMessage | AmqpAnnotatedMessage[], options?: OperationOptionsBase): Promise<void>;
+    /**
+     * Creates an instance of `ServiceBusMessageBatch` to which one can add messages until the maximum supported size is reached.
+     * The batch can be passed to the {@link send} method to send the messages to Azure Service Bus.
+     * @param options - Configures the behavior of the batch.
+     * - `maxSizeInBytes`: The upper limit for the size of batch. The `tryAdd` function will return `false` after this limit is reached.
+     *
+     * @throws `ServiceBusError` if an error is encountered while sending a message.
+     * @throws Error if the underlying connection or sender has been closed.
+     */
+    createMessageBatch(options?: CreateMessageBatchOptions): Promise<ServiceBusMessageBatch>;
+    /**
+     * Returns `true` if either the sender or the client that created it has been closed.
+     * @readonly
+     */
+    isClosed: boolean;
+    /**
+     * Schedules given messages to appear on Service Bus Queue/Subscription at a later time.
+     *
+     * @param messages - Message or an array of messages that need to be scheduled.
+     * @param scheduledEnqueueTimeUtc - The UTC time at which the messages should be enqueued.
+     * @param options - Options bag to pass an abort signal or tracing options.
+     * @returns The sequence numbers of messages that were scheduled.
+     * You will need the sequence number if you intend to cancel the scheduling of the messages.
+     * Save the `Long` type as-is in your application without converting to number. Since JavaScript
+     * only supports 53 bit numbers, converting the `Long` to number will cause loss in precision.
+     * @throws Error if the underlying connection, client or sender is closed.
+     * @throws `ServiceBusError` if the service returns an error while scheduling messages.
+     */
+    scheduleMessages(messages: ServiceBusMessage | ServiceBusMessage[] | AmqpAnnotatedMessage | AmqpAnnotatedMessage[], scheduledEnqueueTimeUtc: Date, options?: OperationOptionsBase): Promise<Long[]>;
+    /**
+     * Cancels multiple messages that were scheduled to appear on a ServiceBus Queue/Subscription.
+     * @param sequenceNumbers - Sequence number or an array of sequence numbers of the messages to be cancelled.
+     * @param options - Options bag to pass an abort signal or tracing options.
+     * @throws Error if the underlying connection, client or sender is closed.
+     * @throws `ServiceBusError` if the service returns an error while canceling scheduled messages.
+     */
+    cancelScheduledMessages(sequenceNumbers: Long | Long[], options?: OperationOptionsBase): Promise<void>;
+    /**
+     * Path of the entity for which the sender has been created.
+     */
+    entityPath: string;
+    /**
+     * Closes the underlying AMQP sender link.
+     * Once closed, the sender cannot be used for any further operations.
+     * Use the `createSender` function on the QueueClient or TopicClient to instantiate a new Sender
+     *
+     */
+    close(): Promise<void>;
+}
+/**
+ * @internal
+ */
+export declare class ServiceBusSenderImpl implements ServiceBusSender {
+    private _context;
+    private _entityPath;
+    identifier: string;
+    private _retryOptions;
+    /**
+     * Denotes if close() was called on this sender
+     */
+    private _isClosed;
+    private _sender;
+    entityPath: string;
+    private get logPrefix();
+    /**
+     * @internal
+     * @throws Error if the underlying connection is closed.
+     */
+    constructor(_context: ConnectionContext, _entityPath: string, retryOptions?: RetryOptions, identifier?: string);
+    private _throwIfSenderOrConnectionClosed;
+    get isClosed(): boolean;
+    sendMessages(messages: ServiceBusMessage | ServiceBusMessage[] | ServiceBusMessageBatch | AmqpAnnotatedMessage | AmqpAnnotatedMessage[], options?: OperationOptionsBase): Promise<void>;
+    createMessageBatch(options?: CreateMessageBatchOptions): Promise<ServiceBusMessageBatch>;
+    scheduleMessages(messages: ServiceBusMessage | ServiceBusMessage[] | AmqpAnnotatedMessage | AmqpAnnotatedMessage[], scheduledEnqueueTimeUtc: Date, options?: OperationOptionsBase): Promise<Long[]>;
+    cancelScheduledMessages(sequenceNumbers: Long | Long[], options?: OperationOptionsBase): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * @internal
+ */
+export declare function isServiceBusMessageBatch(messageBatchOrAnything: unknown): messageBatchOrAnything is ServiceBusMessageBatch;
+//# sourceMappingURL=sender.d.ts.map

package/dist/esm/sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../src/sender.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAUhE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAe,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAQ/E;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YAAY,CACV,QAAQ,EACJ,iBAAiB,GACjB,iBAAiB,EAAE,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,EAAE,EAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;OAQG;IACH,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAczF;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,QAAQ,EACJ,iBAAiB,GACjB,iBAAiB,EAAE,GACnB,oBAAoB,GACpB,oBAAoB,EAAE,EAC1B,uBAAuB,EAAE,IAAI,EAC7B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAEnB;;;;;;OAMG;IACH,uBAAuB,CACrB,eAAe,EAAE,IAAI,GAAG,IAAI,EAAE,EAC9B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAmBzD,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;IAnBd,UAAU,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,aAAa,CAAe;IACpC;;OAEG;IACH,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,OAAO,CAAgB;IACxB,UAAU,EAAE,MAAM,CAAC;IAE1B,OAAO,KAAK,SAAS,GAEpB;IAED;;;OAGG;gBAEO,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,MAAM,EAC3B,YAAY,GAAE,YAAiB,EAC/B,UAAU,CAAC,EAAE,MAAM;IASrB,OAAO,CAAC,gCAAgC;IAUxC,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAEK,YAAY,CAChB,QAAQ,EACJ,iBAAiB,GACjB,iBAAiB,EAAE,GACnB,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,EAAE,EAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAuEV,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAKxF,gBAAgB,CACpB,QAAQ,EACJ,iBAAiB,GACjB,iBAAiB,EAAE,GACnB,oBAAoB,GACpB,oBAAoB,EAAE,EAC1B,uBAAuB,EAAE,IAAI,EAC7B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,EAAE,CAAC;IAwCZ,uBAAuB,CAC3B,eAAe,EAAE,IAAI,GAAG,IAAI,EAAE,EAC9B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC;IAmDV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,sBAAsB,EAAE,OAAO,GAC9B,sBAAsB,IAAI,sBAAsB,CAYlD"}