@splitsoftware/splitio 10.28.1-rc.4 → 11.0.0-rc.1

package/CHANGES.txt

@@ -1,9 +1,18 @@
-10.29.0 (September XX, 2024)
- - Added `factory.destroy()` method, which invokes the `destroy` method on all SDK clients created by the factory.
- - Updated @splitsoftware/splitio-commons package to version 1.18.0 that includes minor updates:
-    - Added support for targeting rules based on large segments for browsers.
-    - Updated some transitive dependencies for vulnerability fixes.
- - Bugfixing - Removed an overloaded `client` method in the `SplitIO.ISDK` interface that accepted a key and trafficType parameters. This interface corresponds to the SDK factory instance in NodeJS, which, unlike `SplitIO.IBrowserSDK` for the Browser, does not handle multiple client instances based on keys or traffic types.
+11.0.0 (October XX, 2024)
+ - Added support for targeting rules based on large segments for browsers.
+ - Added `factory.getState()` 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.
+ - Added `factory.destroy()` method, which invokes the `destroy` method of all clients created by the factory.
+ - Updated @splitsoftware/splitio-commons package to version 2.0.0 that includes major updates and updated some transitive dependencies for vulnerability fixes.
+ - Renamed distribution folders from `/lib` to `/cjs` for CommonJS build, and `/es` to `/esm` for EcmaScript Modules build.
+ - BREAKING CHANGES:
+    - Dropped support for NodeJS v6. The SDK now requires NodeJS v14 or above.
+    - Removed internal ponyfills for the `Map` and `Set` global objects, dropping support for IE and other outdated browsers. The SDK now requires the runtime environment to support these features natively or provide a polyfill.
+    - 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.
+    - TypeScript definitions:
+       - Removed an overloaded `client` method in the `SplitIO.ISDK` interface that accepted `key` and `trafficType` parameters. This interface corresponds to the SDK factory instance in NodeJS, which, unlike `SplitIO.IBrowserSDK` for the Browser, does not handle multiple client instances based on keys.
+       - Updated the `SplitIO.IBrowserSDK` and `SplitIO.IBrowserClient` interfaces to no longer extend the `SplitIO.ISDK` and `SplitIO.IClient` interfaces respectively, as the SDK factory instance in NodeJS or server-side (`SplitIO.ISDK`) has a different API than the SDK client instance in the Browser or client-side (`SplitIO.IBrowserClient`).
 
 10.28.0 (September 6, 2024)
  - Updated @splitsoftware/splitio-commons package to version 1.17.0 that includes minor updates:
@@ -514,7 +523,7 @@
  - Bugfixing - Return correct label when consulted Split is not found.
 
 9.1.1 (May 03, 2017)
- - Bugfixing - Fixed invalid behaviour when using native Fetch API and comparing statusText
+ - Bugfixing - Fixed invalid behavior when using native Fetch API and comparing statusText
   instead of resp.ok
 
 9.1.0 (April 21, 2017)

package/{lib → cjs}/factory/browser.js

@@ -8,19 +8,21 @@ var pollingManagerCS_1 = require("@splitsoftware/splitio-commons/cjs/sync/pollin
 var inLocalStorage_1 = require("@splitsoftware/splitio-commons/cjs/storages/inLocalStorage");
 var InMemoryStorageCS_1 = require("@splitsoftware/splitio-commons/cjs/storages/inMemory/InMemoryStorageCS");
 var sdkManager_1 = require("@splitsoftware/splitio-commons/cjs/sdkManager");
-var sdkClientMethodCSWithTT_1 = require("@splitsoftware/splitio-commons/cjs/sdkClient/sdkClientMethodCSWithTT");
+var sdkClientMethodCS_1 = require("@splitsoftware/splitio-commons/cjs/sdkClient/sdkClientMethodCS");
 var impressionObserverCS_1 = require("@splitsoftware/splitio-commons/cjs/trackers/impressionObserver/impressionObserverCS");
-var browser_1 = require("@splitsoftware/splitio-commons/cjs/integrations/browser");
+var storageCS_1 = require("@splitsoftware/splitio-commons/cjs/utils/settingsValidation/storage/storageCS");
 var sdkFactory_1 = require("@splitsoftware/splitio-commons/cjs/sdkFactory");
 var constants_1 = require("@splitsoftware/splitio-commons/cjs/utils/constants");
 var sdkUserConsent_1 = require("@splitsoftware/splitio-commons/cjs/consent/sdkUserConsent");
-var browser_2 = require("../settings/browser");
+var browser_1 = require("../settings/browser");
 var platform_1 = require("../platform");
 var syncManagerOnlineCSFactory = (0, syncManagerOnline_1.syncManagerOnlineFactory)(pollingManagerCS_1.pollingManagerCSFactory, pushManager_1.pushManagerFactory);
 function getStorage(settings) {
     return settings.storage.type === constants_1.STORAGE_LOCALSTORAGE ?
-        (0, inLocalStorage_1.InLocalStorage)(settings.storage) :
-        InMemoryStorageCS_1.InMemoryStorageCSFactory;
+        (0, inLocalStorage_1.InLocalStorage)(settings.storage)
+        : settings.storage.__originalType === constants_1.STORAGE_LOCALSTORAGE ?
+            storageCS_1.__InLocalStorageMockFactory
+            : InMemoryStorageCS_1.InMemoryStorageCSFactory;
 }
 /**
  *
@@ -34,9 +36,8 @@ function getModules(settings) {
         splitApiFactory: splitApi_1.splitApiFactory,
         syncManagerFactory: syncManagerOnlineCSFactory,
         sdkManagerFactory: sdkManager_1.sdkManagerFactory,
-        sdkClientMethodFactory: sdkClientMethodCSWithTT_1.sdkClientMethodCSFactory,
+        sdkClientMethodFactory: sdkClientMethodCS_1.sdkClientMethodCSFactory,
         SignalListener: platform_1.SignalListener,
-        integrationsManagerFactory: settings.integrations && settings.integrations.length > 0 ? browser_1.integrationsManagerFactory.bind(null, settings.integrations) : undefined,
         impressionsObserverFactory: impressionObserverCS_1.impressionObserverCSFactory,
         extraProps: function (params) {
             return {
@@ -62,7 +63,7 @@ function getModules(settings) {
  * @throws Will throw an error if the provided config is invalid.
  */
 function SplitFactory(config, __updateModules) {
-    var settings = (0, browser_2.settingsFactory)(config);
+    var settings = (0, browser_1.settingsFactory)(config);
     var modules = getModules(settings);
     if (__updateModules)
         __updateModules(modules);

package/{lib → cjs}/settings/browser.js

@@ -8,13 +8,11 @@ var LocalhostFromObject_1 = require("@splitsoftware/splitio-commons/cjs/sync/off
 var consent_1 = require("@splitsoftware/splitio-commons/cjs/utils/settingsValidation/consent");
 var browser_1 = require("./defaults/browser");
 var browser_2 = require("./storage/browser");
-var browser_3 = require("./integrations/browser");
 var params = {
     defaults: browser_1.defaults,
-    acceptKey: true, acceptTT: true,
+    acceptKey: true,
     runtime: runtime_1.validateRuntime,
     storage: browser_2.validateStorage,
-    integrations: browser_3.validateIntegrations,
     logger: builtinLogger_1.validateLogger,
     localhost: function () { return (0, LocalhostFromObject_1.LocalhostFromObject)(); },
     consent: consent_1.validateConsent,

package/{lib → cjs}/settings/defaults/version.js

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

package/{lib → cjs}/settings/storage/browser.js

@@ -5,18 +5,29 @@ 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, _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;
+    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;
+    var __originalType;
+    var fallbackToMemory = function () {
+        __originalType = type;
+        type = constants_1.STORAGE_MEMORY;
+    };
+    // In localhost mode, fallback to Memory storage and track original type to emit SDK_READY_FROM_CACHE if corresponds.
+    // ATM, other mode settings (e.g., 'consumer') are ignored in client-side API, and so treated as standalone.
+    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)()) {
-        type = constants_1.STORAGE_MEMORY;
+        fallbackToMemory();
         log.error('Invalid or unavailable storage. Fallback into MEMORY storage');
     }
     return {
         type: type,
         options: options,
         prefix: prefix,
+        __originalType: __originalType
     };
 }
 exports.validateStorage = validateStorage;

package/{lib → cjs}/sync/offline/splitsParserFromFile.js

@@ -27,7 +27,7 @@ function configFilesPath(configFilePath) {
     return configFilePath;
 }
 // This function is not pure nor meant to be. Here we apply modifications to cover
-// for behaviour that's ensured by the BE.
+// for behavior that's ensured by the BE.
 function arrangeConditions(mocksData) {
     // Iterate through each feature flag data
     (0, lang_1.forOwn)(mocksData, function (data) {

package/client/package.json

@@ -1,5 +1,5 @@
 {
-  "main": "../lib/factory/browser.js",
-  "module": "../es/factory/browser.js",
+  "main": "../cjs/factory/browser.js",
+  "module": "../esm/factory/browser.js",
   "types": "../types/client/index.d.ts"
 }

package/{es → esm}/factory/browser.js

@@ -5,9 +5,9 @@ import { pollingManagerCSFactory } from '@splitsoftware/splitio-commons/esm/sync
 import { InLocalStorage } from '@splitsoftware/splitio-commons/esm/storages/inLocalStorage';
 import { InMemoryStorageCSFactory } from '@splitsoftware/splitio-commons/esm/storages/inMemory/InMemoryStorageCS';
 import { sdkManagerFactory } from '@splitsoftware/splitio-commons/esm/sdkManager';
-import { sdkClientMethodCSFactory } from '@splitsoftware/splitio-commons/esm/sdkClient/sdkClientMethodCSWithTT';
+import { sdkClientMethodCSFactory } from '@splitsoftware/splitio-commons/esm/sdkClient/sdkClientMethodCS';
 import { impressionObserverCSFactory } from '@splitsoftware/splitio-commons/esm/trackers/impressionObserver/impressionObserverCS';
-import { integrationsManagerFactory } from '@splitsoftware/splitio-commons/esm/integrations/browser';
+import { __InLocalStorageMockFactory } from '@splitsoftware/splitio-commons/esm/utils/settingsValidation/storage/storageCS';
 import { sdkFactory } from '@splitsoftware/splitio-commons/esm/sdkFactory';
 import { LOCALHOST_MODE, STORAGE_LOCALSTORAGE } from '@splitsoftware/splitio-commons/esm/utils/constants';
 import { createUserConsentAPI } from '@splitsoftware/splitio-commons/esm/consent/sdkUserConsent';
@@ -16,8 +16,10 @@ import { platform, SignalListener } from '../platform';
 var syncManagerOnlineCSFactory = syncManagerOnlineFactory(pollingManagerCSFactory, pushManagerFactory);
 function getStorage(settings) {
     return settings.storage.type === STORAGE_LOCALSTORAGE ?
-        InLocalStorage(settings.storage) :
-        InMemoryStorageCSFactory;
+        InLocalStorage(settings.storage)
+        : settings.storage.__originalType === STORAGE_LOCALSTORAGE ?
+            __InLocalStorageMockFactory
+            : InMemoryStorageCSFactory;
 }
 /**
  *
@@ -33,7 +35,6 @@ function getModules(settings) {
         sdkManagerFactory: sdkManagerFactory,
         sdkClientMethodFactory: sdkClientMethodCSFactory,
         SignalListener: SignalListener,
-        integrationsManagerFactory: settings.integrations && settings.integrations.length > 0 ? integrationsManagerFactory.bind(null, settings.integrations) : undefined,
         impressionsObserverFactory: impressionObserverCSFactory,
         extraProps: function (params) {
             return {

package/{es → esm}/settings/browser.js

@@ -5,13 +5,11 @@ import { LocalhostFromObject } from '@splitsoftware/splitio-commons/esm/sync/off
 import { validateConsent } from '@splitsoftware/splitio-commons/esm/utils/settingsValidation/consent';
 import { defaults } from './defaults/browser';
 import { validateStorage } from './storage/browser';
-import { validateIntegrations } from './integrations/browser';
 var params = {
     defaults: defaults,
-    acceptKey: true, acceptTT: true,
+    acceptKey: true,
     runtime: validateRuntime,
     storage: validateStorage,
-    integrations: validateIntegrations,
     logger: validateLogger,
     localhost: function () { return LocalhostFromObject(); },
     consent: validateConsent,

package/esm/settings/defaults/version.js

@@ -0,0 +1 @@
+export var packageVersion = '11.0.0-rc.1';

package/esm/settings/storage/browser.js

@@ -0,0 +1,29 @@
+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;
+    var __originalType;
+    var fallbackToMemory = function () {
+        __originalType = type;
+        type = STORAGE_MEMORY;
+    };
+    // In localhost mode, fallback to Memory storage and track original type to emit SDK_READY_FROM_CACHE if corresponds.
+    // ATM, other mode settings (e.g., 'consumer') are ignored in client-side API, and so treated as standalone.
+    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()) {
+        fallbackToMemory();
+        log.error('Invalid or unavailable storage. Fallback into MEMORY storage');
+    }
+    return {
+        type: type,
+        options: options,
+        prefix: prefix,
+        __originalType: __originalType
+    };
+}

package/{es → esm}/sync/offline/splitsParserFromFile.js

@@ -23,7 +23,7 @@ function configFilesPath(configFilePath) {
     return configFilePath;
 }
 // This function is not pure nor meant to be. Here we apply modifications to cover
-// for behaviour that's ensured by the BE.
+// for behavior that's ensured by the BE.
 function arrangeConditions(mocksData) {
     // Iterate through each feature flag data
     forOwn(mocksData, function (data) {

package/package.json

@@ -1,17 +1,16 @@
 {
   "name": "@splitsoftware/splitio",
-  "version": "10.28.1-rc.4",
+  "version": "11.0.0-rc.1",
   "description": "Split SDK",
   "files": [
     "README.md",
     "CONTRIBUTORS-GUIDE.md",
     "LICENSE",
     "CHANGES.txt",
-    "lib",
+    "cjs",
     "types",
-    "es",
+    "esm",
     "src",
-    "scripts/ga-to-split-autorequire.js",
     "client",
     "server"
   ],
@@ -32,16 +31,14 @@
     "sdk",
     "javascript"
   ],
-  "main": "lib/index.js",
-  "module": "es/index.js",
+  "main": "cjs/index.js",
+  "module": "esm/index.js",
   "types": "types",
   "engines": {
-    "npm": ">=3",
-    "node": ">=6"
+    "node": ">=14.0.0"
   },
   "dependencies": {
-    "@splitsoftware/splitio-commons": "1.17.1-rc.3",
-    "@types/google.analytics": "0.0.40",
+    "@splitsoftware/splitio-commons": "2.0.0-rc.2",
     "@types/ioredis": "^4.28.0",
     "bloom-filters": "^3.0.0",
     "ioredis": "^4.28.0",
@@ -84,14 +81,13 @@
     "webpack-merge": "^5.8.0"
   },
   "scripts": {
-    "build-esm": "rimraf es && tsc -outDir es",
-    "postbuild-esm": "cross-env NODE_ENV=es node scripts/copy.packages.json.js && ./scripts/build_esm_replace_imports.sh",
+    "build-esm": "rimraf esm && tsc -outDir esm",
+    "postbuild-esm": "cross-env NODE_ENV=esm node scripts/copy.packages.json.js && ./scripts/build_esm_replace_imports.sh",
     "build-umd:stats": "webpack --progress --env production --json > ./stats/stat_results.json",
-    "build-cjs": "rimraf lib && tsc -outDir lib -m CommonJS",
+    "build-cjs": "rimraf cjs && tsc -outDir cjs -m CommonJS",
     "postbuild-cjs": "cross-env NODE_ENV=cjs node scripts/copy.packages.json.js && ./scripts/build_cjs_replace_imports.sh",
     "build-umd": "rimraf umd && webpack --config webpack.dev.js --env branch=$BUILD_BRANCH && webpack --config webpack.prod.js --env branch=$BUILD_BRANCH && ./scripts/clean_umd_build.sh",
     "build:npm": "npm run build-cjs && npm run build-esm",
-    "build:ga-to-split-autorequire": "terser ./node_modules/@splitsoftware/splitio-commons/src/integrations/ga/autoRequire.js --mangle --output ./scripts/ga-to-split-autorequire.js && cp ./scripts/ga-to-split-autorequire.js umd/ga-to-split-autorequire.js",
     "build": "npm run build-cjs && npm run build-esm && npm run build-umd",
     "check": "npm run check:lint && npm run check:version",
     "check:lint": "eslint src",
@@ -104,7 +100,6 @@
     "test-browser-e2e-destroy": "cross-env NODE_ENV=test karma start karma/e2e.destroy.karma.conf.js",
     "test-browser-e2e-errorCatching": "cross-env NODE_ENV=test karma start karma/e2e.errorCatching.karma.conf.js",
     "test-browser-e2e-push": "cross-env NODE_ENV=test karma start karma/e2e.push.karma.conf.js",
-    "test-browser-e2e-gaIntegration": "cross-env NODE_ENV=test karma start karma/e2e.gaIntegration.karma.conf.js",
     "test-node": "npm run test-node-unit && npm run test-node-e2e",
     "test-node-unit": "cross-env NODE_ENV=test tape -r ./ts-node.register \"src/*/**/__tests__/**/!(browser).spec.js\" | tap-min",
     "test-node-e2e": "npm run test-node-e2e-online && npm run test-node-e2e-offline && npm run test-node-e2e-destroy && npm run test-node-e2e-errorCatching && npm run test-node-e2e-push && npm run test-node-e2e-redis",

package/server/package.json

@@ -1,5 +1,5 @@
 {
-  "main": "../lib/factory/node.js",
-  "module": "../es/factory/node.js",
+  "main": "../cjs/factory/node.js",
+  "module": "../esm/factory/node.js",
   "types": "../types/server/index.d.ts"
 }

package/src/factory/browser.js

@@ -5,9 +5,9 @@ import { pollingManagerCSFactory } from '@splitsoftware/splitio-commons/src/sync
 import { InLocalStorage } from '@splitsoftware/splitio-commons/src/storages/inLocalStorage';
 import { InMemoryStorageCSFactory } from '@splitsoftware/splitio-commons/src/storages/inMemory/InMemoryStorageCS';
 import { sdkManagerFactory } from '@splitsoftware/splitio-commons/src/sdkManager';
-import { sdkClientMethodCSFactory } from '@splitsoftware/splitio-commons/src/sdkClient/sdkClientMethodCSWithTT';
+import { sdkClientMethodCSFactory } from '@splitsoftware/splitio-commons/src/sdkClient/sdkClientMethodCS';
 import { impressionObserverCSFactory } from '@splitsoftware/splitio-commons/src/trackers/impressionObserver/impressionObserverCS';
-import { integrationsManagerFactory } from '@splitsoftware/splitio-commons/src/integrations/browser';
+import { __InLocalStorageMockFactory } from '@splitsoftware/splitio-commons/src/utils/settingsValidation/storage/storageCS';
 import { sdkFactory } from '@splitsoftware/splitio-commons/src/sdkFactory';
 import { LOCALHOST_MODE, STORAGE_LOCALSTORAGE } from '@splitsoftware/splitio-commons/src/utils/constants';
 import { createUserConsentAPI } from '@splitsoftware/splitio-commons/src/consent/sdkUserConsent';
@@ -19,8 +19,10 @@ const syncManagerOnlineCSFactory = syncManagerOnlineFactory(pollingManagerCSFact
 
 function getStorage(settings) {
   return settings.storage.type === STORAGE_LOCALSTORAGE ?
-    InLocalStorage(settings.storage) :
-    InMemoryStorageCSFactory;
+    InLocalStorage(settings.storage)
+    : settings.storage.__originalType === STORAGE_LOCALSTORAGE ?
+      __InLocalStorageMockFactory
+      : InMemoryStorageCSFactory;
 }
 
 /**
@@ -46,8 +48,6 @@ function getModules(settings) {
 
     SignalListener,
 
-    integrationsManagerFactory: settings.integrations && settings.integrations.length > 0 ? integrationsManagerFactory.bind(null, settings.integrations) : undefined,
-
     impressionsObserverFactory: impressionObserverCSFactory,
 
     extraProps: (params) => {

package/src/settings/browser.js

@@ -6,14 +6,12 @@ import { validateConsent } from '@splitsoftware/splitio-commons/src/utils/settin
 
 import { defaults } from './defaults/browser';
 import { validateStorage } from './storage/browser';
-import { validateIntegrations } from './integrations/browser';
 
 const params = {
   defaults,
-  acceptKey: true, acceptTT: true, // Client with bound key and optional TT
+  acceptKey: true, // Client with bound key
   runtime: validateRuntime,
   storage: validateStorage,
-  integrations: validateIntegrations,
   logger: validateLogger,
   localhost: () => LocalhostFromObject(),
   consent: validateConsent,

package/src/settings/defaults/version.js

@@ -1 +1 @@
-export const packageVersion = '10.28.1-rc.4';
+export const packageVersion = '11.0.0-rc.1';

package/src/settings/storage/browser.js

@@ -1,23 +1,36 @@
 import { isLocalStorageAvailable } from '@splitsoftware/splitio-commons/src/utils/env/isLocalStorageAvailable';
-import { STORAGE_MEMORY } from '@splitsoftware/splitio-commons/src/utils/constants';
+import { LOCALHOST_MODE, STORAGE_MEMORY } from '@splitsoftware/splitio-commons/src/utils/constants';
 
 const STORAGE_LOCALSTORAGE = 'LOCALSTORAGE';
 
 export function validateStorage(settings) {
   let {
     log,
+    mode,
     storage: {
       type,
       options = {},
       prefix
     } = { type: STORAGE_MEMORY },
   } = settings;
+  let __originalType;
+
+  const fallbackToMemory = () => {
+    __originalType = type;
+    type = STORAGE_MEMORY;
+  };
+
+  // In localhost mode, fallback to Memory storage and track original type to emit SDK_READY_FROM_CACHE if corresponds.
+  // ATM, other mode settings (e.g., 'consumer') are ignored in client-side API, and so treated as standalone.
+  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()) {
-    type = STORAGE_MEMORY;
+    fallbackToMemory();
     log.error('Invalid or unavailable storage. Fallback into MEMORY storage');
   }
 
@@ -25,5 +38,6 @@ export function validateStorage(settings) {
     type,
     options,
     prefix,
+    __originalType
   };
 }

package/src/sync/offline/splitsParserFromFile.js

@@ -31,7 +31,7 @@ function configFilesPath(configFilePath) {
 }
 
 // This function is not pure nor meant to be. Here we apply modifications to cover
-// for behaviour that's ensured by the BE.
+// for behavior that's ensured by the BE.
 function arrangeConditions(mocksData) {
   // Iterate through each feature flag data
   forOwn(mocksData, data => {

package/types/client/index.d.ts

@@ -6,7 +6,7 @@ export = JsSdk;
 
 declare module JsSdk {
   /**
-   * Split.io sdk factory function.
+   * Split.io SDK factory function.
    * The settings parameter should be an object that complies with the SplitIO.IBrowserSettings.
    * For more information read the corresponding article: @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#configuration}
    */

package/types/index.d.ts

@@ -8,19 +8,19 @@ export = JsSdk;
 
 declare module JsSdk {
   /**
-   * Split.io sdk factory function.
+   * Split.io SDK factory function.
    * The settings parameter should be an object that complies with the SplitIO.INodeAsyncSettings.
    * For more information read the corresponding article: @see {@link https://help.split.io/hc/en-us/articles/360020564931-Node-js-SDK#configuration}
    */
   export function SplitFactory(settings: SplitIO.INodeAsyncSettings): SplitIO.IAsyncSDK;
   /**
-   * Split.io sdk factory function.
+   * Split.io SDK factory function.
    * The settings parameter should be an object that complies with the SplitIO.INodeSettings.
    * For more information read the corresponding article: @see {@link https://help.split.io/hc/en-us/articles/360020564931-Node-js-SDK#configuration}
    */
   export function SplitFactory(settings: SplitIO.INodeSettings): SplitIO.ISDK;
   /**
-   * Split.io sdk factory function.
+   * Split.io SDK factory function.
    * The settings parameter should be an object that complies with the SplitIO.IBrowserSettings.
    * For more information read the corresponding article: @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#configuration}
    */

package/types/server/index.d.ts

@@ -6,13 +6,13 @@ export = JsSdk;
 
 declare module JsSdk {
   /**
-   * Split.io sdk factory function.
+   * Split.io SDK factory function.
    * The settings parameter should be an object that complies with the SplitIO.INodeAsyncSettings.
    * For more information read the corresponding article: @see {@link https://help.split.io/hc/en-us/articles/360020564931-Node-js-SDK#configuration}
    */
   export function SplitFactory(settings: SplitIO.INodeAsyncSettings): SplitIO.IAsyncSDK;
   /**
-   * Split.io sdk factory function.
+   * Split.io SDK factory function.
    * The settings parameter should be an object that complies with the SplitIO.INodeSettings.
    * For more information read the corresponding article: @see {@link https://help.split.io/hc/en-us/articles/360020564931-Node-js-SDK#configuration}
    */