Viaduct.Client 0.1.1

Viaduct.Client

Define your service interface once. Viaduct wires it to an ASP.NET Core server and a typed HTTP client — automatically, at compile time, with no duplication.

Viaduct.Client is the client-side package. It reads your interface at compile time and generates a typed HttpClient proxy — you inject the interface and call methods as if they were local. The server project uses the same interface to generate matching endpoints, so both sides stay in sync automatically.

The single-source-of-truth model

┌─────────────────────────────────────────┐
│  Shared project (IUserService)          │
│  Define once. Change once. Done.        │
└────────────┬────────────────────────────┘
             │
             ▼
  ┌──────────────────────┐
  │  Your client project  │  ← references Viaduct.Client
  │  (this package)       │
  │                       │
  │  CreateAndAddHttpClient│  → GET https://api/.../GetUserAsync/{id}
  │  <IUserService>()     │     POST https://api/.../CreateUserAsync/...
  └──────────────────────┘

Quick start

// Program.cs (client app)
builder.Services.CreateAndAddHttpClient<IUserService>(options =>
{
    options.BaseUrl = "https://api.example.com";
});

// Inject and use anywhere — looks like a local call
public class Dashboard(IUserService users)
{
    public async Task<User> Load(int id) => await users.GetUserAsync(id);
}

Configuration

builder.Services.CreateAndAddHttpClient<IUserService>(options =>
{
    options.BaseUrl = "https://api.example.com";
    options.BasePath = "/api/v1";
    options.UseInterfaceNameForPath = true;
})
.ConfigurePrimaryHttpMessageHandler(() => new HttpClientHandler());

Parameter binding

• Simple types (int, string, bool, DateTime, Guid, etc.) → route or query parameters
• Complex types (classes, records) → JSON request body
• CancellationToken → forwarded to the HTTP call, never serialized

Error handling

Any non-2xx response throws a ViaductException wrapping the underlying HttpRequestException.

Which package do I need?

Requirements

• .NET 8, 9, or 10
• C# 14+ (uses [InterceptsLocation] for compile-time interception)

Full documentation and examples →