@splitsoftware/splitio-commons 1.4.2-rc.2 → 1.4.2-rc.5

package/CHANGES.txt

@@ -1,3 +1,6 @@
+1.6.0 (June XX, 2022)
+ - Added `autoRequire` configuration option to the Google Analytics to Split integration (See https://help.split.io/hc/en-us/articles/360040838752#set-up-with-gtm-and-gtag.js).
+
 1.5.0 (June 24, 2022)
 - Added a new config option to control the tasks that listen or poll for updates on feature flags and segments, via the new config sync.enabled . Running online Split will always pull the most recent updates upon initialization, this only affects updates fetching on a running instance. Useful when a consistent session experience is a must or to save resources when updates are not being used.
 - Updated telemetry logic to track the anonymous config for user consent flag set to declined or unknown.

package/cjs/integrations/ga/GaToSplit.js

@@ -10,23 +10,24 @@ var logNameMapper = 'ga-to-split:mapper';
 /**
  * Provides a plugin to use with analytics.js, accounting for the possibility
  * that the global command queue has been renamed or not yet defined.
- * @param {string} pluginName The plugin name identifier.
- * @param {Function} pluginConstructor The plugin constructor function.
+ * @param window Reference to global object.
+ * @param pluginName The plugin name identifier.
+ * @param pluginConstructor The plugin constructor function.
+ * @param log Logger instance.
+ * @param autoRequire If true, log error when auto-require script is not detected
  */
-function providePlugin(pluginName, pluginConstructor) {
+function providePlugin(window, pluginName, pluginConstructor, log, autoRequire) {
     // get reference to global command queue. Init it if not defined yet.
-    // @ts-expect-error
     var gaAlias = window.GoogleAnalyticsObject || 'ga';
     window[gaAlias] = window[gaAlias] || function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        (window[gaAlias].q = window[gaAlias].q || []).push(args);
+        (window[gaAlias].q = window[gaAlias].q || []).push(arguments);
     };
     // provides the plugin for use with analytics.js.
-    // @ts-expect-error
     window[gaAlias]('provide', pluginName, pluginConstructor);
+    if (autoRequire && (!window[gaAlias].q || window[gaAlias].q.push === [].push)) {
+        // Expecting spy on ga.q push method but not found
+        log.error(logPrefix + 'integration is configured to autorequire the splitTracker plugin, but the necessary script does not seem to have run.');
+    }
 }
 // Default mapping: object used for building the default mapper from hits to Split events
 var defaultMapping = {
@@ -246,6 +247,6 @@ function GaToSplit(sdkOptions, params) {
         return SplitTracker;
     }());
     // Register the plugin, even if config is invalid, since, if not provided, it will block `ga` command queue.
-    providePlugin('splitTracker', SplitTracker);
+    providePlugin(window, 'splitTracker', SplitTracker, log, sdkOptions.autoRequire);
 }
 exports.GaToSplit = GaToSplit;

package/cjs/sdkFactory/index.js

@@ -25,14 +25,13 @@ function sdkFactory(params) {
     (0, apiKey_1.validateAndTrackApiKey)(log, settings.core.authorizationKey);
     var sdkReadinessManager = (0, sdkReadinessManager_1.sdkReadinessManagerFactory)(log, platform.EventEmitter, settings.startup.readyTimeout);
     var readiness = sdkReadinessManager.readinessManager;
-    var matchingKey = (0, key_1.getMatching)(settings.core.key);
     // @TODO consider passing the settings object, so that each storage access only what it needs
     var storageFactoryParams = {
         impressionsQueueSize: settings.scheduler.impressionsQueueSize,
         eventsQueueSize: settings.scheduler.eventsQueueSize,
         optimize: (0, utils_1.shouldBeOptimized)(settings),
         // ATM, only used by InLocalStorage
-        matchingKey: matchingKey,
+        matchingKey: (0, key_1.getMatching)(settings.core.key),
         splitFiltersValidation: settings.sync.__splitFiltersValidation,
         // ATM, only used by PluggableStorage
         mode: settings.mode,
@@ -48,21 +47,7 @@ function sdkFactory(params) {
         log: log
     };
     var storage = storageFactory(storageFactoryParams);
-    // @TODO dataLoader requires validation
-    if (settings.dataLoader) {
-        settings.dataLoader(storage, matchingKey);
-        Promise.resolve(storage.splits.checkCache()).then(function (cacheReady) {
-            if (cacheReady) {
-                if (settings.sync.onlySubmitters) { // emit SDK_READY to not timeout when not synchronizing splits & segments
-                    readiness.splits.emit(constants_2.SDK_SPLITS_ARRIVED);
-                    readiness.segments.emit(constants_2.SDK_SEGMENTS_ARRIVED);
-                }
-                else { // emit SDK_READY_FROM_CACHE
-                    readiness.splits.emit(constants_2.SDK_SPLITS_CACHE_LOADED);
-                }
-            }
-        });
-    }
+    // @TODO add support for dataloader: `if (params.dataLoader) params.dataLoader(storage);`
     var integrationsManager = integrationsManagerFactory && integrationsManagerFactory({ settings: settings, storage: storage });
     // trackers
     var observer = impressionsObserverFactory && impressionsObserverFactory();
@@ -94,9 +79,6 @@ function sdkFactory(params) {
         // Logger wrapper API
         Logger: (0, sdkLogger_1.createLoggerAPI)(settings.log),
         settings: settings,
-        // @TODO remove
-        __storage: storage,
-        __ctx: ctx
     }, extraProps && extraProps(ctx));
 }
 exports.sdkFactory = sdkFactory;

package/cjs/storages/AbstractSplitsCacheSync.js

@@ -33,7 +33,7 @@ var AbstractSplitsCacheSync = /** @class */ (function () {
      * It is used as condition to emit SDK_SPLITS_CACHE_LOADED, and then SDK_READY_FROM_CACHE.
      */
     AbstractSplitsCacheSync.prototype.checkCache = function () {
-        return this.getChangeNumber() > -1;
+        return false;
     };
     /**
      * Kill `name` split and set `defaultTreatment` and `changeNumber`.

package/cjs/storages/dataLoader.js

@@ -1,27 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataLoaderFactory = void 0;
+exports.dataLoaderFactory = void 0;
 var browser_1 = require("../utils/constants/browser");
 /**
- * Factory of storage loader
+ * Factory of client-side storage loader
  *
  * @param preloadedData validated data following the format proposed in https://github.com/godaddy/split-javascript-data-loader
  * and extended with a `mySegmentsData` property.
  * @returns function to preload the storage
  */
-function DataLoaderFactory(preloadedData) {
+function dataLoaderFactory(preloadedData) {
     /**
      * Storage-agnostic adaptation of `loadDataIntoLocalStorage` function
      * (https://github.com/godaddy/split-javascript-data-loader/blob/master/src/load-data.js)
      *
      * @param storage object containing `splits` and `segments` cache (client-side variant)
-     * @param userKey user key (matching key) of the provided MySegmentsCache
+     * @param userId user key string of the provided MySegmentsCache
      *
+     * @TODO extend to support SegmentsCache (server-side variant) by making `userId` optional and adding the corresponding logic.
      * @TODO extend to load data on shared mySegments storages. Be specific when emitting SDK_READY_FROM_CACHE on shared clients. Maybe the serializer should provide the `useSegments` flag.
-     * @TODO add logs, and input validation in this module, in favor of size reduction.
-     * @TODO unit tests
      */
-    return function loadData(storage, userKey) {
+    return function loadData(storage, userId) {
         // Do not load data if current preloadedData is empty
         if (Object.keys(preloadedData).length === 0)
             return;
@@ -37,23 +36,16 @@ function DataLoaderFactory(preloadedData) {
         storage.splits.setChangeNumber(since);
         // splitsData in an object where the property is the split name and the pertaining value is a stringified json of its data
         storage.splits.addSplits(Object.keys(splitsData).map(function (splitName) { return [splitName, splitsData[splitName]]; }));
-        if (userKey) { // add mySegments data (client-side)
-            var mySegmentsData = preloadedData.mySegmentsData && preloadedData.mySegmentsData[userKey];
-            if (!mySegmentsData) {
-                // segmentsData in an object where the property is the segment name and the pertaining value is a stringified object that contains the `added` array of userIds
-                mySegmentsData = Object.keys(segmentsData).filter(function (segmentName) {
-                    var userKeys = segmentsData[segmentName];
-                    return userKeys.indexOf(userKey) > -1;
-                });
-            }
-            storage.segments.resetSegments(mySegmentsData);
-        }
-        else { // add segments data (server-side)
-            Object.keys(segmentsData).filter(function (segmentName) {
-                var userKeys = segmentsData[segmentName];
-                storage.segments.addToSegment(segmentName, userKeys);
+        // add mySegments data
+        var mySegmentsData = preloadedData.mySegmentsData && preloadedData.mySegmentsData[userId];
+        if (!mySegmentsData) {
+            // segmentsData in an object where the property is the segment name and the pertaining value is a stringified object that contains the `added` array of userIds
+            mySegmentsData = Object.keys(segmentsData).filter(function (segmentName) {
+                var userIds = JSON.parse(segmentsData[segmentName]).added;
+                return Array.isArray(userIds) && userIds.indexOf(userId) > -1;
             });
         }
+        storage.segments.resetSegments(mySegmentsData);
     };
 }
-exports.DataLoaderFactory = DataLoaderFactory;
+exports.dataLoaderFactory = dataLoaderFactory;

package/cjs/storages/inMemory/InMemoryStorage.js

@@ -8,7 +8,6 @@ var EventsCacheInMemory_1 = require("./EventsCacheInMemory");
 var ImpressionCountsCacheInMemory_1 = require("./ImpressionCountsCacheInMemory");
 var constants_1 = require("../../utils/constants");
 var TelemetryCacheInMemory_1 = require("./TelemetryCacheInMemory");
-var sets_1 = require("../../utils/lang/sets");
 /**
  * InMemory storage factory for standalone server-side SplitFactory
  *
@@ -29,20 +28,7 @@ function InMemoryStorageFactory(params) {
             this.impressions.clear();
             this.impressionCounts && this.impressionCounts.clear();
             this.events.clear();
-        },
-        // @ts-ignore, private method, for POC
-        getSnapshot: function () {
-            var _this = this;
-            return {
-                lastUpdated: Date.now(),
-                since: this.splits.changeNumber,
-                splitsData: this.splits.splitsCache,
-                segmentsData: Object.keys(this.segments.segmentCache).reduce(function (prev, cur) {
-                    prev[cur] = (0, sets_1.setToArray)(_this.segments.segmentCache[cur]);
-                    return prev;
-                }, {})
-            };
-        },
+        }
     };
 }
 exports.InMemoryStorageFactory = InMemoryStorageFactory;

package/cjs/storages/inMemory/InMemoryStorageCS.js

@@ -29,18 +29,6 @@ function InMemoryStorageCSFactory(params) {
             this.impressionCounts && this.impressionCounts.clear();
             this.events.clear();
         },
-        // @ts-ignore, private method, for POC
-        getSnapshot: function () {
-            var _a;
-            return {
-                lastUpdated: Date.now(),
-                since: this.splits.changeNumber,
-                splitsData: this.splits.splitsCache,
-                mySegmentsData: (_a = {},
-                    _a[params.matchingKey] = Object.keys(this.segments.segmentCache),
-                    _a)
-            };
-        },
         // When using shared instanciation with MEMORY we reuse everything but segments (they are unique per key)
         shared: function () {
             return {

package/cjs/sync/syncManagerOnline.js

@@ -19,9 +19,9 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
      * SyncManager factory for modular SDK
      */
     return function (params) {
-        var settings = params.settings, _a = params.settings, log = _a.log, streamingEnabled = _a.streamingEnabled, _b = _a.sync, syncEnabled = _b.enabled, onlySubmitters = _b.onlySubmitters, telemetryTracker = params.telemetryTracker;
+        var settings = params.settings, _a = params.settings, log = _a.log, streamingEnabled = _a.streamingEnabled, syncEnabled = _a.sync.enabled, telemetryTracker = params.telemetryTracker;
         /** Polling Manager */
-        var pollingManager = onlySubmitters ? undefined : pollingManagerFactory && pollingManagerFactory(params);
+        var pollingManager = pollingManagerFactory && pollingManagerFactory(params);
         /** Push Manager */
         var pushManager = syncEnabled && streamingEnabled && pollingManager && pushManagerFactory ?
             pushManagerFactory(params, pollingManager) :

package/cjs/trackers/impressionObserver/impressionObserverCS.js

@@ -5,7 +5,7 @@ var ImpressionObserver_1 = require("./ImpressionObserver");
 var murmur3_1 = require("../../utils/murmur3/murmur3");
 var buildKey_1 = require("./buildKey");
 function hashImpression32(impression) {
-    return (0, murmur3_1.hash)((0, buildKey_1.buildKey)(impression)).toString();
+    return (0, murmur3_1.hash)((0, buildKey_1.buildKey)(impression));
 }
 exports.hashImpression32 = hashImpression32;
 var LAST_SEEN_CACHE_SIZE = 500; // cache up to 500 impression hashes

package/cjs/utils/settingsValidation/index.js

@@ -127,9 +127,6 @@ function settingsValidation(config, validationParams) {
     // ensure a valid SDK mode
     // @ts-ignore, modify readonly prop
     withDefaults.mode = (0, mode_1.mode)(withDefaults.core.authorizationKey, withDefaults.mode);
-    if (withDefaults.sync.onlySubmitters && withDefaults.mode === constants_1.STANDALONE_MODE && !withDefaults.dataLoader) {
-        throw new Error('To use `onlySubmitters` param in standalone mode, DataLoader is required to preload data into the storage');
-    }
     // ensure a valid Storage based on mode defined.
     // @ts-ignore, modify readonly prop
     if (storage)
@@ -172,13 +169,9 @@ function settingsValidation(config, validationParams) {
         scheduler.pushRetryBackoffBase = fromSecondsToMillis(scheduler.pushRetryBackoffBase);
     }
     // validate sync enabled
-    if (withDefaults.sync.enabled !== false) {
+    if (withDefaults.sync.enabled !== false) { // @ts-ignore, modify readonly prop
         withDefaults.sync.enabled = true;
     }
-    // validate sync onlySubmitters
-    if (withDefaults.sync.onlySubmitters !== true) {
-        withDefaults.sync.onlySubmitters = false;
-    }
     // validate the `splitFilters` settings and parse splits query
     var splitFiltersValidation = (0, splitFilters_1.validateSplitFilters)(log, withDefaults.sync.splitFilters, withDefaults.mode);
     withDefaults.sync.splitFilters = splitFiltersValidation.validFilters;

package/esm/integrations/ga/GaToSplit.js

@@ -7,23 +7,24 @@ var logNameMapper = 'ga-to-split:mapper';
 /**
  * Provides a plugin to use with analytics.js, accounting for the possibility
  * that the global command queue has been renamed or not yet defined.
- * @param {string} pluginName The plugin name identifier.
- * @param {Function} pluginConstructor The plugin constructor function.
+ * @param window Reference to global object.
+ * @param pluginName The plugin name identifier.
+ * @param pluginConstructor The plugin constructor function.
+ * @param log Logger instance.
+ * @param autoRequire If true, log error when auto-require script is not detected
  */
-function providePlugin(pluginName, pluginConstructor) {
+function providePlugin(window, pluginName, pluginConstructor, log, autoRequire) {
     // get reference to global command queue. Init it if not defined yet.
-    // @ts-expect-error
     var gaAlias = window.GoogleAnalyticsObject || 'ga';
     window[gaAlias] = window[gaAlias] || function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        (window[gaAlias].q = window[gaAlias].q || []).push(args);
+        (window[gaAlias].q = window[gaAlias].q || []).push(arguments);
     };
     // provides the plugin for use with analytics.js.
-    // @ts-expect-error
     window[gaAlias]('provide', pluginName, pluginConstructor);
+    if (autoRequire && (!window[gaAlias].q || window[gaAlias].q.push === [].push)) {
+        // Expecting spy on ga.q push method but not found
+        log.error(logPrefix + 'integration is configured to autorequire the splitTracker plugin, but the necessary script does not seem to have run.');
+    }
 }
 // Default mapping: object used for building the default mapper from hits to Split events
 var defaultMapping = {
@@ -240,5 +241,5 @@ export function GaToSplit(sdkOptions, params) {
         return SplitTracker;
     }());
     // Register the plugin, even if config is invalid, since, if not provided, it will block `ga` command queue.
-    providePlugin('splitTracker', SplitTracker);
+    providePlugin(window, 'splitTracker', SplitTracker, log, sdkOptions.autoRequire);
 }

package/esm/sdkFactory/index.js

@@ -8,7 +8,7 @@ import { validateAndTrackApiKey } from '../utils/inputValidation/apiKey';
 import { createLoggerAPI } from '../logger/sdkLogger';
 import { NEW_FACTORY, RETRIEVE_MANAGER } from '../logger/constants';
 import { metadataBuilder } from '../storages/metadataBuilder';
-import { SDK_SPLITS_ARRIVED, SDK_SEGMENTS_ARRIVED, SDK_SPLITS_CACHE_LOADED } from '../readiness/constants';
+import { SDK_SPLITS_ARRIVED, SDK_SEGMENTS_ARRIVED } from '../readiness/constants';
 import { objectAssign } from '../utils/lang/objectAssign';
 /**
  * Modular SDK factory
@@ -22,14 +22,13 @@ export function sdkFactory(params) {
     validateAndTrackApiKey(log, settings.core.authorizationKey);
     var sdkReadinessManager = sdkReadinessManagerFactory(log, platform.EventEmitter, settings.startup.readyTimeout);
     var readiness = sdkReadinessManager.readinessManager;
-    var matchingKey = getMatching(settings.core.key);
     // @TODO consider passing the settings object, so that each storage access only what it needs
     var storageFactoryParams = {
         impressionsQueueSize: settings.scheduler.impressionsQueueSize,
         eventsQueueSize: settings.scheduler.eventsQueueSize,
         optimize: shouldBeOptimized(settings),
         // ATM, only used by InLocalStorage
-        matchingKey: matchingKey,
+        matchingKey: getMatching(settings.core.key),
         splitFiltersValidation: settings.sync.__splitFiltersValidation,
         // ATM, only used by PluggableStorage
         mode: settings.mode,
@@ -45,21 +44,7 @@ export function sdkFactory(params) {
         log: log
     };
     var storage = storageFactory(storageFactoryParams);
-    // @TODO dataLoader requires validation
-    if (settings.dataLoader) {
-        settings.dataLoader(storage, matchingKey);
-        Promise.resolve(storage.splits.checkCache()).then(function (cacheReady) {
-            if (cacheReady) {
-                if (settings.sync.onlySubmitters) { // emit SDK_READY to not timeout when not synchronizing splits & segments
-                    readiness.splits.emit(SDK_SPLITS_ARRIVED);
-                    readiness.segments.emit(SDK_SEGMENTS_ARRIVED);
-                }
-                else { // emit SDK_READY_FROM_CACHE
-                    readiness.splits.emit(SDK_SPLITS_CACHE_LOADED);
-                }
-            }
-        });
-    }
+    // @TODO add support for dataloader: `if (params.dataLoader) params.dataLoader(storage);`
     var integrationsManager = integrationsManagerFactory && integrationsManagerFactory({ settings: settings, storage: storage });
     // trackers
     var observer = impressionsObserverFactory && impressionsObserverFactory();
@@ -91,8 +76,5 @@ export function sdkFactory(params) {
         // Logger wrapper API
         Logger: createLoggerAPI(settings.log),
         settings: settings,
-        // @TODO remove
-        __storage: storage,
-        __ctx: ctx
     }, extraProps && extraProps(ctx));
 }

package/esm/storages/AbstractSplitsCacheSync.js

@@ -30,7 +30,7 @@ var AbstractSplitsCacheSync = /** @class */ (function () {
      * It is used as condition to emit SDK_SPLITS_CACHE_LOADED, and then SDK_READY_FROM_CACHE.
      */
     AbstractSplitsCacheSync.prototype.checkCache = function () {
-        return this.getChangeNumber() > -1;
+        return false;
     };
     /**
      * Kill `name` split and set `defaultTreatment` and `changeNumber`.

package/esm/storages/dataLoader.js

@@ -1,24 +1,23 @@
 import { DEFAULT_CACHE_EXPIRATION_IN_MILLIS } from '../utils/constants/browser';
 /**
- * Factory of storage loader
+ * Factory of client-side storage loader
  *
  * @param preloadedData validated data following the format proposed in https://github.com/godaddy/split-javascript-data-loader
  * and extended with a `mySegmentsData` property.
  * @returns function to preload the storage
  */
-export function DataLoaderFactory(preloadedData) {
+export function dataLoaderFactory(preloadedData) {
     /**
      * Storage-agnostic adaptation of `loadDataIntoLocalStorage` function
      * (https://github.com/godaddy/split-javascript-data-loader/blob/master/src/load-data.js)
      *
      * @param storage object containing `splits` and `segments` cache (client-side variant)
-     * @param userKey user key (matching key) of the provided MySegmentsCache
+     * @param userId user key string of the provided MySegmentsCache
      *
+     * @TODO extend to support SegmentsCache (server-side variant) by making `userId` optional and adding the corresponding logic.
      * @TODO extend to load data on shared mySegments storages. Be specific when emitting SDK_READY_FROM_CACHE on shared clients. Maybe the serializer should provide the `useSegments` flag.
-     * @TODO add logs, and input validation in this module, in favor of size reduction.
-     * @TODO unit tests
      */
-    return function loadData(storage, userKey) {
+    return function loadData(storage, userId) {
         // Do not load data if current preloadedData is empty
         if (Object.keys(preloadedData).length === 0)
             return;
@@ -34,22 +33,15 @@ export function DataLoaderFactory(preloadedData) {
         storage.splits.setChangeNumber(since);
         // splitsData in an object where the property is the split name and the pertaining value is a stringified json of its data
         storage.splits.addSplits(Object.keys(splitsData).map(function (splitName) { return [splitName, splitsData[splitName]]; }));
-        if (userKey) { // add mySegments data (client-side)
-            var mySegmentsData = preloadedData.mySegmentsData && preloadedData.mySegmentsData[userKey];
-            if (!mySegmentsData) {
-                // segmentsData in an object where the property is the segment name and the pertaining value is a stringified object that contains the `added` array of userIds
-                mySegmentsData = Object.keys(segmentsData).filter(function (segmentName) {
-                    var userKeys = segmentsData[segmentName];
-                    return userKeys.indexOf(userKey) > -1;
-                });
-            }
-            storage.segments.resetSegments(mySegmentsData);
-        }
-        else { // add segments data (server-side)
-            Object.keys(segmentsData).filter(function (segmentName) {
-                var userKeys = segmentsData[segmentName];
-                storage.segments.addToSegment(segmentName, userKeys);
+        // add mySegments data
+        var mySegmentsData = preloadedData.mySegmentsData && preloadedData.mySegmentsData[userId];
+        if (!mySegmentsData) {
+            // segmentsData in an object where the property is the segment name and the pertaining value is a stringified object that contains the `added` array of userIds
+            mySegmentsData = Object.keys(segmentsData).filter(function (segmentName) {
+                var userIds = JSON.parse(segmentsData[segmentName]).added;
+                return Array.isArray(userIds) && userIds.indexOf(userId) > -1;
             });
         }
+        storage.segments.resetSegments(mySegmentsData);
     };
 }

package/esm/storages/inMemory/InMemoryStorage.js

@@ -5,7 +5,6 @@ import { EventsCacheInMemory } from './EventsCacheInMemory';
 import { ImpressionCountsCacheInMemory } from './ImpressionCountsCacheInMemory';
 import { LOCALHOST_MODE, STORAGE_MEMORY } from '../../utils/constants';
 import { TelemetryCacheInMemory } from './TelemetryCacheInMemory';
-import { setToArray } from '../../utils/lang/sets';
 /**
  * InMemory storage factory for standalone server-side SplitFactory
  *
@@ -26,20 +25,7 @@ export function InMemoryStorageFactory(params) {
             this.impressions.clear();
             this.impressionCounts && this.impressionCounts.clear();
             this.events.clear();
-        },
-        // @ts-ignore, private method, for POC
-        getSnapshot: function () {
-            var _this = this;
-            return {
-                lastUpdated: Date.now(),
-                since: this.splits.changeNumber,
-                splitsData: this.splits.splitsCache,
-                segmentsData: Object.keys(this.segments.segmentCache).reduce(function (prev, cur) {
-                    prev[cur] = setToArray(_this.segments.segmentCache[cur]);
-                    return prev;
-                }, {})
-            };
-        },
+        }
     };
 }
 InMemoryStorageFactory.type = STORAGE_MEMORY;

package/esm/storages/inMemory/InMemoryStorageCS.js

@@ -26,18 +26,6 @@ export function InMemoryStorageCSFactory(params) {
             this.impressionCounts && this.impressionCounts.clear();
             this.events.clear();
         },
-        // @ts-ignore, private method, for POC
-        getSnapshot: function () {
-            var _a;
-            return {
-                lastUpdated: Date.now(),
-                since: this.splits.changeNumber,
-                splitsData: this.splits.splitsCache,
-                mySegmentsData: (_a = {},
-                    _a[params.matchingKey] = Object.keys(this.segments.segmentCache),
-                    _a)
-            };
-        },
         // When using shared instanciation with MEMORY we reuse everything but segments (they are unique per key)
         shared: function () {
             return {

package/esm/sync/syncManagerOnline.js

@@ -16,9 +16,9 @@ export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFacto
      * SyncManager factory for modular SDK
      */
     return function (params) {
-        var settings = params.settings, _a = params.settings, log = _a.log, streamingEnabled = _a.streamingEnabled, _b = _a.sync, syncEnabled = _b.enabled, onlySubmitters = _b.onlySubmitters, telemetryTracker = params.telemetryTracker;
+        var settings = params.settings, _a = params.settings, log = _a.log, streamingEnabled = _a.streamingEnabled, syncEnabled = _a.sync.enabled, telemetryTracker = params.telemetryTracker;
         /** Polling Manager */
-        var pollingManager = onlySubmitters ? undefined : pollingManagerFactory && pollingManagerFactory(params);
+        var pollingManager = pollingManagerFactory && pollingManagerFactory(params);
         /** Push Manager */
         var pushManager = syncEnabled && streamingEnabled && pollingManager && pushManagerFactory ?
             pushManagerFactory(params, pollingManager) :

package/esm/trackers/impressionObserver/impressionObserverCS.js

@@ -2,7 +2,7 @@ import { ImpressionObserver } from './ImpressionObserver';
 import { hash } from '../../utils/murmur3/murmur3';
 import { buildKey } from './buildKey';
 export function hashImpression32(impression) {
-    return hash(buildKey(impression)).toString();
+    return hash(buildKey(impression));
 }
 var LAST_SEEN_CACHE_SIZE = 500; // cache up to 500 impression hashes
 export function impressionObserverCSFactory() {

package/esm/utils/settingsValidation/index.js

@@ -124,9 +124,6 @@ export function settingsValidation(config, validationParams) {
     // ensure a valid SDK mode
     // @ts-ignore, modify readonly prop
     withDefaults.mode = mode(withDefaults.core.authorizationKey, withDefaults.mode);
-    if (withDefaults.sync.onlySubmitters && withDefaults.mode === STANDALONE_MODE && !withDefaults.dataLoader) {
-        throw new Error('To use `onlySubmitters` param in standalone mode, DataLoader is required to preload data into the storage');
-    }
     // ensure a valid Storage based on mode defined.
     // @ts-ignore, modify readonly prop
     if (storage)
@@ -169,13 +166,9 @@ export function settingsValidation(config, validationParams) {
         scheduler.pushRetryBackoffBase = fromSecondsToMillis(scheduler.pushRetryBackoffBase);
     }
     // validate sync enabled
-    if (withDefaults.sync.enabled !== false) {
+    if (withDefaults.sync.enabled !== false) { // @ts-ignore, modify readonly prop
         withDefaults.sync.enabled = true;
     }
-    // validate sync onlySubmitters
-    if (withDefaults.sync.onlySubmitters !== true) {
-        withDefaults.sync.onlySubmitters = false;
-    }
     // validate the `splitFilters` settings and parse splits query
     var splitFiltersValidation = validateSplitFilters(log, withDefaults.sync.splitFilters, withDefaults.mode);
     withDefaults.sync.splitFilters = splitFiltersValidation.validFilters;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio-commons",
-  "version": "1.4.2-rc.2",
+  "version": "1.4.2-rc.5",
   "description": "Split Javascript SDK common components",
   "main": "cjs/index.js",
   "module": "esm/index.js",

package/src/integrations/ga/GaToSplit.ts

@@ -19,20 +19,26 @@ const logNameMapper = 'ga-to-split:mapper';
 /**
  * Provides a plugin to use with analytics.js, accounting for the possibility
  * that the global command queue has been renamed or not yet defined.
- * @param {string} pluginName The plugin name identifier.
- * @param {Function} pluginConstructor The plugin constructor function.
+ * @param window Reference to global object.
+ * @param pluginName The plugin name identifier.
+ * @param pluginConstructor The plugin constructor function.
+ * @param log Logger instance.
+ * @param autoRequire If true, log error when auto-require script is not detected
  */
-function providePlugin(pluginName: string, pluginConstructor: Function) {
+function providePlugin(window: any, pluginName: string, pluginConstructor: Function, log: ILogger, autoRequire?: boolean) {
   // get reference to global command queue. Init it if not defined yet.
-  // @ts-expect-error
   const gaAlias = window.GoogleAnalyticsObject || 'ga';
-  window[gaAlias] = window[gaAlias] || function (...args: any[]) { // @ts-expect-error
-    (window[gaAlias].q = window[gaAlias].q || []).push(args);
+  window[gaAlias] = window[gaAlias] || function () {
+    (window[gaAlias].q = window[gaAlias].q || []).push(arguments);
   };
 
   // provides the plugin for use with analytics.js.
-  // @ts-expect-error
   window[gaAlias]('provide', pluginName, pluginConstructor);
+
+  if (autoRequire && (!window[gaAlias].q || window[gaAlias].q.push === [].push)) {
+    // Expecting spy on ga.q push method but not found
+    log.error(logPrefix + 'integration is configured to autorequire the splitTracker plugin, but the necessary script does not seem to have run.');
+  }
 }
 
 // Default mapping: object used for building the default mapper from hits to Split events
@@ -284,5 +290,5 @@ export function GaToSplit(sdkOptions: GoogleAnalyticsToSplitOptions, params: IIn
   }
 
   // Register the plugin, even if config is invalid, since, if not provided, it will block `ga` command queue.
-  providePlugin('splitTracker', SplitTracker);
+  providePlugin(window, 'splitTracker', SplitTracker, log, sdkOptions.autoRequire);
 }

package/src/integrations/ga/autoRequire.js

@@ -0,0 +1,33 @@
+/* eslint-disable no-undef */
+/**
+ * Auto-require script to use with GoogleAnalyticsToSplit integration
+ */
+(function (i, r, s) {
+  i[s] = i[s] || r;
+  i[r] = i[r] || function () { i[r].q.push(arguments); };
+  i[r].q = i[r].q || [];
+
+  var ts = {}; // Tracker names
+  function n(arg) { return typeof arg === 'object' && typeof arg.name === 'string' && arg.name; }
+
+  function p(v) { // Queue a `require` command if v is a `create` command
+    if (v && v[0] === 'create') {
+      var t = n(v[1]) || n(v[2]) || n(v[3]) || (typeof v[3] === 'string' ? v[3] : undefined); // Get tracker name
+
+      if (!ts[t]) {
+        ts[t] = true;
+        i[r]((t ? t + '.' : '') + 'require', 'splitTracker'); // Auto-require
+      }
+    }
+  }
+
+  i[r].q.forEach(function (v) { p(v); }); // Process already queued commands
+
+  var o = i[r].q.push;
+  i[r].q.push = function (v) { // Spy new queued commands
+    var result = o.apply(this, arguments);
+    p(v);
+    return result;
+  };
+
+})(window, 'ga', 'GoogleAnalyticsObject');

package/src/integrations/ga/types.ts

@@ -53,13 +53,24 @@ export interface GoogleAnalyticsToSplitOptions {
    * If not provided, events are sent using the key and traffic type provided at SDK config
    */
   identities?: Identity[],
+  /**
+   * Optional flag to log an error if the `auto-require` script is not detected.
+   * The auto-require script automatically requires the `splitTracker` plugin for created trackers,
+   * and should be placed right after your Google Analytics, GTM or gtag.js script tag.
+   *
+   * @see {@link https://help.split.io/hc/en-us/articles/360040838752#google-tag-manager}
+   *
+   * @property {boolean} autoRequire
+   * @default false
+   */
+  autoRequire?: boolean,
 }
 
 /**
  * Enable 'Google Analytics to Split' integration, to track Google Analytics hits as Split events.
  * Used by the browser variant of the isomorphic JS SDK.
  *
- * @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#google-analytics-to-split}
+ * @see {@link https://help.split.io/hc/en-us/articles/360040838752#google-analytics-to-split}
  */
 export interface IGoogleAnalyticsToSplitConfig extends GoogleAnalyticsToSplitOptions {
   type: 'GOOGLE_ANALYTICS_TO_SPLIT'
@@ -129,7 +140,7 @@ export interface SplitToGoogleAnalyticsOptions {
  * Enable 'Split to Google Analytics' integration, to track Split impressions and events as Google Analytics hits.
  * Used by the browser variant of the isomorphic JS SDK.
  *
- * @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#split-to-google-analytics}
+ * @see {@link https://help.split.io/hc/en-us/articles/360040838752#split-to-google-analytics}
  */
 export interface ISplitToGoogleAnalyticsConfig extends SplitToGoogleAnalyticsOptions {
   type: 'SPLIT_TO_GOOGLE_ANALYTICS'

package/src/sdkFactory/index.ts

@@ -3,7 +3,7 @@ import { sdkReadinessManagerFactory } from '../readiness/sdkReadinessManager';
 import { impressionsTrackerFactory } from '../trackers/impressionsTracker';
 import { eventTrackerFactory } from '../trackers/eventTracker';
 import { telemetryTrackerFactory } from '../trackers/telemetryTracker';
-import { IStorageFactoryParams, IStorageSync } from '../storages/types';
+import { IStorageFactoryParams } from '../storages/types';
 import { SplitIO } from '../types';
 import { getMatching } from '../utils/key';
 import { shouldBeOptimized } from '../trackers/impressionObserver/utils';
@@ -11,7 +11,7 @@ import { validateAndTrackApiKey } from '../utils/inputValidation/apiKey';
 import { createLoggerAPI } from '../logger/sdkLogger';
 import { NEW_FACTORY, RETRIEVE_MANAGER } from '../logger/constants';
 import { metadataBuilder } from '../storages/metadataBuilder';
-import { SDK_SPLITS_ARRIVED, SDK_SEGMENTS_ARRIVED, SDK_SPLITS_CACHE_LOADED } from '../readiness/constants';
+import { SDK_SPLITS_ARRIVED, SDK_SEGMENTS_ARRIVED } from '../readiness/constants';
 import { objectAssign } from '../utils/lang/objectAssign';
 
 /**
@@ -32,7 +32,6 @@ export function sdkFactory(params: ISdkFactoryParams): SplitIO.ICsSDK | SplitIO.
 
   const sdkReadinessManager = sdkReadinessManagerFactory(log, platform.EventEmitter, settings.startup.readyTimeout);
   const readiness = sdkReadinessManager.readinessManager;
-  const matchingKey = getMatching(settings.core.key);
 
   // @TODO consider passing the settings object, so that each storage access only what it needs
   const storageFactoryParams: IStorageFactoryParams = {
@@ -41,7 +40,7 @@ export function sdkFactory(params: ISdkFactoryParams): SplitIO.ICsSDK | SplitIO.
     optimize: shouldBeOptimized(settings),
 
     // ATM, only used by InLocalStorage
-    matchingKey,
+    matchingKey: getMatching(settings.core.key),
     splitFiltersValidation: settings.sync.__splitFiltersValidation,
 
     // ATM, only used by PluggableStorage
@@ -59,21 +58,7 @@ export function sdkFactory(params: ISdkFactoryParams): SplitIO.ICsSDK | SplitIO.
   };
 
   const storage = storageFactory(storageFactoryParams);
-
-  // @TODO dataLoader requires validation
-  if (settings.dataLoader) {
-    settings.dataLoader(storage as IStorageSync, matchingKey);
-    Promise.resolve(storage.splits.checkCache()).then(cacheReady => {
-      if (cacheReady) {
-        if (settings.sync.onlySubmitters) { // emit SDK_READY to not timeout when not synchronizing splits & segments
-          readiness.splits.emit(SDK_SPLITS_ARRIVED);
-          readiness.segments.emit(SDK_SEGMENTS_ARRIVED);
-        } else { // emit SDK_READY_FROM_CACHE
-          readiness.splits.emit(SDK_SPLITS_CACHE_LOADED);
-        }
-      }
-    });
-  }
+  // @TODO add support for dataloader: `if (params.dataLoader) params.dataLoader(storage);`
 
   const integrationsManager = integrationsManagerFactory && integrationsManagerFactory({ settings, storage });
 
@@ -118,9 +103,5 @@ export function sdkFactory(params: ISdkFactoryParams): SplitIO.ICsSDK | SplitIO.
     Logger: createLoggerAPI(settings.log),
 
     settings,
-
-    // @TODO remove
-    __storage: storage,
-    __ctx: ctx
   }, extraProps && extraProps(ctx));
 }

package/src/storages/AbstractSplitsCacheSync.ts

@@ -50,7 +50,7 @@ export abstract class AbstractSplitsCacheSync implements ISplitsCacheSync {
    * It is used as condition to emit SDK_SPLITS_CACHE_LOADED, and then SDK_READY_FROM_CACHE.
    */
   checkCache(): boolean {
-    return this.getChangeNumber() > -1;
+    return false;
   }
 
   /**

package/src/storages/dataLoader.ts

@@ -3,26 +3,25 @@ import { DEFAULT_CACHE_EXPIRATION_IN_MILLIS } from '../utils/constants/browser';
 import { DataLoader, ISegmentsCacheSync, ISplitsCacheSync } from './types';
 
 /**
- * Factory of storage loader
+ * Factory of client-side storage loader
  *
  * @param preloadedData validated data following the format proposed in https://github.com/godaddy/split-javascript-data-loader
  * and extended with a `mySegmentsData` property.
  * @returns function to preload the storage
  */
-export function DataLoaderFactory(preloadedData: SplitIO.PreloadedData): DataLoader {
+export function dataLoaderFactory(preloadedData: SplitIO.PreloadedData): DataLoader {
 
   /**
    * Storage-agnostic adaptation of `loadDataIntoLocalStorage` function
    * (https://github.com/godaddy/split-javascript-data-loader/blob/master/src/load-data.js)
    *
    * @param storage object containing `splits` and `segments` cache (client-side variant)
-   * @param userKey user key (matching key) of the provided MySegmentsCache
+   * @param userId user key string of the provided MySegmentsCache
    *
+   * @TODO extend to support SegmentsCache (server-side variant) by making `userId` optional and adding the corresponding logic.
    * @TODO extend to load data on shared mySegments storages. Be specific when emitting SDK_READY_FROM_CACHE on shared clients. Maybe the serializer should provide the `useSegments` flag.
-   * @TODO add logs, and input validation in this module, in favor of size reduction.
-   * @TODO unit tests
    */
-  return function loadData(storage: { splits: ISplitsCacheSync, segments: ISegmentsCacheSync }, userKey?: string) {
+  return function loadData(storage: { splits: ISplitsCacheSync, segments: ISegmentsCacheSync }, userId: string) {
     // Do not load data if current preloadedData is empty
     if (Object.keys(preloadedData).length === 0) return;
 
@@ -42,21 +41,15 @@ export function DataLoaderFactory(preloadedData: SplitIO.PreloadedData): DataLoa
     // splitsData in an object where the property is the split name and the pertaining value is a stringified json of its data
     storage.splits.addSplits(Object.keys(splitsData).map(splitName => [splitName, splitsData[splitName]]));
 
-    if (userKey) { // add mySegments data (client-side)
-      let mySegmentsData = preloadedData.mySegmentsData && preloadedData.mySegmentsData[userKey];
-      if (!mySegmentsData) {
-        // segmentsData in an object where the property is the segment name and the pertaining value is a stringified object that contains the `added` array of userIds
-        mySegmentsData = Object.keys(segmentsData).filter(segmentName => {
-          const userKeys = segmentsData[segmentName];
-          return userKeys.indexOf(userKey) > -1;
-        });
-      }
-      storage.segments.resetSegments(mySegmentsData);
-    } else { // add segments data (server-side)
-      Object.keys(segmentsData).filter(segmentName => {
-        const userKeys = segmentsData[segmentName];
-        storage.segments.addToSegment(segmentName, userKeys);
+    // add mySegments data
+    let mySegmentsData = preloadedData.mySegmentsData && preloadedData.mySegmentsData[userId];
+    if (!mySegmentsData) {
+      // segmentsData in an object where the property is the segment name and the pertaining value is a stringified object that contains the `added` array of userIds
+      mySegmentsData = Object.keys(segmentsData).filter(segmentName => {
+        const userIds = JSON.parse(segmentsData[segmentName]).added;
+        return Array.isArray(userIds) && userIds.indexOf(userId) > -1;
       });
     }
+    storage.segments.resetSegments(mySegmentsData);
   };
 }

package/src/storages/inMemory/InMemoryStorage.ts

@@ -6,8 +6,6 @@ import { IStorageFactoryParams, IStorageSync } from '../types';
 import { ImpressionCountsCacheInMemory } from './ImpressionCountsCacheInMemory';
 import { LOCALHOST_MODE, STORAGE_MEMORY } from '../../utils/constants';
 import { TelemetryCacheInMemory } from './TelemetryCacheInMemory';
-import { SplitIO } from '../../types';
-import { setToArray, ISet } from '../../utils/lang/sets';
 
 /**
  * InMemory storage factory for standalone server-side SplitFactory
@@ -31,20 +29,7 @@ export function InMemoryStorageFactory(params: IStorageFactoryParams): IStorageS
       this.impressions.clear();
       this.impressionCounts && this.impressionCounts.clear();
       this.events.clear();
-    },
-
-    // @ts-ignore, private method, for POC
-    getSnapshot(): SplitIO.PreloadedData {
-      return {
-        lastUpdated: Date.now(), // @ts-ignore accessing private prop
-        since: this.splits.changeNumber, // @ts-ignore accessing private prop
-        splitsData: this.splits.splitsCache, // @ts-ignore accessing private prop
-        segmentsData: Object.keys(this.segments.segmentCache).reduce((prev, cur) => { // @ts-ignore accessing private prop
-          prev[cur] = setToArray(this.segments.segmentCache[cur] as ISet<string>);
-          return prev;
-        }, {})
-      };
-    },
+    }
   };
 }
 

package/src/storages/inMemory/InMemoryStorageCS.ts

@@ -6,7 +6,6 @@ import { IStorageSync, IStorageFactoryParams } from '../types';
 import { ImpressionCountsCacheInMemory } from './ImpressionCountsCacheInMemory';
 import { LOCALHOST_MODE, STORAGE_MEMORY } from '../../utils/constants';
 import { shouldRecordTelemetry, TelemetryCacheInMemory } from './TelemetryCacheInMemory';
-import { SplitIO } from '../../types';
 
 /**
  * InMemory storage factory for standalone client-side SplitFactory
@@ -32,18 +31,6 @@ export function InMemoryStorageCSFactory(params: IStorageFactoryParams): IStorag
       this.events.clear();
     },
 
-    // @ts-ignore, private method, for POC
-    getSnapshot(): SplitIO.PreloadedData {
-      return {
-        lastUpdated: Date.now(), // @ts-ignore accessing private prop
-        since: this.splits.changeNumber, // @ts-ignore accessing private prop
-        splitsData: this.splits.splitsCache,
-        mySegmentsData: { // @ts-ignore accessing private prop
-          [params.matchingKey as string]: Object.keys(this.segments.segmentCache)
-        }
-      };
-    },
-
     // When using shared instanciation with MEMORY we reuse everything but segments (they are unique per key)
     shared() {
       return {

package/src/sync/syncManagerOnline.ts

@@ -28,10 +28,10 @@ export function syncManagerOnlineFactory(
    */
   return function (params: ISdkFactoryContextSync): ISyncManagerCS {
 
-    const { settings, settings: { log, streamingEnabled, sync: { enabled: syncEnabled, onlySubmitters } },  telemetryTracker } = params;
+    const { settings, settings: { log, streamingEnabled, sync: { enabled: syncEnabled } },  telemetryTracker } = params;
 
     /** Polling Manager */
-    const pollingManager = onlySubmitters ? undefined : pollingManagerFactory && pollingManagerFactory(params);
+    const pollingManager = pollingManagerFactory && pollingManagerFactory(params);
 
     /** Push Manager */
     const pushManager = syncEnabled && streamingEnabled && pollingManager && pushManagerFactory ?

package/src/trackers/impressionObserver/impressionObserverCS.ts

@@ -4,7 +4,7 @@ import { buildKey } from './buildKey';
 import { ImpressionDTO } from '../../types';
 
 export function hashImpression32(impression: ImpressionDTO) {
-  return hash(buildKey(impression)).toString();
+  return hash(buildKey(impression));
 }
 
 const LAST_SEEN_CACHE_SIZE = 500; // cache up to 500 impression hashes

package/src/types.ts

@@ -4,7 +4,7 @@ import { ILogger } from './logger/types';
 import { ISdkFactoryContext } from './sdkFactory/types';
 /* eslint-disable no-use-before-define */
 
-import { IStorageFactoryParams, IStorageSync, IStorageAsync, IStorageSyncFactory, IStorageAsyncFactory, DataLoader } from './storages/types';
+import { IStorageFactoryParams, IStorageSync, IStorageAsync, IStorageSyncFactory, IStorageAsyncFactory } from './storages/types';
 import { ISyncManagerCS } from './sync/types';
 
 /**
@@ -98,7 +98,6 @@ export interface ISettings {
     eventsFirstPushWindow: number
   },
   readonly storage: IStorageSyncFactory | IStorageAsyncFactory,
-  readonly dataLoader?: DataLoader,
   readonly integrations: Array<{
     readonly type: string,
     (params: IIntegrationFactoryParams): IIntegration | void
@@ -119,8 +118,7 @@ export interface ISettings {
     impressionsMode: SplitIO.ImpressionsMode,
     __splitFiltersValidation: ISplitFiltersValidation,
     localhostMode?: SplitIO.LocalhostFactory,
-    enabled: boolean,
-    onlySubmitters: boolean
+    enabled: boolean
   },
   readonly runtime: {
     ip: string | false
@@ -754,7 +752,7 @@ export namespace SplitIO {
      * This property is ignored if `mySegmentsData` was provided.
      */
     segmentsData?: {
-      [segmentName: string]: string[]
+      [segmentName: string]: string
     },
   }
   /**

package/src/utils/settingsValidation/index.ts

@@ -147,9 +147,6 @@ export function settingsValidation(config: unknown, validationParams: ISettingsV
   // ensure a valid SDK mode
   // @ts-ignore, modify readonly prop
   withDefaults.mode = mode(withDefaults.core.authorizationKey, withDefaults.mode);
-  if (withDefaults.sync.onlySubmitters && withDefaults.mode === STANDALONE_MODE && !withDefaults.dataLoader) {
-    throw new Error('To use `onlySubmitters` param in standalone mode, DataLoader is required to preload data into the storage');
-  }
 
   // ensure a valid Storage based on mode defined.
   // @ts-ignore, modify readonly prop
@@ -196,15 +193,10 @@ export function settingsValidation(config: unknown, validationParams: ISettingsV
   }
 
   // validate sync enabled
-  if (withDefaults.sync.enabled !== false) {
+  if (withDefaults.sync.enabled !== false) { // @ts-ignore, modify readonly prop
     withDefaults.sync.enabled = true;
   }
 
-  // validate sync onlySubmitters
-  if (withDefaults.sync.onlySubmitters !== true) {
-    withDefaults.sync.onlySubmitters = false;
-  }
-
   // validate the `splitFilters` settings and parse splits query
   const splitFiltersValidation = validateSplitFilters(log, withDefaults.sync.splitFilters, withDefaults.mode);
   withDefaults.sync.splitFilters = splitFiltersValidation.validFilters;

package/types/integrations/ga/types.d.ts

@@ -52,12 +52,23 @@ export interface GoogleAnalyticsToSplitOptions {
      * If not provided, events are sent using the key and traffic type provided at SDK config
      */
     identities?: Identity[];
+    /**
+     * Optional flag to log an error if the `auto-require` script is not detected.
+     * The auto-require script automatically requires the `splitTracker` plugin for created trackers,
+     * and should be placed right after your Google Analytics, GTM or gtag.js script tag.
+     *
+     * @see {@link https://help.split.io/hc/en-us/articles/360040838752#google-tag-manager}
+     *
+     * @property {boolean} autoRequire
+     * @default false
+     */
+    autoRequire?: boolean;
 }
 /**
  * Enable 'Google Analytics to Split' integration, to track Google Analytics hits as Split events.
  * Used by the browser variant of the isomorphic JS SDK.
  *
- * @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#google-analytics-to-split}
+ * @see {@link https://help.split.io/hc/en-us/articles/360040838752#google-analytics-to-split}
  */
 export interface IGoogleAnalyticsToSplitConfig extends GoogleAnalyticsToSplitOptions {
     type: 'GOOGLE_ANALYTICS_TO_SPLIT';
@@ -125,7 +136,7 @@ export interface SplitToGoogleAnalyticsOptions {
  * Enable 'Split to Google Analytics' integration, to track Split impressions and events as Google Analytics hits.
  * Used by the browser variant of the isomorphic JS SDK.
  *
- * @see {@link https://help.split.io/hc/en-us/articles/360020448791-JavaScript-SDK#split-to-google-analytics}
+ * @see {@link https://help.split.io/hc/en-us/articles/360040838752#split-to-google-analytics}
  */
 export interface ISplitToGoogleAnalyticsConfig extends SplitToGoogleAnalyticsOptions {
     type: 'SPLIT_TO_GOOGLE_ANALYTICS';

package/types/storages/dataLoader.d.ts

@@ -1,10 +1,10 @@
 import { SplitIO } from '../types';
 import { DataLoader } from './types';
 /**
- * Factory of storage loader
+ * Factory of client-side storage loader
  *
  * @param preloadedData validated data following the format proposed in https://github.com/godaddy/split-javascript-data-loader
  * and extended with a `mySegmentsData` property.
  * @returns function to preload the storage
  */
-export declare function DataLoaderFactory(preloadedData: SplitIO.PreloadedData): DataLoader;
+export declare function dataLoaderFactory(preloadedData: SplitIO.PreloadedData): DataLoader;

package/types/trackers/impressionObserver/impressionObserverCS.d.ts

@@ -1,4 +1,4 @@
 import { ImpressionObserver } from './ImpressionObserver';
 import { ImpressionDTO } from '../../types';
-export declare function hashImpression32(impression: ImpressionDTO): string;
-export declare function impressionObserverCSFactory(): ImpressionObserver<string>;
+export declare function hashImpression32(impression: ImpressionDTO): number;
+export declare function impressionObserverCSFactory(): ImpressionObserver<number>;

package/types/types.d.ts

@@ -2,7 +2,7 @@ import { ISplitFiltersValidation } from './dtos/types';
 import { IIntegration, IIntegrationFactoryParams } from './integrations/types';
 import { ILogger } from './logger/types';
 import { ISdkFactoryContext } from './sdkFactory/types';
-import { IStorageFactoryParams, IStorageSync, IStorageAsync, IStorageSyncFactory, IStorageAsyncFactory, DataLoader } from './storages/types';
+import { IStorageFactoryParams, IStorageSync, IStorageAsync, IStorageSyncFactory, IStorageAsyncFactory } from './storages/types';
 import { ISyncManagerCS } from './sync/types';
 /**
  * Reduced version of NodeJS.EventEmitter interface with the minimal methods used by the SDK
@@ -92,7 +92,6 @@ export interface ISettings {
         eventsFirstPushWindow: number;
     };
     readonly storage: IStorageSyncFactory | IStorageAsyncFactory;
-    readonly dataLoader?: DataLoader;
     readonly integrations: Array<{
         readonly type: string;
         (params: IIntegrationFactoryParams): IIntegration | void;
@@ -114,7 +113,6 @@ export interface ISettings {
         __splitFiltersValidation: ISplitFiltersValidation;
         localhostMode?: SplitIO.LocalhostFactory;
         enabled: boolean;
-        onlySubmitters: boolean;
     };
     readonly runtime: {
         ip: string | false;
@@ -751,7 +749,7 @@ export declare namespace SplitIO {
          * This property is ignored if `mySegmentsData` was provided.
          */
         segmentsData?: {
-            [segmentName: string]: string[];
+            [segmentName: string]: string;
         };
     }
     /**