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

package/dist/react-native/receivers/receiverCommon.js

@@ -0,0 +1,257 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { logger, receiverLogger } from "../log.js";
+import { translateServiceBusError } from "../serviceBusError.js";
+import { DispositionType } from "../serviceBusMessage.js";
+import { Constants, ErrorNameConditionMapper, retry, RetryMode, RetryOperationType, } from "@azure/core-amqp";
+import { MessageAlreadySettled } from "../util/errors.js";
+import { delay, isDefined } from "@azure/core-util";
+import { toSpanOptions, tracingClient } from "../diagnostics/tracing.js";
+import { extractSpanContextFromServiceBusMessage } from "../diagnostics/instrumentServiceBusMessage.js";
+/**
+ * @internal
+ */
+export function assertValidMessageHandlers(handlers) {
+    if (handlers &&
+        handlers.processMessage instanceof Function &&
+        handlers.processError instanceof Function) {
+        return;
+    }
+    throw new TypeError('Invalid "MessageHandlers" provided.');
+}
+/**
+ * @internal
+ */
+export async function* getMessageIterator(receiver, options) {
+    while (true) {
+        const messages = await receiver.receiveMessages(1, options);
+        if (messages.length === 0) {
+            continue;
+        }
+        yield messages[0];
+    }
+}
+/**
+ * @internal
+ */
+export function wrapProcessErrorHandler(handlers, loggerParam = receiverLogger) {
+    return async (args) => {
+        try {
+            args.error = translateServiceBusError(args.error);
+            await handlers.processError(args);
+        }
+        catch (err) {
+            loggerParam.logError(err, `An error was thrown from the user's processError handler`);
+        }
+    };
+}
+/**
+ * @internal
+ *
+ */
+export function completeMessage(message, context, entityPath, retryOptions) {
+    receiverLogger.verbose("[%s] Completing the message with id '%s'.", context.connectionId, message.messageId);
+    const tracingContext = extractSpanContextFromServiceBusMessage(message);
+    const spanLinks = tracingContext ? [{ tracingContext }] : [];
+    return tracingClient.withSpan("ServicebusReceiver.complete", {}, () => settleMessage(message, DispositionType.complete, context, entityPath, {
+        retryOptions,
+    }), {
+        spanLinks,
+        ...toSpanOptions({ entityPath, host: context.config.host }, "settle", "client"),
+    });
+}
+/**
+ * @internal
+ *
+ */
+export function abandonMessage(message, context, entityPath, propertiesToModify, retryOptions) {
+    receiverLogger.verbose("[%s] Abandoning the message with id '%s'.", context.connectionId, message.messageId);
+    const tracingContext = extractSpanContextFromServiceBusMessage(message);
+    const spanLinks = tracingContext ? [{ tracingContext }] : [];
+    return tracingClient.withSpan("ServicebusReceiver.abandon", {}, () => settleMessage(message, DispositionType.abandon, context, entityPath, {
+        propertiesToModify,
+        retryOptions,
+    }), {
+        spanLinks,
+        ...toSpanOptions({ entityPath, host: context.config.host }, "settle", "client"),
+    });
+}
+/**
+ * @internal
+ *
+ */
+export function deferMessage(message, context, entityPath, propertiesToModify, retryOptions) {
+    receiverLogger.verbose("[%s] Deferring the message with id '%s'.", context.connectionId, message.messageId);
+    const tracingContext = extractSpanContextFromServiceBusMessage(message);
+    const spanLinks = tracingContext ? [{ tracingContext }] : [];
+    return tracingClient.withSpan("ServiceBusReceiver.defer", {}, () => settleMessage(message, DispositionType.defer, context, entityPath, {
+        retryOptions,
+        propertiesToModify,
+    }), {
+        spanLinks,
+        ...toSpanOptions({ entityPath, host: context.config.host }, "settle", "client"),
+    });
+}
+/**
+ * @internal
+ *
+ */
+export function deadLetterMessage(message, context, entityPath, propertiesToModify, retryOptions) {
+    receiverLogger.verbose("[%s] Deadlettering the message with id '%s'.", context.connectionId, message.messageId);
+    const actualPropertiesToModify = {
+        ...propertiesToModify,
+    };
+    // these two fields are handled specially and don't need to be in here.
+    delete actualPropertiesToModify.deadLetterErrorDescription;
+    delete actualPropertiesToModify.deadLetterReason;
+    const dispositionStatusOptions = {
+        propertiesToModify: actualPropertiesToModify,
+        deadLetterReason: propertiesToModify?.deadLetterReason,
+        deadLetterDescription: propertiesToModify?.deadLetterErrorDescription,
+        retryOptions,
+    };
+    const tracingContext = extractSpanContextFromServiceBusMessage(message);
+    const spanLinks = tracingContext ? [{ tracingContext }] : [];
+    return tracingClient.withSpan("ServiceBusReceiver.deadLetter", {}, () => settleMessage(message, DispositionType.deadletter, context, entityPath, dispositionStatusOptions), {
+        spanLinks,
+        ...toSpanOptions({ entityPath, host: context.config.host }, "settle", "client"),
+    });
+}
+/**
+ * @internal
+ */
+export function settleMessage(message, operation, context, entityPath, options, _settleMessageOperation = settleMessageOperation) {
+    return retry({
+        connectionId: context.connectionId,
+        operation: () => {
+            return _settleMessageOperation(message, operation, context, entityPath, options);
+        },
+        operationType: RetryOperationType.messageSettlement,
+        abortSignal: options?.abortSignal,
+        retryOptions: options?.retryOptions,
+    });
+}
+/**
+ * @internal
+ *
+ * NOTE: it's tempting to make this method non-async. However, doing so makes it too easy
+ * to throw exceptions that will not be "catchable" by people chaining to the returned Promise
+ * since we can throw exceptions outside of the Promise's scope.
+ */
+export async function settleMessageOperation(message, operation, context, entityPath, options) {
+    const isDeferredMessage = !message.delivery.link;
+    const receiver = isDeferredMessage
+        ? undefined
+        : context.getReceiverFromCache(message.delivery.link.name, message.sessionId);
+    const associatedLinkName = receiver?.name;
+    let error;
+    if (message.delivery.remote_settled) {
+        error = new Error(MessageAlreadySettled);
+    }
+    else if (!isDeferredMessage &&
+        (!receiver || !receiver.isOpen()) &&
+        isDefined(message.sessionId)) {
+        error = translateServiceBusError({
+            description: `Failed to ${operation} the message as the AMQP link with which the message was ` +
+                `received is no longer alive.`,
+            condition: ErrorNameConditionMapper.SessionLockLostError,
+        });
+    }
+    if (error) {
+        receiverLogger.logError(error, "[%s] An error occurred when settling a message with id '%s'", context.connectionId, message.messageId);
+        throw error;
+    }
+    // Message Settlement with managementLink
+    // 1. If the received message is deferred as such messages can only be settled using managementLink
+    // 2. If the associated receiver link is not available. This does not apply to messages from sessions as we need a lock on the session to do so.
+    if (isDeferredMessage || ((!receiver || !receiver.isOpen()) && !isDefined(message.sessionId))) {
+        return context
+            .getManagementClient(entityPath)
+            .updateDispositionStatus(message.lockToken, operation, {
+            ...options,
+            associatedLinkName,
+            sessionId: message.sessionId,
+        })
+            .catch((err) => {
+            throw translateServiceBusError(err);
+        });
+    }
+    return receiver.settleMessage(message, operation, options).catch((err) => {
+        throw translateServiceBusError(err);
+    });
+}
+/**
+ * Calculates delay between retries, in milliseconds.
+ */
+function calculateDelay(attemptCount, retryDelayInMs, maxRetryDelayInMs, mode) {
+    if (mode === RetryMode.Exponential) {
+        const boundedRandDelta = retryDelayInMs * 0.8 +
+            Math.floor(Math.random() * (retryDelayInMs * 1.2 - retryDelayInMs * 0.8));
+        const incrementDelta = boundedRandDelta * (Math.pow(2, attemptCount) - 1);
+        return Math.min(incrementDelta, maxRetryDelayInMs);
+    }
+    return retryDelayInMs;
+}
+/**
+ * Retry infinitely until success, reporting in between retry attempts.
+ *
+ * This function will only stop retrying if:
+ * - args.retryConfig.operation resolves successfully
+ * - args.retryConfig.operation rejects with an `AbortError`
+ *
+ * @internal
+ */
+export async function retryForever(args, retryFn = retry) {
+    let numRetryCycles = 0;
+    const config = args.retryConfig;
+    if (!config.retryOptions) {
+        config.retryOptions = {};
+    }
+    // eslint-disable-next-line eqeqeq
+    if (config.retryOptions.retryDelayInMs == undefined || config.retryOptions.retryDelayInMs < 0) {
+        config.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;
+    }
+    if (
+    // eslint-disable-next-line eqeqeq
+    config.retryOptions.maxRetryDelayInMs == undefined ||
+        config.retryOptions.maxRetryDelayInMs < 0) {
+        config.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;
+    }
+    if (!config.retryOptions.mode) {
+        config.retryOptions.mode = RetryMode.Fixed;
+    }
+    // The retries are broken up into cycles, giving the user some control over how often
+    // we actually attempt to retry.
+    while (true) {
+        ++numRetryCycles;
+        try {
+            return await retryFn(args.retryConfig);
+        }
+        catch (err) {
+            // if the user aborts the operation we're immediately done.
+            // AbortError is also thrown by linkEntity.init() if the connection has been
+            // permanently closed.
+            if (err.name === "AbortError") {
+                logger.warning(`${args.logPrefix} AbortError caught, ending retries.`);
+                throw err;
+            }
+            // we only report the error here - this avoids spamming the user with too many
+            // redundant reports of errors while still providing them incremental status on failures.
+            try {
+                args.onError(err);
+            }
+            catch (error) {
+                logger.error("args.onerror has thrown", error);
+            }
+            args.logger.logError(err, `${args.logPrefix} Error thrown in retry cycle ${numRetryCycles}, restarting retry cycle with retry options`, args.retryConfig);
+            const delayInMs = calculateDelay(numRetryCycles, config.retryOptions.retryDelayInMs, config.retryOptions.maxRetryDelayInMs, config.retryOptions.mode);
+            logger.verbose("[%s] Sleeping for %d milliseconds for '%s'.", config.connectionId, delayInMs, config.operationType);
+            await delay(delayInMs, {
+                abortSignal: config.abortSignal,
+                abortErrorMsg: "Retry cycle has been cancelled by the user.",
+            });
+            continue;
+        }
+    }
+}
+//# sourceMappingURL=receiverCommon.js.map

package/dist/react-native/receivers/receiverCommon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiverCommon.js","sourceRoot":"","sources":["../../../src/receivers/receiverCommon.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { MessageHandlers, ProcessErrorArgs } from \"../models.js\";\nimport type { ServiceBusReceiver } from \"./receiver.js\";\nimport type { OperationOptionsBase } from \"../modelsToBeSharedWithEventHubs.js\";\nimport type { createServiceBusLogger, ServiceBusLogger } from \"../log.js\";\nimport { logger, receiverLogger } from \"../log.js\";\nimport { translateServiceBusError } from \"../serviceBusError.js\";\nimport type {\n  DeadLetterOptions,\n  ServiceBusMessageImpl,\n  ServiceBusReceivedMessage,\n} from \"../serviceBusMessage.js\";\nimport { DispositionType } from \"../serviceBusMessage.js\";\nimport type { DispositionStatusOptions } from \"../core/managementClient.js\";\nimport type { ConnectionContext } from \"../connectionContext.js\";\nimport type { RetryConfig, RetryOptions } from \"@azure/core-amqp\";\nimport {\n  Constants,\n  ErrorNameConditionMapper,\n  retry,\n  RetryMode,\n  RetryOperationType,\n} from \"@azure/core-amqp\";\nimport { MessageAlreadySettled } from \"../util/errors.js\";\nimport { delay, isDefined } from \"@azure/core-util\";\nimport type { TracingSpanLink } from \"@azure/core-tracing\";\nimport { toSpanOptions, tracingClient } from \"../diagnostics/tracing.js\";\nimport { extractSpanContextFromServiceBusMessage } from \"../diagnostics/instrumentServiceBusMessage.js\";\n\n/**\n * @internal\n */\nexport function assertValidMessageHandlers(handlers: {\n  processMessage?: unknown;\n  processError?: unknown;\n}): void {\n  if (\n    handlers &&\n    handlers.processMessage instanceof Function &&\n    handlers.processError instanceof Function\n  ) {\n    return;\n  }\n\n  throw new TypeError('Invalid \"MessageHandlers\" provided.');\n}\n\n/**\n * @internal\n */\nexport async function* getMessageIterator(\n  receiver: Pick<ServiceBusReceiver, \"receiveMessages\">,\n  options?: OperationOptionsBase,\n): AsyncIterableIterator<ServiceBusReceivedMessage> {\n  while (true) {\n    const messages = await receiver.receiveMessages(1, options);\n\n    if (messages.length === 0) {\n      continue;\n    }\n\n    yield messages[0];\n  }\n}\n\n/**\n * @internal\n */\nexport function wrapProcessErrorHandler(\n  handlers: Pick<MessageHandlers, \"processError\">,\n  loggerParam: ServiceBusLogger = receiverLogger,\n): MessageHandlers[\"processError\"] {\n  return async (args: ProcessErrorArgs) => {\n    try {\n      args.error = translateServiceBusError(args.error);\n      await handlers.processError(args);\n    } catch (err: any) {\n      loggerParam.logError(err, `An error was thrown from the user's processError handler`);\n    }\n  };\n}\n\n/**\n * @internal\n *\n */\nexport function completeMessage(\n  message: ServiceBusMessageImpl,\n  context: ConnectionContext,\n  entityPath: string,\n  retryOptions: RetryOptions | undefined,\n): Promise<void> {\n  receiverLogger.verbose(\n    \"[%s] Completing the message with id '%s'.\",\n    context.connectionId,\n    message.messageId,\n  );\n  const tracingContext = extractSpanContextFromServiceBusMessage(message);\n  const spanLinks: TracingSpanLink[] = tracingContext ? [{ tracingContext }] : [];\n  return tracingClient.withSpan(\n    \"ServicebusReceiver.complete\",\n    {},\n    () =>\n      settleMessage(message, DispositionType.complete, context, entityPath, {\n        retryOptions,\n      }),\n    {\n      spanLinks,\n      ...toSpanOptions({ entityPath, host: context.config.host }, \"settle\", \"client\"),\n    },\n  );\n}\n\n/**\n * @internal\n *\n */\nexport function abandonMessage(\n  message: ServiceBusMessageImpl,\n  context: ConnectionContext,\n  entityPath: string,\n  propertiesToModify: { [key: string]: number | boolean | string | Date | null } | undefined,\n  retryOptions: RetryOptions | undefined,\n): Promise<void> {\n  receiverLogger.verbose(\n    \"[%s] Abandoning the message with id '%s'.\",\n    context.connectionId,\n    message.messageId,\n  );\n  const tracingContext = extractSpanContextFromServiceBusMessage(message);\n  const spanLinks: TracingSpanLink[] = tracingContext ? [{ tracingContext }] : [];\n  return tracingClient.withSpan(\n    \"ServicebusReceiver.abandon\",\n    {},\n    () =>\n      settleMessage(message, DispositionType.abandon, context, entityPath, {\n        propertiesToModify,\n        retryOptions,\n      }),\n    {\n      spanLinks,\n      ...toSpanOptions({ entityPath, host: context.config.host }, \"settle\", \"client\"),\n    },\n  );\n}\n\n/**\n * @internal\n *\n */\nexport function deferMessage(\n  message: ServiceBusMessageImpl,\n  context: ConnectionContext,\n  entityPath: string,\n  propertiesToModify: { [key: string]: number | boolean | string | Date | null } | undefined,\n  retryOptions: RetryOptions | undefined,\n): Promise<void> {\n  receiverLogger.verbose(\n    \"[%s] Deferring the message with id '%s'.\",\n    context.connectionId,\n    message.messageId,\n  );\n  const tracingContext = extractSpanContextFromServiceBusMessage(message);\n  const spanLinks: TracingSpanLink[] = tracingContext ? [{ tracingContext }] : [];\n  return tracingClient.withSpan(\n    \"ServiceBusReceiver.defer\",\n    {},\n    () =>\n      settleMessage(message, DispositionType.defer, context, entityPath, {\n        retryOptions,\n        propertiesToModify,\n      }),\n    {\n      spanLinks,\n      ...toSpanOptions({ entityPath, host: context.config.host }, \"settle\", \"client\"),\n    },\n  );\n}\n\n/**\n * @internal\n *\n */\nexport function deadLetterMessage(\n  message: ServiceBusMessageImpl,\n  context: ConnectionContext,\n  entityPath: string,\n  propertiesToModify:\n    | (DeadLetterOptions & { [key: string]: number | boolean | string | Date | null })\n    | undefined,\n  retryOptions: RetryOptions | undefined,\n): Promise<void> {\n  receiverLogger.verbose(\n    \"[%s] Deadlettering the message with id '%s'.\",\n    context.connectionId,\n    message.messageId,\n  );\n\n  const actualPropertiesToModify: Partial<DeadLetterOptions> = {\n    ...propertiesToModify,\n  };\n\n  // these two fields are handled specially and don't need to be in here.\n  delete actualPropertiesToModify.deadLetterErrorDescription;\n  delete actualPropertiesToModify.deadLetterReason;\n\n  const dispositionStatusOptions: DispositionStatusOptions = {\n    propertiesToModify: actualPropertiesToModify,\n    deadLetterReason: propertiesToModify?.deadLetterReason,\n    deadLetterDescription: propertiesToModify?.deadLetterErrorDescription,\n    retryOptions,\n  };\n\n  const tracingContext = extractSpanContextFromServiceBusMessage(message);\n  const spanLinks: TracingSpanLink[] = tracingContext ? [{ tracingContext }] : [];\n\n  return tracingClient.withSpan(\n    \"ServiceBusReceiver.deadLetter\",\n    {},\n    () =>\n      settleMessage(\n        message,\n        DispositionType.deadletter,\n        context,\n        entityPath,\n        dispositionStatusOptions,\n      ),\n    {\n      spanLinks,\n      ...toSpanOptions({ entityPath, host: context.config.host }, \"settle\", \"client\"),\n    },\n  );\n}\n\n/**\n * @internal\n */\nexport function settleMessage(\n  message: ServiceBusMessageImpl,\n  operation: DispositionType,\n  context: ConnectionContext,\n  entityPath: string,\n  options: DispositionStatusOptions,\n  _settleMessageOperation: typeof settleMessageOperation = settleMessageOperation,\n): Promise<void> {\n  return retry({\n    connectionId: context.connectionId,\n    operation: () => {\n      return _settleMessageOperation(message, operation, context, entityPath, options);\n    },\n    operationType: RetryOperationType.messageSettlement,\n    abortSignal: options?.abortSignal,\n    retryOptions: options?.retryOptions,\n  });\n}\n\n/**\n * @internal\n *\n * NOTE: it's tempting to make this method non-async. However, doing so makes it too easy\n * to throw exceptions that will not be \"catchable\" by people chaining to the returned Promise\n * since we can throw exceptions outside of the Promise's scope.\n */\nexport async function settleMessageOperation(\n  message: ServiceBusMessageImpl,\n  operation: DispositionType,\n  context: ConnectionContext,\n  entityPath: string,\n  options: DispositionStatusOptions,\n): Promise<void> {\n  const isDeferredMessage = !message.delivery.link;\n  const receiver = isDeferredMessage\n    ? undefined\n    : context.getReceiverFromCache(message.delivery.link.name, message.sessionId);\n  const associatedLinkName = receiver?.name;\n\n  let error: Error | undefined;\n  if (message.delivery.remote_settled) {\n    error = new Error(MessageAlreadySettled);\n  } else if (\n    !isDeferredMessage &&\n    (!receiver || !receiver.isOpen()) &&\n    isDefined(message.sessionId)\n  ) {\n    error = translateServiceBusError({\n      description:\n        `Failed to ${operation} the message as the AMQP link with which the message was ` +\n        `received is no longer alive.`,\n      condition: ErrorNameConditionMapper.SessionLockLostError,\n    });\n  }\n\n  if (error) {\n    receiverLogger.logError(\n      error,\n      \"[%s] An error occurred when settling a message with id '%s'\",\n      context.connectionId,\n      message.messageId,\n    );\n    throw error;\n  }\n\n  // Message Settlement with managementLink\n  // 1. If the received message is deferred as such messages can only be settled using managementLink\n  // 2. If the associated receiver link is not available. This does not apply to messages from sessions as we need a lock on the session to do so.\n  if (isDeferredMessage || ((!receiver || !receiver.isOpen()) && !isDefined(message.sessionId))) {\n    return context\n      .getManagementClient(entityPath)\n      .updateDispositionStatus(message.lockToken!, operation, {\n        ...options,\n        associatedLinkName,\n        sessionId: message.sessionId,\n      })\n      .catch((err) => {\n        throw translateServiceBusError(err);\n      });\n  }\n\n  return receiver!.settleMessage(message, operation, options).catch((err) => {\n    throw translateServiceBusError(err);\n  });\n}\n\n/** @internal */\nexport interface RetryForeverArgs<T> {\n  retryConfig: RetryConfig<T>;\n  onError: (err: Error) => void;\n  logger: ReturnType<typeof createServiceBusLogger>;\n  logPrefix: string;\n}\n\n/**\n * Calculates delay between retries, in milliseconds.\n */\nfunction calculateDelay(\n  attemptCount: number,\n  retryDelayInMs: number,\n  maxRetryDelayInMs: number,\n  mode: RetryMode,\n): number {\n  if (mode === RetryMode.Exponential) {\n    const boundedRandDelta =\n      retryDelayInMs * 0.8 +\n      Math.floor(Math.random() * (retryDelayInMs * 1.2 - retryDelayInMs * 0.8));\n\n    const incrementDelta = boundedRandDelta * (Math.pow(2, attemptCount) - 1);\n    return Math.min(incrementDelta, maxRetryDelayInMs);\n  }\n\n  return retryDelayInMs;\n}\n\n/**\n * Retry infinitely until success, reporting in between retry attempts.\n *\n * This function will only stop retrying if:\n * - args.retryConfig.operation resolves successfully\n * - args.retryConfig.operation rejects with an `AbortError`\n *\n * @internal\n */\nexport async function retryForever<T>(\n  args: RetryForeverArgs<T>,\n  retryFn: typeof retry = retry,\n): Promise<T> {\n  let numRetryCycles = 0;\n  const config = args.retryConfig;\n  if (!config.retryOptions) {\n    config.retryOptions = {};\n  }\n  // eslint-disable-next-line eqeqeq\n  if (config.retryOptions.retryDelayInMs == undefined || config.retryOptions.retryDelayInMs < 0) {\n    config.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;\n  }\n  if (\n    // eslint-disable-next-line eqeqeq\n    config.retryOptions.maxRetryDelayInMs == undefined ||\n    config.retryOptions.maxRetryDelayInMs < 0\n  ) {\n    config.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;\n  }\n  if (!config.retryOptions.mode) {\n    config.retryOptions.mode = RetryMode.Fixed;\n  }\n\n  // The retries are broken up into cycles, giving the user some control over how often\n  // we actually attempt to retry.\n  while (true) {\n    ++numRetryCycles;\n\n    try {\n      return await retryFn(args.retryConfig);\n    } catch (err: any) {\n      // if the user aborts the operation we're immediately done.\n      // AbortError is also thrown by linkEntity.init() if the connection has been\n      // permanently closed.\n      if (err.name === \"AbortError\") {\n        logger.warning(`${args.logPrefix} AbortError caught, ending retries.`);\n        throw err;\n      }\n\n      // we only report the error here - this avoids spamming the user with too many\n      // redundant reports of errors while still providing them incremental status on failures.\n      try {\n        args.onError(err);\n      } catch (error: any) {\n        logger.error(\"args.onerror has thrown\", error);\n      }\n\n      args.logger.logError(\n        err,\n        `${args.logPrefix} Error thrown in retry cycle ${numRetryCycles}, restarting retry cycle with retry options`,\n        args.retryConfig,\n      );\n\n      const delayInMs = calculateDelay(\n        numRetryCycles,\n        config.retryOptions.retryDelayInMs,\n        config.retryOptions.maxRetryDelayInMs,\n        config.retryOptions.mode,\n      );\n      logger.verbose(\n        \"[%s] Sleeping for %d milliseconds for '%s'.\",\n        config.connectionId,\n        delayInMs,\n        config.operationType,\n      );\n      await delay(delayInMs, {\n        abortSignal: config.abortSignal,\n        abortErrorMsg: \"Retry cycle has been cancelled by the user.\",\n      });\n\n      continue;\n    }\n  }\n}\n"]}

package/dist/react-native/receivers/sessionReceiver.d.ts

@@ -0,0 +1,189 @@
+import type { ConnectionContext } from "../connectionContext.js";
+import type { MessageHandlers, ReceiveMessagesOptions, ServiceBusReceivedMessage } from "../index.js";
+import type { PeekMessagesOptions, GetMessageIteratorOptions, SubscribeOptions, DeleteMessagesOptions, PurgeMessagesOptions } from "../models.js";
+import type { MessageSession } from "../session/messageSession.js";
+import type { ServiceBusReceiver } from "./receiver.js";
+import type Long from "long";
+import type { DeadLetterOptions } from "../serviceBusMessage.js";
+import type { RetryOptions } from "@azure/core-amqp";
+import type { OperationOptionsBase } from "../modelsToBeSharedWithEventHubs.js";
+/**
+ *A receiver that handles sessions, including renewing the session lock.
+ */
+export interface ServiceBusSessionReceiver extends ServiceBusReceiver {
+    /**
+     * The session ID.
+     */
+    readonly sessionId: string;
+    /**
+     * 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.
+     *
+     * Will return undefined until a AMQP receiver link has been successfully set up for the session.
+     *
+     * @readonly
+     */
+    readonly sessionLockedUntilUtc: Date;
+    /**
+     * Streams messages to message handlers.
+     * @param handlers - A handler that gets called for messages and errors.
+     * @param options - Options for subscribe.
+     * @returns An object that can be closed, sending any remaining messages to `handlers` and
+     * stopping new messages from arriving.
+     */
+    subscribe(handlers: MessageHandlers, options?: SubscribeOptions): {
+        /**
+         * Causes the subscriber to stop receiving new messages.
+         */
+        close(): Promise<void>;
+    };
+    /**
+     * Renews the lock on the session.
+     */
+    renewSessionLock(options?: OperationOptionsBase): Promise<Date>;
+    /**
+     * 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.
+     */
+    getSessionState(options?: OperationOptionsBase): Promise<any>;
+    /**
+     * 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.
+     *
+     */
+    setSessionState(state: any, options?: OperationOptionsBase): Promise<void>;
+}
+/**
+ * @internal
+ */
+export declare class ServiceBusSessionReceiverImpl implements ServiceBusSessionReceiver {
+    private _messageSession;
+    private _context;
+    entityPath: string;
+    receiveMode: "peekLock" | "receiveAndDelete";
+    private _skipParsingBodyAsJson;
+    private _skipConvertingDate;
+    private _retryOptions;
+    sessionId: string;
+    identifier: string;
+    /**
+     * Denotes if close() was called on this receiver
+     */
+    private _isClosed;
+    private get logPrefix();
+    /**
+     * @internal
+     * @throws Error if the underlying connection is closed.
+     * @throws Error if an open receiver is already existing for given sessionId.
+     */
+    constructor(_messageSession: MessageSession, _context: ConnectionContext, entityPath: string, receiveMode: "peekLock" | "receiveAndDelete", _skipParsingBodyAsJson: boolean, _skipConvertingDate: boolean, _retryOptions?: RetryOptions);
+    private _throwIfReceiverOrConnectionClosed;
+    private _throwIfAlreadyReceiving;
+    get isClosed(): boolean;
+    /**
+     * 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(): Date;
+    /**
+     * 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.
+     */
+    renewSessionLock(options?: OperationOptionsBase): Promise<Date>;
+    /**
+     * 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.
+     */
+    setSessionState(state: unknown, options?: OperationOptionsBase): Promise<void>;
+    /**
+     * 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.
+     */
+    getSessionState(options?: OperationOptionsBase): Promise<any>;
+    peekMessages(maxMessageCount: number, options?: PeekMessagesOptions): Promise<ServiceBusReceivedMessage[]>;
+    receiveDeferredMessages(sequenceNumbers: Long | Long[], options?: OperationOptionsBase): Promise<ServiceBusReceivedMessage[]>;
+    deleteMessages(options: DeleteMessagesOptions): Promise<number>;
+    purgeMessages(options?: PurgeMessagesOptions): Promise<number>;
+    receiveMessages(maxMessageCount: number, options?: ReceiveMessagesOptions): Promise<ServiceBusReceivedMessage[]>;
+    subscribe(handlers: MessageHandlers, options?: SubscribeOptions): {
+        close(): Promise<void>;
+    };
+    /**
+     * 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.
+     */
+    private _registerMessageHandler;
+    getMessageIterator(options?: GetMessageIteratorOptions): AsyncIterableIterator<ServiceBusReceivedMessage>;
+    completeMessage(message: ServiceBusReceivedMessage): Promise<void>;
+    abandonMessage(message: ServiceBusReceivedMessage, propertiesToModify?: {
+        [key: string]: number | boolean | string | Date | null;
+    }): Promise<void>;
+    deferMessage(message: ServiceBusReceivedMessage, propertiesToModify?: {
+        [key: string]: number | boolean | string | Date | null;
+    }): Promise<void>;
+    deadLetterMessage(message: ServiceBusReceivedMessage, options?: DeadLetterOptions & {
+        [key: string]: number | boolean | string | Date | null;
+    }): Promise<void>;
+    renewMessageLock(): Promise<Date>;
+    close(): Promise<void>;
+    /**
+     * Indicates whether the receiver is currently receiving messages or not.
+     * When this returns true, new `registerMessageHandler()` or `receiveMessages()` calls cannot be made.
+     */
+    private _isReceivingMessages;
+}
+//# sourceMappingURL=sessionReceiver.d.ts.map

package/dist/react-native/receivers/sessionReceiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionReceiver.d.ts","sourceRoot":"","sources":["../../../src/receivers/sessionReceiver.ts"],"names":[],"mappings":"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"}