@splitsoftware/splitio-commons 1.0.1-rc.1 → 1.0.1-rc.5

package/cjs/evaluator/index.js

@@ -5,7 +5,6 @@ var tslib_1 = require("tslib");
 var Engine_1 = tslib_1.__importDefault(require("./Engine"));
 var thenable_1 = tslib_1.__importDefault(require("../utils/promise/thenable"));
 var LabelsConstants = tslib_1.__importStar(require("../utils/labels"));
-var lang_1 = require("../utils/lang");
 var constants_1 = require("../utils/constants");
 var treatmentException = {
     treatment: constants_1.CONTROL,
@@ -66,17 +65,17 @@ function getEvaluation(log, stringifiedSplit, key, attributes, storage) {
         var splitJSON_1 = JSON.parse(stringifiedSplit);
         var split_1 = Engine_1.default.parse(log, splitJSON_1, storage);
         evaluation = split_1.getTreatment(key, attributes, evaluateFeature);
-        // If the storage is async, evaluation and changeNumber will return a thenable
+        // If the storage is async and the evaluated split uses segment, evaluation is thenable
         if (thenable_1.default(evaluation)) {
             return evaluation.then(function (result) {
                 result.changeNumber = split_1.getChangeNumber();
-                result.config = lang_1.get(splitJSON_1, "configurations." + result.treatment, null);
+                result.config = splitJSON_1.configurations && splitJSON_1.configurations[result.treatment] || null;
                 return result;
             });
         }
         else {
             evaluation.changeNumber = split_1.getChangeNumber(); // Always sync and optional
-            evaluation.config = lang_1.get(splitJSON_1, "configurations." + evaluation.treatment, null);
+            evaluation.config = splitJSON_1.configurations && splitJSON_1.configurations[evaluation.treatment] || null;
         }
     }
     return evaluation;

package/cjs/logger/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOG_PREFIX_CLEANUP = exports.LOG_PREFIX_EVENTS_TRACKER = exports.LOG_PREFIX_IMPRESSIONS_TRACKER = exports.LOG_PREFIX_SYNC_SUBMITTERS = exports.LOG_PREFIX_SYNC_POLLING = exports.LOG_PREFIX_SYNC_MYSEGMENTS = exports.LOG_PREFIX_SYNC_SEGMENTS = exports.LOG_PREFIX_SYNC_SPLITS = exports.LOG_PREFIX_SYNC_STREAMING = exports.LOG_PREFIX_SYNC_OFFLINE = exports.LOG_PREFIX_SYNC_MANAGER = exports.LOG_PREFIX_SYNC = exports.LOG_PREFIX_ENGINE_VALUE = exports.LOG_PREFIX_ENGINE_MATCHER = exports.LOG_PREFIX_ENGINE_COMBINER = exports.LOG_PREFIX_ENGINE = exports.LOG_PREFIX_INSTANTIATION = exports.LOG_PREFIX_SETTINGS = exports.ERROR_LOCALHOST_MODULE_REQUIRED = exports.ERROR_HTTP = exports.ERROR_INVALID_IMPRESSIONS_MODE = exports.ERROR_EMPTY_ARRAY = exports.ERROR_EMPTY = exports.ERROR_INVALID = exports.ERROR_INVALID_KEY_OBJECT = exports.ERROR_TOO_LONG = exports.ERROR_NULL = exports.ERROR_CLIENT_DESTROYED = exports.ERROR_NOT_FINITE = exports.ERROR_SIZE_EXCEEDED = exports.ERROR_NOT_PLAIN_OBJECT = exports.ERROR_EVENT_TYPE_FORMAT = exports.ERROR_EVENTS_TRACKER = exports.ERROR_IMPRESSIONS_LISTENER = exports.ERROR_IMPRESSIONS_TRACKER = exports.ERROR_STREAMING_AUTH = exports.ERROR_STREAMING_SSE = exports.ERROR_SYNC_OFFLINE_LOADING = exports.ERROR_CLIENT_CANNOT_GET_READY = exports.ERROR_CLIENT_LISTENER = exports.ERROR_LOGLEVEL_INVALID = exports.ERROR_ENGINE_COMBINER_IFELSEIF = exports.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2 = exports.WARN_API_KEY = exports.WARN_STORAGE_INVALID = exports.WARN_SPLITS_FILTER_EMPTY = exports.WARN_SPLITS_FILTER_INVALID = exports.WARN_SPLITS_FILTER_IGNORED = exports.WARN_INTEGRATION_INVALID = exports.WARN_NOT_EXISTENT_TT = exports.WARN_LOWERCASE_TRAFFIC_TYPE = exports.WARN_NOT_EXISTENT_SPLIT = exports.WARN_TRIMMING = exports.WARN_CONVERTING = exports.WARN_TRIMMING_PROPERTIES = exports.WARN_SETTING_NULL = exports.SUBMITTERS_PUSH_RETRY = exports.SUBMITTERS_PUSH_FAILS = exports.STREAMING_FALLBACK = exports.STREAMING_PARSING_MESSAGE_FAILS = exports.STREAMING_PARSING_ERROR_FAILS = exports.SYNC_SPLITS_FETCH_FAILS = exports.SYNC_MYSEGMENTS_FETCH_RETRY = exports.CLIENT_NOT_READY = exports.CLIENT_NO_LISTENER = exports.ENGINE_VALUE_NO_ATTRIBUTES = exports.ENGINE_VALUE_INVALID = exports.IMPRESSIONS_TRACKER_SUCCESS = exports.EVENTS_TRACKER_SUCCESS = exports.SYNC_STOP_POLLING = exports.SYNC_CONTINUE_POLLING = exports.SYNC_START_POLLING = exports.SUBMITTERS_PUSH = exports.SUBMITTERS_PUSH_FULL_EVENTS_QUEUE = exports.STREAMING_DISCONNECTING = exports.STREAMING_DISABLED = exports.STREAMING_CONNECTING = exports.STREAMING_RECONNECT = exports.STREAMING_REFRESH_TOKEN = exports.SYNC_SPLITS_FETCH_RETRY = exports.POLLING_STOP = exports.POLLING_START = exports.POLLING_SMART_PAUSING = exports.NEW_FACTORY = exports.NEW_SHARED_CLIENT = exports.IMPRESSION_QUEUEING = exports.IMPRESSION = exports.CLIENT_READY = exports.CLIENT_READY_FROM_CACHE = exports.SETTINGS_SPLITS_FILTER = exports.SYNC_TASK_STOP = exports.SYNC_TASK_EXECUTE = exports.SYNC_TASK_START = exports.STREAMING_NEW_MESSAGE = exports.SYNC_SPLITS_SEGMENTS = exports.SYNC_SPLITS_REMOVED = exports.SYNC_SPLITS_NEW = exports.SYNC_SPLITS_FETCH = exports.SYNC_OFFLINE_DATA = exports.RETRIEVE_MANAGER = exports.RETRIEVE_CLIENT_EXISTING = exports.RETRIEVE_CLIENT_DEFAULT = exports.CLEANUP_DEREGISTERING = exports.CLEANUP_REGISTERING = exports.ENGINE_SANITIZE = exports.ENGINE_VALUE = exports.ENGINE_MATCHER_WHITELIST = exports.ENGINE_MATCHER_STARTS_WITH = exports.ENGINE_MATCHER_STRING_INVALID = exports.ENGINE_MATCHER_STRING = exports.ENGINE_MATCHER_SEGMENT = exports.ENGINE_MATCHER_PART_OF = exports.ENGINE_MATCHER_LESS = exports.ENGINE_MATCHER_GREATER = exports.ENGINE_MATCHER_ENDS_WITH = exports.ENGINE_MATCHER_EQUAL_TO_SET = exports.ENGINE_MATCHER_EQUAL = exports.ENGINE_MATCHER_DEPENDENCY_PRE = exports.ENGINE_MATCHER_DEPENDENCY = exports.ENGINE_MATCHER_CONTAINS_STRING = exports.ENGINE_MATCHER_CONTAINS_ANY = exports.ENGINE_MATCHER_CONTAINS_ALL = exports.ENGINE_MATCHER_BOOLEAN = exports.ENGINE_MATCHER_BETWEEN = exports.ENGINE_MATCHER_ALL = exports.ENGINE_BUCKET = exports.ENGINE_COMBINER_IFELSEIF_NO_TREATMENT = exports.ENGINE_COMBINER_IFELSEIF = exports.ENGINE_COMBINER_AND = void 0;
+exports.LOG_PREFIX_CLEANUP = exports.LOG_PREFIX_EVENTS_TRACKER = exports.LOG_PREFIX_IMPRESSIONS_TRACKER = exports.LOG_PREFIX_SYNC_SUBMITTERS = exports.LOG_PREFIX_SYNC_POLLING = exports.LOG_PREFIX_SYNC_MYSEGMENTS = exports.LOG_PREFIX_SYNC_SEGMENTS = exports.LOG_PREFIX_SYNC_SPLITS = exports.LOG_PREFIX_SYNC_STREAMING = exports.LOG_PREFIX_SYNC_OFFLINE = exports.LOG_PREFIX_SYNC_MANAGER = exports.LOG_PREFIX_SYNC = exports.LOG_PREFIX_ENGINE_VALUE = exports.LOG_PREFIX_ENGINE_MATCHER = exports.LOG_PREFIX_ENGINE_COMBINER = exports.LOG_PREFIX_ENGINE = exports.LOG_PREFIX_INSTANTIATION = exports.LOG_PREFIX_SETTINGS = exports.ERROR_STORAGE_INVALID = exports.ERROR_LOCALHOST_MODULE_REQUIRED = exports.ERROR_HTTP = exports.ERROR_INVALID_IMPRESSIONS_MODE = exports.ERROR_EMPTY_ARRAY = exports.ERROR_EMPTY = exports.ERROR_INVALID = exports.ERROR_INVALID_KEY_OBJECT = exports.ERROR_TOO_LONG = exports.ERROR_NULL = exports.ERROR_CLIENT_DESTROYED = exports.ERROR_NOT_FINITE = exports.ERROR_SIZE_EXCEEDED = exports.ERROR_NOT_PLAIN_OBJECT = exports.ERROR_EVENT_TYPE_FORMAT = exports.ERROR_EVENTS_TRACKER = exports.ERROR_IMPRESSIONS_LISTENER = exports.ERROR_IMPRESSIONS_TRACKER = exports.ERROR_STREAMING_AUTH = exports.ERROR_STREAMING_SSE = exports.ERROR_SYNC_OFFLINE_LOADING = exports.ERROR_CLIENT_CANNOT_GET_READY = exports.ERROR_CLIENT_LISTENER = exports.ERROR_LOGLEVEL_INVALID = exports.ERROR_ENGINE_COMBINER_IFELSEIF = exports.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2 = exports.WARN_API_KEY = exports.WARN_SPLITS_FILTER_EMPTY = exports.WARN_SPLITS_FILTER_INVALID = exports.WARN_SPLITS_FILTER_IGNORED = exports.WARN_INTEGRATION_INVALID = exports.WARN_NOT_EXISTENT_TT = exports.WARN_LOWERCASE_TRAFFIC_TYPE = exports.WARN_NOT_EXISTENT_SPLIT = exports.WARN_TRIMMING = exports.WARN_CONVERTING = exports.WARN_TRIMMING_PROPERTIES = exports.WARN_SETTING_NULL = exports.SUBMITTERS_PUSH_RETRY = exports.SUBMITTERS_PUSH_FAILS = exports.STREAMING_FALLBACK = exports.STREAMING_PARSING_MESSAGE_FAILS = exports.STREAMING_PARSING_ERROR_FAILS = exports.SYNC_SPLITS_FETCH_FAILS = exports.SYNC_MYSEGMENTS_FETCH_RETRY = exports.CLIENT_NOT_READY = exports.CLIENT_NO_LISTENER = exports.ENGINE_VALUE_NO_ATTRIBUTES = exports.ENGINE_VALUE_INVALID = exports.IMPRESSIONS_TRACKER_SUCCESS = exports.EVENTS_TRACKER_SUCCESS = exports.SYNC_STOP_POLLING = exports.SYNC_CONTINUE_POLLING = exports.SYNC_START_POLLING = exports.SUBMITTERS_PUSH = exports.SUBMITTERS_PUSH_FULL_EVENTS_QUEUE = exports.STREAMING_DISCONNECTING = exports.STREAMING_DISABLED = exports.STREAMING_CONNECTING = exports.STREAMING_RECONNECT = exports.STREAMING_REFRESH_TOKEN = exports.SYNC_SPLITS_FETCH_RETRY = exports.POLLING_STOP = exports.POLLING_START = exports.POLLING_SMART_PAUSING = exports.NEW_FACTORY = exports.NEW_SHARED_CLIENT = exports.IMPRESSION_QUEUEING = exports.IMPRESSION = exports.CLIENT_READY = exports.CLIENT_READY_FROM_CACHE = exports.SETTINGS_SPLITS_FILTER = exports.SYNC_TASK_STOP = exports.SYNC_TASK_EXECUTE = exports.SYNC_TASK_START = exports.STREAMING_NEW_MESSAGE = exports.SYNC_SPLITS_SEGMENTS = exports.SYNC_SPLITS_REMOVED = exports.SYNC_SPLITS_NEW = exports.SYNC_SPLITS_FETCH = exports.SYNC_OFFLINE_DATA = exports.RETRIEVE_MANAGER = exports.RETRIEVE_CLIENT_EXISTING = exports.RETRIEVE_CLIENT_DEFAULT = exports.CLEANUP_DEREGISTERING = exports.CLEANUP_REGISTERING = exports.ENGINE_SANITIZE = exports.ENGINE_VALUE = exports.ENGINE_MATCHER_WHITELIST = exports.ENGINE_MATCHER_STARTS_WITH = exports.ENGINE_MATCHER_STRING_INVALID = exports.ENGINE_MATCHER_STRING = exports.ENGINE_MATCHER_SEGMENT = exports.ENGINE_MATCHER_PART_OF = exports.ENGINE_MATCHER_LESS = exports.ENGINE_MATCHER_GREATER = exports.ENGINE_MATCHER_ENDS_WITH = exports.ENGINE_MATCHER_EQUAL_TO_SET = exports.ENGINE_MATCHER_EQUAL = exports.ENGINE_MATCHER_DEPENDENCY_PRE = exports.ENGINE_MATCHER_DEPENDENCY = exports.ENGINE_MATCHER_CONTAINS_STRING = exports.ENGINE_MATCHER_CONTAINS_ANY = exports.ENGINE_MATCHER_CONTAINS_ALL = exports.ENGINE_MATCHER_BOOLEAN = exports.ENGINE_MATCHER_BETWEEN = exports.ENGINE_MATCHER_ALL = exports.ENGINE_BUCKET = exports.ENGINE_COMBINER_IFELSEIF_NO_TREATMENT = exports.ENGINE_COMBINER_IFELSEIF = exports.ENGINE_COMBINER_AND = void 0;
 /**
  * Message codes used to trim string log messages from commons and client-side API modules,
  * in order to reduce the minimal SDK size for Browser and eventually other client-side environments.
@@ -92,9 +92,8 @@ exports.WARN_INTEGRATION_INVALID = 218;
 exports.WARN_SPLITS_FILTER_IGNORED = 219;
 exports.WARN_SPLITS_FILTER_INVALID = 220;
 exports.WARN_SPLITS_FILTER_EMPTY = 221;
-exports.WARN_STORAGE_INVALID = 222;
-exports.WARN_API_KEY = 223;
-exports.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2 = 224;
+exports.WARN_API_KEY = 222;
+exports.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2 = 223;
 exports.ERROR_ENGINE_COMBINER_IFELSEIF = 300;
 exports.ERROR_LOGLEVEL_INVALID = 301;
 exports.ERROR_CLIENT_LISTENER = 302;
@@ -119,6 +118,7 @@ exports.ERROR_EMPTY_ARRAY = 320;
 exports.ERROR_INVALID_IMPRESSIONS_MODE = 321;
 exports.ERROR_HTTP = 322;
 exports.ERROR_LOCALHOST_MODULE_REQUIRED = 323;
+exports.ERROR_STORAGE_INVALID = 324;
 // Log prefixes (a.k.a. tags or categories)
 exports.LOG_PREFIX_SETTINGS = 'settings';
 exports.LOG_PREFIX_INSTANTIATION = 'Factory instantiation';

package/cjs/logger/messages/error.js

@@ -33,5 +33,6 @@ exports.codesError = [
     [c.ERROR_EMPTY_ARRAY, '%s: %s must be a non-empty array.'],
     // initialization / settings validation
     [c.ERROR_INVALID_IMPRESSIONS_MODE, c.LOG_PREFIX_SETTINGS + ': you passed an invalid "impressionsMode". It should be one of the following values: %s. Defaulting to "%s" mode.'],
-    [c.ERROR_LOCALHOST_MODULE_REQUIRED, c.LOG_PREFIX_SETTINGS + ': an invalid value was received for "sync.localhostMode" config. A valid entity should be provided for localhost mode.']
+    [c.ERROR_LOCALHOST_MODULE_REQUIRED, c.LOG_PREFIX_SETTINGS + ': an invalid value was received for "sync.localhostMode" config. A valid entity should be provided for localhost mode.'],
+    [c.ERROR_STORAGE_INVALID, c.LOG_PREFIX_SETTINGS + ': The provided storage is invalid.%s Fallbacking into default MEMORY storage'],
 ];

package/cjs/logger/messages/warn.js

@@ -32,7 +32,6 @@ exports.codesWarn = error_1.codesError.concat([
     [c.WARN_SPLITS_FILTER_IGNORED, c.LOG_PREFIX_SETTINGS + ': split filters have been configured but will have no effect if mode is not "%s", since synchronization is being deferred to an external tool.'],
     [c.WARN_SPLITS_FILTER_INVALID, c.LOG_PREFIX_SETTINGS + ': split filter at position %s is invalid. It must be an object with a valid filter type ("byName" or "byPrefix") and a list of "values".'],
     [c.WARN_SPLITS_FILTER_EMPTY, c.LOG_PREFIX_SETTINGS + ': splitFilters configuration must be a non-empty array of filter objects.'],
-    [c.WARN_STORAGE_INVALID, c.LOG_PREFIX_SETTINGS + ': The provided storage is invalid. Fallbacking into default MEMORY storage'],
     [c.WARN_API_KEY, c.LOG_PREFIX_SETTINGS + ': You already have %s. We recommend keeping only one instance of the factory at all times (Singleton pattern) and reusing it throughout your application'],
     [c.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2, c.LOG_PREFIX_SYNC_STREAMING + 'Fetching MySegments due to an error processing %s notification: %s'],
 ]);

package/cjs/sdkFactory/index.js

@@ -31,7 +31,7 @@ function sdkFactory(params) {
         // ATM, only used by InLocalStorage
         matchingKey: key_1.getMatching(settings.core.key),
         splitFiltersValidation: settings.sync.__splitFiltersValidation,
-        // ATM, only used by CustomStorage. true for partial consumer mode
+        // ATM, only used by PluggableStorage
         mode: settings.mode,
         // Callback used to emit SDK_READY in consumer mode, where `syncManagerFactory` is undefined
         // or only instantiates submitters, and therefore it is not able to emit readiness events.

package/cjs/storages/inRedis/index.js

@@ -25,8 +25,7 @@ function InRedisStorage(options) {
         var redisClient = new RedisAdapter_1.default(log, options.options || {});
         // subscription to Redis connect event in order to emit SDK_READY event on consumer mode
         redisClient.on('connect', function () {
-            if (onReadyCb)
-                onReadyCb();
+            onReadyCb();
         });
         return {
             splits: new SplitsCacheInRedis_1.default(log, keys, redisClient),

package/cjs/storages/pluggable/SplitsCachePluggable.js

@@ -11,7 +11,7 @@ var AbstractSplitsCacheAsync_1 = tslib_1.__importDefault(require("../AbstractSpl
 var SplitsCachePluggable = /** @class */ (function (_super) {
     tslib_1.__extends(SplitsCachePluggable, _super);
     /**
-     * Create a SplitsCache that uses a custom storage wrapper.
+     * Create a SplitsCache that uses a storage wrapper.
      * @param log  Logger instance.
      * @param keys  Key builder.
      * @param wrapper  Adapted wrapper storage.

package/cjs/storages/pluggable/constants.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LOG_PREFIX = void 0;
-exports.LOG_PREFIX = 'storage:pluggable:';
+exports.LOG_PREFIX = 'storage:pluggable: ';

package/cjs/storages/pluggable/inMemoryWrapper.js

@@ -4,7 +4,7 @@ exports.inMemoryWrapperFactory = void 0;
 var lang_1 = require("../../utils/lang");
 var sets_1 = require("../../utils/lang/sets");
 /**
- * Creates a ICustomStorageWrapper implementation that stores items in memory.
+ * Creates a IPluggableStorageWrapper implementation that stores items in memory.
  * The `_cache` property is the object were items are stored.
  * Intended for testing purposes.
  *
@@ -120,7 +120,7 @@ function inMemoryWrapperFactory(connDelay) {
                 return Promise.resolve(sets_1.setToArray(set));
             return Promise.reject('key is not a set');
         },
-        // always connects and close
+        // always connects and disconnects
         connect: function () {
             if (typeof _connDelay === 'number') {
                 return new Promise(function (res) { return setTimeout(res, _connDelay); });
@@ -129,7 +129,7 @@ function inMemoryWrapperFactory(connDelay) {
                 return Promise.resolve();
             }
         },
-        close: function () { return Promise.resolve(); },
+        disconnect: function () { return Promise.resolve(); },
         // for testing
         _setConnDelay: function (connDelay) {
             _connDelay = connDelay;

package/cjs/storages/pluggable/index.js

@@ -14,7 +14,7 @@ var constants_1 = require("../../utils/constants");
 var ImpressionsCacheInMemory_1 = tslib_1.__importDefault(require("../inMemory/ImpressionsCacheInMemory"));
 var EventsCacheInMemory_1 = tslib_1.__importDefault(require("../inMemory/EventsCacheInMemory"));
 var ImpressionCountsCacheInMemory_1 = tslib_1.__importDefault(require("../inMemory/ImpressionCountsCacheInMemory"));
-var NO_VALID_WRAPPER = 'Expecting custom storage `wrapper` in options, but no valid wrapper instance was provided.';
+var NO_VALID_WRAPPER = 'Expecting pluggable storage `wrapper` in options, but no valid wrapper instance was provided.';
 var NO_VALID_WRAPPER_INTERFACE = 'The provided wrapper instance doesn’t follow the expected interface. Check our docs.';
 /**
  * Validate pluggable storage factory options.
@@ -58,7 +58,7 @@ function PluggableStorage(options) {
         var keys = new KeyBuilderSS_1.default(prefix, metadata);
         var wrapper = wrapperAdapter_1.wrapperAdapter(log, options.wrapper);
         var isPartialConsumer = mode === constants_1.CONSUMER_PARTIAL_MODE;
-        // emit SDK_READY event on main client
+        // Connects to wrapper and emits SDK_READY event on main client
         wrapperConnect(wrapper, onReadyCb);
         return {
             splits: new SplitsCachePluggable_1.SplitsCachePluggable(log, keys, wrapper),
@@ -67,20 +67,20 @@ function PluggableStorage(options) {
             impressionCounts: optimize ? new ImpressionCountsCacheInMemory_1.default() : undefined,
             events: isPartialConsumer ? promisifyEventsTrack(new EventsCacheInMemory_1.default(eventsQueueSize)) : new EventsCachePluggable_1.EventsCachePluggable(log, keys.buildEventsKey(), wrapper, metadata),
             // @TODO add telemetry cache when required
-            // Disconnect the underlying storage, to release its resources (such as open files, database connections, etc).
+            // Disconnect the underlying storage
             destroy: function () {
-                return wrapper.close();
+                return wrapper.disconnect();
             },
             // emits SDK_READY event on shared clients and returns a reference to the storage
             shared: function (_, onReadyCb) {
                 wrapperConnect(wrapper, onReadyCb);
                 return tslib_1.__assign(tslib_1.__assign({}, this), { 
-                    // no-op destroy, to close the wrapper only when the main client is destroyed
+                    // no-op destroy, to disconnect the wrapper only when the main client is destroyed
                     destroy: function () { } });
             }
         };
     }
-    PluggableStorageFactory.type = constants_1.STORAGE_CUSTOM;
+    PluggableStorageFactory.type = constants_1.STORAGE_PLUGGABLE;
     return PluggableStorageFactory;
 }
 exports.PluggableStorage = PluggableStorage;

package/cjs/storages/pluggable/wrapperAdapter.js

@@ -19,14 +19,14 @@ exports.METHODS_TO_PROMISE_WRAP = [
     'removeItems',
     'getItems',
     'connect',
-    'close'
+    'disconnect'
 ];
 /**
- * Adapter of the Custom Storage Wrapper.
+ * Adapter of the Pluggable Storage Wrapper.
  * Used to handle exceptions as rejected promises, in order to simplify the error handling on storages.
  *
  * @param log logger instance
- * @param wrapper custom storage wrapper to adapt
+ * @param wrapper storage wrapper to adapt
  * @returns an adapted version of the given storage wrapper
  */
 function wrapperAdapter(log, wrapper) {

package/cjs/sync/polling/updaters/mySegmentsUpdater.js

@@ -23,7 +23,7 @@ function mySegmentsUpdaterFactory(log, mySegmentsFetcher, splitsCache, mySegment
         // NOTE: We only collect metrics on startup.
         // mySegmentsPromise = tracker.start(tracker.TaskNames.MY_SEGMENTS_FETCH, startingUp ? metricCollectors : false, mySegmentsPromise);
     }
-    // @TODO if allowing custom storages, handle async execution
+    // @TODO if allowing pluggable storages, handle async execution
     function updateSegments(segmentsData) {
         var shouldNotifyUpdate;
         if (Array.isArray(segmentsData)) {

package/cjs/sync/streaming/SSEClient/index.js

@@ -34,7 +34,6 @@ var SSEClient = /** @class */ (function () {
      * @throws 'EventSource API is not available. ' if EventSource is not available.
      */
     function SSEClient(settings, useHeaders, getEventSource) {
-        // @ts-expect-error
         this.eventSource = getEventSource && getEventSource();
         // if eventSource is not available, throw an exception
         if (!this.eventSource)

package/cjs/sync/streaming/UpdateWorkers/SplitsUpdateWorker.js

@@ -70,7 +70,6 @@ var SplitsUpdateWorker = /** @class */ (function () {
      */
     SplitsUpdateWorker.prototype.killSplit = function (_a) {
         var changeNumber = _a.changeNumber, splitName = _a.splitName, defaultTreatment = _a.defaultTreatment;
-        // @TODO handle retry due to errors in storage, once we allow the definition of custom async storages
         if (this.splitsCache.killLocally(splitName, defaultTreatment, changeNumber)) {
             // trigger an SDK_UPDATE if Split was killed locally
             this.splitsEventEmitter.emit(constants_1.SDK_SPLITS_ARRIVED, true);

package/cjs/utils/MinEventEmitter.js

@@ -35,13 +35,13 @@ var EventEmitter = /** @class */ (function () {
     EventEmitter.prototype.once = function (type, listener) {
         return this.registerListener(type, listener, true);
     };
-    // eslint-disable-next-line
-    EventEmitter.prototype.removeListener = function (type, listener) {
+    // @ts-ignore
+    EventEmitter.prototype.removeListener = function ( /* type: string, listener: (...args: any[]) => void */) {
         throw new Error('Method not implemented.');
     };
-    // alias of removeListener
-    EventEmitter.prototype.off = function (type, listener) {
-        return this.removeListener(type, listener);
+    // @ts-ignore alias of removeListener
+    EventEmitter.prototype.off = function ( /* type: string, listener: (...args: any[]) => void */) {
+        return this.removeListener( /* type, listener */);
     };
     EventEmitter.prototype.emit = function (type) {
         var args = [];

package/cjs/utils/MinEvents.js

@@ -31,33 +31,31 @@
 // OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
 // USE OR OTHER DEALINGS IN THE SOFTWARE.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEmitter = void 0;
 var R = typeof Reflect === 'object' ? Reflect : null;
 var ReflectApply = R && typeof R.apply === 'function'
     ? R.apply
     : function ReflectApply(target, receiver, args) {
         return Function.prototype.apply.call(target, receiver, args);
     };
-function EventEmitter() {
+exports.EventEmitter = function EventEmitter() {
     EventEmitter.init.call(this);
-}
-exports.default = EventEmitter;
-// Backwards-compat with node 0.10.x
-EventEmitter.EventEmitter = EventEmitter;
-EventEmitter.prototype._events = undefined;
-EventEmitter.prototype._eventsCount = 0;
+};
+exports.EventEmitter.prototype._events = undefined;
+exports.EventEmitter.prototype._eventsCount = 0;
 function checkListener(listener) {
     if (typeof listener !== 'function') {
         throw new TypeError('The "listener" argument must be of type Function. Received type ' + typeof listener);
     }
 }
-EventEmitter.init = function () {
+exports.EventEmitter.init = function () {
     if (this._events === undefined ||
         this._events === Object.getPrototypeOf(this)._events) {
         this._events = Object.create(null);
         this._eventsCount = 0;
     }
 };
-EventEmitter.prototype.emit = function emit(type) {
+exports.EventEmitter.prototype.emit = function emit(type) {
     var args = [];
     for (var i = 1; i < arguments.length; i++)
         args.push(arguments[i]);
@@ -137,10 +135,10 @@ function _addListener(target, type, listener, prepend) {
     }
     return target;
 }
-EventEmitter.prototype.addListener = function addListener(type, listener) {
+exports.EventEmitter.prototype.addListener = function addListener(type, listener) {
     return _addListener(this, type, listener, false);
 };
-EventEmitter.prototype.on = EventEmitter.prototype.addListener;
+exports.EventEmitter.prototype.on = exports.EventEmitter.prototype.addListener;
 function onceWrapper() {
     if (!this.fired) {
         this.target.removeListener(this.type, this.wrapFn);
@@ -157,13 +155,13 @@ function _onceWrap(target, type, listener) {
     state.wrapFn = wrapped;
     return wrapped;
 }
-EventEmitter.prototype.once = function once(type, listener) {
+exports.EventEmitter.prototype.once = function once(type, listener) {
     checkListener(listener);
     this.on(type, _onceWrap(this, type, listener));
     return this;
 };
 // Emits a 'removeListener' event if and only if the listener was removed.
-EventEmitter.prototype.removeListener =
+exports.EventEmitter.prototype.removeListener =
     function removeListener(type, listener) {
         var list, events, position, i, originalListener;
         checkListener(listener);
@@ -205,8 +203,8 @@ EventEmitter.prototype.removeListener =
         }
         return this;
     };
-EventEmitter.prototype.off = EventEmitter.prototype.removeListener;
-EventEmitter.prototype.removeAllListeners =
+exports.EventEmitter.prototype.off = exports.EventEmitter.prototype.removeListener;
+exports.EventEmitter.prototype.removeAllListeners =
     function removeAllListeners(type) {
         var listeners, events, i;
         events = this._events;

package/cjs/utils/constants/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STORAGE_CUSTOM = 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.OPTIMIZED = exports.DEBUG = exports.SPLIT_EVENT = exports.SPLIT_IMPRESSION = exports.NA = exports.UNKNOWN = exports.CONTROL_WITH_CONFIG = exports.CONTROL = void 0;
+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.OPTIMIZED = exports.DEBUG = exports.SPLIT_EVENT = exports.SPLIT_IMPRESSION = exports.NA = exports.UNKNOWN = exports.CONTROL_WITH_CONFIG = exports.CONTROL = void 0;
 // Special treatments
 exports.CONTROL = 'control';
 exports.CONTROL_WITH_CONFIG = {
@@ -26,4 +26,4 @@ exports.CONSUMER_PARTIAL_MODE = 'consumer_partial';
 exports.STORAGE_MEMORY = 'MEMORY';
 exports.STORAGE_LOCALSTORAGE = 'LOCALSTORAGE';
 exports.STORAGE_REDIS = 'REDIS';
-exports.STORAGE_CUSTOM = 'CUSTOM';
+exports.STORAGE_PLUGGABLE = 'PLUGGABLE';

package/cjs/utils/env/isNode.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isNode = void 0;
-// We check for version truthiness since most shims will have that as empty string.
+/**
+ * 'true' if running in Node.js, or 'false' otherwise.
+ * We check for version truthiness since most shims will have that as empty string.
+ */
 // eslint-disable-next-line no-undef
 exports.isNode = typeof process !== 'undefined' && typeof process.version !== 'undefined' && !!process.version ? true : false;

package/cjs/utils/settingsValidation/storage/storageCS.js

@@ -16,29 +16,32 @@ __InLocalStorageMockFactory.type = constants_2.STORAGE_MEMORY;
  *
  * @param {any} settings config object provided by the user to initialize the sdk
  *
- * @returns {Object} valid storage factory. It might be the default `InMemoryStorageCSFactory` if the provided storage is invalid.
+ * @returns {Object} valid storage factory. Default to `InMemoryStorageCSFactory` if the provided storage is invalid or not compatible with the sdk mode if mode is standalone or localhost
+ *
+ * @throws error if mode is consumer and the provided storage is not compatible
  */
 function validateStorageCS(settings) {
     var _a = settings.storage, storage = _a === void 0 ? InMemoryStorageCS_1.InMemoryStorageCSFactory : _a, log = settings.log, mode = settings.mode;
     // If an invalid storage is provided, fallback into MEMORY
-    if (typeof storage !== 'function' || [constants_2.STORAGE_MEMORY, constants_2.STORAGE_LOCALSTORAGE, constants_2.STORAGE_CUSTOM].indexOf(storage.type) === -1) {
+    if (typeof storage !== 'function' || [constants_2.STORAGE_MEMORY, constants_2.STORAGE_LOCALSTORAGE, constants_2.STORAGE_PLUGGABLE].indexOf(storage.type) === -1) {
         storage = InMemoryStorageCS_1.InMemoryStorageCSFactory;
-        log.warn(constants_1.WARN_STORAGE_INVALID);
+        log.error(constants_1.ERROR_STORAGE_INVALID);
     }
     // In localhost mode with InLocalStorage, fallback to a mock InLocalStorage to emit SDK_READY_FROM_CACHE
     if (mode === constants_2.LOCALHOST_MODE && storage.type === constants_2.STORAGE_LOCALSTORAGE) {
         return __InLocalStorageMockFactory;
     }
-    // @TODO check behaviour
     if ([constants_2.LOCALHOST_MODE, constants_2.STANDALONE_MODE].indexOf(mode) === -1) {
         // Consumer modes require an async storage
-        if (storage.type !== constants_2.STORAGE_CUSTOM)
-            throw new Error('A CustomStorage instance is required on consumer modes');
+        if (storage.type !== constants_2.STORAGE_PLUGGABLE)
+            throw new Error('A PluggableStorage instance is required on consumer mode');
     }
     else {
         // Standalone and localhost modes require a sync storage
-        if (storage.type === constants_2.STORAGE_CUSTOM)
-            throw new Error('A CustomStorage instance cannot be used on standalone and localhost modes');
+        if (storage.type === constants_2.STORAGE_PLUGGABLE) {
+            storage = InMemoryStorageCS_1.InMemoryStorageCSFactory;
+            log.error(constants_1.ERROR_STORAGE_INVALID, [' It requires consumer mode.']);
+        }
     }
     // return default InMemory storage if provided one is not valid
     return storage;

package/esm/evaluator/index.js

@@ -1,7 +1,6 @@
 import Engine from './Engine';
 import thenable from '../utils/promise/thenable';
 import * as LabelsConstants from '../utils/labels';
-import { get } from '../utils/lang';
 import { CONTROL } from '../utils/constants';
 var treatmentException = {
     treatment: CONTROL,
@@ -60,17 +59,17 @@ function getEvaluation(log, stringifiedSplit, key, attributes, storage) {
         var splitJSON_1 = JSON.parse(stringifiedSplit);
         var split_1 = Engine.parse(log, splitJSON_1, storage);
         evaluation = split_1.getTreatment(key, attributes, evaluateFeature);
-        // If the storage is async, evaluation and changeNumber will return a thenable
+        // If the storage is async and the evaluated split uses segment, evaluation is thenable
         if (thenable(evaluation)) {
             return evaluation.then(function (result) {
                 result.changeNumber = split_1.getChangeNumber();
-                result.config = get(splitJSON_1, "configurations." + result.treatment, null);
+                result.config = splitJSON_1.configurations && splitJSON_1.configurations[result.treatment] || null;
                 return result;
             });
         }
         else {
             evaluation.changeNumber = split_1.getChangeNumber(); // Always sync and optional
-            evaluation.config = get(splitJSON_1, "configurations." + evaluation.treatment, null);
+            evaluation.config = splitJSON_1.configurations && splitJSON_1.configurations[evaluation.treatment] || null;
         }
     }
     return evaluation;

package/esm/logger/constants.js

@@ -89,9 +89,8 @@ export var WARN_INTEGRATION_INVALID = 218;
 export var WARN_SPLITS_FILTER_IGNORED = 219;
 export var WARN_SPLITS_FILTER_INVALID = 220;
 export var WARN_SPLITS_FILTER_EMPTY = 221;
-export var WARN_STORAGE_INVALID = 222;
-export var WARN_API_KEY = 223;
-export var STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2 = 224;
+export var WARN_API_KEY = 222;
+export var STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2 = 223;
 export var ERROR_ENGINE_COMBINER_IFELSEIF = 300;
 export var ERROR_LOGLEVEL_INVALID = 301;
 export var ERROR_CLIENT_LISTENER = 302;
@@ -116,6 +115,7 @@ export var ERROR_EMPTY_ARRAY = 320;
 export var ERROR_INVALID_IMPRESSIONS_MODE = 321;
 export var ERROR_HTTP = 322;
 export var ERROR_LOCALHOST_MODULE_REQUIRED = 323;
+export var ERROR_STORAGE_INVALID = 324;
 // Log prefixes (a.k.a. tags or categories)
 export var LOG_PREFIX_SETTINGS = 'settings';
 export var LOG_PREFIX_INSTANTIATION = 'Factory instantiation';

package/esm/logger/messages/error.js

@@ -29,5 +29,6 @@ export var codesError = [
     [c.ERROR_EMPTY_ARRAY, '%s: %s must be a non-empty array.'],
     // initialization / settings validation
     [c.ERROR_INVALID_IMPRESSIONS_MODE, c.LOG_PREFIX_SETTINGS + ': you passed an invalid "impressionsMode". It should be one of the following values: %s. Defaulting to "%s" mode.'],
-    [c.ERROR_LOCALHOST_MODULE_REQUIRED, c.LOG_PREFIX_SETTINGS + ': an invalid value was received for "sync.localhostMode" config. A valid entity should be provided for localhost mode.']
+    [c.ERROR_LOCALHOST_MODULE_REQUIRED, c.LOG_PREFIX_SETTINGS + ': an invalid value was received for "sync.localhostMode" config. A valid entity should be provided for localhost mode.'],
+    [c.ERROR_STORAGE_INVALID, c.LOG_PREFIX_SETTINGS + ': The provided storage is invalid.%s Fallbacking into default MEMORY storage'],
 ];

package/esm/logger/messages/warn.js

@@ -28,7 +28,6 @@ export var codesWarn = codesError.concat([
     [c.WARN_SPLITS_FILTER_IGNORED, c.LOG_PREFIX_SETTINGS + ': split filters have been configured but will have no effect if mode is not "%s", since synchronization is being deferred to an external tool.'],
     [c.WARN_SPLITS_FILTER_INVALID, c.LOG_PREFIX_SETTINGS + ': split filter at position %s is invalid. It must be an object with a valid filter type ("byName" or "byPrefix") and a list of "values".'],
     [c.WARN_SPLITS_FILTER_EMPTY, c.LOG_PREFIX_SETTINGS + ': splitFilters configuration must be a non-empty array of filter objects.'],
-    [c.WARN_STORAGE_INVALID, c.LOG_PREFIX_SETTINGS + ': The provided storage is invalid. Fallbacking into default MEMORY storage'],
     [c.WARN_API_KEY, c.LOG_PREFIX_SETTINGS + ': You already have %s. We recommend keeping only one instance of the factory at all times (Singleton pattern) and reusing it throughout your application'],
     [c.STREAMING_PARSING_MY_SEGMENTS_UPDATE_V2, c.LOG_PREFIX_SYNC_STREAMING + 'Fetching MySegments due to an error processing %s notification: %s'],
 ]);

package/esm/sdkFactory/index.js

@@ -27,7 +27,7 @@ export function sdkFactory(params) {
         // ATM, only used by InLocalStorage
         matchingKey: getMatching(settings.core.key),
         splitFiltersValidation: settings.sync.__splitFiltersValidation,
-        // ATM, only used by CustomStorage. true for partial consumer mode
+        // ATM, only used by PluggableStorage
         mode: settings.mode,
         // Callback used to emit SDK_READY in consumer mode, where `syncManagerFactory` is undefined
         // or only instantiates submitters, and therefore it is not able to emit readiness events.

package/esm/storages/inRedis/index.js

@@ -21,8 +21,7 @@ export function InRedisStorage(options) {
         var redisClient = new RedisAdapter(log, options.options || {});
         // subscription to Redis connect event in order to emit SDK_READY event on consumer mode
         redisClient.on('connect', function () {
-            if (onReadyCb)
-                onReadyCb();
+            onReadyCb();
         });
         return {
             splits: new SplitsCacheInRedis(log, keys, redisClient),

package/esm/storages/pluggable/SplitsCachePluggable.js

@@ -8,7 +8,7 @@ import AbstractSplitsCacheAsync from '../AbstractSplitsCacheAsync';
 var SplitsCachePluggable = /** @class */ (function (_super) {
     __extends(SplitsCachePluggable, _super);
     /**
-     * Create a SplitsCache that uses a custom storage wrapper.
+     * Create a SplitsCache that uses a storage wrapper.
      * @param log  Logger instance.
      * @param keys  Key builder.
      * @param wrapper  Adapted wrapper storage.

package/esm/storages/pluggable/constants.js

@@ -1 +1 @@
-export var LOG_PREFIX = 'storage:pluggable:';
+export var LOG_PREFIX = 'storage:pluggable: ';

package/esm/storages/pluggable/inMemoryWrapper.js

@@ -1,7 +1,7 @@
 import { startsWith, toNumber } from '../../utils/lang';
 import { setToArray, _Set } from '../../utils/lang/sets';
 /**
- * Creates a ICustomStorageWrapper implementation that stores items in memory.
+ * Creates a IPluggableStorageWrapper implementation that stores items in memory.
  * The `_cache` property is the object were items are stored.
  * Intended for testing purposes.
  *
@@ -117,7 +117,7 @@ export function inMemoryWrapperFactory(connDelay) {
                 return Promise.resolve(setToArray(set));
             return Promise.reject('key is not a set');
         },
-        // always connects and close
+        // always connects and disconnects
         connect: function () {
             if (typeof _connDelay === 'number') {
                 return new Promise(function (res) { return setTimeout(res, _connDelay); });
@@ -126,7 +126,7 @@ export function inMemoryWrapperFactory(connDelay) {
                 return Promise.resolve();
             }
         },
-        close: function () { return Promise.resolve(); },
+        disconnect: function () { return Promise.resolve(); },
         // for testing
         _setConnDelay: function (connDelay) {
             _connDelay = connDelay;

package/esm/storages/pluggable/index.js

@@ -7,11 +7,11 @@ import { EventsCachePluggable } from './EventsCachePluggable';
 import { wrapperAdapter, METHODS_TO_PROMISE_WRAP } from './wrapperAdapter';
 import { isObject } from '../../utils/lang';
 import { validatePrefix } from '../KeyBuilder';
-import { CONSUMER_PARTIAL_MODE, STORAGE_CUSTOM } from '../../utils/constants';
+import { CONSUMER_PARTIAL_MODE, STORAGE_PLUGGABLE } from '../../utils/constants';
 import ImpressionsCacheInMemory from '../inMemory/ImpressionsCacheInMemory';
 import EventsCacheInMemory from '../inMemory/EventsCacheInMemory';
 import ImpressionCountsCacheInMemory from '../inMemory/ImpressionCountsCacheInMemory';
-var NO_VALID_WRAPPER = 'Expecting custom storage `wrapper` in options, but no valid wrapper instance was provided.';
+var NO_VALID_WRAPPER = 'Expecting pluggable storage `wrapper` in options, but no valid wrapper instance was provided.';
 var NO_VALID_WRAPPER_INTERFACE = 'The provided wrapper instance doesn’t follow the expected interface. Check our docs.';
 /**
  * Validate pluggable storage factory options.
@@ -55,7 +55,7 @@ export function PluggableStorage(options) {
         var keys = new KeyBuilderSS(prefix, metadata);
         var wrapper = wrapperAdapter(log, options.wrapper);
         var isPartialConsumer = mode === CONSUMER_PARTIAL_MODE;
-        // emit SDK_READY event on main client
+        // Connects to wrapper and emits SDK_READY event on main client
         wrapperConnect(wrapper, onReadyCb);
         return {
             splits: new SplitsCachePluggable(log, keys, wrapper),
@@ -64,19 +64,19 @@ export function PluggableStorage(options) {
             impressionCounts: optimize ? new ImpressionCountsCacheInMemory() : undefined,
             events: isPartialConsumer ? promisifyEventsTrack(new EventsCacheInMemory(eventsQueueSize)) : new EventsCachePluggable(log, keys.buildEventsKey(), wrapper, metadata),
             // @TODO add telemetry cache when required
-            // Disconnect the underlying storage, to release its resources (such as open files, database connections, etc).
+            // Disconnect the underlying storage
             destroy: function () {
-                return wrapper.close();
+                return wrapper.disconnect();
             },
             // emits SDK_READY event on shared clients and returns a reference to the storage
             shared: function (_, onReadyCb) {
                 wrapperConnect(wrapper, onReadyCb);
                 return __assign(__assign({}, this), { 
-                    // no-op destroy, to close the wrapper only when the main client is destroyed
+                    // no-op destroy, to disconnect the wrapper only when the main client is destroyed
                     destroy: function () { } });
             }
         };
     }
-    PluggableStorageFactory.type = STORAGE_CUSTOM;
+    PluggableStorageFactory.type = STORAGE_PLUGGABLE;
     return PluggableStorageFactory;
 }

package/esm/storages/pluggable/wrapperAdapter.js

@@ -16,14 +16,14 @@ export var METHODS_TO_PROMISE_WRAP = [
     'removeItems',
     'getItems',
     'connect',
-    'close'
+    'disconnect'
 ];
 /**
- * Adapter of the Custom Storage Wrapper.
+ * Adapter of the Pluggable Storage Wrapper.
  * Used to handle exceptions as rejected promises, in order to simplify the error handling on storages.
  *
  * @param log logger instance
- * @param wrapper custom storage wrapper to adapt
+ * @param wrapper storage wrapper to adapt
  * @returns an adapted version of the given storage wrapper
  */
 export function wrapperAdapter(log, wrapper) {