@westyx-nexus/sdk-react and @westyx-nexus/openfeature-provider-react, newest
first. The two 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.20.0 (2026-11-19)
- HTTP 423
service_locked: exportsNexusServiceLockedErrorandFALLBACK_REASON_SERVICE_LOCKED; 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.
v0.19.2 - 2026-11-12
- The OpenFeature provider stops asking a switched-off environment. While the environment is switched off in the console, the provider keeps the targeted values it already had and sends no
evaluate-abrequest - for any context - for theaddonSuppressionMswindow, with one warning; any success clears it.@westyx-nexus/openfeature-provider-reactrequires@westyx-nexus/sdk-react>=0.19.2.
v0.19.1 - 2026-11-11
- An idle page keeps refreshing while the live stream is down. The client reads its cache once per TTL on its own, so a component that does not re-render still picks up a change. See Caching behaviour.
NexusClient.ttlMsexposes the resolved cache lifetime.- The OpenFeature bridge requires
@westyx-nexus/sdk-react>=0.19.1.
v0.19.0 - 2026-11-11
- A switched-off environment has its own error.
NexusEnvironmentDisabledError(HTTP 403environment_disabled) - the refresh waits five minutes between attempts and the stream moves to its polling schedule (FALLBACK_REASON_ENVIRONMENT_DISABLED) until the environment is switched on. See Error handling. NexusApiErrorcarriesstatusandcodefor any status with no dedicated class, so an unmapped failure can be told apart without parsing its message.- The
client readylog record names the configs and flags the first sync delivered. See Custom logging. - CI runs the suite on Node 20, 22, 24 and 26.
- The OpenFeature bridge requires
@westyx-nexus/sdk-react>=0.19.0.
v0.18.0 - 2026-10-21
- The build starts with
'use client', soNexusProviderand the hooks can be imported from a React Server Component - a Next.jsapp/layout.tsxrenders the provider as a client boundary without a wrapper file. See Getting started with Next.js. - The OpenFeature bridge requires
@westyx-nexus/sdk-react>=0.18.0.
v0.17.0 - 2026-10-02
- Local development without a key. With neither
baseUrlnorapiKey, the client takes the endpoint and a developer session fromwestyx dev runthrough the dev server. See Local development. NexusDevSessionErrorsays why the developer session could not be obtained.baseUrlandapiKeyare optional together; giving only one of them is aNexusConfigError.
v0.16.0 - 2026-08-30
- Breaking:
getSecret()is removed, withNexusPublicKeyErrorandNexusSecretNotFoundError. This SDK only ever holds a public key, and the backend never sends a secret to one.
Migrating to v0.16.0
If nothing in your code calledgetSecret() - the common case, since it never returned a value -
there is nothing to change. Read secrets in server code with a backend SDK.
v0.15.0 - 2026-08-11
- A stream that never connects is reported once, through the configured logger or on
console.warn. A connection lost after connecting is reported byuseNexusStreamStatus()and the stream observer instead. - The stream request sends only the API key and
Accept.
v0.14.0 - 2026-08-11
- The package type-checks under React 18’s types as well as 19’s; both are compiled and tested in CI.
- An object- or array-valued config does not re-render its consumers on a sync that changed nothing.
- The provider’s configuration signature carries a digest of the API key rather than the key.
v0.13.0 - 2026-08-06
- OpenFeature bridge: an object or array evaluation carries an integer beyond
Number.MAX_SAFE_INTEGERas its exact decimal string, at any depth, so the resolved value survivesJSON.stringify. The scalar number resolution answersTYPE_MISMATCHfor the same value.
v0.12.1 - 2026-08-04
NexusClient.snapshotRevision- how many times the snapshot’s contents have been replaced, so asubscribelistener can tell a configuration change from a stream transition or a 304.- OpenFeature bridge: re-fetches targeted values only when the configuration changed; closing it
releases the identity it held;
NexusProviderOptionsis exported; types resolve for CommonJS consumers. It requires the SDK at>=0.12.1.
v0.12.0 - 2026-08-03
- Per-user targeting in the OpenFeature bridge. A context with a
targetingKeyresolves a boolean for that user through the AB Testing add-on. See OpenFeature. - Bridge options
loggerandaddonSuppressionMs. NexusClient.hasFlag(key)andNexusClient.getFlagKeys().- The bridge’s resolutions report
DEFAULTorERRORbeside an error code,FLAG_NOT_FOUNDfor an unknown flag, avarianton every scalar, andTYPE_MISMATCHrather than a converted value. - Breaking:
evaluateAB()anduseEvaluateAB()take string attribute values.
Migrating to v0.12.0
The endpoint compares cohort values as strings and answered anything else with a 400, so a call passing a number or a boolean was already failing. Format at the call site:v0.11.0 - 2026-07-30
Rebuilt on a client shared with the Angular and Vue SDKs, compiled into this package.useNexusStreamStatus()anduseNexusBillingOverdue()re-render on every stream and billing transition.requestTimeoutMs,streamConnectTimeoutMsandstreamIdleTimeoutMs; every request has a deadline, and the stream has a connect and a liveness deadline.- Refreshes are coalesced and ordered; integers above 2^53 arrive as
bigint; response bodies are bounded (NexusResponseTooLargeError);close()releases everything. - Value hooks are built on
useSyncExternalStore. - Breaking: a public key is required;
useSecret()is removed;useNexusSyncedAt()returns epoch milliseconds;NexusLoggermethods take(message, fields?);ttlMs: 0and an emptysseReconnectCooldownare rejected.
Migrating to v0.11.0
-
A public key. Any key other than
wxp_...is rejected at construction. Create a public key on the frontend service. -
useSecret()- remove the call; it only ever returnedundefinedin a browser. -
useNexusSyncedAt()returns a number:new Date(useNexusSyncedAt())where you need aDate. -
A custom logger receives values in a second argument rather than in the message:
-
ttlMs: 0orsseReconnectCooldown: []- remove the option or set a positive value.
v0.10.0 - 2026-07-05
- Version alignment across the SDK suite.
v0.8.0 - 2026-06-16
- The OpenFeature bridge
@westyx-nexus/openfeature-provider-react.
v0.4.1 - 2026-06-03
- The live stream is a
fetchstream, with the key in theX-Nexus-API-Keyheader rather than in the URL. - Error messages carry status codes rather than response bodies.
v0.4.0 - 2026-05-28
- API paths moved from
/api/v1/to/v1/. NexusQuarantinedErrorand theonQuarantinedobserver callback.
v0.3.1 - 2026-05-12
- A 5xx sync is retried with exponential backoff; a stream
429honoursRetry-After. FALLBACK_REASON_TRANSPORTis exported.
