@taxora/sdk 1.7.0 → 1.8.0

package/dist/index.d.cts

@@ -1092,6 +1092,63 @@ type SmartEnrichmentMode = (typeof SmartEnrichmentMode)[keyof typeof SmartEnrich
 declare function toSmartEnrichmentMode(value: unknown): SmartEnrichmentMode | undefined;
 declare function describeSmartEnrichmentMode(mode: SmartEnrichmentMode): string;
 
+/** Why a row was left out of a recheck. */
+type SmartEnrichmentRecheckSkipReason = 'resolved' | 'no_vat_exists' | 'limit_reached' | 'cooldown' | 'running' | 'pending';
+type SmartEnrichmentRecheckRunState = 'queued' | 'running' | 'finished' | 'failed';
+interface SmartEnrichmentRecheckRun {
+    state: SmartEnrichmentRecheckRunState;
+    /** Set once a finished recheck found a usable number (`true`) or did not (`false`). */
+    resolved?: boolean;
+}
+interface SmartEnrichmentRecheckOptions {
+    /** 0-based row indexes of the lookup; omit to recheck every row that qualifies. */
+    rows?: number[];
+    /** Only report which rows would run and what they cost — nothing is started. */
+    dryRun?: boolean;
+}
+/**
+ * What a recheck started (or, for a dry run, would start) and what it costs. Every recheck counts
+ * as a check like a new lookup (Deep Verify ×2), whether a VAT number is found or not.
+ */
+declare class SmartEnrichmentRecheck {
+    readonly jobId: string;
+    /** Row indexes that are (or would be) rechecked. */
+    readonly rows: number[];
+    /** Checks these rechecks use. */
+    readonly checks: number;
+    /** Rows left out, by reason. */
+    readonly skipped: Partial<Record<SmartEnrichmentRecheckSkipReason, number>>;
+    readonly dryRun: boolean;
+    constructor(jobId: string, 
+    /** Row indexes that are (or would be) rechecked. */
+    rows: number[], 
+    /** Checks these rechecks use. */
+    checks: number, 
+    /** Rows left out, by reason. */
+    skipped: Partial<Record<SmartEnrichmentRecheckSkipReason, number>>, dryRun: boolean);
+    static fromArray(data: Record<string, unknown>): SmartEnrichmentRecheck;
+}
+/**
+ * "Check again" state of a lookup, as `smartEnrichment.get()` reports it: the rows that can be
+ * rechecked right now, the rechecks of the last week, and the limits behind both.
+ */
+declare class SmartEnrichmentRecheckState {
+    /** Row indexes that can be rechecked now. */
+    readonly eligible: number[];
+    /** Rechecks of the last week, by row index. */
+    readonly runs: Record<number, SmartEnrichmentRecheckRun>;
+    readonly maxPerRow: number;
+    readonly cooldownDays: number;
+    constructor(
+    /** Row indexes that can be rechecked now. */
+    eligible: number[], 
+    /** Rechecks of the last week, by row index. */
+    runs: Record<number, SmartEnrichmentRecheckRun>, maxPerRow: number, cooldownDays: number);
+    static fromArray(data: Record<string, unknown>): SmartEnrichmentRecheckState;
+    /** True while any recheck of this lookup is queued or running. */
+    isActive(): boolean;
+}
+
 /**
  * Why a VAT number the research DID find was not returned as the result.
  *
@@ -1251,6 +1308,10 @@ declare class SmartEnrichmentResource {
      * or 'company_website' (published by the company itself, not officially confirmable).
      */
     readonly taxNumberSource: SmartEnrichmentTaxNumberSource | undefined;
+    /** How often this row was checked again (`smartEnrichment.recheck()`); undefined when never. */
+    readonly recheckCount: number | undefined;
+    /** When it was last checked again (ISO 8601). */
+    readonly lastRecheckedAt: string | undefined;
     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, 
@@ -1314,7 +1375,11 @@ declare class SmartEnrichmentResource {
      * Where `taxNumber` comes from: 'vat_id' (read off the VAT ID the tax authority confirmed — exact)
      * or 'company_website' (published by the company itself, not officially confirmable).
      */
-    taxNumberSource?: SmartEnrichmentTaxNumberSource | undefined);
+    taxNumberSource?: SmartEnrichmentTaxNumberSource | undefined, 
+    /** How often this row was checked again (`smartEnrichment.recheck()`); undefined when never. */
+    recheckCount?: number | undefined, 
+    /** When it was last checked again (ISO 8601). */
+    lastRecheckedAt?: string | undefined);
     /** True when the register knows the number under a different name than the one requested. */
     nameMismatch(): boolean;
     /** True when a VAT number was found but rejected by the official check. */
@@ -1335,7 +1400,11 @@ declare class SmartEnrichmentJob {
     readonly completedCount: number | undefined;
     readonly foundCount: number | undefined;
     readonly results: SmartEnrichmentResource[];
-    constructor(jobId: string, status: SmartEnrichmentStatus, itemCount: number | undefined, completedCount: number | undefined, foundCount: number | undefined, results: SmartEnrichmentResource[]);
+    /** Which rows can be checked again and which are being rechecked (undefined on older API versions). */
+    readonly recheck: SmartEnrichmentRecheckState | undefined;
+    constructor(jobId: string, status: SmartEnrichmentStatus, itemCount: number | undefined, completedCount: number | undefined, foundCount: number | undefined, results: SmartEnrichmentResource[], 
+    /** Which rows can be checked again and which are being rechecked (undefined on older API versions). */
+    recheck?: SmartEnrichmentRecheckState | undefined);
     static fromArray(data: Record<string, unknown>): SmartEnrichmentJob;
     isProcessing(): boolean;
     /** Convenience for single lookups: the first (or only) result, if any. */
@@ -1544,6 +1613,21 @@ declare class SmartEnrichmentEndpoint {
     bulkLookup(items: SmartEnrichmentInput[], mode?: SmartEnrichmentMode): Promise<SmartEnrichmentJob>;
     /** Poll a job (single or bulk) by its id. */
     get(jobId: string): Promise<SmartEnrichmentJob>;
+    /**
+     * 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.
+     */
+    recheck(jobId: string, options?: SmartEnrichmentRecheckOptions): Promise<SmartEnrichmentRecheck>;
     /**
      * 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`.
@@ -2126,4 +2210,4 @@ declare class AuthRetryHttpClient implements HttpClientInterface {
     private injectAuthHeader;
 }
 
-export { ApiVersion, AuthEndpoint, AuthRetryHttpClient, AuthenticationException, CompanyAddress, CompanyEndpoint, type CompanyResource, ComplianceDocumentType, ComplianceEnrollment, ComplianceEnrollmentPage, ComplianceEnrollmentStatus, type ComplianceEnterpriseSize, type ComplianceInvoiceLineInput, type ComplianceInvoiceTaxInput, type ComplianceLedgerStateChangedEvent, type ComplianceLedgerWebhookObject, type ComplianceRequestService, ComplianceService, ComplianceTaxReport, ComplianceTaxReportPage, type ComplianceTaxReportRequestState, ComplianceTaxReportState, ComplianceTransaction, type ComplianceTransactionBuyerInput, type ComplianceTransactionFilters, type ComplianceTransactionInvoiceLine, type ComplianceTransactionInvoiceLineTax, ComplianceTransactionPage, type ComplianceTransactionRequestState, type ComplianceTransactionRequestType, ComplianceTransactionState, type ComplianceTransactionStateChangedEvent, ComplianceTransactionType, type ComplianceTransactionWebhookObject, type ComplianceTypeOperation, type CreateComplianceEnrollmentInput, type CreateComplianceTransactionInput, type CreateNorwayEnrollmentInput, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EReportingAccessRequestInput, EReportingEndpoint, type EReportingInterval, type EnrichmentCompletedEvent, type EnrichmentCompletedWebhookObject, type EnrichmentUpdatedEvent, type EnrichmentUpdatedWebhookObject, Environment, Environment as EnvironmentType, FetchHttpClient, type HttpClientInterface, HttpException, ImportResult, InMemoryTokenStorage, Language, type LocalTaxNumberReportOptions, LocalTaxNumberRow, type LocalTaxNumberSummary, LoginIdentifier, type NorwayEnrollmentInput, NorwegianOrgNumber, type ParsedWebhookSignatureHeader, PeppolLookupResult, PeppolLookupStatus, ProviderDocument, ProviderDocumentLine, RegistryCompany, RetryPolicy, type RetryPolicyOptions, type RevenueCountryBreakdown, type RevenueCurrencyBreakdown, type RevenueStateBreakdown, RevenueStatistics, type RevenueStatisticsFilters, type RevenueTimeBucket, type RevenueTotals, type RevenueTypeBreakdown, ScoreBreakdown, SireneLookupResult, type SmartEnrichmentAddressQuality, type SmartEnrichmentConfidenceBucket, SmartEnrichmentEndpoint, type SmartEnrichmentExportOptions, type SmartEnrichmentHistoryInput, SmartEnrichmentHistoryPage, SmartEnrichmentHistoryRow, type SmartEnrichmentHistoryStats, type SmartEnrichmentInput, SmartEnrichmentJob, SmartEnrichmentMode, type SmartEnrichmentOfficialAddress, type SmartEnrichmentOutcomeBreakdown, type SmartEnrichmentProviderVerdict, type SmartEnrichmentRejectedCandidate, SmartEnrichmentRejectionReason, SmartEnrichmentResource, type SmartEnrichmentSourceBreakdown, SmartEnrichmentStatistics, type SmartEnrichmentStatisticsInterval, type SmartEnrichmentStatisticsOptions, type SmartEnrichmentStatisticsRange, type SmartEnrichmentStatisticsTotals, SmartEnrichmentStatus, type SmartEnrichmentTaxNumberSource, type SmartEnrichmentTimeBucket, type SmartEnrichmentUsage, type SmartEnrichmentUsageHistoryEntry, type SmartEnrichmentWaitOptions, TaxoraClient, TaxoraClientFactory, type TaxoraClientOptions, TaxoraException, type TaxoraWebhookEvent, type TestWebhookObject, Token, type TokenStorageInterface, type UpdateComplianceTransactionInput, ValidationException, VatCertificateExport, VatCollection, VatEndpoint, type VatRate, VatRates, VatResource, VatState, type VatStateChangedEvent, type VatValidatedEvent, VatValidationAddressInput, type VatWebhookObject, WEBHOOK_ID_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEventEnvelope, type WebhookEventType, type WebhookRawBody, type WebhookSignatureErrorReason, type WebhookSignatureHeaderInput, WebhookSignatureVerificationError, type WebhookTestEvent, type WebhookVerifyOptions, computeWebhookSignature, constructWebhookEvent, describeApiError, describeComplianceDocumentType, describeComplianceEnrollmentStatus, describeComplianceService, describeComplianceTaxReportState, describeComplianceTransactionState, describeComplianceTransactionType, describePeppolLookupStatus, describeSmartEnrichmentMode, describeSmartEnrichmentRejectionReason, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseLocalTaxNumbersCsv, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, toSmartEnrichmentRejectionReason, toSmartEnrichmentStatus, verifyWebhookSignature };
+export { ApiVersion, AuthEndpoint, AuthRetryHttpClient, AuthenticationException, CompanyAddress, CompanyEndpoint, type CompanyResource, ComplianceDocumentType, ComplianceEnrollment, ComplianceEnrollmentPage, ComplianceEnrollmentStatus, type ComplianceEnterpriseSize, type ComplianceInvoiceLineInput, type ComplianceInvoiceTaxInput, type ComplianceLedgerStateChangedEvent, type ComplianceLedgerWebhookObject, type ComplianceRequestService, ComplianceService, ComplianceTaxReport, ComplianceTaxReportPage, type ComplianceTaxReportRequestState, ComplianceTaxReportState, ComplianceTransaction, type ComplianceTransactionBuyerInput, type ComplianceTransactionFilters, type ComplianceTransactionInvoiceLine, type ComplianceTransactionInvoiceLineTax, ComplianceTransactionPage, type ComplianceTransactionRequestState, type ComplianceTransactionRequestType, ComplianceTransactionState, type ComplianceTransactionStateChangedEvent, ComplianceTransactionType, type ComplianceTransactionWebhookObject, type ComplianceTypeOperation, type CreateComplianceEnrollmentInput, type CreateComplianceTransactionInput, type CreateNorwayEnrollmentInput, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EReportingAccessRequestInput, EReportingEndpoint, type EReportingInterval, type EnrichmentCompletedEvent, type EnrichmentCompletedWebhookObject, type EnrichmentUpdatedEvent, type EnrichmentUpdatedWebhookObject, Environment, Environment as EnvironmentType, FetchHttpClient, type HttpClientInterface, HttpException, ImportResult, InMemoryTokenStorage, Language, type LocalTaxNumberReportOptions, LocalTaxNumberRow, type LocalTaxNumberSummary, LoginIdentifier, type NorwayEnrollmentInput, NorwegianOrgNumber, type ParsedWebhookSignatureHeader, PeppolLookupResult, PeppolLookupStatus, ProviderDocument, ProviderDocumentLine, RegistryCompany, RetryPolicy, type RetryPolicyOptions, type RevenueCountryBreakdown, type RevenueCurrencyBreakdown, type RevenueStateBreakdown, RevenueStatistics, type RevenueStatisticsFilters, type RevenueTimeBucket, type RevenueTotals, type RevenueTypeBreakdown, ScoreBreakdown, SireneLookupResult, type SmartEnrichmentAddressQuality, type SmartEnrichmentConfidenceBucket, SmartEnrichmentEndpoint, type SmartEnrichmentExportOptions, type SmartEnrichmentHistoryInput, SmartEnrichmentHistoryPage, SmartEnrichmentHistoryRow, type SmartEnrichmentHistoryStats, type SmartEnrichmentInput, SmartEnrichmentJob, SmartEnrichmentMode, type SmartEnrichmentOfficialAddress, type SmartEnrichmentOutcomeBreakdown, type SmartEnrichmentProviderVerdict, SmartEnrichmentRecheck, type SmartEnrichmentRecheckOptions, type SmartEnrichmentRecheckRun, type SmartEnrichmentRecheckRunState, type SmartEnrichmentRecheckSkipReason, SmartEnrichmentRecheckState, type SmartEnrichmentRejectedCandidate, SmartEnrichmentRejectionReason, SmartEnrichmentResource, type SmartEnrichmentSourceBreakdown, SmartEnrichmentStatistics, type SmartEnrichmentStatisticsInterval, type SmartEnrichmentStatisticsOptions, type SmartEnrichmentStatisticsRange, type SmartEnrichmentStatisticsTotals, SmartEnrichmentStatus, type SmartEnrichmentTaxNumberSource, type SmartEnrichmentTimeBucket, type SmartEnrichmentUsage, type SmartEnrichmentUsageHistoryEntry, type SmartEnrichmentWaitOptions, TaxoraClient, TaxoraClientFactory, type TaxoraClientOptions, TaxoraException, type TaxoraWebhookEvent, type TestWebhookObject, Token, type TokenStorageInterface, type UpdateComplianceTransactionInput, ValidationException, VatCertificateExport, VatCollection, VatEndpoint, type VatRate, VatRates, VatResource, VatState, type VatStateChangedEvent, type VatValidatedEvent, VatValidationAddressInput, type VatWebhookObject, WEBHOOK_ID_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEventEnvelope, type WebhookEventType, type WebhookRawBody, type WebhookSignatureErrorReason, type WebhookSignatureHeaderInput, WebhookSignatureVerificationError, type WebhookTestEvent, type WebhookVerifyOptions, computeWebhookSignature, constructWebhookEvent, describeApiError, describeComplianceDocumentType, describeComplianceEnrollmentStatus, describeComplianceService, describeComplianceTaxReportState, describeComplianceTransactionState, describeComplianceTransactionType, describePeppolLookupStatus, describeSmartEnrichmentMode, describeSmartEnrichmentRejectionReason, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseLocalTaxNumbersCsv, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, toSmartEnrichmentRejectionReason, toSmartEnrichmentStatus, verifyWebhookSignature };

package/dist/index.d.ts

@@ -1092,6 +1092,63 @@ type SmartEnrichmentMode = (typeof SmartEnrichmentMode)[keyof typeof SmartEnrich
 declare function toSmartEnrichmentMode(value: unknown): SmartEnrichmentMode | undefined;
 declare function describeSmartEnrichmentMode(mode: SmartEnrichmentMode): string;
 
+/** Why a row was left out of a recheck. */
+type SmartEnrichmentRecheckSkipReason = 'resolved' | 'no_vat_exists' | 'limit_reached' | 'cooldown' | 'running' | 'pending';
+type SmartEnrichmentRecheckRunState = 'queued' | 'running' | 'finished' | 'failed';
+interface SmartEnrichmentRecheckRun {
+    state: SmartEnrichmentRecheckRunState;
+    /** Set once a finished recheck found a usable number (`true`) or did not (`false`). */
+    resolved?: boolean;
+}
+interface SmartEnrichmentRecheckOptions {
+    /** 0-based row indexes of the lookup; omit to recheck every row that qualifies. */
+    rows?: number[];
+    /** Only report which rows would run and what they cost — nothing is started. */
+    dryRun?: boolean;
+}
+/**
+ * What a recheck started (or, for a dry run, would start) and what it costs. Every recheck counts
+ * as a check like a new lookup (Deep Verify ×2), whether a VAT number is found or not.
+ */
+declare class SmartEnrichmentRecheck {
+    readonly jobId: string;
+    /** Row indexes that are (or would be) rechecked. */
+    readonly rows: number[];
+    /** Checks these rechecks use. */
+    readonly checks: number;
+    /** Rows left out, by reason. */
+    readonly skipped: Partial<Record<SmartEnrichmentRecheckSkipReason, number>>;
+    readonly dryRun: boolean;
+    constructor(jobId: string, 
+    /** Row indexes that are (or would be) rechecked. */
+    rows: number[], 
+    /** Checks these rechecks use. */
+    checks: number, 
+    /** Rows left out, by reason. */
+    skipped: Partial<Record<SmartEnrichmentRecheckSkipReason, number>>, dryRun: boolean);
+    static fromArray(data: Record<string, unknown>): SmartEnrichmentRecheck;
+}
+/**
+ * "Check again" state of a lookup, as `smartEnrichment.get()` reports it: the rows that can be
+ * rechecked right now, the rechecks of the last week, and the limits behind both.
+ */
+declare class SmartEnrichmentRecheckState {
+    /** Row indexes that can be rechecked now. */
+    readonly eligible: number[];
+    /** Rechecks of the last week, by row index. */
+    readonly runs: Record<number, SmartEnrichmentRecheckRun>;
+    readonly maxPerRow: number;
+    readonly cooldownDays: number;
+    constructor(
+    /** Row indexes that can be rechecked now. */
+    eligible: number[], 
+    /** Rechecks of the last week, by row index. */
+    runs: Record<number, SmartEnrichmentRecheckRun>, maxPerRow: number, cooldownDays: number);
+    static fromArray(data: Record<string, unknown>): SmartEnrichmentRecheckState;
+    /** True while any recheck of this lookup is queued or running. */
+    isActive(): boolean;
+}
+
 /**
  * Why a VAT number the research DID find was not returned as the result.
  *
@@ -1251,6 +1308,10 @@ declare class SmartEnrichmentResource {
      * or 'company_website' (published by the company itself, not officially confirmable).
      */
     readonly taxNumberSource: SmartEnrichmentTaxNumberSource | undefined;
+    /** How often this row was checked again (`smartEnrichment.recheck()`); undefined when never. */
+    readonly recheckCount: number | undefined;
+    /** When it was last checked again (ISO 8601). */
+    readonly lastRecheckedAt: string | undefined;
     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, 
@@ -1314,7 +1375,11 @@ declare class SmartEnrichmentResource {
      * Where `taxNumber` comes from: 'vat_id' (read off the VAT ID the tax authority confirmed — exact)
      * or 'company_website' (published by the company itself, not officially confirmable).
      */
-    taxNumberSource?: SmartEnrichmentTaxNumberSource | undefined);
+    taxNumberSource?: SmartEnrichmentTaxNumberSource | undefined, 
+    /** How often this row was checked again (`smartEnrichment.recheck()`); undefined when never. */
+    recheckCount?: number | undefined, 
+    /** When it was last checked again (ISO 8601). */
+    lastRecheckedAt?: string | undefined);
     /** True when the register knows the number under a different name than the one requested. */
     nameMismatch(): boolean;
     /** True when a VAT number was found but rejected by the official check. */
@@ -1335,7 +1400,11 @@ declare class SmartEnrichmentJob {
     readonly completedCount: number | undefined;
     readonly foundCount: number | undefined;
     readonly results: SmartEnrichmentResource[];
-    constructor(jobId: string, status: SmartEnrichmentStatus, itemCount: number | undefined, completedCount: number | undefined, foundCount: number | undefined, results: SmartEnrichmentResource[]);
+    /** Which rows can be checked again and which are being rechecked (undefined on older API versions). */
+    readonly recheck: SmartEnrichmentRecheckState | undefined;
+    constructor(jobId: string, status: SmartEnrichmentStatus, itemCount: number | undefined, completedCount: number | undefined, foundCount: number | undefined, results: SmartEnrichmentResource[], 
+    /** Which rows can be checked again and which are being rechecked (undefined on older API versions). */
+    recheck?: SmartEnrichmentRecheckState | undefined);
     static fromArray(data: Record<string, unknown>): SmartEnrichmentJob;
     isProcessing(): boolean;
     /** Convenience for single lookups: the first (or only) result, if any. */
@@ -1544,6 +1613,21 @@ declare class SmartEnrichmentEndpoint {
     bulkLookup(items: SmartEnrichmentInput[], mode?: SmartEnrichmentMode): Promise<SmartEnrichmentJob>;
     /** Poll a job (single or bulk) by its id. */
     get(jobId: string): Promise<SmartEnrichmentJob>;
+    /**
+     * 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.
+     */
+    recheck(jobId: string, options?: SmartEnrichmentRecheckOptions): Promise<SmartEnrichmentRecheck>;
     /**
      * 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`.
@@ -2126,4 +2210,4 @@ declare class AuthRetryHttpClient implements HttpClientInterface {
     private injectAuthHeader;
 }
 
-export { ApiVersion, AuthEndpoint, AuthRetryHttpClient, AuthenticationException, CompanyAddress, CompanyEndpoint, type CompanyResource, ComplianceDocumentType, ComplianceEnrollment, ComplianceEnrollmentPage, ComplianceEnrollmentStatus, type ComplianceEnterpriseSize, type ComplianceInvoiceLineInput, type ComplianceInvoiceTaxInput, type ComplianceLedgerStateChangedEvent, type ComplianceLedgerWebhookObject, type ComplianceRequestService, ComplianceService, ComplianceTaxReport, ComplianceTaxReportPage, type ComplianceTaxReportRequestState, ComplianceTaxReportState, ComplianceTransaction, type ComplianceTransactionBuyerInput, type ComplianceTransactionFilters, type ComplianceTransactionInvoiceLine, type ComplianceTransactionInvoiceLineTax, ComplianceTransactionPage, type ComplianceTransactionRequestState, type ComplianceTransactionRequestType, ComplianceTransactionState, type ComplianceTransactionStateChangedEvent, ComplianceTransactionType, type ComplianceTransactionWebhookObject, type ComplianceTypeOperation, type CreateComplianceEnrollmentInput, type CreateComplianceTransactionInput, type CreateNorwayEnrollmentInput, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EReportingAccessRequestInput, EReportingEndpoint, type EReportingInterval, type EnrichmentCompletedEvent, type EnrichmentCompletedWebhookObject, type EnrichmentUpdatedEvent, type EnrichmentUpdatedWebhookObject, Environment, Environment as EnvironmentType, FetchHttpClient, type HttpClientInterface, HttpException, ImportResult, InMemoryTokenStorage, Language, type LocalTaxNumberReportOptions, LocalTaxNumberRow, type LocalTaxNumberSummary, LoginIdentifier, type NorwayEnrollmentInput, NorwegianOrgNumber, type ParsedWebhookSignatureHeader, PeppolLookupResult, PeppolLookupStatus, ProviderDocument, ProviderDocumentLine, RegistryCompany, RetryPolicy, type RetryPolicyOptions, type RevenueCountryBreakdown, type RevenueCurrencyBreakdown, type RevenueStateBreakdown, RevenueStatistics, type RevenueStatisticsFilters, type RevenueTimeBucket, type RevenueTotals, type RevenueTypeBreakdown, ScoreBreakdown, SireneLookupResult, type SmartEnrichmentAddressQuality, type SmartEnrichmentConfidenceBucket, SmartEnrichmentEndpoint, type SmartEnrichmentExportOptions, type SmartEnrichmentHistoryInput, SmartEnrichmentHistoryPage, SmartEnrichmentHistoryRow, type SmartEnrichmentHistoryStats, type SmartEnrichmentInput, SmartEnrichmentJob, SmartEnrichmentMode, type SmartEnrichmentOfficialAddress, type SmartEnrichmentOutcomeBreakdown, type SmartEnrichmentProviderVerdict, type SmartEnrichmentRejectedCandidate, SmartEnrichmentRejectionReason, SmartEnrichmentResource, type SmartEnrichmentSourceBreakdown, SmartEnrichmentStatistics, type SmartEnrichmentStatisticsInterval, type SmartEnrichmentStatisticsOptions, type SmartEnrichmentStatisticsRange, type SmartEnrichmentStatisticsTotals, SmartEnrichmentStatus, type SmartEnrichmentTaxNumberSource, type SmartEnrichmentTimeBucket, type SmartEnrichmentUsage, type SmartEnrichmentUsageHistoryEntry, type SmartEnrichmentWaitOptions, TaxoraClient, TaxoraClientFactory, type TaxoraClientOptions, TaxoraException, type TaxoraWebhookEvent, type TestWebhookObject, Token, type TokenStorageInterface, type UpdateComplianceTransactionInput, ValidationException, VatCertificateExport, VatCollection, VatEndpoint, type VatRate, VatRates, VatResource, VatState, type VatStateChangedEvent, type VatValidatedEvent, VatValidationAddressInput, type VatWebhookObject, WEBHOOK_ID_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEventEnvelope, type WebhookEventType, type WebhookRawBody, type WebhookSignatureErrorReason, type WebhookSignatureHeaderInput, WebhookSignatureVerificationError, type WebhookTestEvent, type WebhookVerifyOptions, computeWebhookSignature, constructWebhookEvent, describeApiError, describeComplianceDocumentType, describeComplianceEnrollmentStatus, describeComplianceService, describeComplianceTaxReportState, describeComplianceTransactionState, describeComplianceTransactionType, describePeppolLookupStatus, describeSmartEnrichmentMode, describeSmartEnrichmentRejectionReason, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseLocalTaxNumbersCsv, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, toSmartEnrichmentRejectionReason, toSmartEnrichmentStatus, verifyWebhookSignature };
+export { ApiVersion, AuthEndpoint, AuthRetryHttpClient, AuthenticationException, CompanyAddress, CompanyEndpoint, type CompanyResource, ComplianceDocumentType, ComplianceEnrollment, ComplianceEnrollmentPage, ComplianceEnrollmentStatus, type ComplianceEnterpriseSize, type ComplianceInvoiceLineInput, type ComplianceInvoiceTaxInput, type ComplianceLedgerStateChangedEvent, type ComplianceLedgerWebhookObject, type ComplianceRequestService, ComplianceService, ComplianceTaxReport, ComplianceTaxReportPage, type ComplianceTaxReportRequestState, ComplianceTaxReportState, ComplianceTransaction, type ComplianceTransactionBuyerInput, type ComplianceTransactionFilters, type ComplianceTransactionInvoiceLine, type ComplianceTransactionInvoiceLineTax, ComplianceTransactionPage, type ComplianceTransactionRequestState, type ComplianceTransactionRequestType, ComplianceTransactionState, type ComplianceTransactionStateChangedEvent, ComplianceTransactionType, type ComplianceTransactionWebhookObject, type ComplianceTypeOperation, type CreateComplianceEnrollmentInput, type CreateComplianceTransactionInput, type CreateNorwayEnrollmentInput, DEFAULT_WEBHOOK_TOLERANCE_SECONDS, type EReportingAccessRequestInput, EReportingEndpoint, type EReportingInterval, type EnrichmentCompletedEvent, type EnrichmentCompletedWebhookObject, type EnrichmentUpdatedEvent, type EnrichmentUpdatedWebhookObject, Environment, Environment as EnvironmentType, FetchHttpClient, type HttpClientInterface, HttpException, ImportResult, InMemoryTokenStorage, Language, type LocalTaxNumberReportOptions, LocalTaxNumberRow, type LocalTaxNumberSummary, LoginIdentifier, type NorwayEnrollmentInput, NorwegianOrgNumber, type ParsedWebhookSignatureHeader, PeppolLookupResult, PeppolLookupStatus, ProviderDocument, ProviderDocumentLine, RegistryCompany, RetryPolicy, type RetryPolicyOptions, type RevenueCountryBreakdown, type RevenueCurrencyBreakdown, type RevenueStateBreakdown, RevenueStatistics, type RevenueStatisticsFilters, type RevenueTimeBucket, type RevenueTotals, type RevenueTypeBreakdown, ScoreBreakdown, SireneLookupResult, type SmartEnrichmentAddressQuality, type SmartEnrichmentConfidenceBucket, SmartEnrichmentEndpoint, type SmartEnrichmentExportOptions, type SmartEnrichmentHistoryInput, SmartEnrichmentHistoryPage, SmartEnrichmentHistoryRow, type SmartEnrichmentHistoryStats, type SmartEnrichmentInput, SmartEnrichmentJob, SmartEnrichmentMode, type SmartEnrichmentOfficialAddress, type SmartEnrichmentOutcomeBreakdown, type SmartEnrichmentProviderVerdict, SmartEnrichmentRecheck, type SmartEnrichmentRecheckOptions, type SmartEnrichmentRecheckRun, type SmartEnrichmentRecheckRunState, type SmartEnrichmentRecheckSkipReason, SmartEnrichmentRecheckState, type SmartEnrichmentRejectedCandidate, SmartEnrichmentRejectionReason, SmartEnrichmentResource, type SmartEnrichmentSourceBreakdown, SmartEnrichmentStatistics, type SmartEnrichmentStatisticsInterval, type SmartEnrichmentStatisticsOptions, type SmartEnrichmentStatisticsRange, type SmartEnrichmentStatisticsTotals, SmartEnrichmentStatus, type SmartEnrichmentTaxNumberSource, type SmartEnrichmentTimeBucket, type SmartEnrichmentUsage, type SmartEnrichmentUsageHistoryEntry, type SmartEnrichmentWaitOptions, TaxoraClient, TaxoraClientFactory, type TaxoraClientOptions, TaxoraException, type TaxoraWebhookEvent, type TestWebhookObject, Token, type TokenStorageInterface, type UpdateComplianceTransactionInput, ValidationException, VatCertificateExport, VatCollection, VatEndpoint, type VatRate, VatRates, VatResource, VatState, type VatStateChangedEvent, type VatValidatedEvent, VatValidationAddressInput, type VatWebhookObject, WEBHOOK_ID_HEADER, WEBHOOK_SIGNATURE_HEADER, type WebhookEventEnvelope, type WebhookEventType, type WebhookRawBody, type WebhookSignatureErrorReason, type WebhookSignatureHeaderInput, WebhookSignatureVerificationError, type WebhookTestEvent, type WebhookVerifyOptions, computeWebhookSignature, constructWebhookEvent, describeApiError, describeComplianceDocumentType, describeComplianceEnrollmentStatus, describeComplianceService, describeComplianceTaxReportState, describeComplianceTransactionState, describeComplianceTransactionType, describePeppolLookupStatus, describeSmartEnrichmentMode, describeSmartEnrichmentRejectionReason, describeSmartEnrichmentStatus, describeVatState, generateWebhookSignatureHeader, getBaseUrl, getFailedVatStates, parseLocalTaxNumbersCsv, parseWebhookSignatureHeader, toComplianceDocumentType, toComplianceEnrollmentStatus, toComplianceService, toComplianceTaxReportState, toComplianceTransactionState, toComplianceTransactionType, toPeppolLookupStatus, toSmartEnrichmentMode, toSmartEnrichmentRejectionReason, toSmartEnrichmentStatus, verifyWebhookSignature };

package/dist/index.js

@@ -2201,6 +2201,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",
@@ -2330,7 +2397,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;
@@ -2355,6 +2422,8 @@ var SmartEnrichmentResource = class _SmartEnrichmentResource {
     this.taxNumberType = taxNumberType;
     this.taxNumberLabel = taxNumberLabel;
     this.taxNumberSource = taxNumberSource;
+    this.recheckCount = recheckCount;
+    this.lastRecheckedAt = lastRecheckedAt;
   }
   status;
   vatNumber;
@@ -2380,6 +2449,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";
@@ -2430,7 +2501,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() {
@@ -2458,20 +2531,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;
@@ -2479,6 +2555,7 @@ var SmartEnrichmentJob = class _SmartEnrichmentJob {
   completedCount;
   foundCount;
   results;
+  recheck;
   static fromArray(data) {
     const num = (key) => {
       const v = data[key];
@@ -2496,7 +2573,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() {
@@ -2742,6 +2820,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`.
@@ -2946,7 +3059,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",
@@ -3916,7 +4029,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";
@@ -4146,6 +4259,8 @@ export {
   SmartEnrichmentHistoryRow,
   SmartEnrichmentJob,
   SmartEnrichmentMode,
+  SmartEnrichmentRecheck,
+  SmartEnrichmentRecheckState,
   SmartEnrichmentRejectionReason,
   SmartEnrichmentResource,
   SmartEnrichmentStatistics,