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

package/src/logger/messages/error.ts

@@ -2,7 +2,8 @@ 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 targeting rule type found'],
+  [c.ENGINE_MATCHER_ERROR, c.LOG_PREFIX_ENGINE_MATCHER + '[%s] %s'],
   // SDK
   [c.ERROR_LOGLEVEL_INVALID, 'logger: Invalid Log Level - No changes to the logs will be applied.'],
   [c.ERROR_CLIENT_CANNOT_GET_READY, 'The SDK will not get ready. Reason: %s'],

package/src/logger/messages/warn.ts

@@ -4,7 +4,7 @@ import { codesError } from './error';
 export const codesWarn: [number, string][] = codesError.concat([
   // evaluator
   [c.ENGINE_VALUE_INVALID, c.LOG_PREFIX_ENGINE_VALUE + 'Value %s doesn\'t match with expected type.'],
-  [c.ENGINE_VALUE_NO_ATTRIBUTES, c.LOG_PREFIX_ENGINE_VALUE + 'Defined attribute [%s], no attributes received.'],
+  [c.ENGINE_VALUE_NO_ATTRIBUTES, c.LOG_PREFIX_ENGINE_VALUE + 'Defined attribute `%s`. No attributes received.'],
   // synchronizer
   [c.SYNC_MYSEGMENTS_FETCH_RETRY, c.LOG_PREFIX_SYNC_MYSEGMENTS + 'Retrying download of segments #%s. Reason: %s'],
   [c.SYNC_SPLITS_FETCH_FAILS, c.LOG_PREFIX_SYNC_SPLITS + 'Error while doing fetch of feature flags. %s'],

package/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}${filterQueryString || ''}${till ? '&till=' + till : ''}`;
       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/storages/inLocalStorage/SplitsCacheInLocal.ts

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

package/src/storages/pluggable/index.ts

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

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/Semver.ts

@@ -0,0 +1,111 @@
+import { isString } from '../utils/lang';
+
+const NUMERIC_IDENTIFIER_REGEX = /^[0-9]+$/;
+
+const METADATA_DELIMITER = '+';
+const PRERELEASE_DELIMITER = '-';
+const 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: string, b: string): number {
+  if (NUMERIC_IDENTIFIER_REGEX.test(a) && NUMERIC_IDENTIFIER_REGEX.test(b)) {
+    const 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: string): string {
+  return value.replace(/^0+(?=\d)/, '');
+}
+
+function throwError(version: string) {
+  throw new Error('Unable to convert to Semver, incorrect format: ' + version);
+}
+
+export class Semver {
+
+  private readonly _major: string;
+  private readonly _minor: string;
+  private readonly _patch: string;
+  private readonly _preRelease: string[];
+  private readonly _isStable: boolean;
+
+  // Version string for 'equal' and 'in list' comparisons
+  public readonly version: string;
+
+  public constructor(version: string) {
+    if (!isString(version)) throwError(version);
+
+    // Separate metadata if exists
+    let index = version.indexOf(METADATA_DELIMITER);
+    let [vWithoutMetadata, metadata] = index === -1 ? [version] : [version.slice(0, index), version.slice(index + 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((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
+    const vParts = vWithoutMetadata.split(VALUE_DELIMITER).map((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`
+   */
+  public compare(toCompare: Semver): number {
+    if (this.version === toCompare.version) return 0;
+
+    let 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 (let i = 0, length = Math.min(this._preRelease.length, toCompare._preRelease.length); i < length; i++) {
+      const result = compareStrings(this._preRelease[i], toCompare._preRelease[i]);
+      if (result !== 0) return result;
+    }
+
+    return this._preRelease.length - toCompare._preRelease.length;
+  }
+}

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/labels/index.ts

@@ -5,4 +5,4 @@ export const SDK_NOT_READY = 'not ready';
 export const EXCEPTION = 'exception';
 export const SPLIT_ARCHIVED = 'archived';
 export const NOT_IN_SPLIT = 'not in split';
-export const UNSUPPORTED_MATCHER_TYPE = 'unsupported matcher type';
+export const UNSUPPORTED_MATCHER_TYPE = 'targeting rule type unsupported by sdk';

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/src/utils/settingsValidation/logger/pluggableLogger.ts

@@ -4,7 +4,7 @@ import { LogLevel } from '../../../types';
 import { getLogLevel } from './commons';
 
 function isLogger(log: any): log is ILogger {
-  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.

package/types/dtos/types.d.ts

@@ -11,6 +11,10 @@ export interface IBetweenMatcherData {
     start: number;
     end: number;
 }
+export interface IBetweenStringMatcherData {
+    start: string;
+    end: string;
+}
 export interface IWhitelistMatcherData {
     whitelist: string[];
 }
@@ -35,6 +39,7 @@ interface ISplitMatcherBase {
     dependencyMatcherData?: null | IDependencyMatcherData;
     booleanMatcherData?: null | boolean;
     stringMatcherData?: null | string;
+    betweenStringMatcherData?: null | IBetweenStringMatcherData;
 }
 interface IAllKeysMatcher extends ISplitMatcherBase {
     matcherType: 'ALL_KEYS';
@@ -103,7 +108,27 @@ interface IMatchesStringMatcher extends ISplitMatcherBase {
     matcherType: 'MATCHES_STRING';
     stringMatcherData: string;
 }
-export declare type ISplitMatcher = IAllKeysMatcher | IInSegmentMatcher | IWhitelistMatcher | IEqualToMatcher | IGreaterThanOrEqualToMatcher | ILessThanOrEqualToMatcher | IBetweenMatcher | IEqualToSetMatcher | IContainsAnyOfSetMatcher | IContainsAllOfSetMatcher | IPartOfSetMatcher | IStartsWithMatcher | IEndsWithMatcher | IContainsStringMatcher | IInSplitTreatmentMatcher | IEqualToBooleanMatcher | IMatchesStringMatcher;
+interface IEqualToSemverMatcher extends ISplitMatcherBase {
+    matcherType: 'EQUAL_TO_SEMVER';
+    stringMatcherData: string;
+}
+interface IGreaterThanOrEqualToSemverMatcher extends ISplitMatcherBase {
+    matcherType: 'GREATER_THAN_OR_EQUAL_TO_SEMVER';
+    stringMatcherData: string;
+}
+interface ILessThanOrEqualToSemverMatcher extends ISplitMatcherBase {
+    matcherType: 'LESS_THAN_OR_EQUAL_TO_SEMVER';
+    stringMatcherData: string;
+}
+interface IBetweenSemverMatcher extends ISplitMatcherBase {
+    matcherType: 'BETWEEN_SEMVER';
+    betweenStringMatcherData: IBetweenStringMatcherData;
+}
+interface IInListSemverMatcher extends ISplitMatcherBase {
+    matcherType: 'IN_LIST_SEMVER';
+    whitelistMatcherData: IWhitelistMatcherData;
+}
+export declare type ISplitMatcher = IAllKeysMatcher | IInSegmentMatcher | IWhitelistMatcher | IEqualToMatcher | IGreaterThanOrEqualToMatcher | ILessThanOrEqualToMatcher | IBetweenMatcher | IEqualToSetMatcher | IContainsAnyOfSetMatcher | IContainsAllOfSetMatcher | IPartOfSetMatcher | IStartsWithMatcher | IEndsWithMatcher | IContainsStringMatcher | IInSplitTreatmentMatcher | IEqualToBooleanMatcher | IMatchesStringMatcher | IEqualToSemverMatcher | IGreaterThanOrEqualToSemverMatcher | ILessThanOrEqualToSemverMatcher | IBetweenSemverMatcher | IInListSemverMatcher;
 /** Split object */
 export interface ISplitPartition {
     treatment: string;

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

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

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

@@ -1,3 +1,2 @@
 import { IBetweenMatcherData } from '../../dtos/types';
-import { ILogger } from '../../logger/types';
-export declare function betweenMatcherContext(log: ILogger, ruleVO: IBetweenMatcherData): (runtimeAttr: number) => boolean;
+export declare function betweenMatcherContext(ruleVO: IBetweenMatcherData): (runtimeAttr: number) => boolean;

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

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

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

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

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

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

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

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

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

@@ -2,4 +2,4 @@ import { IDependencyMatcherData, MaybeThenable } from '../../dtos/types';
 import { IStorageAsync, IStorageSync } from '../../storages/types';
 import { ILogger } from '../../logger/types';
 import { IDependencyMatcherValue, ISplitEvaluator } from '../types';
-export declare function dependencyMatcherContext(log: ILogger, { split, treatments }: IDependencyMatcherData, storage: IStorageSync | IStorageAsync): ({ key, attributes }: IDependencyMatcherValue, splitEvaluator: ISplitEvaluator) => MaybeThenable<boolean>;
+export declare function dependencyMatcherContext({ split, treatments }: IDependencyMatcherData, storage: IStorageSync | IStorageAsync, log: ILogger): ({ key, attributes }: IDependencyMatcherValue, splitEvaluator: ISplitEvaluator) => MaybeThenable<boolean>;

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,6 +1,5 @@
 import { MaybeThenable } from '../../dtos/types';
 import { ISegmentsCacheBase } from '../../storages/types';
-import { ILogger } from '../../logger/types';
-export declare function segmentMatcherContext(log: ILogger, segmentName: string, storage: {
+export declare function segmentMatcherContext(segmentName: string, storage: {
     segments: ISegmentsCacheBase;
 }): (key: string) => MaybeThenable<boolean>;

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,2 @@
+import { IBetweenStringMatcherData } from '../../dtos/types';
+export declare function betweenSemverMatcherContext(ruleAttr: IBetweenStringMatcherData): (runtimeAttr: string) => boolean;

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

@@ -0,0 +1 @@
+export declare function equalToSemverMatcherContext(ruleAttr: string): (runtimeAttr: string) => boolean;

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

@@ -0,0 +1 @@
+export declare function greaterThanEqualToSemverMatcherContext(ruleAttr: string): (runtimeAttr: string) => boolean;

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

@@ -0,0 +1 @@
+export declare function inListSemverMatcherContext(ruleAttr: string[]): (runtimeAttr: string) => boolean;

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

@@ -0,0 +1 @@
+export declare function lessThanEqualToSemverMatcherContext(ruleAttr: string): (runtimeAttr: string) => boolean;

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

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

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

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

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

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

package/types/evaluator/matchersTransform/set.d.ts

@@ -1,5 +1,5 @@
-import { IWhitelistMatcherData } from '../../dtos/types';
+import { ISplitMatcher } from '../../dtos/types';
 /**
  * Extract whitelist array. Used by set and string matchers
  */
-export declare function setTransform(whitelistObject: IWhitelistMatcherData): string[];
+export declare function setTransform(whitelistObject: ISplitMatcher['whitelistMatcherData']): string[] | null | undefined;

package/types/evaluator/matchersTransform/string.d.ts

@@ -0,0 +1,7 @@
+import { ISplitMatcher } from '../../dtos/types';
+/**
+ * Extract value from string matcher data.
+ */
+export declare function stringTransform({ stringMatcherData }: ISplitMatcher): {
+    value: string | null | undefined;
+};

package/types/evaluator/matchersTransform/whitelist.d.ts

@@ -1,5 +1,5 @@
-import { IWhitelistMatcherData } from '../../dtos/types';
+import { ISplitMatcher } from '../../dtos/types';
 /**
- * Extract whitelist as a set. Used by 'WHITELIST' matcher.
+ * Extract whitelist array.
  */
-export declare function whitelistTransform(whitelistObject: IWhitelistMatcherData): import("../../utils/lang/sets").ISet<string>;
+export declare function whitelistTransform(whitelistObject: ISplitMatcher['whitelistMatcherData']): string[] | null | undefined;

package/types/evaluator/types.d.ts

@@ -1,6 +1,5 @@
-import { IBetweenMatcherData, IDependencyMatcherData, MaybeThenable } from '../dtos/types';
+import { IBetweenMatcherData, IBetweenStringMatcherData, IDependencyMatcherData, MaybeThenable } from '../dtos/types';
 import { IStorageAsync, IStorageSync } from '../storages/types';
-import { ISet } from '../utils/lang/sets';
 import { SplitIO } from '../types';
 import { ILogger } from '../logger/types';
 export interface IDependencyMatcherValue {
@@ -9,7 +8,8 @@ export interface IDependencyMatcherValue {
 }
 export interface IMatcherDto {
     type: number;
-    value?: string | number | boolean | string[] | IDependencyMatcherData | ISet<string> | IBetweenMatcherData | null;
+    name: string;
+    value?: string | number | boolean | string[] | IDependencyMatcherData | IBetweenMatcherData | IBetweenStringMatcherData | null;
     attribute: string | null;
     negate: boolean;
     dataType: string;

package/types/logger/constants.d.ts

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

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/labels/index.d.ts

@@ -5,4 +5,4 @@ export declare const SDK_NOT_READY = "not ready";
 export declare const EXCEPTION = "exception";
 export declare const SPLIT_ARCHIVED = "archived";
 export declare const NOT_IN_SPLIT = "not in split";
-export declare const UNSUPPORTED_MATCHER_TYPE = "unsupported matcher type";
+export declare const UNSUPPORTED_MATCHER_TYPE = "targeting rule type unsupported by sdk";

package/types/utils/semVer.d.ts

@@ -0,0 +1,15 @@
+export declare class Semver {
+    private readonly _major;
+    private readonly _minor;
+    private readonly _patch;
+    private readonly _preRelease;
+    private readonly _isStable;
+    readonly version: string;
+    constructor(version: string);
+    /**
+     * Precedence comparision between 2 Semver objects.
+     *
+     * @return `0` if `this === toCompare`, `-1` if `this < toCompare`, and `1` if `this > toCompare`
+     */
+    compare(toCompare: Semver): number;
+}

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;