Handling Invoice Outcomes from arca.issue() in facturas

import { createArcaClient, createPostgresStore } from "facturas";
import { sql } from "@vercel/postgres";

const arca = createArcaClient({
  store: createPostgresStore({ query: (text, params) => sql.query(text, params) }),
});

const venta = { id: "sale-abc-123", totalEnCentavos: 150_000 };

const factura = await arca.issue(
  {
    issuer: "monotributo",
    salesPoint: 3,
    to: { condition: "consumidor_final" },
    items: [{ amount: venta.totalEnCentavos }],
  },
  { idempotencyKey: venta.id },
);

switch (factura.kind) {
  case "authorized":
    // factura.voucher contains the CAE, voucher number, amounts, and dates.
    await db.saveInvoice({
      saleId: venta.id,
      cae: factura.voucher.cae,
      voucherNumber: factura.voucher.number,
      amounts: factura.voucher.amounts,
    });
    break;

  case "rejected":
    // factura.issues is an array of ARCA fiscal issues with codes and messages.
    console.error("ARCA rejected the invoice:", factura.issues);
    await db.markSaleRejected(venta.id, factura.issues);
    break;

  case "indeterminate":
    // The number was reserved. Preserve it and reconcile later.
    console.error("Outcome unknown — preserve evidence:", {
      attempted: factura.attempted,
      lookup: factura.lookup,
    });
    await db.markSalePendingReconciliation(venta.id);
    break;

  case "conflict":
    // A different voucher occupies the reserved number. Requires investigation.
    console.error("Conflict — manual review required:", {
      attempted: factura.attempted,
      found: factura.found,
    });
    await alertOps(venta.id, factura);
    break;

  default:
    factura satisfies never;
}