@fin.cx/opendata 4.2.0 → 4.3.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@fin.cx/opendata',
-    version: '4.2.0',
+    version: '4.3.0',
     description: 'Open business and financial data for TypeScript: register lookups on the German register portal (handelsregister.de) without storage, the statutory public holidays of the German federal states, the base rate of § 247 BGB, and stock and crypto prices and fundamentals from several providers.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxrQkFBa0I7SUFDeEIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLG9TQUFvUztDQUNsVCxDQUFBIn0=

package/dist_ts/vatid/classes.evatrclient.d.ts

@@ -0,0 +1,15 @@
+import type { IEvatrConfirmation, IEvatrConfirmationInput, IVatIdClientOptions, IVatIdTraderData } from './interfaces.js';
+/**
+ * The BZSt's confirmation of foreign VAT IDs (§ 18e Nr. 1 UStG) over its eVatR REST API
+ * (`https://api.evatr.vies.bzst.de/api-docs`). A simple confirmation says whether a VAT ID is valid
+ * when asked; a qualified one also compares the business's name, city, and where given street and
+ * postal code with what its member state registered. The BZSt confirms to a business with a German
+ * VAT ID of its own, which every request names. Nothing is kept: each answer goes to the caller.
+ */
+export declare class EvatrClient {
+    private readonly options;
+    constructor(options?: IVatIdClientOptions);
+    confirm(inputArg: IEvatrConfirmationInput): Promise<IEvatrConfirmation>;
+}
+/** The business data as a qualified confirmation sends it: trimmed, with the name and the city required. */
+export declare const traderOf: (traderArg: IVatIdTraderData) => IVatIdTraderData | undefined;

package/dist_ts/vatid/classes.evatrclient.js

@@ -0,0 +1,169 @@
+import { VatIdError } from './classes.vatiderror.js';
+import { evatrBaseUrl, evatrConfirmationPath, evatrStatusCodes } from './constants.js';
+import { postJson, textField } from './request.js';
+import { splitVatId } from './vatid.js';
+/** The status codes that are an answer about the VAT ID asked about, and whether they say it is valid. */
+const ANSWERS = {
+    'evatr-0000': true,
+    'evatr-2008': true,
+    'evatr-2001': false,
+    'evatr-2002': false,
+    'evatr-2006': false,
+};
+/** What every other status code means for the caller (`VatIdError`). */
+const REFUSALS = {
+    'evatr-0001': 'invalid_input',
+    'evatr-0002': 'invalid_input',
+    'evatr-0003': 'invalid_input',
+    'evatr-0004': 'requester_invalid',
+    'evatr-0005': 'vat_id_malformed',
+    'evatr-0006': 'not_permitted',
+    'evatr-0007': 'invalid_input',
+    'evatr-0008': 'qualified_limit_reached',
+    'evatr-0011': 'unavailable',
+    'evatr-0012': 'vat_id_malformed',
+    'evatr-0013': 'unavailable',
+    'evatr-1001': 'unavailable',
+    'evatr-1002': 'unavailable',
+    'evatr-1003': 'unavailable',
+    'evatr-1004': 'unavailable',
+    'evatr-2003': 'vat_id_malformed',
+    'evatr-2004': 'unavailable',
+    'evatr-2005': 'requester_invalid',
+    'evatr-2007': 'member_state_unavailable',
+    'evatr-2011': 'unavailable',
+    'evatr-3011': 'unavailable',
+};
+const FIELD_RESULTS = ['A', 'B', 'C', 'D'];
+const fieldResult = (bodyArg, keyArg) => {
+    const value = textField(bodyArg, keyArg);
+    return value !== undefined && FIELD_RESULTS.includes(value) ? value : undefined;
+};
+/**
+ * The BZSt's confirmation of foreign VAT IDs (§ 18e Nr. 1 UStG) over its eVatR REST API
+ * (`https://api.evatr.vies.bzst.de/api-docs`). A simple confirmation says whether a VAT ID is valid
+ * when asked; a qualified one also compares the business's name, city, and where given street and
+ * postal code with what its member state registered. The BZSt confirms to a business with a German
+ * VAT ID of its own, which every request names. Nothing is kept: each answer goes to the caller.
+ */
+export class EvatrClient {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async confirm(inputArg) {
+        const requester = splitVatId(inputArg.requesterVatId);
+        if (!requester || requester.countryCode !== 'DE') {
+            throw new VatIdError('invalid_input', 'the requester is named by its German VAT ID', { service: 'bzst-evatr', field: 'requesterVatId' });
+        }
+        const asked = splitVatId(inputArg.vatId);
+        if (!asked) {
+            throw new VatIdError('invalid_input', 'the VAT ID asked about starts with no member state\'s code', { service: 'bzst-evatr', field: 'vatId' });
+        }
+        const trader = inputArg.trader ? traderOf(inputArg.trader) : undefined;
+        if (inputArg.trader && !trader) {
+            throw new VatIdError('invalid_input', 'a qualified confirmation needs the name and the city', { service: 'bzst-evatr', field: 'trader' });
+        }
+        const answer = await postJson(this.options, 'bzst-evatr', `${this.options.baseUrl ?? evatrBaseUrl}${evatrConfirmationPath}`, {
+            anfragendeUstid: requester.vatId,
+            angefragteUstid: asked.vatId,
+            ...(trader
+                ? {
+                    firmenname: trader.name,
+                    ort: trader.city,
+                    ...(trader.street ? { strasse: trader.street } : {}),
+                    ...(trader.postalCode ? { plz: trader.postalCode } : {}),
+                }
+                : {}),
+        }, inputArg.signal);
+        const status = textField(answer.body, 'status');
+        if (!status || !evatrStatusCodes.includes(status)) {
+            throw new VatIdError('unexpected_answer', `the BZSt answered HTTP ${answer.httpStatus} without a status it documents`, {
+                service: 'bzst-evatr',
+                httpStatus: answer.httpStatus,
+                ...(status ? { serviceCode: status } : {}),
+                answer: answer.answer,
+            });
+        }
+        const code = status;
+        const valid = ANSWERS[code];
+        if (valid === undefined) {
+            throw new VatIdError(REFUSALS[code] ?? 'unexpected_answer', `the BZSt answered ${code}`, {
+                service: 'bzst-evatr',
+                serviceCode: code,
+                httpStatus: answer.httpStatus,
+                answer: answer.answer,
+            });
+        }
+        const requestedAt = textField(answer.body, 'anfrageZeitpunkt');
+        const requestedAtMs = requestedAt ? Date.parse(requestedAt) : Number.NaN;
+        if (!requestedAt || Number.isNaN(requestedAtMs)) {
+            throw new VatIdError('unexpected_answer', 'the BZSt answered without the moment of the request', {
+                service: 'bzst-evatr',
+                serviceCode: code,
+                httpStatus: answer.httpStatus,
+                answer: answer.answer,
+            });
+        }
+        const requestId = textField(answer.body, 'id');
+        const validFrom = textField(answer.body, 'gueltigAb');
+        const validTo = textField(answer.body, 'gueltigBis');
+        const qualified = trader && valid ? qualifiedResultOf(trader, code, answer.body) : undefined;
+        if (qualified === null) {
+            // a qualified request answered valid without a result for each field sent would read as a simple
+            // confirmation; it is refused instead of being passed on as one
+            throw new VatIdError('unexpected_answer', `the BZSt answered ${code} to a qualified request without a documented result for each field sent`, {
+                service: 'bzst-evatr',
+                serviceCode: code,
+                httpStatus: answer.httpStatus,
+                answer: answer.answer,
+            });
+        }
+        return {
+            service: 'bzst-evatr',
+            ...(requestId ? { requestId } : {}),
+            requestedAt,
+            requestedAtMs,
+            status: code,
+            valid,
+            ...(validFrom ? { validFrom } : {}),
+            ...(validTo ? { validTo } : {}),
+            requesterVatId: requester.vatId,
+            vatId: asked.vatId,
+            ...(qualified ? { qualified } : {}),
+            answer: answer.answer,
+        };
+    }
+}
+/**
+ * The comparison of a qualified request whose VAT ID is valid: `evatr-2008` says it has a
+ * particularity and gives no result (`answered: false`); otherwise every field sent has a documented
+ * result (`A`…`D`), or the answer is not one this client reads (`null`). A result the BZSt gives for a
+ * field not sent is kept as it is.
+ */
+const qualifiedResultOf = (traderArg, codeArg, bodyArg) => {
+    if (codeArg === 'evatr-2008') {
+        return { asked: traderArg, answered: false };
+    }
+    const name = fieldResult(bodyArg, 'ergFirmenname');
+    const city = fieldResult(bodyArg, 'ergOrt');
+    // a field not sent may still carry its result (`C`, not asked); one sent must
+    const street = fieldResult(bodyArg, 'ergStrasse');
+    const postalCode = fieldResult(bodyArg, 'ergPlz');
+    if (!name || !city || (traderArg.street && !street) || (traderArg.postalCode && !postalCode)) {
+        return null;
+    }
+    return { asked: traderArg, answered: true, name, city, ...(street ? { street } : {}), ...(postalCode ? { postalCode } : {}) };
+};
+/** The business data as a qualified confirmation sends it: trimmed, with the name and the city required. */
+export const traderOf = (traderArg) => {
+    const name = traderArg.name.trim();
+    const city = traderArg.city.trim();
+    if (!name || !city) {
+        return undefined;
+    }
+    const street = traderArg.street?.trim();
+    const postalCode = traderArg.postalCode?.trim();
+    return { name, city, ...(street ? { street } : {}), ...(postalCode ? { postalCode } : {}) };
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5ldmF0cmNsaWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3ZhdGlkL2NsYXNzZXMuZXZhdHJjbGllbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBd0IsTUFBTSx5QkFBeUIsQ0FBQztBQUMzRSxPQUFPLEVBQUUsWUFBWSxFQUFFLHFCQUFxQixFQUFFLGdCQUFnQixFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFVdkYsT0FBTyxFQUFFLFFBQVEsRUFBRSxTQUFTLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDbkQsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUV4QywwR0FBMEc7QUFDMUcsTUFBTSxPQUFPLEdBQXlEO0lBQ3BFLFlBQVksRUFBRSxJQUFJO0lBQ2xCLFlBQVksRUFBRSxJQUFJO0lBQ2xCLFlBQVksRUFBRSxLQUFLO0lBQ25CLFlBQVksRUFBRSxLQUFLO0lBQ25CLFlBQVksRUFBRSxLQUFLO0NBQ3BCLENBQUM7QUFFRix3RUFBd0U7QUFDeEUsTUFBTSxRQUFRLEdBQWlFO0lBQzdFLFlBQVksRUFBRSxlQUFlO0lBQzdCLFlBQVksRUFBRSxlQUFlO0lBQzdCLFlBQVksRUFBRSxlQUFlO0lBQzdCLFlBQVksRUFBRSxtQkFBbUI7SUFDakMsWUFBWSxFQUFFLGtCQUFrQjtJQUNoQyxZQUFZLEVBQUUsZUFBZTtJQUM3QixZQUFZLEVBQUUsZUFBZTtJQUM3QixZQUFZLEVBQUUseUJBQXlCO0lBQ3ZDLFlBQVksRUFBRSxhQUFhO0lBQzNCLFlBQVksRUFBRSxrQkFBa0I7SUFDaEMsWUFBWSxFQUFFLGFBQWE7SUFDM0IsWUFBWSxFQUFFLGFBQWE7SUFDM0IsWUFBWSxFQUFFLGFBQWE7SUFDM0IsWUFBWSxFQUFFLGFBQWE7SUFDM0IsWUFBWSxFQUFFLGFBQWE7SUFDM0IsWUFBWSxFQUFFLGtCQUFrQjtJQUNoQyxZQUFZLEVBQUUsYUFBYTtJQUMzQixZQUFZLEVBQUUsbUJBQW1CO0lBQ2pDLFlBQVksRUFBRSwwQkFBMEI7SUFDeEMsWUFBWSxFQUFFLGFBQWE7SUFDM0IsWUFBWSxFQUFFLGFBQWE7Q0FDNUIsQ0FBQztBQUVGLE1BQU0sYUFBYSxHQUFpQyxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsQ0FBQyxDQUFDO0FBRXpFLE1BQU0sV0FBVyxHQUFHLENBQUMsT0FBZ0IsRUFBRSxNQUFjLEVBQWlDLEVBQUU7SUFDdEYsTUFBTSxLQUFLLEdBQUcsU0FBUyxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQztJQUN6QyxPQUFPLEtBQUssS0FBSyxTQUFTLElBQUssYUFBbUMsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFFLEtBQTJCLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztBQUNoSSxDQUFDLENBQUM7QUFFRjs7Ozs7O0dBTUc7QUFDSCxNQUFNLE9BQU8sV0FBVztJQUNPO0lBQTdCLFlBQTZCLFVBQStCLEVBQUU7UUFBakMsWUFBTyxHQUFQLE9BQU8sQ0FBMEI7SUFBRyxDQUFDO0lBRTNELEtBQUssQ0FBQyxPQUFPLENBQUMsUUFBaUM7UUFDcEQsTUFBTSxTQUFTLEdBQUcsVUFBVSxDQUFDLFFBQVEsQ0FBQyxjQUFjLENBQUMsQ0FBQztRQUN0RCxJQUFJLENBQUMsU0FBUyxJQUFJLFNBQVMsQ0FBQyxXQUFXLEtBQUssSUFBSSxFQUFFLENBQUM7WUFDakQsTUFBTSxJQUFJLFVBQVUsQ0FBQyxlQUFlLEVBQUUsNkNBQTZDLEVBQUUsRUFBRSxPQUFPLEVBQUUsWUFBWSxFQUFFLEtBQUssRUFBRSxnQkFBZ0IsRUFBRSxDQUFDLENBQUM7UUFDM0ksQ0FBQztRQUNELE1BQU0sS0FBSyxHQUFHLFVBQVUsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDekMsSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1lBQ1gsTUFBTSxJQUFJLFVBQVUsQ0FBQyxlQUFlLEVBQUUsNERBQTRELEVBQUUsRUFBRSxPQUFPLEVBQUUsWUFBWSxFQUFFLEtBQUssRUFBRSxPQUFPLEVBQUUsQ0FBQyxDQUFDO1FBQ2pKLENBQUM7UUFDRCxNQUFNLE1BQU0sR0FBRyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUM7UUFDdkUsSUFBSSxRQUFRLENBQUMsTUFBTSxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDL0IsTUFBTSxJQUFJLFVBQVUsQ0FBQyxlQUFlLEVBQUUsc0RBQXNELEVBQUUsRUFBRSxPQUFPLEVBQUUsWUFBWSxFQUFFLEtBQUssRUFBRSxRQUFRLEVBQUUsQ0FBQyxDQUFDO1FBQzVJLENBQUM7UUFDRCxNQUFNLE1BQU0sR0FBRyxNQUFNLFFBQVEsQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLFlBQVksRUFBRSxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxJQUFJLFlBQVksR0FBRyxxQkFBcUIsRUFBRSxFQUFFO1lBQzNILGVBQWUsRUFBRSxTQUFTLENBQUMsS0FBSztZQUNoQyxlQUFlLEVBQUUsS0FBSyxDQUFDLEtBQUs7WUFDNUIsR0FBRyxDQUFDLE1BQU07Z0JBQ1IsQ0FBQyxDQUFDO29CQUNBLFVBQVUsRUFBRSxNQUFNLENBQUMsSUFBSTtvQkFDdkIsR0FBRyxFQUFFLE1BQU0sQ0FBQyxJQUFJO29CQUNoQixHQUFHLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxPQUFPLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7b0JBQ3BELEdBQUcsQ0FBQyxNQUFNLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxFQUFFLEdBQUcsRUFBRSxNQUFNLENBQUMsVUFBVSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztpQkFDekQ7Z0JBQ0QsQ0FBQyxDQUFDLEVBQUUsQ0FBQztTQUNSLEVBQUUsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDO1FBQ3BCLE1BQU0sTUFBTSxHQUFHLFNBQVMsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLFFBQVEsQ0FBQyxDQUFDO1FBQ2hELElBQUksQ0FBQyxNQUFNLElBQUksQ0FBRSxnQkFBc0MsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztZQUN6RSxNQUFNLElBQUksVUFBVSxDQUFDLG1CQUFtQixFQUFFLDBCQUEwQixNQUFNLENBQUMsVUFBVSxnQ0FBZ0MsRUFBRTtnQkFDckgsT0FBTyxFQUFFLFlBQVk7Z0JBQ3JCLFVBQVUsRUFBRSxNQUFNLENBQUMsVUFBVTtnQkFDN0IsR0FBRyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxXQUFXLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDMUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNO2FBQ3RCLENBQUMsQ0FBQztRQUNMLENBQUM7UUFDRCxNQUFNLElBQUksR0FBRyxNQUEwQixDQUFDO1FBQ3hDLE1BQU0sS0FBSyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUM1QixJQUFJLEtBQUssS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUN4QixNQUFNLElBQUksVUFBVSxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMsSUFBSSxtQkFBbUIsRUFBRSxxQkFBcUIsSUFBSSxFQUFFLEVBQUU7Z0JBQ3ZGLE9BQU8sRUFBRSxZQUFZO2dCQUNyQixXQUFXLEVBQUUsSUFBSTtnQkFDakIsVUFBVSxFQUFFLE1BQU0sQ0FBQyxVQUFVO2dCQUM3QixNQUFNLEVBQUUsTUFBTSxDQUFDLE1BQU07YUFDdEIsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztRQUNELE1BQU0sV0FBVyxHQUFHLFNBQVMsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLGtCQUFrQixDQUFDLENBQUM7UUFDL0QsTUFBTSxhQUFhLEdBQUcsV0FBVyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDO1FBQ3pFLElBQUksQ0FBQyxXQUFXLElBQUksTUFBTSxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsRUFBRSxDQUFDO1lBQ2hELE1BQU0sSUFBSSxVQUFVLENBQUMsbUJBQW1CLEVBQUUscURBQXFELEVBQUU7Z0JBQy9GLE9BQU8sRUFBRSxZQUFZO2dCQUNyQixXQUFXLEVBQUUsSUFBSTtnQkFDakIsVUFBVSxFQUFFLE1BQU0sQ0FBQyxVQUFVO2dCQUM3QixNQUFNLEVBQUUsTUFBTSxDQUFDLE1BQU07YUFDdEIsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztRQUNELE1BQU0sU0FBUyxHQUFHLFNBQVMsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxDQUFDO1FBQy9DLE1BQU0sU0FBUyxHQUFHLFNBQVMsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLFdBQVcsQ0FBQyxDQUFDO1FBQ3RELE1BQU0sT0FBTyxHQUFHLFNBQVMsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLFlBQVksQ0FBQyxDQUFDO1FBQ3JELE1BQU0sU0FBUyxHQUFHLE1BQU0sSUFBSSxLQUFLLENBQUMsQ0FBQyxDQUFDLGlCQUFpQixDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUM7UUFDN0YsSUFBSSxTQUFTLEtBQUssSUFBSSxFQUFFLENBQUM7WUFDdkIsaUdBQWlHO1lBQ2pHLGdFQUFnRTtZQUNoRSxNQUFNLElBQUksVUFBVSxDQUFDLG1CQUFtQixFQUFFLHFCQUFxQixJQUFJLHlFQUF5RSxFQUFFO2dCQUM1SSxPQUFPLEVBQUUsWUFBWTtnQkFDckIsV0FBVyxFQUFFLElBQUk7Z0JBQ2pCLFVBQVUsRUFBRSxNQUFNLENBQUMsVUFBVTtnQkFDN0IsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNO2FBQ3RCLENBQUMsQ0FBQztRQUNMLENBQUM7UUFDRCxPQUFPO1lBQ0wsT0FBTyxFQUFFLFlBQVk7WUFDckIsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsRUFBRSxTQUFTLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1lBQ25DLFdBQVc7WUFDWCxhQUFhO1lBQ2IsTUFBTSxFQUFFLElBQW9DO1lBQzVDLEtBQUs7WUFDTCxHQUFHLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQyxFQUFFLFNBQVMsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7WUFDbkMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFBRSxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1lBQy9CLGNBQWMsRUFBRSxTQUFTLENBQUMsS0FBSztZQUMvQixLQUFLLEVBQUUsS0FBSyxDQUFDLEtBQUs7WUFDbEIsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsRUFBRSxTQUFTLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1lBQ25DLE1BQU0sRUFBRSxNQUFNLENBQUMsTUFBTTtTQUN0QixDQUFDO0lBQ0osQ0FBQztDQUNGO0FBRUQ7Ozs7O0dBS0c7QUFDSCxNQUFNLGlCQUFpQixHQUFHLENBQUMsU0FBMkIsRUFBRSxPQUF5QixFQUFFLE9BQWdCLEVBQWdDLEVBQUU7SUFDbkksSUFBSSxPQUFPLEtBQUssWUFBWSxFQUFFLENBQUM7UUFDN0IsT0FBTyxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUUsUUFBUSxFQUFFLEtBQUssRUFBRSxDQUFDO0lBQy9DLENBQUM7SUFDRCxNQUFNLElBQUksR0FBRyxXQUFXLENBQUMsT0FBTyxFQUFFLGVBQWUsQ0FBQyxDQUFDO0lBQ25ELE1BQU0sSUFBSSxHQUFHLFdBQVcsQ0FBQyxPQUFPLEVBQUUsUUFBUSxDQUFDLENBQUM7SUFDNUMsOEVBQThFO0lBQzlFLE1BQU0sTUFBTSxHQUFHLFdBQVcsQ0FBQyxPQUFPLEVBQUUsWUFBWSxDQUFDLENBQUM7SUFDbEQsTUFBTSxVQUFVLEdBQUcsV0FBVyxDQUFDLE9BQU8sRUFBRSxRQUFRLENBQUMsQ0FBQztJQUNsRCxJQUFJLENBQUMsSUFBSSxJQUFJLENBQUMsSUFBSSxJQUFJLENBQUMsU0FBUyxDQUFDLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLFVBQVUsSUFBSSxDQUFDLFVBQVUsQ0FBQyxFQUFFLENBQUM7UUFDN0YsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBQ0QsT0FBTyxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUUsUUFBUSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLEdBQUcsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEdBQUcsQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLEVBQUUsVUFBVSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUM7QUFDaEksQ0FBQyxDQUFDO0FBRUYsNEdBQTRHO0FBQzVHLE1BQU0sQ0FBQyxNQUFNLFFBQVEsR0FBRyxDQUFDLFNBQTJCLEVBQWdDLEVBQUU7SUFDcEYsTUFBTSxJQUFJLEdBQUcsU0FBUyxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztJQUNuQyxNQUFNLElBQUksR0FBRyxTQUFTLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO0lBQ25DLElBQUksQ0FBQyxJQUFJLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNuQixPQUFPLFNBQVMsQ0FBQztJQUNuQixDQUFDO0lBQ0QsTUFBTSxNQUFNLEdBQUcsU0FBUyxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsQ0FBQztJQUN4QyxNQUFNLFVBQVUsR0FBRyxTQUFTLENBQUMsVUFBVSxFQUFFLElBQUksRUFBRSxDQUFDO0lBQ2hELE9BQU8sRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLEdBQUcsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEdBQUcsQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLEVBQUUsVUFBVSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUM7QUFDOUYsQ0FBQyxDQUFDIn0=

package/dist_ts/vatid/classes.vatiderror.d.ts

@@ -0,0 +1,51 @@
+import type { IVatIdServiceAnswer } from './interfaces.js';
+/**
+ * Why a VAT ID could not be confirmed. Every code means that the service gave no answer about the
+ * validity of the VAT ID asked about:
+ * - `invalid_input`: what was asked is incomplete or not a VAT ID of a member state (checked before
+ *   sending, or refused by the service: eVatR `evatr-0002`, `evatr-0003`, `evatr-0007`, VIES
+ *   `INVALID_INPUT`);
+ * - `vat_id_malformed`: the service says the VAT ID asked about does not have the form its member
+ *   state gives (eVatR `evatr-0005`, `evatr-0012`, `evatr-2003`);
+ * - `requester_invalid`: the requester's own VAT ID is malformed or not valid (eVatR `evatr-0004`,
+ *   `evatr-2005`, VIES `INVALID_REQUESTER_INFO`);
+ * - `not_permitted`: a German VAT ID asked about by a German one (eVatR `evatr-0006`);
+ * - `qualified_limit_reached`: the qualified confirmations of this session are used up (eVatR
+ *   `evatr-0008`); a simple one is still possible;
+ * - `unavailable`: the service cannot answer now (eVatR `evatr-0011`, `-0013`, `-1001`…`-1004`,
+ *   `-2004`, `-2011`, `-3011`; VIES `SERVICE_UNAVAILABLE`);
+ * - `member_state_unavailable`: the member state's system did not answer or failed (eVatR
+ *   `evatr-2007`; VIES `MS_UNAVAILABLE`, `TIMEOUT`);
+ * - `busy`: too many requests at once (VIES `GLOBAL_MAX_CONCURRENT_REQ`, `MS_MAX_CONCURRENT_REQ`
+ *   and their `_TIME` forms);
+ * - `blocked`: the service blocks this address or this VAT ID (VIES `IP_BLOCKED`, `VAT_BLOCKED`);
+ * - `unreachable`: no answer arrived — the name, the connection or TLS failed;
+ * - `timeout`: the answer did not arrive within the client's time;
+ * - `aborted`: the caller's signal ended the request;
+ * - `unexpected_answer`: an answer this client cannot read, or a status it does not know.
+ */
+export type TVatIdErrorCode = 'invalid_input' | 'vat_id_malformed' | 'requester_invalid' | 'not_permitted' | 'qualified_limit_reached' | 'unavailable' | 'member_state_unavailable' | 'busy' | 'blocked' | 'unreachable' | 'timeout' | 'aborted' | 'unexpected_answer';
+export interface IVatIdErrorDetails {
+    service: 'bzst-evatr' | 'vies';
+    /** the service's own code: `evatr-0008`, `MS_UNAVAILABLE` */
+    serviceCode?: string;
+    /** the HTTP status of the answer, where one arrived */
+    httpStatus?: number;
+    /** which input a local check refused */
+    field?: 'requesterVatId' | 'vatId' | 'trader';
+    /** the answer as it arrived, where one did */
+    answer?: IVatIdServiceAnswer;
+}
+/** The typed error of the VAT ID clients. */
+export declare class VatIdError extends Error {
+    readonly code: TVatIdErrorCode;
+    readonly service: IVatIdErrorDetails['service'];
+    readonly serviceCode?: string;
+    readonly httpStatus?: number;
+    readonly field?: IVatIdErrorDetails['field'];
+    /** the answer as it arrived, where one did: a refusal, or an answer this client cannot read */
+    readonly answer?: IVatIdServiceAnswer;
+    constructor(code: TVatIdErrorCode, message: string, detailsArg: IVatIdErrorDetails, options?: {
+        cause?: unknown;
+    });
+}

package/dist_ts/vatid/classes.vatiderror.js

@@ -0,0 +1,29 @@
+/** The typed error of the VAT ID clients. */
+export class VatIdError extends Error {
+    code;
+    service;
+    serviceCode;
+    httpStatus;
+    field;
+    /** the answer as it arrived, where one did: a refusal, or an answer this client cannot read */
+    answer;
+    constructor(code, message, detailsArg, options) {
+        super(message, options);
+        this.name = 'VatIdError';
+        this.code = code;
+        this.service = detailsArg.service;
+        if (detailsArg.serviceCode !== undefined) {
+            this.serviceCode = detailsArg.serviceCode;
+        }
+        if (detailsArg.httpStatus !== undefined) {
+            this.httpStatus = detailsArg.httpStatus;
+        }
+        if (detailsArg.field !== undefined) {
+            this.field = detailsArg.field;
+        }
+        if (detailsArg.answer !== undefined) {
+            this.answer = detailsArg.answer;
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy52YXRpZGVycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvdmF0aWQvY2xhc3Nlcy52YXRpZGVycm9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQXNEQSw2Q0FBNkM7QUFDN0MsTUFBTSxPQUFPLFVBQVcsU0FBUSxLQUFLO0lBQ25CLElBQUksQ0FBa0I7SUFDdEIsT0FBTyxDQUFnQztJQUN2QyxXQUFXLENBQVU7SUFDckIsVUFBVSxDQUFVO0lBQ3BCLEtBQUssQ0FBK0I7SUFDcEQsK0ZBQStGO0lBQy9FLE1BQU0sQ0FBdUI7SUFFN0MsWUFBWSxJQUFxQixFQUFFLE9BQWUsRUFBRSxVQUE4QixFQUFFLE9BQTZCO1FBQy9HLEtBQUssQ0FBQyxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDeEIsSUFBSSxDQUFDLElBQUksR0FBRyxZQUFZLENBQUM7UUFDekIsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUM7UUFDakIsSUFBSSxDQUFDLE9BQU8sR0FBRyxVQUFVLENBQUMsT0FBTyxDQUFDO1FBQ2xDLElBQUksVUFBVSxDQUFDLFdBQVcsS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUN6QyxJQUFJLENBQUMsV0FBVyxHQUFHLFVBQVUsQ0FBQyxXQUFXLENBQUM7UUFDNUMsQ0FBQztRQUNELElBQUksVUFBVSxDQUFDLFVBQVUsS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUN4QyxJQUFJLENBQUMsVUFBVSxHQUFHLFVBQVUsQ0FBQyxVQUFVLENBQUM7UUFDMUMsQ0FBQztRQUNELElBQUksVUFBVSxDQUFDLEtBQUssS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUNuQyxJQUFJLENBQUMsS0FBSyxHQUFHLFVBQVUsQ0FBQyxLQUFLLENBQUM7UUFDaEMsQ0FBQztRQUNELElBQUksVUFBVSxDQUFDLE1BQU0sS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUNwQyxJQUFJLENBQUMsTUFBTSxHQUFHLFVBQVUsQ0FBQyxNQUFNLENBQUM7UUFDbEMsQ0FBQztJQUNILENBQUM7Q0FDRiJ9

package/dist_ts/vatid/classes.viesclient.d.ts

@@ -0,0 +1,12 @@
+import type { IViesCheck, IViesCheckInput, IVatIdClientOptions } from './interfaces.js';
+/**
+ * The European Commission's VIES over its REST API ("Vies on-the-Web", `swagger_publicVAT.yaml`):
+ * whether a VAT ID is valid, and with the business data a comparison of each field. A request that
+ * names the requester's own VAT ID gets VIES's request identifier. Errors arrive with HTTP 200 and
+ * `actionSucceed: false`; they are thrown as `VatIdError`. Nothing is kept.
+ */
+export declare class ViesClient {
+    private readonly options;
+    constructor(options?: IVatIdClientOptions);
+    check(inputArg: IViesCheckInput): Promise<IViesCheck>;
+}

package/dist_ts/vatid/classes.viesclient.js

@@ -0,0 +1,118 @@
+import { VatIdError } from './classes.vatiderror.js';
+import { traderOf } from './classes.evatrclient.js';
+import { viesBaseUrl, viesCheckPath } from './constants.js';
+import { postJson, textField } from './request.js';
+import { splitVatId } from './vatid.js';
+/** The error codes of VIES's `errorWrappers`, as its test service answers them (read on 2026-09-27). */
+const REFUSALS = {
+    INVALID_INPUT: 'invalid_input',
+    INVALID_REQUESTER_INFO: 'requester_invalid',
+    SERVICE_UNAVAILABLE: 'unavailable',
+    MS_UNAVAILABLE: 'member_state_unavailable',
+    TIMEOUT: 'member_state_unavailable',
+    VAT_BLOCKED: 'blocked',
+    IP_BLOCKED: 'blocked',
+    GLOBAL_MAX_CONCURRENT_REQ: 'busy',
+    GLOBAL_MAX_CONCURRENT_REQ_TIME: 'busy',
+    MS_MAX_CONCURRENT_REQ: 'busy',
+    MS_MAX_CONCURRENT_REQ_TIME: 'busy',
+};
+const MATCHES = ['VALID', 'INVALID', 'NOT_PROCESSED'];
+const matchOf = (bodyArg, keyArg) => {
+    const value = textField(bodyArg, keyArg);
+    return value !== undefined && MATCHES.includes(value) ? value : undefined;
+};
+/** VIES writes `---` where a member state gives no name or address. */
+const givenText = (bodyArg, keyArg) => {
+    const value = textField(bodyArg, keyArg)?.trim();
+    return value && value !== '---' ? value : undefined;
+};
+/**
+ * The European Commission's VIES over its REST API ("Vies on-the-Web", `swagger_publicVAT.yaml`):
+ * whether a VAT ID is valid, and with the business data a comparison of each field. A request that
+ * names the requester's own VAT ID gets VIES's request identifier. Errors arrive with HTTP 200 and
+ * `actionSucceed: false`; they are thrown as `VatIdError`. Nothing is kept.
+ */
+export class ViesClient {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async check(inputArg) {
+        const asked = splitVatId(inputArg.vatId);
+        if (!asked) {
+            throw new VatIdError('invalid_input', 'the VAT ID asked about starts with no member state\'s code', { service: 'vies', field: 'vatId' });
+        }
+        const requester = inputArg.requesterVatId === undefined ? undefined : splitVatId(inputArg.requesterVatId);
+        if (inputArg.requesterVatId !== undefined && !requester) {
+            throw new VatIdError('invalid_input', 'the requester\'s VAT ID starts with no member state\'s code', { service: 'vies', field: 'requesterVatId' });
+        }
+        const trader = inputArg.trader ? traderOf(inputArg.trader) : undefined;
+        if (inputArg.trader && !trader) {
+            throw new VatIdError('invalid_input', 'a comparison needs the name and the city', { service: 'vies', field: 'trader' });
+        }
+        const answer = await postJson(this.options, 'vies', `${this.options.baseUrl ?? viesBaseUrl}${viesCheckPath}`, {
+            countryCode: asked.countryCode,
+            vatNumber: asked.number,
+            ...(requester ? { requesterMemberStateCode: requester.countryCode, requesterNumber: requester.number } : {}),
+            ...(trader
+                ? {
+                    traderName: trader.name,
+                    traderCity: trader.city,
+                    ...(trader.street ? { traderStreet: trader.street } : {}),
+                    ...(trader.postalCode ? { traderPostalCode: trader.postalCode } : {}),
+                }
+                : {}),
+        }, inputArg.signal);
+        const body = answer.body;
+        const succeeded = body && typeof body === 'object' ? Reflect.get(body, 'actionSucceed') : undefined;
+        if (succeeded === false) {
+            const wrappers = Reflect.get(body, 'errorWrappers');
+            const first = Array.isArray(wrappers) ? wrappers[0] : undefined;
+            const serviceCode = textField(first, 'error');
+            throw new VatIdError(serviceCode ? (REFUSALS[serviceCode] ?? 'unexpected_answer') : 'unexpected_answer', `VIES answered ${serviceCode ?? 'an error without a code'}`, {
+                service: 'vies',
+                httpStatus: answer.httpStatus,
+                ...(serviceCode ? { serviceCode } : {}),
+                answer: answer.answer,
+            });
+        }
+        const valid = body && typeof body === 'object' ? Reflect.get(body, 'valid') : undefined;
+        const requestedAt = textField(body, 'requestDate');
+        const requestedAtMs = requestedAt ? Date.parse(requestedAt) : Number.NaN;
+        if (answer.httpStatus !== 200 || typeof valid !== 'boolean' || !requestedAt || Number.isNaN(requestedAtMs)) {
+            throw new VatIdError('unexpected_answer', `VIES answered HTTP ${answer.httpStatus} in a form this client cannot read`, {
+                service: 'vies',
+                httpStatus: answer.httpStatus,
+                answer: answer.answer,
+            });
+        }
+        const requestId = textField(body, 'requestIdentifier');
+        const name = givenText(body, 'name') ?? givenText(body, 'traderName');
+        const address = givenText(body, 'address');
+        const compared = trader
+            ? {
+                asked: trader,
+                ...optionalMatch('name', matchOf(body, 'traderNameMatch')),
+                ...optionalMatch('street', matchOf(body, 'traderStreetMatch')),
+                ...optionalMatch('postalCode', matchOf(body, 'traderPostalCodeMatch')),
+                ...optionalMatch('city', matchOf(body, 'traderCityMatch')),
+            }
+            : undefined;
+        return {
+            service: 'vies',
+            valid,
+            requestedAt,
+            requestedAtMs,
+            ...(requestId ? { requestId } : {}),
+            vatId: asked.vatId,
+            ...(requester ? { requesterVatId: requester.vatId } : {}),
+            ...(name ? { name } : {}),
+            ...(address ? { address } : {}),
+            ...(compared ? { compared } : {}),
+            answer: answer.answer,
+        };
+    }
+}
+const optionalMatch = (keyArg, matchArg) => (matchArg ? { [keyArg]: matchArg } : {});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy52aWVzY2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvdmF0aWQvY2xhc3Nlcy52aWVzY2xpZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxVQUFVLEVBQXdCLE1BQU0seUJBQXlCLENBQUM7QUFDM0UsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3BELE9BQU8sRUFBRSxXQUFXLEVBQUUsYUFBYSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFNUQsT0FBTyxFQUFFLFFBQVEsRUFBRSxTQUFTLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDbkQsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLFlBQVksQ0FBQztBQUV4Qyx3R0FBd0c7QUFDeEcsTUFBTSxRQUFRLEdBQThDO0lBQzFELGFBQWEsRUFBRSxlQUFlO0lBQzlCLHNCQUFzQixFQUFFLG1CQUFtQjtJQUMzQyxtQkFBbUIsRUFBRSxhQUFhO0lBQ2xDLGNBQWMsRUFBRSwwQkFBMEI7SUFDMUMsT0FBTyxFQUFFLDBCQUEwQjtJQUNuQyxXQUFXLEVBQUUsU0FBUztJQUN0QixVQUFVLEVBQUUsU0FBUztJQUNyQix5QkFBeUIsRUFBRSxNQUFNO0lBQ2pDLDhCQUE4QixFQUFFLE1BQU07SUFDdEMscUJBQXFCLEVBQUUsTUFBTTtJQUM3QiwwQkFBMEIsRUFBRSxNQUFNO0NBQ25DLENBQUM7QUFFRixNQUFNLE9BQU8sR0FBMEIsQ0FBQyxPQUFPLEVBQUUsU0FBUyxFQUFFLGVBQWUsQ0FBQyxDQUFDO0FBRTdFLE1BQU0sT0FBTyxHQUFHLENBQUMsT0FBZ0IsRUFBRSxNQUFjLEVBQTBCLEVBQUU7SUFDM0UsTUFBTSxLQUFLLEdBQUcsU0FBUyxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQztJQUN6QyxPQUFPLEtBQUssS0FBSyxTQUFTLElBQUssT0FBNkIsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FB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

package/dist_ts/vatid/constants.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The BZSt's eVatR REST API (Bestätigungsverfahren of § 18e UStG), as its OpenAPI document names it
+ * (`https://api.evatr.vies.bzst.de/api-docs`, read on 2026-09-27): the server, and the path of a
+ * confirmation. The XML-RPC interface the BZSt offered before is obsolete from 30 November 2025.
+ */
+export declare const evatrBaseUrl = "https://api.evatr.vies.bzst.de/app";
+export declare const evatrConfirmationPath = "/v1/abfrage";
+/**
+ * The European Commission's "Vies on-the-Web" REST API: the base under which its contract's paths
+ * (`swagger_publicVAT.yaml`) answer, read on 2026-09-27 (`/check-status` answered there, and so did
+ * `/check-vat-test-service`). The contract itself names no host.
+ */
+export declare const viesBaseUrl = "https://ec.europa.eu/taxation_customs/vies/rest-api";
+export declare const viesCheckPath = "/check-vat-number";
+/** How long one request may take by default, the answer included. */
+export declare const defaultVatIdTimeoutMs = 30000;
+/**
+ * The country codes a VAT identification number starts with, as the eVatR API's list of member
+ * states gives them (`/v1/info/eu_mitgliedstaaten`, read on 2026-09-27): the 27 member states,
+ * Greece as `EL`, and `XI` for Northern Ireland.
+ */
+export declare const vatIdCountryCodes: readonly ["AT", "BE", "BG", "CY", "CZ", "DE", "DK", "EE", "EL", "ES", "FI", "FR", "HR", "HU", "IE", "IT", "LT", "LU", "LV", "MT", "NL", "PL", "PT", "RO", "SE", "SI", "SK", "XI"];
+/**
+ * Every status code of the eVatR API with the HTTP status its list of messages gives it
+ * (`/v1/info/statusmeldungen`, read on 2026-09-27). The OpenAPI document lists `evatr-0008` under
+ * 400 and the list under 403, so the code decides, never the HTTP status.
+ */
+export declare const evatrStatusCodes: readonly ["evatr-0000", "evatr-0001", "evatr-0002", "evatr-0003", "evatr-0004", "evatr-0005", "evatr-0006", "evatr-0007", "evatr-0008", "evatr-0011", "evatr-0012", "evatr-0013", "evatr-1001", "evatr-1002", "evatr-1003", "evatr-1004", "evatr-2001", "evatr-2002", "evatr-2003", "evatr-2004", "evatr-2005", "evatr-2006", "evatr-2007", "evatr-2008", "evatr-2011", "evatr-3011"];

package/dist_ts/vatid/constants.js

@@ -0,0 +1,37 @@
+/**
+ * The BZSt's eVatR REST API (Bestätigungsverfahren of § 18e UStG), as its OpenAPI document names it
+ * (`https://api.evatr.vies.bzst.de/api-docs`, read on 2026-09-27): the server, and the path of a
+ * confirmation. The XML-RPC interface the BZSt offered before is obsolete from 30 November 2025.
+ */
+export const evatrBaseUrl = 'https://api.evatr.vies.bzst.de/app';
+export const evatrConfirmationPath = '/v1/abfrage';
+/**
+ * The European Commission's "Vies on-the-Web" REST API: the base under which its contract's paths
+ * (`swagger_publicVAT.yaml`) answer, read on 2026-09-27 (`/check-status` answered there, and so did
+ * `/check-vat-test-service`). The contract itself names no host.
+ */
+export const viesBaseUrl = 'https://ec.europa.eu/taxation_customs/vies/rest-api';
+export const viesCheckPath = '/check-vat-number';
+/** How long one request may take by default, the answer included. */
+export const defaultVatIdTimeoutMs = 30_000;
+/**
+ * The country codes a VAT identification number starts with, as the eVatR API's list of member
+ * states gives them (`/v1/info/eu_mitgliedstaaten`, read on 2026-09-27): the 27 member states,
+ * Greece as `EL`, and `XI` for Northern Ireland.
+ */
+export const vatIdCountryCodes = [
+    'AT', 'BE', 'BG', 'CY', 'CZ', 'DE', 'DK', 'EE', 'EL', 'ES', 'FI', 'FR', 'HR', 'HU',
+    'IE', 'IT', 'LT', 'LU', 'LV', 'MT', 'NL', 'PL', 'PT', 'RO', 'SE', 'SI', 'SK', 'XI',
+];
+/**
+ * Every status code of the eVatR API with the HTTP status its list of messages gives it
+ * (`/v1/info/statusmeldungen`, read on 2026-09-27). The OpenAPI document lists `evatr-0008` under
+ * 400 and the list under 403, so the code decides, never the HTTP status.
+ */
+export const evatrStatusCodes = [
+    'evatr-0000', 'evatr-0001', 'evatr-0002', 'evatr-0003', 'evatr-0004', 'evatr-0005', 'evatr-0006',
+    'evatr-0007', 'evatr-0008', 'evatr-0011', 'evatr-0012', 'evatr-0013', 'evatr-1001', 'evatr-1002',
+    'evatr-1003', 'evatr-1004', 'evatr-2001', 'evatr-2002', 'evatr-2003', 'evatr-2004', 'evatr-2005',
+    'evatr-2006', 'evatr-2007', 'evatr-2008', 'evatr-2011', 'evatr-3011',
+];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvdmF0aWQvY29uc3RhbnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxZQUFZLEdBQUcsb0NBQW9DLENBQUM7QUFDakUsTUFBTSxDQUFDLE1BQU0scUJBQXFCLEdBQUcsYUFBYSxDQUFDO0FBRW5EOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxXQUFXLEdBQUcscURBQXFELENBQUM7QUFDakYsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFHLG1CQUFtQixDQUFDO0FBRWpELHFFQUFxRTtBQUNyRSxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyxNQUFNLENBQUM7QUFFNUM7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHO0lBQy9CLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJO0lBQ2xGLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJO0NBQzFFLENBQUM7QUFFWDs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sZ0JBQWdCLEdBQUc7SUFDOUIsWUFBWSxFQUFFLFlBQVksRUFBRSxZQUFZLEVBQUUsWUFBWSxFQUFFLFlBQVksRUFBRSxZQUFZLEVBQUUsWUFBWTtJQUNoRyxZQUFZLEVBQUUsWUFBWSxFQUFFLFlBQVksRUFBRSxZQUFZLEVBQUUsWUFBWSxFQUFFLFlBQVksRUFBRSxZQUFZO0lBQ2hHLFlBQVksRUFBRSxZQUFZLEVBQUUsWUFBWSxFQUFFLFlBQVksRUFBRSxZQUFZLEVBQUUsWUFBWSxFQUFFLFlBQVk7SUFDaEcsWUFBWSxFQUFFLFlBQVksRUFBRSxZQUFZLEVBQUUsWUFBWSxFQUFFLFlBQVk7Q0FDNUQsQ0FBQyJ9

package/dist_ts/vatid/index.d.ts

@@ -0,0 +1,6 @@
+export * from './interfaces.js';
+export { VatIdError, type IVatIdErrorDetails, type TVatIdErrorCode } from './classes.vatiderror.js';
+export { defaultVatIdTimeoutMs, evatrBaseUrl, evatrConfirmationPath, evatrStatusCodes, vatIdCountryCodes, viesBaseUrl, viesCheckPath, } from './constants.js';
+export { splitVatId } from './vatid.js';
+export { EvatrClient } from './classes.evatrclient.js';
+export { ViesClient } from './classes.viesclient.js';

package/dist_ts/vatid/index.js

@@ -0,0 +1,10 @@
+// This entry point stands alone: it imports nothing from the rest of the package and has no
+// dependencies. It keeps nothing: every answer goes to the caller, who keeps it as evidence where the
+// law asks for it.
+export * from './interfaces.js';
+export { VatIdError } from './classes.vatiderror.js';
+export { defaultVatIdTimeoutMs, evatrBaseUrl, evatrConfirmationPath, evatrStatusCodes, vatIdCountryCodes, viesBaseUrl, viesCheckPath, } from './constants.js';
+export { splitVatId } from './vatid.js';
+export { EvatrClient } from './classes.evatrclient.js';
+export { ViesClient } from './classes.viesclient.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy92YXRpZC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSw0RkFBNEY7QUFDNUYsc0dBQXNHO0FBQ3RHLG1CQUFtQjtBQUNuQixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLE9BQU8sRUFBRSxVQUFVLEVBQWlELE1BQU0seUJBQXlCLENBQUM7QUFDcEcsT0FBTyxFQUNMLHFCQUFxQixFQUNyQixZQUFZLEVBQ1oscUJBQXFCLEVBQ3JCLGdCQUFnQixFQUNoQixpQkFBaUIsRUFDakIsV0FBVyxFQUNYLGFBQWEsR0FDZCxNQUFNLGdCQUFnQixDQUFDO0FBQ3hCLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFDeEMsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQ3ZELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQyJ9