Errors

{
  "type": "/problems/locale-not-configured",
  "title": "Locale not configured",
  "status": 422,
  "detail": "Locale \"pt-PT\" is not configured on this project."
}

{
  "type": "/problems/quota-exceeded",
  "title": "Quota exceeded",
  "status": 429,
  "detail": "The account this workspace belongs to has no AI words left for this cycle. They reset on 1 Nov 2026.",
  "quota": {
    "reason": "plan_allowance",
    "scope": "account",
    "requested": 4820,
    "resets_at": "2026-11-01T00:00:00+00:00"
  }
}

type Problem = { type: string; title: string; status: number; detail: string; [extension: string]: unknown };

export async function startRun(token: string) {
  const res = await fetch('https://api.transglot.ai/v1/translate', {
    method: 'POST',
    headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ scope: 'missing' }),
  });

  if (res.ok) return res.json(); // 202: the batch

  const problem = (await res.json()) as Problem;

  switch (problem.type) {
    case '/problems/active-batch':
      // Another run is going. Watch it instead of starting a second one.
      return { watch: problem.batch_id };
    case '/problems/rate-limited': {
      const seconds = Number(res.headers.get('Retry-After') ?? '1');
      await new Promise((resolve) => setTimeout(resolve, seconds * 1000));
      return startRun(token);
    }
    case '/problems/quota-exceeded':
      // Lifts on its own at quota.resets_at (when set). Do not loop on it.
      throw new Error(`No AI words left: ${problem.detail}`);
    case '/problems/missing-ability':
      throw new Error(`This token needs the "${problem.ability}" ability.`);
    default:
      throw new Error(`${problem.status} ${problem.type}: ${problem.detail}`);
  }
}