@taxora/sdk 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `@taxora/sdk` are documented here. Versions follow [SemVer](https://semver.org/).
 
+## [1.5.0] — 2026-10-22
+
+### Added
+
+- **Smart Enrichment: `sourceUrl` and `registeredOwner`** on `SmartEnrichmentResource`. `sourceUrl` is the page
+  the VAT number was read from (usually the company's Impressum; only http(s) addresses are accepted).
+  `registeredOwner` names the person the tax authority has the VAT ID under when that is not the trading name —
+  typical for a German sole proprietorship (e.K.). `sourceUrls` lists every page the number was read from,
+  `sourceUrl` first (each research pass that found the same number contributes its page).
+
+### Changed
+
+- Bundled OpenAPI specs (`resources/`) refreshed from the current API.
+
 ## [1.4.0] — 2026-10-21
 
 ### Added

package/README.md

@@ -363,6 +363,13 @@ if (quality && quality.warnings.length > 0) {
   console.log(quality.warnings.join(', '), '→', quality.derivedPlace);
 }
 
+// Where the number came from, and who it is registered to. `sourceUrl` is the page it was read
+// from (usually the Impressum). `registeredOwner` is set when the tax authority has the VAT ID
+// under a person rather than the trading name — a German e.K. — and confirmed it for them.
+console.log(result?.sourceUrl ?? '—'); // e.g. 'https://example.de/impressum'
+console.log(result?.sourceUrls.join(', ')); // every page it was found on, main one first
+console.log(result?.registeredOwner ?? '—'); // e.g. 'Kevin Seibel'
+
 // 'not_found' doesn't always mean nothing turned up. When the research found a VAT number but
 // the official check threw it out (e.g. the tax authority reports it as invalid), the number
 // and the reason are in `rejectedCandidates` — no need to re-check it yourself.

package/dist/index.cjs

@@ -2431,7 +2431,7 @@ function toRejectedCandidates(value) {
   return candidates;
 }
 var SmartEnrichmentResource = class _SmartEnrichmentResource {
-  constructor(status, vatNumber, vatType, confidence, matchedCompanyName, matchedAddress, country, source, mode = void 0, providerVerdicts = [], addressQuality = void 0, rejectedCandidates = []) {
+  constructor(status, vatNumber, vatType, confidence, matchedCompanyName, matchedAddress, country, source, mode = void 0, providerVerdicts = [], addressQuality = void 0, rejectedCandidates = [], sourceUrl = void 0, registeredOwner = void 0, sourceUrls = []) {
     this.status = status;
     this.vatNumber = vatNumber;
     this.vatType = vatType;
@@ -2444,6 +2444,9 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
     this.providerVerdicts = providerVerdicts;
     this.addressQuality = addressQuality;
     this.rejectedCandidates = rejectedCandidates;
+    this.sourceUrl = sourceUrl;
+    this.registeredOwner = registeredOwner;
+    this.sourceUrls = sourceUrls;
   }
   status;
   vatNumber;
@@ -2457,6 +2460,9 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
   providerVerdicts;
   addressQuality;
   rejectedCandidates;
+  sourceUrl;
+  registeredOwner;
+  sourceUrls;
   /** True when a VAT number was found but rejected by the official check. */
   hasRejectedCandidates() {
     return this.rejectedCandidates.length > 0;
@@ -2466,6 +2472,13 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       const v = data[key];
       return typeof v === "string" ? v : void 0;
     };
+    const text = (key) => {
+      const v = str(key)?.trim();
+      return v ? v : void 0;
+    };
+    const isWebUrl = (value) => typeof value === "string" && /^https?:\/\/\S+$/i.test(value.trim());
+    const url = text("sourceUrl");
+    const urls = data["sourceUrls"];
     const num = (key) => {
       const v = data[key];
       return typeof v === "number" ? v : void 0;
@@ -2484,7 +2497,10 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       toSmartEnrichmentMode(data["mode"]),
       Array.isArray(verdicts) ? verdicts.filter((v) => typeof v === "object" && v !== null) : [],
       typeof quality === "object" && quality !== null ? quality : void 0,
-      toRejectedCandidates(data["rejectedCandidates"])
+      toRejectedCandidates(data["rejectedCandidates"]),
+      url && isWebUrl(url) ? url : void 0,
+      text("registeredOwner"),
+      Array.isArray(urls) ? [...new Set(urls.filter(isWebUrl).map((u) => u.trim()))] : []
     );
   }
   toArray() {
@@ -2500,7 +2516,10 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
       mode: this.mode ?? null,
       providerVerdicts: this.providerVerdicts,
       addressQuality: this.addressQuality ?? null,
-      rejectedCandidates: this.rejectedCandidates.map((c) => ({ vatNumber: c.vatNumber, reason: c.reason }))
+      rejectedCandidates: this.rejectedCandidates.map((c) => ({ vatNumber: c.vatNumber, reason: c.reason })),
+      sourceUrl: this.sourceUrl ?? null,
+      registeredOwner: this.registeredOwner ?? null,
+      sourceUrls: this.sourceUrls
     };
   }
 };
@@ -3778,7 +3797,7 @@ var AuthRetryHttpClient = class {
 };
 
 // src/version.ts
-var SDK_VERSION = "1.4.0";
+var SDK_VERSION = "1.5.0";
 
 // src/http/SdkVersionHttpClient.ts
 var SDK_VERSION_HEADER = "X-Taxora-SDK-Version";