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

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,12 @@
+"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 isEqual = ruleSemver.version === new Semver_1.Semver(runtimeAttr).version;
+        return isEqual;
+    };
+}
+exports.equalToSemverMatcherContext = equalToSemverMatcherContext;

package/cjs/evaluator/matchers/semver_gte.js

@@ -0,0 +1,12 @@
+"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 isGreaterThanEqual = new Semver_1.Semver(runtimeAttr).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,12 @@
+"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 isLessThenEqual = new Semver_1.Semver(runtimeAttr).compare(ruleSemver) <= 0;
+        return isLessThenEqual;
+    };
+}
+exports.lessThanEqualToSemverMatcherContext = lessThanEqualToSemverMatcherContext;

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/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,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Semver = void 0;
+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) {
+        // 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,8 @@
+import { Semver } from '../../utils/Semver';
+export function equalToSemverMatcherContext(log, ruleAttr) {
+    var ruleSemver = new Semver(ruleAttr);
+    return function equalToSemverMatcher(runtimeAttr) {
+        var isEqual = ruleSemver.version === new Semver(runtimeAttr).version;
+        return isEqual;
+    };
+}

package/esm/evaluator/matchers/semver_gte.js

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

package/esm/evaluator/matchers/semver_inlist.js

@@ -0,0 +1,10 @@
+import { setToArray, _Set } from '../../utils/lang/sets';
+import { Semver } from '../../utils/Semver';
+export function inListSemverMatcherContext(log, ruleAttr) {
+    var listOfSemvers = new _Set(setToArray(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,8 @@
+import { Semver } from '../../utils/Semver';
+export function lessThanEqualToSemverMatcherContext(log, ruleAttr) {
+    var ruleSemver = new Semver(ruleAttr);
+    return function lessThanEqualToSemverMatcher(runtimeAttr) {
+        var isLessThenEqual = new Semver(runtimeAttr).compare(ruleSemver) <= 0;
+        return isLessThenEqual;
+    };
+}

package/esm/evaluator/matchersTransform/index.js

@@ -10,37 +10,38 @@ 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);
+            value = segmentTransform(userDefinedSegmentMatcherData);
         }
-        else if (type === matcherTypes.WHITELIST) {
-            value = whitelistTransform(whitelistObject);
+        else if (type === matcherTypes.WHITELIST ||
+            type === matcherTypes.IN_LIST_SEMVER) {
+            value = whitelistTransform(whitelistMatcherData);
         }
         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,27 +49,33 @@ 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 = setTransform(whitelistMatcherData);
             dataType = matcherDataTypes.SET;
         }
         else if (type === matcherTypes.STARTS_WITH ||
             type === matcherTypes.ENDS_WITH ||
             type === matcherTypes.CONTAINS_STRING) {
-            value = setTransform(whitelistObject);
+            value = setTransform(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 {

package/esm/services/splitApi.js

@@ -1,6 +1,6 @@
 import { splitHttpClientFactory } from './splitHttpClient';
 import { objectAssign } from '../utils/lang/objectAssign';
-import { SPLITS, IMPRESSIONS, IMPRESSIONS_COUNT, EVENTS, TELEMETRY, TOKEN, SEGMENT, MY_SEGMENT, FLAGS_SPEC } from '../utils/constants';
+import { SPLITS, IMPRESSIONS, IMPRESSIONS_COUNT, EVENTS, TELEMETRY, TOKEN, SEGMENT, MY_SEGMENT } from '../utils/constants';
 import { ERROR_TOO_MANY_SETS } from '../logger/constants';
 var noCacheHeaderOptions = { headers: { 'Cache-Control': 'no-cache' } };
 function userKeyToQueryParam(userKey) {
@@ -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?s=" + 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(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?since=" + since + (till ? '&till=' + till : '') + (filterQueryString || '');
             return splitHttpClient(url, noCache ? noCacheHeaderOptions : undefined, telemetryTracker.trackHttp(SPLITS))
                 .catch(function (err) {
                 if (err.statusCode === 414)