@splitsoftware/splitio-commons 1.8.2-rc.0 → 1.8.2-rc.1

package/cjs/utils/inputValidation/apiKey.js

@@ -3,51 +3,52 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.releaseApiKey = exports.validateAndTrackApiKey = exports.usedKeysMap = exports.validateApiKey = void 0;
 var constants_1 = require("../../logger/constants");
 var lang_1 = require("../lang");
-var item = 'api_key';
-/** validates the given api key */
-function validateApiKey(log, maybeApiKey) {
-    var apiKey = false;
-    if (maybeApiKey == undefined) { // eslint-disable-line eqeqeq
+var item = 'sdk_key';
+// @TODO replace ApiKey with SdkKey in function names
+/** validates the given SDK key */
+function validateApiKey(log, maybeSdkKey) {
+    var sdkKey = false;
+    if (maybeSdkKey == undefined) { // eslint-disable-line eqeqeq
         log.error(constants_1.ERROR_NULL, [constants_1.LOG_PREFIX_INSTANTIATION, item]);
     }
-    else if ((0, lang_1.isString)(maybeApiKey)) {
-        if (maybeApiKey.length > 0)
-            apiKey = maybeApiKey;
+    else if ((0, lang_1.isString)(maybeSdkKey)) {
+        if (maybeSdkKey.length > 0)
+            sdkKey = maybeSdkKey;
         else
             log.error(constants_1.ERROR_EMPTY, [constants_1.LOG_PREFIX_INSTANTIATION, item]);
     }
     else {
         log.error(constants_1.ERROR_INVALID, [constants_1.LOG_PREFIX_INSTANTIATION, item]);
     }
-    return apiKey;
+    return sdkKey;
 }
 exports.validateApiKey = validateApiKey;
 // Exported for telemetry
 exports.usedKeysMap = {};
-/** validates the given api key and also warns if it is in use */
-function validateAndTrackApiKey(log, maybeApiKey) {
-    var apiKey = validateApiKey(log, maybeApiKey);
-    // If the apiKey is correct, we'll save it as the instance creation should work.
-    if (apiKey) {
-        if (!exports.usedKeysMap[apiKey]) {
+/** validates the given SDK key and also warns if it is in use */
+function validateAndTrackApiKey(log, maybeSdkKey) {
+    var sdkKey = validateApiKey(log, maybeSdkKey);
+    // If sdkKey is correct, we'll save it as the instance creation should work.
+    if (sdkKey) {
+        if (!exports.usedKeysMap[sdkKey]) {
             // If this key is not present, only warning scenarios is that we have factories for other keys.
-            exports.usedKeysMap[apiKey] = 1;
+            exports.usedKeysMap[sdkKey] = 1;
             if (Object.keys(exports.usedKeysMap).length > 1) {
-                log.warn(constants_1.WARN_API_KEY, ['an instance of the Split factory']);
+                log.warn(constants_1.WARN_SDK_KEY, ['an instance of the Split factory']);
             }
         }
         else {
-            log.warn(constants_1.WARN_API_KEY, [exports.usedKeysMap[apiKey] + " factory/ies with this API Key"]);
-            exports.usedKeysMap[apiKey]++;
+            log.warn(constants_1.WARN_SDK_KEY, [exports.usedKeysMap[sdkKey] + " factory/ies with this SDK Key"]);
+            exports.usedKeysMap[sdkKey]++;
         }
     }
-    return apiKey;
+    return sdkKey;
 }
 exports.validateAndTrackApiKey = validateAndTrackApiKey;
-function releaseApiKey(apiKey) {
-    if (exports.usedKeysMap[apiKey])
-        exports.usedKeysMap[apiKey]--;
-    if (exports.usedKeysMap[apiKey] === 0)
-        delete exports.usedKeysMap[apiKey];
+function releaseApiKey(sdkKey) {
+    if (exports.usedKeysMap[sdkKey])
+        exports.usedKeysMap[sdkKey]--;
+    if (exports.usedKeysMap[sdkKey] === 0)
+        delete exports.usedKeysMap[sdkKey];
 }
 exports.releaseApiKey = releaseApiKey;

package/cjs/utils/inputValidation/preloadedData.js

@@ -13,12 +13,12 @@ function validateSplitsData(log, maybeSplitsData, method) {
     if ((0, lang_1.isObject)(maybeSplitsData)) {
         var splitNames = Object.keys(maybeSplitsData);
         if (splitNames.length === 0)
-            log.warn(method + ": preloadedData.splitsData doesn't contain split definitions.");
+            log.warn(method + ": preloadedData.splitsData doesn't contain feature flag definitions.");
         // @TODO in the future, consider handling the possibility of having parsed definitions of splits
         if (splitNames.every(function (splitName) { return (0, split_1.validateSplit)(log, splitName, method) && (0, lang_1.isString)(maybeSplitsData[splitName]); }))
             return true;
     }
-    log.error(method + ": preloadedData.splitsData must be a map of split names to their serialized definitions.");
+    log.error(method + ": preloadedData.splitsData must be a map of feature flag names to their stringified definitions.");
     return false;
 }
 function validateMySegmentsData(log, maybeMySegmentsData, method) {
@@ -40,7 +40,7 @@ function validateSegmentsData(log, maybeSegmentsData, method) {
         if (segmentNames.every(function (segmentName) { return (0, lang_1.isString)(maybeSegmentsData[segmentName]); }))
             return true;
     }
-    log.error(method + ": preloadedData.segmentsData must be a map of segment names to their serialized definitions.");
+    log.error(method + ": preloadedData.segmentsData must be a map of segment names to their stringified definitions.");
     return false;
 }
 function validatePreloadedData(log, maybePreloadedData, method) {

package/cjs/utils/inputValidation/split.js

@@ -6,7 +6,7 @@ var lang_1 = require("../lang");
 // include BOM and nbsp
 var TRIMMABLE_SPACES_REGEX = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/;
 function validateSplit(log, maybeSplit, method, item) {
-    if (item === void 0) { item = 'split name'; }
+    if (item === void 0) { item = 'feature flag name'; }
     if (maybeSplit == undefined) { // eslint-disable-line eqeqeq
         log.error(constants_1.ERROR_NULL, [method, item]);
     }

package/cjs/utils/inputValidation/splits.js

@@ -5,8 +5,8 @@ var constants_1 = require("../../logger/constants");
 var lang_1 = require("../lang");
 var split_1 = require("./split");
 function validateSplits(log, maybeSplits, method, listName, item) {
-    if (listName === void 0) { listName = 'split_names'; }
-    if (item === void 0) { item = 'split name'; }
+    if (listName === void 0) { listName = 'feature flag names'; }
+    if (item === void 0) { item = 'feature flag name'; }
     if (Array.isArray(maybeSplits) && maybeSplits.length > 0) {
         var validatedArray_1 = [];
         // Remove invalid values

package/cjs/utils/settingsValidation/index.js

@@ -84,7 +84,7 @@ function fromSecondsToMillis(n) {
 }
 /**
  * Validates the given config and use it to build a settings object.
- * NOTE: it doesn't validate the Api Key. Call `validateApikey` or `validateAndTrackApiKey` for that after settings validation.
+ * NOTE: it doesn't validate the SDK Key. Call `validateApiKey` or `validateAndTrackApiKey` for that after settings validation.
  *
  * @param config user defined configuration
  * @param validationParams defaults and fields validators used to validate and creates a settings object from a given config

package/esm/logger/constants.js

@@ -92,7 +92,7 @@ export var WARN_INTEGRATION_INVALID = 218;
 export var WARN_SPLITS_FILTER_IGNORED = 219;
 export var WARN_SPLITS_FILTER_INVALID = 220;
 export var WARN_SPLITS_FILTER_EMPTY = 221;
-export var WARN_API_KEY = 222;
+export var WARN_SDK_KEY = 222;
 export var STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2 = 223;
 export var ERROR_ENGINE_COMBINER_IFELSEIF = 300;
 export var ERROR_LOGLEVEL_INVALID = 301;
@@ -132,7 +132,7 @@ export var LOG_PREFIX_SYNC = 'sync';
 export var LOG_PREFIX_SYNC_MANAGER = LOG_PREFIX_SYNC + ':sync-manager: ';
 export var LOG_PREFIX_SYNC_OFFLINE = LOG_PREFIX_SYNC + ':offline: ';
 export var LOG_PREFIX_SYNC_STREAMING = LOG_PREFIX_SYNC + ':streaming: ';
-export var LOG_PREFIX_SYNC_SPLITS = LOG_PREFIX_SYNC + ':split-changes: ';
+export var LOG_PREFIX_SYNC_SPLITS = LOG_PREFIX_SYNC + ':featureflag-changes: ';
 export var LOG_PREFIX_SYNC_SEGMENTS = LOG_PREFIX_SYNC + ':segment-changes: ';
 export var LOG_PREFIX_SYNC_MYSEGMENTS = LOG_PREFIX_SYNC + ':my-segments: ';
 export var LOG_PREFIX_SYNC_POLLING = LOG_PREFIX_SYNC + ':polling-manager: ';

package/esm/logger/messages/debug.js

@@ -12,8 +12,8 @@ export var codesDebug = codesInfo.concat([
     [c.ENGINE_MATCHER_CONTAINS_ALL, c.LOG_PREFIX_ENGINE_MATCHER + '[containsAllMatcher] %s contains all elements of %s? %s'],
     [c.ENGINE_MATCHER_CONTAINS_ANY, c.LOG_PREFIX_ENGINE_MATCHER + '[containsAnyMatcher] %s contains at least an element of %s? %s'],
     [c.ENGINE_MATCHER_CONTAINS_STRING, c.LOG_PREFIX_ENGINE_MATCHER + '[containsStringMatcher] %s contains %s? %s'],
-    [c.ENGINE_MATCHER_DEPENDENCY, c.LOG_PREFIX_ENGINE_MATCHER + '[dependencyMatcher] parent split "%s" evaluated to "%s" with label "%s". %s evaluated treatment is part of [%s] ? %s.'],
-    [c.ENGINE_MATCHER_DEPENDENCY_PRE, c.LOG_PREFIX_ENGINE_MATCHER + '[dependencyMatcher] will evaluate parent split: "%s" with key: %s %s'],
+    [c.ENGINE_MATCHER_DEPENDENCY, c.LOG_PREFIX_ENGINE_MATCHER + '[dependencyMatcher] parent feature flag "%s" evaluated to "%s" with label "%s". %s evaluated treatment is part of [%s] ? %s.'],
+    [c.ENGINE_MATCHER_DEPENDENCY_PRE, c.LOG_PREFIX_ENGINE_MATCHER + '[dependencyMatcher] will evaluate parent feature flag: "%s" with key: %s %s'],
     [c.ENGINE_MATCHER_EQUAL, c.LOG_PREFIX_ENGINE_MATCHER + '[equalToMatcher] is %s equal to %s? %s'],
     [c.ENGINE_MATCHER_EQUAL_TO_SET, c.LOG_PREFIX_ENGINE_MATCHER + '[equalToSetMatcher] is %s equal to set %s? %s'],
     [c.ENGINE_MATCHER_ENDS_WITH, c.LOG_PREFIX_ENGINE_MATCHER + '[endsWithMatcher] %s ends with %s? %s'],
@@ -34,15 +34,15 @@ export var codesDebug = codesInfo.concat([
     [c.RETRIEVE_CLIENT_EXISTING, 'Retrieving existing SDK client.'],
     [c.RETRIEVE_MANAGER, 'Retrieving manager instance.'],
     // synchronizer
-    [c.SYNC_OFFLINE_DATA, c.LOG_PREFIX_SYNC_OFFLINE + 'Splits data: \n%s'],
-    [c.SYNC_SPLITS_FETCH, c.LOG_PREFIX_SYNC_SPLITS + 'Spin up split update using since = %s'],
-    [c.SYNC_SPLITS_NEW, c.LOG_PREFIX_SYNC_SPLITS + 'New splits %s'],
-    [c.SYNC_SPLITS_REMOVED, c.LOG_PREFIX_SYNC_SPLITS + 'Removed splits %s'],
+    [c.SYNC_OFFLINE_DATA, c.LOG_PREFIX_SYNC_OFFLINE + 'Feature flags data: \n%s'],
+    [c.SYNC_SPLITS_FETCH, c.LOG_PREFIX_SYNC_SPLITS + 'Spin up feature flags update using since = %s'],
+    [c.SYNC_SPLITS_NEW, c.LOG_PREFIX_SYNC_SPLITS + 'New feature flags %s'],
+    [c.SYNC_SPLITS_REMOVED, c.LOG_PREFIX_SYNC_SPLITS + 'Removed feature flags %s'],
     [c.SYNC_SPLITS_SEGMENTS, c.LOG_PREFIX_SYNC_SPLITS + 'Segment names collected %s'],
     [c.STREAMING_NEW_MESSAGE, c.LOG_PREFIX_SYNC_STREAMING + 'New SSE message received, with data: %s.'],
     [c.SYNC_TASK_START, c.LOG_PREFIX_SYNC + ': Starting %s. Running each %s millis'],
     [c.SYNC_TASK_EXECUTE, c.LOG_PREFIX_SYNC + ': Running %s'],
     [c.SYNC_TASK_STOP, c.LOG_PREFIX_SYNC + ': Stopping %s'],
     // initialization / settings validation
-    [c.SETTINGS_SPLITS_FILTER, c.LOG_PREFIX_SETTINGS + ': splits filtering criteria is "%s".']
+    [c.SETTINGS_SPLITS_FILTER, c.LOG_PREFIX_SETTINGS + ': feature flags filtering criteria is "%s".']
 ]);

package/esm/logger/messages/error.js

@@ -1,7 +1,7 @@
 import * as c from '../constants';
 export var codesError = [
     // evaluator
-    [c.ERROR_ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Invalid Split, no valid rules found'],
+    [c.ERROR_ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Invalid feature flag, no valid rules found'],
     // SDK
     [c.ERROR_LOGLEVEL_INVALID, 'logger: Invalid Log Level - No changes to the logs will be applied.'],
     [c.ERROR_CLIENT_CANNOT_GET_READY, 'The SDK will not get ready. Reason: %s'],
@@ -9,7 +9,7 @@ export var codesError = [
     [c.ERROR_IMPRESSIONS_LISTENER, c.LOG_PREFIX_IMPRESSIONS_TRACKER + 'Impression listener logImpression method threw: %s.'],
     [c.ERROR_EVENTS_TRACKER, c.LOG_PREFIX_EVENTS_TRACKER + 'Failed to queue %s'],
     // synchronizer
-    [c.ERROR_SYNC_OFFLINE_LOADING, c.LOG_PREFIX_SYNC_OFFLINE + 'There was an issue loading the mock Splits data, no changes will be applied to the current cache. %s'],
+    [c.ERROR_SYNC_OFFLINE_LOADING, c.LOG_PREFIX_SYNC_OFFLINE + 'There was an issue loading the mock feature flags data. No changes will be applied to the current cache. %s'],
     [c.ERROR_STREAMING_SSE, c.LOG_PREFIX_SYNC_STREAMING + 'Failed to connect or error on streaming connection, with error message: %s'],
     [c.ERROR_STREAMING_AUTH, c.LOG_PREFIX_SYNC_STREAMING + 'Failed to authenticate for streaming. Error: %s.'],
     [c.ERROR_HTTP, 'Response status is not OK. Status: %s. URL: %s. Message: %s'],

package/esm/logger/messages/info.js

@@ -6,7 +6,7 @@ export var codesInfo = codesWarn.concat([
     [c.CLIENT_READY_FROM_CACHE, READY_MSG + ' from cache'],
     [c.CLIENT_READY, READY_MSG],
     // SDK
-    [c.IMPRESSION, c.LOG_PREFIX_IMPRESSIONS_TRACKER + 'Split: %s. Key: %s. Evaluation: %s. Label: %s'],
+    [c.IMPRESSION, c.LOG_PREFIX_IMPRESSIONS_TRACKER + 'Feature flag: %s. Key: %s. Evaluation: %s. Label: %s'],
     [c.IMPRESSION_QUEUEING, c.LOG_PREFIX_IMPRESSIONS_TRACKER + 'Queueing corresponding impression.'],
     [c.NEW_SHARED_CLIENT, 'New shared client instance created.'],
     [c.NEW_FACTORY, 'New Split SDK instance created.'],
@@ -19,13 +19,13 @@ export var codesInfo = 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 download of splits #%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 reseting timer.'],
     [c.SUBMITTERS_PUSH, c.LOG_PREFIX_SYNC_SUBMITTERS + 'Pushing %s.'],
     [c.STREAMING_REFRESH_TOKEN, c.LOG_PREFIX_SYNC_STREAMING + 'Refreshing streaming token in %s seconds, and connecting streaming in %s seconds.'],
     [c.STREAMING_RECONNECT, c.LOG_PREFIX_SYNC_STREAMING + 'Attempting to reconnect streaming in %s seconds.'],
     [c.STREAMING_CONNECTING, c.LOG_PREFIX_SYNC_STREAMING + 'Connecting streaming.'],
-    [c.STREAMING_DISABLED, c.LOG_PREFIX_SYNC_STREAMING + 'Streaming is disabled for given Api key. Switching to polling mode.'],
+    [c.STREAMING_DISABLED, c.LOG_PREFIX_SYNC_STREAMING + 'Streaming is disabled for given SDK key. Switching to polling mode.'],
     [c.STREAMING_DISCONNECTING, c.LOG_PREFIX_SYNC_STREAMING + 'Disconnecting streaming.'],
     [c.SYNC_START_POLLING, c.LOG_PREFIX_SYNC_MANAGER + 'Streaming not available. Starting polling.'],
     [c.SYNC_CONTINUE_POLLING, c.LOG_PREFIX_SYNC_MANAGER + 'Streaming couldn\'t connect. Continue polling.'],

package/esm/logger/messages/warn.js

@@ -6,7 +6,7 @@ export var codesWarn = codesError.concat([
     [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 download of segments #%s. Reason: %s'],
-    [c.SYNC_SPLITS_FETCH_FAILS, c.LOG_PREFIX_SYNC_SPLITS + 'Error while doing fetch of Splits. %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'],
     [c.STREAMING_FALLBACK, c.LOG_PREFIX_SYNC_STREAMING + 'Falling back to polling mode. Reason: %s'],
@@ -20,14 +20,14 @@ export var codesWarn = codesError.concat([
     [c.WARN_TRIMMING_PROPERTIES, '%s: Event has more than 300 properties. Some of them will be trimmed when processed.'],
     [c.WARN_CONVERTING, '%s: %s "%s" is not of type string, converting.'],
     [c.WARN_TRIMMING, '%s: %s "%s" has extra whitespace, trimming.'],
-    [c.WARN_NOT_EXISTENT_SPLIT, '%s: split "%s" does not exist in this environment, please double check what splits exist in the Split web console.'],
+    [c.WARN_NOT_EXISTENT_SPLIT, '%s: feature flag "%s" does not exist in this environment. Please double check what feature flags exist in the Split user interface.'],
     [c.WARN_LOWERCASE_TRAFFIC_TYPE, '%s: traffic_type_name should be all lowercase - converting string to lowercase.'],
-    [c.WARN_NOT_EXISTENT_TT, '%s: traffic type "%s" does not have any corresponding split in this environment, make sure you\'re tracking your events to a valid traffic type defined in the Split web console.'],
+    [c.WARN_NOT_EXISTENT_TT, '%s: traffic type "%s" does not have any corresponding feature flag in this environment, make sure you\'re tracking your events to a valid traffic type defined in the Split user interface.'],
     // initialization / settings validation
     [c.WARN_INTEGRATION_INVALID, c.LOG_PREFIX_SETTINGS + ': %s integration item(s) at settings is invalid. %s'],
-    [c.WARN_SPLITS_FILTER_IGNORED, c.LOG_PREFIX_SETTINGS + ': split filters have been configured but will have no effect if mode is not "%s", since synchronization is being deferred to an external tool.'],
-    [c.WARN_SPLITS_FILTER_INVALID, c.LOG_PREFIX_SETTINGS + ': split filter at position %s is invalid. It must be an object with a valid filter type ("byName" or "byPrefix") and a list of "values".'],
-    [c.WARN_SPLITS_FILTER_EMPTY, c.LOG_PREFIX_SETTINGS + ': splitFilters configuration must be a non-empty array of filter objects.'],
-    [c.WARN_API_KEY, c.LOG_PREFIX_SETTINGS + ': You already have %s. We recommend keeping only one instance of the factory at all times (Singleton pattern) and reusing it throughout your application'],
+    [c.WARN_SPLITS_FILTER_IGNORED, c.LOG_PREFIX_SETTINGS + ': feature flag filters have been configured but will have no effect if mode is not "%s", since synchronization is being deferred to an external tool.'],
+    [c.WARN_SPLITS_FILTER_INVALID, c.LOG_PREFIX_SETTINGS + ': feature flag filter at position %s is invalid. It must be an object with a valid filter type ("byName" or "byPrefix") and a list of "values".'],
+    [c.WARN_SPLITS_FILTER_EMPTY, c.LOG_PREFIX_SETTINGS + ': feature flag filter configuration must be a non-empty array of filter objects.'],
+    [c.WARN_SDK_KEY, c.LOG_PREFIX_SETTINGS + ': You already have %s. We recommend keeping only one instance of the factory at all times (Singleton pattern) and reusing it throughout your application'],
     [c.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2, c.LOG_PREFIX_SYNC_STREAMING + 'Fetching MySegments due to an error processing %s notification: %s'],
 ]);

package/esm/sdkClient/client.js

@@ -8,10 +8,10 @@ import { CONTROL, TREATMENT, TREATMENTS, TREATMENT_WITH_CONFIG, TREATMENTS_WITH_
 import { IMPRESSION, IMPRESSION_QUEUEING } from '../logger/constants';
 import { isStorageSync } from '../trackers/impressionObserver/utils';
 var treatmentNotReady = { treatment: CONTROL, label: SDK_NOT_READY };
-function treatmentsNotReady(splitNames) {
+function treatmentsNotReady(featureFlagNames) {
     var evaluations = {};
-    splitNames.forEach(function (splitName) {
-        evaluations[splitName] = treatmentNotReady;
+    featureFlagNames.forEach(function (featureFlagName) {
+        evaluations[featureFlagName] = treatmentNotReady;
     });
     return evaluations;
 }
@@ -21,59 +21,59 @@ function treatmentsNotReady(splitNames) {
 export function clientFactory(params) {
     var readinessManager = params.sdkReadinessManager.readinessManager, storage = params.storage, settings = params.settings, impressionsTracker = params.impressionsTracker, eventTracker = params.eventTracker, telemetryTracker = params.telemetryTracker;
     var log = settings.log, mode = settings.mode;
-    function getTreatment(key, splitName, attributes, withConfig) {
+    function getTreatment(key, featureFlagName, attributes, withConfig) {
         if (withConfig === void 0) { withConfig = false; }
         var stopTelemetryTracker = telemetryTracker.trackEval(withConfig ? TREATMENT_WITH_CONFIG : TREATMENT);
         var wrapUp = function (evaluationResult) {
             var queue = [];
-            var treatment = processEvaluation(evaluationResult, splitName, key, attributes, withConfig, "getTreatment" + (withConfig ? 'withConfig' : ''), queue);
+            var treatment = processEvaluation(evaluationResult, featureFlagName, key, attributes, withConfig, "getTreatment" + (withConfig ? 'withConfig' : ''), queue);
             impressionsTracker.track(queue, attributes);
             stopTelemetryTracker(queue[0] && queue[0].label);
             return treatment;
         };
         var evaluation = readinessManager.isReady() || readinessManager.isReadyFromCache() ?
-            evaluateFeature(log, key, splitName, attributes, storage) :
+            evaluateFeature(log, key, featureFlagName, attributes, storage) :
             isStorageSync(settings) ? // If the SDK is not ready, treatment may be incorrect due to having splits but not segments data, or storage is not connected
                 treatmentNotReady :
                 Promise.resolve(treatmentNotReady); // Promisify if async
         return thenable(evaluation) ? evaluation.then(function (res) { return wrapUp(res); }) : wrapUp(evaluation);
     }
-    function getTreatmentWithConfig(key, splitName, attributes) {
-        return getTreatment(key, splitName, attributes, true);
+    function getTreatmentWithConfig(key, featureFlagName, attributes) {
+        return getTreatment(key, featureFlagName, attributes, true);
     }
-    function getTreatments(key, splitNames, attributes, withConfig) {
+    function getTreatments(key, featureFlagNames, attributes, withConfig) {
         if (withConfig === void 0) { withConfig = false; }
         var stopTelemetryTracker = telemetryTracker.trackEval(withConfig ? TREATMENTS_WITH_CONFIG : TREATMENTS);
         var wrapUp = function (evaluationResults) {
             var queue = [];
             var treatments = {};
-            Object.keys(evaluationResults).forEach(function (splitName) {
-                treatments[splitName] = processEvaluation(evaluationResults[splitName], splitName, key, attributes, withConfig, "getTreatments" + (withConfig ? 'withConfig' : ''), queue);
+            Object.keys(evaluationResults).forEach(function (featureFlagName) {
+                treatments[featureFlagName] = processEvaluation(evaluationResults[featureFlagName], featureFlagName, key, attributes, withConfig, "getTreatments" + (withConfig ? 'withConfig' : ''), queue);
             });
             impressionsTracker.track(queue, attributes);
             stopTelemetryTracker(queue[0] && queue[0].label);
             return treatments;
         };
         var evaluations = readinessManager.isReady() || readinessManager.isReadyFromCache() ?
-            evaluateFeatures(log, key, splitNames, attributes, storage) :
+            evaluateFeatures(log, key, featureFlagNames, attributes, storage) :
             isStorageSync(settings) ? // If the SDK is not ready, treatment may be incorrect due to having splits but not segments data, or storage is not connected
-                treatmentsNotReady(splitNames) :
-                Promise.resolve(treatmentsNotReady(splitNames)); // Promisify if async
+                treatmentsNotReady(featureFlagNames) :
+                Promise.resolve(treatmentsNotReady(featureFlagNames)); // Promisify if async
         return thenable(evaluations) ? evaluations.then(function (res) { return wrapUp(res); }) : wrapUp(evaluations);
     }
-    function getTreatmentsWithConfig(key, splitNames, attributes) {
-        return getTreatments(key, splitNames, attributes, true);
+    function getTreatmentsWithConfig(key, featureFlagNames, attributes) {
+        return getTreatments(key, featureFlagNames, attributes, true);
     }
     // Internal function
-    function processEvaluation(evaluation, splitName, key, attributes, withConfig, invokingMethodName, queue) {
+    function processEvaluation(evaluation, featureFlagName, key, attributes, withConfig, invokingMethodName, queue) {
         var matchingKey = getMatching(key);
         var bucketingKey = getBucketing(key);
         var treatment = evaluation.treatment, label = evaluation.label, changeNumber = evaluation.changeNumber, _a = evaluation.config, config = _a === void 0 ? null : _a;
-        log.info(IMPRESSION, [splitName, matchingKey, treatment, label]);
-        if (validateSplitExistance(log, readinessManager, splitName, label, invokingMethodName)) {
+        log.info(IMPRESSION, [featureFlagName, matchingKey, treatment, label]);
+        if (validateSplitExistance(log, readinessManager, featureFlagName, label, invokingMethodName)) {
             log.info(IMPRESSION_QUEUEING);
             queue.push({
-                feature: splitName,
+                feature: featureFlagName,
                 keyName: matchingKey,
                 treatment: treatment,
                 time: Date.now(),

package/esm/sdkClient/clientAttributesDecoration.js

@@ -12,17 +12,17 @@ export function clientAttributesDecoration(log, client) {
     var clientGetTreatments = client.getTreatments;
     var clientGetTreatmentsWithConfig = client.getTreatmentsWithConfig;
     var clientTrack = client.track;
-    function getTreatment(maybeKey, maybeSplit, maybeAttributes) {
-        return clientGetTreatment(maybeKey, maybeSplit, combineAttributes(maybeAttributes));
+    function getTreatment(maybeKey, maybeFeatureFlagName, maybeAttributes) {
+        return clientGetTreatment(maybeKey, maybeFeatureFlagName, combineAttributes(maybeAttributes));
     }
-    function getTreatmentWithConfig(maybeKey, maybeSplit, maybeAttributes) {
-        return clientGetTreatmentWithConfig(maybeKey, maybeSplit, combineAttributes(maybeAttributes));
+    function getTreatmentWithConfig(maybeKey, maybeFeatureFlagName, maybeAttributes) {
+        return clientGetTreatmentWithConfig(maybeKey, maybeFeatureFlagName, combineAttributes(maybeAttributes));
     }
-    function getTreatments(maybeKey, maybeSplits, maybeAttributes) {
-        return clientGetTreatments(maybeKey, maybeSplits, combineAttributes(maybeAttributes));
+    function getTreatments(maybeKey, maybeFeatureFlagNames, maybeAttributes) {
+        return clientGetTreatments(maybeKey, maybeFeatureFlagNames, combineAttributes(maybeAttributes));
     }
-    function getTreatmentsWithConfig(maybeKey, maybeSplits, maybeAttributes) {
-        return clientGetTreatmentsWithConfig(maybeKey, maybeSplits, combineAttributes(maybeAttributes));
+    function getTreatmentsWithConfig(maybeKey, maybeFeatureFlagNames, maybeAttributes) {
+        return clientGetTreatmentsWithConfig(maybeKey, maybeFeatureFlagNames, combineAttributes(maybeAttributes));
     }
     function track(maybeKey, maybeTT, maybeEvent, maybeEventValue, maybeProperties) {
         return clientTrack(maybeKey, maybeTT, maybeEvent, maybeEventValue, maybeProperties);

package/esm/sdkClient/clientInputValidation.js

@@ -13,10 +13,10 @@ export function clientInputValidationDecorator(settings, client, readinessManage
     /**
      * Avoid repeating this validations code
      */
-    function validateEvaluationParams(maybeKey, maybeSplitOrSplits, maybeAttributes, methodName) {
+    function validateEvaluationParams(maybeKey, maybeFeatureFlagNameOrNames, maybeAttributes, methodName) {
         var multi = startsWith(methodName, 'getTreatments');
         var key = validateKey(log, maybeKey, methodName);
-        var splitOrSplits = multi ? validateSplits(log, maybeSplitOrSplits, methodName) : validateSplit(log, maybeSplitOrSplits, methodName);
+        var splitOrSplits = multi ? validateSplits(log, maybeFeatureFlagNameOrNames, methodName) : validateSplit(log, maybeFeatureFlagNameOrNames, methodName);
         var attributes = validateAttributes(log, maybeAttributes, methodName);
         var isOperational = validateIfNotDestroyed(log, readinessManager, methodName);
         validateIfOperational(log, readinessManager, methodName);
@@ -31,8 +31,8 @@ export function clientInputValidationDecorator(settings, client, readinessManage
     function wrapResult(value) {
         return isSync ? value : Promise.resolve(value);
     }
-    function getTreatment(maybeKey, maybeSplit, maybeAttributes) {
-        var params = validateEvaluationParams(maybeKey, maybeSplit, maybeAttributes, 'getTreatment');
+    function getTreatment(maybeKey, maybeFeatureFlagName, maybeAttributes) {
+        var params = validateEvaluationParams(maybeKey, maybeFeatureFlagName, maybeAttributes, 'getTreatment');
         if (params.valid) {
             return client.getTreatment(params.key, params.splitOrSplits, params.attributes);
         }
@@ -40,8 +40,8 @@ export function clientInputValidationDecorator(settings, client, readinessManage
             return wrapResult(CONTROL);
         }
     }
-    function getTreatmentWithConfig(maybeKey, maybeSplit, maybeAttributes) {
-        var params = validateEvaluationParams(maybeKey, maybeSplit, maybeAttributes, 'getTreatmentWithConfig');
+    function getTreatmentWithConfig(maybeKey, maybeFeatureFlagName, maybeAttributes) {
+        var params = validateEvaluationParams(maybeKey, maybeFeatureFlagName, maybeAttributes, 'getTreatmentWithConfig');
         if (params.valid) {
             return client.getTreatmentWithConfig(params.key, params.splitOrSplits, params.attributes);
         }
@@ -49,8 +49,8 @@ export function clientInputValidationDecorator(settings, client, readinessManage
             return wrapResult(objectAssign({}, CONTROL_WITH_CONFIG));
         }
     }
-    function getTreatments(maybeKey, maybeSplits, maybeAttributes) {
-        var params = validateEvaluationParams(maybeKey, maybeSplits, maybeAttributes, 'getTreatments');
+    function getTreatments(maybeKey, maybeFeatureFlagNames, maybeAttributes) {
+        var params = validateEvaluationParams(maybeKey, maybeFeatureFlagNames, maybeAttributes, 'getTreatments');
         if (params.valid) {
             return client.getTreatments(params.key, params.splitOrSplits, params.attributes);
         }
@@ -61,8 +61,8 @@ export function clientInputValidationDecorator(settings, client, readinessManage
             return wrapResult(res_1);
         }
     }
-    function getTreatmentsWithConfig(maybeKey, maybeSplits, maybeAttributes) {
-        var params = validateEvaluationParams(maybeKey, maybeSplits, maybeAttributes, 'getTreatmentsWithConfig');
+    function getTreatmentsWithConfig(maybeKey, maybeFeatureFlagNames, maybeAttributes) {
+        var params = validateEvaluationParams(maybeKey, maybeFeatureFlagNames, maybeAttributes, 'getTreatmentsWithConfig');
         if (params.valid) {
             return client.getTreatmentsWithConfig(params.key, params.splitOrSplits, params.attributes);
         }

package/esm/sdkClient/sdkClient.js

@@ -49,7 +49,7 @@ export function sdkClientFactory(params, isSharedClient) {
                 // Cleanup event listeners
                 sdkReadinessManager.readinessManager.destroy();
                 signalListener && signalListener.stop();
-                // Release the API Key if it is the main client
+                // Release the SDK Key if it is the main client
                 if (!isSharedClient)
                     releaseApiKey(settings.core.authorizationKey);
                 if (uniqueKeysTracker)

package/esm/sdkFactory/index.js

@@ -18,7 +18,7 @@ import { NONE, OPTIMIZED } from '../utils/constants';
 export function sdkFactory(params) {
     var settings = params.settings, platform = params.platform, storageFactory = params.storageFactory, splitApiFactory = params.splitApiFactory, extraProps = params.extraProps, syncManagerFactory = params.syncManagerFactory, SignalListener = params.SignalListener, impressionsObserverFactory = params.impressionsObserverFactory, integrationsManagerFactory = params.integrationsManagerFactory, sdkManagerFactory = params.sdkManagerFactory, sdkClientMethodFactory = params.sdkClientMethodFactory, filterAdapterFactory = params.filterAdapterFactory;
     var log = settings.log, impressionsMode = settings.sync.impressionsMode;
-    // @TODO handle non-recoverable errors, such as, global `fetch` not available, invalid API Key, etc.
+    // @TODO handle non-recoverable errors, such as, global `fetch` not available, invalid SDK Key, etc.
     // On non-recoverable errors, we should mark the SDK as destroyed and not start synchronization.
     // We will just log and allow for the SDK to end up throwing an SDK_TIMEOUT event for devs to handle.
     validateAndTrackApiKey(log, settings.core.authorizationKey);

package/esm/sdkManager/index.js

@@ -2,6 +2,9 @@ import { objectAssign } from '../utils/lang/objectAssign';
 import { thenable } from '../utils/promise/thenable';
 import { find } from '../utils/lang';
 import { validateSplit, validateSplitExistance, validateIfNotDestroyed, validateIfOperational } from '../utils/inputValidation';
+var SPLIT_FN_LABEL = 'split';
+var SPLITS_FN_LABEL = 'splits';
+var NAMES_FN_LABEL = 'names';
 function collectTreatments(splitObject) {
     var conditions = splitObject.conditions;
     // Rollout conditions are supposed to have the entire partitions list, so we find the first one.
@@ -35,15 +38,14 @@ function objectsToViews(splitObjects) {
 }
 export function sdkManagerFactory(log, splits, _a) {
     var readinessManager = _a.readinessManager, sdkStatus = _a.sdkStatus;
-    var SPLIT_FN_LABEL = 'split';
     return objectAssign(
     // Proto-linkage of the readiness Event Emitter
     Object.create(sdkStatus), {
         /**
-         * Get the Split object corresponding to the given split name if valid
+         * Get the feature flag object corresponding to the given feature flag name if valid
          */
-        split: function (maybeSplitName) {
-            var splitName = validateSplit(log, maybeSplitName, SPLIT_FN_LABEL);
+        split: function (featureFlagName) {
+            var splitName = validateSplit(log, featureFlagName, SPLIT_FN_LABEL);
             if (!validateIfNotDestroyed(log, readinessManager, SPLIT_FN_LABEL) || !validateIfOperational(log, readinessManager, SPLIT_FN_LABEL) || !splitName) {
                 return null;
             }
@@ -58,10 +60,10 @@ export function sdkManagerFactory(log, splits, _a) {
             return objectToView(split);
         },
         /**
-         * Get the Split objects present on the factory storage
+         * Get the feature flag objects present on the factory storage
          */
         splits: function () {
-            if (!validateIfNotDestroyed(log, readinessManager, 'splits') || !validateIfOperational(log, readinessManager, 'splits')) {
+            if (!validateIfNotDestroyed(log, readinessManager, SPLITS_FN_LABEL) || !validateIfOperational(log, readinessManager, SPLITS_FN_LABEL)) {
                 return [];
             }
             var currentSplits = splits.getAll();
@@ -70,10 +72,10 @@ export function sdkManagerFactory(log, splits, _a) {
                 objectsToViews(currentSplits);
         },
         /**
-         * Get the Split names present on the factory storage
+         * Get the feature flag names present on the factory storage
          */
         names: function () {
-            if (!validateIfNotDestroyed(log, readinessManager, 'names') || !validateIfOperational(log, readinessManager, 'names')) {
+            if (!validateIfNotDestroyed(log, readinessManager, NAMES_FN_LABEL) || !validateIfOperational(log, readinessManager, NAMES_FN_LABEL)) {
                 return [];
             }
             var splitNames = splits.getSplitNames();

package/esm/services/splitHttpClient.js

@@ -50,7 +50,7 @@ export function splitHttpClientFactory(settings, getFetch, getOptions) {
             if (resp) { // An HTTP error
                 switch (resp.status) {
                     case 404:
-                        msg = 'Invalid API key or resource not found.';
+                        msg = 'Invalid SDK key or resource not found.';
                         break;
                     // Don't use resp.statusText since reason phrase is removed in HTTP/2
                     default:

package/esm/storages/inRedis/SplitsCacheInRedis.js

@@ -65,7 +65,7 @@ var SplitsCacheInRedis = /** @class */ (function (_super) {
                 newStringifiedSplit = JSON.stringify(split);
             }
             catch (e) {
-                throw new Error('Error parsing split definition: ' + e);
+                throw new Error('Error parsing feature flag definition: ' + e);
             }
             return Promise.all([
                 _this.redis.set(splitKey, newStringifiedSplit),
@@ -226,7 +226,7 @@ var SplitsCacheInRedis = /** @class */ (function (_super) {
             return Promise.resolve(splits);
         })
             .catch(function (e) {
-            _this.log.error(LOG_PREFIX + ("Could not grab splits due to an error: " + e + "."));
+            _this.log.error(LOG_PREFIX + ("Could not grab feature flags due to an error: " + e + "."));
             return Promise.reject(e);
         });
     };

package/esm/storages/pluggable/SplitsCachePluggable.js

@@ -52,7 +52,7 @@ var SplitsCachePluggable = /** @class */ (function (_super) {
                 stringifiedNewSplit = JSON.stringify(split);
             }
             catch (e) {
-                throw new Error('Error parsing split definition: ' + e);
+                throw new Error('Error parsing feature flag definition: ' + e);
             }
             return Promise.all([
                 _this.wrapper.set(splitKey, stringifiedNewSplit),

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

@@ -81,7 +81,7 @@ export function segmentChangesUpdaterFactory(log, segmentChangesFetcher, segment
                 // @TODO although factory status is destroyed, synchronization is not stopped
                 if (readiness)
                     readiness.destroy();
-                log.error(LOG_PREFIX_INSTANTIATION + ": you passed a client-side type authorizationKey, please grab an Api Key from the Split web console that is of type Server-side.");
+                log.error(LOG_PREFIX_INSTANTIATION + ": you passed a client-side type authorizationKey, please grab an SDK Key from the Split user interface that is of type server-side.");
             }
             else {
                 log.warn(LOG_PREFIX_SYNC_SEGMENTS + "Error while doing fetch of segments. " + error);

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

@@ -2,7 +2,6 @@ import { _Set, setToArray } from '../../../utils/lang/sets';
 import { timeout } from '../../../utils/promise/timeout';
 import { SDK_SPLITS_ARRIVED, SDK_SPLITS_CACHE_LOADED } from '../../../readiness/constants';
 import { SYNC_SPLITS_FETCH, SYNC_SPLITS_NEW, SYNC_SPLITS_REMOVED, SYNC_SPLITS_SEGMENTS, SYNC_SPLITS_FETCH_FAILS, SYNC_SPLITS_FETCH_RETRY } from '../../../logger/constants';
-import { _Map } from '../../../utils/lang/maps';
 // Checks that all registered segments have been fetched (changeNumber !== -1 for every segment).
 // Returns a promise that could be rejected.
 // @TODO review together with Segments and MySegments storage APIs
@@ -35,25 +34,19 @@ export function parseSegments(_a) {
  * Exported for testing purposes.
  */
 export function computeSplitsMutation(entries) {
-    var uniqueEntries = new _Map();
-    entries.forEach(function (split) {
-        var prevSplit = uniqueEntries.get(split.name);
-        if (!prevSplit || prevSplit.changeNumber < split.changeNumber)
-            uniqueEntries.set(split.name, split);
-    });
     var segments = new _Set();
-    var computed = { added: [], removed: [], segments: [] };
-    uniqueEntries.forEach(function (split) {
+    var computed = entries.reduce(function (accum, split) {
         if (split.status === 'ACTIVE') {
-            computed.added.push([split.name, split]);
+            accum.added.push([split.name, split]);
             parseSegments(split).forEach(function (segmentName) {
                 segments.add(segmentName);
             });
         }
         else {
-            computed.removed.push(split.name);
+            accum.removed.push(split.name);
         }
-    });
+        return accum;
+    }, { added: [], removed: [], segments: [] });
     computed.segments = setToArray(segments);
     return computed;
 }