@splitsoftware/splitio-commons 1.13.2-rc.2 → 1.13.2-rc.4

package/CHANGES.txt

@@ -1,6 +1,5 @@
 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.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/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/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(key) {
+        var runtimeSemver = new Semver_1.Semver(key);
+        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,14 @@
+"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) {
+    var listOfSemvers = new sets_1._Set((0, sets_1.setToArray)(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 isLessThenEqual = runtimeSemver.compare(ruleSemver) <= 0;
+        return isLessThenEqual;
+    };
+}
+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/matchersTransform/index.js

@@ -13,37 +13,38 @@ 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);
+            value = (0, segment_1.segmentTransform)(userDefinedSegmentMatcherData);
         }
-        else if (type === matcherTypes_1.matcherTypes.WHITELIST) {
-            value = (0, whitelist_1.whitelistTransform)(whitelistObject);
+        else if (type === matcherTypes_1.matcherTypes.WHITELIST ||
+            type === matcherTypes_1.matcherTypes.IN_LIST_SEMVER) {
+            value = (0, whitelist_1.whitelistTransform)(whitelistMatcherData);
         }
         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,27 +52,33 @@ 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, set_1.setTransform)(whitelistMatcherData);
             dataType = matcherTypes_1.matcherDataTypes.SET;
         }
         else if (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, set_1.setTransform)(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 {

package/cjs/evaluator/parser/index.js

@@ -9,24 +9,37 @@ 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++) {
+    var _loop_1 = function (i) {
         var _a = conditions[i], matcherGroup = _a.matcherGroup, partitions = _a.partitions, label = _a.label, conditionType = _a.conditionType;
         // transform data structure
         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 expressions = matchers.map(function (matcherDto, index) {
+            var matcher;
+            try {
+                matcher = (0, matchers_1.matcherFactory)(log, matcherDto, storage);
+            }
+            catch (error) {
+                log.error(constants_1.ENGINE_MATCHER_ERROR, [matcherGroup.matchers[index].matcherType, 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, [matcherGroup.matchers[index].matcherType, 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);
             };
         });
@@ -34,10 +47,14 @@ function parser(log, conditions, storage) {
         if (expressions.length === 0) {
             // reset any data collected during parsing
             predicates = [];
-            // and break the loop
-            break;
+            return "break";
         }
         predicates.push((0, condition_1.conditionContext)(log, (0, and_1.andCombinerContext)(log, expressions), treatments_1.Treatments.parse(partitions), label, conditionType));
+    };
+    for (var i = 0; i < conditions.length; i++) {
+        var state_1 = _loop_1(i);
+        if (state_1 === "break")
+            break;
     }
     // Instanciate evaluator given the set of conditions using if else if logic
     return (0, ifelseif_1.ifElseIfCombinerContext)(log, predicates);

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/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

@@ -6,6 +6,7 @@ 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.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?s=" + constants_1.FLAGS_SPEC;
-            if (userMatchingKeys) { // `userMatchingKeys` is undefined in server-side
+            var url = urls.auth + "/v2/auth";
+            if (userMatchingKeys) { // accounting the possibility that `userMatchingKeys` is undefined (server-side API)
                 var queryParams = userMatchingKeys.map(userKeyToQueryParam).join('&');
-                if (queryParams)
-                    url += '&' + queryParams;
+                if (queryParams) // accounting the possibility that `userKeys` and thus `queryParams` are empty
+                    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?since=" + since + (till ? '&till=' + till : '') + (filterQueryString || '');
             return splitHttpClient(url, noCache ? noCacheHeaderOptions : undefined, telemetryTracker.trackHttp(constants_1.SPLITS))
                 .catch(function (err) {
                 if (err.statusCode === 414)

package/cjs/storages/KeyBuilder.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getStorageHash = exports.KeyBuilder = exports.validatePrefix = void 0;
-var constants_1 = require("../utils/constants");
 var lang_1 = require("../utils/lang");
 var murmur3_1 = require("../utils/murmur3/murmur3");
 var everythingAtTheEnd = /[^.]+$/;
@@ -67,10 +66,10 @@ var KeyBuilder = /** @class */ (function () {
 }());
 exports.KeyBuilder = KeyBuilder;
 /**
- * Generates a murmur32 hash based on the authorization key, the feature flags filter query, and version of SplitChanges API.
+ * Generates a murmur32 hash based on the authorization key and the feature flags filter query.
  * The hash is in hexadecimal format (8 characters max, 32 bits).
  */
 function getStorageHash(settings) {
-    return (0, murmur3_1.hash)(settings.core.authorizationKey + "::" + settings.sync.__splitFiltersValidation.queryString + "::" + constants_1.FLAGS_SPEC).toString(16);
+    return (0, murmur3_1.hash)(settings.core.authorizationKey + "::" + settings.sync.__splitFiltersValidation.queryString).toString(16);
 }
 exports.getStorageHash = getStorageHash;

package/cjs/utils/Semver.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Semver = void 0;
+var lang_1 = require("../utils/lang");
+var NUMERIC_IDENTIFIER_REGEX = /^[0-9]+$/;
+var METADATA_DELIMITER = '+';
+var PRERELEASE_DELIMITER = '-';
+var VALUE_DELIMITER = '.';
+/**
+ * Compares two strings. If both strings are numeric identifiers, they are compared numerically. Otherwise, they are compared lexicographically.
+ * This could be implemented using `a.localeCompare(b, undefined, { numeric: true })` but locale options are not broadly supported.
+ */
+function compareStrings(a, b) {
+    if (NUMERIC_IDENTIFIER_REGEX.test(a) && NUMERIC_IDENTIFIER_REGEX.test(b)) {
+        var result = a.length - b.length;
+        if (result !== 0) {
+            return result;
+        }
+    }
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+// Sanitizes a numeric identifier by removing leading zeros
+function sanitizeNumericIdentifier(value) {
+    return value.replace(/^0+(?=\d)/, '');
+}
+function throwError(version) {
+    throw new Error('Unable to convert to Semver, incorrect format: ' + version);
+}
+var Semver = /** @class */ (function () {
+    function Semver(version) {
+        if (!(0, lang_1.isString)(version))
+            throwError(version);
+        // Separate metadata if exists
+        var index = version.indexOf(METADATA_DELIMITER);
+        var _a = index === -1 ? [version] : [version.slice(0, index), version.slice(index + 1)], vWithoutMetadata = _a[0], metadata = _a[1];
+        if (metadata === '')
+            throwError(version);
+        // Set pre-release versions if exists
+        index = vWithoutMetadata.indexOf(PRERELEASE_DELIMITER);
+        if (index === -1) {
+            this._isStable = true;
+            this._preRelease = [];
+        }
+        else {
+            this._isStable = false;
+            this._preRelease = vWithoutMetadata.slice(index + 1).split(VALUE_DELIMITER).map(function (value) {
+                if (!value)
+                    throwError(version);
+                return NUMERIC_IDENTIFIER_REGEX.test(value) ?
+                    sanitizeNumericIdentifier(value) :
+                    value;
+            });
+            vWithoutMetadata = vWithoutMetadata.slice(0, index);
+        }
+        // Set major, minor, and patch versions
+        var vParts = vWithoutMetadata.split(VALUE_DELIMITER).map(function (value) {
+            if (!value || !NUMERIC_IDENTIFIER_REGEX.test(value))
+                throwError(version);
+            return sanitizeNumericIdentifier(value);
+        });
+        if (vParts.length !== 3)
+            throwError(version);
+        this._major = vParts[0];
+        this._minor = vParts[1];
+        this._patch = vParts[2];
+        // Set version string
+        this.version = vParts.join(VALUE_DELIMITER);
+        if (this._preRelease.length)
+            this.version += PRERELEASE_DELIMITER + this._preRelease.join(VALUE_DELIMITER);
+        if (metadata)
+            this.version += METADATA_DELIMITER + metadata;
+    }
+    /**
+     * Precedence comparision between 2 Semver objects.
+     *
+     * @return `0` if `this === toCompare`, `-1` if `this < toCompare`, and `1` if `this > toCompare`
+     */
+    Semver.prototype.compare = function (toCompare) {
+        if (this.version === toCompare.version)
+            return 0;
+        var result = compareStrings(this._major, toCompare._major);
+        if (result !== 0)
+            return result;
+        result = compareStrings(this._minor, toCompare._minor);
+        if (result !== 0)
+            return result;
+        result = compareStrings(this._patch, toCompare._patch);
+        if (result !== 0)
+            return result;
+        if (!this._isStable && toCompare._isStable)
+            return -1;
+        if (this._isStable && !toCompare._isStable)
+            return 1;
+        for (var i = 0, length_1 = Math.min(this._preRelease.length, toCompare._preRelease.length); i < length_1; i++) {
+            var result_1 = compareStrings(this._preRelease[i], toCompare._preRelease[i]);
+            if (result_1 !== 0)
+                return result_1;
+        }
+        return this._preRelease.length - toCompare._preRelease.length;
+    };
+    return Semver;
+}());
+exports.Semver = Semver;

package/cjs/utils/constants/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MY_SEGMENT = exports.SEGMENT = exports.TOKEN = exports.TELEMETRY = exports.EVENTS = exports.IMPRESSIONS_COUNT = exports.IMPRESSIONS = exports.SPLITS = exports.NONE_ENUM = exports.DEBUG_ENUM = exports.OPTIMIZED_ENUM = exports.CONSUMER_PARTIAL_ENUM = exports.CONSUMER_ENUM = exports.STANDALONE_ENUM = exports.DEDUPED = exports.DROPPED = exports.QUEUED = exports.NAMES_FN_LABEL = exports.SPLITS_FN_LABEL = exports.SPLIT_FN_LABEL = exports.TRACK_FN_LABEL = exports.GET_TREATMENTS_WITH_CONFIG_BY_FLAG_SETS = exports.GET_TREATMENTS_WITH_CONFIG_BY_FLAG_SET = exports.GET_TREATMENTS_BY_FLAG_SETS = exports.GET_TREATMENTS_BY_FLAG_SET = exports.GET_TREATMENTS_WITH_CONFIG = exports.GET_TREATMENT_WITH_CONFIG = exports.GET_TREATMENTS = exports.GET_TREATMENT = exports.CONSENT_UNKNOWN = exports.CONSENT_DECLINED = exports.CONSENT_GRANTED = exports.STORAGE_PLUGGABLE = exports.STORAGE_REDIS = exports.STORAGE_LOCALSTORAGE = exports.STORAGE_MEMORY = exports.CONSUMER_PARTIAL_MODE = exports.CONSUMER_MODE = exports.PRODUCER_MODE = exports.STANDALONE_MODE = exports.LOCALHOST_MODE = exports.NONE = exports.OPTIMIZED = exports.DEBUG = exports.SPLIT_EVENT = exports.SPLIT_IMPRESSION = exports.NA = exports.UNKNOWN = exports.CONTROL_WITH_CONFIG = exports.CONTROL = void 0;
-exports.FLAGS_SPEC = exports.PAUSED = exports.ENABLED = exports.DISABLED = exports.NON_REQUESTED = exports.REQUESTED = exports.POLLING = exports.STREAMING = exports.AUTH_REJECTION = exports.SYNC_MODE_UPDATE = exports.ABLY_ERROR = exports.TOKEN_REFRESH = exports.SSE_CONNECTION_ERROR = exports.STREAMING_STATUS = exports.OCCUPANCY_SEC = exports.OCCUPANCY_PRI = exports.CONNECTION_ESTABLISHED = exports.TRACK = exports.TREATMENTS_WITH_CONFIG_BY_FLAGSETS = exports.TREATMENTS_WITH_CONFIG_BY_FLAGSET = exports.TREATMENTS_BY_FLAGSETS = exports.TREATMENTS_BY_FLAGSET = exports.TREATMENTS_WITH_CONFIG = exports.TREATMENT_WITH_CONFIG = exports.TREATMENTS = exports.TREATMENT = void 0;
+exports.PAUSED = exports.ENABLED = exports.DISABLED = exports.NON_REQUESTED = exports.REQUESTED = exports.POLLING = exports.STREAMING = exports.AUTH_REJECTION = exports.SYNC_MODE_UPDATE = exports.ABLY_ERROR = exports.TOKEN_REFRESH = exports.SSE_CONNECTION_ERROR = exports.STREAMING_STATUS = exports.OCCUPANCY_SEC = exports.OCCUPANCY_PRI = exports.CONNECTION_ESTABLISHED = exports.TRACK = exports.TREATMENTS_WITH_CONFIG_BY_FLAGSETS = exports.TREATMENTS_WITH_CONFIG_BY_FLAGSET = exports.TREATMENTS_BY_FLAGSETS = exports.TREATMENTS_BY_FLAGSET = exports.TREATMENTS_WITH_CONFIG = exports.TREATMENT_WITH_CONFIG = exports.TREATMENTS = exports.TREATMENT = void 0;
 // Special treatments
 exports.CONTROL = 'control';
 exports.CONTROL_WITH_CONFIG = {
@@ -90,4 +90,3 @@ exports.NON_REQUESTED = 1;
 exports.DISABLED = 0;
 exports.ENABLED = 1;
 exports.PAUSED = 2;
-exports.FLAGS_SPEC = '1.1';

package/cjs/utils/settingsValidation/logger/pluggableLogger.js

@@ -4,7 +4,7 @@ exports.validateLogger = void 0;
 var logger_1 = require("../../../logger");
 var commons_1 = require("./commons");
 function isLogger(log) {
-    return log && typeof log.debug === 'function' && typeof log.info === 'function' && typeof log.warn === 'function' && typeof log.error === 'function' && typeof log.setLogLevel === 'function';
+    return log !== null && typeof log === 'object' && typeof log.debug === 'function' && typeof log.info === 'function' && typeof log.warn === 'function' && typeof log.error === 'function' && typeof log.setLogLevel === 'function';
 }
 // By default it starts disabled.
 var initialLogLevel = logger_1.LogLevels.NONE;

package/esm/evaluator/matchers/gte.js

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

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/semver_between.js

@@ -0,0 +1,10 @@
+import { Semver } from '../../utils/Semver';
+export function betweenSemverMatcherContext(log, ruleAttr) {
+    var startSemver = new Semver(ruleAttr.start);
+    var endSemver = new Semver(ruleAttr.end);
+    return function betweenSemverMatcher(key) {
+        var runtimeSemver = new Semver(key);
+        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(log, ruleAttr) {
+    var ruleSemver = new Semver(ruleAttr);
+    return function equalToSemverMatcher(runtimeAttr) {
+        var runtimeSemver = new Semver(runtimeAttr);
+        var isEqual = ruleSemver.version === runtimeSemver.version;
+        return isEqual;
+    };
+}