MonadicSharp.Http 1.0.0

MonadicSharp.Http

Result-aware HTTP client for .NET 8 — HTTP errors, timeouts, and deserialization failures are typed Result<T> values, never unhandled exceptions.

Overview

MonadicSharp.Http replaces the fragile try/catch pattern around HttpClient with Railway-Oriented error handling:

• IHttpResultClient — typed interface for GET, POST, PUT, PATCH, DELETE
• HttpResultClient — default implementation backed by HttpClient
• RetryPolicy — typed retry with exponential backoff, composable with CircuitBreaker
• HttpResultResponse<T> — wraps result + status code + response headers
• HttpError — typed error factory for every HTTP failure scenario

Installation

dotnet add package MonadicSharp.Http

Basic Usage

// GET
Result<WeatherForecast> forecast =
    await httpClient.GetAsync<WeatherForecast>("/api/weather");

// POST
Result<OrderResponse> order =
    await httpClient.PostAsync<OrderRequest, OrderResponse>("/api/orders", orderRequest);

// Railway chain
var result = await httpClient
    .GetAsync<UserProfile>($"/api/users/{userId}")
    .BindAsync(profile => enrichmentAgent.ExecuteAsync(profile, context));

HttpResultResponse — Access Status & Headers

HttpResultResponse<Page> response =
    await httpClient.SendAsync<Page>(new HttpRequestMessage(HttpMethod.Get, "/api/page"));

Console.WriteLine(response.StatusCode);  // HttpStatusCode.OK
Console.WriteLine(response.Result.IsSuccess);
if (response.Headers.TryGetValue("X-Rate-Limit-Remaining", out var remaining))
    Console.WriteLine(remaining);

RetryPolicy

var retry = new RetryPolicy(
    maxAttempts: 3,
    initialDelay: TimeSpan.FromMilliseconds(200),
    backoffMultiplier: 2.0,
    retryOn: error => error.Code is "HTTP_429" or "HTTP_503");

var result = await retry.ExecuteAsync(
    ct => httpClient.GetAsync<Data>("/api/data", ct));

// On exhaustion: HttpError.RetryExhausted (contains lastError + attempt count)

Integration with CircuitBreaker

var breaker = new CircuitBreaker("ExternalApi", failureThreshold: 5);

var result = await retry.ExecuteAsync(
    ct => breaker.ExecuteAsync(
        innerCt => httpClient.GetAsync<Data>("/api/data", innerCt), ct));

Error Codes

DI Registration

// Registers IHttpResultClient + named HttpClient
services.AddMonadicSharpHttp("MyClient", client =>
{
    client.BaseAddress = new Uri("https://api.example.com");
    client.Timeout = TimeSpan.FromSeconds(30);
});

License

MIT — part of MonadicSharp.Framework.