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

package/esm/evaluator/matchers/cont_any.js

@@ -1,6 +1,5 @@
-import { ENGINE_MATCHER_CONTAINS_ANY } from '../../logger/constants';
 import { findIndex } from '../../utils/lang';
-export function containsAnySetMatcherContext(log, ruleAttr) {
+export function containsAnySetMatcherContext(ruleAttr) {
     return function containsAnyMatcher(runtimeAttr) {
         var containsAny = false;
         var _loop_1 = function (i) {
@@ -10,7 +9,6 @@ export function containsAnySetMatcherContext(log, ruleAttr) {
         for (var i = 0; i < ruleAttr.length && !containsAny; i++) {
             _loop_1(i);
         }
-        log.debug(ENGINE_MATCHER_CONTAINS_ANY, [runtimeAttr, ruleAttr, containsAny]);
         return containsAny;
     };
 }

package/esm/evaluator/matchers/cont_str.js

@@ -1,9 +1,7 @@
 import { isString } from '../../utils/lang';
-import { ENGINE_MATCHER_CONTAINS_STRING } from '../../logger/constants';
-export function containsStringMatcherContext(log, ruleAttr) {
+export function containsStringMatcherContext(ruleAttr) {
     return function containsStringMatcher(runtimeAttr) {
         var contains = ruleAttr.some(function (e) { return isString(runtimeAttr) && runtimeAttr.indexOf(e) > -1; });
-        log.debug(ENGINE_MATCHER_CONTAINS_STRING, [runtimeAttr, ruleAttr, contains]);
         return contains;
     };
 }

package/esm/evaluator/matchers/dependency.js

@@ -1,6 +1,6 @@
 import { thenable } from '../../utils/promise/thenable';
 import { ENGINE_MATCHER_DEPENDENCY, ENGINE_MATCHER_DEPENDENCY_PRE } from '../../logger/constants';
-export function dependencyMatcherContext(log, _a, storage) {
+export function dependencyMatcherContext(_a, storage, log) {
     var split = _a.split, treatments = _a.treatments;
     function checkTreatment(evaluation, acceptableTreatments, parentName) {
         var matches = false;

package/esm/evaluator/matchers/eq.js

@@ -1,8 +1,6 @@
-import { ENGINE_MATCHER_EQUAL } from '../../logger/constants';
-export function equalToMatcherContext(log, ruleAttr) {
+export function equalToMatcherContext(ruleAttr) {
     return function equalToMatcher(runtimeAttr) {
         var isEqual = runtimeAttr === ruleAttr;
-        log.debug(ENGINE_MATCHER_EQUAL, [runtimeAttr, ruleAttr, isEqual]);
         return isEqual;
     };
 }

package/esm/evaluator/matchers/eq_set.js

@@ -1,6 +1,5 @@
-import { ENGINE_MATCHER_EQUAL_TO_SET } from '../../logger/constants';
 import { findIndex } from '../../utils/lang';
-export function equalToSetMatcherContext(log, ruleAttr) {
+export function equalToSetMatcherContext(ruleAttr) {
     return function equalToSetMatcher(runtimeAttr) {
         // Length being the same is the first condition.
         var isEqual = runtimeAttr.length === ruleAttr.length;
@@ -12,7 +11,6 @@ export function equalToSetMatcherContext(log, ruleAttr) {
         for (var i = 0; i < runtimeAttr.length && isEqual; i++) {
             _loop_1(i);
         }
-        log.debug(ENGINE_MATCHER_EQUAL_TO_SET, [runtimeAttr, ruleAttr, isEqual]);
         return isEqual;
     };
 }

package/esm/evaluator/matchers/ew.js

@@ -1,9 +1,7 @@
-import { ENGINE_MATCHER_ENDS_WITH } from '../../logger/constants';
 import { endsWith } from '../../utils/lang';
-export function endsWithMatcherContext(log, ruleAttr) {
+export function endsWithMatcherContext(ruleAttr) {
     return function endsWithMatcher(runtimeAttr) {
         var strEndsWith = ruleAttr.some(function (e) { return endsWith(runtimeAttr, e); });
-        log.debug(ENGINE_MATCHER_ENDS_WITH, [runtimeAttr, ruleAttr, strEndsWith]);
         return strEndsWith;
     };
 }

package/esm/evaluator/matchers/gte.js

@@ -1,8 +1,6 @@
-import { ENGINE_MATCHER_GREATER } from '../../logger/constants';
-export function greaterThanEqualMatcherContext(log, ruleAttr) {
+export function greaterThanEqualMatcherContext(ruleAttr) {
     return function greaterThanEqualMatcher(runtimeAttr) {
-        var isGreaterEqualThan = runtimeAttr >= ruleAttr;
-        log.debug(ENGINE_MATCHER_GREATER, [runtimeAttr, ruleAttr, isGreaterEqualThan]);
-        return isGreaterEqualThan;
+        var isGreaterThanEqual = runtimeAttr >= ruleAttr;
+        return isGreaterThanEqual;
     };
 }

package/esm/evaluator/matchers/index.js

@@ -15,6 +15,11 @@ import { containsStringMatcherContext } from './cont_str';
 import { dependencyMatcherContext } from './dependency';
 import { booleanMatcherContext } from './boolean';
 import { stringMatcherContext } from './string';
+import { equalToSemverMatcherContext } from './semver_eq';
+import { greaterThanEqualToSemverMatcherContext } from './semver_gte';
+import { lessThanEqualToSemverMatcherContext } from './semver_lte';
+import { betweenSemverMatcherContext } from './semver_between';
+import { inListSemverMatcherContext } from './semver_inlist';
 var matchers = [
     undefined,
     allMatcherContext,
@@ -33,7 +38,12 @@ var matchers = [
     containsStringMatcherContext,
     dependencyMatcherContext,
     booleanMatcherContext,
-    stringMatcherContext // MATCHES_STRING: 17
+    stringMatcherContext,
+    equalToSemverMatcherContext,
+    greaterThanEqualToSemverMatcherContext,
+    lessThanEqualToSemverMatcherContext,
+    betweenSemverMatcherContext,
+    inListSemverMatcherContext, // IN_LIST_SEMVER: 22
 ];
 /**
  * Matcher factory.
@@ -43,6 +53,6 @@ export function matcherFactory(log, matcherDto, storage) {
     var matcherFn;
     // @ts-ignore
     if (matchers[type])
-        matcherFn = matchers[type](log, value, storage); // There is no index-out-of-bound exception in JavaScript
+        matcherFn = matchers[type](value, storage, log); // There is no index-out-of-bound exception in JavaScript
     return matcherFn;
 }

package/esm/evaluator/matchers/lte.js

@@ -1,8 +1,6 @@
-import { ENGINE_MATCHER_LESS } from '../../logger/constants';
-export function lessThanEqualMatcherContext(log, ruleAttr) {
+export function lessThanEqualMatcherContext(ruleAttr) {
     return function lessThanEqualMatcher(runtimeAttr) {
-        var isLessEqualThan = runtimeAttr <= ruleAttr;
-        log.debug(ENGINE_MATCHER_LESS, [runtimeAttr, ruleAttr, isLessEqualThan]);
-        return isLessEqualThan;
+        var isLessThanEqual = runtimeAttr <= ruleAttr;
+        return isLessThanEqual;
     };
 }

package/esm/evaluator/matchers/matcherTypes.js

@@ -16,7 +16,12 @@ export var matcherTypes = {
     CONTAINS_STRING: 14,
     IN_SPLIT_TREATMENT: 15,
     EQUAL_TO_BOOLEAN: 16,
-    MATCHES_STRING: 17
+    MATCHES_STRING: 17,
+    EQUAL_TO_SEMVER: 18,
+    GREATER_THAN_OR_EQUAL_TO_SEMVER: 19,
+    LESS_THAN_OR_EQUAL_TO_SEMVER: 20,
+    BETWEEN_SEMVER: 21,
+    IN_LIST_SEMVER: 22,
 };
 export var matcherDataTypes = {
     BOOLEAN: 'BOOLEAN',

package/esm/evaluator/matchers/part_of.js

@@ -1,6 +1,5 @@
 import { findIndex } from '../../utils/lang';
-import { ENGINE_MATCHER_PART_OF } from '../../logger/constants';
-export function partOfSetMatcherContext(log, ruleAttr) {
+export function partOfSetMatcherContext(ruleAttr) {
     return function partOfMatcher(runtimeAttr) {
         // To be part of the length should be minor or equal.
         var isPartOf = runtimeAttr.length <= ruleAttr.length;
@@ -12,7 +11,6 @@ export function partOfSetMatcherContext(log, ruleAttr) {
         for (var i = 0; i < runtimeAttr.length && isPartOf; i++) {
             _loop_1(i);
         }
-        log.debug(ENGINE_MATCHER_PART_OF, [runtimeAttr, ruleAttr, isPartOf]);
         return isPartOf;
     };
 }

package/esm/evaluator/matchers/segment.js

@@ -1,17 +1,12 @@
 import { thenable } from '../../utils/promise/thenable';
-import { ENGINE_MATCHER_SEGMENT } from '../../logger/constants';
-export function segmentMatcherContext(log, segmentName, storage) {
+export function segmentMatcherContext(segmentName, storage) {
     return function segmentMatcher(key) {
         var isInSegment = storage.segments.isInSegment(segmentName, key);
         if (thenable(isInSegment)) {
             isInSegment.then(function (result) {
-                log.debug(ENGINE_MATCHER_SEGMENT, [segmentName, key, isInSegment]);
                 return result;
             });
         }
-        else {
-            log.debug(ENGINE_MATCHER_SEGMENT, [segmentName, key, isInSegment]);
-        }
         return isInSegment;
     };
 }

package/esm/evaluator/matchers/semver_between.js

@@ -0,0 +1,10 @@
+import { Semver } from '../../utils/Semver';
+export function betweenSemverMatcherContext(ruleAttr) {
+    var startSemver = new Semver(ruleAttr.start);
+    var endSemver = new Semver(ruleAttr.end);
+    return function betweenSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver(runtimeAttr);
+        var isBetween = startSemver.compare(runtimeSemver) <= 0 && endSemver.compare(runtimeSemver) >= 0;
+        return isBetween;
+    };
+}

package/esm/evaluator/matchers/semver_eq.js

@@ -0,0 +1,9 @@
+import { Semver } from '../../utils/Semver';
+export function equalToSemverMatcherContext(ruleAttr) {
+    var ruleSemver = new Semver(ruleAttr);
+    return function equalToSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver(runtimeAttr);
+        var isEqual = ruleSemver.version === runtimeSemver.version;
+        return isEqual;
+    };
+}

package/esm/evaluator/matchers/semver_gte.js

@@ -0,0 +1,9 @@
+import { Semver } from '../../utils/Semver';
+export function greaterThanEqualToSemverMatcherContext(ruleAttr) {
+    var ruleSemver = new Semver(ruleAttr);
+    return function greaterThanEqualToSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver(runtimeAttr);
+        var isGreaterThanEqual = runtimeSemver.compare(ruleSemver) >= 0;
+        return isGreaterThanEqual;
+    };
+}

package/esm/evaluator/matchers/semver_inlist.js

@@ -0,0 +1,13 @@
+import { _Set } from '../../utils/lang/sets';
+import { Semver } from '../../utils/Semver';
+export function inListSemverMatcherContext(ruleAttr) {
+    // @TODO ruleAttr validation should be done at the `parser` or `matchersTransform` level to reuse for all matchers
+    if (!ruleAttr || ruleAttr.length === 0)
+        throw new Error('whitelistMatcherData is required for IN_LIST_SEMVER matcher type');
+    var listOfSemvers = new _Set(ruleAttr.map(function (version) { return new Semver(version).version; }));
+    return function inListSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver(runtimeAttr).version;
+        var isInList = listOfSemvers.has(runtimeSemver);
+        return isInList;
+    };
+}

package/esm/evaluator/matchers/semver_lte.js

@@ -0,0 +1,9 @@
+import { Semver } from '../../utils/Semver';
+export function lessThanEqualToSemverMatcherContext(ruleAttr) {
+    var ruleSemver = new Semver(ruleAttr);
+    return function lessThanEqualToSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver(runtimeAttr);
+        var isLessThanEqual = runtimeSemver.compare(ruleSemver) <= 0;
+        return isLessThanEqual;
+    };
+}

package/esm/evaluator/matchers/string.js

@@ -1,16 +1,7 @@
-import { ENGINE_MATCHER_STRING_INVALID, ENGINE_MATCHER_STRING } from '../../logger/constants';
-export function stringMatcherContext(log, ruleAttr) {
+export function stringMatcherContext(ruleAttr) {
+    var regex = new RegExp(ruleAttr);
     return function stringMatcher(runtimeAttr) {
-        var re;
-        try {
-            re = new RegExp(ruleAttr);
-        }
-        catch (e) {
-            log.debug(ENGINE_MATCHER_STRING_INVALID, [ruleAttr]);
-            return false;
-        }
-        var regexMatches = re.test(runtimeAttr);
-        log.debug(ENGINE_MATCHER_STRING, [runtimeAttr, ruleAttr, regexMatches ? 'yes' : 'no']);
+        var regexMatches = regex.test(runtimeAttr);
         return regexMatches;
     };
 }

package/esm/evaluator/matchers/sw.js

@@ -1,9 +1,7 @@
-import { ENGINE_MATCHER_STARTS_WITH } from '../../logger/constants';
 import { startsWith } from '../../utils/lang';
-export function startsWithMatcherContext(log, ruleAttr) {
+export function startsWithMatcherContext(ruleAttr) {
     return function startsWithMatcher(runtimeAttr) {
         var matches = ruleAttr.some(function (e) { return startsWith(runtimeAttr, e); });
-        log.debug(ENGINE_MATCHER_STARTS_WITH, [runtimeAttr, ruleAttr, matches]);
         return matches;
     };
 }

package/esm/evaluator/matchers/whitelist.js

@@ -1,9 +1,8 @@
-import { setToArray } from '../../utils/lang/sets';
-import { ENGINE_MATCHER_WHITELIST } from '../../logger/constants';
-export function whitelistMatcherContext(log, ruleAttr) {
+import { _Set } from '../../utils/lang/sets';
+export function whitelistMatcherContext(ruleAttr) {
+    var whitelistSet = new _Set(ruleAttr);
     return function whitelistMatcher(runtimeAttr) {
-        var isInWhitelist = ruleAttr.has(runtimeAttr);
-        log.debug(ENGINE_MATCHER_WHITELIST, [runtimeAttr, setToArray(ruleAttr).join(','), isInWhitelist]);
+        var isInWhitelist = whitelistSet.has(runtimeAttr);
         return isInWhitelist;
     };
 }

package/esm/evaluator/matchersTransform/index.js

@@ -2,7 +2,6 @@ import { findIndex } from '../../utils/lang';
 import { matcherTypes, matcherTypesMapper, matcherDataTypes } from '../matchers/matcherTypes';
 import { segmentTransform } from './segment';
 import { whitelistTransform } from './whitelist';
-import { setTransform } from './set';
 import { numericTransform } from './unaryNumeric';
 import { zeroSinceHH, zeroSinceSS } from '../convertions';
 /**
@@ -10,37 +9,34 @@ import { zeroSinceHH, zeroSinceSS } from '../convertions';
  */
 export function matchersTransform(matchers) {
     var parsedMatchers = matchers.map(function (matcher) {
-        var matcherType = matcher.matcherType /* string */, negate = matcher.negate /* boolean */, keySelector = matcher.keySelector /* keySelectorObject */, segmentObject = matcher.userDefinedSegmentMatcherData /* segmentObject */, whitelistObject = matcher.whitelistMatcherData /* whiteListObject, provided by 'WHITELIST', set and string matchers */, unaryNumericObject = matcher.unaryNumericMatcherData /* unaryNumericObject */, betweenObject = matcher.betweenMatcherData /* betweenObject */, dependencyObject = matcher.dependencyMatcherData /* dependencyObject */, booleanMatcherData = matcher.booleanMatcherData, stringMatcherData = matcher.stringMatcherData;
+        var matcherType = matcher.matcherType, negate = matcher.negate, keySelector = matcher.keySelector, userDefinedSegmentMatcherData = matcher.userDefinedSegmentMatcherData, whitelistMatcherData = matcher.whitelistMatcherData, /* whitelistObject, provided by 'WHITELIST', 'IN_LIST_SEMVER', set and string matchers */ unaryNumericMatcherData = matcher.unaryNumericMatcherData, betweenMatcherData = matcher.betweenMatcherData, dependencyMatcherData = matcher.dependencyMatcherData, booleanMatcherData = matcher.booleanMatcherData, stringMatcherData = matcher.stringMatcherData, betweenStringMatcherData = matcher.betweenStringMatcherData;
         var attribute = keySelector && keySelector.attribute;
         var type = matcherTypesMapper(matcherType);
         // As default input data type we use string (even for ALL_KEYS)
         var dataType = matcherDataTypes.STRING;
         var value = undefined;
         if (type === matcherTypes.IN_SEGMENT) {
-            value = segmentTransform(segmentObject);
-        }
-        else if (type === matcherTypes.WHITELIST) {
-            value = whitelistTransform(whitelistObject);
+            value = segmentTransform(userDefinedSegmentMatcherData);
         }
         else if (type === matcherTypes.EQUAL_TO) {
-            value = numericTransform(unaryNumericObject);
+            value = numericTransform(unaryNumericMatcherData);
             dataType = matcherDataTypes.NUMBER;
-            if (unaryNumericObject.dataType === 'DATETIME') {
+            if (unaryNumericMatcherData.dataType === 'DATETIME') {
                 value = zeroSinceHH(value);
                 dataType = matcherDataTypes.DATETIME;
             }
         }
         else if (type === matcherTypes.GREATER_THAN_OR_EQUAL_TO ||
             type === matcherTypes.LESS_THAN_OR_EQUAL_TO) {
-            value = numericTransform(unaryNumericObject);
+            value = numericTransform(unaryNumericMatcherData);
             dataType = matcherDataTypes.NUMBER;
-            if (unaryNumericObject.dataType === 'DATETIME') {
+            if (unaryNumericMatcherData.dataType === 'DATETIME') {
                 value = zeroSinceSS(value);
                 dataType = matcherDataTypes.DATETIME;
             }
         }
         else if (type === matcherTypes.BETWEEN) {
-            value = betweenObject;
+            value = betweenMatcherData;
             dataType = matcherDataTypes.NUMBER;
             if (value.dataType === 'DATETIME') {
                 value.start = zeroSinceSS(value.start);
@@ -48,33 +44,42 @@ export function matchersTransform(matchers) {
                 dataType = matcherDataTypes.DATETIME;
             }
         }
+        else if (type === matcherTypes.BETWEEN_SEMVER) {
+            value = betweenStringMatcherData;
+        }
         else if (type === matcherTypes.EQUAL_TO_SET ||
             type === matcherTypes.CONTAINS_ANY_OF_SET ||
             type === matcherTypes.CONTAINS_ALL_OF_SET ||
             type === matcherTypes.PART_OF_SET) {
-            value = setTransform(whitelistObject);
+            value = whitelistTransform(whitelistMatcherData);
             dataType = matcherDataTypes.SET;
         }
-        else if (type === matcherTypes.STARTS_WITH ||
+        else if (type === matcherTypes.WHITELIST ||
+            type === matcherTypes.IN_LIST_SEMVER ||
+            type === matcherTypes.STARTS_WITH ||
             type === matcherTypes.ENDS_WITH ||
             type === matcherTypes.CONTAINS_STRING) {
-            value = setTransform(whitelistObject);
+            value = whitelistTransform(whitelistMatcherData);
         }
         else if (type === matcherTypes.IN_SPLIT_TREATMENT) {
-            value = dependencyObject;
+            value = dependencyMatcherData;
             dataType = matcherDataTypes.NOT_SPECIFIED;
         }
         else if (type === matcherTypes.EQUAL_TO_BOOLEAN) {
             dataType = matcherDataTypes.BOOLEAN;
             value = booleanMatcherData;
         }
-        else if (type === matcherTypes.MATCHES_STRING) {
+        else if (type === matcherTypes.MATCHES_STRING ||
+            type === matcherTypes.EQUAL_TO_SEMVER ||
+            type === matcherTypes.GREATER_THAN_OR_EQUAL_TO_SEMVER ||
+            type === matcherTypes.LESS_THAN_OR_EQUAL_TO_SEMVER) {
             value = stringMatcherData;
         }
         return {
             attribute: attribute,
             negate: negate,
             type: type,
+            name: matcherType,
             value: value,
             dataType: dataType // runtime input data type
         };

package/esm/evaluator/matchersTransform/whitelist.js

@@ -1,7 +1,6 @@
-import { _Set } from '../../utils/lang/sets';
 /**
- * Extract whitelist as a set. Used by 'WHITELIST' matcher.
+ * Extract whitelist array.
  */
 export function whitelistTransform(whitelistObject) {
-    return new _Set(whitelistObject.whitelist);
+    return whitelistObject && whitelistObject.whitelist;
 }

package/esm/evaluator/parser/index.js

@@ -6,6 +6,7 @@ import { conditionContext } from '../condition';
 import { ifElseIfCombinerContext } from '../combiners/ifelseif';
 import { andCombinerContext } from '../combiners/and';
 import { thenable } from '../../utils/promise/thenable';
+import { ENGINE_MATCHER_ERROR, ENGINE_MATCHER_RESULT } from '../../logger/constants';
 export function parser(log, conditions, storage) {
     var predicates = [];
     for (var i = 0; i < conditions.length; i++) {
@@ -14,17 +15,32 @@ export function parser(log, conditions, storage) {
         var matchers = matchersTransform(matcherGroup.matchers);
         // create a set of pure functions from the matcher's dto
         var expressions = matchers.map(function (matcherDto) {
-            var matcher = matcherFactory(log, matcherDto, storage);
+            var matcher;
+            try {
+                matcher = matcherFactory(log, matcherDto, storage);
+            }
+            catch (error) {
+                log.error(ENGINE_MATCHER_ERROR, [matcherDto.name, error]);
+            }
             // Evaluator function.
             return function (key, attributes, splitEvaluator) {
                 var value = sanitizeValue(log, key, matcherDto, attributes);
-                var result = value !== undefined && matcher ? matcher(value, splitEvaluator) : false;
-                if (thenable(result)) {
-                    // @ts-ignore
-                    return result.then(function (res) { return Boolean(res ^ matcherDto.negate); });
+                var result = false;
+                if (value !== undefined && matcher) {
+                    try {
+                        result = matcher(value, splitEvaluator);
+                    }
+                    catch (error) {
+                        log.error(ENGINE_MATCHER_ERROR, [matcherDto.name, error]);
+                    }
                 }
-                // @ts-ignore
-                return Boolean(result ^ matcherDto.negate);
+                function handleResult(result) {
+                    log.debug(ENGINE_MATCHER_RESULT, [matcherDto.name, result, matcherDto.value, value]); // @ts-ignore
+                    return Boolean(result ^ matcherDto.negate);
+                }
+                return thenable(result) ?
+                    result.then(handleResult) :
+                    handleResult(result);
             };
         });
         // if matcher's factory can't instantiate the matchers, the expressions array will be empty

package/esm/logger/constants.js

@@ -9,25 +9,8 @@ export var ENGINE_COMBINER_AND = 0;
 export var ENGINE_COMBINER_IFELSEIF = 1;
 export var ENGINE_COMBINER_IFELSEIF_NO_TREATMENT = 2;
 export var ENGINE_BUCKET = 3;
-export var ENGINE_MATCHER_ALL = 4;
-export var ENGINE_MATCHER_BETWEEN = 5;
-export var ENGINE_MATCHER_BOOLEAN = 6;
-export var ENGINE_MATCHER_CONTAINS_ALL = 7;
-export var ENGINE_MATCHER_CONTAINS_ANY = 8;
-export var ENGINE_MATCHER_CONTAINS_STRING = 9;
 export var ENGINE_MATCHER_DEPENDENCY = 10;
 export var ENGINE_MATCHER_DEPENDENCY_PRE = 11;
-export var ENGINE_MATCHER_EQUAL = 12;
-export var ENGINE_MATCHER_EQUAL_TO_SET = 13;
-export var ENGINE_MATCHER_ENDS_WITH = 14;
-export var ENGINE_MATCHER_GREATER = 15;
-export var ENGINE_MATCHER_LESS = 16;
-export var ENGINE_MATCHER_PART_OF = 17;
-export var ENGINE_MATCHER_SEGMENT = 18;
-export var ENGINE_MATCHER_STRING = 19;
-export var ENGINE_MATCHER_STRING_INVALID = 20;
-export var ENGINE_MATCHER_STARTS_WITH = 21;
-export var ENGINE_MATCHER_WHITELIST = 22;
 export var ENGINE_VALUE = 23;
 export var ENGINE_SANITIZE = 24;
 export var CLEANUP_REGISTERING = 25;
@@ -45,6 +28,7 @@ export var SYNC_TASK_START = 36;
 export var SYNC_TASK_EXECUTE = 37;
 export var SYNC_TASK_STOP = 38;
 export var SETTINGS_SPLITS_FILTER = 39;
+export var ENGINE_MATCHER_RESULT = 40;
 export var CLIENT_READY_FROM_CACHE = 100;
 export var CLIENT_READY = 101;
 export var IMPRESSION = 102;
@@ -128,6 +112,7 @@ export var ERROR_NOT_BOOLEAN = 325;
 export var ERROR_MIN_CONFIG_PARAM = 326;
 export var ERROR_TOO_MANY_SETS = 327;
 export var ERROR_SETS_FILTER_EXCLUSIVE = 328;
+export var ENGINE_MATCHER_ERROR = 329;
 // Log prefixes (a.k.a. tags or categories)
 export var LOG_PREFIX_SETTINGS = 'settings';
 export var LOG_PREFIX_INSTANTIATION = 'Factory instantiation';

package/esm/logger/index.js

@@ -1,5 +1,5 @@
 import { objectAssign } from '../utils/lang/objectAssign';
-import { find } from '../utils/lang';
+import { find, isObject } from '../utils/lang';
 import { _Map } from '../utils/lang/maps';
 export var LogLevels = {
     DEBUG: 'DEBUG',
@@ -24,7 +24,14 @@ export function _sprintf(format, args) {
     if (args === void 0) { args = []; }
     var i = 0;
     return format.replace(/%s/g, function () {
-        return args[i++];
+        var arg = args[i++];
+        if (isObject(arg) || Array.isArray(arg)) {
+            try {
+                arg = JSON.stringify(arg);
+            }
+            catch (e) { /* empty */ }
+        }
+        return arg;
     });
 }
 var defaultOptions = {

package/esm/logger/messages/debug.js

@@ -6,27 +6,11 @@ export var codesDebug = codesInfo.concat([
     [c.ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Treatment found: %s'],
     [c.ENGINE_COMBINER_IFELSEIF_NO_TREATMENT, c.LOG_PREFIX_ENGINE_COMBINER + 'All predicates evaluated, no treatment found.'],
     [c.ENGINE_BUCKET, c.LOG_PREFIX_ENGINE + ': using algo "murmur" bucket %s for key %s using seed %s - treatment %s'],
-    [c.ENGINE_MATCHER_ALL, c.LOG_PREFIX_ENGINE_MATCHER + '[allMatcher] is always true'],
-    [c.ENGINE_MATCHER_BETWEEN, c.LOG_PREFIX_ENGINE_MATCHER + '[betweenMatcher] is %s between %s and %s? %s'],
-    [c.ENGINE_MATCHER_BOOLEAN, c.LOG_PREFIX_ENGINE_MATCHER + '[booleanMatcher] %s === %s'],
-    [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 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'],
-    [c.ENGINE_MATCHER_GREATER, c.LOG_PREFIX_ENGINE_MATCHER + '[greaterThanEqualMatcher] is %s greater than %s? %s'],
-    [c.ENGINE_MATCHER_LESS, c.LOG_PREFIX_ENGINE_MATCHER + '[lessThanEqualMatcher] is %s less than %s? %s'],
-    [c.ENGINE_MATCHER_PART_OF, c.LOG_PREFIX_ENGINE_MATCHER + '[partOfMatcher] %s is part of %s? %s'],
-    [c.ENGINE_MATCHER_SEGMENT, c.LOG_PREFIX_ENGINE_MATCHER + '[segmentMatcher] evaluated %s / %s => %s'],
-    [c.ENGINE_MATCHER_STRING, c.LOG_PREFIX_ENGINE_MATCHER + '[stringMatcher] does %s matches with %s? %s'],
-    [c.ENGINE_MATCHER_STRING_INVALID, c.LOG_PREFIX_ENGINE_MATCHER + '[stringMatcher] %s is an invalid regex'],
-    [c.ENGINE_MATCHER_STARTS_WITH, c.LOG_PREFIX_ENGINE_MATCHER + '[startsWithMatcher] %s starts with %s? %s'],
-    [c.ENGINE_MATCHER_WHITELIST, c.LOG_PREFIX_ENGINE_MATCHER + '[whitelistMatcher] evaluated %s in [%s] => %s'],
-    [c.ENGINE_VALUE, c.LOG_PREFIX_ENGINE_VALUE + 'Extracted attribute [%s], [%s] will be used for matching.'],
-    [c.ENGINE_SANITIZE, c.LOG_PREFIX_ENGINE + ':sanitize: Attempted to sanitize [%s] which should be of type [%s]. Sanitized and processed value => [%s]'],
+    [c.ENGINE_MATCHER_DEPENDENCY, c.LOG_PREFIX_ENGINE_MATCHER + '[IN_SPLIT_TREATMENT] 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 + '[IN_SPLIT_TREATMENT] will evaluate parent feature flag: "%s" with key: %s %s'],
+    [c.ENGINE_VALUE, c.LOG_PREFIX_ENGINE_VALUE + 'Extracted attribute `%s`. %s will be used for matching.'],
+    [c.ENGINE_SANITIZE, c.LOG_PREFIX_ENGINE + ':sanitize: Attempted to sanitize %s which should be of type %s. Sanitized and processed value => %s'],
+    [c.ENGINE_MATCHER_RESULT, c.LOG_PREFIX_ENGINE_MATCHER + '[%s] Result: %s. Rule value: %s. Evaluation value: %s'],
     // SDK
     [c.CLEANUP_REGISTERING, c.LOG_PREFIX_CLEANUP + 'Registering cleanup handler %s'],
     [c.CLEANUP_DEREGISTERING, c.LOG_PREFIX_CLEANUP + 'Deregistering cleanup handler %s'],

package/esm/logger/messages/error.js

@@ -1,7 +1,8 @@
 import * as c from '../constants';
 export var codesError = [
     // evaluator
-    [c.ERROR_ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Invalid feature flag, no valid rules or unsupported matcher type found'],
+    [c.ERROR_ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Invalid feature flag, no valid rules or unsupported targeting rule type found'],
+    [c.ENGINE_MATCHER_ERROR, c.LOG_PREFIX_ENGINE_MATCHER + '[%s] %s'],
     // 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'],

package/esm/logger/messages/warn.js

@@ -3,7 +3,7 @@ import { codesError } from './error';
 export var codesWarn = codesError.concat([
     // evaluator
     [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.'],
+    [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 feature flags. %s'],

package/esm/services/splitApi.js

@@ -29,16 +29,16 @@ export function splitApiFactory(settings, platform, telemetryTracker) {
             return splitHttpClient(url).then(function () { return true; }).catch(function () { return false; });
         },
         fetchAuth: function (userMatchingKeys) {
-            var url = urls.auth + "/v2/auth";
-            if (userMatchingKeys) { // accounting the possibility that `userMatchingKeys` is undefined (server-side API)
+            var url = urls.auth + "/v2/auth?s=" + FLAGS_SPEC;
+            if (userMatchingKeys) { // `userMatchingKeys` is undefined in server-side
                 var queryParams = userMatchingKeys.map(userKeyToQueryParam).join('&');
-                if (queryParams) // accounting the possibility that `userKeys` and thus `queryParams` are empty
-                    url += '?' + queryParams;
+                if (queryParams)
+                    url += '&' + queryParams;
             }
             return splitHttpClient(url, undefined, telemetryTracker.trackHttp(TOKEN));
         },
         fetchSplitChanges: function (since, noCache, till) {
-            var url = urls.sdk + "/splitChanges?s=" + FLAGS_SPEC + "&since=" + since + (till ? '&till=' + till : '') + (filterQueryString || '');
+            var url = urls.sdk + "/splitChanges?s=" + FLAGS_SPEC + "&since=" + since + (filterQueryString || '') + (till ? '&till=' + till : '');
             return splitHttpClient(url, noCache ? noCacheHeaderOptions : undefined, telemetryTracker.trackHttp(SPLITS))
                 .catch(function (err) {
                 if (err.statusCode === 414)

package/esm/storages/inLocalStorage/SplitsCacheInLocal.js

@@ -123,7 +123,7 @@ var SplitsCacheInLocal = /** @class */ (function (_super) {
     SplitsCacheInLocal.prototype.setChangeNumber = function (changeNumber) {
         // when using a new split query, we must update it at the store
         if (this.updateNewFilter) {
-            this.log.info(LOG_PREFIX + 'SDK key or feature flag filter criteria was modified. Updating cache');
+            this.log.info(LOG_PREFIX + 'SDK key, flags filter criteria or flags spec version was modified. Updating cache');
             var storageHashKey = this.keys.buildHashKey();
             try {
                 localStorage.setItem(storageHashKey, this.storageHash);

package/esm/storages/pluggable/index.js

@@ -79,7 +79,7 @@ export function PluggableStorage(options) {
                 return wrapper.get(keys.buildHashKey()).then(function (hash) {
                     var currentHash = getStorageHash(settings);
                     if (hash !== currentHash) {
-                        log.info(LOG_PREFIX + 'Storage HASH has changed (SDK key or feature flag filter criteria was modified). Clearing cache');
+                        log.info(LOG_PREFIX + 'Storage HASH has changed (SDK key, flags filter criteria or flags spec version was modified). Clearing cache');
                         return wrapper.getKeysByPrefix(keys.prefix + ".").then(function (storageKeys) {
                             return Promise.all(storageKeys.map(function (storageKey) { return wrapper.del(storageKey); }));
                         }).then(function () { return wrapper.set(keys.buildHashKey(), currentHash); });