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

package/CHANGES.txt

@@ -1,6 +1,7 @@
-1.14.0 (April XX, 2024)
- - Updated impression label to 'unsupported matcher type' when the matcher type is not supported by the SDK.
- - Updated Split API client to include the flags spec version query parameter for the `splitChanges` endpoint.
+1.14.0 (May 3, 2024)
+ - Added support for targeting rules based on semantic versions (https://semver.org/).
+ - Added special impression label "targeting rule type unsupported by sdk" when the matcher type is not supported by the SDK, which returns 'control' treatment.
+ - Updated Split API client to include the flags spec version query parameter for the `splitChanges` and `auth` endpoints.
 
 1.13.1 (January 10, 2024)
  - Updated client `destroy` method to release SDK key immediately and avoid unexpected warning logs when a factory is created with the same SDK key after the previous one was destroyed.

package/cjs/evaluator/Engine.js

@@ -1,17 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Engine = void 0;
-var tslib_1 = require("tslib");
 var lang_1 = require("../utils/lang");
 var parser_1 = require("./parser");
 var key_1 = require("../utils/key");
 var thenable_1 = require("../utils/promise/thenable");
-var LabelsConstants = (0, tslib_1.__importStar)(require("../utils/labels"));
+var labels_1 = require("../utils/labels");
 var constants_1 = require("../utils/constants");
 function evaluationResult(result, defaultTreatment) {
     return {
         treatment: (0, lang_1.get)(result, 'treatment', defaultTreatment),
-        label: (0, lang_1.get)(result, 'label', LabelsConstants.NO_CONDITION_MATCH)
+        label: (0, lang_1.get)(result, 'label', labels_1.NO_CONDITION_MATCH)
     };
 }
 var Engine = /** @class */ (function () {
@@ -42,16 +41,16 @@ var Engine = /** @class */ (function () {
         catch (err) {
             return {
                 treatment: constants_1.CONTROL,
-                label: LabelsConstants.EXCEPTION
+                label: labels_1.EXCEPTION
             };
         }
         if (this.isGarbage()) {
             treatment = constants_1.CONTROL;
-            label = LabelsConstants.SPLIT_ARCHIVED;
+            label = labels_1.SPLIT_ARCHIVED;
         }
         else if (killed) {
             treatment = defaultTreatment;
-            label = LabelsConstants.SPLIT_KILLED;
+            label = labels_1.SPLIT_KILLED;
         }
         else {
             var evaluation = this.evaluator(parsedKey, seed, trafficAllocation, trafficAllocationSeed, attributes, splitEvaluator);

package/cjs/evaluator/combiners/ifelseif.js

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ifElseIfCombinerContext = void 0;
-var tslib_1 = require("tslib");
 var lang_1 = require("../../utils/lang");
 var thenable_1 = require("../../utils/promise/thenable");
-var LabelsConstants = (0, tslib_1.__importStar)(require("../../utils/labels"));
+var labels_1 = require("../../utils/labels");
 var constants_1 = require("../../utils/constants");
 var constants_2 = require("../../logger/constants");
 function ifElseIfCombinerContext(log, predicates) {
@@ -12,7 +11,7 @@ function ifElseIfCombinerContext(log, predicates) {
         log.error(constants_2.ERROR_ENGINE_COMBINER_IFELSEIF);
         return {
             treatment: constants_1.CONTROL,
-            label: LabelsConstants.UNSUPPORTED_MATCHER_TYPE
+            label: labels_1.UNSUPPORTED_MATCHER_TYPE
         };
     }
     function computeTreatment(predicateResults) {

package/cjs/evaluator/condition/index.js

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.conditionContext = void 0;
-var tslib_1 = require("tslib");
 var engineUtils_1 = require("./engineUtils");
 var thenable_1 = require("../../utils/promise/thenable");
-var LabelsConstants = (0, tslib_1.__importStar)(require("../../utils/labels"));
+var labels_1 = require("../../utils/labels");
 // Build Evaluation object if and only if matchingResult is true
 function match(log, matchingResult, bucketingKey, seed, treatments, label) {
     if (matchingResult) {
@@ -24,7 +23,7 @@ function conditionContext(log, matcherEvaluator, treatments, label, conditionTyp
         if (conditionType === 'ROLLOUT' && !(0, engineUtils_1.shouldApplyRollout)(trafficAllocation, key.bucketingKey, trafficAllocationSeed)) {
             return {
                 treatment: undefined,
-                label: LabelsConstants.NOT_IN_SPLIT
+                label: labels_1.NOT_IN_SPLIT
             };
         }
         // matcherEvaluator could be Async, this relays on matchers return value, so we need

package/cjs/evaluator/index.js

@@ -1,16 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.evaluateFeaturesByFlagSets = exports.evaluateFeatures = exports.evaluateFeature = void 0;
-var tslib_1 = require("tslib");
 var Engine_1 = require("./Engine");
 var thenable_1 = require("../utils/promise/thenable");
-var LabelsConstants = (0, tslib_1.__importStar)(require("../utils/labels"));
+var labels_1 = require("../utils/labels");
 var constants_1 = require("../utils/constants");
 var sets_1 = require("../utils/lang/sets");
 var constants_2 = require("../logger/constants");
 var treatmentException = {
     treatment: constants_1.CONTROL,
-    label: LabelsConstants.EXCEPTION,
+    label: labels_1.EXCEPTION,
     config: null
 };
 function treatmentsException(splitNames) {
@@ -94,13 +93,13 @@ exports.evaluateFeaturesByFlagSets = evaluateFeaturesByFlagSets;
 function getEvaluation(log, splitJSON, key, attributes, storage) {
     var evaluation = {
         treatment: constants_1.CONTROL,
-        label: LabelsConstants.SPLIT_NOT_FOUND,
+        label: labels_1.SPLIT_NOT_FOUND,
         config: null
     };
     if (splitJSON) {
         var split_1 = Engine_1.Engine.parse(log, splitJSON, storage);
         evaluation = split_1.getTreatment(key, attributes, evaluateFeature);
-        // If the storage is async and the evaluated split uses segment, evaluation is thenable
+        // If the storage is async and the evaluated flag uses segments or dependencies, evaluation is thenable
         if ((0, thenable_1.thenable)(evaluation)) {
             return evaluation.then(function (result) {
                 result.changeNumber = split_1.getChangeNumber();

package/cjs/evaluator/matchers/gte.js

@@ -4,9 +4,9 @@ exports.greaterThanEqualMatcherContext = void 0;
 var constants_1 = require("../../logger/constants");
 function greaterThanEqualMatcherContext(log, ruleAttr) {
     return function greaterThanEqualMatcher(runtimeAttr) {
-        var isGreaterEqualThan = runtimeAttr >= ruleAttr;
-        log.debug(constants_1.ENGINE_MATCHER_GREATER, [runtimeAttr, ruleAttr, isGreaterEqualThan]);
-        return isGreaterEqualThan;
+        var isGreaterThanEqual = runtimeAttr >= ruleAttr;
+        log.debug(constants_1.ENGINE_MATCHER_GREATER, [runtimeAttr, ruleAttr, isGreaterThanEqual]);
+        return isGreaterThanEqual;
     };
 }
 exports.greaterThanEqualMatcherContext = greaterThanEqualMatcherContext;

package/cjs/evaluator/matchers/index.js

@@ -18,6 +18,11 @@ var cont_str_1 = require("./cont_str");
 var dependency_1 = require("./dependency");
 var boolean_1 = require("./boolean");
 var string_1 = require("./string");
+var semver_eq_1 = require("./semver_eq");
+var semver_gte_1 = require("./semver_gte");
+var semver_lte_1 = require("./semver_lte");
+var semver_between_1 = require("./semver_between");
+var semver_inlist_1 = require("./semver_inlist");
 var matchers = [
     undefined,
     all_1.allMatcherContext,
@@ -36,7 +41,12 @@ var matchers = [
     cont_str_1.containsStringMatcherContext,
     dependency_1.dependencyMatcherContext,
     boolean_1.booleanMatcherContext,
-    string_1.stringMatcherContext // MATCHES_STRING: 17
+    string_1.stringMatcherContext,
+    semver_eq_1.equalToSemverMatcherContext,
+    semver_gte_1.greaterThanEqualToSemverMatcherContext,
+    semver_lte_1.lessThanEqualToSemverMatcherContext,
+    semver_between_1.betweenSemverMatcherContext,
+    semver_inlist_1.inListSemverMatcherContext, // IN_LIST_SEMVER: 22
 ];
 /**
  * Matcher factory.

package/cjs/evaluator/matchers/lte.js

@@ -4,9 +4,9 @@ exports.lessThanEqualMatcherContext = void 0;
 var constants_1 = require("../../logger/constants");
 function lessThanEqualMatcherContext(log, ruleAttr) {
     return function lessThanEqualMatcher(runtimeAttr) {
-        var isLessEqualThan = runtimeAttr <= ruleAttr;
-        log.debug(constants_1.ENGINE_MATCHER_LESS, [runtimeAttr, ruleAttr, isLessEqualThan]);
-        return isLessEqualThan;
+        var isLessThanEqual = runtimeAttr <= ruleAttr;
+        log.debug(constants_1.ENGINE_MATCHER_LESS, [runtimeAttr, ruleAttr, isLessThanEqual]);
+        return isLessThanEqual;
     };
 }
 exports.lessThanEqualMatcherContext = lessThanEqualMatcherContext;

package/cjs/evaluator/matchers/matcherTypes.js

@@ -19,7 +19,12 @@ exports.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,
 };
 exports.matcherDataTypes = {
     BOOLEAN: 'BOOLEAN',

package/cjs/evaluator/matchers/semver_between.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.betweenSemverMatcherContext = void 0;
+var Semver_1 = require("../../utils/Semver");
+function betweenSemverMatcherContext(log, ruleAttr) {
+    var startSemver = new Semver_1.Semver(ruleAttr.start);
+    var endSemver = new Semver_1.Semver(ruleAttr.end);
+    return function betweenSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver_1.Semver(runtimeAttr);
+        var isBetween = startSemver.compare(runtimeSemver) <= 0 && endSemver.compare(runtimeSemver) >= 0;
+        return isBetween;
+    };
+}
+exports.betweenSemverMatcherContext = betweenSemverMatcherContext;

package/cjs/evaluator/matchers/semver_eq.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.equalToSemverMatcherContext = void 0;
+var Semver_1 = require("../../utils/Semver");
+function equalToSemverMatcherContext(log, ruleAttr) {
+    var ruleSemver = new Semver_1.Semver(ruleAttr);
+    return function equalToSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver_1.Semver(runtimeAttr);
+        var isEqual = ruleSemver.version === runtimeSemver.version;
+        return isEqual;
+    };
+}
+exports.equalToSemverMatcherContext = equalToSemverMatcherContext;

package/cjs/evaluator/matchers/semver_gte.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.greaterThanEqualToSemverMatcherContext = void 0;
+var Semver_1 = require("../../utils/Semver");
+function greaterThanEqualToSemverMatcherContext(log, ruleAttr) {
+    var ruleSemver = new Semver_1.Semver(ruleAttr);
+    return function greaterThanEqualToSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver_1.Semver(runtimeAttr);
+        var isGreaterThanEqual = runtimeSemver.compare(ruleSemver) >= 0;
+        return isGreaterThanEqual;
+    };
+}
+exports.greaterThanEqualToSemverMatcherContext = greaterThanEqualToSemverMatcherContext;

package/cjs/evaluator/matchers/semver_inlist.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inListSemverMatcherContext = void 0;
+var sets_1 = require("../../utils/lang/sets");
+var Semver_1 = require("../../utils/Semver");
+function inListSemverMatcherContext(log, 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 sets_1._Set(ruleAttr.map(function (version) { return new Semver_1.Semver(version).version; }));
+    return function inListSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver_1.Semver(runtimeAttr).version;
+        var isInList = listOfSemvers.has(runtimeSemver);
+        return isInList;
+    };
+}
+exports.inListSemverMatcherContext = inListSemverMatcherContext;

package/cjs/evaluator/matchers/semver_lte.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lessThanEqualToSemverMatcherContext = void 0;
+var Semver_1 = require("../../utils/Semver");
+function lessThanEqualToSemverMatcherContext(log, ruleAttr) {
+    var ruleSemver = new Semver_1.Semver(ruleAttr);
+    return function lessThanEqualToSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver_1.Semver(runtimeAttr);
+        var isLessThanEqual = runtimeSemver.compare(ruleSemver) <= 0;
+        return isLessThanEqual;
+    };
+}
+exports.lessThanEqualToSemverMatcherContext = lessThanEqualToSemverMatcherContext;

package/cjs/evaluator/matchers/string.js

@@ -3,16 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.stringMatcherContext = void 0;
 var constants_1 = require("../../logger/constants");
 function stringMatcherContext(log, ruleAttr) {
+    var regex = new RegExp(ruleAttr);
     return function stringMatcher(runtimeAttr) {
-        var re;
-        try {
-            re = new RegExp(ruleAttr);
-        }
-        catch (e) {
-            log.debug(constants_1.ENGINE_MATCHER_STRING_INVALID, [ruleAttr]);
-            return false;
-        }
-        var regexMatches = re.test(runtimeAttr);
+        var regexMatches = regex.test(runtimeAttr);
         log.debug(constants_1.ENGINE_MATCHER_STRING, [runtimeAttr, ruleAttr, regexMatches ? 'yes' : 'no']);
         return regexMatches;
     };

package/cjs/evaluator/matchers/whitelist.js

@@ -4,9 +4,10 @@ exports.whitelistMatcherContext = void 0;
 var sets_1 = require("../../utils/lang/sets");
 var constants_1 = require("../../logger/constants");
 function whitelistMatcherContext(log, ruleAttr) {
+    var whitelistSet = new sets_1._Set(ruleAttr);
     return function whitelistMatcher(runtimeAttr) {
-        var isInWhitelist = ruleAttr.has(runtimeAttr);
-        log.debug(constants_1.ENGINE_MATCHER_WHITELIST, [runtimeAttr, (0, sets_1.setToArray)(ruleAttr).join(','), isInWhitelist]);
+        var isInWhitelist = whitelistSet.has(runtimeAttr);
+        log.debug(constants_1.ENGINE_MATCHER_WHITELIST, [runtimeAttr, ruleAttr.join(','), isInWhitelist]);
         return isInWhitelist;
     };
 }

package/cjs/evaluator/matchersTransform/index.js

@@ -5,7 +5,6 @@ var lang_1 = require("../../utils/lang");
 var matcherTypes_1 = require("../matchers/matcherTypes");
 var segment_1 = require("./segment");
 var whitelist_1 = require("./whitelist");
-var set_1 = require("./set");
 var unaryNumeric_1 = require("./unaryNumeric");
 var convertions_1 = require("../convertions");
 /**
@@ -13,37 +12,34 @@ var convertions_1 = require("../convertions");
  */
 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 = (0, matcherTypes_1.matcherTypesMapper)(matcherType);
         // As default input data type we use string (even for ALL_KEYS)
         var dataType = matcherTypes_1.matcherDataTypes.STRING;
         var value = undefined;
         if (type === matcherTypes_1.matcherTypes.IN_SEGMENT) {
-            value = (0, segment_1.segmentTransform)(segmentObject);
-        }
-        else if (type === matcherTypes_1.matcherTypes.WHITELIST) {
-            value = (0, whitelist_1.whitelistTransform)(whitelistObject);
+            value = (0, segment_1.segmentTransform)(userDefinedSegmentMatcherData);
         }
         else if (type === matcherTypes_1.matcherTypes.EQUAL_TO) {
-            value = (0, unaryNumeric_1.numericTransform)(unaryNumericObject);
+            value = (0, unaryNumeric_1.numericTransform)(unaryNumericMatcherData);
             dataType = matcherTypes_1.matcherDataTypes.NUMBER;
-            if (unaryNumericObject.dataType === 'DATETIME') {
+            if (unaryNumericMatcherData.dataType === 'DATETIME') {
                 value = (0, convertions_1.zeroSinceHH)(value);
                 dataType = matcherTypes_1.matcherDataTypes.DATETIME;
             }
         }
         else if (type === matcherTypes_1.matcherTypes.GREATER_THAN_OR_EQUAL_TO ||
             type === matcherTypes_1.matcherTypes.LESS_THAN_OR_EQUAL_TO) {
-            value = (0, unaryNumeric_1.numericTransform)(unaryNumericObject);
+            value = (0, unaryNumeric_1.numericTransform)(unaryNumericMatcherData);
             dataType = matcherTypes_1.matcherDataTypes.NUMBER;
-            if (unaryNumericObject.dataType === 'DATETIME') {
+            if (unaryNumericMatcherData.dataType === 'DATETIME') {
                 value = (0, convertions_1.zeroSinceSS)(value);
                 dataType = matcherTypes_1.matcherDataTypes.DATETIME;
             }
         }
         else if (type === matcherTypes_1.matcherTypes.BETWEEN) {
-            value = betweenObject;
+            value = betweenMatcherData;
             dataType = matcherTypes_1.matcherDataTypes.NUMBER;
             if (value.dataType === 'DATETIME') {
                 value.start = (0, convertions_1.zeroSinceSS)(value.start);
@@ -51,33 +47,42 @@ function matchersTransform(matchers) {
                 dataType = matcherTypes_1.matcherDataTypes.DATETIME;
             }
         }
+        else if (type === matcherTypes_1.matcherTypes.BETWEEN_SEMVER) {
+            value = betweenStringMatcherData;
+        }
         else if (type === matcherTypes_1.matcherTypes.EQUAL_TO_SET ||
             type === matcherTypes_1.matcherTypes.CONTAINS_ANY_OF_SET ||
             type === matcherTypes_1.matcherTypes.CONTAINS_ALL_OF_SET ||
             type === matcherTypes_1.matcherTypes.PART_OF_SET) {
-            value = (0, set_1.setTransform)(whitelistObject);
+            value = (0, whitelist_1.whitelistTransform)(whitelistMatcherData);
             dataType = matcherTypes_1.matcherDataTypes.SET;
         }
-        else if (type === matcherTypes_1.matcherTypes.STARTS_WITH ||
+        else if (type === matcherTypes_1.matcherTypes.WHITELIST ||
+            type === matcherTypes_1.matcherTypes.IN_LIST_SEMVER ||
+            type === matcherTypes_1.matcherTypes.STARTS_WITH ||
             type === matcherTypes_1.matcherTypes.ENDS_WITH ||
             type === matcherTypes_1.matcherTypes.CONTAINS_STRING) {
-            value = (0, set_1.setTransform)(whitelistObject);
+            value = (0, whitelist_1.whitelistTransform)(whitelistMatcherData);
         }
         else if (type === matcherTypes_1.matcherTypes.IN_SPLIT_TREATMENT) {
-            value = dependencyObject;
+            value = dependencyMatcherData;
             dataType = matcherTypes_1.matcherDataTypes.NOT_SPECIFIED;
         }
         else if (type === matcherTypes_1.matcherTypes.EQUAL_TO_BOOLEAN) {
             dataType = matcherTypes_1.matcherDataTypes.BOOLEAN;
             value = booleanMatcherData;
         }
-        else if (type === matcherTypes_1.matcherTypes.MATCHES_STRING) {
+        else if (type === matcherTypes_1.matcherTypes.MATCHES_STRING ||
+            type === matcherTypes_1.matcherTypes.EQUAL_TO_SEMVER ||
+            type === matcherTypes_1.matcherTypes.GREATER_THAN_OR_EQUAL_TO_SEMVER ||
+            type === matcherTypes_1.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/cjs/evaluator/matchersTransform/whitelist.js

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.whitelistTransform = void 0;
-var sets_1 = require("../../utils/lang/sets");
 /**
- * Extract whitelist as a set. Used by 'WHITELIST' matcher.
+ * Extract whitelist array.
  */
 function whitelistTransform(whitelistObject) {
-    return new sets_1._Set(whitelistObject.whitelist);
+    return whitelistObject && whitelistObject.whitelist;
 }
 exports.whitelistTransform = whitelistTransform;

package/cjs/evaluator/parser/index.js

@@ -9,6 +9,7 @@ var condition_1 = require("../condition");
 var ifelseif_1 = require("../combiners/ifelseif");
 var and_1 = require("../combiners/and");
 var thenable_1 = require("../../utils/promise/thenable");
+var constants_1 = require("../../logger/constants");
 function parser(log, conditions, storage) {
     var predicates = [];
     for (var i = 0; i < conditions.length; i++) {
@@ -17,16 +18,28 @@ function parser(log, conditions, storage) {
         var matchers = (0, matchersTransform_1.matchersTransform)(matcherGroup.matchers);
         // create a set of pure functions from the matcher's dto
         var expressions = matchers.map(function (matcherDto) {
-            var matcher = (0, matchers_1.matcherFactory)(log, matcherDto, storage);
+            var matcher;
+            try {
+                matcher = (0, matchers_1.matcherFactory)(log, matcherDto, storage);
+            }
+            catch (error) {
+                log.error(constants_1.ENGINE_MATCHER_ERROR, [matcherDto.name, error]);
+            }
             // Evaluator function.
             return function (key, attributes, splitEvaluator) {
                 var value = (0, value_1.sanitizeValue)(log, key, matcherDto, attributes);
-                var result = value !== undefined && matcher ? matcher(value, splitEvaluator) : false;
-                if ((0, thenable_1.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(constants_1.ENGINE_MATCHER_ERROR, [matcherDto.name, error]);
+                    }
                 }
-                // @ts-ignore
+                if ((0, thenable_1.thenable)(result)) { // @ts-ignore
+                    return result.then(function (res) { return Boolean(res ^ matcherDto.negate); });
+                } // @ts-ignore
                 return Boolean(result ^ matcherDto.negate);
             };
         });

package/cjs/logger/constants.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.SETTINGS_SPLITS_FILTER = exports.SYNC_TASK_STOP = exports.SYNC_TASK_EXECUTE = exports.SYNC_TASK_START = exports.STREAMING_NEW_MESSAGE = exports.SYNC_SPLITS_SEGMENTS = exports.SYNC_SPLITS_REMOVED = exports.SYNC_SPLITS_NEW = 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_WHITELIST = exports.ENGINE_MATCHER_STARTS_WITH = exports.ENGINE_MATCHER_STRING_INVALID = exports.ENGINE_MATCHER_STRING = exports.ENGINE_MATCHER_SEGMENT = exports.ENGINE_MATCHER_PART_OF = exports.ENGINE_MATCHER_LESS = exports.ENGINE_MATCHER_GREATER = exports.ENGINE_MATCHER_ENDS_WITH = exports.ENGINE_MATCHER_EQUAL_TO_SET = exports.ENGINE_MATCHER_EQUAL = exports.ENGINE_MATCHER_DEPENDENCY_PRE = exports.ENGINE_MATCHER_DEPENDENCY = exports.ENGINE_MATCHER_CONTAINS_STRING = exports.ENGINE_MATCHER_CONTAINS_ANY = exports.ENGINE_MATCHER_CONTAINS_ALL = exports.ENGINE_MATCHER_BOOLEAN = exports.ENGINE_MATCHER_BETWEEN = exports.ENGINE_MATCHER_ALL = exports.ENGINE_BUCKET = exports.ENGINE_COMBINER_IFELSEIF_NO_TREATMENT = exports.ENGINE_COMBINER_IFELSEIF = exports.ENGINE_COMBINER_AND = void 0;
-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_MY_SEGMENTS_UPDATE_V2 = 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 = 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 = 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_INSTANTIATION = exports.LOG_PREFIX_SETTINGS = 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_LOCALHOST_MODULE_REQUIRED = exports.ERROR_HTTP = exports.ERROR_INVALID_CONFIG_PARAM = 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 = void 0;
+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.SETTINGS_SPLITS_FILTER = exports.SYNC_TASK_STOP = exports.SYNC_TASK_EXECUTE = exports.SYNC_TASK_START = exports.STREAMING_NEW_MESSAGE = exports.SYNC_SPLITS_SEGMENTS = exports.SYNC_SPLITS_REMOVED = exports.SYNC_SPLITS_NEW = 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_WHITELIST = exports.ENGINE_MATCHER_STARTS_WITH = exports.ENGINE_MATCHER_STRING = exports.ENGINE_MATCHER_SEGMENT = exports.ENGINE_MATCHER_PART_OF = exports.ENGINE_MATCHER_LESS = exports.ENGINE_MATCHER_GREATER = exports.ENGINE_MATCHER_ENDS_WITH = exports.ENGINE_MATCHER_EQUAL_TO_SET = exports.ENGINE_MATCHER_EQUAL = exports.ENGINE_MATCHER_DEPENDENCY_PRE = exports.ENGINE_MATCHER_DEPENDENCY = exports.ENGINE_MATCHER_CONTAINS_STRING = exports.ENGINE_MATCHER_CONTAINS_ANY = exports.ENGINE_MATCHER_CONTAINS_ALL = exports.ENGINE_MATCHER_BOOLEAN = exports.ENGINE_MATCHER_BETWEEN = exports.ENGINE_MATCHER_ALL = exports.ENGINE_BUCKET = exports.ENGINE_COMBINER_IFELSEIF_NO_TREATMENT = exports.ENGINE_COMBINER_IFELSEIF = exports.ENGINE_COMBINER_AND = void 0;
+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_MY_SEGMENTS_UPDATE_V2 = 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 = 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 = 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_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_LOCALHOST_MODULE_REQUIRED = exports.ERROR_HTTP = exports.ERROR_INVALID_CONFIG_PARAM = 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 = void 0;
 /**
  * Message codes used to trim string log messages from commons and client-side API modules,
  * in order to reduce the minimal SDK size for Browser and eventually other client-side environments.
@@ -30,7 +30,6 @@ exports.ENGINE_MATCHER_LESS = 16;
 exports.ENGINE_MATCHER_PART_OF = 17;
 exports.ENGINE_MATCHER_SEGMENT = 18;
 exports.ENGINE_MATCHER_STRING = 19;
-exports.ENGINE_MATCHER_STRING_INVALID = 20;
 exports.ENGINE_MATCHER_STARTS_WITH = 21;
 exports.ENGINE_MATCHER_WHITELIST = 22;
 exports.ENGINE_VALUE = 23;
@@ -133,6 +132,7 @@ exports.ERROR_NOT_BOOLEAN = 325;
 exports.ERROR_MIN_CONFIG_PARAM = 326;
 exports.ERROR_TOO_MANY_SETS = 327;
 exports.ERROR_SETS_FILTER_EXCLUSIVE = 328;
+exports.ENGINE_MATCHER_ERROR = 329;
 // Log prefixes (a.k.a. tags or categories)
 exports.LOG_PREFIX_SETTINGS = 'settings';
 exports.LOG_PREFIX_INSTANTIATION = 'Factory instantiation';

package/cjs/logger/index.js

@@ -28,7 +28,14 @@ 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 ((0, lang_1.isObject)(arg) || Array.isArray(arg)) {
+            try {
+                arg = JSON.stringify(arg);
+            }
+            catch (e) { /* empty */ }
+        }
+        return arg;
     });
 }
 exports._sprintf = _sprintf;

package/cjs/logger/messages/debug.js

@@ -26,7 +26,6 @@ exports.codesDebug = info_1.codesInfo.concat([
     [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.'],

package/cjs/logger/messages/error.js

@@ -5,7 +5,8 @@ var tslib_1 = require("tslib");
 var c = (0, tslib_1.__importStar)(require("../constants"));
 exports.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/cjs/services/splitApi.js

@@ -32,16 +32,16 @@ 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=" + constants_1.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(constants_1.TOKEN));
         },
         fetchSplitChanges: function (since, noCache, till) {
-            var url = urls.sdk + "/splitChanges?s=" + constants_1.FLAGS_SPEC + "&since=" + since + (till ? '&till=' + till : '') + (filterQueryString || '');
+            var url = urls.sdk + "/splitChanges?s=" + constants_1.FLAGS_SPEC + "&since=" + since + (filterQueryString || '') + (till ? '&till=' + till : '');
             return splitHttpClient(url, noCache ? noCacheHeaderOptions : undefined, telemetryTracker.trackHttp(constants_1.SPLITS))
                 .catch(function (err) {
                 if (err.statusCode === 414)

package/cjs/storages/inLocalStorage/SplitsCacheInLocal.js

@@ -126,7 +126,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(constants_1.LOG_PREFIX + 'SDK key or feature flag filter criteria was modified. Updating cache');
+            this.log.info(constants_1.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/cjs/storages/pluggable/index.js

@@ -82,7 +82,7 @@ function PluggableStorage(options) {
                 return wrapper.get(keys.buildHashKey()).then(function (hash) {
                     var currentHash = (0, KeyBuilder_1.getStorageHash)(settings);
                     if (hash !== currentHash) {
-                        log.info(constants_2.LOG_PREFIX + 'Storage HASH has changed (SDK key or feature flag filter criteria was modified). Clearing cache');
+                        log.info(constants_2.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); });