facturas 0.12.3 → 0.13.0

package/dist/{chunk-G7BWMDFT.mjs → chunk-KPWAQMR5.mjs}

@@ -1,29 +1,30 @@
+import {
+  ARCA_CURRENCY_IDS,
+  ARCA_DOCUMENT_TYPES,
+  ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS,
+  ARCA_INVOICE_CLASS_BY_ISSUER,
+  ARCA_ISSUER_CONDITION_IDS,
+  ARCA_RECEIVER_CONDITION_IDS,
+  ARCA_VAT_RATES,
+  ARCA_VOUCHER_TYPES
+} from "./chunk-LQMNKQ2V.mjs";
 import {
   createPadronService
-} from "./chunk-7LEKQ4P7.mjs";
+} from "./chunk-WVKVJTFG.mjs";
 import {
   arcaMinorUnitsToNumber,
   assertArcaMinorUnits,
-  calculateWsfeAmounts,
   createWsfeService,
   isWithinArcaTolerance,
   normalizeArcaAmountToMinorUnits,
   normalizeWsfeDateInput,
   normalizeWsfeVoucherInput,
+  roundHalfEvenRatio,
   serializeArcaExchangeRate
-} from "./chunk-QHYJ424J.mjs";
-import {
-  ARCA_CURRENCY_IDS,
-  ARCA_DOCUMENT_TYPES,
-  ARCA_FINAL_CONSUMER_IDENTIFICATION_THRESHOLD_MINOR_UNITS,
-  ARCA_INVOICE_CLASS_BY_ISSUER,
-  ARCA_ISSUER_CONDITION_IDS,
-  ARCA_RECEIVER_CONDITION_IDS,
-  ARCA_VOUCHER_TYPES
-} from "./chunk-GX5ERXT6.mjs";
+} from "./chunk-BPBTQDCO.mjs";
 import {
   createWsmtxcaService
-} from "./chunk-ZPVXXSUC.mjs";
+} from "./chunk-WN62NMUJ.mjs";
 import {
   ArcaConfigurationError,
   ArcaError,
@@ -35,7 +36,7 @@ import {
   createResponseBodyDiagnostic,
   createSafeErrorDiagnostic,
   toArcaSafeErrorMetadata
-} from "./chunk-ZOSNASXB.mjs";
+} from "./chunk-BYEP3ABS.mjs";
 
 // src/config.ts
 var ARCA_ENVIRONMENTS = ["production", "test"];
@@ -1190,7 +1191,7 @@ function createWsaaAuthModule(options) {
   }
   return {
     login(service, authOptions = {}) {
-      return abortable(runLogin(service, authOptions), authOptions.signal);
+      return abortable(runLogin(service, authOptions), authOptions.abortSignal);
     }
   };
   function runLogin(service, authOptions) {
@@ -1698,6 +1699,17 @@ function validateIssuanceFields(fields) {
   if (fields.concept !== void 0 && !["products", "services", "products_and_services"].includes(fields.concept)) {
     bad("concept");
   }
+  if (fields.fce !== void 0) {
+    objectKeys(fields.fce, "fce", [
+      "cbu",
+      "alias",
+      "transfer",
+      "annulment",
+      "reference"
+    ]);
+    validateFceOptions(fields.fce);
+  }
+  normalizedFceAnnulment(fields);
 }
 function positiveId(value, field) {
   if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
@@ -1772,6 +1784,7 @@ function applyFceFields(data, fce) {
     bad("fce");
   }
   validateFceOptions(fce);
+  normalizedFceAnnulment({ fce, optionalFields: data.optionalFields });
   const extra = [
     ...fce.cbu === void 0 ? [] : [{ id: "2101", value: fce.cbu }],
     ...fce.alias === void 0 ? [] : [{ id: "2102", value: fce.alias }],
@@ -1785,6 +1798,26 @@ function applyFceFields(data, fce) {
   }
   data.optionalFields = options;
 }
+function normalizedFceAnnulment(fields) {
+  const encoded = (fields.optionalFields ?? []).filter(
+    (field) => field.id === "22"
+  );
+  if (encoded.length > 1) {
+    bad("optionalFields");
+  }
+  const encodedValue = encoded[0]?.value;
+  if (encodedValue !== void 0 && !["S", "N"].includes(encodedValue)) {
+    bad("fce.annulment");
+  }
+  const direct = fields.fce?.annulment;
+  if (direct !== void 0 && encodedValue !== void 0) {
+    throw new ArcaInputError(
+      direct === (encodedValue === "S") ? "FCE annulment is duplicated in fce and optionalFields." : "FCE annulment conflicts between fce and optionalFields.",
+      { code: "ARCA_INPUT_INVALID_VALUE", field: "fce.annulment" }
+    );
+  }
+  return direct ?? (encodedValue === void 0 ? void 0 : encodedValue === "S");
+}
 function validateFceHeader(data) {
   const family = voucherFamily(data.voucherType);
   if (family.family === "fce") {
@@ -1833,53 +1866,36 @@ var iso = (value) => {
   return `${date.slice(0, 4)}-${date.slice(4, 6)}-${date.slice(6, 8)}`;
 };
 function wsmtxcaRequest(data, number) {
-  if (!data.details?.length) {
-    invalid("details", "WSMTXCA requires detailed items");
-  }
-  const items = data.details.map((item, index) => {
-    if (!item || typeof item !== "object" || Object.keys(item).some(
-      (k) => ![
-        "description",
-        "quantity",
-        "unit",
-        "unitPrice",
-        "discount",
-        "vatCondition",
-        "vatAmount",
-        "amount",
-        "code",
-        "matrixCode",
-        "matrixUnits"
-      ].includes(k)
-    )) {
-      invalid(`details[${index}]`, "Invalid detailed item fields");
-    }
-    if (typeof item.description !== "string" || !(item.description.trim() && Number.isFinite(item.quantity)) || item.quantity <= 0 || !Number.isInteger(item.unit) || item.unit < 0 || typeof item.unitPrice !== "string" || !/^\d+(\.\d{1,6})?$/.test(item.unitPrice) || !Number.isInteger(item.vatCondition)) {
-      invalid(`details[${index}]`, "Invalid detailed item");
-    }
-    return {
-      unidadesMtx: item.matrixUnits,
-      codigoMtx: item.matrixCode,
-      codigo: item.code,
-      descripcion: item.description,
-      cantidad: item.quantity,
-      codigoUnidadMedida: item.unit,
-      precioUnitario: item.unitPrice,
-      importeBonificacion: minor(item.discount ?? 0, "details.discount"),
-      codigoCondicionIVA: item.vatCondition,
-      ...item.vatAmount === void 0 ? {} : { importeIVA: minor(item.vatAmount, "details.vatAmount") },
-      importeItem: minor(item.amount, "details.amount")
-    };
-  });
-  const itemTotal = data.details.reduce(
-    (sum, item) => sum + BigInt(item.amount),
-    0n
-  );
+  const legacy = data.details !== void 0;
+  const authorized = data.authorizedLines !== void 0;
+  const lines = data.lines ?? data.authorizedLines ?? data.details;
+  const sources = [data.lines, data.authorizedLines, data.details].filter(
+    (source) => source !== void 0
+  ).length;
+  if (!lines?.length || sources !== 1) {
+    invalid("items", "WSMTXCA requires items with line detail");
+  }
+  const items = lines.map((line) => ({
+    unidadesMtx: line.matrixUnits,
+    codigoMtx: line.matrixCode,
+    codigo: line.code,
+    descripcion: line.description,
+    cantidad: line.quantity,
+    codigoUnidadMedida: line.unit,
+    precioUnitario: line.unitPrice,
+    // Old durable records omitted a zero discount. Rebuild the exact request
+    // those releases sent without rewriting the stored fiscal evidence.
+    importeBonificacion: minor(line.discount ?? 0, "items.discount"),
+    codigoCondicionIVA: line.vatCondition,
+    ...line.vatAmount === void 0 ? {} : { importeIVA: minor(line.vatAmount, "items.vatAmount") },
+    importeItem: minor(line.amount, "items.amount")
+  }));
+  const itemTotal = lines.reduce((sum, line) => sum + BigInt(line.amount), 0n);
   const expected = normalizeArcaAmountToMinorUnits(data.totalAmount, "total") - normalizeArcaAmountToMinorUnits(data.taxAmount, "taxes");
-  if (!isWithinArcaTolerance(itemTotal, expected, 1)) {
-    invalid(
-      "details",
-      "Item totals must equal the voucher total excluding tributes"
+  if (legacy || authorized ? !isWithinArcaTolerance(itemTotal, expected, 1) : itemTotal !== expected) {
+    throw new ArcaError(
+      "The derived WSMTXCA items do not sum to the voucher header excluding tributes. This is an SDK invariant failure.",
+      "ARCA_ISSUE_INVARIANT"
     );
   }
   const tributes = data.taxes?.length ? data.taxes : void 0;
@@ -1974,7 +1990,7 @@ function rows(value, key) {
 function wsmtxcaHeader(found) {
   const raw = found.raw;
   const items = rows(raw.arrayItems, "item");
-  const details = items?.map((i) => ({
+  const lines = items?.map((i) => ({
     description: String(i.descripcion ?? ""),
     quantity: Number(i.cantidad),
     unit: Number(i.codigoUnidadMedida),
@@ -2004,12 +2020,12 @@ function wsmtxcaHeader(found) {
     serviceStartDate: raw.fechaServicioDesde === void 0 ? void 0 : String(raw.fechaServicioDesde),
     serviceEndDate: raw.fechaServicioHasta === void 0 ? void 0 : String(raw.fechaServicioHasta),
     paymentDueDate: raw.fechaVencimientoPago === void 0 ? void 0 : String(raw.fechaVencimientoPago),
-    details,
+    lines,
     vatRates: rows(raw.arraySubtotalesIVA, "subtotalIVA")?.map((v) => ({
       id: Number(v.codigo),
       amount: Number(v.importe),
       baseAmount: Number(
-        (details ?? []).filter((i) => i.vatCondition === Number(v.codigo)).reduce((sum, i) => sum + BigInt(i.amount), 0n) - normalizeArcaAmountToMinorUnits(Number(v.importe), "vat")
+        (lines ?? []).filter((i) => i.vatCondition === Number(v.codigo)).reduce((sum, i) => sum + BigInt(i.amount), 0n) - normalizeArcaAmountToMinorUnits(Number(v.importe), "vat")
       ) / 100
     })),
     taxes: rows(raw.arrayOtrosTributos, "otroTributo")?.map((t) => ({
@@ -2150,7 +2166,7 @@ function createWsmtxcaIssuanceService(wsmtxca) {
     issue: (input) => wsmtxca.issue({
       representedTaxId: input.representedTaxId,
       forceRefresh: input.forceRefresh,
-      signal: input.signal,
+      abortSignal: input.abortSignal,
       data: wsmtxcaRequest(input.data, input.voucherNumber)
     }),
     lookupVoucher: async (input) => {
@@ -2175,6 +2191,385 @@ function wsmtxcaAdditionalData(fields) {
   };
 }
 
+// src/services/wsfe-amounts.ts
+var RATES = {
+  0: { id: ARCA_VAT_RATES.IVA_0, basisPoints: 0n },
+  2.5: { id: ARCA_VAT_RATES.IVA_2_5, basisPoints: 250n },
+  5: { id: ARCA_VAT_RATES.IVA_5, basisPoints: 500n },
+  10.5: { id: ARCA_VAT_RATES.IVA_10_5, basisPoints: 1050n },
+  21: { id: ARCA_VAT_RATES.IVA_21, basisPoints: 2100n },
+  27: { id: ARCA_VAT_RATES.IVA_27, basisPoints: 2700n }
+};
+function calculateWsfeAmounts(input) {
+  if (!Array.isArray(input.items) || input.items.length === 0) {
+    invalidItem("items", "a non-empty array of items");
+  }
+  const isVat = input.voucherClass === "A" || input.voucherClass === "B";
+  if (!(isVat || input.voucherClass === "C")) {
+    invalidItem("voucherClass", "A, B or C");
+  }
+  const totals = collectItems(input.items, isVat);
+  let net = totals.net;
+  let vat = 0n;
+  const { exempt, untaxed, groups } = totals;
+  const vatRates = [];
+  for (const [rate, group] of groups) {
+    const { id, basisPoints } = RATES[rate];
+    const netFromGross = roundHalfEvenRatio(
+      group.gross * 10000n,
+      10000n + basisPoints
+    );
+    const base = group.net + netFromGross;
+    const tax = roundHalfEvenRatio(group.net * basisPoints, 10000n) + group.gross - netFromGross;
+    if (base === 0n) {
+      continue;
+    }
+    net += base;
+    vat += tax;
+    vatRates.push({
+      id,
+      baseAmount: arcaMinorUnitsToNumber(base, "netAmount"),
+      amount: arcaMinorUnitsToNumber(tax, "vatAmount")
+    });
+  }
+  const computed = net + vat + exempt + untaxed;
+  arcaMinorUnitsToNumber(computed, "totalAmount");
+  const sent = input.total === void 0 ? computed : assertArcaMinorUnits(input.total, "total");
+  const adjustment = sent - computed;
+  const allowance = BigInt(vatRates.length);
+  if (adjustment < -allowance || adjustment > allowance || vat + adjustment < 0n) {
+    throw new ArcaInputError(
+      "total does not match the computed amount within the VAT allowance.",
+      {
+        code: "ARCA_INPUT_AMOUNT_MISMATCH",
+        field: "total",
+        expected: `${computed} minor units (at most ${allowance} minor units of VAT adjustment, with non-negative VAT)`
+      }
+    );
+  }
+  return {
+    data: {
+      totalAmount: arcaMinorUnitsToNumber(sent, "totalAmount"),
+      netAmount: arcaMinorUnitsToNumber(net, "netAmount"),
+      vatAmount: arcaMinorUnitsToNumber(vat + adjustment, "vatAmount"),
+      nonTaxableAmount: arcaMinorUnitsToNumber(untaxed, "nonTaxableAmount"),
+      exemptAmount: arcaMinorUnitsToNumber(exempt, "exemptAmount"),
+      taxAmount: 0,
+      ...isVat ? { vatRates } : {}
+    },
+    amounts: {
+      computedTotal: Number(computed),
+      sentTotal: Number(sent),
+      vatAdjustment: Number(adjustment)
+    }
+  };
+}
+function collectItems(items, isVat) {
+  let net = 0n;
+  let exempt = 0n;
+  let untaxed = 0n;
+  const groups = /* @__PURE__ */ new Map();
+  for (const [index, item] of items.entries()) {
+    const path = `items[${index}]`;
+    if (item === null || typeof item !== "object" || Array.isArray(item)) {
+      invalidItem(path, "an item object");
+    }
+    if (!isVat) {
+      net += classCAmount(item, path);
+      continue;
+    }
+    const { amount, field, rate } = vatItemAmount(item, path);
+    if (rate === "exempt") {
+      exempt += amount;
+      continue;
+    }
+    if (rate === "untaxed") {
+      untaxed += amount;
+      continue;
+    }
+    const group = groups.get(rate) ?? { net: 0n, gross: 0n };
+    group[field] += amount;
+    groups.set(rate, group);
+  }
+  return { net, exempt, untaxed, groups };
+}
+function classCAmount(item, path) {
+  if ("vat" in item || "net" in item || "gross" in item) {
+    invalidItem("items", "amount items for a class C voucher");
+  }
+  return assertArcaMinorUnits(item.amount, `${path}.amount`);
+}
+function vatItemAmount(item, path) {
+  if ("amount" in item || "net" in item === "gross" in item) {
+    invalidItem(
+      "items",
+      "exactly one of net or gross, and vat, for a class A or B voucher"
+    );
+  }
+  const field = "net" in item ? "net" : "gross";
+  const amount = assertArcaMinorUnits(
+    item[field],
+    `${path}.${field}`
+  );
+  const rate = item.vat;
+  if (rate !== "exempt" && rate !== "untaxed" && (typeof rate !== "number" || !Object.hasOwn(RATES, rate))) {
+    invalidItem(`${path}.vat`, "0, 2.5, 5, 10.5, 21, 27, exempt, or untaxed");
+  }
+  return { amount, field, rate };
+}
+function invalidItem(field, expected) {
+  throw new ArcaInputError(`${field} must be ${expected}.`, {
+    code: "ARCA_INPUT_INVALID_VALUE",
+    field,
+    expected
+  });
+}
+var UNTAXED_CONDITION = 1;
+var EXEMPT_CONDITION = 2;
+function deriveWsmtxcaSettlement(input, vatAdjustment) {
+  if (!Array.isArray(input.items) || input.items.length === 0) {
+    invalidItem("items", "a non-empty array of items");
+  }
+  const isVat = input.voucherClass === "A" || input.voucherClass === "B";
+  const drafts = [];
+  const groups = /* @__PURE__ */ new Map();
+  for (const [index, item] of input.items.entries()) {
+    const path = `items[${index}]`;
+    if (item === null || typeof item !== "object" || Array.isArray(item)) {
+      invalidItem(path, "an item object");
+    }
+    drafts.push(lineDraft(item, path, isVat, groups));
+  }
+  reconcileGroups(drafts, groups);
+  absorbAdjustment(drafts, BigInt(vatAdjustment));
+  const lines = drafts.map(({ line, vat, amount }) => ({
+    ...line,
+    amount: Number(amount),
+    ...input.voucherClass === "A" ? { vatAmount: Number(vat) } : {}
+  }));
+  const vatByCondition = /* @__PURE__ */ new Map();
+  for (const draft of drafts) {
+    if (draft.rate === void 0) {
+      continue;
+    }
+    const condition = RATES[draft.rate].id;
+    vatByCondition.set(
+      condition,
+      (vatByCondition.get(condition) ?? 0) + Number(draft.vat)
+    );
+  }
+  return { lines, vatByCondition };
+}
+function lineDraft(item, path, isVat, groups) {
+  const line = assertItemLine(item, path);
+  if (!isVat) {
+    const amount2 = classCAmount(item, path);
+    return {
+      line: { ...line, vatCondition: RATES[0].id, amount: 0 },
+      vat: 0n,
+      amount: amount2,
+      amountFormula: { numerator: amount2, denominator: 1n }
+    };
+  }
+  const { amount, field, rate } = vatItemAmount(item, path);
+  if (rate === "exempt" || rate === "untaxed") {
+    return {
+      line: {
+        ...line,
+        vatCondition: rate === "exempt" ? EXEMPT_CONDITION : UNTAXED_CONDITION,
+        amount: 0
+      },
+      vat: 0n,
+      amount,
+      amountFormula: { numerator: amount, denominator: 1n }
+    };
+  }
+  const { id, basisPoints } = RATES[rate];
+  const group = groups.get(rate) ?? { net: 0n, gross: 0n };
+  group[field] += amount;
+  groups.set(rate, group);
+  const vat = field === "gross" ? amount - roundHalfEvenRatio(amount * 10000n, 10000n + basisPoints) : roundHalfEvenRatio(amount * basisPoints, 10000n);
+  return {
+    line: { ...line, vatCondition: id, amount: 0 },
+    vat,
+    amount: field === "gross" ? amount : amount + vat,
+    rate,
+    field,
+    vatFormula: field === "gross" ? {
+      numerator: amount * basisPoints,
+      denominator: 10000n + basisPoints
+    } : { numerator: amount * basisPoints, denominator: 10000n },
+    amountFormula: field === "gross" ? { numerator: amount, denominator: 1n } : {
+      numerator: amount * (10000n + basisPoints),
+      denominator: 10000n
+    }
+  };
+}
+function reconcileGroups(drafts, groups) {
+  for (const [rate, group] of groups) {
+    const { basisPoints } = RATES[rate];
+    const netFromGross = roundHalfEvenRatio(
+      group.gross * 10000n,
+      10000n + basisPoints
+    );
+    settle(
+      drafts,
+      (draft) => draft.rate === rate && draft.field === "net",
+      roundHalfEvenRatio(group.net * basisPoints, 10000n) - sumVat(drafts, (d) => d.rate === rate && d.field === "net"),
+      true
+    );
+    settle(
+      drafts,
+      (draft) => draft.rate === rate && draft.field === "gross",
+      group.gross - netFromGross - sumVat(drafts, (d) => d.rate === rate && d.field === "gross"),
+      false
+    );
+  }
+}
+function sumVat(drafts, of) {
+  return drafts.reduce((sum, draft) => of(draft) ? sum + draft.vat : sum, 0n);
+}
+function settle(drafts, of, amount, movesItem) {
+  let remaining = amount;
+  const targets = drafts.filter(of);
+  let cursor = 0;
+  while (remaining !== 0n) {
+    const step = remaining > 0n ? 1n : -1n;
+    let target;
+    for (let offset = 0; offset < targets.length; offset++) {
+      const index = (cursor + offset) % targets.length;
+      const candidate = targets[index];
+      if (candidate && canMove(candidate, step, movesItem)) {
+        target = candidate;
+        cursor = (index + 1) % targets.length;
+        break;
+      }
+    }
+    if (target === void 0) {
+      throw new ArcaError(
+        "The derived WSMTXCA VAT does not fit its lines. This is an SDK invariant failure.",
+        "ARCA_ISSUE_INVARIANT"
+      );
+    }
+    applyMove(target, step, movesItem);
+    remaining -= step;
+  }
+}
+function canMove(draft, step, movesItem) {
+  const vat = draft.vat + step;
+  if (vat < 0n || draft.rate === 0 && vat !== 0n) {
+    return false;
+  }
+  if (draft.vatFormula !== void 0 && !withinAbsoluteCent(vat, draft.vatFormula)) {
+    return false;
+  }
+  return !movesItem || withinAbsoluteCent(draft.amount + step, draft.amountFormula);
+}
+function withinAbsoluteCent(value, formula) {
+  const difference = value * formula.denominator - formula.numerator;
+  return (difference < 0n ? -difference : difference) <= formula.denominator;
+}
+function applyMove(draft, step, movesItem) {
+  draft.vat += step;
+  if (movesItem) {
+    draft.amount += step;
+  }
+}
+function absorbAdjustment(drafts, adjustment) {
+  if (adjustment === 0n) {
+    return;
+  }
+  const step = adjustment > 0n ? 1n : -1n;
+  let remaining = adjustment;
+  const rates = [
+    ...new Set(
+      drafts.map((draft) => draft.rate).filter(
+        (rate) => rate !== void 0 && rate > 0
+      )
+    )
+  ];
+  for (const rate of rates) {
+    const target = drafts.find(
+      (draft) => draft.rate === rate && canMove(draft, step, true)
+    );
+    if (target === void 0) {
+      continue;
+    }
+    applyMove(target, step, true);
+    remaining -= step;
+    if (remaining === 0n) {
+      return;
+    }
+  }
+  throw new ArcaInputError(
+    "total cannot be reconciled with WSMTXCA item formulas within ARCA's tolerance.",
+    {
+      code: "ARCA_INPUT_AMOUNT_MISMATCH",
+      field: "total"
+    }
+  );
+}
+var ITEM_KEYS = [
+  "net",
+  "gross",
+  "amount",
+  "vat",
+  "description",
+  "quantity",
+  "unit",
+  "unitPrice",
+  "discount",
+  "code",
+  "matrixCode",
+  "matrixUnits"
+];
+function assertItemLine(item, path) {
+  assertRequiredLineFields(item, path);
+  for (const key of ["code", "matrixCode"]) {
+    if (item[key] !== void 0 && typeof item[key] !== "string") {
+      invalidItem(`${path}.${key}`, "a string");
+    }
+  }
+  if (item.matrixUnits !== void 0 && !Number.isFinite(item.matrixUnits)) {
+    invalidItem(`${path}.matrixUnits`, "a number");
+  }
+  return {
+    ...item.matrixUnits === void 0 ? {} : { matrixUnits: item.matrixUnits },
+    ...item.matrixCode === void 0 ? {} : { matrixCode: item.matrixCode },
+    ...item.code === void 0 ? {} : { code: item.code },
+    description: item.description,
+    quantity: item.quantity,
+    unit: item.unit,
+    unitPrice: item.unitPrice,
+    discount: Number(
+      assertArcaMinorUnits(item.discount ?? 0, `${path}.discount`)
+    )
+  };
+}
+function assertRequiredLineFields(item, path) {
+  for (const key of Object.keys(item)) {
+    if (!ITEM_KEYS.includes(key)) {
+      invalidItem(`${path}.${key}`, "a supported item field");
+    }
+  }
+  const { description, quantity, unit, unitPrice } = item;
+  if (typeof description !== "string" || description.trim() === "") {
+    invalidItem(`${path}.description`, "a non-empty description");
+  }
+  if (!Number.isFinite(quantity) || quantity <= 0) {
+    invalidItem(`${path}.quantity`, "a positive quantity");
+  }
+  if (!Number.isInteger(unit) || unit < 0) {
+    invalidItem(`${path}.unit`, "an ARCA unit of measure code");
+  }
+  if (typeof unitPrice !== "string" || !/^\d+(\.\d{1,6})?$/.test(unitPrice)) {
+    invalidItem(
+      `${path}.unitPrice`,
+      "a major-unit decimal string with at most six decimals"
+    );
+  }
+}
+
 // src/services/wsfe-derive.ts
 var INVOICE_TYPES = {
   A: ARCA_VOUCHER_TYPES.FACTURA_A,
@@ -2188,7 +2583,6 @@ function deriveWsfeInvoice(input, now = /* @__PURE__ */ new Date()) {
     [
       ...ISSUANCE_KEYS,
       "family",
-      "details",
       "issuer",
       "items",
       "salesPoint",
@@ -2209,11 +2603,12 @@ function deriveWsfeInvoice(input, now = /* @__PURE__ */ new Date()) {
   assertSalesPoint(input.salesPoint);
   const receiver = deriveReceiver(input.to);
   const voucherClass = resolveInvoiceClass(input.issuer, input.to.condition);
-  const { data: amountsData, amounts } = input.amounts ? reviewedInvoiceAmounts(input.amounts, input.taxes) : calculateWsfeAmounts({
+  const lineSource = input.amounts ? void 0 : {
     voucherClass,
     items: input.items,
     total: input.total === void 0 ? void 0 : input.total - tributeTotal(input.taxes ?? [])
-  });
+  };
+  const { data: amountsData, amounts } = lineSource === void 0 ? reviewedInvoiceAmounts(input.amounts, input.taxes) : calculateWsfeAmounts(lineSource);
   const currency = deriveCurrency(input);
   const voucherDate = normalizeWsfeDateInput(
     input.date === void 0 ? buenosAiresDate(now) : input.date,
@@ -2258,12 +2653,17 @@ function deriveWsfeInvoice(input, now = /* @__PURE__ */ new Date()) {
       throw cause;
     }
     throw new ArcaError(
-      "The derived invoice failed exact WSFE validation. This is an SDK invariant failure.",
+      "The derived invoice failed WSFE validation. This is an SDK invariant failure.",
       "ARCA_ISSUE_INVARIANT",
       { cause }
     );
   }
-  return { data, voucherClass, amounts };
+  return {
+    data,
+    voucherClass,
+    amounts,
+    ...lineSource === void 0 ? {} : { lineSource }
+  };
 }
 function reviewedInvoiceAmounts(amounts, taxes) {
   const taxTotal = taxes === void 0 ? 0 : tributeTotal(taxes);
@@ -2438,7 +2838,7 @@ function assertIssueKeys(value, keys, prefix, method = "issue()") {
       throw new ArcaInputError(`${field} is not supported by ${method}.`, {
         code: "ARCA_INPUT_RESERVED_FIELD",
         field,
-        expected: "a supported high-level API field; use the exact API for other fiscal fields"
+        expected: "a field the facade supports"
       });
     }
   }
@@ -2492,10 +2892,9 @@ function deriveNumericReceiver(to) {
 
 // src/services/wsfe-credit-note.ts
 function invalid3(reason) {
-  throw new ArcaInputError(
-    `issueCreditNote cannot proceed: ${reason}. Use the exact service API for manual control.`,
-    { code: "ARCA_INPUT_INVALID_VALUE" }
-  );
+  throw new ArcaInputError(`issueCreditNote cannot proceed: ${reason}.`, {
+    code: "ARCA_INPUT_INVALID_VALUE"
+  });
 }
 function required(value, field) {
   if (value === void 0 || value === null) {
@@ -2504,7 +2903,7 @@ function required(value, field) {
   return value;
 }
 function deriveWsfeFullCreditNote(original, input, now = /* @__PURE__ */ new Date(), kind = "creditNote") {
-  const { note, header } = prepareCreditNote(original, input, now, kind);
+  const { note, header } = prepareCreditNote([original], input, now, kind);
   const data = {
     ...header,
     ...original.taxes ? { taxes: structuredClone(original.taxes) } : {},
@@ -2526,24 +2925,32 @@ function deriveWsfeFullCreditNote(original, input, now = /* @__PURE__ */ new Dat
     amounts: { computedTotal: total, sentTotal: total, vatAdjustment: 0 }
   };
 }
-function deriveWsfePartialCreditNote(original, input, now = /* @__PURE__ */ new Date(), kind = "creditNote") {
+function deriveWsfePartialCreditNote(originals, input, now = /* @__PURE__ */ new Date(), kind = "creditNote") {
   if (input.items === void 0 && input.amounts === void 0) {
     invalid3("items is required to credit chosen lines");
   }
   const requestedTotal = input.total === void 0 ? void 0 : assertArcaMinorUnits(input.total, "total");
-  const { note, header } = prepareCreditNote(original, input, now, kind);
-  const { data: amountsData, amounts } = input.amounts ? reviewedInvoiceAmounts(input.amounts, input.taxes) : calculateWsfeAmounts({
+  const { note, header } = prepareCreditNote(originals, input, now, kind);
+  const lineSource = input.amounts ? void 0 : {
     voucherClass: note.voucherClass,
     items: input.items,
     total: input.total === void 0 ? void 0 : input.total - tributeTotal(input.taxes ?? [])
-  });
-  const originalTotal = normalizeArcaAmountToMinorUnits(
-    required(original.totalAmount, "totalAmount"),
-    "totalAmount"
+  };
+  const { data: amountsData, amounts } = lineSource === void 0 ? reviewedInvoiceAmounts(
+    input.amounts,
+    input.taxes
+  ) : calculateWsfeAmounts(lineSource);
+  const originalTotal = originals.reduce(
+    (sum, original) => sum + normalizeArcaAmountToMinorUnits(
+      required(original.totalAmount, "totalAmount"),
+      "totalAmount"
+    ),
+    0n
   );
+  const ceiling = originals.length === 1 ? "the original" : "the sum of the originals";
   if (kind === "creditNote" && (requestedTotal ?? BigInt(amounts.sentTotal)) > originalTotal) {
     invalid3(
-      "the note total is greater than the original; the SDK does not track earlier notes against an original"
+      `the note total is greater than ${ceiling}; the SDK does not track earlier notes against an original`
     );
   }
   const data = { ...header, ...amountsData };
@@ -2566,15 +2973,55 @@ function deriveWsfePartialCreditNote(original, input, now = /* @__PURE__ */ new
   );
   const sentTotal = input.amounts && requestedTotal !== void 0 ? Number(requestedTotal) : total;
   if (kind === "creditNote" && BigInt(sentTotal) > originalTotal) {
-    invalid3("the note total is greater than the original");
+    invalid3(`the note total is greater than ${ceiling}`);
   }
   data.totalAmount = minor(sentTotal, "total");
   amounts.computedTotal += total - amounts.sentTotal;
   amounts.sentTotal = sentTotal;
   normalizeWsfeVoucherInput(data);
-  return { data, voucherClass: note.voucherClass, amounts };
+  return {
+    data,
+    voucherClass: note.voucherClass,
+    amounts,
+    ...lineSource === void 0 ? {} : { lineSource }
+  };
+}
+function prepareCreditNote(originals, input, now, kind) {
+  const derived = originals.map(
+    (original) => prepareOneCreditNote(original, input, now, kind)
+  );
+  const [first, ...rest] = derived;
+  if (first === void 0) {
+    invalid3("for must name at least one original");
+  }
+  for (const other of rest) {
+    assertInheritedHeader(first.header, other.header);
+  }
+  return {
+    note: first.note,
+    header: {
+      ...first.header,
+      associatedVouchers: derived.flatMap(
+        (one) => one.header.associatedVouchers ?? []
+      )
+    }
+  };
 }
-function prepareCreditNote(original, input, now, kind) {
+function assertInheritedHeader(first, other) {
+  for (const field of /* @__PURE__ */ new Set([...Object.keys(first), ...Object.keys(other)])) {
+    if (field === "associatedVouchers") {
+      continue;
+    }
+    const left = first[field];
+    const right = other[field];
+    if (JSON.stringify(left) !== JSON.stringify(right)) {
+      invalid3(
+        `the originals disagree on ${field}, which the note inherits from them`
+      );
+    }
+  }
+}
+function prepareOneCreditNote(original, input, now, kind) {
   assertOriginalExtensions(original);
   const family = voucherFamily(original.voucherType ?? 0);
   if (family.types[2] === original.voucherType) {
@@ -2660,7 +3107,6 @@ var CREDIT_NOTE_KEYS = [
   "taxes",
   "amounts",
   "optionalFields",
-  "details",
   "fce"
 ];
 var TARGET_BOUNDS = [
@@ -2673,7 +3119,7 @@ function assertCreditNoteInput(input) {
   validateIssuanceFields(input);
   if ("associatedPeriod" in input) {
     throw new ArcaInputError(
-      "issueCreditNote does not support associatedPeriod; a note against a period is exact-layer work. Use the exact service API for manual control.",
+      "issueCreditNote adjusts either the originals named in for or a period, never both; drop one of them.",
       {
         code: "ARCA_INPUT_RESERVED_FIELD",
         field: "associatedPeriod",
@@ -2682,7 +3128,7 @@ function assertCreditNoteInput(input) {
     );
   }
   assertIssueKeys(input, CREDIT_NOTE_KEYS, "input", "issueCreditNote()");
-  const target = assertCreditNoteTarget(input.for);
+  const target = assertCreditNoteTargets(input.for);
   if (input.salesPoint !== void 0) {
     assertCreditNoteBound(input.salesPoint, 99999, "salesPoint");
   }
@@ -2690,7 +3136,6 @@ function assertCreditNoteInput(input) {
   const common = {
     ...input.fce === void 0 ? {} : { fce: structuredClone(input.fce) },
     ...input.taxes === void 0 ? {} : { taxes: structuredClone(input.taxes) },
-    ...input.details === void 0 ? {} : { details: structuredClone(input.details) },
     ...input.optionalFields === void 0 ? {} : { optionalFields: structuredClone(input.optionalFields) },
     for: target,
     ...input.salesPoint === void 0 ? {} : { salesPoint: input.salesPoint },
@@ -2727,13 +3172,47 @@ function assertCreditNoteInput(input) {
     ...input.total === void 0 ? {} : { total: input.total }
   };
 }
-function assertCreditNoteTarget(value) {
+function assertCreditNoteTargets(value) {
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      throw new ArcaInputError(
+        "issueCreditNote requires for to name at least one authorized original.",
+        {
+          code: "ARCA_INPUT_MISSING_FIELD",
+          field: "input.for",
+          expected: "a non-empty array of { salesPoint, voucherType, number }"
+        }
+      );
+    }
+    const targets = value.map(
+      (target, index) => assertCreditNoteTarget(target, `for[${index}]`)
+    );
+    const seen = /* @__PURE__ */ new Set();
+    for (const [index, target] of targets.entries()) {
+      const key = `${target.salesPoint}:${target.voucherType}:${target.number}`;
+      if (seen.has(key)) {
+        throw new ArcaInputError(
+          "issueCreditNote requires each original in for to be unique.",
+          {
+            code: "ARCA_INPUT_INVALID_VALUE",
+            field: `input.for[${index}]`,
+            expected: "unique voucher coordinates"
+          }
+        );
+      }
+      seen.add(key);
+    }
+    return targets;
+  }
+  return assertCreditNoteTarget(value, "for");
+}
+function assertCreditNoteTarget(value, path) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
     throw new ArcaInputError(
       "issueCreditNote requires for: the coordinates of the authorized invoice the note corrects.",
       {
         code: "ARCA_INPUT_MISSING_FIELD",
-        field: "input.for",
+        field: `input.${path}`,
         expected: "{ salesPoint, voucherType, number }"
       }
     );
@@ -2741,20 +3220,20 @@ function assertCreditNoteTarget(value) {
   assertIssueKeys(
     value,
     ["salesPoint", "voucherType", "number"],
-    "input.for",
+    `input.${path}`,
     "issueCreditNote()"
   );
   for (const [field, max] of TARGET_BOUNDS) {
-    assertCreditNoteBound(value[field], max, `for.${field}`);
+    assertCreditNoteBound(value[field], max, `${path}.${field}`);
   }
   if (![1, 2, 6, 7, 11, 12, 51, 52, 201, 202, 206, 207, 211, 212].includes(
     value.voucherType
   )) {
     throw new ArcaInputError(
-      "issueCreditNote requires an authorized invoice or debit note in a supported family in for.voucherType. Use the exact service API for manual control.",
+      "issueCreditNote requires an authorized invoice or debit note in a supported family in for.voucherType.",
       {
         code: "ARCA_INPUT_INVALID_VALUE",
-        field: "input.for.voucherType",
+        field: `input.${path}.voucherType`,
         expected: "1, 6 or 11"
       }
     );
@@ -2765,6 +3244,9 @@ function assertCreditNoteTarget(value) {
     number: value.number
   };
 }
+function creditNoteTargets(input) {
+  return Array.isArray(input.for) ? input.for : [input.for];
+}
 function assertCreditNoteBound(value, max, path) {
   if (!Number.isSafeInteger(value) || value < 1 || value > max) {
     throw new ArcaInputError(
@@ -2852,6 +3334,16 @@ function assertFullMode(input) {
       }
     );
   }
+  if (Array.isArray(input.for) && input.for.length > 1) {
+    throw new ArcaInputError(
+      "issueCreditNote takes all: true against one original; a full note of several originals has no single total. Pass items or amounts instead.",
+      {
+        code: "ARCA_INPUT_INVALID_VALUE",
+        field: "input.all",
+        expected: "one original in for when all is true"
+      }
+    );
+  }
 }
 
 // src/services/vouchers.ts
@@ -2938,21 +3430,37 @@ function previewInvoice(input, options) {
 }
 function prepareInvoice(input, options) {
   const prepared = deriveWsfeInvoice(input);
-  if (input.details !== void 0) {
-    prepared.data.details = structuredClone(input.details);
-  }
+  attachLines(prepared, options);
   validatePrepared(prepared, options);
   return prepared;
 }
+function attachLines(prepared, options) {
+  if (options.service !== "wsmtxca") {
+    return;
+  }
+  if (prepared.lineSource === void 0) {
+    throw new ArcaInputError(
+      "WSMTXCA needs items with line detail; a reviewed amounts breakdown has no lines.",
+      { code: "ARCA_INPUT_INVALID_VALUE", field: "amounts" }
+    );
+  }
+  const settlement = deriveWsmtxcaSettlement(
+    prepared.lineSource,
+    prepared.amounts.vatAdjustment
+  );
+  prepared.data.lines = settlement.lines;
+  prepared.data.vatRates = prepared.data.vatRates?.map((rate) => ({
+    ...rate,
+    amount: arcaMinorUnitsToNumber(
+      BigInt(settlement.vatByCondition.get(rate.id) ?? 0),
+      "vatAmount"
+    )
+  }));
+}
 function validatePrepared(prepared, options) {
   validateFiscalHeader(prepared.data);
   if (options.service === "wsmtxca") {
     wsmtxcaRequest(prepared.data);
-  } else if (prepared.data.details !== void 0) {
-    throw new ArcaInputError("Detailed items require service: wsmtxca", {
-      code: "ARCA_INPUT_INVALID_VALUE",
-      field: "details"
-    });
   }
 }
 function toPreview(prepared, options) {
@@ -3038,12 +3546,15 @@ async function runOperation(wsfe, operation, input, prepare, options, context, r
         supersededBy: idempotencyKey,
         readNext: () => nextNumber(wsfe, prepared.data, options)
       });
-      return "blocked" in barrier ? barrier.blocked : await claim(barrier.reserved);
+      return "blocked" in barrier ? {
+        ...barrier.blocked,
+        ...requestEvidence(prepared.data, void 0, options)
+      } : await claim(barrier.reserved);
     }
   );
   function reservation(number) {
     const service = options.service ?? "wsfe";
-    const versioned = service === "wsmtxca" || prepared.data.details !== void 0;
+    const versioned = service === "wsmtxca" || prepared.data.lines !== void 0;
     return {
       v: versioned ? 2 : 1,
       operation,
@@ -3075,7 +3586,7 @@ async function runOperation(wsfe, operation, input, prepare, options, context, r
       await storeCall(() => store.set(sequenceRecord, JSON.stringify(claimed)));
     }
     if (await storeCall(() => store.add(key, JSON.stringify(record)))) {
-      const outcome = await settle(
+      const outcome = await settle2(
         runAuthorization(wsfe, prepared, options, number)
       );
       if (coordinated && outcome.kind !== "indeterminate") {
@@ -3118,7 +3629,7 @@ async function runOperation(wsfe, operation, input, prepare, options, context, r
           (other) => storeCall(() => store.get(settledKey(environment, taxId, other)))
         );
       }
-      return await settle(
+      return await settle2(
         runAuthorization(
           wsfe,
           {
@@ -3144,7 +3655,7 @@ async function runOperation(wsfe, operation, input, prepare, options, context, r
       consult
     );
   }
-  async function settle(running) {
+  async function settle2(running) {
     return await recordConflict(store, settled, await running);
   }
 }
@@ -3157,7 +3668,7 @@ async function recordConflict(store, key, outcome) {
     kind: "conflict",
     number: outcome.attempted.number,
     found: Object.fromEntries(
-      Object.entries(outcome.found).filter(([field]) => field !== "raw")
+      Object.entries(outcome.found).filter(([field]) => field !== "rawResponse")
     ),
     settledAt: (/* @__PURE__ */ new Date()).toISOString()
   };
@@ -3180,7 +3691,7 @@ function readSettledRecord(json) {
 }
 async function settledOutcome(select, reservation, settled, options, settledFor) {
   if (settled.kind === "conflict") {
-    return settledConflict(settled, reservation);
+    return settledConflict(settled, reservation, options);
   }
   const outcome = await consultReservation(select, reservation, options, true);
   const empty = outcome.kind === "indeterminate" && outcome.lookup.kind === "not_found";
@@ -3195,7 +3706,12 @@ async function settledOutcome(select, reservation, settled, options, settledFor)
       number: settled.number
     },
     attempt: replayEvidence(reservation.service),
-    lookup: { kind: "superseded", by: settled.by }
+    lookup: { kind: "superseded", by: settled.by },
+    ...requestEvidence(
+      preparedFromRecord(reservation).data,
+      reservation.number,
+      { ...options, service: reservation.service ?? "wsfe" }
+    )
   };
 }
 async function successionDisputed(key, settledFor) {
@@ -3213,7 +3729,7 @@ async function successionDisputed(key, settledFor) {
   }
   return true;
 }
-function settledConflict(settled, reservation) {
+function settledConflict(settled, reservation, options) {
   return {
     kind: "conflict",
     attempted: {
@@ -3223,7 +3739,12 @@ function settledConflict(settled, reservation) {
     },
     attempt: replayEvidence(reservation.service),
     found: settled.found,
-    reason: "This key already recorded another voucher at the reserved number. Reconcile before issuing under a new key."
+    reason: "This key already recorded another voucher at the reserved number. Reconcile before issuing under a new key.",
+    ...requestEvidence(
+      preparedFromRecord(reservation).data,
+      reservation.number,
+      { ...options, service: reservation.service ?? "wsfe" }
+    )
   };
 }
 function validateKeyStore(options, context) {
@@ -3280,7 +3801,7 @@ async function nextNumber(wsfe, data, options) {
   const number = await wsfe.getNextVoucherNumber({
     representedTaxId: options.representedTaxId,
     forceRefresh: options.forceRefresh,
-    ...options.signal === void 0 ? {} : { signal: options.signal },
+    ...options.abortSignal === void 0 ? {} : { abortSignal: options.abortSignal },
     salesPoint: data.salesPoint,
     voucherType: data.voucherType
   });
@@ -3299,17 +3820,16 @@ async function runAuthorization(wsfe, { data, voucherClass, amounts }, options,
   const auth = {
     representedTaxId: options.representedTaxId,
     forceRefresh: options.forceRefresh,
-    ...options.signal === void 0 ? {} : { signal: options.signal }
+    ...options.abortSignal === void 0 ? {} : { abortSignal: options.abortSignal }
   };
-  const includeRaw = options.include?.raw === true;
-  const includeExact = options.include?.exactInput === true;
+  const includeRawResponse = options.include?.rawResponse === true;
   const number = reservedNumber ?? await nextNumber(wsfe, data, options);
   const attempted = {
     salesPoint: data.salesPoint,
     voucherType: data.voucherType,
     number
   };
-  const exact = exactEvidence(data, number, options, includeExact);
+  const includedRequest = requestEvidence(data, number, options);
   const voucher = (cae, caeExpiry) => ({
     ...attempted,
     voucherClass,
@@ -3323,8 +3843,8 @@ async function runAuthorization(wsfe, { data, voucherClass, amounts }, options,
     auth,
     data,
     attempted,
-    includeRaw,
-    exact,
+    includeRawResponse,
+    includedRequest,
     voucher,
     service: options.service
   };
@@ -3338,7 +3858,8 @@ async function runAuthorization(wsfe, { data, voucherClass, amounts }, options,
         kind: "indeterminate",
         attempted,
         attempt: attempt2,
-        lookup: options.signal?.aborted ? { kind: "aborted" } : { kind: "failed", error: toArcaSafeErrorMetadata(error) }
+        lookup: options.abortSignal?.aborted ? { kind: "aborted" } : { kind: "failed", error: toArcaSafeErrorMetadata(error) },
+        ...includedRequest
       };
     }
     if (lookup.kind === "found") {
@@ -3355,8 +3876,8 @@ async function runAuthorization(wsfe, { data, voucherClass, amounts }, options,
       kind: "authorized",
       recoveredByMatch: false,
       voucher: voucher(authorization.cae, authorization.caeExpiry),
-      authorization: projectEvidence(authorization, includeRaw),
-      ...exact
+      authorization: projectEvidence(authorization, includeRawResponse),
+      ...includedRequest
     };
   }
   if (authorization.kind === "rejected") {
@@ -3364,7 +3885,7 @@ async function runAuthorization(wsfe, { data, voucherClass, amounts }, options,
       authorization,
       recovery,
       options,
-      includeRaw,
+      includeRawResponse,
       replay
     );
   }
@@ -3373,7 +3894,7 @@ async function runAuthorization(wsfe, { data, voucherClass, amounts }, options,
     kind: "indeterminate",
     reason: authorization.voucherNumber === number ? "incomplete_response" : "contradictory_response"
   };
-  const attempt = projectEvidence(uncertain, includeRaw);
+  const attempt = projectEvidence(uncertain, includeRawResponse);
   return recoverInvoice({
     wsfe,
     service: options.service,
@@ -3381,12 +3902,12 @@ async function runAuthorization(wsfe, { data, voucherClass, amounts }, options,
     data,
     attempted,
     attempt,
-    includeRaw,
-    exact,
+    includeRawResponse,
+    includedRequest,
     voucher
   });
 }
-async function resolveRejection(authorization, recovery, options, includeRaw, replay) {
+async function resolveRejection(authorization, recovery, options, includeRawResponse, replay) {
   const issues = [...authorization.errors, ...authorization.observations];
   const consult = options.idempotencyKey !== void 0 && (options.service === "wsmtxca" || issues.some((issue) => issue.code === "10016"));
   if (consult) {
@@ -3398,7 +3919,7 @@ async function resolveRejection(authorization, recovery, options, includeRaw, re
           kind: "indeterminate",
           reason: "contradictory_response"
         },
-        includeRaw
+        includeRawResponse
       ),
       strangerAtNumber: !replay
     });
@@ -3410,7 +3931,8 @@ async function resolveRejection(authorization, recovery, options, includeRaw, re
     kind: "rejected",
     attempted: recovery.attempted,
     issues: issues.map(projectIssue),
-    authorization: projectEvidence(authorization, includeRaw)
+    authorization: projectEvidence(authorization, includeRawResponse),
+    ...recovery.includedRequest
   };
 }
 async function recoverInvoice({
@@ -3419,19 +3941,20 @@ async function recoverInvoice({
   data,
   attempted,
   attempt,
-  includeRaw,
-  exact,
+  includeRawResponse,
+  includedRequest,
   voucher,
   lookup: suppliedLookup,
   service,
   strangerAtNumber = false
 }) {
-  if (suppliedLookup === void 0 && auth.signal?.aborted) {
+  if (suppliedLookup === void 0 && auth.abortSignal?.aborted) {
     return {
       kind: "indeterminate",
       attempted,
       attempt,
-      lookup: { kind: "aborted" }
+      lookup: { kind: "aborted" },
+      ...includedRequest
     };
   }
   let lookup;
@@ -3442,16 +3965,18 @@ async function recoverInvoice({
       kind: "indeterminate",
       attempted,
       attempt,
-      lookup: auth.signal?.aborted ? { kind: "aborted" } : { kind: "failed", error: toArcaSafeErrorMetadata(error) }
+      lookup: auth.abortSignal?.aborted ? { kind: "aborted" } : { kind: "failed", error: toArcaSafeErrorMetadata(error) },
+      ...includedRequest
     };
   }
-  const raw = includeRaw ? { raw: lookup.raw } : {};
+  const rawResponse = includeRawResponse ? { rawResponse: lookup.raw } : {};
   if (lookup.kind === "not_found") {
     return {
       kind: "indeterminate",
       attempted,
       attempt,
-      lookup: { kind: "not_found", ...raw }
+      lookup: { kind: "not_found", ...rawResponse },
+      ...includedRequest
     };
   }
   if (strangerAtNumber) {
@@ -3459,8 +3984,9 @@ async function recoverInvoice({
       kind: "conflict",
       attempted,
       attempt,
-      found: { ...toVoucherSummary(lookup.voucher), ...raw },
-      reason: "ARCA refused the number this call reserved and another voucher occupies it"
+      found: { ...toVoucherSummary(lookup.voucher), ...rawResponse },
+      reason: "ARCA refused the number this call reserved and another voucher occupies it",
+      ...includedRequest
     };
   }
   const detailsMatch = service === "wsmtxca" ? matchWsmtxcaDetails(data, attempted.number, lookup.voucher.raw) : void 0;
@@ -3475,15 +4001,21 @@ async function recoverInvoice({
         kind: "conflict",
         attempted,
         attempt,
-        found: { ...toVoucherSummary(lookup.voucher), ...raw },
-        reason: `${matched.reason}. Configure a store and pass idempotencyKey for retries.`
+        found: { ...toVoucherSummary(lookup.voucher), ...rawResponse },
+        reason: `${matched.reason}. Configure a store and pass idempotencyKey for retries.`,
+        ...includedRequest
       };
     }
     return {
       kind: "indeterminate",
       attempted,
       attempt,
-      lookup: { kind: "incomplete", reason: matched.reason, ...raw }
+      lookup: {
+        kind: "incomplete",
+        reason: matched.reason,
+        ...rawResponse
+      },
+      ...includedRequest
     };
   }
   return {
@@ -3494,8 +4026,8 @@ async function recoverInvoice({
       lookup.voucher.caeExpiry
     ),
     attempt,
-    lookup: { ...toVoucherSummary(lookup.voucher), ...raw },
-    ...exact
+    lookup: { ...toVoucherSummary(lookup.voucher), ...rawResponse },
+    ...includedRequest
   };
 }
 function projectIssue(issue) {
@@ -3509,7 +4041,7 @@ function projectIssue(issue) {
     ...issue.resultLevel === void 0 ? {} : { resultLevel: issue.resultLevel }
   };
 }
-function projectEvidence(evidence, includeRaw) {
+function projectEvidence(evidence, includeRawResponse) {
   const base = {
     kind: evidence.kind,
     service: evidence.service,
@@ -3521,7 +4053,7 @@ function projectEvidence(evidence, includeRaw) {
     },
     errors: evidence.errors.map(projectIssue),
     observations: evidence.observations.map(projectIssue),
-    ...includeRaw && evidence.raw !== void 0 ? { raw: evidence.raw } : {}
+    ...includeRawResponse && evidence.raw !== void 0 ? { rawResponse: evidence.raw } : {}
   };
   const projected = { ...base };
   for (const field of [
@@ -3548,10 +4080,10 @@ function projectEvidence(evidence, includeRaw) {
 }
 function cloneOptions(options) {
   assertIssueObject(options, "options");
-  const { signal, ...rest } = options;
+  const { abortSignal, ...rest } = options;
   return {
     ...structuredClone(rest),
-    ...signal === void 0 ? {} : { signal }
+    ...abortSignal === void 0 ? {} : { abortSignal }
   };
 }
 function validateOptions(options) {
@@ -3565,14 +4097,14 @@ function validateOptions(options) {
       "idempotencyKey",
       "service",
       "number",
-      "signal"
+      "abortSignal"
     ],
     "options"
   );
-  if (options.signal !== void 0 && (typeof options.signal !== "object" || options.signal === null || typeof options.signal.aborted !== "boolean" || typeof options.signal.addEventListener !== "function")) {
-    throw new ArcaInputError("options.signal must be an AbortSignal.", {
+  if (options.abortSignal !== void 0 && (typeof options.abortSignal !== "object" || options.abortSignal === null || typeof options.abortSignal.aborted !== "boolean" || typeof options.abortSignal.addEventListener !== "function")) {
+    throw new ArcaInputError("options.abortSignal must be an AbortSignal.", {
       code: "ARCA_INPUT_INVALID_VALUE",
-      field: "options.signal"
+      field: "options.abortSignal"
     });
   }
   if (options.service !== void 0 && options.service !== "wsfe" && options.service !== "wsmtxca") {
@@ -3603,8 +4135,12 @@ function validateOptions(options) {
   }
   if (options.include !== void 0) {
     assertIssueObject(options.include, "options.include");
-    assertIssueKeys(options.include, ["raw", "exactInput"], "options.include");
-    for (const field of ["raw", "exactInput"]) {
+    assertIssueKeys(
+      options.include,
+      ["request", "rawResponse"],
+      "options.include"
+    );
+    for (const field of ["request", "rawResponse"]) {
       if (options.include[field] !== void 0 && typeof options.include[field] !== "boolean") {
         throw new ArcaInputError(
           `options.include.${field} must be a boolean.`,
@@ -3652,16 +4188,17 @@ async function issueCreditNote(wsfe, input, inputOptions, context, kind = "credi
   );
 }
 async function previewNote(wsfe, input, inputOptions, context, kind) {
-  const options = structuredClone(inputOptions);
+  const options = cloneOptions(inputOptions);
   assertIssueKeys(
     options,
-    ["representedTaxId", "service", "forceRefresh"],
+    ["representedTaxId", "service", "forceRefresh", "abortSignal"],
     "options"
   );
-  return toPreview(
-    await prepareNote(wsfe, input, options, context, kind),
-    options
-  );
+  const prepared = await prepareNote(wsfe, input, options, context, kind);
+  return {
+    ...toPreview(prepared, options),
+    ...prepared.originals === void 0 ? {} : { originals: prepared.originals }
+  };
 }
 async function prepareNote(wsfe, input, options, context, kind) {
   validateOptions(options);
@@ -3675,10 +4212,72 @@ async function prepareNote(wsfe, input, options, context, kind) {
       code: "ARCA_INPUT_INVALID_VALUE"
     });
   }
-  const target = note.for;
+  const targets = creditNoteTargets(note);
+  validateFceAssociations(note, targets, options.service ?? "wsfe");
+  const originals = [];
+  for (const target of targets) {
+    originals.push(await lookupOriginal(wsfe, target, options));
+  }
+  const [firstOriginal] = originals;
+  const prepared = note.all === true ? deriveWsfeFullCreditNote(firstOriginal, note) : deriveWsfePartialCreditNote(originals, note, /* @__PURE__ */ new Date(), kind);
+  if (note.all === true) {
+    const mirrored = firstOriginal.lines;
+    if (mirrored !== void 0) {
+      prepared.data.authorizedLines = structuredClone(mirrored);
+    }
+  } else {
+    attachLines(prepared, options);
+  }
+  if (voucherFamily(prepared.data.voucherType).family === "fce") {
+    const taxId = options.representedTaxId ?? context?.taxId;
+    if (!taxId) {
+      throw new ArcaInputError("FCE association requires the issuer tax ID", {
+        code: "ARCA_INPUT_MISSING_FIELD",
+        field: "representedTaxId"
+      });
+    }
+    for (const associated of prepared.data.associatedVouchers ?? []) {
+      associated.taxId = String(taxId);
+    }
+  }
+  validatePrepared(prepared, options);
+  return { ...prepared, originals: originals.map(toVoucherSummary) };
+}
+function validateFceAssociations(note, targets, service) {
+  const fceTargets = targets.filter(
+    (target2) => voucherFamily(target2.voucherType).family === "fce"
+  );
+  if (fceTargets.length === 0) {
+    return;
+  }
+  const nonAnnulment = normalizedFceAnnulment(note) === false;
+  if ((service === "wsmtxca" || nonAnnulment) && targets.length !== 1) {
+    throw new ArcaInputError(
+      service === "wsmtxca" ? "WSMTXCA FCE notes require exactly one associated original." : "Non-annulment FCE notes require exactly one associated invoice.",
+      {
+        code: "ARCA_INPUT_INVALID_VALUE",
+        field: "input.for",
+        expected: "one FCE original"
+      }
+    );
+  }
+  const [target] = targets;
+  if (nonAnnulment && target !== void 0 && voucherFamily(target.voucherType).types[0] !== target.voucherType) {
+    throw new ArcaInputError(
+      "Non-annulment FCE notes must be associated to an FCE invoice.",
+      {
+        code: "ARCA_INPUT_INVALID_VALUE",
+        field: "input.for.voucherType",
+        expected: "an FCE invoice type"
+      }
+    );
+  }
+}
+async function lookupOriginal(wsfe, target, options) {
   const original = await wsfe.lookupVoucher({
     representedTaxId: options.representedTaxId,
     forceRefresh: options.forceRefresh,
+    ...options.abortSignal === void 0 ? {} : { abortSignal: options.abortSignal },
     ...target
   });
   if (original.kind !== "found") {
@@ -3693,28 +4292,7 @@ async function prepareNote(wsfe, input, options, context, kind) {
       { code: "ARCA_INPUT_INVALID_VALUE", field: "input.for" }
     );
   }
-  const prepared = note.all === true ? deriveWsfeFullCreditNote(original.voucher, note) : deriveWsfePartialCreditNote(original.voucher, note, /* @__PURE__ */ new Date(), kind);
-  if (note.details !== void 0) {
-    prepared.data.details = structuredClone(note.details);
-  } else if (note.all && "details" in original.voucher) {
-    prepared.data.details = structuredClone(
-      original.voucher.details
-    );
-  }
-  if (voucherFamily(prepared.data.voucherType).family === "fce") {
-    const taxId = options.representedTaxId ?? context?.taxId;
-    if (!taxId) {
-      throw new ArcaInputError("FCE association requires the issuer tax ID", {
-        code: "ARCA_INPUT_MISSING_FIELD",
-        field: "representedTaxId"
-      });
-    }
-    for (const associated of prepared.data.associatedVouchers ?? []) {
-      associated.taxId = String(taxId);
-    }
-  }
-  validatePrepared(prepared, options);
-  return prepared;
+  return original.voucher;
 }
 function preparePeriodNote(input, options, kind) {
   const { associatedPeriod, ...invoice } = input;
@@ -3743,9 +4321,9 @@ function preparePeriodNote(input, options, kind) {
   validatePrepared(prepared, options);
   return prepared;
 }
-function exactEvidence(data, number, options, include) {
-  return include ? {
-    sent: options.service === "wsmtxca" ? wsmtxcaRequest(data, number) : data
+function requestEvidence(data, number, options) {
+  return options.include?.request === true ? {
+    request: options.service === "wsmtxca" ? wsmtxcaRequest(data, number) : data
   } : {};
 }
 async function recoverOperation(select, key, inputOptions, context) {
@@ -3753,7 +4331,7 @@ async function recoverOperation(select, key, inputOptions, context) {
   assertIssueObject(options, "options");
   assertIssueKeys(
     options,
-    ["representedTaxId", "forceRefresh", "include", "signal"],
+    ["representedTaxId", "forceRefresh", "include", "abortSignal"],
     "options"
   );
   validateOptions(options);
@@ -3769,7 +4347,7 @@ async function recoverOperation(select, key, inputOptions, context) {
   );
   if (json === null) {
     throw new ArcaInputError("No reservation exists for this idempotency key", {
-      code: "ARCA_INPUT_INVALID_VALUE",
+      code: "ARCA_INPUT_RESERVATION_NOT_FOUND",
       field: "idempotencyKey"
     });
   }
@@ -3830,12 +4408,11 @@ function consultReservation(select, record, options, strangerAtNumber = false) {
     strangerAtNumber,
     attempted,
     attempt: replayEvidence(storedOptions.service),
-    includeRaw: options.include?.raw === true,
-    exact: exactEvidence(
+    includeRawResponse: options.include?.rawResponse === true,
+    includedRequest: requestEvidence(
       prepared.data,
       record.number,
-      storedOptions,
-      options.include?.exactInput === true
+      storedOptions
     ),
     voucher: (cae, caeExpiry) => ({
       ...attempted,
@@ -3890,7 +4467,7 @@ async function runSequenceBarrier({
     settled,
     await consultReservation(select, record, {
       forceRefresh: options.forceRefresh,
-      ...options.signal === void 0 ? {} : { signal: options.signal }
+      ...options.abortSignal === void 0 ? {} : { abortSignal: options.abortSignal }
     })
   );
   if (outcome.kind === "authorized" || outcome.kind === "conflict") {
@@ -4088,10 +4665,12 @@ function createArcaClient(config = {}) {
 // src/store/file.ts
 import { createHash as createHash3, randomUUID as randomUUID2 } from "crypto";
 import {
+  link,
   mkdir,
+  open,
   readFile,
   rename,
-  rm,
+  rmdir,
   stat,
   unlink,
   writeFile
@@ -4194,35 +4773,28 @@ function fileLease(directory, ensure) {
     owner,
     expiresAt: new Date(Date.now() + ARCA_LEASE_MS).toISOString()
   });
-  const read = async () => {
-    try {
-      return JSON.parse(await readFile(holder, "utf8"));
-    } catch {
-      return null;
-    }
-  };
   return {
     acquire: (owner) => storeCall(async () => {
       await ensure();
       if (!await createDirectory(directory)) {
-        if (await stillHeld(directory, await read())) {
+        const current = await readHolder(holder);
+        if (await stillHeld(directory, current?.value ?? null)) {
           return false;
         }
-        await rm(directory, { recursive: true, force: true });
-        if (!await createDirectory(directory)) {
-          return false;
+        if (current) {
+          await retireHolder(directory, holder, current.raw);
+        } else {
+          await removeEmptyDirectory(directory);
         }
+        return false;
       }
       return await writeHolder(holder, claim(owner));
     }),
-    renew: (owner) => storeCall(async () => {
-      if ((await read())?.owner === owner) {
-        await writeFile(holder, claim(owner), { mode: 384 });
-      }
-    }),
+    renew: (owner) => storeCall(() => renewHolder(holder, owner, claim(owner))),
     release: (owner) => storeCall(async () => {
-      if ((await read())?.owner === owner) {
-        await rm(directory, { recursive: true, force: true });
+      const current = await readHolder(holder);
+      if (current?.value?.owner === owner) {
+        await retireHolder(directory, holder, current.raw);
       }
     })
   };
@@ -4243,12 +4815,105 @@ async function writeHolder(holder, value) {
     await writeFile(holder, value, { mode: 384, flag: "wx" });
     return true;
   } catch (error) {
-    if (error.code === "EEXIST") {
+    if (error.code === "EEXIST" || error.code === "ENOENT") {
       return false;
     }
     throw error;
   }
 }
+async function readHolder(holder) {
+  let raw;
+  try {
+    raw = await readFile(holder, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+  try {
+    return { raw, value: JSON.parse(raw) };
+  } catch {
+    return { raw, value: null };
+  }
+}
+async function renewHolder(holder, owner, value) {
+  let file;
+  try {
+    file = await open(holder, "r+");
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return;
+    }
+    throw error;
+  }
+  try {
+    let current = null;
+    try {
+      current = JSON.parse(await file.readFile("utf8"));
+    } catch {
+    }
+    if (current?.owner === owner) {
+      await file.truncate(0);
+      await file.write(value, 0, "utf8");
+    }
+  } finally {
+    await file.close();
+  }
+}
+async function retireHolder(directory, holder, expected) {
+  const retired = `${directory}.${randomUUID2()}.stale`;
+  try {
+    await rename(holder, retired);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return;
+    }
+    throw error;
+  }
+  let removed = false;
+  try {
+    if (await readFile(retired, "utf8") !== expected) {
+      return;
+    }
+    try {
+      await rmdir(directory);
+      removed = true;
+    } catch (error) {
+      if (!isDirectoryContention(error)) {
+        throw error;
+      }
+    }
+  } finally {
+    if (!removed) {
+      await restoreHolder(retired, holder);
+    }
+    await unlink(retired).catch(() => void 0);
+  }
+}
+async function restoreHolder(retired, holder) {
+  try {
+    await link(retired, holder);
+  } catch (error) {
+    const code = error.code;
+    if (code !== "EEXIST" && code !== "ENOENT") {
+      throw error;
+    }
+  }
+}
+async function removeEmptyDirectory(directory) {
+  try {
+    await rmdir(directory);
+  } catch (error) {
+    if (!isDirectoryContention(error)) {
+      throw error;
+    }
+  }
+}
+function isDirectoryContention(error) {
+  const code = error.code;
+  return code === "ENOENT" || code === "ENOTEMPTY" || code === "EEXIST";
+}
 async function stillHeld(directory, holder) {
   if (holder) {
     return Date.parse(holder.expiresAt) > Date.now();
@@ -4278,4 +4943,4 @@ export {
   withLease,
   createFileStore
 };
-//# sourceMappingURL=chunk-G7BWMDFT.mjs.map
+//# sourceMappingURL=chunk-KPWAQMR5.mjs.map