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

package/CHANGES.txt

@@ -1,6 +1,6 @@
 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 use the version query param for the `splitChanges` endpoint.
+ - 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/combiners/ifelseif.js

@@ -39,7 +39,7 @@ function ifElseIfCombinerContext(log, predicates) {
         return computeTreatment(predicateResults);
     }
     // if there is none predicates, then there was an error in parsing phase
-    if (!Array.isArray(predicates) || Array.isArray(predicates) && predicates.length === 0) {
+    if (!Array.isArray(predicates) || predicates.length === 0) {
         return unexpectedInputHandler;
     }
     else {

package/cjs/evaluator/parser/index.js

@@ -30,8 +30,7 @@ function parser(log, conditions, storage) {
                 return Boolean(result ^ matcherDto.negate);
             };
         });
-        // if matcher's factory can't instanciate the matchers, the expressions array
-        // will be empty
+        // if matcher's factory can't instantiate the matchers, the expressions array will be empty
         if (expressions.length === 0) {
             // reset any data collected during parsing
             predicates = [];

package/cjs/logger/messages/error.js

@@ -5,7 +5,7 @@ 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 found'],
+    [c.ERROR_ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Invalid feature flag, no valid rules or unsupported matcher type found'],
     // SDK
     [c.ERROR_LOGLEVEL_INVALID, 'logger: Invalid Log Level - No changes to the logs will be applied.'],
     [c.ERROR_CLIENT_CANNOT_GET_READY, 'The SDK will not get ready. Reason: %s'],

package/cjs/sdkClient/sdkClient.js

@@ -31,8 +31,6 @@ function sdkClientFactory(params, isSharedClient) {
     function __flush() {
         return syncManager ? syncManager.flush() : Promise.resolve();
     }
-    // Same promise if `destroy` is called multiple times
-    var destroyPromise;
     return (0, objectAssign_1.objectAssign)(
     // Proto-linkage of the readiness Event Emitter
     Object.create(sdkReadinessManager.sdkStatus), 
@@ -45,8 +43,6 @@ function sdkClientFactory(params, isSharedClient) {
             return __cooldown(__flush, COOLDOWN_TIME_IN_MILLIS);
         },
         destroy: function () {
-            if (destroyPromise)
-                return destroyPromise;
             // Mark the SDK as destroyed immediately
             sdkReadinessManager.readinessManager.destroy();
             // For main client, release the SDK Key and record stat before flushing data
@@ -56,7 +52,7 @@ function sdkClientFactory(params, isSharedClient) {
             }
             // Stop background jobs
             syncManager && syncManager.stop();
-            destroyPromise = __flush().then(function () {
+            return __flush().then(function () {
                 // Cleanup event listeners
                 signalListener && signalListener.stop();
                 // @TODO stop only if last client is destroyed
@@ -65,7 +61,6 @@ function sdkClientFactory(params, isSharedClient) {
                 // Cleanup storage
                 return storage.destroy();
             });
-            return destroyPromise;
         }
     });
 }

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?v=1.0&since=" + since + (till ? '&till=' + till : '') + (filterQueryString || '');
+            var url = urls.sdk + "/splitChanges?s=" + constants_1.FLAGS_SPEC + "&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,6 +1,7 @@
 "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 = /[^.]+$/;
@@ -70,6 +71,6 @@ exports.KeyBuilder = KeyBuilder;
  * 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 + "::1.0").toString(16);
+    return (0, murmur3_1.hash)(settings.core.authorizationKey + "::" + settings.sync.__splitFiltersValidation.queryString + "::" + constants_1.FLAGS_SPEC).toString(16);
 }
 exports.getStorageHash = getStorageHash;

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.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.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;
 // Special treatments
 exports.CONTROL = 'control';
 exports.CONTROL_WITH_CONFIG = {
@@ -90,3 +90,4 @@ exports.NON_REQUESTED = 1;
 exports.DISABLED = 0;
 exports.ENABLED = 1;
 exports.PAUSED = 2;
+exports.FLAGS_SPEC = '1.1';

package/cjs/utils/settingsValidation/index.js

@@ -57,7 +57,7 @@ exports.base = {
         // Telemetry Server
         telemetry: 'https://telemetry.split.io/api',
     },
-    // Defines which kind of storage we should instanciate.
+    // Defines which kind of storage we should instantiate.
     storage: undefined,
     // Defines if the logs are enabled, SDK wide.
     debug: undefined,

package/esm/evaluator/combiners/ifelseif.js

@@ -35,7 +35,7 @@ export function ifElseIfCombinerContext(log, predicates) {
         return computeTreatment(predicateResults);
     }
     // if there is none predicates, then there was an error in parsing phase
-    if (!Array.isArray(predicates) || Array.isArray(predicates) && predicates.length === 0) {
+    if (!Array.isArray(predicates) || predicates.length === 0) {
         return unexpectedInputHandler;
     }
     else {

package/esm/evaluator/parser/index.js

@@ -27,8 +27,7 @@ export function parser(log, conditions, storage) {
                 return Boolean(result ^ matcherDto.negate);
             };
         });
-        // if matcher's factory can't instanciate the matchers, the expressions array
-        // will be empty
+        // if matcher's factory can't instantiate the matchers, the expressions array will be empty
         if (expressions.length === 0) {
             // reset any data collected during parsing
             predicates = [];

package/esm/logger/messages/error.js

@@ -1,7 +1,7 @@
 import * as c from '../constants';
 export var codesError = [
     // evaluator
-    [c.ERROR_ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Invalid feature flag, no valid rules found'],
+    [c.ERROR_ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Invalid feature flag, no valid rules or unsupported matcher type found'],
     // SDK
     [c.ERROR_LOGLEVEL_INVALID, 'logger: Invalid Log Level - No changes to the logs will be applied.'],
     [c.ERROR_CLIENT_CANNOT_GET_READY, 'The SDK will not get ready. Reason: %s'],

package/esm/sdkClient/sdkClient.js

@@ -28,8 +28,6 @@ export function sdkClientFactory(params, isSharedClient) {
     function __flush() {
         return syncManager ? syncManager.flush() : Promise.resolve();
     }
-    // Same promise if `destroy` is called multiple times
-    var destroyPromise;
     return objectAssign(
     // Proto-linkage of the readiness Event Emitter
     Object.create(sdkReadinessManager.sdkStatus), 
@@ -42,8 +40,6 @@ export function sdkClientFactory(params, isSharedClient) {
             return __cooldown(__flush, COOLDOWN_TIME_IN_MILLIS);
         },
         destroy: function () {
-            if (destroyPromise)
-                return destroyPromise;
             // Mark the SDK as destroyed immediately
             sdkReadinessManager.readinessManager.destroy();
             // For main client, release the SDK Key and record stat before flushing data
@@ -53,7 +49,7 @@ export function sdkClientFactory(params, isSharedClient) {
             }
             // Stop background jobs
             syncManager && syncManager.stop();
-            destroyPromise = __flush().then(function () {
+            return __flush().then(function () {
                 // Cleanup event listeners
                 signalListener && signalListener.stop();
                 // @TODO stop only if last client is destroyed
@@ -62,7 +58,6 @@ export function sdkClientFactory(params, isSharedClient) {
                 // Cleanup storage
                 return storage.destroy();
             });
-            return destroyPromise;
         }
     });
 }

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 } from '../utils/constants';
+import { SPLITS, IMPRESSIONS, IMPRESSIONS_COUNT, EVENTS, TELEMETRY, TOKEN, SEGMENT, MY_SEGMENT, FLAGS_SPEC } 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";
-            if (userMatchingKeys) { // accounting the possibility that `userMatchingKeys` is undefined (server-side API)
+            var url = urls.auth + "/v2/auth?s=" + FLAGS_SPEC;
+            if (userMatchingKeys) { // `userMatchingKeys` is undefined in server-side
                 var queryParams = userMatchingKeys.map(userKeyToQueryParam).join('&');
-                if (queryParams) // accounting the possibility that `userKeys` and thus `queryParams` are empty
-                    url += '?' + queryParams;
+                if (queryParams)
+                    url += '&' + queryParams;
             }
             return splitHttpClient(url, undefined, telemetryTracker.trackHttp(TOKEN));
         },
         fetchSplitChanges: function (since, noCache, till) {
-            var url = urls.sdk + "/splitChanges?v=1.0&since=" + since + (till ? '&till=' + till : '') + (filterQueryString || '');
+            var url = urls.sdk + "/splitChanges?s=" + FLAGS_SPEC + "&since=" + since + (till ? '&till=' + till : '') + (filterQueryString || '');
             return splitHttpClient(url, noCache ? noCacheHeaderOptions : undefined, telemetryTracker.trackHttp(SPLITS))
                 .catch(function (err) {
                 if (err.statusCode === 414)

package/esm/storages/KeyBuilder.js

@@ -1,3 +1,4 @@
+import { FLAGS_SPEC } from '../utils/constants';
 import { startsWith } from '../utils/lang';
 import { hash } from '../utils/murmur3/murmur3';
 var everythingAtTheEnd = /[^.]+$/;
@@ -66,5 +67,5 @@ export { KeyBuilder };
  * The hash is in hexadecimal format (8 characters max, 32 bits).
  */
 export function getStorageHash(settings) {
-    return hash(settings.core.authorizationKey + "::" + settings.sync.__splitFiltersValidation.queryString + "::1.0").toString(16);
+    return hash(settings.core.authorizationKey + "::" + settings.sync.__splitFiltersValidation.queryString + "::" + FLAGS_SPEC).toString(16);
 }

package/esm/utils/constants/index.js

@@ -86,3 +86,4 @@ export var NON_REQUESTED = 1;
 export var DISABLED = 0;
 export var ENABLED = 1;
 export var PAUSED = 2;
+export var FLAGS_SPEC = '1.1';

package/esm/utils/settingsValidation/index.js

@@ -54,7 +54,7 @@ export var base = {
         // Telemetry Server
         telemetry: 'https://telemetry.split.io/api',
     },
-    // Defines which kind of storage we should instanciate.
+    // Defines which kind of storage we should instantiate.
     storage: undefined,
     // Defines if the logs are enabled, SDK wide.
     debug: undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio-commons",
-  "version": "1.13.2-rc.0",
+  "version": "1.13.2-rc.2",
   "description": "Split JavaScript SDK common components",
   "main": "cjs/index.js",
   "module": "esm/index.js",

package/src/evaluator/combiners/ifelseif.ts

@@ -50,7 +50,7 @@ export function ifElseIfCombinerContext(log: ILogger, predicates: IEvaluator[]):
   }
 
   // if there is none predicates, then there was an error in parsing phase
-  if (!Array.isArray(predicates) || Array.isArray(predicates) && predicates.length === 0) {
+  if (!Array.isArray(predicates) || predicates.length === 0) {
     return unexpectedInputHandler;
   } else {
     return ifElseIfCombiner;

package/src/evaluator/parser/index.ts

@@ -44,8 +44,7 @@ export function parser(log: ILogger, conditions: ISplitCondition[], storage: ISt
       };
     });
 
-    // if matcher's factory can't instanciate the matchers, the expressions array
-    // will be empty
+    // if matcher's factory can't instantiate the matchers, the expressions array will be empty
     if (expressions.length === 0) {
       // reset any data collected during parsing
       predicates = [];

package/src/logger/messages/error.ts

@@ -2,7 +2,7 @@ import * as c from '../constants';
 
 export const codesError: [number, string][] = [
   // evaluator
-  [c.ERROR_ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Invalid feature flag, no valid rules found'],
+  [c.ERROR_ENGINE_COMBINER_IFELSEIF, c.LOG_PREFIX_ENGINE_COMBINER + 'Invalid feature flag, no valid rules or unsupported matcher type found'],
   // SDK
   [c.ERROR_LOGLEVEL_INVALID, 'logger: Invalid Log Level - No changes to the logs will be applied.'],
   [c.ERROR_CLIENT_CANNOT_GET_READY, 'The SDK will not get ready. Reason: %s'],

package/src/sdkClient/sdkClient.ts

@@ -35,9 +35,6 @@ export function sdkClientFactory(params: ISdkFactoryContext, isSharedClient?: bo
     return syncManager ? syncManager.flush() : Promise.resolve();
   }
 
-  // Same promise if `destroy` is called multiple times
-  let destroyPromise: Promise<void> | undefined;
-
   return objectAssign(
     // Proto-linkage of the readiness Event Emitter
     Object.create(sdkReadinessManager.sdkStatus) as IStatusInterface,
@@ -56,8 +53,6 @@ export function sdkClientFactory(params: ISdkFactoryContext, isSharedClient?: bo
         return __cooldown(__flush, COOLDOWN_TIME_IN_MILLIS);
       },
       destroy() {
-        if (destroyPromise) return destroyPromise;
-
         // Mark the SDK as destroyed immediately
         sdkReadinessManager.readinessManager.destroy();
 
@@ -70,7 +65,7 @@ export function sdkClientFactory(params: ISdkFactoryContext, isSharedClient?: bo
         // Stop background jobs
         syncManager && syncManager.stop();
 
-        destroyPromise = __flush().then(() => {
+        return __flush().then(() => {
           // Cleanup event listeners
           signalListener && signalListener.stop();
 
@@ -80,8 +75,6 @@ export function sdkClientFactory(params: ISdkFactoryContext, isSharedClient?: bo
           // Cleanup storage
           return storage.destroy();
         });
-
-        return destroyPromise;
       }
     }
   );

package/src/services/splitApi.ts

@@ -4,7 +4,7 @@ import { splitHttpClientFactory } from './splitHttpClient';
 import { ISplitApi } from './types';
 import { objectAssign } from '../utils/lang/objectAssign';
 import { ITelemetryTracker } from '../trackers/types';
-import { SPLITS, IMPRESSIONS, IMPRESSIONS_COUNT, EVENTS, TELEMETRY, TOKEN, SEGMENT, MY_SEGMENT } from '../utils/constants';
+import { SPLITS, IMPRESSIONS, IMPRESSIONS_COUNT, EVENTS, TELEMETRY, TOKEN, SEGMENT, MY_SEGMENT, FLAGS_SPEC } from '../utils/constants';
 import { ERROR_TOO_MANY_SETS } from '../logger/constants';
 
 const noCacheHeaderOptions = { headers: { 'Cache-Control': 'no-cache' } };
@@ -44,17 +44,16 @@ export function splitApiFactory(
     },
 
     fetchAuth(userMatchingKeys?: string[]) {
-      let url = `${urls.auth}/v2/auth`;
-      if (userMatchingKeys) { // accounting the possibility that `userMatchingKeys` is undefined (server-side API)
+      let url = `${urls.auth}/v2/auth?s=${FLAGS_SPEC}`;
+      if (userMatchingKeys) { // `userMatchingKeys` is undefined in server-side
         const queryParams = userMatchingKeys.map(userKeyToQueryParam).join('&');
-        if (queryParams) // accounting the possibility that `userKeys` and thus `queryParams` are empty
-          url += '?' + queryParams;
+        if (queryParams) url += '&' + queryParams;
       }
       return splitHttpClient(url, undefined, telemetryTracker.trackHttp(TOKEN));
     },
 
     fetchSplitChanges(since: number, noCache?: boolean, till?: number) {
-      const url = `${urls.sdk}/splitChanges?v=1.0&since=${since}${till ? '&till=' + till : ''}${filterQueryString || ''}`;
+      const url = `${urls.sdk}/splitChanges?s=${FLAGS_SPEC}&since=${since}${till ? '&till=' + till : ''}${filterQueryString || ''}`;
       return splitHttpClient(url, noCache ? noCacheHeaderOptions : undefined, telemetryTracker.trackHttp(SPLITS))
         .catch((err) => {
           if (err.statusCode === 414) settings.log.error(ERROR_TOO_MANY_SETS);

package/src/storages/KeyBuilder.ts

@@ -1,4 +1,5 @@
 import { ISettings } from '../types';
+import { FLAGS_SPEC } from '../utils/constants';
 import { startsWith } from '../utils/lang';
 import { hash } from '../utils/murmur3/murmur3';
 
@@ -85,5 +86,5 @@ export class KeyBuilder {
  * The hash is in hexadecimal format (8 characters max, 32 bits).
  */
 export function getStorageHash(settings: ISettings) {
-  return hash(`${settings.core.authorizationKey}::${settings.sync.__splitFiltersValidation.queryString}::1.0`).toString(16);
+  return hash(`${settings.core.authorizationKey}::${settings.sync.__splitFiltersValidation.queryString}::${FLAGS_SPEC}`).toString(16);
 }

package/src/types.ts

@@ -353,7 +353,7 @@ interface INodeBasicSettings extends ISharedSettings {
     IPAddressesEnabled?: boolean
   },
   /**
-   * Defines which kind of storage we should instanciate.
+   * Defines which kind of storage we should instantiate.
    * @property {Object} storage
    */
   storage?: (params: any) => any,
@@ -918,7 +918,7 @@ export namespace SplitIO {
      */
     features?: MockedFeaturesMap,
     /**
-     * Defines which kind of storage we should instanciate.
+     * Defines which kind of storage we should instantiate.
      * @property {Object} storage
      */
     storage?: (params: IStorageFactoryParams) => IStorageSync | IStorageAsync,
@@ -944,7 +944,7 @@ export namespace SplitIO {
      */
     urls?: UrlSettings,
     /**
-     * Defines which kind of storage we should instanciate.
+     * Defines which kind of storage we should instantiate.
      * @property {Object} storage
      */
     storage?: (params: IStorageFactoryParams) => IStorageSync,

package/src/utils/constants/index.ts

@@ -104,3 +104,5 @@ export const NON_REQUESTED = 1;
 export const DISABLED = 0;
 export const ENABLED = 1;
 export const PAUSED = 2;
+
+export const FLAGS_SPEC = '1.1';

package/src/utils/settingsValidation/index.ts

@@ -61,7 +61,7 @@ export const base = {
     telemetry: 'https://telemetry.split.io/api',
   },
 
-  // Defines which kind of storage we should instanciate.
+  // Defines which kind of storage we should instantiate.
   storage: undefined,
 
   // Defines if the logs are enabled, SDK wide.

package/types/evaluator/matchers/sember_inlist.d.ts

@@ -0,0 +1,3 @@
+import { ISet } from '../../utils/lang/sets';
+import { ILogger } from '../../logger/types';
+export declare function inListSemverMatcherContext(log: ILogger, ruleAttr: ISet<string>): (runtimeAttr: string) => boolean;

package/types/evaluator/matchers/semver_between.d.ts

@@ -0,0 +1,3 @@
+import { IBetweenMatcherData } from '../../dtos/types';
+import { ILogger } from '../../logger/types';
+export declare function betweenSemverMatcherContext(log: ILogger, ruleVO: IBetweenMatcherData): (key: string) => boolean;

package/types/evaluator/matchers/semver_eq.d.ts

@@ -0,0 +1,2 @@
+import { ILogger } from '../../logger/types';
+export declare function equalToSemverMatcherContext(log: ILogger, ruleAttr: string): (runtimeAttr: string) => boolean;

package/types/evaluator/matchers/semver_gte.d.ts

@@ -0,0 +1,2 @@
+import { ILogger } from '../../logger/types';
+export declare function greaterThanEqualToSemverMatcherContext(log: ILogger, ruleAttr: string): (runtimeAttr: string) => boolean;

package/types/evaluator/matchers/semver_lte.d.ts

@@ -0,0 +1,2 @@
+import { ILogger } from '../../logger/types';
+export declare function lessThanEqualToSemverMatcherContext(log: ILogger, ruleAttr: string): (runtimeAttr: string) => boolean;

package/types/types.d.ts

@@ -347,7 +347,7 @@ interface INodeBasicSettings extends ISharedSettings {
         IPAddressesEnabled?: boolean;
     };
     /**
-     * Defines which kind of storage we should instanciate.
+     * Defines which kind of storage we should instantiate.
      * @property {Object} storage
      */
     storage?: (params: any) => any;
@@ -915,7 +915,7 @@ export declare namespace SplitIO {
          */
         features?: MockedFeaturesMap;
         /**
-         * Defines which kind of storage we should instanciate.
+         * Defines which kind of storage we should instantiate.
          * @property {Object} storage
          */
         storage?: (params: IStorageFactoryParams) => IStorageSync | IStorageAsync;
@@ -941,7 +941,7 @@ export declare namespace SplitIO {
          */
         urls?: UrlSettings;
         /**
-         * Defines which kind of storage we should instanciate.
+         * Defines which kind of storage we should instantiate.
          * @property {Object} storage
          */
         storage?: (params: IStorageFactoryParams) => IStorageSync;

package/types/utils/constants/index.d.ts

@@ -78,3 +78,4 @@ export declare const NON_REQUESTED = 1;
 export declare const DISABLED = 0;
 export declare const ENABLED = 1;
 export declare const PAUSED = 2;
+export declare const FLAGS_SPEC = "1.1";

package/types/utils/semVer.d.ts

@@ -0,0 +1,22 @@
+export declare class Semver {
+    private _major;
+    private _minor;
+    private _patch;
+    private _preRelease;
+    private _isStable;
+    private _oVersion;
+    constructor(version: string);
+    private removeMetadataIfExists;
+    isEqualTo(toCompare: Semver): boolean;
+    isGreaterThanOrEqualTo(toCompare: Semver): boolean;
+    isLessThanOrEqualTo(toCompare: Semver): boolean;
+    isBetween(start: Semver, end: Semver): boolean;
+    /**
+     * Precedence comparision between 2 Semver objects.
+     *
+     * @return the value {@code 0} if {@code this == toCompare};
+     *         a value less than {@code 0} if {@code this < toCompare}; and
+     *         a value greater than {@code 0} if {@code this > toCompare}
+     */
+    private compare;
+}

package/types/utils/settingsValidation/logger/globalLogLevel.d.ts

@@ -0,0 +1,8 @@
+import { LogLevel } from '../../../types';
+/**
+ * The debug level can be set globally via the `localStorage.splitio_debug` item in browser, or the `SPLITIO_DEBUG` env var in NodeJS.
+ * Acceptable values are: 'DEBUG', 'INFO', 'WARN', 'ERROR', 'NONE'.
+ * Other acceptable values are 'on', 'enable' and 'enabled', which are equivalent to 'DEBUG'.
+ * Any other value, like undefined, null or an invalid string, returns `undefined` and means that the global log level is not set.
+ */
+export declare function getGlobalLogLevel(): LogLevel | undefined;