nexus-spring-boot-starter and nexus-openfeature-spring-boot, newest first. Both 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.18.1 - 2026-11-19
- OpenFeature
423 service_lockedhold: uses a timed suppression window (default 5 minutes) matchingenvironment_disabled, soevaluateABrecovers automatically once the lockdown is lifted. - Virtual threads: switches
sessionLockfromsynchronizedtoReentrantLockto avoid pinning carrier threads during token-exchange HTTP calls on JDK 21-23.
v0.18.0 (2026-11-19)
- HTTP 423
service_locked: addsNexusServiceLockedExceptionandNexusStreamObserver.FALLBACK_REASON_SERVICE_LOCKED; stops SSE reconnects immediately and halts background sync retries until an explicitsync()succeeds. - OpenFeature provider: suppresses repeated
evaluateABrequests while the service is locked down, serving the cached snapshot asSTALE.
v0.17.0 - 2026-11-12
- A switched-off environment is reported by name.
403 {"error":"environment_disabled"}throwsNexusEnvironmentDisabledExceptionon every request. The cache keeps serving; the background refresh and the stream wait five minutes between attempts (onFallback("environment-disabled")), 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 response no more specific exception describes throws
NexusApiExceptionwithstatusCode(),errorCode()andoperation(); the message never carries the response body. A429isNexusRateLimitedExceptionon every path, orNexusQuarantinedExceptionwith a quarantine body. - The startup summary:
nexus: client loadednames the configs, secrets and flags the first sync delivered - never a value. The starter logs it through SLF4J;WESTYX_NEXUS_LOG_STARTUP=1writes it to stderr from a plain client with no logger. getSyncErrors()lists the resources the server did not deliver, each logged once as a warning;nexus.log-sync-errors=falsekeeps the list without the log lines.NexusLoggergainswarn.- Concurrent
sync()calls apply one at a time, so an older response never replaces a newer one. - The stream recovers on its own from every failure. A successful connection starts the failure count and the backoff over, and so does the cooldown; a connection that delivers nothing for
nexus.stream-idle-timeout(90 s) is closed and reconnected;disconnectStream()ends a read on a silent connection at once. - A WIF refresh that fails while the session is still valid no longer fails the request; an expired session falls back to the
apiKey, or throwsNexusSessionExpiredExceptionwith the refresh error as its cause, and a credential that is gone throwsNexusWIFNotConfiguredExceptionat once. nexus.sse-reconnect-cooldownbinds from properties.- JDK 25 is tested, alongside 17 and 21; the Spring Boot matrix is 3.5.16, 4.0.9 and 4.1.2.
Migrating to v0.17.0
- A custom
ExchangePayloadSourceimplementsExchangeCredential resolveCredential(ExchangeContext)instead ofString buildPayload(ExchangeContext), returningExchangeCredential.oidc(token)orExchangeCredential.awsIam(headers, body)rather than a JSON body.ExchangePayloadSource.ofOidcToken(...)is unchanged. - An expired
developercredential throwsNexusSessionExpiredException(it wasNexusWIFNotConfiguredException); a missing one still throwsNexusWIFNotConfiguredException. - A blank token from
ExchangePayloadSource.ofOidcTokenthrowsNexusWIFNotConfiguredException(it wasNexusWIFTokenExchangeFailedException). - Code that matched the message of an unexpected status (
unexpected sync status 500) readsNexusApiException.statusCode()instead.
v0.16.0 - 2026-09-30
- The endpoint can come from the environment. With
nexus.base-url(orNexusConfig.baseUrl) unset, the client readsWESTYX_SERVICE_ENDPOINT, whichwestyx dev runsets; the auto-configuration activates on either, and an error about the variable’s value names the variable. - No key means WIF. With no
nexus.api-keyandnexus.wif.enabledunset, the starter enables WIF with the configured provider, sowestyx dev runstarts a Spring application with no Nexus properties at all.
v0.15.0 - 2026-08-25
- The secret guard honours the backend’s key classification. A key is public - and secret access refused - when either the key’s prefix or the server’s
key_typesays so;getKeyType()reports that effective type. - A logger that throws cannot take the client down. Every internal log call is contained.
- The cached snapshot never renders a secret - its
toString()prints counts only. - An interrupted sync re-raises the interrupt.
v0.14.0 - 2026-08-10
- The WIF provider is a type.
WIFProvideris an enum;nexus.wif.providerbinds leniently and an unknown value fails the start naming every valid one. WIFConfighas a factory per provider, so a provider’s options are reachable only through the factory that owns them.WIFConfig.custom(...)expresses a credential the SDK has no provider for.- A
developerprovider. Afterwestyx dev setup, a developer machine authenticates with the session the CLI already obtained; always the last providerautoconsiders. - The API key stays masked on the actuator’s configuration endpoints even with
show-valueson. X-Nexus-Server-IDis the authority the request actually carries - host, plus a port only when it is not the scheme’s default.
Migrating to v0.14.0
WIFConfig.builder().provider("...")becomes the provider’s factory:WIFConfig.kubernetes(),aws(),awsIam(region),gcp(audience),azure(audience),azureFederated(),developer(),auto()orcustom(source).WIFConfig.provider()returnsWIFProvider; thePROVIDER_*string constants are gone.ExchangePayloadSource.buildPayload()takes anExchangeContext.
v0.13.0 - 2026-08-06
- A 402 throttles the background refresh to one attempt every five minutes, and any successful sync - a
304included - clearsisBillingOverdue(). A quarantineexpires_atis clamped to 24 hours. - Configuration is validated at
create(), withNexusConfigExceptionnaming the option. - The OpenFeature provider carries an integer larger than the
Valueinteger slot as its exact decimal text inside an object or array resolution.
Migrating to v0.13.0
- A zero or negative
ttl, an emptysseReconnectCooldown, or an entry below one minute is rejected; leave the option unset for the default. - An oversized integer inside an object resolution is read with
asString().
v0.12.0 - 2026-08-03
- Per-user targeting in the OpenFeature provider through the AB Testing add-on, one request per identity, memoised, with concurrent evaluations coalesced.
findFlag(String)distinguishes a missing flag from one that is off.- An object config resolves into the OpenFeature value model; integer resolutions are exact.
Migrating to v0.12.0
evaluateABtakesMap<String, String>attributes; format non-string values at the call site.- An unknown boolean flag reports
FLAG_NOT_FOUND; a non-intnumber ingetIntegerEvaluationreportsTYPE_MISMATCH;getObjectEvaluationreturns a structuredValue.
v0.11.0 - 2026-07-28
- One artifact for Spring Boot 3.5, 4.0 and 4.1, built against 4.0.
- The SDK no longer picks a JSON library for you - Jackson 2 and 3 are both optional, and the SDK uses whichever your application has.
- File-type secrets are written
0600at creation, openedCREATE_NEW+NOFOLLOW_LINKS, on paths scoped to each client. - SpotBugs + find-sec-bugs run in the build; the OpenFeature provider has a CI test job.
Migrating to v0.11.0
If you materialise file-type secrets on a shared host, rotate them after upgrading.
v0.10.0 - 2026-07-05
- Version alignment across the Westyx Nexus SDK suite.
v0.9.0 - 2026-07-03
- The
aws_iamWIF provider for ECS, Fargate, Lambda and plain EC2: a SigV4-signed STSGetCallerIdentityrequest bound to the service’s own host.nexus.wif.aws-regionsets the STS region. - Azure Workload Identity on AKS - the projected federated token file is preferred over IMDS; the IMDS path requires an
api://<client-id>audience. - Auto-detection probes the credential material, never an environment variable alone.
create()rejects a plain-http base URL outside loopback; metadata and exchange reads are bounded; a non-positiveexpires_inis an exchange failure.
v0.8.0 - 2026-06-16
- The OpenFeature provider - the
nexus-openfeature-spring-bootartifact.
v0.6.0 - 2026-06-10
- The stream reconnects after a fallback to polling, on the
sseReconnectCooldownschedule.
v0.5.1 - 2026-06-03
- Exception messages carry status codes only; file-secret paths hash the key name; WIF tokens are trimmed; the WIF session is refreshed before each stream reconnect.
v0.5.0 - 2026-06-01
- The write API:
setSecret,deleteSecret,deleteSecretVersion, andNexusRateLimitedException.
v0.4.0 - 2026-05-28
- All endpoints under
/v1/;NexusQuarantinedExceptionandonQuarantined.
v0.3.1 - 2026-05-13
- The stream honours
Retry-Afteron a429.
v0.3.0
- AB testing batch evaluation, file-type secrets.
v0.2.0
- Workload Identity Federation, stream observer hooks, 402 handling, service kind, separate sync and stream HTTP clients.
v0.1.0
- Initial release.
