에러 핸들링 & Retry 전략

async function sleep(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

function computeBackoff(attempt, retryAfterSec) {
  // 429 응답에 Retry-After 헤더 있으면 우선 사용
  if (retryAfterSec) {
    return retryAfterSec * 1000;
  }
  // 1초 → 2초 → 4초 → 8초 ... 최대 30초
  const base = Math.min(1000 * Math.pow(2, attempt), 30000);
  // jitter ±20%
  const jitter = base * 0.2 * (Math.random() * 2 - 1);
  return base + jitter;
}

// errorCode 기반으로 재시도 가능 여부 판정
async function isRetryable(response) {
  if (response.status === 429) return true;
  if (response.status === 500) {
    // 500은 ERR_INTERNAL_ERROR(재시도 O) vs ERR_PDF_FILE_MISSING(재시도 X) 분기
    const body = await response.clone().json().catch(() => null);
    return body?.errorCode !== 'ERR_PDF_FILE_MISSING';
  }
  if (response.status === 409) {
    const body = await response.clone().json().catch(() => null);
    // 락 타임아웃 (errorCode 필드 부재) → 재시도 O
    if (!body?.errorCode) return true;
    // ERR_PDF_NOT_GENERATED / ERR_PDF_PENDING → 재시도 O
    if (body.errorCode === 'ERR_PDF_NOT_GENERATED'
     || body.errorCode === 'ERR_PDF_PENDING') return true;
    // ERR_CONFLICT (리소스 상태 충돌) → 재시도 X
    return false;
  }
  return false;
}

async function withRetry(fetchFn, maxAttempts = 4) {
  let lastResponse;
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    lastResponse = await fetchFn();

    if (!(await isRetryable(lastResponse))) {
      return lastResponse;
    }

    if (attempt === maxAttempts - 1) {
      return lastResponse; // 마지막 시도, 그대로 반환
    }

    const retryAfter = lastResponse.headers.get('Retry-After');
    const waitMs = computeBackoff(attempt, retryAfter ? parseInt(retryAfter, 10) : null);
    await sleep(waitMs);
  }
  return lastResponse; // 도달하지 않지만 컴파일러 경고 회피
}

// crypto.randomUUID()는 Node.js 14.17+ / 브라우저 표준 API. 별도 라이브러리 불요.
async function createOrderWithRetry(orderData) {
  const idempotencyKey = crypto.randomUUID();
  const baseUrl = 'https://api-sandbox.sweetbook.com';
  const headers = {
    'Authorization': 'Bearer {YOUR_API_KEY}',
    'Idempotency-Key': idempotencyKey,
    'Content-Type': 'application/json; charset=utf-8',
  };

  return await withRetry(async () => {
    return fetch(`${baseUrl}/v1/orders`, {
      method: 'POST',
      headers,
      body: JSON.stringify(orderData),
    });
  });
}

// withRetry / sleep / computeBackoff / isRetryable 헬퍼는 위 "Exponential Backoff + Jitter" 섹션 코드 사용.
async function placeOrder(orderData) {
  const baseUrl = 'https://api-sandbox.sweetbook.com';
  const headers = {
    'Authorization': 'Bearer {YOUR_API_KEY}',
    'Content-Type': 'application/json; charset=utf-8',
  };

  // 1. 견적 (멱등 안전, Idempotency-Key 불요. transient 에러만 재시도)
  const estResponse = await withRetry(() =>
    fetch(`${baseUrl}/v1/orders/estimate`, {
      method: 'POST', headers, body: JSON.stringify(orderData),
    })
  );
  const est = await estResponse.json();

  if (!est.data?.creditSufficient) {
    // 402 사전 차단 (자동 충전 금지)
    throw new Error(
      `충전금 부족. 필요: ${est.data.paidCreditAmount}, 잔액: ${est.data.creditBalance}`
    );
  }

  // 2. 주문 생성 (Idempotency-Key 필수, transient 에러는 같은 키로 재시도)
  const idempotencyKey = crypto.randomUUID();
  const orderResponse = await withRetry(() =>
    fetch(`${baseUrl}/v1/orders`, {
      method: 'POST',
      headers: { ...headers, 'Idempotency-Key': idempotencyKey },
      body: JSON.stringify(orderData),
    })
  );

  // 3. 402 재확인 (견적 통과 후 동시 차감 케이스)
  if (orderResponse.status === 402) {
    const body = await orderResponse.json();
    throw new Error(
      `충전금 부족 (동시성). 필요: ${body.data.required}, 잔액: ${body.data.balance}`
    );
  }

  return orderResponse.json();
}