Document identifiers

import {
  isValidPinfl,
  parsePinfl,
  formatPinfl,
  isValidInn,
  formatInn,
  isValidPassport,
  formatPassport,
  isValidCarPlate,
  parseCarPlate,
  formatCarPlate,
  isValidBankAccount,
  formatBankAccount,
  isValidMfo,
  UZ_REGIONS,
  regionByPlateCode,
} from '@akhatmirzo/core';

function parsePinfl(
  input: string | number | null | undefined,
  options?: PinflOptions, // { checksum?: boolean }
): PinflInfo | null;

interface PinflInfo {
  gender: 'male' | 'female';
  birthDate: Date; // local time, 00:00
}

parsePinfl('31503901234567'); // { gender: 'male', birthDate: new Date(1990, 2, 15) }
parsePinfl('6 010120 1234567'); // { gender: 'female', birthDate: new Date(2020, 0, 1) }
parsePinfl('33102901234567'); // null — there is no 31 February
parsePinfl('21503901234567'); // null — the first digit must be 3–6

function isValidPinfl(input: string | number | null | undefined, options?: PinflOptions): boolean;

isValidPinfl('31503901234567'); // true
isValidPinfl('315039012345'); // false — 12 digits
isValidPinfl('31503901234562', { checksum: true }); // true
isValidPinfl('31503901234567', { checksum: true }); // false — check digit doesn't match

function formatPinfl(input: string | number | null | undefined): string;

formatPinfl('31503901234567'); // '31503 90123 4567'
formatPinfl('315039'); // '31503 9'

function isValidInn(input: string | number | null | undefined): boolean;

isValidInn('123456789'); // true
isValidInn('123 456 789'); // true
isValidInn('012345678'); // false — starts with 0
isValidInn('12345678'); // false — 8 digits

function formatInn(input: string | number | null | undefined): string;

formatInn('123456789'); // '123 456 789'
formatInn('1234'); // '123 4'

function isValidPassport(input: string | null | undefined): boolean;

isValidPassport('AA1234567'); // true
isValidPassport('ad 1234567'); // true
isValidPassport('АА1234567'); // false — Cyrillic letters
isValidPassport('A1234567'); // false — one-letter series

function formatPassport(input: string | null | undefined): string;

formatPassport('aa1234567'); // 'AA 1234567'
formatPassport('ad 12'); // 'AD 12'

function parseCarPlate(input: string | null | undefined): CarPlateInfo | null;

interface CarPlateInfo {
  region: UzRegion; // from UZ_REGIONS
  regionCode: string; // '01'
  type: 'personal' | 'legal';
}

parseCarPlate('01 A 123 BC'); // { region: { id: 'tashkent-city', … }, regionCode: '01', type: 'personal' }
parseCarPlate('30 123 abc')?.type; // 'legal'
parseCarPlate('00 A 123 BC'); // null — code 00 belongs to no region

function isValidCarPlate(input: string | null | undefined): boolean;

isValidCarPlate('01A123BC'); // true
isValidCarPlate('01 1234 AB'); // false

function formatCarPlate(input: string | null | undefined): string;

formatCarPlate('01a123bc'); // '01 A 123 BC'
formatCarPlate('01123abc'); // '01 123 ABC'
formatCarPlate('01A1'); // '01 A 1'

function isValidBankAccount(input: string | null | undefined): boolean;

isValidBankAccount('20208000900012345001'); // true
isValidBankAccount('2020 8000 9000 1234 5001'); // true
isValidBankAccount('2020800090001234500'); // false — 19 digits

function formatBankAccount(input: string | null | undefined): string;

formatBankAccount('20208000900012345001'); // '2020 8000 9000 1234 5001'

function isValidMfo(input: string | null | undefined): boolean;

isValidMfo('00014'); // true
isValidMfo('1234'); // false

const UZ_REGIONS: readonly UzRegion[];

interface UzRegion {
  id: UzRegionId; // 'tashkent-city', 'andijan', ...
  name: string; // 'Andijon viloyati'
  nameCyr: string; // 'Андижон вилояти'
  center: string; // 'Andijon'
  plateCodes: readonly string[]; // ['60', '61', …, '69']
}

import { UZ_REGIONS } from '@akhatmirzo/core';

export function RegionOptions() {
  return UZ_REGIONS.map((r) => (
    <option key={r.id} value={r.id}>
      {r.name}
    </option>
  ));
}

function regionByPlateCode(code: string | number | null | undefined): UzRegion | null;

regionByPlateCode('01')?.id; // 'tashkent-city'
regionByPlateCode(95)?.name; // 'Qoraqalpogʻiston Respublikasi'
regionByPlateCode('02')?.id; // 'tashkent-city' (range 01–09)
regionByPlateCode('00'); // null

interface PinflOptions {
  checksum?: boolean; // default: false
}
interface PinflInfo {
  gender: 'male' | 'female';
  birthDate: Date;
}
type CarPlateType = 'personal' | 'legal';
interface CarPlateInfo {
  region: UzRegion;
  regionCode: string;
  type: CarPlateType;
}
type UzRegionId =
  | 'karakalpakstan'
  | 'andijan'
  | 'bukhara'
  | 'jizzakh'
  | 'kashkadarya'
  | 'navoi'
  | 'namangan'
  | 'samarkand'
  | 'surkhandarya'
  | 'syrdarya'
  | 'tashkent'
  | 'fergana'
  | 'khorezm'
  | 'tashkent-city';