@taxora/sdk 1.4.0 → 1.5.0

package/dist/index.d.cts

@@ -1195,6 +1195,22 @@ declare class SmartEnrichmentResource {
      * apart from "found nothing". Empty for every other status.
      */
     readonly rejectedCandidates: SmartEnrichmentRejectedCandidate[];
+    /**
+     * Only on `found`: the web page the VAT number was read from — usually the company's own
+     * Impressum / legal notice. Undefined when it came from Taxora's own data or a register.
+     */
+    readonly sourceUrl: string | undefined;
+    /**
+     * Only on `found`: 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.). `matchedCompanyName` stays
+     * the trading name.
+     */
+    readonly registeredOwner: string | undefined;
+    /**
+     * Only on `found`: every page the VAT number was read from, `sourceUrl` first — each research
+     * pass that found the same number contributes its page. At most 5.
+     */
+    readonly sourceUrls: string[];
     constructor(status: SmartEnrichmentStatus, vatNumber: string | undefined, vatType: string | undefined, confidence: number | undefined, matchedCompanyName: string | undefined, 
     /** Official/registered address of the matched company, when available. */
     matchedAddress: string | undefined, country: string | undefined, source: string | undefined, 
@@ -1211,7 +1227,23 @@ declare class SmartEnrichmentResource {
      * e.g. one the tax authority reports as invalid. Lets you tell "found one, it is invalid"
      * apart from "found nothing". Empty for every other status.
      */
-    rejectedCandidates?: SmartEnrichmentRejectedCandidate[]);
+    rejectedCandidates?: SmartEnrichmentRejectedCandidate[], 
+    /**
+     * Only on `found`: the web page the VAT number was read from — usually the company's own
+     * Impressum / legal notice. Undefined when it came from Taxora's own data or a register.
+     */
+    sourceUrl?: string | undefined, 
+    /**
+     * Only on `found`: 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.). `matchedCompanyName` stays
+     * the trading name.
+     */
+    registeredOwner?: string | undefined, 
+    /**
+     * Only on `found`: every page the VAT number was read from, `sourceUrl` first — each research
+     * pass that found the same number contributes its page. At most 5.
+     */
+    sourceUrls?: string[]);
     /** True when a VAT number was found but rejected by the official check. */
     hasRejectedCandidates(): boolean;
     static fromArray(data: Record<string, unknown>): SmartEnrichmentResource;

package/dist/index.d.ts

@@ -1195,6 +1195,22 @@ declare class SmartEnrichmentResource {
      * apart from "found nothing". Empty for every other status.
      */
     readonly rejectedCandidates: SmartEnrichmentRejectedCandidate[];
+    /**
+     * Only on `found`: the web page the VAT number was read from — usually the company's own
+     * Impressum / legal notice. Undefined when it came from Taxora's own data or a register.
+     */
+    readonly sourceUrl: string | undefined;
+    /**
+     * Only on `found`: 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.). `matchedCompanyName` stays
+     * the trading name.
+     */
+    readonly registeredOwner: string | undefined;
+    /**
+     * Only on `found`: every page the VAT number was read from, `sourceUrl` first — each research
+     * pass that found the same number contributes its page. At most 5.
+     */
+    readonly sourceUrls: string[];
     constructor(status: SmartEnrichmentStatus, vatNumber: string | undefined, vatType: string | undefined, confidence: number | undefined, matchedCompanyName: string | undefined, 
     /** Official/registered address of the matched company, when available. */
     matchedAddress: string | undefined, country: string | undefined, source: string | undefined, 
@@ -1211,7 +1227,23 @@ declare class SmartEnrichmentResource {
      * e.g. one the tax authority reports as invalid. Lets you tell "found one, it is invalid"
      * apart from "found nothing". Empty for every other status.
      */
-    rejectedCandidates?: SmartEnrichmentRejectedCandidate[]);
+    rejectedCandidates?: SmartEnrichmentRejectedCandidate[], 
+    /**
+     * Only on `found`: the web page the VAT number was read from — usually the company's own
+     * Impressum / legal notice. Undefined when it came from Taxora's own data or a register.
+     */
+    sourceUrl?: string | undefined, 
+    /**
+     * Only on `found`: 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.). `matchedCompanyName` stays
+     * the trading name.
+     */
+    registeredOwner?: string | undefined, 
+    /**
+     * Only on `found`: every page the VAT number was read from, `sourceUrl` first — each research
+     * pass that found the same number contributes its page. At most 5.
+     */
+    sourceUrls?: string[]);
     /** True when a VAT number was found but rejected by the official check. */
     hasRejectedCandidates(): boolean;
     static fromArray(data: Record<string, unknown>): SmartEnrichmentResource;

package/dist/index.js

@@ -2316,7 +2316,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;
@@ -2329,6 +2329,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;
@@ -2342,6 +2345,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;
@@ -2351,6 +2357,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;
@@ -2369,7 +2382,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() {
@@ -2385,7 +2401,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
     };
   }
 };
@@ -3663,7 +3682,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";