Function backoffWithJitter

packages/utils/src/retry.ts:19–33

(
  attempt: number,
  retryAfterMs: number | null,
  options: BackoffOptions = {}
)

 * Attempt is 1-indexed.
 */
export function backoffWithJitter(
  attempt: number,
  retryAfterMs: number | null,
  options: BackoffOptions = {}
): number {
  const baseMs = options.baseMs ?? DEFAULT_BACKOFF_BASE_MS
  const maxMs = options.maxMs ?? DEFAULT_BACKOFF_MAX_MS
  if (retryAfterMs !== null) {
    return Math.min(Math.max(retryAfterMs, baseMs), maxMs)
  }
  const exponential = Math.min(baseMs * 2 ** (attempt - 1), maxMs)
  // Inline crypto float to avoid cross-file imports within the package (Turbopack limitation)
  const jitter = crypto.getRandomValues(new Uint32Array(1))[0] / 0x100000000
  return exponential * (0.8 + jitter * 0.4)
}

/** Maximum `Retry-After` value honored: 30 s. Prevents a misconfigured upstream from stalling callers. */
const RETRY_AFTER_MAX_MS = 30_000