@splitsoftware/splitio-commons 1.17.1-rc.3 → 2.0.0-rc.0

package/src/trackers/impressionsTracker.ts

@@ -19,7 +19,6 @@ export function impressionsTrackerFactory(
   settings: ISettings,
   impressionsCache: IImpressionsCacheBase,
   strategy: IStrategy,
-  whenInit: (cb: () => void) => void,
   integrationsManager?: IImpressionsHandler,
   telemetryCache?: ITelemetryCacheSync | ITelemetryCacheAsync,
 ): IImpressionsTracker {
@@ -68,18 +67,16 @@ export function impressionsTrackerFactory(
           };
 
           // Wrap in a timeout because we don't want it to be blocking.
-          whenInit(() => {
-            setTimeout(() => {
-              // integrationsManager.handleImpression does not throw errors
-              if (integrationsManager) integrationsManager.handleImpression(impressionData);
+          setTimeout(function () {
+            // integrationsManager.handleImpression does not throw errors
+            if (integrationsManager) integrationsManager.handleImpression(impressionData);
 
-              try { // @ts-ignore. An exception on the listeners should not break the SDK.
-                if (impressionListener) impressionListener.logImpression(impressionData);
-              } catch (err) {
-                log.error(ERROR_IMPRESSIONS_LISTENER, [err]);
-              }
-            });
-          });
+            try { // @ts-ignore. An exception on the listeners should not break the SDK.
+              if (impressionListener) impressionListener.logImpression(impressionData);
+            } catch (err) {
+              log.error(ERROR_IMPRESSIONS_LISTENER, [err]);
+            }
+          }, 0);
         }
       }
     }

package/src/trackers/types.ts

@@ -65,7 +65,6 @@ export interface IImpressionSenderAdapter {
 
 /** Unique keys tracker */
 export interface IUniqueKeysTracker {
-  start(): void;
   stop(): void;
   track(key: string, featureName: string): void;
 }

package/src/trackers/uniqueKeysTracker.ts

@@ -25,6 +25,10 @@ export function uniqueKeysTrackerFactory(
 ): IUniqueKeysTracker {
   let intervalId: any;
 
+  if (filterAdapter.refreshRate) {
+    intervalId = setInterval(filterAdapter.clear, filterAdapter.refreshRate);
+  }
+
   return {
 
     track(key: string, featureName: string): void {
@@ -35,12 +39,6 @@ export function uniqueKeysTrackerFactory(
       uniqueKeysCache.track(key, featureName);
     },
 
-    start(): void {
-      if (filterAdapter.refreshRate) {
-        intervalId = setInterval(filterAdapter.clear, filterAdapter.refreshRate);
-      }
-    },
-
     stop(): void {
       clearInterval(intervalId);
     }

package/src/types.ts

@@ -1,4 +1,4 @@
-import { ISplit, ISplitFiltersValidation } from './dtos/types';
+import { ISplitFiltersValidation } from './dtos/types';
 import { IIntegration, IIntegrationFactoryParams } from './integrations/types';
 import { ILogger } from './logger/types';
 import { ISdkFactoryContext } from './sdkFactory/types';
@@ -71,7 +71,6 @@ export interface ISettings {
   readonly core: {
     authorizationKey: string,
     key: SplitIO.SplitKey,
-    trafficType?: string,
     labelsEnabled: boolean,
     IPAddressesEnabled: boolean
   },
@@ -98,7 +97,6 @@ export interface ISettings {
     eventsFirstPushWindow: number
   },
   readonly storage: IStorageSyncFactory | IStorageAsyncFactory,
-  readonly preloadedData?: SplitIO.PreloadedData,
   readonly integrations: Array<{
     readonly type: string,
     (params: IIntegrationFactoryParams): IIntegration | void
@@ -772,20 +770,21 @@ export namespace SplitIO {
      * If this value is older than 10 days ago (expiration time policy), the data is not used to update the storage content.
      * @TODO configurable expiration time policy?
      */
-    // lastUpdated: number,
+    lastUpdated: number,
     /**
      * Change number of the preloaded data.
      * If this value is older than the current changeNumber at the storage, the data is not used to update the storage content.
      */
     since: number,
     /**
-     * List of feature flag definitions.
-     * @TODO rename to flags
+     * Map of feature flags to their stringified definitions.
      */
-    splitsData: ISplit[],
+    splitsData: {
+      [splitName: string]: string
+    },
     /**
      * Optional map of user keys to their list of segments.
-     * @TODO rename to memberships
+     * @TODO remove when releasing first version
      */
     mySegmentsData?: {
       [key: string]: string[]
@@ -793,10 +792,9 @@ export namespace SplitIO {
     /**
      * Optional map of segments to their stringified definitions.
      * This property is ignored if `mySegmentsData` was provided.
-     * @TODO rename to segments
      */
     segmentsData?: {
-      [segmentName: string]: string[]
+      [segmentName: string]: string
     },
   }
   /**
@@ -924,12 +922,6 @@ export namespace SplitIO {
        * @property {SplitKey} key
        */
       key: SplitKey,
-      /**
-       * Traffic type associated with the customer identifier. @see {@link https://help.split.io/hc/en-us/articles/360019916311-Traffic-type}
-       * If no provided as a setting it will be required on the client.track() calls.
-       * @property {string} trafficType
-       */
-      trafficType?: string,
       /**
        * Disable labels from being sent to Split backend. Labels may contain sensitive information.
        * @property {boolean} labelsEnabled
@@ -1038,10 +1030,9 @@ export namespace SplitIO {
      * Returns a shared client of the SDK, with the given key and optional traffic type.
      * @function client
      * @param {SplitKey} key The key for the new client instance.
-     * @param {string=} trafficType The traffic type of the provided key.
      * @returns {ICsClient} The client instance.
      */
-    client(key: SplitKey, trafficType?: string): ICsClient,
+    client(key: SplitKey): ICsClient,
     /**
      * Returns a manager instance of the SDK to explore available information.
      * @function manager

package/src/utils/LRUCache/index.ts

@@ -1,14 +1,13 @@
-import { IMap, _Map } from '../lang/maps';
 import { LinkedList, Node } from './LinkedList';
 
 export class LRUCache<K, V> {
   maxLen: number;
-  items: IMap<K, Node<{ key: K, value: V }>>;
+  items: Map<K, Node<{ key: K, value: V }>>;
   lru: LinkedList<{ key: K, value: V }>;
 
   constructor(maxSize?: number) {
     this.maxLen = maxSize || 1;
-    this.items = new _Map();
+    this.items = new Map();
     this.lru = new LinkedList();
   }
 

package/src/utils/constants/browser.ts

@@ -1,6 +1,2 @@
-// Integration types
-export const GOOGLE_ANALYTICS_TO_SPLIT = 'GOOGLE_ANALYTICS_TO_SPLIT';
-export const SPLIT_TO_GOOGLE_ANALYTICS = 'SPLIT_TO_GOOGLE_ANALYTICS';
-
 // This value might be eventually set via a config parameter
 export const DEFAULT_CACHE_EXPIRATION_IN_MILLIS = 864000000; // 10 days

package/src/utils/lang/index.ts

@@ -122,10 +122,9 @@ export function isBoolean(val: any): boolean {
  */
 export function isFiniteNumber(val: any): boolean {
   if (val instanceof Number) val = val.valueOf();
-  // @TODO remove `isFinite` once `Number.isFinite` is fully supported by targets
-  // eslint-disable-next-line compat/compat
-  if (typeof val === 'number') return Number.isFinite ? Number.isFinite(val) : isFinite(val);
-  return false;
+  return typeof val === 'number' ?
+    Number.isFinite ? Number.isFinite(val) : isFinite(val) :
+    false;
 }
 
 /**
@@ -134,9 +133,9 @@ export function isFiniteNumber(val: any): boolean {
  */
 export function isIntegerNumber(val: any): boolean {
   if (val instanceof Number) val = val.valueOf();
-  // eslint-disable-next-line compat/compat
-  if (typeof val === 'number') return Number.isInteger ? Number.isInteger(val) : isFinite(val) && Math.floor(val) === val;
-  return false;
+  return typeof val === 'number' ?
+    Number.isInteger ? Number.isInteger(val) : isFinite(val) && Math.floor(val) === val :
+    false;
 }
 
 /**

package/src/utils/lang/objectAssign.ts

@@ -1,71 +1,6 @@
-/*
-Adaptation of "object-assign" library (https://www.npmjs.com/package/object-assign)
-exported as an ES module instead of CommonJS, to avoid extra configuration steps when using
-the ESM build of the SDK with tools that doesn't support CommonJS by default (e.g. Rollup).
-
-object-assign
-(c) Sindre Sorhus
-@license MIT
-*/
-
-/* eslint-disable */
-// @ts-nocheck
-
-var getOwnPropertySymbols = Object.getOwnPropertySymbols;
-var hasOwnProperty = Object.prototype.hasOwnProperty;
-var propIsEnumerable = Object.prototype.propertyIsEnumerable;
-
-function toObject(val) {
-  if (val === null || val === undefined) {
-    throw new TypeError('Object.assign cannot be called with null or undefined');
-  }
-
-  return Object(val);
-}
-
-function shouldUseNative() {
-  try {
-    if (!Object.assign) {
-      return false;
-    }
-
-    // Detect buggy property enumeration order in older V8 versions.
-
-    // https://bugs.chromium.org/p/v8/issues/detail?id=4118
-    var test1 = new String('abc');
-    test1[5] = 'de';
-    if (Object.getOwnPropertyNames(test1)[0] === '5') {
-      return false;
-    }
-
-    // https://bugs.chromium.org/p/v8/issues/detail?id=3056
-    var test2 = {};
-    for (var i = 0; i < 10; i++) {
-      test2['_' + String.fromCharCode(i)] = i;
-    }
-    var order2 = Object.getOwnPropertyNames(test2).map(function (n) {
-      return test2[n];
-    });
-    if (order2.join('') !== '0123456789') {
-      return false;
-    }
-
-    // https://bugs.chromium.org/p/v8/issues/detail?id=3056
-    var test3 = {};
-    'abcdefghijklmnopqrst'.split('').forEach(function (letter) {
-      test3[letter] = letter;
-    });
-    if (Object.keys(Object.assign({}, test3)).join('') !==
-      'abcdefghijklmnopqrst') {
-      return false;
-    }
-
-    return true;
-  } catch (err) {
-    // We don't expect any of the above to throw, but better to be safe.
-    return false;
-  }
-}
+/**
+ * A tiny polyfill for Object.assign
+ */
 
 // https://www.npmjs.com/package/@types/object-assign
 type ObjectAssign = (<T, U>(target: T, source: U) => T & U) &
@@ -74,31 +9,17 @@ type ObjectAssign = (<T, U>(target: T, source: U) => T & U) &
   (<T, U, V, W, Q>(target: T, source1: U, source2: V, source3: W, source4: Q) => T & U & V & W & Q) &
   (<T, U, V, W, Q, R>(target: T, source1: U, source2: V, source3: W, source4: Q, source5: R) => T & U & V & W & Q & R) &
   ((target: any, ...sources: any[]) => any);
-
-export const objectAssign: ObjectAssign = shouldUseNative() ? Object.assign : function (target, source) {
-  var from;
-  var to = toObject(target);
-  var symbols;
-
-  for (var s = 1; s < arguments.length; s++) {
-    from = Object(arguments[s]);
-
-    // eslint-disable-next-line no-restricted-syntax
-    for (var key in from) {
-      if (hasOwnProperty.call(from, key)) {
-        to[key] = from[key];
-      }
-    }
-
-    if (getOwnPropertySymbols) {
-      symbols = getOwnPropertySymbols(from);
-      for (var i = 0; i < symbols.length; i++) {
-        if (propIsEnumerable.call(from, symbols[i])) {
-          to[symbols[i]] = from[symbols[i]];
-        }
+export const objectAssign: ObjectAssign = Object.assign || function (target: any) {
+  if (target === null || target === undefined) throw new TypeError('Object.assign cannot be called with null or undefined');
+  target = Object(target);
+
+  for (let i = 1; i < arguments.length; i++) {
+    const source = Object(arguments[i]); // eslint-disable-next-line no-restricted-syntax
+    for (const key in source) {
+      if (Object.prototype.hasOwnProperty.call(source, key)) {
+        target[key] = source[key];
       }
     }
   }
-
-  return to;
+  return target;
 };

package/src/utils/lang/sets.ts

@@ -1,129 +1,7 @@
-/**
- * Set implementation based on es6-set polyfill (https://github.com/medikoo/es6-set/blob/master/polyfill.js),
- * with the minimal features used by the SDK.
-
-Copyright (C) 2013 Mariusz Nowak (www.medikoo.com)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
-**/
-
-export interface ISet<T> {
-  add(value: T): this;
-  clear(): void;
-  delete(value: T): boolean;
-  forEach(callbackfn: (value: T, value2: T, set: ISet<T>) => void, thisArg?: any): void;
-  has(value: T): boolean;
-  readonly size: number;
-}
-
-export class SetPoly<T> implements ISet<T>{
-  __setData__: T[] = [];
-
-  // unlike ES6 `Set`, it only accepts an array as first argument iterable
-  constructor(values?: readonly T[] | null) {
-    if (Array.isArray(values)) values.forEach(value => { this.add(value); });
-  }
-
-  clear() {
-    if (!this.__setData__.length) return;
-    this.__setData__.length = 0;
-  }
-
-  add(value: T) {
-    if (this.has(value)) return this;
-    this.__setData__.push(value);
-    return this;
-  }
-
-  delete(value: T) {
-    let index = this.__setData__.indexOf(value);
-    if (index === -1) return false;
-    this.__setData__.splice(index, 1);
-    return true;
-  }
-
-  has(value: T) {
-    return this.__setData__.indexOf(value) !== -1;
-  }
-
-  forEach(callbackfn: (value: T, value2: T, set: SetPoly<T>) => void, thisArg?: any): void {
-    if (typeof callbackfn !== 'function') throw new TypeError(callbackfn + ' is not a function');
-
-    for (let i = 0; i < this.__setData__.length; i++) {
-      const value = this.__setData__[i];
-      callbackfn.call(thisArg, value, value, this);
-    }
-  }
-
-  get size() {
-    return this.__setData__.length;
-  }
-
-}
-
-
-/**
- * return an array containing the items of the given set.
- * @param set Set or SetPoly instance
- */
-export function setToArray<T>(set: ISet<T>): T[] {
-  if (set instanceof SetPoly) {
-    return set.__setData__.slice();
-  }
-  // if not using SetPoly as set, it means Array.from is supported
-  // eslint-disable-next-line compat/compat
-  return Array.from(set as Set<T>);
-}
-
-interface ISetConstructor {
-  new <T = any>(values?: readonly T[] | null): ISet<T>;
-  readonly prototype: ISet<any>;
-}
-
-/**
- * return the Set constructor to use. If `Array.from` built-in or native Set is not available or it doesn't support the required features,
- * a ponyfill with minimal features is returned instead.
- *
- * Exported for testing purposes only.
- */
-export function __getSetConstructor(): ISetConstructor {
-  // eslint-disable-next-line compat/compat
-  if (typeof Array.from === 'function' && typeof Set === 'function' && Set.prototype && Set.prototype.values) {
-    return Set;
-  }
-  return SetPoly;
-}
-
-export const _Set = __getSetConstructor();
-
-export function returnSetsUnion<T>(set: ISet<T>, set2: ISet<T>): ISet<T> {
-  const result = new _Set(setToArray(set));
-  set2.forEach(value => {
-    result.add(value);
-  });
-  return result;
+export function returnSetsUnion<T>(set: Set<T>, set2: Set<T>): Set<T> {
+  return new Set(Array.from(set).concat(Array.from(set2)));
 }
 
 export function returnDifference<T>(list: T[] = [], list2: T[] = []): T[] {
-  const result = new _Set(list);
-  list2.forEach(item => {
-    result.delete(item);
-  });
-  return setToArray(result);
+  return list.filter(item => list2.indexOf(item) === -1);
 }

package/src/utils/settingsValidation/index.ts

@@ -6,7 +6,6 @@ import { validImpressionsMode } from './impressionsMode';
 import { ISettingsValidationParams } from './types';
 import { ISettings } from '../../types';
 import { validateKey } from '../inputValidation/key';
-import { validateTrafficType } from '../inputValidation/trafficType';
 import { ERROR_MIN_CONFIG_PARAM, LOG_PREFIX_CLIENT_INSTANTIATION } from '../../logger/constants';
 
 // Exported for telemetry
@@ -19,8 +18,6 @@ export const base = {
     authorizationKey: undefined,
     // key used in your system (only required for browser version)
     key: undefined,
-    // traffic type for the given key (only used on browser version)
-    trafficType: undefined,
     // toggle impressions tracking of labels
     labelsEnabled: true,
     // toggle sendind (true) or not sending (false) IP and Host Name with impressions, events, and telemetries requests (only used on nodejs version)
@@ -168,13 +165,6 @@ export function settingsValidation(config: unknown, validationParams: ISettingsV
       // @ts-ignore, @TODO handle invalid keys as a non-recoverable error?
       withDefaults.core.key = validateKey(log, maybeKey, LOG_PREFIX_CLIENT_INSTANTIATION);
     }
-
-    if (validationParams.acceptTT) {
-      const maybeTT = withDefaults.core.trafficType;
-      if (maybeTT !== undefined) { // @ts-ignore
-        withDefaults.core.trafficType = validateTrafficType(log, maybeTT, LOG_PREFIX_CLIENT_INSTANTIATION);
-      }
-    }
   } else {
     // On server-side, key is undefined and used to distinguish from client-side
     if (maybeKey !== undefined) log.warn('Provided `key` is ignored in server-side SDK.'); // @ts-ignore

package/src/utils/settingsValidation/logger/builtinLogger.ts

@@ -3,11 +3,10 @@ import { ILogger } from '../../../logger/types';
 import { isLocalStorageAvailable } from '../../env/isLocalStorageAvailable';
 import { isNode } from '../../env/isNode';
 import { codesDebug } from '../../../logger/messages/debug';
-import { _Map } from '../../lang/maps';
 import { getLogLevel } from './commons';
 import { LogLevel } from '../../../types';
 
-const allCodes = new _Map(codesDebug);
+const allCodes = new Map(codesDebug);
 
 // @TODO set default debug setting instead of initialLogLevel when integrating in JS and Node packages
 const LS_KEY = 'splitio_debug';

package/src/utils/settingsValidation/storage/storageCS.ts

@@ -3,6 +3,14 @@ import { ISettings, SDKMode } from '../../../types';
 import { ILogger } from '../../../logger/types';
 import { ERROR_STORAGE_INVALID } from '../../../logger/constants';
 import { LOCALHOST_MODE, STANDALONE_MODE, STORAGE_PLUGGABLE, STORAGE_LOCALSTORAGE, STORAGE_MEMORY } from '../../../utils/constants';
+import { IStorageFactoryParams, IStorageSync } from '../../../storages/types';
+
+export function __InLocalStorageMockFactory(params: IStorageFactoryParams): IStorageSync {
+  const result = InMemoryStorageCSFactory(params);
+  result.splits.checkCache = () => true; // to emit SDK_READY_FROM_CACHE
+  return result;
+}
+__InLocalStorageMockFactory.type = STORAGE_MEMORY;
 
 /**
  * This function validates `settings.storage` object
@@ -22,6 +30,11 @@ export function validateStorageCS(settings: { log: ILogger, storage?: any, mode:
     log.error(ERROR_STORAGE_INVALID);
   }
 
+  // In localhost mode with InLocalStorage, fallback to a mock InLocalStorage to emit SDK_READY_FROM_CACHE
+  if (mode === LOCALHOST_MODE && storage.type === STORAGE_LOCALSTORAGE) {
+    return __InLocalStorageMockFactory;
+  }
+
   if ([LOCALHOST_MODE, STANDALONE_MODE].indexOf(mode) === -1) {
     // Consumer modes require an async storage
     if (storage.type !== STORAGE_PLUGGABLE) throw new Error('A PluggableStorage instance is required on consumer mode');

package/src/utils/settingsValidation/types.ts

@@ -12,8 +12,6 @@ export interface ISettingsValidationParams {
   defaults: Partial<ISettings> & { version: string } & { startup: ISettings['startup'] },
   /** If true, validates core.key */
   acceptKey?: boolean,
-  /** If true, validates core.trafficType */
-  acceptTT?: boolean,
   /** Define runtime values (`settings.runtime`) */
   runtime: (settings: ISettings) => ISettings['runtime'],
   /** Storage validator (`settings.storage`) */

package/types/logger/index.d.ts

@@ -1,6 +1,5 @@
 import { ILoggerOptions, ILogger } from './types';
 import { LogLevel } from '../types';
-import { IMap } from '../utils/lang/maps';
 export declare const LogLevels: {
     [level: string]: LogLevel;
 };
@@ -10,7 +9,7 @@ export declare class Logger implements ILogger {
     private options;
     private codes;
     private logLevel;
-    constructor(options?: ILoggerOptions, codes?: IMap<number, string>);
+    constructor(options?: ILoggerOptions, codes?: Map<number, string>);
     setLogLevel(logLevel: LogLevel): void;
     debug(msg: string | number, args?: any[]): void;
     info(msg: string | number, args?: any[]): void;

package/types/readiness/types.d.ts

@@ -46,7 +46,6 @@ export interface IReadinessManager {
     timeout(): void;
     setDestroyed(): void;
     destroy(): void;
-    init(): void;
     /** for client-side */
     shared(): IReadinessManager;
 }

package/types/sdkClient/clientCS.d.ts

@@ -1,10 +1,9 @@
 import { ILogger } from '../logger/types';
 import { SplitIO } from '../types';
 /**
- * Decorator that binds a key and (optionally) a traffic type to client methods
+ * Decorator that binds a key to client methods
  *
  * @param client sync client instance
  * @param key validated split key
- * @param trafficType validated traffic type
  */
-export declare function clientCSDecorator(log: ILogger, client: SplitIO.IClient, key: SplitIO.SplitKey, trafficType?: string): SplitIO.ICsClient;
+export declare function clientCSDecorator(log: ILogger, client: SplitIO.IClient, key: SplitIO.SplitKey): SplitIO.ICsClient;

package/types/sdkFactory/types.d.ts

@@ -48,7 +48,6 @@ export interface ISdkFactoryContext {
     splitApi?: ISplitApi;
     syncManager?: ISyncManager;
     clients: Record<string, IBasicClient>;
-    whenInit(cb: () => void): void;
 }
 export interface ISdkFactoryContextSync extends ISdkFactoryContext {
     storage: IStorageSync;
@@ -64,7 +63,6 @@ export interface ISdkFactoryContextAsync extends ISdkFactoryContext {
  * Object parameter with the modules required to create an SDK factory instance
  */
 export interface ISdkFactoryParams {
-    isPure?: boolean;
     settings: ISettings;
     platform: IPlatform;
     storageFactory: (params: IStorageFactoryParams) => IStorageSync | IStorageAsync;
@@ -73,7 +71,7 @@ export interface ISdkFactoryParams {
     sdkManagerFactory: typeof sdkManagerFactory;
     sdkClientMethodFactory: (params: ISdkFactoryContext) => ({
         (): SplitIO.ICsClient;
-        (key: SplitIO.SplitKey, trafficType?: string | undefined): SplitIO.ICsClient;
+        (key: SplitIO.SplitKey): SplitIO.ICsClient;
     } | (() => SplitIO.IClient) | (() => SplitIO.IAsyncClient));
     impressionsObserverFactory: () => IImpressionObserver;
     filterAdapterFactory?: () => IFilterAdapter;

package/types/storages/AbstractSplitsCacheAsync.d.ts

@@ -1,6 +1,5 @@
 import { ISplitsCacheAsync } from './types';
 import { ISplit } from '../dtos/types';
-import { ISet } from '../utils/lang/sets';
 /**
  * This class provides a skeletal implementation of the ISplitsCacheAsync interface
  * to minimize the effort required to implement this interface.
@@ -15,10 +14,15 @@ export declare abstract class AbstractSplitsCacheAsync implements ISplitsCacheAs
     abstract getChangeNumber(): Promise<number>;
     abstract getAll(): Promise<ISplit[]>;
     abstract getSplitNames(): Promise<string[]>;
-    abstract getNamesByFlagSets(flagSets: string[]): Promise<ISet<string>[]>;
+    abstract getNamesByFlagSets(flagSets: string[]): Promise<Set<string>[]>;
     abstract trafficTypeExists(trafficType: string): Promise<boolean>;
     abstract clear(): Promise<boolean | void>;
     usesSegments(): Promise<boolean>;
+    /**
+     * Check if the splits information is already stored in cache.
+     * Noop, just keeping the interface. This is used by client-side implementations only.
+     */
+    checkCache(): Promise<boolean>;
     /**
      * Kill `name` split and set `defaultTreatment` and `changeNumber`.
      * Used for SPLIT_KILL push notifications.

package/types/storages/AbstractSplitsCacheSync.d.ts

@@ -1,6 +1,5 @@
 import { ISplitsCacheSync } from './types';
 import { ISplit } from '../dtos/types';
-import { ISet } from '../utils/lang/sets';
 /**
  * This class provides a skeletal implementation of the ISplitsCacheSync interface
  * to minimize the effort required to implement this interface.
@@ -19,6 +18,11 @@ export declare abstract class AbstractSplitsCacheSync implements ISplitsCacheSyn
     abstract trafficTypeExists(trafficType: string): boolean;
     abstract usesSegments(): boolean;
     abstract clear(): void;
+    /**
+     * Check if the splits information is already stored in cache. This data can be preloaded.
+     * It is used as condition to emit SDK_SPLITS_CACHE_LOADED, and then SDK_READY_FROM_CACHE.
+     */
+    checkCache(): boolean;
     /**
      * Kill `name` split and set `defaultTreatment` and `changeNumber`.
      * Used for SPLIT_KILL push notifications.
@@ -30,7 +34,7 @@ export declare abstract class AbstractSplitsCacheSync implements ISplitsCacheSyn
      * for instance, if the `changeNumber` is old, or if the split is not found (e.g., `/splitchanges` hasn't been fetched yet), or if the storage fails to apply the update.
      */
     killLocally(name: string, defaultTreatment: string, changeNumber: number): boolean;
-    abstract getNamesByFlagSets(flagSets: string[]): ISet<string>[];
+    abstract getNamesByFlagSets(flagSets: string[]): Set<string>[];
 }
 /**
  * Given a parsed split, it returns a boolean flagging if its conditions use segments matchers (rules & whitelists).