@getpeppr/cli 0.4.2 → 0.4.4

package/README.md

@@ -17,7 +17,7 @@ getpeppr --help
 
 ### `getpeppr init` — Scaffold an invoice
 
-Generate a starter JSON file with all required fields pre-filled:
+Generate a starter JSON file suitable for local validation and UBL conversion:
 
 ```bash
 getpeppr init                        # creates invoice.json
@@ -26,7 +26,7 @@ getpeppr init --credit-note          # credit note template
 getpeppr init --force                # overwrite existing file
 ```
 
-The generated template includes a Belgian seller, a German buyer, and two invoice lines — ready to edit and validate.
+The generated template includes a Belgian seller, a German buyer, and two invoice lines — ready to edit, validate, and convert locally.
 
 ### `getpeppr validate` — Validate an invoice
 
@@ -82,7 +82,7 @@ Look up any participant registered on the Peppol network:
 
 ```bash
 # Direct lookup by Peppol ID
-getpeppr lookup 0208:BE0685660237
+getpeppr lookup 0208:0685660237
 
 # Search by company name
 getpeppr lookup --name "Dupont"
@@ -91,7 +91,7 @@ getpeppr lookup --name "Dupont"
 getpeppr lookup --name "GmbH" --country DE
 
 # JSON output
-getpeppr lookup 0208:BE0685660237 --json
+getpeppr lookup 0208:0685660237 --json
 ```
 
 | Flag | Description |
@@ -131,7 +131,7 @@ Send an invoice through the getpeppr API to the Peppol network. Targets sandbox
 getpeppr send invoice.json
 
 # Quick test — synthesize an invoice from flags (no file needed)
-getpeppr send --to 0208:BE0314595348 --amount 100 --desc "Test invoice"
+getpeppr send --to 9925:BE0314595348 --amount 100 --desc "Test invoice"
 
 # Watch delivery status until terminal (60s timeout)
 getpeppr send invoice.json --watch
@@ -157,6 +157,8 @@ getpeppr send invoice.json --prod
 | `--json` | Machine-readable JSON output |
 | `--quiet` | Exit code only, no output |
 
+When sending through the API, getpeppr determines the seller from the API key. A `from` party can still be present for local validation and UBL conversion, but the gateway ignores it for delivery.
+
 ### `getpeppr logout` — Remove stored credentials
 
 ```bash
@@ -198,7 +200,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:
+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.
 
 ```json
 {
@@ -209,7 +211,7 @@ The input file must be a JSON object matching the getpeppr `InvoiceInput` type:
   "buyerReference": "PO-2026-042",
   "from": {
     "name": "Dupont & Fils SPRL",
-    "peppolId": "0208:BE0123456789",
+    "peppolId": "0208:0123456789",
     "street": "Avenue Louise 54",
     "city": "Bruxelles",
     "postalCode": "1050",

package/dist/index.js

@@ -884,7 +884,7 @@ function validateParty(party, path) {
     errors.push(error(`${path}.name`, "Business name is required", "BR-06"));
   }
   if (party.peppolId === void 0 || party.peppolId === null || party.peppolId === "") {
-    errors.push(error(`${path}.peppolId`, "Peppol participant ID is required", void 0, 'Format: "scheme:id", e.g. "0208:BE0123456789" for Belgian companies'));
+    errors.push(error(`${path}.peppolId`, "Peppol participant ID is required", void 0, 'Format: "scheme:id", e.g. "0208:0123456789" for Belgian companies'));
   } else if (!assertString(party.peppolId, `${path}.peppolId`, errors)) {
   } else if (!party.peppolId.includes(":")) {
     errors.push(error(`${path}.peppolId`, `Invalid Peppol ID format: "${party.peppolId}"`, void 0, 'Must be "scheme:id" format. Common schemes: 0208 (Belgium), 0009 (France SIRET), 0204 (Germany Leitweg)'));
@@ -986,7 +986,7 @@ function validateInvoice(input) {
     }
     const ppId = input.payeeParty.peppolId;
     if (ppId === void 0 || ppId === null || ppId === "") {
-      errors.push(error("payeeParty.peppolId", "Payee party Peppol ID is required", void 0, 'Format: "scheme:id", e.g. "0208:BE0123456789"'));
+      errors.push(error("payeeParty.peppolId", "Payee party Peppol ID is required", void 0, 'Format: "scheme:id", e.g. "0208:0123456789"'));
     } else if (!assertString(ppId, "payeeParty.peppolId", errors)) {
     } else if (!ppId.includes(":")) {
       errors.push(error("payeeParty.peppolId", `Invalid Peppol ID format: "${ppId}"`, void 0, 'Must be "scheme:id" format'));
@@ -1059,7 +1059,7 @@ function validateInvoice(input) {
 }
 
 // ../sdk/dist/version.js
-var SDK_VERSION = "1.4.2";
+var SDK_VERSION = "1.5.1";
 
 // ../sdk/dist/core/client.js
 function findHeaderCaseInsensitive(headers, name) {
@@ -1819,8 +1819,8 @@ ${validation.errors.map((e) => `  - ${e.field}: ${e.message}${e.suggestion ? ` (
    * ```ts
    * const result = await peppol.invoices.send({
    *   number: "INV-001",
-   *   from: { name: "My Company", peppolId: "0208:BE0123456789", country: "BE" },
-   *   to: { name: "Client Co", peppolId: "0208:BE9876543210", country: "BE" },
+   *   from: { name: "My Company", peppolId: "0208:0123456789", country: "BE" },
+   *   to: { name: "Client Co", peppolId: "0208:0987654321", country: "BE" },
    *   lines: [
    *     { description: "Consulting", quantity: 10, unitPrice: 150, vatRate: 21 }
    *   ]
@@ -1874,20 +1874,21 @@ ${validation.errors.map((e) => `  - ${e.field}: ${e.message}${e.suggestion ? ` (
     return this.adapter.getInvoiceAs(id, format);
   }
   /**
-   * Validate an invoice server-side using XSD and Schematron rules.
-   * Builds UBL XML from the input and sends it to the server for validation.
-   * More thorough than client-side validation — catches XML-level issues.
+   * Validate an invoice server-side using the getpeppr gateway's offline SDK-backed checks.
+   * The gateway runs SDK validation, verifies UBL XML generation, and evaluates offline
+   * Peppol business rules without sending the invoice to Storecove.
    *
    * @example
    * ```ts
    * const result = await peppol.invoices.validateServer({
    *   number: "INV-001",
-   *   to: { name: "Acme", peppolId: "0208:BE0123456789", country: "BE" },
+   *   to: { name: "Acme", peppolId: "0208:0123456789", country: "BE" },
    *   lines: [{ description: "Item", quantity: 1, unitPrice: 100, vatRate: 21 }]
    * });
    * console.log(result.valid, result.schematron.errors);
    * ```
-   * @throws {PeppolApiError} 501 if the gateway provider does not support server-side validation
+   * Validation findings return a structured result with valid=false. Transport, auth,
+   * malformed request, and unexpected gateway failures still throw PeppolApiError.
    */
   async validateServer(input) {
     return this.adapter.validateDocumentServer(input);
@@ -2078,14 +2079,14 @@ var DirectoryOperations = class {
    *
    * @example
    * ```ts
-   * const entry = await peppol.directory.lookup("0208:BE0123456789");
+   * const entry = await peppol.directory.lookup("0208:0123456789");
    * console.log(entry.name, entry.capabilities);
    * ```
    */
   async lookup(peppolId) {
     const colonIndex = peppolId.indexOf(":");
     if (colonIndex === -1) {
-      throw new PeppolError('Invalid Peppol ID format. Expected "scheme:id" (e.g., "0208:BE0123456789")');
+      throw new PeppolError('Invalid Peppol ID format. Expected "scheme:id" (e.g., "0208:0123456789")');
     }
     const scheme = peppolId.slice(0, colonIndex);
     const id = peppolId.slice(colonIndex + 1);
@@ -2207,7 +2208,7 @@ var ContactOperations = class {
    * ```ts
    * const contact = await peppol.contacts.create({
    *   name: "Acme Corp",
-   *   peppolId: "0208:BE0123456789",
+   *   peppolId: "0208:0123456789",
    *   country: "BE",
    *   isClient: true,
    * });
@@ -2788,7 +2789,7 @@ var INVOICE_TEMPLATE = {
   buyerReference: "PO-2026-042",
   from: {
     name: "Dupont & Fils SPRL",
-    peppolId: "0208:BE0123456789",
+    peppolId: "0208:0123456789",
     street: "Avenue Louise 54",
     city: "Bruxelles",
     postalCode: "1050",
@@ -2830,7 +2831,7 @@ var CREDIT_NOTE_TEMPLATE = {
   invoiceReference: "INV-2026-001",
   from: {
     name: "Dupont & Fils SPRL",
-    peppolId: "0208:BE0123456789",
+    peppolId: "0208:0123456789",
     street: "Avenue Louise 54",
     city: "Bruxelles",
     postalCode: "1050",
@@ -2994,7 +2995,7 @@ function parseMatch(raw) {
   };
 }
 async function lookupParticipant(scheme, id) {
-  const participantParam = `iso6523-actorid-upis::${scheme}:${id}`;
+  const participantParam = `iso6523-actorid-upis::${scheme}:${normalizeParticipantIdentifier(scheme, id)}`;
   const url = `${BASE_URL}?participant=${encodeURIComponent(participantParam)}`;
   const response = await fetch(url, {
     signal: AbortSignal.timeout(15e3),
@@ -3012,6 +3013,12 @@ async function lookupParticipant(scheme, id) {
   }
   return parseMatch(data.matches[0]);
 }
+function normalizeParticipantIdentifier(scheme, id) {
+  if (scheme === "0208") {
+    return id.replace(/^BE(?=(?:0|1)\d{9}$)/i, "");
+  }
+  return id;
+}
 async function searchParticipants(opts) {
   const params = new URLSearchParams();
   if (opts.name) params.set("name", opts.name);
@@ -3140,7 +3147,7 @@ function validatePeppolId(raw) {
   if (colonIndex === -1) {
     return {
       ok: false,
-      error: `Invalid Peppol ID format: "${raw}". Expected format: scheme:id (e.g. 0208:BE0685660237)`
+      error: `Invalid Peppol ID format: "${raw}". Expected format: scheme:id (e.g. 0208:0685660237)`
     };
   }
   const scheme = raw.slice(0, colonIndex);
@@ -3395,6 +3402,20 @@ startxref
 190
 %%EOF`;
 var MINIMAL_TEST_PDF_BASE64 = Buffer.from(MINIMAL_PDF).toString("base64");
+var SCHEME_COUNTRY_DEFAULTS = {
+  "0009": "FR",
+  "0204": "DE",
+  "0208": "BE",
+  "9925": "BE"
+};
+function deriveCountryFromPeppolId(peppolId) {
+  const [scheme, identifier = ""] = peppolId.split(":");
+  const alphaPrefix = identifier.slice(0, 2);
+  if (/^[A-Za-z]{2}$/.test(alphaPrefix)) {
+    return alphaPrefix.toUpperCase();
+  }
+  return SCHEME_COUNTRY_DEFAULTS[scheme] ?? "BE";
+}
 function buildDefaultSendPayload(overrides = {}) {
   const today = /* @__PURE__ */ new Date();
   const due = new Date(today.getTime() + 30 * 864e5);
@@ -3406,7 +3427,7 @@ function buildDefaultSendPayload(overrides = {}) {
   const description = overrides.description ?? "Test service from getpeppr";
   const randomSuffix = Math.floor(Math.random() * 65536).toString(16).toUpperCase().padStart(4, "0");
   const number = `TEST-${Date.now().toString(36).toUpperCase()}-${randomSuffix}`;
-  const country = peppolId.split(":")[1]?.slice(0, 2) ?? "BE";
+  const country = overrides.country != null ? overrides.country.toUpperCase() : deriveCountryFromPeppolId(peppolId);
   const payload = {
     number,
     date: isoToday,
@@ -3458,7 +3479,7 @@ var MutexError = class extends Error {
 function hasOverrides(o) {
   if (!o) return false;
   return Boolean(
-    o.to != null && o.to !== "" || o.amount != null || o.currency || o.description || o.attachment === true
+    o.to != null && o.to !== "" || o.country != null && o.country !== "" || o.amount != null || o.currency || o.description || o.attachment === true
   );
 }
 function buildPayload(opts) {
@@ -3566,7 +3587,7 @@ var API_BASE = "https://api.getpeppr.dev/v1";
 var LOCAL_BASE = "http://localhost:3001/api/v1";
 var DASHBOARD_BASE = "https://console.getpeppr.dev/invoices";
 function registerSendCommand(program2) {
-  program2.command("send").description("Send an invoice to the Peppol network via getpeppr API").argument("[file]", "optional path to invoice JSON (mutex with --to/--amount/...)").option("--prod", "target production (live keys + confirmation)").option("--local", "target localhost:3001 dev server").option("--key <key>", "override API key \u2014 for CI/scripted use only; visible in `ps` and shell history. Prefer GETPEPPR_API_KEY env var.").option("--to <peppol-id>", "recipient peppol id (e.g., 0208:BE0314595348)").option("--amount <number>", "line amount in major currency units (decimal allowed)").option("--currency <iso>", "ISO 4217 currency (default EUR)").option("--desc <text>", "line description").option("--attachment", "attach the test PDF").option("--watch", "poll status until delivered (60s timeout)").option("-y, --yes", "skip --prod confirmation prompt").option("--no-validate", "skip pre-validation locally").option("--json", "output JSON").option("--quiet", "exit code only, no output").action(async (file, flags) => {
+  program2.command("send").description("Send an invoice to the Peppol network via getpeppr API").argument("[file]", "optional path to invoice JSON (mutex with --to/--amount/...)").option("--prod", "target production (live keys + confirmation)").option("--local", "target localhost:3001 dev server").option("--key <key>", "override API key \u2014 for CI/scripted use only; visible in `ps` and shell history. Prefer GETPEPPR_API_KEY env var.").option("--to <peppol-id>", "recipient peppol id (e.g., 9925:BE0314595348)").option("--country <iso>", "recipient ISO 3166-1 alpha-2 country override (e.g., BE)").option("--amount <number>", "line amount in major currency units (decimal allowed)").option("--currency <iso>", "ISO 4217 currency (default EUR)").option("--desc <text>", "line description").option("--attachment", "attach the test PDF").option("--watch", "poll status until delivered (60s timeout)").option("-y, --yes", "skip --prod confirmation prompt").option("--no-validate", "skip pre-validation locally").option("--json", "output JSON").option("--quiet", "exit code only, no output").action(async (file, flags) => {
     let auth;
     try {
       auth = resolveApiKey({
@@ -3583,6 +3604,7 @@ function registerSendCommand(program2) {
     }
     const overrides = {
       to: flags.to,
+      country: flags.country,
       amount: flags.amount != null ? Number(flags.amount) : void 0,
       currency: flags.currency,
       description: flags.desc,