@splitsoftware/splitio-commons 2.7.2-rc.0 → 2.7.9-rc.1

package/CHANGES.txt

@@ -1,5 +1,7 @@
-2.8.0 (October XX, 2025)
- - Updated the SDK’s initial synchronization in Node.js (server-side) to use `startup.requestTimeoutBeforeReady` and `startup.retriesOnFailureBeforeReady` to control the timeout and retry behavior of segment requests.
+2.8.0 (October 28, 2025)
+ - Added new configuration for Fallback Treatments, which allows setting a treatment value and optional config to be returned in place of "control", either globally or by flag. Read more in our docs.
+ - Added `client.whenReady()` and `client.whenReadyFromCache()` methods to replace the deprecated `client.ready()` method, which has an issue causing the returned promise to hang when using async/await syntax if it was rejected.
+ - Updated the SDK_READY_FROM_CACHE event to be emitted alongside the SDK_READY event if it hasn’t already been emitted.
 
 2.7.1 (October 8, 2025)
  - Bugfix - Update `debug` option to support log levels when `logger` option is used.

package/cjs/evaluator/fallbackTreatmentsCalculator/constants.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackDiscardReason = void 0;
+var FallbackDiscardReason;
+(function (FallbackDiscardReason) {
+    FallbackDiscardReason["FlagName"] = "Invalid flag name (max 100 chars, no spaces)";
+    FallbackDiscardReason["Treatment"] = "Invalid treatment (max 100 chars and must match pattern)";
+})(FallbackDiscardReason = exports.FallbackDiscardReason || (exports.FallbackDiscardReason = {}));

package/cjs/evaluator/fallbackTreatmentsCalculator/fallbackSanitizer/index.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbacksSanitizer = void 0;
+var lang_1 = require("../../../utils/lang");
+var constants_1 = require("../constants");
+var FallbacksSanitizer = /** @class */ (function () {
+    function FallbacksSanitizer() {
+    }
+    FallbacksSanitizer.isValidFlagName = function (name) {
+        return name.length <= 100 && !name.includes(' ');
+    };
+    FallbacksSanitizer.isValidTreatment = function (t) {
+        var treatment = (0, lang_1.isObject)(t) ? t.treatment : t;
+        if (!(0, lang_1.isString)(treatment) || treatment.length > 100) {
+            return false;
+        }
+        return FallbacksSanitizer.pattern.test(treatment);
+    };
+    FallbacksSanitizer.sanitizeGlobal = function (logger, treatment) {
+        if (!this.isValidTreatment(treatment)) {
+            logger.error("Fallback treatments - Discarded fallback: " + constants_1.FallbackDiscardReason.Treatment);
+            return undefined;
+        }
+        return treatment;
+    };
+    FallbacksSanitizer.sanitizeByFlag = function (logger, byFlagFallbacks) {
+        var _this = this;
+        var sanitizedByFlag = {};
+        var entries = Object.keys(byFlagFallbacks);
+        entries.forEach(function (flag) {
+            var t = byFlagFallbacks[flag];
+            if (!_this.isValidFlagName(flag)) {
+                logger.error("Fallback treatments - Discarded flag '" + flag + "': " + constants_1.FallbackDiscardReason.FlagName);
+                return;
+            }
+            if (!_this.isValidTreatment(t)) {
+                logger.error("Fallback treatments - Discarded treatment for flag '" + flag + "': " + constants_1.FallbackDiscardReason.Treatment);
+                return;
+            }
+            sanitizedByFlag[flag] = t;
+        });
+        return sanitizedByFlag;
+    };
+    FallbacksSanitizer.pattern = /^[0-9]+[.a-zA-Z0-9_-]*$|^[a-zA-Z]+[a-zA-Z0-9_-]*$/;
+    return FallbacksSanitizer;
+}());
+exports.FallbacksSanitizer = FallbacksSanitizer;

package/cjs/evaluator/fallbackTreatmentsCalculator/index.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackTreatmentsCalculator = exports.FALLBACK_PREFIX = void 0;
+var fallbackSanitizer_1 = require("./fallbackSanitizer");
+var constants_1 = require("../../utils/constants");
+var lang_1 = require("../../utils/lang");
+exports.FALLBACK_PREFIX = 'fallback - ';
+var FallbackTreatmentsCalculator = /** @class */ (function () {
+    function FallbackTreatmentsCalculator(logger, fallbacks) {
+        var sanitizedGlobal = (fallbacks === null || fallbacks === void 0 ? void 0 : fallbacks.global) ? fallbackSanitizer_1.FallbacksSanitizer.sanitizeGlobal(logger, fallbacks.global) : undefined;
+        var sanitizedByFlag = (fallbacks === null || fallbacks === void 0 ? void 0 : fallbacks.byFlag) ? fallbackSanitizer_1.FallbacksSanitizer.sanitizeByFlag(logger, fallbacks.byFlag) : {};
+        this.fallbacks = {
+            global: sanitizedGlobal,
+            byFlag: sanitizedByFlag
+        };
+    }
+    FallbackTreatmentsCalculator.prototype.resolve = function (flagName, label) {
+        var _a;
+        var treatment = (_a = this.fallbacks.byFlag) === null || _a === void 0 ? void 0 : _a[flagName];
+        if (treatment) {
+            return this.copyWithLabel(treatment, label);
+        }
+        if (this.fallbacks.global) {
+            return this.copyWithLabel(this.fallbacks.global, label);
+        }
+        return {
+            treatment: constants_1.CONTROL,
+            config: null,
+            label: label,
+        };
+    };
+    FallbackTreatmentsCalculator.prototype.copyWithLabel = function (fallback, label) {
+        if ((0, lang_1.isString)(fallback)) {
+            return {
+                treatment: fallback,
+                config: null,
+                label: "" + exports.FALLBACK_PREFIX + label,
+            };
+        }
+        return {
+            treatment: fallback.treatment,
+            config: fallback.config,
+            label: "" + exports.FALLBACK_PREFIX + label,
+        };
+    };
+    return FallbackTreatmentsCalculator;
+}());
+exports.FallbackTreatmentsCalculator = FallbackTreatmentsCalculator;

package/cjs/logger/constants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SUBMITTERS_PUSH_PAGE_HIDDEN = exports.USER_CONSENT_INITIAL = exports.USER_CONSENT_NOT_UPDATED = exports.USER_CONSENT_UPDATED = exports.IMPRESSIONS_TRACKER_SUCCESS = exports.EVENTS_TRACKER_SUCCESS = exports.SYNC_STOP_POLLING = exports.SYNC_CONTINUE_POLLING = exports.SYNC_START_POLLING = exports.SUBMITTERS_PUSH = exports.SUBMITTERS_PUSH_FULL_QUEUE = exports.STREAMING_DISCONNECTING = exports.STREAMING_DISABLED = exports.STREAMING_CONNECTING = exports.STREAMING_RECONNECT = exports.STREAMING_REFRESH_TOKEN = exports.SYNC_SPLITS_FETCH_RETRY = exports.POLLING_STOP = exports.POLLING_START = exports.POLLING_SMART_PAUSING = exports.NEW_FACTORY = exports.NEW_SHARED_CLIENT = exports.IMPRESSION_QUEUEING = exports.IMPRESSION = exports.CLIENT_READY = exports.CLIENT_READY_FROM_CACHE = exports.ENGINE_DEFAULT = exports.ENGINE_MATCHER_RESULT = exports.SETTINGS_SPLITS_FILTER = exports.SYNC_TASK_STOP = exports.SYNC_TASK_EXECUTE = exports.SYNC_TASK_START = exports.STREAMING_NEW_MESSAGE = exports.SYNC_RBS_UPDATE = exports.SYNC_SPLITS_UPDATE = exports.SYNC_SPLITS_FETCH = exports.SYNC_OFFLINE_DATA = exports.RETRIEVE_MANAGER = exports.RETRIEVE_CLIENT_EXISTING = exports.RETRIEVE_CLIENT_DEFAULT = exports.CLEANUP_DEREGISTERING = exports.CLEANUP_REGISTERING = exports.ENGINE_SANITIZE = exports.ENGINE_VALUE = exports.ENGINE_MATCHER_DEPENDENCY_PRE = exports.ENGINE_MATCHER_DEPENDENCY = exports.ENGINE_BUCKET = exports.ENGINE_COMBINER_IFELSEIF_NO_TREATMENT = exports.ENGINE_COMBINER_IFELSEIF = exports.ENGINE_COMBINER_AND = void 0;
-exports.ERROR_EMPTY_ARRAY = exports.ERROR_EMPTY = exports.ERROR_INVALID = exports.ERROR_INVALID_KEY_OBJECT = exports.ERROR_TOO_LONG = exports.ERROR_NULL = exports.ERROR_CLIENT_DESTROYED = exports.ERROR_NOT_FINITE = exports.ERROR_SIZE_EXCEEDED = exports.ERROR_NOT_PLAIN_OBJECT = exports.ERROR_EVENT_TYPE_FORMAT = exports.ERROR_EVENTS_TRACKER = exports.ERROR_IMPRESSIONS_LISTENER = exports.ERROR_IMPRESSIONS_TRACKER = exports.ERROR_STREAMING_AUTH = exports.ERROR_STREAMING_SSE = exports.ERROR_SYNC_OFFLINE_LOADING = exports.ERROR_CLIENT_CANNOT_GET_READY = exports.ERROR_CLIENT_LISTENER = exports.ERROR_LOGLEVEL_INVALID = exports.ERROR_ENGINE_COMBINER_IFELSEIF = exports.WARN_FLAGSET_WITHOUT_FLAGS = exports.WARN_FLAGSET_NOT_CONFIGURED = exports.WARN_LOWERCASE_FLAGSET = exports.WARN_INVALID_FLAGSET = exports.STREAMING_PARSING_SPLIT_UPDATE = exports.STREAMING_PARSING_MEMBERSHIPS_UPDATE = exports.WARN_SDK_KEY = exports.WARN_SPLITS_FILTER_EMPTY = exports.WARN_SPLITS_FILTER_INVALID = exports.WARN_SPLITS_FILTER_IGNORED = exports.WARN_INTEGRATION_INVALID = exports.WARN_NOT_EXISTENT_TT = exports.WARN_LOWERCASE_TRAFFIC_TYPE = exports.WARN_NOT_EXISTENT_SPLIT = exports.WARN_TRIMMING = exports.WARN_CONVERTING = exports.WARN_TRIMMING_PROPERTIES = exports.WARN_SETTING_NULL = exports.SUBMITTERS_PUSH_RETRY = exports.SUBMITTERS_PUSH_FAILS = exports.STREAMING_FALLBACK = exports.STREAMING_PARSING_MESSAGE_FAILS = exports.STREAMING_PARSING_ERROR_FAILS = exports.SYNC_SPLITS_FETCH_FAILS = exports.SYNC_MYSEGMENTS_FETCH_RETRY = exports.CLIENT_NOT_READY = exports.CLIENT_NO_LISTENER = exports.ENGINE_VALUE_NO_ATTRIBUTES = exports.ENGINE_VALUE_INVALID = void 0;
+exports.ERROR_EMPTY_ARRAY = exports.ERROR_EMPTY = exports.ERROR_INVALID = exports.ERROR_INVALID_KEY_OBJECT = exports.ERROR_TOO_LONG = exports.ERROR_NULL = exports.ERROR_CLIENT_DESTROYED = exports.ERROR_NOT_FINITE = exports.ERROR_SIZE_EXCEEDED = exports.ERROR_NOT_PLAIN_OBJECT = exports.ERROR_EVENT_TYPE_FORMAT = exports.ERROR_EVENTS_TRACKER = exports.ERROR_IMPRESSIONS_LISTENER = exports.ERROR_IMPRESSIONS_TRACKER = exports.ERROR_STREAMING_AUTH = exports.ERROR_STREAMING_SSE = exports.ERROR_SYNC_OFFLINE_LOADING = exports.ERROR_CLIENT_CANNOT_GET_READY = exports.ERROR_CLIENT_LISTENER = exports.ERROR_LOGLEVEL_INVALID = exports.ERROR_ENGINE_COMBINER_IFELSEIF = exports.WARN_FLAGSET_WITHOUT_FLAGS = exports.WARN_FLAGSET_NOT_CONFIGURED = exports.WARN_LOWERCASE_FLAGSET = exports.WARN_INVALID_FLAGSET = exports.STREAMING_PARSING_SPLIT_UPDATE = exports.STREAMING_PARSING_MEMBERSHIPS_UPDATE = exports.WARN_SDK_KEY = exports.WARN_SPLITS_FILTER_EMPTY = exports.WARN_SPLITS_FILTER_INVALID = exports.WARN_SPLITS_FILTER_IGNORED = exports.WARN_INTEGRATION_INVALID = exports.WARN_NOT_EXISTENT_TT = exports.WARN_LOWERCASE_TRAFFIC_TYPE = exports.WARN_NOT_EXISTENT_SPLIT = exports.WARN_TRIMMING = exports.WARN_CONVERTING = exports.WARN_TRIMMING_PROPERTIES = exports.WARN_SETTING_NULL = exports.SUBMITTERS_PUSH_RETRY = exports.SUBMITTERS_PUSH_FAILS = exports.STREAMING_FALLBACK = exports.STREAMING_PARSING_MESSAGE_FAILS = exports.STREAMING_PARSING_ERROR_FAILS = exports.SYNC_SPLITS_FETCH_FAILS = exports.SYNC_MYSEGMENTS_FETCH_RETRY = exports.CLIENT_NOT_READY_FROM_CACHE = exports.CLIENT_NO_LISTENER = exports.ENGINE_VALUE_NO_ATTRIBUTES = exports.ENGINE_VALUE_INVALID = void 0;
 exports.LOG_PREFIX_CLEANUP = exports.LOG_PREFIX_UNIQUE_KEYS_TRACKER = exports.LOG_PREFIX_EVENTS_TRACKER = exports.LOG_PREFIX_IMPRESSIONS_TRACKER = exports.LOG_PREFIX_SYNC_SUBMITTERS = exports.LOG_PREFIX_SYNC_POLLING = exports.LOG_PREFIX_SYNC_MYSEGMENTS = exports.LOG_PREFIX_SYNC_SEGMENTS = exports.LOG_PREFIX_SYNC_SPLITS = exports.LOG_PREFIX_SYNC_STREAMING = exports.LOG_PREFIX_SYNC_OFFLINE = exports.LOG_PREFIX_SYNC_MANAGER = exports.LOG_PREFIX_SYNC = exports.LOG_PREFIX_ENGINE_VALUE = exports.LOG_PREFIX_ENGINE_MATCHER = exports.LOG_PREFIX_ENGINE_COMBINER = exports.LOG_PREFIX_ENGINE = exports.LOG_PREFIX_CLIENT_INSTANTIATION = exports.LOG_PREFIX_INSTANTIATION = exports.LOG_PREFIX_SETTINGS = exports.ENGINE_MATCHER_ERROR = exports.ERROR_SETS_FILTER_EXCLUSIVE = exports.ERROR_TOO_MANY_SETS = exports.ERROR_MIN_CONFIG_PARAM = exports.ERROR_NOT_BOOLEAN = exports.ERROR_STORAGE_INVALID = exports.ERROR_HTTP = exports.ERROR_INVALID_CONFIG_PARAM = void 0;
 /**
  * Message codes used to trim string log messages from commons and client-side API modules,
@@ -63,7 +63,7 @@ exports.SUBMITTERS_PUSH_PAGE_HIDDEN = 125;
 exports.ENGINE_VALUE_INVALID = 200;
 exports.ENGINE_VALUE_NO_ATTRIBUTES = 201;
 exports.CLIENT_NO_LISTENER = 202;
-exports.CLIENT_NOT_READY = 203;
+exports.CLIENT_NOT_READY_FROM_CACHE = 203;
 exports.SYNC_MYSEGMENTS_FETCH_RETRY = 204;
 exports.SYNC_SPLITS_FETCH_FAILS = 205;
 exports.STREAMING_PARSING_ERROR_FAILS = 206;

package/cjs/logger/messages/info.js

@@ -23,7 +23,7 @@ exports.codesInfo = warn_1.codesWarn.concat([
     [c.POLLING_SMART_PAUSING, c.LOG_PREFIX_SYNC_POLLING + 'Turning segments data polling %s.'],
     [c.POLLING_START, c.LOG_PREFIX_SYNC_POLLING + 'Starting polling'],
     [c.POLLING_STOP, c.LOG_PREFIX_SYNC_POLLING + 'Stopping polling'],
-    [c.SYNC_SPLITS_FETCH_RETRY, c.LOG_PREFIX_SYNC_SPLITS + 'Retrying fetch of feature flags (attempt #%s). Reason: %s'],
+    [c.SYNC_SPLITS_FETCH_RETRY, c.LOG_PREFIX_SYNC_SPLITS + 'Retrying download of feature flags #%s. Reason: %s'],
     [c.SUBMITTERS_PUSH_FULL_QUEUE, c.LOG_PREFIX_SYNC_SUBMITTERS + 'Flushing full %s queue and resetting timer.'],
     [c.SUBMITTERS_PUSH, c.LOG_PREFIX_SYNC_SUBMITTERS + 'Pushing %s.'],
     [c.SUBMITTERS_PUSH_PAGE_HIDDEN, c.LOG_PREFIX_SYNC_SUBMITTERS + 'Flushing %s because page became hidden.'],

package/cjs/logger/messages/warn.js

@@ -9,7 +9,7 @@ exports.codesWarn = error_1.codesError.concat([
     [c.ENGINE_VALUE_INVALID, c.LOG_PREFIX_ENGINE_VALUE + 'Value %s doesn\'t match with expected type.'],
     [c.ENGINE_VALUE_NO_ATTRIBUTES, c.LOG_PREFIX_ENGINE_VALUE + 'Defined attribute `%s`. No attributes received.'],
     // synchronizer
-    [c.SYNC_MYSEGMENTS_FETCH_RETRY, c.LOG_PREFIX_SYNC_MYSEGMENTS + 'Retrying fetch of memberships (attempt #%s). Reason: %s'],
+    [c.SYNC_MYSEGMENTS_FETCH_RETRY, c.LOG_PREFIX_SYNC_MYSEGMENTS + 'Retrying download of segments #%s. Reason: %s'],
     [c.SYNC_SPLITS_FETCH_FAILS, c.LOG_PREFIX_SYNC_SPLITS + 'Error while doing fetch of feature flags. %s'],
     [c.STREAMING_PARSING_ERROR_FAILS, c.LOG_PREFIX_SYNC_STREAMING + 'Error parsing SSE error notification: %s'],
     [c.STREAMING_PARSING_MESSAGE_FAILS, c.LOG_PREFIX_SYNC_STREAMING + 'Error parsing SSE message notification: %s'],
@@ -17,8 +17,8 @@ exports.codesWarn = error_1.codesError.concat([
     [c.SUBMITTERS_PUSH_FAILS, c.LOG_PREFIX_SYNC_SUBMITTERS + 'Dropping %s after retry. Reason: %s.'],
     [c.SUBMITTERS_PUSH_RETRY, c.LOG_PREFIX_SYNC_SUBMITTERS + 'Failed to push %s, keeping data to retry on next iteration. Reason: %s.'],
     // client status
-    [c.CLIENT_NOT_READY, '%s: the SDK is not ready, results may be incorrect%s. Make sure to wait for SDK readiness before using this method.'],
-    [c.CLIENT_NO_LISTENER, 'No listeners for SDK Readiness detected. Incorrect control treatments could have been logged if you called getTreatment/s while the SDK was not yet ready.'],
+    [c.CLIENT_NOT_READY_FROM_CACHE, '%s: the SDK is not ready to evaluate. Results may be incorrect%s. Make sure to wait for SDK readiness before using this method.'],
+    [c.CLIENT_NO_LISTENER, 'No listeners for SDK_READY event detected. Incorrect control treatments could have been logged if you called getTreatment/s while the SDK was not yet synchronized with the backend.'],
     // input validation
     [c.WARN_SETTING_NULL, '%s: Property "%s" is of invalid type. Setting value to null.'],
     [c.WARN_TRIMMING_PROPERTIES, '%s: more than 300 properties were provided. Some of them will be trimmed when processed.'],

package/cjs/readiness/readinessManager.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.readinessManagerFactory = void 0;
 var objectAssign_1 = require("../utils/lang/objectAssign");
 var constants_1 = require("./constants");
-var constants_2 = require("../utils/constants");
 function splitsEventEmitterFactory(EventEmitter) {
     var splitsEventEmitter = (0, objectAssign_1.objectAssign)(new EventEmitter(), {
         splitsArrived: false,
@@ -75,7 +74,7 @@ function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
         if (!isReady && !isDestroyed) {
             try {
                 syncLastUpdate();
-                gate.emit(constants_1.SDK_READY_FROM_CACHE);
+                gate.emit(constants_1.SDK_READY_FROM_CACHE, isReady);
             }
             catch (e) {
                 // throws user callback exceptions in next tick
@@ -84,7 +83,6 @@ function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
         }
     }
     function checkIsReadyOrUpdate(diff) {
-        var _a;
         if (isDestroyed)
             return;
         if (isReady) {
@@ -103,9 +101,9 @@ function readinessManagerFactory(EventEmitter, settings, splits, isShared) {
                 isReady = true;
                 try {
                     syncLastUpdate();
-                    if (!isReadyFromCache && ((_a = settings.storage) === null || _a === void 0 ? void 0 : _a.type) === constants_2.STORAGE_LOCALSTORAGE) {
+                    if (!isReadyFromCache) {
                         isReadyFromCache = true;
-                        gate.emit(constants_1.SDK_READY_FROM_CACHE);
+                        gate.emit(constants_1.SDK_READY_FROM_CACHE, isReady);
                     }
                     gate.emit(constants_1.SDK_READY);
                 }

package/cjs/readiness/sdkReadinessManager.js

@@ -8,6 +8,7 @@ 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).
  * It also updates logs related warnings and errors.
@@ -34,6 +35,9 @@ function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
                 readyCbCount++;
             }
         }
+        else if (event === constants_1.SDK_READY_FROM_CACHE && readinessManager.isReadyFromCache()) {
+            log.error(constants_2.ERROR_CLIENT_LISTENER, ['SDK_READY_FROM_CACHE']);
+        }
     });
     /** Ready promise */
     var readyPromise = generateReadyPromise();
@@ -76,6 +80,7 @@ function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
                 SDK_UPDATE: constants_1.SDK_UPDATE,
                 SDK_READY_TIMED_OUT: constants_1.SDK_READY_TIMED_OUT,
             },
+            // @TODO: remove in next major
             ready: function () {
                 if (readinessManager.hasTimedout()) {
                     if (!readinessManager.isReady()) {
@@ -87,6 +92,34 @@ function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
                 }
                 return readyPromise;
             },
+            whenReady: function () {
+                return new Promise(function (resolve, reject) {
+                    if (readinessManager.isReady()) {
+                        resolve();
+                    }
+                    else if (readinessManager.hasTimedout()) {
+                        reject(TIMEOUT_ERROR);
+                    }
+                    else {
+                        readinessManager.gate.once(constants_1.SDK_READY, resolve);
+                        readinessManager.gate.once(constants_1.SDK_READY_TIMED_OUT, function () { return reject(TIMEOUT_ERROR); });
+                    }
+                });
+            },
+            whenReadyFromCache: function () {
+                return new Promise(function (resolve, reject) {
+                    if (readinessManager.isReadyFromCache()) {
+                        resolve(readinessManager.isReady());
+                    }
+                    else if (readinessManager.hasTimedout()) {
+                        reject(TIMEOUT_ERROR);
+                    }
+                    else {
+                        readinessManager.gate.once(constants_1.SDK_READY_FROM_CACHE, function () { return resolve(readinessManager.isReady()); });
+                        readinessManager.gate.once(constants_1.SDK_READY_TIMED_OUT, function () { return reject(TIMEOUT_ERROR); });
+                    }
+                });
+            },
             __getStatus: function () {
                 return {
                     isReady: readinessManager.isReady(),

package/cjs/sdkClient/client.js

@@ -30,7 +30,7 @@ function stringify(options) {
  * 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;
+    var readinessManager = params.sdkReadinessManager.readinessManager, storage = params.storage, settings = params.settings, impressionsTracker = params.impressionsTracker, eventTracker = params.eventTracker, telemetryTracker = params.telemetryTracker, fallbackTreatmentsCalculator = params.fallbackTreatmentsCalculator;
     var log = settings.log, mode = settings.mode;
     var isAsync = (0, mode_1.isConsumerMode)(mode);
     function getTreatment(key, featureFlagName, attributes, options, withConfig, methodName) {
@@ -44,7 +44,7 @@ function clientFactory(params) {
             stopTelemetryTracker(queue[0] && queue[0].imp.label);
             return treatment;
         };
-        var evaluation = readinessManager.isReady() || readinessManager.isReadyFromCache() ?
+        var evaluation = readinessManager.isReadyFromCache() ?
             (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) :
@@ -69,7 +69,7 @@ function clientFactory(params) {
             stopTelemetryTracker(queue[0] && queue[0].imp.label);
             return treatments;
         };
-        var evaluations = readinessManager.isReady() || readinessManager.isReadyFromCache() ?
+        var evaluations = readinessManager.isReadyFromCache() ?
             (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)) :
@@ -95,7 +95,7 @@ function clientFactory(params) {
             stopTelemetryTracker(queue[0] && queue[0].imp.label);
             return treatments;
         };
-        var evaluations = readinessManager.isReady() || readinessManager.isReadyFromCache() ?
+        var evaluations = readinessManager.isReadyFromCache() ?
             (0, evaluator_1.evaluateFeaturesByFlagSets)(log, key, flagSetNames, attributes, storage, methodName) :
             isAsync ?
                 Promise.resolve({}) :
@@ -115,7 +115,14 @@ function clientFactory(params) {
     function processEvaluation(evaluation, featureFlagName, key, properties, withConfig, invokingMethodName, queue) {
         var matchingKey = (0, key_1.getMatching)(key);
         var bucketingKey = (0, key_1.getBucketing)(key);
-        var treatment = evaluation.treatment, label = evaluation.label, changeNumber = evaluation.changeNumber, _a = evaluation.config, config = _a === void 0 ? null : _a, impressionsDisabled = evaluation.impressionsDisabled;
+        var changeNumber = evaluation.changeNumber, impressionsDisabled = evaluation.impressionsDisabled;
+        var treatment = evaluation.treatment, label = evaluation.label, _a = evaluation.config, config = _a === void 0 ? null : _a;
+        if (treatment === constants_1.CONTROL) {
+            var fallbackTreatment = fallbackTreatmentsCalculator.resolve(featureFlagName, label);
+            treatment = fallbackTreatment.treatment;
+            label = fallbackTreatment.label;
+            config = fallbackTreatment.config;
+        }
         log.info(constants_2.IMPRESSION, [featureFlagName, matchingKey, treatment, label]);
         if ((0, splitExistence_1.validateSplitExistence)(log, readinessManager, featureFlagName, label, invokingMethodName)) {
             log.info(constants_2.IMPRESSION_QUEUEING);

package/cjs/sdkClient/clientInputValidation.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.clientInputValidationDecorator = void 0;
-var objectAssign_1 = require("../utils/lang/objectAssign");
 var inputValidation_1 = require("../utils/inputValidation");
 var lang_1 = require("../utils/lang");
 var constants_1 = require("../utils/constants");
@@ -11,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) {
+function clientInputValidationDecorator(settings, client, readinessManager, fallbackTreatmentsCalculator) {
     var log = settings.log, mode = settings.mode;
     var isAsync = (0, mode_1.isConsumerMode)(mode);
     /**
@@ -27,7 +26,7 @@ function clientInputValidationDecorator(settings, client, readinessManager) {
         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.validateIfOperational)(log, readinessManager, methodName, nameOrNames);
+        (0, inputValidation_1.validateIfReadyFromCache)(log, readinessManager, methodName, nameOrNames);
         var valid = isNotDestroyed && key && nameOrNames && attributes !== false;
         return {
             valid: valid,
@@ -37,6 +36,16 @@ function clientInputValidationDecorator(settings, client, readinessManager) {
             options: options
         };
     }
+    function evaluateFallBackTreatment(featureFlagName, withConfig) {
+        var _a = fallbackTreatmentsCalculator.resolve(featureFlagName, ''), treatment = _a.treatment, config = _a.config;
+        if (withConfig) {
+            return {
+                treatment: treatment,
+                config: config
+            };
+        }
+        return treatment;
+    }
     function wrapResult(value) {
         return isAsync ? Promise.resolve(value) : value;
     }
@@ -46,7 +55,8 @@ function clientInputValidationDecorator(settings, client, readinessManager) {
             return client.getTreatment(params.key, params.nameOrNames, params.attributes, params.options);
         }
         else {
-            return wrapResult(constants_1.CONTROL);
+            var result = evaluateFallBackTreatment(params.nameOrNames, false);
+            return wrapResult(result);
         }
     }
     function getTreatmentWithConfig(maybeKey, maybeFeatureFlagName, maybeAttributes, maybeOptions) {
@@ -55,7 +65,8 @@ function clientInputValidationDecorator(settings, client, readinessManager) {
             return client.getTreatmentWithConfig(params.key, params.nameOrNames, params.attributes, params.options);
         }
         else {
-            return wrapResult((0, objectAssign_1.objectAssign)({}, constants_1.CONTROL_WITH_CONFIG));
+            var result = evaluateFallBackTreatment(params.nameOrNames, true);
+            return wrapResult(result);
         }
     }
     function getTreatments(maybeKey, maybeFeatureFlagNames, maybeAttributes, maybeOptions) {
@@ -66,7 +77,7 @@ function clientInputValidationDecorator(settings, client, readinessManager) {
         else {
             var res_1 = {};
             if (params.nameOrNames)
-                params.nameOrNames.forEach(function (split) { return res_1[split] = constants_1.CONTROL; });
+                params.nameOrNames.forEach(function (split) { return res_1[split] = evaluateFallBackTreatment(split, false); });
             return wrapResult(res_1);
         }
     }
@@ -78,7 +89,7 @@ function clientInputValidationDecorator(settings, client, readinessManager) {
         else {
             var res_2 = {};
             if (params.nameOrNames)
-                params.nameOrNames.forEach(function (split) { return res_2[split] = (0, objectAssign_1.objectAssign)({}, constants_1.CONTROL_WITH_CONFIG); });
+                params.nameOrNames.forEach(function (split) { return res_2[split] = evaluateFallBackTreatment(split, true); });
             return wrapResult(res_2);
         }
     }

package/cjs/sdkClient/sdkClient.js

@@ -35,7 +35,7 @@ function sdkClientFactory(params, isSharedClient) {
     // 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), 
+    (0, clientInputValidation_1.clientInputValidationDecorator)(settings, (0, client_1.clientFactory)(params), sdkReadinessManager.readinessManager, params.fallbackTreatmentsCalculator), 
     // Sdk destroy
     {
         flush: function () {

package/cjs/sdkFactory/index.js

@@ -17,6 +17,7 @@ var uniqueKeysTracker_1 = require("../trackers/uniqueKeysTracker");
 var constants_3 = require("../utils/constants");
 var setRolloutPlan_1 = require("../storages/setRolloutPlan");
 var key_1 = require("../utils/key");
+var fallbackTreatmentsCalculator_1 = require("../evaluator/fallbackTreatmentsCalculator");
 /**
  * Modular SDK factory
  */
@@ -51,6 +52,7 @@ function sdkFactory(params) {
             readiness.splits.emit(constants_2.SDK_SPLITS_CACHE_LOADED);
         }
     });
+    var fallbackTreatmentsCalculator = new fallbackTreatmentsCalculator_1.FallbackTreatmentsCalculator(settings.log, settings.fallbackTreatments);
     if (initialRolloutPlan) {
         (0, setRolloutPlan_1.setRolloutPlan)(log, initialRolloutPlan, storage, key && (0, key_1.getMatching)(key));
         if (storage.splits.getChangeNumber() > -1)
@@ -71,7 +73,7 @@ function sdkFactory(params) {
     var eventTracker = (0, eventTracker_1.eventTrackerFactory)(settings, storage.events, whenInit, integrationsManager, storage.telemetry);
     // splitApi is used by SyncManager and Browser signal listener
     var splitApi = splitApiFactory && splitApiFactory(settings, platform, telemetryTracker);
-    var ctx = { clients: clients, splitApi: splitApi, eventTracker: eventTracker, impressionsTracker: impressionsTracker, telemetryTracker: telemetryTracker, uniqueKeysTracker: uniqueKeysTracker, sdkReadinessManager: sdkReadinessManager, readiness: readiness, settings: settings, storage: storage, platform: platform };
+    var ctx = { clients: clients, splitApi: splitApi, eventTracker: eventTracker, impressionsTracker: impressionsTracker, telemetryTracker: telemetryTracker, uniqueKeysTracker: uniqueKeysTracker, sdkReadinessManager: sdkReadinessManager, readiness: readiness, settings: settings, storage: storage, platform: platform, fallbackTreatmentsCalculator: fallbackTreatmentsCalculator };
     var syncManager = syncManagerFactory && syncManagerFactory(ctx);
     ctx.syncManager = syncManager;
     var signalListener = SignalListener && new SignalListener(syncManager, settings, storage, splitApi);

package/cjs/sdkManager/index.js

@@ -54,7 +54,7 @@ function sdkManagerFactory(settings, splits, _a) {
          */
         split: function (featureFlagName) {
             var splitName = (0, inputValidation_1.validateSplit)(log, featureFlagName, constants_1.SPLIT_FN_LABEL);
-            if (!(0, inputValidation_1.validateIfNotDestroyed)(log, readinessManager, constants_1.SPLIT_FN_LABEL) || !(0, inputValidation_1.validateIfOperational)(log, readinessManager, constants_1.SPLIT_FN_LABEL) || !splitName) {
+            if (!(0, inputValidation_1.validateIfOperational)(log, readinessManager, constants_1.SPLIT_FN_LABEL) || !splitName) {
                 return isAsync ? Promise.resolve(null) : null;
             }
             var split = splits.getSplit(splitName);
@@ -71,7 +71,7 @@ function sdkManagerFactory(settings, splits, _a) {
          * Get the feature flag objects present on the factory storage
          */
         splits: function () {
-            if (!(0, inputValidation_1.validateIfNotDestroyed)(log, readinessManager, constants_1.SPLITS_FN_LABEL) || !(0, inputValidation_1.validateIfOperational)(log, readinessManager, constants_1.SPLITS_FN_LABEL)) {
+            if (!(0, inputValidation_1.validateIfOperational)(log, readinessManager, constants_1.SPLITS_FN_LABEL)) {
                 return isAsync ? Promise.resolve([]) : [];
             }
             var currentSplits = splits.getAll();
@@ -83,7 +83,7 @@ function sdkManagerFactory(settings, splits, _a) {
          * Get the feature flag names present on the factory storage
          */
         names: function () {
-            if (!(0, inputValidation_1.validateIfNotDestroyed)(log, readinessManager, constants_1.NAMES_FN_LABEL) || !(0, inputValidation_1.validateIfOperational)(log, readinessManager, constants_1.NAMES_FN_LABEL)) {
+            if (!(0, inputValidation_1.validateIfOperational)(log, readinessManager, constants_1.NAMES_FN_LABEL)) {
                 return isAsync ? Promise.resolve([]) : [];
             }
             var splitNames = splits.getSplitNames();

package/cjs/sync/polling/syncTasks/segmentsSyncTask.js

@@ -8,6 +8,6 @@ var segmentChangesUpdater_1 = require("../updaters/segmentChangesUpdater");
  * Creates a sync task that periodically executes a `segmentChangesUpdater` task
  */
 function segmentsSyncTaskFactory(fetchSegmentChanges, storage, readiness, settings) {
-    return (0, syncTask_1.syncTaskFactory)(settings.log, (0, segmentChangesUpdater_1.segmentChangesUpdaterFactory)(settings.log, (0, segmentChangesFetcher_1.segmentChangesFetcherFactory)(fetchSegmentChanges), storage.segments, readiness, settings.startup.requestTimeoutBeforeReady, settings.startup.retriesOnFailureBeforeReady), settings.scheduler.segmentsRefreshRate, 'segmentChangesUpdater');
+    return (0, syncTask_1.syncTaskFactory)(settings.log, (0, segmentChangesUpdater_1.segmentChangesUpdaterFactory)(settings.log, (0, segmentChangesFetcher_1.segmentChangesFetcherFactory)(fetchSegmentChanges), storage.segments, readiness), settings.scheduler.segmentsRefreshRate, 'segmentChangesUpdater');
 }
 exports.segmentsSyncTaskFactory = segmentsSyncTaskFactory;

package/cjs/sync/polling/updaters/segmentChangesUpdater.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.segmentChangesUpdaterFactory = void 0;
 var constants_1 = require("../../../readiness/constants");
 var constants_2 = require("../../../logger/constants");
-var timeout_1 = require("../../../utils/promise/timeout");
 /**
  * Factory of SegmentChanges updater, a task that:
  *  - fetches segment changes using `segmentChangesFetcher`
@@ -15,33 +14,22 @@ var timeout_1 = require("../../../utils/promise/timeout");
  * @param segments - segments storage, with sync or async methods
  * @param readiness - optional readiness manager. Not required for synchronizer or producer mode.
  */
-function segmentChangesUpdaterFactory(log, segmentChangesFetcher, segments, readiness, requestTimeoutBeforeReady, retriesOnFailureBeforeReady) {
+function segmentChangesUpdaterFactory(log, segmentChangesFetcher, segments, readiness) {
     var readyOnAlreadyExistentState = true;
-    function _promiseDecorator(promise) {
-        if (readyOnAlreadyExistentState && requestTimeoutBeforeReady)
-            promise = (0, timeout_1.timeout)(requestTimeoutBeforeReady, promise);
-        return promise;
-    }
-    function updateSegment(segmentName, noCache, till, fetchOnlyNew, retries) {
+    function updateSegment(segmentName, noCache, till, fetchOnlyNew) {
         log.debug(constants_2.LOG_PREFIX_SYNC_SEGMENTS + "Processing segment " + segmentName);
         var sincePromise = Promise.resolve(segments.getChangeNumber(segmentName));
         return sincePromise.then(function (since) {
             // if fetchOnlyNew flag, avoid processing already fetched segments
             return fetchOnlyNew && since !== undefined ?
                 false :
-                segmentChangesFetcher(since || -1, segmentName, noCache, till, _promiseDecorator).then(function (changes) {
+                segmentChangesFetcher(since || -1, segmentName, noCache, till).then(function (changes) {
                     return Promise.all(changes.map(function (x) {
                         log.debug(constants_2.LOG_PREFIX_SYNC_SEGMENTS + "Processing " + segmentName + " with till = " + x.till + ". Added: " + x.added.length + ". Removed: " + x.removed.length);
                         return segments.update(segmentName, x.added, x.removed, x.till);
                     })).then(function (updates) {
                         return updates.some(function (update) { return update; });
                     });
-                }).catch(function (error) {
-                    if (retries) {
-                        log.warn(constants_2.LOG_PREFIX_SYNC_SEGMENTS + "Retrying fetch of segment " + segmentName + " (attempt #" + retries + "). Reason: " + error);
-                        return updateSegment(segmentName, noCache, till, fetchOnlyNew, retries - 1);
-                    }
-                    throw error;
                 });
         });
     }
@@ -61,7 +49,8 @@ function segmentChangesUpdaterFactory(log, segmentChangesFetcher, segments, read
         // If not a segment name provided, read list of available segments names to be updated.
         var segmentsPromise = Promise.resolve(segmentName ? [segmentName] : segments.getRegisteredSegments());
         return segmentsPromise.then(function (segmentNames) {
-            var updaters = segmentNames.map(function (segmentName) { return updateSegment(segmentName, noCache, till, fetchOnlyNew, readyOnAlreadyExistentState ? retriesOnFailureBeforeReady : 0); });
+            // Async fetchers
+            var updaters = segmentNames.map(function (segmentName) { return updateSegment(segmentName, noCache, till, fetchOnlyNew); });
             return Promise.all(updaters).then(function (shouldUpdateFlags) {
                 // if at least one segment fetch succeeded, mark segments ready
                 if (shouldUpdateFlags.some(function (update) { return update; }) || readyOnAlreadyExistentState) {

package/cjs/sync/polling/updaters/splitChangesUpdater.js

@@ -171,14 +171,14 @@ function splitChangesUpdaterFactory(log, splitChangesFetcher, storage, splitFilt
                 });
             })
                 .catch(function (error) {
+                log.warn(constants_2.SYNC_SPLITS_FETCH_FAILS, [error]);
                 if (startingUp && retriesOnFailureBeforeReady > retry) {
                     retry += 1;
-                    log.warn(constants_2.SYNC_SPLITS_FETCH_RETRY, [retry, error]);
+                    log.info(constants_2.SYNC_SPLITS_FETCH_RETRY, [retry, error]);
                     return _splitChangesUpdater(sinces, retry);
                 }
                 else {
                     startingUp = false;
-                    log.warn(constants_2.SYNC_SPLITS_FETCH_FAILS, [error]);
                 }
                 return false;
             });

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

@@ -19,7 +19,7 @@ function SSEHandlerFactory(log, pushEmitter, telemetryTracker) {
             // Ably error
             var code = error.parsedData.code;
             telemetryTracker.streamingEvent(constants_3.ABLY_ERROR, code);
-            // 401 errors due to invalid or expired token (e.g., if refresh token coudn't be executed)
+            // 401 errors due to invalid or expired token (e.g., if refresh token couldn't be executed)
             if (40140 <= code && code <= 40149)
                 return true;
             // Others 4XX errors (e.g., bad request from the SDK)

package/cjs/sync/submitters/telemetrySubmitter.js

@@ -107,14 +107,14 @@ function telemetrySubmitterFactory(params) {
     if (!telemetry || !now)
         return; // No submitter created if telemetry cache is not defined
     var settings = params.settings, _a = params.settings, log = _a.log, telemetryRefreshRate = _a.scheduler.telemetryRefreshRate, splitApi = params.splitApi, readiness = params.readiness, sdkReadinessManager = params.sdkReadinessManager;
-    var startTime = (0, timer_1.timer)(now);
+    var stopTimer = (0, timer_1.timer)(now);
     var submitter = (0, submitter_1.firstPushWindowDecorator)((0, submitter_1.submitterFactory)(log, splitApi.postMetricsUsage, telemetry, telemetryRefreshRate, undefined, 0, true), telemetryRefreshRate);
     readiness.gate.once(constants_2.SDK_READY_FROM_CACHE, function () {
-        telemetry.recordTimeUntilReadyFromCache(startTime());
+        telemetry.recordTimeUntilReadyFromCache(stopTimer());
     });
     sdkReadinessManager.incInternalReadyCbCount();
     readiness.gate.once(constants_2.SDK_READY, function () {
-        telemetry.recordTimeUntilReady(startTime());
+        telemetry.recordTimeUntilReady(stopTimer());
         // Post config data when the SDK is ready and if the telemetry submitter was started
         if (submitter.isRunning()) {
             var postMetricsConfigTask = (0, submitter_1.submitterFactory)(log, splitApi.postMetricsConfig, telemetryCacheConfigAdapter(telemetry, settings), 0, undefined, 0, true);

package/cjs/trackers/telemetryTracker.js

@@ -6,10 +6,10 @@ var timer_1 = require("../utils/timeTracker/timer");
 var constants_1 = require("../utils/constants");
 function telemetryTrackerFactory(telemetryCache, now) {
     if (telemetryCache && now) {
-        var startTime_1 = (0, timer_1.timer)(now);
+        var sessionTimer_1 = (0, timer_1.timer)(now);
         return {
             trackEval: function (method) {
-                var evalTime = (0, timer_1.timer)(now);
+                var evalTimer = (0, timer_1.timer)(now);
                 return function (label) {
                     switch (label) {
                         case labels_1.EXCEPTION:
@@ -19,13 +19,13 @@ function telemetryTrackerFactory(telemetryCache, now) {
                             if (telemetryCache.recordNonReadyUsage)
                                 telemetryCache.recordNonReadyUsage();
                     }
-                    telemetryCache.recordLatency(method, evalTime());
+                    telemetryCache.recordLatency(method, evalTimer());
                 };
             },
             trackHttp: function (operation) {
-                var httpTime = (0, timer_1.timer)(now);
+                var httpTimer = (0, timer_1.timer)(now);
                 return function (error) {
-                    telemetryCache.recordHttpLatency(operation, httpTime());
+                    telemetryCache.recordHttpLatency(operation, httpTimer());
                     if (error && error.statusCode)
                         telemetryCache.recordHttpError(operation, error.statusCode);
                     else
@@ -34,7 +34,7 @@ function telemetryTrackerFactory(telemetryCache, now) {
             },
             sessionLength: function () {
                 if (telemetryCache.recordSessionLength)
-                    telemetryCache.recordSessionLength(startTime_1());
+                    telemetryCache.recordSessionLength(sessionTimer_1());
             },
             streamingEvent: function (e, d) {
                 if (e === constants_1.AUTH_REJECTION) {