@azure/core-amqp 4.3.5-alpha.20250130.1 → 4.3.5-alpha.20250131.1

package/dist/browser/retry.js

@@ -154,17 +154,10 @@ export async function retry(config) {
         return result;
     }
     else {
-        throw compileErrors(errors);
-    }
-}
-function compileErrors(errors) {
-    if (!errors.length) {
-        throw new RangeError("Error array is empty");
+        if (errors.length === 1) {
+            throw errors[0];
+        }
+        throw new AggregateError(errors);
     }
-    let i = 0;
-    const str = errors.map((error) => `Error ${i++}: ${error}`).join("\n\n");
-    const lastError = errors[errors.length - 1];
-    lastError.message = str;
-    return lastError;
 }
 //# sourceMappingURL=retry.js.map

package/dist/browser/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n/* eslint-disable eqeqeq */\n\nimport type { MessagingError } from \"./errors.js\";\nimport { translate } from \"./errors.js\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { Constants } from \"./util/constants.js\";\nimport { checkNetworkConnection } from \"./util/checkNetworkConnection.js\";\nimport { delay } from \"@azure/core-util\";\nimport { logger } from \"./log.js\";\n\n/**\n * Determines whether the object is a Delivery object.\n * @internal\n */\nfunction isDelivery(obj: any): boolean {\n  let result: boolean = false;\n  if (\n    obj &&\n    typeof obj.id === \"number\" &&\n    typeof obj.settled === \"boolean\" &&\n    typeof obj.remote_settled === \"boolean\" &&\n    typeof obj.format === \"number\"\n  ) {\n    result = true;\n  }\n  return result;\n}\n\n/**\n * Describes the Retry Mode type\n */\nexport enum RetryMode {\n  Exponential,\n  Fixed,\n}\n\n/**\n * Describes the retry operation type.\n */\nexport enum RetryOperationType {\n  cbsAuth = \"cbsAuth\",\n  connection = \"connection\",\n  management = \"management\",\n  receiverLink = \"receiverLink\",\n  senderLink = \"senderLink\",\n  sendMessage = \"sendMessage\",\n  receiveMessage = \"receiveMessage\",\n  session = \"session\",\n  messageSettlement = \"settlement\",\n}\n\n/**\n * Retry policy options that determine the mode, number of retries, retry interval etc.\n */\nexport interface RetryOptions {\n  /**\n   * Number of times the operation needs to be retried in case\n   * of retryable error. Default: 3.\n   */\n  maxRetries?: number;\n  /**\n   * Amount of time to wait in milliseconds before making the\n   * next attempt. Default: `30000 milliseconds`.\n   * When `mode` option is set to `Exponential`,\n   * this is used to compute the exponentially increasing delays between retries.\n   */\n  retryDelayInMs?: number;\n  /**\n   * Number of milliseconds to wait before declaring that current attempt has timed out which will trigger a retry\n   * A minimum value of `60000` milliseconds will be used if a value not greater than this is provided.\n   */\n  timeoutInMs?: number;\n  /**\n   * Denotes which retry mode to apply. If undefined, defaults to `Fixed`\n   */\n  mode?: RetryMode;\n  /**\n   * Denotes the maximum delay between retries\n   * that the retry attempts will be capped at. Applicable only when performing exponential retry.\n   */\n  maxRetryDelayInMs?: number;\n}\n\n/**\n * Describes the parameters that need to be configured for the retry operation.\n */\nexport interface RetryConfig<T> {\n  /**\n   * The operation that needs to be retried.\n   */\n  operation: () => Promise<T>;\n  /**\n   * The connection identifier. Used in logging information.\n   * Extremely useful when multiple connections are logged in the same file.\n   */\n  connectionId: string;\n  /**\n   * The name/type of operation to be performed.\n   * Extremely useful in providing better debug logs.\n   */\n  operationType: RetryOperationType;\n  /**\n   * The host \"<yournamespace>.servicebus.windows.net\".\n   * Used to check network connectivity.\n   */\n  connectionHost?: string;\n  /**\n   * The retry related options associated with given operation execution.\n   */\n  retryOptions?: RetryOptions;\n  /**\n   * The `AbortSignal` associated with the operation being retried on.\n   * If this signal is fired during the wait time between retries, then the `retry()` method will ensure that the wait is abandoned and the retry process gets cancelled. If this signal is fired when the operation is in progress, then the operation is expected to react to it.\n   */\n  abortSignal?: AbortSignalLike;\n}\n\n/**\n * Validates the retry config.\n * @internal\n */\nfunction validateRetryConfig<T>(config: RetryConfig<T>): void {\n  if (!config.operation) {\n    throw new TypeError(\"Missing 'operation' in retry configuration\");\n  }\n\n  if (!config.connectionId) {\n    throw new TypeError(\"Missing 'connectionId' in retry configuration\");\n  }\n\n  if (!config.operationType) {\n    throw new TypeError(\"Missing 'operationType' in retry configuration\");\n  }\n}\n\n/**\n * Calculates delay between retries, in milliseconds.\n * @internal\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 * Every operation is attempted at least once. Additional attempts are made if the previous attempt failed\n * with a retryable error. The number of additional attempts is governed by the `maxRetries` property provided\n * on the `RetryConfig` argument.\n *\n * If `mode` option is set to `Fixed`, then the retries are made on the\n * given operation for a specified number of times, with a fixed delay in between each retry each time.\n *\n * If `mode` option is set to `Exponential`, then the delay between retries is adjusted to increase\n * exponentially with each attempt using back-off factor of power 2.\n *\n * @param config - Parameters to configure retry operation\n *\n * @returns Promise<T>.\n */\nexport async function retry<T>(config: RetryConfig<T>): Promise<T> {\n  validateRetryConfig(config);\n  const updatedConfig = { ...config };\n  if (!updatedConfig.retryOptions) {\n    updatedConfig.retryOptions = {};\n  }\n  if (\n    updatedConfig.retryOptions.maxRetries == undefined ||\n    updatedConfig.retryOptions.maxRetries < 0\n  ) {\n    updatedConfig.retryOptions.maxRetries = Constants.defaultMaxRetries;\n  }\n  if (\n    updatedConfig.retryOptions.retryDelayInMs == undefined ||\n    updatedConfig.retryOptions.retryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;\n  }\n  if (\n    updatedConfig.retryOptions.maxRetryDelayInMs == undefined ||\n    updatedConfig.retryOptions.maxRetryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;\n  }\n  if (updatedConfig.retryOptions.mode == undefined) {\n    updatedConfig.retryOptions.mode = RetryMode.Fixed;\n  }\n  const errors: (MessagingError | Error)[] = [];\n  let result: any;\n  let success = false;\n  const totalNumberOfAttempts = updatedConfig.retryOptions.maxRetries + 1;\n  for (let i = 1; i <= totalNumberOfAttempts; i++) {\n    logger.verbose(\n      \"[%s] Attempt number for '%s': %d.\",\n      updatedConfig.connectionId,\n      updatedConfig.operationType,\n      i,\n    );\n    try {\n      result = await updatedConfig.operation();\n      success = true;\n      logger.verbose(\n        \"[%s] Success for '%s', after attempt number: %d.\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n      );\n      if (result && !isDelivery(result)) {\n        logger.verbose(\n          \"[%s] Success result for '%s': %O\",\n          updatedConfig.connectionId,\n          updatedConfig.operationType,\n          result,\n        );\n      }\n      break;\n    } catch (_err) {\n      const err = translate(_err);\n\n      if (\n        !(err as any).retryable &&\n        err.name === \"ServiceCommunicationError\" &&\n        updatedConfig.connectionHost\n      ) {\n        const isConnected = await checkNetworkConnection(updatedConfig.connectionHost);\n        if (!isConnected) {\n          err.name = \"ConnectionLostError\";\n          (err as any).retryable = true;\n        }\n      }\n      logger.verbose(\n        \"[%s] Error occurred for '%s' in attempt number %d: %O\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n        err,\n      );\n\n      errors.push(err);\n      if ((errors[errors?.length - 1] as MessagingError).retryable && totalNumberOfAttempts > i) {\n        const targetDelayInMs = calculateDelay(\n          i,\n          updatedConfig.retryOptions.retryDelayInMs,\n          updatedConfig.retryOptions.maxRetryDelayInMs,\n          updatedConfig.retryOptions.mode,\n        );\n        logger.verbose(\n          \"[%s] Sleeping for %d milliseconds for '%s'.\",\n          updatedConfig.connectionId,\n          targetDelayInMs,\n          updatedConfig.operationType,\n        );\n        await delay(targetDelayInMs, {\n          abortSignal: updatedConfig.abortSignal,\n          abortErrorMsg: `The retry operation has been cancelled by the user.`,\n        });\n\n        continue;\n      } else {\n        break;\n      }\n    }\n  }\n  if (success) {\n    return result;\n  } else {\n    throw compileErrors(errors);\n  }\n}\n\nfunction compileErrors(errors: (MessagingError | Error)[]): MessagingError | Error {\n  if (!errors.length) {\n    throw new RangeError(\"Error array is empty\");\n  }\n  let i = 0;\n  const str = errors.map((error) => `Error ${i++}: ${error}`).join(\"\\n\\n\");\n  const lastError = errors[errors.length - 1];\n  lastError.message = str;\n  return lastError;\n}\n"]}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n/* eslint-disable eqeqeq */\n\nimport type { MessagingError } from \"./errors.js\";\nimport { translate } from \"./errors.js\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { Constants } from \"./util/constants.js\";\nimport { checkNetworkConnection } from \"./util/checkNetworkConnection.js\";\nimport { delay } from \"@azure/core-util\";\nimport { logger } from \"./log.js\";\n\n/**\n * Determines whether the object is a Delivery object.\n * @internal\n */\nfunction isDelivery(obj: any): boolean {\n  let result: boolean = false;\n  if (\n    obj &&\n    typeof obj.id === \"number\" &&\n    typeof obj.settled === \"boolean\" &&\n    typeof obj.remote_settled === \"boolean\" &&\n    typeof obj.format === \"number\"\n  ) {\n    result = true;\n  }\n  return result;\n}\n\n/**\n * Describes the Retry Mode type\n */\nexport enum RetryMode {\n  Exponential,\n  Fixed,\n}\n\n/**\n * Describes the retry operation type.\n */\nexport enum RetryOperationType {\n  cbsAuth = \"cbsAuth\",\n  connection = \"connection\",\n  management = \"management\",\n  receiverLink = \"receiverLink\",\n  senderLink = \"senderLink\",\n  sendMessage = \"sendMessage\",\n  receiveMessage = \"receiveMessage\",\n  session = \"session\",\n  messageSettlement = \"settlement\",\n}\n\n/**\n * Retry policy options that determine the mode, number of retries, retry interval etc.\n */\nexport interface RetryOptions {\n  /**\n   * Number of times the operation needs to be retried in case\n   * of retryable error. Default: 3.\n   */\n  maxRetries?: number;\n  /**\n   * Amount of time to wait in milliseconds before making the\n   * next attempt. Default: `30000 milliseconds`.\n   * When `mode` option is set to `Exponential`,\n   * this is used to compute the exponentially increasing delays between retries.\n   */\n  retryDelayInMs?: number;\n  /**\n   * Number of milliseconds to wait before declaring that current attempt has timed out which will trigger a retry\n   * A minimum value of `60000` milliseconds will be used if a value not greater than this is provided.\n   */\n  timeoutInMs?: number;\n  /**\n   * Denotes which retry mode to apply. If undefined, defaults to `Fixed`\n   */\n  mode?: RetryMode;\n  /**\n   * Denotes the maximum delay between retries\n   * that the retry attempts will be capped at. Applicable only when performing exponential retry.\n   */\n  maxRetryDelayInMs?: number;\n}\n\n/**\n * Describes the parameters that need to be configured for the retry operation.\n */\nexport interface RetryConfig<T> {\n  /**\n   * The operation that needs to be retried.\n   */\n  operation: () => Promise<T>;\n  /**\n   * The connection identifier. Used in logging information.\n   * Extremely useful when multiple connections are logged in the same file.\n   */\n  connectionId: string;\n  /**\n   * The name/type of operation to be performed.\n   * Extremely useful in providing better debug logs.\n   */\n  operationType: RetryOperationType;\n  /**\n   * The host \"<yournamespace>.servicebus.windows.net\".\n   * Used to check network connectivity.\n   */\n  connectionHost?: string;\n  /**\n   * The retry related options associated with given operation execution.\n   */\n  retryOptions?: RetryOptions;\n  /**\n   * The `AbortSignal` associated with the operation being retried on.\n   * If this signal is fired during the wait time between retries, then the `retry()` method will ensure that the wait is abandoned and the retry process gets cancelled. If this signal is fired when the operation is in progress, then the operation is expected to react to it.\n   */\n  abortSignal?: AbortSignalLike;\n}\n\n/**\n * Validates the retry config.\n * @internal\n */\nfunction validateRetryConfig<T>(config: RetryConfig<T>): void {\n  if (!config.operation) {\n    throw new TypeError(\"Missing 'operation' in retry configuration\");\n  }\n\n  if (!config.connectionId) {\n    throw new TypeError(\"Missing 'connectionId' in retry configuration\");\n  }\n\n  if (!config.operationType) {\n    throw new TypeError(\"Missing 'operationType' in retry configuration\");\n  }\n}\n\n/**\n * Calculates delay between retries, in milliseconds.\n * @internal\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 * Every operation is attempted at least once. Additional attempts are made if the previous attempt failed\n * with a retryable error. The number of additional attempts is governed by the `maxRetries` property provided\n * on the `RetryConfig` argument.\n *\n * If `mode` option is set to `Fixed`, then the retries are made on the\n * given operation for a specified number of times, with a fixed delay in between each retry each time.\n *\n * If `mode` option is set to `Exponential`, then the delay between retries is adjusted to increase\n * exponentially with each attempt using back-off factor of power 2.\n *\n * @param config - Parameters to configure retry operation\n *\n * @returns Promise<T>.\n */\nexport async function retry<T>(config: RetryConfig<T>): Promise<T> {\n  validateRetryConfig(config);\n  const updatedConfig = { ...config };\n  if (!updatedConfig.retryOptions) {\n    updatedConfig.retryOptions = {};\n  }\n  if (\n    updatedConfig.retryOptions.maxRetries == undefined ||\n    updatedConfig.retryOptions.maxRetries < 0\n  ) {\n    updatedConfig.retryOptions.maxRetries = Constants.defaultMaxRetries;\n  }\n  if (\n    updatedConfig.retryOptions.retryDelayInMs == undefined ||\n    updatedConfig.retryOptions.retryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;\n  }\n  if (\n    updatedConfig.retryOptions.maxRetryDelayInMs == undefined ||\n    updatedConfig.retryOptions.maxRetryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;\n  }\n  if (updatedConfig.retryOptions.mode == undefined) {\n    updatedConfig.retryOptions.mode = RetryMode.Fixed;\n  }\n  const errors: (MessagingError | Error)[] = [];\n  let result: any;\n  let success = false;\n  const totalNumberOfAttempts = updatedConfig.retryOptions.maxRetries + 1;\n  for (let i = 1; i <= totalNumberOfAttempts; i++) {\n    logger.verbose(\n      \"[%s] Attempt number for '%s': %d.\",\n      updatedConfig.connectionId,\n      updatedConfig.operationType,\n      i,\n    );\n    try {\n      result = await updatedConfig.operation();\n      success = true;\n      logger.verbose(\n        \"[%s] Success for '%s', after attempt number: %d.\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n      );\n      if (result && !isDelivery(result)) {\n        logger.verbose(\n          \"[%s] Success result for '%s': %O\",\n          updatedConfig.connectionId,\n          updatedConfig.operationType,\n          result,\n        );\n      }\n      break;\n    } catch (_err) {\n      const err = translate(_err);\n\n      if (\n        !(err as any).retryable &&\n        err.name === \"ServiceCommunicationError\" &&\n        updatedConfig.connectionHost\n      ) {\n        const isConnected = await checkNetworkConnection(updatedConfig.connectionHost);\n        if (!isConnected) {\n          err.name = \"ConnectionLostError\";\n          (err as any).retryable = true;\n        }\n      }\n      logger.verbose(\n        \"[%s] Error occurred for '%s' in attempt number %d: %O\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n        err,\n      );\n\n      errors.push(err);\n      if ((errors[errors?.length - 1] as MessagingError).retryable && totalNumberOfAttempts > i) {\n        const targetDelayInMs = calculateDelay(\n          i,\n          updatedConfig.retryOptions.retryDelayInMs,\n          updatedConfig.retryOptions.maxRetryDelayInMs,\n          updatedConfig.retryOptions.mode,\n        );\n        logger.verbose(\n          \"[%s] Sleeping for %d milliseconds for '%s'.\",\n          updatedConfig.connectionId,\n          targetDelayInMs,\n          updatedConfig.operationType,\n        );\n        await delay(targetDelayInMs, {\n          abortSignal: updatedConfig.abortSignal,\n          abortErrorMsg: `The retry operation has been cancelled by the user.`,\n        });\n\n        continue;\n      } else {\n        break;\n      }\n    }\n  }\n  if (success) {\n    return result;\n  } else {\n    if (errors.length === 1) {\n      throw errors[0];\n    }\n    throw new AggregateError(errors);\n  }\n}\n"]}

package/dist/commonjs/retry.js

@@ -158,17 +158,10 @@ async function retry(config) {
         return result;
     }
     else {
-        throw compileErrors(errors);
-    }
-}
-function compileErrors(errors) {
-    if (!errors.length) {
-        throw new RangeError("Error array is empty");
+        if (errors.length === 1) {
+            throw errors[0];
+        }
+        throw new AggregateError(errors);
     }
-    let i = 0;
-    const str = errors.map((error) => `Error ${i++}: ${error}`).join("\n\n");
-    const lastError = errors[errors.length - 1];
-    lastError.message = str;
-    return lastError;
 }
 //# sourceMappingURL=retry.js.map

package/dist/commonjs/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n/* eslint-disable eqeqeq */\n\nimport type { MessagingError } from \"./errors.js\";\nimport { translate } from \"./errors.js\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { Constants } from \"./util/constants.js\";\nimport { checkNetworkConnection } from \"./util/checkNetworkConnection.js\";\nimport { delay } from \"@azure/core-util\";\nimport { logger } from \"./log.js\";\n\n/**\n * Determines whether the object is a Delivery object.\n * @internal\n */\nfunction isDelivery(obj: any): boolean {\n  let result: boolean = false;\n  if (\n    obj &&\n    typeof obj.id === \"number\" &&\n    typeof obj.settled === \"boolean\" &&\n    typeof obj.remote_settled === \"boolean\" &&\n    typeof obj.format === \"number\"\n  ) {\n    result = true;\n  }\n  return result;\n}\n\n/**\n * Describes the Retry Mode type\n */\nexport enum RetryMode {\n  Exponential,\n  Fixed,\n}\n\n/**\n * Describes the retry operation type.\n */\nexport enum RetryOperationType {\n  cbsAuth = \"cbsAuth\",\n  connection = \"connection\",\n  management = \"management\",\n  receiverLink = \"receiverLink\",\n  senderLink = \"senderLink\",\n  sendMessage = \"sendMessage\",\n  receiveMessage = \"receiveMessage\",\n  session = \"session\",\n  messageSettlement = \"settlement\",\n}\n\n/**\n * Retry policy options that determine the mode, number of retries, retry interval etc.\n */\nexport interface RetryOptions {\n  /**\n   * Number of times the operation needs to be retried in case\n   * of retryable error. Default: 3.\n   */\n  maxRetries?: number;\n  /**\n   * Amount of time to wait in milliseconds before making the\n   * next attempt. Default: `30000 milliseconds`.\n   * When `mode` option is set to `Exponential`,\n   * this is used to compute the exponentially increasing delays between retries.\n   */\n  retryDelayInMs?: number;\n  /**\n   * Number of milliseconds to wait before declaring that current attempt has timed out which will trigger a retry\n   * A minimum value of `60000` milliseconds will be used if a value not greater than this is provided.\n   */\n  timeoutInMs?: number;\n  /**\n   * Denotes which retry mode to apply. If undefined, defaults to `Fixed`\n   */\n  mode?: RetryMode;\n  /**\n   * Denotes the maximum delay between retries\n   * that the retry attempts will be capped at. Applicable only when performing exponential retry.\n   */\n  maxRetryDelayInMs?: number;\n}\n\n/**\n * Describes the parameters that need to be configured for the retry operation.\n */\nexport interface RetryConfig<T> {\n  /**\n   * The operation that needs to be retried.\n   */\n  operation: () => Promise<T>;\n  /**\n   * The connection identifier. Used in logging information.\n   * Extremely useful when multiple connections are logged in the same file.\n   */\n  connectionId: string;\n  /**\n   * The name/type of operation to be performed.\n   * Extremely useful in providing better debug logs.\n   */\n  operationType: RetryOperationType;\n  /**\n   * The host \"<yournamespace>.servicebus.windows.net\".\n   * Used to check network connectivity.\n   */\n  connectionHost?: string;\n  /**\n   * The retry related options associated with given operation execution.\n   */\n  retryOptions?: RetryOptions;\n  /**\n   * The `AbortSignal` associated with the operation being retried on.\n   * If this signal is fired during the wait time between retries, then the `retry()` method will ensure that the wait is abandoned and the retry process gets cancelled. If this signal is fired when the operation is in progress, then the operation is expected to react to it.\n   */\n  abortSignal?: AbortSignalLike;\n}\n\n/**\n * Validates the retry config.\n * @internal\n */\nfunction validateRetryConfig<T>(config: RetryConfig<T>): void {\n  if (!config.operation) {\n    throw new TypeError(\"Missing 'operation' in retry configuration\");\n  }\n\n  if (!config.connectionId) {\n    throw new TypeError(\"Missing 'connectionId' in retry configuration\");\n  }\n\n  if (!config.operationType) {\n    throw new TypeError(\"Missing 'operationType' in retry configuration\");\n  }\n}\n\n/**\n * Calculates delay between retries, in milliseconds.\n * @internal\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 * Every operation is attempted at least once. Additional attempts are made if the previous attempt failed\n * with a retryable error. The number of additional attempts is governed by the `maxRetries` property provided\n * on the `RetryConfig` argument.\n *\n * If `mode` option is set to `Fixed`, then the retries are made on the\n * given operation for a specified number of times, with a fixed delay in between each retry each time.\n *\n * If `mode` option is set to `Exponential`, then the delay between retries is adjusted to increase\n * exponentially with each attempt using back-off factor of power 2.\n *\n * @param config - Parameters to configure retry operation\n *\n * @returns Promise<T>.\n */\nexport async function retry<T>(config: RetryConfig<T>): Promise<T> {\n  validateRetryConfig(config);\n  const updatedConfig = { ...config };\n  if (!updatedConfig.retryOptions) {\n    updatedConfig.retryOptions = {};\n  }\n  if (\n    updatedConfig.retryOptions.maxRetries == undefined ||\n    updatedConfig.retryOptions.maxRetries < 0\n  ) {\n    updatedConfig.retryOptions.maxRetries = Constants.defaultMaxRetries;\n  }\n  if (\n    updatedConfig.retryOptions.retryDelayInMs == undefined ||\n    updatedConfig.retryOptions.retryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;\n  }\n  if (\n    updatedConfig.retryOptions.maxRetryDelayInMs == undefined ||\n    updatedConfig.retryOptions.maxRetryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;\n  }\n  if (updatedConfig.retryOptions.mode == undefined) {\n    updatedConfig.retryOptions.mode = RetryMode.Fixed;\n  }\n  const errors: (MessagingError | Error)[] = [];\n  let result: any;\n  let success = false;\n  const totalNumberOfAttempts = updatedConfig.retryOptions.maxRetries + 1;\n  for (let i = 1; i <= totalNumberOfAttempts; i++) {\n    logger.verbose(\n      \"[%s] Attempt number for '%s': %d.\",\n      updatedConfig.connectionId,\n      updatedConfig.operationType,\n      i,\n    );\n    try {\n      result = await updatedConfig.operation();\n      success = true;\n      logger.verbose(\n        \"[%s] Success for '%s', after attempt number: %d.\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n      );\n      if (result && !isDelivery(result)) {\n        logger.verbose(\n          \"[%s] Success result for '%s': %O\",\n          updatedConfig.connectionId,\n          updatedConfig.operationType,\n          result,\n        );\n      }\n      break;\n    } catch (_err) {\n      const err = translate(_err);\n\n      if (\n        !(err as any).retryable &&\n        err.name === \"ServiceCommunicationError\" &&\n        updatedConfig.connectionHost\n      ) {\n        const isConnected = await checkNetworkConnection(updatedConfig.connectionHost);\n        if (!isConnected) {\n          err.name = \"ConnectionLostError\";\n          (err as any).retryable = true;\n        }\n      }\n      logger.verbose(\n        \"[%s] Error occurred for '%s' in attempt number %d: %O\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n        err,\n      );\n\n      errors.push(err);\n      if ((errors[errors?.length - 1] as MessagingError).retryable && totalNumberOfAttempts > i) {\n        const targetDelayInMs = calculateDelay(\n          i,\n          updatedConfig.retryOptions.retryDelayInMs,\n          updatedConfig.retryOptions.maxRetryDelayInMs,\n          updatedConfig.retryOptions.mode,\n        );\n        logger.verbose(\n          \"[%s] Sleeping for %d milliseconds for '%s'.\",\n          updatedConfig.connectionId,\n          targetDelayInMs,\n          updatedConfig.operationType,\n        );\n        await delay(targetDelayInMs, {\n          abortSignal: updatedConfig.abortSignal,\n          abortErrorMsg: `The retry operation has been cancelled by the user.`,\n        });\n\n        continue;\n      } else {\n        break;\n      }\n    }\n  }\n  if (success) {\n    return result;\n  } else {\n    throw compileErrors(errors);\n  }\n}\n\nfunction compileErrors(errors: (MessagingError | Error)[]): MessagingError | Error {\n  if (!errors.length) {\n    throw new RangeError(\"Error array is empty\");\n  }\n  let i = 0;\n  const str = errors.map((error) => `Error ${i++}: ${error}`).join(\"\\n\\n\");\n  const lastError = errors[errors.length - 1];\n  lastError.message = str;\n  return lastError;\n}\n"]}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n/* eslint-disable eqeqeq */\n\nimport type { MessagingError } from \"./errors.js\";\nimport { translate } from \"./errors.js\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { Constants } from \"./util/constants.js\";\nimport { checkNetworkConnection } from \"./util/checkNetworkConnection.js\";\nimport { delay } from \"@azure/core-util\";\nimport { logger } from \"./log.js\";\n\n/**\n * Determines whether the object is a Delivery object.\n * @internal\n */\nfunction isDelivery(obj: any): boolean {\n  let result: boolean = false;\n  if (\n    obj &&\n    typeof obj.id === \"number\" &&\n    typeof obj.settled === \"boolean\" &&\n    typeof obj.remote_settled === \"boolean\" &&\n    typeof obj.format === \"number\"\n  ) {\n    result = true;\n  }\n  return result;\n}\n\n/**\n * Describes the Retry Mode type\n */\nexport enum RetryMode {\n  Exponential,\n  Fixed,\n}\n\n/**\n * Describes the retry operation type.\n */\nexport enum RetryOperationType {\n  cbsAuth = \"cbsAuth\",\n  connection = \"connection\",\n  management = \"management\",\n  receiverLink = \"receiverLink\",\n  senderLink = \"senderLink\",\n  sendMessage = \"sendMessage\",\n  receiveMessage = \"receiveMessage\",\n  session = \"session\",\n  messageSettlement = \"settlement\",\n}\n\n/**\n * Retry policy options that determine the mode, number of retries, retry interval etc.\n */\nexport interface RetryOptions {\n  /**\n   * Number of times the operation needs to be retried in case\n   * of retryable error. Default: 3.\n   */\n  maxRetries?: number;\n  /**\n   * Amount of time to wait in milliseconds before making the\n   * next attempt. Default: `30000 milliseconds`.\n   * When `mode` option is set to `Exponential`,\n   * this is used to compute the exponentially increasing delays between retries.\n   */\n  retryDelayInMs?: number;\n  /**\n   * Number of milliseconds to wait before declaring that current attempt has timed out which will trigger a retry\n   * A minimum value of `60000` milliseconds will be used if a value not greater than this is provided.\n   */\n  timeoutInMs?: number;\n  /**\n   * Denotes which retry mode to apply. If undefined, defaults to `Fixed`\n   */\n  mode?: RetryMode;\n  /**\n   * Denotes the maximum delay between retries\n   * that the retry attempts will be capped at. Applicable only when performing exponential retry.\n   */\n  maxRetryDelayInMs?: number;\n}\n\n/**\n * Describes the parameters that need to be configured for the retry operation.\n */\nexport interface RetryConfig<T> {\n  /**\n   * The operation that needs to be retried.\n   */\n  operation: () => Promise<T>;\n  /**\n   * The connection identifier. Used in logging information.\n   * Extremely useful when multiple connections are logged in the same file.\n   */\n  connectionId: string;\n  /**\n   * The name/type of operation to be performed.\n   * Extremely useful in providing better debug logs.\n   */\n  operationType: RetryOperationType;\n  /**\n   * The host \"<yournamespace>.servicebus.windows.net\".\n   * Used to check network connectivity.\n   */\n  connectionHost?: string;\n  /**\n   * The retry related options associated with given operation execution.\n   */\n  retryOptions?: RetryOptions;\n  /**\n   * The `AbortSignal` associated with the operation being retried on.\n   * If this signal is fired during the wait time between retries, then the `retry()` method will ensure that the wait is abandoned and the retry process gets cancelled. If this signal is fired when the operation is in progress, then the operation is expected to react to it.\n   */\n  abortSignal?: AbortSignalLike;\n}\n\n/**\n * Validates the retry config.\n * @internal\n */\nfunction validateRetryConfig<T>(config: RetryConfig<T>): void {\n  if (!config.operation) {\n    throw new TypeError(\"Missing 'operation' in retry configuration\");\n  }\n\n  if (!config.connectionId) {\n    throw new TypeError(\"Missing 'connectionId' in retry configuration\");\n  }\n\n  if (!config.operationType) {\n    throw new TypeError(\"Missing 'operationType' in retry configuration\");\n  }\n}\n\n/**\n * Calculates delay between retries, in milliseconds.\n * @internal\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 * Every operation is attempted at least once. Additional attempts are made if the previous attempt failed\n * with a retryable error. The number of additional attempts is governed by the `maxRetries` property provided\n * on the `RetryConfig` argument.\n *\n * If `mode` option is set to `Fixed`, then the retries are made on the\n * given operation for a specified number of times, with a fixed delay in between each retry each time.\n *\n * If `mode` option is set to `Exponential`, then the delay between retries is adjusted to increase\n * exponentially with each attempt using back-off factor of power 2.\n *\n * @param config - Parameters to configure retry operation\n *\n * @returns Promise<T>.\n */\nexport async function retry<T>(config: RetryConfig<T>): Promise<T> {\n  validateRetryConfig(config);\n  const updatedConfig = { ...config };\n  if (!updatedConfig.retryOptions) {\n    updatedConfig.retryOptions = {};\n  }\n  if (\n    updatedConfig.retryOptions.maxRetries == undefined ||\n    updatedConfig.retryOptions.maxRetries < 0\n  ) {\n    updatedConfig.retryOptions.maxRetries = Constants.defaultMaxRetries;\n  }\n  if (\n    updatedConfig.retryOptions.retryDelayInMs == undefined ||\n    updatedConfig.retryOptions.retryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;\n  }\n  if (\n    updatedConfig.retryOptions.maxRetryDelayInMs == undefined ||\n    updatedConfig.retryOptions.maxRetryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;\n  }\n  if (updatedConfig.retryOptions.mode == undefined) {\n    updatedConfig.retryOptions.mode = RetryMode.Fixed;\n  }\n  const errors: (MessagingError | Error)[] = [];\n  let result: any;\n  let success = false;\n  const totalNumberOfAttempts = updatedConfig.retryOptions.maxRetries + 1;\n  for (let i = 1; i <= totalNumberOfAttempts; i++) {\n    logger.verbose(\n      \"[%s] Attempt number for '%s': %d.\",\n      updatedConfig.connectionId,\n      updatedConfig.operationType,\n      i,\n    );\n    try {\n      result = await updatedConfig.operation();\n      success = true;\n      logger.verbose(\n        \"[%s] Success for '%s', after attempt number: %d.\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n      );\n      if (result && !isDelivery(result)) {\n        logger.verbose(\n          \"[%s] Success result for '%s': %O\",\n          updatedConfig.connectionId,\n          updatedConfig.operationType,\n          result,\n        );\n      }\n      break;\n    } catch (_err) {\n      const err = translate(_err);\n\n      if (\n        !(err as any).retryable &&\n        err.name === \"ServiceCommunicationError\" &&\n        updatedConfig.connectionHost\n      ) {\n        const isConnected = await checkNetworkConnection(updatedConfig.connectionHost);\n        if (!isConnected) {\n          err.name = \"ConnectionLostError\";\n          (err as any).retryable = true;\n        }\n      }\n      logger.verbose(\n        \"[%s] Error occurred for '%s' in attempt number %d: %O\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n        err,\n      );\n\n      errors.push(err);\n      if ((errors[errors?.length - 1] as MessagingError).retryable && totalNumberOfAttempts > i) {\n        const targetDelayInMs = calculateDelay(\n          i,\n          updatedConfig.retryOptions.retryDelayInMs,\n          updatedConfig.retryOptions.maxRetryDelayInMs,\n          updatedConfig.retryOptions.mode,\n        );\n        logger.verbose(\n          \"[%s] Sleeping for %d milliseconds for '%s'.\",\n          updatedConfig.connectionId,\n          targetDelayInMs,\n          updatedConfig.operationType,\n        );\n        await delay(targetDelayInMs, {\n          abortSignal: updatedConfig.abortSignal,\n          abortErrorMsg: `The retry operation has been cancelled by the user.`,\n        });\n\n        continue;\n      } else {\n        break;\n      }\n    }\n  }\n  if (success) {\n    return result;\n  } else {\n    if (errors.length === 1) {\n      throw errors[0];\n    }\n    throw new AggregateError(errors);\n  }\n}\n"]}

package/dist/esm/retry.js

@@ -154,17 +154,10 @@ export async function retry(config) {
         return result;
     }
     else {
-        throw compileErrors(errors);
-    }
-}
-function compileErrors(errors) {
-    if (!errors.length) {
-        throw new RangeError("Error array is empty");
+        if (errors.length === 1) {
+            throw errors[0];
+        }
+        throw new AggregateError(errors);
     }
-    let i = 0;
-    const str = errors.map((error) => `Error ${i++}: ${error}`).join("\n\n");
-    const lastError = errors[errors.length - 1];
-    lastError.message = str;
-    return lastError;
 }
 //# sourceMappingURL=retry.js.map

package/dist/esm/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n/* eslint-disable eqeqeq */\n\nimport type { MessagingError } from \"./errors.js\";\nimport { translate } from \"./errors.js\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { Constants } from \"./util/constants.js\";\nimport { checkNetworkConnection } from \"./util/checkNetworkConnection.js\";\nimport { delay } from \"@azure/core-util\";\nimport { logger } from \"./log.js\";\n\n/**\n * Determines whether the object is a Delivery object.\n * @internal\n */\nfunction isDelivery(obj: any): boolean {\n  let result: boolean = false;\n  if (\n    obj &&\n    typeof obj.id === \"number\" &&\n    typeof obj.settled === \"boolean\" &&\n    typeof obj.remote_settled === \"boolean\" &&\n    typeof obj.format === \"number\"\n  ) {\n    result = true;\n  }\n  return result;\n}\n\n/**\n * Describes the Retry Mode type\n */\nexport enum RetryMode {\n  Exponential,\n  Fixed,\n}\n\n/**\n * Describes the retry operation type.\n */\nexport enum RetryOperationType {\n  cbsAuth = \"cbsAuth\",\n  connection = \"connection\",\n  management = \"management\",\n  receiverLink = \"receiverLink\",\n  senderLink = \"senderLink\",\n  sendMessage = \"sendMessage\",\n  receiveMessage = \"receiveMessage\",\n  session = \"session\",\n  messageSettlement = \"settlement\",\n}\n\n/**\n * Retry policy options that determine the mode, number of retries, retry interval etc.\n */\nexport interface RetryOptions {\n  /**\n   * Number of times the operation needs to be retried in case\n   * of retryable error. Default: 3.\n   */\n  maxRetries?: number;\n  /**\n   * Amount of time to wait in milliseconds before making the\n   * next attempt. Default: `30000 milliseconds`.\n   * When `mode` option is set to `Exponential`,\n   * this is used to compute the exponentially increasing delays between retries.\n   */\n  retryDelayInMs?: number;\n  /**\n   * Number of milliseconds to wait before declaring that current attempt has timed out which will trigger a retry\n   * A minimum value of `60000` milliseconds will be used if a value not greater than this is provided.\n   */\n  timeoutInMs?: number;\n  /**\n   * Denotes which retry mode to apply. If undefined, defaults to `Fixed`\n   */\n  mode?: RetryMode;\n  /**\n   * Denotes the maximum delay between retries\n   * that the retry attempts will be capped at. Applicable only when performing exponential retry.\n   */\n  maxRetryDelayInMs?: number;\n}\n\n/**\n * Describes the parameters that need to be configured for the retry operation.\n */\nexport interface RetryConfig<T> {\n  /**\n   * The operation that needs to be retried.\n   */\n  operation: () => Promise<T>;\n  /**\n   * The connection identifier. Used in logging information.\n   * Extremely useful when multiple connections are logged in the same file.\n   */\n  connectionId: string;\n  /**\n   * The name/type of operation to be performed.\n   * Extremely useful in providing better debug logs.\n   */\n  operationType: RetryOperationType;\n  /**\n   * The host \"<yournamespace>.servicebus.windows.net\".\n   * Used to check network connectivity.\n   */\n  connectionHost?: string;\n  /**\n   * The retry related options associated with given operation execution.\n   */\n  retryOptions?: RetryOptions;\n  /**\n   * The `AbortSignal` associated with the operation being retried on.\n   * If this signal is fired during the wait time between retries, then the `retry()` method will ensure that the wait is abandoned and the retry process gets cancelled. If this signal is fired when the operation is in progress, then the operation is expected to react to it.\n   */\n  abortSignal?: AbortSignalLike;\n}\n\n/**\n * Validates the retry config.\n * @internal\n */\nfunction validateRetryConfig<T>(config: RetryConfig<T>): void {\n  if (!config.operation) {\n    throw new TypeError(\"Missing 'operation' in retry configuration\");\n  }\n\n  if (!config.connectionId) {\n    throw new TypeError(\"Missing 'connectionId' in retry configuration\");\n  }\n\n  if (!config.operationType) {\n    throw new TypeError(\"Missing 'operationType' in retry configuration\");\n  }\n}\n\n/**\n * Calculates delay between retries, in milliseconds.\n * @internal\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 * Every operation is attempted at least once. Additional attempts are made if the previous attempt failed\n * with a retryable error. The number of additional attempts is governed by the `maxRetries` property provided\n * on the `RetryConfig` argument.\n *\n * If `mode` option is set to `Fixed`, then the retries are made on the\n * given operation for a specified number of times, with a fixed delay in between each retry each time.\n *\n * If `mode` option is set to `Exponential`, then the delay between retries is adjusted to increase\n * exponentially with each attempt using back-off factor of power 2.\n *\n * @param config - Parameters to configure retry operation\n *\n * @returns Promise<T>.\n */\nexport async function retry<T>(config: RetryConfig<T>): Promise<T> {\n  validateRetryConfig(config);\n  const updatedConfig = { ...config };\n  if (!updatedConfig.retryOptions) {\n    updatedConfig.retryOptions = {};\n  }\n  if (\n    updatedConfig.retryOptions.maxRetries == undefined ||\n    updatedConfig.retryOptions.maxRetries < 0\n  ) {\n    updatedConfig.retryOptions.maxRetries = Constants.defaultMaxRetries;\n  }\n  if (\n    updatedConfig.retryOptions.retryDelayInMs == undefined ||\n    updatedConfig.retryOptions.retryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;\n  }\n  if (\n    updatedConfig.retryOptions.maxRetryDelayInMs == undefined ||\n    updatedConfig.retryOptions.maxRetryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;\n  }\n  if (updatedConfig.retryOptions.mode == undefined) {\n    updatedConfig.retryOptions.mode = RetryMode.Fixed;\n  }\n  const errors: (MessagingError | Error)[] = [];\n  let result: any;\n  let success = false;\n  const totalNumberOfAttempts = updatedConfig.retryOptions.maxRetries + 1;\n  for (let i = 1; i <= totalNumberOfAttempts; i++) {\n    logger.verbose(\n      \"[%s] Attempt number for '%s': %d.\",\n      updatedConfig.connectionId,\n      updatedConfig.operationType,\n      i,\n    );\n    try {\n      result = await updatedConfig.operation();\n      success = true;\n      logger.verbose(\n        \"[%s] Success for '%s', after attempt number: %d.\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n      );\n      if (result && !isDelivery(result)) {\n        logger.verbose(\n          \"[%s] Success result for '%s': %O\",\n          updatedConfig.connectionId,\n          updatedConfig.operationType,\n          result,\n        );\n      }\n      break;\n    } catch (_err) {\n      const err = translate(_err);\n\n      if (\n        !(err as any).retryable &&\n        err.name === \"ServiceCommunicationError\" &&\n        updatedConfig.connectionHost\n      ) {\n        const isConnected = await checkNetworkConnection(updatedConfig.connectionHost);\n        if (!isConnected) {\n          err.name = \"ConnectionLostError\";\n          (err as any).retryable = true;\n        }\n      }\n      logger.verbose(\n        \"[%s] Error occurred for '%s' in attempt number %d: %O\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n        err,\n      );\n\n      errors.push(err);\n      if ((errors[errors?.length - 1] as MessagingError).retryable && totalNumberOfAttempts > i) {\n        const targetDelayInMs = calculateDelay(\n          i,\n          updatedConfig.retryOptions.retryDelayInMs,\n          updatedConfig.retryOptions.maxRetryDelayInMs,\n          updatedConfig.retryOptions.mode,\n        );\n        logger.verbose(\n          \"[%s] Sleeping for %d milliseconds for '%s'.\",\n          updatedConfig.connectionId,\n          targetDelayInMs,\n          updatedConfig.operationType,\n        );\n        await delay(targetDelayInMs, {\n          abortSignal: updatedConfig.abortSignal,\n          abortErrorMsg: `The retry operation has been cancelled by the user.`,\n        });\n\n        continue;\n      } else {\n        break;\n      }\n    }\n  }\n  if (success) {\n    return result;\n  } else {\n    throw compileErrors(errors);\n  }\n}\n\nfunction compileErrors(errors: (MessagingError | Error)[]): MessagingError | Error {\n  if (!errors.length) {\n    throw new RangeError(\"Error array is empty\");\n  }\n  let i = 0;\n  const str = errors.map((error) => `Error ${i++}: ${error}`).join(\"\\n\\n\");\n  const lastError = errors[errors.length - 1];\n  lastError.message = str;\n  return lastError;\n}\n"]}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n/* eslint-disable eqeqeq */\n\nimport type { MessagingError } from \"./errors.js\";\nimport { translate } from \"./errors.js\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { Constants } from \"./util/constants.js\";\nimport { checkNetworkConnection } from \"./util/checkNetworkConnection.js\";\nimport { delay } from \"@azure/core-util\";\nimport { logger } from \"./log.js\";\n\n/**\n * Determines whether the object is a Delivery object.\n * @internal\n */\nfunction isDelivery(obj: any): boolean {\n  let result: boolean = false;\n  if (\n    obj &&\n    typeof obj.id === \"number\" &&\n    typeof obj.settled === \"boolean\" &&\n    typeof obj.remote_settled === \"boolean\" &&\n    typeof obj.format === \"number\"\n  ) {\n    result = true;\n  }\n  return result;\n}\n\n/**\n * Describes the Retry Mode type\n */\nexport enum RetryMode {\n  Exponential,\n  Fixed,\n}\n\n/**\n * Describes the retry operation type.\n */\nexport enum RetryOperationType {\n  cbsAuth = \"cbsAuth\",\n  connection = \"connection\",\n  management = \"management\",\n  receiverLink = \"receiverLink\",\n  senderLink = \"senderLink\",\n  sendMessage = \"sendMessage\",\n  receiveMessage = \"receiveMessage\",\n  session = \"session\",\n  messageSettlement = \"settlement\",\n}\n\n/**\n * Retry policy options that determine the mode, number of retries, retry interval etc.\n */\nexport interface RetryOptions {\n  /**\n   * Number of times the operation needs to be retried in case\n   * of retryable error. Default: 3.\n   */\n  maxRetries?: number;\n  /**\n   * Amount of time to wait in milliseconds before making the\n   * next attempt. Default: `30000 milliseconds`.\n   * When `mode` option is set to `Exponential`,\n   * this is used to compute the exponentially increasing delays between retries.\n   */\n  retryDelayInMs?: number;\n  /**\n   * Number of milliseconds to wait before declaring that current attempt has timed out which will trigger a retry\n   * A minimum value of `60000` milliseconds will be used if a value not greater than this is provided.\n   */\n  timeoutInMs?: number;\n  /**\n   * Denotes which retry mode to apply. If undefined, defaults to `Fixed`\n   */\n  mode?: RetryMode;\n  /**\n   * Denotes the maximum delay between retries\n   * that the retry attempts will be capped at. Applicable only when performing exponential retry.\n   */\n  maxRetryDelayInMs?: number;\n}\n\n/**\n * Describes the parameters that need to be configured for the retry operation.\n */\nexport interface RetryConfig<T> {\n  /**\n   * The operation that needs to be retried.\n   */\n  operation: () => Promise<T>;\n  /**\n   * The connection identifier. Used in logging information.\n   * Extremely useful when multiple connections are logged in the same file.\n   */\n  connectionId: string;\n  /**\n   * The name/type of operation to be performed.\n   * Extremely useful in providing better debug logs.\n   */\n  operationType: RetryOperationType;\n  /**\n   * The host \"<yournamespace>.servicebus.windows.net\".\n   * Used to check network connectivity.\n   */\n  connectionHost?: string;\n  /**\n   * The retry related options associated with given operation execution.\n   */\n  retryOptions?: RetryOptions;\n  /**\n   * The `AbortSignal` associated with the operation being retried on.\n   * If this signal is fired during the wait time between retries, then the `retry()` method will ensure that the wait is abandoned and the retry process gets cancelled. If this signal is fired when the operation is in progress, then the operation is expected to react to it.\n   */\n  abortSignal?: AbortSignalLike;\n}\n\n/**\n * Validates the retry config.\n * @internal\n */\nfunction validateRetryConfig<T>(config: RetryConfig<T>): void {\n  if (!config.operation) {\n    throw new TypeError(\"Missing 'operation' in retry configuration\");\n  }\n\n  if (!config.connectionId) {\n    throw new TypeError(\"Missing 'connectionId' in retry configuration\");\n  }\n\n  if (!config.operationType) {\n    throw new TypeError(\"Missing 'operationType' in retry configuration\");\n  }\n}\n\n/**\n * Calculates delay between retries, in milliseconds.\n * @internal\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 * Every operation is attempted at least once. Additional attempts are made if the previous attempt failed\n * with a retryable error. The number of additional attempts is governed by the `maxRetries` property provided\n * on the `RetryConfig` argument.\n *\n * If `mode` option is set to `Fixed`, then the retries are made on the\n * given operation for a specified number of times, with a fixed delay in between each retry each time.\n *\n * If `mode` option is set to `Exponential`, then the delay between retries is adjusted to increase\n * exponentially with each attempt using back-off factor of power 2.\n *\n * @param config - Parameters to configure retry operation\n *\n * @returns Promise<T>.\n */\nexport async function retry<T>(config: RetryConfig<T>): Promise<T> {\n  validateRetryConfig(config);\n  const updatedConfig = { ...config };\n  if (!updatedConfig.retryOptions) {\n    updatedConfig.retryOptions = {};\n  }\n  if (\n    updatedConfig.retryOptions.maxRetries == undefined ||\n    updatedConfig.retryOptions.maxRetries < 0\n  ) {\n    updatedConfig.retryOptions.maxRetries = Constants.defaultMaxRetries;\n  }\n  if (\n    updatedConfig.retryOptions.retryDelayInMs == undefined ||\n    updatedConfig.retryOptions.retryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;\n  }\n  if (\n    updatedConfig.retryOptions.maxRetryDelayInMs == undefined ||\n    updatedConfig.retryOptions.maxRetryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;\n  }\n  if (updatedConfig.retryOptions.mode == undefined) {\n    updatedConfig.retryOptions.mode = RetryMode.Fixed;\n  }\n  const errors: (MessagingError | Error)[] = [];\n  let result: any;\n  let success = false;\n  const totalNumberOfAttempts = updatedConfig.retryOptions.maxRetries + 1;\n  for (let i = 1; i <= totalNumberOfAttempts; i++) {\n    logger.verbose(\n      \"[%s] Attempt number for '%s': %d.\",\n      updatedConfig.connectionId,\n      updatedConfig.operationType,\n      i,\n    );\n    try {\n      result = await updatedConfig.operation();\n      success = true;\n      logger.verbose(\n        \"[%s] Success for '%s', after attempt number: %d.\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n      );\n      if (result && !isDelivery(result)) {\n        logger.verbose(\n          \"[%s] Success result for '%s': %O\",\n          updatedConfig.connectionId,\n          updatedConfig.operationType,\n          result,\n        );\n      }\n      break;\n    } catch (_err) {\n      const err = translate(_err);\n\n      if (\n        !(err as any).retryable &&\n        err.name === \"ServiceCommunicationError\" &&\n        updatedConfig.connectionHost\n      ) {\n        const isConnected = await checkNetworkConnection(updatedConfig.connectionHost);\n        if (!isConnected) {\n          err.name = \"ConnectionLostError\";\n          (err as any).retryable = true;\n        }\n      }\n      logger.verbose(\n        \"[%s] Error occurred for '%s' in attempt number %d: %O\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n        err,\n      );\n\n      errors.push(err);\n      if ((errors[errors?.length - 1] as MessagingError).retryable && totalNumberOfAttempts > i) {\n        const targetDelayInMs = calculateDelay(\n          i,\n          updatedConfig.retryOptions.retryDelayInMs,\n          updatedConfig.retryOptions.maxRetryDelayInMs,\n          updatedConfig.retryOptions.mode,\n        );\n        logger.verbose(\n          \"[%s] Sleeping for %d milliseconds for '%s'.\",\n          updatedConfig.connectionId,\n          targetDelayInMs,\n          updatedConfig.operationType,\n        );\n        await delay(targetDelayInMs, {\n          abortSignal: updatedConfig.abortSignal,\n          abortErrorMsg: `The retry operation has been cancelled by the user.`,\n        });\n\n        continue;\n      } else {\n        break;\n      }\n    }\n  }\n  if (success) {\n    return result;\n  } else {\n    if (errors.length === 1) {\n      throw errors[0];\n    }\n    throw new AggregateError(errors);\n  }\n}\n"]}

package/dist/react-native/retry.js

@@ -154,17 +154,10 @@ export async function retry(config) {
         return result;
     }
     else {
-        throw compileErrors(errors);
-    }
-}
-function compileErrors(errors) {
-    if (!errors.length) {
-        throw new RangeError("Error array is empty");
+        if (errors.length === 1) {
+            throw errors[0];
+        }
+        throw new AggregateError(errors);
     }
-    let i = 0;
-    const str = errors.map((error) => `Error ${i++}: ${error}`).join("\n\n");
-    const lastError = errors[errors.length - 1];
-    lastError.message = str;
-    return lastError;
 }
 //# sourceMappingURL=retry.js.map

package/dist/react-native/retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n/* eslint-disable eqeqeq */\n\nimport type { MessagingError } from \"./errors.js\";\nimport { translate } from \"./errors.js\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { Constants } from \"./util/constants.js\";\nimport { checkNetworkConnection } from \"./util/checkNetworkConnection.js\";\nimport { delay } from \"@azure/core-util\";\nimport { logger } from \"./log.js\";\n\n/**\n * Determines whether the object is a Delivery object.\n * @internal\n */\nfunction isDelivery(obj: any): boolean {\n  let result: boolean = false;\n  if (\n    obj &&\n    typeof obj.id === \"number\" &&\n    typeof obj.settled === \"boolean\" &&\n    typeof obj.remote_settled === \"boolean\" &&\n    typeof obj.format === \"number\"\n  ) {\n    result = true;\n  }\n  return result;\n}\n\n/**\n * Describes the Retry Mode type\n */\nexport enum RetryMode {\n  Exponential,\n  Fixed,\n}\n\n/**\n * Describes the retry operation type.\n */\nexport enum RetryOperationType {\n  cbsAuth = \"cbsAuth\",\n  connection = \"connection\",\n  management = \"management\",\n  receiverLink = \"receiverLink\",\n  senderLink = \"senderLink\",\n  sendMessage = \"sendMessage\",\n  receiveMessage = \"receiveMessage\",\n  session = \"session\",\n  messageSettlement = \"settlement\",\n}\n\n/**\n * Retry policy options that determine the mode, number of retries, retry interval etc.\n */\nexport interface RetryOptions {\n  /**\n   * Number of times the operation needs to be retried in case\n   * of retryable error. Default: 3.\n   */\n  maxRetries?: number;\n  /**\n   * Amount of time to wait in milliseconds before making the\n   * next attempt. Default: `30000 milliseconds`.\n   * When `mode` option is set to `Exponential`,\n   * this is used to compute the exponentially increasing delays between retries.\n   */\n  retryDelayInMs?: number;\n  /**\n   * Number of milliseconds to wait before declaring that current attempt has timed out which will trigger a retry\n   * A minimum value of `60000` milliseconds will be used if a value not greater than this is provided.\n   */\n  timeoutInMs?: number;\n  /**\n   * Denotes which retry mode to apply. If undefined, defaults to `Fixed`\n   */\n  mode?: RetryMode;\n  /**\n   * Denotes the maximum delay between retries\n   * that the retry attempts will be capped at. Applicable only when performing exponential retry.\n   */\n  maxRetryDelayInMs?: number;\n}\n\n/**\n * Describes the parameters that need to be configured for the retry operation.\n */\nexport interface RetryConfig<T> {\n  /**\n   * The operation that needs to be retried.\n   */\n  operation: () => Promise<T>;\n  /**\n   * The connection identifier. Used in logging information.\n   * Extremely useful when multiple connections are logged in the same file.\n   */\n  connectionId: string;\n  /**\n   * The name/type of operation to be performed.\n   * Extremely useful in providing better debug logs.\n   */\n  operationType: RetryOperationType;\n  /**\n   * The host \"<yournamespace>.servicebus.windows.net\".\n   * Used to check network connectivity.\n   */\n  connectionHost?: string;\n  /**\n   * The retry related options associated with given operation execution.\n   */\n  retryOptions?: RetryOptions;\n  /**\n   * The `AbortSignal` associated with the operation being retried on.\n   * If this signal is fired during the wait time between retries, then the `retry()` method will ensure that the wait is abandoned and the retry process gets cancelled. If this signal is fired when the operation is in progress, then the operation is expected to react to it.\n   */\n  abortSignal?: AbortSignalLike;\n}\n\n/**\n * Validates the retry config.\n * @internal\n */\nfunction validateRetryConfig<T>(config: RetryConfig<T>): void {\n  if (!config.operation) {\n    throw new TypeError(\"Missing 'operation' in retry configuration\");\n  }\n\n  if (!config.connectionId) {\n    throw new TypeError(\"Missing 'connectionId' in retry configuration\");\n  }\n\n  if (!config.operationType) {\n    throw new TypeError(\"Missing 'operationType' in retry configuration\");\n  }\n}\n\n/**\n * Calculates delay between retries, in milliseconds.\n * @internal\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 * Every operation is attempted at least once. Additional attempts are made if the previous attempt failed\n * with a retryable error. The number of additional attempts is governed by the `maxRetries` property provided\n * on the `RetryConfig` argument.\n *\n * If `mode` option is set to `Fixed`, then the retries are made on the\n * given operation for a specified number of times, with a fixed delay in between each retry each time.\n *\n * If `mode` option is set to `Exponential`, then the delay between retries is adjusted to increase\n * exponentially with each attempt using back-off factor of power 2.\n *\n * @param config - Parameters to configure retry operation\n *\n * @returns Promise<T>.\n */\nexport async function retry<T>(config: RetryConfig<T>): Promise<T> {\n  validateRetryConfig(config);\n  const updatedConfig = { ...config };\n  if (!updatedConfig.retryOptions) {\n    updatedConfig.retryOptions = {};\n  }\n  if (\n    updatedConfig.retryOptions.maxRetries == undefined ||\n    updatedConfig.retryOptions.maxRetries < 0\n  ) {\n    updatedConfig.retryOptions.maxRetries = Constants.defaultMaxRetries;\n  }\n  if (\n    updatedConfig.retryOptions.retryDelayInMs == undefined ||\n    updatedConfig.retryOptions.retryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;\n  }\n  if (\n    updatedConfig.retryOptions.maxRetryDelayInMs == undefined ||\n    updatedConfig.retryOptions.maxRetryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;\n  }\n  if (updatedConfig.retryOptions.mode == undefined) {\n    updatedConfig.retryOptions.mode = RetryMode.Fixed;\n  }\n  const errors: (MessagingError | Error)[] = [];\n  let result: any;\n  let success = false;\n  const totalNumberOfAttempts = updatedConfig.retryOptions.maxRetries + 1;\n  for (let i = 1; i <= totalNumberOfAttempts; i++) {\n    logger.verbose(\n      \"[%s] Attempt number for '%s': %d.\",\n      updatedConfig.connectionId,\n      updatedConfig.operationType,\n      i,\n    );\n    try {\n      result = await updatedConfig.operation();\n      success = true;\n      logger.verbose(\n        \"[%s] Success for '%s', after attempt number: %d.\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n      );\n      if (result && !isDelivery(result)) {\n        logger.verbose(\n          \"[%s] Success result for '%s': %O\",\n          updatedConfig.connectionId,\n          updatedConfig.operationType,\n          result,\n        );\n      }\n      break;\n    } catch (_err) {\n      const err = translate(_err);\n\n      if (\n        !(err as any).retryable &&\n        err.name === \"ServiceCommunicationError\" &&\n        updatedConfig.connectionHost\n      ) {\n        const isConnected = await checkNetworkConnection(updatedConfig.connectionHost);\n        if (!isConnected) {\n          err.name = \"ConnectionLostError\";\n          (err as any).retryable = true;\n        }\n      }\n      logger.verbose(\n        \"[%s] Error occurred for '%s' in attempt number %d: %O\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n        err,\n      );\n\n      errors.push(err);\n      if ((errors[errors?.length - 1] as MessagingError).retryable && totalNumberOfAttempts > i) {\n        const targetDelayInMs = calculateDelay(\n          i,\n          updatedConfig.retryOptions.retryDelayInMs,\n          updatedConfig.retryOptions.maxRetryDelayInMs,\n          updatedConfig.retryOptions.mode,\n        );\n        logger.verbose(\n          \"[%s] Sleeping for %d milliseconds for '%s'.\",\n          updatedConfig.connectionId,\n          targetDelayInMs,\n          updatedConfig.operationType,\n        );\n        await delay(targetDelayInMs, {\n          abortSignal: updatedConfig.abortSignal,\n          abortErrorMsg: `The retry operation has been cancelled by the user.`,\n        });\n\n        continue;\n      } else {\n        break;\n      }\n    }\n  }\n  if (success) {\n    return result;\n  } else {\n    throw compileErrors(errors);\n  }\n}\n\nfunction compileErrors(errors: (MessagingError | Error)[]): MessagingError | Error {\n  if (!errors.length) {\n    throw new RangeError(\"Error array is empty\");\n  }\n  let i = 0;\n  const str = errors.map((error) => `Error ${i++}: ${error}`).join(\"\\n\\n\");\n  const lastError = errors[errors.length - 1];\n  lastError.message = str;\n  return lastError;\n}\n"]}
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n/* eslint-disable eqeqeq */\n\nimport type { MessagingError } from \"./errors.js\";\nimport { translate } from \"./errors.js\";\nimport type { AbortSignalLike } from \"@azure/abort-controller\";\nimport { Constants } from \"./util/constants.js\";\nimport { checkNetworkConnection } from \"./util/checkNetworkConnection.js\";\nimport { delay } from \"@azure/core-util\";\nimport { logger } from \"./log.js\";\n\n/**\n * Determines whether the object is a Delivery object.\n * @internal\n */\nfunction isDelivery(obj: any): boolean {\n  let result: boolean = false;\n  if (\n    obj &&\n    typeof obj.id === \"number\" &&\n    typeof obj.settled === \"boolean\" &&\n    typeof obj.remote_settled === \"boolean\" &&\n    typeof obj.format === \"number\"\n  ) {\n    result = true;\n  }\n  return result;\n}\n\n/**\n * Describes the Retry Mode type\n */\nexport enum RetryMode {\n  Exponential,\n  Fixed,\n}\n\n/**\n * Describes the retry operation type.\n */\nexport enum RetryOperationType {\n  cbsAuth = \"cbsAuth\",\n  connection = \"connection\",\n  management = \"management\",\n  receiverLink = \"receiverLink\",\n  senderLink = \"senderLink\",\n  sendMessage = \"sendMessage\",\n  receiveMessage = \"receiveMessage\",\n  session = \"session\",\n  messageSettlement = \"settlement\",\n}\n\n/**\n * Retry policy options that determine the mode, number of retries, retry interval etc.\n */\nexport interface RetryOptions {\n  /**\n   * Number of times the operation needs to be retried in case\n   * of retryable error. Default: 3.\n   */\n  maxRetries?: number;\n  /**\n   * Amount of time to wait in milliseconds before making the\n   * next attempt. Default: `30000 milliseconds`.\n   * When `mode` option is set to `Exponential`,\n   * this is used to compute the exponentially increasing delays between retries.\n   */\n  retryDelayInMs?: number;\n  /**\n   * Number of milliseconds to wait before declaring that current attempt has timed out which will trigger a retry\n   * A minimum value of `60000` milliseconds will be used if a value not greater than this is provided.\n   */\n  timeoutInMs?: number;\n  /**\n   * Denotes which retry mode to apply. If undefined, defaults to `Fixed`\n   */\n  mode?: RetryMode;\n  /**\n   * Denotes the maximum delay between retries\n   * that the retry attempts will be capped at. Applicable only when performing exponential retry.\n   */\n  maxRetryDelayInMs?: number;\n}\n\n/**\n * Describes the parameters that need to be configured for the retry operation.\n */\nexport interface RetryConfig<T> {\n  /**\n   * The operation that needs to be retried.\n   */\n  operation: () => Promise<T>;\n  /**\n   * The connection identifier. Used in logging information.\n   * Extremely useful when multiple connections are logged in the same file.\n   */\n  connectionId: string;\n  /**\n   * The name/type of operation to be performed.\n   * Extremely useful in providing better debug logs.\n   */\n  operationType: RetryOperationType;\n  /**\n   * The host \"<yournamespace>.servicebus.windows.net\".\n   * Used to check network connectivity.\n   */\n  connectionHost?: string;\n  /**\n   * The retry related options associated with given operation execution.\n   */\n  retryOptions?: RetryOptions;\n  /**\n   * The `AbortSignal` associated with the operation being retried on.\n   * If this signal is fired during the wait time between retries, then the `retry()` method will ensure that the wait is abandoned and the retry process gets cancelled. If this signal is fired when the operation is in progress, then the operation is expected to react to it.\n   */\n  abortSignal?: AbortSignalLike;\n}\n\n/**\n * Validates the retry config.\n * @internal\n */\nfunction validateRetryConfig<T>(config: RetryConfig<T>): void {\n  if (!config.operation) {\n    throw new TypeError(\"Missing 'operation' in retry configuration\");\n  }\n\n  if (!config.connectionId) {\n    throw new TypeError(\"Missing 'connectionId' in retry configuration\");\n  }\n\n  if (!config.operationType) {\n    throw new TypeError(\"Missing 'operationType' in retry configuration\");\n  }\n}\n\n/**\n * Calculates delay between retries, in milliseconds.\n * @internal\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 * Every operation is attempted at least once. Additional attempts are made if the previous attempt failed\n * with a retryable error. The number of additional attempts is governed by the `maxRetries` property provided\n * on the `RetryConfig` argument.\n *\n * If `mode` option is set to `Fixed`, then the retries are made on the\n * given operation for a specified number of times, with a fixed delay in between each retry each time.\n *\n * If `mode` option is set to `Exponential`, then the delay between retries is adjusted to increase\n * exponentially with each attempt using back-off factor of power 2.\n *\n * @param config - Parameters to configure retry operation\n *\n * @returns Promise<T>.\n */\nexport async function retry<T>(config: RetryConfig<T>): Promise<T> {\n  validateRetryConfig(config);\n  const updatedConfig = { ...config };\n  if (!updatedConfig.retryOptions) {\n    updatedConfig.retryOptions = {};\n  }\n  if (\n    updatedConfig.retryOptions.maxRetries == undefined ||\n    updatedConfig.retryOptions.maxRetries < 0\n  ) {\n    updatedConfig.retryOptions.maxRetries = Constants.defaultMaxRetries;\n  }\n  if (\n    updatedConfig.retryOptions.retryDelayInMs == undefined ||\n    updatedConfig.retryOptions.retryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.retryDelayInMs = Constants.defaultDelayBetweenOperationRetriesInMs;\n  }\n  if (\n    updatedConfig.retryOptions.maxRetryDelayInMs == undefined ||\n    updatedConfig.retryOptions.maxRetryDelayInMs < 0\n  ) {\n    updatedConfig.retryOptions.maxRetryDelayInMs = Constants.defaultMaxDelayForExponentialRetryInMs;\n  }\n  if (updatedConfig.retryOptions.mode == undefined) {\n    updatedConfig.retryOptions.mode = RetryMode.Fixed;\n  }\n  const errors: (MessagingError | Error)[] = [];\n  let result: any;\n  let success = false;\n  const totalNumberOfAttempts = updatedConfig.retryOptions.maxRetries + 1;\n  for (let i = 1; i <= totalNumberOfAttempts; i++) {\n    logger.verbose(\n      \"[%s] Attempt number for '%s': %d.\",\n      updatedConfig.connectionId,\n      updatedConfig.operationType,\n      i,\n    );\n    try {\n      result = await updatedConfig.operation();\n      success = true;\n      logger.verbose(\n        \"[%s] Success for '%s', after attempt number: %d.\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n      );\n      if (result && !isDelivery(result)) {\n        logger.verbose(\n          \"[%s] Success result for '%s': %O\",\n          updatedConfig.connectionId,\n          updatedConfig.operationType,\n          result,\n        );\n      }\n      break;\n    } catch (_err) {\n      const err = translate(_err);\n\n      if (\n        !(err as any).retryable &&\n        err.name === \"ServiceCommunicationError\" &&\n        updatedConfig.connectionHost\n      ) {\n        const isConnected = await checkNetworkConnection(updatedConfig.connectionHost);\n        if (!isConnected) {\n          err.name = \"ConnectionLostError\";\n          (err as any).retryable = true;\n        }\n      }\n      logger.verbose(\n        \"[%s] Error occurred for '%s' in attempt number %d: %O\",\n        updatedConfig.connectionId,\n        updatedConfig.operationType,\n        i,\n        err,\n      );\n\n      errors.push(err);\n      if ((errors[errors?.length - 1] as MessagingError).retryable && totalNumberOfAttempts > i) {\n        const targetDelayInMs = calculateDelay(\n          i,\n          updatedConfig.retryOptions.retryDelayInMs,\n          updatedConfig.retryOptions.maxRetryDelayInMs,\n          updatedConfig.retryOptions.mode,\n        );\n        logger.verbose(\n          \"[%s] Sleeping for %d milliseconds for '%s'.\",\n          updatedConfig.connectionId,\n          targetDelayInMs,\n          updatedConfig.operationType,\n        );\n        await delay(targetDelayInMs, {\n          abortSignal: updatedConfig.abortSignal,\n          abortErrorMsg: `The retry operation has been cancelled by the user.`,\n        });\n\n        continue;\n      } else {\n        break;\n      }\n    }\n  }\n  if (success) {\n    return result;\n  } else {\n    if (errors.length === 1) {\n      throw errors[0];\n    }\n    throw new AggregateError(errors);\n  }\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@azure/core-amqp",
   "sdk-type": "client",
-  "version": "4.3.5-alpha.20250130.1",
+  "version": "4.3.5-alpha.20250131.1",
   "description": "Common library for amqp based azure sdks like @azure/event-hubs.",
   "author": "Microsoft Corporation",
   "license": "MIT",