BonyadCode.Resulter.AspNetCore 1.1.2

In the name of God

BonyadCode.Resulter.AspNetCore

A utility library to standardize API responses in ASP.NET Core. It supports both Controllers and Minimal APIs with consistent handling of success, failure, validation errors, and exceptions, using rich ProblemDetails following RFC7807.

✨ Features

• Unified Result Model: Consistent ResultBuilder<T> and ResultBuilder for all HTTP outcomes.
• Support for Minimal APIs & Controllers: Seamlessly convert to IActionResult or IResult.
• ProblemDetails Integration: Built-in helpers to enrich error responses with metadata.
• Zero Boilerplate: Clean, expressive syntax that reduces repetitive response code.
• Validation: and Error Support: Maps errors from FluentValidation, DataAnnotations, and IdentityResult into structured responses.

📦 Installation

dotnet add package BonyadCode.Resulter.AspNetCore

🚀 Quick Examples

✅ Success (Controller)

[HttpGet("hello")]
public IActionResult GetHello()
{
    var result = ResultBuilder<string>.Success("Hello, world!");
    return result.ToHttpResultController();
}

Response JSON:

{
  "succeeded": true,
  "statusCode": 200,
  "data": "Hello, world!",
  "problemDetails": null
}

✅ Success (Minimal Api)

app.MapGet("/hello", () =>
{
    var result = ResultBuilder<string>.Success("Hello, world!");
    return result.ToHttpResultMinimal();
});

Response JSON:

{
  "succeeded": true,
  "statusCode": 200,
  "data": "Hello, world!",
  "problemDetails": null
}

✅ Custom Success (Controller)

[HttpGet("hello")]
public IActionResult GetHello()
{
    var result = ResultBuilder.Success("User was Created", HttpStatusCode.Created);
    return result.ToHttpResultController();
}

Response JSON:

{
  "succeeded": true,
  "statusCode": 201,
  "data": "User was Created",
  "problemDetails": null
}

✅ Custom Success (Minimal Api)

app.MapGet("/hello", () =>
{
    var result = ResultBuilder.Success("User was Created", HttpStatusCode.Created);
    return result.ToHttpResultMinimal();
});

Response JSON:

{
  "succeeded": true,
  "statusCode": 201,
  "data": "User was Created",
  "problemDetails": null
}

❌ Validation Failure (Controller)

[HttpPost("register")]
public IActionResult RegisterUser(UserDto dto)
{
    var result = ResultBuilder<string>.Failure()
        .AddProblemDetailsFromKeyValuePairs("Email", "Email is required.")
        .AddProblemDetailsFromKeyValuePairs("Password", "Password must be at least 8 characters." );

    return result.ToHttpResultController();
}

or

[HttpPost("register")]
public IActionResult RegisterUser(UserDto dto)
{
    var result = ResultBuilder<string>.Failure()
        .AddProblemDetailsFromKeyValuePairs(["Email","Password"], ["Email is required.","Password must be at least 8 characters." ]);

    return result.ToHttpResultController();
}

Response JSON:

{
  "succeeded": false,
  "statusCode": 400,
  "data": null,
  "problemDetails": {
    "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
    "title": "A problem occurred.",
    "detail": "A problem occurred (400 BadRequest).",
    "status": 400,
    "extensions": {
      "Email": [
        "Email is required."
      ],
      "Password": [
        "Password must be at least 8 characters."
      ]
    }
  }
}

🌐 Minimal API Usage

✅ Success

app.MapGet("/status", () =>
{
    var result = ResultBuilder<string>.Success("All systems operational.", HttpStatusCode.NoContent);
    return result.ToHttpResultMinimal();
});

or

app.MapGet("/status", () =>
{
    var result = ResultBuilder<string>.Success("All systems operational.");
    return result.ToHttpResultMinimal(HttpStatusCode.NoContent);
});

Response JSON:

{
  "succeeded": true,
  "statusCode": 204,
  "data": "All systems operational.",
  "problemDetails": null
}

❌ FluentValidation Errors

app.MapPost("/login", (LoginRequest request, HttpContext? httpContext, IValidator<LoginRequest> validator) =>
{
    var validationResult = validator.Validate(request);

    if(!validationResult.Succeeded)
    {
        var result = ResultBuilder<string>.Failure()
            .AddProblemDetailsFromFluentValidationResult(validationResult);

        return result.ToHttpResultMinimal(HttpStatusCode.Conflict, httpContext);
    }

    return ResultBuilder<string>.Success("Logged in").ToHttpResultMinimal();
});

Response JSON:

{
  "succeeded": false,
  "statusCode": 409,
  "data": null,
  "problemDetails": {
    "type": "https://example.com/problems/validation",
    "title": "A validation problem occurred.",
    "detail": "One or more validation failures occured.",
    "status": 409,
    "instance": "/api/register",
    "extensions": {
      "Username": [
        "Username already exists."
      ]
    }
  }
}

⚙️ Custom ProblemDetails Examples

🛠️ Attach Custom Metadata

var result = ResultBuilder<string>.Failure()
    .AddCustomProblemDetails(
        type: "https://example.com/problems/validation",
        title: "A custom problem occurred.",
        details: "One or more custom failures occured.",
        statusCode: HttpStatusCode.Conflict,
        instance: "/api/register",
        extensions: new Dictionary<string, object?>
        {
            { "Username", new[] { "Username already exists." } }
        }).ToHttpResultMinimal(HttpStatusCode.Conflict, httpContext);

Note: You can pass the httpContext to the above method so that "instance" is extracted automatically from it.

Response JSON:

{
  "succeeded": false,
  "statusCode": 409,
  "data": null,
  "problemDetails": {
    "type": "https://example.com/problems/validation",
    "title": "A custom problem occurred.",
    "detail": "One or more custom failures occured.",
    "status": 409,
    "instance": "/api/register",
    "extensions": {
      "Username": [
        "Username already exists."
      ]
    }
  }
}

🧐 Validation Sources

🔧 DataAnnotations

var validationResult = new ValidationResult("Email", new[] { "Invalid email" });
var result = ResultBuilder.Failure()
    .AddProblemDetailsFromValidationResult(validationResult);

🧪 FluentValidation

var result = ResultBuilder.Failure()
    .AddProblemDetailsFromFluentValidationResult(validationResult);

🔐 IdentityResult

var result = ResultBuilder.Failure()
    .AddProblemDetailsFromIdentityError(identityResult);

🔥 Exception Handling

try
{
    throw new InvalidOperationException("Something broke.");
}
catch (Exception ex)
{
    var result = ResultBuilder.Failure()
        .AddProblemDetailsFromException(ex, httpContext);

    return result.ToHttpResultController();
}

Response JSON (truncated):

{
  "succeeded": false,
  "statusCode": 500,
  "data": null,
  "problemDetails": {
    "type": "https://tools.ietf.org/html/rfc7231#section-6.6.1",
    "title": "A Server problem occurred.",
    "detail": {
      "message": "Something broke."
    },
    "status": 500,
    "instance": "/api/failing-endpoint",
    "extensions": {
      "Message": [
        "Something broke."
      ],
      "Source": [
        "MyApp"
      ]
    }
  }
}

📚 Extension Reference

Endpoint Result Methods:

ProblemDetails Helper Methods:

🧪 API Behavior Matrix

🤝 Contributing

PRs and feedback welcome! GitHub →

📄 License

Apache 2.0 — see the LICENSE file.

📦 Links

• NuGet
• GitHub

Usage Conditions:

• This program must not be used for any military or governmental purposes without the owner's consent.
• This program must not be used for any inhumane purposes.
• This program must not be used for any illegal or haram activities.