A comprehensive utility library for validations, name formatting, and secure password generation in .NET applications. Features include Turkish ID validation, minimum age validation, file extension validation, Turkish-aware name formatting, and cryptographically secure password generation.
SpectraUtils is a comprehensive, production-ready utility library for .NET 9 applications, providing robust validation, name formatting, secure password generation, and security services. Designed with performance and security as core priorities, it supports Turkish-specific features and integrates seamlessly with ASP.NET Core dependency injection.
?? Features
?? Security Services
PBKDF2 Password Hashing: Industry-standard password hashing with configurable iterations, salt size, and key size
Secure Token Generation: Cryptographically secure Base64Url tokens for authentication and security tokens
One-Time Code Generator: Random numeric OTP generation for 2FA and verification flows
Password Helper: Flexible password creation with configurable character requirements
? Validation Attributes
MinimumAgeAttribute: Validates minimum age requirements (DateTime & DateOnly support)
TCIDValidationAttribute: Turkish National ID validation with checksum verification
TurkishTaxNumberValidationAttribute: Turkish Tax Identification Number (VKN) validation
IbanValidationAttribute: International Bank Account Number validation
AllowedExtensionsAttribute: File extension and size validation
?? String & Name Processing
NameEdit Service: Turkish-aware name correction and formatting
Service Collection Extensions: Easy DI integration
?? Installation
NuGet Package Manager
Install-Package SpectraUtils
.NET CLI
dotnet add package SpectraUtils
?? Quick Start
Dependency Injection Setup
using SpectraUtils.Extensions;
var builder = WebApplication.CreateBuilder(args);
// Add SpectraUtils services
builder.Services.AddSpectraUtils();
var app = builder.Build();
using SpectraUtils.Attributes.ValidationAttributes;
public class UserRegistration
{
[MinimumAge(18)]
public DateTime BirthDate { get; set; }
[MinimumAge(21)]
public DateOnly BirthDateOnly { get; set; }
}
Turkish National ID Validation
public class Citizen
{
[TCIDValidation]
public string TcId { get; set; } // Example: "10000000146"
}
Turkish Tax Number Validation
public class Company
{
[TurkishTaxNumberValidation]
public string TaxId { get; set; } // 10-digit VKN
}
IBAN Validation
public class BankAccount
{
[IbanValidation]
public string IBAN { get; set; }
[IbanValidation(expectedCountryCode: "TR")]
public string TurkishIBAN { get; set; }
}
File Extension and Size Validation
public class DocumentUpload
{
// Max 1MB, jpg and png only
[AllowedExtensions(1024 * 1024, ".jpg", ".png")]
public IFormFile? Avatar { get; set; }
// For file paths
[AllowedExtensions(1024 * 1024, ".pdf", ".doc", ".docx")]
public string? DocumentPath { get; set; }
}
?? Programmatic Validators
IBAN Validation
using SpectraUtils.Validation;
// Basic validation
bool isValid = IbanValidator.IsValid("TR33 0006 1000 0006 1001 2034 01");
// With country code
bool isTurkish = IbanValidator.IsValid(iban, expectedCountryCode: "TR");
Turkish Tax Number Validation
using SpectraUtils.Validation;
bool isValidTaxId = TurkishTaxNumberValidator.IsValid("1234567890");
?? Advanced Configuration
Custom PBKDF2 Settings
builder.Services.AddSingleton<IPasswordHasher>(
new Pbkdf2PasswordHasher(
iterations: 310_000, // OWASP 2024
saltSize: 32, // 256-bit salt
keySize: 64 // 512-bit output
)
);
// ? CORRECT: Hash before storing
string passwordHash = passwordHasher.Hash(userInput);
await database.SaveAsync(user => user.PasswordHash = passwordHash);
// ? WRONG: Never store plain passwords
user.Password = userInput;
Token Generation
// ? Use SpectraUtils for secure tokens
string resetToken = tokenGenerator.GenerateToken(byteLength: 64);
// ? WRONG: Weak random sources
var random = new Random();
string badToken = random.Next().ToString();
Contributions are welcome! Please feel free to submit a Pull Request.
To contribute:
Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request
?? License
MIT License - See LICENSE file for details.
MIT License
Copyright (c) 2024 O�uzhan KARAGUZEL
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
