ErrorLib.Core 1.0.1

ErrorLib.Core

🔧 Portable, extensible, and fluent error/result handling for modern .NET applications.

ErrorLib is a clean, developer-friendly result and exception handling library for .NET and ASP.NET Core. It provides a structured Result<T> pattern, centralized exception mapping, logging abstraction, and out-of-the-box middleware integration for Web APIs.

✨ Features

• ✅ Strongly typed Result, DataResult<T>, SuccessResult, ErrorResult, ErrorDataResult<T>
• 🔄 Fluent chaining: .WithStatusCode(), .WithErrorCode(), .WithValidationErrors()
• 🔗 Conditional logic: .IfSuccess(), .IfError(), .IfStatusCode() etc.
• 🧠 IExceptionMapper to map exceptions to messages, codes, HTTP statuses
• 🔌 Logging abstraction via ILogger, compatible with built-in or custom loggers
• 🚫 TryCatchWrapper.Try() and TryAsync() for safe execution
• 🌐 ASP.NET Core middleware support via ErrorLib.AspNetCore

🚀 Basic Usage ✅ TryCatchWrapper (Sync)

var result = TryCatchWrapper.Try(() ⇒ { // your business logic return new UserDto(); });

if (!result.IsSuccess) Console.WriteLine(result.Message); ✅ TryCatchWrapper (Async)

var result = await TryCatchWrapper.TryAsync(async () ⇒ { return await _userService.GetUserAsync(1); });

if (!result.IsSuccess) logger.LogError(result.Message); ✅ ResultFactory

return ResultFactory.Success("Operation completed"); return ResultFactory.Success(userDto); return ResultFactory.Error("User not found", 404, "USER_NOT_FOUND"); ✅ Validation Error Example

return ResultFactory.ValidationError<UserDto>( new List<string> { "Name is required", "Email must be valid" } ); ✅ Fluent Result Extensions

return new ErrorResult("Invalid input") .WithStatusCode<ErrorResult>(400) .WithErrorCode<ErrorResult>("VALIDATION") .WithTraceId<ErrorResult>("abc-123");

result .IfError(() ⇒ logger.LogError("❌ Error occurred")) .IfSuccess(() ⇒ logger.LogInfo("✅ All good")) .IfStatusCode(404, () ⇒ logger.LogWarning("🔍 Not Found")); ⚙️ Exception Mapping Customize exception handling globally:

public class MyExceptionMapper : IExceptionMapper { public int MapStatusCode(Exception ex) ⇒ ex switch { NotFoundException ⇒ 404, BusinessException ⇒ 409, ValidationException ⇒ 400, _ ⇒ 500 };

public string MapMessage(Exception ex) =>
    ex.Message;

public string MapErrorCode(Exception ex) =>
    "GENERIC_ERROR";

} Register in DI:

services.AddSingleton<IExceptionMapper, MyExceptionMapper>(); 🔌 Logging Abstraction ConsoleLogger

ILogger logger = new ConsoleLogger(); logger.LogError("Something went wrong", ex); MicrosoftLoggerAdapter csharp Kopyala Düzenle var adapter = new MicrosoftLoggerAdapter( app.Services.GetRequiredService<Microsoft.Extensions.Logging.ILogger>() ); 🌐 ASP.NET Core Middleware (ErrorLib.AspNetCore) Enable global exception handling in Program.cs:

app.UseCustomExceptionHandler(); Register services:

builder.Services.AddSingleton<ILogger, ConsoleLogger>(); // or MicrosoftLoggerAdapter builder.Services.AddSingleton<IExceptionMapper, DefaultExceptionMapper>(); Automatically catches all unhandled exceptions in HTTP pipeline and returns standard JSON error responses.

🧪 Supported Platforms ✅ .NET 6 / .NET 7 / .NET 8

✅ ASP.NET Core Web API

✅ Console apps, Workers, Background jobs

📦 Installation

ErrorLib.Core

dotnet add package ErrorLib.Core
dotnet add package ErrorLib.AspNetCore