🇹🇷 tr-vkn-validator 🇹🇷

Türkiye Vergi Kimlik Numarası (VKN) ve TC Kimlik Numarası (TCKN) Doğrulayıcı

Hafif, sıfır bağımlılığa sahip (zero-dependency) ve tam tip destekli VKN/TCKN doğrulama kütüphanesi.

🌟 Neden Bu Paket?

• 🚀 Çok Hafif: Projenize ekstra hiçbir bağımlılık (dependency) yüklemez.
• 🛡️ Tip Güvenli: %100 TypeScript ile yazılmıştır. Hata yapma riskinizi azaltır.
• 🌍 Evrensel: Hem ES Modules (import) hem de CommonJS (require) ortamlarında (Node.js, React, Vue, vb.) pürüzsüz çalışır.
• 📐 Matematiksel Doğruluk: Sadece uzunluk kontrolü yapmaz; devlet standartlarındaki Mod10 ve Mod9 sağlamasını algoritma bazında teyit eder.

📦 Kurulum

Projenize dahil etmek çok kolay! Terminalinizi açın ve favori paket yöneticinizi kullanın:

# npm kullanarak
npm install tr-vkn-validator

# yarn kullanarak
yarn add tr-vkn-validator

# pnpm kullanarak
pnpm add tr-vkn-validator

💻 Kullanım

Hangi modül yapısını kullanıyorsanız, ona uygun şekilde projeye dahil edebilirsiniz.

➡️ ES Modules (React, Vue, Modern Node.js vb.)

import { isVKNValid, isTCKNValid } from 'tr-vkn-validator';

// 🏢 VKN Doğrulama (Vergi Kimlik Numarası)
const vknSonuc = isVKNValid('1111111115');
console.log(vknSonuc ? '✅ VKN Geçerli' : '❌ VKN Geçersiz');

// 👤 TCKN Doğrulama (TC Kimlik Numarası)
const tcknSonuc = isTCKNValid('10000000146');
console.log(tcknSonuc ? '✅ TCKN Geçerli' : '❌ TCKN Geçersiz');

➡️ CommonJS (Eski Node.js projeleri)

const { isVKNValid, isTCKNValid } = require('tr-vkn-validator');

if (isVKNValid('1111111115')) {
  console.log('✅ Geçerli bir VKN girdiniz.');
} else {
  console.log('❌ Lütfen geçerli bir Vergi Numarası girin.');
}

🧠 Algoritma Hakkında

Bu paketin arka planındaki doğrulama mantığı, Hazine ve Maliye Bakanlığı ile Nüfus ve Vatandaşlık İşleri Genel Müdürlüğü standartlarında belirtilen algoritmaları baz alır. Sadece 10 veya 11 hane olmasını kontrol etmekle kalmaz, haneler arasındaki matematiksel bağıntının (checksum) doğruluğunu hesaplayarak sahte numaraların geçişini engeller.

📜 Lisans

Bu proje ISC lisansı ile lisanslanmıştır. Tamamen açık kaynaklıdır ve özgürce kullanılabilir. ❤️ Kodlamaya devam!