Kopticx.Validify 1.0.0

Kopticx.Validify

Validify is a lightweight validation filter for ASP.NET Core Minimal APIs that uses FluentValidation under the hood. It allows you to inject model validation seamlessly into your API pipeline using a simple and expressive syntax.

✨ Features

• ✅ Declarative model validation for Minimal APIs
• 🔄 Integrates with FluentValidation validators
• 🧩 Plug-and-play with Microsoft.Extensions.DependencyInjection
• 🛡️ Prevents invalid requests from reaching your handlers
• 📦 Available as a NuGet package
• ⚙️ Compatible with Native AOT

🚀 Installation

Install from NuGet:

dotnet add package Validify

⚙️ How it works

Validify registers a filter that intercepts requests before they hit your endpoint. If the request model is invalid, a 400 Bad Request is returned with validation details.

Example usage:

companiesApi.MapPost("/", PostUser)
    .WithValidation<PostUserModel>();

🛠️ Setup

1. Register the service

builder.Services.AddValidify();

2. Create a FluentValidator

public class PostUserModelValidator : AbstractValidator<PostUserModel>
{
    public PostUserModelValidator()
    {
        RuleFor(x => x.Username)
            .NotEmpty().WithMessage("Username is required")
            .MaximumLength(255).WithMessage("Must be less than 255 characters");

        // More rules...
    }
}

3. Register your FluentValidator's validators

services
    .AddSingleton<IValidator<PostUserModel>, PostUserModelValidator>()
    .AddSingleton<IValidator<PutUserModel>, PutUserModelValidator>();

🔐 Native AOT Support

Validify is fully compatible with Native AOT for optimized, self-contained executables:

<IsAotCompatible>true</IsAotCompatible>

🧩 Register validation response types for source generation

To support HttpValidationProblemDetails responses in AOT scenarios, include it in your JsonSerializerContext:

[JsonSerializable(typeof(HttpValidationProblemDetails))]
public partial class AppJsonSerializerContext : JsonSerializerContext;

This ensures that validation error responses can be properly serialized when using source-generated System.Text.Json.

📂 Project Structure

• ValidifyRegistration.cs: Registers all necessary services
• ValidationEndpointExtensions.cs: Adds .WithValidation<T>() to RouteHandlerBuilder
• ValidationFilter.cs: The filter that runs before your endpoint logic

📦 NuGet Package

📦 nuget.org/packages/Kopticx.Validify

🧪 Why use Validify?

• Prevent invalid models from hitting your business logic
• Use FluentValidation's full feature set
• Centralize validation behavior with clean syntax
• Built for performance and developer experience

📝 License

📄 Third-party licenses

Validify uses FluentValidation, licensed under the Apache 2.0 License.

See NOTICE file for more information.