ConfigHub.Client 0.1.0-beta.1

ConfigHub.Client

Official .NET client SDK for ConfigHub — enterprise configuration management with real-time updates.

Multi-targeted: net8.0 / net9.0 / net10.0.

Features

• Configuration provider — plug ConfigHub directly into IConfiguration with live reload (IConfiguration, IOptions<T>, IOptionsMonitor<T>)
• ETag-based caching — automatic If-None-Match handling, server responds 304 Not Modified
• Polling refresh — background service that reloads configuration on an interval
• SignalR real-time updates — push notifications (MessagePack) trigger instant refresh
• Resilience — built-in retry, circuit breaker, and timeout policies
• Strongly-typed exceptions — ConfigHubNotFoundException, ConfigHubUnauthorizedException, ConfigHubRateLimitException, ConfigHubConnectionException

Installation

dotnet add package ConfigHub.Client

Quick start

Option 1 — Configuration provider (recommended)

ConfigHub values become part of IConfiguration and refresh automatically:

var builder = WebApplication.CreateBuilder(args);

builder.Configuration.AddConfigHub(options =>
{
    options.Endpoint = "https://confighub.example.com";
    options.ApiKey = "<your-api-key>";
    options.AppId = "my-app";
    options.Environment = "production";
    options.EnablePollingRefresh = true;          // optional
    options.PollingInterval = TimeSpan.FromMinutes(1);
    options.EnableSignalR = true;                 // optional, real-time push
});

builder.Services.AddConfigHubRefresh(builder.Configuration);

var app = builder.Build();

// Read values like any other configuration source
var maxRetries = app.Configuration["MaxRetries"];

Option 2 — appsettings.json

{
  "ConfigHub": {
    "Endpoint": "https://confighub.example.com",
    "ApiKey": "<your-api-key>",
    "AppId": "my-app",
    "Environment": "production",
    "Version": "1.0",
    "Profile": "default",
    "EnablePollingRefresh": true,
    "PollingInterval": "00:01:00",
    "EnableSignalR": false
  }
}

builder.Configuration.AddConfigHub(builder.Configuration);
builder.Services.AddConfigHubRefresh(builder.Configuration);

Options

Error handling

License

Licensed under the GNU Affero General Public License v3.0 — see LICENSE in the repository.