Atya.Http.Client 1.0.0

Atya.Http.Client

Typed HttpClient helpers that return Atya Result values, understand ProblemDetails failures, and propagate correlation identifiers.

Overview

Atya.Http.Client wraps HttpClient calls in Result and Result<T> so callers handle expected upstream failures without exception control flow. It reads RFC ProblemDetails responses, aligns status-to-error-kind behavior with Atya.Errors.ProblemDetails, and forwards correlation identifiers on outbound requests.

Installation

dotnet add package Atya.Http.Client

Quick Start

using Atya.Http.Client;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();
services.AddAtyaHttpClient(options =>
{
    options.CorrelationIdAccessor = () => "current-correlation-id";
});

using var provider = services.BuildServiceProvider();
var client = provider.GetRequiredService<AtyaHttpClient>();

using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.example.test/customers/42");
var result = await client.SendJsonAsync<CustomerDto>(request);

if (result.IsSuccess)
{
    Console.WriteLine(result.Value.Name);
}
else
{
    Console.WriteLine(result.Error.Code);
}

public sealed record CustomerDto(string Name);

Feature Tour

Command-style calls

Use SendAsync when the response body is not part of the success contract:

using var request = new HttpRequestMessage(HttpMethod.Delete, "https://api.example.test/customers/42");
var result = await client.SendAsync(request);

JSON calls

Use SendJsonAsync<TValue> when a successful response contains JSON:

using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.example.test/customers/42");
var result = await client.SendJsonAsync<CustomerDto>(request);

Correlation

AtyaHttpClientOptions.CorrelationIdAccessor provides the current correlation id. The client forwards it through X-Correlation-ID unless the request already has that header.

Error Codes

When an upstream ProblemDetails payload contains the errorCode extension from Atya.Errors.ProblemDetails, that code is returned instead of atya.http.client.http_failure.

Why This Dependency

Atya.Foundation.Results provides the Result and Error model. Atya.Errors.ProblemDetails owns the ProblemDetails extension names and error-kind mapping options consumed when interpreting upstream HTTP failures. Microsoft.Extensions.Http provides the standard typed-client registration surface.

Links

• Repository: https://github.com/AtyaLibraries/Client
• NuGet: https://www.nuget.org/packages/Atya.Http.Client
• License: https://github.com/AtyaLibraries/Client/blob/development/LICENSE