@splitsoftware/splitio-commons 0.1.1-canary.6 → 0.1.1-rc.18

package/esm/sync/streaming/UpdateWorkers/MySegmentsUpdateWorker.js

@@ -10,7 +10,7 @@ var MySegmentsUpdateWorker = /** @class */ (function () {
         this.mySegmentsSyncTask = mySegmentsSyncTask;
         this.maxChangeNumber = 0; // keeps the maximum changeNumber among queued events
         this.handleNewEvent = false;
-        this.segmentList = undefined; // keeps the segmentList (if included in payload) from the queued event with maximum changeNumber
+        this.segmentsData = undefined; // keeps the segmentsData (if included in notification payload) from the queued event with maximum changeNumber
         this.currentChangeNumber = -1; // @TODO: remove once `/mySegments` endpoint provides the changeNumber
         this.put = this.put.bind(this);
         this.__handleMySegmentsUpdateCall = this.__handleMySegmentsUpdateCall.bind(this);
@@ -24,7 +24,7 @@ var MySegmentsUpdateWorker = /** @class */ (function () {
             this.handleNewEvent = false;
             var currentMaxChangeNumber_1 = this.maxChangeNumber;
             // fetch mySegments revalidating data if cached
-            this.mySegmentsSyncTask.execute(this.segmentList, true).then(function (result) {
+            this.mySegmentsSyncTask.execute(this.segmentsData, true).then(function (result) {
                 if (result !== false) // Unlike `Splits|SegmentsUpdateWorker`, we cannot use `mySegmentsCache.getChangeNumber` since `/mySegments` endpoint doesn't provide this value.
                     _this.currentChangeNumber = Math.max(_this.currentChangeNumber, currentMaxChangeNumber_1); // use `currentMaxChangeNumber`, in case that `this.maxChangeNumber` was updated during fetch.
                 if (_this.handleNewEvent) {
@@ -40,15 +40,15 @@ var MySegmentsUpdateWorker = /** @class */ (function () {
      * Invoked by NotificationProcessor on MY_SEGMENTS_UPDATE event
      *
      * @param {number} changeNumber change number of the MY_SEGMENTS_UPDATE notification
-     * @param {string[] | undefined} segmentList might be undefined
+     * @param {SegmentsData | undefined} segmentsData might be undefined
      */
-    MySegmentsUpdateWorker.prototype.put = function (changeNumber, segmentList) {
+    MySegmentsUpdateWorker.prototype.put = function (changeNumber, segmentsData) {
         if (changeNumber <= this.currentChangeNumber || changeNumber <= this.maxChangeNumber)
             return;
         this.maxChangeNumber = changeNumber;
         this.handleNewEvent = true;
         this.backoff.reset();
-        this.segmentList = segmentList;
+        this.segmentsData = segmentsData;
         if (this.mySegmentsSyncTask.isExecuting())
             return;
         this.__handleMySegmentsUpdateCall();

package/esm/sync/streaming/UpdateWorkers/SegmentsUpdateWorker.js

@@ -54,7 +54,8 @@ var SegmentsUpdateWorker = /** @class */ (function () {
      * @param {number} changeNumber change number of the SEGMENT_UPDATE notification
      * @param {string} segmentName segment name of the SEGMENT_UPDATE notification
      */
-    SegmentsUpdateWorker.prototype.put = function (changeNumber, segmentName) {
+    SegmentsUpdateWorker.prototype.put = function (_a) {
+        var changeNumber = _a.changeNumber, segmentName = _a.segmentName;
         var currentChangeNumber = this.segmentsCache.getChangeNumber(segmentName);
         if (changeNumber <= currentChangeNumber || changeNumber <= this.maxChangeNumbers[segmentName])
             return;

package/esm/sync/streaming/UpdateWorkers/SplitsUpdateWorker.js

@@ -46,7 +46,8 @@ var SplitsUpdateWorker = /** @class */ (function () {
      *
      * @param {number} changeNumber change number of the SPLIT_UPDATE notification
      */
-    SplitsUpdateWorker.prototype.put = function (changeNumber) {
+    SplitsUpdateWorker.prototype.put = function (_a) {
+        var changeNumber = _a.changeNumber;
         var currentChangeNumber = this.splitsCache.getChangeNumber();
         if (changeNumber <= currentChangeNumber || changeNumber <= this.maxChangeNumber)
             return;
@@ -64,14 +65,15 @@ var SplitsUpdateWorker = /** @class */ (function () {
      * @param {string} splitName name of split to kill
      * @param {string} defaultTreatment default treatment value
      */
-    SplitsUpdateWorker.prototype.killSplit = function (changeNumber, splitName, defaultTreatment) {
+    SplitsUpdateWorker.prototype.killSplit = function (_a) {
+        var changeNumber = _a.changeNumber, splitName = _a.splitName, defaultTreatment = _a.defaultTreatment;
         // @TODO handle retry due to errors in storage, once we allow the definition of custom async storages
         if (this.splitsCache.killLocally(splitName, defaultTreatment, changeNumber)) {
             // trigger an SDK_UPDATE if Split was killed locally
             this.splitsEventEmitter.emit(SDK_SPLITS_ARRIVED, true);
         }
         // queues the SplitChanges fetch (only if changeNumber is newer)
-        this.put(changeNumber);
+        this.put({ changeNumber: changeNumber });
     };
     return SplitsUpdateWorker;
 }());

package/esm/sync/streaming/constants.js

@@ -23,6 +23,7 @@ export var PUSH_SUBSYSTEM_UP = 'PUSH_SUBSYSTEM_UP';
 export var PUSH_SUBSYSTEM_DOWN = 'PUSH_SUBSYSTEM_DOWN';
 // Update-type push notifications, handled by NotificationProcessor
 export var MY_SEGMENTS_UPDATE = 'MY_SEGMENTS_UPDATE';
+export var MY_SEGMENTS_UPDATE_V2 = 'MY_SEGMENTS_UPDATE_V2';
 export var SEGMENT_UPDATE = 'SEGMENT_UPDATE';
 export var SPLIT_KILL = 'SPLIT_KILL';
 export var SPLIT_UPDATE = 'SPLIT_UPDATE';
@@ -34,4 +35,5 @@ export var ControlType;
     ControlType["STREAMING_DISABLED"] = "STREAMING_DISABLED";
     ControlType["STREAMING_PAUSED"] = "STREAMING_PAUSED";
     ControlType["STREAMING_RESUMED"] = "STREAMING_RESUMED";
+    ControlType["STREAMING_RESET"] = "STREAMING_RESET";
 })(ControlType || (ControlType = {}));

package/esm/sync/streaming/mySegmentsV2utils.js

@@ -0,0 +1,69 @@
+import { algorithms } from '../../utils/decompress';
+import { decodeFromBase64 } from '../../utils/base64';
+var GZIP = 1;
+var ZLIB = 2;
+function Uint8ArrayToString(myUint8Arr) {
+    return String.fromCharCode.apply(null, myUint8Arr);
+}
+function StringToUint8Array(myString) {
+    var charCodes = myString.split('').map(function (e) { return e.charCodeAt(0); });
+    return new Uint8Array(charCodes);
+}
+/**
+ * Decode and decompress 'data' with 'compression' algorithm
+ *
+ * @param {string} data
+ * @param {number} compression 1 GZIP, 2 ZLIB
+ * @returns {Uint8Array}
+ * @throws if data string cannot be decoded, decompressed or the provided compression value is invalid (not 1 or 2)
+ */
+function decompress(data, compression) {
+    var compressData = decodeFromBase64(data);
+    var binData = StringToUint8Array(compressData);
+    if (typeof algorithms === 'string')
+        throw new Error(algorithms);
+    if (compression === GZIP)
+        return algorithms.gunzipSync(binData);
+    if (compression === ZLIB)
+        return algorithms.unzlibSync(binData);
+    throw new Error("Invalid compression algorithm #" + compression);
+}
+/**
+ * Decode, decompress and parse the provided 'data' into a KeyList object
+ *
+ * @param {string} data
+ * @param {number} compression
+ * @returns {{a?: string[], r?: string[] }}
+ * @throws if data string cannot be decoded, decompressed or parsed
+ */
+export function parseKeyList(data, compression) {
+    var binKeyList = decompress(data, compression);
+    var strKeyList = Uint8ArrayToString(binKeyList);
+    // replace numbers to strings, to avoid losing precision
+    return JSON.parse(strKeyList.replace(/\d+/g, '"$&"'));
+}
+/**
+ * Decode, decompress and parse the provided 'data' into a Bitmap object
+ *
+ * @param {string} data
+ * @param {number} compression
+ * @returns {Uint8Array}
+ * @throws if data string cannot be decoded or decompressed
+ */
+export function parseBitmap(data, compression) {
+    return decompress(data, compression);
+}
+/**
+ * Check if the 'bitmap' bit at 'hash64hex' position is 1
+ *
+ * @param {Uint8Array} bitmap
+ * @param {string} hash64hex 16-chars string, representing a number in hexa
+ * @returns {boolean}
+ */
+export function isInBitmap(bitmap, hash64hex) {
+    // using the lowest 32 bits as index, to avoid losing precision when converting to number
+    var index = parseInt(hash64hex.slice(8), 16) % (bitmap.length * 8);
+    var internal = Math.floor(index / 8);
+    var offset = index % 8;
+    return (bitmap[internal] & 1 << offset) > 0;
+}

package/esm/sync/streaming/pushManager.js

@@ -8,18 +8,26 @@ import { authenticateFactory, hashUserKey } from './AuthClient';
 import { forOwn } from '../../utils/lang';
 import SSEClient from './SSEClient';
 import { getMatching } from '../../utils/key';
-import { MY_SEGMENTS_UPDATE, PUSH_NONRETRYABLE_ERROR, PUSH_SUBSYSTEM_DOWN, SECONDS_BEFORE_EXPIRATION, SEGMENT_UPDATE, SPLIT_KILL, SPLIT_UPDATE, PUSH_RETRYABLE_ERROR, PUSH_SUBSYSTEM_UP } from './constants';
-import { STREAMING_FALLBACK, STREAMING_REFRESH_TOKEN, STREAMING_CONNECTING, STREAMING_DISABLED, ERROR_STREAMING_AUTH, STREAMING_DISCONNECTING, STREAMING_RECONNECT } from '../../logger/constants';
+import { MY_SEGMENTS_UPDATE, MY_SEGMENTS_UPDATE_V2, PUSH_NONRETRYABLE_ERROR, PUSH_SUBSYSTEM_DOWN, SECONDS_BEFORE_EXPIRATION, SEGMENT_UPDATE, SPLIT_KILL, SPLIT_UPDATE, PUSH_RETRYABLE_ERROR, PUSH_SUBSYSTEM_UP, ControlType } from './constants';
+import { STREAMING_FALLBACK, STREAMING_REFRESH_TOKEN, STREAMING_CONNECTING, STREAMING_DISABLED, ERROR_STREAMING_AUTH, STREAMING_DISCONNECTING, STREAMING_RECONNECT, STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2 } from '../../logger/constants';
+import { UpdateStrategy } from './SSEHandler/types';
+import { isInBitmap, parseBitmap, parseKeyList } from './mySegmentsV2utils';
+import { _Set } from '../../utils/lang/sets';
+import { hash64 } from '../../utils/murmur3/murmur3_64';
 /**
  * PushManager factory:
  * - for server-side if key is not provided in settings.
  * - for client-side, with support for multiple clients, if key is provided in settings
  */
 export default function pushManagerFactory(pollingManager, storage, readiness, fetchAuth, platform, settings) {
+    // `userKey` is the matching key of main client in client-side SDK.
+    // It can be used to check if running on client-side or server-side SDK.
+    var userKey = settings.core.key ? getMatching(settings.core.key) : undefined; //
     var log = settings.log;
     var sseClient;
     try {
-        sseClient = new SSEClient(settings.urls.streaming, platform.getEventSource);
+        // `useHeaders` false for client-side, even if the platform EventSource supports headers (e.g., React Native).
+        sseClient = new SSEClient(settings, userKey ? false : true, platform.getEventSource);
     }
     catch (e) {
         log.warn(STREAMING_FALLBACK, [e]);
@@ -30,44 +38,58 @@ export default function pushManagerFactory(pollingManager, storage, readiness, f
     var pushEmitter = new platform.EventEmitter();
     var sseHandler = SSEHandlerFactory(log, pushEmitter);
     sseClient.setEventHandler(sseHandler);
+    // init workers
+    var segmentsUpdateWorker = userKey ? new MySegmentsUpdateWorker(pollingManager.segmentsSyncTask) : new SegmentsUpdateWorker(storage.segments, pollingManager.segmentsSyncTask);
+    // For server-side we pass the segmentsSyncTask, used by SplitsUpdateWorker to fetch new segments
+    var splitsUpdateWorker = new SplitsUpdateWorker(storage.splits, pollingManager.splitsSyncTask, readiness.splits, userKey ? undefined : pollingManager.segmentsSyncTask);
     // [Only for client-side] map of hashes to user keys, to dispatch MY_SEGMENTS_UPDATE events to the corresponding MySegmentsUpdateWorker
     var userKeyHashes = {};
-    var userKey = settings.core.key ? getMatching(settings.core.key) : undefined; // matching key of main client
+    // [Only for client-side] map of user keys to their corresponding hash64 and MySegmentsUpdateWorkers.
+    // Hash64 is used to process MY_SEGMENTS_UPDATE_V2 events and dispatch actions to the corresponding MySegmentsUpdateWorker.
+    var clients = {};
     if (userKey) {
         var hash = hashUserKey(userKey);
         userKeyHashes[hash] = userKey;
+        clients[userKey] = { hash64: hash64(userKey), worker: segmentsUpdateWorker };
     }
-    // init workers
-    var segmentsUpdateWorker = userKey ? new MySegmentsUpdateWorker(pollingManager.segmentsSyncTask) : new SegmentsUpdateWorker(storage.segments, pollingManager.segmentsSyncTask);
-    // [Only for server-side] we pass the segmentsSyncTask, used by SplitsUpdateWorker to fetch new segments
-    var splitsUpdateWorker = new SplitsUpdateWorker(storage.splits, pollingManager.splitsSyncTask, readiness.splits, userKey ? undefined : pollingManager.segmentsSyncTask);
-    // [Only for client-side] map of user keys to their corresponding MySegmentsUpdateWorkers. It has a two-fold intention:
-    // - stop workers all together when push is disconnected
-    // - keep the current list of user keys to authenticate
-    var workers = {};
-    if (userKey)
-        workers[userKey] = segmentsUpdateWorker;
     // [Only for client-side] variable to flag that a new client was added. It is needed to reconnect streaming.
     var connectForNewClient = false;
-    // flag that indicates if `disconnectPush` was called, either by the SyncManager (when the client is destroyed) or by a PUSH_NONRETRYABLE_ERROR error.
+    // flag that indicates if `stop/disconnectPush` was called, either by the SyncManager, when the client is destroyed, or due to a PUSH_NONRETRYABLE_ERROR error.
     // It is used to halt the `connectPush` process if it was in progress.
     var disconnected;
+    // flag that indicates a PUSH_NONRETRYABLE_ERROR, condition with which starting pushManager again is ignored.
+    var disabled; // `disabled` implies `disconnected === true`
     /** PushManager functions related to initialization */
     var connectPushRetryBackoff = new Backoff(connectPush, settings.scheduler.pushRetryBackoffBase);
-    var timeoutId;
-    function scheduleTokenRefresh(issuedAt, expirationTime) {
-        // clear scheduled token refresh if exists (needed when resuming PUSH)
-        if (timeoutId)
-            clearTimeout(timeoutId);
-        // Set token refresh 10 minutes before expirationTime
-        var delayInSeconds = expirationTime - issuedAt - SECONDS_BEFORE_EXPIRATION;
-        log.info(STREAMING_REFRESH_TOKEN, [delayInSeconds]);
-        timeoutId = setTimeout(connectPush, delayInSeconds * 1000);
+    var timeoutIdTokenRefresh;
+    var timeoutIdSseOpen;
+    function scheduleTokenRefreshAndSse(authData) {
+        // clear scheduled tasks if exist
+        if (timeoutIdTokenRefresh)
+            clearTimeout(timeoutIdTokenRefresh);
+        if (timeoutIdSseOpen)
+            clearTimeout(timeoutIdSseOpen);
+        // Set token refresh 10 minutes before `expirationTime - issuedAt`
+        var decodedToken = authData.decodedToken;
+        var refreshTokenDelay = decodedToken.exp - decodedToken.iat - SECONDS_BEFORE_EXPIRATION;
+        // Default connDelay of 60 secs
+        var connDelay = typeof authData.connDelay === 'number' && authData.connDelay >= 0 ? authData.connDelay : 60;
+        log.info(STREAMING_REFRESH_TOKEN, [refreshTokenDelay, connDelay]);
+        timeoutIdTokenRefresh = setTimeout(connectPush, refreshTokenDelay * 1000);
+        timeoutIdSseOpen = setTimeout(function () {
+            // halt if disconnected
+            if (disconnected)
+                return;
+            sseClient.open(authData);
+        }, connDelay * 1000);
     }
     function connectPush() {
+        // Guard condition in case `stop/disconnectPush` has been called (e.g., calling SDK destroy, or app signal close/background)
+        if (disconnected)
+            return;
+        log.info(STREAMING_CONNECTING, [disconnected === undefined ? '' : 'Re-']);
         disconnected = false;
-        log.info(STREAMING_CONNECTING);
-        var userKeys = userKey ? Object.keys(workers) : undefined;
+        var userKeys = userKey ? Object.keys(clients) : undefined;
         authenticate(userKeys).then(function (authData) {
             if (disconnected)
                 return;
@@ -79,12 +101,10 @@ export default function pushManagerFactory(pollingManager, storage, readiness, f
                 return;
             }
             // [Only for client-side] don't open SSE connection if a new shared client was added, since it means that a new authentication is taking place
-            if (userKeys && userKeys.length < Object.keys(workers).length)
+            if (userKeys && userKeys.length < Object.keys(clients).length)
                 return;
-            // Connect to SSE and schedule refresh token
-            var decodedToken = authData.decodedToken;
-            sseClient.open(authData);
-            scheduleTokenRefresh(decodedToken.iat, decodedToken.exp);
+            // Schedule SSE connection and refresh token
+            scheduleTokenRefreshAndSse(authData);
         }).catch(function (error) {
             if (disconnected)
                 return;
@@ -100,11 +120,16 @@ export default function pushManagerFactory(pollingManager, storage, readiness, f
     }
     // close SSE connection and cancel scheduled tasks
     function disconnectPush() {
+        // Halt disconnecting, just to avoid redundant logs if called multiple times
+        if (disconnected)
+            return;
         disconnected = true;
-        log.info(STREAMING_DISCONNECTING);
         sseClient.close();
-        if (timeoutId)
-            clearTimeout(timeoutId);
+        log.info(STREAMING_DISCONNECTING);
+        if (timeoutIdTokenRefresh)
+            clearTimeout(timeoutIdTokenRefresh);
+        if (timeoutIdSseOpen)
+            clearTimeout(timeoutIdSseOpen);
         connectPushRetryBackoff.reset();
         stopWorkers();
     }
@@ -112,15 +137,23 @@ export default function pushManagerFactory(pollingManager, storage, readiness, f
     function stopWorkers() {
         splitsUpdateWorker.backoff.reset();
         if (userKey)
-            forOwn(workers, function (worker) { return worker.backoff.reset(); });
+            forOwn(clients, function (_a) {
+                var worker = _a.worker;
+                return worker.backoff.reset();
+            });
         else
             segmentsUpdateWorker.backoff.reset();
     }
     pushEmitter.on(PUSH_SUBSYSTEM_DOWN, stopWorkers);
-    // restart backoff retry counter once push is connected
-    pushEmitter.on(PUSH_SUBSYSTEM_UP, function () { connectPushRetryBackoff.reset(); });
+    // Only required when streaming connects after a PUSH_RETRYABLE_ERROR.
+    // Otherwise it is unnecessary (e.g, STREAMING_RESUMED).
+    pushEmitter.on(PUSH_SUBSYSTEM_UP, function () {
+        connectPushRetryBackoff.reset();
+        stopWorkers();
+    });
     /** Fallbacking without retry due to: STREAMING_DISABLED control event, or 'pushEnabled: false', or non-recoverable SSE and Authentication errors */
     pushEmitter.on(PUSH_NONRETRYABLE_ERROR, function handleNonRetryableError() {
+        disabled = true;
         // Note: `stopWorkers` is been called twice, but it is not harmful
         disconnectPush();
         pushEmitter.emit(PUSH_SUBSYSTEM_DOWN); // no harm if polling already
@@ -134,6 +167,16 @@ export default function pushManagerFactory(pollingManager, storage, readiness, f
         log.info(STREAMING_RECONNECT, [delayInMillis / 1000]);
         pushEmitter.emit(PUSH_SUBSYSTEM_DOWN); // no harm if polling already
     });
+    /** STREAMING_RESET notification. Unlike a PUSH_RETRYABLE_ERROR, it doesn't emit PUSH_SUBSYSTEM_DOWN to fallback polling */
+    pushEmitter.on(ControlType.STREAMING_RESET, function handleStreamingReset() {
+        if (disconnected)
+            return; // should never happen
+        // Minimum required clean-up.
+        // `disconnectPush` cannot be called because it sets `disconnected` and thus `connectPush` will not execute
+        if (timeoutIdTokenRefresh)
+            clearTimeout(timeoutIdTokenRefresh);
+        connectPush();
+    });
     /** Functions related to synchronization (Queues and Workers in the spec) */
     pushEmitter.on(SPLIT_KILL, splitsUpdateWorker.killSplit);
     pushEmitter.on(SPLIT_UPDATE, splitsUpdateWorker.put);
@@ -141,11 +184,72 @@ export default function pushManagerFactory(pollingManager, storage, readiness, f
         pushEmitter.on(MY_SEGMENTS_UPDATE, function handleMySegmentsUpdate(parsedData, channel) {
             var userKeyHash = channel.split('_')[2];
             var userKey = userKeyHashes[userKeyHash];
-            if (userKey && workers[userKey]) { // check context since it can be undefined if client has been destroyed
-                var mySegmentsUpdateWorker = workers[userKey];
-                mySegmentsUpdateWorker.put(parsedData.changeNumber, parsedData.includesPayload ? parsedData.segmentList ? parsedData.segmentList : [] : undefined);
+            if (userKey && clients[userKey]) { // check existence since it can be undefined if client has been destroyed
+                clients[userKey].worker.put(parsedData.changeNumber, parsedData.includesPayload ? parsedData.segmentList ? parsedData.segmentList : [] : undefined);
             }
         });
+        pushEmitter.on(MY_SEGMENTS_UPDATE_V2, function handleMySegmentsUpdate(parsedData) {
+            switch (parsedData.u) {
+                case UpdateStrategy.BoundedFetchRequest: {
+                    var bitmap_1;
+                    try {
+                        bitmap_1 = parseBitmap(parsedData.d, parsedData.c);
+                    }
+                    catch (e) {
+                        log.warn(STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2, ['BoundedFetchRequest', e]);
+                        break;
+                    }
+                    forOwn(clients, function (_a) {
+                        var hash64 = _a.hash64, worker = _a.worker;
+                        if (isInBitmap(bitmap_1, hash64.hex)) {
+                            worker.put(parsedData.changeNumber); // fetch mySegments
+                        }
+                    });
+                    return;
+                }
+                case UpdateStrategy.KeyList: {
+                    var keyList = void 0, added_1, removed_1;
+                    try {
+                        keyList = parseKeyList(parsedData.d, parsedData.c);
+                        added_1 = new _Set(keyList.a);
+                        removed_1 = new _Set(keyList.r);
+                    }
+                    catch (e) {
+                        log.warn(STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2, ['KeyList', e]);
+                        break;
+                    }
+                    forOwn(clients, function (_a) {
+                        var hash64 = _a.hash64, worker = _a.worker;
+                        var add = added_1.has(hash64.dec) ? true : removed_1.has(hash64.dec) ? false : undefined;
+                        if (add !== undefined) {
+                            worker.put(parsedData.changeNumber, {
+                                name: parsedData.segmentName,
+                                add: add
+                            });
+                        }
+                    });
+                    return;
+                }
+                case UpdateStrategy.SegmentRemoval:
+                    if (!parsedData.segmentName) {
+                        log.warn(STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2, ['SegmentRemoval', 'No segment name was provided']);
+                        break;
+                    }
+                    forOwn(clients, function (_a) {
+                        var worker = _a.worker;
+                        return worker.put(parsedData.changeNumber, {
+                            name: parsedData.segmentName,
+                            add: false
+                        });
+                    });
+                    return;
+            }
+            // `UpdateStrategy.UnboundedFetchRequest` and fallbacks of other cases
+            forOwn(clients, function (_a) {
+                var worker = _a.worker;
+                worker.put(parsedData.changeNumber);
+            });
+        });
     }
     else {
         pushEmitter.on(SEGMENT_UPDATE, segmentsUpdateWorker.put);
@@ -156,13 +260,16 @@ export default function pushManagerFactory(pollingManager, storage, readiness, f
         // Expose functionality for starting and stoping push mode:
         stop: disconnectPush,
         start: function () {
+            // Guard condition to avoid calling `connectPush` again if the `start` method is called multiple times or if push has been disabled.
+            if (disabled || disconnected === false)
+                return;
+            disconnected = false;
             // Run in next event-loop cycle for optimization on client-side: if multiple clients are created in the same cycle than the factory, only one authentication is performed.
             setTimeout(connectPush);
         },
         // [Only for client-side]
         add: function (userKey, mySegmentsSyncTask) {
-            var mySegmentsUpdateWorker = new MySegmentsUpdateWorker(mySegmentsSyncTask);
-            workers[userKey] = mySegmentsUpdateWorker;
+            clients[userKey] = { hash64: hash64(userKey), worker: new MySegmentsUpdateWorker(mySegmentsSyncTask) };
             var hash = hashUserKey(userKey);
             if (!userKeyHashes[hash]) {
                 userKeyHashes[hash] = userKey;
@@ -182,6 +289,7 @@ export default function pushManagerFactory(pollingManager, storage, readiness, f
         remove: function (userKey) {
             var hash = hashUserKey(userKey);
             delete userKeyHashes[hash];
+            delete clients[userKey];
         }
     });
 }

package/esm/sync/submitters/metricsSyncTask.js

@@ -22,5 +22,5 @@ export function countsSyncTaskFactory(log, postMetricsCounters, countsCache, met
  */
 export function latenciesSyncTaskFactory(log, postMetricsLatencies, latenciesCache, metricsRefreshRate, latencyTracker) {
     // don't retry metrics.
-    return submitterSyncTaskFactory(log, postMetricsLatencies, latenciesCache, metricsRefreshRate, 'latency metrics', latencyTracker, fromCache('latencies'));
+    return submitterSyncTaskFactory(log, postMetricsLatencies, latenciesCache, metricsRefreshRate, 'latency metrics', latencyTracker, fromCache('latencies'), 0, true);
 }

package/esm/sync/submitters/submitterSyncTask.js

@@ -3,7 +3,7 @@ import { SUBMITTERS_PUSH, SUBMITTERS_PUSH_FAILS, SUBMITTERS_PUSH_RETRY } from '.
 /**
  * Base function to create submitter sync tasks, such as ImpressionsSyncTask and EventsSyncTask
  */
-export function submitterSyncTaskFactory(log, postClient, sourceCache, postRate, dataName, latencyTracker, fromCacheToPayload, maxRetries) {
+export function submitterSyncTaskFactory(log, postClient, sourceCache, postRate, dataName, latencyTracker, fromCacheToPayload, maxRetries, debugLogs) {
     if (maxRetries === void 0) { maxRetries = 0; }
     var retries = 0;
     function postData() {
@@ -11,7 +11,7 @@ export function submitterSyncTaskFactory(log, postClient, sourceCache, postRate,
             return Promise.resolve();
         var data = sourceCache.state();
         var dataCount = typeof data.length === 'number' ? data.length : '';
-        log.info(SUBMITTERS_PUSH, [dataCount, dataName]);
+        log[debugLogs ? 'debug' : 'info'](SUBMITTERS_PUSH, [dataCount, dataName]);
         var latencyTrackerStop = latencyTracker && latencyTracker.start();
         var jsonPayload = JSON.stringify(fromCacheToPayload ? fromCacheToPayload(data) : data);
         if (!maxRetries)

package/esm/sync/syncManagerFromFile.js

@@ -0,0 +1,11 @@
+import { splitsParserFromFileFactory } from './offline/splitsParser/splitsParserFromFile';
+import { syncManagerOfflineFactory } from './syncManagerOffline';
+import { LOCALHOST_MODE } from '../utils/constants';
+// Factory of Localhost SyncManager based on yaml file.
+// Requires Node 'fs' and 'path' APIs.
+export function LocalhostFromFile() {
+    var localhost = syncManagerOfflineFactory(splitsParserFromFileFactory);
+    // @ts-ignore
+    localhost.type = LOCALHOST_MODE;
+    return localhost;
+}

package/esm/sync/syncManagerFromObject.js

@@ -0,0 +1,10 @@
+import { splitsParserFromSettingsFactory } from './offline/splitsParser/splitsParserFromSettings';
+import { syncManagerOfflineFactory } from './syncManagerOffline';
+import { LOCALHOST_MODE } from '../utils/constants';
+// Factory of Localhost SyncManager based on JS object.
+export function LocalhostFromObject() {
+    var localhost = syncManagerOfflineFactory(splitsParserFromSettingsFactory);
+    // @ts-ignore
+    localhost.type = LOCALHOST_MODE;
+    return localhost;
+}

package/esm/sync/syncManagerOffline.js

@@ -10,20 +10,20 @@ function flush() {
  *
  * @param splitsParser e.g., `splitsParserFromFile`, `splitsParserFromSettings`.
  */
-export function syncManagerOfflineFactory(splitsParser) {
+export function syncManagerOfflineFactory(splitsParserFactory) {
     /**
      * SyncManager factory for modular SDK
      */
     return function (_a) {
         var settings = _a.settings, readiness = _a.readiness, storage = _a.storage;
-        return objectAssign(fromObjectSyncTaskFactory(splitsParser, storage, readiness, settings), {
+        return objectAssign(fromObjectSyncTaskFactory(splitsParserFactory(), storage, readiness, settings), {
             // fake flush, that resolves immediately
             flush: flush,
             // [Only used for client-side]
             shared: function (matchingKey, readinessManager) {
                 return {
                     start: function () {
-                        // In LOCALHOST mode, shared clients are ready in the next event cycle than created
+                        // In LOCALHOST mode, shared clients are ready in the next event-loop cycle than created
                         // SDK_READY cannot be emitted directly because this will not update the readiness status
                         setTimeout(function () {
                             readinessManager.segments.emit(SDK_SEGMENTS_ARRIVED); // SDK_SPLITS_ARRIVED emitted by main SyncManager

package/esm/sync/syncManagerOnline.js

@@ -53,15 +53,25 @@ export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFacto
             // fetch splits and segments. There is no need to catch this promise (it is always resolved)
             pollingManager.syncAll();
         }
-        var running = false;
+        if (pushManager) {
+            pushManager.on(PUSH_SUBSYSTEM_UP, stopPollingAndSyncAll);
+            pushManager.on(PUSH_SUBSYSTEM_DOWN, startPolling);
+        }
+        var running = false; // flag that indicates whether the syncManager has been started (true) or stopped (false)
+        var startFirstTime = true; // flag to distinguish calling the `start` method for the first time, to support pausing and resuming the synchronization
         return {
+            pushManager: pushManager,
+            /**
+             * Method used to start the syncManager for the first time, or resume it after being stopped.
+             */
             start: function () {
                 // start syncing splits and segments
                 if (pushManager) {
-                    pollingManager.syncAll();
-                    pushManager.on(PUSH_SUBSYSTEM_UP, stopPollingAndSyncAll);
-                    pushManager.on(PUSH_SUBSYSTEM_DOWN, startPolling);
-                    // Run in next event-loop cycle as in client-side SyncManager
+                    // Doesn't call `syncAll` when the syncManager is resuming
+                    if (startFirstTime) {
+                        pollingManager.syncAll();
+                        startFirstTime = false;
+                    }
                     pushManager.start();
                 }
                 else {
@@ -71,6 +81,9 @@ export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFacto
                 submitter && submitter.start();
                 running = true;
             },
+            /**
+             * Method used to stop/pause the syncManager.
+             */
             stop: function () {
                 // stop syncing
                 if (pushManager)

package/esm/sync/syncTask.js

@@ -1,6 +1,6 @@
 import { SYNC_TASK_EXECUTE, SYNC_TASK_START, SYNC_TASK_STOP } from '../logger/constants';
 /**
- * Creates a syncTask that handles the periodic execution of a givan task ("start" and "stop" methods).
+ * Creates a syncTask that handles the periodic execution of a given task ("start" and "stop" methods).
  * The task can be executed once calling the "execute" method.
  * NOTE: Multiple calls to "execute" are not queued. Use "isExecuting" method to handle synchronization.
  *

package/esm/trackers/impressionObserver/ImpressionObserver.js

@@ -5,8 +5,6 @@ var ImpressionObserver = /** @class */ (function () {
         this.hasher = hasher;
     }
     ImpressionObserver.prototype.testAndSet = function (impression) {
-        if (!impression)
-            return;
         var hash = this.hasher(impression);
         var previous = this.cache.get(hash);
         this.cache.set(hash, impression.time);

package/esm/trackers/impressionObserver/buildKey.js

@@ -1,10 +1,3 @@
-var UNKNOWN = 'UNKNOWN';
-function _unknownIfNull(s) {
-    return s ? s : UNKNOWN;
-}
-function _zeroIfNull(l) {
-    return l ? l : 0;
-}
-export default function buildKey(impression) {
-    return _unknownIfNull(impression.keyName) + "\n    :" + _unknownIfNull(impression.feature) + "\n    :" + _unknownIfNull(impression.treatment) + "\n    :" + _unknownIfNull(impression.label) + "\n    :" + _zeroIfNull(impression.changeNumber);
+export function buildKey(impression) {
+    return impression.keyName + ":" + impression.feature + ":" + impression.treatment + ":" + impression.label + ":" + impression.changeNumber;
 }

package/esm/trackers/impressionObserver/impressionObserverCS.js

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

package/esm/trackers/impressionObserver/impressionObserverSS.js

@@ -1,8 +1,8 @@
 import ImpressionObserver from './ImpressionObserver';
-import { hash128 } from '../../utils/murmur3/murmur3_128';
-import buildKey from './buildKey';
+import { hash128 } from '../../utils/murmur3/murmur3_128_x86';
+import { buildKey } from './buildKey';
 export function hashImpression128(impression) {
-    return impression ? hash128(buildKey(impression)).toString() : null;
+    return hash128(buildKey(impression));
 }
 var LAST_SEEN_CACHE_SIZE = 500000; // cache up to 500k impression hashes
 export function impressionObserverSSFactory() {

package/esm/utils/constants/index.js

@@ -20,3 +20,6 @@ export var PRODUCER_MODE = 'producer';
 export var CONSUMER_MODE = 'consumer';
 // Storage types
 export var STORAGE_MEMORY = 'MEMORY';
+export var STORAGE_LOCALSTORAGE = 'LOCALSTORAGE';
+export var STORAGE_REDIS = 'REDIS';
+export var STORAGE_CUSTOM = 'CUSTOM';