@financica/scrada-client 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# @financica/scrada-client
+
+TypeScript HTTP client for the [Scrada](https://www.scrada.be/) Peppol API. Scrada is a Belgian Peppol access point that exposes a JSON API for sending and receiving Peppol BIS Billing 3.0 documents (invoices, credit notes) plus participant registration and lookup.
+
+This package is the thin transport layer — it wraps `https://api.scrada.be/v1` and exposes typed request/response shapes. It does not build payloads from upstream sources like Stripe; for that, see [`@financica/scrada-stripe`](../scrada-stripe).
+
+## Installation
+
+```bash
+npm install @financica/scrada-client
+```
+
+Requires Node 18+ for the global `fetch`.
+
+## Usage
+
+```ts
+import { ScradaApiClient } from "@financica/scrada-client";
+
+const scrada = new ScradaApiClient({
+    apiKey: process.env.SCRADA_API_KEY!,
+    password: process.env.SCRADA_PASSWORD!,
+});
+
+const documentId = await scrada.sendOutboundSalesInvoice(companyId, invoice);
+const info = await scrada.getOutboundDocumentInfo(companyId, documentId);
+```
+
+Or construct it from environment variables:
+
+```ts
+import { createScradaApiClientFromEnv } from "@financica/scrada-client";
+
+// Reads SCRADA_API_KEY, SCRADA_PASSWORD, SCRADA_API_BASE_URL.
+const scrada = createScradaApiClientFromEnv();
+```
+
+## Methods
+
+| Method | HTTP | Path |
+| --- | --- | --- |
+| `registerCompany` | POST | `/company/{id}/peppol/register` |
+| `deregisterCompany` | DELETE | `/company/{id}/peppol/deregister/{scheme}/{id}` |
+| `getUnconfirmedInboundDocuments` | GET | `/company/{id}/peppol/inbound/document/unconfirmed` |
+| `getInboundDocument` | GET | `/company/{id}/peppol/inbound/document/{docId}` |
+| `getInboundDocumentPdf` | GET | `/company/{id}/peppol/inbound/document/{docId}/pdf` |
+| `confirmInboundDocument` | PUT | `/company/{id}/peppol/inbound/document/{docId}/confirm` |
+| `sendOutboundSalesInvoice` | POST | `/company/{id}/peppol/outbound/salesInvoice` |
+| `getOutboundDocumentInfo` | GET | `/company/{id}/peppol/outbound/document/{docId}/info` |
+| `lookupPeppolParticipant` | GET | `/company/{id}/peppol/lookup/{scheme}/{id}` |
+| `lookupPeppolParty` | POST | `/company/{id}/peppol/lookup` |
+
+## Errors
+
+All non-2xx responses surface as `ScradaApiError`:
+
+```ts
+import { ScradaApiClient, ScradaApiError } from "@financica/scrada-client";
+
+try {
+    await scrada.sendOutboundSalesInvoice(companyId, invoice);
+} catch (err) {
+    if (err instanceof ScradaApiError) {
+        console.error(err.status, err.message, err.details);
+    }
+    throw err;
+}
+```
+
+The `message` is extracted from the response body using `summarizeScradaErrorDetails`, which walks Scrada's variable error shapes (`{message}`, `{errors: [{detail}]}`, `{modelState}`, `{defaultFormat}`, …) and joins the human-readable strings with ` | `. The full original body is preserved on `err.details`.
+
+## Types
+
+- `PeppolOnlyInvoice` — the body shape for the outbound sales invoice and self-billing endpoints (mirrors `v1.PeppolOnlyInvoice` in the Scrada OpenAPI spec).
+- `PeppolOnlyInvoiceParty` — supplier or customer; includes the `vatStatus` field that determines whether the supplier may charge VAT (1 = Subject, 2 = Not subject, 3 = Small business / franchise).
+- `PeppolOnlyInvoiceLine`, `SalesInvoiceVatTotal`, `ScradaInvoiceAttachment`, `ScradaAddress`.
+- `ScradaInboundDocumentSummary`, `ScradaInboundDocumentResponse`, `ScradaOutboundDocumentInfo`, `ScradaPeppolLookupResponse`.
+- Enum-coded scalars: `CompanyVatStatus`, `CompanyInvoiceLineVatType`, `CompanyInvoiceTaxNumberType`.
+
+## Constants
+
+`DEFAULT_SCRADA_API_BASE_URL`, `SCRADA_LANGUAGE_HEADER`, `SCRADA_ATTACHMENT_FILE_TYPE_INVOICE`, plus the default Peppol identifier scheme strings (`DEFAULT_PEPPOL_*`) used during participant registration.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Mirrors v1.CompanyVatStatus.
+ *
+ *   1 — Subject to VAT (charges and remits VAT — the normal case)
+ *   2 — Not subject to VAT (no VAT registration at all)
+ *   3 — Small business / franchise exemption (has a VAT number but is exempt
+ *       from collecting VAT, e.g. Belgian Article 56bis kleine onderneming)
+ *
+ * Scrada uses this on the supplier party to decide whether the supplier may
+ * charge VAT on the outbound document. When unset, Scrada appears to default
+ * to a non-VAT-collecting status, and any non-zero VAT line is rejected with
+ * "VAT difference left for 0% VAT".
+ */
+type CompanyVatStatus = 1 | 2 | 3;
+/**
+ * Mirrors v1.CompanyInvoiceLineVatType (subset commonly used).
+ *
+ *   1 — Standard rate
+ *   2 — Zero rate
+ *   3 — Exempt from tax
+ *  50 — Reverse charge
+ *  52 — 0% Clause 44 (Article 44)
+ *
+ * The full enum supports 1–10, 20–22, 50–54, 70–72 (export, ICD, OSS, etc.).
+ * Modeled as `number` rather than a literal union so the rarer codes don't
+ * require library updates to stay valid.
+ */
+type CompanyInvoiceLineVatType = number;
+/** Mirrors v1.CompanyInvoiceTaxNumberType. 1 = BE, 2 = NL, 3 = FR. */
+type CompanyInvoiceTaxNumberType = 1 | 2 | 3;
+interface ScradaAddress {
+    street: string | null;
+    streetNumber: string | null;
+    streetBox: string | null;
+    city: string | null;
+    zipCode: string | null;
+    countrySubentity: string | null;
+    countryCode: string | null;
+}
+interface PeppolOnlyInvoiceParty {
+    peppolID?: string | null;
+    code?: string | null;
+    languageCode?: string | null;
+    name: string;
+    address: ScradaAddress;
+    phone?: string | null;
+    email?: string | null;
+    invoiceEmail?: string | null;
+    contact?: string | null;
+    vatStatus?: CompanyVatStatus;
+    taxNumberType?: CompanyInvoiceTaxNumberType;
+    taxNumber?: string | null;
+    legalPersonRegister?: string | null;
+    vatNumber?: string | null;
+    glnNumber?: string | null;
+}
+interface PeppolOnlyInvoiceLine {
+    lineNumber: string;
+    itemCodeSeller?: string | null;
+    itemCodeBuyer?: string | null;
+    itemName: string;
+    itemOriginCountryCode?: string | null;
+    quantity: number;
+    /** Scrada's CompanyInvoiceLineUomType code (1 = piece). */
+    unitType: number;
+    itemExclVat?: number | null;
+    itemInclVat?: number | null;
+    vatType: CompanyInvoiceLineVatType;
+    vatPercentage: number;
+    totalDiscountExclVat?: number | null;
+    totalDiscountInclVat?: number | null;
+    totalExclVat?: number | null;
+    totalInclVat?: number | null;
+    invoicePeriodStartDate?: string | null;
+    invoicePeriodEndDate?: string | null;
+}
+interface SalesInvoiceVatTotal {
+    vatType: CompanyInvoiceLineVatType;
+    vatPercentage: number;
+    totalExclVat: number;
+    totalVat: number;
+    totalInclVat: number;
+    note?: string | null;
+}
+interface ScradaInvoiceAttachment {
+    filename: string;
+    fileType: number;
+    mimeType: string;
+    base64Data: string;
+    externalReference?: string;
+}
+/**
+ * Body for POST /v1/company/{companyID}/peppol/outbound/salesInvoice
+ * (and the self-billing equivalent).
+ */
+interface PeppolOnlyInvoice {
+    number: string;
+    externalReference?: string | null;
+    creditInvoice?: boolean | null;
+    isInclVat?: boolean | null;
+    invoiceReference?: string | null;
+    invoiceDate: string;
+    invoiceExpiryDate?: string | null;
+    supplier: PeppolOnlyInvoiceParty;
+    customer: PeppolOnlyInvoiceParty;
+    totalExclVat: number;
+    totalInclVat: number;
+    totalVat: number;
+    currency?: string | null;
+    payableRoundingAmount?: number | null;
+    note?: string | null;
+    lines: PeppolOnlyInvoiceLine[];
+    vatTotals: SalesInvoiceVatTotal[];
+    paymentTerms?: string | null;
+    attachments?: ScradaInvoiceAttachment[] | null;
+}
+interface ScradaInboundDocumentSummary {
+    id: string;
+    internalNumber?: number;
+    peppolSenderScheme?: string;
+    peppolSenderID?: string;
+    peppolReceiverScheme?: string;
+    peppolReceiverID?: string;
+    peppolC1CountryCode?: string;
+    peppolC2Timestamp?: string;
+    peppolC2SeatID?: string;
+    peppolC2MessageID?: string;
+    peppolC3IncomingUniqueID?: string;
+    peppolC3MessageID?: string;
+    peppolC3Timestamp?: string;
+    peppolConversationID?: string;
+    peppolSbdhInstanceID?: string;
+    peppolProcessScheme?: string;
+    peppolProcessValue?: string;
+    peppolDocumentTypeScheme?: string;
+    peppolDocumentTypeValue?: string;
+}
+interface ScradaInboundUnconfirmedResponse {
+    results?: ScradaInboundDocumentSummary[];
+    __count?: number;
+}
+interface ScradaInboundDocumentResponse {
+    body: string;
+    contentType: string | null;
+    headers: Record<string, string>;
+}
+interface ScradaOutboundDocumentInfo {
+    id: string;
+    createdOn?: string;
+    externalReference?: string;
+    peppolSenderID?: string | null;
+    peppolReceiverID?: string | null;
+    peppolC1CountryCode?: string | null;
+    peppolC2Timestamp?: string | null;
+    peppolC2SeatID?: string | null;
+    peppolC2MessageID?: string | null;
+    peppolC3MessageID?: string | null;
+    peppolC3Timestamp?: string | null;
+    peppolC3SeatID?: string | null;
+    peppolConversationID?: string | null;
+    peppolSbdhInstanceID?: string | null;
+    peppolDocumentTypeScheme?: string | null;
+    peppolDocumentTypeValue?: string | null;
+    peppolProcessScheme?: string | null;
+    peppolProcessValue?: string | null;
+    salesInvoiceID?: string | null;
+    status: string;
+    attempt?: number;
+    errorMessage?: string;
+}
+interface ScradaPeppolLookupResponse {
+    registered?: boolean;
+    supportInvoice?: boolean;
+    supportCreditInvoice?: boolean;
+    supportSelfBillingInvoice?: boolean;
+    supportSelfBillingCreditInvoice?: boolean;
+    participantIdentifier?: {
+        scheme?: string;
+        id?: string;
+    } | null;
+    businessEntity?: {
+        name?: string;
+        languageCode?: string;
+        countryCode?: string;
+    } | null;
+    documentTypes?: Array<{
+        scheme?: string;
+        value?: string;
+        processIdentifier?: {
+            scheme?: string;
+            value?: string;
+        } | null;
+    }> | null;
+}
+
+interface ScradaApiClientOptions {
+    apiKey: string;
+    password: string;
+    baseUrl?: string;
+    /** Override the global `fetch` (e.g. for testing). */
+    fetch?: typeof fetch;
+}
+interface ScradaInboundPdfResponse {
+    arrayBuffer: ArrayBuffer;
+    contentType: string;
+    headers: Record<string, string>;
+}
+/**
+ * HTTP client for the Scrada Peppol API.
+ *
+ * https://api.scrada.be/v1
+ *
+ * Authenticates with API key + password sent as `X-API-KEY` / `X-PASSWORD`
+ * headers. All non-2xx responses surface as `ScradaApiError`.
+ */
+declare class ScradaApiClient {
+    private readonly apiKey;
+    private readonly password;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(options: ScradaApiClientOptions);
+    private buildHeaders;
+    private request;
+    registerCompany(companyId: string, payload: Record<string, unknown>): Promise<string>;
+    deregisterCompany(companyId: string, participantIdentifierScheme: string, participantIdentifierValue: string): Promise<void>;
+    getUnconfirmedInboundDocuments(companyId: string): Promise<ScradaInboundUnconfirmedResponse>;
+    getInboundDocument(companyId: string, documentId: string): Promise<ScradaInboundDocumentResponse>;
+    getInboundDocumentPdf(companyId: string, documentId: string): Promise<ScradaInboundPdfResponse>;
+    confirmInboundDocument(companyId: string, documentId: string): Promise<void>;
+    sendOutboundSalesInvoice(companyId: string, payload: PeppolOnlyInvoice): Promise<string>;
+    getOutboundDocumentInfo(companyId: string, documentId: string): Promise<ScradaOutboundDocumentInfo>;
+    lookupPeppolParticipant(companyId: string, scheme: string, id: string): Promise<ScradaPeppolLookupResponse>;
+    lookupPeppolParty(companyId: string, payload: Record<string, unknown>): Promise<ScradaPeppolLookupResponse>;
+}
+/**
+ * Create a Scrada API client from the canonical environment variables.
+ * Throws when SCRADA_API_KEY or SCRADA_PASSWORD is missing.
+ */
+declare const createScradaApiClientFromEnv: (env?: NodeJS.ProcessEnv) => ScradaApiClient;
+
+declare const DEFAULT_SCRADA_API_BASE_URL = "https://api.scrada.be/v1";
+/** Language sent in the Scrada `Language` request header (server may localize errors). */
+declare const SCRADA_LANGUAGE_HEADER = "EN";
+declare const DEFAULT_PEPPOL_SENDER_IDENTIFIER_SCHEME = "iso6523-actorid-upis";
+/** ISO/IEC 6523 0208: Belgian enterprise number (KBO/BCE). */
+declare const DEFAULT_PEPPOL_COMPANY_IDENTIFIER_SCHEME = "0208";
+/** ISO/IEC 6523 9925: Belgian VAT number scheme. */
+declare const DEFAULT_PEPPOL_VAT_IDENTIFIER_SCHEME = "9925";
+declare const DEFAULT_PEPPOL_DOCUMENT_TYPE_SCHEME = "busdox-docid-qns";
+declare const DEFAULT_PEPPOL_DOCUMENT_TYPE_VALUE = "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1";
+declare const DEFAULT_PEPPOL_PROCESS_SCHEME = "cenbii-procid-ubl";
+declare const DEFAULT_PEPPOL_PROCESS_VALUE = "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0";
+/** Scrada `attachment.fileType` value for the primary invoice/credit note PDF. */
+declare const SCRADA_ATTACHMENT_FILE_TYPE_INVOICE = 1;
+
+declare class ScradaApiError extends Error {
+    status: number;
+    details: unknown;
+    constructor(message: string, status: number, details: unknown);
+}
+/**
+ * Walks a Scrada error response body and pulls out the human-readable
+ * message strings. Returns `null` when nothing usable is found.
+ *
+ * Scrada returns errors in several shapes (string, `{message}`,
+ * `{errors: [{detail}]}`, `{modelState: {...}}`, etc.); this collapses
+ * them into a single ` | `-separated summary.
+ */
+declare const summarizeScradaErrorDetails: (details: unknown) => string | null;
+/**
+ * Converts a non-2xx Scrada response into a ScradaApiError, parsing the body
+ * as JSON when possible and extracting message strings via
+ * {@link summarizeScradaErrorDetails}.
+ */
+declare const scradaApiErrorFromResponse: (response: Response) => Promise<ScradaApiError>;
+
+export { type CompanyInvoiceLineVatType, type CompanyInvoiceTaxNumberType, type CompanyVatStatus, DEFAULT_PEPPOL_COMPANY_IDENTIFIER_SCHEME, DEFAULT_PEPPOL_DOCUMENT_TYPE_SCHEME, DEFAULT_PEPPOL_DOCUMENT_TYPE_VALUE, DEFAULT_PEPPOL_PROCESS_SCHEME, DEFAULT_PEPPOL_PROCESS_VALUE, DEFAULT_PEPPOL_SENDER_IDENTIFIER_SCHEME, DEFAULT_PEPPOL_VAT_IDENTIFIER_SCHEME, DEFAULT_SCRADA_API_BASE_URL, type PeppolOnlyInvoice, type PeppolOnlyInvoiceLine, type PeppolOnlyInvoiceParty, SCRADA_ATTACHMENT_FILE_TYPE_INVOICE, SCRADA_LANGUAGE_HEADER, type SalesInvoiceVatTotal, type ScradaAddress, ScradaApiClient, type ScradaApiClientOptions, ScradaApiError, type ScradaInboundDocumentResponse, type ScradaInboundDocumentSummary, type ScradaInboundPdfResponse, type ScradaInboundUnconfirmedResponse, type ScradaInvoiceAttachment, type ScradaOutboundDocumentInfo, type ScradaPeppolLookupResponse, createScradaApiClientFromEnv, scradaApiErrorFromResponse, summarizeScradaErrorDetails };

package/dist/index.js

@@ -0,0 +1,312 @@
+// src/constants.ts
+var DEFAULT_SCRADA_API_BASE_URL = "https://api.scrada.be/v1";
+var SCRADA_LANGUAGE_HEADER = "EN";
+var DEFAULT_PEPPOL_SENDER_IDENTIFIER_SCHEME = "iso6523-actorid-upis";
+var DEFAULT_PEPPOL_COMPANY_IDENTIFIER_SCHEME = "0208";
+var DEFAULT_PEPPOL_VAT_IDENTIFIER_SCHEME = "9925";
+var DEFAULT_PEPPOL_DOCUMENT_TYPE_SCHEME = "busdox-docid-qns";
+var DEFAULT_PEPPOL_DOCUMENT_TYPE_VALUE = "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1";
+var DEFAULT_PEPPOL_PROCESS_SCHEME = "cenbii-procid-ubl";
+var DEFAULT_PEPPOL_PROCESS_VALUE = "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0";
+var SCRADA_ATTACHMENT_FILE_TYPE_INVOICE = 1;
+
+// src/errors.ts
+var ScradaApiError = class extends Error {
+  status;
+  details;
+  constructor(message, status, details) {
+    super(message);
+    this.name = "ScradaApiError";
+    this.status = status;
+    this.details = details;
+  }
+};
+var tryParseJson = (value) => {
+  try {
+    return JSON.parse(value);
+  } catch {
+    return null;
+  }
+};
+var normalizeDetailMessage = (value) => value.trim().replace(/\s+/g, " ");
+var collectDetailMessages = (value, collector, depth = 0) => {
+  if (depth > 4 || value === null || value === void 0) return;
+  if (typeof value === "string") {
+    const normalized = normalizeDetailMessage(value);
+    if (normalized.length > 0) collector.add(normalized);
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const entry of value) {
+      collectDetailMessages(entry, collector, depth + 1);
+    }
+    return;
+  }
+  if (typeof value !== "object") return;
+  const record = value;
+  const preferredFields = [
+    "defaultFormat",
+    "message",
+    "error",
+    "title",
+    "detail",
+    "description",
+    "reason"
+  ];
+  for (const field of preferredFields) {
+    const fieldValue = record[field];
+    if (typeof fieldValue === "string") {
+      const normalized = normalizeDetailMessage(fieldValue);
+      if (normalized.length > 0) collector.add(normalized);
+    }
+  }
+  const nestedFields = ["details", "errors", "validationErrors", "modelState"];
+  for (const field of nestedFields) {
+    if (field in record) {
+      collectDetailMessages(record[field], collector, depth + 1);
+    }
+  }
+  for (const [key, fieldValue] of Object.entries(record)) {
+    if (preferredFields.includes(key) || nestedFields.includes(key)) continue;
+    if (typeof fieldValue === "string") {
+      const normalized = normalizeDetailMessage(fieldValue);
+      if (normalized.length > 0 && /error|invalid|missing|required/i.test(key)) {
+        collector.add(normalized);
+      }
+      continue;
+    }
+    if (Array.isArray(fieldValue) || fieldValue && typeof fieldValue === "object") {
+      collectDetailMessages(fieldValue, collector, depth + 1);
+    }
+  }
+};
+var summarizeScradaErrorDetails = (details) => {
+  const collector = /* @__PURE__ */ new Set();
+  collectDetailMessages(details, collector);
+  if (collector.size === 0) return null;
+  return Array.from(collector).slice(0, 6).join(" | ");
+};
+var coerceErrorMessage = (details, fallback) => summarizeScradaErrorDetails(details) ?? fallback;
+var scradaApiErrorFromResponse = async (response) => {
+  const textBody = await response.text();
+  const parsed = tryParseJson(textBody) ?? textBody;
+  return new ScradaApiError(
+    coerceErrorMessage(
+      parsed,
+      `Scrada request failed with status ${response.status}`
+    ),
+    response.status,
+    parsed
+  );
+};
+
+// src/client.ts
+var joinUrl = (baseUrl, path) => {
+  const normalizedBase = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  return `${normalizedBase}${normalizedPath}`;
+};
+var normalizeHeaders = (headers) => {
+  const result = {};
+  headers.forEach((value, key) => {
+    result[key.toLowerCase()] = value;
+  });
+  return result;
+};
+var normalizeDocumentId = (value) => {
+  if (typeof value === "string" && value.trim().length > 0) return value.trim();
+  if (value && typeof value === "object") {
+    const record = value;
+    if (typeof record.id === "string" && record.id.trim().length > 0) {
+      return record.id.trim();
+    }
+    if (typeof record.documentID === "string" && record.documentID.trim().length > 0) {
+      return record.documentID.trim();
+    }
+  }
+  throw new Error("Unable to resolve document ID from Scrada response");
+};
+var tryParseJson2 = (value) => {
+  try {
+    return JSON.parse(value);
+  } catch {
+    return null;
+  }
+};
+var ScradaApiClient = class {
+  apiKey;
+  password;
+  baseUrl;
+  fetchImpl;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.password = options.password;
+    this.baseUrl = options.baseUrl ?? DEFAULT_SCRADA_API_BASE_URL;
+    this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  buildHeaders(extra) {
+    const headers = new Headers({
+      "X-API-KEY": this.apiKey,
+      "X-PASSWORD": this.password,
+      Language: SCRADA_LANGUAGE_HEADER
+    });
+    if (extra) {
+      const extraHeaders = new Headers(extra);
+      extraHeaders.forEach((value, key) => {
+        headers.set(key, value);
+      });
+    }
+    return headers;
+  }
+  async request(params) {
+    const response = await this.fetchImpl(joinUrl(this.baseUrl, params.path), {
+      method: params.method ?? "GET",
+      headers: this.buildHeaders(params.headers),
+      body: params.body
+    });
+    if (!response.ok) {
+      throw await scradaApiErrorFromResponse(response);
+    }
+    const expect = params.expect ?? "json";
+    if (expect === "arrayBuffer") {
+      return await response.arrayBuffer();
+    }
+    if (expect === "text") {
+      return await response.text();
+    }
+    const textBody = await response.text();
+    if (!textBody) return null;
+    const parsed = tryParseJson2(textBody);
+    if (parsed !== null) return parsed;
+    return textBody;
+  }
+  // ── Peppol registration ─────────────────────────────────────────────
+  async registerCompany(companyId, payload) {
+    const response = await this.request({
+      path: `/company/${companyId}/peppol/register`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload)
+    });
+    return normalizeDocumentId(response);
+  }
+  async deregisterCompany(companyId, participantIdentifierScheme, participantIdentifierValue) {
+    await this.request({
+      path: `/company/${companyId}/peppol/deregister/${encodeURIComponent(
+        participantIdentifierScheme
+      )}/${encodeURIComponent(participantIdentifierValue)}`,
+      method: "DELETE"
+    });
+  }
+  // ── Inbound documents ───────────────────────────────────────────────
+  async getUnconfirmedInboundDocuments(companyId) {
+    return this.request({
+      path: `/company/${companyId}/peppol/inbound/document/unconfirmed`
+    });
+  }
+  async getInboundDocument(companyId, documentId) {
+    const response = await this.fetchImpl(
+      joinUrl(
+        this.baseUrl,
+        `/company/${companyId}/peppol/inbound/document/${documentId}`
+      ),
+      {
+        method: "GET",
+        headers: this.buildHeaders()
+      }
+    );
+    if (!response.ok) throw await scradaApiErrorFromResponse(response);
+    return {
+      body: await response.text(),
+      contentType: response.headers.get("content-type"),
+      headers: normalizeHeaders(response.headers)
+    };
+  }
+  async getInboundDocumentPdf(companyId, documentId) {
+    const response = await this.fetchImpl(
+      joinUrl(
+        this.baseUrl,
+        `/company/${companyId}/peppol/inbound/document/${documentId}/pdf`
+      ),
+      {
+        method: "GET",
+        headers: this.buildHeaders()
+      }
+    );
+    if (!response.ok) throw await scradaApiErrorFromResponse(response);
+    return {
+      arrayBuffer: await response.arrayBuffer(),
+      contentType: response.headers.get("content-type") ?? "application/pdf",
+      headers: normalizeHeaders(response.headers)
+    };
+  }
+  async confirmInboundDocument(companyId, documentId) {
+    await this.request({
+      path: `/company/${companyId}/peppol/inbound/document/${documentId}/confirm`,
+      method: "PUT"
+    });
+  }
+  // ── Outbound documents ──────────────────────────────────────────────
+  async sendOutboundSalesInvoice(companyId, payload) {
+    const response = await this.request({
+      path: `/company/${companyId}/peppol/outbound/salesInvoice`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload)
+    });
+    return normalizeDocumentId(response);
+  }
+  async getOutboundDocumentInfo(companyId, documentId) {
+    return this.request({
+      path: `/company/${companyId}/peppol/outbound/document/${documentId}/info`
+    });
+  }
+  // ── Peppol participant lookup ───────────────────────────────────────
+  async lookupPeppolParticipant(companyId, scheme, id) {
+    return this.request({
+      path: `/company/${companyId}/peppol/lookup/${encodeURIComponent(
+        scheme
+      )}/${encodeURIComponent(id)}`
+    });
+  }
+  async lookupPeppolParty(companyId, payload) {
+    return this.request({
+      path: `/company/${companyId}/peppol/lookup`,
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload)
+    });
+  }
+};
+var createScradaApiClientFromEnv = (env = process.env) => {
+  const apiKey = env.SCRADA_API_KEY;
+  const password = env.SCRADA_PASSWORD;
+  if (!apiKey || !password) {
+    throw new Error(
+      "Scrada credentials are not configured. Set SCRADA_API_KEY and SCRADA_PASSWORD."
+    );
+  }
+  return new ScradaApiClient({
+    apiKey,
+    password,
+    baseUrl: env.SCRADA_API_BASE_URL
+  });
+};
+export {
+  DEFAULT_PEPPOL_COMPANY_IDENTIFIER_SCHEME,
+  DEFAULT_PEPPOL_DOCUMENT_TYPE_SCHEME,
+  DEFAULT_PEPPOL_DOCUMENT_TYPE_VALUE,
+  DEFAULT_PEPPOL_PROCESS_SCHEME,
+  DEFAULT_PEPPOL_PROCESS_VALUE,
+  DEFAULT_PEPPOL_SENDER_IDENTIFIER_SCHEME,
+  DEFAULT_PEPPOL_VAT_IDENTIFIER_SCHEME,
+  DEFAULT_SCRADA_API_BASE_URL,
+  SCRADA_ATTACHMENT_FILE_TYPE_INVOICE,
+  SCRADA_LANGUAGE_HEADER,
+  ScradaApiClient,
+  ScradaApiError,
+  createScradaApiClientFromEnv,
+  scradaApiErrorFromResponse,
+  summarizeScradaErrorDetails
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/errors.ts","../src/client.ts"],"sourcesContent":["export const DEFAULT_SCRADA_API_BASE_URL = \"https://api.scrada.be/v1\";\n\n/** Language sent in the Scrada `Language` request header (server may localize errors). */\nexport const SCRADA_LANGUAGE_HEADER = \"EN\";\n\n// ── Peppol identifier scheme defaults ────────────────────────────────\n\nexport const DEFAULT_PEPPOL_SENDER_IDENTIFIER_SCHEME = \"iso6523-actorid-upis\";\n/** ISO/IEC 6523 0208: Belgian enterprise number (KBO/BCE). */\nexport const DEFAULT_PEPPOL_COMPANY_IDENTIFIER_SCHEME = \"0208\";\n/** ISO/IEC 6523 9925: Belgian VAT number scheme. */\nexport const DEFAULT_PEPPOL_VAT_IDENTIFIER_SCHEME = \"9925\";\nexport const DEFAULT_PEPPOL_DOCUMENT_TYPE_SCHEME = \"busdox-docid-qns\";\nexport const DEFAULT_PEPPOL_DOCUMENT_TYPE_VALUE =\n\t\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1\";\nexport const DEFAULT_PEPPOL_PROCESS_SCHEME = \"cenbii-procid-ubl\";\nexport const DEFAULT_PEPPOL_PROCESS_VALUE =\n\t\"urn:fdc:peppol.eu:2017:poacc:billing:01:1.0\";\n\n// ── Scrada attachment file type codes ────────────────────────────────\n\n/** Scrada `attachment.fileType` value for the primary invoice/credit note PDF. */\nexport const SCRADA_ATTACHMENT_FILE_TYPE_INVOICE = 1;\n","export class ScradaApiError extends Error {\n\tstatus: number;\n\tdetails: unknown;\n\n\tconstructor(message: string, status: number, details: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"ScradaApiError\";\n\t\tthis.status = status;\n\t\tthis.details = details;\n\t}\n}\n\nconst tryParseJson = (value: string): unknown => {\n\ttry {\n\t\treturn JSON.parse(value) as unknown;\n\t} catch {\n\t\treturn null;\n\t}\n};\n\nconst normalizeDetailMessage = (value: string) => value.trim().replace(/\\s+/g, \" \");\n\nconst collectDetailMessages = (value: unknown, collector: Set<string>, depth = 0) => {\n\tif (depth > 4 || value === null || value === undefined) return;\n\n\tif (typeof value === \"string\") {\n\t\tconst normalized = normalizeDetailMessage(value);\n\t\tif (normalized.length > 0) collector.add(normalized);\n\t\treturn;\n\t}\n\n\tif (Array.isArray(value)) {\n\t\tfor (const entry of value) {\n\t\t\tcollectDetailMessages(entry, collector, depth + 1);\n\t\t}\n\t\treturn;\n\t}\n\n\tif (typeof value !== \"object\") return;\n\tconst record = value as Record<string, unknown>;\n\n\tconst preferredFields = [\n\t\t\"defaultFormat\",\n\t\t\"message\",\n\t\t\"error\",\n\t\t\"title\",\n\t\t\"detail\",\n\t\t\"description\",\n\t\t\"reason\",\n\t];\n\n\tfor (const field of preferredFields) {\n\t\tconst fieldValue = record[field];\n\t\tif (typeof fieldValue === \"string\") {\n\t\t\tconst normalized = normalizeDetailMessage(fieldValue);\n\t\t\tif (normalized.length > 0) collector.add(normalized);\n\t\t}\n\t}\n\n\tconst nestedFields = [\"details\", \"errors\", \"validationErrors\", \"modelState\"];\n\tfor (const field of nestedFields) {\n\t\tif (field in record) {\n\t\t\tcollectDetailMessages(record[field], collector, depth + 1);\n\t\t}\n\t}\n\n\tfor (const [key, fieldValue] of Object.entries(record)) {\n\t\tif (preferredFields.includes(key) || nestedFields.includes(key)) continue;\n\t\tif (typeof fieldValue === \"string\") {\n\t\t\tconst normalized = normalizeDetailMessage(fieldValue);\n\t\t\tif (normalized.length > 0 && /error|invalid|missing|required/i.test(key)) {\n\t\t\t\tcollector.add(normalized);\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\tArray.isArray(fieldValue) ||\n\t\t\t(fieldValue && typeof fieldValue === \"object\")\n\t\t) {\n\t\t\tcollectDetailMessages(fieldValue, collector, depth + 1);\n\t\t}\n\t}\n};\n\n/**\n * Walks a Scrada error response body and pulls out the human-readable\n * message strings. Returns `null` when nothing usable is found.\n *\n * Scrada returns errors in several shapes (string, `{message}`,\n * `{errors: [{detail}]}`, `{modelState: {...}}`, etc.); this collapses\n * them into a single ` | `-separated summary.\n */\nexport const summarizeScradaErrorDetails = (details: unknown): string | null => {\n\tconst collector = new Set<string>();\n\tcollectDetailMessages(details, collector);\n\tif (collector.size === 0) return null;\n\treturn Array.from(collector).slice(0, 6).join(\" | \");\n};\n\nconst coerceErrorMessage = (details: unknown, fallback: string) =>\n\tsummarizeScradaErrorDetails(details) ?? fallback;\n\n/**\n * Converts a non-2xx Scrada response into a ScradaApiError, parsing the body\n * as JSON when possible and extracting message strings via\n * {@link summarizeScradaErrorDetails}.\n */\nexport const scradaApiErrorFromResponse = async (\n\tresponse: Response,\n): Promise<ScradaApiError> => {\n\tconst textBody = await response.text();\n\tconst parsed = tryParseJson(textBody) ?? textBody;\n\treturn new ScradaApiError(\n\t\tcoerceErrorMessage(\n\t\t\tparsed,\n\t\t\t`Scrada request failed with status ${response.status}`,\n\t\t),\n\t\tresponse.status,\n\t\tparsed,\n\t);\n};\n","import { DEFAULT_SCRADA_API_BASE_URL, SCRADA_LANGUAGE_HEADER } from \"./constants\";\nimport { scradaApiErrorFromResponse } from \"./errors\";\nimport type {\n\tPeppolOnlyInvoice,\n\tScradaInboundDocumentResponse,\n\tScradaInboundUnconfirmedResponse,\n\tScradaOutboundDocumentInfo,\n\tScradaPeppolLookupResponse,\n} from \"./types\";\n\ntype ScradaRequestMethod = \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n\nexport interface ScradaApiClientOptions {\n\tapiKey: string;\n\tpassword: string;\n\tbaseUrl?: string;\n\t/** Override the global `fetch` (e.g. for testing). */\n\tfetch?: typeof fetch;\n}\n\nexport interface ScradaInboundPdfResponse {\n\tarrayBuffer: ArrayBuffer;\n\tcontentType: string;\n\theaders: Record<string, string>;\n}\n\nconst joinUrl = (baseUrl: string, path: string) => {\n\tconst normalizedBase = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\n\tconst normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n\treturn `${normalizedBase}${normalizedPath}`;\n};\n\nconst normalizeHeaders = (headers: Headers) => {\n\tconst result: Record<string, string> = {};\n\theaders.forEach((value, key) => {\n\t\tresult[key.toLowerCase()] = value;\n\t});\n\treturn result;\n};\n\nconst normalizeDocumentId = (value: unknown): string => {\n\tif (typeof value === \"string\" && value.trim().length > 0) return value.trim();\n\tif (value && typeof value === \"object\") {\n\t\tconst record = value as Record<string, unknown>;\n\t\tif (typeof record.id === \"string\" && record.id.trim().length > 0) {\n\t\t\treturn record.id.trim();\n\t\t}\n\t\tif (\n\t\t\ttypeof record.documentID === \"string\" &&\n\t\t\trecord.documentID.trim().length > 0\n\t\t) {\n\t\t\treturn record.documentID.trim();\n\t\t}\n\t}\n\tthrow new Error(\"Unable to resolve document ID from Scrada response\");\n};\n\nconst tryParseJson = (value: string): unknown => {\n\ttry {\n\t\treturn JSON.parse(value) as unknown;\n\t} catch {\n\t\treturn null;\n\t}\n};\n\n/**\n * HTTP client for the Scrada Peppol API.\n *\n * https://api.scrada.be/v1\n *\n * Authenticates with API key + password sent as `X-API-KEY` / `X-PASSWORD`\n * headers. All non-2xx responses surface as `ScradaApiError`.\n */\nexport class ScradaApiClient {\n\tprivate readonly apiKey: string;\n\tprivate readonly password: string;\n\tprivate readonly baseUrl: string;\n\tprivate readonly fetchImpl: typeof fetch;\n\n\tconstructor(options: ScradaApiClientOptions) {\n\t\tthis.apiKey = options.apiKey;\n\t\tthis.password = options.password;\n\t\tthis.baseUrl = options.baseUrl ?? DEFAULT_SCRADA_API_BASE_URL;\n\t\tthis.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);\n\t}\n\n\tprivate buildHeaders(extra?: HeadersInit): Headers {\n\t\tconst headers = new Headers({\n\t\t\t\"X-API-KEY\": this.apiKey,\n\t\t\t\"X-PASSWORD\": this.password,\n\t\t\tLanguage: SCRADA_LANGUAGE_HEADER,\n\t\t});\n\t\tif (extra) {\n\t\t\tconst extraHeaders = new Headers(extra);\n\t\t\textraHeaders.forEach((value, key) => {\n\t\t\t\theaders.set(key, value);\n\t\t\t});\n\t\t}\n\t\treturn headers;\n\t}\n\n\tprivate async request<T>(params: {\n\t\tpath: string;\n\t\tmethod?: ScradaRequestMethod;\n\t\tbody?: BodyInit;\n\t\theaders?: HeadersInit;\n\t\texpect?: \"json\" | \"text\" | \"arrayBuffer\";\n\t}): Promise<T> {\n\t\tconst response = await this.fetchImpl(joinUrl(this.baseUrl, params.path), {\n\t\t\tmethod: params.method ?? \"GET\",\n\t\t\theaders: this.buildHeaders(params.headers),\n\t\t\tbody: params.body,\n\t\t});\n\n\t\tif (!response.ok) {\n\t\t\tthrow await scradaApiErrorFromResponse(response);\n\t\t}\n\n\t\tconst expect = params.expect ?? \"json\";\n\t\tif (expect === \"arrayBuffer\") {\n\t\t\treturn (await response.arrayBuffer()) as T;\n\t\t}\n\t\tif (expect === \"text\") {\n\t\t\treturn (await response.text()) as T;\n\t\t}\n\n\t\tconst textBody = await response.text();\n\t\tif (!textBody) return null as T;\n\t\tconst parsed = tryParseJson(textBody);\n\t\tif (parsed !== null) return parsed as T;\n\t\treturn textBody as T;\n\t}\n\n\t// ── Peppol registration ─────────────────────────────────────────────\n\n\tasync registerCompany(\n\t\tcompanyId: string,\n\t\tpayload: Record<string, unknown>,\n\t): Promise<string> {\n\t\tconst response = await this.request<unknown>({\n\t\t\tpath: `/company/${companyId}/peppol/register`,\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(payload),\n\t\t});\n\t\treturn normalizeDocumentId(response);\n\t}\n\n\tasync deregisterCompany(\n\t\tcompanyId: string,\n\t\tparticipantIdentifierScheme: string,\n\t\tparticipantIdentifierValue: string,\n\t): Promise<void> {\n\t\tawait this.request<null>({\n\t\t\tpath: `/company/${companyId}/peppol/deregister/${encodeURIComponent(\n\t\t\t\tparticipantIdentifierScheme,\n\t\t\t)}/${encodeURIComponent(participantIdentifierValue)}`,\n\t\t\tmethod: \"DELETE\",\n\t\t});\n\t}\n\n\t// ── Inbound documents ───────────────────────────────────────────────\n\n\tasync getUnconfirmedInboundDocuments(\n\t\tcompanyId: string,\n\t): Promise<ScradaInboundUnconfirmedResponse> {\n\t\treturn this.request<ScradaInboundUnconfirmedResponse>({\n\t\t\tpath: `/company/${companyId}/peppol/inbound/document/unconfirmed`,\n\t\t});\n\t}\n\n\tasync getInboundDocument(\n\t\tcompanyId: string,\n\t\tdocumentId: string,\n\t): Promise<ScradaInboundDocumentResponse> {\n\t\tconst response = await this.fetchImpl(\n\t\t\tjoinUrl(\n\t\t\t\tthis.baseUrl,\n\t\t\t\t`/company/${companyId}/peppol/inbound/document/${documentId}`,\n\t\t\t),\n\t\t\t{\n\t\t\t\tmethod: \"GET\",\n\t\t\t\theaders: this.buildHeaders(),\n\t\t\t},\n\t\t);\n\n\t\tif (!response.ok) throw await scradaApiErrorFromResponse(response);\n\n\t\treturn {\n\t\t\tbody: await response.text(),\n\t\t\tcontentType: response.headers.get(\"content-type\"),\n\t\t\theaders: normalizeHeaders(response.headers),\n\t\t};\n\t}\n\n\tasync getInboundDocumentPdf(\n\t\tcompanyId: string,\n\t\tdocumentId: string,\n\t): Promise<ScradaInboundPdfResponse> {\n\t\tconst response = await this.fetchImpl(\n\t\t\tjoinUrl(\n\t\t\t\tthis.baseUrl,\n\t\t\t\t`/company/${companyId}/peppol/inbound/document/${documentId}/pdf`,\n\t\t\t),\n\t\t\t{\n\t\t\t\tmethod: \"GET\",\n\t\t\t\theaders: this.buildHeaders(),\n\t\t\t},\n\t\t);\n\t\tif (!response.ok) throw await scradaApiErrorFromResponse(response);\n\n\t\treturn {\n\t\t\tarrayBuffer: await response.arrayBuffer(),\n\t\t\tcontentType: response.headers.get(\"content-type\") ?? \"application/pdf\",\n\t\t\theaders: normalizeHeaders(response.headers),\n\t\t};\n\t}\n\n\tasync confirmInboundDocument(companyId: string, documentId: string): Promise<void> {\n\t\tawait this.request<null>({\n\t\t\tpath: `/company/${companyId}/peppol/inbound/document/${documentId}/confirm`,\n\t\t\tmethod: \"PUT\",\n\t\t});\n\t}\n\n\t// ── Outbound documents ──────────────────────────────────────────────\n\n\tasync sendOutboundSalesInvoice(\n\t\tcompanyId: string,\n\t\tpayload: PeppolOnlyInvoice,\n\t): Promise<string> {\n\t\tconst response = await this.request<unknown>({\n\t\t\tpath: `/company/${companyId}/peppol/outbound/salesInvoice`,\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(payload),\n\t\t});\n\t\treturn normalizeDocumentId(response);\n\t}\n\n\tasync getOutboundDocumentInfo(\n\t\tcompanyId: string,\n\t\tdocumentId: string,\n\t): Promise<ScradaOutboundDocumentInfo> {\n\t\treturn this.request<ScradaOutboundDocumentInfo>({\n\t\t\tpath: `/company/${companyId}/peppol/outbound/document/${documentId}/info`,\n\t\t});\n\t}\n\n\t// ── Peppol participant lookup ───────────────────────────────────────\n\n\tasync lookupPeppolParticipant(\n\t\tcompanyId: string,\n\t\tscheme: string,\n\t\tid: string,\n\t): Promise<ScradaPeppolLookupResponse> {\n\t\treturn this.request<ScradaPeppolLookupResponse>({\n\t\t\tpath: `/company/${companyId}/peppol/lookup/${encodeURIComponent(\n\t\t\t\tscheme,\n\t\t\t)}/${encodeURIComponent(id)}`,\n\t\t});\n\t}\n\n\tasync lookupPeppolParty(\n\t\tcompanyId: string,\n\t\tpayload: Record<string, unknown>,\n\t): Promise<ScradaPeppolLookupResponse> {\n\t\treturn this.request<ScradaPeppolLookupResponse>({\n\t\t\tpath: `/company/${companyId}/peppol/lookup`,\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { \"Content-Type\": \"application/json\" },\n\t\t\tbody: JSON.stringify(payload),\n\t\t});\n\t}\n}\n\n/**\n * Create a Scrada API client from the canonical environment variables.\n * Throws when SCRADA_API_KEY or SCRADA_PASSWORD is missing.\n */\nexport const createScradaApiClientFromEnv = (\n\tenv: NodeJS.ProcessEnv = process.env,\n): ScradaApiClient => {\n\tconst apiKey = env.SCRADA_API_KEY;\n\tconst password = env.SCRADA_PASSWORD;\n\tif (!apiKey || !password) {\n\t\tthrow new Error(\n\t\t\t\"Scrada credentials are not configured. Set SCRADA_API_KEY and SCRADA_PASSWORD.\",\n\t\t);\n\t}\n\n\treturn new ScradaApiClient({\n\t\tapiKey,\n\t\tpassword,\n\t\tbaseUrl: env.SCRADA_API_BASE_URL,\n\t});\n};\n"],"mappings":"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","names":["tryParseJson"]}

package/package.json

@@ -0,0 +1,38 @@
+{
+	"name": "@financica/scrada-client",
+	"version": "0.1.0",
+	"description": "TypeScript HTTP client for the Scrada Peppol API (https://api.scrada.be/v1).",
+	"license": "MIT",
+	"type": "module",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsup",
+		"prepack": "bun run build",
+		"lint": "biome check .",
+		"format": "biome format --write .",
+		"type-check": "tsc --noEmit",
+		"test": "vitest",
+		"test:run": "vitest --run",
+		"ci": "bun run type-check && bun run lint && bun run test:run && bun run build"
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.13",
+		"@types/node": "^22.0.0",
+		"tsup": "^8.0.0",
+		"typescript": "^5.9.3",
+		"vitest": "^4.0.18"
+	}
+}