validator-tax-id 1.2.0 → 1.3.0

package/README.md

@@ -1,13 +1,23 @@
 # Tax ID Validator
 
+A lightweight, zero-dependency, and universal TypeScript library to validate Tax IDs (Identification Numbers)
+
+It uses precise mathematical algorithms to verify the integrity of the document number and follow guides of the country governments
+
 [![NPM Version](https://img.shields.io/npm/v/validator-tax-id?style=flat-square)](https://www.npmjs.com/package/validator-tax-id)
 [![NPM Downloads](https://img.shields.io/npm/dm/validator-tax-id?style=flat-square)](https://www.npmjs.com/package/validator-tax-id)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://github.com/AngelBlanco97/tax-id-validator/blob/main/LICENSE)
 [![CI Tests](https://github.com/AngelBlanco97/tax-id-validator/actions/workflows/publish.yml/badge.svg)](https://github.com/AngelBlanco97/tax-id-validator/actions)
+[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://paypal.me/AngelBlanco747)
 
-A lightweight, zero-dependency, and universal TypeScript library to validate Tax IDs (Identification Numbers)
+## Supported Countries
 
-It uses precise mathematical algorithms to verify the integrity of the document number and follow guides of the country governments
+| Country     | Code | Documents Supported            | Algorithm          |
+| ----------- | ---- | ------------------------------ | ------------------ |
+| 🇪🇸 Spain    | es   | DNI, NIE, CIF                  | Module 23          |
+| 🇵🇹 Portugal | pt   | NIF (Personal)                 | Module 11          |
+| 🇫🇷 France   | fr   | SIREN, SIRET, NIR              | Luhn + Mod.97      |
+| 🇩🇪 Germany  | de   | SteuerIdNr, VAT Number, W-IdNr | ISO 7064 Mod 10,11 |
 
 ## Features
 
@@ -45,6 +55,10 @@ validateIdentification("pt", "232013969"); // true (NIF)
 
 // 🇫🇷 France (FR)
 validateIdentification("fr", "443061841"); // true (SIREN)
+
+// 🇩🇪 Germany (DE)
+validateIdentification("de", "86095742719"); // true (SteuerIdNr)
+validateIdentification("de", "DE136695976"); // true (VAT Number)
 ```
 
 ### Individual Validators (Recommended) ✨
@@ -63,6 +77,10 @@ import {
   validateNIR,
   // Portugal
   validateNIF,
+  // Germany
+  validateSteuerIdNr,
+  validateVatNumber,
+  validateWidnr,
 } from "validator-tax-id";
 
 // 🇪🇸 Spain - Direct validation
@@ -77,6 +95,11 @@ validateNIR("188057512301180"); // true
 
 // 🇵🇹 Portugal - Direct validation
 validateNIF("123456789"); // true
+
+// 🇩🇪 Germany - Direct validation
+validateSteuerIdNr("86095742719"); // true
+validateVatNumber("DE136695976"); // true
+validateWidnr("136695976"); // true
 ```
 
 ### Country Auto-detect
@@ -84,70 +107,36 @@ validateNIF("123456789"); // true
 If you don't know the specific document type:
 
 ```typescript
-import { validateES, validateFR, validatePT } from "validator-tax-id";
+import {
+  validateES,
+  validateFR,
+  validatePT,
+  validateDE,
+} from "validator-tax-id";
 
 validateES("12345678Z"); // true (auto-detects DNI)
 validateES("A58818501"); // true (auto-detects CIF)
 validateFR("443061841"); // true (auto-detects SIREN)
 validatePT("123456789"); // true
+validateDE("86095742719"); // true (auto-detects SteuerIdNr)
+validateDE("DE136695976"); // true (auto-detects VAT Number)
 ```
 
 ## API Reference
 
 ### `validateIdentification(country, value)`
 
-- **country**: `CountryCode` ('es' | 'pt' | 'fr') - The ISO code of the country.
-- **value**: `string` | `any` - The document string to validate.
+- **country**: `CountryCode` ('es' | 'pt' | 'fr' | 'de') - The ISO code of the country.
+- **value**: `string` - The document string to validate.
 - **Returns**: `boolean` (`true` if valid, `false` otherwise).
 
 _Note: The validator sanitizes the input automatically (removes spaces, hyphens, and is case-insensitive)._
 
-## SUPPORTED COUNTRIES
-
-| Country  | Code | Documents Supported | Algorithm     |
-| -------- | ---- | ------------------- | ------------- |
-| Spain    | es   | DNI, NIE , CIF      | Module 23     |
-| Portugal | pt   | NIF (Personal)      | Module 11     |
-| France   | fr   | SIREN, SIRET, NIR   | Luhn + Mod.97 |
-
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-## [1.2.0] - 2026-01-19
-
-### Added 🚀
-
-- **Individual Validators**: New exported functions for direct validation:
-  - Spain: `validateDNI`, `validateNIE`, `validateCIF`, `validateES`
-  - France: `validateSIREN`, `validateSIRET`, `validateNIR`, `validateFR`
-  - Portugal: `validateNIF`, `validatePT`
-- Better tree-shaking support with individual exports
-- Country auto-detect validators (`validateES`, `validateFR`, `validatePT`)
-
-## [1.1.3] - 2026-01-18
-
-### Added 🚀
-
-- **France (FR)** added validation for NIR document and fix SIREN-SIRET algorithm
-- **Spain (ES)** added validation for CIF document.
-- **Portugal (PT)** added validation on prefix in NIF document
-
-## [1.1.0] - 2026-01-17
-
-### Added 🚀
-
-- **France (FR)** support added.
-- Validation for **SIREN** (9 digits) and **SIRET** (14 digits) using Luhn algorithm.
-
-## [1.0.0] - 2026-01-17
+## Support
 
-### Added
+If this library helped you, consider buying me a coffee ☕
 
-- Initial release.
-- **Spain (ES)** support: DNI and NIE validation (Modulo 23).
-- **Portugal (PT)** support: NIF validation (Modulo 11).
-- Core logic and TypeScript types.
+[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=for-the-badge)](https://paypal.me/AngelBlanco747)
 
 ## License
 

package/dist/index.cjs

@@ -1,84 +1,45 @@
-"use strict";var f=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var F=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var D=(e,t)=>{for(var r in t)f(e,r,{get:t[r],enumerable:!0})},A=(e,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of F(t))!_.call(e,n)&&n!==r&&f(e,n,{get:()=>t[n],enumerable:!(s=T(t,n))||s.enumerable});return e};var $=e=>A(f({},"__esModule",{value:!0}),e);var H={};D(H,{validateCIF:()=>u,validateDNI:()=>p,validateES:()=>I,validateFR:()=>R,validateIdentification:()=>Z,validateNIE:()=>d,validateNIF:()=>N,validateNIR:()=>g,validatePT:()=>b,validateSIREN:()=>E,validateSIRET:()=>y});module.exports=$(H);var x="TRWAGMYFPDXBNJZSQVHLCKE",h="JABCDEFGHI",G=/^[0-9]{8}[A-Z]$/,L=/^[XYZ][0-9]{7}[A-Z]$/,B=/^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$/;var p=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!G.test(t))return!1;let r=t.slice(0,-1),s=t.slice(-1),n=parseInt(r,10);return x[n%23]===s};var d=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!L.test(t))return!1;let r=t.slice(0,-1),s=t.slice(-1);r=r.replace("X","0").replace("Y","1").replace("Z","2");let n=parseInt(r,10);return x[n%23]===s};var u=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!B.test(t))return!1;let r=t[0],s=t.slice(1,8),n=t[8],o=0,l=0;for(let i=0;i<s.length;i++){let v=parseInt(s[i],10);if(i%2===0){let c=v*2;l+=c>9?c-9:c}else o+=v}let a=(10-(o+l)%10)%10,S=h[a];return"PQRSNW".includes(r)?n===S:"ABEH".includes(r)?n===String(a):n===String(a)||n===S};var I=e=>p(e)||d(e)||u(e);var P=/^[1-8]\d{2}(0[1-9]|1[0-2]|[2-9]\d)(\d{2}|2A|2B|97\d)\d{6}\d{2}$/,C=e=>{let t=0,r=!1;for(let s=e.length-1;s>=0;s--){let n=parseInt(e[s],10);r&&(n*=2,n>9&&(n-=9)),t+=n,r=!r}return t%10===0};var g=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!P.test(t))return!1;let r=parseInt(t.slice(-2),10),s=t.slice(0,-2),n=s.slice(5,7);n==="2A"&&(s=s.slice(0,5)+"19"+s.slice(7)),n==="2B"&&(s=s.slice(0,5)+"18"+s.slice(7));let o=BigInt(s);return Number(97n-o%97n)===r};var E=e=>{if(typeof e!="string")return!1;let t=e.replace(/\s|-/g,"");return!/^\d{9}$/.test(t)||/^(\d)\1+$/.test(t)?!1:C(t)};var y=e=>{if(typeof e!="string")return!1;let t=e.replace(/\s|-/g,"");return!/^\d{14}$/.test(t)||/^(\d)\1+$/.test(t)?!1:C(t)};var R=e=>{if(typeof e!="string")return!1;let t=e.replace(/\s|-/g,"");return t.length===15?g(e):t.length===9?E(e):t.length===14?y(e):!1};var X=["1","2","3","5","6","8","9"];var N=e=>{if(typeof e!="string")return!1;let t=e.replace(/\s|-/g,"");if(!/^[0-9]{9}$/.test(t)||!X.includes(t[0]))return!1;let n=11-t.slice(0,8).split("").reduce((o,l,m)=>{let a=9-m;return o+parseInt(l,10)*a},0)%11;return n>=10&&(n=0),n===parseInt(t[8],10)},b=N;var U={es:I,pt:b,fr:R};var Z=(e,t)=>{let r=U[e];return r?r(t):(console.warn(`[TaxIDValidator] Country '${e}' not supported yet.`),!1)};0&&(module.exports={validateCIF,validateDNI,validateES,validateFR,validateIdentification,validateNIE,validateNIF,validateNIR,validatePT,validateSIREN,validateSIRET});
+"use strict";var f=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var X=Object.prototype.hasOwnProperty;var z=(e,t)=>{for(var n in t)f(e,n,{get:t[n],enumerable:!0})},$=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of O(t))!X.call(e,r)&&r!==n&&f(e,r,{get:()=>t[r],enumerable:!(o=M(t,r))||o.enumerable});return e};var P=e=>$(f({},"__esModule",{value:!0}),e);var rt={};z(rt,{isValidCountryCode:()=>F,isValidString:()=>u,validateCIF:()=>b,validateDE:()=>_,validateDNI:()=>E,validateES:()=>C,validateFR:()=>S,validateIdentification:()=>ot,validateNIE:()=>x,validateNIF:()=>y,validateNIR:()=>R,validatePT:()=>h,validateSIREN:()=>D,validateSIRET:()=>N,validateSteuerIdNr:()=>T,validateVatNumber:()=>k,validateWidnr:()=>v});module.exports=P(rt);var u=e=>typeof e=="string"&&e.length>0,F=e=>e==="es"||e==="pt"||e==="fr"||e==="de";var c=e=>u(e)?e.toUpperCase().replace(/[\s-]/g,""):null,a=(e,t)=>{let n=c(e);return n===null?null:t.test(n)?n:null};var I=e=>{let t=0,n=!1;for(let o=e.length-1;o>=0;o--){let r=parseInt(e[o],10);n&&(r*=2,r>9&&(r-=9)),t+=r,n=!n}return t%10===0},g=(e,t)=>t[e%23],w=e=>{let o=11-e.reduce((r,i,s)=>{let l=9-s;return r+i*l},0)%11;return o>=10?0:o},V=e=>Number(97n-e%97n),A=e=>{let t="JABCDEFGHI",n=0,o=0;for(let s=0;s<e.length;s++){let l=parseInt(e[s],10);if(s%2===0){let p=l*2;o+=p>9?p-9:p}else n+=l}let i=(10-(n+o)%10)%10;return{digit:i,letter:t[i]}},m=e=>/^(\d)\1+$/.test(e),d=e=>{let t=10;for(let o=0;o<e.length;o++){let i=(parseInt(e[o],10)+t)%10;t=(i===0?10:i)*2%11}let n=11-t;return n===10?0:n},G=e=>{let t={};for(let i of e)t[i]=(t[i]||0)+1;let n=Object.values(t),o=n.filter(i=>i===2).length,r=n.filter(i=>i===3).length;return o===1&&r===0||r===1&&o===0};var L="TRWAGMYFPDXBNJZSQVHLCKE",B=/^[0-9]{8}[A-Z]$/,W=/^[XYZ][0-9]{7}[A-Z]$/,Y=/^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$/,H="PQRSNW",J="ABEH",E=e=>{let t=a(e,B);if(!t)return!1;let n=parseInt(t.slice(0,-1),10),o=t.slice(-1);return g(n,L)===o},x=e=>{let t=a(e,W);if(!t)return!1;let n=t.slice(-1),o=t[0],i=parseInt((o==="X"?"0":o==="Y"?"1":"2")+t.slice(1,-1),10);return g(i,L)===n},b=e=>{let t=a(e,Y);if(!t)return!1;let n=t[0],o=t.slice(1,8),r=t[8],{digit:i,letter:s}=A(o);return H.includes(n)?r===s:J.includes(n)?r===String(i):r===String(i)||r===s},C=e=>E(e)||x(e)||b(e);var U=/^[1-8]\d{2}(0[1-9]|1[0-2]|[2-9]\d)(\d{2}|2A|2B|97\d)\d{6}\d{2}$/,Z=/^\d{9}$/,K=/^\d{14}$/,R=e=>{let t=a(e,U);if(!t)return!1;let n=parseInt(t.slice(-2),10),o=t.slice(0,-2),r=o.slice(5,7);return r==="2A"&&(o=o.slice(0,5)+"19"+o.slice(7)),r==="2B"&&(o=o.slice(0,5)+"18"+o.slice(7)),V(BigInt(o))===n},D=e=>{let t=c(e);return!t||!Z.test(t)||m(t)?!1:I(t)},N=e=>{let t=c(e);return!t||!K.test(t)||m(t)?!1:I(t)};var S=e=>{let t=c(e);return t?t.length===15?R(e):t.length===9?D(e):t.length===14?N(e):!1:!1};var Q=/^[0-9]{9}$/,j=["1","2","3","5","6","8","9"],y=e=>{let t=c(e);if(!t||!Q.test(t)||!j.includes(t[0]))return!1;let n=t.slice(0,8).split("").map(r=>parseInt(r,10));return w(n)===parseInt(t[8],10)},h=y;var q=/^[0-9]{11}$/,tt=/^DE[0-9]{9}$/,et=/^[0-9]{9}$/,T=e=>{let t=a(e,q);if(!t)return!1;let n=t.substring(0,10),o=parseInt(t.substring(10,11),10);return G(n)?d(n)===o:!1},k=e=>{let t=a(e,tt);if(!t)return!1;let n=t.substring(2),o=n.substring(0,8),r=parseInt(n.substring(8,9),10);return d(o)===r},v=e=>{let t=a(e,et);if(!t)return!1;let n=t.substring(0,8),o=parseInt(t.substring(8,9),10);return d(n)===o},_=e=>T(e)||k(e)||v(e);var nt={es:C,pt:h,fr:S,de:_},ot=(e,t)=>{let n=nt[e];return n?n(t):(console.warn(`[TaxIDValidator] Country '${e}' not supported yet.`),!1)};0&&(module.exports={isValidCountryCode,isValidString,validateCIF,validateDE,validateDNI,validateES,validateFR,validateIdentification,validateNIE,validateNIF,validateNIR,validatePT,validateSIREN,validateSIRET,validateSteuerIdNr,validateVatNumber,validateWidnr});
 /**
- * Validate Spanish DNI (Documento Nacional de Identidad).
- * @param value - The DNI number to validate (8 digits + letter)
- * @returns boolean indicating whether the DNI is valid
+ * Types for Tax ID Validator
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
 /**
- * Validate Spanish NIE (Número de Identidad de Extranjero).
- * @param value - The NIE number to validate (X/Y/Z + 7 digits + letter)
- * @returns boolean indicating whether the NIE is valid
+ * Sanitization utilities for Tax ID validation
+ * Single Responsibility: Only handles string cleaning/normalization
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
 /**
- * Validate Spanish CIF (Código de Identificación Fiscal).
- * @param value - The CIF number to validate (letter + 7 digits + control)
- * @returns boolean indicating whether the CIF is valid
+ * Common validation algorithms
+ * Single Responsibility: Only contains mathematical validation algorithms
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate Spanish DNI/NIE/CIF numbers (auto-detect type).
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification is valid
+ * Spanish Tax ID Validators (DNI, NIE, CIF)
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French NIR (Numéro d'Inscription au Répertoire) - Social Security Number.
- * @param value - The NIR number to validate (15 digits)
- * @returns boolean indicating whether the NIR is valid
+ * French Tax ID Validators (NIR, SIREN, SIRET)
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.service-public.gouv.fr/
  */
 /**
- * Validate French SIREN (Système d'Identification du Répertoire des Entreprises).
- * @param value - The SIREN number to validate (9 digits)
- * @returns boolean indicating whether the SIREN is valid
+ * Portuguese Tax ID Validators (NIF)
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French SIRET (Système d'Identification du Répertoire des Établissements).
- * @param value - The SIRET number to validate (14 digits = SIREN + NIC)
- * @returns boolean indicating whether the SIRET is valid
+ * German Validators (SteuerIdNr,  VAT Number, W-IdNr)
+ * @documentation https://euipo.europa.eu/tunnel-web/secure/webdav/guest/document_library/Documents/COSME/VAT%20numbers%20EU.pdf
+ * @documentation https://www.iamexpat.de/expat-info/money-taxation/tax-identification-number-germany
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French SIREN or SIRET numbers (auto-detect by length).
- * @param value - The SIREN (9 digits) or SIRET (14 digits) number to validate
- * @returns boolean indicating whether the number is valid
- * @author AngelBlanco97
- * @license MIT
- */
-/**
- * Validates French identification numbers: NIR, SIREN, and SIRET (auto-detect).
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification number is valid
- * @author AngelBlanco97
- * @license MIT
- * @documentation https://www.service-public.gouv.fr/
- */
-/**
- * Validates a Portuguese NIF (Número de Identificação Fiscal).
- * @param value - The NIF number to validate (9 digits)
- * @returns boolean indicating whether the NIF is valid
- * @author AngelBlanco97
- * @license MIT
- * @documentation https://en.wikipedia.org/wiki/Tax_identification_number#Portugal
- */
-/**
- * Function to validate identification numbers based on country/type.
- * @param Country - The country code representing the type of identification number (e.g., 'es' for Spain, 'pt' for Portugal)
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification number is valid (true) or not (false)
+ * Tax ID Validator - Main Entry Point
  * @author AngelBlanco97
  * @license MIT
  */

package/dist/index.d.cts

@@ -2,20 +2,85 @@ export { validateCIF, validateDNI, validateES, validateNIE } from './validators/
 export { validateFR, validateNIR, validateSIREN, validateSIRET } from './validators/fr.cjs';
 export { validateNIF, validatePT } from './validators/pt.cjs';
 
-declare const validators: {
-    es: (value: any) => boolean;
-    pt: (value: any) => boolean;
-    fr: (value: any) => boolean;
-};
-type CountryCode = keyof typeof validators;
+/**
+ * German Validators (SteuerIdNr,  VAT Number, W-IdNr)
+ * @documentation https://euipo.europa.eu/tunnel-web/secure/webdav/guest/document_library/Documents/COSME/VAT%20numbers%20EU.pdf
+ * @documentation https://www.iamexpat.de/expat-info/money-taxation/tax-identification-number-germany
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Validate German Steueridentifikationsnummer (Tax Identification Number).
+ * Unique per person, lifetime validity.
+ * Format: 11 digits.
+ * Checksum: ISO 7064 Mod 11,10.
+ * * @param value - The value to validate
+ * @returns boolean indicating whether the SteuerIdNr is valid
+ */
+declare const validateSteuerIdNr: (value: unknown) => boolean;
+/**
+ * Validate German VAT Number (Umsatzsteuer-Id).
+ * Format: DE + 9 digits.
+ * Checksum: ISO 7064 Mod 11,10.
+ * * @param value - The value to validate
+ * @returns boolean indicating whether the VAT number is valid
+ */
+declare const validateVatNumber: (value: unknown) => boolean;
+/**
+ * Validate Business identification number (W-IdNr)
+ * Format: DE + 9 digits + suffix (usually).
+ * Based on your regex, we validate the 9 digit core.
+ * Checksum: ISO 7064 Mod 11,10 (Same as VAT).
+ * * @param value - The value to validate
+ * @returns boolean indicating whether the W-IdNr is valid
+ */
+declare const validateWidnr: (value: unknown) => boolean;
+/**
+ * Validate German Tax Identifiers (SteuerIdNr, Steuernummer, VAT Number, W-IdNr).
+ * @param value - The value to validate
+ * @returns boolean indicating whether any of the German tax identifiers is valid
+ */
+declare const validateDE: (value: unknown) => boolean;
+
+/**
+ * Types for Tax ID Validator
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Supported country codes (ISO 3166-1 alpha-2)
+ */
+type CountryCode = "es" | "pt" | "fr" | "de";
+/**
+ * Valid input type for tax ID validation.
+ * Only strings are valid - this makes the API explicit.
+ */
+type TaxIdInput = string;
+/**
+ * Validation function signature
+ */
+type ValidatorFunction = (value: unknown) => boolean;
+/**
+ * Type guard to check if value is a non-empty string
+ */
+declare const isValidString: (value: unknown) => value is string;
+/**
+ * Type guard to check if country code is valid
+ */
+declare const isValidCountryCode: (code: unknown) => code is CountryCode;
+
+/**
+ * Tax ID Validator - Main Entry Point
+ * @author AngelBlanco97
+ * @license MIT
+ */
+
 /**
  * Function to validate identification numbers based on country/type.
- * @param Country - The country code representing the type of identification number (e.g., 'es' for Spain, 'pt' for Portugal)
+ * @param country - The country code representing the type of identification number (e.g., 'es' for Spain, 'pt' for Portugal)
  * @param value - The identification number to validate
  * @returns boolean indicating whether the identification number is valid (true) or not (false)
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateIdentification: (country: CountryCode, value: any) => boolean;
+declare const validateIdentification: (country: CountryCode, value: unknown) => boolean;
 
-export { type CountryCode, validateIdentification };
+export { type CountryCode, type TaxIdInput, type ValidatorFunction, isValidCountryCode, isValidString, validateDE, validateIdentification, validateSteuerIdNr, validateVatNumber, validateWidnr };

package/dist/index.d.ts

@@ -2,20 +2,85 @@ export { validateCIF, validateDNI, validateES, validateNIE } from './validators/
 export { validateFR, validateNIR, validateSIREN, validateSIRET } from './validators/fr.js';
 export { validateNIF, validatePT } from './validators/pt.js';
 
-declare const validators: {
-    es: (value: any) => boolean;
-    pt: (value: any) => boolean;
-    fr: (value: any) => boolean;
-};
-type CountryCode = keyof typeof validators;
+/**
+ * German Validators (SteuerIdNr,  VAT Number, W-IdNr)
+ * @documentation https://euipo.europa.eu/tunnel-web/secure/webdav/guest/document_library/Documents/COSME/VAT%20numbers%20EU.pdf
+ * @documentation https://www.iamexpat.de/expat-info/money-taxation/tax-identification-number-germany
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Validate German Steueridentifikationsnummer (Tax Identification Number).
+ * Unique per person, lifetime validity.
+ * Format: 11 digits.
+ * Checksum: ISO 7064 Mod 11,10.
+ * * @param value - The value to validate
+ * @returns boolean indicating whether the SteuerIdNr is valid
+ */
+declare const validateSteuerIdNr: (value: unknown) => boolean;
+/**
+ * Validate German VAT Number (Umsatzsteuer-Id).
+ * Format: DE + 9 digits.
+ * Checksum: ISO 7064 Mod 11,10.
+ * * @param value - The value to validate
+ * @returns boolean indicating whether the VAT number is valid
+ */
+declare const validateVatNumber: (value: unknown) => boolean;
+/**
+ * Validate Business identification number (W-IdNr)
+ * Format: DE + 9 digits + suffix (usually).
+ * Based on your regex, we validate the 9 digit core.
+ * Checksum: ISO 7064 Mod 11,10 (Same as VAT).
+ * * @param value - The value to validate
+ * @returns boolean indicating whether the W-IdNr is valid
+ */
+declare const validateWidnr: (value: unknown) => boolean;
+/**
+ * Validate German Tax Identifiers (SteuerIdNr, Steuernummer, VAT Number, W-IdNr).
+ * @param value - The value to validate
+ * @returns boolean indicating whether any of the German tax identifiers is valid
+ */
+declare const validateDE: (value: unknown) => boolean;
+
+/**
+ * Types for Tax ID Validator
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Supported country codes (ISO 3166-1 alpha-2)
+ */
+type CountryCode = "es" | "pt" | "fr" | "de";
+/**
+ * Valid input type for tax ID validation.
+ * Only strings are valid - this makes the API explicit.
+ */
+type TaxIdInput = string;
+/**
+ * Validation function signature
+ */
+type ValidatorFunction = (value: unknown) => boolean;
+/**
+ * Type guard to check if value is a non-empty string
+ */
+declare const isValidString: (value: unknown) => value is string;
+/**
+ * Type guard to check if country code is valid
+ */
+declare const isValidCountryCode: (code: unknown) => code is CountryCode;
+
+/**
+ * Tax ID Validator - Main Entry Point
+ * @author AngelBlanco97
+ * @license MIT
+ */
+
 /**
  * Function to validate identification numbers based on country/type.
- * @param Country - The country code representing the type of identification number (e.g., 'es' for Spain, 'pt' for Portugal)
+ * @param country - The country code representing the type of identification number (e.g., 'es' for Spain, 'pt' for Portugal)
  * @param value - The identification number to validate
  * @returns boolean indicating whether the identification number is valid (true) or not (false)
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateIdentification: (country: CountryCode, value: any) => boolean;
+declare const validateIdentification: (country: CountryCode, value: unknown) => boolean;
 
-export { type CountryCode, validateIdentification };
+export { type CountryCode, type TaxIdInput, type ValidatorFunction, isValidCountryCode, isValidString, validateDE, validateIdentification, validateSteuerIdNr, validateVatNumber, validateWidnr };

package/dist/index.js

@@ -1,84 +1,45 @@
-var u="TRWAGMYFPDXBNJZSQVHLCKE",C="JABCDEFGHI",T=/^[0-9]{8}[A-Z]$/,F=/^[XYZ][0-9]{7}[A-Z]$/,_=/^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$/;var I=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!T.test(t))return!1;let s=t.slice(0,-1),n=t.slice(-1),r=parseInt(s,10);return u[r%23]===n};var g=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!F.test(t))return!1;let s=t.slice(0,-1),n=t.slice(-1);s=s.replace("X","0").replace("Y","1").replace("Z","2");let r=parseInt(s,10);return u[r%23]===n};var E=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!_.test(t))return!1;let s=t[0],n=t.slice(1,8),r=t[8],o=0,l=0;for(let i=0;i<n.length;i++){let d=parseInt(n[i],10);if(i%2===0){let c=d*2;l+=c>9?c-9:c}else o+=d}let a=(10-(o+l)%10)%10,p=C[a];return"PQRSNW".includes(s)?r===p:"ABEH".includes(s)?r===String(a):r===String(a)||r===p};var y=e=>I(e)||g(e)||E(e);var D=/^[1-8]\d{2}(0[1-9]|1[0-2]|[2-9]\d)(\d{2}|2A|2B|97\d)\d{6}\d{2}$/,R=e=>{let t=0,s=!1;for(let n=e.length-1;n>=0;n--){let r=parseInt(e[n],10);s&&(r*=2,r>9&&(r-=9)),t+=r,s=!s}return t%10===0};var N=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!D.test(t))return!1;let s=parseInt(t.slice(-2),10),n=t.slice(0,-2),r=n.slice(5,7);r==="2A"&&(n=n.slice(0,5)+"19"+n.slice(7)),r==="2B"&&(n=n.slice(0,5)+"18"+n.slice(7));let o=BigInt(n);return Number(97n-o%97n)===s};var b=e=>{if(typeof e!="string")return!1;let t=e.replace(/\s|-/g,"");return!/^\d{9}$/.test(t)||/^(\d)\1+$/.test(t)?!1:R(t)};var m=e=>{if(typeof e!="string")return!1;let t=e.replace(/\s|-/g,"");return!/^\d{14}$/.test(t)||/^(\d)\1+$/.test(t)?!1:R(t)};var S=e=>{if(typeof e!="string")return!1;let t=e.replace(/\s|-/g,"");return t.length===15?N(e):t.length===9?b(e):t.length===14?m(e):!1};var A=["1","2","3","5","6","8","9"];var v=e=>{if(typeof e!="string")return!1;let t=e.replace(/\s|-/g,"");if(!/^[0-9]{9}$/.test(t)||!A.includes(t[0]))return!1;let r=11-t.slice(0,8).split("").reduce((o,l,f)=>{let a=9-f;return o+parseInt(l,10)*a},0)%11;return r>=10&&(r=0),r===parseInt(t[8],10)},x=v;var $={es:y,pt:x,fr:S};var U=(e,t)=>{let s=$[e];return s?s(t):(console.warn(`[TaxIDValidator] Country '${e}' not supported yet.`),!1)};export{E as validateCIF,I as validateDNI,y as validateES,S as validateFR,U as validateIdentification,g as validateNIE,v as validateNIF,N as validateNIR,x as validatePT,b as validateSIREN,m as validateSIRET};
+var p=e=>typeof e=="string"&&e.length>0,G=e=>e==="es"||e==="pt"||e==="fr"||e==="de";var c=e=>p(e)?e.toUpperCase().replace(/[\s-]/g,""):null,a=(e,t)=>{let n=c(e);return n===null?null:t.test(n)?n:null};var f=e=>{let t=0,n=!1;for(let o=e.length-1;o>=0;o--){let r=parseInt(e[o],10);n&&(r*=2,r>9&&(r-=9)),t+=r,n=!n}return t%10===0},I=(e,t)=>t[e%23],m=e=>{let o=11-e.reduce((r,i,s)=>{let l=9-s;return r+i*l},0)%11;return o>=10?0:o},E=e=>Number(97n-e%97n),x=e=>{let t="JABCDEFGHI",n=0,o=0;for(let s=0;s<e.length;s++){let l=parseInt(e[s],10);if(s%2===0){let d=l*2;o+=d>9?d-9:d}else n+=l}let i=(10-(n+o)%10)%10;return{digit:i,letter:t[i]}},g=e=>/^(\d)\1+$/.test(e),u=e=>{let t=10;for(let o=0;o<e.length;o++){let i=(parseInt(e[o],10)+t)%10;t=(i===0?10:i)*2%11}let n=11-t;return n===10?0:n},b=e=>{let t={};for(let i of e)t[i]=(t[i]||0)+1;let n=Object.values(t),o=n.filter(i=>i===2).length,r=n.filter(i=>i===3).length;return o===1&&r===0||r===1&&o===0};var C="TRWAGMYFPDXBNJZSQVHLCKE",L=/^[0-9]{8}[A-Z]$/,M=/^[XYZ][0-9]{7}[A-Z]$/,O=/^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$/,X="PQRSNW",z="ABEH",R=e=>{let t=a(e,L);if(!t)return!1;let n=parseInt(t.slice(0,-1),10),o=t.slice(-1);return I(n,C)===o},D=e=>{let t=a(e,M);if(!t)return!1;let n=t.slice(-1),o=t[0],i=parseInt((o==="X"?"0":o==="Y"?"1":"2")+t.slice(1,-1),10);return I(i,C)===n},N=e=>{let t=a(e,O);if(!t)return!1;let n=t[0],o=t.slice(1,8),r=t[8],{digit:i,letter:s}=x(o);return X.includes(n)?r===s:z.includes(n)?r===String(i):r===String(i)||r===s},S=e=>R(e)||D(e)||N(e);var $=/^[1-8]\d{2}(0[1-9]|1[0-2]|[2-9]\d)(\d{2}|2A|2B|97\d)\d{6}\d{2}$/,P=/^\d{9}$/,B=/^\d{14}$/,y=e=>{let t=a(e,$);if(!t)return!1;let n=parseInt(t.slice(-2),10),o=t.slice(0,-2),r=o.slice(5,7);return r==="2A"&&(o=o.slice(0,5)+"19"+o.slice(7)),r==="2B"&&(o=o.slice(0,5)+"18"+o.slice(7)),E(BigInt(o))===n},h=e=>{let t=c(e);return!t||!P.test(t)||g(t)?!1:f(t)},T=e=>{let t=c(e);return!t||!B.test(t)||g(t)?!1:f(t)};var k=e=>{let t=c(e);return t?t.length===15?y(e):t.length===9?h(e):t.length===14?T(e):!1:!1};var W=/^[0-9]{9}$/,Y=["1","2","3","5","6","8","9"],v=e=>{let t=c(e);if(!t||!W.test(t)||!Y.includes(t[0]))return!1;let n=t.slice(0,8).split("").map(r=>parseInt(r,10));return m(n)===parseInt(t[8],10)},_=v;var H=/^[0-9]{11}$/,J=/^DE[0-9]{9}$/,U=/^[0-9]{9}$/,F=e=>{let t=a(e,H);if(!t)return!1;let n=t.substring(0,10),o=parseInt(t.substring(10,11),10);return b(n)?u(n)===o:!1},w=e=>{let t=a(e,J);if(!t)return!1;let n=t.substring(2),o=n.substring(0,8),r=parseInt(n.substring(8,9),10);return u(o)===r},V=e=>{let t=a(e,U);if(!t)return!1;let n=t.substring(0,8),o=parseInt(t.substring(8,9),10);return u(n)===o},A=e=>F(e)||w(e)||V(e);var Z={es:S,pt:_,fr:k,de:A},xt=(e,t)=>{let n=Z[e];return n?n(t):(console.warn(`[TaxIDValidator] Country '${e}' not supported yet.`),!1)};export{G as isValidCountryCode,p as isValidString,N as validateCIF,A as validateDE,R as validateDNI,S as validateES,k as validateFR,xt as validateIdentification,D as validateNIE,v as validateNIF,y as validateNIR,_ as validatePT,h as validateSIREN,T as validateSIRET,F as validateSteuerIdNr,w as validateVatNumber,V as validateWidnr};
 /**
- * Validate Spanish DNI (Documento Nacional de Identidad).
- * @param value - The DNI number to validate (8 digits + letter)
- * @returns boolean indicating whether the DNI is valid
+ * Types for Tax ID Validator
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
 /**
- * Validate Spanish NIE (Número de Identidad de Extranjero).
- * @param value - The NIE number to validate (X/Y/Z + 7 digits + letter)
- * @returns boolean indicating whether the NIE is valid
+ * Sanitization utilities for Tax ID validation
+ * Single Responsibility: Only handles string cleaning/normalization
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
 /**
- * Validate Spanish CIF (Código de Identificación Fiscal).
- * @param value - The CIF number to validate (letter + 7 digits + control)
- * @returns boolean indicating whether the CIF is valid
+ * Common validation algorithms
+ * Single Responsibility: Only contains mathematical validation algorithms
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate Spanish DNI/NIE/CIF numbers (auto-detect type).
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification is valid
+ * Spanish Tax ID Validators (DNI, NIE, CIF)
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French NIR (Numéro d'Inscription au Répertoire) - Social Security Number.
- * @param value - The NIR number to validate (15 digits)
- * @returns boolean indicating whether the NIR is valid
+ * French Tax ID Validators (NIR, SIREN, SIRET)
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.service-public.gouv.fr/
  */
 /**
- * Validate French SIREN (Système d'Identification du Répertoire des Entreprises).
- * @param value - The SIREN number to validate (9 digits)
- * @returns boolean indicating whether the SIREN is valid
+ * Portuguese Tax ID Validators (NIF)
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French SIRET (Système d'Identification du Répertoire des Établissements).
- * @param value - The SIRET number to validate (14 digits = SIREN + NIC)
- * @returns boolean indicating whether the SIRET is valid
+ * German Validators (SteuerIdNr,  VAT Number, W-IdNr)
+ * @documentation https://euipo.europa.eu/tunnel-web/secure/webdav/guest/document_library/Documents/COSME/VAT%20numbers%20EU.pdf
+ * @documentation https://www.iamexpat.de/expat-info/money-taxation/tax-identification-number-germany
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French SIREN or SIRET numbers (auto-detect by length).
- * @param value - The SIREN (9 digits) or SIRET (14 digits) number to validate
- * @returns boolean indicating whether the number is valid
- * @author AngelBlanco97
- * @license MIT
- */
-/**
- * Validates French identification numbers: NIR, SIREN, and SIRET (auto-detect).
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification number is valid
- * @author AngelBlanco97
- * @license MIT
- * @documentation https://www.service-public.gouv.fr/
- */
-/**
- * Validates a Portuguese NIF (Número de Identificação Fiscal).
- * @param value - The NIF number to validate (9 digits)
- * @returns boolean indicating whether the NIF is valid
- * @author AngelBlanco97
- * @license MIT
- * @documentation https://en.wikipedia.org/wiki/Tax_identification_number#Portugal
- */
-/**
- * Function to validate identification numbers based on country/type.
- * @param Country - The country code representing the type of identification number (e.g., 'es' for Spain, 'pt' for Portugal)
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification number is valid (true) or not (false)
+ * Tax ID Validator - Main Entry Point
  * @author AngelBlanco97
  * @license MIT
  */

package/dist/validators/es.cjs

@@ -1,31 +1,23 @@
-"use strict";var a=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var N=Object.prototype.hasOwnProperty;var R=(e,t)=>{for(var r in t)a(e,r,{get:t[r],enumerable:!0})},S=(e,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of C(t))!N.call(e,n)&&n!==r&&a(e,n,{get:()=>t[n],enumerable:!(s=g(t,n))||s.enumerable});return e};var m=e=>S(a({},"__esModule",{value:!0}),e);var L={};R(L,{validateCIF:()=>d,validateDNI:()=>I,validateES:()=>G,validateNIE:()=>b});module.exports=m(L);var u="TRWAGMYFPDXBNJZSQVHLCKE",y="JABCDEFGHI",A=/^[0-9]{8}[A-Z]$/,D=/^[XYZ][0-9]{7}[A-Z]$/,F=/^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$/;var I=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!A.test(t))return!1;let r=t.slice(0,-1),s=t.slice(-1),n=parseInt(r,10);return u[n%23]===s};var b=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!D.test(t))return!1;let r=t.slice(0,-1),s=t.slice(-1);r=r.replace("X","0").replace("Y","1").replace("Z","2");let n=parseInt(r,10);return u[n%23]===s};var d=e=>{if(typeof e!="string")return!1;let t=e.toUpperCase().replace(/\s|-/g,"");if(!F.test(t))return!1;let r=t[0],s=t.slice(1,8),n=t[8],i=0,p=0;for(let o=0;o<s.length;o++){let E=parseInt(s[o],10);if(o%2===0){let l=E*2;p+=l>9?l-9:l}else i+=E}let c=(10-(i+p)%10)%10,f=y[c];return"PQRSNW".includes(r)?n===f:"ABEH".includes(r)?n===String(c):n===String(c)||n===f};var G=e=>I(e)||b(e)||d(e);0&&(module.exports={validateCIF,validateDNI,validateES,validateNIE});
+"use strict";var l=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var E=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var D=(t,e)=>{for(var n in e)l(t,n,{get:e[n],enumerable:!0})},T=(t,e,n,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of E(e))!y.call(t,o)&&o!==n&&l(t,o,{get:()=>e[o],enumerable:!(r=C(e,o))||r.enumerable});return t};var b=t=>T(l({},"__esModule",{value:!0}),t);var _={};D(_,{validateCIF:()=>I,validateDNI:()=>f,validateES:()=>O,validateNIE:()=>x});module.exports=b(_);var d=t=>typeof t=="string"&&t.length>0;var N=t=>d(t)?t.toUpperCase().replace(/[\s-]/g,""):null,c=(t,e)=>{let n=N(t);return n===null?null:e.test(n)?n:null};var a=(t,e)=>e[t%23];var g=t=>{let e="JABCDEFGHI",n=0,r=0;for(let u=0;u<t.length;u++){let p=parseInt(t[u],10);if(u%2===0){let i=p*2;r+=i>9?i-9:i}else n+=p}let s=(10-(n+r)%10)%10;return{digit:s,letter:e[s]}};var m="TRWAGMYFPDXBNJZSQVHLCKE",S=/^[0-9]{8}[A-Z]$/,h=/^[XYZ][0-9]{7}[A-Z]$/,R=/^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$/,F="PQRSNW",L="ABEH",f=t=>{let e=c(t,S);if(!e)return!1;let n=parseInt(e.slice(0,-1),10),r=e.slice(-1);return a(n,m)===r},x=t=>{let e=c(t,h);if(!e)return!1;let n=e.slice(-1),r=e[0],s=parseInt((r==="X"?"0":r==="Y"?"1":"2")+e.slice(1,-1),10);return a(s,m)===n},I=t=>{let e=c(t,R);if(!e)return!1;let n=e[0],r=e.slice(1,8),o=e[8],{digit:s,letter:u}=g(r);return F.includes(n)?o===u:L.includes(n)?o===String(s):o===String(s)||o===u},O=t=>f(t)||x(t)||I(t);0&&(module.exports={validateCIF,validateDNI,validateES,validateNIE});
 /**
- * Validate Spanish DNI (Documento Nacional de Identidad).
- * @param value - The DNI number to validate (8 digits + letter)
- * @returns boolean indicating whether the DNI is valid
+ * Types for Tax ID Validator
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
 /**
- * Validate Spanish NIE (Número de Identidad de Extranjero).
- * @param value - The NIE number to validate (X/Y/Z + 7 digits + letter)
- * @returns boolean indicating whether the NIE is valid
+ * Sanitization utilities for Tax ID validation
+ * Single Responsibility: Only handles string cleaning/normalization
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
 /**
- * Validate Spanish CIF (Código de Identificación Fiscal).
- * @param value - The CIF number to validate (letter + 7 digits + control)
- * @returns boolean indicating whether the CIF is valid
+ * Common validation algorithms
+ * Single Responsibility: Only contains mathematical validation algorithms
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate Spanish DNI/NIE/CIF numbers (auto-detect type).
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification is valid
+ * Spanish Tax ID Validators (DNI, NIE, CIF)
  * @author AngelBlanco97
  * @license MIT
  */

package/dist/validators/es.d.cts

@@ -1,36 +1,33 @@
+/**
+ * Spanish Tax ID Validators (DNI, NIE, CIF)
+ * @author AngelBlanco97
+ * @license MIT
+ */
 /**
  * Validate Spanish DNI (Documento Nacional de Identidad).
  * @param value - The DNI number to validate (8 digits + letter)
  * @returns boolean indicating whether the DNI is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
-declare const validateDNI: (value: any) => boolean;
+declare const validateDNI: (value: unknown) => boolean;
 /**
  * Validate Spanish NIE (Número de Identidad de Extranjero).
  * @param value - The NIE number to validate (X/Y/Z + 7 digits + letter)
  * @returns boolean indicating whether the NIE is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
-declare const validateNIE: (value: any) => boolean;
+declare const validateNIE: (value: unknown) => boolean;
 /**
  * Validate Spanish CIF (Código de Identificación Fiscal).
  * @param value - The CIF number to validate (letter + 7 digits + control)
  * @returns boolean indicating whether the CIF is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateCIF: (value: any) => boolean;
+declare const validateCIF: (value: unknown) => boolean;
 /**
  * Validate Spanish DNI/NIE/CIF numbers (auto-detect type).
  * @param value - The identification number to validate
  * @returns boolean indicating whether the identification is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateES: (value: any) => boolean;
+declare const validateES: (value: unknown) => boolean;
 
 export { validateCIF, validateDNI, validateES, validateNIE };

package/dist/validators/es.d.ts

@@ -1,36 +1,33 @@
+/**
+ * Spanish Tax ID Validators (DNI, NIE, CIF)
+ * @author AngelBlanco97
+ * @license MIT
+ */
 /**
  * Validate Spanish DNI (Documento Nacional de Identidad).
  * @param value - The DNI number to validate (8 digits + letter)
  * @returns boolean indicating whether the DNI is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
-declare const validateDNI: (value: any) => boolean;
+declare const validateDNI: (value: unknown) => boolean;
 /**
  * Validate Spanish NIE (Número de Identidad de Extranjero).
  * @param value - The NIE number to validate (X/Y/Z + 7 digits + letter)
  * @returns boolean indicating whether the NIE is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
-declare const validateNIE: (value: any) => boolean;
+declare const validateNIE: (value: unknown) => boolean;
 /**
  * Validate Spanish CIF (Código de Identificación Fiscal).
  * @param value - The CIF number to validate (letter + 7 digits + control)
  * @returns boolean indicating whether the CIF is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateCIF: (value: any) => boolean;
+declare const validateCIF: (value: unknown) => boolean;
 /**
  * Validate Spanish DNI/NIE/CIF numbers (auto-detect type).
  * @param value - The identification number to validate
  * @returns boolean indicating whether the identification is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateES: (value: any) => boolean;
+declare const validateES: (value: unknown) => boolean;
 
 export { validateCIF, validateDNI, validateES, validateNIE };

package/dist/validators/es.js

@@ -1,31 +1,23 @@
-var E="TRWAGMYFPDXBNJZSQVHLCKE",u="JABCDEFGHI",I=/^[0-9]{8}[A-Z]$/,b=/^[XYZ][0-9]{7}[A-Z]$/,d=/^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$/;var g=t=>{if(typeof t!="string")return!1;let e=t.toUpperCase().replace(/\s|-/g,"");if(!I.test(e))return!1;let n=e.slice(0,-1),s=e.slice(-1),r=parseInt(n,10);return E[r%23]===s};var C=t=>{if(typeof t!="string")return!1;let e=t.toUpperCase().replace(/\s|-/g,"");if(!b.test(e))return!1;let n=e.slice(0,-1),s=e.slice(-1);n=n.replace("X","0").replace("Y","1").replace("Z","2");let r=parseInt(n,10);return E[r%23]===s};var N=t=>{if(typeof t!="string")return!1;let e=t.toUpperCase().replace(/\s|-/g,"");if(!d.test(e))return!1;let n=e[0],s=e.slice(1,8),r=e[8],a=0,i=0;for(let o=0;o<s.length;o++){let f=parseInt(s[o],10);if(o%2===0){let l=f*2;i+=l>9?l-9:l}else a+=f}let c=(10-(a+i)%10)%10,p=u[c];return"PQRSNW".includes(n)?r===p:"ABEH".includes(n)?r===String(c):r===String(c)||r===p};var S=t=>g(t)||C(t)||N(t);export{N as validateCIF,g as validateDNI,S as validateES,C as validateNIE};
+var p=t=>typeof t=="string"&&t.length>0;var m=t=>p(t)?t.toUpperCase().replace(/[\s-]/g,""):null,c=(t,e)=>{let n=m(t);return n===null?null:e.test(n)?n:null};var l=(t,e)=>e[t%23];var d=t=>{let e="JABCDEFGHI",n=0,r=0;for(let s=0;s<t.length;s++){let a=parseInt(t[s],10);if(s%2===0){let i=a*2;r+=i>9?i-9:i}else n+=a}let o=(10-(n+r)%10)%10;return{digit:o,letter:e[o]}};var g="TRWAGMYFPDXBNJZSQVHLCKE",f=/^[0-9]{8}[A-Z]$/,x=/^[XYZ][0-9]{7}[A-Z]$/,I=/^[ABCDEFGHJNPQRSUVW][0-9]{7}[0-9A-J]$/,C="PQRSNW",E="ABEH",y=t=>{let e=c(t,f);if(!e)return!1;let n=parseInt(e.slice(0,-1),10),r=e.slice(-1);return l(n,g)===r},D=t=>{let e=c(t,x);if(!e)return!1;let n=e.slice(-1),r=e[0],o=parseInt((r==="X"?"0":r==="Y"?"1":"2")+e.slice(1,-1),10);return l(o,g)===n},T=t=>{let e=c(t,I);if(!e)return!1;let n=e[0],r=e.slice(1,8),u=e[8],{digit:o,letter:s}=d(r);return C.includes(n)?u===s:E.includes(n)?u===String(o):u===String(o)||u===s},L=t=>y(t)||D(t)||T(t);export{T as validateCIF,y as validateDNI,L as validateES,D as validateNIE};
 /**
- * Validate Spanish DNI (Documento Nacional de Identidad).
- * @param value - The DNI number to validate (8 digits + letter)
- * @returns boolean indicating whether the DNI is valid
+ * Types for Tax ID Validator
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
 /**
- * Validate Spanish NIE (Número de Identidad de Extranjero).
- * @param value - The NIE number to validate (X/Y/Z + 7 digits + letter)
- * @returns boolean indicating whether the NIE is valid
+ * Sanitization utilities for Tax ID validation
+ * Single Responsibility: Only handles string cleaning/normalization
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.interior.gob.es/opencms/es/servicios-al-ciudadano/tramites-y-gestiones/dni/calculo-del-digito-de-control-del-nif-nie/
  */
 /**
- * Validate Spanish CIF (Código de Identificación Fiscal).
- * @param value - The CIF number to validate (letter + 7 digits + control)
- * @returns boolean indicating whether the CIF is valid
+ * Common validation algorithms
+ * Single Responsibility: Only contains mathematical validation algorithms
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate Spanish DNI/NIE/CIF numbers (auto-detect type).
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification is valid
+ * Spanish Tax ID Validators (DNI, NIE, CIF)
  * @author AngelBlanco97
  * @license MIT
  */

package/dist/validators/fr.cjs

@@ -1,38 +1,23 @@
-"use strict";var o=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var R=(t,e)=>{for(var s in e)o(t,s,{get:e[s],enumerable:!0})},I=(t,e,s,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of g(e))!u.call(t,r)&&r!==s&&o(t,r,{get:()=>e[r],enumerable:!(n=d(e,r))||n.enumerable});return t};var y=t=>I(o({},"__esModule",{value:!0}),t);var N={};R(N,{validateFR:()=>E,validateFR_NIR:()=>x,validateFR_SIREN_SIRET:()=>h,validateNIR:()=>i,validateSIREN:()=>l,validateSIREN_SIRET:()=>c,validateSIRET:()=>a});module.exports=y(N);var b=/^[1-8]\d{2}(0[1-9]|1[0-2]|[2-9]\d)(\d{2}|2A|2B|97\d)\d{6}\d{2}$/,f=t=>{let e=0,s=!1;for(let n=t.length-1;n>=0;n--){let r=parseInt(t[n],10);s&&(r*=2,r>9&&(r-=9)),e+=r,s=!s}return e%10===0};var i=t=>{if(typeof t!="string")return!1;let e=t.toUpperCase().replace(/\s|-/g,"");if(!b.test(e))return!1;let s=parseInt(e.slice(-2),10),n=e.slice(0,-2),r=n.slice(5,7);r==="2A"&&(n=n.slice(0,5)+"19"+n.slice(7)),r==="2B"&&(n=n.slice(0,5)+"18"+n.slice(7));let p=BigInt(n);return Number(97n-p%97n)===s};var l=t=>{if(typeof t!="string")return!1;let e=t.replace(/\s|-/g,"");return!/^\d{9}$/.test(e)||/^(\d)\1+$/.test(e)?!1:f(e)};var a=t=>{if(typeof t!="string")return!1;let e=t.replace(/\s|-/g,"");return!/^\d{14}$/.test(e)||/^(\d)\1+$/.test(e)?!1:f(e)};var c=t=>{if(typeof t!="string")return!1;let e=t.replace(/\s|-/g,"");return e.length===9?l(e):e.length===14?a(e):!1};var E=t=>{if(typeof t!="string")return!1;let e=t.replace(/\s|-/g,"");return e.length===15?i(t):e.length===9?l(t):e.length===14?a(t):!1},h=c,x=i;0&&(module.exports={validateFR,validateFR_NIR,validateFR_SIREN_SIRET,validateNIR,validateSIREN,validateSIREN_SIRET,validateSIRET});
+"use strict";var i=Object.defineProperty;var x=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var h=(e,t)=>{for(var r in t)i(e,r,{get:t[r],enumerable:!0})},R=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of I(t))!y.call(e,o)&&o!==r&&i(e,o,{get:()=>t[o],enumerable:!(n=x(t,o))||n.enumerable});return e};var E=e=>R(i({},"__esModule",{value:!0}),e);var k={};h(k,{validateFR:()=>D,validateFR_NIR:()=>N,validateFR_SIREN_SIRET:()=>C,validateNIR:()=>c,validateSIREN:()=>a,validateSIREN_SIRET:()=>m,validateSIRET:()=>p});module.exports=E(k);var d=e=>typeof e=="string"&&e.length>0;var s=e=>d(e)?e.toUpperCase().replace(/[\s-]/g,""):null,f=(e,t)=>{let r=s(e);return r===null?null:t.test(r)?r:null};var u=e=>{let t=0,r=!1;for(let n=e.length-1;n>=0;n--){let o=parseInt(e[n],10);r&&(o*=2,o>9&&(o-=9)),t+=o,r=!r}return t%10===0};var g=e=>Number(97n-e%97n);var l=e=>/^(\d)\1+$/.test(e);var S=/^[1-8]\d{2}(0[1-9]|1[0-2]|[2-9]\d)(\d{2}|2A|2B|97\d)\d{6}\d{2}$/,b=/^\d{9}$/,T=/^\d{14}$/,c=e=>{let t=f(e,S);if(!t)return!1;let r=parseInt(t.slice(-2),10),n=t.slice(0,-2),o=n.slice(5,7);return o==="2A"&&(n=n.slice(0,5)+"19"+n.slice(7)),o==="2B"&&(n=n.slice(0,5)+"18"+n.slice(7)),g(BigInt(n))===r},a=e=>{let t=s(e);return!t||!b.test(t)||l(t)?!1:u(t)},p=e=>{let t=s(e);return!t||!T.test(t)||l(t)?!1:u(t)},m=e=>{let t=s(e);return t?t.length===9?a(t):t.length===14?p(t):!1:!1},D=e=>{let t=s(e);return t?t.length===15?c(e):t.length===9?a(e):t.length===14?p(e):!1:!1},C=m,N=c;0&&(module.exports={validateFR,validateFR_NIR,validateFR_SIREN_SIRET,validateNIR,validateSIREN,validateSIREN_SIRET,validateSIRET});
 /**
- * Validate French NIR (Numéro d'Inscription au Répertoire) - Social Security Number.
- * @param value - The NIR number to validate (15 digits)
- * @returns boolean indicating whether the NIR is valid
+ * Types for Tax ID Validator
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.service-public.gouv.fr/
  */
 /**
- * Validate French SIREN (Système d'Identification du Répertoire des Entreprises).
- * @param value - The SIREN number to validate (9 digits)
- * @returns boolean indicating whether the SIREN is valid
+ * Sanitization utilities for Tax ID validation
+ * Single Responsibility: Only handles string cleaning/normalization
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French SIRET (Système d'Identification du Répertoire des Établissements).
- * @param value - The SIRET number to validate (14 digits = SIREN + NIC)
- * @returns boolean indicating whether the SIRET is valid
+ * Common validation algorithms
+ * Single Responsibility: Only contains mathematical validation algorithms
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French SIREN or SIRET numbers (auto-detect by length).
- * @param value - The SIREN (9 digits) or SIRET (14 digits) number to validate
- * @returns boolean indicating whether the number is valid
+ * French Tax ID Validators (NIR, SIREN, SIRET)
  * @author AngelBlanco97
  * @license MIT
  */
-/**
- * Validates French identification numbers: NIR, SIREN, and SIRET (auto-detect).
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification number is valid
- * @author AngelBlanco97
- * @license MIT
- * @documentation https://www.service-public.gouv.fr/
- */

package/dist/validators/fr.d.cts

@@ -1,46 +1,41 @@
+/**
+ * French Tax ID Validators (NIR, SIREN, SIRET)
+ * @author AngelBlanco97
+ * @license MIT
+ */
 /**
  * Validate French NIR (Numéro d'Inscription au Répertoire) - Social Security Number.
  * @param value - The NIR number to validate (15 digits)
  * @returns boolean indicating whether the NIR is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://www.service-public.gouv.fr/
  */
-declare const validateNIR: (value: any) => boolean;
+declare const validateNIR: (value: unknown) => boolean;
 /**
  * Validate French SIREN (Système d'Identification du Répertoire des Entreprises).
  * @param value - The SIREN number to validate (9 digits)
  * @returns boolean indicating whether the SIREN is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateSIREN: (value: any) => boolean;
+declare const validateSIREN: (value: unknown) => boolean;
 /**
  * Validate French SIRET (Système d'Identification du Répertoire des Établissements).
  * @param value - The SIRET number to validate (14 digits = SIREN + NIC)
  * @returns boolean indicating whether the SIRET is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateSIRET: (value: any) => boolean;
+declare const validateSIRET: (value: unknown) => boolean;
 /**
  * Validate French SIREN or SIRET numbers (auto-detect by length).
  * @param value - The SIREN (9 digits) or SIRET (14 digits) number to validate
  * @returns boolean indicating whether the number is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateSIREN_SIRET: (value: any) => boolean;
+declare const validateSIREN_SIRET: (value: unknown) => boolean;
 /**
  * Validates French identification numbers: NIR, SIREN, and SIRET (auto-detect).
  * @param value - The identification number to validate
  * @returns boolean indicating whether the identification number is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://www.service-public.gouv.fr/
  */
-declare const validateFR: (value: any) => boolean;
-declare const validateFR_SIREN_SIRET: (value: any) => boolean;
-declare const validateFR_NIR: (value: any) => boolean;
+declare const validateFR: (value: unknown) => boolean;
+declare const validateFR_SIREN_SIRET: (value: unknown) => boolean;
+declare const validateFR_NIR: (value: unknown) => boolean;
 
 export { validateFR, validateFR_NIR, validateFR_SIREN_SIRET, validateNIR, validateSIREN, validateSIREN_SIRET, validateSIRET };

package/dist/validators/fr.d.ts

@@ -1,46 +1,41 @@
+/**
+ * French Tax ID Validators (NIR, SIREN, SIRET)
+ * @author AngelBlanco97
+ * @license MIT
+ */
 /**
  * Validate French NIR (Numéro d'Inscription au Répertoire) - Social Security Number.
  * @param value - The NIR number to validate (15 digits)
  * @returns boolean indicating whether the NIR is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://www.service-public.gouv.fr/
  */
-declare const validateNIR: (value: any) => boolean;
+declare const validateNIR: (value: unknown) => boolean;
 /**
  * Validate French SIREN (Système d'Identification du Répertoire des Entreprises).
  * @param value - The SIREN number to validate (9 digits)
  * @returns boolean indicating whether the SIREN is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateSIREN: (value: any) => boolean;
+declare const validateSIREN: (value: unknown) => boolean;
 /**
  * Validate French SIRET (Système d'Identification du Répertoire des Établissements).
  * @param value - The SIRET number to validate (14 digits = SIREN + NIC)
  * @returns boolean indicating whether the SIRET is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateSIRET: (value: any) => boolean;
+declare const validateSIRET: (value: unknown) => boolean;
 /**
  * Validate French SIREN or SIRET numbers (auto-detect by length).
  * @param value - The SIREN (9 digits) or SIRET (14 digits) number to validate
  * @returns boolean indicating whether the number is valid
- * @author AngelBlanco97
- * @license MIT
  */
-declare const validateSIREN_SIRET: (value: any) => boolean;
+declare const validateSIREN_SIRET: (value: unknown) => boolean;
 /**
  * Validates French identification numbers: NIR, SIREN, and SIRET (auto-detect).
  * @param value - The identification number to validate
  * @returns boolean indicating whether the identification number is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://www.service-public.gouv.fr/
  */
-declare const validateFR: (value: any) => boolean;
-declare const validateFR_SIREN_SIRET: (value: any) => boolean;
-declare const validateFR_NIR: (value: any) => boolean;
+declare const validateFR: (value: unknown) => boolean;
+declare const validateFR_SIREN_SIRET: (value: unknown) => boolean;
+declare const validateFR_NIR: (value: unknown) => boolean;
 
 export { validateFR, validateFR_NIR, validateFR_SIREN_SIRET, validateNIR, validateSIREN, validateSIREN_SIRET, validateSIRET };

package/dist/validators/fr.js

@@ -1,38 +1,23 @@
-var c=/^[1-8]\d{2}(0[1-9]|1[0-2]|[2-9]\d)(\d{2}|2A|2B|97\d)\d{6}\d{2}$/,o=t=>{let e=0,s=!1;for(let n=t.length-1;n>=0;n--){let r=parseInt(t[n],10);s&&(r*=2,r>9&&(r-=9)),e+=r,s=!s}return e%10===0};var i=t=>{if(typeof t!="string")return!1;let e=t.toUpperCase().replace(/\s|-/g,"");if(!c.test(e))return!1;let s=parseInt(e.slice(-2),10),n=e.slice(0,-2),r=n.slice(5,7);r==="2A"&&(n=n.slice(0,5)+"19"+n.slice(7)),r==="2B"&&(n=n.slice(0,5)+"18"+n.slice(7));let f=BigInt(n);return Number(97n-f%97n)===s};var l=t=>{if(typeof t!="string")return!1;let e=t.replace(/\s|-/g,"");return!/^\d{9}$/.test(e)||/^(\d)\1+$/.test(e)?!1:o(e)};var a=t=>{if(typeof t!="string")return!1;let e=t.replace(/\s|-/g,"");return!/^\d{14}$/.test(e)||/^(\d)\1+$/.test(e)?!1:o(e)};var p=t=>{if(typeof t!="string")return!1;let e=t.replace(/\s|-/g,"");return e.length===9?l(e):e.length===14?a(e):!1};var d=t=>{if(typeof t!="string")return!1;let e=t.replace(/\s|-/g,"");return e.length===15?i(t):e.length===9?l(t):e.length===14?a(t):!1},g=p,u=i;export{d as validateFR,u as validateFR_NIR,g as validateFR_SIREN_SIRET,i as validateNIR,l as validateSIREN,p as validateSIREN_SIRET,a as validateSIRET};
+var l=e=>typeof e=="string"&&e.length>0;var s=e=>l(e)?e.toUpperCase().replace(/[\s-]/g,""):null,c=(e,t)=>{let r=s(e);return r===null?null:t.test(r)?r:null};var i=e=>{let t=0,r=!1;for(let n=e.length-1;n>=0;n--){let o=parseInt(e[n],10);r&&(o*=2,o>9&&(o-=9)),t+=o,r=!r}return t%10===0};var a=e=>Number(97n-e%97n);var u=e=>/^(\d)\1+$/.test(e);var g=/^[1-8]\d{2}(0[1-9]|1[0-2]|[2-9]\d)(\d{2}|2A|2B|97\d)\d{6}\d{2}$/,m=/^\d{9}$/,x=/^\d{14}$/,p=e=>{let t=c(e,g);if(!t)return!1;let r=parseInt(t.slice(-2),10),n=t.slice(0,-2),o=n.slice(5,7);return o==="2A"&&(n=n.slice(0,5)+"19"+n.slice(7)),o==="2B"&&(n=n.slice(0,5)+"18"+n.slice(7)),a(BigInt(n))===r},d=e=>{let t=s(e);return!t||!m.test(t)||u(t)?!1:i(t)},f=e=>{let t=s(e);return!t||!x.test(t)||u(t)?!1:i(t)},I=e=>{let t=s(e);return t?t.length===9?d(t):t.length===14?f(t):!1:!1},T=e=>{let t=s(e);return t?t.length===15?p(e):t.length===9?d(e):t.length===14?f(e):!1:!1},D=I,C=p;export{T as validateFR,C as validateFR_NIR,D as validateFR_SIREN_SIRET,p as validateNIR,d as validateSIREN,I as validateSIREN_SIRET,f as validateSIRET};
 /**
- * Validate French NIR (Numéro d'Inscription au Répertoire) - Social Security Number.
- * @param value - The NIR number to validate (15 digits)
- * @returns boolean indicating whether the NIR is valid
+ * Types for Tax ID Validator
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://www.service-public.gouv.fr/
  */
 /**
- * Validate French SIREN (Système d'Identification du Répertoire des Entreprises).
- * @param value - The SIREN number to validate (9 digits)
- * @returns boolean indicating whether the SIREN is valid
+ * Sanitization utilities for Tax ID validation
+ * Single Responsibility: Only handles string cleaning/normalization
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French SIRET (Système d'Identification du Répertoire des Établissements).
- * @param value - The SIRET number to validate (14 digits = SIREN + NIC)
- * @returns boolean indicating whether the SIRET is valid
+ * Common validation algorithms
+ * Single Responsibility: Only contains mathematical validation algorithms
  * @author AngelBlanco97
  * @license MIT
  */
 /**
- * Validate French SIREN or SIRET numbers (auto-detect by length).
- * @param value - The SIREN (9 digits) or SIRET (14 digits) number to validate
- * @returns boolean indicating whether the number is valid
+ * French Tax ID Validators (NIR, SIREN, SIRET)
  * @author AngelBlanco97
  * @license MIT
  */
-/**
- * Validates French identification numbers: NIR, SIREN, and SIRET (auto-detect).
- * @param value - The identification number to validate
- * @returns boolean indicating whether the identification number is valid
- * @author AngelBlanco97
- * @license MIT
- * @documentation https://www.service-public.gouv.fr/
- */

package/dist/validators/pt.cjs

@@ -1,9 +1,23 @@
-"use strict";var s=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var I=Object.prototype.hasOwnProperty;var d=(e,t)=>{for(var o in t)s(e,o,{get:t[o],enumerable:!0})},T=(e,t,o,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of p(t))!I.call(e,n)&&n!==o&&s(e,n,{get:()=>t[n],enumerable:!(r=u(t,n))||r.enumerable});return e};var g=e=>T(s({},"__esModule",{value:!0}),e);var x={};d(x,{validateNIF:()=>l,validatePT:()=>D});module.exports=g(x);var m=["1","2","3","5","6","8","9"];var l=e=>{if(typeof e!="string")return!1;let t=e.replace(/\s|-/g,"");if(!/^[0-9]{9}$/.test(t)||!m.includes(t[0]))return!1;let n=11-t.slice(0,8).split("").reduce((i,a,c)=>{let f=9-c;return i+parseInt(a,10)*f},0)%11;return n>=10&&(n=0),n===parseInt(t[8],10)},D=l;0&&(module.exports={validateNIF,validatePT});
+"use strict";var s=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var x=(t,e)=>{for(var o in e)s(t,o,{get:e[o],enumerable:!0})},I=(t,e,o,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of m(e))!f.call(t,n)&&n!==o&&s(t,n,{get:()=>e[n],enumerable:!(r=g(e,n))||r.enumerable});return t};var y=t=>I(s({},"__esModule",{value:!0}),t);var T={};x(T,{validateNIF:()=>l,validatePT:()=>C});module.exports=y(T);var i=t=>typeof t=="string"&&t.length>0;var u=t=>i(t)?t.toUpperCase().replace(/[\s-]/g,""):null;var c=t=>{let r=11-t.reduce((n,p,a)=>{let d=9-a;return n+p*d},0)%11;return r>=10?0:r};var D=/^[0-9]{9}$/,h=["1","2","3","5","6","8","9"],l=t=>{let e=u(t);if(!e||!D.test(e)||!h.includes(e[0]))return!1;let o=e.slice(0,8).split("").map(n=>parseInt(n,10));return c(o)===parseInt(e[8],10)},C=l;0&&(module.exports={validateNIF,validatePT});
 /**
- * Validates a Portuguese NIF (Número de Identificação Fiscal).
- * @param value - The NIF number to validate (9 digits)
- * @returns boolean indicating whether the NIF is valid
+ * Types for Tax ID Validator
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Sanitization utilities for Tax ID validation
+ * Single Responsibility: Only handles string cleaning/normalization
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Common validation algorithms
+ * Single Responsibility: Only contains mathematical validation algorithms
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Portuguese Tax ID Validators (NIF)
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://en.wikipedia.org/wiki/Tax_identification_number#Portugal
  */

package/dist/validators/pt.d.cts

@@ -1,18 +1,21 @@
+/**
+ * Portuguese Tax ID Validators (NIF)
+ * @author AngelBlanco97
+ * @license MIT
+ */
 /**
  * Validates a Portuguese NIF (Número de Identificação Fiscal).
  * @param value - The NIF number to validate (9 digits)
  * @returns boolean indicating whether the NIF is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://en.wikipedia.org/wiki/Tax_identification_number#Portugal
  */
-declare const validateNIF: (value: any) => boolean;
+declare const validateNIF: (value: unknown) => boolean;
 /**
  * Validates a Portuguese NIF (Número de Identificação Fiscal).
  * Alias for validateNIF for consistency with other country validators.
  * @param value - The NIF number to validate
  * @returns boolean indicating whether the NIF is valid
  */
-declare const validatePT: (value: any) => boolean;
+declare const validatePT: (value: unknown) => boolean;
 
 export { validateNIF, validatePT };

package/dist/validators/pt.d.ts

@@ -1,18 +1,21 @@
+/**
+ * Portuguese Tax ID Validators (NIF)
+ * @author AngelBlanco97
+ * @license MIT
+ */
 /**
  * Validates a Portuguese NIF (Número de Identificação Fiscal).
  * @param value - The NIF number to validate (9 digits)
  * @returns boolean indicating whether the NIF is valid
- * @author AngelBlanco97
- * @license MIT
  * @documentation https://en.wikipedia.org/wiki/Tax_identification_number#Portugal
  */
-declare const validateNIF: (value: any) => boolean;
+declare const validateNIF: (value: unknown) => boolean;
 /**
  * Validates a Portuguese NIF (Número de Identificação Fiscal).
  * Alias for validateNIF for consistency with other country validators.
  * @param value - The NIF number to validate
  * @returns boolean indicating whether the NIF is valid
  */
-declare const validatePT: (value: any) => boolean;
+declare const validatePT: (value: unknown) => boolean;
 
 export { validateNIF, validatePT };

package/dist/validators/pt.js

@@ -1,9 +1,23 @@
-var i=["1","2","3","5","6","8","9"];var a=n=>{if(typeof n!="string")return!1;let t=n.replace(/\s|-/g,"");if(!/^[0-9]{9}$/.test(t)||!i.includes(t[0]))return!1;let e=11-t.slice(0,8).split("").reduce((o,r,s)=>{let l=9-s;return o+parseInt(r,10)*l},0)%11;return e>=10&&(e=0),e===parseInt(t[8],10)},u=a;export{a as validateNIF,u as validatePT};
+var s=t=>typeof t=="string"&&t.length>0;var i=t=>s(t)?t.toUpperCase().replace(/[\s-]/g,""):null;var u=t=>{let n=11-t.reduce((o,c,l)=>{let p=9-l;return o+c*p},0)%11;return n>=10?0:n};var a=/^[0-9]{9}$/,d=["1","2","3","5","6","8","9"],g=t=>{let e=i(t);if(!e||!a.test(e)||!d.includes(e[0]))return!1;let r=e.slice(0,8).split("").map(o=>parseInt(o,10));return u(r)===parseInt(e[8],10)},h=g;export{g as validateNIF,h as validatePT};
 /**
- * Validates a Portuguese NIF (Número de Identificação Fiscal).
- * @param value - The NIF number to validate (9 digits)
- * @returns boolean indicating whether the NIF is valid
+ * Types for Tax ID Validator
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Sanitization utilities for Tax ID validation
+ * Single Responsibility: Only handles string cleaning/normalization
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Common validation algorithms
+ * Single Responsibility: Only contains mathematical validation algorithms
+ * @author AngelBlanco97
+ * @license MIT
+ */
+/**
+ * Portuguese Tax ID Validators (NIF)
  * @author AngelBlanco97
  * @license MIT
- * @documentation https://en.wikipedia.org/wiki/Tax_identification_number#Portugal
  */

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "validator-tax-id",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "type": "module",
+  "funding": {
+    "type": "paypal",
+    "url": "https://paypal.me/AngelBlanco747"
+  },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",