@splitsoftware/splitio-commons 3.1.1-rc.10 → 3.1.1-rc.12

package/cjs/readiness/readinessManager.js

@@ -3,20 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.readinessManagerFactory = void 0;
 var objectAssign_1 = require("../utils/lang/objectAssign");
 var constants_1 = require("./constants");
-function splitsEventEmitterFactory(EventEmitter) {
-    var splitsEventEmitter = (0, objectAssign_1.objectAssign)(new EventEmitter(), {
-        splitsArrived: false,
-        splitsCacheLoaded: false,
+function definitionsEventEmitterFactory(EventEmitter) {
+    var definitionsEventEmitter = (0, objectAssign_1.objectAssign)(new EventEmitter(), {
+        definitionsArrived: false,
+        definitionsCacheLoaded: false,
         hasInit: false,
         initCallbacks: []
     });
     // `isSplitKill` condition avoids an edge-case of wrongly emitting SDK_READY if:
     // - `/memberships` fetch and SPLIT_KILL occurs before `/splitChanges` fetch, and
     // - storage has cached splits (for which case `splitsStorage.killLocally` can return true)
-    splitsEventEmitter.on(constants_1.SDK_SPLITS_ARRIVED, function (metadata, isSplitKill) { if (!isSplitKill)
-        splitsEventEmitter.splitsArrived = true; });
-    splitsEventEmitter.once(constants_1.SDK_SPLITS_CACHE_LOADED, function () { splitsEventEmitter.splitsCacheLoaded = true; });
-    return splitsEventEmitter;
+    definitionsEventEmitter.on(constants_1.SDK_DEFINITIONS_ARRIVED, function (metadata, isSplitKill) { if (!isSplitKill)
+        definitionsEventEmitter.definitionsArrived = true; });
+    definitionsEventEmitter.once(constants_1.SDK_DEFINITIONS_CACHE_LOADED, function () { definitionsEventEmitter.definitionsCacheLoaded = true; });
+    return definitionsEventEmitter;
 }
 function segmentsEventEmitterFactory(EventEmitter) {
     var segmentsEventEmitter = (0, objectAssign_1.objectAssign)(new EventEmitter(), {
@@ -28,8 +28,8 @@ function segmentsEventEmitterFactory(EventEmitter) {
 /**
  * Factory of readiness manager, which handles the ready / update event propagation.
  */
-function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
-    if (splits === void 0) { splits = splitsEventEmitterFactory(EventEmitter); }
+function readinessManagerFactory(EventEmitter, settings, definitions, isShared) {
+    if (definitions === void 0) { definitions = definitionsEventEmitterFactory(EventEmitter); }
     var readyTimeout = settings.startup.readyTimeout;
     var segments = segmentsEventEmitterFactory(EventEmitter);
     var gate = new EventEmitter();
@@ -44,10 +44,10 @@ function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
     };
     // emit SDK_READY_FROM_CACHE
     var isReadyFromCache = false;
-    if (splits.splitsCacheLoaded)
+    if (definitions.definitionsCacheLoaded)
         isReadyFromCache = true; // ready from cache, but doesn't emit SDK_READY_FROM_CACHE
     else
-        splits.once(constants_1.SDK_SPLITS_CACHE_LOADED, checkIsReadyFromCache);
+        definitions.once(constants_1.SDK_DEFINITIONS_CACHE_LOADED, checkIsReadyFromCache);
     // emit SDK_READY_TIMED_OUT
     var hasTimedout = false;
     function timeout() {
@@ -55,11 +55,11 @@ function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
             return;
         hasTimedout = true;
         syncLastUpdate();
-        gate.emit(constants_1.SDK_READY_TIMED_OUT, 'Split SDK emitted SDK_READY_TIMED_OUT event.');
+        gate.emit(constants_1.SDK_READY_TIMED_OUT, 'SDK client emitted SDK_READY_TIMED_OUT event.');
     }
     // emit SDK_READY and SDK_UPDATE
     var isReady = false;
-    splits.on(constants_1.SDK_SPLITS_ARRIVED, checkIsReadyOrUpdate);
+    definitions.on(constants_1.SDK_DEFINITIONS_ARRIVED, checkIsReadyOrUpdate);
     segments.on(constants_1.SDK_SEGMENTS_ARRIVED, checkIsReadyOrUpdate);
     var isDestroyed = false;
     var readyTimeoutId;
@@ -68,8 +68,8 @@ function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
         if (readyTimeout > 0 && !isReady)
             readyTimeoutId = setTimeout(timeout, readyTimeout);
     }
-    splits.initCallbacks.push(__init);
-    if (splits.hasInit)
+    definitions.initCallbacks.push(__init);
+    if (definitions.hasInit)
         __init();
     function checkIsReadyFromCache(cacheMetadata) {
         metadataReady = cacheMetadata;
@@ -100,7 +100,7 @@ function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
             }
         }
         else {
-            if (splits.splitsArrived && segments.segmentsArrived) {
+            if (definitions.definitionsArrived && segments.segmentsArrived) {
                 clearTimeout(readyTimeoutId);
                 isReady = true;
                 try {
@@ -123,11 +123,11 @@ function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
         }
     }
     return {
-        splits: splits,
+        definitions: definitions,
         segments: segments,
         gate: gate,
         shared: function () {
-            return readinessManagerFactory(EventEmitter, settings, splits, true);
+            return readinessManagerFactory(EventEmitter, settings, definitions, true);
         },
         // @TODO review/remove next methods when non-recoverable errors are reworked
         // Called on consumer mode, when storage fails to connect
@@ -136,17 +136,17 @@ function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
         // tracking and evaluations, while keeping event listeners to emit SDK_READY_TIMED_OUT event
         setDestroyed: function () { isDestroyed = true; },
         init: function () {
-            if (splits.hasInit)
+            if (definitions.hasInit)
                 return;
-            splits.hasInit = true;
-            splits.initCallbacks.forEach(function (cb) { return cb(); });
+            definitions.hasInit = true;
+            definitions.initCallbacks.forEach(function (cb) { return cb(); });
         },
         destroy: function () {
             isDestroyed = true;
             syncLastUpdate();
             clearTimeout(readyTimeoutId);
             if (!isShared)
-                splits.hasInit = false;
+                definitions.hasInit = false;
         },
         isReady: function () { return isReady; },
         isReadyFromCache: function () { return isReadyFromCache; },

package/cjs/readiness/sdkReadinessManager.js

@@ -7,7 +7,6 @@ var readinessManager_1 = require("./readinessManager");
 var constants_1 = require("./constants");
 var constants_2 = require("../logger/constants");
 var NEW_LISTENER_EVENT = 'newListener';
-var REMOVE_LISTENER_EVENT = 'removeListener';
 var TIMEOUT_ERROR = new Error(constants_1.SDK_READY_TIMED_OUT);
 /**
  * SdkReadinessManager factory, which provides the public status API of SDK clients and manager: ready promise, readiness event emitter and constants (SDK_READY, etc).
@@ -19,21 +18,11 @@ var TIMEOUT_ERROR = new Error(constants_1.SDK_READY_TIMED_OUT);
 function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
     if (readinessManager === void 0) { readinessManager = (0, readinessManager_1.readinessManagerFactory)(EventEmitter, settings); }
     var log = settings.log;
-    /** Ready callback warning */
-    var internalReadyCbCount = 0;
-    var readyCbCount = 0;
-    readinessManager.gate.on(REMOVE_LISTENER_EVENT, function (event) {
-        if (event === constants_1.SDK_READY)
-            readyCbCount--;
-    });
     readinessManager.gate.on(NEW_LISTENER_EVENT, function (event) {
         if (event === constants_1.SDK_READY || event === constants_1.SDK_READY_TIMED_OUT) {
             if (readinessManager.isReady()) {
                 log.error(constants_2.ERROR_CLIENT_LISTENER, [event === constants_1.SDK_READY ? 'SDK_READY' : 'SDK_READY_TIMED_OUT']);
             }
-            else if (event === constants_1.SDK_READY) {
-                readyCbCount++;
-            }
         }
         else if (event === constants_1.SDK_READY_FROM_CACHE && readinessManager.isReadyFromCache()) {
             log.error(constants_2.ERROR_CLIENT_LISTENER, ['SDK_READY_FROM_CACHE']);
@@ -52,8 +41,6 @@ function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
         var promise = (0, wrapper_1.promiseWrapper)(new Promise(function (resolve, reject) {
             readinessManager.gate.once(constants_1.SDK_READY, function () {
                 log.info(constants_2.CLIENT_READY);
-                if (readyCbCount === internalReadyCbCount && !promise.hasOnFulfilled())
-                    log.warn(constants_2.CLIENT_NO_LISTENER);
                 resolve();
             });
             readinessManager.gate.once(constants_1.SDK_READY_TIMED_OUT, function (message) {
@@ -78,9 +65,6 @@ function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
         shared: function () {
             return sdkReadinessManagerFactory(EventEmitter, settings, readinessManager.shared());
         },
-        incInternalReadyCbCount: function () {
-            internalReadyCbCount++;
-        },
         sdkStatus: (0, objectAssign_1.objectAssign)(
         // Expose Event Emitter functionality
         Object.create(readinessManager.gate), {
@@ -95,7 +79,7 @@ function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
             ready: function () {
                 if (readinessManager.hasTimedout()) {
                     if (!readinessManager.isReady()) {
-                        return (0, wrapper_1.promiseWrapper)(Promise.reject(new Error('Split SDK has emitted SDK_READY_TIMED_OUT event.')), defaultOnRejected);
+                        return (0, wrapper_1.promiseWrapper)(Promise.reject(new Error('SDK client has emitted SDK_READY_TIMED_OUT event.')), defaultOnRejected);
                     }
                     else {
                         return Promise.resolve();

package/cjs/sdkClient/client.js

@@ -1,15 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.clientFactory = void 0;
+exports.clientFactory = exports.stringify = void 0;
 var evaluator_1 = require("../evaluator");
 var thenable_1 = require("../utils/promise/thenable");
 var key_1 = require("../utils/key");
-var splitExistence_1 = require("../utils/inputValidation/splitExistence");
-var trafficTypeExistence_1 = require("../utils/inputValidation/trafficTypeExistence");
+var definitionExistence_1 = require("../utils/inputValidation/definitionExistence");
 var labels_1 = require("../utils/labels");
 var constants_1 = require("../utils/constants");
 var constants_2 = require("../logger/constants");
 var mode_1 = require("../utils/settingsValidation/mode");
+var trackMethod_1 = require("./trackMethod");
 var treatmentNotReady = { treatment: constants_1.CONTROL, label: labels_1.SDK_NOT_READY };
 function treatmentsNotReady(featureFlagNames) {
     var evaluations = {};
@@ -18,19 +18,20 @@ function treatmentsNotReady(featureFlagNames) {
     });
     return evaluations;
 }
-function stringify(options) {
-    if (options && options.properties) {
+function stringify(properties) {
+    if (properties) {
         try {
-            return JSON.stringify(options.properties);
+            return JSON.stringify(properties);
         }
         catch ( /* JSON.stringify should never throw with validated options, but handling just in case */_a) { /* JSON.stringify should never throw with validated options, but handling just in case */ }
     }
 }
+exports.stringify = stringify;
 /**
  * Creator of base client with getTreatments and track methods.
  */
 function clientFactory(params) {
-    var readinessManager = params.sdkReadinessManager.readinessManager, storage = params.storage, settings = params.settings, impressionsTracker = params.impressionsTracker, eventTracker = params.eventTracker, telemetryTracker = params.telemetryTracker, fallbackTreatmentsCalculator = params.fallbackTreatmentsCalculator;
+    var readinessManager = params.sdkReadinessManager.readinessManager, storage = params.storage, settings = params.settings, impressionsTracker = params.impressionsTracker, telemetryTracker = params.telemetryTracker, fallbackCalculator = params.fallbackCalculator;
     var log = settings.log, mode = settings.mode;
     var isAsync = (0, mode_1.isConsumerMode)(mode);
     function getTreatment(key, featureFlagName, attributes, options, withConfig, methodName) {
@@ -39,13 +40,13 @@ function clientFactory(params) {
         var stopTelemetryTracker = telemetryTracker.trackEval(withConfig ? constants_1.TREATMENT_WITH_CONFIG : constants_1.TREATMENT);
         var wrapUp = function (evaluationResult) {
             var queue = [];
-            var treatment = processEvaluation(evaluationResult, featureFlagName, key, stringify(options), withConfig, methodName, queue);
+            var treatment = processEvaluation(evaluationResult, featureFlagName, key, withConfig, methodName, queue, options);
             impressionsTracker.track(queue, attributes);
             stopTelemetryTracker(queue[0] && queue[0].imp.label);
             return treatment;
         };
         var evaluation = readinessManager.isReadyFromCache() ?
-            (0, evaluator_1.evaluateFeature)(log, key, featureFlagName, attributes, storage, options) :
+            (0, evaluator_1.evaluateFeature)(log, key, featureFlagName, attributes, storage) :
             isAsync ? // If the SDK is not ready, treatment may be incorrect due to having splits but not segments data, or storage is not connected
                 Promise.resolve(treatmentNotReady) :
                 treatmentNotReady;
@@ -61,16 +62,15 @@ function clientFactory(params) {
         var wrapUp = function (evaluationResults) {
             var queue = [];
             var treatments = {};
-            var properties = stringify(options);
             Object.keys(evaluationResults).forEach(function (featureFlagName) {
-                treatments[featureFlagName] = processEvaluation(evaluationResults[featureFlagName], featureFlagName, key, properties, withConfig, methodName, queue);
+                treatments[featureFlagName] = processEvaluation(evaluationResults[featureFlagName], featureFlagName, key, withConfig, methodName, queue, options);
             });
             impressionsTracker.track(queue, attributes);
             stopTelemetryTracker(queue[0] && queue[0].imp.label);
             return treatments;
         };
         var evaluations = readinessManager.isReadyFromCache() ?
-            (0, evaluator_1.evaluateFeatures)(log, key, featureFlagNames, attributes, storage, options) :
+            (0, evaluator_1.evaluateFeatures)(log, key, featureFlagNames, attributes, storage) :
             isAsync ? // If the SDK is not ready, treatment may be incorrect due to having splits but not segments data, or storage is not connected
                 Promise.resolve(treatmentsNotReady(featureFlagNames)) :
                 treatmentsNotReady(featureFlagNames);
@@ -87,16 +87,15 @@ function clientFactory(params) {
         var wrapUp = function (evaluationResults) {
             var queue = [];
             var treatments = {};
-            var properties = stringify(options);
             Object.keys(evaluationResults).forEach(function (featureFlagName) {
-                treatments[featureFlagName] = processEvaluation(evaluationResults[featureFlagName], featureFlagName, key, properties, withConfig, methodName, queue);
+                treatments[featureFlagName] = processEvaluation(evaluationResults[featureFlagName], featureFlagName, key, withConfig, methodName, queue, options);
             });
             impressionsTracker.track(queue, attributes);
             stopTelemetryTracker(queue[0] && queue[0].imp.label);
             return treatments;
         };
         var evaluations = readinessManager.isReadyFromCache() ?
-            (0, evaluator_1.evaluateFeaturesByFlagSets)(log, key, flagSetNames, attributes, storage, methodName, options) :
+            (0, evaluator_1.evaluateFeaturesByFlagSets)(log, key, flagSetNames, attributes, storage, methodName) :
             isAsync ?
                 Promise.resolve({}) :
                 {};
@@ -112,19 +111,20 @@ function clientFactory(params) {
         return getTreatmentsByFlagSets(key, [flagSetName], attributes, options, true, constants_1.TREATMENTS_WITH_CONFIG_BY_FLAGSET, constants_1.GET_TREATMENTS_WITH_CONFIG_BY_FLAG_SET);
     }
     // Internal function
-    function processEvaluation(evaluation, featureFlagName, key, properties, withConfig, invokingMethodName, queue) {
+    function processEvaluation(evaluation, featureFlagName, key, withConfig, invokingMethodName, queue, options) {
+        if (options === void 0) { options = {}; }
         var matchingKey = (0, key_1.getMatching)(key);
         var bucketingKey = (0, key_1.getBucketing)(key);
-        var changeNumber = evaluation.changeNumber, impressionsDisabled = evaluation.impressionsDisabled;
+        var definition = evaluation.definition;
         var treatment = evaluation.treatment, label = evaluation.label, _a = evaluation.config, config = _a === void 0 ? null : _a;
         if (treatment === constants_1.CONTROL) {
-            var fallbackTreatment = fallbackTreatmentsCalculator(featureFlagName, label);
+            var fallbackTreatment = fallbackCalculator(featureFlagName, label);
             treatment = fallbackTreatment.treatment;
             label = fallbackTreatment.label;
             config = fallbackTreatment.config;
         }
-        if ((0, splitExistence_1.validateSplitExistence)(log, readinessManager, featureFlagName, label, invokingMethodName)) {
-            log.info(constants_2.IMPRESSION_QUEUEING, [featureFlagName, matchingKey, treatment, label]);
+        if ((0, definitionExistence_1.validateDefinitionExistence)(log, readinessManager, featureFlagName, label, invokingMethodName)) {
+            log.info(constants_2.IMPRESSION_QUEUEING, ['Feature flag', featureFlagName, matchingKey, treatment, label]);
             queue.push({
                 imp: {
                     feature: featureFlagName,
@@ -133,10 +133,10 @@ function clientFactory(params) {
                     time: Date.now(),
                     bucketingKey: bucketingKey,
                     label: label,
-                    changeNumber: changeNumber,
-                    properties: properties
+                    changeNumber: definition === null || definition === void 0 ? void 0 : definition.changeNumber,
+                    properties: stringify(options.properties)
                 },
-                disabled: impressionsDisabled
+                disabled: options.impressionsDisabled || (definition === null || definition === void 0 ? void 0 : definition.impressionsDisabled)
             });
         }
         if (withConfig) {
@@ -147,33 +147,7 @@ function clientFactory(params) {
         }
         return treatment;
     }
-    function track(key, trafficTypeName, eventTypeId, value, properties, size) {
-        if (size === void 0) { size = 1024; }
-        var stopTelemetryTracker = telemetryTracker.trackEval(constants_1.TRACK);
-        var matchingKey = (0, key_1.getMatching)(key);
-        var timestamp = Date.now();
-        var eventData = {
-            eventTypeId: eventTypeId,
-            trafficTypeName: trafficTypeName,
-            value: value,
-            timestamp: timestamp,
-            key: matchingKey,
-            properties: properties
-        };
-        // This may be async but we only warn, we don't actually care if it is valid or not in terms of queueing the event.
-        (0, trafficTypeExistence_1.validateTrafficTypeExistence)(log, readinessManager, storage.splits, mode, trafficTypeName, constants_1.TRACK_FN_LABEL);
-        var result = eventTracker.track(eventData, size);
-        if ((0, thenable_1.thenable)(result)) {
-            return result.then(function (result) {
-                stopTelemetryTracker();
-                return result;
-            });
-        }
-        else {
-            stopTelemetryTracker();
-            return result;
-        }
-    }
+    var track = (0, trackMethod_1.trackMethodFactory)(params);
     return {
         getTreatment: getTreatment,
         getTreatmentWithConfig: getTreatmentWithConfig,

package/cjs/sdkClient/clientInputValidation.js

@@ -10,7 +10,7 @@ var splitFilters_1 = require("../utils/settingsValidation/splitFilters");
  * Decorator that validates the input before actually executing the client methods.
  * We should "guard" the client here, while not polluting the "real" implementation of those methods.
  */
-function clientInputValidationDecorator(settings, client, readinessManager, fallbackTreatmentsCalculator) {
+function clientInputValidationDecorator(settings, client, readinessManager, fallbackCalculator) {
     var log = settings.log, mode = settings.mode;
     var isAsync = (0, mode_1.isConsumerMode)(mode);
     /**
@@ -21,12 +21,12 @@ function clientInputValidationDecorator(settings, client, readinessManager, fall
         var nameOrNames = methodName.indexOf('ByFlagSet') > -1 ?
             (0, splitFilters_1.validateFlagSets)(log, methodName, maybeNameOrNames, settings.sync.__splitFiltersValidation.groupedFilters.bySet) :
             (0, lang_1.startsWith)(methodName, constants_1.GET_TREATMENTS) ?
-                (0, inputValidation_1.validateSplits)(log, maybeNameOrNames, methodName) :
-                (0, inputValidation_1.validateSplit)(log, maybeNameOrNames, methodName);
+                (0, inputValidation_1.validateDefinitions)(log, maybeNameOrNames, methodName) :
+                (0, inputValidation_1.validateDefinition)(log, maybeNameOrNames, methodName);
         var attributes = (0, inputValidation_1.validateAttributes)(log, maybeAttributes, methodName);
         var isNotDestroyed = (0, inputValidation_1.validateIfNotDestroyed)(log, readinessManager, methodName);
         var options = (0, inputValidation_1.validateEvaluationOptions)(log, maybeOptions, methodName);
-        (0, inputValidation_1.validateIfReadyFromCache)(log, readinessManager, methodName, nameOrNames);
+        (0, inputValidation_1.validateIfReadyFromCache)(log, readinessManager, methodName);
         var valid = isNotDestroyed && key && nameOrNames && attributes !== false;
         return {
             valid: valid,
@@ -42,7 +42,7 @@ function clientInputValidationDecorator(settings, client, readinessManager, fall
             featureFlagName.forEach(function (split) { return res_1[split] = evaluateFallBackTreatment(split, withConfig); });
             return res_1;
         }
-        var _a = fallbackTreatmentsCalculator(featureFlagName), treatment = _a.treatment, config = _a.config;
+        var _a = fallbackCalculator(featureFlagName), treatment = _a.treatment, config = _a.config;
         return withConfig ?
             {
                 treatment: treatment,
@@ -100,17 +100,6 @@ function clientInputValidationDecorator(settings, client, readinessManager, fall
             client.getTreatmentsWithConfigByFlagSet(params.key, params.nameOrNames[0], params.attributes, params.options) :
             wrapResult({});
     }
-    function track(maybeKey, maybeTT, maybeEvent, maybeEventValue, maybeProperties) {
-        var key = (0, inputValidation_1.validateKey)(log, maybeKey, constants_1.TRACK_FN_LABEL);
-        var tt = (0, inputValidation_1.validateTrafficType)(log, maybeTT, constants_1.TRACK_FN_LABEL);
-        var event = (0, inputValidation_1.validateEvent)(log, maybeEvent, constants_1.TRACK_FN_LABEL);
-        var eventValue = (0, inputValidation_1.validateEventValue)(log, maybeEventValue, constants_1.TRACK_FN_LABEL);
-        var _a = (0, inputValidation_1.validateEventProperties)(log, maybeProperties, constants_1.TRACK_FN_LABEL), properties = _a.properties, size = _a.size;
-        var isNotDestroyed = (0, inputValidation_1.validateIfNotDestroyed)(log, readinessManager, constants_1.TRACK_FN_LABEL);
-        return isNotDestroyed && key && tt && event && eventValue !== false && properties !== false ? // @ts-expect-error
-            client.track(key, tt, event, eventValue, properties, size) :
-            wrapResult(false);
-    }
     return {
         getTreatment: getTreatment,
         getTreatmentWithConfig: getTreatmentWithConfig,
@@ -120,7 +109,7 @@ function clientInputValidationDecorator(settings, client, readinessManager, fall
         getTreatmentsWithConfigByFlagSets: getTreatmentsWithConfigByFlagSets,
         getTreatmentsByFlagSet: getTreatmentsByFlagSet,
         getTreatmentsWithConfigByFlagSet: getTreatmentsWithConfigByFlagSet,
-        track: track
+        track: client.track,
     };
 }
 exports.clientInputValidationDecorator = clientInputValidationDecorator;

package/cjs/sdkClient/sdkClient.js

@@ -2,75 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkClientFactory = void 0;
 var objectAssign_1 = require("../utils/lang/objectAssign");
-var apiKey_1 = require("../utils/inputValidation/apiKey");
 var client_1 = require("./client");
 var clientInputValidation_1 = require("./clientInputValidation");
-var COOLDOWN_TIME_IN_MILLIS = 1000;
+var sdkLifecycle_1 = require("./sdkLifecycle");
 /**
  * Creates an Sdk client, i.e., a base client with status, init, flush and destroy interface
  */
 function sdkClientFactory(params, isSharedClient) {
-    var sdkReadinessManager = params.sdkReadinessManager, syncManager = params.syncManager, storage = params.storage, signalListener = params.signalListener, settings = params.settings, telemetryTracker = params.telemetryTracker, impressionsTracker = params.impressionsTracker;
-    var hasInit = false;
-    var lastActionTime = 0;
-    function __cooldown(func, time) {
-        var now = Date.now();
-        //get the actual time elapsed in ms
-        var timeElapsed = now - lastActionTime;
-        //check if the time elapsed is less than desired cooldown
-        if (timeElapsed < time) {
-            //if yes, return message with remaining time in seconds
-            settings.log.warn("Flush cooldown, remaining time ".concat((time - timeElapsed) / 1000, " seconds"));
-            return Promise.resolve();
-        }
-        else {
-            //Do the requested action and re-assign the lastActionTime
-            lastActionTime = now;
-            return func();
-        }
-    }
-    function __flush() {
-        return syncManager ? syncManager.flush() : Promise.resolve();
-    }
+    var sdkReadinessManager = params.sdkReadinessManager, settings = params.settings;
     return (0, objectAssign_1.objectAssign)(
     // Proto-linkage of the readiness Event Emitter
     Object.create(sdkReadinessManager.sdkStatus), 
     // Client API (getTreatment* & track methods)
-    (0, clientInputValidation_1.clientInputValidationDecorator)(settings, (0, client_1.clientFactory)(params), sdkReadinessManager.readinessManager, params.fallbackTreatmentsCalculator), {
-        init: function () {
-            if (hasInit)
-                return;
-            hasInit = true;
-            if (!isSharedClient) {
-                (0, apiKey_1.validateAndTrackApiKey)(settings.log, settings.core.authorizationKey);
-                sdkReadinessManager.readinessManager.init();
-                impressionsTracker.start();
-                syncManager && syncManager.start();
-                signalListener && signalListener.start();
-            }
-        },
-        flush: function () {
-            // @TODO define cooldown time
-            return __cooldown(__flush, COOLDOWN_TIME_IN_MILLIS);
-        },
-        destroy: function () {
-            hasInit = false;
-            // Mark the SDK as destroyed immediately
-            sdkReadinessManager.readinessManager.destroy();
-            // For main client, cleanup the SDK Key, listeners and scheduled jobs, and record stat before flushing data
-            if (!isSharedClient) {
-                (0, apiKey_1.releaseApiKey)(settings.core.authorizationKey);
-                telemetryTracker.sessionLength();
-                signalListener && signalListener.stop();
-                impressionsTracker.stop();
-            }
-            // Stop background jobs
-            syncManager && syncManager.stop();
-            return __flush().then(function () {
-                // Cleanup storage
-                return storage.destroy();
-            });
-        }
-    });
+    (0, clientInputValidation_1.clientInputValidationDecorator)(settings, (0, client_1.clientFactory)(params), sdkReadinessManager.readinessManager, params.fallbackCalculator), (0, sdkLifecycle_1.sdkLifecycleFactory)(params, isSharedClient));
 }
 exports.sdkClientFactory = sdkClientFactory;

package/cjs/sdkClient/sdkLifecycle.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sdkLifecycleFactory = void 0;
+var apiKey_1 = require("../utils/inputValidation/apiKey");
+var constants_1 = require("../utils/constants");
+var COOLDOWN_TIME_IN_MILLIS = 1000;
+/**
+ * Creates an Sdk client, i.e., a base client with status, init, flush and destroy interface
+ */
+function sdkLifecycleFactory(params, isSharedClient) {
+    var sdkReadinessManager = params.sdkReadinessManager, syncManager = params.syncManager, storage = params.storage, settings = params.settings, telemetryTracker = params.telemetryTracker, impressionsTracker = params.impressionsTracker, platform = params.platform, serviceApi = params.serviceApi;
+    var hasInit = false;
+    var lastActionTime = 0;
+    var signalListener = platform.SignalListener && settings.mode !== constants_1.LOCALHOST_MODE ? new platform.SignalListener(params) : undefined;
+    function __cooldown(func, time) {
+        var now = Date.now();
+        //get the actual time elapsed in ms
+        var timeElapsed = now - lastActionTime;
+        //check if the time elapsed is less than desired cooldown
+        if (timeElapsed < time) {
+            //if yes, return message with remaining time in seconds
+            settings.log.warn("Flush cooldown, remaining time ".concat((time - timeElapsed) / 1000, " seconds"));
+            return Promise.resolve();
+        }
+        else {
+            //Do the requested action and re-assign the lastActionTime
+            lastActionTime = now;
+            return func();
+        }
+    }
+    function __flush() {
+        return syncManager ? syncManager.flush() : Promise.resolve();
+    }
+    return {
+        init: function () {
+            if (hasInit)
+                return;
+            hasInit = true;
+            if (!isSharedClient) {
+                (0, apiKey_1.validateAndTrackApiKey)(settings.log, settings.core.authorizationKey);
+                sdkReadinessManager.readinessManager.init();
+                impressionsTracker.start();
+                syncManager && syncManager.start();
+                signalListener && signalListener.start();
+            }
+        },
+        flush: function () {
+            // @TODO define cooldown time
+            return __cooldown(__flush, COOLDOWN_TIME_IN_MILLIS);
+        },
+        destroy: function () {
+            hasInit = false;
+            // Mark the SDK as destroyed immediately
+            sdkReadinessManager.readinessManager.destroy();
+            // For main client, cleanup the SDK Key, listeners and scheduled jobs, and record stat before flushing data
+            if (!isSharedClient) {
+                (0, apiKey_1.releaseApiKey)(settings.core.authorizationKey);
+                telemetryTracker.sessionLength();
+                signalListener && signalListener.stop();
+                impressionsTracker.stop();
+            }
+            // Stop background jobs
+            syncManager && syncManager.stop();
+            // Stop the service API (the auth provider backoff retries specifically) before flushing,
+            // so that a pending/never-resolved auth retry doesn't block the flush forever
+            serviceApi && serviceApi.stop();
+            return __flush().then(function () {
+                // Cleanup storage
+                return storage.destroy();
+            });
+        }
+    };
+}
+exports.sdkLifecycleFactory = sdkLifecycleFactory;

package/cjs/sdkClient/trackMethod.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackMethodFactory = void 0;
+var thenable_1 = require("../utils/promise/thenable");
+var key_1 = require("../utils/key");
+var trafficTypeExistence_1 = require("../utils/inputValidation/trafficTypeExistence");
+var inputValidation_1 = require("../utils/inputValidation");
+var constants_1 = require("../utils/constants");
+var mode_1 = require("../utils/settingsValidation/mode");
+/**
+ * Creates a standalone `track` function with input validation.
+ * Reusable by FF SDK client, Configs SDK, and thin-client SDK.
+ */
+function trackMethodFactory(params, warnTTExistence) {
+    if (warnTTExistence === void 0) { warnTTExistence = true; }
+    var settings = params.settings, definitions = params.storage.definitions, telemetryTracker = params.telemetryTracker, eventTracker = params.eventTracker, readinessManager = params.sdkReadinessManager.readinessManager;
+    var log = settings.log, mode = settings.mode;
+    var isAsync = (0, mode_1.isConsumerMode)(mode);
+    return function track(maybeKey, maybeTT, maybeEvent, maybeEventValue, maybeProperties) {
+        // Input validation
+        var key = (0, inputValidation_1.validateKey)(log, maybeKey, constants_1.TRACK_FN_LABEL);
+        var trafficTypeName = (0, inputValidation_1.validateTrafficType)(log, maybeTT, constants_1.TRACK_FN_LABEL);
+        var eventTypeId = (0, inputValidation_1.validateEvent)(log, maybeEvent, constants_1.TRACK_FN_LABEL);
+        var value = (0, inputValidation_1.validateEventValue)(log, maybeEventValue, constants_1.TRACK_FN_LABEL);
+        var _a = (0, inputValidation_1.validateEventProperties)(log, maybeProperties, constants_1.TRACK_FN_LABEL), properties = _a.properties, size = _a.size;
+        var isNotDestroyed = (0, inputValidation_1.validateIfNotDestroyed)(log, readinessManager, constants_1.TRACK_FN_LABEL);
+        if (!(isNotDestroyed && key && trafficTypeName && eventTypeId && value !== false && properties !== false)) {
+            return isAsync ? Promise.resolve(false) : false;
+        }
+        // Core logic
+        var stopTelemetryTracker = telemetryTracker.trackEval(constants_1.TRACK);
+        var eventData = {
+            eventTypeId: eventTypeId,
+            trafficTypeName: trafficTypeName,
+            value: value,
+            timestamp: Date.now(),
+            key: (0, key_1.getMatching)(key),
+            properties: properties
+        };
+        // This may be async but we only warn, we don't actually care if it is valid or not in terms of queueing the event.
+        if (warnTTExistence)
+            (0, trafficTypeExistence_1.validateTrafficTypeExistence)(log, readinessManager, definitions, mode, trafficTypeName, constants_1.TRACK_FN_LABEL);
+        var result = eventTracker.track(eventData, size);
+        if ((0, thenable_1.thenable)(result)) {
+            return result.then(function (result) {
+                stopTelemetryTracker();
+                return result;
+            });
+        }
+        else {
+            stopTelemetryTracker();
+            return result;
+        }
+    };
+}
+exports.trackMethodFactory = trackMethodFactory;