@splitsoftware/splitio-commons 1.4.1-rc.2 → 1.4.2-rc.1

package/CHANGES.txt

@@ -1,3 +1,8 @@
+1.4.2 (June XX, 2022)
+ - Added `sync.enabled` property to SDK configuration to allow synchronize splits and segments only once.
+ - Updated telemetry to submit data even if user consent is not granted.
+ - Updated submitters logic, to avoid duplicating the post of impressions to Split cloud when the SDK is destroyed while performing its periodic post of impressions.
+
 1.4.1 (June 13, 2022)
  - Bugfixing - Updated submitters logic, to avoid dropping impressions and events that are being tracked while POST request is pending.
 

package/cjs/consent/sdkUserConsent.js

@@ -31,10 +31,10 @@ function createUserConsentAPI(params) {
                 log.info(constants_1.USER_CONSENT_UPDATED, [settings.userConsent, newConsentStatus]); // @ts-ignore, modify readonly prop
                 settings.userConsent = newConsentStatus;
                 if (consent) { // resumes submitters if transitioning to GRANTED
-                    (_a = syncManager === null || syncManager === void 0 ? void 0 : syncManager.submitter) === null || _a === void 0 ? void 0 : _a.start();
+                    (_a = syncManager === null || syncManager === void 0 ? void 0 : syncManager.submitterManager) === null || _a === void 0 ? void 0 : _a.start();
                 }
-                else { // pauses submitters and drops tracked data if transitioning to DECLINED
-                    (_b = syncManager === null || syncManager === void 0 ? void 0 : syncManager.submitter) === null || _b === void 0 ? void 0 : _b.stop();
+                else { // pauses submitters (except telemetry), and drops tracked data if transitioning to DECLINED
+                    (_b = syncManager === null || syncManager === void 0 ? void 0 : syncManager.submitterManager) === null || _b === void 0 ? void 0 : _b.stop(true);
                     // @ts-ignore, clear method is present in storage for standalone and partial consumer mode
                     if (events.clear)
                         events.clear(); // @ts-ignore

package/cjs/listeners/browser.js

@@ -53,7 +53,7 @@ var BrowserSignalListener = /** @class */ (function () {
     BrowserSignalListener.prototype.flushData = function () {
         if (!this.syncManager)
             return; // In consumer mode there is not sync manager and data to flush
-        // Flush data if there is user consent
+        // Flush impressions & events data if there is user consent
         if ((0, consent_1.isConsentGranted)(this.settings)) {
             var eventsUrl = this.settings.urls.events;
             var extraMetadata = {
@@ -64,11 +64,12 @@ var BrowserSignalListener = /** @class */ (function () {
             this._flushData(eventsUrl + '/events/beacon', this.storage.events, this.serviceApi.postEventsBulk);
             if (this.storage.impressionCounts)
                 this._flushData(eventsUrl + '/testImpressions/count/beacon', this.storage.impressionCounts, this.serviceApi.postTestImpressionsCount, impressionCountsSubmitter_1.fromImpressionCountsCollector);
-            if (this.storage.telemetry) {
-                var telemetryUrl = this.settings.urls.telemetry;
-                var telemetryCacheAdapter = (0, telemetrySubmitter_1.telemetryCacheStatsAdapter)(this.storage.telemetry, this.storage.splits, this.storage.segments);
-                this._flushData(telemetryUrl + '/v1/metrics/usage/beacon', telemetryCacheAdapter, this.serviceApi.postMetricsUsage);
-            }
+        }
+        // Flush telemetry data
+        if (this.storage.telemetry) {
+            var telemetryUrl = this.settings.urls.telemetry;
+            var telemetryCacheAdapter = (0, telemetrySubmitter_1.telemetryCacheStatsAdapter)(this.storage.telemetry, this.storage.splits, this.storage.segments);
+            this._flushData(telemetryUrl + '/v1/metrics/usage/beacon', telemetryCacheAdapter, this.serviceApi.postMetricsUsage);
         }
         // Close streaming connection
         if (this.syncManager.pushManager)

package/cjs/sync/submitters/submitterManager.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.submitterManagerFactory = void 0;
-var syncTaskComposite_1 = require("../syncTaskComposite");
 var eventsSubmitter_1 = require("./eventsSubmitter");
 var impressionsSubmitter_1 = require("./impressionsSubmitter");
 var impressionCountsSubmitter_1 = require("./impressionCountsSubmitter");
@@ -15,8 +14,33 @@ function submitterManagerFactory(params) {
     if (impressionCountsSubmitter)
         submitters.push(impressionCountsSubmitter);
     var telemetrySubmitter = (0, telemetrySubmitter_1.telemetrySubmitterFactory)(params);
-    if (telemetrySubmitter)
-        submitters.push(telemetrySubmitter);
-    return (0, syncTaskComposite_1.syncTaskComposite)(submitters);
+    return {
+        // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
+        start: function (onlyTelemetry) {
+            if (!onlyTelemetry)
+                submitters.forEach(function (submitter) { return submitter.start(); });
+            if (telemetrySubmitter)
+                telemetrySubmitter.start();
+        },
+        // `allExceptTelemetry` true if userConsent is changed to DECLINED
+        stop: function (allExceptTelemetry) {
+            submitters.forEach(function (submitter) { return submitter.stop(); });
+            if (!allExceptTelemetry && telemetrySubmitter)
+                telemetrySubmitter.stop();
+        },
+        isRunning: function () {
+            return submitters.some(function (submitter) { return submitter.isRunning(); });
+        },
+        // Flush data. Called with `onlyTelemetry` true if SDK is destroyed with userConsent not GRANTED
+        execute: function (onlyTelemetry) {
+            var promises = onlyTelemetry ? [] : submitters.map(function (submitter) { return submitter.execute(); });
+            if (telemetrySubmitter)
+                promises.push(telemetrySubmitter.execute());
+            return Promise.all(promises);
+        },
+        isExecuting: function () {
+            return submitters.some(function (submitter) { return submitter.isExecuting(); });
+        }
+    };
 }
 exports.submitterManagerFactory = submitterManagerFactory;

package/cjs/sync/syncManagerOnline.js

@@ -19,16 +19,16 @@ 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, 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 = pollingManagerFactory && pollingManagerFactory(params);
         /** Push Manager */
-        var pushManager = streamingEnabled && pollingManager && pushManagerFactory ?
+        var pushManager = syncEnabled && streamingEnabled && pollingManager && pushManagerFactory ?
             pushManagerFactory(params, pollingManager) :
             undefined;
         /** Submitter Manager */
         // It is not inyected as push and polling managers, because at the moment it is required
-        var submitter = (0, submitterManager_1.submitterManagerFactory)(params);
+        var submitterManager = (0, submitterManager_1.submitterManagerFactory)(params);
         /** Sync Manager logic */
         function startPolling() {
             if (pollingManager.isRunning()) {
@@ -61,7 +61,7 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
             // E.g.: user consent, app state changes (Page hide, Foreground/Background, Online/Offline).
             pollingManager: pollingManager,
             pushManager: pushManager,
-            submitter: submitter,
+            submitterManager: submitterManager,
             /**
              * Method used to start the syncManager for the first time, or resume it after being stopped.
              */
@@ -69,21 +69,29 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
                 running = true;
                 // start syncing splits and segments
                 if (pollingManager) {
-                    if (pushManager) {
-                        // Doesn't call `syncAll` when the syncManager is resuming
+                    // If synchronization is disabled pushManager and pollingManager should not start
+                    if (syncEnabled) {
+                        if (pushManager) {
+                            // Doesn't call `syncAll` when the syncManager is resuming
+                            if (startFirstTime) {
+                                pollingManager.syncAll();
+                                startFirstTime = false;
+                            }
+                            pushManager.start();
+                        }
+                        else {
+                            pollingManager.start();
+                        }
+                    }
+                    else {
                         if (startFirstTime) {
                             pollingManager.syncAll();
                             startFirstTime = false;
                         }
-                        pushManager.start();
-                    }
-                    else {
-                        pollingManager.start();
                     }
                 }
                 // start periodic data recording (events, impressions, telemetry).
-                if ((0, consent_1.isConsentGranted)(settings))
-                    submitter.start();
+                submitterManager.start(!(0, consent_1.isConsentGranted)(settings));
             },
             /**
              * Method used to stop/pause the syncManager.
@@ -96,16 +104,13 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
                 if (pollingManager && pollingManager.isRunning())
                     pollingManager.stop();
                 // stop periodic data recording (events, impressions, telemetry).
-                submitter.stop();
+                submitterManager.stop();
             },
             isRunning: function () {
                 return running;
             },
             flush: function () {
-                if ((0, consent_1.isConsentGranted)(settings))
-                    return submitter.execute();
-                else
-                    return Promise.resolve();
+                return submitterManager.execute(!(0, consent_1.isConsentGranted)(settings));
             },
             // [Only used for client-side]
             // If polling and push managers are defined (standalone mode), they implement the interfaces for client-side
@@ -116,22 +121,28 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
                 return {
                     isRunning: mySegmentsSyncTask.isRunning,
                     start: function () {
-                        if (pushManager) {
-                            if (pollingManager.isRunning()) {
-                                // if doing polling, we must start the periodic fetch of data
-                                if (storage.splits.usesSegments())
-                                    mySegmentsSyncTask.start();
+                        if (syncEnabled) {
+                            if (pushManager) {
+                                if (pollingManager.isRunning()) {
+                                    // if doing polling, we must start the periodic fetch of data
+                                    if (storage.splits.usesSegments())
+                                        mySegmentsSyncTask.start();
+                                }
+                                else {
+                                    // if not polling, we must execute the sync task for the initial fetch
+                                    // of segments since `syncAll` was already executed when starting the main client
+                                    mySegmentsSyncTask.execute();
+                                }
+                                pushManager.add(matchingKey, mySegmentsSyncTask);
                             }
                             else {
-                                // if not polling, we must execute the sync task for the initial fetch
-                                // of segments since `syncAll` was already executed when starting the main client
-                                mySegmentsSyncTask.execute();
+                                if (storage.splits.usesSegments())
+                                    mySegmentsSyncTask.start();
                             }
-                            pushManager.add(matchingKey, mySegmentsSyncTask);
                         }
                         else {
-                            if (storage.splits.usesSegments())
-                                mySegmentsSyncTask.start();
+                            if (!readinessManager.isReady())
+                                mySegmentsSyncTask.execute();
                         }
                     },
                     stop: function () {

package/cjs/sync/syncTask.js

@@ -4,8 +4,8 @@ exports.syncTaskFactory = void 0;
 var constants_1 = require("../logger/constants");
 /**
  * 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.
+ * The task can be also executed by calling the "execute" method. Multiple execute calls are chained to run secuentially and avoid race conditions.
+ * For example, submitters executed on SDK destroy or full queue, while periodic execution is pending.
  *
  * @param log  Logger instance.
  * @param task  Task to execute that returns a promise that NEVER REJECTS. Otherwise, periodic execution can result in Unhandled Promise Rejections.
@@ -15,8 +15,8 @@ var constants_1 = require("../logger/constants");
  */
 function syncTaskFactory(log, task, period, taskName) {
     if (taskName === void 0) { taskName = 'task'; }
-    // Flag that indicates if the task is being executed
-    var executing = false;
+    // Task promise while it is pending. Undefined once the promise is resolved
+    var pendingTask;
     // flag that indicates if the task periodic execution has been started/stopped.
     var running = false;
     // Auxiliar counter used to avoid race condition when calling `start` & `stop` intermittently
@@ -30,13 +30,19 @@ function syncTaskFactory(log, task, period, taskName) {
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        executing = true;
+        // If task is executing, chain the new execution
+        if (pendingTask) {
+            return pendingTask.then(function () {
+                return execute.apply(void 0, args);
+            });
+        }
+        // Execute task
         log.debug(constants_1.SYNC_TASK_EXECUTE, [taskName]);
-        return task.apply(void 0, args).then(function (result) {
-            executing = false;
+        pendingTask = task.apply(void 0, args).then(function (result) {
+            pendingTask = undefined;
             return result;
         });
-        // No need to handle promise rejection because it is a pre-condition that provided task never rejects.
+        return pendingTask;
     }
     function periodicExecute(currentRunningId) {
         return execute.apply(void 0, runningArgs).then(function (result) {
@@ -48,10 +54,9 @@ function syncTaskFactory(log, task, period, taskName) {
         });
     }
     return {
-        // @TODO check if we need to queued `execute` calls, to avoid possible race conditions on submitters and updaters with streaming.
         execute: execute,
         isExecuting: function () {
-            return executing;
+            return pendingTask !== undefined;
         },
         start: function () {
             var args = [];

package/cjs/utils/settingsValidation/index.js

@@ -73,7 +73,8 @@ exports.base = {
         splitFilters: undefined,
         // impressions collection mode
         impressionsMode: constants_1.OPTIMIZED,
-        localhostMode: undefined
+        localhostMode: undefined,
+        enabled: true
     },
     // Logger
     log: undefined
@@ -167,6 +168,10 @@ function settingsValidation(config, validationParams) {
         // We are not checking if bases are positive numbers. Thus, we might be reauthenticating immediately (`setTimeout` with NaN or negative number)
         scheduler.pushRetryBackoffBase = fromSecondsToMillis(scheduler.pushRetryBackoffBase);
     }
+    // validate sync enabled
+    if (withDefaults.sync.enabled !== false) { // @ts-ignore, modify readonly prop
+        withDefaults.sync.enabled = true;
+    }
     // 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/consent/sdkUserConsent.js

@@ -28,10 +28,10 @@ export function createUserConsentAPI(params) {
                 log.info(USER_CONSENT_UPDATED, [settings.userConsent, newConsentStatus]); // @ts-ignore, modify readonly prop
                 settings.userConsent = newConsentStatus;
                 if (consent) { // resumes submitters if transitioning to GRANTED
-                    (_a = syncManager === null || syncManager === void 0 ? void 0 : syncManager.submitter) === null || _a === void 0 ? void 0 : _a.start();
+                    (_a = syncManager === null || syncManager === void 0 ? void 0 : syncManager.submitterManager) === null || _a === void 0 ? void 0 : _a.start();
                 }
-                else { // pauses submitters and drops tracked data if transitioning to DECLINED
-                    (_b = syncManager === null || syncManager === void 0 ? void 0 : syncManager.submitter) === null || _b === void 0 ? void 0 : _b.stop();
+                else { // pauses submitters (except telemetry), and drops tracked data if transitioning to DECLINED
+                    (_b = syncManager === null || syncManager === void 0 ? void 0 : syncManager.submitterManager) === null || _b === void 0 ? void 0 : _b.stop(true);
                     // @ts-ignore, clear method is present in storage for standalone and partial consumer mode
                     if (events.clear)
                         events.clear(); // @ts-ignore

package/esm/listeners/browser.js

@@ -50,7 +50,7 @@ var BrowserSignalListener = /** @class */ (function () {
     BrowserSignalListener.prototype.flushData = function () {
         if (!this.syncManager)
             return; // In consumer mode there is not sync manager and data to flush
-        // Flush data if there is user consent
+        // Flush impressions & events data if there is user consent
         if (isConsentGranted(this.settings)) {
             var eventsUrl = this.settings.urls.events;
             var extraMetadata = {
@@ -61,11 +61,12 @@ var BrowserSignalListener = /** @class */ (function () {
             this._flushData(eventsUrl + '/events/beacon', this.storage.events, this.serviceApi.postEventsBulk);
             if (this.storage.impressionCounts)
                 this._flushData(eventsUrl + '/testImpressions/count/beacon', this.storage.impressionCounts, this.serviceApi.postTestImpressionsCount, fromImpressionCountsCollector);
-            if (this.storage.telemetry) {
-                var telemetryUrl = this.settings.urls.telemetry;
-                var telemetryCacheAdapter = telemetryCacheStatsAdapter(this.storage.telemetry, this.storage.splits, this.storage.segments);
-                this._flushData(telemetryUrl + '/v1/metrics/usage/beacon', telemetryCacheAdapter, this.serviceApi.postMetricsUsage);
-            }
+        }
+        // Flush telemetry data
+        if (this.storage.telemetry) {
+            var telemetryUrl = this.settings.urls.telemetry;
+            var telemetryCacheAdapter = telemetryCacheStatsAdapter(this.storage.telemetry, this.storage.splits, this.storage.segments);
+            this._flushData(telemetryUrl + '/v1/metrics/usage/beacon', telemetryCacheAdapter, this.serviceApi.postMetricsUsage);
         }
         // Close streaming connection
         if (this.syncManager.pushManager)

package/esm/sync/submitters/submitterManager.js

@@ -1,4 +1,3 @@
-import { syncTaskComposite } from '../syncTaskComposite';
 import { eventsSubmitterFactory } from './eventsSubmitter';
 import { impressionsSubmitterFactory } from './impressionsSubmitter';
 import { impressionCountsSubmitterFactory } from './impressionCountsSubmitter';
@@ -12,7 +11,32 @@ export function submitterManagerFactory(params) {
     if (impressionCountsSubmitter)
         submitters.push(impressionCountsSubmitter);
     var telemetrySubmitter = telemetrySubmitterFactory(params);
-    if (telemetrySubmitter)
-        submitters.push(telemetrySubmitter);
-    return syncTaskComposite(submitters);
+    return {
+        // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
+        start: function (onlyTelemetry) {
+            if (!onlyTelemetry)
+                submitters.forEach(function (submitter) { return submitter.start(); });
+            if (telemetrySubmitter)
+                telemetrySubmitter.start();
+        },
+        // `allExceptTelemetry` true if userConsent is changed to DECLINED
+        stop: function (allExceptTelemetry) {
+            submitters.forEach(function (submitter) { return submitter.stop(); });
+            if (!allExceptTelemetry && telemetrySubmitter)
+                telemetrySubmitter.stop();
+        },
+        isRunning: function () {
+            return submitters.some(function (submitter) { return submitter.isRunning(); });
+        },
+        // Flush data. Called with `onlyTelemetry` true if SDK is destroyed with userConsent not GRANTED
+        execute: function (onlyTelemetry) {
+            var promises = onlyTelemetry ? [] : submitters.map(function (submitter) { return submitter.execute(); });
+            if (telemetrySubmitter)
+                promises.push(telemetrySubmitter.execute());
+            return Promise.all(promises);
+        },
+        isExecuting: function () {
+            return submitters.some(function (submitter) { return submitter.isExecuting(); });
+        }
+    };
 }

package/esm/sync/syncManagerOnline.js

@@ -16,16 +16,16 @@ 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, 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 = pollingManagerFactory && pollingManagerFactory(params);
         /** Push Manager */
-        var pushManager = streamingEnabled && pollingManager && pushManagerFactory ?
+        var pushManager = syncEnabled && streamingEnabled && pollingManager && pushManagerFactory ?
             pushManagerFactory(params, pollingManager) :
             undefined;
         /** Submitter Manager */
         // It is not inyected as push and polling managers, because at the moment it is required
-        var submitter = submitterManagerFactory(params);
+        var submitterManager = submitterManagerFactory(params);
         /** Sync Manager logic */
         function startPolling() {
             if (pollingManager.isRunning()) {
@@ -58,7 +58,7 @@ export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFacto
             // E.g.: user consent, app state changes (Page hide, Foreground/Background, Online/Offline).
             pollingManager: pollingManager,
             pushManager: pushManager,
-            submitter: submitter,
+            submitterManager: submitterManager,
             /**
              * Method used to start the syncManager for the first time, or resume it after being stopped.
              */
@@ -66,21 +66,29 @@ export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFacto
                 running = true;
                 // start syncing splits and segments
                 if (pollingManager) {
-                    if (pushManager) {
-                        // Doesn't call `syncAll` when the syncManager is resuming
+                    // If synchronization is disabled pushManager and pollingManager should not start
+                    if (syncEnabled) {
+                        if (pushManager) {
+                            // Doesn't call `syncAll` when the syncManager is resuming
+                            if (startFirstTime) {
+                                pollingManager.syncAll();
+                                startFirstTime = false;
+                            }
+                            pushManager.start();
+                        }
+                        else {
+                            pollingManager.start();
+                        }
+                    }
+                    else {
                         if (startFirstTime) {
                             pollingManager.syncAll();
                             startFirstTime = false;
                         }
-                        pushManager.start();
-                    }
-                    else {
-                        pollingManager.start();
                     }
                 }
                 // start periodic data recording (events, impressions, telemetry).
-                if (isConsentGranted(settings))
-                    submitter.start();
+                submitterManager.start(!isConsentGranted(settings));
             },
             /**
              * Method used to stop/pause the syncManager.
@@ -93,16 +101,13 @@ export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFacto
                 if (pollingManager && pollingManager.isRunning())
                     pollingManager.stop();
                 // stop periodic data recording (events, impressions, telemetry).
-                submitter.stop();
+                submitterManager.stop();
             },
             isRunning: function () {
                 return running;
             },
             flush: function () {
-                if (isConsentGranted(settings))
-                    return submitter.execute();
-                else
-                    return Promise.resolve();
+                return submitterManager.execute(!isConsentGranted(settings));
             },
             // [Only used for client-side]
             // If polling and push managers are defined (standalone mode), they implement the interfaces for client-side
@@ -113,22 +118,28 @@ export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFacto
                 return {
                     isRunning: mySegmentsSyncTask.isRunning,
                     start: function () {
-                        if (pushManager) {
-                            if (pollingManager.isRunning()) {
-                                // if doing polling, we must start the periodic fetch of data
-                                if (storage.splits.usesSegments())
-                                    mySegmentsSyncTask.start();
+                        if (syncEnabled) {
+                            if (pushManager) {
+                                if (pollingManager.isRunning()) {
+                                    // if doing polling, we must start the periodic fetch of data
+                                    if (storage.splits.usesSegments())
+                                        mySegmentsSyncTask.start();
+                                }
+                                else {
+                                    // if not polling, we must execute the sync task for the initial fetch
+                                    // of segments since `syncAll` was already executed when starting the main client
+                                    mySegmentsSyncTask.execute();
+                                }
+                                pushManager.add(matchingKey, mySegmentsSyncTask);
                             }
                             else {
-                                // if not polling, we must execute the sync task for the initial fetch
-                                // of segments since `syncAll` was already executed when starting the main client
-                                mySegmentsSyncTask.execute();
+                                if (storage.splits.usesSegments())
+                                    mySegmentsSyncTask.start();
                             }
-                            pushManager.add(matchingKey, mySegmentsSyncTask);
                         }
                         else {
-                            if (storage.splits.usesSegments())
-                                mySegmentsSyncTask.start();
+                            if (!readinessManager.isReady())
+                                mySegmentsSyncTask.execute();
                         }
                     },
                     stop: function () {

package/esm/sync/syncTask.js

@@ -1,8 +1,8 @@
 import { SYNC_TASK_EXECUTE, SYNC_TASK_START, SYNC_TASK_STOP } from '../logger/constants';
 /**
  * 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.
+ * The task can be also executed by calling the "execute" method. Multiple execute calls are chained to run secuentially and avoid race conditions.
+ * For example, submitters executed on SDK destroy or full queue, while periodic execution is pending.
  *
  * @param log  Logger instance.
  * @param task  Task to execute that returns a promise that NEVER REJECTS. Otherwise, periodic execution can result in Unhandled Promise Rejections.
@@ -12,8 +12,8 @@ import { SYNC_TASK_EXECUTE, SYNC_TASK_START, SYNC_TASK_STOP } from '../logger/co
  */
 export function syncTaskFactory(log, task, period, taskName) {
     if (taskName === void 0) { taskName = 'task'; }
-    // Flag that indicates if the task is being executed
-    var executing = false;
+    // Task promise while it is pending. Undefined once the promise is resolved
+    var pendingTask;
     // flag that indicates if the task periodic execution has been started/stopped.
     var running = false;
     // Auxiliar counter used to avoid race condition when calling `start` & `stop` intermittently
@@ -27,13 +27,19 @@ export function syncTaskFactory(log, task, period, taskName) {
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        executing = true;
+        // If task is executing, chain the new execution
+        if (pendingTask) {
+            return pendingTask.then(function () {
+                return execute.apply(void 0, args);
+            });
+        }
+        // Execute task
         log.debug(SYNC_TASK_EXECUTE, [taskName]);
-        return task.apply(void 0, args).then(function (result) {
-            executing = false;
+        pendingTask = task.apply(void 0, args).then(function (result) {
+            pendingTask = undefined;
             return result;
         });
-        // No need to handle promise rejection because it is a pre-condition that provided task never rejects.
+        return pendingTask;
     }
     function periodicExecute(currentRunningId) {
         return execute.apply(void 0, runningArgs).then(function (result) {
@@ -45,10 +51,9 @@ export function syncTaskFactory(log, task, period, taskName) {
         });
     }
     return {
-        // @TODO check if we need to queued `execute` calls, to avoid possible race conditions on submitters and updaters with streaming.
         execute: execute,
         isExecuting: function () {
-            return executing;
+            return pendingTask !== undefined;
         },
         start: function () {
             var args = [];

package/esm/utils/settingsValidation/index.js

@@ -70,7 +70,8 @@ export var base = {
         splitFilters: undefined,
         // impressions collection mode
         impressionsMode: OPTIMIZED,
-        localhostMode: undefined
+        localhostMode: undefined,
+        enabled: true
     },
     // Logger
     log: undefined
@@ -164,6 +165,10 @@ export function settingsValidation(config, validationParams) {
         // We are not checking if bases are positive numbers. Thus, we might be reauthenticating immediately (`setTimeout` with NaN or negative number)
         scheduler.pushRetryBackoffBase = fromSecondsToMillis(scheduler.pushRetryBackoffBase);
     }
+    // validate sync enabled
+    if (withDefaults.sync.enabled !== false) { // @ts-ignore, modify readonly prop
+        withDefaults.sync.enabled = true;
+    }
     // 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.1-rc.2",
+  "version": "1.4.2-rc.1",
   "description": "Split Javascript SDK common components",
   "main": "cjs/index.js",
   "module": "esm/index.js",

package/src/consent/sdkUserConsent.ts

@@ -34,9 +34,10 @@ export function createUserConsentAPI(params: ISdkFactoryContext) {
         settings.userConsent = newConsentStatus;
 
         if (consent) { // resumes submitters if transitioning to GRANTED
-          syncManager?.submitter?.start();
-        } else { // pauses submitters and drops tracked data if transitioning to DECLINED
-          syncManager?.submitter?.stop();
+          syncManager?.submitterManager?.start();
+        } else { // pauses submitters (except telemetry), and drops tracked data if transitioning to DECLINED
+          syncManager?.submitterManager?.stop(true);
+
           // @ts-ignore, clear method is present in storage for standalone and partial consumer mode
           if (events.clear) events.clear(); // @ts-ignore
           if (impressions.clear) impressions.clear();

package/src/listeners/browser.ts

@@ -67,7 +67,7 @@ export class BrowserSignalListener implements ISignalListener {
   flushData() {
     if (!this.syncManager) return; // In consumer mode there is not sync manager and data to flush
 
-    // Flush data if there is user consent
+    // Flush impressions & events data if there is user consent
     if (isConsentGranted(this.settings)) {
       const eventsUrl = this.settings.urls.events;
       const extraMetadata = {
@@ -78,11 +78,13 @@ export class BrowserSignalListener implements ISignalListener {
       this._flushData(eventsUrl + '/testImpressions/beacon', this.storage.impressions, this.serviceApi.postTestImpressionsBulk, this.fromImpressionsCollector, extraMetadata);
       this._flushData(eventsUrl + '/events/beacon', this.storage.events, this.serviceApi.postEventsBulk);
       if (this.storage.impressionCounts) this._flushData(eventsUrl + '/testImpressions/count/beacon', this.storage.impressionCounts, this.serviceApi.postTestImpressionsCount, fromImpressionCountsCollector);
-      if (this.storage.telemetry) {
-        const telemetryUrl = this.settings.urls.telemetry;
-        const telemetryCacheAdapter = telemetryCacheStatsAdapter(this.storage.telemetry, this.storage.splits, this.storage.segments);
-        this._flushData(telemetryUrl + '/v1/metrics/usage/beacon', telemetryCacheAdapter, this.serviceApi.postMetricsUsage);
-      }
+    }
+
+    // Flush telemetry data
+    if (this.storage.telemetry) {
+      const telemetryUrl = this.settings.urls.telemetry;
+      const telemetryCacheAdapter = telemetryCacheStatsAdapter(this.storage.telemetry, this.storage.splits, this.storage.segments);
+      this._flushData(telemetryUrl + '/v1/metrics/usage/beacon', telemetryCacheAdapter, this.serviceApi.postMetricsUsage);
     }
 
     // Close streaming connection

package/src/sdkClient/clientAttributesDecoration.ts

@@ -5,7 +5,7 @@ import { ILogger } from '../logger/types';
 import { objectAssign } from '../utils/lang/objectAssign';
 
 /**
- * Add in memory attributes storage methods and combine them with any attribute received from the getTreatment/s call 
+ * Add in memory attributes storage methods and combine them with any attribute received from the getTreatment/s call
  */
 export function clientAttributesDecoration<TClient extends SplitIO.IClient | SplitIO.IAsyncClient>(log: ILogger, client: TClient) {
 
@@ -52,10 +52,10 @@ export function clientAttributesDecoration<TClient extends SplitIO.IClient | Spl
     getTreatments: getTreatments,
     getTreatmentsWithConfig: getTreatmentsWithConfig,
     track: track,
-    
+
     /**
      * Add an attribute to client's in memory attributes storage
-     * 
+     *
      * @param {string} attributeName Attrinute name
      * @param {string, number, boolean, list} attributeValue Attribute value
      * @returns {boolean} true if the attribute was stored and false otherways
@@ -70,7 +70,7 @@ export function clientAttributesDecoration<TClient extends SplitIO.IClient | Spl
 
     /**
      * Returns the attribute with the given key
-     * 
+     *
      * @param {string} attributeName Attribute name
      * @returns {Object} Attribute with the given key
      */
@@ -81,7 +81,7 @@ export function clientAttributesDecoration<TClient extends SplitIO.IClient | Spl
 
     /**
      * Add to client's in memory attributes storage the attributes in 'attributes'
-     * 
+     *
      * @param {Object} attributes Object with attributes to store
      * @returns true if attributes were stored an false otherways
      */
@@ -92,7 +92,7 @@ export function clientAttributesDecoration<TClient extends SplitIO.IClient | Spl
 
     /**
      * Return all the attributes stored in client's in memory attributes storage
-     * 
+     *
      * @returns {Object} returns all the stored attributes
      */
     getAttributes(): Record<string, Object> {
@@ -101,8 +101,8 @@ export function clientAttributesDecoration<TClient extends SplitIO.IClient | Spl
 
     /**
      * Removes from client's in memory attributes storage the attribute with the given key
-     * 
-     * @param {string} attributeName 
+     *
+     * @param {string} attributeName
      * @returns {boolean} true if attribute was removed and false otherways
      */
     removeAttribute(attributeName: string) {
@@ -116,7 +116,7 @@ export function clientAttributesDecoration<TClient extends SplitIO.IClient | Spl
     clearAttributes() {
       return attributeStorage.clear();
     }
-    
+
   });
 
 }

package/src/sync/submitters/submitterManager.ts

@@ -1,11 +1,11 @@
-import { syncTaskComposite } from '../syncTaskComposite';
 import { eventsSubmitterFactory } from './eventsSubmitter';
 import { impressionsSubmitterFactory } from './impressionsSubmitter';
 import { impressionCountsSubmitterFactory } from './impressionCountsSubmitter';
 import { telemetrySubmitterFactory } from './telemetrySubmitter';
 import { ISdkFactoryContextSync } from '../../sdkFactory/types';
+import { ISubmitterManager } from './types';
 
-export function submitterManagerFactory(params: ISdkFactoryContextSync) {
+export function submitterManagerFactory(params: ISdkFactoryContextSync): ISubmitterManager {
 
   const submitters = [
     impressionsSubmitterFactory(params),
@@ -15,7 +15,33 @@ export function submitterManagerFactory(params: ISdkFactoryContextSync) {
   const impressionCountsSubmitter = impressionCountsSubmitterFactory(params);
   if (impressionCountsSubmitter) submitters.push(impressionCountsSubmitter);
   const telemetrySubmitter = telemetrySubmitterFactory(params);
-  if (telemetrySubmitter) submitters.push(telemetrySubmitter);
 
-  return syncTaskComposite(submitters);
+  return {
+    // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
+    start(onlyTelemetry?: boolean) {
+      if (!onlyTelemetry) submitters.forEach(submitter => submitter.start());
+      if (telemetrySubmitter) telemetrySubmitter.start();
+    },
+
+    // `allExceptTelemetry` true if userConsent is changed to DECLINED
+    stop(allExceptTelemetry?: boolean) {
+      submitters.forEach(submitter => submitter.stop());
+      if (!allExceptTelemetry && telemetrySubmitter) telemetrySubmitter.stop();
+    },
+
+    isRunning() {
+      return submitters.some(submitter => submitter.isRunning());
+    },
+
+    // Flush data. Called with `onlyTelemetry` true if SDK is destroyed with userConsent not GRANTED
+    execute(onlyTelemetry?: boolean) {
+      const promises = onlyTelemetry ? [] : submitters.map(submitter => submitter.execute());
+      if (telemetrySubmitter) promises.push(telemetrySubmitter.execute());
+      return Promise.all(promises);
+    },
+
+    isExecuting() {
+      return submitters.some(submitter => submitter.isExecuting());
+    }
+  };
 }

package/src/sync/submitters/types.ts

@@ -1,5 +1,6 @@
 import { IMetadata } from '../../dtos/types';
 import { SplitIO } from '../../types';
+import { ISyncTask } from '../types';
 
 export type ImpressionsPayload = {
   /** Split name */
@@ -191,3 +192,9 @@ export type TelemetryConfigStatsPayload = TelemetryConfigStats & {
   i?: Array<string>, // integrations
   uC: number, // userConsent
 }
+
+export interface ISubmitterManager extends ISyncTask {
+  start(onlyTelemetry?: boolean): void,
+  stop(allExceptTelemetry?: boolean): void,
+  execute(onlyTelemetry?: boolean): Promise<any>
+}

package/src/sync/syncManagerOnline.ts

@@ -28,19 +28,19 @@ export function syncManagerOnlineFactory(
    */
   return function (params: ISdkFactoryContextSync): ISyncManagerCS {
 
-    const { settings, settings: { log, streamingEnabled }, telemetryTracker } = params;
+    const { settings, settings: { log, streamingEnabled, sync: { enabled: syncEnabled } },  telemetryTracker } = params;
 
     /** Polling Manager */
     const pollingManager = pollingManagerFactory && pollingManagerFactory(params);
 
     /** Push Manager */
-    const pushManager = streamingEnabled && pollingManager && pushManagerFactory ?
+    const pushManager = syncEnabled && streamingEnabled && pollingManager && pushManagerFactory ?
       pushManagerFactory(params, pollingManager) :
       undefined;
 
     /** Submitter Manager */
     // It is not inyected as push and polling managers, because at the moment it is required
-    const submitter = submitterManagerFactory(params);
+    const submitterManager = submitterManagerFactory(params);
 
     /** Sync Manager logic */
 
@@ -79,7 +79,7 @@ export function syncManagerOnlineFactory(
       // E.g.: user consent, app state changes (Page hide, Foreground/Background, Online/Offline).
       pollingManager,
       pushManager,
-      submitter,
+      submitterManager,
 
       /**
        * Method used to start the syncManager for the first time, or resume it after being stopped.
@@ -89,20 +89,29 @@ export function syncManagerOnlineFactory(
 
         // start syncing splits and segments
         if (pollingManager) {
-          if (pushManager) {
-            // Doesn't call `syncAll` when the syncManager is resuming
+
+          // If synchronization is disabled pushManager and pollingManager should not start
+          if (syncEnabled) {
+            if (pushManager) {
+              // Doesn't call `syncAll` when the syncManager is resuming
+              if (startFirstTime) {
+                pollingManager.syncAll();
+                startFirstTime = false;
+              }
+              pushManager.start();
+            } else {
+              pollingManager.start();
+            }
+          } else {
             if (startFirstTime) {
               pollingManager.syncAll();
               startFirstTime = false;
             }
-            pushManager.start();
-          } else {
-            pollingManager.start();
           }
         }
 
         // start periodic data recording (events, impressions, telemetry).
-        if (isConsentGranted(settings)) submitter.start();
+        submitterManager.start(!isConsentGranted(settings));
       },
 
       /**
@@ -116,7 +125,7 @@ export function syncManagerOnlineFactory(
         if (pollingManager && pollingManager.isRunning()) pollingManager.stop();
 
         // stop periodic data recording (events, impressions, telemetry).
-        submitter.stop();
+        submitterManager.stop();
       },
 
       isRunning() {
@@ -124,8 +133,7 @@ export function syncManagerOnlineFactory(
       },
 
       flush() {
-        if (isConsentGranted(settings)) return submitter.execute();
-        else return Promise.resolve();
+        return submitterManager.execute(!isConsentGranted(settings));
       },
 
       // [Only used for client-side]
@@ -138,18 +146,22 @@ export function syncManagerOnlineFactory(
         return {
           isRunning: mySegmentsSyncTask.isRunning,
           start() {
-            if (pushManager) {
-              if (pollingManager!.isRunning()) {
-                // if doing polling, we must start the periodic fetch of data
-                if (storage.splits.usesSegments()) mySegmentsSyncTask.start();
+            if (syncEnabled) {
+              if (pushManager) {
+                if (pollingManager!.isRunning()) {
+                  // if doing polling, we must start the periodic fetch of data
+                  if (storage.splits.usesSegments()) mySegmentsSyncTask.start();
+                } else {
+                  // if not polling, we must execute the sync task for the initial fetch
+                  // of segments since `syncAll` was already executed when starting the main client
+                  mySegmentsSyncTask.execute();
+                }
+                pushManager.add(matchingKey, mySegmentsSyncTask);
               } else {
-                // if not polling, we must execute the sync task for the initial fetch
-                // of segments since `syncAll` was already executed when starting the main client
-                mySegmentsSyncTask.execute();
+                if (storage.splits.usesSegments()) mySegmentsSyncTask.start();
               }
-              pushManager.add(matchingKey, mySegmentsSyncTask);
             } else {
-              if (storage.splits.usesSegments()) mySegmentsSyncTask.start();
+              if (!readinessManager.isReady()) mySegmentsSyncTask.execute();
             }
           },
           stop() {

package/src/sync/syncTask.ts

@@ -4,8 +4,8 @@ import { ISyncTask } from './types';
 
 /**
  * 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.
+ * The task can be also executed by calling the "execute" method. Multiple execute calls are chained to run secuentially and avoid race conditions.
+ * For example, submitters executed on SDK destroy or full queue, while periodic execution is pending.
  *
  * @param log  Logger instance.
  * @param task  Task to execute that returns a promise that NEVER REJECTS. Otherwise, periodic execution can result in Unhandled Promise Rejections.
@@ -15,8 +15,8 @@ import { ISyncTask } from './types';
  */
 export function syncTaskFactory<Input extends any[], Output = any>(log: ILogger, task: (...args: Input) => Promise<Output>, period: number, taskName = 'task'): ISyncTask<Input, Output> {
 
-  // Flag that indicates if the task is being executed
-  let executing = false;
+  // Task promise while it is pending. Undefined once the promise is resolved
+  let pendingTask: Promise<Output> | undefined;
   // flag that indicates if the task periodic execution has been started/stopped.
   let running = false;
   // Auxiliar counter used to avoid race condition when calling `start` & `stop` intermittently
@@ -26,14 +26,21 @@ export function syncTaskFactory<Input extends any[], Output = any>(log: ILogger,
   // Id of the periodic call timeout
   let timeoutID: any;
 
-  function execute(...args: Input) {
-    executing = true;
+  function execute(...args: Input): Promise<Output> {
+    // If task is executing, chain the new execution
+    if (pendingTask) {
+      return pendingTask.then(() => {
+        return execute(...args);
+      });
+    }
+
+    // Execute task
     log.debug(SYNC_TASK_EXECUTE, [taskName]);
-    return task(...args).then(result => {
-      executing = false;
+    pendingTask = task(...args).then(result => {
+      pendingTask = undefined;
       return result;
     });
-    // No need to handle promise rejection because it is a pre-condition that provided task never rejects.
+    return pendingTask;
   }
 
   function periodicExecute(currentRunningId: number) {
@@ -46,11 +53,10 @@ export function syncTaskFactory<Input extends any[], Output = any>(log: ILogger,
   }
 
   return {
-    // @TODO check if we need to queued `execute` calls, to avoid possible race conditions on submitters and updaters with streaming.
     execute,
 
     isExecuting() {
-      return executing;
+      return pendingTask !== undefined;
     },
 
     start(...args: Input) {

package/src/sync/types.ts

@@ -2,6 +2,7 @@ import { IReadinessManager } from '../readiness/types';
 import { IStorageSync } from '../storages/types';
 import { IPollingManager } from './polling/types';
 import { IPushManager } from './streaming/types';
+import { ISubmitterManager } from './submitters/types';
 
 export interface ITask<Input extends any[] = []> {
   /**
@@ -39,7 +40,7 @@ export interface ISyncManager extends ITask {
   flush(): Promise<any>,
   pushManager?: IPushManager,
   pollingManager?: IPollingManager,
-  submitter?: ISyncTask
+  submitterManager?: ISubmitterManager
 }
 
 export interface ISyncManagerCS extends ISyncManager {

package/src/types.ts

@@ -117,7 +117,8 @@ export interface ISettings {
     splitFilters: SplitIO.SplitFilter[],
     impressionsMode: SplitIO.ImpressionsMode,
     __splitFiltersValidation: ISplitFiltersValidation,
-    localhostMode?: SplitIO.LocalhostFactory
+    localhostMode?: SplitIO.LocalhostFactory,
+    enabled: boolean
   },
   readonly runtime: {
     ip: string | false
@@ -214,6 +215,11 @@ interface ISharedSettings {
      * @default 'OPTIMIZED'
      */
     impressionsMode?: SplitIO.ImpressionsMode,
+    /**
+     * Enables synchronization.
+     * @property {boolean} enabled
+     */
+    enabled: boolean
   }
 }
 /**

package/src/utils/settingsValidation/index.ts

@@ -83,7 +83,8 @@ export const base = {
     splitFilters: undefined,
     // impressions collection mode
     impressionsMode: OPTIMIZED,
-    localhostMode: undefined
+    localhostMode: undefined,
+    enabled: true
   },
 
   // Logger
@@ -191,6 +192,11 @@ export function settingsValidation(config: unknown, validationParams: ISettingsV
     scheduler.pushRetryBackoffBase = fromSecondsToMillis(scheduler.pushRetryBackoffBase);
   }
 
+  // validate sync enabled
+  if (withDefaults.sync.enabled !== false) { // @ts-ignore, modify readonly prop
+    withDefaults.sync.enabled = true;
+  }
+
   // 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/autoRequire.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Auto-require script to use with GaToSplit integration
+ */
+export declare function autoRequire(): void;

package/types/sync/submitters/submitterManager.d.ts

@@ -1,2 +1,3 @@
 import { ISdkFactoryContextSync } from '../../sdkFactory/types';
-export declare function submitterManagerFactory(params: ISdkFactoryContextSync): import("../types").ISyncTask<[], any>;
+import { ISubmitterManager } from './types';
+export declare function submitterManagerFactory(params: ISdkFactoryContextSync): ISubmitterManager;

package/types/sync/submitters/types.d.ts

@@ -1,5 +1,6 @@
 import { IMetadata } from '../../dtos/types';
 import { SplitIO } from '../../types';
+import { ISyncTask } from '../types';
 export declare type ImpressionsPayload = {
     /** Split name */
     f: string;
@@ -169,3 +170,8 @@ export declare type TelemetryConfigStatsPayload = TelemetryConfigStats & {
     i?: Array<string>;
     uC: number;
 };
+export interface ISubmitterManager extends ISyncTask {
+    start(onlyTelemetry?: boolean): void;
+    stop(allExceptTelemetry?: boolean): void;
+    execute(onlyTelemetry?: boolean): Promise<any>;
+}

package/types/sync/syncTask.d.ts

@@ -2,8 +2,8 @@ import { ILogger } from '../logger/types';
 import { ISyncTask } from './types';
 /**
  * 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.
+ * The task can be also executed by calling the "execute" method. Multiple execute calls are chained to run secuentially and avoid race conditions.
+ * For example, submitters executed on SDK destroy or full queue, while periodic execution is pending.
  *
  * @param log  Logger instance.
  * @param task  Task to execute that returns a promise that NEVER REJECTS. Otherwise, periodic execution can result in Unhandled Promise Rejections.

package/types/sync/types.d.ts

@@ -2,6 +2,7 @@ import { IReadinessManager } from '../readiness/types';
 import { IStorageSync } from '../storages/types';
 import { IPollingManager } from './polling/types';
 import { IPushManager } from './streaming/types';
+import { ISubmitterManager } from './submitters/types';
 export interface ITask<Input extends any[] = []> {
     /**
      * Start periodic execution of the task
@@ -35,7 +36,7 @@ export interface ISyncManager extends ITask {
     flush(): Promise<any>;
     pushManager?: IPushManager;
     pollingManager?: IPollingManager;
-    submitter?: ISyncTask;
+    submitterManager?: ISubmitterManager;
 }
 export interface ISyncManagerCS extends ISyncManager {
     shared(matchingKey: string, readinessManager: IReadinessManager, storage: IStorageSync): ISyncManager | undefined;

package/types/types.d.ts

@@ -112,6 +112,7 @@ export interface ISettings {
         impressionsMode: SplitIO.ImpressionsMode;
         __splitFiltersValidation: ISplitFiltersValidation;
         localhostMode?: SplitIO.LocalhostFactory;
+        enabled: boolean;
     };
     readonly runtime: {
         ip: string | false;
@@ -208,6 +209,11 @@ interface ISharedSettings {
          * @default 'OPTIMIZED'
          */
         impressionsMode?: SplitIO.ImpressionsMode;
+        /**
+         * Enables synchronization.
+         * @property {boolean} enabled
+         */
+        enabled: boolean;
     };
 }
 /**

package/types/utils/settingsValidation/index.d.ts

@@ -37,6 +37,7 @@ export declare const base: {
         splitFilters: undefined;
         impressionsMode: string;
         localhostMode: undefined;
+        enabled: boolean;
     };
     log: undefined;
 };

package/cjs/sync/syncTaskComposite.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.syncTaskComposite = void 0;
-/**
- * Composite Sync Task: group of sync tasks that are treated as a single one.
- */
-function syncTaskComposite(syncTasks) {
-    return {
-        start: function () {
-            syncTasks.forEach(function (syncTask) { return syncTask.start(); });
-        },
-        stop: function () {
-            syncTasks.forEach(function (syncTask) { return syncTask.stop(); });
-        },
-        isRunning: function () {
-            return syncTasks.some(function (syncTask) { return syncTask.isRunning(); });
-        },
-        execute: function () {
-            return Promise.all(syncTasks.map(function (syncTask) { return syncTask.execute(); }));
-        },
-        isExecuting: function () {
-            return syncTasks.some(function (syncTask) { return syncTask.isExecuting(); });
-        }
-    };
-}
-exports.syncTaskComposite = syncTaskComposite;

package/esm/sync/syncTaskComposite.js

@@ -1,22 +0,0 @@
-/**
- * Composite Sync Task: group of sync tasks that are treated as a single one.
- */
-export function syncTaskComposite(syncTasks) {
-    return {
-        start: function () {
-            syncTasks.forEach(function (syncTask) { return syncTask.start(); });
-        },
-        stop: function () {
-            syncTasks.forEach(function (syncTask) { return syncTask.stop(); });
-        },
-        isRunning: function () {
-            return syncTasks.some(function (syncTask) { return syncTask.isRunning(); });
-        },
-        execute: function () {
-            return Promise.all(syncTasks.map(function (syncTask) { return syncTask.execute(); }));
-        },
-        isExecuting: function () {
-            return syncTasks.some(function (syncTask) { return syncTask.isExecuting(); });
-        }
-    };
-}

package/src/sync/syncTaskComposite.ts

@@ -1,26 +0,0 @@
-import { ISyncTask } from './types';
-
-/**
- * Composite Sync Task: group of sync tasks that are treated as a single one.
- */
-export function syncTaskComposite(syncTasks: ISyncTask[]): ISyncTask {
-
-  return {
-    start() {
-      syncTasks.forEach(syncTask => syncTask.start());
-    },
-    stop() {
-      syncTasks.forEach(syncTask => syncTask.stop());
-    },
-    isRunning() {
-      return syncTasks.some(syncTask => syncTask.isRunning());
-    },
-    execute() {
-      return Promise.all(syncTasks.map(syncTask => syncTask.execute()));
-    },
-    isExecuting() {
-      return syncTasks.some(syncTask => syncTask.isExecuting());
-    }
-  };
-
-}