@taxora/sdk 1.0.6 → 1.1.0

package/dist/index.cjs

@@ -26,15 +26,36 @@ __export(index_exports, {
   AuthenticationException: () => AuthenticationException,
   CompanyAddress: () => CompanyAddress,
   CompanyEndpoint: () => CompanyEndpoint,
+  ComplianceEnrollment: () => ComplianceEnrollment,
+  ComplianceEnrollmentPage: () => ComplianceEnrollmentPage,
+  ComplianceEnrollmentStatus: () => ComplianceEnrollmentStatus,
+  ComplianceTaxReport: () => ComplianceTaxReport,
+  ComplianceTaxReportPage: () => ComplianceTaxReportPage,
+  ComplianceTaxReportState: () => ComplianceTaxReportState,
+  ComplianceTransaction: () => ComplianceTransaction,
+  ComplianceTransactionPage: () => ComplianceTransactionPage,
+  ComplianceTransactionState: () => ComplianceTransactionState,
+  ComplianceTransactionType: () => ComplianceTransactionType,
+  EReportingEndpoint: () => EReportingEndpoint,
   Environment: () => Environment,
   FetchHttpClient: () => FetchHttpClient,
   HttpException: () => HttpException,
+  ImportResult: () => ImportResult,
   InMemoryTokenStorage: () => InMemoryTokenStorage,
   Language: () => Language,
   LoginIdentifier: () => LoginIdentifier,
   ProviderDocument: () => ProviderDocument,
   ProviderDocumentLine: () => ProviderDocumentLine,
+  RevenueStatistics: () => RevenueStatistics,
   ScoreBreakdown: () => ScoreBreakdown,
+  SireneLookupResult: () => SireneLookupResult,
+  SmartEnrichmentEndpoint: () => SmartEnrichmentEndpoint,
+  SmartEnrichmentHistoryPage: () => SmartEnrichmentHistoryPage,
+  SmartEnrichmentHistoryRow: () => SmartEnrichmentHistoryRow,
+  SmartEnrichmentJob: () => SmartEnrichmentJob,
+  SmartEnrichmentResource: () => SmartEnrichmentResource,
+  SmartEnrichmentStatistics: () => SmartEnrichmentStatistics,
+  SmartEnrichmentStatus: () => SmartEnrichmentStatus,
   TaxoraClient: () => TaxoraClient,
   TaxoraClientFactory: () => TaxoraClientFactory,
   TaxoraException: () => TaxoraException,
@@ -43,12 +64,23 @@ __export(index_exports, {
   VatCertificateExport: () => VatCertificateExport,
   VatCollection: () => VatCollection,
   VatEndpoint: () => VatEndpoint,
+  VatRates: () => VatRates,
   VatResource: () => VatResource,
   VatState: () => VatState,
   VatValidationAddressInput: () => VatValidationAddressInput,
+  describeComplianceEnrollmentStatus: () => describeComplianceEnrollmentStatus,
+  describeComplianceTaxReportState: () => describeComplianceTaxReportState,
+  describeComplianceTransactionState: () => describeComplianceTransactionState,
+  describeComplianceTransactionType: () => describeComplianceTransactionType,
+  describeSmartEnrichmentStatus: () => describeSmartEnrichmentStatus,
   describeVatState: () => describeVatState,
   getBaseUrl: () => getBaseUrl,
-  getFailedVatStates: () => getFailedVatStates
+  getFailedVatStates: () => getFailedVatStates,
+  toComplianceEnrollmentStatus: () => toComplianceEnrollmentStatus,
+  toComplianceTaxReportState: () => toComplianceTaxReportState,
+  toComplianceTransactionState: () => toComplianceTransactionState,
+  toComplianceTransactionType: () => toComplianceTransactionType,
+  toSmartEnrichmentStatus: () => toSmartEnrichmentStatus
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -277,6 +309,1779 @@ var CompanyEndpoint = class {
   }
 };
 
+// src/enums/ComplianceEnrollmentStatus.ts
+var ComplianceEnrollmentStatus = {
+  PENDING_DATA: "pending_data",
+  ACCOUNT_CREATED: "account_created",
+  REGIME_ACTIVATED: "regime_activated",
+  READY: "ready",
+  SUSPENDED: "suspended",
+  ERROR_ACCOUNT: "error_account",
+  ERROR_ACTIVATION: "error_activation",
+  UNKNOWN: "unknown"
+};
+var VALUES = Object.values(ComplianceEnrollmentStatus);
+function toComplianceEnrollmentStatus(value) {
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (VALUES.includes(normalized)) {
+      return normalized;
+    }
+  }
+  return ComplianceEnrollmentStatus.UNKNOWN;
+}
+var DESCRIPTIONS = {
+  [ComplianceEnrollmentStatus.PENDING_DATA]: "Awaiting merchant data before provisioning can start.",
+  [ComplianceEnrollmentStatus.ACCOUNT_CREATED]: "Provider account exists. Regime not yet activated.",
+  [ComplianceEnrollmentStatus.REGIME_ACTIVATED]: "Compliance regime activated at provider. Ready to submit transactions.",
+  [ComplianceEnrollmentStatus.READY]: "Enrollment fully active and reporting.",
+  [ComplianceEnrollmentStatus.SUSPENDED]: "Enrollment temporarily suspended.",
+  [ComplianceEnrollmentStatus.ERROR_ACCOUNT]: "Provider account creation failed.",
+  [ComplianceEnrollmentStatus.ERROR_ACTIVATION]: "Regime activation at provider failed.",
+  [ComplianceEnrollmentStatus.UNKNOWN]: "Unknown status."
+};
+function describeComplianceEnrollmentStatus(status) {
+  return DESCRIPTIONS[status];
+}
+
+// src/dto/ComplianceEnrollment.ts
+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;
+}
+var ComplianceEnrollment = class _ComplianceEnrollment {
+  constructor(id, companyId, country, regime, provider, status, statusLabel, statusError, providerAccountId, taxId, companyRegisterId, companyRegisterScheme, regimeConfig, reportingStartDate, notificationEmail, autoSend, createdAt, updatedAt) {
+    this.id = id;
+    this.companyId = companyId;
+    this.country = country;
+    this.regime = regime;
+    this.provider = provider;
+    this.status = status;
+    this.statusLabel = statusLabel;
+    this.statusError = statusError;
+    this.providerAccountId = providerAccountId;
+    this.taxId = taxId;
+    this.companyRegisterId = companyRegisterId;
+    this.companyRegisterScheme = companyRegisterScheme;
+    this.regimeConfig = regimeConfig;
+    this.reportingStartDate = reportingStartDate;
+    this.notificationEmail = notificationEmail;
+    this.autoSend = autoSend;
+    this.createdAt = createdAt;
+    this.updatedAt = updatedAt;
+  }
+  id;
+  companyId;
+  country;
+  regime;
+  provider;
+  status;
+  statusLabel;
+  statusError;
+  providerAccountId;
+  taxId;
+  companyRegisterId;
+  companyRegisterScheme;
+  regimeConfig;
+  reportingStartDate;
+  notificationEmail;
+  autoSend;
+  createdAt;
+  updatedAt;
+  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"]),
+      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"]),
+      regimeConfig,
+      asNullableString(data["reporting_start_date"]),
+      asNullableString(data["notification_email"]),
+      data["auto_send"] === true,
+      asNullableString(data["created_at"]),
+      asNullableString(data["updated_at"])
+    );
+  }
+};
+
+// src/dto/ComplianceEnrollmentPage.ts
+var ComplianceEnrollmentPage = class _ComplianceEnrollmentPage {
+  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 = payload !== null && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+    const rows = Array.isArray(obj["data"]) ? obj["data"].filter((row) => typeof row === "object" && row !== null).map(ComplianceEnrollment.fromArray) : [];
+    const meta = obj["meta"] !== null && typeof obj["meta"] === "object" && !Array.isArray(obj["meta"]) ? obj["meta"] : {};
+    const num = (value, fallback) => typeof value === "number" ? value : fallback;
+    return new _ComplianceEnrollmentPage(
+      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/enums/ComplianceTaxReportState.ts
+var ComplianceTaxReportState = {
+  NEW: "new",
+  SENT: "sent",
+  ACKNOWLEDGED: "acknowledged",
+  REGISTERED: "registered",
+  REFUSED: "refused",
+  ERROR: "error",
+  UNKNOWN: "unknown"
+};
+var VALUES2 = Object.values(ComplianceTaxReportState);
+function toComplianceTaxReportState(value) {
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (VALUES2.includes(normalized)) {
+      return normalized;
+    }
+  }
+  return ComplianceTaxReportState.UNKNOWN;
+}
+var DESCRIPTIONS2 = {
+  [ComplianceTaxReportState.NEW]: "Created at provider, waiting for the daily ledger batch.",
+  [ComplianceTaxReportState.SENT]: "Ledger transmitted to PPF.",
+  [ComplianceTaxReportState.ACKNOWLEDGED]: "PPF acknowledged receipt of the ledger.",
+  [ComplianceTaxReportState.REGISTERED]: "Accepted by DGFiP (CDV 300).",
+  [ComplianceTaxReportState.REFUSED]: "Rejected by DGFiP (CDV 301).",
+  [ComplianceTaxReportState.ERROR]: "Transmission or PPF error.",
+  [ComplianceTaxReportState.UNKNOWN]: "Unknown state."
+};
+function describeComplianceTaxReportState(state) {
+  return DESCRIPTIONS2[state];
+}
+
+// src/dto/ComplianceTaxReport.ts
+function asString2(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNullableString2(value) {
+  return typeof value === "string" ? value : null;
+}
+function asNumber2(value) {
+  return typeof value === "number" ? value : Number(value ?? 0) || 0;
+}
+function asNullableNumber(value) {
+  return typeof value === "number" ? value : null;
+}
+function asMoney(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return "0.00";
+}
+var ComplianceTaxReport = class _ComplianceTaxReport {
+  constructor(id, companyId, complianceTransactionId, ledgerId, country, regime, state, stateLabel, isTerminal, providerTaxReportId, providerLedgerId, baseAmount, taxAmount, totalAmount, refusalReason, registeredAt, refusedAt, createdAt, updatedAt) {
+    this.id = id;
+    this.companyId = companyId;
+    this.complianceTransactionId = complianceTransactionId;
+    this.ledgerId = ledgerId;
+    this.country = country;
+    this.regime = regime;
+    this.state = state;
+    this.stateLabel = stateLabel;
+    this.isTerminal = isTerminal;
+    this.providerTaxReportId = providerTaxReportId;
+    this.providerLedgerId = providerLedgerId;
+    this.baseAmount = baseAmount;
+    this.taxAmount = taxAmount;
+    this.totalAmount = totalAmount;
+    this.refusalReason = refusalReason;
+    this.registeredAt = registeredAt;
+    this.refusedAt = refusedAt;
+    this.createdAt = createdAt;
+    this.updatedAt = updatedAt;
+  }
+  id;
+  companyId;
+  complianceTransactionId;
+  ledgerId;
+  country;
+  regime;
+  state;
+  stateLabel;
+  isTerminal;
+  providerTaxReportId;
+  providerLedgerId;
+  baseAmount;
+  taxAmount;
+  totalAmount;
+  refusalReason;
+  registeredAt;
+  refusedAt;
+  createdAt;
+  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"]),
+      toComplianceTaxReportState(data["state"]),
+      asString2(data["state_label"]),
+      data["is_terminal"] === true,
+      asNullableString2(data["provider_tax_report_id"]),
+      asNullableString2(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"])
+    );
+  }
+};
+
+// src/dto/ComplianceTaxReportPage.ts
+var ComplianceTaxReportPage = class _ComplianceTaxReportPage {
+  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 = payload !== null && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+    const rows = Array.isArray(obj["data"]) ? obj["data"].filter((row) => typeof row === "object" && row !== null).map(ComplianceTaxReport.fromArray) : [];
+    const meta = obj["meta"] !== null && typeof obj["meta"] === "object" && !Array.isArray(obj["meta"]) ? obj["meta"] : {};
+    const num = (value, fallback) => typeof value === "number" ? value : fallback;
+    return new _ComplianceTaxReportPage(
+      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/enums/ComplianceTransactionState.ts
+var ComplianceTransactionState = {
+  PENDING: "pending",
+  SENDING: "sending",
+  SUBMITTED: "submitted",
+  ERROR: "error",
+  UNKNOWN: "unknown"
+};
+var VALUES3 = Object.values(ComplianceTransactionState);
+function toComplianceTransactionState(value) {
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (VALUES3.includes(normalized)) {
+      return normalized;
+    }
+  }
+  return ComplianceTransactionState.UNKNOWN;
+}
+var DESCRIPTIONS3 = {
+  [ComplianceTransactionState.PENDING]: "Recorded locally, not yet submitted to the provider.",
+  [ComplianceTransactionState.SENDING]: "Submission to the provider in progress.",
+  [ComplianceTransactionState.SUBMITTED]: "Successfully submitted to the provider.",
+  [ComplianceTransactionState.ERROR]: "Submission failed. See submissionError.",
+  [ComplianceTransactionState.UNKNOWN]: "Unknown state."
+};
+function describeComplianceTransactionState(state) {
+  return DESCRIPTIONS3[state];
+}
+
+// src/enums/ComplianceTransactionType.ts
+var ComplianceTransactionType = {
+  B2C_OUTBOUND: "b2c_outbound",
+  B2B_DOMESTIC_OUTBOUND: "b2b_domestic_outbound",
+  B2B_DOMESTIC_INBOUND: "b2b_domestic_inbound",
+  CROSSBORDER_OUTBOUND: "crossborder_outbound",
+  CROSSBORDER_INBOUND: "crossborder_inbound",
+  UNKNOWN: "unknown"
+};
+var VALUES4 = Object.values(ComplianceTransactionType);
+function toComplianceTransactionType(value) {
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (VALUES4.includes(normalized)) {
+      return normalized;
+    }
+  }
+  return ComplianceTransactionType.UNKNOWN;
+}
+var DESCRIPTIONS4 = {
+  [ComplianceTransactionType.B2C_OUTBOUND]: "Sale to a private person in the merchant country (DGFiP Flux 10.3).",
+  [ComplianceTransactionType.B2B_DOMESTIC_OUTBOUND]: "Sale to a domestic business (DGFiP Flux 1, Phase 2).",
+  [ComplianceTransactionType.B2B_DOMESTIC_INBOUND]: "Purchase from a domestic business (DGFiP Flux 1, Phase 2).",
+  [ComplianceTransactionType.CROSSBORDER_OUTBOUND]: "Sale to a non-domestic business (DGFiP Flux 10.1).",
+  [ComplianceTransactionType.CROSSBORDER_INBOUND]: "Purchase from a non-domestic supplier (DGFiP Flux 10.1).",
+  [ComplianceTransactionType.UNKNOWN]: "Unknown transaction type."
+};
+function describeComplianceTransactionType(type) {
+  return DESCRIPTIONS4[type];
+}
+
+// src/dto/ComplianceTransaction.ts
+function asString3(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNullableString3(value) {
+  return typeof value === "string" ? value : null;
+}
+function asNumber3(value) {
+  return typeof value === "number" ? value : Number(value ?? 0) || 0;
+}
+function asMoney2(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  return "0.00";
+}
+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) {
+    this.id = id;
+    this.companyId = companyId;
+    this.complianceEnrollmentId = complianceEnrollmentId;
+    this.country = country;
+    this.regime = regime;
+    this.transactionType = transactionType;
+    this.transactionTypeLabel = transactionTypeLabel;
+    this.state = state;
+    this.stateLabel = stateLabel;
+    this.invoiceNumber = invoiceNumber;
+    this.invoiceDate = invoiceDate;
+    this.dueDate = dueDate;
+    this.currency = currency;
+    this.subtotal = subtotal;
+    this.taxAmount = taxAmount;
+    this.total = total;
+    this.counterpartyName = counterpartyName;
+    this.counterpartyCountry = counterpartyCountry;
+    this.counterpartyVatNumber = counterpartyVatNumber;
+    this.isPaid = isPaid;
+    this.paidAt = paidAt;
+    this.providerInvoiceId = providerInvoiceId;
+    this.submissionError = submissionError;
+    this.reportedAt = reportedAt;
+    this.taxReport = taxReport;
+    this.createdAt = createdAt;
+    this.updatedAt = updatedAt;
+  }
+  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;
+  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"]),
+      toComplianceTransactionType(data["transaction_type"]),
+      asString3(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"),
+      asMoney2(data["subtotal"]),
+      asMoney2(data["tax_amount"]),
+      asMoney2(data["total"]),
+      asNullableString3(data["counterparty_name"]),
+      asNullableString3(data["counterparty_country"]),
+      asNullableString3(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"]),
+      taxReport,
+      asNullableString3(data["created_at"]),
+      asNullableString3(data["updated_at"])
+    );
+  }
+};
+
+// src/dto/ComplianceTransactionPage.ts
+var ComplianceTransactionPage = class _ComplianceTransactionPage {
+  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 = payload !== null && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+    const rows = Array.isArray(obj["data"]) ? obj["data"].filter((row) => typeof row === "object" && row !== null).map(ComplianceTransaction.fromArray) : [];
+    const meta = obj["meta"] !== null && typeof obj["meta"] === "object" && !Array.isArray(obj["meta"]) ? obj["meta"] : {};
+    const num = (value, fallback) => typeof value === "number" ? value : fallback;
+    return new _ComplianceTransactionPage(
+      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/dto/ImportResult.ts
+var ImportResult = class _ImportResult {
+  constructor(created, skippedDuplicates, errors) {
+    this.created = created;
+    this.skippedDuplicates = skippedDuplicates;
+    this.errors = errors;
+  }
+  created;
+  skippedDuplicates;
+  errors;
+  static fromArray(data) {
+    const errors = (Array.isArray(data["errors"]) ? data["errors"] : []).filter(
+      (row) => typeof row === "string"
+    );
+    const num = (value) => typeof value === "number" ? value : 0;
+    return new _ImportResult(num(data["created"]), num(data["skipped_duplicates"]), errors);
+  }
+};
+
+// src/dto/RevenueStatistics.ts
+function asString4(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNumber4(value) {
+  return typeof value === "number" ? value : Number(value ?? 0) || 0;
+}
+function asMoney3(value) {
+  return typeof value === "string" ? value : "0.0000";
+}
+function asRecords(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter((row) => typeof row === "object" && row !== null);
+}
+function toTotals(data) {
+  return {
+    count: asNumber4(data["count"]),
+    subtotal: asMoney3(data["subtotal"]),
+    taxAmount: asMoney3(data["tax_amount"]),
+    total: asMoney3(data["total"])
+  };
+}
+var RevenueStatistics = class _RevenueStatistics {
+  constructor(dateFrom, dateTo, interval, primaryCurrency, isMultiCurrency, totals, timeSeries, byType, byCountry, byState, byCurrency) {
+    this.dateFrom = dateFrom;
+    this.dateTo = dateTo;
+    this.interval = interval;
+    this.primaryCurrency = primaryCurrency;
+    this.isMultiCurrency = isMultiCurrency;
+    this.totals = totals;
+    this.timeSeries = timeSeries;
+    this.byType = byType;
+    this.byCountry = byCountry;
+    this.byState = byState;
+    this.byCurrency = byCurrency;
+  }
+  dateFrom;
+  dateTo;
+  interval;
+  primaryCurrency;
+  isMultiCurrency;
+  totals;
+  timeSeries;
+  byType;
+  byCountry;
+  byState;
+  byCurrency;
+  static fromArray(data) {
+    const range = typeof data["range"] === "object" && data["range"] !== null ? data["range"] : {};
+    const totals = toTotals(
+      typeof data["totals"] === "object" && data["totals"] !== null ? data["totals"] : {}
+    );
+    const timeSeries = asRecords(data["time_series"]).map((row) => ({
+      bucket: asString4(row["bucket"]),
+      ...toTotals(row)
+    }));
+    const byType = asRecords(data["by_type"]).map((row) => ({
+      type: asString4(row["type"]),
+      typeLabel: asString4(row["type_label"]),
+      count: asNumber4(row["count"]),
+      total: asMoney3(row["total"])
+    }));
+    const byCountry = asRecords(data["by_country"]).map((row) => ({
+      country: asString4(row["country"], "unknown"),
+      count: asNumber4(row["count"]),
+      total: asMoney3(row["total"])
+    }));
+    const byState = asRecords(data["by_state"]).map((row) => ({
+      state: asString4(row["state"]),
+      stateLabel: asString4(row["state_label"]),
+      count: asNumber4(row["count"]),
+      total: asMoney3(row["total"])
+    }));
+    const byCurrency = asRecords(data["by_currency"]).map((row) => ({
+      currency: asString4(row["currency"]),
+      ...toTotals(row)
+    }));
+    return new _RevenueStatistics(
+      asString4(range["date_from"]) || void 0,
+      asString4(range["date_to"]) || void 0,
+      asString4(range["interval"]) || void 0,
+      asString4(data["primary_currency"], "EUR"),
+      data["is_multi_currency"] === true,
+      totals,
+      timeSeries,
+      byType,
+      byCountry,
+      byState,
+      byCurrency
+    );
+  }
+};
+
+// src/dto/SireneLookupResult.ts
+function asString5(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNullableString4(value) {
+  return typeof value === "string" ? value : null;
+}
+var SireneLookupResult = class _SireneLookupResult {
+  constructor(companyName, siren, siret, nafCode, nafFull, enterpriseSize, address, city, postalcode) {
+    this.companyName = companyName;
+    this.siren = siren;
+    this.siret = siret;
+    this.nafCode = nafCode;
+    this.nafFull = nafFull;
+    this.enterpriseSize = enterpriseSize;
+    this.address = address;
+    this.city = city;
+    this.postalcode = postalcode;
+  }
+  companyName;
+  siren;
+  siret;
+  nafCode;
+  nafFull;
+  enterpriseSize;
+  address;
+  city;
+  postalcode;
+  static fromArray(data) {
+    return new _SireneLookupResult(
+      asString5(data["company_name"]),
+      asString5(data["siren"]),
+      asNullableString4(data["siret"]),
+      asNullableString4(data["naf_code"]),
+      asNullableString4(data["naf_full"]),
+      asNullableString4(data["enterprise_size"]),
+      asNullableString4(data["address"]),
+      asNullableString4(data["city"]),
+      asNullableString4(data["postalcode"])
+    );
+  }
+};
+
+// src/dto/VatRates.ts
+function asString6(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNumber5(value) {
+  return typeof value === "number" ? value : Number(value ?? 0) || 0;
+}
+var VatRates = class _VatRates {
+  constructor(country, currency, rates) {
+    this.country = country;
+    this.currency = currency;
+    this.rates = rates;
+  }
+  country;
+  currency;
+  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: asString6(row["category"]),
+      labelKey: asString6(row["label_key"]),
+      taxName: asString6(row["tax_name"]),
+      requiresVatex: row["requires_vatex"] === true
+    }));
+    return new _VatRates(asString6(data["country"]), asString6(data["currency"], "EUR"), rates);
+  }
+};
+
+// src/exceptions/ValidationException.ts
+var ValidationException = class extends TaxoraException {
+  statusCode = 422;
+  errors;
+  constructor(message, errors, context = {}) {
+    super(message, context);
+    this.name = "ValidationException";
+    this.errors = errors;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  getErrors() {
+    return this.errors;
+  }
+};
+
+// src/endpoints/EReportingEndpoint.ts
+var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+var NAF_CODE_REGEX = /^\d{2}$/;
+var INTERVALS = ["day", "week", "month"];
+var ENTERPRISE_SIZES = ["micro", "pme", "eti", "ge"];
+var TYPE_OPERATIONS = ["services", "goods", "mixed"];
+var TRANSACTION_TYPES = [
+  "b2c_outbound",
+  "b2b_domestic_outbound",
+  "b2b_domestic_inbound",
+  "crossborder_outbound",
+  "crossborder_inbound"
+];
+var EReportingEndpoint = class {
+  constructor(baseUrl, apiKey, tokenStorage, httpClient) {
+    this.baseUrl = baseUrl;
+    this.apiKey = apiKey;
+    this.tokenStorage = tokenStorage;
+    this.httpClient = httpClient;
+  }
+  baseUrl;
+  apiKey;
+  tokenStorage;
+  httpClient;
+  // ---------------------------------------------------------------------
+  // Enrollments
+  // ---------------------------------------------------------------------
+  /**
+   * Create a compliance enrollment and provision the provider account. By
+   * default the DGFiP regime is activated right away; pass `autoActivate: false`
+   * to only create the account.
+   *
+   * On provider failure the API responds 502 (mapped to an HttpException) and
+   * the enrollment is persisted in `error_account`/`error_activation` state so
+   * provisioning can be retried.
+   */
+  async createEnrollment(input) {
+    this.validateEnrollmentInput(input);
+    const body = {
+      email: input.email,
+      naf_code: input.nafCode,
+      enterprise_size: input.enterpriseSize,
+      type_operation: input.typeOperation,
+      reporting_start_date: this.formatDate(input.reportingStartDate)
+    };
+    if (input.country !== void 0) body["country"] = input.country;
+    if (input.regime !== void 0) body["regime"] = input.regime;
+    if (input.siret !== void 0) body["siret"] = input.siret;
+    if (input.siren !== void 0) body["siren"] = input.siren;
+    if (input.vatNumber !== void 0) body["vat_number"] = input.vatNumber;
+    if (input.companyName !== void 0) body["company_name"] = input.companyName;
+    if (input.address !== void 0) body["address"] = input.address;
+    if (input.city !== void 0) body["city"] = input.city;
+    if (input.postalcode !== void 0) body["postalcode"] = input.postalcode;
+    if (input.province !== void 0) body["province"] = input.province;
+    if (input.autoActivate !== void 0) body["auto_activate"] = input.autoActivate;
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/enrollments`, body);
+    const data = await this.parseJsonResponse(response);
+    return ComplianceEnrollment.fromArray(data);
+  }
+  /** Paginated list of the company's enrollments (newest first). `perPage` is capped at 100 server-side. */
+  async listEnrollments(page = 1, perPage = 25) {
+    const params = new URLSearchParams();
+    params.set("page", String(page));
+    params.set("per_page", String(perPage));
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/enrollments?${params.toString()}`);
+    return ComplianceEnrollmentPage.fromResponse(await this.parseJsonResponse(response));
+  }
+  /** Get a single enrollment by id. */
+  async getEnrollment(id) {
+    this.validateId(id, "id");
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/enrollments/${id}`);
+    const data = await this.parseJsonResponse(response);
+    return ComplianceEnrollment.fromArray(data);
+  }
+  /**
+   * Look up company data by SIRET, SIREN or French VAT number via the French
+   * SIRENE registry — ideal for prefilling createEnrollment().
+   *
+   * Rate-limited to 3 requests/minute per user (protects the external French
+   * government API); exceeding it yields a 429 (mapped to an HttpException).
+   */
+  async sireneLookup(q) {
+    if (q.trim() === "") {
+      throw new TaxoraException("q must not be empty.");
+    }
+    const params = new URLSearchParams();
+    params.set("q", q);
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/sirene-lookup?${params.toString()}`);
+    const data = await this.parseJsonResponse(response);
+    return SireneLookupResult.fromArray(data);
+  }
+  // ---------------------------------------------------------------------
+  // Transactions
+  // ---------------------------------------------------------------------
+  /**
+   * Record and (by default) submit a Flux 10 transaction. Pass `submitNow: false`
+   * to only record it — submission can be triggered later via submitTransaction().
+   *
+   * Immediate per-invoice submission requires the e-invoicing feature on the
+   * account; in pure e-reporting mode the transaction is only recorded and
+   * reported via the aggregated daily ledgers.
+   *
+   * Creation is idempotent on the invoice's natural key (enrollment, type,
+   * invoice number, invoice date, counterparty VAT): a re-sent create returns
+   * the existing transaction with HTTP 200 instead of creating a duplicate.
+   *
+   * On provider failure the API responds 502 (mapped to an HttpException).
+   */
+  async createTransaction(input) {
+    this.validateId(input.complianceEnrollmentId, "complianceEnrollmentId");
+    this.validateTransactionType(input.transactionType);
+    this.validateInvoiceNumber(input.invoiceNumber);
+    this.validateInvoiceLines(input.invoiceLines);
+    this.validateOptionalCodes(input);
+    const body = {
+      compliance_enrollment_id: input.complianceEnrollmentId,
+      transaction_type: input.transactionType,
+      invoice_number: input.invoiceNumber,
+      invoice_date: this.formatDate(input.invoiceDate),
+      subtotal: input.subtotal,
+      total: input.total,
+      invoice_lines_attributes: this.buildInvoiceLines(input.invoiceLines)
+    };
+    this.applyOptionalTransactionFields(body, input);
+    if (input.submitNow !== void 0) body["submit_now"] = input.submitNow;
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/transactions`, body);
+    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. */
+  async listTransactions(filters = {}) {
+    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.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();
+    const url = `${this.baseUrl}/compliance/transactions${queryString ? `?${queryString}` : ""}`;
+    const response = await this.sendRequest("GET", url);
+    return ComplianceTransactionPage.fromResponse(await this.parseJsonResponse(response));
+  }
+  /** Get a single transaction by id (includes its tax report when one exists). */
+  async getTransaction(id) {
+    this.validateId(id, "id");
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/transactions/${id}`);
+    const data = await this.parseJsonResponse(response);
+    return ComplianceTransaction.fromArray(data);
+  }
+  /** Update a still-pending transaction. Only the provided fields are sent; already-submitted transactions are rejected with 422. */
+  async updateTransaction(id, input) {
+    this.validateId(id, "id");
+    if (input.transactionType !== void 0) this.validateTransactionType(input.transactionType);
+    if (input.invoiceNumber !== void 0) this.validateInvoiceNumber(input.invoiceNumber);
+    if (input.invoiceLines !== void 0) this.validateInvoiceLines(input.invoiceLines);
+    this.validateOptionalCodes(input);
+    const body = {};
+    if (input.transactionType !== void 0) body["transaction_type"] = input.transactionType;
+    if (input.invoiceNumber !== void 0) body["invoice_number"] = input.invoiceNumber;
+    if (input.invoiceDate !== void 0) body["invoice_date"] = this.formatDate(input.invoiceDate);
+    if (input.subtotal !== void 0) body["subtotal"] = input.subtotal;
+    if (input.total !== void 0) body["total"] = input.total;
+    if (input.invoiceLines !== void 0) body["invoice_lines_attributes"] = this.buildInvoiceLines(input.invoiceLines);
+    this.applyOptionalTransactionFields(body, input);
+    const response = await this.sendRequest("PUT", `${this.baseUrl}/compliance/transactions/${id}`, body);
+    const data = await this.parseJsonResponse(response);
+    return ComplianceTransaction.fromArray(data);
+  }
+  /** Delete a still-pending transaction. Already-submitted transactions are rejected with 422. */
+  async deleteTransaction(id) {
+    this.validateId(id, "id");
+    const response = await this.sendRequest("DELETE", `${this.baseUrl}/compliance/transactions/${id}`);
+    await this.assertNoContentResponse(response);
+  }
+  /**
+   * Submit (or retry) an existing `pending`/`error` transaction to the provider.
+   * Replays the invoice lines stored at creation, so they don't have to be re-sent.
+   *
+   * Requires the e-invoicing feature on the account — pure e-reporting customers
+   * get a 422 (transactions are reported via the aggregated daily ledgers instead).
+   *
+   * On provider failure the API responds 502 (mapped to an HttpException);
+   * already-submitted transactions are rejected with 422.
+   */
+  async submitTransaction(id) {
+    this.validateId(id, "id");
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/transactions/${id}/submit`);
+    const data = await this.parseJsonResponse(response);
+    return ComplianceTransaction.fromArray(data);
+  }
+  /**
+   * Bulk-import transactions from a semicolon-separated CSV (one row per invoice
+   * line; rows sharing an invoice_number are grouped into one transaction).
+   * Required columns: invoice_number, invoice_date, transaction_type, subtotal,
+   * total, line_description, line_quantity, line_price, tax_name, tax_percent,
+   * tax_category.
+   *
+   * The import is idempotent: re-uploading the same file skips rows whose
+   * invoice already exists (reported via `skippedDuplicates`).
+   */
+  async importTransactions(enrollmentId, csvContent, filename = "transactions.csv") {
+    this.validateId(enrollmentId, "enrollmentId");
+    if (csvContent.trim() === "") {
+      throw new TaxoraException("csvContent must not be empty.");
+    }
+    const form = new FormData();
+    form.set("compliance_enrollment_id", String(enrollmentId));
+    form.set("file", new Blob([csvContent], { type: "text/csv" }), filename);
+    const response = await this.sendMultipartRequest("POST", `${this.baseUrl}/compliance/transactions/import`, form);
+    const data = await this.parseJsonResponse(response);
+    return ImportResult.fromArray(data);
+  }
+  // ---------------------------------------------------------------------
+  // Analytics, configuration & reports
+  // ---------------------------------------------------------------------
+  /**
+   * Aggregated turnover statistics for the authenticated company's e-reporting
+   * transactions. All arguments are optional — the API defaults to the last 12
+   * months and a monthly interval.
+   */
+  async getRevenueStatistics(filters = {}) {
+    if (filters.interval !== void 0 && !INTERVALS.includes(filters.interval)) {
+      throw new TaxoraException(
+        `Invalid statistics interval "${String(filters.interval)}". Expected one of: ${INTERVALS.join(", ")}.`
+      );
+    }
+    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.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);
+    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);
+  }
+  /**
+   * The canonical VAT rates & DGFiP tax categories for a reporting country
+   * (the seller's reporting-country rates, not the counterparty's). Falls back
+   * to the configured default country (FR) when none/unknown is given.
+   */
+  async getVatRates(country) {
+    const params = new URLSearchParams();
+    if (country !== void 0) params.set("country", country);
+    const queryString = params.toString();
+    const url = `${this.baseUrl}/compliance/vat-rates${queryString ? `?${queryString}` : ""}`;
+    const response = await this.sendRequest("GET", url);
+    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) {
+    const params = new URLSearchParams();
+    params.set("page", String(page));
+    params.set("per_page", String(perPage));
+    if (state !== void 0) params.set("state", state);
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/tax-reports?${params.toString()}`);
+    return ComplianceTaxReportPage.fromResponse(await this.parseJsonResponse(response));
+  }
+  /** Get a single tax report by id. */
+  async getTaxReport(id) {
+    this.validateId(id, "id");
+    const response = await this.sendRequest("GET", `${this.baseUrl}/compliance/tax-reports/${id}`);
+    const data = await this.parseJsonResponse(response);
+    return ComplianceTaxReport.fromArray(data);
+  }
+  /**
+   * Request activation of the E-Reporting feature for the account. This route
+   * is deliberately NOT gated by compliance access — it exists precisely for
+   * accounts that do not have the feature yet. The authenticated user's
+   * name/email take precedence over the form values server-side.
+   *
+   * Note: unlike the other compliance routes, validation failures here are
+   * returned as HTTP 400 (surfaced as HttpException), not 422.
+   */
+  async requestEReportingAccess(input = {}) {
+    const body = {};
+    if (input.name !== void 0) body["name"] = input.name;
+    if (input.email !== void 0) body["email"] = input.email;
+    if (input.company !== void 0) body["company"] = input.company;
+    if (input.phone !== void 0) body["phone"] = input.phone;
+    if (input.message !== void 0) body["message"] = input.message;
+    if (input.language !== void 0) body["language"] = input.language;
+    const response = await this.sendRequest("POST", `${this.baseUrl}/compliance/e-reporting-request`, body);
+    await this.parseJsonResponse(response);
+  }
+  // ---------------------------------------------------------------------
+  // Input validation (fail fast, before any request is sent)
+  // ---------------------------------------------------------------------
+  validateEnrollmentInput(input) {
+    if (input.siret === void 0 && input.siren === void 0) {
+      throw new TaxoraException("Either siret or siren is required.");
+    }
+    if (input.siret !== void 0 && input.siret.length !== 14) {
+      throw new TaxoraException("siret must be exactly 14 characters.");
+    }
+    if (input.siren !== void 0 && input.siren.length !== 9) {
+      throw new TaxoraException("siren must be exactly 9 characters.");
+    }
+    if (input.email.trim() === "" || !input.email.includes("@")) {
+      throw new TaxoraException("email must be a valid email address.");
+    }
+    if (!NAF_CODE_REGEX.test(input.nafCode)) {
+      throw new TaxoraException('nafCode must be exactly 2 digits, e.g. "47".');
+    }
+    if (!ENTERPRISE_SIZES.includes(input.enterpriseSize)) {
+      throw new TaxoraException(
+        `Invalid enterpriseSize "${String(input.enterpriseSize)}". Expected one of: ${ENTERPRISE_SIZES.join(", ")}.`
+      );
+    }
+    if (!TYPE_OPERATIONS.includes(input.typeOperation)) {
+      throw new TaxoraException(
+        `Invalid typeOperation "${String(input.typeOperation)}". Expected one of: ${TYPE_OPERATIONS.join(", ")}.`
+      );
+    }
+    if (input.country !== void 0 && input.country.length !== 2) {
+      throw new TaxoraException("country must be a 2-character ISO 3166-1 alpha-2 code.");
+    }
+  }
+  validateId(id, name) {
+    if (!Number.isInteger(id) || id <= 0) {
+      throw new TaxoraException(`${name} must be a positive integer.`);
+    }
+  }
+  validateTransactionType(type) {
+    if (!TRANSACTION_TYPES.includes(type)) {
+      throw new TaxoraException(
+        `Invalid transactionType "${String(type)}". Expected one of: ${TRANSACTION_TYPES.join(", ")}.`
+      );
+    }
+  }
+  validateInvoiceNumber(invoiceNumber) {
+    if (invoiceNumber.trim() === "") {
+      throw new TaxoraException("invoiceNumber must not be empty.");
+    }
+    if (invoiceNumber.length > 50) {
+      throw new TaxoraException("invoiceNumber must not exceed 50 characters.");
+    }
+  }
+  validateInvoiceLines(lines) {
+    if (lines.length === 0) {
+      throw new TaxoraException("invoiceLines must contain at least one line.");
+    }
+    lines.forEach((line, index) => {
+      if (line.taxes.length === 0) {
+        throw new TaxoraException(`invoiceLines[${index}].taxes must contain at least one tax.`);
+      }
+    });
+  }
+  validateOptionalCodes(input) {
+    if (input.currency !== void 0 && input.currency.length !== 3) {
+      throw new TaxoraException("currency must be a 3-character ISO 4217 code.");
+    }
+    if (input.counterpartyCountry !== void 0 && input.counterpartyCountry.length !== 2) {
+      throw new TaxoraException("counterpartyCountry must be a 2-character ISO 3166-1 alpha-2 code.");
+    }
+  }
+  // ---------------------------------------------------------------------
+  // Body building (camelCase input → snake_case wire format)
+  // ---------------------------------------------------------------------
+  buildInvoiceLines(lines) {
+    return lines.map((line) => {
+      const built = {
+        description: line.description,
+        quantity: line.quantity,
+        price: line.price,
+        taxes_attributes: line.taxes.map((tax) => {
+          const taxBuilt = {
+            name: tax.name,
+            percent: tax.percent,
+            category: tax.category
+          };
+          if (tax.comment !== void 0) taxBuilt["comment"] = tax.comment;
+          return taxBuilt;
+        })
+      };
+      if (line.unit !== void 0) built["unit"] = line.unit;
+      return built;
+    });
+  }
+  /** Applies the optional scalar fields shared by create and update. */
+  applyOptionalTransactionFields(body, input) {
+    if (input.dueDate !== void 0) body["due_date"] = this.formatDate(input.dueDate);
+    if (input.currency !== void 0) body["currency"] = input.currency;
+    if (input.taxAmount !== void 0) body["tax_amount"] = input.taxAmount;
+    if (input.counterpartyName !== void 0) body["counterparty_name"] = input.counterpartyName;
+    if (input.counterpartyCountry !== void 0) body["counterparty_country"] = input.counterpartyCountry;
+    if (input.counterpartyVatNumber !== void 0) body["counterparty_vat_number"] = input.counterpartyVatNumber;
+    if (input.providerContactId !== void 0) body["provider_contact_id"] = input.providerContactId;
+    if (input.paymentMethod !== void 0) body["payment_method"] = input.paymentMethod;
+    if (input.remittanceInformation !== void 0) body["remittance_information"] = input.remittanceInformation;
+    if (input.paymentMethodText !== void 0) body["payment_method_text"] = input.paymentMethodText;
+    if (input.paymentTerms !== void 0) body["payment_terms"] = input.paymentTerms;
+  }
+  // ---------------------------------------------------------------------
+  // HTTP plumbing (kept in sync with SmartEnrichmentEndpoint)
+  // ---------------------------------------------------------------------
+  buildHeaders(withJsonContentType = true) {
+    const headers = {
+      "x-api-key": this.apiKey
+    };
+    if (withJsonContentType) {
+      headers["Content-Type"] = "application/json";
+    }
+    const token = this.tokenStorage.get();
+    if (token) {
+      headers["Authorization"] = `Bearer ${token.accessToken}`;
+    }
+    return headers;
+  }
+  async sendRequest(method, url, body) {
+    const options = { headers: this.buildHeaders() };
+    if (body) options.body = JSON.stringify(body);
+    return this.httpClient.request(method, url, options);
+  }
+  /** 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 });
+  }
+  /** Accepts any 2xx response (e.g. 201 on create, 200 on idempotent replay). */
+  async parseJsonResponse(response) {
+    const responseText = await response.text();
+    if (response.status === 422) {
+      throw this.buildValidationException(responseText);
+    }
+    if (!response.ok) {
+      throw new HttpException(`HTTP error ${response.status}`, response.status, responseText);
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(responseText);
+    } catch {
+      throw new HttpException("Invalid JSON response", 0, responseText);
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+      throw new HttpException("Unexpected response format", 0, responseText);
+    }
+    const obj = parsed;
+    if (obj["data"] !== void 0 && typeof obj["data"] === "object" && obj["data"] !== null) {
+      return obj["data"];
+    }
+    return obj;
+  }
+  /** For the 204 delete: keeps the shared 422/HTTP error mapping but never parses a body. */
+  async assertNoContentResponse(response) {
+    if (response.status === 204) {
+      return;
+    }
+    const responseText = await response.text();
+    if (response.status === 422) {
+      throw this.buildValidationException(responseText);
+    }
+    if (!response.ok) {
+      throw new HttpException(`HTTP error ${response.status}`, response.status, responseText);
+    }
+  }
+  /**
+   * The backend emits two 422 shapes: Laravel FormRequest failures as
+   * `{message, errors: {field: [...]}}` and state-guard errors via returnError()
+   * as `{error: "reason"}`. Preserve the reason in both cases.
+   */
+  buildValidationException(responseText) {
+    let message = "Validation failed";
+    let errors = {};
+    try {
+      const parsed = JSON.parse(responseText);
+      if (parsed["errors"] !== null && typeof parsed["errors"] === "object" && !Array.isArray(parsed["errors"])) {
+        errors = parsed["errors"];
+      }
+      if (typeof parsed["message"] === "string" && parsed["message"] !== "") {
+        message = parsed["message"];
+      } else if (typeof parsed["error"] === "string" && parsed["error"] !== "") {
+        message = parsed["error"];
+      }
+    } catch {
+    }
+    return new ValidationException(message, errors, { responseBody: responseText });
+  }
+  /**
+   * Date objects are serialized from their LOCAL date parts — construct them as
+   * `new Date('2026-09-01T00:00:00')` (local midnight); a bare `new Date('2026-09-01')`
+   * is UTC midnight and shifts a day back in UTC-negative timezones.
+   */
+  formatDate(date) {
+    if (date instanceof Date) {
+      const year = date.getFullYear();
+      const month = String(date.getMonth() + 1).padStart(2, "0");
+      const day = String(date.getDate()).padStart(2, "0");
+      return `${year}-${month}-${day}`;
+    }
+    if (!DATE_REGEX.test(date)) {
+      throw new TaxoraException(`Invalid date format: "${date}". Expected YYYY-MM-DD.`);
+    }
+    return date;
+  }
+};
+
+// src/enums/SmartEnrichmentStatus.ts
+var SmartEnrichmentStatus = {
+  FOUND: "found",
+  NO_VAT_EXISTS: "no_vat_exists",
+  NOT_FOUND: "not_found",
+  PROCESSING: "processing",
+  QUEUED: "queued",
+  COMPLETED: "completed",
+  FAILED: "failed",
+  UNKNOWN: "unknown"
+};
+var VALUES5 = Object.values(SmartEnrichmentStatus);
+function toSmartEnrichmentStatus(value) {
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (VALUES5.includes(normalized)) {
+      return normalized;
+    }
+  }
+  return SmartEnrichmentStatus.UNKNOWN;
+}
+var DESCRIPTIONS5 = {
+  [SmartEnrichmentStatus.FOUND]: "A VAT number was resolved and confirmed.",
+  [SmartEnrichmentStatus.NO_VAT_EXISTS]: "The company was identified but has no VAT number.",
+  [SmartEnrichmentStatus.NOT_FOUND]: "No sufficiently-confident match could be resolved.",
+  [SmartEnrichmentStatus.PROCESSING]: "The lookup is still being processed.",
+  [SmartEnrichmentStatus.QUEUED]: "The job is queued.",
+  [SmartEnrichmentStatus.COMPLETED]: "The job has completed.",
+  [SmartEnrichmentStatus.FAILED]: "The job failed.",
+  [SmartEnrichmentStatus.UNKNOWN]: "Unknown status."
+};
+function describeSmartEnrichmentStatus(status) {
+  return DESCRIPTIONS5[status];
+}
+
+// src/dto/SmartEnrichmentResource.ts
+var SmartEnrichmentResource = class _SmartEnrichmentResource {
+  constructor(status, vatNumber, vatType, confidence, matchedCompanyName, matchedAddress, country, source) {
+    this.status = status;
+    this.vatNumber = vatNumber;
+    this.vatType = vatType;
+    this.confidence = confidence;
+    this.matchedCompanyName = matchedCompanyName;
+    this.matchedAddress = matchedAddress;
+    this.country = country;
+    this.source = source;
+  }
+  status;
+  vatNumber;
+  vatType;
+  confidence;
+  matchedCompanyName;
+  matchedAddress;
+  country;
+  source;
+  static fromArray(data) {
+    const str = (key) => {
+      const v = data[key];
+      return typeof v === "string" ? v : void 0;
+    };
+    const num = (key) => {
+      const v = data[key];
+      return typeof v === "number" ? v : void 0;
+    };
+    return new _SmartEnrichmentResource(
+      toSmartEnrichmentStatus(data["status"]),
+      str("vatNumber"),
+      str("vatType"),
+      num("confidence"),
+      str("matchedCompanyName"),
+      str("matchedAddress"),
+      str("country"),
+      str("source")
+    );
+  }
+  toArray() {
+    return {
+      status: this.status,
+      vatNumber: this.vatNumber ?? null,
+      vatType: this.vatType ?? null,
+      confidence: this.confidence ?? null,
+      matchedCompanyName: this.matchedCompanyName ?? null,
+      matchedAddress: this.matchedAddress ?? null,
+      country: this.country ?? null,
+      source: this.source ?? null
+    };
+  }
+};
+
+// src/dto/SmartEnrichmentJob.ts
+var SmartEnrichmentJob = class _SmartEnrichmentJob {
+  constructor(jobId, status, itemCount, completedCount, foundCount, results) {
+    this.jobId = jobId;
+    this.status = status;
+    this.itemCount = itemCount;
+    this.completedCount = completedCount;
+    this.foundCount = foundCount;
+    this.results = results;
+  }
+  jobId;
+  status;
+  itemCount;
+  completedCount;
+  foundCount;
+  results;
+  static fromArray(data) {
+    const num = (key) => {
+      const v = data[key];
+      return typeof v === "number" ? v : void 0;
+    };
+    let results = [];
+    if (Array.isArray(data["results"])) {
+      results = data["results"].filter((row) => typeof row === "object" && row !== null).map(SmartEnrichmentResource.fromArray);
+    } else if (data["vatNumber"] !== void 0 || _SmartEnrichmentJob.looksLikeItem(data["status"])) {
+      results = [SmartEnrichmentResource.fromArray(data)];
+    }
+    return new _SmartEnrichmentJob(
+      typeof data["jobId"] === "string" ? data["jobId"] : "",
+      toSmartEnrichmentStatus(data["status"]),
+      num("itemCount"),
+      num("completedCount"),
+      num("foundCount"),
+      results
+    );
+  }
+  isProcessing() {
+    return this.status === SmartEnrichmentStatus.PROCESSING || this.status === SmartEnrichmentStatus.QUEUED;
+  }
+  /** Convenience for single lookups: the first (or only) result, if any. */
+  result() {
+    return this.results[0];
+  }
+  static looksLikeItem(status) {
+    const s = toSmartEnrichmentStatus(status);
+    return s === SmartEnrichmentStatus.FOUND || s === SmartEnrichmentStatus.NO_VAT_EXISTS || s === SmartEnrichmentStatus.NOT_FOUND;
+  }
+};
+
+// src/dto/SmartEnrichmentHistoryRow.ts
+var SmartEnrichmentHistoryRow = class _SmartEnrichmentHistoryRow {
+  constructor(jobId, status, isBulk, itemCount, foundCount, queryCompanyName, queryCountry, queryCity, input, result, createdAt, finishedAt) {
+    this.jobId = jobId;
+    this.status = status;
+    this.isBulk = isBulk;
+    this.itemCount = itemCount;
+    this.foundCount = foundCount;
+    this.queryCompanyName = queryCompanyName;
+    this.queryCountry = queryCountry;
+    this.queryCity = queryCity;
+    this.input = input;
+    this.result = result;
+    this.createdAt = createdAt;
+    this.finishedAt = finishedAt;
+  }
+  jobId;
+  status;
+  isBulk;
+  itemCount;
+  foundCount;
+  queryCompanyName;
+  queryCountry;
+  queryCity;
+  input;
+  result;
+  createdAt;
+  finishedAt;
+  static fromArray(data) {
+    const str = (value) => typeof value === "string" ? value : void 0;
+    const query = data["query"] !== null && typeof data["query"] === "object" && !Array.isArray(data["query"]) ? data["query"] : {};
+    const inputRaw = data["input"] !== null && typeof data["input"] === "object" && !Array.isArray(data["input"]) ? data["input"] : void 0;
+    const input = inputRaw ? {
+      companyName: str(inputRaw["companyName"]),
+      street: str(inputRaw["street"]),
+      postalCode: str(inputRaw["postalCode"]),
+      city: str(inputRaw["city"]),
+      country: str(inputRaw["country"])
+    } : void 0;
+    const result = data["result"] !== null && typeof data["result"] === "object" && !Array.isArray(data["result"]) ? SmartEnrichmentResource.fromArray(data["result"]) : void 0;
+    return new _SmartEnrichmentHistoryRow(
+      str(data["jobId"]) ?? "",
+      toSmartEnrichmentStatus(data["status"]),
+      data["isBulk"] === true,
+      typeof data["itemCount"] === "number" ? data["itemCount"] : 0,
+      typeof data["foundCount"] === "number" ? data["foundCount"] : 0,
+      str(query["companyName"]),
+      str(query["country"]),
+      str(query["city"]),
+      input,
+      result,
+      str(data["createdAt"]),
+      str(data["finishedAt"])
+    );
+  }
+};
+
+// src/dto/SmartEnrichmentHistoryPage.ts
+var SmartEnrichmentHistoryPage = class _SmartEnrichmentHistoryPage {
+  constructor(rows, currentPage, perPage, total, lastPage, stats) {
+    this.rows = rows;
+    this.currentPage = currentPage;
+    this.perPage = perPage;
+    this.total = total;
+    this.lastPage = lastPage;
+    this.stats = stats;
+  }
+  rows;
+  currentPage;
+  perPage;
+  total;
+  lastPage;
+  stats;
+  static fromResponse(payload) {
+    const obj = payload !== null && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+    const rows = Array.isArray(obj["data"]) ? obj["data"].filter((row) => typeof row === "object" && row !== null).map(SmartEnrichmentHistoryRow.fromArray) : [];
+    const meta = obj["meta"] !== null && typeof obj["meta"] === "object" && !Array.isArray(obj["meta"]) ? obj["meta"] : {};
+    const num = (value, fallback) => typeof value === "number" ? value : fallback;
+    const statsRaw = obj["stats"] !== null && typeof obj["stats"] === "object" && !Array.isArray(obj["stats"]) ? obj["stats"] : void 0;
+    const stats = statsRaw ? { total: num(statsRaw["total"], 0), found: num(statsRaw["found"], 0) } : void 0;
+    return new _SmartEnrichmentHistoryPage(
+      rows,
+      num(meta["currentPage"], 1),
+      num(meta["perPage"], rows.length),
+      num(meta["total"], rows.length),
+      num(meta["lastPage"], 1),
+      stats
+    );
+  }
+  [Symbol.iterator]() {
+    return this.rows[Symbol.iterator]();
+  }
+  get length() {
+    return this.rows.length;
+  }
+};
+
+// src/dto/SmartEnrichmentStatistics.ts
+function asString7(value, fallback = "") {
+  return typeof value === "string" ? value : fallback;
+}
+function asNumber6(value) {
+  return typeof value === "number" ? value : Number(value ?? 0) || 0;
+}
+function asRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function asRecords2(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter((row) => typeof row === "object" && row !== null);
+}
+var SmartEnrichmentStatistics = class _SmartEnrichmentStatistics {
+  constructor(range, totals, timeSeries, bySource, byOutcome, confidenceBuckets) {
+    this.range = range;
+    this.totals = totals;
+    this.timeSeries = timeSeries;
+    this.bySource = bySource;
+    this.byOutcome = byOutcome;
+    this.confidenceBuckets = confidenceBuckets;
+  }
+  range;
+  totals;
+  timeSeries;
+  bySource;
+  byOutcome;
+  confidenceBuckets;
+  static fromArray(data) {
+    const range = asRecord(data["range"]);
+    const totals = asRecord(data["totals"]);
+    const timeSeries = asRecords2(data["time_series"]).map((row) => ({
+      bucket: asString7(row["bucket"]),
+      jobs: asNumber6(row["jobs"]),
+      items: asNumber6(row["items"]),
+      found: asNumber6(row["found"])
+    }));
+    const bySource = asRecords2(data["by_source"]).map((row) => ({
+      source: asString7(row["source"]),
+      jobs: asNumber6(row["jobs"]),
+      found: asNumber6(row["found"])
+    }));
+    const byOutcome = asRecords2(data["by_outcome"]).map((row) => ({
+      outcome: asString7(row["outcome"]),
+      count: asNumber6(row["count"])
+    }));
+    const confidenceBuckets = asRecords2(data["confidence_buckets"]).map((row) => ({
+      bucket: asString7(row["bucket"]),
+      count: asNumber6(row["count"])
+    }));
+    return new _SmartEnrichmentStatistics(
+      {
+        dateFrom: asString7(range["date_from"]),
+        dateTo: asString7(range["date_to"]),
+        interval: asString7(range["interval"])
+      },
+      {
+        jobs: asNumber6(totals["jobs"]),
+        items: asNumber6(totals["items"]),
+        found: asNumber6(totals["found"]),
+        foundRate: asNumber6(totals["found_rate"]),
+        avgConfidence: asNumber6(totals["avg_confidence"])
+      },
+      timeSeries,
+      bySource,
+      byOutcome,
+      confidenceBuckets
+    );
+  }
+};
+
+// src/endpoints/SmartEnrichmentEndpoint.ts
+var STATISTICS_INTERVALS = ["day", "week", "month"];
+var DEFAULT_POLL_INTERVAL_MS = 2e3;
+var DEFAULT_POLL_TIMEOUT_MS = 12e4;
+var SmartEnrichmentEndpoint = class {
+  constructor(baseUrl, apiKey, tokenStorage, httpClient) {
+    this.baseUrl = baseUrl;
+    this.apiKey = apiKey;
+    this.tokenStorage = tokenStorage;
+    this.httpClient = httpClient;
+  }
+  baseUrl;
+  apiKey;
+  tokenStorage;
+  httpClient;
+  /**
+   * Single reverse lookup. Returns a confident result synchronously, or a `processing`
+   * job (poll with get(job.jobId) or waitForCompletion(job.jobId)) when deeper resolution
+   * is needed.
+   */
+  async lookup(input) {
+    this.validateInput(input);
+    const body = {
+      companyName: input.companyName,
+      country: input.country
+    };
+    if (input.street !== void 0) body["street"] = input.street;
+    if (input.postalCode !== void 0) body["postalCode"] = input.postalCode;
+    if (input.city !== void 0) body["city"] = input.city;
+    const response = await this.sendRequest("POST", `${this.baseUrl}/smart-enrichment`, body);
+    const data = await this.parseJsonResponse(response, [200, 202]);
+    return SmartEnrichmentJob.fromArray(data);
+  }
+  /**
+   * Bulk batch — always async. Returns a `processing` job; results arrive via the
+   * `enrichment.completed` webhook and are retrievable via get(job.jobId).
+   */
+  async bulkLookup(items) {
+    if (items.length === 0) {
+      throw new TaxoraException("bulkLookup requires at least one item.");
+    }
+    items.forEach((item, index) => this.validateInput(item, `items[${index}]`));
+    const response = await this.sendRequest("POST", `${this.baseUrl}/smart-enrichment/bulk`, { items });
+    const data = await this.parseJsonResponse(response, [200, 202]);
+    return SmartEnrichmentJob.fromArray(data);
+  }
+  /** Poll a job (single or bulk) by its id. */
+  async get(jobId) {
+    this.validateJobId(jobId);
+    const response = await this.sendRequest("GET", `${this.baseUrl}/smart-enrichment/${encodeURIComponent(jobId)}`);
+    const data = await this.parseJsonResponse(response);
+    return SmartEnrichmentJob.fromArray(data);
+  }
+  /**
+   * Poll get(jobId) until the job is no longer processing (completed, failed or resolved).
+   * Throws a TaxoraException when the job does not finish within `timeoutMs`.
+   */
+  async waitForCompletion(jobId, options = {}) {
+    this.validateJobId(jobId);
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;
+    if (!Number.isFinite(pollIntervalMs) || pollIntervalMs <= 0) {
+      throw new TaxoraException("pollIntervalMs must be greater than 0.");
+    }
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+      throw new TaxoraException("timeoutMs must be greater than 0.");
+    }
+    const deadline = Date.now() + timeoutMs;
+    for (; ; ) {
+      const job = await this.get(jobId);
+      if (!job.isProcessing()) {
+        return job;
+      }
+      if (Date.now() + pollIntervalMs > deadline) {
+        throw new TaxoraException(`Smart Enrichment job "${jobId}" did not complete within ${timeoutMs}ms.`, {
+          jobId,
+          timeoutMs
+        });
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+  }
+  /**
+   * Paginated lookup history (newest first). `perPage` is capped at 100 server-side.
+   * `search` filters (free-text) over the queried company name and the resolved
+   * VAT number / matched company name.
+   */
+  async history(page = 1, perPage = 25, search) {
+    const params = new URLSearchParams();
+    params.set("page", String(page));
+    params.set("perPage", String(perPage));
+    if (search !== void 0) params.set("search", search);
+    const response = await this.sendRequest("GET", `${this.baseUrl}/smart-enrichment/history?${params.toString()}`);
+    return SmartEnrichmentHistoryPage.fromResponse(await this.parseRawJson(response));
+  }
+  /** Current billing-period quota usage, plus recent monthly billing entries. */
+  async usage() {
+    const response = await this.sendRequest("GET", `${this.baseUrl}/smart-enrichment/usage`);
+    const data = await this.parseJsonResponse(response);
+    return {
+      period: typeof data["period"] === "string" ? data["period"] : "",
+      used: typeof data["used"] === "number" ? data["used"] : 0,
+      included: typeof data["included"] === "number" ? data["included"] : 0,
+      remaining: typeof data["remaining"] === "number" ? data["remaining"] : 0,
+      overageCount: typeof data["overageCount"] === "number" ? data["overageCount"] : 0,
+      overagePrice: typeof data["overagePrice"] === "number" ? data["overagePrice"] : 0,
+      overageAmount: typeof data["overageAmount"] === "number" ? data["overageAmount"] : 0,
+      hardCap: typeof data["hardCap"] === "number" ? data["hardCap"] : null,
+      history: this.parseUsageHistory(data["history"])
+    };
+  }
+  /**
+   * Export the company's lookups as CSV (bulk-input shape plus the resolved VAT columns;
+   * bulk jobs are flattened to one line per input row). Returns the raw CSV text
+   * (UTF-8, BOM included by the API so Excel opens umlauts correctly).
+   */
+  async export(options = {}) {
+    const params = new URLSearchParams();
+    if (options.dateFrom !== void 0) params.set("date_from", options.dateFrom);
+    if (options.dateTo !== void 0) params.set("date_to", options.dateTo);
+    if (options.minConfidence !== void 0) params.set("min_confidence", String(options.minConfidence));
+    for (const status of options.status ?? []) {
+      params.append("status[]", status);
+    }
+    if (options.onlyFound !== void 0) params.set("only_found", options.onlyFound ? "1" : "0");
+    const queryString = params.toString();
+    const url = `${this.baseUrl}/smart-enrichment/export${queryString ? `?${queryString}` : ""}`;
+    const response = await this.sendRequest("GET", url);
+    return this.parseCsvResponse(response);
+  }
+  /**
+   * Aggregated lookup statistics: headline totals, a time series and breakdowns by
+   * source, outcome and confidence band. The API defaults to the last 12 months
+   * and a monthly interval.
+   */
+  async statistics(options = {}) {
+    if (options.interval !== void 0 && !STATISTICS_INTERVALS.includes(options.interval)) {
+      throw new TaxoraException(
+        `Invalid statistics interval "${String(options.interval)}". Expected one of: ${STATISTICS_INTERVALS.join(", ")}.`
+      );
+    }
+    const params = new URLSearchParams();
+    if (options.dateFrom !== void 0) params.set("date_from", options.dateFrom);
+    if (options.dateTo !== void 0) params.set("date_to", options.dateTo);
+    if (options.interval !== void 0) params.set("interval", options.interval);
+    const queryString = params.toString();
+    const url = `${this.baseUrl}/smart-enrichment/statistics${queryString ? `?${queryString}` : ""}`;
+    const response = await this.sendRequest("GET", url);
+    return SmartEnrichmentStatistics.fromArray(await this.parseRawJson(response));
+  }
+  // ---------------------------------------------------------------------
+  // Input validation (fail fast, before any request is sent)
+  // ---------------------------------------------------------------------
+  validateInput(input, context) {
+    const where = context ? ` (${context})` : "";
+    if (input.companyName.trim() === "") {
+      throw new TaxoraException(`companyName must not be empty${where}.`);
+    }
+    if (input.country.length !== 2) {
+      throw new TaxoraException(`country must be a 2-character ISO 3166-1 alpha-2 code${where}.`);
+    }
+  }
+  validateJobId(jobId) {
+    if (jobId.trim() === "") {
+      throw new TaxoraException("jobId must not be empty.");
+    }
+  }
+  // ---------------------------------------------------------------------
+  // HTTP plumbing (kept in sync with VatEndpoint)
+  // ---------------------------------------------------------------------
+  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;
+  }
+  async sendRequest(method, url, body) {
+    const options = { headers: this.buildHeaders() };
+    if (body) options.body = JSON.stringify(body);
+    return this.httpClient.request(method, url, options);
+  }
+  async parseJsonResponse(response, acceptedStatuses = [200]) {
+    const responseText = await response.text();
+    if (response.status === 422) {
+      throw new ValidationException("Validation failed", this.parseValidationErrors(responseText));
+    }
+    if (!response.ok && !acceptedStatuses.includes(response.status)) {
+      throw new HttpException(`HTTP error ${response.status}`, response.status, responseText);
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(responseText);
+    } catch {
+      throw new HttpException("Invalid JSON response", 0, responseText);
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+      throw new HttpException("Unexpected response format", 0, responseText);
+    }
+    const obj = parsed;
+    if (obj["data"] !== void 0 && (typeof obj["data"] === "object" || Array.isArray(obj["data"]))) {
+      return obj["data"];
+    }
+    return obj;
+  }
+  /**
+   * Like parseJsonResponse but returns the whole object WITHOUT unwrapping `data` — used for
+   * the paginated history response (where `data` is the row array and `meta`/`stats` must be
+   * preserved) and the statistics response.
+   */
+  async parseRawJson(response) {
+    const responseText = await response.text();
+    if (response.status === 422) {
+      throw new ValidationException("Validation failed", this.parseValidationErrors(responseText));
+    }
+    if (!response.ok) {
+      throw new HttpException(`HTTP error ${response.status}`, response.status, responseText);
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(responseText);
+    } catch {
+      throw new HttpException("Invalid JSON response", 0, responseText);
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+      throw new HttpException("Unexpected response format", 0, responseText);
+    }
+    return parsed;
+  }
+  /**
+   * For the CSV export: keeps the shared 422/HTTP error mapping but returns the body
+   * verbatim (text/csv) instead of parsing JSON.
+   */
+  async parseCsvResponse(response) {
+    const responseText = await response.text();
+    if (response.status === 422) {
+      throw new ValidationException("Validation failed", this.parseValidationErrors(responseText));
+    }
+    if (!response.ok) {
+      throw new HttpException(`HTTP error ${response.status}`, response.status, responseText);
+    }
+    return responseText;
+  }
+  parseValidationErrors(responseText) {
+    try {
+      const parsed = JSON.parse(responseText);
+      if (parsed["errors"] !== null && typeof parsed["errors"] === "object" && !Array.isArray(parsed["errors"])) {
+        return parsed["errors"];
+      }
+    } catch {
+    }
+    return {};
+  }
+  parseUsageHistory(value) {
+    if (!Array.isArray(value)) return [];
+    return value.filter((row) => typeof row === "object" && row !== null).map((row) => ({
+      period: typeof row["period"] === "string" ? row["period"] : "",
+      matches: typeof row["matches"] === "number" ? row["matches"] : 0,
+      amount: typeof row["amount"] === "string" ? row["amount"] : "0.00",
+      state: row["state"] === "billed" ? "billed" : "pending",
+      billingType: typeof row["billingType"] === "string" ? row["billingType"] : null,
+      manualReference: typeof row["manualReference"] === "string" ? row["manualReference"] : null
+    }));
+  }
+};
+
 // src/enums/VatState.ts
 var VatState = {
   VALID: "valid",
@@ -287,14 +2092,14 @@ var VatState = {
 function getFailedVatStates() {
   return [VatState.INVALID, VatState.FRAUD];
 }
-var DESCRIPTIONS = {
+var DESCRIPTIONS6 = {
   [VatState.VALID]: "The VAT number is valid and active.",
   [VatState.INVALID]: "The VAT number is invalid or not registered.",
   [VatState.FRAUD]: "The VAT number has been flagged as potentially fraudulent.",
   [VatState.UNKNOWN]: "The VAT number state could not be determined."
 };
 function describeVatState(state) {
-  return DESCRIPTIONS[state];
+  return DESCRIPTIONS6[state];
 }
 
 // src/dto/CompanyAddress.ts
@@ -501,7 +2306,7 @@ var ProviderDocument = class _ProviderDocument {
 
 // src/dto/VatResource.ts
 var VatResource = class _VatResource {
-  constructor(uuid, vatUid, state, countryCode, companyName, companyAddress, requestedCompanyName, requestedCompanyNameOriginal, requestedInputAddress, checkedAt, score, scoreSource, scoreAttempts, breakdown, environment, provider, usedProviders, providerVatState, providerNote, providerLastCheckedAt, hasApiError, errorMessage, nextApiRecheckAt, providerDocument) {
+  constructor(uuid, vatUid, state, countryCode, companyName, companyAddress, requestedCompanyName, requestedCompanyNameOriginal, requestedInputAddress, checkedAt, score, scoreSource, scoreAttempts, breakdown, environment, provider, usedProviders, providerValid, providerVatState, providerNote, providerLastCheckedAt, hasApiError, errorMessage, nextApiRecheckAt, providerDocument) {
     this.uuid = uuid;
     this.vatUid = vatUid;
     this.state = state;
@@ -519,6 +2324,7 @@ var VatResource = class _VatResource {
     this.environment = environment;
     this.provider = provider;
     this.usedProviders = usedProviders;
+    this.providerValid = providerValid;
     this.providerVatState = providerVatState;
     this.providerNote = providerNote;
     this.providerLastCheckedAt = providerLastCheckedAt;
@@ -544,6 +2350,7 @@ var VatResource = class _VatResource {
   environment;
   provider;
   usedProviders;
+  providerValid;
   providerVatState;
   providerNote;
   providerLastCheckedAt;
@@ -563,6 +2370,7 @@ var VatResource = class _VatResource {
     const hasApiError = data["has_api_error"] === null ? null : typeof data["has_api_error"] === "boolean" ? data["has_api_error"] : void 0;
     const errorMessage = data["error_message"] === null ? null : typeof data["error_message"] === "string" ? data["error_message"] : void 0;
     const nextApiRecheckAt = data["next_api_recheck_at"] === null ? null : typeof data["next_api_recheck_at"] === "string" ? data["next_api_recheck_at"] : void 0;
+    const providerValid = data["provider_valid"] === null ? null : typeof data["provider_valid"] === "boolean" ? data["provider_valid"] : void 0;
     const breakdown = Array.isArray(data["breakdown"]) ? data["breakdown"].map(ScoreBreakdown.fromArray) : void 0;
     const usedProviders = Array.isArray(data["used_providers"]) ? data["used_providers"].filter((v) => typeof v === "string") : void 0;
     const scoreAttempts = Array.isArray(data["score_attempts"]) ? data["score_attempts"] : void 0;
@@ -585,6 +2393,7 @@ var VatResource = class _VatResource {
       str("environment"),
       str("provider"),
       usedProviders,
+      providerValid,
       str("provider_vat_state"),
       str("provider_note"),
       providerLastCheckedAt,
@@ -601,6 +2410,18 @@ var VatResource = class _VatResource {
     }
     return `https://app.sandbox.taxora.io/vat/history/${this.uuid}`;
   }
+  isValid(useProviderState = false) {
+    if (useProviderState) {
+      return this.isProviderValid();
+    }
+    return this.state === VatState.VALID;
+  }
+  isProviderValid() {
+    if (this.providerValid !== void 0 && this.providerValid !== null) {
+      return this.providerValid;
+    }
+    return this.providerVatState === VatState.VALID;
+  }
   toArray() {
     return {
       uuid: this.uuid,
@@ -620,6 +2441,7 @@ var VatResource = class _VatResource {
       environment: this.environment ?? null,
       provider: this.provider ?? null,
       used_providers: this.usedProviders ?? null,
+      provider_valid: this.providerValid ?? null,
       provider_vat_state: this.providerVatState ?? null,
       provider_note: this.providerNote ?? null,
       provider_last_checked_at: this.providerLastCheckedAt?.toISOString() ?? null,
@@ -739,23 +2561,8 @@ var VatValidationAddressInput = class _VatValidationAddressInput {
   }
 };
 
-// src/exceptions/ValidationException.ts
-var ValidationException = class extends TaxoraException {
-  statusCode = 422;
-  errors;
-  constructor(message, errors, context = {}) {
-    super(message, context);
-    this.name = "ValidationException";
-    this.errors = errors;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-  getErrors() {
-    return this.errors;
-  }
-};
-
 // src/endpoints/VatEndpoint.ts
-var DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+var DATE_REGEX2 = /^\d{4}-\d{2}-\d{2}$/;
 var VatEndpoint = class {
   constructor(baseUrl, apiKey, tokenStorage, httpClient) {
     this.baseUrl = baseUrl;
@@ -920,7 +2727,7 @@ var VatEndpoint = class {
       const day = String(date.getDate()).padStart(2, "0");
       return `${year}-${month}-${day}`;
     }
-    if (!DATE_REGEX.test(date)) {
+    if (!DATE_REGEX2.test(date)) {
       throw new TaxoraException(`Invalid date format: "${date}". Expected YYYY-MM-DD.`);
     }
     return date;
@@ -1003,21 +2810,47 @@ var AuthRetryHttpClient = class {
   }
 };
 
+// src/version.ts
+var SDK_VERSION = "1.1.0";
+
+// src/http/SdkVersionHttpClient.ts
+var SDK_VERSION_HEADER = "X-Taxora-SDK-Version";
+var SDK_VERSION_VALUE = `taxora-node/${SDK_VERSION}`;
+var SdkVersionHttpClient = class {
+  constructor(inner) {
+    this.inner = inner;
+  }
+  inner;
+  async request(method, url, options) {
+    const existing = options?.headers ?? {};
+    const headers = {
+      ...existing,
+      [SDK_VERSION_HEADER]: SDK_VERSION_VALUE
+    };
+    return this.inner.request(method, url, { ...options ?? {}, headers });
+  }
+};
+
 // src/client/TaxoraClient.ts
 var TaxoraClient = class {
   auth;
   vat;
   company;
+  smartEnrichment;
+  eReporting;
   baseUrl;
   constructor(options) {
     const environment = options.environment ?? Environment.SANDBOX;
     const tokenStorage = options.tokenStorage ?? new InMemoryTokenStorage();
     const httpClient = options.httpClient ?? new FetchHttpClient();
+    const versionedClient = new SdkVersionHttpClient(httpClient);
     this.baseUrl = getBaseUrl(environment);
-    this.auth = new AuthEndpoint(this.baseUrl, options.apiKey, tokenStorage, httpClient);
-    const retryClient = new AuthRetryHttpClient(httpClient, tokenStorage, () => this.auth.refresh());
+    this.auth = new AuthEndpoint(this.baseUrl, options.apiKey, tokenStorage, versionedClient);
+    const retryClient = new AuthRetryHttpClient(versionedClient, tokenStorage, () => this.auth.refresh());
     this.vat = new VatEndpoint(this.baseUrl, options.apiKey, tokenStorage, retryClient);
     this.company = new CompanyEndpoint(this.baseUrl, options.apiKey, tokenStorage, retryClient);
+    this.smartEnrichment = new SmartEnrichmentEndpoint(this.baseUrl, options.apiKey, tokenStorage, retryClient);
+    this.eReporting = new EReportingEndpoint(this.baseUrl, options.apiKey, tokenStorage, retryClient);
   }
 };
 
@@ -1046,15 +2879,36 @@ var Language = {
   AuthenticationException,
   CompanyAddress,
   CompanyEndpoint,
+  ComplianceEnrollment,
+  ComplianceEnrollmentPage,
+  ComplianceEnrollmentStatus,
+  ComplianceTaxReport,
+  ComplianceTaxReportPage,
+  ComplianceTaxReportState,
+  ComplianceTransaction,
+  ComplianceTransactionPage,
+  ComplianceTransactionState,
+  ComplianceTransactionType,
+  EReportingEndpoint,
   Environment,
   FetchHttpClient,
   HttpException,
+  ImportResult,
   InMemoryTokenStorage,
   Language,
   LoginIdentifier,
   ProviderDocument,
   ProviderDocumentLine,
+  RevenueStatistics,
   ScoreBreakdown,
+  SireneLookupResult,
+  SmartEnrichmentEndpoint,
+  SmartEnrichmentHistoryPage,
+  SmartEnrichmentHistoryRow,
+  SmartEnrichmentJob,
+  SmartEnrichmentResource,
+  SmartEnrichmentStatistics,
+  SmartEnrichmentStatus,
   TaxoraClient,
   TaxoraClientFactory,
   TaxoraException,
@@ -1063,11 +2917,22 @@ var Language = {
   VatCertificateExport,
   VatCollection,
   VatEndpoint,
+  VatRates,
   VatResource,
   VatState,
   VatValidationAddressInput,
+  describeComplianceEnrollmentStatus,
+  describeComplianceTaxReportState,
+  describeComplianceTransactionState,
+  describeComplianceTransactionType,
+  describeSmartEnrichmentStatus,
   describeVatState,
   getBaseUrl,
-  getFailedVatStates
+  getFailedVatStates,
+  toComplianceEnrollmentStatus,
+  toComplianceTaxReportState,
+  toComplianceTransactionState,
+  toComplianceTransactionType,
+  toSmartEnrichmentStatus
 });
 //# sourceMappingURL=index.cjs.map