Nestgrid.Response.Extensions.Validation 0.8.0

Nestgrid.Response.Extensions.Validation

Data annotations validation extensions for Nestgrid.Response.

Nestgrid.Response.Extensions.Validation converts System.ComponentModel.DataAnnotations.ValidationResult values into Nestgrid result messages and invalid results.

Installation

dotnet add package Nestgrid.Response.Extensions.Validation

Quick Start

using System.ComponentModel.DataAnnotations;
using Nestgrid.Response;
using Nestgrid.Response.Extensions.Validation;

var validationResults = new List<ValidationResult>();

Validator.TryValidateObject(
    request,
    new ValidationContext(request),
    validationResults,
    validateAllProperties: true);

Result result = validationResults.ToInvalidResult();

Realistic Example

using System.ComponentModel.DataAnnotations;
using Nestgrid.Response;
using Nestgrid.Response.Extensions.Validation;

public Result<UserDto> Create(CreateUserRequest request)
{
    var validationResults = new List<ValidationResult>();

    if (!Validator.TryValidateObject(
        request,
        new ValidationContext(request),
        validationResults,
        validateAllProperties: true))
    {
        return validationResults.ToInvalidResult<UserDto>();
    }

    var user = new UserDto(1, request.Name, request.Email);

    return Results.Created(user);
}

Feature Summary

• Converts one ValidationResult to one ResultMessage.
• Converts many validation results to result messages.
• Creates non-generic and generic invalid results.
• Allows caller-selected message severity.
• Preserves validation message text exactly as supplied.
• Does not introduce a custom validation abstraction.
• Provides opt-in member-aware conversion through ToMessagesWithProperties() and ToInvalidResultWithProperties<T>().

Behavior

• Validation messages are preserved exactly as supplied.
• Member names are not prepended to messages.
• Message codes are not inferred.
• Message properties are not inferred.
• Default severity is Warning.
• ToInvalidResult() always returns ResultStatus.Invalid.

Member-aware conversion is opt-in and preserves member names as ResultMessage.Property values. Blank member names are ignored; a validation result without a usable member produces one memberless message. The default code is validation_failed, the default message for a missing error message is The entity is invalid., and the default severity remains Warning.

Validation messages, property names and custom codes are consumer-controlled output. Review them before returning them to untrusted clients or writing them to logs; the package does not decide whether a particular domain validation message is safe to disclose.

var result = validationResults.ToInvalidResultWithProperties<UserDto>();

Override severity when needed:

var result = validationResults.ToInvalidResult(ResultMessageSeverity.Error);

Documentation

• Main repository
• Core package
• Architecture overview

Samples

• Validation sample
• Core sample