@taxora/sdk 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to `@taxora/sdk` are documented here. Versions follow [SemVer](https://semver.org/).
 
+## [1.8.0] — 2026-10-25
+
+### Added
+
+- **`smartEnrichment.recheck(jobId, { rows?, dryRun? })`** searches again for rows without a usable answer
+  (`not_found`, or a number registered to another company). Every recheck counts as a check like a new lookup (Deep
+  Verify ×2), found or not; max 3 per row, 7 days apart; `no_vat_exists` and found rows are never rechecked.
+  `dryRun` reports rows, skipped rows and cost without starting anything. Returns `SmartEnrichmentRecheck`
+  (`rows`, `checks`, `skipped`, `dryRun`).
+- **`SmartEnrichmentJob.recheck`** (`SmartEnrichmentRecheckState`: `eligible`, `runs`, `maxPerRow`, `cooldownDays`,
+  `isActive()`) and **`recheckCount` / `lastRecheckedAt`** on each result.
+
+### Changed
+
+- Bundled OpenAPI specs (`resources/`) refreshed from the current API.
+
+## [1.7.1] — 2026-10-24
+
+### Fixed
+
+- **`smartEnrichment.export()` keeps the CSV's UTF-8 BOM.** `Response.text()` silently dropped it, so Excel opened a
+  saved export as ANSI and garbled umlauts. The body is now returned byte-for-byte, as documented.
+
 ## [1.7.0] — 2026-10-24
 
 ### Added

package/README.md

@@ -448,6 +448,26 @@ for (const row of history) {
 }
 ```
 
+### Check rows again
+
+Search once more for rows without a usable answer (`not_found`, or a number registered to another company). Every
+recheck counts as a check like a new lookup (Deep Verify ×2), whether a VAT number is found or not. A row can be
+rechecked up to 3 times, 7 days apart; `no_vat_exists` and found rows are never rechecked.
+
+```ts
+// What would run, and what it costs — nothing is started
+const plan = await client.smartEnrichment.recheck(jobId, { dryRun: true });
+console.log(plan.rows.length, 'rows,', plan.checks, 'checks, skipped:', plan.skipped);
+
+await client.smartEnrichment.recheck(jobId); // every row that qualifies
+await client.smartEnrichment.recheck(jobId, { rows: [3, 7] }); // or just these rows
+
+// Improved rows arrive via the `enrichment.updated` webhook; or poll:
+const job = await client.smartEnrichment.get(jobId);
+console.log(job.recheck?.isActive() ? 'still rechecking' : 'done');
+console.log(job.results[3]?.recheckCount, job.results[3]?.lastRecheckedAt);
+```
+
 ### Quota usage & billing history
 
 ```ts

package/dist/index.cjs

@@ -63,6 +63,8 @@ __export(index_exports, {
   SmartEnrichmentHistoryRow: () => SmartEnrichmentHistoryRow,
   SmartEnrichmentJob: () => SmartEnrichmentJob,
   SmartEnrichmentMode: () => SmartEnrichmentMode,
+  SmartEnrichmentRecheck: () => SmartEnrichmentRecheck,
+  SmartEnrichmentRecheckState: () => SmartEnrichmentRecheckState,
   SmartEnrichmentRejectionReason: () => SmartEnrichmentRejectionReason,
   SmartEnrichmentResource: () => SmartEnrichmentResource,
   SmartEnrichmentStatistics: () => SmartEnrichmentStatistics,
@@ -2318,6 +2320,73 @@ var EReportingEndpoint = class {
   }
 };
 
+// src/dto/SmartEnrichmentRecheck.ts
+var toIndexes = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "number" && Number.isInteger(v)) : [];
+var SmartEnrichmentRecheck = class _SmartEnrichmentRecheck {
+  constructor(jobId, rows, checks, skipped, dryRun) {
+    this.jobId = jobId;
+    this.rows = rows;
+    this.checks = checks;
+    this.skipped = skipped;
+    this.dryRun = dryRun;
+  }
+  jobId;
+  rows;
+  checks;
+  skipped;
+  dryRun;
+  static fromArray(data) {
+    const skipped = {};
+    const rawSkipped = data["skipped"];
+    if (typeof rawSkipped === "object" && rawSkipped !== null && !Array.isArray(rawSkipped)) {
+      for (const [reason, count] of Object.entries(rawSkipped)) {
+        if (typeof count === "number") skipped[reason] = count;
+      }
+    }
+    return new _SmartEnrichmentRecheck(
+      typeof data["jobId"] === "string" ? data["jobId"] : "",
+      toIndexes(data["rows"]),
+      typeof data["checks"] === "number" ? data["checks"] : 0,
+      skipped,
+      data["dryRun"] === true
+    );
+  }
+};
+var SmartEnrichmentRecheckState = class _SmartEnrichmentRecheckState {
+  constructor(eligible, runs, maxPerRow, cooldownDays) {
+    this.eligible = eligible;
+    this.runs = runs;
+    this.maxPerRow = maxPerRow;
+    this.cooldownDays = cooldownDays;
+  }
+  eligible;
+  runs;
+  maxPerRow;
+  cooldownDays;
+  static fromArray(data) {
+    const runs = {};
+    const rawRuns = data["runs"];
+    if (typeof rawRuns === "object" && rawRuns !== null && !Array.isArray(rawRuns)) {
+      for (const [index, run] of Object.entries(rawRuns)) {
+        if (!/^\d+$/.test(index) || typeof run !== "object" || run === null) continue;
+        const { state, resolved } = run;
+        if (state !== "queued" && state !== "running" && state !== "finished" && state !== "failed") continue;
+        runs[Number(index)] = typeof resolved === "boolean" ? { state, resolved } : { state };
+      }
+    }
+    return new _SmartEnrichmentRecheckState(
+      toIndexes(data["eligible"]),
+      runs,
+      typeof data["maxPerRow"] === "number" ? data["maxPerRow"] : 3,
+      typeof data["cooldownDays"] === "number" ? data["cooldownDays"] : 7
+    );
+  }
+  /** True while any recheck of this lookup is queued or running. */
+  isActive() {
+    return Object.values(this.runs).some((run) => run.state === "queued" || run.state === "running");
+  }
+};
+
 // src/enums/SmartEnrichmentMode.ts
 var SmartEnrichmentMode = {
   DEFAULT: "default",
@@ -2447,7 +2516,7 @@ function toOfficialAddress(value) {
   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 = [], 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) {
+  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, recheckCount = void 0, lastRecheckedAt = void 0) {
     this.status = status;
     this.vatNumber = vatNumber;
     this.vatType = vatType;
@@ -2472,6 +2541,8 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
     this.taxNumberType = taxNumberType;
     this.taxNumberLabel = taxNumberLabel;
     this.taxNumberSource = taxNumberSource;
+    this.recheckCount = recheckCount;
+    this.lastRecheckedAt = lastRecheckedAt;
   }
   status;
   vatNumber;
@@ -2497,6 +2568,8 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
   taxNumberType;
   taxNumberLabel;
   taxNumberSource;
+  recheckCount;
+  lastRecheckedAt;
   /** True when the register knows the number under a different name than the one requested. */
   nameMismatch() {
     return this.nameMatch === "mismatch";
@@ -2547,7 +2620,9 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       toOfficialAddress(data["officialAddress"]),
       text("taxNumberType"),
       text("taxNumberLabel"),
-      data["taxNumberSource"] === "vat_id" || data["taxNumberSource"] === "company_website" ? data["taxNumberSource"] : void 0
+      data["taxNumberSource"] === "vat_id" || data["taxNumberSource"] === "company_website" ? data["taxNumberSource"] : void 0,
+      num("recheckCount"),
+      text("lastRecheckedAt")
     );
   }
   toArray() {
@@ -2575,20 +2650,23 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       officialAddress: this.officialAddress ?? null,
       taxNumberType: this.taxNumberType ?? null,
       taxNumberLabel: this.taxNumberLabel ?? null,
-      taxNumberSource: this.taxNumberSource ?? null
+      taxNumberSource: this.taxNumberSource ?? null,
+      recheckCount: this.recheckCount ?? null,
+      lastRecheckedAt: this.lastRecheckedAt ?? null
     };
   }
 };
 
 // src/dto/SmartEnrichmentJob.ts
 var SmartEnrichmentJob = class _SmartEnrichmentJob {
-  constructor(jobId, status, itemCount, completedCount, foundCount, results) {
+  constructor(jobId, status, itemCount, completedCount, foundCount, results, recheck = void 0) {
     this.jobId = jobId;
     this.status = status;
     this.itemCount = itemCount;
     this.completedCount = completedCount;
     this.foundCount = foundCount;
     this.results = results;
+    this.recheck = recheck;
   }
   jobId;
   status;
@@ -2596,6 +2674,7 @@ var SmartEnrichmentJob = class _SmartEnrichmentJob {
   completedCount;
   foundCount;
   results;
+  recheck;
   static fromArray(data) {
     const num = (key) => {
       const v = data[key];
@@ -2613,7 +2692,8 @@ var SmartEnrichmentJob = class _SmartEnrichmentJob {
       num("itemCount"),
       num("completedCount"),
       num("foundCount"),
-      results
+      results,
+      typeof data["recheck"] === "object" && data["recheck"] !== null && !Array.isArray(data["recheck"]) ? SmartEnrichmentRecheckState.fromArray(data["recheck"]) : void 0
     );
   }
   isProcessing() {
@@ -2859,6 +2939,41 @@ var SmartEnrichmentEndpoint = class {
     const data = await this.parseJsonResponse(response);
     return SmartEnrichmentJob.fromArray(data);
   }
+  /**
+   * Search again for rows of a finished lookup that have no usable answer (`not_found`, or a
+   * number registered to another company). Without `rows` every row that qualifies is rechecked.
+   *
+   * Every recheck counts as a check like a new lookup (Deep Verify ×2), whether a VAT number is
+   * found or not. A row can be rechecked up to 3 times, with 7 days between two rechecks;
+   * `no_vat_exists` and found rows are never rechecked. Pass `dryRun` to see which rows would run
+   * and what they cost without starting anything. Improved rows arrive via the
+   * `enrichment.updated` webhook; `get(jobId).recheck` shows the progress.
+   *
+   * Throws a ValidationException when nothing can be rechecked, the lookup is still running, or
+   * rechecks are not available (sandbox, flat-fee import), and an HttpException (429) when the
+   * start credit or monthly hard cap does not cover it.
+   */
+  async recheck(jobId, options = {}) {
+    this.validateJobId(jobId);
+    const body = {};
+    if (options.rows !== void 0) {
+      if (options.rows.length === 0) {
+        throw new TaxoraException("rows must not be empty; omit it to recheck every row that qualifies.");
+      }
+      if (options.rows.some((index) => !Number.isInteger(index) || index < 0)) {
+        throw new TaxoraException("rows must contain 0-based row indexes (integers >= 0).");
+      }
+      body["rows"] = [...new Set(options.rows)];
+    }
+    if (options.dryRun) body["dryRun"] = true;
+    const response = await this.sendRequest(
+      "POST",
+      `${this.baseUrl}/smart-enrichment/${encodeURIComponent(jobId)}/recheck`,
+      body
+    );
+    const data = await this.parseJsonResponse(response, [200, 202]);
+    return SmartEnrichmentRecheck.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`.
@@ -3063,7 +3178,7 @@ var SmartEnrichmentEndpoint = class {
    * verbatim (text/csv) instead of parsing JSON.
    */
   async parseCsvResponse(response) {
-    const responseText = await response.text();
+    const responseText = new TextDecoder("utf-8", { ignoreBOM: true }).decode(await response.arrayBuffer());
     if (response.status === 422) {
       throw new ValidationException(
         jsonErrorMessage(responseText) ?? "Validation failed",
@@ -4033,7 +4148,7 @@ var AuthRetryHttpClient = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.7.0";
+var SDK_VERSION = "1.8.0";
 
 // src/http/SdkVersionHttpClient.ts
 var SDK_VERSION_HEADER = "X-Taxora-SDK-Version";
@@ -4264,6 +4379,8 @@ function toBytes(rawBody) {
   SmartEnrichmentHistoryRow,
   SmartEnrichmentJob,
   SmartEnrichmentMode,
+  SmartEnrichmentRecheck,
+  SmartEnrichmentRecheckState,
   SmartEnrichmentRejectionReason,
   SmartEnrichmentResource,
   SmartEnrichmentStatistics,