@getpeppr/cli 0.4.4 → 0.4.6

package/README.md

@@ -211,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:0123456789",
+    "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:0123456789" 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:0123456789"'));
+      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.1";
+var SDK_VERSION = "1.9.0";
 
 // ../sdk/dist/core/client.js
 function findHeaderCaseInsensitive(headers, name) {
@@ -1286,12 +1286,7 @@ var GetpepprAdapter = class {
     const invoices = result.invoices ?? result.data ?? [];
     const meta = result.meta;
     return {
-      data: invoices.map((inv) => ({
-        id: String(inv.id ?? ""),
-        number: String(inv.number ?? ""),
-        status: mapStatus(String(inv.state ?? inv.status ?? "submitted")),
-        createdAt: inv.created_at ? String(inv.created_at) : void 0
-      })),
+      data: invoices.map(parseInvoiceSummary),
       meta: {
         totalCount: Number(meta?.total_count ?? invoices.length),
         offset: Number(meta?.offset ?? options?.offset ?? 0),
@@ -1306,7 +1301,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();
@@ -1490,6 +1486,58 @@ var GetpepprAdapter = class {
   async deleteContact(id) {
     await this.request("DELETE", `/contacts/${id}`);
   }
+  async createLegalEntity(input, options) {
+    const headers = {};
+    if (options?.idempotencyKey)
+      headers["Idempotency-Key"] = options.idempotencyKey;
+    const result = await this.request("POST", "/legal-entities", input, headers);
+    return parseLegalEntity(result);
+  }
+  async getLegalEntity(id) {
+    const result = await this.request("GET", `/legal-entities/${id}`);
+    return parseLegalEntity(result);
+  }
+  async listLegalEntities(options) {
+    const params = new URLSearchParams();
+    if (options?.limit != null)
+      params.set("limit", String(options.limit));
+    if (options?.offset != null)
+      params.set("offset", String(options.offset));
+    const query = params.toString() ? `?${params.toString()}` : "";
+    const result = await this.request("GET", `/legal-entities${query}`);
+    const rows = result.data ?? [];
+    const pagination = result.pagination;
+    return {
+      data: rows.map(parseLegalEntity),
+      meta: {
+        totalCount: Number(pagination?.total_count ?? rows.length),
+        offset: Number(pagination?.offset ?? options?.offset ?? 0),
+        limit: Number(pagination?.limit ?? options?.limit ?? 50),
+        hasMore: Boolean(pagination?.has_more ?? false),
+        truncated: false
+      }
+    };
+  }
+  async archiveLegalEntity(id) {
+    const result = await this.request("DELETE", `/legal-entities/${id}`);
+    return {
+      id: String(result.id ?? id),
+      externalId: result.externalId != null ? String(result.externalId) : null,
+      status: "archived"
+    };
+  }
+  async requestLegalEntityAttestation(id, input, options) {
+    const headers = {};
+    if (options?.idempotencyKey)
+      headers["Idempotency-Key"] = options.idempotencyKey;
+    const result = await this.request("POST", `/legal-entities/${id}/attestation`, input, headers);
+    return {
+      id: String(result.id ?? id),
+      externalId: result.externalId != null ? String(result.externalId) : null,
+      status: String(result.status ?? ""),
+      expiresAt: String(result.expiresAt ?? "")
+    };
+  }
   async listBankAccounts(options) {
     const params = new URLSearchParams();
     if (options?.limit != null)
@@ -1595,6 +1643,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 ?? ""),
@@ -1632,6 +1714,44 @@ function parseContact(raw) {
     contact.directoryLastChecked = String(raw.directoryLastChecked);
   return contact;
 }
+function parseLegalEntity(raw) {
+  const idObj = raw.identifier;
+  const le = {
+    id: String(raw.id ?? ""),
+    externalId: raw.externalId != null ? String(raw.externalId) : null,
+    companyName: raw.companyName != null ? String(raw.companyName) : null,
+    country: raw.country != null ? String(raw.country) : null,
+    identifier: idObj && idObj.scheme != null && idObj.value != null ? { scheme: String(idObj.scheme), value: String(idObj.value) } : null,
+    status: String(raw.status ?? "pending"),
+    environment: String(raw.environment ?? ""),
+    createdAt: String(raw.createdAt ?? "")
+  };
+  if (raw.verificationDetail != null) {
+    le.verificationDetail = raw.verificationDetail;
+  }
+  return le;
+}
+function parseInvoiceSummary(raw) {
+  const summary = {
+    id: String(raw.id ?? ""),
+    number: String(raw.invoiceNumber ?? raw.number ?? ""),
+    status: mapStatus(String(raw.state ?? raw.status ?? "submitted"))
+  };
+  if (raw.createdAt != null)
+    summary.createdAt = String(raw.createdAt);
+  if (typeof raw.isCreditNote === "boolean")
+    summary.isCreditNote = raw.isCreditNote;
+  if (raw.recipientName != null)
+    summary.recipientName = String(raw.recipientName);
+  if (raw.totalAmount != null && Number.isFinite(Number(raw.totalAmount))) {
+    summary.totalAmount = Number(raw.totalAmount);
+  }
+  if (raw.currency != null)
+    summary.currency = String(raw.currency);
+  if (raw.environment != null)
+    summary.environment = String(raw.environment);
+  return summary;
+}
 function parseBankAccount(raw) {
   const account = {
     id: String(raw.id ?? ""),
@@ -1710,6 +1830,19 @@ var PeppolApiError = class extends PeppolError {
     this.name = "PeppolApiError";
     this.retryAfterMs = retryAfterMs;
   }
+  /**
+   * The gateway's machine-readable error code, parsed from the JSON response body
+   * (e.g. "le_cap_exceeded", "identifier_immutable", "legal_entity_locked", "forbidden").
+   * Returns undefined when the body is not JSON or carries no string `code`.
+   */
+  get code() {
+    try {
+      const parsed = JSON.parse(this.responseBody);
+      return typeof parsed?.code === "string" ? parsed.code : void 0;
+    } catch {
+      return void 0;
+    }
+  }
 };
 var Peppol = class {
   adapter;
@@ -1720,6 +1853,7 @@ var Peppol = class {
   contacts;
   bankAccounts;
   transports;
+  legalEntities;
   constructor(config) {
     if (!config.apiKey) {
       throw new PeppolError("API key is required. Sign up at https://console.getpeppr.dev to get your sandbox key.");
@@ -1732,6 +1866,7 @@ var Peppol = class {
     this.contacts = new ContactOperations(this.adapter);
     this.bankAccounts = new BankAccountOperations(this.adapter);
     this.transports = new TransportOperations(this.adapter);
+    this.legalEntities = new LegalEntityOperations(this.adapter);
   }
   /**
    * Validate an invoice without sending it.
@@ -1819,8 +1954,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:0123456789", country: "BE" },
-   *   to: { name: "Client Co", peppolId: "0208:0987654321", 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 +2017,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:0123456789", 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 +2214,14 @@ var DirectoryOperations = class {
    *
    * @example
    * ```ts
-   * const entry = await peppol.directory.lookup("0208:0123456789");
+   * 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:0123456789")');
+      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 +2266,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 +2342,8 @@ var ContactOperations = class {
    * @example
    * ```ts
    * const contact = await peppol.contacts.create({
-   *   name: "Acme Corp",
-   *   peppolId: "0208:0123456789",
+   *   name: "ACMEDIA",
+   *   peppolId: "0208:0685660237",
    *   country: "BE",
    *   isClient: true,
    * });
@@ -2253,6 +2388,74 @@ var ContactOperations = class {
     return paginate((offset, limit) => this.adapter.listContacts({ ...options, offset, limit }), options);
   }
 };
+var LegalEntityOperations = class {
+  adapter;
+  constructor(adapter) {
+    this.adapter = adapter;
+  }
+  /**
+   * Create a sub-tenant Legal Entity for one of your customers.
+   *
+   * Idempotent on `externalId`: repeated calls with the same `externalId` return
+   * the existing entity (HTTP 200) instead of creating a duplicate. Transient 5xx
+   * failures are NOT auto-retried unless you pass `options.idempotencyKey`.
+   *
+   * @example
+   * ```ts
+   * const le = await peppol.legalEntities.create({
+   *   externalId: "tenant-42",
+   *   companyName: "Acme Health AB",
+   *   country: "SE",
+   *   address: { line1: "Storgatan 1", city: "Stockholm", zip: "11122" },
+   *   identifier: { scheme: "0007", value: "5560000001" },
+   * }, { idempotencyKey: "tenant-42-create" });
+   * ```
+   */
+  async create(input, options) {
+    return this.adapter.createLegalEntity(input, options);
+  }
+  /**
+   * Fetch a single sub-tenant Legal Entity by id. For production entities the
+   * `status` reflects the attestation lifecycle (awaiting_authz → attested → active).
+   */
+  async get(id) {
+    return this.adapter.getLegalEntity(id);
+  }
+  /** List your sub-tenant Legal Entities, newest first. */
+  async list(options) {
+    return this.adapter.listLegalEntities(options);
+  }
+  /**
+   * Async iterator over all sub-tenant Legal Entities, handling pagination.
+   *
+   * @example
+   * ```ts
+   * for await (const le of peppol.legalEntities.listAll()) console.log(le.id, le.status);
+   * ```
+   */
+  listAll(options) {
+    return paginate((offset, limit) => this.adapter.listLegalEntities({ ...options, offset, limit }), options);
+  }
+  /** Archive (soft-delete) a sub-tenant Legal Entity. The id stays resolvable for audit. */
+  async archive(id) {
+    return this.adapter.archiveLegalEntity(id);
+  }
+  /**
+   * Request a sub-tenant attestation (production only). Emails the co-branded
+   * confirmation link to the sub-tenant contact and returns the pending status.
+   *
+   * Transient failures are NOT auto-retried unless you pass `options.idempotencyKey`;
+   * re-issuing mints a fresh token, so a retried call is safe.
+   *
+   * @example
+   * ```ts
+   * await peppol.legalEntities.requestAttestation(le.id, { contactEmail: "owner@acme.example" });
+   * ```
+   */
+  async requestAttestation(id, input, options) {
+    return this.adapter.requestLegalEntityAttestation(id, input, options);
+  }
+};
 var BankAccountOperations = class {
   adapter;
   constructor(adapter) {
@@ -2789,7 +2992,7 @@ var INVOICE_TEMPLATE = {
   buyerReference: "PO-2026-042",
   from: {
     name: "Dupont & Fils SPRL",
-    peppolId: "0208:0123456789",
+    peppolId: "0208:0685660237",
     street: "Avenue Louise 54",
     city: "Bruxelles",
     postalCode: "1050",
@@ -2831,7 +3034,7 @@ var CREDIT_NOTE_TEMPLATE = {
   invoiceReference: "INV-2026-001",
   from: {
     name: "Dupont & Fils SPRL",
-    peppolId: "0208:0123456789",
+    peppolId: "0208:0685660237",
     street: "Avenue Louise 54",
     city: "Bruxelles",
     postalCode: "1050",
@@ -2882,6 +3085,11 @@ function registerInitCommand(program2) {
   1. Edit the file with your invoice data
   2. Validate: getpeppr validate ${filename}
   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 in Settings \u2192 Peppol Identity, or set each
+  line's "vatCategory" to "O" (outside the scope of VAT) for a no-VAT test send.
 `);
       process.exit(0);
     }