@splitsoftware/splitio 11.4.2-rc.2 → 11.5.0-rc.0

package/CHANGES.txt

@@ -1,5 +1,6 @@
 11.5.0 (August XX, 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`.
+ - Added `factory.getCache()` method for standalone server-side SDKs, which returns the rollout plan snapshot from the storage.
+ - Added `preloadedData` configuration option for standalone client-side SDKs, which allows preloading the SDK storage with a snapshot of the rollout plan.
 
 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.
@@ -13,7 +14,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, pausing the SDK synchronization process.
+ - Bugfix - Enhanced HTTP client module to implement timeouts for failing requests that might otherwise remain pending indefinitely on some Fetch API implementations.
 
 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.
@@ -54,15 +55,6 @@
     - 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

@@ -7,6 +7,7 @@ var pushManager_1 = require("@splitsoftware/splitio-commons/cjs/sync/streaming/p
 var pollingManagerSS_1 = require("@splitsoftware/splitio-commons/cjs/sync/polling/pollingManagerSS");
 var inRedis_1 = require("@splitsoftware/splitio-commons/cjs/storages/inRedis");
 var InMemoryStorage_1 = require("@splitsoftware/splitio-commons/cjs/storages/inMemory/InMemoryStorage");
+var dataLoader_1 = require("@splitsoftware/splitio-commons/cjs/storages/dataLoader");
 var sdkManager_1 = require("@splitsoftware/splitio-commons/cjs/sdkManager");
 var sdkClientMethod_1 = require("@splitsoftware/splitio-commons/cjs/sdkClient/sdkClientMethod");
 var impressionObserverSS_1 = require("@splitsoftware/splitio-commons/cjs/trackers/impressionObserver/impressionObserverSS");
@@ -37,7 +38,16 @@ function getModules(settings) {
         sdkClientMethodFactory: sdkClientMethod_1.sdkClientMethodFactory,
         SignalListener: platform_1.SignalListener,
         impressionsObserverFactory: impressionObserverSS_1.impressionObserverSSFactory,
-        filterAdapterFactory: bloomFilter_1.bloomFilterFactory
+        filterAdapterFactory: bloomFilter_1.bloomFilterFactory,
+        extraProps: function (params) {
+            if (params.settings.mode !== constants_1.CONSUMER_MODE) {
+                return {
+                    getCache: function (userKeys) {
+                        return (0, dataLoader_1.getCache)(params.settings.log, params.storage, userKeys);
+                    }
+                };
+            }
+        }
     };
     switch (settings.mode) {
         case constants_1.LOCALHOST_MODE:

package/cjs/platform/getEventSource/eventsource.js

@@ -7,7 +7,7 @@ that accepts a custom agent.
 
 The MIT License
 
-Copyright (c) EventSource GitHub organization
+Copyright (c) EventSource GitHub organisation
 
 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.4.2-rc.2';
+exports.packageVersion = '11.5.0-rc.0';

package/cjs/settings/storage/browser.js

@@ -5,7 +5,7 @@ var isLocalStorageAvailable_1 = require("@splitsoftware/splitio-commons/cjs/util
 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, wrapper = _b.wrapper;
+    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 __originalType;
     var fallbackToMemory = function () {
         __originalType = type;
@@ -29,7 +29,6 @@ function validateStorage(settings) {
         prefix: prefix,
         expirationDays: expirationDays,
         clearOnInit: clearOnInit,
-        wrapper: wrapper,
         __originalType: __originalType
     };
 }

package/esm/factory/node.js

@@ -4,6 +4,7 @@ import { pushManagerFactory } from '@splitsoftware/splitio-commons/esm/sync/stre
 import { pollingManagerSSFactory } from '@splitsoftware/splitio-commons/esm/sync/polling/pollingManagerSS';
 import { InRedisStorage } from '@splitsoftware/splitio-commons/esm/storages/inRedis';
 import { InMemoryStorageFactory } from '@splitsoftware/splitio-commons/esm/storages/inMemory/InMemoryStorage';
+import { getCache } from '@splitsoftware/splitio-commons/esm/storages/dataLoader';
 import { sdkManagerFactory } from '@splitsoftware/splitio-commons/esm/sdkManager';
 import { sdkClientMethodFactory } from '@splitsoftware/splitio-commons/esm/sdkClient/sdkClientMethod';
 import { impressionObserverSSFactory } from '@splitsoftware/splitio-commons/esm/trackers/impressionObserver/impressionObserverSS';
@@ -34,7 +35,16 @@ function getModules(settings) {
         sdkClientMethodFactory: sdkClientMethodFactory,
         SignalListener: SignalListener,
         impressionsObserverFactory: impressionObserverSSFactory,
-        filterAdapterFactory: bloomFilterFactory
+        filterAdapterFactory: bloomFilterFactory,
+        extraProps: function (params) {
+            if (params.settings.mode !== CONSUMER_MODE) {
+                return {
+                    getCache: function (userKeys) {
+                        return getCache(params.settings.log, params.storage, userKeys);
+                    }
+                };
+            }
+        }
     };
     switch (settings.mode) {
         case LOCALHOST_MODE:

package/esm/platform/getEventSource/eventsource.js

@@ -7,7 +7,7 @@ that accepts a custom agent.
 
 The MIT License
 
-Copyright (c) EventSource GitHub organization
+Copyright (c) EventSource GitHub organisation
 
 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.4.2-rc.2';
+export var packageVersion = '11.5.0-rc.0';

package/esm/settings/storage/browser.js

@@ -2,7 +2,7 @@ import { isLocalStorageAvailable } from '@splitsoftware/splitio-commons/esm/util
 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, wrapper = _b.wrapper;
+    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 __originalType;
     var fallbackToMemory = function () {
         __originalType = type;
@@ -26,7 +26,6 @@ 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.4.2-rc.2",
+  "version": "11.5.0-rc.0",
   "description": "Split SDK",
   "files": [
     "README.md",
@@ -38,7 +38,7 @@
     "node": ">=14.0.0"
   },
   "dependencies": {
-    "@splitsoftware/splitio-commons": "2.4.2-rc.2",
+    "@splitsoftware/splitio-commons": "2.5.0-rc.0",
     "bloom-filters": "^3.0.4",
     "ioredis": "^4.28.0",
     "js-yaml": "^3.13.1",

package/src/factory/node.js

@@ -4,6 +4,7 @@ import { pushManagerFactory } from '@splitsoftware/splitio-commons/src/sync/stre
 import { pollingManagerSSFactory } from '@splitsoftware/splitio-commons/src/sync/polling/pollingManagerSS';
 import { InRedisStorage } from '@splitsoftware/splitio-commons/src/storages/inRedis';
 import { InMemoryStorageFactory } from '@splitsoftware/splitio-commons/src/storages/inMemory/InMemoryStorage';
+import { getCache } from '@splitsoftware/splitio-commons/src/storages/dataLoader';
 import { sdkManagerFactory } from '@splitsoftware/splitio-commons/src/sdkManager';
 import { sdkClientMethodFactory } from '@splitsoftware/splitio-commons/src/sdkClient/sdkClientMethod';
 import { impressionObserverSSFactory } from '@splitsoftware/splitio-commons/src/trackers/impressionObserver/impressionObserverSS';
@@ -48,7 +49,17 @@ function getModules(settings) {
 
     impressionsObserverFactory: impressionObserverSSFactory,
 
-    filterAdapterFactory: bloomFilterFactory
+    filterAdapterFactory: bloomFilterFactory,
+
+    extraProps: (params) => {
+      if (params.settings.mode !== CONSUMER_MODE) {
+        return {
+          getCache(userKeys) {
+            return getCache(params.settings.log, params.storage, userKeys);
+          }
+        };
+      }
+    }
   };
 
   switch (settings.mode) {

package/src/platform/getEventSource/eventsource.js

@@ -6,7 +6,7 @@ that accepts a custom agent.
 
 The MIT License
 
-Copyright (c) EventSource GitHub organization
+Copyright (c) EventSource GitHub organisation
 
 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.4.2-rc.2';
+export const packageVersion = '11.5.0-rc.0';

package/src/settings/storage/browser.js

@@ -12,8 +12,7 @@ export function validateStorage(settings) {
       options = {},
       prefix,
       expirationDays,
-      clearOnInit,
-      wrapper
+      clearOnInit
     } = { type: STORAGE_MEMORY },
   } = settings;
   let __originalType;
@@ -43,7 +42,6 @@ export function validateStorage(settings) {
     prefix,
     expirationDays,
     clearOnInit,
-    wrapper,
     __originalType
   };
 }