> ## Documentation Index
> Fetch the complete documentation index at: https://docs.westyx.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# React SDK - Version history

> What changed in each release of the React SDK and its OpenFeature bridge, and how to migrate across a breaking change.

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`](https://gitlab.com/westyx/nexus/sdk/react/-/blob/main/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](https://docs.westyx.dev/sdks/react/caching-behaviour.md).
* `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](https://docs.westyx.dev/sdks/react/error-handling.md).
* **`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](https://docs.westyx.dev/sdks/react/custom-logging.md).
* 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](https://docs.westyx.dev/sdks/react/getting-started.md).
* 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](https://docs.westyx.dev/sdks/react/configuration.md#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](https://docs.westyx.dev/sdks/react/openfeature.md#per-user-targeting).
* 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:

```ts theme={null}
// before
evaluateAB(['checkout.v2'], user.id, { age: user.age, beta: true });

// after
evaluateAB(['checkout.v2'], user.id, { age: String(user.age), beta: 'true' });
```

## 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:

  ```ts theme={null}
  const logger: Partial<NexusLogger> = {
    info: (message, fields) => console.info('[nexus]', message, fields),
    warn: (message, fields) => console.warn('[nexus]', message, fields),
  };
  ```

* **`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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.