Bulgarian Control Numbers (TypeScript Edition)

:bulgaria: Проверка на контролни цифри ползвани в България - ЕГН, ЛНЧ, Булстат, IBAN.

Note: This is a modernized TypeScript version of the original library by Petar Petrov. The original JavaScript library can be found at petarov/bulgarian-control-numbers. This version includes TypeScript support, modern build tooling (Vite), and ESM support while maintaining full backward compatibility.

Install

npm install bulgarian-control-numbers

or

yarn add bulgarian-control-numbers

or

<script src="https://cdn.jsdelivr.net/npm/[email protected]/build/bgcn.min.js"></script>

Usage

As a node.js module (CommonJS):

const BGCN = require('bulgarian-control-numbers').default;

As an ES module:

import BGCN from 'bulgarian-control-numbers';

With TypeScript:

import BGCN from 'bulgarian-control-numbers';

const egn = BGCN.egn('0550290476');
egn.isValid // true
egn.value // '0550290476'
egn.gender // 'f'
egn.birthday.day // 29
egn.birthday.month // 10
egn.birthday.year // 2005

const pn = BGCN.pn('1001122334'); // ЛНЧ
pn.isValid // true

const bulstat = BGCN.bulstat('BG131071587')
bulstat.isValid // true
bulstat.value // '131071587'

const iban = BGCN.iban('BG15UNCR70001522604629');
iban.isValid // true
iban.value // 'BG15UNCR70001522604629'
iban.accountNo // '22604629'
iban.bic // 'UNCRBGSF'

BGCN.isValid('BG131071587') // true
BGCN.isValid('BG15UNCR70001522604629') // true

In a web page:

<script type="text/javascript" src="bgcn.js"></script>
<script>
    var BGCN = BGCN.default;
    var egn = BGCN.egn('0550290476');
    // ...
</script>

Development

Run yarn install to install dependencies.

Run yarn test to run unit tests.

Run yarn build to create a build (produces both UMD and ESM formats).

Run yarn type-check to verify TypeScript types.

Credits

Original Author: Petar Petrov - Original JavaScript implementation
Modernization: 3ig - TypeScript migration, Vite build system, and ESM support

This is a modernization of the original bulgarian-control-numbers library, converted to TypeScript with modern tooling while maintaining 100% backward compatibility.

References

• БСВ Консултинг - Контролни цифри ползвани в България
• Единен граждански номер
• International Bank Account Number

License

MIT - Copyright (c) 2020 Petar Petrov (original author)