Skip to main content
Every release of @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: exports NexusServiceLockedError and FALLBACK_REASON_SERVICE_LOCKED; stops SSE reconnects immediately and halts background sync retries until an explicit sync succeeds.
  • OpenFeature provider: suppresses repeated evaluate-ab requests while the service is locked down, serving the cached snapshot as STALE.

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-ab request - for any context - for the addonSuppressionMs window, with one warning; any success clears it. @westyx-nexus/openfeature-provider-react requires @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.ttlMs exposes 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 403 environment_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.
  • NexusApiError carries status and code for any status with no dedicated class, so an unmapped failure can be told apart without parsing its message.
  • The client ready log 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', so NexusProvider and the hooks can be imported from a React Server Component - a Next.js app/layout.tsx renders 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 baseUrl nor apiKey, the client takes the endpoint and a developer session from westyx dev run through the dev server. See Local development.
  • NexusDevSessionError says why the developer session could not be obtained.
  • baseUrl and apiKey are optional together; giving only one of them is a NexusConfigError.

v0.16.0 - 2026-08-30

  • Breaking: getSecret() is removed, with NexusPublicKeyError and NexusSecretNotFoundError. 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 called getSecret() - 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 by useNexusStreamStatus() 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_INTEGER as its exact decimal string, at any depth, so the resolved value survives JSON.stringify. The scalar number resolution answers TYPE_MISMATCH for the same value.

v0.12.1 - 2026-08-04

  • NexusClient.snapshotRevision - how many times the snapshot’s contents have been replaced, so a subscribe listener 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; NexusProviderOptions is 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 targetingKey resolves a boolean for that user through the AB Testing add-on. See OpenFeature.
  • Bridge options logger and addonSuppressionMs.
  • NexusClient.hasFlag(key) and NexusClient.getFlagKeys().
  • The bridge’s resolutions report DEFAULT or ERROR beside an error code, FLAG_NOT_FOUND for an unknown flag, a variant on every scalar, and TYPE_MISMATCH rather than a converted value.
  • Breaking: evaluateAB() and useEvaluateAB() 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() and useNexusBillingOverdue() re-render on every stream and billing transition.
  • requestTimeoutMs, streamConnectTimeoutMs and streamIdleTimeoutMs; 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; NexusLogger methods take (message, fields?); ttlMs: 0 and an empty sseReconnectCooldown are 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 returned undefined in a browser.
  • useNexusSyncedAt() returns a number: new Date(useNexusSyncedAt()) where you need a Date.
  • A custom logger receives values in a second argument rather than in the message:
  • ttlMs: 0 or sseReconnectCooldown: [] - 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 fetch stream, with the key in the X-Nexus-API-Key header 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/.
  • NexusQuarantinedError and the onQuarantined observer callback.

v0.3.1 - 2026-05-12

  • A 5xx sync is retried with exponential backoff; a stream 429 honours Retry-After.
  • FALLBACK_REASON_TRANSPORT is exported.