@taxora/sdk 1.8.0 → 1.9.0

package/dist/index.js

@@ -440,6 +440,213 @@ var AuthEndpoint = class {
   }
 };
 
+// src/dto/UsageSummary.ts
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function asRecordList(value) {
+  return Array.isArray(value) ? value.filter((row) => asRecord(row) !== null) : [];
+}
+function asString(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNullableString(value) {
+  return typeof value === "string" ? value : null;
+}
+function asNumber(value) {
+  return typeof value === "number" ? value : Number(value ?? 0) || 0;
+}
+function asNullableNumber(value) {
+  if (value === null || value === void 0 || value === "") return null;
+  const num = Number(value);
+  return Number.isFinite(num) ? num : null;
+}
+var UsageSummary = class _UsageSummary {
+  constructor(id, companyId, feature, country, regime, billingPeriod, eventCount, billableAmount, state, stateLabel, periodClosedAt, billingTriggeredAt, billedAt, stripeInvoiceId, stripeSubscriptionItemId, billingNotes, events, createdAt, updatedAt) {
+    this.id = id;
+    this.companyId = companyId;
+    this.feature = feature;
+    this.country = country;
+    this.regime = regime;
+    this.billingPeriod = billingPeriod;
+    this.eventCount = eventCount;
+    this.billableAmount = billableAmount;
+    this.state = state;
+    this.stateLabel = stateLabel;
+    this.periodClosedAt = periodClosedAt;
+    this.billingTriggeredAt = billingTriggeredAt;
+    this.billedAt = billedAt;
+    this.stripeInvoiceId = stripeInvoiceId;
+    this.stripeSubscriptionItemId = stripeSubscriptionItemId;
+    this.billingNotes = billingNotes;
+    this.events = events;
+    this.createdAt = createdAt;
+    this.updatedAt = updatedAt;
+  }
+  id;
+  companyId;
+  feature;
+  country;
+  regime;
+  billingPeriod;
+  eventCount;
+  billableAmount;
+  state;
+  stateLabel;
+  periodClosedAt;
+  billingTriggeredAt;
+  billedAt;
+  stripeInvoiceId;
+  stripeSubscriptionItemId;
+  billingNotes;
+  events;
+  createdAt;
+  updatedAt;
+  static fromArray(data) {
+    const amount = data["billable_amount"];
+    return new _UsageSummary(
+      asNumber(data["id"]),
+      asNumber(data["company_id"]),
+      asString(data["feature"]),
+      asNullableString(data["country"]),
+      asNullableString(data["regime"]),
+      asString(data["billing_period"]),
+      asNumber(data["event_count"]),
+      typeof amount === "string" ? amount : typeof amount === "number" ? String(amount) : null,
+      asNullableString(data["state"]),
+      asNullableString(data["state_label"]),
+      asNullableString(data["period_closed_at"]),
+      asNullableString(data["billing_triggered_at"]),
+      asNullableString(data["billed_at"]),
+      asNullableString(data["stripe_invoice_id"]),
+      asNullableString(data["stripe_subscription_item_id"]),
+      asNullableString(data["billing_notes"]),
+      asRecordList(data["events"]).map((event) => ({
+        id: asNumber(event["id"]),
+        usageSummaryId: asNullableNumber(event["usage_summary_id"]),
+        feature: asString(event["feature"]),
+        country: asNullableString(event["country"]),
+        regime: asNullableString(event["regime"]),
+        billingPeriod: asString(event["billing_period"]),
+        resourceType: asNullableString(event["resource_type"]),
+        resourceId: asNullableNumber(event["resource_id"]),
+        stripeUsageRecordId: asNullableString(event["stripe_usage_record_id"]),
+        stripeReportedAt: asNullableString(event["stripe_reported_at"]),
+        createdAt: asNullableString(event["created_at"])
+      })),
+      asNullableString(data["created_at"]),
+      asNullableString(data["updated_at"])
+    );
+  }
+};
+var UsageSummaryPage = class _UsageSummaryPage {
+  constructor(rows, currentPage, perPage, total, lastPage) {
+    this.rows = rows;
+    this.currentPage = currentPage;
+    this.perPage = perPage;
+    this.total = total;
+    this.lastPage = lastPage;
+  }
+  rows;
+  currentPage;
+  perPage;
+  total;
+  lastPage;
+  static fromResponse(payload) {
+    const obj = asRecord(payload) ?? {};
+    const rows = asRecordList(obj["data"]).map(UsageSummary.fromArray);
+    const meta = asRecord(obj["meta"]) ?? {};
+    const num = (value, fallback) => typeof value === "number" ? value : fallback;
+    return new _UsageSummaryPage(
+      rows,
+      num(meta["current_page"], 1),
+      num(meta["per_page"], rows.length),
+      num(meta["total"], rows.length),
+      num(meta["last_page"], 1)
+    );
+  }
+  [Symbol.iterator]() {
+    return this.rows[Symbol.iterator]();
+  }
+  get length() {
+    return this.rows.length;
+  }
+};
+
+// src/endpoints/BillingEndpoint.ts
+var PERIOD_REGEX = /^\d{4}-(0[1-9]|1[0-2])$/;
+var BillingEndpoint = class {
+  constructor(baseUrl, apiKey, tokenStorage, httpClient, retryPolicy = new RetryPolicy()) {
+    this.baseUrl = baseUrl;
+    this.apiKey = apiKey;
+    this.tokenStorage = tokenStorage;
+    this.httpClient = httpClient;
+    this.retryPolicy = retryPolicy;
+  }
+  baseUrl;
+  apiKey;
+  tokenStorage;
+  httpClient;
+  retryPolicy;
+  /** Paginated usage summaries, newest billing period first. `perPage` is clamped to 1-100 server-side. */
+  async listUsageSummaries(page = 1, perPage = 25) {
+    const params = new URLSearchParams();
+    params.set("page", String(page));
+    params.set("per_page", String(perPage));
+    const data = await this.getJson(`${this.baseUrl}/billing/usage-summaries?${params.toString()}`);
+    return UsageSummaryPage.fromResponse(data);
+  }
+  /**
+   * The usage summaries of one billing period (YYYY-MM), one per feature,
+   * each with its usage events. A period without usage yields a 404 (HttpException).
+   */
+  async getUsageSummaries(period) {
+    if (!PERIOD_REGEX.test(period)) {
+      throw new TaxoraException(`Invalid billing period "${period}". Expected YYYY-MM, e.g. "2026-09".`);
+    }
+    const data = await this.getJson(`${this.baseUrl}/billing/usage-summaries/${period}`);
+    return Array.isArray(data) ? data.filter((row) => typeof row === "object" && row !== null).map(UsageSummary.fromArray) : [];
+  }
+  buildHeaders() {
+    const headers = {
+      "Content-Type": "application/json",
+      "x-api-key": this.apiKey
+    };
+    const token = this.tokenStorage.get();
+    if (token) {
+      headers["Authorization"] = `Bearer ${token.accessToken}`;
+    }
+    return headers;
+  }
+  /** GET + envelope unwrap (`{success, data}` → data, which may be an object or an array). */
+  async getJson(url) {
+    return withRetries(this.retryPolicy, "billing request", async () => {
+      const response = await this.httpClient.request("GET", url, { headers: this.buildHeaders() });
+      const responseText = await response.text();
+      if (!response.ok) {
+        throw new HttpException(
+          describeApiError(responseText, response.status),
+          response.status,
+          responseText,
+          {},
+          response.headers.get("retry-after")
+        );
+      }
+      let parsed;
+      try {
+        parsed = JSON.parse(responseText);
+      } catch {
+        throw new HttpException("Invalid JSON response", response.status, responseText);
+      }
+      if (typeof parsed !== "object" || parsed === null) {
+        throw new HttpException("Unexpected response format", response.status, responseText);
+      }
+      const obj = parsed;
+      return obj["data"] !== void 0 && obj["data"] !== null ? obj["data"] : obj;
+    });
+  }
+};
+
 // src/dto/CompanyResource.ts
 function normalizeCompanyResource(data) {
   const apiRateLimit = typeof data["api_rate_limit"] === "number" ? data["api_rate_limit"] : void 0;
@@ -566,13 +773,13 @@ function describeComplianceService(service) {
 }
 
 // src/dto/ComplianceEnrollment.ts
-function asString(value, fallback = "") {
+function asString2(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString(value) {
+function asNullableString2(value) {
   return typeof value === "string" ? value : null;
 }
-function asNumber(value) {
+function asNumber2(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
 var ComplianceEnrollment = class _ComplianceEnrollment {
@@ -619,29 +826,114 @@ var ComplianceEnrollment = class _ComplianceEnrollment {
   static fromArray(data) {
     const regimeConfig = typeof data["regime_config"] === "object" && data["regime_config"] !== null && !Array.isArray(data["regime_config"]) ? data["regime_config"] : null;
     return new _ComplianceEnrollment(
-      asNumber(data["id"]),
-      asNumber(data["company_id"]),
-      asString(data["country"]),
-      asString(data["regime"]),
-      asString(data["provider"]),
+      asNumber2(data["id"]),
+      asNumber2(data["company_id"]),
+      asString2(data["country"]),
+      asString2(data["regime"]),
+      asString2(data["provider"]),
       toComplianceEnrollmentStatus(data["status"]),
-      asString(data["status_label"]),
-      asNullableString(data["status_error"]),
-      asNullableString(data["provider_account_id"]),
-      asNullableString(data["tax_id"]),
-      asNullableString(data["company_register_id"]),
-      asNullableString(data["company_register_scheme"]),
+      asString2(data["status_label"]),
+      asNullableString2(data["status_error"]),
+      asNullableString2(data["provider_account_id"]),
+      asNullableString2(data["tax_id"]),
+      asNullableString2(data["company_register_id"]),
+      asNullableString2(data["company_register_scheme"]),
       regimeConfig,
-      asNullableString(data["reporting_start_date"]),
-      asNullableString(data["notification_email"]),
+      asNullableString2(data["reporting_start_date"]),
+      asNullableString2(data["notification_email"]),
       data["auto_send"] === true,
-      asNullableString(data["created_at"]),
-      asNullableString(data["updated_at"]),
+      asNullableString2(data["created_at"]),
+      asNullableString2(data["updated_at"]),
       toComplianceService(data["service"])
     );
   }
 };
 
+// src/dto/ComplianceOfferings.ts
+function asRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function asRecordList2(value) {
+  return Array.isArray(value) ? value.filter((row) => asRecord2(row) !== null) : [];
+}
+function asString3(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNullableString3(value) {
+  return typeof value === "string" ? value : null;
+}
+function asNullableNumber2(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) return Number(value);
+  return null;
+}
+function asStringList(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function toRequires(value) {
+  const record = asRecord2(value);
+  return record === null ? null : { country: asString3(record["country"]), service: asString3(record["service"]) };
+}
+var ComplianceOfferings = class _ComplianceOfferings {
+  constructor(offerings, coverage, access, accessByCountry) {
+    this.offerings = offerings;
+    this.coverage = coverage;
+    this.access = access;
+    this.accessByCountry = accessByCountry;
+  }
+  offerings;
+  coverage;
+  access;
+  accessByCountry;
+  static fromArray(data) {
+    const offerings = asRecordList2(data["data"]).map((row) => ({
+      country: asString3(row["country"]),
+      service: asString3(row["service"]),
+      currency: asString3(row["currency"], "EUR"),
+      active: row["active"] === true,
+      viaStripe: row["via_stripe"] === true,
+      plan: asNullableString3(row["plan"]),
+      status: asNullableString3(row["status"]),
+      enrolled: row["enrolled"] === true,
+      plans: asRecordList2(row["plans"]).map((plan) => ({
+        key: asString3(plan["key"]),
+        monthlyFee: asNullableNumber2(plan["monthly_fee"]),
+        setupFee: asNullableNumber2(plan["setup_fee"]),
+        usageTiers: Array.isArray(plan["usage_tiers"]) ? plan["usage_tiers"] : [],
+        volumeLimit: plan["volume_limit"] ?? null,
+        contactOnly: plan["contact_only"] === true,
+        checkoutAvailable: plan["checkout_available"] === true,
+        requires: toRequires(plan["requires"]),
+        eligible: plan["eligible"] === true
+      }))
+    }));
+    const coverage = asRecordList2(data["coverage"]).map((row) => ({
+      country: asString3(row["country"]),
+      availability: asString3(row["availability"]),
+      services: asStringList(row["services"]),
+      network: asNullableString3(row["network"]),
+      format: asNullableString3(row["format"]),
+      mandate: asNullableString3(row["mandate"]),
+      support: asString3(row["support"], "yes")
+    }));
+    const access = asRecord2(data["access"]) ?? {};
+    const accessByCountry = {};
+    for (const [country, services] of Object.entries(asRecord2(data["access_by_country"]) ?? {})) {
+      const flags = {};
+      for (const [service, value] of Object.entries(asRecord2(services) ?? {})) {
+        flags[service] = value === true;
+      }
+      accessByCountry[country] = flags;
+    }
+    return new _ComplianceOfferings(
+      offerings,
+      coverage,
+      { eReporting: access["e_reporting"] === true, eInvoicing: access["e_invoicing"] === true },
+      accessByCountry
+    );
+  }
+};
+
 // src/dto/ComplianceEnrollmentPage.ts
 var ComplianceEnrollmentPage = class _ComplianceEnrollmentPage {
   constructor(rows, currentPage, perPage, total, lastPage) {
@@ -711,16 +1003,16 @@ function describeComplianceTaxReportState(state) {
 }
 
 // src/dto/ComplianceTaxReport.ts
-function asString2(value, fallback = "") {
+function asString4(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString2(value) {
+function asNullableString4(value) {
   return typeof value === "string" ? value : null;
 }
-function asNumber2(value) {
+function asNumber3(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
-function asNullableNumber(value) {
+function asNullableNumber3(value) {
   return typeof value === "number" ? value : null;
 }
 function asMoney(value) {
@@ -771,25 +1063,25 @@ var ComplianceTaxReport = class _ComplianceTaxReport {
   updatedAt;
   static fromArray(data) {
     return new _ComplianceTaxReport(
-      asNumber2(data["id"]),
-      asNumber2(data["company_id"]),
-      asNullableNumber(data["compliance_transaction_id"]),
-      asNullableNumber(data["ledger_id"]),
-      asString2(data["country"]),
-      asString2(data["regime"]),
+      asNumber3(data["id"]),
+      asNumber3(data["company_id"]),
+      asNullableNumber3(data["compliance_transaction_id"]),
+      asNullableNumber3(data["ledger_id"]),
+      asString4(data["country"]),
+      asString4(data["regime"]),
       toComplianceTaxReportState(data["state"]),
-      asString2(data["state_label"]),
+      asString4(data["state_label"]),
       data["is_terminal"] === true,
-      asNullableString2(data["provider_tax_report_id"]),
-      asNullableString2(data["provider_ledger_id"]),
+      asNullableString4(data["provider_tax_report_id"]),
+      asNullableString4(data["provider_ledger_id"]),
       asMoney(data["base_amount"]),
       asMoney(data["tax_amount"]),
       asMoney(data["total_amount"]),
-      asNullableString2(data["refusal_reason"]),
-      asNullableString2(data["registered_at"]),
-      asNullableString2(data["refused_at"]),
-      asNullableString2(data["created_at"]),
-      asNullableString2(data["updated_at"])
+      asNullableString4(data["refusal_reason"]),
+      asNullableString4(data["registered_at"]),
+      asNullableString4(data["refused_at"]),
+      asNullableString4(data["created_at"]),
+      asNullableString4(data["updated_at"])
     );
   }
 };
@@ -860,6 +1152,8 @@ var ComplianceTransactionState = {
   SENDING: "sending",
   SUBMITTED: "submitted",
   ERROR: "error",
+  /** E-invoicing only: the buyer cannot receive e-invoices — nothing was sent or billed; send your regular invoice. */
+  NOT_REQUIRED: "not_required",
   UNKNOWN: "unknown"
 };
 var VALUES5 = Object.values(ComplianceTransactionState);
@@ -877,6 +1171,7 @@ var DESCRIPTIONS5 = {
   [ComplianceTransactionState.SENDING]: "Submission to the provider in progress.",
   [ComplianceTransactionState.SUBMITTED]: "Successfully submitted to the provider.",
   [ComplianceTransactionState.ERROR]: "Submission failed. See submissionError.",
+  [ComplianceTransactionState.NOT_REQUIRED]: "The buyer cannot receive e-invoices, so none was sent or billed. Send your regular invoice instead.",
   [ComplianceTransactionState.UNKNOWN]: "Unknown state."
 };
 function describeComplianceTransactionState(state) {
@@ -915,13 +1210,13 @@ function describeComplianceTransactionType(type) {
 }
 
 // src/dto/ComplianceTransaction.ts
-function asString3(value, fallback = "") {
+function asString5(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString3(value) {
+function asNullableString5(value) {
   return typeof value === "string" ? value : null;
 }
-function asNumber3(value) {
+function asNumber4(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
 function asMoney2(value) {
@@ -929,34 +1224,55 @@ function asMoney2(value) {
   if (typeof value === "number" && Number.isFinite(value)) return String(value);
   return "0.00";
 }
-function asNullableNumber2(value) {
+function asNullableNumber4(value) {
   if (typeof value === "number" && Number.isFinite(value)) return value;
   if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) return Number(value);
   return null;
 }
-function asRecord(value) {
+function asRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
 }
-function asRecordList(value) {
-  return Array.isArray(value) ? value.filter((row) => asRecord(row) !== null) : [];
+function asRecordList3(value) {
+  return Array.isArray(value) ? value.filter((row) => asRecord3(row) !== null) : [];
+}
+function toInvoicePdf(value) {
+  const pdf = asRecord3(value);
+  if (pdf === null) return null;
+  return {
+    filename: asNullableString5(pdf["filename"]),
+    size: asNullableNumber4(pdf["size"]),
+    attached: pdf["attached"] === true
+  };
+}
+function toEurEquivalent(value) {
+  const eur = asRecord3(value);
+  if (eur === null) return null;
+  return {
+    subtotal: asMoney2(eur["subtotal"]),
+    taxAmount: asMoney2(eur["tax_amount"]),
+    total: asMoney2(eur["total"]),
+    rate: asString5(eur["rate"]),
+    rateDate: asNullableString5(eur["rate_date"]),
+    source: asString5(eur["source"], "ECB")
+  };
 }
 function toInvoiceLines(providerPayload) {
-  const invoice = asRecord(asRecord(providerPayload)?.["invoice"]);
-  return asRecordList(invoice?.["invoice_lines_attributes"]).map((line) => ({
-    description: asString3(line["description"]),
-    quantity: asNullableNumber2(line["quantity"]),
+  const invoice = asRecord3(asRecord3(providerPayload)?.["invoice"]);
+  return asRecordList3(invoice?.["invoice_lines_attributes"]).map((line) => ({
+    description: asString5(line["description"]),
+    quantity: asNullableNumber4(line["quantity"]),
     price: asMoney2(line["price"]),
-    unit: asNullableNumber2(line["unit"]),
-    taxes: asRecordList(line["taxes_attributes"]).map((tax) => ({
-      name: asString3(tax["name"]),
-      percent: asNullableNumber2(tax["percent"]),
-      category: asNullableString3(tax["category"]),
-      comment: asNullableString3(tax["comment"])
+    unit: asNullableNumber4(line["unit"]),
+    taxes: asRecordList3(line["taxes_attributes"]).map((tax) => ({
+      name: asString5(tax["name"]),
+      percent: asNullableNumber4(tax["percent"]),
+      category: asNullableString5(tax["category"]),
+      comment: asNullableString5(tax["comment"])
     }))
   }));
 }
 var ComplianceTransaction = class _ComplianceTransaction {
-  constructor(id, companyId, complianceEnrollmentId, country, regime, transactionType, transactionTypeLabel, state, stateLabel, invoiceNumber, invoiceDate, dueDate, currency, subtotal, taxAmount, total, counterpartyName, counterpartyCountry, counterpartyVatNumber, isPaid, paidAt, providerInvoiceId, submissionError, reportedAt, taxReport, createdAt, updatedAt, counterpartyRegisterId = null, counterpartyAddress = null, counterpartyCity = null, counterpartyPostalcode = null, counterpartyEmail = null, buyerReference = null, documentType = ComplianceDocumentType.INVOICE, amendedNumber = null, amendedDate = null, providerState = null, invoiceLines = []) {
+  constructor(id, companyId, complianceEnrollmentId, country, regime, transactionType, transactionTypeLabel, state, stateLabel, invoiceNumber, invoiceDate, dueDate, currency, subtotal, taxAmount, total, counterpartyName, counterpartyCountry, counterpartyVatNumber, isPaid, paidAt, providerInvoiceId, submissionError, reportedAt, taxReport, createdAt, updatedAt, counterpartyRegisterId = null, counterpartyAddress = null, counterpartyCity = null, counterpartyPostalcode = null, counterpartyEmail = null, buyerReference = null, documentType = ComplianceDocumentType.INVOICE, amendedNumber = null, amendedDate = null, providerState = null, invoiceLines = [], documentUrl = null, deliveryCheck = null, invoicePdf = null, internalReference = null, pdfUrl = null, buyerRejected = false, rejectionReason = null, eurEquivalent = null) {
     this.id = id;
     this.companyId = companyId;
     this.complianceEnrollmentId = complianceEnrollmentId;
@@ -995,6 +1311,14 @@ var ComplianceTransaction = class _ComplianceTransaction {
     this.amendedDate = amendedDate;
     this.providerState = providerState;
     this.invoiceLines = invoiceLines;
+    this.documentUrl = documentUrl;
+    this.deliveryCheck = deliveryCheck;
+    this.invoicePdf = invoicePdf;
+    this.internalReference = internalReference;
+    this.pdfUrl = pdfUrl;
+    this.buyerRejected = buyerRejected;
+    this.rejectionReason = rejectionReason;
+    this.eurEquivalent = eurEquivalent;
   }
   id;
   companyId;
@@ -1034,50 +1358,66 @@ var ComplianceTransaction = class _ComplianceTransaction {
   amendedDate;
   providerState;
   invoiceLines;
+  documentUrl;
+  deliveryCheck;
+  invoicePdf;
+  internalReference;
+  pdfUrl;
+  buyerRejected;
+  rejectionReason;
+  eurEquivalent;
   get isCreditNote() {
     return this.documentType === ComplianceDocumentType.CREDIT_NOTE;
   }
   static fromArray(data) {
     const taxReport = typeof data["tax_report"] === "object" && data["tax_report"] !== null && !Array.isArray(data["tax_report"]) ? ComplianceTaxReport.fromArray(data["tax_report"]) : void 0;
     return new _ComplianceTransaction(
-      asNumber3(data["id"]),
-      asNumber3(data["company_id"]),
-      asNumber3(data["compliance_enrollment_id"]),
-      asString3(data["country"]),
-      asString3(data["regime"]),
+      asNumber4(data["id"]),
+      asNumber4(data["company_id"]),
+      asNumber4(data["compliance_enrollment_id"]),
+      asString5(data["country"]),
+      asString5(data["regime"]),
       toComplianceTransactionType(data["transaction_type"]),
-      asString3(data["transaction_type_label"]),
+      asString5(data["transaction_type_label"]),
       toComplianceTransactionState(data["state"]),
-      asString3(data["state_label"]),
-      asString3(data["invoice_number"]),
-      asNullableString3(data["invoice_date"]),
-      asNullableString3(data["due_date"]),
-      asString3(data["currency"], "EUR"),
+      asString5(data["state_label"]),
+      asString5(data["invoice_number"]),
+      asNullableString5(data["invoice_date"]),
+      asNullableString5(data["due_date"]),
+      asString5(data["currency"], "EUR"),
       asMoney2(data["subtotal"]),
       asMoney2(data["tax_amount"]),
       asMoney2(data["total"]),
-      asNullableString3(data["counterparty_name"]),
-      asNullableString3(data["counterparty_country"]),
-      asNullableString3(data["counterparty_vat_number"]),
+      asNullableString5(data["counterparty_name"]),
+      asNullableString5(data["counterparty_country"]),
+      asNullableString5(data["counterparty_vat_number"]),
       data["is_paid"] === true,
-      asNullableString3(data["paid_at"]),
-      asNullableString3(data["provider_invoice_id"]),
-      asNullableString3(data["submission_error"]),
-      asNullableString3(data["reported_at"]),
+      asNullableString5(data["paid_at"]),
+      asNullableString5(data["provider_invoice_id"]),
+      asNullableString5(data["submission_error"]),
+      asNullableString5(data["reported_at"]),
       taxReport,
-      asNullableString3(data["created_at"]),
-      asNullableString3(data["updated_at"]),
-      asNullableString3(data["counterparty_register_id"]),
-      asNullableString3(data["counterparty_address"]),
-      asNullableString3(data["counterparty_city"]),
-      asNullableString3(data["counterparty_postalcode"]),
-      asNullableString3(data["counterparty_email"]),
-      asNullableString3(data["buyer_reference"]),
+      asNullableString5(data["created_at"]),
+      asNullableString5(data["updated_at"]),
+      asNullableString5(data["counterparty_register_id"]),
+      asNullableString5(data["counterparty_address"]),
+      asNullableString5(data["counterparty_city"]),
+      asNullableString5(data["counterparty_postalcode"]),
+      asNullableString5(data["counterparty_email"]),
+      asNullableString5(data["buyer_reference"]),
       data["document_type"] === void 0 || data["document_type"] === null ? ComplianceDocumentType.INVOICE : toComplianceDocumentType(data["document_type"]),
-      asNullableString3(data["amended_number"]),
-      asNullableString3(data["amended_date"]),
-      asNullableString3(data["provider_state"]),
-      toInvoiceLines(data["provider_payload"])
+      asNullableString5(data["amended_number"]),
+      asNullableString5(data["amended_date"]),
+      asNullableString5(data["provider_state"]),
+      toInvoiceLines(data["provider_payload"]),
+      asNullableString5(data["document_url"]),
+      asRecord3(data["delivery_check"]),
+      toInvoicePdf(data["invoice_pdf"]),
+      asNullableString5(data["internal_reference"]),
+      asNullableString5(data["pdf_url"]),
+      data["buyer_rejected"] === true,
+      asNullableString5(data["rejection_reason"]),
+      toEurEquivalent(data["eur_equivalent"])
     );
   }
 };
@@ -1164,10 +1504,10 @@ function describePeppolLookupStatus(status) {
 }
 
 // src/dto/PeppolLookupResult.ts
-function asString4(value, fallback = "") {
+function asString6(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString4(value) {
+function asNullableString6(value) {
   return typeof value === "string" ? value : null;
 }
 var PeppolLookupResult = class _PeppolLookupResult {
@@ -1198,21 +1538,21 @@ var PeppolLookupResult = class _PeppolLookupResult {
     return new _PeppolLookupResult(
       toPeppolLookupStatus(data["status"]),
       typeof data["reachable"] === "boolean" ? data["reachable"] : null,
-      asString4(data["country"]),
-      asString4(data["scheme"]),
-      asString4(data["id"]),
+      asString6(data["country"]),
+      asString6(data["scheme"]),
+      asString6(data["id"]),
       documentTypes,
-      asNullableString4(data["transport_type_code"]),
-      asNullableString4(data["checked_at"])
+      asNullableString6(data["transport_type_code"]),
+      asNullableString6(data["checked_at"])
     );
   }
 };
 
 // src/dto/RegistryCompany.ts
-function asString5(value, fallback = "") {
+function asString7(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString5(value) {
+function asNullableString7(value) {
   return typeof value === "string" ? value : null;
 }
 var RegistryCompany = class _RegistryCompany {
@@ -1244,27 +1584,27 @@ var RegistryCompany = class _RegistryCompany {
   country;
   static fromArray(data) {
     return new _RegistryCompany(
-      asString5(data["org_number"]),
-      asString5(data["company_name"]),
-      asNullableString5(data["organisation_form"]),
+      asString7(data["org_number"]),
+      asString7(data["company_name"]),
+      asNullableString7(data["organisation_form"]),
       data["vat_registered"] === true,
-      asNullableString5(data["vat_number"]),
+      asNullableString7(data["vat_number"]),
       data["enterprise_register"] === true,
       data["bankrupt"] === true,
       data["under_liquidation"] === true,
-      asNullableString5(data["address"]),
-      asNullableString5(data["postalcode"]),
-      asNullableString5(data["city"]),
-      asString5(data["country"])
+      asNullableString7(data["address"]),
+      asNullableString7(data["postalcode"]),
+      asNullableString7(data["city"]),
+      asString7(data["country"])
     );
   }
 };
 
 // src/dto/RevenueStatistics.ts
-function asString6(value, fallback = "") {
+function asString8(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNumber4(value) {
+function asNumber5(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
 function asMoney3(value) {
@@ -1276,7 +1616,7 @@ function asRecords(value) {
 }
 function toTotals(data) {
   return {
-    count: asNumber4(data["count"]),
+    count: asNumber5(data["count"]),
     subtotal: asMoney3(data["subtotal"]),
     taxAmount: asMoney3(data["tax_amount"]),
     total: asMoney3(data["total"])
@@ -1313,35 +1653,35 @@ var RevenueStatistics = class _RevenueStatistics {
       typeof data["totals"] === "object" && data["totals"] !== null ? data["totals"] : {}
     );
     const timeSeries = asRecords(data["time_series"]).map((row) => ({
-      bucket: asString6(row["bucket"]),
+      bucket: asString8(row["bucket"]),
       ...toTotals(row)
     }));
     const byType = asRecords(data["by_type"]).map((row) => ({
-      type: asString6(row["type"]),
-      typeLabel: asString6(row["type_label"]),
-      count: asNumber4(row["count"]),
+      type: asString8(row["type"]),
+      typeLabel: asString8(row["type_label"]),
+      count: asNumber5(row["count"]),
       total: asMoney3(row["total"])
     }));
     const byCountry = asRecords(data["by_country"]).map((row) => ({
-      country: asString6(row["country"], "unknown"),
-      count: asNumber4(row["count"]),
+      country: asString8(row["country"], "unknown"),
+      count: asNumber5(row["count"]),
       total: asMoney3(row["total"])
     }));
     const byState = asRecords(data["by_state"]).map((row) => ({
-      state: asString6(row["state"]),
-      stateLabel: asString6(row["state_label"]),
-      count: asNumber4(row["count"]),
+      state: asString8(row["state"]),
+      stateLabel: asString8(row["state_label"]),
+      count: asNumber5(row["count"]),
       total: asMoney3(row["total"])
     }));
     const byCurrency = asRecords(data["by_currency"]).map((row) => ({
-      currency: asString6(row["currency"]),
+      currency: asString8(row["currency"]),
       ...toTotals(row)
     }));
     return new _RevenueStatistics(
-      asString6(range["date_from"]) || void 0,
-      asString6(range["date_to"]) || void 0,
-      asString6(range["interval"]) || void 0,
-      asString6(data["primary_currency"], "EUR"),
+      asString8(range["date_from"]) || void 0,
+      asString8(range["date_to"]) || void 0,
+      asString8(range["interval"]) || void 0,
+      asString8(data["primary_currency"], "EUR"),
       data["is_multi_currency"] === true,
       totals,
       timeSeries,
@@ -1354,10 +1694,10 @@ var RevenueStatistics = class _RevenueStatistics {
 };
 
 // src/dto/SireneLookupResult.ts
-function asString7(value, fallback = "") {
+function asString9(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNullableString6(value) {
+function asNullableString8(value) {
   return typeof value === "string" ? value : null;
 }
 var SireneLookupResult = class _SireneLookupResult {
@@ -1383,24 +1723,24 @@ var SireneLookupResult = class _SireneLookupResult {
   postalcode;
   static fromArray(data) {
     return new _SireneLookupResult(
-      asString7(data["company_name"]),
-      asString7(data["siren"]),
-      asNullableString6(data["siret"]),
-      asNullableString6(data["naf_code"]),
-      asNullableString6(data["naf_full"]),
-      asNullableString6(data["enterprise_size"]),
-      asNullableString6(data["address"]),
-      asNullableString6(data["city"]),
-      asNullableString6(data["postalcode"])
+      asString9(data["company_name"]),
+      asString9(data["siren"]),
+      asNullableString8(data["siret"]),
+      asNullableString8(data["naf_code"]),
+      asNullableString8(data["naf_full"]),
+      asNullableString8(data["enterprise_size"]),
+      asNullableString8(data["address"]),
+      asNullableString8(data["city"]),
+      asNullableString8(data["postalcode"])
     );
   }
 };
 
 // src/dto/VatRates.ts
-function asString8(value, fallback = "") {
+function asString10(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNumber5(value) {
+function asNumber6(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
 var VatRates = class _VatRates {
@@ -1414,13 +1754,13 @@ var VatRates = class _VatRates {
   rates;
   static fromArray(data) {
     const rates = (Array.isArray(data["rates"]) ? data["rates"] : []).filter((row) => typeof row === "object" && row !== null).map((row) => ({
-      percent: asNumber5(row["percent"]),
-      category: asString8(row["category"]),
-      labelKey: asString8(row["label_key"]),
-      taxName: asString8(row["tax_name"]),
+      percent: asNumber6(row["percent"]),
+      category: asString10(row["category"]),
+      labelKey: asString10(row["label_key"]),
+      taxName: asString10(row["tax_name"]),
       requiresVatex: row["requires_vatex"] === true
     }));
-    return new _VatRates(asString8(data["country"]), asString8(data["currency"], "EUR"), rates);
+    return new _VatRates(asString10(data["country"]), asString10(data["currency"], "EUR"), rates);
   }
 };
 
@@ -1479,10 +1819,15 @@ var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
 var NAF_CODE_REGEX = /^\d{2}$/;
 var COUNTRY_REGEX = /^[A-Za-z]{2}$/;
 var PEPPOL_SCHEME_REGEX = /^\d{4}$/;
+var INVOICE_PDF_MAX_BYTES = 10 * 1024 * 1024;
+var INVOICE_PDF_MAGIC = [37, 80, 68, 70, 45];
 var INTERVALS = ["day", "week", "month"];
 var SERVICES = ["e_reporting", "e_invoicing"];
 var ENTERPRISE_SIZES = ["micro", "pme", "eti", "ge"];
 var TYPE_OPERATIONS = ["services", "goods", "mixed"];
+var NOTIFICATION_LANGUAGES = ["de", "en"];
+var NOTIFICATION_DIGESTS = ["off", "daily", "weekly"];
+var NOTIFICATION_MAX_RECIPIENTS = 5;
 var TRANSACTION_TYPES = [
   "b2c_outbound",
   "b2b_domestic_outbound",
@@ -1677,6 +2022,8 @@ var EReportingEndpoint = class {
     this.validateInvoiceLines(input.invoiceLines);
     this.validateOptionalCodes(input);
     this.validateBuyerFields(input);
+    this.validateInternalReference(input.internalReference);
+    this.validateInvoicePdfFilename(input);
     const body = {
       compliance_enrollment_id: input.complianceEnrollmentId,
       transaction_type: input.transactionType,
@@ -1692,23 +2039,9 @@ var EReportingEndpoint = class {
     const data = await this.parseJsonResponse(response);
     return ComplianceTransaction.fromArray(data);
   }
-  /** Paginated list of the company's transactions (newest invoice date first), filterable by date / state / type / enrollment / country. */
+  /** Paginated list of the company's transactions (newest invoice date first), filterable by date / state / type / enrollment / country / search / internal reference / provider state. */
   async listTransactions(filters = {}) {
-    if (filters.complianceEnrollmentId !== void 0) {
-      this.validateId(filters.complianceEnrollmentId, "complianceEnrollmentId");
-    }
-    if (filters.country !== void 0 && !COUNTRY_REGEX.test(filters.country)) {
-      throw new TaxoraException("country must be a 2-character ISO 3166-1 alpha-2 code.");
-    }
-    const params = new URLSearchParams();
-    if (filters.dateFrom !== void 0) params.set("date_from", this.formatDate(filters.dateFrom));
-    if (filters.dateTo !== void 0) params.set("date_to", this.formatDate(filters.dateTo));
-    if (filters.state !== void 0) params.set("state", filters.state);
-    if (filters.transactionType !== void 0) params.set("transaction_type", filters.transactionType);
-    if (filters.complianceEnrollmentId !== void 0) {
-      params.set("compliance_enrollment_id", String(filters.complianceEnrollmentId));
-    }
-    if (filters.country !== void 0) params.set("country", filters.country.toUpperCase());
+    const params = this.buildTransactionFilterParams(filters);
     if (filters.page !== void 0) params.set("page", String(filters.page));
     if (filters.perPage !== void 0) params.set("per_page", String(filters.perPage));
     const queryString = params.toString();
@@ -1716,6 +2049,27 @@ var EReportingEndpoint = class {
     const response = await this.sendRequest("GET", url);
     return ComplianceTransactionPage.fromResponse(await this.parseJsonResponse(response));
   }
+  /**
+   * All transactions matching the filters as raw CSV for bookkeeping
+   * (semicolon-separated) — the same filters as listTransactions() without
+   * pagination. Columns: invoice_number, internal_reference, invoice_date,
+   * due_date, country, transaction_type, document_type, state, delivery_state,
+   * buyer_rejected, rejection_reason, counterparty_name, counterparty_country,
+   * counterparty_vat_number, currency, subtotal, tax_amount, total, eur_rate,
+   * eur_rate_date, eur_subtotal, eur_tax_amount, eur_total, provider_invoice_id,
+   * created_at. The eur_* columns hold the ECB reference conversion for non-EUR
+   * invoices (empty for EUR). Max 50,000 rows server-side. The body is returned
+   * verbatim, a UTF-8 BOM included when the API sends one.
+   */
+  async exportTransactionsCsv(filters = {}) {
+    const queryString = this.buildTransactionFilterParams(filters).toString();
+    const url = `${this.baseUrl}/compliance/transactions/export.csv${queryString ? `?${queryString}` : ""}`;
+    const response = await this.sendDownloadRequest(url, "text/csv, application/json");
+    if (!response.ok) {
+      await this.parseJsonResponse(response);
+    }
+    return new TextDecoder("utf-8", { ignoreBOM: true }).decode(await response.arrayBuffer());
+  }
   /** Get a single transaction by id (includes its tax report when one exists). */
   async getTransaction(id) {
     this.validateId(id, "id");
@@ -1731,6 +2085,8 @@ var EReportingEndpoint = class {
     if (input.invoiceLines !== void 0) this.validateInvoiceLines(input.invoiceLines);
     this.validateOptionalCodes(input);
     this.validateBuyerFields(input);
+    this.validateInternalReference(input.internalReference);
+    this.validateInvoicePdfFilename(input);
     const body = {};
     if (input.transactionType !== void 0) body["transaction_type"] = input.transactionType;
     if (input.invoiceNumber !== void 0) body["invoice_number"] = input.invoiceNumber;
@@ -1765,6 +2121,47 @@ var EReportingEndpoint = class {
     const data = await this.parseJsonResponse(response);
     return ComplianceTransaction.fromArray(data);
   }
+  /**
+   * Download the legal e-invoice document of a sent transaction (e-invoicing,
+   * e.g. the EHF/UBL XML for Norway). Available once `documentUrl` on the
+   * transaction is set.
+   *
+   * Errors: 404 (HttpException) for an unknown transaction; 409 (HttpException)
+   * when no document exists (yet) — e.g. e-reporting, not sent, or the network
+   * has not produced it yet (try again in a few minutes); 502 on provider failure.
+   */
+  async getTransactionDocument(id) {
+    this.validateId(id, "id");
+    const response = await this.sendDownloadRequest(`${this.baseUrl}/compliance/transactions/${id}/document`, "*/*");
+    if (!response.ok) {
+      await this.parseJsonResponse(response);
+    }
+    return {
+      content: new Uint8Array(await response.arrayBuffer()),
+      contentType: response.headers.get("content-type") ?? "application/octet-stream",
+      filename: this.filenameFromDisposition(response.headers.get("content-disposition"))
+    };
+  }
+  /**
+   * Download the invoice as a readable PDF — the seller's attached PDF, or the
+   * provider's rendering of the e-invoice. Available once `pdfUrl` on the
+   * transaction is set.
+   *
+   * Errors: 404 (HttpException) for an unknown transaction; 409 (HttpException)
+   * when no PDF exists (yet); 502 on provider failure.
+   */
+  async getTransactionPdf(id) {
+    this.validateId(id, "id");
+    const response = await this.sendDownloadRequest(`${this.baseUrl}/compliance/transactions/${id}/pdf`, "*/*");
+    if (!response.ok) {
+      await this.parseJsonResponse(response);
+    }
+    return {
+      content: new Uint8Array(await response.arrayBuffer()),
+      contentType: response.headers.get("content-type") ?? "application/octet-stream",
+      filename: this.filenameFromDisposition(response.headers.get("content-disposition"))
+    };
+  }
   /**
    * Bulk-import transactions from a semicolon-separated CSV (one row per invoice
    * line; rows sharing an invoice_number are grouped into one transaction).
@@ -1796,6 +2193,9 @@ var EReportingEndpoint = class {
    * months and a monthly interval.
    */
   async getRevenueStatistics(filters = {}) {
+    if (filters.complianceEnrollmentId !== void 0) {
+      this.validateId(filters.complianceEnrollmentId, "complianceEnrollmentId");
+    }
     if (filters.interval !== void 0 && !INTERVALS.includes(filters.interval)) {
       throw new TaxoraException(
         `Invalid statistics interval "${String(filters.interval)}". Expected one of: ${INTERVALS.join(", ")}.`
@@ -1807,12 +2207,42 @@ var EReportingEndpoint = class {
     if (filters.interval !== void 0) params.set("interval", filters.interval);
     if (filters.transactionType !== void 0) params.set("transaction_type", filters.transactionType);
     if (filters.state !== void 0) params.set("state", filters.state);
+    if (filters.complianceEnrollmentId !== void 0) {
+      params.set("compliance_enrollment_id", String(filters.complianceEnrollmentId));
+    }
     const queryString = params.toString();
     const url = `${this.baseUrl}/compliance/revenue-statistics${queryString ? `?${queryString}` : ""}`;
     const response = await this.sendRequest("GET", url);
     const data = await this.parseJsonResponse(response);
     return RevenueStatistics.fromArray(data);
   }
+  /**
+   * Net and VAT per month, currency and tax rate as raw CSV (semicolon-separated,
+   * computed from the invoice lines) — for reconciling the reported figures with
+   * your VAT return. Same filters as getRevenueStatistics() (without
+   * `interval`); defaults to the last 12 months. The body is returned verbatim,
+   * a UTF-8 BOM included when the API sends one.
+   */
+  async exportRevenueTaxRatesCsv(filters = {}) {
+    if (filters.complianceEnrollmentId !== void 0) {
+      this.validateId(filters.complianceEnrollmentId, "complianceEnrollmentId");
+    }
+    const params = new URLSearchParams();
+    if (filters.dateFrom !== void 0) params.set("date_from", this.formatDate(filters.dateFrom));
+    if (filters.dateTo !== void 0) params.set("date_to", this.formatDate(filters.dateTo));
+    if (filters.transactionType !== void 0) params.set("transaction_type", filters.transactionType);
+    if (filters.state !== void 0) params.set("state", filters.state);
+    if (filters.complianceEnrollmentId !== void 0) {
+      params.set("compliance_enrollment_id", String(filters.complianceEnrollmentId));
+    }
+    const queryString = params.toString();
+    const url = `${this.baseUrl}/compliance/revenue-statistics/tax-rates.csv${queryString ? `?${queryString}` : ""}`;
+    const response = await this.sendDownloadRequest(url, "text/csv, application/json");
+    if (!response.ok) {
+      await this.parseJsonResponse(response);
+    }
+    return new TextDecoder("utf-8", { ignoreBOM: true }).decode(await response.arrayBuffer());
+  }
   /**
    * The canonical VAT rates & DGFiP tax categories for a reporting country
    * (the seller's reporting-country rates, not the counterparty's). Falls back
@@ -1827,12 +2257,19 @@ var EReportingEndpoint = class {
     const data = await this.parseJsonResponse(response);
     return VatRates.fromArray(data);
   }
-  /** Paginated list of the company's tax reports (newest first), optionally filtered by state. */
-  async listTaxReports(page = 1, perPage = 25, state) {
+  /**
+   * Paginated list of the company's tax reports (newest first), optionally
+   * filtered by state and by country (2-letter ISO code, case-insensitive).
+   */
+  async listTaxReports(page = 1, perPage = 25, state, country) {
+    if (country !== void 0 && !COUNTRY_REGEX.test(country)) {
+      throw new TaxoraException("country must be a 2-character ISO 3166-1 alpha-2 code.");
+    }
     const params = new URLSearchParams();
     params.set("page", String(page));
     params.set("per_page", String(perPage));
     if (state !== void 0) params.set("state", state);
+    if (country !== void 0) params.set("country", country.toUpperCase());
     const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/tax-reports?${params.toString()}`);
     return ComplianceTaxReportPage.fromResponse(await this.parseJsonResponse(response));
   }
@@ -1874,8 +2311,177 @@ var EReportingEndpoint = class {
     await this.parseJsonResponse(response);
   }
   // ---------------------------------------------------------------------
+  // Self-service plans (Stripe) — not gated by compliance access
+  // ---------------------------------------------------------------------
+  /**
+   * Bookable compliance plans per country (net EUR prices), every country
+   * Taxora reaches, and which services the company has unlocked. Works for
+   * companies without compliance access.
+   */
+  async getOfferings() {
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/offerings`);
+    return ComplianceOfferings.fromArray(await this.parseJsonResponse(response));
+  }
+  /**
+   * Start a Stripe Checkout for a plan (see getOfferings() — `checkoutAvailable`).
+   * Open the returned `url` in the browser. After payment Stripe redirects to
+   * the Taxora portal, which activates the plan; call confirmCheckout() with the
+   * session id to activate it from your side (idempotent).
+   *
+   * Errors: 422 (ValidationException) for an unknown or contact-only plan or a
+   * plan that is already active; 502 (HttpException) on a Stripe error.
+   */
+  async createCheckout(country, plan) {
+    if (!COUNTRY_REGEX.test(country)) {
+      throw new TaxoraException("country must be a 2-character ISO 3166-1 alpha-2 code.");
+    }
+    if (plan.trim() === "" || plan.length > 30) {
+      throw new TaxoraException("plan must be a non-empty plan key of at most 30 characters.");
+    }
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/checkout`, {
+      country: country.toUpperCase(),
+      plan
+    });
+    const data = await this.parseJsonResponse(response);
+    return { id: String(data["id"] ?? ""), url: String(data["url"] ?? "") };
+  }
+  /** Confirm a finished Stripe Checkout and activate its plan. Idempotent. */
+  async confirmCheckout(sessionId) {
+    if (sessionId.trim() === "" || sessionId.length > 255) {
+      throw new TaxoraException("sessionId must be a non-empty string of at most 255 characters.");
+    }
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/checkout/confirm`, {
+      session_id: sessionId
+    });
+    const data = await this.parseJsonResponse(response);
+    const str = (value) => typeof value === "string" ? value : null;
+    return {
+      active: data["active"] === true,
+      country: str(data["country"]),
+      service: str(data["service"]),
+      plan: str(data["plan"]),
+      status: str(data["status"])
+    };
+  }
+  /**
+   * URL of the Stripe billing portal for the company's compliance plans
+   * (invoices, payment method, cancellation). The portal returns to the Taxora
+   * portal. 404 (HttpException) when no plan was bought via Stripe.
+   */
+  async createBillingPortalSession() {
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/billing-portal`);
+    const data = await this.parseJsonResponse(response);
+    return String(data["url"] ?? "");
+  }
+  // ---------------------------------------------------------------------
+  // Notification emails
+  // ---------------------------------------------------------------------
+  /**
+   * The company's opt-in e-reporting / e-invoicing emails: recipients, language,
+   * the "buyer not on Peppol" email and the digest. Readable by every member.
+   */
+  async getNotificationSettings() {
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/notification-settings`);
+    return this.toNotificationSettings(await this.parseJsonResponse(response));
+  }
+  /**
+   * Change the company's e-reporting / e-invoicing emails; only the provided
+   * fields change. `notOnPeppol` only reports invoices held back after it was
+   * switched on.
+   *
+   * Errors: 422 (ValidationException) when an email is switched on without any
+   * recipient; 403 (HttpException, body code `admin_only` or `read_only_role`)
+   * for users who are not company admins.
+   */
+  async updateNotificationSettings(input) {
+    const body = {};
+    if (input.recipients !== void 0) {
+      if (!Array.isArray(input.recipients)) {
+        throw new TaxoraException("recipients must be an array of email addresses.");
+      }
+      if (input.recipients.length > NOTIFICATION_MAX_RECIPIENTS) {
+        throw new TaxoraException(`recipients must not contain more than ${NOTIFICATION_MAX_RECIPIENTS} entries.`);
+      }
+      body["recipients"] = input.recipients.map((recipient, index) => {
+        const email = typeof recipient === "string" ? recipient.trim() : recipient;
+        this.validateEmail(email, `recipients[${index}]`);
+        if (email.length > 191) {
+          throw new TaxoraException(`recipients[${index}] must not exceed 191 characters.`);
+        }
+        return email;
+      });
+    }
+    if (input.language !== void 0) {
+      if (!NOTIFICATION_LANGUAGES.includes(input.language)) {
+        throw new TaxoraException(
+          `Invalid language "${String(input.language)}". Expected one of: ${NOTIFICATION_LANGUAGES.join(", ")}.`
+        );
+      }
+      body["language"] = input.language;
+    }
+    if (input.notOnPeppol !== void 0) {
+      if (typeof input.notOnPeppol !== "boolean") {
+        throw new TaxoraException("notOnPeppol must be a boolean.");
+      }
+      body["not_on_peppol"] = input.notOnPeppol;
+    }
+    if (input.digest !== void 0) {
+      if (!NOTIFICATION_DIGESTS.includes(input.digest)) {
+        throw new TaxoraException(
+          `Invalid digest "${String(input.digest)}". Expected one of: ${NOTIFICATION_DIGESTS.join(", ")}.`
+        );
+      }
+      body["digest"] = input.digest;
+    }
+    if (Object.keys(body).length === 0) {
+      throw new TaxoraException("updateNotificationSettings requires at least one field to update.");
+    }
+    const response = await this.sendRequest("PUT", `${this.baseUrl}/compliance/notification-settings`, body);
+    return this.toNotificationSettings(await this.parseJsonResponse(response));
+  }
+  toNotificationSettings(data) {
+    const recipients = Array.isArray(data["recipients"]) ? data["recipients"].filter((r) => typeof r === "string" && r !== "") : [];
+    const digest = data["digest"];
+    return {
+      recipients,
+      language: data["language"] === "en" ? "en" : "de",
+      notOnPeppol: data["not_on_peppol"] === true,
+      digest: digest === "daily" || digest === "weekly" ? digest : "off",
+      digestSentAt: typeof data["digest_sent_at"] === "string" ? data["digest_sent_at"] : null
+    };
+  }
+  // ---------------------------------------------------------------------
   // Input validation (fail fast, before any request is sent)
   // ---------------------------------------------------------------------
+  /** Validated transaction-list filters as query params (shared by listTransactions and exportTransactionsCsv). */
+  buildTransactionFilterParams(filters) {
+    if (filters.complianceEnrollmentId !== void 0) {
+      this.validateId(filters.complianceEnrollmentId, "complianceEnrollmentId");
+    }
+    if (filters.country !== void 0 && !COUNTRY_REGEX.test(filters.country)) {
+      throw new TaxoraException("country must be a 2-character ISO 3166-1 alpha-2 code.");
+    }
+    if (filters.search !== void 0 && filters.search.length > 100) {
+      throw new TaxoraException("search must not exceed 100 characters.");
+    }
+    this.validateInternalReference(filters.internalReference);
+    if (filters.providerState !== void 0 && !/^[a-z_]{1,30}$/.test(filters.providerState)) {
+      throw new TaxoraException('providerState must be 1-30 lowercase letters or underscores (e.g. "refused").');
+    }
+    const params = new URLSearchParams();
+    if (filters.dateFrom !== void 0) params.set("date_from", this.formatDate(filters.dateFrom));
+    if (filters.dateTo !== void 0) params.set("date_to", this.formatDate(filters.dateTo));
+    if (filters.state !== void 0) params.set("state", filters.state);
+    if (filters.transactionType !== void 0) params.set("transaction_type", filters.transactionType);
+    if (filters.complianceEnrollmentId !== void 0) {
+      params.set("compliance_enrollment_id", String(filters.complianceEnrollmentId));
+    }
+    if (filters.country !== void 0) params.set("country", filters.country.toUpperCase());
+    if (filters.search !== void 0) params.set("search", filters.search);
+    if (filters.internalReference !== void 0) params.set("internal_reference", filters.internalReference);
+    if (filters.providerState !== void 0) params.set("provider_state", filters.providerState);
+    return params;
+  }
   validateEnrollmentInput(input) {
     if (input.siret === void 0 && input.siren === void 0) {
       throw new TaxoraException("Either siret or siren is required.");
@@ -2003,6 +2609,20 @@ var EReportingEndpoint = class {
       }
     });
   }
+  validateInvoicePdfFilename(input) {
+    if (input.invoicePdfFilename === void 0) return;
+    if (input.invoicePdfFilename.length > 120) {
+      throw new TaxoraException("invoicePdfFilename must not exceed 120 characters.");
+    }
+    if (input.invoicePdf === void 0) {
+      throw new TaxoraException("invoicePdfFilename requires invoicePdf.");
+    }
+  }
+  validateInternalReference(internalReference) {
+    if (internalReference !== void 0 && internalReference.length > 100) {
+      throw new TaxoraException("internalReference must not exceed 100 characters.");
+    }
+  }
   validateOptionalCodes(input) {
     if (input.currency !== void 0 && input.currency.length !== 3) {
       throw new TaxoraException("currency must be a 3-character ISO 4217 code.");
@@ -2084,6 +2704,29 @@ var EReportingEndpoint = class {
     if (input.amendedNumber !== void 0) body["amended_number"] = input.amendedNumber;
     if (input.amendedDate !== void 0) body["amended_date"] = this.formatDate(input.amendedDate);
     if (input.extraInfo !== void 0) body["extra_info"] = input.extraInfo;
+    if (input.internalReference !== void 0) body["internal_reference"] = input.internalReference;
+    if (input.invoicePdf !== void 0) body["invoice_pdf"] = this.encodeInvoicePdf(input.invoicePdf);
+    if (input.invoicePdfFilename !== void 0) body["invoice_pdf_filename"] = input.invoicePdfFilename;
+  }
+  /** Bytes → base64 (validated as a PDF of at most 10 MB); strings are taken as already base64. */
+  encodeInvoicePdf(pdf) {
+    if (typeof pdf === "string") {
+      if (pdf.trim() === "") {
+        throw new TaxoraException("invoicePdf must not be empty.");
+      }
+      return pdf;
+    }
+    const bytes = pdf instanceof Uint8Array ? pdf : new Uint8Array(pdf);
+    if (bytes.byteLength === 0) {
+      throw new TaxoraException("invoicePdf must not be empty.");
+    }
+    if (bytes.byteLength > INVOICE_PDF_MAX_BYTES) {
+      throw new TaxoraException("invoicePdf must not exceed 10 MB.");
+    }
+    if (!INVOICE_PDF_MAGIC.every((byte, index) => bytes[index] === byte)) {
+      throw new TaxoraException('invoicePdf must be a PDF file (content must start with "%PDF-").');
+    }
+    return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString("base64");
   }
   // ---------------------------------------------------------------------
   // HTTP plumbing (kept in sync with SmartEnrichmentEndpoint)
@@ -2107,6 +2750,30 @@ var EReportingEndpoint = class {
     const send = () => this.httpClient.request(method, url, options);
     return method === "GET" ? withResponseRetries(this.retryPolicy, "e-reporting request", send) : send();
   }
+  /** GET for a non-JSON download (CSV / document): no JSON Content-Type, retried like other GETs. */
+  async sendDownloadRequest(url, accept) {
+    const headers = this.buildHeaders(false);
+    headers["Accept"] = accept;
+    return withResponseRetries(
+      this.retryPolicy,
+      "e-reporting download",
+      () => this.httpClient.request("GET", url, { headers })
+    );
+  }
+  /** `attachment; filename="x.xml"` (or RFC 5987 `filename*=UTF-8''x.xml`) → "x.xml". */
+  filenameFromDisposition(header) {
+    if (header === null) return null;
+    const extended = /filename\*\s*=\s*(?:UTF-8|utf-8)''([^;]+)/.exec(header);
+    if (extended?.[1] !== void 0) {
+      try {
+        return decodeURIComponent(extended[1].trim());
+      } catch {
+      }
+    }
+    const plain = /filename\s*=\s*"([^"]*)"|filename\s*=\s*([^;]+)/.exec(header);
+    const name = (plain?.[1] ?? plain?.[2])?.trim();
+    return name !== void 0 && name !== "" ? name : null;
+  }
   /** Multipart upload: Content-Type is left to fetch so the boundary is set correctly. */
   async sendMultipartRequest(method, url, form) {
     return this.httpClient.request(method, url, { headers: this.buildHeaders(false), body: form });
@@ -2688,13 +3355,13 @@ var SmartEnrichmentHistoryPage = class _SmartEnrichmentHistoryPage {
 };
 
 // src/dto/SmartEnrichmentStatistics.ts
-function asString9(value, fallback = "") {
+function asString11(value, fallback = "") {
   return typeof value === "string" ? value : fallback;
 }
-function asNumber6(value) {
+function asNumber7(value) {
   return typeof value === "number" ? value : Number(value ?? 0) || 0;
 }
-function asRecord2(value) {
+function asRecord4(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function asRecords2(value) {
@@ -2717,39 +3384,39 @@ var SmartEnrichmentStatistics = class _SmartEnrichmentStatistics {
   byOutcome;
   confidenceBuckets;
   static fromArray(data) {
-    const range = asRecord2(data["range"]);
-    const totals = asRecord2(data["totals"]);
+    const range = asRecord4(data["range"]);
+    const totals = asRecord4(data["totals"]);
     const timeSeries = asRecords2(data["time_series"]).map((row) => ({
-      bucket: asString9(row["bucket"]),
-      jobs: asNumber6(row["jobs"]),
-      items: asNumber6(row["items"]),
-      found: asNumber6(row["found"])
+      bucket: asString11(row["bucket"]),
+      jobs: asNumber7(row["jobs"]),
+      items: asNumber7(row["items"]),
+      found: asNumber7(row["found"])
     }));
     const bySource = asRecords2(data["by_source"]).map((row) => ({
-      source: asString9(row["source"]),
-      jobs: asNumber6(row["jobs"]),
-      found: asNumber6(row["found"])
+      source: asString11(row["source"]),
+      jobs: asNumber7(row["jobs"]),
+      found: asNumber7(row["found"])
     }));
     const byOutcome = asRecords2(data["by_outcome"]).map((row) => ({
-      outcome: asString9(row["outcome"]),
-      count: asNumber6(row["count"])
+      outcome: asString11(row["outcome"]),
+      count: asNumber7(row["count"])
     }));
     const confidenceBuckets = asRecords2(data["confidence_buckets"]).map((row) => ({
-      bucket: asString9(row["bucket"]),
-      count: asNumber6(row["count"])
+      bucket: asString11(row["bucket"]),
+      count: asNumber7(row["count"])
     }));
     return new _SmartEnrichmentStatistics(
       {
-        dateFrom: asString9(range["date_from"]),
-        dateTo: asString9(range["date_to"]),
-        interval: asString9(range["interval"])
+        dateFrom: asString11(range["date_from"]),
+        dateTo: asString11(range["date_to"]),
+        interval: asString11(range["interval"])
       },
       {
-        jobs: asNumber6(totals["jobs"]),
-        items: asNumber6(totals["items"]),
-        found: asNumber6(totals["found"]),
-        foundRate: asNumber6(totals["found_rate"]),
-        avgConfidence: asNumber6(totals["avg_confidence"])
+        jobs: asNumber7(totals["jobs"]),
+        items: asNumber7(totals["items"]),
+        found: asNumber7(totals["found"]),
+        foundRate: asNumber7(totals["found_rate"]),
+        avgConfidence: asNumber7(totals["avg_confidence"])
       },
       timeSeries,
       bySource,
@@ -4029,7 +4696,7 @@ var AuthRetryHttpClient = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.8.0";
+var SDK_VERSION = "1.9.0";
 
 // src/http/SdkVersionHttpClient.ts
 var SDK_VERSION_HEADER = "X-Taxora-SDK-Version";
@@ -4056,6 +4723,7 @@ var TaxoraClient = class {
   company;
   smartEnrichment;
   eReporting;
+  billing;
   baseUrl;
   constructor(options) {
     const environment = options.environment ?? Environment.SANDBOX;
@@ -4076,6 +4744,7 @@ var TaxoraClient = class {
       retryPolicy
     );
     this.eReporting = new EReportingEndpoint(this.baseUrl, options.apiKey, tokenStorage, retryClient, retryPolicy);
+    this.billing = new BillingEndpoint(this.baseUrl, options.apiKey, tokenStorage, retryClient, retryPolicy);
   }
 };
 
@@ -4215,17 +4884,24 @@ function toBytes(rawBody) {
     "invalid_body"
   );
 }
+
+// src/webhooks/WebhookEvent.ts
+function isTransactionBuyerRejected(object) {
+  return object.buyer_rejected === true;
+}
 export {
   ApiVersion,
   AuthEndpoint,
   AuthRetryHttpClient,
   AuthenticationException,
+  BillingEndpoint,
   CompanyAddress,
   CompanyEndpoint,
   ComplianceDocumentType,
   ComplianceEnrollment,
   ComplianceEnrollmentPage,
   ComplianceEnrollmentStatus,
+  ComplianceOfferings,
   ComplianceService,
   ComplianceTaxReport,
   ComplianceTaxReportPage,
@@ -4269,6 +4945,8 @@ export {
   TaxoraClientFactory,
   TaxoraException,
   Token,
+  UsageSummary,
+  UsageSummaryPage,
   ValidationException,
   VatCertificateExport,
   VatCollection,
@@ -4297,6 +4975,7 @@ export {
   generateWebhookSignatureHeader,
   getBaseUrl,
   getFailedVatStates,
+  isTransactionBuyerRejected,
   parseLocalTaxNumbersCsv,
   parseWebhookSignatureHeader,
   toComplianceDocumentType,