@splitsoftware/splitio 11.5.0-rc.1 → 11.5.1-rc.1

package/CHANGES.txt

@@ -1,6 +1,11 @@
-11.5.0 (September 9, 2025)
- - Added `factory.getRolloutPlan()` method for standalone server-side SDKs, which returns the rollout plan snapshot from the storage.
- - Added `initialRolloutPlan` configuration option for standalone client-side SDKs, which allows preloading the SDK storage with a snapshot of the rollout plan.
+11.6.0 (September 18, 2025)
+ - Added `storage.wrapper` configuration option to allow the SDK to use a custom storage wrapper for the storage type `LOCALSTORAGE`. Default value is `window.localStorage`.
+ - Updated @splitsoftware/splitio-commons package to version 2.6.0.
+
+11.5.0 (September 10, 2025)
+ - Added `factory.getRolloutPlan()` method for standalone server-side SDK (Node.js), which returns the rollout plan snapshot from the storage.
+ - Added `initialRolloutPlan` configuration option for standalone client-side SDK (Browser), which allows preloading the SDK storage with a snapshot of the rollout plan.
+ - Updated @splitsoftware/splitio-commons package to version 2.5.0.
 
 11.4.1 (June 3, 2025)
  - Updated @splitsoftware/splitio-commons package to version 2.4.1, which improves the Proxy fallback to flag spec version 1.2 by handling the case when the Proxy does not return an end-of-stream marker in 400 status code responses.
@@ -14,7 +19,7 @@
  - Updated @splitsoftware/splitio-commons package to version 2.3.0, which optimizes the Redis storage to:
     - Avoid lazy require of the `ioredis` dependency when the SDK is initialized, and
     - Flag the SDK as ready from cache immediately to allow queueing feature flag evaluations before SDK_READY event is emitted.
- - Bugfix - Enhanced HTTP client module to implement timeouts for failing requests that might otherwise remain pending indefinitely on some Fetch API implementations.
+ - Bugfix - Enhanced HTTP client module to implement timeouts for failing requests that might otherwise remain pending indefinitely on some Fetch API implementations, pausing the SDK synchronization process.
 
 11.2.0 (March 28, 2025)
  - Added a new optional argument to the client `getTreatment` methods to allow passing additional evaluation options, such as a map of properties to append to the generated impressions sent to Split backend. Read more in our docs.
@@ -55,6 +60,15 @@
     - Removed the deprecated `GOOGLE_ANALYTICS_TO_SPLIT` and `SPLIT_TO_GOOGLE_ANALYTICS` integrations. The `integrations` configuration option has been removed from the SDK factory configuration, along with the associated interfaces in the TypeScript definitions.
     - Removed the `core.trafficType` configuration option (`SplitIO.IBrowserSettings['core']['trafficType]`) and the `trafficType` parameter from the SDK `client()` method in Browser (`SplitIO.IBrowserSDK['client']`). As a result, traffic types can no longer be bound to SDK clients, and the traffic type must be provided in the `track` method.
 
+10.28.1 (July 25, 2025)
+ - Updated @splitsoftware/splitio-commons package to version 1.17.1 that includes some vulnerability and bug fixes.
+ - Updated the Redis storage to avoid lazy require of the `ioredis` dependency when the SDK is initialized.
+ - Bugfix - Enhanced HTTP client module to implement timeouts for failing requests that might otherwise remain pending indefinitely on some Fetch API implementations, pausing the SDK synchronization process.
+ - Bugfix - Properly handle rejected promises when using targeting rules with segment matchers in consumer modes (e.g., Redis and Pluggable storages).
+ - Bugfix - Sanitize the `SplitSDKMachineName` header value to avoid exceptions on HTTP/S requests when it contains non ISO-8859-1 characters (Related to issue https://github.com/splitio/javascript-client/issues/847).
+ - Bugfix - Fixed an issue with the SDK_UPDATE event on server-side, where it was not being emitted if there was an empty segment and the SDK received a feature flag update notification.
+ - Bugfix - Fixed an issue with the server-side polling manager that caused dangling timers when the SDK was destroyed before it was ready.
+
 10.28.0 (September 6, 2024)
  - Updated @splitsoftware/splitio-commons package to version 1.17.0 that includes minor updates:
     - Added `sync.requestOptions.getHeaderOverrides` configuration option to enhance SDK HTTP request Headers for Authorization Frameworks.

package/cjs/factory/node.js

@@ -13,6 +13,7 @@ var sdkClientMethod_1 = require("@splitsoftware/splitio-commons/cjs/sdkClient/sd
 var impressionObserverSS_1 = require("@splitsoftware/splitio-commons/cjs/trackers/impressionObserver/impressionObserverSS");
 var sdkFactory_1 = require("@splitsoftware/splitio-commons/cjs/sdkFactory");
 var constants_1 = require("@splitsoftware/splitio-commons/cjs/utils/constants");
+var mode_1 = require("@splitsoftware/splitio-commons/cjs/utils/settingsValidation/mode");
 var LocalhostFromFile_1 = require("../sync/offline/LocalhostFromFile");
 var node_1 = require("../settings/node");
 var platform_1 = require("../platform");
@@ -40,10 +41,10 @@ function getModules(settings) {
         impressionsObserverFactory: impressionObserverSS_1.impressionObserverSSFactory,
         filterAdapterFactory: bloomFilter_1.bloomFilterFactory,
         extraProps: function (params) {
-            if (params.settings.mode !== constants_1.CONSUMER_MODE) {
+            if (!(0, mode_1.isConsumerMode)(params.settings.mode)) {
                 return {
-                    getRolloutPlan: function (userKeys) {
-                        return (0, getRolloutPlan_1.getRolloutPlan)(params.settings.log, params.storage, userKeys);
+                    getRolloutPlan: function (options) {
+                        return (0, getRolloutPlan_1.getRolloutPlan)(params.settings.log, params.storage, options);
                     }
                 };
             }

package/cjs/platform/getEventSource/eventsource.js

@@ -7,7 +7,7 @@ that accepts a custom agent.
 
 The MIT License
 
-Copyright (c) EventSource GitHub organisation
+Copyright (c) EventSource GitHub organization
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/cjs/settings/defaults/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.packageVersion = void 0;
-exports.packageVersion = '11.5.0-rc.1';
+exports.packageVersion = '11.5.1-rc.1';

package/cjs/settings/storage/browser.js

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateStorage = void 0;
-var isLocalStorageAvailable_1 = require("@splitsoftware/splitio-commons/cjs/utils/env/isLocalStorageAvailable");
 var constants_1 = require("@splitsoftware/splitio-commons/cjs/utils/constants");
 var STORAGE_LOCALSTORAGE = 'LOCALSTORAGE';
 function validateStorage(settings) {
-    var log = settings.log, mode = settings.mode, _a = settings.storage, _b = _a === void 0 ? { type: constants_1.STORAGE_MEMORY } : _a, type = _b.type, _c = _b.options, options = _c === void 0 ? {} : _c, prefix = _b.prefix, expirationDays = _b.expirationDays, clearOnInit = _b.clearOnInit;
+    var log = settings.log, mode = settings.mode, _a = settings.storage, _b = _a === void 0 ? { type: constants_1.STORAGE_MEMORY } : _a, type = _b.type, _c = _b.options, options = _c === void 0 ? {} : _c, prefix = _b.prefix, expirationDays = _b.expirationDays, clearOnInit = _b.clearOnInit, wrapper = _b.wrapper;
     var __originalType;
     var fallbackToMemory = function () {
         __originalType = type;
@@ -16,12 +15,10 @@ function validateStorage(settings) {
     if (mode === constants_1.LOCALHOST_MODE && type === STORAGE_LOCALSTORAGE) {
         fallbackToMemory();
     }
-    // If an invalid storage type is provided OR we want to use LOCALSTORAGE and
-    // it's not available, fallback into MEMORY
-    if (type !== constants_1.STORAGE_MEMORY && type !== STORAGE_LOCALSTORAGE ||
-        type === STORAGE_LOCALSTORAGE && !(0, isLocalStorageAvailable_1.isLocalStorageAvailable)()) {
+    // If an invalid storage type is provided, fallback into MEMORY
+    if (type !== constants_1.STORAGE_MEMORY && type !== STORAGE_LOCALSTORAGE) {
         fallbackToMemory();
-        log.error('Invalid or unavailable storage. Fallback into MEMORY storage');
+        log.error('Invalid storage type. Fallback into MEMORY storage');
     }
     return {
         type: type,
@@ -29,6 +26,7 @@ function validateStorage(settings) {
         prefix: prefix,
         expirationDays: expirationDays,
         clearOnInit: clearOnInit,
+        wrapper: wrapper,
         __originalType: __originalType
     };
 }

package/esm/factory/node.js

@@ -10,6 +10,7 @@ import { sdkClientMethodFactory } from '@splitsoftware/splitio-commons/esm/sdkCl
 import { impressionObserverSSFactory } from '@splitsoftware/splitio-commons/esm/trackers/impressionObserver/impressionObserverSS';
 import { sdkFactory } from '@splitsoftware/splitio-commons/esm/sdkFactory';
 import { CONSUMER_MODE, LOCALHOST_MODE } from '@splitsoftware/splitio-commons/esm/utils/constants';
+import { isConsumerMode } from '@splitsoftware/splitio-commons/esm/utils/settingsValidation/mode';
 import { localhostFromFileFactory } from '../sync/offline/LocalhostFromFile';
 import { settingsFactory } from '../settings/node';
 import { platform, SignalListener } from '../platform';
@@ -37,10 +38,10 @@ function getModules(settings) {
         impressionsObserverFactory: impressionObserverSSFactory,
         filterAdapterFactory: bloomFilterFactory,
         extraProps: function (params) {
-            if (params.settings.mode !== CONSUMER_MODE) {
+            if (!isConsumerMode(params.settings.mode)) {
                 return {
-                    getRolloutPlan: function (userKeys) {
-                        return getRolloutPlan(params.settings.log, params.storage, userKeys);
+                    getRolloutPlan: function (options) {
+                        return getRolloutPlan(params.settings.log, params.storage, options);
                     }
                 };
             }

package/esm/platform/getEventSource/eventsource.js

@@ -7,7 +7,7 @@ that accepts a custom agent.
 
 The MIT License
 
-Copyright (c) EventSource GitHub organisation
+Copyright (c) EventSource GitHub organization
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/esm/settings/defaults/version.js

@@ -1 +1 @@
-export var packageVersion = '11.5.0-rc.1';
+export var packageVersion = '11.5.1-rc.1';

package/esm/settings/storage/browser.js

@@ -1,8 +1,7 @@
-import { isLocalStorageAvailable } from '@splitsoftware/splitio-commons/esm/utils/env/isLocalStorageAvailable';
 import { LOCALHOST_MODE, STORAGE_MEMORY } from '@splitsoftware/splitio-commons/esm/utils/constants';
 var STORAGE_LOCALSTORAGE = 'LOCALSTORAGE';
 export function validateStorage(settings) {
-    var log = settings.log, mode = settings.mode, _a = settings.storage, _b = _a === void 0 ? { type: STORAGE_MEMORY } : _a, type = _b.type, _c = _b.options, options = _c === void 0 ? {} : _c, prefix = _b.prefix, expirationDays = _b.expirationDays, clearOnInit = _b.clearOnInit;
+    var log = settings.log, mode = settings.mode, _a = settings.storage, _b = _a === void 0 ? { type: STORAGE_MEMORY } : _a, type = _b.type, _c = _b.options, options = _c === void 0 ? {} : _c, prefix = _b.prefix, expirationDays = _b.expirationDays, clearOnInit = _b.clearOnInit, wrapper = _b.wrapper;
     var __originalType;
     var fallbackToMemory = function () {
         __originalType = type;
@@ -13,12 +12,10 @@ export function validateStorage(settings) {
     if (mode === LOCALHOST_MODE && type === STORAGE_LOCALSTORAGE) {
         fallbackToMemory();
     }
-    // If an invalid storage type is provided OR we want to use LOCALSTORAGE and
-    // it's not available, fallback into MEMORY
-    if (type !== STORAGE_MEMORY && type !== STORAGE_LOCALSTORAGE ||
-        type === STORAGE_LOCALSTORAGE && !isLocalStorageAvailable()) {
+    // If an invalid storage type is provided, fallback into MEMORY
+    if (type !== STORAGE_MEMORY && type !== STORAGE_LOCALSTORAGE) {
         fallbackToMemory();
-        log.error('Invalid or unavailable storage. Fallback into MEMORY storage');
+        log.error('Invalid storage type. Fallback into MEMORY storage');
     }
     return {
         type: type,
@@ -26,6 +23,7 @@ export function validateStorage(settings) {
         prefix: prefix,
         expirationDays: expirationDays,
         clearOnInit: clearOnInit,
+        wrapper: wrapper,
         __originalType: __originalType
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio",
-  "version": "11.5.0-rc.1",
+  "version": "11.5.1-rc.1",
   "description": "Split SDK",
   "files": [
     "README.md",
@@ -38,7 +38,7 @@
     "node": ">=14.0.0"
   },
   "dependencies": {
-    "@splitsoftware/splitio-commons": "2.5.0-rc.1",
+    "@splitsoftware/splitio-commons": "2.5.1-rc.0",
     "bloom-filters": "^3.0.4",
     "ioredis": "^4.28.0",
     "js-yaml": "^3.13.1",

package/src/factory/node.js

@@ -10,6 +10,7 @@ import { sdkClientMethodFactory } from '@splitsoftware/splitio-commons/src/sdkCl
 import { impressionObserverSSFactory } from '@splitsoftware/splitio-commons/src/trackers/impressionObserver/impressionObserverSS';
 import { sdkFactory } from '@splitsoftware/splitio-commons/src/sdkFactory';
 import { CONSUMER_MODE, LOCALHOST_MODE } from '@splitsoftware/splitio-commons/src/utils/constants';
+import { isConsumerMode } from '@splitsoftware/splitio-commons/src/utils/settingsValidation/mode';
 
 import { localhostFromFileFactory } from '../sync/offline/LocalhostFromFile';
 import { settingsFactory } from '../settings/node';
@@ -52,10 +53,10 @@ function getModules(settings) {
     filterAdapterFactory: bloomFilterFactory,
 
     extraProps: (params) => {
-      if (params.settings.mode !== CONSUMER_MODE) {
+      if (!isConsumerMode(params.settings.mode)) {
         return {
-          getRolloutPlan(userKeys) {
-            return getRolloutPlan(params.settings.log, params.storage, userKeys);
+          getRolloutPlan(options) {
+            return getRolloutPlan(params.settings.log, params.storage, options);
           }
         };
       }

package/src/platform/getEventSource/eventsource.js

@@ -6,7 +6,7 @@ that accepts a custom agent.
 
 The MIT License
 
-Copyright (c) EventSource GitHub organisation
+Copyright (c) EventSource GitHub organization
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/src/settings/defaults/version.js

@@ -1 +1 @@
-export const packageVersion = '11.5.0-rc.1';
+export const packageVersion = '11.5.1-rc.1';

package/src/settings/storage/browser.js

@@ -1,4 +1,3 @@
-import { isLocalStorageAvailable } from '@splitsoftware/splitio-commons/src/utils/env/isLocalStorageAvailable';
 import { LOCALHOST_MODE, STORAGE_MEMORY } from '@splitsoftware/splitio-commons/src/utils/constants';
 
 const STORAGE_LOCALSTORAGE = 'LOCALSTORAGE';
@@ -12,7 +11,8 @@ export function validateStorage(settings) {
       options = {},
       prefix,
       expirationDays,
-      clearOnInit
+      clearOnInit,
+      wrapper
     } = { type: STORAGE_MEMORY },
   } = settings;
   let __originalType;
@@ -28,12 +28,10 @@ export function validateStorage(settings) {
     fallbackToMemory();
   }
 
-  // If an invalid storage type is provided OR we want to use LOCALSTORAGE and
-  // it's not available, fallback into MEMORY
-  if (type !== STORAGE_MEMORY && type !== STORAGE_LOCALSTORAGE ||
-    type === STORAGE_LOCALSTORAGE && !isLocalStorageAvailable()) {
+  // If an invalid storage type is provided, fallback into MEMORY
+  if (type !== STORAGE_MEMORY && type !== STORAGE_LOCALSTORAGE) {
     fallbackToMemory();
-    log.error('Invalid or unavailable storage. Fallback into MEMORY storage');
+    log.error('Invalid storage type. Fallback into MEMORY storage');
   }
 
   return {
@@ -42,6 +40,7 @@ export function validateStorage(settings) {
     prefix,
     expirationDays,
     clearOnInit,
+    wrapper,
     __originalType
   };
 }