RepletoryLib.Http.Client 1.0.0

RepletoryLib.Http.Client

Typed HTTP client with Polly resilience policies (retry, circuit breaker, timeout).

Part of the RepletoryLib ecosystem -- standalone, reusable .NET 10 libraries with zero business logic.

Overview

RepletoryLib.Http.Client provides a typed HTTP client service with built-in Polly resilience policies. Every outgoing request is automatically protected by retry with exponential backoff, a circuit breaker, and a timeout policy. Responses are wrapped in Result<T> for consistent error handling.

Key Features

• IHttpClientService -- Typed GET, POST, PUT, PATCH, DELETE returning Result<T>
• Retry policy -- Exponential backoff with configurable retry count
• Circuit breaker -- Opens after consecutive failures to prevent cascade
• Timeout -- Per-request timeout protection
• Correlation ID forwarding -- Automatically propagates X-Correlation-ID to downstream services

Installation

dotnet add package RepletoryLib.Http.Client

Dependencies

Quick Start

using RepletoryLib.Http.Client;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddRepletoryHttpClient<IPaymentGateway>(builder.Configuration);

{
  "HttpClient": {
    "BaseUrl": "https://api.payment-gateway.com",
    "TimeoutSeconds": 30,
    "RetryCount": 3,
    "CircuitBreakerThreshold": 5,
    "CircuitBreakerDurationSeconds": 30
  }
}

Configuration

HttpClientOptions

Usage Examples

Making HTTP Requests

using RepletoryLib.Http.Client.Interfaces;

public class PaymentService
{
    private readonly IHttpClientService _http;

    public PaymentService(IHttpClientService http) => _http = http;

    public async Task<PaymentResult?> ProcessPaymentAsync(PaymentRequest request)
    {
        var result = await _http.PostAsync<PaymentResult>("/v1/payments", request);

        if (result.IsSuccess)
            return result.Data;

        _logger.LogError("Payment failed: {Error} (Status: {Code})", result.Error, result.StatusCode);
        return null;
    }

    public async Task<Order?> GetOrderAsync(string orderId)
    {
        var result = await _http.GetAsync<Order>($"/v1/orders/{orderId}");
        return result.IsSuccess ? result.Data : null;
    }
}

Resilience Behavior

Request 1: POST /v1/payments → 503 (server error)
  ↳ Retry 1 (after 1s): → 503
  ↳ Retry 2 (after 2s): → 503
  ↳ Retry 3 (after 4s): → 200 OK ✓

After 5 consecutive failures:
  ↳ Circuit breaker OPENS for 30 seconds
  ↳ All requests fail-fast without calling the server
  ↳ After 30s, circuit enters half-open state
  ↳ Next request tests if server has recovered

API Reference

IHttpClientService

All methods return Result<T> -- check IsSuccess before accessing Data.

Integration with Other RepletoryLib Packages

Troubleshooting

License

This project is licensed under the MIT License.

Copyright (c) 2024-2026 Repletory.

For complete documentation, infrastructure setup, and configuration reference, see the RepletoryLib main repository.