VerifyNation is a modern, extensible, and lightweight .NET library for validating Turkish Republic Identity Numbers (TCKN).
✨ Features
🔢 Standard TCKN algorithmic validation
🔍 Length and first digit checks
🚫 Blacklist/✅ Whitelist support
🔗 Pipeline/chain support: stop on first error or collect all errors
🌐 Internationalization (i18n) for error messages (TR/EN)
🧩 Easily add your own custom rules (custom rule API)
⚡ Async validation support
🧰 Easy integration with Dependency Injection
🧪 100% test coverage and real-world scenarios
📦 Installation
dotnet add package VerifyNation
🚀 Basic Usage
using Codergies.VerifyNation;
var validator = new TcknValidator(RuleFactory.CreateTcknRules());
var result = validator.Validate("10000000146");
if (result.IsValid)
Console.WriteLine("TCKN is valid!");
else
Console.WriteLine("TCKN is invalid: " + string.Join(", ", result.ErrorMessages));
🛠️ Advanced Usage
1. 💉 Dependency Injection Integration
using Codergies.VerifyNation.Extensions;
services.AddTcknValidator(); // In Startup.cs or Program.cs
// In your Controller or Service:
public class MyService
{
private readonly IValidator<string> _tcknValidator;
public MyService(IValidator<string> tcknValidator) => _tcknValidator = tcknValidator;
public void ValidateTckn(string tckn)
{
var result = _tcknValidator.Validate(tckn);
// ...
}
}
2. 🔗 Pipeline/Chain Mode
Control whether rules are executed sequentially and stop at the first error, or always collect all errors:
var validator = new TcknValidator(RuleFactory.CreateTcknRules());
validator.PipelineMode = ValidationPipelineMode.StopOnFirstFailure; // Stops at the first error
var result = validator.Validate("12345678901");
if (!result.IsValid)
Console.WriteLine($"First error: {result.Errors[0].Message}");
3. 🚫✅ Blacklist/Whitelist Rules
using Codergies.VerifyNation.Rules;
var blacklist = new[] { "12345678901", "11111111111" };
var validator = new TcknValidator(RuleFactory.CreateTcknRules());
validator.AddRule(new BlacklistValidationRule(blacklist));
var result = validator.Validate("12345678901"); // Returns blacklist error
var whitelist = new[] { "10000000146" };
validator.AddRule(new WhitelistValidationRule(whitelist));
var result2 = validator.Validate("99999999999"); // Returns whitelist error
4. 🌐 Internationalization (i18n) for Error Messages
var resultTr = validator.Validate("123", "tr"); // Error messages in Turkish
var resultEn = validator.Validate("123", "en"); // Error messages in English
5. ⚡ Async Validation
var result = await validator.ValidateAsync("10000000146");
6. 🧩 Add Your Own Custom Rule
public class CustomAlwaysFailRule : IValidationRule<string>
{
public string Name => "CustomAlwaysFail";
public string ErrorMessage => "Always fails.";
public string ErrorCode => "ERR_CUSTOM_FAIL";
public bool Validate(IValidationContext context, string input) => false;
public Task<bool> ValidateAsync(IValidationContext context, string input, CancellationToken cancellationToken = default) => Task.FromResult(false);
public string GetErrorMessage(string culture = null) => ErrorMessage;
}
var validator = new TcknValidator(RuleFactory.CreateTcknRules());
validator.AddRule(new CustomAlwaysFailRule());
var result = validator.Validate("10000000146"); // Returns custom rule error
7. 🏛️ NVI (e-Devlet) TCKN Verification Rule
You can validate a TCKN against the official Turkish government (NVI) service, verifying not only the number but also the person's name, surname, and birth year:
using Codergies.VerifyNation.Rules;
var nviRule = new NviTcknValidationRule("YASIN", "KAYA", 1990);
var validator = new TcknValidator(RuleFactory.CreateTcknRules());
validator.AddRule(nviRule);
var result = await validator.ValidateAsync("10000000146");
if (result.IsValid)
Console.WriteLine("TCKN is valid and verified by NVI!");
else
Console.WriteLine("TCKN is invalid or not verified by NVI.");
⚠️ Note:
This rule requires the user's name, surname, and birth year.
The NVI service may have IP restrictions and is intended for official use.
Always handle exceptions and sensitive data with care.
