Rc-validator NPM

Simple JavaScript validator of Slovak birth numbers (a.k.a. personal numbers)

This library contains a validation methods for slovak birth numbers. It checks following properties:

correct position of '/' character
illegal characters
length
- 9 chars for year prior 1953 included
- 10 chars for year after 1953 excluded
valid month
valid day
mod 11 check

Installation

npm i rc-validator or yarn add rc-validator

Usage

import {getValidationError, isValid} from 'rc-validator'

const birthNumber = '700803/8752'

const result = getValidationError(birthNumber)
const valid = isValid(birthNumber)
const slashPresentError = getValidationError(birthNumber, 'SLASH_MUST_NOT_BE_PRESENT')

// result === undefined
// valid === true
// slashPresentError === 'SLASH_MUST_NOT_BE_PRESENT'

Methods

isValid(value: string, slashRule: SlashRule = SlashRule.OPTIONAL): boolean

value - input value
slashRule - flag declaring how to handle '/' char
returns true when input value is valid, otherwise false

getValidationError(value: string, slashRule: SlashRule = SlashRule.OPTIONAL): ValidationError | undefined

value - input value
slashRule - flag declaring how to handle '/' char
returns undefined when input value is valid, otherwise ValidationError enum value

SlashRule

Value	Description	Note
SLASH_OPTIONAL	It accepts input with or without slash	Default
SLASH_REQUIRED	Slash is required
SLASH_MUST_NOT_BE_PRESENT	Slash is prohibited, only numbers are accepted

ValidationError

Value	Description	Note
TOO_SHORT	Input is shorter than 9
TOO_LONG	Input is longer than 11
SLASH_REQUIRED	SlashRule === REQUIRED, but '/' is not present in input
SLASH_MUST_NOT_BE_PRESENT	SlashRule === MUST_NOT_BE_PRESENT, but '/' is present in input
INVALID_SLASH_POSITION	Slash char index is not 6
NOT_A_NUMBER	Input contains illegal characters
INVALID_MONTH	Month part is not 1...12
INVALID_DAY	Day part is not 1...31	Months with 28 or 30 days are not validated by this rule, because mod 11 rule takes care about that
INVALID_YEAR_9_CHARS	Input is 9 char long (excluding slash), but year part is > 53
INVALID_YEAR_10_CHARS	Input is 10 char long (excluding slash), mod 11 rule not fulfilled and year < 54 or year > 85
MOD_11_CHECK_FAIL	Mod 11 rule not fulfilled