CHANGELOG.md carries the
same releases in full detail.
v0.21.1 - 2026-11-19
- SSE restart after
423 service_locked: resets the internal stream cancellation state when the stream exits on423, allowing a subsequentConnectStream()call to reconnect after the lockdown is lifted.
v0.21.0 (2026-11-19)
- HTTP 423
service_locked: addsNexusServiceLockedExceptionandFallbackReason.ServiceLocked; stops SSE reconnects immediately and halts background sync retries until an explicit sync succeeds. - OpenFeature provider: suppresses repeated
evaluate-abrequests while the service is locked down, serving the cached snapshot asSTALE. - Target framework (
net10.0): dropsnet8.0(end of support on 2026-11-10); all six packages now targetnet10.0(LTS). - Path hardening: validates fully-qualified canonical paths in
DevCredentialsFileandSecretDirectoryCleanup.
v0.20.2 - 2026-11-12
- The OpenFeature provider stops asking a switched-off environment. While the environment is switched off in the console, a targeted evaluation serves the snapshot as
STALEand the provider sends noEvaluateABAsyncrequest - for any user - for theAddonSuppressionwindow, with one warning; any success clears it.
v0.20.1 - 2026-11-11
- A successful stream connection starts the failure count and the backoff over. Drops hours apart no longer add up to a fallback, and the reconnect delay no longer climbs to 30 s for the life of the process.
- The first retry after the cooldown waits 1 s.
v0.20.0 - 2026-11-11
- A switched-off environment has its own exception.
NexusEnvironmentDisabledException(aNexusApiException, HTTP 403environment_disabled) is raised by every call, the WIF token exchange included. The cache keeps serving; the background refresh retries every five minutes and the stream falls back to polling (FallbackReason.EnvironmentDisabled) until the environment is switched on. See Error handling. NexusApiExceptioncarriesStatusCodeandErrorCode, the HTTP status and the server’serrorcode, so an unmapped failure such as410 tenant_deletedcan be told apart without parsing the message.- Resources the server leaves out of a sync reach the application:
client.SyncErrorslists them, and each is logged as aWarningwhen it first appears (NexusConfig.LogSyncErrors,NexusOptions.LogSyncErrors). See API reference. - A startup summary names the configs, secrets and flags the first sync delivered, never a value. Without a
LoggerFactory,WESTYX_NEXUS_LOG_STARTUP=1writes it to standard error. See Logging. - Syncs apply one at a time, so a slow response can never replace a newer one.
- CI runs the
net10.0build on .NET 11. .NET 8 stays a target. See Installation.
v0.19.0 - 2026-10-21
WestyxNexus.OpenFeaturetargets the OpenFeature .NET SDK 2.x (OpenFeature2.0 or later, below 3.0), so it installs next to the current OpenFeature release. A cancelled evaluation stops waiting for a targeted lookup. See OpenFeature.IsStreamConnectedreports the connection itself. It istruefrom the moment the stream returns200 OKuntil that connection ends, andfalseduring every backoff, fallback, rate-limit or quarantine wait - a health check can read it directly. See API reference.- While the stream is down, the client syncs once per TTL on its own, so values read through
IConfiguration,IOptionsMonitor<T>or bound secrets keep refreshing until the stream reconnects. WithenableStream: false(orEnableStream = false) the client syncs once per TTL the same way. See SSE live updates. - Every
IStreamObserverhook has an empty default, so an observer implements only the hooks it needs. See Stream observer.
Migrating to v0.19.0
The OpenFeature provider needs OpenFeature 2.x. Update theOpenFeature package to 2.x, and
call the client’s 2.x methods:
GetStringValueAsync, GetDoubleValueAsync, GetIntegerValueAsync and
GetObjectValueAsync. Registering the provider with Api.Instance.SetProviderAsync is unchanged.
Applications that do not use WestyxNexus.OpenFeature need no change.
v0.18.0 - 2026-09-30
- The endpoint can come from the environment. Leave
BaseUrlunset and the client readsWESTYX_SERVICE_ENDPOINT(NexusConfig.ServiceEndpointEnvironmentVariable) when it is created -westyx dev runsets it for the script’s service, so a locally started application needs neither an endpoint nor a key in its code.AddWestyxNexusapplies the same rule toNexusOptions.BaseUrl. A value you set always wins, and an error about the variable’s value names the variable. See Configuration. NexusConfig.BaseUrlisstring?and no longerrequired. Every existing initializer still compiles; code that reads the property may see a nullable warning.
v0.17.0 - 2026-08-29
NexusOptions.LoggerFactory,NexusOptions.ObserverandWifOptions.CredentialSourceare removed, closing the sevenSYSLIB1100/SYSLIB1101warnings a config-binding-generator consumer got for properties that could never come from configuration. Register the service in the container instead -services.AddSingleton<IStreamObserver, MyObserver>()- andAddWestyxNexusresolves it from there.
Migrating to v0.17.0
Three service-typed options properties move into the container.WifOptions.CredentialSource: services.AddSingleton<IWifCredentialSource, MySource>() instead of setting it on the options object. AddWestyxNexus(NexusConfig) is unaffected - it still accepts NexusConfig.LoggerFactory/.Observer and registers them into the container for you.
v0.16.0 - 2026-08-14
- A request carrying a credential does not follow a redirect. Every client the SDK owns refuses redirects. The runtime strips
Authorizationacross a cross-origin redirect but forwards custom headers, andX-Nexus-API-Keyis a custom header - so a redirect is an error rather than a delivery. If your endpoint could have returned one, rotate the service key. - The secret guards read the backend’s
key_typeas well as the key’s prefix, so a legacy public key without thewxp_prefix is treated as public. aws_iamships inWestyxNexus.Wif.Awsand is selected as a credential source, so the core no longer depends onAWSSDK.Core. See Workload identity.- OpenTelemetry tracing and metrics, under
NexusDiagnostics.Name- three spans and three instruments, inert until something subscribes. - Every package is trim- and Native-AOT-compatible and declares
IsAotCompatible, proven by a harness the pipeline publishes under bothPublishAotandPublishTrimmed. See Trimming and Native AOT. - XML documentation, symbol packages and Source Link ship in all six packages - IntelliSense, and stepping into the SDK from your own debugger.
KeyTypeandKindare enums, andGetSecretis synchronous.GetSecretreads the in-memory cache and never made a network call.
Migrating to v0.16.0
INexusLogger and NexusConfig.Logger are removed. Set NexusConfig.LoggerFactory to an ILoggerFactory instead; on the dependency-injection path the application’s own ILoggerFactory is used with nothing to set.
aws_iam moves to its own package and becomes a credential source.
services.AddWestyxNexusAwsIam("eu-central-1") and remove "Provider": "aws_iam" and "AwsRegion" from appsettings.json. A configuration that still names aws_iam throws at startup, naming the package to add and the call to make. The exchange body, the signed header set and the X-Nexus-Server-ID binding are unchanged, and the logs and the wif.provider span attribute still read aws_iam.
WifProvider.AwsIam is gone, which shifts the numeric values of Gcp, Azure and Developer. Only code that casts the enum to or from an integer is affected; use the member names.
Three API shapes change.
GetSecret reads the in-memory cache and never made a network call, so the Task promised asynchrony it could not deliver; it pairs with GetSecretFilePath, which was always synchronous. KeyType.None is a WIF-only client, and ServiceKind.Unknown covers both “not yet synced” and a kind this SDK version does not recognise - so a kind added to the platform cannot make an existing client throw. client.KindName carries the string the backend sent.
GetAllConfigs and GetAllFlags return the same read-only instance until the next sync, rather than a fresh copy per call - measured at a thousand keys, a call cost 16.6 µs and 31 KB. Read them again after a sync. A caller that cast the result back to Dictionary<,> and mutated it - which affected only that copy - now gets an InvalidCastException; copy the map yourself if you need a mutable one.
A configuration value that cannot be meant is rejected rather than repaired. A sync 429 now arrives as NexusRateLimitedException carrying RetryAfter; an unexpected status is NexusApiException. Both are NexusException, so a catch (NexusException) already covers them.
v0.15.0 - 2026-08-08
- A credential source can express any credential the protocol accepts.
IWifCredentialSourcereturns either an OIDC token or a signed, server-bound request - the shapeaws_iamuses - so supplying a workload identity the SDK does not produce natively no longer requires a change to the SDK. See Workload identity. westyx dev setupcredentials are picked up automatically. Thedeveloperprovider uses the session the Westyx CLI already obtained, directly as the bearer, with no token exchange. It is probed last, so a real cloud identity always wins on a real cloud host. See Local development.WifConfig.Provideris an enum (WifProvider), and a value outside the set is rejected at construction. The WIF types are renamed toWifConfig/WifProvider/WifConfig.AwsRegion.services.AddWestyxNexus(IConfiguration section)registers the client from a configuration section, and anIWifCredentialSourcein the container is picked up automatically. See Dependency injection.
Migrating to v0.15.0
The WIF types are renamed andProvider changes type. Both are mechanical, and the compiler names every site.
WifConfig.TokenSource still works and is obsolete for one release:
CredentialSource wins. Provider = WifProvider.AwsIam together with a credential source now throws at client construction: aws_iam signs its own request, so the credential source would never be called.
v0.14.0 - 2026-08-05
- File-type secrets live in a private per-client directory, created
0700, with each file created exclusively at0600and the mode applied by the creating call. Nothing else on the machine can enter the directory, which is how .NET gets symlink safety without anO_NOFOLLOWequivalent. See API reference. - A throwing
IStreamObservercallback cannot affect the stream. Every hook goes through one guarded dispatcher, so a bug in your telemetry callback neither ends the stream nor counts as a transport error. - A billing
402throttles the background refresh to one attempt every five minutes rather than stopping it, and any success clears it - a304 Not Modifiedincluded - so settling the invoice restores service without restarting the process. - The SSE stream carries a connect deadline and an idle deadline.
StreamConnectTimeout(default 10 s) bounds the connect-to-headers phase;StreamIdleTimeout(default 90 s) is reset by every line received, keepalives included. See SSE live updates. - Configuration is validated at construction. A value that cannot be meant throws
NexusConfigExceptionnaming the option, and for the reconnect schedule the offending index.nullstill selects the default. See Configuration. - An integer inside an OpenFeature structure resolution keeps its exact value, carried as its decimal text when it does not fit the 32-bit integer slot.
Migrating to v0.14.0
Two changes can affect existing code. Configuration values that were previously coerced are now rejected. If you pass any of these to mean “use the default”, passnull instead:
int.MaxValue:
AsInteger and fractional numbers as AsDouble. A scalar ResolveIntegerValue still answers TYPE_MISMATCH for a value that does not fit, which is unchanged.
v0.13.0 - 2026-08-03
builder.AddWestyxNexus(config)wires everything over one client. One call servesIConfigurationand the container from the same client, so config binding, secrets binding, feature management and an injectedNexusClientshare one cache, one sync loop and one SSE connection.services.AddWestyxNexus(config)accepts aNexusConfigdirectly - the same object the configuration source takes. WhatIHttpClientFactoryowns is rejected by name rather than ignored.NexusOptions.LoggerFactoryroutes SDK diagnostics away from the application’s logging pipeline when you want that; null keeps using the application’s.- The dependency-injection entry points name the call you are missing when no client is registered.
- The client created on the builder is disposed with the host. If you register a client yourself, use
services.AddSingleton(_ => client)- the container disposes what a factory returns, not an instance handed toAddSingleton(client).
v0.12.1 - 2026-07-31
- An OpenFeature boolean resolution reports its
Variant-"true"or"false", lowercase, the same spelling every SDK in the suite uses.
v0.12.0 - 2026-07-31
- Boolean flag evaluation is per-user. With a targeting key in the
EvaluationContext, the OpenFeature provider resolves the flag through the AB Testing add-on, applying its rollout percentage and cohort rules to that identity. Without a targeting key it reads the synced snapshot, exactly as before. NexusClient.FindFlag(key)returns the flag’sis_activestate ornullwhen the flag is not in the cache at all, whichGetFlagcannot express.- An object or array config resolves to a real OpenFeature structure, so
AsStructure()works. Composite values used to arrive as their JSON text. - Breaking:
EvaluateABAsync’sattributesisIDictionary<string, string>; an unknown flag resolves asFLAG_NOT_FOUND; successful resolutions reportStaticrather thanCached.
Migrating to v0.12.0
Four changes; only the first is a source edit.
A non-string attribute value was already rejected by the service with
400, so nothing that
worked before stops working - the signature now says what the endpoint accepts. Cohort conditions
compare attribute values as strings, so formatting the value at the call site is what lets you
control exactly what the rule is matched against.
v0.11.0 - 2026-07-14
Acts on an external .NET developer’s review. Several items are breaking, and every deliberate departure from .NET convention is explained in Design decisions. Five packages instead of two - a console app no longer drags in the configuration pipeline it never uses:- BREAKING -
AddWestyx()moved toWestyxNexus.Extensions.Configuration. Add the package reference; the namespace is unchanged, so no code edit. - BREAKING - multi-targeted
net8.0;net10.0. .NET 8 goes out of support on 2026-11-10; .NET 10 is the current LTS (to 2028-11-14). NexusConfig.LoggerFactorytakes a standardILoggerFactory;INexusLoggeris obsolete but still bridged. Log statements are structured, under the categoriesWestyx.Nexus.NexusClient,Westyx.Nexus.StreamandWestyx.Nexus.Wif.- Async startup.
AddWestyxNexus()runs the initial sync in anIHostedServiceinstead of blocking a thread-pool thread. NexusConfig.PooledConnectionLifetime(default 2 minutes). The framework default is infinite, so an application-lifetime singleton never recycled a connection and never observed a DNS change.IConfigurationbinding fixed twice - dotted keys are now section-navigable (GetSection("database")used to come back empty and bind nothing), and JSON objects and arrays are flattened instead of stored as one opaque string.AddWestyxNexusSecrets<T>()binds secrets toIOptions<T>with live re-bind, without putting them inIConfiguration.AddWestyxNexusFeatureManagement()serves Nexus flags toIFeatureManagerfrom the in-memory cache.
- File-type secrets are written owner-readable only (
0600), applied at creation viaUnixCreateModerather than by a chmod afterwards. - Two clients holding the same secret no longer share one temp file; the first disposed used to delete it out from under the other.
- The post-sync notification is additive, so the configuration provider and the secrets binder both stay live when used together.
Migrating to v0.11.0
AddWestyx() moved to its own package. Add WestyxNexus.Extensions.Configuration; the namespace is still Westyx.Nexus, so no code changes.
IConfiguration keys are section-navigable. A Nexus key database.host is reachable as database:host as well as database.host, and JSON objects and arrays are flattened into child keys - so GetSection("database") and IOptions<T> binding work, where before this release they came back empty. A workaround you built keeps working.
v0.10.0 - 2026-07-05
- Version alignment across the Westyx Nexus SDK suite.
v0.9.0 - 2026-07-03
aws_iamWIF provider (AWS IAM Caller Identity) - authenticates non-EKS AWS compute (ECS/Fargate, Lambda, plain EC2) that has IAM credentials but no OIDC token. The SDK SigV4-signs an STSGetCallerIdentityrequest (never sent to AWS) and posts it to/v1/auth/token-exchange; Nexus replays it against a pinned STS endpoint to prove your IAM role. The signedX-Nexus-Server-IDis your service’s own base-URL host - a captured request is valid for that one service only, and there is nothing to configure. UsesAWSSDK.Corefor the credential/region chain only. See Workload identity.- Azure Workload Identity (AKS) - the
Azureprovider now prefers the projected federated token file ($AZURE_FEDERATED_TOKEN_FILE) before falling back to IMDS; auto-detection probes the file too. - Probe-based auto-detection - auto-detect now stats the Kubernetes / AWS-IRSA / Azure token files and live-probes the GCP and Azure metadata servers (~1 s timeout), instead of keying on environment variables absent on real cloud nodes.
- Security hardening -
NexusClient.CreateAsyncrejects plain-httpBaseUrls (loopback excepted); the Azure IMDS path refuses the generic default audience (must beapi://<client-id>); expired WIF sessions fail closed; the metadata client disables redirects and the system proxy; metadata/exchange reads are bounded.
v0.8.0 - 2026-06-16
WestyxNexus.OpenFeatureNuGet sub-package - installWestyxNexus.OpenFeaturealongsideWestyxNexusand registerNexusProvideras an OpenFeature provider. Feature flags resolve viaResolveBooleanValue; configs viaResolveString/Double/Integer/StructureValue. All reads are cache-backed. See OpenFeature integration.
v0.7.0 - 2026-06-12
- ASP.NET Core
IConfigurationintegration -builder.Configuration.AddWestyx(nexusConfig)plugs Nexus into the standard configuration pipeline. All config values are accessible viaIConfiguration, bindable viaIOptions<T>, and live-reloaded viaIOptionsMonitor<T>when SSE is enabled — no restart needed. See ASP.NET Core configuration.
v0.6.0
- SSE reconnects after a polling fallback. After the stream falls back to TTL polling, the SDK schedules a reconnect attempt on the
SseReconnectCooldownschedule instead of staying in polling mode until the client is restarted.
v0.5.1 - 2026-06-03
- Requires .NET 8 or later - target framework widened to
net8.0. Supports .NET 8, 9, 10, and later. - Security improvements - response bodies are no longer embedded in exception messages;
file-type secret paths are fully hashed; key names are never stored on the filesystem. - Reliable
GetSecretAsync- all code paths return a properly awaitableTask, consistent with async/await conventions throughout the SDK. - Thread-safe WIF session - concurrent token refresh calls are serialised to prevent redundant token exchanges.
- CI - test stage runs on every MR; publish is restricted to
main-branch tags.
v0.5.0
- Write API -
SetSecretAsync,DeleteSecretAsync,DeleteSecretVersionAsyncfor programmatic secret management. secret keys only; public keys throwNexusPublicKeyExceptionimmediately without a network call. NexusRateLimitedException- new exception for HTTP 429 on write endpoints.
v0.4.0 - 2026-05-28
- Quarantine handling -
NexusQuarantinedExceptionon sync when the backend returns429with a{"error":"quarantined"}body, carryingReasonandExpiresAt;IStreamObserver.OnQuarantined; background sync is suppressed untilExpiresAt, and the stream sleeps until then and reconnects without counting a transport failure. - All API paths moved from
/api/v1/to/v1/. ConfigEntry.IsPublicis removed; visibility is decided server-side.
v0.3.1 - 2026-05-13
Retry-After-aware SSE 429 handling -RunStreamAsyncnowawait Task.Delay-s the indicated duration (clamped[5 s, 5 min]) and reconnects automatically when the server returns429with a parseableRetry-Afterheader (delta-seconds or HTTP-date form). WithoutRetry-After, the legacy terminate-on-429 + TTL polling fallback is preserved.
v0.3.0
- AB Testing add-on - new
EvaluateABAsync(keys, userId, attributes, ct)for batch per-user flag evaluation. ThrowsNexusAbAddonNotAvailableExceptionon 403. - File-type secrets - secrets now carry a
typefield;file-type values are materialised to temp files underPath.GetTempPath()and exposed viaGetSecretFilePath(key). Temp files are cleaned up byDispose().
v0.2.0
- Workload Identity Federation - Kubernetes / AWS IRSA / GCP / Azure auto-detected; bearer-JWT auth with automatic refresh.
- Stream observer hooks - opt-in
IStreamObserverfor ops dashboards and load-test tooling. - Service kind awareness -
GetSecretAsyncblocked withNexusServiceKindMismatchExceptiononkind=frontendservices. - 402 Payment Required handling -
NexusBillingExceptionthrown,BillingOverdueflag set, the background refresh throttled to one attempt every five minutes and the cache served; any success clears it. - Split HTTP clients - a short consumer timeout no longer truncates the SSE stream.
v0.1.0
- Initial release.
