Codice fiscale in TypeScript

Presentazione

La libreria offre quattro famiglie di strumenti: un parser per codificare e decodificare un codice fiscale, generatori di pattern per espressioni regolari, validatori, e un validatore di coerenza tra un codice fiscale e dati personali (cognome, nome, data e luogo di nascita, sesso). Gestisce anche i casi di omocodia.

Il README precisa che per i luoghi di nascita serve un connettore Belfiore: uno con dataset incorporato, uno JSON, oppure uno proprio basato sulla classe astratta fornita. Il progetto è sotto licenza MIT; gli elenchi di comuni e Stati si basano su dataset aperti con licenze CC BY.

Punti di forza

• Le FAQ ricordano che una semplice RegExp non verifica né la coerenza tra data e luogo di nascita né il carattere di controllo; la libreria se ne occupa.
• Omocodia gestita da una classe dedicata, integrata in Parser, Validator e Pattern (cfDeomocode, cfOmocode, cfOmocodeId).
• Codifica e decodifica complete: encodeCf produce il codice a partire dai dati, cfDecode ricava nome, data, sesso e luogo.
• Validatore di coerenza (CFMismatchValidator) con metodi match e mismatch per cognome, nome, data, sesso e luogo di nascita.
• Compatibilità dichiarata con Node.js, Chrome, Firefox ed Edge.

Per chi

Per gli sviluppatori JavaScript o TypeScript che devono controllare o produrre un codice fiscale, in un servizio Node.js o in un’applicazione web lato browser.

Installazione

Installazione con npm. Il README richiede inoltre un BelfioreConnector, da scegliere tra due pacchetti @marketto (dataset incorporato, o elenco JSON) oppure da scrivere in proprio; la libreria si istanzia poi con quel connettore. È descritta anche l’inclusione tramite tag script.

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

Leggete il README su GitHub

Punti di attenzione

• Il README indica che un connettore Belfiore è richiesto; si installa a parte, come pacchetto @marketto distinto.
• L’anno a due cifre è ambiguo: il parser sceglie 20xx se la data è valida negli ultimi 100 anni, altrimenti 19xx.
• Le funzioni legate ai luoghi (placeToCf, cfDecode, validazioni del luogo) sono asincrone e si usano con await.

Utilizzabile da un agente?

Nessun SKILL.md, AGENTS.md, CLAUDE.md, regola Cursor o server MCP trovato nella radice o nel README. È una libreria JavaScript/TypeScript da integrare nel codice.