kassza 0.1.0

package/dist/validators/index.cjs

@@ -0,0 +1,296 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/validators/address.ts
+const MIN_ZIP = 1e3;
+const MAX_ZIP = 9999;
+const MAX_BUDAPEST_DISTRICT = 23;
+const ROMAN_VALUES = {
+	I: 1,
+	V: 5,
+	X: 10
+};
+function isValidHungarianZipCode(value) {
+	const trimmed = (typeof value === "number" ? String(value) : typeof value === "string" ? value : "").trim();
+	if (!/^\d{4}$/.test(trimmed)) return false;
+	const zip = Number(trimmed);
+	return zip >= MIN_ZIP && zip <= MAX_ZIP;
+}
+function romanToNumber(roman) {
+	let total = 0;
+	for (let index = 0; index < roman.length; index++) {
+		const current = ROMAN_VALUES[roman.charAt(index)] ?? 0;
+		const next = ROMAN_VALUES[roman.charAt(index + 1)] ?? 0;
+		total += current < next ? -current : current;
+	}
+	return total;
+}
+const ROMAN_DISTRICT = /^([IVX]{1,5})(?:\.\s*(?:[Kk]er(?:ület)?\.?)?|\s+[Kk]er(?:ület)?\.?)(?=[\s,]|$)/;
+const ARABIC_DISTRICT = /^(\d{1,2})\.?\s*[Kk]er(?:ület)?\.?(?=[\s,]|$)/;
+function matchDistrict(text) {
+	const roman = ROMAN_DISTRICT.exec(text);
+	const arabic = roman ? void 0 : ARABIC_DISTRICT.exec(text);
+	const match = roman ?? arabic;
+	if (!match?.[1]) return void 0;
+	const district = roman ? romanToNumber(match[1]) : Number(match[1]);
+	if (district < 1 || district > MAX_BUDAPEST_DISTRICT) return void 0;
+	return {
+		district,
+		rest: text.slice(match[0].length).replace(/^[\s,]+/, "")
+	};
+}
+function normalizeInput(value) {
+	return value.replace(/[\r\n]+/g, ", ").replace(/\s+/g, " ").replace(/\s*(?:,\s*)+/g, ", ").replace(/^(?:HU|H)\s*-\s*/i, "").replace(/,?\s*(?:Magyarország|Hungary)\.?$/i, "").replace(/^[\s,]+|[\s,]+$/g, "");
+}
+function isBudapest(city) {
+	return city.toLowerCase() === "budapest";
+}
+function splitCityAndAddress(rest) {
+	const comma = rest.indexOf(",");
+	if (comma !== -1) return {
+		city: rest.slice(0, comma).trim(),
+		address: rest.slice(comma + 1).trim()
+	};
+	const space = rest.indexOf(" ");
+	if (space === -1) return void 0;
+	return {
+		city: rest.slice(0, space),
+		address: rest.slice(space + 1).trim()
+	};
+}
+function buildAddress(zip, cityPart, addressPart) {
+	let city = cityPart.trim();
+	let address = addressPart.trim();
+	let district;
+	const cityWithDistrict = /^(\S+)\s+(.+)$/.exec(city);
+	if (cityWithDistrict?.[1] && cityWithDistrict[2] && isBudapest(cityWithDistrict[1])) {
+		const match = matchDistrict(cityWithDistrict[2]);
+		if (match && match.rest === "") {
+			city = cityWithDistrict[1];
+			district = match.district;
+		}
+	}
+	if (district === void 0 && isBudapest(city)) {
+		const match = matchDistrict(address);
+		if (match) {
+			district = match.district;
+			address = match.rest;
+		}
+	}
+	if (!isValidHungarianZipCode(zip) || !/\p{L}/u.test(city) || address === "") return void 0;
+	return district === void 0 ? {
+		zip,
+		city,
+		address
+	} : {
+		zip,
+		city,
+		address,
+		district
+	};
+}
+function parseHungarianAddress(value) {
+	if (typeof value !== "string") return void 0;
+	const text = normalizeInput(value);
+	const zipFirst = /^(\d{4}),?\s+(.+)$/.exec(text);
+	if (zipFirst?.[1] && zipFirst[2]) {
+		const parts = splitCityAndAddress(zipFirst[2]);
+		return parts ? buildAddress(zipFirst[1], parts.city, parts.address) : void 0;
+	}
+	const zipLast = /^(.+?),\s*(\d{4})\s+([^,\d][^,]*)$/.exec(text);
+	if (zipLast?.[1] && zipLast[2] && zipLast[3]) return buildAddress(zipLast[2], zipLast[3], zipLast[1]);
+}
+//#endregion
+//#region src/validators/agent-key.ts
+function isValidAgentKey(value) {
+	if (typeof value !== "string") return false;
+	const key = value.trim();
+	return key !== "" && !/\s/.test(key) && key === key.toLowerCase();
+}
+//#endregion
+//#region src/validators/digits.ts
+const SEPARATORS = /[\s-]+/g;
+function stripSeparators(value) {
+	return value.replace(SEPARATORS, "");
+}
+function isDigits(value, length) {
+	if (!/^\d+$/.test(value)) return false;
+	return length === void 0 || value.length === length;
+}
+function weightedDigitSum(digits, weights) {
+	return [...digits].reduce((sum, digit, index) => sum + Number(digit) * Number(weights[index % weights.length]), 0);
+}
+//#endregion
+//#region src/validators/bank-account.ts
+const GIRO_WEIGHTS = [
+	9,
+	7,
+	3,
+	1
+];
+const HU_IBAN_LENGTH = 28;
+function hasValidCheckDigit(block) {
+	return weightedDigitSum(block, GIRO_WEIGHTS) % 10 === 0;
+}
+function groupsOfEight(digits) {
+	return digits.match(/\d{8}/g)?.join("-") ?? digits;
+}
+function parseHungarianBankAccount(value) {
+	if (typeof value !== "string") return void 0;
+	const digits = stripSeparators(value);
+	if (!isDigits(digits, 16) && !isDigits(digits, 24)) return void 0;
+	if (!hasValidCheckDigit(digits.slice(0, 8)) || !hasValidCheckDigit(digits.slice(8))) return;
+	return {
+		digits,
+		bankCode: digits.slice(0, 3),
+		branchCode: digits.slice(3, 7),
+		formatted: groupsOfEight(digits)
+	};
+}
+function isValidHungarianBankAccount(value) {
+	return parseHungarianBankAccount(value) !== void 0;
+}
+function formatHungarianBankAccount(value) {
+	return parseHungarianBankAccount(value)?.formatted;
+}
+function ibanMod97(iban) {
+	const rearranged = `${iban.slice(4)}${iban.slice(0, 4)}`;
+	let remainder = 0;
+	for (const char of rearranged) {
+		const code = char.charCodeAt(0);
+		const chunk = code >= 65 ? String(code - 55) : char;
+		for (const digit of chunk) remainder = (remainder * 10 + Number(digit)) % 97;
+	}
+	return remainder;
+}
+function isValidHungarianIban(value) {
+	if (typeof value !== "string") return false;
+	const iban = stripSeparators(value).toUpperCase();
+	if (iban.length !== HU_IBAN_LENGTH || !iban.startsWith("HU")) return false;
+	if (!isDigits(iban.slice(2), 26)) return false;
+	return ibanMod97(iban) === 1;
+}
+//#endregion
+//#region src/validators/email.ts
+const MAX_EMAIL_LENGTH = 254;
+const EMAIL_PATTERN = /^[^\s@]+@[^\s@.]+(?:\.[^\s@.]+)+$/;
+function normalizeEmail(value) {
+	return value.trim().toLowerCase();
+}
+function isValidEmail(value) {
+	if (typeof value !== "string") return false;
+	const email = value.trim();
+	return email.length <= MAX_EMAIL_LENGTH && EMAIL_PATTERN.test(email);
+}
+//#endregion
+//#region src/validators/eu-vat.ts
+const EU_VAT_NUMBER_PATTERNS = {
+	AT: /^U\d{8}$/,
+	BE: /^[01]\d{9}$/,
+	BG: /^\d{9,10}$/,
+	CY: /^\d{8}[A-Z]$/,
+	CZ: /^\d{8,10}$/,
+	DE: /^\d{9}$/,
+	DK: /^\d{8}$/,
+	EE: /^\d{9}$/,
+	EL: /^\d{9}$/,
+	ES: /^[A-Z0-9]\d{7}[A-Z0-9]$/,
+	FI: /^\d{8}$/,
+	FR: /^[A-HJ-NP-Z0-9]{2}\d{9}$/,
+	HR: /^\d{11}$/,
+	HU: /^\d{8}$/,
+	IE: /^(?:\d{7}[A-W][A-I]?|\d[A-Z+*]\d{5}[A-W])$/,
+	IT: /^\d{11}$/,
+	LT: /^(?:\d{9}|\d{12})$/,
+	LU: /^\d{8}$/,
+	LV: /^\d{11}$/,
+	MT: /^\d{8}$/,
+	NL: /^\d{9}B\d{2}$/,
+	PL: /^\d{10}$/,
+	PT: /^\d{9}$/,
+	RO: /^[1-9]\d{1,9}$/,
+	SE: /^\d{10}01$/,
+	SI: /^\d{8}$/,
+	SK: /^\d{10}$/,
+	XI: /^(?:\d{9}|\d{12}|GD[0-4]\d{2}|HA[5-9]\d{2})$/
+};
+function isEuVatCountryPrefix(value) {
+	return Object.hasOwn(EU_VAT_NUMBER_PATTERNS, value);
+}
+function normalizeEuVatNumber(value) {
+	return value.replace(/[\s.-]+/g, "").toUpperCase();
+}
+function isValidEuVatNumber(value) {
+	if (typeof value !== "string") return false;
+	const normalized = normalizeEuVatNumber(value);
+	const prefix = normalized.slice(0, 2);
+	if (!isEuVatCountryPrefix(prefix)) return false;
+	return EU_VAT_NUMBER_PATTERNS[prefix].test(normalized.slice(2));
+}
+//#endregion
+//#region src/validators/tax-number.ts
+const TAXPAYER_ID_WEIGHTS = [
+	9,
+	7,
+	3,
+	1,
+	9,
+	7,
+	3
+];
+const HUNGARIAN_TAX_COUNTY_CODES = [
+	...Array.from({ length: 19 }, (_, index) => String(index + 2).padStart(2, "0")),
+	...Array.from({ length: 23 }, (_, index) => String(index + 22)),
+	"51"
+];
+const COUNTY_CODE_SET = new Set(HUNGARIAN_TAX_COUNTY_CODES);
+function isVatCode(value) {
+	return value >= "1" && value <= "5" && value.length === 1;
+}
+function isValidHungarianTaxpayerId(value) {
+	const digits = stripSeparators(value);
+	if (!isDigits(digits, 8)) return false;
+	return (10 - weightedDigitSum(digits.slice(0, 7), TAXPAYER_ID_WEIGHTS) % 10) % 10 === Number(digits[7]);
+}
+function parseHungarianTaxNumber(value) {
+	if (typeof value !== "string") return void 0;
+	const digits = stripSeparators(value);
+	if (!isDigits(digits, 11)) return void 0;
+	const taxpayerId = digits.slice(0, 8);
+	const vatCode = digits.slice(8, 9);
+	const countyCode = digits.slice(9, 11);
+	if (!isValidHungarianTaxpayerId(taxpayerId)) return void 0;
+	if (!isVatCode(vatCode) || !COUNTY_CODE_SET.has(countyCode)) return void 0;
+	return {
+		taxpayerId,
+		vatCode,
+		countyCode,
+		formatted: `${taxpayerId}-${vatCode}-${countyCode}`
+	};
+}
+function isValidHungarianTaxNumber(value) {
+	return parseHungarianTaxNumber(value) !== void 0;
+}
+function isValidHungarianGroupTaxNumber(value) {
+	return parseHungarianTaxNumber(value)?.vatCode === "5";
+}
+function isHungarianVatGroupMemberTaxNumber(value) {
+	return parseHungarianTaxNumber(value)?.vatCode === "4";
+}
+//#endregion
+exports.EU_VAT_NUMBER_PATTERNS = EU_VAT_NUMBER_PATTERNS;
+exports.HUNGARIAN_TAX_COUNTY_CODES = HUNGARIAN_TAX_COUNTY_CODES;
+exports.formatHungarianBankAccount = formatHungarianBankAccount;
+exports.isHungarianVatGroupMemberTaxNumber = isHungarianVatGroupMemberTaxNumber;
+exports.isValidAgentKey = isValidAgentKey;
+exports.isValidEmail = isValidEmail;
+exports.isValidEuVatNumber = isValidEuVatNumber;
+exports.isValidHungarianBankAccount = isValidHungarianBankAccount;
+exports.isValidHungarianGroupTaxNumber = isValidHungarianGroupTaxNumber;
+exports.isValidHungarianIban = isValidHungarianIban;
+exports.isValidHungarianTaxNumber = isValidHungarianTaxNumber;
+exports.isValidHungarianTaxpayerId = isValidHungarianTaxpayerId;
+exports.isValidHungarianZipCode = isValidHungarianZipCode;
+exports.normalizeEmail = normalizeEmail;
+exports.normalizeEuVatNumber = normalizeEuVatNumber;
+exports.parseHungarianAddress = parseHungarianAddress;
+exports.parseHungarianBankAccount = parseHungarianBankAccount;
+exports.parseHungarianTaxNumber = parseHungarianTaxNumber;

package/dist/validators/index.d.cts

@@ -0,0 +1,51 @@
+//#region src/validators/address.d.ts
+interface HungarianAddress {
+  readonly zip: string;
+  readonly city: string;
+  readonly address: string;
+  readonly district?: number | undefined;
+}
+export declare function isValidHungarianZipCode(value: string | number): boolean;
+export declare function parseHungarianAddress(value: string): HungarianAddress | undefined;
+//#endregion
+//#region src/validators/agent-key.d.ts
+export declare function isValidAgentKey(value: string): boolean;
+//#endregion
+//#region src/validators/bank-account.d.ts
+interface HungarianBankAccount {
+  readonly digits: string;
+  readonly bankCode: string;
+  readonly branchCode: string;
+  readonly formatted: string;
+}
+export declare function parseHungarianBankAccount(value: string): HungarianBankAccount | undefined;
+export declare function isValidHungarianBankAccount(value: string): boolean;
+export declare function formatHungarianBankAccount(value: string): string | undefined;
+export declare function isValidHungarianIban(value: string): boolean;
+//#endregion
+//#region src/validators/email.d.ts
+export declare function normalizeEmail(value: string): string;
+export declare function isValidEmail(value: string): boolean;
+//#endregion
+//#region src/validators/eu-vat.d.ts
+type EuVatCountryPrefix = "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";
+export declare const EU_VAT_NUMBER_PATTERNS: Readonly<Record<EuVatCountryPrefix, RegExp>>;
+export declare function normalizeEuVatNumber(value: string): string;
+export declare function isValidEuVatNumber(value: string): boolean;
+//#endregion
+//#region src/validators/tax-number.d.ts
+type HungarianVatCode = "1" | "2" | "3" | "4" | "5";
+interface HungarianTaxNumber {
+  readonly taxpayerId: string;
+  readonly vatCode: HungarianVatCode;
+  readonly countyCode: string;
+  readonly formatted: string;
+}
+export declare const HUNGARIAN_TAX_COUNTY_CODES: readonly string[];
+export declare function isValidHungarianTaxpayerId(value: string): boolean;
+export declare function parseHungarianTaxNumber(value: string): HungarianTaxNumber | undefined;
+export declare function isValidHungarianTaxNumber(value: string): boolean;
+export declare function isValidHungarianGroupTaxNumber(value: string): boolean;
+export declare function isHungarianVatGroupMemberTaxNumber(value: string): boolean;
+//#endregion
+export type { EuVatCountryPrefix, HungarianAddress, HungarianBankAccount, HungarianTaxNumber, HungarianVatCode };

package/dist/validators/index.d.ts

@@ -0,0 +1,51 @@
+//#region src/validators/address.d.ts
+interface HungarianAddress {
+  readonly zip: string;
+  readonly city: string;
+  readonly address: string;
+  readonly district?: number | undefined;
+}
+export declare function isValidHungarianZipCode(value: string | number): boolean;
+export declare function parseHungarianAddress(value: string): HungarianAddress | undefined;
+//#endregion
+//#region src/validators/agent-key.d.ts
+export declare function isValidAgentKey(value: string): boolean;
+//#endregion
+//#region src/validators/bank-account.d.ts
+interface HungarianBankAccount {
+  readonly digits: string;
+  readonly bankCode: string;
+  readonly branchCode: string;
+  readonly formatted: string;
+}
+export declare function parseHungarianBankAccount(value: string): HungarianBankAccount | undefined;
+export declare function isValidHungarianBankAccount(value: string): boolean;
+export declare function formatHungarianBankAccount(value: string): string | undefined;
+export declare function isValidHungarianIban(value: string): boolean;
+//#endregion
+//#region src/validators/email.d.ts
+export declare function normalizeEmail(value: string): string;
+export declare function isValidEmail(value: string): boolean;
+//#endregion
+//#region src/validators/eu-vat.d.ts
+type EuVatCountryPrefix = "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";
+export declare const EU_VAT_NUMBER_PATTERNS: Readonly<Record<EuVatCountryPrefix, RegExp>>;
+export declare function normalizeEuVatNumber(value: string): string;
+export declare function isValidEuVatNumber(value: string): boolean;
+//#endregion
+//#region src/validators/tax-number.d.ts
+type HungarianVatCode = "1" | "2" | "3" | "4" | "5";
+interface HungarianTaxNumber {
+  readonly taxpayerId: string;
+  readonly vatCode: HungarianVatCode;
+  readonly countyCode: string;
+  readonly formatted: string;
+}
+export declare const HUNGARIAN_TAX_COUNTY_CODES: readonly string[];
+export declare function isValidHungarianTaxpayerId(value: string): boolean;
+export declare function parseHungarianTaxNumber(value: string): HungarianTaxNumber | undefined;
+export declare function isValidHungarianTaxNumber(value: string): boolean;
+export declare function isValidHungarianGroupTaxNumber(value: string): boolean;
+export declare function isHungarianVatGroupMemberTaxNumber(value: string): boolean;
+//#endregion
+export type { EuVatCountryPrefix, HungarianAddress, HungarianBankAccount, HungarianTaxNumber, HungarianVatCode };

package/dist/validators/index.js

@@ -0,0 +1,278 @@
+//#region src/validators/address.ts
+const MIN_ZIP = 1e3;
+const MAX_ZIP = 9999;
+const MAX_BUDAPEST_DISTRICT = 23;
+const ROMAN_VALUES = {
+	I: 1,
+	V: 5,
+	X: 10
+};
+function isValidHungarianZipCode(value) {
+	const trimmed = (typeof value === "number" ? String(value) : typeof value === "string" ? value : "").trim();
+	if (!/^\d{4}$/.test(trimmed)) return false;
+	const zip = Number(trimmed);
+	return zip >= MIN_ZIP && zip <= MAX_ZIP;
+}
+function romanToNumber(roman) {
+	let total = 0;
+	for (let index = 0; index < roman.length; index++) {
+		const current = ROMAN_VALUES[roman.charAt(index)] ?? 0;
+		const next = ROMAN_VALUES[roman.charAt(index + 1)] ?? 0;
+		total += current < next ? -current : current;
+	}
+	return total;
+}
+const ROMAN_DISTRICT = /^([IVX]{1,5})(?:\.\s*(?:[Kk]er(?:ület)?\.?)?|\s+[Kk]er(?:ület)?\.?)(?=[\s,]|$)/;
+const ARABIC_DISTRICT = /^(\d{1,2})\.?\s*[Kk]er(?:ület)?\.?(?=[\s,]|$)/;
+function matchDistrict(text) {
+	const roman = ROMAN_DISTRICT.exec(text);
+	const arabic = roman ? void 0 : ARABIC_DISTRICT.exec(text);
+	const match = roman ?? arabic;
+	if (!match?.[1]) return void 0;
+	const district = roman ? romanToNumber(match[1]) : Number(match[1]);
+	if (district < 1 || district > MAX_BUDAPEST_DISTRICT) return void 0;
+	return {
+		district,
+		rest: text.slice(match[0].length).replace(/^[\s,]+/, "")
+	};
+}
+function normalizeInput(value) {
+	return value.replace(/[\r\n]+/g, ", ").replace(/\s+/g, " ").replace(/\s*(?:,\s*)+/g, ", ").replace(/^(?:HU|H)\s*-\s*/i, "").replace(/,?\s*(?:Magyarország|Hungary)\.?$/i, "").replace(/^[\s,]+|[\s,]+$/g, "");
+}
+function isBudapest(city) {
+	return city.toLowerCase() === "budapest";
+}
+function splitCityAndAddress(rest) {
+	const comma = rest.indexOf(",");
+	if (comma !== -1) return {
+		city: rest.slice(0, comma).trim(),
+		address: rest.slice(comma + 1).trim()
+	};
+	const space = rest.indexOf(" ");
+	if (space === -1) return void 0;
+	return {
+		city: rest.slice(0, space),
+		address: rest.slice(space + 1).trim()
+	};
+}
+function buildAddress(zip, cityPart, addressPart) {
+	let city = cityPart.trim();
+	let address = addressPart.trim();
+	let district;
+	const cityWithDistrict = /^(\S+)\s+(.+)$/.exec(city);
+	if (cityWithDistrict?.[1] && cityWithDistrict[2] && isBudapest(cityWithDistrict[1])) {
+		const match = matchDistrict(cityWithDistrict[2]);
+		if (match && match.rest === "") {
+			city = cityWithDistrict[1];
+			district = match.district;
+		}
+	}
+	if (district === void 0 && isBudapest(city)) {
+		const match = matchDistrict(address);
+		if (match) {
+			district = match.district;
+			address = match.rest;
+		}
+	}
+	if (!isValidHungarianZipCode(zip) || !/\p{L}/u.test(city) || address === "") return void 0;
+	return district === void 0 ? {
+		zip,
+		city,
+		address
+	} : {
+		zip,
+		city,
+		address,
+		district
+	};
+}
+function parseHungarianAddress(value) {
+	if (typeof value !== "string") return void 0;
+	const text = normalizeInput(value);
+	const zipFirst = /^(\d{4}),?\s+(.+)$/.exec(text);
+	if (zipFirst?.[1] && zipFirst[2]) {
+		const parts = splitCityAndAddress(zipFirst[2]);
+		return parts ? buildAddress(zipFirst[1], parts.city, parts.address) : void 0;
+	}
+	const zipLast = /^(.+?),\s*(\d{4})\s+([^,\d][^,]*)$/.exec(text);
+	if (zipLast?.[1] && zipLast[2] && zipLast[3]) return buildAddress(zipLast[2], zipLast[3], zipLast[1]);
+}
+//#endregion
+//#region src/validators/agent-key.ts
+function isValidAgentKey(value) {
+	if (typeof value !== "string") return false;
+	const key = value.trim();
+	return key !== "" && !/\s/.test(key) && key === key.toLowerCase();
+}
+//#endregion
+//#region src/validators/digits.ts
+const SEPARATORS = /[\s-]+/g;
+function stripSeparators(value) {
+	return value.replace(SEPARATORS, "");
+}
+function isDigits(value, length) {
+	if (!/^\d+$/.test(value)) return false;
+	return length === void 0 || value.length === length;
+}
+function weightedDigitSum(digits, weights) {
+	return [...digits].reduce((sum, digit, index) => sum + Number(digit) * Number(weights[index % weights.length]), 0);
+}
+//#endregion
+//#region src/validators/bank-account.ts
+const GIRO_WEIGHTS = [
+	9,
+	7,
+	3,
+	1
+];
+const HU_IBAN_LENGTH = 28;
+function hasValidCheckDigit(block) {
+	return weightedDigitSum(block, GIRO_WEIGHTS) % 10 === 0;
+}
+function groupsOfEight(digits) {
+	return digits.match(/\d{8}/g)?.join("-") ?? digits;
+}
+function parseHungarianBankAccount(value) {
+	if (typeof value !== "string") return void 0;
+	const digits = stripSeparators(value);
+	if (!isDigits(digits, 16) && !isDigits(digits, 24)) return void 0;
+	if (!hasValidCheckDigit(digits.slice(0, 8)) || !hasValidCheckDigit(digits.slice(8))) return;
+	return {
+		digits,
+		bankCode: digits.slice(0, 3),
+		branchCode: digits.slice(3, 7),
+		formatted: groupsOfEight(digits)
+	};
+}
+function isValidHungarianBankAccount(value) {
+	return parseHungarianBankAccount(value) !== void 0;
+}
+function formatHungarianBankAccount(value) {
+	return parseHungarianBankAccount(value)?.formatted;
+}
+function ibanMod97(iban) {
+	const rearranged = `${iban.slice(4)}${iban.slice(0, 4)}`;
+	let remainder = 0;
+	for (const char of rearranged) {
+		const code = char.charCodeAt(0);
+		const chunk = code >= 65 ? String(code - 55) : char;
+		for (const digit of chunk) remainder = (remainder * 10 + Number(digit)) % 97;
+	}
+	return remainder;
+}
+function isValidHungarianIban(value) {
+	if (typeof value !== "string") return false;
+	const iban = stripSeparators(value).toUpperCase();
+	if (iban.length !== HU_IBAN_LENGTH || !iban.startsWith("HU")) return false;
+	if (!isDigits(iban.slice(2), 26)) return false;
+	return ibanMod97(iban) === 1;
+}
+//#endregion
+//#region src/validators/email.ts
+const MAX_EMAIL_LENGTH = 254;
+const EMAIL_PATTERN = /^[^\s@]+@[^\s@.]+(?:\.[^\s@.]+)+$/;
+function normalizeEmail(value) {
+	return value.trim().toLowerCase();
+}
+function isValidEmail(value) {
+	if (typeof value !== "string") return false;
+	const email = value.trim();
+	return email.length <= MAX_EMAIL_LENGTH && EMAIL_PATTERN.test(email);
+}
+//#endregion
+//#region src/validators/eu-vat.ts
+const EU_VAT_NUMBER_PATTERNS = {
+	AT: /^U\d{8}$/,
+	BE: /^[01]\d{9}$/,
+	BG: /^\d{9,10}$/,
+	CY: /^\d{8}[A-Z]$/,
+	CZ: /^\d{8,10}$/,
+	DE: /^\d{9}$/,
+	DK: /^\d{8}$/,
+	EE: /^\d{9}$/,
+	EL: /^\d{9}$/,
+	ES: /^[A-Z0-9]\d{7}[A-Z0-9]$/,
+	FI: /^\d{8}$/,
+	FR: /^[A-HJ-NP-Z0-9]{2}\d{9}$/,
+	HR: /^\d{11}$/,
+	HU: /^\d{8}$/,
+	IE: /^(?:\d{7}[A-W][A-I]?|\d[A-Z+*]\d{5}[A-W])$/,
+	IT: /^\d{11}$/,
+	LT: /^(?:\d{9}|\d{12})$/,
+	LU: /^\d{8}$/,
+	LV: /^\d{11}$/,
+	MT: /^\d{8}$/,
+	NL: /^\d{9}B\d{2}$/,
+	PL: /^\d{10}$/,
+	PT: /^\d{9}$/,
+	RO: /^[1-9]\d{1,9}$/,
+	SE: /^\d{10}01$/,
+	SI: /^\d{8}$/,
+	SK: /^\d{10}$/,
+	XI: /^(?:\d{9}|\d{12}|GD[0-4]\d{2}|HA[5-9]\d{2})$/
+};
+function isEuVatCountryPrefix(value) {
+	return Object.hasOwn(EU_VAT_NUMBER_PATTERNS, value);
+}
+function normalizeEuVatNumber(value) {
+	return value.replace(/[\s.-]+/g, "").toUpperCase();
+}
+function isValidEuVatNumber(value) {
+	if (typeof value !== "string") return false;
+	const normalized = normalizeEuVatNumber(value);
+	const prefix = normalized.slice(0, 2);
+	if (!isEuVatCountryPrefix(prefix)) return false;
+	return EU_VAT_NUMBER_PATTERNS[prefix].test(normalized.slice(2));
+}
+//#endregion
+//#region src/validators/tax-number.ts
+const TAXPAYER_ID_WEIGHTS = [
+	9,
+	7,
+	3,
+	1,
+	9,
+	7,
+	3
+];
+const HUNGARIAN_TAX_COUNTY_CODES = [
+	...Array.from({ length: 19 }, (_, index) => String(index + 2).padStart(2, "0")),
+	...Array.from({ length: 23 }, (_, index) => String(index + 22)),
+	"51"
+];
+const COUNTY_CODE_SET = new Set(HUNGARIAN_TAX_COUNTY_CODES);
+function isVatCode(value) {
+	return value >= "1" && value <= "5" && value.length === 1;
+}
+function isValidHungarianTaxpayerId(value) {
+	const digits = stripSeparators(value);
+	if (!isDigits(digits, 8)) return false;
+	return (10 - weightedDigitSum(digits.slice(0, 7), TAXPAYER_ID_WEIGHTS) % 10) % 10 === Number(digits[7]);
+}
+function parseHungarianTaxNumber(value) {
+	if (typeof value !== "string") return void 0;
+	const digits = stripSeparators(value);
+	if (!isDigits(digits, 11)) return void 0;
+	const taxpayerId = digits.slice(0, 8);
+	const vatCode = digits.slice(8, 9);
+	const countyCode = digits.slice(9, 11);
+	if (!isValidHungarianTaxpayerId(taxpayerId)) return void 0;
+	if (!isVatCode(vatCode) || !COUNTY_CODE_SET.has(countyCode)) return void 0;
+	return {
+		taxpayerId,
+		vatCode,
+		countyCode,
+		formatted: `${taxpayerId}-${vatCode}-${countyCode}`
+	};
+}
+function isValidHungarianTaxNumber(value) {
+	return parseHungarianTaxNumber(value) !== void 0;
+}
+function isValidHungarianGroupTaxNumber(value) {
+	return parseHungarianTaxNumber(value)?.vatCode === "5";
+}
+function isHungarianVatGroupMemberTaxNumber(value) {
+	return parseHungarianTaxNumber(value)?.vatCode === "4";
+}
+//#endregion
+export { EU_VAT_NUMBER_PATTERNS, HUNGARIAN_TAX_COUNTY_CODES, formatHungarianBankAccount, isHungarianVatGroupMemberTaxNumber, isValidAgentKey, isValidEmail, isValidEuVatNumber, isValidHungarianBankAccount, isValidHungarianGroupTaxNumber, isValidHungarianIban, isValidHungarianTaxNumber, isValidHungarianTaxpayerId, isValidHungarianZipCode, normalizeEmail, normalizeEuVatNumber, parseHungarianAddress, parseHungarianBankAccount, parseHungarianTaxNumber };

package/llms.txt

@@ -0,0 +1,16 @@
+# kassza
+
+> Zero-dependency TypeScript client for the Számlázz.hu Számla Agent API (Hungarian invoicing): invoices, proformas, receipts, reversals, payments, PDFs, NAV taxpayer lookup, IPN webhooks. Unofficial.
+
+## Docs for coding agents
+
+- [Start here](agents/README.md): overview, the five rules, vocabulary
+- [Pitfalls](agents/pitfalls.md): hard rules and error categories
+- [API reference](agents/api.md): every method, input and output
+- [Recipes](agents/recipes.md): webhooks, idempotency, receipts, IPN, storage, serverless, tests
+- [Claude Code skill](agents/skills/kassza/SKILL.md)
+
+## Human docs
+
+- [README](README.md): short Hungarian quick start
+- [Official Számlázz.hu Agent docs](https://docs.szamlazz.hu/hu/agent/)