[WebTranslator 개발기 #10] Gemini 429 쿼터 초과와 통합 프롬프트 빌더

{
  "error": {
    "code": 429,
    "message": "Resource has been exhausted (e.g. check quota).",
    "status": "RESOURCE_EXHAUSTED"
  }
}

// gemini_adapter.js: 모델마다 따로따로 작성된 프롬프트 (오류 코드)
function getGeminiPrompt(texts) {
  return "Translate JSON array to Korean: " + JSON.stringify(texts);
}

// openai_adapter.js
function getOpenAIPrompt(texts) {
  return "You are a professional translator. Output JSON array: " + JSON.stringify(texts);
}

// src/content/dynamic_observer.js: 디바운스 배치 큐 기반 정식 동적 감지기
let dynamicQueue = [];
let debounceTimer = null;

export function initDynamicObserver() {
  const observer = new MutationObserver((mutations) => {
    // 번역 진행 중이 아닐 때는 무시
    if (document.body.dataset.wtStatus !== "translated") return;

    for (const mutation of mutations) {
      mutation.addedNodes.forEach((node) => {
        // 이미 번역된 래퍼(.wt-trans-wrapper)는 수집 제외
        if (node.nodeType === Node.ELEMENT_NODE && !node.classList.contains("wt-trans-wrapper")) {
          const texts = collectTextNodes(node);
          dynamicQueue.push(...texts);
        }
      });
    }

    // 300ms 디바운스로 요청을 묶어서 25개 단위 배치로 발송
    clearTimeout(debounceTimer);
    debounceTimer = setTimeout(() => {
      if (dynamicQueue.length > 0) {
        const batchToTranslate = dynamicQueue.splice(0, dynamicQueue.length);
        dispatchDynamicBatchTranslation(batchToTranslate);
      }
    }, 300);
  });

  observer.observe(document.body, { childList: true, subtree: true });
}

모델마다 따로따로 프롬프트를 짜지 마라. 공통 4대 번역 규칙(1:1 매칭, 원문 언어 무관 번역, 코드/태그 원형 보존, 순수 JSON 강제)을 단일 베이스로 정의하고, 사용자 커스텀 지시문만 결합하여 반환하는 buildTranslationPrompt로 완전히 일원화해라.

// src/background/prompt_builder.js: 중앙 통합 번역 프롬프트 빌더
export function buildTranslationPrompt(targetLang = "ko", customPrompt = "") {
  const baseRules = [
    `You are an expert professional translator. Translate the given JSON array of strings into ${targetLang}.`,
    "",
    "Strict Rules:",
    "1. Maintain exact 1-to-1 array element correspondence and order.",
    "2. Translate 100% of non-target text regardless of original language.",
    "3. Keep code names, variables, HTML tags, and technical terms intact.",
    "4. Return ONLY a valid JSON array with NO markdown backticks or commentary."
  ];

  // 사용자가 옵션에서 등록한 커스텀 지시문 동적 결합
  if (customPrompt && customPrompt.trim().length > 0) {
    baseRules.push("", `User Custom Instructions: ${customPrompt.trim()}`);
  }

  return baseRules.join("\n");
}

// src/background/translator.js: 429 반려 시 큐 후방 재진입 및 지속 재시도 파이프라인
export async function processBatchWithPersistentRetry(batchQueue, engineConfig) {
  while (batchQueue.length > 0) {
    const currentBatch = batchQueue.shift();

    try {
      const translated = await callEngineAPI(currentBatch, engineConfig);
      applyTranslationToDOM(currentBatch, translated);
    } catch (err) {
      if (err.status === 429 || err.message.includes("429")) {
        console.warn("[WebTranslator] 429 쿼터 초과 감지. 10초 대기 후 큐 후방으로 재진입합니다.");
        
        // 1. 이미 진행 중인 선행 요청들이 쿼터를 소모하고 비워질 때까지 10초 대기
        await sleep(10000);

        // 2. 실패 배치를 큐 맨 뒤로 다시 넣어 순서 재조정 (영구 포기 방지)
        batchQueue.push(currentBatch);
      } else {
        console.error("[WebTranslator] 치명적 에러 발생:", err);
      }
    }
  }
}