Codice fiscale in TypeScript

Overview

The library offers four families of tools: a parser to encode and decode a codice fiscale, generators of regular-expression patterns, validators, and a validator that checks a codice fiscale against personal data (last name, first name, birth date and place, gender). It also handles omocodia cases.

The README states that a Belfiore connector is required for birthplaces: one with an embedded dataset, a JSON one, or your own built on the provided abstract class. The project is MIT licensed; the lists of municipalities and countries rely on open datasets under CC BY licenses.

Highlights

• The FAQ points out that a plain RegExp checks neither the consistency between birth date and place nor the check character; the library does.
• Omocodia handled by a dedicated class, integrated into the Parser, Validator and Pattern (cfDeomocode, cfOmocode, cfOmocodeId).
• Full encoding and decoding: encodeCf builds the code from the data, cfDecode recovers name codes, date, gender and place.
• Consistency validator (CFMismatchValidator) with match and mismatch methods for last name, first name, date, gender and birthplace.
• Declared compatibility with Node.js, Chrome, Firefox and Edge.

Who it is for

For JavaScript or TypeScript developers who need to check or produce a codice fiscale, in a Node.js service or a browser-side web application.

Installation

Install with npm. The README also requires a BelfioreConnector, to be chosen from two @marketto packages (embedded dataset, or JSON list) or written yourself; the library is then instantiated with that connector. Inclusion through script tags is also described.

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

Read the README on GitHub

Points of attention

• The README states that a Belfiore connector is required; it is installed separately, as a distinct @marketto package.
• The two-digit year is ambiguous: the parser picks 20xx if the date would be valid within the last 100 years, otherwise 19xx.
• Place-related functions (placeToCf, cfDecode, place validators) are asynchronous and used with await.

Can an agent use it?

No SKILL.md, AGENTS.md, CLAUDE.md, Cursor rules or MCP server found at the root or in the README. This is a JavaScript/TypeScript library to integrate into code.