@splitsoftware/splitio-commons 1.2.1-rc.1 → 1.2.1-rc.10

package/cjs/sync/streaming/SSEHandler/index.js

@@ -25,7 +25,7 @@ function isRetryableError(error) {
  * @param pushEmitter emitter for events related to streaming support
  */
 function SSEHandlerFactory(log, pushEmitter) {
-    var notificationKeeper = NotificationKeeper_1.notificationKeeperFactory(pushEmitter);
+    var notificationKeeper = (0, NotificationKeeper_1.notificationKeeperFactory)(pushEmitter);
     return {
         handleOpen: function () {
             notificationKeeper.handleOpen();
@@ -34,7 +34,7 @@ function SSEHandlerFactory(log, pushEmitter) {
         handleError: function (error) {
             var errorWithParsedData = error;
             try {
-                errorWithParsedData = NotificationParser_1.errorParser(error);
+                errorWithParsedData = (0, NotificationParser_1.errorParser)(error);
             }
             catch (err) {
                 log.warn(constants_2.STREAMING_PARSING_ERROR_FAILS, [err]);
@@ -52,7 +52,7 @@ function SSEHandlerFactory(log, pushEmitter) {
         handleMessage: function (message) {
             var messageWithParsedData;
             try {
-                messageWithParsedData = NotificationParser_1.messageParser(message);
+                messageWithParsedData = (0, NotificationParser_1.messageParser)(message);
                 if (!messageWithParsedData)
                     return; // Messages with empty data are ignored
             }

package/cjs/sync/streaming/mySegmentsV2utils.js

@@ -21,7 +21,7 @@ function StringToUint8Array(myString) {
  * @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 = base64_1.decodeFromBase64(data);
+    var compressData = (0, base64_1.decodeFromBase64)(data);
     var binData = StringToUint8Array(compressData);
     if (typeof decompress_1.algorithms === 'string')
         throw new Error(decompress_1.algorithms);

package/cjs/sync/streaming/pushManager.js

@@ -26,7 +26,7 @@ function pushManagerFactory(params, pollingManager) {
     var settings = params.settings, storage = params.storage, splitApi = params.splitApi, readiness = params.readiness, platform = params.platform;
     // `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 ? key_1.getMatching(settings.core.key) : undefined;
+    var userKey = settings.core.key ? (0, key_1.getMatching)(settings.core.key) : undefined;
     var log = settings.log;
     var sseClient;
     try {
@@ -37,10 +37,10 @@ function pushManagerFactory(params, pollingManager) {
         log.warn(constants_2.STREAMING_FALLBACK, [e]);
         return;
     }
-    var authenticate = AuthClient_1.authenticateFactory(splitApi.fetchAuth);
+    var authenticate = (0, AuthClient_1.authenticateFactory)(splitApi.fetchAuth);
     // init feedback loop
     var pushEmitter = new platform.EventEmitter();
-    var sseHandler = SSEHandler_1.SSEHandlerFactory(log, pushEmitter);
+    var sseHandler = (0, SSEHandler_1.SSEHandlerFactory)(log, pushEmitter);
     sseClient.setEventHandler(sseHandler);
     // init workers
     // MySegmentsUpdateWorker (client-side) are initiated in `add` method
@@ -58,6 +58,7 @@ function pushManagerFactory(params, pollingManager) {
     // 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.
+    // true if STREAMING_DISABLED control event, or 'pushEnabled: false', or non-recoverable SSE or Auth errors.
     var disabled; // `disabled` implies `disconnected === true`
     /** PushManager functions related to initialization */
     var connectPushRetryBackoff = new Backoff_1.Backoff(connectPush, settings.scheduler.pushRetryBackoffBase);
@@ -138,7 +139,7 @@ function pushManagerFactory(params, pollingManager) {
     function stopWorkers() {
         splitsUpdateWorker.backoff.reset();
         if (userKey)
-            lang_1.forOwn(clients, function (_a) {
+            (0, lang_1.forOwn)(clients, function (_a) {
                 var worker = _a.worker;
                 return worker.backoff.reset();
             });
@@ -194,15 +195,15 @@ function pushManagerFactory(params, pollingManager) {
                 case types_1.UpdateStrategy.BoundedFetchRequest: {
                     var bitmap_1;
                     try {
-                        bitmap_1 = mySegmentsV2utils_1.parseBitmap(parsedData.d, parsedData.c);
+                        bitmap_1 = (0, mySegmentsV2utils_1.parseBitmap)(parsedData.d, parsedData.c);
                     }
                     catch (e) {
                         log.warn(constants_2.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2, ['BoundedFetchRequest', e]);
                         break;
                     }
-                    lang_1.forOwn(clients, function (_a) {
+                    (0, lang_1.forOwn)(clients, function (_a) {
                         var hash64 = _a.hash64, worker = _a.worker;
-                        if (mySegmentsV2utils_1.isInBitmap(bitmap_1, hash64.hex)) {
+                        if ((0, mySegmentsV2utils_1.isInBitmap)(bitmap_1, hash64.hex)) {
                             worker.put(parsedData.changeNumber); // fetch mySegments
                         }
                     });
@@ -211,7 +212,7 @@ function pushManagerFactory(params, pollingManager) {
                 case types_1.UpdateStrategy.KeyList: {
                     var keyList = void 0, added_1, removed_1;
                     try {
-                        keyList = mySegmentsV2utils_1.parseKeyList(parsedData.d, parsedData.c);
+                        keyList = (0, mySegmentsV2utils_1.parseKeyList)(parsedData.d, parsedData.c);
                         added_1 = new sets_1._Set(keyList.a);
                         removed_1 = new sets_1._Set(keyList.r);
                     }
@@ -219,7 +220,7 @@ function pushManagerFactory(params, pollingManager) {
                         log.warn(constants_2.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2, ['KeyList', e]);
                         break;
                     }
-                    lang_1.forOwn(clients, function (_a) {
+                    (0, lang_1.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) {
@@ -236,7 +237,7 @@ function pushManagerFactory(params, pollingManager) {
                         log.warn(constants_2.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2, ['SegmentRemoval', 'No segment name was provided']);
                         break;
                     }
-                    lang_1.forOwn(clients, function (_a) {
+                    (0, lang_1.forOwn)(clients, function (_a) {
                         var worker = _a.worker;
                         return worker.put(parsedData.changeNumber, {
                             name: parsedData.segmentName,
@@ -246,7 +247,7 @@ function pushManagerFactory(params, pollingManager) {
                     return;
             }
             // `UpdateStrategy.UnboundedFetchRequest` and fallbacks of other cases
-            lang_1.forOwn(clients, function (_a) {
+            (0, lang_1.forOwn)(clients, function (_a) {
                 var worker = _a.worker;
                 worker.put(parsedData.changeNumber);
             });
@@ -255,16 +256,18 @@ function pushManagerFactory(params, pollingManager) {
     else {
         pushEmitter.on(constants_1.SEGMENT_UPDATE, segmentsUpdateWorker.put);
     }
-    return objectAssign_1.objectAssign(
+    return (0, objectAssign_1.objectAssign)(
     // Expose Event Emitter functionality and Event constants
     Object.create(pushEmitter), {
-        // Stop/pause push mode
+        // Stop/pause push mode.
+        // It doesn't emit events. Neither PUSH_SUBSYSTEM_DOWN to start polling.
         stop: function () {
             disconnectPush(); // `handleNonRetryableError` cannot be used as `stop`, because it emits PUSH_SUBSYSTEM_DOWN event, which starts polling.
             if (userKey)
                 this.remove(userKey); // Necessary to properly resume streaming in client-side (e.g., RN SDK transition to foreground).
         },
-        // Start/resume push mode
+        // Start/resume push mode.
+        // It eventually emits PUSH_SUBSYSTEM_DOWN, that starts polling, or PUSH_SUBSYSTEM_UP, that executes a syncAll
         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)
@@ -275,12 +278,16 @@ function pushManagerFactory(params, pollingManager) {
             else
                 setTimeout(connectPush); // server-side runs in next cycle as in client-side, for consistency with client-side
         },
+        // true/false if start or stop was called last respectively
+        isRunning: function () {
+            return disconnected === false;
+        },
         // [Only for client-side]
         add: function (userKey, mySegmentsSyncTask) {
-            var hash = AuthClient_1.hashUserKey(userKey);
+            var hash = (0, AuthClient_1.hashUserKey)(userKey);
             if (!userKeyHashes[hash]) {
                 userKeyHashes[hash] = userKey;
-                clients[userKey] = { hash64: murmur3_64_1.hash64(userKey), worker: new MySegmentsUpdateWorker_1.MySegmentsUpdateWorker(mySegmentsSyncTask) };
+                clients[userKey] = { hash64: (0, murmur3_64_1.hash64)(userKey), worker: new MySegmentsUpdateWorker_1.MySegmentsUpdateWorker(mySegmentsSyncTask) };
                 connectForNewClient = true; // we must reconnect on start, to listen the channel for the new user key
                 // Reconnects in case of a new client.
                 // Run in next event-loop cycle to save authentication calls
@@ -295,7 +302,7 @@ function pushManagerFactory(params, pollingManager) {
         },
         // [Only for client-side]
         remove: function (userKey) {
-            var hash = AuthClient_1.hashUserKey(userKey);
+            var hash = (0, AuthClient_1.hashUserKey)(userKey);
             delete userKeyHashes[hash];
             delete clients[userKey];
         }

package/cjs/sync/submitters/eventsSyncTask.js

@@ -3,29 +3,41 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.eventsSyncTaskFactory = void 0;
 var submitterSyncTask_1 = require("./submitterSyncTask");
 var constants_1 = require("../../logger/constants");
+var DATA_NAME = 'events';
 /**
  * Sync task that periodically posts tracked events
  */
 function eventsSyncTaskFactory(log, postEventsBulk, eventsCache, eventsPushRate, eventsFirstPushWindow, latencyTracker) {
     // don't retry events.
-    var syncTask = submitterSyncTask_1.submitterSyncTaskFactory(log, postEventsBulk, eventsCache, eventsPushRate, 'queued events', latencyTracker);
-    // Set a timer for the first push of events,
+    var syncTask = (0, submitterSyncTask_1.submitterSyncTaskFactory)(log, postEventsBulk, eventsCache, eventsPushRate, DATA_NAME, latencyTracker);
+    // Set a timer for the first push window of events.
+    // Not implemented in the base submitter or sync task, since this feature is only used by the events submitter.
     if (eventsFirstPushWindow > 0) {
+        var running_1 = false;
         var stopEventPublisherTimeout_1;
         var originalStart_1 = syncTask.start;
         syncTask.start = function () {
+            running_1 = true;
             stopEventPublisherTimeout_1 = setTimeout(originalStart_1, eventsFirstPushWindow);
         };
         var originalStop_1 = syncTask.stop;
         syncTask.stop = function () {
+            running_1 = false;
             clearTimeout(stopEventPublisherTimeout_1);
             originalStop_1();
         };
+        syncTask.isRunning = function () {
+            return running_1;
+        };
     }
-    // register eventsSubmitter to be executed when events cache is full
+    // register events submitter to be executed when events cache is full
     eventsCache.setOnFullQueueCb(function () {
-        log.info(constants_1.SUBMITTERS_PUSH_FULL_EVENTS_QUEUE);
-        syncTask.execute();
+        if (syncTask.isRunning()) {
+            log.info(constants_1.SUBMITTERS_PUSH_FULL_QUEUE, [DATA_NAME]);
+            syncTask.execute();
+        }
+        // If submitter is stopped (e.g., user consent declined or unknown, or app state offline), we don't send the data.
+        // Data will be sent when submitter is resumed.
     });
     return syncTask;
 }

package/cjs/sync/submitters/impressionCountsSyncTask.js

@@ -30,6 +30,6 @@ var IMPRESSIONS_COUNT_RATE = 1800000; // 30 minutes
  */
 function impressionCountsSyncTaskFactory(log, postTestImpressionsCount, impressionCountsCache, latencyTracker) {
     // retry impressions counts only once.
-    return submitterSyncTask_1.submitterSyncTaskFactory(log, postTestImpressionsCount, impressionCountsCache, IMPRESSIONS_COUNT_RATE, 'impression counts', latencyTracker, fromImpressionCountsCollector, 1);
+    return (0, submitterSyncTask_1.submitterSyncTaskFactory)(log, postTestImpressionsCount, impressionCountsCache, IMPRESSIONS_COUNT_RATE, 'impression counts', latencyTracker, fromImpressionCountsCollector, 1);
 }
 exports.impressionCountsSyncTaskFactory = impressionCountsSyncTaskFactory;

package/cjs/sync/submitters/impressionsSyncTask.js

@@ -3,14 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.impressionsSyncTaskFactory = exports.fromImpressionsCollector = void 0;
 var lang_1 = require("../../utils/lang");
 var submitterSyncTask_1 = require("./submitterSyncTask");
+var constants_1 = require("../../logger/constants");
+var DATA_NAME = 'impressions';
 /**
  * Converts `impressions` data from cache into request payload.
  */
 function fromImpressionsCollector(sendLabels, data) {
-    var groupedByFeature = lang_1.groupBy(data, 'feature');
+    var groupedByFeature = (0, lang_1.groupBy)(data, 'feature');
     var dto = [];
     // using forOwn instead of for...in since the last also iterates over prototype enumerables
-    lang_1.forOwn(groupedByFeature, function (value, name) {
+    (0, lang_1.forOwn)(groupedByFeature, function (value, name) {
         dto.push({
             f: name,
             i: value.map(function (entry) {
@@ -36,6 +38,16 @@ exports.fromImpressionsCollector = fromImpressionsCollector;
 function impressionsSyncTaskFactory(log, postTestImpressionsBulk, impressionsCache, impressionsRefreshRate, sendLabels, latencyTracker) {
     if (sendLabels === void 0) { sendLabels = false; }
     // retry impressions only once.
-    return submitterSyncTask_1.submitterSyncTaskFactory(log, postTestImpressionsBulk, impressionsCache, impressionsRefreshRate, 'impressions', latencyTracker, fromImpressionsCollector.bind(undefined, sendLabels), 1);
+    var syncTask = (0, submitterSyncTask_1.submitterSyncTaskFactory)(log, postTestImpressionsBulk, impressionsCache, impressionsRefreshRate, DATA_NAME, latencyTracker, fromImpressionsCollector.bind(undefined, sendLabels), 1);
+    // register impressions submitter to be executed when impressions cache is full
+    impressionsCache.setOnFullQueueCb(function () {
+        if (syncTask.isRunning()) {
+            log.info(constants_1.SUBMITTERS_PUSH_FULL_QUEUE, [DATA_NAME]);
+            syncTask.execute();
+        }
+        // If submitter is stopped (e.g., user consent declined or unknown, or app state offline), we don't send the data.
+        // Data will be sent when submitter is resumed.
+    });
+    return syncTask;
 }
 exports.impressionsSyncTaskFactory = impressionsSyncTaskFactory;

package/cjs/sync/submitters/metricsSyncTask.js

@@ -7,7 +7,7 @@ var submitterSyncTask_1 = require("./submitterSyncTask");
 function fromCache(propertyName) {
     return function (data) {
         var result = [];
-        lang_1.forOwn(data, function (value, key) {
+        (0, lang_1.forOwn)(data, function (value, key) {
             var _a;
             result.push((_a = { name: key }, _a[propertyName] = value, _a));
         });
@@ -18,7 +18,7 @@ function fromCache(propertyName) {
  * Sync task that periodically posts telemetry counts
  */
 function countsSyncTaskFactory(log, postMetricsCounters, countsCache, metricsRefreshRate, latencyTracker) {
-    return submitterSyncTask_1.submitterSyncTaskFactory(log, postMetricsCounters, countsCache, metricsRefreshRate, 'count metrics', latencyTracker, fromCache('delta'));
+    return (0, submitterSyncTask_1.submitterSyncTaskFactory)(log, postMetricsCounters, countsCache, metricsRefreshRate, 'count metrics', latencyTracker, fromCache('delta'));
 }
 exports.countsSyncTaskFactory = countsSyncTaskFactory;
 /**
@@ -26,6 +26,6 @@ exports.countsSyncTaskFactory = countsSyncTaskFactory;
  */
 function latenciesSyncTaskFactory(log, postMetricsLatencies, latenciesCache, metricsRefreshRate, latencyTracker) {
     // don't retry metrics.
-    return submitterSyncTask_1.submitterSyncTaskFactory(log, postMetricsLatencies, latenciesCache, metricsRefreshRate, 'latency metrics', latencyTracker, fromCache('latencies'), 0, true);
+    return (0, submitterSyncTask_1.submitterSyncTaskFactory)(log, postMetricsLatencies, latenciesCache, metricsRefreshRate, 'latency metrics', latencyTracker, fromCache('latencies'), 0, true);
 }
 exports.latenciesSyncTaskFactory = latenciesSyncTaskFactory;

package/cjs/sync/submitters/submitterManager.js

@@ -9,12 +9,12 @@ function submitterManagerFactory(params) {
     var settings = params.settings, storage = params.storage, splitApi = params.splitApi;
     var log = settings.log;
     var submitters = [
-        impressionsSyncTask_1.impressionsSyncTaskFactory(log, splitApi.postTestImpressionsBulk, storage.impressions, settings.scheduler.impressionsRefreshRate, settings.core.labelsEnabled),
-        eventsSyncTask_1.eventsSyncTaskFactory(log, splitApi.postEventsBulk, storage.events, settings.scheduler.eventsPushRate, settings.startup.eventsFirstPushWindow)
+        (0, impressionsSyncTask_1.impressionsSyncTaskFactory)(log, splitApi.postTestImpressionsBulk, storage.impressions, settings.scheduler.impressionsRefreshRate, settings.core.labelsEnabled),
+        (0, eventsSyncTask_1.eventsSyncTaskFactory)(log, splitApi.postEventsBulk, storage.events, settings.scheduler.eventsPushRate, settings.startup.eventsFirstPushWindow)
         // @TODO add telemetry submitter
     ];
     if (storage.impressionCounts)
-        submitters.push(impressionCountsSyncTask_1.impressionCountsSyncTaskFactory(log, splitApi.postTestImpressionsCount, storage.impressionCounts));
-    return syncTaskComposite_1.syncTaskComposite(submitters);
+        submitters.push((0, impressionCountsSyncTask_1.impressionCountsSyncTaskFactory)(log, splitApi.postTestImpressionsCount, storage.impressionCounts));
+    return (0, syncTaskComposite_1.syncTaskComposite)(submitters);
 }
 exports.submitterManagerFactory = submitterManagerFactory;

package/cjs/sync/submitters/submitterSyncTask.js

@@ -39,6 +39,6 @@ function submitterSyncTaskFactory(log, postClient, sourceCache, postRate, dataNa
         // if latencyTracker provided, attach stop callback to postEventsPromise
         return latencyTrackerStop ? postPromise.then(latencyTrackerStop).catch(latencyTrackerStop) : postPromise;
     }
-    return syncTask_1.syncTaskFactory(log, postData, postRate, dataName + ' submitter');
+    return (0, syncTask_1.syncTaskFactory)(log, postData, postRate, dataName + ' submitter');
 }
 exports.submitterSyncTaskFactory = submitterSyncTaskFactory;

package/cjs/sync/syncManagerOnline.js

@@ -4,6 +4,7 @@ exports.syncManagerOnlineFactory = void 0;
 var submitterManager_1 = require("./submitters/submitterManager");
 var constants_1 = require("./streaming/constants");
 var constants_2 = require("../logger/constants");
+var consent_1 = require("../utils/consent");
 /**
  * Online SyncManager factory.
  * Can be used for server-side API, and client-side API with or without multiple clients.
@@ -17,7 +18,7 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
      * SyncManager factory for modular SDK
      */
     return function (params) {
-        var _a = params.settings, log = _a.log, streamingEnabled = _a.streamingEnabled;
+        var settings = params.settings, _a = params.settings, log = _a.log, streamingEnabled = _a.streamingEnabled;
         /** Polling Manager */
         var pollingManager = pollingManagerFactory && pollingManagerFactory(params);
         /** Push Manager */
@@ -26,7 +27,7 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
             undefined;
         /** Submitter Manager */
         // It is not inyected as push and polling managers, because at the moment it is required
-        var submitter = submitterManager_1.submitterManagerFactory(params);
+        var submitter = (0, submitterManager_1.submitterManagerFactory)(params);
         /** Sync Manager logic */
         function startPolling() {
             if (pollingManager.isRunning()) {
@@ -52,11 +53,16 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
         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 {
+            // Exposed for fine-grained control of synchronization.
+            // E.g.: user consent, app state changes (Page hide, Foreground/Background, Online/Offline).
+            pollingManager: pollingManager,
             pushManager: pushManager,
+            submitter: submitter,
             /**
              * Method used to start the syncManager for the first time, or resume it after being stopped.
              */
             start: function () {
+                running = true;
                 // start syncing splits and segments
                 if (pollingManager) {
                     if (pushManager) {
@@ -72,29 +78,27 @@ function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
                     }
                 }
                 // start periodic data recording (events, impressions, telemetry).
-                if (submitter)
+                if ((0, consent_1.isConsentGranted)(settings))
                     submitter.start();
-                running = true;
             },
             /**
              * Method used to stop/pause the syncManager.
              */
             stop: function () {
+                running = false;
                 // stop syncing
                 if (pushManager)
                     pushManager.stop();
                 if (pollingManager && pollingManager.isRunning())
                     pollingManager.stop();
                 // stop periodic data recording (events, impressions, telemetry).
-                if (submitter)
-                    submitter.stop();
-                running = false;
+                submitter.stop();
             },
             isRunning: function () {
                 return running;
             },
             flush: function () {
-                if (submitter)
+                if ((0, consent_1.isConsentGranted)(settings))
                     return submitter.execute();
                 else
                     return Promise.resolve();

package/cjs/trackers/eventTracker.js

@@ -4,13 +4,17 @@ exports.eventTrackerFactory = void 0;
 var objectAssign_1 = require("../utils/lang/objectAssign");
 var thenable_1 = require("../utils/promise/thenable");
 var constants_1 = require("../logger/constants");
+var constants_2 = require("../utils/constants");
+var utils_1 = require("./impressionObserver/utils");
 /**
  * Event tracker stores events in cache and pass them to the integrations manager if provided.
  *
  * @param eventsCache cache to save events
  * @param integrationsManager optional event handler used for integrations
  */
-function eventTrackerFactory(log, eventsCache, integrationsManager) {
+function eventTrackerFactory(settings, eventsCache, integrationsManager) {
+    var log = settings.log;
+    var isSync = (0, utils_1.isStorageSync)(settings);
     function queueEventsCallback(eventData, tracked) {
         var eventTypeId = eventData.eventTypeId, trafficTypeName = eventData.trafficTypeName, key = eventData.key, value = eventData.value, timestamp = eventData.timestamp, properties = eventData.properties;
         // Logging every prop would be too much.
@@ -21,9 +25,9 @@ function eventTrackerFactory(log, eventsCache, integrationsManager) {
                 // Wrap in a timeout because we don't want it to be blocking.
                 setTimeout(function () {
                     // copy of event, to avoid unexpected behaviour if modified by integrations
-                    var eventDataCopy = objectAssign_1.objectAssign({}, eventData);
+                    var eventDataCopy = (0, objectAssign_1.objectAssign)({}, eventData);
                     if (eventData.properties)
-                        eventDataCopy.properties = objectAssign_1.objectAssign({}, eventData.properties);
+                        eventDataCopy.properties = (0, objectAssign_1.objectAssign)({}, eventData.properties);
                     // integrationsManager does not throw errors (they are internally handled by each integration module)
                     integrationsManager.handleEvent(eventDataCopy);
                 }, 0);
@@ -36,8 +40,11 @@ function eventTrackerFactory(log, eventsCache, integrationsManager) {
     }
     return {
         track: function (eventData, size) {
+            if (settings.userConsent === constants_2.CONSENT_DECLINED) {
+                return isSync ? false : Promise.resolve(false);
+            }
             var tracked = eventsCache.track(eventData, size);
-            if (thenable_1.thenable(tracked)) {
+            if ((0, thenable_1.thenable)(tracked)) {
                 return tracked.then(queueEventsCallback.bind(null, eventData));
             }
             else {

package/cjs/trackers/impressionObserver/impressionObserverCS.js

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

package/cjs/trackers/impressionObserver/impressionObserverSS.js

@@ -5,7 +5,7 @@ var ImpressionObserver_1 = require("./ImpressionObserver");
 var murmur3_128_x86_1 = require("../../utils/murmur3/murmur3_128_x86");
 var buildKey_1 = require("./buildKey");
 function hashImpression128(impression) {
-    return murmur3_128_x86_1.hash128(buildKey_1.buildKey(impression));
+    return (0, murmur3_128_x86_1.hash128)((0, buildKey_1.buildKey)(impression));
 }
 exports.hashImpression128 = hashImpression128;
 var LAST_SEEN_CACHE_SIZE = 500000; // cache up to 500k impression hashes

package/cjs/trackers/impressionObserver/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shouldBeOptimized = exports.shouldAddPt = void 0;
+exports.isStorageSync = exports.shouldBeOptimized = exports.shouldAddPt = void 0;
 var constants_1 = require("../../utils/constants");
 /**
  * Checks if impressions previous time should be added or not.
@@ -18,3 +18,10 @@ function shouldBeOptimized(settings) {
     return settings.sync.impressionsMode === constants_1.OPTIMIZED ? true : false;
 }
 exports.shouldBeOptimized = shouldBeOptimized;
+/**
+ * Storage is async if mode is consumer or partial consumer
+ */
+function isStorageSync(settings) {
+    return [constants_1.CONSUMER_MODE, constants_1.CONSUMER_PARTIAL_MODE].indexOf(settings.mode) === -1 ? true : false;
+}
+exports.isStorageSync = isStorageSync;

package/cjs/trackers/impressionsTracker.js

@@ -5,6 +5,7 @@ var objectAssign_1 = require("../utils/lang/objectAssign");
 var thenable_1 = require("../utils/promise/thenable");
 var time_1 = require("../utils/time");
 var constants_1 = require("../logger/constants");
+var constants_2 = require("../utils/constants");
 /**
  * Impressions tracker stores impressions in cache and pass them to the listener and integrations manager if provided.
  *
@@ -15,16 +16,16 @@ var constants_1 = require("../logger/constants");
  * @param observer optional impression observer. If provided, previous time (pt property) is included in impression instances
  * @param countsCache optional cache to save impressions count. If provided, impressions will be deduped (OPTIMIZED mode)
  */
-function impressionsTrackerFactory(log, impressionsCache, 
-// @TODO consider passing only an optional integrationsManager to handle impressions
-_a, impressionListener, integrationsManager, 
+function impressionsTrackerFactory(settings, impressionsCache, integrationsManager, 
 // if observer is provided, it implies `shouldAddPreviousTime` flag (i.e., if impressions previous time should be added or not)
 observer, 
 // if countsCache is provided, it implies `isOptimized` flag (i.e., if impressions should be deduped or not)
 countsCache) {
-    var _b = _a.runtime, ip = _b.ip, hostname = _b.hostname, version = _a.version;
+    var log = settings.log, impressionListener = settings.impressionListener, _a = settings.runtime, ip = _a.ip, hostname = _a.hostname, version = settings.version;
     return {
         track: function (impressions, attributes) {
+            if (settings.userConsent === constants_2.CONSENT_DECLINED)
+                return;
             var impressionsCount = impressions.length;
             var impressionsToStore = []; // Track only the impressions that are going to be stored
             // Wraps impressions to store and adds previousTime if it corresponds
@@ -39,13 +40,13 @@ countsCache) {
                     countsCache.track(impression.feature, now, 1);
                 }
                 // Checks if the impression should be added in queue to be sent
-                if (!countsCache || !impression.pt || impression.pt < time_1.truncateTimeFrame(now)) {
+                if (!countsCache || !impression.pt || impression.pt < (0, time_1.truncateTimeFrame)(now)) {
                     impressionsToStore.push(impression);
                 }
             });
             var res = impressionsCache.track(impressionsToStore);
             // If we're on an async storage, handle error and log it.
-            if (thenable_1.thenable(res)) {
+            if ((0, thenable_1.thenable)(res)) {
                 res.then(function () {
                     log.info(constants_1.IMPRESSIONS_TRACKER_SUCCESS, [impressionsCount]);
                 }).catch(function (err) {
@@ -57,7 +58,7 @@ countsCache) {
                 var _loop_1 = function (i) {
                     var impressionData = {
                         // copy of impression, to avoid unexpected behaviour if modified by integrations or impressionListener
-                        impression: objectAssign_1.objectAssign({}, impressions[i]),
+                        impression: (0, objectAssign_1.objectAssign)({}, impressions[i]),
                         attributes: attributes,
                         ip: ip,
                         hostname: hostname,
@@ -68,7 +69,7 @@ countsCache) {
                         // integrationsManager.handleImpression does not throw errors
                         if (integrationsManager)
                             integrationsManager.handleImpression(impressionData);
-                        try { // An exception on the listeners should not break the SDK.
+                        try { // @ts-ignore. An exception on the listeners should not break the SDK.
                             if (impressionListener)
                                 impressionListener.logImpression(impressionData);
                         }

package/cjs/utils/MinEvents.js

@@ -38,9 +38,10 @@ var ReflectApply = R && typeof R.apply === 'function'
     : function ReflectApply(target, receiver, args) {
         return Function.prototype.apply.call(target, receiver, args);
     };
-exports.EventEmitter = function EventEmitter() {
+var EventEmitter = function EventEmitter() {
     EventEmitter.init.call(this);
 };
+exports.EventEmitter = EventEmitter;
 exports.EventEmitter.prototype._events = undefined;
 exports.EventEmitter.prototype._eventsCount = 0;
 function checkListener(listener) {

package/cjs/utils/consent.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isConsentGranted = void 0;
+var constants_1 = require("./constants");
+function isConsentGranted(settings) {
+    var userConsent = settings.userConsent;
+    // undefined userConsent is handled as granted (default)
+    return !userConsent || userConsent === constants_1.CONSENT_GRANTED;
+}
+exports.isConsentGranted = isConsentGranted;

package/cjs/utils/constants/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STORAGE_PLUGGABLE = exports.STORAGE_REDIS = exports.STORAGE_LOCALSTORAGE = exports.STORAGE_MEMORY = exports.CONSUMER_PARTIAL_MODE = exports.CONSUMER_MODE = exports.PRODUCER_MODE = exports.STANDALONE_MODE = exports.LOCALHOST_MODE = exports.OPTIMIZED = exports.DEBUG = exports.SPLIT_EVENT = exports.SPLIT_IMPRESSION = exports.NA = exports.UNKNOWN = exports.CONTROL_WITH_CONFIG = exports.CONTROL = void 0;
+exports.CONSENT_UNKNOWN = exports.CONSENT_DECLINED = exports.CONSENT_GRANTED = exports.STORAGE_PLUGGABLE = exports.STORAGE_REDIS = exports.STORAGE_LOCALSTORAGE = exports.STORAGE_MEMORY = exports.CONSUMER_PARTIAL_MODE = exports.CONSUMER_MODE = exports.PRODUCER_MODE = exports.STANDALONE_MODE = exports.LOCALHOST_MODE = exports.OPTIMIZED = exports.DEBUG = exports.SPLIT_EVENT = exports.SPLIT_IMPRESSION = exports.NA = exports.UNKNOWN = exports.CONTROL_WITH_CONFIG = exports.CONTROL = void 0;
 // Special treatments
 exports.CONTROL = 'control';
 exports.CONTROL_WITH_CONFIG = {
@@ -27,3 +27,7 @@ exports.STORAGE_MEMORY = 'MEMORY';
 exports.STORAGE_LOCALSTORAGE = 'LOCALSTORAGE';
 exports.STORAGE_REDIS = 'REDIS';
 exports.STORAGE_PLUGGABLE = 'PLUGGABLE';
+// User consent
+exports.CONSENT_GRANTED = 'GRANTED'; // The user has granted consent for tracking events and impressions
+exports.CONSENT_DECLINED = 'DECLINED'; // The user has declined consent for tracking events and impressions
+exports.CONSENT_UNKNOWN = 'UNKNOWN'; // The user has neither granted nor declined consent for tracking events and impressions

package/cjs/utils/inputValidation/apiKey.js

@@ -10,7 +10,7 @@ function validateApiKey(log, maybeApiKey) {
     if (maybeApiKey == undefined) { // eslint-disable-line eqeqeq
         log.error(constants_1.ERROR_NULL, [constants_1.LOG_PREFIX_INSTANTIATION, item]);
     }
-    else if (lang_1.isString(maybeApiKey)) {
+    else if ((0, lang_1.isString)(maybeApiKey)) {
         if (maybeApiKey.length > 0)
             apiKey = maybeApiKey;
         else

package/cjs/utils/inputValidation/attribute.js

@@ -3,13 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateAttribute = void 0;
 var lang_1 = require("../../utils/lang");
 function validateAttribute(log, attributeKey, attributeValue, method) {
-    if (!lang_1.isString(attributeKey) || attributeKey.length === 0) {
+    if (!(0, lang_1.isString)(attributeKey) || attributeKey.length === 0) {
         log.warn(method + ": you passed an invalid attribute name, attribute name must be a non-empty string.");
         return false;
     }
-    var isStringVal = lang_1.isString(attributeValue);
-    var isFiniteVal = lang_1.isFiniteNumber(attributeValue);
-    var isBoolVal = lang_1.isBoolean(attributeValue);
+    var isStringVal = (0, lang_1.isString)(attributeValue);
+    var isFiniteVal = (0, lang_1.isFiniteNumber)(attributeValue);
+    var isBoolVal = (0, lang_1.isBoolean)(attributeValue);
     var isArrayVal = Array.isArray(attributeValue);
     if (!(isStringVal || isFiniteVal || isBoolVal || isArrayVal)) { // If it's not of valid type.
         log.warn(method + ": you passed an invalid attribute value for " + attributeKey + ". Acceptable types are: string, number, boolean and array of strings.");