v1.0.0 - Initial Release
π Initial release of idnumbers package
Features
- β 80 countries supported - Comprehensive coverage across all continents
- π Validation - Verify ID number format and checksums
- π Parsing - Extract information like birth date, gender, and citizenship
- π‘οΈ Type-safe - Full TypeScript support with type definitions
- π¦ Zero dependencies - Lightweight and secure
- β¨ Well-tested - 797 tests with 100% pass rate
- π Multiple formats - Supports various ID number formats per country
Installation
npm install idnumbersQuick Start
import { validateNationalId, parseIdInfo } from 'idnumbers';
// Validate a US Social Security Number
const result = validateNationalId('USA', '123-45-6789');
console.log(result.isValid); // true or false
// Parse information from a South African ID
const info = parseIdInfo('ZAF', '8001015009087');
console.log(info);
// {
// yyyymmdd: Date(1980-01-01),
// gender: 'male',
// citizenship: 'citizen'
// }Supported Countries
80+ countries including: USA, UK, France, Germany, Japan, China, India, Brazil, Canada, Australia, South Africa, and many more.
See full documentation: https://github.com/identique/idnumbers-npm#readme