@getpeppr/cli 0.5.0 → 0.5.2

package/dist/index.js

@@ -418,17 +418,16 @@ function calculateTaxSubtotals(lines, allowances, charges) {
   const groups = /* @__PURE__ */ new Map();
   function addToGroup(vatCategory, vatRate, amount) {
     const key = `${vatCategory}-${vatRate}`;
-    const lineTax = round2(amount * (vatRate / 100));
     const existing = groups.get(key);
     if (existing) {
       existing.taxableAmount = round2(existing.taxableAmount + amount);
-      existing.taxAmount = round2(existing.taxAmount + lineTax);
     } else {
       groups.set(key, {
         vatRate,
         vatCategory,
         taxableAmount: amount,
-        taxAmount: lineTax
+        taxAmount: 0
+        // computed once per group below (BR-CO-17)
       });
     }
   }
@@ -441,7 +440,10 @@ function calculateTaxSubtotals(lines, allowances, charges) {
   for (const c of charges ?? []) {
     addToGroup(c.vatCategory ?? "S", c.vatRate, c.amount);
   }
-  return Array.from(groups.values());
+  return Array.from(groups.values()).map((subtotal) => ({
+    ...subtotal,
+    taxAmount: round2(subtotal.taxableAmount * (subtotal.vatRate / 100))
+  }));
 }
 function calculateDocumentTotals(lines, allowances, charges) {
   const taxSubtotals = calculateTaxSubtotals(lines, allowances, charges);
@@ -486,10 +488,13 @@ function buildTaxCurrencyTotalXml(totalTax, taxCurrency, rate) {
     <cbc:TaxAmount currencyID="${escapeXml(taxCurrency)}">${formatAmount(convertedAmount)}</cbc:TaxAmount>
   </cac:TaxTotal>`;
 }
+function payableFromTaxInclusive(taxInclusiveAmount, prepaidAmount, roundingAmount) {
+  return Number((taxInclusiveAmount - (prepaidAmount ?? 0) + (roundingAmount ?? 0)).toFixed(2));
+}
 function buildLegalMonetaryTotalXml(totals, currency, options) {
   const prepaid = options?.prepaidAmount;
   const rounding = options?.roundingAmount;
-  const payableAmount = totals.taxInclusiveAmount - (prepaid ?? 0) + (rounding ?? 0);
+  const payableAmount = payableFromTaxInclusive(totals.taxInclusiveAmount, prepaid, rounding);
   return `<cac:LegalMonetaryTotal>
     <cbc:LineExtensionAmount currencyID="${escapeXml(currency)}">${formatAmount(totals.lineExtensionAmount)}</cbc:LineExtensionAmount>
     <cbc:TaxExclusiveAmount currencyID="${escapeXml(currency)}">${formatAmount(totals.taxExclusiveAmount)}</cbc:TaxExclusiveAmount>
@@ -626,6 +631,47 @@ function buildCreditNoteXml(input) {
 </CreditNote>`;
 }
 
+// ../sdk/dist/core/checksums/luhn.js
+function isValidLuhn(input) {
+  if (typeof input !== "string")
+    return false;
+  if (!/^\d+$/.test(input))
+    return false;
+  let sum = 0;
+  let alt = false;
+  for (let i = input.length - 1; i >= 0; i--) {
+    let n = input.charCodeAt(i) - 48;
+    if (alt) {
+      n *= 2;
+      if (n > 9)
+        n -= 9;
+    }
+    sum += n;
+    alt = !alt;
+  }
+  return sum % 10 === 0;
+}
+var LA_POSTE_SIREN = "356000000";
+function isValidLuhnSiret(input) {
+  if (typeof input !== "string")
+    return false;
+  if (!/^\d{14}$/.test(input))
+    return false;
+  const siren = input.slice(0, 9);
+  if (!isValidLuhn(siren))
+    return false;
+  if (isValidLuhn(input))
+    return true;
+  if (siren === LA_POSTE_SIREN) {
+    let sum = 0;
+    for (let i = 0; i < input.length; i++) {
+      sum += input.charCodeAt(i) - 48;
+    }
+    return sum % 5 === 0;
+  }
+  return false;
+}
+
 // ../sdk/dist/core/country-rules.js
 function warn(field, message, ruleId) {
   return { field, message, ruleId };
@@ -660,15 +706,47 @@ function validateBelgiumSeller(input, _errors, warnings) {
     warnings.push(warn("paymentReference", "Belgian sellers typically include a structured communication reference (+++NNN/NNNN/NNNNN+++ format).", "BE-02"));
   }
 }
+var FR_SIREN_RE = /^\d{9}$/;
 var FR_SIRET_RE = /^\d{14}$/;
-var FR_VAT_RE = /^FR[A-Z0-9]{2}\d{9}$/;
+var FR_VAT_RE = /^FR[0-9A-HJ-NP-Z]{2}\d{9}$/;
+var FR_VAT_NUMERIC_KEY_RE = /^FR(\d{2})(\d{9})$/;
+var FR_SIREN_BASED_SCHEMES = ["0002", "0009", "0225"];
+function frVatKey(siren) {
+  return (12 + 3 * (Number(siren) % 97)) % 97;
+}
+function isValidSirenOrSiret(id) {
+  if (FR_SIREN_RE.test(id))
+    return isValidLuhn(id);
+  if (FR_SIRET_RE.test(id))
+    return isValidLuhnSiret(id);
+  return false;
+}
 function validateFrance(input, _errors, warnings) {
-  const { companyId, vatNumber } = input.to ?? {};
-  if (companyId && !FR_SIRET_RE.test(companyId)) {
-    warnings.push(warn("to.companyId", `French company ID (SIRET) should be exactly 14 digits, got "${companyId}".`, "FR-01"));
+  const { companyId, companyIdScheme, vatNumber } = input.to ?? {};
+  const companyIdIsSiren = !companyIdScheme || FR_SIREN_BASED_SCHEMES.includes(companyIdScheme);
+  if (companyId != null && companyId !== "" && companyIdIsSiren) {
+    if (typeof companyId !== "string") {
+      warnings.push(warn("to.companyId", "French company ID should be a string of 9 (SIREN) or 14 (SIRET) digits.", "FR-01"));
+    } else if (!FR_SIREN_RE.test(companyId) && !FR_SIRET_RE.test(companyId)) {
+      warnings.push(warn("to.companyId", `French company ID should be a 9-digit SIREN or 14-digit SIRET, got "${companyId}".`, "FR-01"));
+    } else if (!isValidSirenOrSiret(companyId)) {
+      warnings.push(warn("to.companyId", `French company ID "${companyId}" has an invalid checksum. Verify the SIREN/SIRET.`, "FR-01"));
+    }
   }
-  if (vatNumber && !FR_VAT_RE.test(vatNumber)) {
-    warnings.push(warn("to.vatNumber", `French VAT number should match format FR + 2 characters + 9 digits (SIREN), got "${vatNumber}".`, "FR-02"));
+  if (vatNumber != null && vatNumber !== "") {
+    if (typeof vatNumber !== "string") {
+      warnings.push(warn("to.vatNumber", "French VAT number should be a string matching FR + 2 characters + 9 digits (SIREN).", "FR-02"));
+    } else if (!FR_VAT_RE.test(vatNumber)) {
+      warnings.push(warn("to.vatNumber", `French VAT number should match format FR + 2 characters + 9 digits (SIREN), got "${vatNumber}".`, "FR-02"));
+    } else {
+      const numericKey = FR_VAT_NUMERIC_KEY_RE.exec(vatNumber);
+      if (numericKey) {
+        const [, key, siren] = numericKey;
+        if (Number(key) !== frVatKey(siren)) {
+          warnings.push(warn("to.vatNumber", `French VAT number "${vatNumber}" has an invalid verification key \u2014 expected FR${String(frVatKey(siren)).padStart(2, "0")}${siren}. Likely a typo.`, "FR-03"));
+        }
+      }
+    }
   }
 }
 function validateItaly(input, _errors, warnings) {
@@ -1058,8 +1136,32 @@ function validateInvoice(input) {
   };
 }
 
+// ../sdk/dist/core/status-precedence.js
+var STATUS_PRECEDENCE = [
+  { status: "failed", family: "terminal-failure" },
+  { status: "rejected", family: "terminal-failure" },
+  { status: "paid", family: "terminal-success" },
+  { status: "partially_paid", family: "progress" },
+  { status: "accepted", family: "progress" },
+  { status: "conditionally_accepted", family: "progress" },
+  { status: "under_query", family: "progress" },
+  { status: "in_process", family: "progress" },
+  { status: "cleared", family: "progress" },
+  { status: "delivered", family: "progress" },
+  { status: "acknowledged", family: "progress" },
+  // Terminal for developer wait semantics only — stays rank 40 (non-terminal)
+  // in the projection guard (§3.12 two-level terminality).
+  { status: "no_action", family: "terminal-failure" },
+  { status: "submitted", family: "progress" },
+  { status: "unknown", family: "fallback" }
+];
+function statusFamily(status) {
+  return STATUS_PRECEDENCE.find((e) => e.status === status)?.family ?? "fallback";
+}
+var TERMINAL_FAILURE_STATUSES = STATUS_PRECEDENCE.filter((e) => e.family === "terminal-failure").map((e) => e.status);
+
 // ../sdk/dist/version.js
-var SDK_VERSION = "2.0.0";
+var SDK_VERSION = "2.4.0";
 
 // ../sdk/dist/core/client.js
 function findHeaderCaseInsensitive(headers, name) {
@@ -1636,14 +1738,21 @@ function detectMimeType(filename) {
   }
 }
 function parseSendResult(result) {
-  return {
+  const rawStatus = result.status == null ? void 0 : String(result.status);
+  const sendResult = {
     id: String(result.id ?? ""),
-    status: mapStatus(String(result.status ?? "submitted")),
+    status: mapStatus(rawStatus ?? "submitted"),
     peppolMessageId: result.peppolMessageId ?? result.peppol_message_id,
     createdAt: String(result.createdAt ?? result.updatedAt ?? result.created_at ?? (/* @__PURE__ */ new Date()).toISOString()),
     ublXml: result.ublXml,
     warnings: Array.isArray(result.warnings) ? result.warnings : void 0
   };
+  if (rawStatus !== void 0)
+    sendResult.rawStatus = rawStatus;
+  const detail = parseStatusDetail(result.detail);
+  if (detail)
+    sendResult.detail = detail;
+  return sendResult;
 }
 function parseDirectoryEntry(result) {
   const participant = isRecord(result.participant) ? result.participant : result;
@@ -1679,6 +1788,51 @@ function formatPeppolId(scheme, id) {
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+var STATUS_DETAIL_AXES = ["platformFiscal", "delivery", "businessDisposition", "settlement"];
+function parseStatusDetailEntry(raw) {
+  if (!isRecord(raw) || typeof raw.axis !== "string" || typeof raw.jurisdiction !== "string" || typeof raw.code !== "string" || typeof raw.label !== "string" || typeof raw.codeSystem !== "string" || typeof raw.codeVersion !== "string") {
+    return void 0;
+  }
+  const entry = {
+    axis: raw.axis,
+    jurisdiction: raw.jurisdiction,
+    code: raw.code,
+    label: raw.label,
+    codeSystem: raw.codeSystem,
+    codeVersion: raw.codeVersion
+  };
+  if (isRecord(raw.standardCode) && typeof raw.standardCode.system === "string" && typeof raw.standardCode.code === "string") {
+    entry.standardCode = { system: raw.standardCode.system, code: raw.standardCode.code };
+  }
+  if (typeof raw.reason === "string")
+    entry.reason = raw.reason;
+  if (Array.isArray(raw.warnings) && raw.warnings.every((w) => typeof w === "string")) {
+    entry.warnings = [...raw.warnings];
+  }
+  if (typeof raw.failureCategory === "string") {
+    entry.failureCategory = raw.failureCategory;
+  }
+  if (isRecord(raw.payment) && typeof raw.payment.amount === "number" && typeof raw.payment.currency === "string" && typeof raw.payment.date === "string") {
+    entry.payment = { amount: raw.payment.amount, currency: raw.payment.currency, date: raw.payment.date };
+  }
+  if (typeof raw.paymentSemantics === "string") {
+    entry.paymentSemantics = raw.paymentSemantics;
+  }
+  if (typeof raw.actor === "string")
+    entry.actor = raw.actor;
+  return entry;
+}
+function parseStatusDetail(raw) {
+  if (!isRecord(raw))
+    return void 0;
+  const detail = {};
+  for (const axis of STATUS_DETAIL_AXES) {
+    const entry = parseStatusDetailEntry(raw[axis]);
+    if (entry)
+      detail[axis] = entry;
+  }
+  return Object.keys(detail).length > 0 ? detail : void 0;
+}
 function parseContact(raw) {
   const contact = {
     id: String(raw.id ?? ""),
@@ -1734,11 +1888,17 @@ function parseLegalEntity(raw) {
   return le;
 }
 function parseInvoiceSummary(raw) {
+  const rawStatus = (raw.state ?? raw.status) == null ? void 0 : String(raw.state ?? raw.status);
   const summary = {
     id: String(raw.id ?? ""),
     number: String(raw.invoiceNumber ?? raw.number ?? ""),
-    status: mapStatus(String(raw.state ?? raw.status ?? "submitted"))
+    status: mapStatus(rawStatus ?? "submitted")
   };
+  if (rawStatus !== void 0)
+    summary.rawStatus = rawStatus;
+  const detail = parseStatusDetail(raw.detail);
+  if (detail)
+    summary.detail = detail;
   if (raw.createdAt != null)
     summary.createdAt = String(raw.createdAt);
   if (typeof raw.isCreditNote === "boolean")
@@ -2097,15 +2257,21 @@ ${validation.errors.map((e) => `  - ${e.field}: ${e.message}${e.suggestion ? ` (
    * Transition an invoice to a new state.
    * The gateway validates the state machine — invalid transitions return an error.
    *
+   * `"paid"` on a French CTC invoice reports the payment collection
+   * (« signalement d'encaissement ») to the tax authority via the gateway —
+   * a legal obligation of the French mandate for service invoices. The full
+   * amount is reported from the invoice's stored tax breakdown (no amount to
+   * pass), at most once per invoice: replays return the same report (200),
+   * a concurrent report returns 409, a non-French invoice returns 422.
+   * The invoice's own status becomes `paid` later, when the network confirms
+   * (webhook / polling), not synchronously with this call.
+   *
    * @example
    * ```ts
-   * await peppol.invoices.markAs("inv-123", "accepted");
-   * await peppol.invoices.markAs("inv-123", "paid", {
-   *   commit: "with_mail",
-   *   reason: "Payment received",
-   * });
+   * // France: report that the customer paid this invoice
+   * await peppol.invoices.markAs("inv-123", "paid");
    * ```
-   * @throws {PeppolApiError} 501 if the gateway provider does not support state transitions
+   * @throws {PeppolApiError} 422 for "paid" on a non-French-CTC invoice; 501 for states the provider does not support
    */
   async markAs(id, state, options) {
     return this.adapter.markInvoiceAs(id, state, options);
@@ -2166,14 +2332,19 @@ ${validation.errors.map((e) => `  - ${e.field}: ${e.message}${e.suggestion ? ` (
     const timeout = options?.timeout ?? 12e4;
     const interval = options?.interval ?? 5e3;
     const targets = Array.isArray(targetStatus) ? targetStatus : [targetStatus];
-    const terminalFailures = ["failed", "rejected", "no_action"];
     const startTime = Date.now();
     while (true) {
       const result = await this.getStatus(documentId);
       if (targets.includes(result.status)) {
         return result;
       }
-      if (terminalFailures.includes(result.status)) {
+      if (TERMINAL_FAILURE_STATUSES.includes(result.status)) {
+        throw new PeppolError(`Document ${documentId} reached terminal status "${result.status}" while waiting for "${targets.join('" or "')}"`);
+      }
+      if (statusFamily(result.status) === "terminal-success") {
+        if (targets.every((t) => statusFamily(t) === "progress")) {
+          return result;
+        }
         throw new PeppolError(`Document ${documentId} reached terminal status "${result.status}" while waiting for "${targets.join('" or "')}"`);
       }
       if (Date.now() - startTime >= timeout) {