trid-validator

Lightweight Turkish National ID (TC Kimlik No / TCKN) validation library.

Installation

npm install trid-validator

Usage

import { validateTRID } from 'trid-validator';

validate('10000000146'); // true or false

API

validateTRID(tcno: string): boolean

Returns true if the given TC Kimlik number is valid.

validateDetailed(tcno: string): ValidationResult

Returns detailed validation result with error information.

interface ValidationResult {
  isValid: boolean;
  errors: ValidationError[];
}

Algorithm

The Turkish National ID is an 11-digit number validated with a double checksum:

1. Must be exactly 11 digits
2. First digit cannot be zero
3. 10th digit = ((sum of odd-positioned digits × 7) − sum of even-positioned digits) mod 10
4. 11th digit = sum of first 10 digits mod 10

License

MIT