Quonfig.OpenFeature.ServerProvider

OpenFeature provider for Quonfig — wraps the Quonfig.Sdk .NET SDK.

Installation

dotnet add package Quonfig.OpenFeature.ServerProvider
dotnet add package OpenFeature

Usage

using OpenFeature;
using OpenFeature.Model;
using Quonfig.OpenFeature.ServerProvider;

var provider = new QuonfigProvider(new QuonfigProviderOptions
{
    SdkKey = "qf_sk_production_...",
    TargetingKeyMapping = "user.id", // default
});

// Register and wait for initialization
await Api.Instance.SetProviderAsync(provider);

var client = Api.Instance.GetClient();

// Boolean flag
bool enabled = await client.GetBooleanValueAsync("my-flag", false);

// String flag with context
var ctx = EvaluationContext.Builder()
    .SetTargetingKey("user-123")
    .Set("user.email", new Value("alice@co.com"))
    .Set("org.tier", new Value("enterprise"))
    .Build();
string plan = await client.GetStringValueAsync("billing.plan", "free", ctx);

Context mapping

OpenFeature uses a flat key-value evaluation context. Quonfig uses a nested namespace model. The provider maps between them using dot-notation (split on the first dot only):

OpenFeature key	Quonfig namespace	Quonfig property
"user.email"	"user"	"email"
"org.tier"	"org"	"tier"
"country" (no dot)	"" (default)	"country"
"user.ip.address"	"user"	"ip.address" (first dot)
targetingKey	"user"	"id" (via TargetingKeyMapping)

To use a different targeting key property:

var provider = new QuonfigProvider(new QuonfigProviderOptions
{
    SdkKey = "qf_sk_...",
    TargetingKeyMapping = "org.id", // targetingKey -> org namespace, id property
});

Local / offline mode

Use Datadir instead of SdkKey to load config from a local workspace directory:

var provider = new QuonfigProvider(new QuonfigProviderOptions
{
    Datadir = "/path/to/workspace",
    Environment = "Production",
});

Reason and error mapping

The provider forwards Quonfig's evaluation Reason, Variant, ErrorCode, and flag metadata onto OpenFeature's ResolutionDetails. The reason mapping is 1:1:

Quonfig reason	OpenFeature reason
Static	STATIC
TargetingMatch	TARGETING_MATCH
Split	SPLIT
Default	DEFAULT
(anything else)	UNKNOWN

Errors never throw — they return the caller's default with an ErrorType set: FlagNotFound → FLAG_NOT_FOUND, TypeMismatch → TYPE_MISMATCH, General → GENERAL. A missing flag surfaces with reason DEFAULT (matching the other Quonfig OpenFeature providers).

Note: a flag whose only rule is an unconditional match (ALWAYS_TRUE) resolves with reason STATIC (the canonical reason semantics Quonfig.Sdk adopted in 0.0.2, consistent with the other Quonfig SDKs). The provider passes the SDK's reason through verbatim.

Provider events

The provider emits:

• PROVIDER_READY after a successful InitializeAsync
• PROVIDER_ERROR if initialization fails
• PROVIDER_CONFIGURATION_CHANGED on every post-ready config refresh (SSE, fallback poll, or datadir watcher)

PROVIDER_STALE is deferred to a follow-up release.

Native SDK escape hatch

For features not covered by OpenFeature (parsed TimeSpan durations, long / bytes values, log levels, raw key access), reach the underlying client:

var native = provider.GetClient();
TimeSpan? ttl = native?.GetDuration("cache.ttl");

Type mapping

Quonfig type	OpenFeature method	Notes
bool	GetBooleanValueAsync	Direct
string	GetStringValueAsync	Direct
int	GetIntegerValueAsync	Returns int
double	GetDoubleValueAsync	Returns double
string_list	GetObjectValueAsync	Returns a Value list
json	GetObjectValueAsync	Returns a parsed Value
long	N/A	Use the native client
duration	GetStringValueAsync	ISO 8601 string ("PT1M30S")
log_level	N/A	Native SDK only

GetObjectValueAsync resolves string_list first, then falls back to a parsed json value.