NRIC Utils

Functions to validate and mask Singapore NRICs

Features

• [x] Validate NRICs
• [x] Mask NRICs (SXXXXXXXA => SXXXA)
• [x] Validate masked NRICs
• [ ] Yup integration
  • [ ] Yup method for validating NRICs
  • [ ] Yup method for validating masked NRICs
• [ ] Generate NRICs
• [ ] Tests
  • [x] Tests for validating NRICs
  • [x] Tests for masking NRICs
  • [x] Tests for validating masked NRICs
  • [ ] Tests for generating NRICs

Docs

Installation

npm install nric-utils

Usage

const { maskNric, validateNric } = require('nric-utils');
// Or
import { maskNric, validateNric } from 'nric-utils';

const nric = 'S0000002G';

validateNric(nric); 
// => true

maskNric('S0000002G'); 
// => 002G

/* 
Pass in true to maskNric to also include the first letter:
*/
maskNric('S0000002G', true); 
// => S002G

⚙Build setup

Clone or fork the repository, then run

npm install

# to runs tests
npm run test -s

# format with prettier
npm run format

# build (convert to JavaScript)
npm run build

Format and ensure tests pass before pushing.

License

MIT