Angular / TypeScript TCKN & VKN Doğrulama Kütüphanesi

@tcknvkn/angular, Angular projelerinde TCKN (TC Kimlik No) ve VKN (Vergi Kimlik No) doğrulama işlemleri için hazırlanmış hafif bir validator kütüphanesidir.

Bu paket yalnızca algoritmik/format doğrulaması yapar. Nüfus veya vergi servislerinden kimlik sahibine ait gerçek doğrulama yapmaz.

Kurulum

npm install @tcknvkn/angular

Neden Bu Kütüphane?

• Angular Reactive Forms ve template-driven forms desteği
• TCKN validator ve VKN validator fonksiyonları
• Ham değer doğrulama (validateTckn, validateVkn)
• Toplu doğrulama (validateMultipleTckn, validateMultipleVkn)
• TypeScript ile güçlü tip desteği
• Sunucu çağrısı olmadan hızlı istemci tarafı doğrulama

Hızlı Kullanım

Reactive Forms

import { FormControl, Validators } from "@angular/forms";
import { tcknValidator, vknValidator } from "@tcknvkn/angular";

const tcknControl = new FormControl("", {
  validators: [Validators.required, tcknValidator({ allowEmpty: false })]
});

const vknControl = new FormControl("", {
  validators: [vknValidator()]
});

Template-Driven Forms

import { Component } from "@angular/core";
import { FormsModule } from "@angular/forms";
import { TcknValidatorDirective, VknValidatorDirective } from "@tcknvkn/angular";

@Component({
  standalone: true,
  selector: "app-root",
  imports: [FormsModule, TcknValidatorDirective, VknValidatorDirective],
  template: `
    <input name="tckn" ngModel tcknValidator />
    <input name="vkn" ngModel vknValidator />
  `
})
export class AppComponent {}

API Referansı

validateTckn(input: string): ValidationResult

Verilen değeri normalize ederek (yalnızca rakamları alır) TCKN algoritmasına göre doğrular.

validateVkn(input: string): ValidationResult

Verilen değeri normalize ederek VKN algoritmasına göre doğrular.

validateMultipleTckn(inputs: string[]): ValidationResult[]

Birden fazla TCKN değerini tek çağrıda doğrular.

validateMultipleVkn(inputs: string[]): ValidationResult[]

Birden fazla VKN değerini tek çağrıda doğrular.

validateTcknValue(value: string, options?: ValidatorOptions): ValidationErrors | null

Angular form hata formatında TCKN sonucu döndürür.

validateVknValue(value: string, options?: ValidatorOptions): ValidationErrors | null

Angular form hata formatında VKN sonucu döndürür.

tcknValidator(options?: ValidatorOptions): ValidatorFn

Reactive Forms için TCKN validator üretir.

vknValidator(options?: ValidatorOptions): ValidatorFn

Reactive Forms için VKN validator üretir.

TcknValidatorDirective / VknValidatorDirective

Template-driven form kullanımında doğrudan HTML üzerinde doğrulama sağlar.

Hata Formatı

TCKN için:

{
  tckn: {
    errors: string[];
    value: string;
  }
}

VKN için:

{
  vkn: {
    errors: string[];
    value: string;
  }
}

Test ve Build

npm ci
npm test
npm run build

İlgili Bağlantılar

• Kütüphaneler: https://www.tcknvkn.com/kutuphaneler
• Angular kütüphane sayfası: https://www.tcknvkn.com/kutuphaneler/angular
• TC üret: https://www.tcknvkn.com/tc-uret
• TC no üret: https://www.tcknvkn.com/tc-no-uret
• TC üretici: https://www.tcknvkn.com/tc-uretici
• TCKN üret: https://tcknvkn.com/tckn-uret
• Vergi no üret: https://www.tcknvkn.com/vergi-no-uret
• Vergi no üretici: https://www.tcknvkn.com/vergi-no-uretici
• VKN üret: https://tcknvkn.com/vkn-uret

Lisans

MIT