Function withRetry

actions/setup/js/error_recovery.cjs:167–239

* Execute an operation with retry logic and exponential backoff * @template T * @param {() => Promise } operation - The async operation to execute * @param {Partial } [config] - Retry configuration (optional) * @param {string} [operationName] - Name of the operation for logging *

(operation, config = {}, operationName = "operation")

 * @throws {Error} If all retry attempts fail
 */
async function withRetry(operation, config = {}, operationName = "operation") {
  const fullConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
  let lastError;
  let delay = fullConfig.initialDelayMs;

  for (let attempt = 0; attempt <= fullConfig.maxRetries; attempt++) {
    try {
      if (attempt > 0) {
        const jitter = fullConfig.jitterMs > 0 ? Math.floor(Math.random() * fullConfig.jitterMs) : 0;
        const delayWithJitter = delay + jitter;
        core.info(`Retry attempt ${attempt}/${fullConfig.maxRetries} for ${operationName} after ${delayWithJitter}ms delay`);
        logRetryEvent(lastError, operationName, attempt, delayWithJitter);
        await sleep(delayWithJitter);
      }

      const result = await operation();

      if (attempt > 0) {
        core.info(`✓ ${operationName} succeeded on retry attempt ${attempt}`);
      }

      return result;
    } catch (error) {
      lastError = error;
      const errorMsg = getErrorMessage(error);

      // Check if this error should be retried
      if (!fullConfig.shouldRetry(error)) {
        core.debug(`${operationName} failed with non-retryable error: ${errorMsg}`);
        throw enhanceError(error, {
          operation: operationName,
          attempt: attempt + 1,
          retryable: false,
          suggestion: "This error cannot be resolved by retrying. Please check the error details and fix the underlying issue.",
        });
      }

      // If this was the last attempt, throw the enhanced error
      if (attempt === fullConfig.maxRetries) {
        core.warning(`${operationName} failed after ${fullConfig.maxRetries} retry attempts: ${errorMsg}`);
        throw enhanceError(error, {
          operation: operationName,
          attempt: attempt + 1,
          maxRetries: fullConfig.maxRetries,
          retryable: true,
          suggestion: "All retry attempts exhausted. This may be a persistent issue. Check GitHub status or try again later.",
        });
      }

      // Log the retry attempt
      core.warning(`${operationName} failed (attempt ${attempt + 1}/${fullConfig.maxRetries + 1}): ${errorMsg}`);

      // Calculate next delay: honour Retry-After header when present, otherwise
      // use exponential backoff.  Either way the result is capped at maxDelayMs.
      const retryAfterMs = getRetryAfterMs(error);
      if (retryAfterMs !== null) {
        const cappedDelay = Math.min(retryAfterMs, fullConfig.maxDelayMs);
        if (cappedDelay < retryAfterMs) {