Flare.OpenFeature.Provider 10.2.2

Flare.OpenFeature.Provider

OpenFeature provider for Flare feature flag management system. Supports in-memory caching with background polling, provider lifecycle events, and automatic context conversion.

Installation

dotnet add package Flare.OpenFeature.Provider

Quick Start

services.AddOpenFeature(builder =>
{
 builder.AddFlareProvider(new FlareApiClientOptions
 {
 BaseUrl = "https://flare.example.com",
 ApiKey = "your-api-key",
 Scope = "production"
 });
});

With IConfiguration binding

{
 "Flare": {
 "BaseUrl": "https://flare.example.com",
 "ApiKey": "your-api-key",
 "Scope": "production"
 }
}

services.AddOpenFeature(builder =>
{
 builder.AddFlareProvider(configuration);
});

With custom caching options

services.AddOpenFeature(builder =>
{
 builder.AddFlareProvider(
 new FlareApiClientOptions
 {
 BaseUrl = "https://flare.example.com",
 ApiKey = "your-api-key",
 Scope = "production"
 },
 new FlareProviderOptions
 {
 PollingInterval = TimeSpan.FromSeconds(15),
 StaleThreshold = 5,
 CachingEnabled = true
 });
});

Evaluating Flags

public class MyService
{
 private readonly IFeatureClient _client;

 public MyService(IFeatureClient client) => _client = client;

 public async Task DoWork()
 {
 // boolean flag
 var isEnabled = await _client.GetBooleanValueAsync("my-flag", false);

 // string flag
 var theme = await _client.GetStringValueAsync("ui-theme", "default");

 // number flags
 var timeout = await _client.GetIntegerValueAsync("request-timeout", 30);
 var rate = await _client.GetDoubleValueAsync("sample-rate", 0.1);

 // json flag — returns OpenFeature Value (supports nested objects/arrays)
 var config = await _client.GetObjectValueAsync("feature-config", new Value());
 }
}

Features

Caching and Background Polling

When caching is enabled (default), the provider:

1. Fetches all flags on initialization and populates an in-memory cache
2. Resolves flags from cache for near-instant evaluations
3. Polls the Flare API in the background to keep the cache fresh
4. Emits OpenFeature events on flag changes, errors, and staleness

Cache reads are lock-free using volatile reference swap for minimal overhead on the hot path.

Provider Events

The provider emits standard OpenFeature events:

Direct Evaluation Fallback

When caching is disabled, flags are evaluated directly against the Flare API per request. Errors are surfaced as OpenFeature FeatureProviderException subtypes (GeneralException, ProviderNotReadyException, ParseErrorException, etc.), which the SDK handles automatically.

Configuration Options

FlareApiClientOptions

FlareProviderOptions

Supported Value Types

All Flare flag types are supported:

Requesting a flag with an incompatible type (e.g., calling GetBooleanValueAsync on a json flag) throws TypeMismatchException.

License

MIT License - see for details.