Gestion des erreurs

{
  "type": "about:blank",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "billing is required.",
  "errors": [
    { "field": "billing", "error": "required" }
  ]
}

// med-client.mjs — Node.js >= 18 (fetch natif)
const BASE = "https://api.myexpressdriver.com/v1";
const API_KEY = process.env.MED_API_KEY; // med_live_...

/**
 * Erreur typée portant le Problem Details (RFC 9457).
 */
class MedApiError extends Error {
  constructor(problem, httpStatus) {
    super(problem?.detail || problem?.title || `HTTP ${httpStatus}`);
    this.name = "MedApiError";
    this.status = httpStatus;
    this.title = problem?.title;
    this.type = problem?.type;
    this.detail = problem?.detail;
    this.code = problem?.code;           // ex. "leg_invoiced", "relay_timeout"
    this.reference = problem?.reference; // présent sur les 500 : à transmettre au support
    this.errors = problem?.errors ?? []; // [{ field, error }]
  }
}

const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

async function medRequest(method, path, { body, idempotencyKey, retries = 2 } = {}) {
  const headers = {
    "X-Api-Key": API_KEY,
    "Content-Type": "application/json",
  };
  if (idempotencyKey) headers["Idempotency-Key"] = idempotencyKey;

  const res = await fetch(`${BASE}${path}`, {
    method,
    headers,
    body: body ? JSON.stringify(body) : undefined,
  });

  // Succès (200/201/207) : on renvoie le corps tel quel.
  if (res.ok) {
    return res.status === 204 ? null : res.json();
  }

  // Erreur : le corps est un Problem Details (application/problem+json).
  const problem = await res.json().catch(() => ({}));

  // 429 — respecter Retry-After, puis retenter.
  if (res.status === 429 && retries > 0) {
    const wait = Number(res.headers.get("Retry-After") ?? 1);
    await sleep(wait * 1000);
    return medRequest(method, path, { body, idempotencyKey, retries: retries - 1 });
  }

  // 409 request_in_progress — la même requête est encore en traitement :
  // patienter (Retry-After) puis rejouer avec la MÊME clé.
  if (res.status === 409 && problem?.code === "request_in_progress" && !problem?.outcome_unknown && retries > 0) {
    const wait = Number(res.headers.get("Retry-After") ?? 5);
    await sleep(wait * 1000);
    return medRequest(method, path, { body, idempotencyKey, retries: retries - 1 });
  }

  // 502 — l'opération a pu aboutir (relay_timeout) : on ne rejoue qu'avec une clé
  // d'idempotence, qui renvoie la mission déjà créée au lieu d'en créer une seconde.
  // Issue inconnue (outcome_unknown) : ne jamais rejouer automatiquement.
  if (res.status === 502 && idempotencyKey && !problem?.outcome_unknown && retries > 0) {
    await sleep(2000);
    return medRequest(method, path, { body, idempotencyKey, retries: retries - 1 });
  }

  // Brancher sur le STATUT (jamais sur le texte de detail).
  switch (res.status) {
    case 401:
      throw new MedApiError(problem, 401); // clé invalide/révoquée/expirée
    case 403:
      throw new MedApiError(problem, 403); // scope manquant
    case 404:
      throw new MedApiError(problem, 404); // hors groupe OU inexistante
    case 409:
      throw new MedApiError(problem, 409); // conflit idempotence/métier (voir problem.code)
    case 422:
      // Exploiter problem.errors[] pour un retour champ par champ.
      throw new MedApiError(problem, 422);
    case 500:
      // Aucun détail technique : journaliser problem.reference pour le support.
      throw new MedApiError(problem, 500);
    default:
      throw new MedApiError(problem, res.status);
  }
}

// Exemple d'usage
try {
  const transport = await medRequest("GET", "/transports/-O9xAbCdEf");
  console.log(transport.status); // statut public stable
} catch (err) {
  if (err instanceof MedApiError && err.status === 422) {
    for (const { field, error } of err.errors) {
      console.warn(`Champ « ${field} » invalide : ${error}`);
    }
  } else if (err instanceof MedApiError && err.status === 404) {
    console.warn("Mission introuvable ou hors de votre groupe.");
  } else {
    throw err;
  }
}