lookup.mjs

// Predio — Node example with typed-error handling. Node 18+ (built-in fetch).
// Usage:  PREDIO_API_KEY=pk_... node lookup.mjs 13077A01800039
const API_KEY = process.env.PREDIO_API_KEY;
if (!API_KEY) throw new Error("Set PREDIO_API_KEY (free key: https://prediohq.com)");

const rc = process.argv[2] ?? "9872023VH5797S0001WX";
const res = await fetch(`https://api.prediohq.com/v1/inmueble/${rc}`, {
  headers: { "x-api-key": API_KEY },
});

// Every outcome is JSON with a stable shape — branch on HTTP status + error.code,
// never on parsing quirks (that's the point of not consuming the SOAP upstream).
const body = await res.json();

if (res.ok) {
  const p = body.property;
  console.log(`${p.address?.municipality ?? "?"} — ${p.class} / ${p.use}`);
  console.log(`Built area: ${p.builtAreaM2 ?? "n/a"} m² · year: ${p.yearBuilt ?? "n/a"}`);
  console.log(`Source: ${body.source.provider} · cached: ${body.source.cached}`);
} else {
  switch (body.error?.code) {
    case "NOT_FOUND":          // 404 — the reference doesn't exist
    case "INVALID_REFERENCE":  // 422 — malformed (check digits are validated before calling upstream)
      console.error(`Bad input (don't retry): ${body.error.message}`);
      break;
    case "PAYMENT_REQUIRED":   // 402 — out of credits: top up, then retry is safe
      console.error(`Out of credits: ${body.error.message}`);
      break;
    case "RATE_LIMITED":       // 429 — back off and retry
      console.error(`Rate limited, retry after: ${res.headers.get("retry-after") ?? "?"}s`);
      break;
    default:                   // 5xx — upstream/infra: retryable
      console.error(`Transient (${res.status}): ${body.error?.message ?? "unknown"}`);
  }
  process.exitCode = 1;
}