feat: add fallback treatments config and improve client ready state handling

Author: EmilianoSanchez

CHANGES.txt

@@ -1,3 +1,10 @@
+1.5.0 (October 31, 2025)
+ - Added new configuration for Fallback Treatments, which allows setting a treatment value and optional config to be returned in place of "control", either globally or by flag. Read more in our docs.
+ - Added `client.getStatus()` method to retrieve the client readiness status properties (`isReady`, `isReadyFromCache`, etc).
+ - Added `client.whenReady()` and `client.whenReadyFromCache()` methods to replace the deprecated `client.ready()` method, which has an issue causing the returned promise to hang when using async/await syntax if it was rejected.
+ - Updated the SDK_READY_FROM_CACHE event to be emitted alongside the SDK_READY event if it hasn’t already been emitted.
+ - Updated @splitsoftware/splitio-commons package to version 2.8.0.
+
 1.4.1 (October 8, 2025)
  - Bugfix - Updated @splitsoftware/splitio-commons package to version 2.7.1, which fixes the `debug` option to support log levels when the `logger` option is used.
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio-react-native",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "Split SDK for React Native",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -61,7 +61,7 @@
   },
   "homepage": "https://github.com/splitio/react-native-client#readme",
   "dependencies": {
-    "@splitsoftware/splitio-commons": "2.7.1"
+    "@splitsoftware/splitio-commons": "2.8.0"
   },
   "devDependencies": {
     "@react-native-community/eslint-config": "^3.2.0",

package.json

@@ -1,7 +1,7 @@
 import type SplitIO from '@splitsoftware/splitio-commons/types/splitio';
 import { CONSENT_GRANTED } from '@splitsoftware/splitio-commons/src/utils/constants';
 
-const packageVersion = '1.4.1';
+const packageVersion = '1.5.0';
 
 export const defaults = {
   startup: {

src/settings/defaults.ts

@@ -109,6 +109,13 @@ let fullReactNativeSettings: SplitIO.IReactNativeSettings = {
   },
   userConsent: 'GRANTED',
   mode: 'standalone',
+  fallbackTreatments: {
+    global: { treatment: 'global-treatment', config: '{"global": true}' },
+    byFlag: {
+      my_flag: { treatment: 'flag-treatment', config: '{"flag": true}' },
+      my_other_flag: 'other-flag-treatment',
+    },
+  },
 };
 
 reactNativeSettings.userConsent = 'DECLINED';

ts-tests/index.ts

@@ -32,7 +32,7 @@ declare module JsSdk {
    * }
    * ```
    *
-   * @see {@link https://developer.harness.io/docs/feature-management-experimentation/sdks-and-infrastructure/client-side-sdks/react-native-sdk/#configuring-cache}
+   * @see {@link https://developer.harness.io/docs/feature-management-experimentation/sdks-and-infrastructure/client-side-sdks/react-native-sdk/#configure-cache-behavior}
    */
   export function InLocalStorage(options?: SplitIO.InLocalStorageOptions): SplitIO.StorageSyncFactory;
 

types/full/index.d.ts

@@ -32,7 +32,7 @@ declare module JsSdk {
    * }
    * ```
    *
-   * @see {@link https://developer.harness.io/docs/feature-management-experimentation/sdks-and-infrastructure/client-side-sdks/react-native-sdk/#configuring-cache}
+   * @see {@link https://developer.harness.io/docs/feature-management-experimentation/sdks-and-infrastructure/client-side-sdks/react-native-sdk/#configure-cache-behavior}
    */
   export function InLocalStorage(options?: SplitIO.InLocalStorageOptions): SplitIO.StorageSyncFactory;