Codice fiscale en TypeScript

Présentation

La bibliothèque propose quatre familles d’outils : un parser pour encoder et décoder un codice fiscale, des générateurs de motifs d’expressions régulières, des validateurs, et un validateur de cohérence entre un codice fiscale et des données personnelles (nom, prénom, date et lieu de naissance, sexe). Elle gère aussi les cas d’omocodia.

Le README précise qu’un connecteur Belfiore est indispensable pour les lieux de naissance : un connecteur à jeu de données embarqué, un connecteur JSON, ou le sien à partir de la classe abstraite fournie. Le projet est sous licence MIT ; les listes de communes et de pays reposent sur des jeux de données ouverts sous licences CC BY.

Points forts

• La FAQ rappelle qu’une simple RegExp ne vérifie ni la cohérence entre date et lieu de naissance ni le caractère de contrôle ; la bibliothèque s’en charge.
• Omocodia prise en charge par une classe dédiée, intégrée au Parser, au Validator et au Pattern (cfDeomocode, cfOmocode, cfOmocodeId).
• Encodage et décodage complets : encodeCf produit le code à partir des données, cfDecode retrouve nom, date, sexe et lieu.
• Validateur de cohérence (CFMismatchValidator) avec des méthodes match et mismatch pour le nom, le prénom, la date, le sexe et le lieu de naissance.
• Compatibilité annoncée avec Node.js, Chrome, Firefox et Edge.

Pour qui

Pour les développeurs JavaScript ou TypeScript qui doivent contrôler ou produire un codice fiscale, dans un service Node.js ou dans une application web côté navigateur.

Installation

Installation par npm. Le README demande en plus un BelfioreConnector, à choisir parmi deux paquets @marketto (jeu de données embarqué, ou liste JSON) ou à écrire soi-même ; la bibliothèque s’instancie ensuite avec ce connecteur. Une inclusion par balises script est aussi décrite.

npm i -s @marketto/codice-fiscale-utils

Lire le README sur GitHub

Points d’attention

• Le README indique qu’un connecteur Belfiore est requis ; il s’installe séparément, sous forme de paquet @marketto distinct.
• L’année à deux chiffres est ambiguë : le parser retient 20xx si la date est valide dans les 100 dernières années, sinon 19xx.
• Les fonctions liées aux lieux (placeToCf, cfDecode, validations de lieu) sont asynchrones et s’utilisent avec await.

Utilisable par un agent ?

Aucun SKILL.md, AGENTS.md, CLAUDE.md, règle Cursor ni serveur MCP trouvé à la racine ou dans le README. C’est une bibliothèque JavaScript/TypeScript à intégrer dans du code.