@getpeppr/cli 0.3.1 → 0.4.1

package/dist/index.js

@@ -735,6 +735,131 @@ function validateCountryRules(input) {
   return { errors, warnings };
 }
 
+// ../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 }],
+  ["GBP", { code: "GBP", name: "Pound Sterling", minorUnits: 2 }],
+  ["CHF", { code: "CHF", name: "Swiss Franc", minorUnits: 2 }],
+  ["DKK", { code: "DKK", name: "Danish Krone", minorUnits: 2 }],
+  ["NOK", { code: "NOK", name: "Norwegian Krone", minorUnits: 2 }],
+  ["SEK", { code: "SEK", name: "Swedish Krona", minorUnits: 2 }],
+  ["PLN", { code: "PLN", name: "Polish Zloty", minorUnits: 2 }],
+  ["CZK", { code: "CZK", name: "Czech Koruna", minorUnits: 2 }],
+  ["HUF", { code: "HUF", name: "Hungarian Forint", minorUnits: 2 }],
+  ["RON", { code: "RON", name: "Romanian Leu", minorUnits: 2 }],
+  ["BGN", { code: "BGN", name: "Bulgarian Lev", minorUnits: 2 }],
+  ["HRK", { code: "HRK", name: "Croatian Kuna", minorUnits: 2 }],
+  ["ISK", { code: "ISK", name: "Icelandic Krona", minorUnits: 0 }],
+  ["TRY", { code: "TRY", name: "Turkish Lira", minorUnits: 2 }],
+  ["JPY", { code: "JPY", name: "Japanese Yen", minorUnits: 0 }],
+  ["CNY", { code: "CNY", name: "Chinese Yuan", minorUnits: 2 }],
+  ["KRW", { code: "KRW", name: "South Korean Won", minorUnits: 0 }],
+  ["INR", { code: "INR", name: "Indian Rupee", minorUnits: 2 }],
+  ["SGD", { code: "SGD", name: "Singapore Dollar", minorUnits: 2 }],
+  ["AUD", { code: "AUD", name: "Australian Dollar", minorUnits: 2 }],
+  ["NZD", { code: "NZD", name: "New Zealand Dollar", minorUnits: 2 }],
+  ["CAD", { code: "CAD", name: "Canadian Dollar", minorUnits: 2 }],
+  ["BRL", { code: "BRL", name: "Brazilian Real", minorUnits: 2 }],
+  ["MXN", { code: "MXN", name: "Mexican Peso", minorUnits: 2 }],
+  ["ZAR", { code: "ZAR", name: "South African Rand", minorUnits: 2 }],
+  ["AED", { code: "AED", name: "UAE Dirham", minorUnits: 2 }],
+  ["SAR", { code: "SAR", name: "Saudi Riyal", minorUnits: 2 }],
+  ["ILS", { code: "ILS", name: "Israeli Shekel", minorUnits: 2 }],
+  ["HKD", { code: "HKD", name: "Hong Kong Dollar", minorUnits: 2 }],
+  ["TWD", { code: "TWD", name: "Taiwan Dollar", minorUnits: 2 }]
+]);
+function getCurrency(code) {
+  return CURRENCIES.get(code.toUpperCase());
+}
+var EAS_SCHEMES = [
+  { code: "0002", name: "System Information et Repertoire des Entreprises et des Etablissements (SIRENE)", country: "FR" },
+  { code: "0007", name: "Organisationsnummer", country: "SE" },
+  { code: "0009", name: "SIRET-CODE", country: "FR" },
+  { code: "0088", name: "EAN Location Code (GLN)" },
+  { code: "0096", name: "Danish Chamber of Commerce (P-nummer)", country: "DK" },
+  { code: "0184", name: "Danish Central Business Register (CVR)", country: "DK" },
+  { code: "0190", name: "Dutch Chamber of Commerce (KVK)", country: "NL" },
+  { code: "0191", name: "Organisatie Identificatie Nummer (OIN)", country: "NL" },
+  { code: "0192", name: "Danish SE-number (Erhvervsstyrelsen)", country: "DK" },
+  { code: "0195", name: "Singapore Unique Entity Number (UEN)", country: "SG" },
+  { code: "0196", name: "Icelandic Kennitala", country: "IS" },
+  { code: "0198", name: "Danish ERST id (Erhvervsstyrelsen)", country: "DK" },
+  { code: "0200", name: "Lithuanian Legal Entity Register (GRIS)", country: "LT" },
+  { code: "0201", name: "Italian Codice Destinatario", country: "IT" },
+  { code: "0202", name: "Italian Fiscal Code (Codice Fiscale)", country: "IT" },
+  { code: "0204", name: "German Leitweg-ID", country: "DE" },
+  { code: "0208", name: "Belgian Enterprise Number (KBO/BCE)", country: "BE" },
+  { code: "0209", name: "German Creditor Identifier (GS1)", country: "DE" },
+  { code: "0210", name: "Italian Codice Fiscale (per IPA)", country: "IT" },
+  { code: "0211", name: "Italian Partita IVA (VAT number)", country: "IT" },
+  { code: "0212", name: "Finnish OVT code", country: "FI" },
+  { code: "0213", name: "Finnish OP identifier", country: "FI" },
+  { code: "0225", name: "FRCTC Electronic Address", country: "FR" },
+  { code: "9957", name: "French VAT number", country: "FR" }
+];
+var EAS_BY_CODE = new Map(EAS_SCHEMES.map((s) => [s.code, s]));
+var UNIT_ALIAS_MAP = {
+  each: "EA",
+  piece: "EA",
+  pieces: "EA",
+  hour: "HUR",
+  hours: "HUR",
+  day: "DAY",
+  days: "DAY",
+  week: "WEE",
+  weeks: "WEE",
+  month: "MON",
+  months: "MON",
+  year: "ANN",
+  years: "ANN",
+  kilogram: "KGM",
+  kg: "KGM",
+  meter: "MTR",
+  metre: "MTR",
+  liter: "LTR",
+  litre: "LTR",
+  unit: "C62",
+  units: "C62",
+  set: "SET",
+  sets: "SET",
+  pack: "PK",
+  packs: "PK",
+  minute: "MIN",
+  minutes: "MIN",
+  second: "SEC",
+  seconds: "SEC",
+  tonne: "TNE",
+  ton: "TNE",
+  "square metre": "MTK",
+  "square meter": "MTK",
+  sqm: "MTK"
+};
+var UNIT_CODES = /* @__PURE__ */ new Map([
+  ["EA", "Each"],
+  ["HUR", "Hour"],
+  ["DAY", "Day"],
+  ["WEE", "Week"],
+  ["MON", "Month"],
+  ["ANN", "Year"],
+  ["MIN", "Minute"],
+  ["SEC", "Second"],
+  ["KGM", "Kilogram"],
+  ["MTR", "Metre"],
+  ["LTR", "Litre"],
+  ["MTK", "Square metre"],
+  ["TNE", "Tonne"],
+  ["C62", "One (unit)"],
+  ["SET", "Set"],
+  ["PK", "Pack"]
+]);
+function resolveUnit(input) {
+  return UNIT_ALIAS_MAP[input.toLowerCase()] ?? input;
+}
+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
 function error(field, message, ruleId, suggestion) {
   return { field, message, ruleId, suggestion };
@@ -742,19 +867,31 @@ function error(field, message, ruleId, suggestion) {
 function warning(field, message, ruleId) {
   return { field, message, ruleId };
 }
+function assertString(value, fieldPath, errors) {
+  if (typeof value !== "string") {
+    errors.push(error(fieldPath, `Expected string, received ${value === null ? "null" : typeof value}`, void 0, "Check your payload \u2014 this field must be a text value"));
+    return false;
+  }
+  return true;
+}
 var ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 function validateParty(party, path) {
   const errors = [];
-  if (!party.name?.trim()) {
+  if (party.name === void 0 || party.name === null || party.name === "") {
+    errors.push(error(`${path}.name`, "Business name is required", "BR-06"));
+  } else if (!assertString(party.name, `${path}.name`, errors)) {
+  } else if (!party.name.trim()) {
     errors.push(error(`${path}.name`, "Business name is required", "BR-06"));
   }
-  if (!party.peppolId) {
+  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'));
+  } 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)'));
   }
-  if (!party.country) {
+  if (party.country === void 0 || party.country === null || party.country === "") {
     errors.push(error(`${path}.country`, "Country code is required", "BR-11"));
+  } else if (!assertString(party.country, `${path}.country`, errors)) {
   } else if (party.country.length !== 2) {
     errors.push(error(`${path}.country`, `Invalid country code: "${party.country}"`, void 0, "Must be ISO 3166-1 alpha-2 (e.g., BE, FR, DE, NL)"));
   }
@@ -762,13 +899,22 @@ function validateParty(party, path) {
 }
 function validateBuyerAddress(party, path) {
   const errors = [];
-  if (!party.street?.trim()) {
+  if (party.street === void 0 || party.street === null || party.street === "") {
+    errors.push(error(`${path}.street`, "Street address is required for the buyer", "BR-50", 'e.g. "123 Business Street"'));
+  } else if (!assertString(party.street, `${path}.street`, errors)) {
+  } else if (!party.street.trim()) {
     errors.push(error(`${path}.street`, "Street address is required for the buyer", "BR-50", 'e.g. "123 Business Street"'));
   }
-  if (!party.city?.trim()) {
+  if (party.city === void 0 || party.city === null || party.city === "") {
+    errors.push(error(`${path}.city`, "City is required for the buyer", "BR-51", 'e.g. "Brussels"'));
+  } else if (!assertString(party.city, `${path}.city`, errors)) {
+  } else if (!party.city.trim()) {
     errors.push(error(`${path}.city`, "City is required for the buyer", "BR-51", 'e.g. "Brussels"'));
   }
-  if (!party.postalCode?.trim()) {
+  if (party.postalCode === void 0 || party.postalCode === null || party.postalCode === "") {
+    errors.push(error(`${path}.postalCode`, "Postal code is required for the buyer", "BR-53", 'e.g. "1000"'));
+  } else if (!assertString(party.postalCode, `${path}.postalCode`, errors)) {
+  } else if (!party.postalCode.trim()) {
     errors.push(error(`${path}.postalCode`, "Postal code is required for the buyer", "BR-53", 'e.g. "1000"'));
   }
   return errors;
@@ -776,7 +922,10 @@ function validateBuyerAddress(party, path) {
 function validateLine(line, index, isCreditNote = false) {
   const errors = [];
   const path = `lines[${index}]`;
-  if (!line.description?.trim()) {
+  if (line.description === void 0 || line.description === null || line.description === "") {
+    errors.push(error(`${path}.description`, "Line item description is required", "BR-25"));
+  } else if (!assertString(line.description, `${path}.description`, errors)) {
+  } else if (!line.description.trim()) {
     errors.push(error(`${path}.description`, "Line item description is required", "BR-25"));
   }
   if (line.quantity === void 0 || line.quantity === null) {
@@ -799,15 +948,24 @@ function validateLine(line, index, isCreditNote = false) {
 function validateInvoice(input) {
   const errors = [];
   const warnings = [];
-  if (!input.number?.trim()) {
+  if (input.number === void 0 || input.number === null || input.number === "") {
+    errors.push(error("number", "Invoice number is required", "BR-02", "Must be unique per supplier"));
+  } else if (!assertString(input.number, "number", errors)) {
+  } else if (!input.number.trim()) {
     errors.push(error("number", "Invoice number is required", "BR-02", "Must be unique per supplier"));
   }
   const VALID_TYPE_CODES = [380, 381, 383, 384, 386, 389, 751];
   if (input.invoiceTypeCode != null && !VALID_TYPE_CODES.includes(input.invoiceTypeCode)) {
     errors.push(error("invoiceTypeCode", `Invalid invoice type code: ${input.invoiceTypeCode}`, void 0, "Valid codes: 380, 381, 383, 384, 386, 389, 751"));
   }
-  if (input.isCreditNote && !input.invoiceReference?.trim()) {
-    errors.push(error("invoiceReference", "Reference to the original invoice is required for credit notes", void 0, 'Set invoiceReference to the original invoice number (e.g., "INV-001")'));
+  if (input.isCreditNote) {
+    const ref = input.invoiceReference;
+    if (ref === void 0 || ref === null || ref === "") {
+      errors.push(error("invoiceReference", "Reference to the original invoice is required for credit notes", void 0, 'Set invoiceReference to the original invoice number (e.g., "INV-001")'));
+    } else if (!assertString(ref, "invoiceReference", errors)) {
+    } else if (!ref.trim()) {
+      errors.push(error("invoiceReference", "Reference to the original invoice is required for credit notes", void 0, 'Set invoiceReference to the original invoice number (e.g., "INV-001")'));
+    }
   }
   if (input.from) {
     warnings.push(warning("from", "Seller info is determined by your API key. The 'from' field is deprecated and ignored."));
@@ -819,13 +977,19 @@ function validateInvoice(input) {
     errors.push(...validateBuyerAddress(input.to, "to"));
   }
   if (input.payeeParty) {
-    if (!input.payeeParty.name?.trim()) {
+    const ppName = input.payeeParty.name;
+    if (ppName === void 0 || ppName === null || ppName === "") {
+      errors.push(error("payeeParty.name", "Payee party name is required", "BR-17"));
+    } else if (!assertString(ppName, "payeeParty.name", errors)) {
+    } else if (!ppName.trim()) {
       errors.push(error("payeeParty.name", "Payee party name is required", "BR-17"));
     }
-    if (!input.payeeParty.peppolId) {
+    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"'));
-    } else if (!input.payeeParty.peppolId.includes(":")) {
-      errors.push(error("payeeParty.peppolId", `Invalid Peppol ID format: "${input.payeeParty.peppolId}"`, void 0, 'Must be "scheme:id" format'));
+    } 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'));
     }
   }
   if (!input.lines || input.lines.length === 0) {
@@ -867,6 +1031,12 @@ function validateInvoice(input) {
   if (input.taxCurrencyRate !== void 0 && input.taxCurrencyRate <= 0) {
     errors.push(error("taxCurrencyRate", `Tax currency rate must be positive, got ${input.taxCurrencyRate}`, void 0, "Set to the exchange rate from document currency to tax currency"));
   }
+  if (input.currency && !getCurrency(input.currency)) {
+    errors.push(error("currency", `Invalid currency code: "${input.currency}"`, void 0, 'Use ISO 4217 (e.g., "EUR", "USD", "GBP", "JPY"). See https://getpeppr.dev/docs/types/#currency'));
+  }
+  if (input.taxCurrency && !getCurrency(input.taxCurrency)) {
+    errors.push(error("taxCurrency", `Invalid tax currency code: "${input.taxCurrency}"`, void 0, 'Use ISO 4217 (e.g., "EUR", "USD")'));
+  }
   if (!input.dueDate) {
     warnings.push(warning("dueDate", "No due date specified. Recommended for payment terms.", "BR-09"));
   }
@@ -889,9 +1059,19 @@ function validateInvoice(input) {
 }
 
 // ../sdk/dist/version.js
-var SDK_VERSION = "1.3.0";
+var SDK_VERSION = "1.4.0";
 
 // ../sdk/dist/core/client.js
+function findHeaderCaseInsensitive(headers, name) {
+  if (!headers)
+    return void 0;
+  const target = name.toLowerCase();
+  for (const [key, value] of Object.entries(headers)) {
+    if (key.toLowerCase() === target)
+      return value;
+  }
+  return void 0;
+}
 var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
 function sleep(ms) {
   return new Promise((resolve4) => setTimeout(resolve4, ms));
@@ -960,7 +1140,7 @@ var GetpepprAdapter = class {
         lastError = err;
         const is429 = err instanceof PeppolApiError && err.statusCode === 429;
         const isSafeMethod = /^(GET|DELETE|HEAD)$/i.test(method);
-        const hasIdempotencyKey = !!extraHeaders?.["Idempotency-Key"];
+        const hasIdempotencyKey = !!findHeaderCaseInsensitive(extraHeaders, "Idempotency-Key");
         const canRetry = is429 || isSafeMethod || hasIdempotencyKey;
         if (attempt < maxRetries && canRetry && isRetryableError(err)) {
           const retryAfterMs = err instanceof PeppolApiError ? err.retryAfterMs : void 0;
@@ -1493,11 +1673,16 @@ var VALID_STATUSES = /* @__PURE__ */ new Set([
   "under_query",
   "conditionally_accepted",
   "partially_paid",
-  "no_action"
+  "no_action",
+  "unknown"
+  // explicitly known: gateway may emit this when it can't map a Storecove status
 ]);
 function mapStatus(raw) {
   const s = raw.toLowerCase();
-  return VALID_STATUSES.has(s) ? s : "unknown";
+  if (VALID_STATUSES.has(s))
+    return s;
+  console.warn(`[getpeppr] Unknown gateway status received: "${raw}" \u2014 please report to support@getpeppr.dev. Coercing to "unknown".`);
+  return "unknown";
 }
 var PeppolError = class extends Error {
   constructor(message) {
@@ -1575,12 +1760,14 @@ async function* paginate(fetchPage, options) {
   let offset = 0;
   while (true) {
     const page = await fetchPage(offset, pageSize);
+    if (page.data.length === 0)
+      break;
     for (const item of page.data) {
       yield item;
     }
     if (!page.meta.hasMore)
       break;
-    offset += pageSize;
+    offset += page.data.length;
   }
 }
 var InvoiceOperations = class {
@@ -2062,7 +2249,7 @@ var ContactOperations = class {
    * ```
    */
   listAll(options) {
-    return paginate((offset, limit) => this.adapter.listContacts({ ...options, offset, limit }));
+    return paginate((offset, limit) => this.adapter.listContacts({ ...options, offset, limit }), options);
   }
 };
 var BankAccountOperations = class {
@@ -2143,7 +2330,7 @@ var BankAccountOperations = class {
    * ```
    */
   listAll(options) {
-    return paginate((offset, limit) => this.adapter.listBankAccounts({ ...options, offset, limit }));
+    return paginate((offset, limit) => this.adapter.listBankAccounts({ ...options, offset, limit }), options);
   }
 };
 var TransportOperations = class {
@@ -2225,93 +2412,6 @@ var TransportOperations = class {
   }
 };
 
-// ../sdk/dist/core/code-lists.js
-var EAS_SCHEMES = [
-  { code: "0002", name: "System Information et Repertoire des Entreprises et des Etablissements (SIRENE)", country: "FR" },
-  { code: "0007", name: "Organisationsnummer", country: "SE" },
-  { code: "0009", name: "SIRET-CODE", country: "FR" },
-  { code: "0088", name: "EAN Location Code (GLN)" },
-  { code: "0096", name: "Danish Chamber of Commerce (P-nummer)", country: "DK" },
-  { code: "0184", name: "Danish Central Business Register (CVR)", country: "DK" },
-  { code: "0190", name: "Dutch Chamber of Commerce (KVK)", country: "NL" },
-  { code: "0191", name: "Organisatie Identificatie Nummer (OIN)", country: "NL" },
-  { code: "0192", name: "Danish SE-number (Erhvervsstyrelsen)", country: "DK" },
-  { code: "0195", name: "Singapore Unique Entity Number (UEN)", country: "SG" },
-  { code: "0196", name: "Icelandic Kennitala", country: "IS" },
-  { code: "0198", name: "Danish ERST id (Erhvervsstyrelsen)", country: "DK" },
-  { code: "0200", name: "Lithuanian Legal Entity Register (GRIS)", country: "LT" },
-  { code: "0201", name: "Italian Codice Destinatario", country: "IT" },
-  { code: "0202", name: "Italian Fiscal Code (Codice Fiscale)", country: "IT" },
-  { code: "0204", name: "German Leitweg-ID", country: "DE" },
-  { code: "0208", name: "Belgian Enterprise Number (KBO/BCE)", country: "BE" },
-  { code: "0209", name: "German Creditor Identifier (GS1)", country: "DE" },
-  { code: "0210", name: "Italian Codice Fiscale (per IPA)", country: "IT" },
-  { code: "0211", name: "Italian Partita IVA (VAT number)", country: "IT" },
-  { code: "0212", name: "Finnish OVT code", country: "FI" },
-  { code: "0213", name: "Finnish OP identifier", country: "FI" }
-];
-var EAS_BY_CODE = new Map(EAS_SCHEMES.map((s) => [s.code, s]));
-var UNIT_ALIAS_MAP = {
-  each: "EA",
-  piece: "EA",
-  pieces: "EA",
-  hour: "HUR",
-  hours: "HUR",
-  day: "DAY",
-  days: "DAY",
-  week: "WEE",
-  weeks: "WEE",
-  month: "MON",
-  months: "MON",
-  year: "ANN",
-  years: "ANN",
-  kilogram: "KGM",
-  kg: "KGM",
-  meter: "MTR",
-  metre: "MTR",
-  liter: "LTR",
-  litre: "LTR",
-  unit: "C62",
-  units: "C62",
-  set: "SET",
-  sets: "SET",
-  pack: "PK",
-  packs: "PK",
-  minute: "MIN",
-  minutes: "MIN",
-  second: "SEC",
-  seconds: "SEC",
-  tonne: "TNE",
-  ton: "TNE",
-  "square metre": "MTK",
-  "square meter": "MTK",
-  sqm: "MTK"
-};
-var UNIT_CODES = /* @__PURE__ */ new Map([
-  ["EA", "Each"],
-  ["HUR", "Hour"],
-  ["DAY", "Day"],
-  ["WEE", "Week"],
-  ["MON", "Month"],
-  ["ANN", "Year"],
-  ["MIN", "Minute"],
-  ["SEC", "Second"],
-  ["KGM", "Kilogram"],
-  ["MTR", "Metre"],
-  ["LTR", "Litre"],
-  ["MTK", "Square metre"],
-  ["TNE", "Tonne"],
-  ["C62", "One (unit)"],
-  ["SET", "Set"],
-  ["PK", "Pack"]
-]);
-function resolveUnit(input) {
-  return UNIT_ALIAS_MAP[input.toLowerCase()] ?? input;
-}
-function getAllUnits() {
-  return Array.from(UNIT_CODES.entries()).map(([code, name]) => ({ code, name })).sort((a, b) => a.code.localeCompare(b.code));
-}
-
 // ../sdk/dist/core/schematron.js
 function violation(ruleId, severity, message, field) {
   return { ruleId, severity, message, field };
@@ -2839,6 +2939,14 @@ import pc4 from "picocolors";
 
 // src/lib/peppol-directory.ts
 var BASE_URL = "https://directory.peppol.eu/search/1.0/json";
+var DirectoryError = class extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.name = "DirectoryError";
+    this.status = status;
+  }
+};
 function stripQuotes(name) {
   if (name.startsWith('"') && name.endsWith('"') && name.length >= 2) {
     return name.slice(1, -1);
@@ -2888,7 +2996,16 @@ function parseMatch(raw) {
 async function lookupParticipant(scheme, id) {
   const participantParam = `iso6523-actorid-upis::${scheme}:${id}`;
   const url = `${BASE_URL}?participant=${encodeURIComponent(participantParam)}`;
-  const response = await fetch(url);
+  const response = await fetch(url, {
+    signal: AbortSignal.timeout(15e3),
+    headers: { "User-Agent": "@getpeppr/cli" }
+  });
+  if (!response.ok) {
+    throw new DirectoryError(
+      `Lookup failed: HTTP ${response.status} ${response.statusText}`,
+      response.status
+    );
+  }
   const data = await response.json();
   if (!data.matches || data.matches.length === 0) {
     return null;
@@ -2900,7 +3017,16 @@ async function searchParticipants(opts) {
   if (opts.name) params.set("name", opts.name);
   if (opts.country) params.set("country", opts.country);
   const url = `${BASE_URL}?${params.toString()}`;
-  const response = await fetch(url);
+  const response = await fetch(url, {
+    signal: AbortSignal.timeout(15e3),
+    headers: { "User-Agent": "@getpeppr/cli" }
+  });
+  if (!response.ok) {
+    throw new DirectoryError(
+      `Search failed: HTTP ${response.status} ${response.statusText}`,
+      response.status
+    );
+  }
   const data = await response.json();
   const allMatches = (data.matches ?? []).map(parseMatch);
   const limit = opts.limit ?? 10;
@@ -3066,7 +3192,12 @@ async function handleLookup(peppolId, options) {
   let result;
   try {
     result = await lookupParticipant(parsed.scheme, parsed.id);
-  } catch {
+  } catch (err) {
+    if (err instanceof DirectoryError) {
+      exitWithError(
+        `${pc4.red("\u2717")} Peppol Directory returned an error (HTTP ${err.status ?? "unknown"}). Try again later.`
+      );
+    }
     exitWithError(
       `${pc4.red("\u2717")} Could not reach Peppol Directory. Check your internet connection.`
     );
@@ -3103,7 +3234,12 @@ async function handleSearch(options) {
       country: options.country,
       limit
     });
-  } catch {
+  } catch (err) {
+    if (err instanceof DirectoryError) {
+      exitWithError(
+        `${pc4.red("\u2717")} Peppol Directory returned an error (HTTP ${err.status ?? "unknown"}). Try again later.`
+      );
+    }
     exitWithError(
       `${pc4.red("\u2717")} Could not reach Peppol Directory. Check your internet connection.`
     );