@getpeppr/cli 0.8.3 → 0.8.4

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to `@getpeppr/cli` are documented here.
 
 The CLI bundles `@getpeppr/sdk` into its published artifact (tsup `noExternal`), so `validate`, `convert` and `init` run the SDK's validators, country rules and UBL builder locally — an SDK release only reaches CLI users once the CLI is rebundled. Rebundle-only releases are listed with the SDK version they ship.
 
+## [0.8.4] — 2026-08-22
+
+`getpeppr init` now scaffolds an invoice that a fresh sandbox account can send:
+the SPF Economie test receiver plus out-of-scope `O/0` lines. The previous
+template targeted the correct receiver but still carried VAT-bearing and
+reverse-charge lines, so a new sender with no VAT identifier received 422.
+
+Every generated `O` line includes the builder-only exemption reason required by
+the SDK's local validator. The quick `getpeppr send --to …` payload remains on
+the same contract. This release bundles SDK 4.7.0.
+
 ## [0.8.3] — 2026-08-21
 
 Rebundles `@getpeppr/sdk` **4.6.0** (was 4.5.0), so `getpeppr validate` and

package/README.md

@@ -241,7 +241,7 @@ Scaffolding (`init`), validation, and conversion run fully offline — no API ke
 
 ## Invoice format
 
-The input file must be a JSON object matching the getpeppr `InvoiceInput` type. `number`, `to`, and `lines` are required for API sends. The `from` party is included in the scaffold because offline validation and UBL conversion need seller metadata; API sends use the legal entity linked to your key.
+The input file must be a JSON object matching the getpeppr `InvoiceInput` type. `number`, `to`, and `lines` are required for API sends. The `from` party is included in the scaffold because offline validation and UBL conversion need seller metadata; API sends use the legal entity linked to your key. The generated file is an integration fixture: a fresh sandbox sender has no VAT identifier, so every line uses category `O` at rate `0`.
 
 ```json
 {
@@ -271,14 +271,17 @@ The input file must be a JSON object matching the getpeppr `InvoiceInput` type.
       "description": "Conseil en transformation numérique",
       "quantity": 10,
       "unitPrice": 950,
-      "vatRate": 21
+      "vatRate": 0,
+      "vatCategory": "O",
+      "taxExemptReason": "Integration test"
     },
     {
       "description": "Software license — annual subscription",
       "quantity": 1,
       "unitPrice": 2400,
       "vatRate": 0,
-      "vatCategory": "AE"
+      "vatCategory": "O",
+      "taxExemptReason": "Integration test"
     }
   ],
   "paymentTerms": "Net 30 days",

package/dist/index.js

@@ -130,7 +130,7 @@ Validating: ${pc.bold(filename)}
   return lines.join("\n");
 }
 
-// ../sdk/dist/core/canonical-schemes.js
+// ../../../getpeppr/packages/sdk/dist/core/canonical-schemes.js
 var ALIAS_TO_EAS = /* @__PURE__ */ new Map([
   ["AD:VAT", "9922"],
   ["AE:TIN", "0235"],
@@ -356,7 +356,7 @@ function countryForScheme(scheme) {
 var CANONICAL_SCHEME_COUNT = ALIAS_TO_EAS.size;
 var SCHEME_COUNTRY_COUNT = EAS_TO_COUNTRY.size;
 
-// ../sdk/dist/core/peppol-id.js
+// ../../../getpeppr/packages/sdk/dist/core/peppol-id.js
 function isWellFormedPeppolId(peppolId) {
   if (!peppolId.includes(":"))
     return false;
@@ -382,7 +382,7 @@ function parsePeppolId(peppolId) {
   };
 }
 
-// ../sdk/dist/core/iso6523-icd-codes.js
+// ../../../getpeppr/packages/sdk/dist/core/iso6523-icd-codes.js
 var ICD_CODES = /* @__PURE__ */ new Set([
   "0002",
   "0003",
@@ -642,7 +642,7 @@ function canCarryPartyIdentification(scheme, context) {
   return scheme === "SEPA" && context !== "AccountingCustomerParty";
 }
 
-// ../sdk/dist/core/ubl-builder.js
+// ../../../getpeppr/packages/sdk/dist/core/ubl-builder.js
 var UBL_NS = "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2";
 var CAC_NS = "urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2";
 var CBC_NS = "urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2";
@@ -717,6 +717,28 @@ function formatVatRate(vatRate, field) {
   }
   return String(vatRate);
 }
+function formatBaseQuantity(baseQuantity, field) {
+  if (typeof baseQuantity !== "number" || !Number.isFinite(baseQuantity) || baseQuantity <= 0) {
+    throw new UblBuilderInputError("baseQuantity must be a finite number greater than zero.", field, "PEPPOL-EN16931-R121");
+  }
+  const numeric = String(baseQuantity);
+  const exponentMarker = numeric.search(/[eE]/);
+  if (exponentMarker === -1)
+    return numeric;
+  const coefficient = numeric.slice(0, exponentMarker);
+  const exponent = Number(numeric.slice(exponentMarker + 1));
+  const decimalPoint = coefficient.indexOf(".");
+  const digits = coefficient.replace(".", "");
+  const integerDigits = decimalPoint === -1 ? coefficient.length : decimalPoint;
+  const outputPoint = integerDigits + exponent;
+  if (outputPoint <= 0) {
+    return `0.${"0".repeat(-outputPoint)}${digits}`;
+  }
+  if (outputPoint >= digits.length) {
+    return `${digits}${"0".repeat(outputPoint - digits.length)}`;
+  }
+  return `${digits.slice(0, outputPoint)}.${digits.slice(outputPoint)}`;
+}
 function round2(n) {
   return Math.round(n * 100) / 100;
 }
@@ -974,7 +996,7 @@ function buildDocumentLineXml(line, index, currency, lineTag, qtyTag) {
       </cac:Item>
       <cac:Price>
         <cbc:PriceAmount currencyID="${escapeXml(currency)}">${formatAmount(line.unitPrice)}</cbc:PriceAmount>
-        ${line.baseQuantity != null ? `<cbc:BaseQuantity unitCode="${escapeXml(resolveUnitCode(line.baseQuantityUnit ?? line.unit ?? DEFAULT_UNIT))}">${line.baseQuantity}</cbc:BaseQuantity>` : ""}
+        ${line.baseQuantity !== void 0 ? `<cbc:BaseQuantity unitCode="${escapeXml(resolveUnitCode(line.baseQuantityUnit ?? line.unit ?? DEFAULT_UNIT))}">${formatBaseQuantity(line.baseQuantity, `lines[${index}].baseQuantity`)}</cbc:BaseQuantity>` : ""}
       </cac:Price>
     </cac:${lineTag}>`;
 }
@@ -1220,7 +1242,7 @@ function buildCreditNoteXml(input) {
 </CreditNote>`;
 }
 
-// ../sdk/dist/core/checksums/luhn.js
+// ../../../getpeppr/packages/sdk/dist/core/checksums/luhn.js
 function isValidLuhn(input) {
   if (typeof input !== "string")
     return false;
@@ -1261,7 +1283,7 @@ function isValidLuhnSiret(input) {
   return false;
 }
 
-// ../sdk/dist/core/country-rules.js
+// ../../../getpeppr/packages/sdk/dist/core/country-rules.js
 function warn(field, message, ruleId) {
   return { field, message, ruleId };
 }
@@ -1402,7 +1424,7 @@ function validateCountryRules(input) {
   return { errors, warnings };
 }
 
-// ../sdk/dist/core/code-lists.js
+// ../../../getpeppr/packages/sdk/dist/core/code-lists.js
 var CURRENCIES = /* @__PURE__ */ new Map([
   ["EUR", { code: "EUR", name: "Euro", minorUnits: 2 }],
   ["USD", { code: "USD", name: "US Dollar", minorUnits: 2 }],
@@ -1527,7 +1549,7 @@ function getAllUnits() {
   return Array.from(UNIT_CODES.entries()).map(([code, name]) => ({ code, name })).sort((a, b) => a.code.localeCompare(b.code));
 }
 
-// ../sdk/dist/core/validator.js
+// ../../../getpeppr/packages/sdk/dist/core/validator.js
 function error(field, message, ruleId, suggestion) {
   return { field, message, ruleId, suggestion };
 }
@@ -1605,6 +1627,11 @@ function validateLine(line, index, isCreditNote = false) {
   } else if (line.unitPrice < 0) {
     errors.push(error(`${path}.unitPrice`, `Unit price cannot be negative, got ${line.unitPrice}`, void 0, "For discounts, use a negative quantity or a separate discount line"));
   }
+  if (line.baseQuantity !== void 0) {
+    if (typeof line.baseQuantity !== "number" || !Number.isFinite(line.baseQuantity) || line.baseQuantity <= 0) {
+      errors.push(error(`${path}.baseQuantity`, "Base quantity must be a finite number greater than zero", "PEPPOL-EN16931-R121", "Use a positive number for the item price base quantity"));
+    }
+  }
   if (line.vatRate === void 0 || line.vatRate === null) {
     errors.push(error(`${path}.vatRate`, "VAT rate is required", "BR-CO-17"));
   } else if (line.vatRate < 0 || line.vatRate > 100) {
@@ -1754,7 +1781,7 @@ function validateInvoice(input) {
   };
 }
 
-// ../sdk/dist/core/schematron.js
+// ../../../getpeppr/packages/sdk/dist/core/schematron.js
 function violation(ruleId, severity, message, field) {
   return { ruleId, severity, message, field };
 }
@@ -2279,7 +2306,7 @@ var SDK_SCHEMATRON_RULE_IDS = [
   "PEPPOL-EN16931-R080"
 ];
 
-// ../sdk/dist/core/status-precedence.js
+// ../../../getpeppr/packages/sdk/dist/core/status-precedence.js
 var STATUS_PRECEDENCE = [
   { status: "failed", family: "terminal-failure" },
   { status: "rejected", family: "terminal-failure" },
@@ -2303,10 +2330,10 @@ function statusFamily(status) {
 }
 var TERMINAL_FAILURE_STATUSES = STATUS_PRECEDENCE.filter((e) => e.family === "terminal-failure").map((e) => e.status);
 
-// ../sdk/dist/version.js
-var SDK_VERSION = "4.6.0";
+// ../../../getpeppr/packages/sdk/dist/version.js
+var SDK_VERSION = "4.7.0";
 
-// ../sdk/dist/core/client.js
+// ../../../getpeppr/packages/sdk/dist/core/client.js
 function findHeaderCaseInsensitive(headers, name) {
   if (!headers)
     return void 0;
@@ -2537,9 +2564,8 @@ var GetpepprAdapter = class {
       clearTimeout(timeoutId);
     }
   }
-  // NOTE: sendInvoice and createInvoice hit the same SDK endpoint (POST /invoices).
-  // The gateway (Tasks 9-10) differentiates them: sendInvoice wraps with
-  // { invoice: {...}, send_after_import: true }, createInvoice omits the flag.
+  // sendInvoice and createInvoice hit the same endpoint. The latter adds the
+  // legacy `_draft` marker, which the current gateway rejects explicitly.
   async sendInvoice(input, options) {
     const headers = {};
     if (options?.idempotencyKey) {
@@ -3521,16 +3547,12 @@ var InvoiceOperations = class {
     this.adapter = adapter;
   }
   /**
-   * Create a draft invoice without sending it.
-   * Validates input client-side, then creates the invoice via the gateway.
-   * Use `sendById()` to send the draft when ready.
+   * Request draft creation from the gateway.
    *
-   * @example
-   * ```ts
-   * const draft = await peppol.invoices.create({ number: "INV-001", to, lines });
-   * // Later, when ready:
-   * await peppol.invoices.sendById(draft.id);
-   * ```
+   * @deprecated The current Storecove-backed gateway does not support drafts
+   * and returns 422 `drafts_not_supported`. Submit the final document with
+   * `invoices.send()` instead.
+   * @throws {PeppolApiError} 422 with code `drafts_not_supported`
    */
   async create(input, options) {
     const validation = validateInvoice(input);
@@ -3545,14 +3567,11 @@ ${validation.errors.map((e) => `  - ${e.field}: ${e.message}${e.suggestion ? ` (
     return result;
   }
   /**
-   * Send an existing draft invoice by ID.
-   * The invoice must have been previously created with `create()`.
+   * Request sending of an existing draft invoice by ID.
    *
-   * @example
-   * ```ts
-   * await peppol.invoices.sendById("inv-1");
-   * ```
-   * @throws {PeppolApiError} 501 if the gateway provider does not support draft sending
+   * @deprecated The current Storecove-backed gateway has no draft lifecycle and
+   * always returns 501. Submit the final document with `invoices.send()`.
+   * @throws {PeppolApiError} 501 with the current gateway provider
    */
   async sendById(id) {
     return this.adapter.sendInvoiceById(id);
@@ -3723,52 +3742,39 @@ ${validation.errors.map((e) => `  - ${e.field}: ${e.message}${e.suggestion ? ` (
     return this.adapter.importInvoice(options);
   }
   /**
-   * Acknowledge a received invoice.
+   * Request acknowledgement of a received invoice.
    *
-   * @example
-   * ```ts
-   * const result = await peppol.invoices.acknowledge("inv-123");
-   * console.log(result.status); // "accepted"
-   * ```
-   * @throws {PeppolApiError} 501 if the gateway provider does not support acknowledgement
+   * @deprecated The current Storecove-backed gateway does not support
+   * acknowledgement and always returns 501.
+   * @throws {PeppolApiError} 501 with the current gateway provider
    */
   async acknowledge(id) {
     return this.adapter.acknowledgeInvoice(id);
   }
   /**
-   * Update an existing invoice (draft only).
-   * Only include the fields you want to change — partial updates are supported.
+   * Request an update to an existing invoice.
    *
-   * @example
-   * ```ts
-   * const updated = await peppol.invoices.update("inv-123", {
-   *   dueDate: "2026-04-01",
-   *   lines: [
-   *     { id: "line-1", quantity: 5 },
-   *     { id: "line-2", _destroy: true },
-   *   ],
-   * });
-   * ```
-   * @throws {PeppolApiError} 501 if the gateway provider does not support invoice updates
+   * @deprecated Storecove documents are immutable after submission. The
+   * current gateway always returns 501; issue a credit note instead.
+   * @throws {PeppolApiError} 501 with the current gateway provider
    */
   async update(id, input) {
     return this.adapter.updateInvoice(id, input);
   }
   /**
-   * Delete an invoice.
+   * Request deletion of an invoice.
    *
-   * @example
-   * ```ts
-   * const deleted = await peppol.invoices.delete("inv-123");
-   * ```
-   * @throws {PeppolApiError} 501 if the gateway provider does not support invoice deletion
+   * @deprecated The current Storecove-backed gateway does not support invoice
+   * deletion and always returns 501.
+   * @throws {PeppolApiError} 501 with the current gateway provider
    */
   async delete(id) {
     return this.adapter.deleteInvoice(id);
   }
   /**
-   * Transition an invoice to a new state.
-   * The gateway validates the state machine — invalid transitions return an error.
+   * Report a French CTC invoice as paid.
+   * Other state transitions are retained for API compatibility but the current
+   * Storecove-backed gateway returns 501 for them.
    *
    * `"paid"` on a French CTC invoice reports the payment collection
    * (« signalement d'encaissement ») to the tax authority via the gateway —
@@ -4448,14 +4454,17 @@ var INVOICE_TEMPLATE = {
       description: "Conseil en transformation num\xE9rique",
       quantity: 10,
       unitPrice: 950,
-      vatRate: 21
+      vatRate: 0,
+      vatCategory: "O",
+      taxExemptReason: "Integration test"
     },
     {
       description: "Software license \u2014 annual subscription",
       quantity: 1,
       unitPrice: 2400,
       vatRate: 0,
-      vatCategory: "AE"
+      vatCategory: "O",
+      taxExemptReason: "Integration test"
     }
   ],
   paymentTerms: "Net 30 days",
@@ -4491,7 +4500,9 @@ var CREDIT_NOTE_TEMPLATE = {
       description: "Avoir partiel \u2014 Conseil en transformation num\xE9rique",
       quantity: 2,
       unitPrice: 950,
-      vatRate: 21
+      vatRate: 0,
+      vatCategory: "O",
+      taxExemptReason: "Integration test"
     }
   ],
   note: "Avoir pour prestations non r\xE9alis\xE9es \u2014 r\xE9f. INV-2026-001"
@@ -4525,9 +4536,9 @@ function registerInitCommand(program2) {
   3. Convert to XML: getpeppr convert ${filename}
   4. Send: getpeppr send ${filename}
 
-  ${pc2.dim("Sandbox note:")} this template includes VAT. To send it on a sandbox
-  account, first register your VAT on the Peppol identity page, or set each
-  line's "vatCategory" to "O" (outside the scope of VAT) for a no-VAT test send.
+  ${pc2.dim("Sandbox note:")} ready for a fresh sandbox account. This template
+  targets the test receiver and uses O/0 tax lines. Replace the fixture tax
+  treatment with the real category after registering the sender's VAT details.
 `);
       process.exit(0);
     }
@@ -5090,11 +5101,12 @@ function buildDefaultSendPayload(overrides = {}) {
         quantity: 1,
         unitPrice: amount,
         vatRate: 0,
-        // vatCategory "O" = "Services outside scope of tax" (UBL 2.1 / EN 16931).
-        // Public entities (SPF Economie) are VAT-exempt. The SDK pre-validator
-        // requires the builder-only reason; the send transport strips it so
-        // Storecove can still derive its own provider-specific text.
-        // If sandbox returns 422 on this combination, fallback is vatRate: 21 + vatCategory: "S".
+        // vatCategory "O" = outside the scope of VAT (UBL 2.1 / EN 16931).
+        // A fresh sandbox sender has no VAT identifier, so this integration
+        // fixture deliberately uses O/0. The SDK pre-validator requires the
+        // builder-only reason; the send transport strips it so Storecove can
+        // derive its own provider-specific text.
+        // Do not fall back to VAT-bearing category "S": a fresh sandbox sender has no VAT number.
         vatCategory: "O",
         taxExemptReason: "Not subject to VAT"
       }