@taxora/sdk 1.5.0 → 1.7.0

package/dist/index.js

@@ -2315,8 +2315,22 @@ function toRejectedCandidates(value) {
   }
   return candidates;
 }
+function toOfficialAddress(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return void 0;
+  }
+  const record = value;
+  const address = {};
+  for (const key of ["street", "postal_code", "city", "country"]) {
+    const part = typeof record[key] === "string" ? record[key].trim() : "";
+    if (part !== "") {
+      address[key] = part;
+    }
+  }
+  return Object.keys(address).length > 0 ? address : void 0;
+}
 var SmartEnrichmentResource = class _SmartEnrichmentResource {
-  constructor(status, vatNumber, vatType, confidence, matchedCompanyName, matchedAddress, country, source, mode = void 0, providerVerdicts = [], addressQuality = void 0, rejectedCandidates = [], sourceUrl = void 0, registeredOwner = void 0, sourceUrls = []) {
+  constructor(status, vatNumber, vatType, confidence, matchedCompanyName, matchedAddress, country, source, mode = void 0, providerVerdicts = [], addressQuality = void 0, rejectedCandidates = [], sourceUrl = void 0, registeredOwner = void 0, sourceUrls = [], taxNumber = void 0, vatValid = void 0, aiScore = void 0, nameMatch = void 0, officialName = void 0, officialAddress = void 0, taxNumberType = void 0, taxNumberLabel = void 0, taxNumberSource = void 0) {
     this.status = status;
     this.vatNumber = vatNumber;
     this.vatType = vatType;
@@ -2332,6 +2346,15 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
     this.sourceUrl = sourceUrl;
     this.registeredOwner = registeredOwner;
     this.sourceUrls = sourceUrls;
+    this.taxNumber = taxNumber;
+    this.vatValid = vatValid;
+    this.aiScore = aiScore;
+    this.nameMatch = nameMatch;
+    this.officialName = officialName;
+    this.officialAddress = officialAddress;
+    this.taxNumberType = taxNumberType;
+    this.taxNumberLabel = taxNumberLabel;
+    this.taxNumberSource = taxNumberSource;
   }
   status;
   vatNumber;
@@ -2348,6 +2371,19 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
   sourceUrl;
   registeredOwner;
   sourceUrls;
+  taxNumber;
+  vatValid;
+  aiScore;
+  nameMatch;
+  officialName;
+  officialAddress;
+  taxNumberType;
+  taxNumberLabel;
+  taxNumberSource;
+  /** True when the register knows the number under a different name than the one requested. */
+  nameMismatch() {
+    return this.nameMatch === "mismatch";
+  }
   /** True when a VAT number was found but rejected by the official check. */
   hasRejectedCandidates() {
     return this.rejectedCandidates.length > 0;
@@ -2385,7 +2421,16 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       toRejectedCandidates(data["rejectedCandidates"]),
       url && isWebUrl(url) ? url : void 0,
       text("registeredOwner"),
-      Array.isArray(urls) ? [...new Set(urls.filter(isWebUrl).map((u) => u.trim()))] : []
+      Array.isArray(urls) ? [...new Set(urls.filter(isWebUrl).map((u) => u.trim()))] : [],
+      text("taxNumber"),
+      typeof data["vatValid"] === "boolean" ? data["vatValid"] : void 0,
+      num("aiScore"),
+      data["nameMatch"] === "ok" || data["nameMatch"] === "mismatch" ? data["nameMatch"] : void 0,
+      text("officialName"),
+      toOfficialAddress(data["officialAddress"]),
+      text("taxNumberType"),
+      text("taxNumberLabel"),
+      data["taxNumberSource"] === "vat_id" || data["taxNumberSource"] === "company_website" ? data["taxNumberSource"] : void 0
     );
   }
   toArray() {
@@ -2404,7 +2449,16 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       rejectedCandidates: this.rejectedCandidates.map((c) => ({ vatNumber: c.vatNumber, reason: c.reason })),
       sourceUrl: this.sourceUrl ?? null,
       registeredOwner: this.registeredOwner ?? null,
-      sourceUrls: this.sourceUrls
+      sourceUrls: this.sourceUrls,
+      taxNumber: this.taxNumber ?? null,
+      vatValid: this.vatValid ?? null,
+      aiScore: this.aiScore ?? null,
+      nameMatch: this.nameMatch ?? null,
+      officialName: this.officialName ?? null,
+      officialAddress: this.officialAddress ?? null,
+      taxNumberType: this.taxNumberType ?? null,
+      taxNumberLabel: this.taxNumberLabel ?? null,
+      taxNumberSource: this.taxNumberSource ?? null
     };
   }
 };
@@ -3412,6 +3466,123 @@ var VatValidationAddressInput = class _VatValidationAddressInput {
   }
 };
 
+// src/dto/LocalTaxNumberReport.ts
+var LocalTaxNumberRow = class _LocalTaxNumberRow {
+  constructor(companyName, requestedName, country, vatNumber, vatStatus, taxNumber, taxNumberName, taxNumberSource, source, checkedAt, checkId) {
+    this.companyName = companyName;
+    this.requestedName = requestedName;
+    this.country = country;
+    this.vatNumber = vatNumber;
+    this.vatStatus = vatStatus;
+    this.taxNumber = taxNumber;
+    this.taxNumberName = taxNumberName;
+    this.taxNumberSource = taxNumberSource;
+    this.source = source;
+    this.checkedAt = checkedAt;
+    this.checkId = checkId;
+  }
+  companyName;
+  requestedName;
+  country;
+  vatNumber;
+  vatStatus;
+  taxNumber;
+  taxNumberName;
+  taxNumberSource;
+  source;
+  checkedAt;
+  checkId;
+  /** One CSV row keyed by column name. */
+  static fromArray(data) {
+    const cell = (key) => {
+      const value = data[key];
+      const trimmed = typeof value === "string" ? value.trim() : "";
+      return trimmed === "" ? null : trimmed;
+    };
+    return new _LocalTaxNumberRow(
+      cell("companyName"),
+      cell("requestedName"),
+      cell("country"),
+      cell("vatNumber"),
+      cell("vatStatus"),
+      cell("taxNumber"),
+      cell("taxNumberName"),
+      cell("taxNumberSource"),
+      cell("source"),
+      cell("checkedAt"),
+      cell("checkId")
+    );
+  }
+  toArray() {
+    return {
+      companyName: this.companyName,
+      requestedName: this.requestedName,
+      country: this.country,
+      vatNumber: this.vatNumber,
+      vatStatus: this.vatStatus,
+      taxNumber: this.taxNumber,
+      taxNumberName: this.taxNumberName,
+      taxNumberSource: this.taxNumberSource,
+      source: this.source,
+      checkedAt: this.checkedAt,
+      checkId: this.checkId
+    };
+  }
+};
+function parseCsvRecords(csv) {
+  const records = [];
+  let record = [];
+  let cell = "";
+  let quoted = false;
+  for (let i = 0; i < csv.length; i++) {
+    const ch = csv[i];
+    if (quoted) {
+      if (ch === '"') {
+        if (csv[i + 1] === '"') {
+          cell += '"';
+          i++;
+        } else {
+          quoted = false;
+        }
+      } else {
+        cell += ch;
+      }
+    } else if (ch === '"') {
+      quoted = true;
+    } else if (ch === ",") {
+      record.push(cell);
+      cell = "";
+    } else if (ch === "\n" || ch === "\r") {
+      if (ch === "\r" && csv[i + 1] === "\n") i++;
+      record.push(cell);
+      records.push(record);
+      record = [];
+      cell = "";
+    } else {
+      cell += ch;
+    }
+  }
+  if (cell !== "" || record.length > 0) {
+    record.push(cell);
+    records.push(record);
+  }
+  return records.filter((r) => !(r.length === 1 && r[0] === ""));
+}
+function parseLocalTaxNumbersCsv(csv) {
+  const [header, ...records] = parseCsvRecords(csv.replace(/^\uFEFF/, ""));
+  if (!header) {
+    return [];
+  }
+  const names = header.map((name) => name.trim());
+  return records.map((cells) => {
+    const row = {};
+    names.forEach((name, i) => {
+      row[name] = cells[i];
+    });
+    return LocalTaxNumberRow.fromArray(row);
+  });
+}
+
 // src/endpoints/VatEndpoint.ts
 var DATE_REGEX2 = /^\d{4}-\d{2}-\d{2}$/;
 var VatEndpoint = class {
@@ -3522,6 +3693,69 @@ var VatEndpoint = class {
       return new Uint8Array(buffer);
     });
   }
+  /**
+   * Local tax numbers report as raw CSV (UTF-8 with BOM, comma-separated): every company checked —
+   * single and bulk VAT checks and Smart Enrichment lookups — once, with its local tax number
+   * (taxNumber, taxNumberName, taxNumberSource). Digit-only taxNumber cells carry a leading TAB so
+   * Excel keeps them as text; `localTaxNumbers()` strips it for you.
+   */
+  async localTaxNumbersCsv(options = {}) {
+    const params = this.localTaxNumbersParams(options);
+    if (options.onlyWithTaxNumber !== void 0) {
+      params.set("only_with_tax_number", options.onlyWithTaxNumber ? "1" : "0");
+    }
+    const url = this.withQuery(`${this.baseUrl}/reports/local-tax-numbers`, params);
+    return withRetries(this.retryPolicy, "Local tax numbers report", async () => {
+      const headers = this.buildHeaders();
+      delete headers["Content-Type"];
+      headers["Accept"] = "text/csv, application/json";
+      const response = await this.httpClient.request("GET", url, { headers });
+      if (response.status === 422) {
+        await this.parseJsonResponse(response);
+      }
+      const text = new TextDecoder("utf-8", { ignoreBOM: true }).decode(await response.arrayBuffer());
+      if (!response.ok) {
+        throw new HttpException(
+          describeApiError(text, response.status),
+          response.status,
+          text,
+          {},
+          response.headers.get("retry-after")
+        );
+      }
+      return text;
+    });
+  }
+  /** The local tax numbers report, parsed: one row per company (same filters as `localTaxNumbersCsv()`). */
+  async localTaxNumbers(options = {}) {
+    return parseLocalTaxNumbersCsv(await this.localTaxNumbersCsv(options));
+  }
+  /** How many companies the report would list for the filters, and how many have a tax number. */
+  async localTaxNumbersSummary(options = {}) {
+    const url = this.withQuery(
+      `${this.baseUrl}/reports/local-tax-numbers/summary`,
+      this.localTaxNumbersParams(options)
+    );
+    return withRetries(this.retryPolicy, "Local tax numbers summary", async () => {
+      const response = await this.sendRequest("GET", url);
+      const data = await this.parseJsonResponse(response);
+      const count = (key) => typeof data[key] === "number" ? data[key] : 0;
+      return { companies: count("companies"), withTaxNumber: count("withTaxNumber") };
+    });
+  }
+  localTaxNumbersParams(options) {
+    const params = new URLSearchParams();
+    if (options.dateFrom !== void 0) params.set("date_from", this.formatDate(options.dateFrom));
+    if (options.dateTo !== void 0) params.set("date_to", this.formatDate(options.dateTo));
+    for (const country of options.countries ?? []) {
+      params.append("countries[]", country.trim().toUpperCase());
+    }
+    return params;
+  }
+  withQuery(url, params) {
+    const queryString = params.toString();
+    return queryString ? `${url}?${queryString}` : url;
+  }
   buildHeaders() {
     const headers = {
       "Content-Type": "application/json",
@@ -3682,7 +3916,7 @@ var AuthRetryHttpClient = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.5.0";
+var SDK_VERSION = "1.7.0";
 
 // src/http/SdkVersionHttpClient.ts
 var SDK_VERSION_HEADER = "X-Taxora-SDK-Version";
@@ -3895,6 +4129,7 @@ export {
   ImportResult,
   InMemoryTokenStorage,
   Language,
+  LocalTaxNumberRow,
   LoginIdentifier,
   NorwegianOrgNumber,
   PeppolLookupResult,
@@ -3947,6 +4182,7 @@ export {
   generateWebhookSignatureHeader,
   getBaseUrl,
   getFailedVatStates,
+  parseLocalTaxNumbersCsv,
   parseWebhookSignatureHeader,
   toComplianceDocumentType,
   toComplianceEnrollmentStatus,