westyx-nexus and westyx-nexus-openfeature, newest first. The two crates release from one tag and share one version number. Where a release broke something, its Migrating section shows the change to make. The repository’s CHANGELOG.md carries the same releases in full detail.
v0.17.0-beta.2 - 2026-11-19
- OpenFeature
423 service_lockedhold: uses a timed suppression window (default 5 minutes) matchingenvironment_disabled, soevaluate_abrecovers automatically once the lockdown is lifted. - Secret file background refresh:
get_secret_file_path()now triggersensure_fresh()consistently with the other read methods.
v0.17.0-beta.1 (2026-11-19)
- HTTP 423
service_locked: addsNexusError::ServiceLocked; stops the SSE stream 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.
v0.16.0-beta.1 - 2026-11-12
- A switched-off environment is reported by name.
403 {"error":"environment_disabled"}returnsNexusError::EnvironmentDisabled { operation }on every request, the stream and the token exchange. The cached snapshot keeps serving; the background refresh and the stream wait five minutes between attempts, one warning is logged, and the first successful sync clears it. The OpenFeature provider serves the snapshot asSTALEmeanwhile. - Every API error carries its status and code. A status no other variant describes is
NexusError::Api { operation, status, code },Forbiddencarries itscode, anderr.status()/err.code()answer for any error. No message carries a response body. - The startup summary. The
Nexus client readyevent names the configs, secrets and flags the first sync delivered - never a value. With notracingsubscriber installed,WESTYX_NEXUS_LOG_STARTUP=1writes it to stderr. sync_errors()lists the resources the server did not deliver, each logged once as a warning;log_sync_errors: Some(false)keeps the list without the warnings.- A WIF refresh that fails while the session is still valid keeps the session; once it has expired, a failed refresh is
SessionExpiredwith the refresh error as itssource. - The stream’s error budget restarts after a connection that held for 30 seconds, however it ended; a connection that ends sooner counts as an error, so a flapping endpoint backs off and falls back to polling.
Migrating to v0.16.0-beta.1
-
Minimum supported Rust version 1.91.1 (was 1.88) - the oldest toolchain that resolves a dependency set with no open security advisory. A project pinned below it stays on
0.15.0-beta.1. -
NexusError::ForbiddenbecomesNexusError::Forbidden { .. }in a pattern. -
NexusError::SessionExpiredbecomesNexusError::SessionExpired { .. }; the cause isstd::error::Error::source. -
Code that read the status out of
SyncFailed("...: unexpected status N")matchesNexusError::Api { status, .. }or callserr.status(). -
A
NexusConfigbuilt without..Default::default()addslog_sync_errors: None.
v0.15.0-beta.1 - 2026-09-30
- The endpoint can come from the environment. Leave
endpointempty and the client readsWESTYX_SERVICE_ENDPOINT(westyx_nexus::SERVICE_ENDPOINT_ENV) 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. A value in the field always wins, and an error about the variable’s value names the variable. See Configuration.
v0.14.0-beta.2 - 2026-08-29
- Three declared dependency floors raised to versions that actually build.
serde_jsonto1.0.25,tempfileto3.10.0, and the dev-onlymockitoto1.3.0- a-Z minimal-versionsbuild now runs every pipeline, so a declared floor cannot silently stop building again.
v0.14.0-beta.1 - 2026-08-20
- Breaking: secrets are
SecretString.get_secretreturns asecrecy::SecretString, read with.expose_secret()(both re-exported from the crate root). The value is zeroised on drop - so a replaced cache snapshot leaves no plaintext in freed memory - andDebugrenders it as[REDACTED]. - Credential-bearing requests refuse redirects. The API and stream clients set
redirect::Policy::none(), so a 3xx never resends the API key or the WIF session token to another host. - The public-key guard honours the backend’s classification. A key the backend reports as public is refused secret access whether or not it carries the
wxp_prefix - either signal is sufficient. - The
developercredential is matched on host and port, so two local services on the same host but different ports resolve to their own sessions.
Migrating to v0.14.0-beta.1
Import
ExposeSecret from the crate root.
v0.13.0-beta.1 - 2026-08-09
- A typed provider vocabulary.
WifProvideris a#[non_exhaustive]enum implementingDisplayandFromStr, so a provider read out of an environment variable is validated where it is read rather than deep inside a session refresh. - Breaking: one
credentialfield.WifConfig.providerandWifConfig.token_sourcecollapse intocredential: WifCredential, so a provider and a custom source cannot both be configured. - An async credential source that can express a whole exchange body.
WifCredentialSourceproduces either an OIDC token or the complete token-exchange payload, so a credential that is not an OIDC token fits without a change to the SDK.blocking_token_sourceadapts an existing synchronous closure. - The
developerprovider. On a machine wherewestyx dev setuphas run, the SDK sends the Nexus session token the CLI already obtained. It performs no token exchange and is probed last, so a real cloud credential always wins. - Contradictions rejected at construction, naming the fix:
aws_regionoutsideaws_iam, andaws_iamwithout theaws-iamcargo feature. - Printing a
NexusConfigor aWifConfigrenders the API key asset/unset.
Migrating to v0.13.0-beta.1
v0.12.0-beta.1 - 2026-08-04
- The OpenFeature provider resolves boolean flags per user. An evaluation context carrying a targeting key selects a per-user evaluation through the A/B Testing add-on, so rollout percentages and cohort rules apply. One request covers every flag in the snapshot, results are memoised per user for 30 seconds, and concurrent evaluations for the same user coalesce into one call. See OpenFeature.
NexusProviderOptions-targeting_ttl,max_targeting_keysandaddon_suppression, each validated when the provider is built.find_flagon the blocking client, matching the async one: a disabled flag and an absent one are distinguishable on both surfaces.- Breaking:
evaluate_abtakes&HashMap<String, String>for its attributes on both clients. The service compares attribute values witheq,neqandin, so a string map is what a cohort rule can act on. Values built withjson!("pro")become"pro".to_string(). - Through the provider, a whole number written
5.0resolves as5. JSON has one number type; a fractional value resolves asTYPE_MISMATCHwith your default rather than being truncated, and values beyond the float range keep their exact value. - A composite config value containing a JSON null resolves as
TYPE_MISMATCH. The OpenFeature value model has no null, so such a value cannot be represented there; read it as raw JSON through the wrapped client.
Migrating to v0.12.0-beta.1
v0.11.0-beta.2 - 2026-07-29
The largest rework in the crate’s history. It breaks the public API; Async migration lists the one-line change per break.- Async-first client.
create,sync,set_secret,delete_secret,delete_secret_versionandevaluate_abareasync fn. Cache reads stay synchronous, andspawn_blockingwrappers are no longer needed. blockingfeature for applications with no runtime of their own.tracinginstrumentation with structured fields on create, sync, the token exchange and the stream loop.- Owner-only file-type secrets. Each client materialises them into its own private
0700directory, and each file is created0600at creation viacreate_new+O_NOFOLLOWplus an atomic rename. Two clients never share a path, and a secret removed on the server is removed from disk. - Cleanup runs while the stream is active. The SSE task now holds only a weak reference, so dropping the last clone reaches the cleanup.
- Stream deadlines - a connect deadline plus an idle deadline that resets on every byte, keepalive comments included.
- One status-to-error mapping shared by every endpoint;
evaluate_abreportsRateLimitedon 429. - Bounded response bodies everywhere, with a size error instead of a truncated document.
- Coalesced refreshes - concurrent reads on a stale snapshot trigger one request, and snapshots cannot apply out of order.
- Billing back-off instead of a halt, cleared by the next successful sync.
- Configuration validated once, at construction, naming the option and the list index.
auth_expiringforces a refresh, and a 401 forces one refresh plus one retry.NexusError::TransportreplacesHttp, so the HTTP client is no longer part of the semver contract; the enum is#[non_exhaustive]and gainedConfigandResponseTooLarge.- Exact RFC 3339 date arithmetic, so a quarantine expiry between March and December of a leap year is no longer a day early, and an absurd expiry is clamped to 24 hours.
- OpenFeature provider - see OpenFeature.
- Edition 2024,
thiserror 2, and minimum supported Rust version 1.88, measured and verified by a CI job.
Migrating to v0.11.0-beta.2
Async migration lists the one-line change per break.v0.10.1-beta.1 - 2026-07-10
- Public-key error message no longer mentions the retired
pk_prefix - the error surfaced when a public-key client attempts a secret operation reads “cannot read or write secrets with a public key”.
v0.9.0-beta.1 - 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 endpoint host - a captured request is valid for that one service only. Behind the optionalaws-iamcargo feature, off by default. See Workload identity.- Azure IMDS path - the
azureprovider prefers the projected federated token file ($AZURE_FEDERATED_TOKEN_FILE, AKS) and otherwise fetches an IMDS managed-identity token, requiring an explicitapi://<client-id>audience. - Security hardening - plain-http endpoints rejected (loopback excepted); a failed WIF refresh fails closed; token-exchange 400/403 map to
BadRequest/Forbidden; the slugHostheader is sent on the exchange; metadata and exchange reads are bounded;expires_inis clamped.
v0.8.0-beta.2 - 2026-07-01
- WIF GCP fix - the
gcpprovider fetches a real Google-signed OIDC identity token from the GCE metadata server. It previously read theGOOGLE_APPLICATION_CREDENTIALSkey file, which is not a JWT and was rejected by the token exchange. Auto-detection was aligned with the actual token sources.
v0.8.0-beta.1 - 2026-06-16
- Version alignment across the Westyx Nexus SDK suite.
v0.6.0-beta.1 - 2026-06-11
- The stream reconnects after the polling fallback, on the cooldown schedule
sse_reconnect_cooldownsets.
v0.5.1-beta.1 - 2026-06-03
- Security - response bodies are no longer embedded in error messages;
SecretNotFoundtruncates the key to 128 characters; file-secret paths carry an opaque hash rather than the key name; WIF token files are whitespace-trimmed. - SSE -
flag.toggledtriggers a re-sync, and a429carrying a quarantine body pauses reconnects untilexpires_at.
v0.5.0-beta.1 - 2026-06-01
- The first release of the Rust SDK.
