nexus-kotlin-sdk, nexus-kotlin-openfeature and nexus-ktor-plugin, newest first. The three 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.
v0.18.0 (2026-11-19)
- HTTP 423
service_locked: addsNexusServiceLockedExceptionandFALLBACK_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
NexusApiExceptionwithstatus,codeandoperation;NexusForbiddenExceptionis one too. The message never carries the response body. - The startup summary:
nexus: client loadednames the configs, secrets and flags the first sync delivered - never a value. syncErrorslists the resources the server did not deliver, each logged once as a warning;logSyncErrors = falsekeeps the list without the log lines.- 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.
Migrating to v0.17.0
- A custom
ExchangePayloadProviderimplementssuspend fun resolveCredential(context: ExchangeContext): ExchangeCredentialinstead ofbuildPayload(context): String, returningExchangeCredential.Oidc(token)orExchangeCredential.AwsIam(headers, body)rather than a JSON body.oidcTokenProvider { }is unchanged. - Code that matched the message of an unexpected status (
nexus: /v1/sync returned 500) readsNexusApiException.statusinstead. - Code compiled against an earlier version that calls the
NexusConfigconstructor orcopypositionally is recompiled; named arguments are unaffected.
v0.16.0 - 2026-09-30
- The endpoint can come from the environment. Leave
baseUrlempty and the client readsWESTYX_SERVICE_ENDPOINTwhen 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. AbaseUrlyou set always wins, and an error about the variable’s value names the variable. The Ktor plugin’sendpointfalls back the same way. See Configuration.
v0.15.1 - 2026-08-19
- A code-quality maintenance release: internal improvements only, with no behaviour or API change.
v0.15.0 - 2026-08-19
- Credential-bearing requests never follow a redirect. The API and stream clients refuse redirects, so the API key and the WIF session token reach only the endpoint you configured.
- 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 - the guard reads either signal. aws_iamsigns the full authority. The signedX-Nexus-Server-IDincludes a non-default port, soaws_iamauthenticates on a deployment reachable at a port other than 443.- The wire models are
internal.SecretEntry,SyncResponseandTokenExchangeResponsecarry the server’s wire format and are no longer exported; theirtoString(), and the client’s own, render secrets and tokens as***. Breaking only if you referenced those types directly.
v0.14.1 - 2026-08-07
- Auto-detection reaches Azure IMDS when
WifCredential.Autocarries an audience. On a non-AKS Azure VM,WifCredential.Auto(audience = "api://<client-id>")is what that step needs; the genericwestyx-nexusdefault is still refused rather than sent, because Azure AD rejects it as a resource. AKS Workload Identity is unaffected - its projected token file carries its own audience.
v0.14.0 - 2026-08-07
The WIF configuration surface is reshaped, and local development gets a credential of its own. It contains breaking changes - see the CHANGELOG for the migration table.WifConfigisenabledpluscredential, a sealedWifCredentialwhose cases carry only the options that credential has: no audience on Kubernetes, no AWS region outsideAwsIam, and no way to combine a built-in provider with a custom one.- A
developercredential -westyx dev setupissues a session for your service and the SDK picks it up with no code change, last in auto-detection so a cloud credential always wins. ExchangePayloadProvider, a public extension point that returns the whole exchange payload, so a credential that is not an OIDC bearer token can be expressed.WifProvider, an enum for the provider vocabulary, withfromWirefor parsing a string.
Migrating to v0.14.0
The
WIF_PROVIDER_* constants are replaced by the WifProvider enum; parse a string with WifProvider.fromWire(value).
v0.13.0 - 2026-08-06
- A composite (object or array) OpenFeature resolution carries an integer larger than
the
Valuetype’s 32-bit integer slot as its exact decimal text. An integer that fits stays anInt, a genuinely fractional number stays aDouble, and the scalarIntegerevaluation still answersTYPE_MISMATCHfor the same value - the two paths differ on purpose.
v0.12.1 - 2026-08-03
- An
Integerevaluation through the OpenFeature provider requires an exactInt. A fractional config value resolved as the truncated integer with a success reason -3.14gave3- which handed the caller a wrong number with nothing to indicate it. It now resolves asTYPE_MISMATCHwith the default you passed, the same answer every other Westyx Nexus SDK gives. See OpenFeature. getIntandgetLongread a whole number written with a decimal point -8.0reads as8, where it previously returned the default. A fractional value still returns the default, and the log line names which of the two mistakes it was.
v0.12.0 - 2026-07-31
- The OpenFeature provider resolves per user. An
EvaluationContextcarrying a targeting key now selects a per-user boolean evaluation through the Nexus AB 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. The targeted path blocks the calling thread - see the OpenFeature page. NexusProviderOptions-targetingTtl,maxTargetingKeys,addonSuppressionandlogger, each validated in the constructor.NexusClient.getAllFlags()returns every flag in the snapshot with its active state, as every other Westyx Nexus SDK does.
v0.11.0 - 2026-07-29
- No bundled HTTP engine. The SDK depends on
ktor-client-coreonly, so engine choice - connection pooling, TLS, proxying - stays with the application. Add one engine artifact, or pass one toNexusClient.create(engine = …). With none available,createraisesNexusNoHttpEngineExceptionnaming the dependency line to add. See Installation. - Logging, via SLF4J.
NexusConfig.loggerdefaults to the logger nameddev.westyx.nexusand is a no-op until the application binds a backend. No record carries a secret value, a secret key name, an API key, a session JWT or a workload OIDC token. - A Ktor server plugin, published separately as
nexus-ktor-plugin. See Ktor plugin. getLongreads an integer config exactly, including values above 2^53;findFlagreturnsnullfor a flag that does not exist;syncedAt()reports when the snapshot was last confirmed current.- The stream reconnects after a clean server close - which is what a deploy and a WIF session rollover both produce.
connectStream()is idempotent, and the stream has a connect deadline and a 90-second idle deadline. See SSE live updates. - A 402 throttles the background refresh for five minutes instead of suspending it, and any success clears it. A quarantine deadline is honoured up to a 24-hour bound. Refreshes are serialised and coalesced, and a 304 resets the TTL. See Caching behaviour.
- Response bodies are bounded while reading, and one status-to-exception mapping is shared by every endpoint. See Error handling.
- Observer callbacks are guarded - a throwing callback is absorbed, reported through the logger, and cannot stop the stream. See Stream observer.
- File-type secrets are
0600from creation, in a per-client0700directory created on first use and removed byclose()or a JVM shutdown hook. - WIF selection fails closed: a client that asked for workload identity is never quietly created with API-key authentication. See Workload identity.
sseReconnectCooldownrejects a value below one minute instead of clamping it, andttlmust be positive - both named in the error.- Ktor 3.5.1, coroutines 1.11.0, serialization 1.11.0, SLF4J 2.0.18, AWS SDK 2.49.5, OpenFeature 1.22.0; built with Kotlin 2.4.10. JVM baseline unchanged at 17, now tested on 17, 21 and 25.
Migrating to v0.11.0
- Add one Ktor client engine (
io.ktor:ktor-client-cio,-okhttp,-javaor-apache5), or pass one toNexusClient.create(engine = ...). - A client with
wif.enabled = truewhose credential cannot be resolved raisesNexusWifNotConfiguredException; configureapiKeyand leave WIF disabled if you relied on the API-key fallback. sseReconnectCooldownentries below 1 and a non-positivettlraiseNexusConfigException;apiKeyis required unless WIF is enabled.getStringreturns a composite value’s default - usegetJson;getIntreturns the default outsideIntrange - usegetLong.- The OpenFeature provider reports
FLAG_NOT_FOUNDfor a missing flag and returns a structuredValuefor an object.
v0.10.0 - 2026-07-05
- Version alignment across the Westyx Nexus SDK suite.
v0.9.0 - 2026-07-03
- The
aws_iamWIF provider; Azure requests the app-registration audience rather than an ARM token; https enforced on the base URL; fail-closed session refresh;expires_inguard; hardened metadata client.
v0.8.0 - 2026-06-16
- The OpenFeature provider (
nexus-kotlin-openfeature).
v0.6.0 - 2026-06-10
- The stream reconnects after the TTL-polling fallback, on the
sseReconnectCooldownschedule (in minutes).
v0.5.1 - 2026-06-03
- Response bodies removed from exception messages; file-secret paths hash key and value; thread-safe WIF session state; SSE event whitelist.
v0.5.0 - 2026-06-01
- Write API:
setSecret,deleteSecret,deleteSecretVersion;NexusRateLimitedException.
v0.4.0 - 2026-05-28
- Initial release:
evaluateAB, quarantine handling,auth_expiringrefresh,getSecretFilePath,streamStatus.
