@getpeppr/cli 0.4.3 → 0.4.5

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:0685660237",
     "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:0685660237" 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:0685660237"'));
     } 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.5.0";
+var SDK_VERSION = "1.5.2";
 
 // ../sdk/dist/core/client.js
 function findHeaderCaseInsensitive(headers, name) {
@@ -1306,7 +1306,8 @@ var GetpepprAdapter = class {
     return parseSendResult(result);
   }
   async lookupDirectory(scheme, id) {
-    return this.request("GET", `/directory/${scheme}/${id}`);
+    const result = await this.request("GET", `/directory/${scheme}/${id}`);
+    return parseDirectoryEntry(result);
   }
   async searchDirectory(params) {
     const query = new URLSearchParams(params).toString();
@@ -1595,6 +1596,40 @@ function parseSendResult(result) {
     warnings: Array.isArray(result.warnings) ? result.warnings : void 0
   };
 }
+function parseDirectoryEntry(result) {
+  const participant = isRecord(result.participant) ? result.participant : result;
+  const scheme = participant.scheme == null ? void 0 : String(participant.scheme);
+  const id = participant.id == null ? void 0 : String(participant.id);
+  const peppolId = participant.peppolId == null ? formatPeppolId(scheme, id) : String(participant.peppolId);
+  return {
+    name: String(participant.name ?? ""),
+    peppolId,
+    country: String(participant.country ?? ""),
+    capabilities: Array.isArray(participant.capabilities) ? participant.capabilities.map(String) : [],
+    registrationDate: participant.registrationDate == null ? void 0 : String(participant.registrationDate),
+    vatNumber: participant.vatNumber == null ? void 0 : String(participant.vatNumber),
+    additionalIds: Array.isArray(participant.additionalIds) ? participant.additionalIds.filter(isRecord).map((entry) => ({
+      scheme: String(entry.scheme ?? ""),
+      value: String(entry.value ?? "")
+    })) : void 0,
+    contactInfo: isRecord(participant.contactInfo) ? {
+      name: participant.contactInfo.name == null ? void 0 : String(participant.contactInfo.name),
+      email: participant.contactInfo.email == null ? void 0 : String(participant.contactInfo.email),
+      phone: participant.contactInfo.phone == null ? void 0 : String(participant.contactInfo.phone)
+    } : void 0,
+    website: participant.website == null ? void 0 : String(participant.website)
+  };
+}
+function formatPeppolId(scheme, id) {
+  if (!id)
+    return scheme ? `${scheme}:` : "";
+  if (id.includes(":"))
+    return id;
+  return scheme ? `${scheme}:${id}` : id;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function parseContact(raw) {
   const contact = {
     id: String(raw.id ?? ""),
@@ -1819,8 +1854,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:0685660237", country: "BE" },
+   *   to: { name: "Client Co", peppolId: "0208:0685660237", country: "BE" },
    *   lines: [
    *     { description: "Consulting", quantity: 10, unitPrice: 150, vatRate: 21 }
    *   ]
@@ -1882,7 +1917,7 @@ ${validation.errors.map((e) => `  - ${e.field}: ${e.message}${e.suggestion ? ` (
    * ```ts
    * const result = await peppol.invoices.validateServer({
    *   number: "INV-001",
-   *   to: { name: "Acme", peppolId: "0208:BE0123456789", country: "BE" },
+   *   to: { name: "Acme", peppolId: "0208:0685660237", country: "BE" },
    *   lines: [{ description: "Item", quantity: 1, unitPrice: 100, vatRate: 21 }]
    * });
    * console.log(result.valid, result.schematron.errors);
@@ -2079,14 +2114,14 @@ var DirectoryOperations = class {
    *
    * @example
    * ```ts
-   * const entry = await peppol.directory.lookup("0208:BE0123456789");
+   * const entry = await peppol.directory.lookup("0208:0685660237");
    * 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:0685660237")');
     }
     const scheme = peppolId.slice(0, colonIndex);
     const id = peppolId.slice(colonIndex + 1);
@@ -2131,7 +2166,7 @@ var DirectoryOperations = class {
    *
    * @example
    * ```ts
-   * const result = await peppol.directory.searchByVat("BE0123456789");
+   * const result = await peppol.directory.searchByVat("BE0685660237");
    * ```
    */
   async searchByVat(vatNumber) {
@@ -2207,8 +2242,8 @@ var ContactOperations = class {
    * @example
    * ```ts
    * const contact = await peppol.contacts.create({
-   *   name: "Acme Corp",
-   *   peppolId: "0208:BE0123456789",
+   *   name: "ACMEDIA",
+   *   peppolId: "0208:0685660237",
    *   country: "BE",
    *   isClient: true,
    * });
@@ -2789,7 +2824,7 @@ var INVOICE_TEMPLATE = {
   buyerReference: "PO-2026-042",
   from: {
     name: "Dupont & Fils SPRL",
-    peppolId: "0208:BE0123456789",
+    peppolId: "0208:0685660237",
     street: "Avenue Louise 54",
     city: "Bruxelles",
     postalCode: "1050",
@@ -2831,7 +2866,7 @@ var CREDIT_NOTE_TEMPLATE = {
   invoiceReference: "INV-2026-001",
   from: {
     name: "Dupont & Fils SPRL",
-    peppolId: "0208:BE0123456789",
+    peppolId: "0208:0685660237",
     street: "Avenue Louise 54",
     city: "Bruxelles",
     postalCode: "1050",
@@ -2995,7 +3030,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),
@@ -3013,6 +3048,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);
@@ -3141,7 +3182,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);
@@ -3396,6 +3437,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);
@@ -3407,7 +3462,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,
@@ -3459,7 +3514,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) {
@@ -3567,7 +3622,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({
@@ -3584,6 +3639,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,