@splitsoftware/splitio-commons 2.0.0-rc.4 → 2.0.0-rc.5

package/cjs/utils/settingsValidation/integrations/pluggable.js

@@ -5,9 +5,9 @@ var common_1 = require("./common");
 /**
  * This function validates `settings.integrations` object that consists of a list of pluggable integration factories.
  *
- * @param {any} settings config object provided by the user to initialize the sdk
+ * @param settings - config object provided by the user to initialize the sdk
  *
- * @returns {Array} array of valid integration factories. The array might be empty if `settings` object does not have valid integrations.
+ * @returns array of valid integration factories. The array might be empty if `settings` object does not have valid integrations.
  */
 function validatePluggableIntegrations(settings) {
     return (0, common_1.validateIntegrations)(settings, function (integration) { return typeof integration === 'function'; }, 'Integration items must be functions that initialize the integrations');

package/cjs/utils/settingsValidation/logger/builtinLogger.js

@@ -31,7 +31,7 @@ else if ((0, logger_1.isLogLevelString)(initialState)) {
 /**
  * Validates the `debug` property at config and use it to set the log level.
  *
- * @param settings user config object, with an optional `debug` property of type boolean or string log level.
+ * @param settings - user config object, with an optional `debug` property of type boolean or string log level.
  * @returns a logger instance with the log level at `settings.debug`. If `settings.debug` is invalid or not provided, `initialLogLevel` is used.
  */
 function validateLogger(settings) {

package/cjs/utils/settingsValidation/logger/commons.js

@@ -6,7 +6,7 @@ var logger_1 = require("../../../logger");
  * Returns the LogLevel for the given debugValue or undefined if it is invalid,
  * i.e., if the debugValue is not a boolean or LogLevel string.
  *
- * @param debugValue debug value at config
+ * @param debugValue - debug value at config
  * @returns LogLevel of the given debugValue or undefined if the provided value is invalid
  */
 function getLogLevel(debugValue) {

package/cjs/utils/settingsValidation/logger/pluggableLogger.js

@@ -11,7 +11,7 @@ var initialLogLevel = logger_1.LogLevels.NONE;
 /**
  * Validates the `debug` property at config and use it to set the logger.
  *
- * @param settings user config object, with an optional `debug` property of type boolean, string log level or a Logger object.
+ * @param settings - user config object, with an optional `debug` property of type boolean, string log level or a Logger object.
  * @returns a logger instance, that might be: the provided logger at `settings.debug`, or one with the given `debug` log level,
  * or one with NONE log level if `debug` is not defined or invalid.
  */

package/cjs/utils/settingsValidation/splitFilters.js

@@ -36,9 +36,9 @@ function validateFilterType(maybeFilterType) {
 /**
  * Validate, deduplicate and sort a given list of filter values.
  *
- * @param {string} type filter type string used for log messages
- * @param {string[]} values list of values to validate, deduplicate and sort
- * @param {number} maxLength
+ * @param type - filter type string used for log messages
+ * @param values - list of values to validate, deduplicate and sort
+ * @param maxLength - max length allowed for the list of values
  * @returns list of valid, unique and alphabetically sorted non-empty strings. The list is empty if `values` param is not a non-empty array or all its values are invalid.
  *
  * @throws Error if the sanitized list exceeds the length indicated by `maxLength`
@@ -67,7 +67,7 @@ function validateSplitFilter(log, type, values, maxLength) {
  *  - '&prefixes=<comma-separated-values>': if only `byName` filter is undefined
  *  - '&names=<comma-separated-values>&prefixes=<comma-separated-values>': if no one is undefined
  *
- * @param {Object} groupedFilters object of filters. Each filter must be a list of valid, unique and ordered string values.
+ * @param groupedFilters - object of filters. Each filter must be a list of valid, unique and ordered string values.
  * @returns null or string with the `split filter query` component of the URL.
  */
 function queryStringBuilder(groupedFilters) {
@@ -83,15 +83,12 @@ function queryStringBuilder(groupedFilters) {
 /**
  * Sanitizes set names list taking into account:
  *  - It should be lowercase
- *  - Must adhere the following regular expression /^[a-z0-9][_a-z0-9]{0,49}$/ that means
+ *  - Must adhere the following regular expression `/^[a-z0-9][_a-z0-9]{0,49}$/` that means
  *   - must start with a letter or number
  *   - Be in lowercase
  *   - Be alphanumeric
  *   - have a max length of 50 characters
  *
- * @param {ILogger} log
- * @param {string[]} flagSets
- * @param {string} method
  * @returns sanitized list of set names
  */
 function sanitizeFlagSets(log, flagSets, method) {
@@ -120,9 +117,9 @@ function configuredFilter(validFilters, filterType) {
 /**
  * Validates `splitFilters` configuration object and parses it into a query string for filtering splits on `/splitChanges` fetch.
  *
- * @param {ILogger} log logger
- * @param {any} maybeSplitFilters split filters configuration param provided by the user
- * @param {string} mode settings mode
+ * @param log - logger
+ * @param maybeSplitFilters - split filters configuration param provided by the user
+ * @param mode - settings mode
  * @returns it returns an object with the following properties:
  *  - `validFilters`: the validated `splitFilters` configuration object defined by the user.
  *  - `queryString`: the parsed split filter query. it is null if all filters are invalid or all values in filters are invalid.

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

@@ -14,9 +14,9 @@ __InLocalStorageMockFactory.type = constants_2.STORAGE_MEMORY;
 /**
  * This function validates `settings.storage` object
  *
- * @param {any} settings config object provided by the user to initialize the sdk
+ * @param settings - config object provided by the user to initialize the sdk
  *
- * @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
+ * @returns 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
  */

package/cjs/utils/settingsValidation/url.js

@@ -9,9 +9,9 @@ var streamingEndpointMatcher = /^\/(sse|event-stream)/;
  * Get URL based on a given target (path).
  * ATM, it is only used for testing purposes.
  *
- * @param settings settings object
- * @param target url path
- * @return complete url
+ * @param settings - settings object
+ * @param target - url path
+ * @returns complete url
  */
 function url(settings, target) {
     if (telemetryEndpointMatcher.test(target)) {

package/esm/integrations/pluggable.js

@@ -3,8 +3,8 @@ import { SPLIT_IMPRESSION, SPLIT_EVENT } from '../utils/constants';
  * Factory function for IntegrationsManager with pluggable integrations.
  * The integrations manager instantiates integration, and bypass tracked events and impressions to them.
  *
- * @param integrations validated list of integration factories
- * @param params information of the Sdk factory instance that integrations can access to
+ * @param integrations - validated list of integration factories
+ * @param params - information of the Sdk factory instance that integrations can access to
  *
  * @returns integration manager or undefined if `integrations` are not present in settings.
  */

package/esm/logger/sdkLogger.js

@@ -3,7 +3,7 @@ import { ERROR_LOGLEVEL_INVALID } from './constants';
 /**
  * The public Logger utility API exposed via SplitFactory, used to update the log level.
  *
- * @param log the factory logger instance to handle
+ * @param log - the factory logger instance to handle
  */
 export function createLoggerAPI(log) {
     function setLogLevel(logLevel) {
@@ -23,7 +23,7 @@ export function createLoggerAPI(log) {
         },
         /**
          * Sets a custom log Level for the SDK.
-         * @param {string} logLevel - Custom LogLevel value.
+         * @param logLevel - Custom LogLevel value.
          */
         setLogLevel: setLogLevel,
         /**

package/esm/readiness/sdkReadinessManager.js

@@ -9,8 +9,8 @@ var REMOVE_LISTENER_EVENT = 'removeListener';
  * SdkReadinessManager factory, which provides the public status API of SDK clients and manager: ready promise, readiness event emitter and constants (SDK_READY, etc).
  * It also updates logs related warnings and errors.
  *
- * @param readyTimeout time in millis to emit SDK_READY_TIME_OUT event
- * @param readinessManager optional readinessManager to use. only used internally for `shared` method
+ * @param readyTimeout - time in millis to emit SDK_READY_TIME_OUT event
+ * @param readinessManager - optional readinessManager to use. only used internally for `shared` method
  */
 export function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
     if (readinessManager === void 0) { readinessManager = readinessManagerFactory(EventEmitter, settings); }
@@ -73,25 +73,6 @@ export function sdkReadinessManagerFactory(EventEmitter, settings, readinessMana
                 SDK_UPDATE: SDK_UPDATE,
                 SDK_READY_TIMED_OUT: SDK_READY_TIMED_OUT,
             },
-            /**
-             * Returns a promise that will be resolved once the SDK has finished loading (SDK_READY event emitted) or rejected if the SDK has timedout (SDK_READY_TIMED_OUT event emitted).
-             * As it's meant to provide similar flexibility to the event approach, given that the SDK might be eventually ready after a timeout event, calling the `ready` method after the
-             * SDK had timed out will return a new promise that should eventually resolve if the SDK gets ready.
-             *
-             * Caveats: the method was designed to avoid an unhandled Promise rejection if the rejection case is not handled, so that `onRejected` handler is optional when using promises.
-             * However, when using async/await syntax, the rejection should be explicitly propagated like in the following example:
-             * ```
-             * try {
-             *   await client.ready().catch((e) => { throw e; });
-             *   // SDK is ready
-             * } catch(e) {
-             *   // SDK has timedout
-             * }
-             * ```
-             *
-             * @function ready
-             * @returns {Promise<void>}
-             */
             ready: function () {
                 if (readinessManager.hasTimedout()) {
                     if (!readinessManager.isReady()) {

package/esm/sdkClient/client.js

@@ -162,6 +162,5 @@ export function clientFactory(params) {
         getTreatmentsByFlagSet: getTreatmentsByFlagSet,
         getTreatmentsWithConfigByFlagSet: getTreatmentsWithConfigByFlagSet,
         track: track,
-        isClientSide: false
     };
 }

package/esm/sdkClient/clientAttributesDecoration.js

@@ -63,9 +63,9 @@ export function clientAttributesDecoration(log, client) {
         /**
          * Add an attribute to client's in memory attributes storage
          *
-         * @param {string} attributeName Attrinute name
-         * @param {string, number, boolean, list} attributeValue Attribute value
-         * @returns {boolean} true if the attribute was stored and false otherways
+         * @param attributeName - Attribute name
+         * @param attributeValue - Attribute value
+         * @returns true if the attribute was stored and false otherways
          */
         setAttribute: function (attributeName, attributeValue) {
             var attribute = {};
@@ -78,8 +78,8 @@ export function clientAttributesDecoration(log, client) {
         /**
          * Returns the attribute with the given name
          *
-         * @param {string} attributeName Attribute name
-         * @returns {Object} Attribute with the given name
+         * @param attributeName - Attribute name
+         * @returns Attribute with the given name
          */
         getAttribute: function (attributeName) {
             log.debug("retrieved attribute " + attributeName);
@@ -88,7 +88,7 @@ export function clientAttributesDecoration(log, client) {
         /**
          * Add to client's in memory attributes storage the attributes in 'attributes'
          *
-         * @param {Object} attributes Object with attributes to store
+         * @param attributes - Object with attributes to store
          * @returns true if attributes were stored an false otherways
          */
         setAttributes: function (attributes) {
@@ -99,7 +99,7 @@ export function clientAttributesDecoration(log, client) {
         /**
          * Return all the attributes stored in client's in memory attributes storage
          *
-         * @returns {Object} returns all the stored attributes
+         * @returns returns all the stored attributes
          */
         getAttributes: function () {
             return attributeStorage.getAll();
@@ -107,8 +107,8 @@ export function clientAttributesDecoration(log, client) {
         /**
          * Removes from client's in memory attributes storage the attribute with the given name
          *
-         * @param {string} attributeName
-         * @returns {boolean} true if attribute was removed and false otherways
+         * @param attributeName - Attribute name
+         * @returns true if attribute was removed and false otherways
          */
         removeAttribute: function (attributeName) {
             log.debug("removed attribute " + attributeName);

package/esm/sdkClient/clientCS.js

@@ -3,8 +3,8 @@ import { clientAttributesDecoration } from './clientAttributesDecoration';
 /**
  * Decorator that binds a key to client methods
  *
- * @param client sync client instance
- * @param key validated split key
+ * @param client - sync client instance
+ * @param key - validated split key
  */
 export function clientCSDecorator(log, client, key) {
     var clientCS = clientAttributesDecoration(log, client);

package/esm/services/splitApi.js

@@ -9,9 +9,9 @@ function userKeyToQueryParam(userKey) {
 /**
  * Factory of SplitApi objects, which group the collection of Split HTTP endpoints used by the SDK
  *
- * @param settings validated settings object
- * @param platform object containing environment-specific dependencies
- * @param telemetryTracker telemetry tracker
+ * @param settings - validated settings object
+ * @param platform - object containing environment-specific dependencies
+ * @param telemetryTracker - telemetry tracker
  */
 export function splitApiFactory(settings, platform, telemetryTracker) {
     var urls = settings.urls;
@@ -64,8 +64,8 @@ export function splitApiFactory(settings, platform, telemetryTracker) {
         /**
          * Post events.
          *
-         * @param body  Events bulk payload
-         * @param headers  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
+         * @param body -  Events bulk payload
+         * @param headers -  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
          */
         postEventsBulk: function (body, headers) {
             var url = urls.events + "/events/bulk";
@@ -74,8 +74,8 @@ export function splitApiFactory(settings, platform, telemetryTracker) {
         /**
          * Post impressions.
          *
-         * @param body  Impressions bulk payload
-         * @param headers  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
+         * @param body -  Impressions bulk payload
+         * @param headers -  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
          */
         postTestImpressionsBulk: function (body, headers) {
             var url = urls.events + "/testImpressions/bulk";
@@ -89,8 +89,8 @@ export function splitApiFactory(settings, platform, telemetryTracker) {
         /**
          * Post impressions counts.
          *
-         * @param body  Impressions counts payload
-         * @param headers  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
+         * @param body -  Impressions counts payload
+         * @param headers -  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
          */
         postTestImpressionsCount: function (body, headers) {
             var url = urls.events + "/testImpressions/count";
@@ -99,8 +99,8 @@ export function splitApiFactory(settings, platform, telemetryTracker) {
         /**
          * Post unique keys for client side.
          *
-         * @param body  unique keys payload
-         * @param headers  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
+         * @param body -  unique keys payload
+         * @param headers -  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
          */
         postUniqueKeysBulkCs: function (body, headers) {
             var url = urls.telemetry + "/v1/keys/cs";
@@ -109,8 +109,8 @@ export function splitApiFactory(settings, platform, telemetryTracker) {
         /**
          * Post unique keys for server side.
          *
-         * @param body  unique keys payload
-         * @param headers  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
+         * @param body -  unique keys payload
+         * @param headers -  Optionals headers to overwrite default ones. For example, it is used in producer mode to overwrite metadata headers.
          */
         postUniqueKeysBulkSs: function (body, headers) {
             var url = urls.telemetry + "/v1/keys/ss";

package/esm/services/splitHttpClient.js

@@ -5,8 +5,8 @@ var messageNoFetch = 'Global fetch API is not available.';
 /**
  * Factory of Split HTTP clients, which are HTTP clients with predefined headers for Split endpoints.
  *
- * @param settings SDK settings, used to access authorizationKey, logger instance and metadata (SDK version, ip and hostname) to set additional headers
- * @param platform object containing environment-specific dependencies
+ * @param settings - SDK settings, used to access authorizationKey, logger instance and metadata (SDK version, ip and hostname) to set additional headers
+ * @param platform - object containing environment-specific dependencies
  */
 export function splitHttpClientFactory(settings, _a) {
     var getOptions = _a.getOptions, getFetch = _a.getFetch;

package/esm/storages/AbstractSplitsCacheAsync.js

@@ -22,10 +22,7 @@ var AbstractSplitsCacheAsync = /** @class */ (function () {
      * Kill `name` split and set `defaultTreatment` and `changeNumber`.
      * Used for SPLIT_KILL push notifications.
      *
-     * @param {string} name
-     * @param {string} defaultTreatment
-     * @param {number} changeNumber
-     * @returns {Promise} a promise that is resolved once the split kill operation is performed. The fulfillment value is a boolean: `true` if the operation successed updating the split or `false` if no split is updated,
+     * @returns a promise that is resolved once the split kill operation is performed. The fulfillment value is a boolean: `true` if the operation successed updating the split or `false` if no split is updated,
      * 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.
      * The promise will never be rejected.
      */

package/esm/storages/AbstractSplitsCacheSync.js

@@ -38,10 +38,7 @@ var AbstractSplitsCacheSync = /** @class */ (function () {
      * Kill `name` split and set `defaultTreatment` and `changeNumber`.
      * Used for SPLIT_KILL push notifications.
      *
-     * @param {string} name
-     * @param {string} defaultTreatment
-     * @param {number} changeNumber
-     * @returns {boolean} `true` if the operation successed updating the split, or `false` if no split is updated,
+     * @returns `true` if the operation successed updating the split, or `false` if no split is updated,
      * 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.
      */
     AbstractSplitsCacheSync.prototype.killLocally = function (name, defaultTreatment, changeNumber) {

package/esm/storages/dataLoader.js

@@ -2,7 +2,7 @@ import { DEFAULT_CACHE_EXPIRATION_IN_MILLIS } from '../utils/constants/browser';
 /**
  * Factory of client-side storage loader
  *
- * @param preloadedData validated data following the format proposed in https://github.com/godaddy/split-javascript-data-loader
+ * @param preloadedData - validated data following the format proposed in https://github.com/godaddy/split-javascript-data-loader
  * and extended with a `mySegmentsData` property.
  * @returns function to preload the storage
  */
@@ -11,12 +11,11 @@ export function dataLoaderFactory(preloadedData) {
      * Storage-agnostic adaptation of `loadDataIntoLocalStorage` function
      * (https://github.com/godaddy/split-javascript-data-loader/blob/master/src/load-data.js)
      *
-     * @param storage object containing `splits` and `segments` cache (client-side variant)
-     * @param userId user key string of the provided MySegmentsCache
-     *
-     * @TODO extend to support SegmentsCache (server-side variant) by making `userId` optional and adding the corresponding logic.
-     * @TODO extend to load data on shared mySegments storages. Be specific when emitting SDK_READY_FROM_CACHE on shared clients. Maybe the serializer should provide the `useSegments` flag.
+     * @param storage - object containing `splits` and `segments` cache (client-side variant)
+     * @param userId - user key string of the provided MySegmentsCache
      */
+    // @TODO extend to support SegmentsCache (server-side variant) by making `userId` optional and adding the corresponding logic.
+    // @TODO extend to load data on shared mySegments storages. Be specific when emitting SDK_READY_FROM_CACHE on shared clients. Maybe the serializer should provide the `useSegments` flag.
     return function loadData(storage, userId) {
         // Do not load data if current preloadedData is empty
         if (Object.keys(preloadedData).length === 0)

package/esm/storages/findLatencyIndex.js

@@ -5,7 +5,7 @@ var BASE = 1.5;
 /**
  * Calculates buckets from latency in milliseconds
  *
- * @param latencyInMs
+ * @param latencyInMs - latency in milliseconds
  * @returns a bucket index from 0 to 22 inclusive
  */
 export function findLatencyIndex(latencyInMs) {

package/esm/storages/inLocalStorage/SplitsCacheInLocal.js

@@ -9,11 +9,6 @@ import { setToArray } from '../../utils/lang/sets';
  */
 var SplitsCacheInLocal = /** @class */ (function (_super) {
     __extends(SplitsCacheInLocal, _super);
-    /**
-     * @param {KeyBuilderCS} keys
-     * @param {number | undefined} expirationTimestamp
-     * @param {ISplitFiltersValidation} splitFiltersValidation
-     */
     function SplitsCacheInLocal(settings, keys, expirationTimestamp) {
         var _this = _super.call(this) || this;
         _this.keys = keys;
@@ -194,7 +189,7 @@ var SplitsCacheInLocal = /** @class */ (function (_super) {
     /**
      * Clean Splits cache if its `lastUpdated` timestamp is older than the given `expirationTimestamp`,
      *
-     * @param {number | undefined} expirationTimestamp if the value is not a number, data will not be cleaned
+     * @param expirationTimestamp - if the value is not a number, data will not be cleaned
      */
     SplitsCacheInLocal.prototype._checkExpiration = function (expirationTimestamp) {
         var value = localStorage.getItem(this.keys.buildLastUpdatedKey());

package/esm/storages/inMemory/AttributesCacheInMemory.js

@@ -6,9 +6,9 @@ var AttributesCacheInMemory = /** @class */ (function () {
     /**
      * Create or update the value for the given attribute
      *
-     * @param {string} attributeName attribute name
-     * @param {Object} attributeValue attribute value
-     * @returns {boolean} the attribute was stored
+     * @param attributeName - attribute name
+     * @param attributeValue - attribute value
+     * @returns the attribute was stored
      */
     AttributesCacheInMemory.prototype.setAttribute = function (attributeName, attributeValue) {
         this.attributesCache[attributeName] = attributeValue;
@@ -17,8 +17,8 @@ var AttributesCacheInMemory = /** @class */ (function () {
     /**
      * Retrieves the value of a given attribute
      *
-     * @param {string} attributeName attribute name
-     * @returns {Object?} stored attribute value
+     * @param attributeName - attribute name
+     * @returns stored attribute value
      */
     AttributesCacheInMemory.prototype.getAttribute = function (attributeName) {
         return this.attributesCache[attributeName];
@@ -26,8 +26,8 @@ var AttributesCacheInMemory = /** @class */ (function () {
     /**
      * Create or update all the given attributes
      *
-     * @param {[string, Object]} attributes attributes to create or update
-     * @returns {boolean} attributes were stored
+     * @param attributes - attributes to create or update
+     * @returns attributes were stored
      */
     AttributesCacheInMemory.prototype.setAttributes = function (attributes) {
         this.attributesCache = objectAssign(this.attributesCache, attributes);
@@ -36,7 +36,7 @@ var AttributesCacheInMemory = /** @class */ (function () {
     /**
      * Retrieve the full attributes map
      *
-     * @returns {Map<string, Object>} stored attributes
+     * @returns stored attributes
      */
     AttributesCacheInMemory.prototype.getAll = function () {
         return this.attributesCache;
@@ -44,8 +44,8 @@ var AttributesCacheInMemory = /** @class */ (function () {
     /**
      * Removes a given attribute from the map
      *
-     * @param {string} attributeName attribute to remove
-     * @returns {boolean} attribute removed
+     * @param attributeName - attribute to remove
+     * @returns attribute removed
      */
     AttributesCacheInMemory.prototype.removeAttribute = function (attributeName) {
         if (Object.keys(this.attributesCache).indexOf(attributeName) >= 0) {

package/esm/storages/inMemory/EventsCacheInMemory.js

@@ -2,7 +2,7 @@ var MAX_QUEUE_BYTE_SIZE = 5 * 1024 * 1024; // 5M
 var EventsCacheInMemory = /** @class */ (function () {
     /**
      *
-     * @param eventsQueueSize number of queued events to call onFullQueueCb.
+     * @param eventsQueueSize - number of queued events to call onFullQueueCb.
      * Default value is 0, that means no maximum value, in case we want to avoid this being triggered.
      */
     function EventsCacheInMemory(eventsQueueSize) {

package/esm/storages/inMemory/ImpressionsCacheInMemory.js

@@ -1,7 +1,7 @@
 var ImpressionsCacheInMemory = /** @class */ (function () {
     /**
      *
-     * @param impressionsQueueSize number of queued impressions to call onFullQueueCb.
+     * @param impressionsQueueSize - number of queued impressions to call onFullQueueCb.
      * Default value is 0, that means no maximum value, in case we want to avoid this being triggered.
      */
     function ImpressionsCacheInMemory(impressionsQueueSize) {

package/esm/storages/inMemory/InMemoryStorage.js

@@ -9,7 +9,7 @@ import { UniqueKeysCacheInMemory } from './UniqueKeysCacheInMemory';
 /**
  * InMemory storage factory for standalone server-side SplitFactory
  *
- * @param params parameters required by EventsCacheSync
+ * @param params - parameters required by EventsCacheSync
  */
 export function InMemoryStorageFactory(params) {
     var _a = params.settings, _b = _a.scheduler, impressionsQueueSize = _b.impressionsQueueSize, eventsQueueSize = _b.eventsQueueSize, _c = _a.sync, impressionsMode = _c.impressionsMode, __splitFiltersValidation = _c.__splitFiltersValidation;

package/esm/storages/inMemory/InMemoryStorageCS.js

@@ -9,7 +9,7 @@ import { UniqueKeysCacheInMemoryCS } from './UniqueKeysCacheInMemoryCS';
 /**
  * InMemory storage factory for standalone client-side SplitFactory
  *
- * @param params parameters required by EventsCacheSync
+ * @param params - parameters required by EventsCacheSync
  */
 export function InMemoryStorageCSFactory(params) {
     var _a = params.settings, _b = _a.scheduler, impressionsQueueSize = _b.impressionsQueueSize, eventsQueueSize = _b.eventsQueueSize, _c = _a.sync, impressionsMode = _c.impressionsMode, __splitFiltersValidation = _c.__splitFiltersValidation;

package/esm/storages/inMemory/UniqueKeysCacheInMemoryCS.js

@@ -3,7 +3,7 @@ import { setToArray } from '../../utils/lang/sets';
 var UniqueKeysCacheInMemoryCS = /** @class */ (function () {
     /**
      *
-     * @param impressionsQueueSize number of queued impressions to call onFullQueueCb.
+     * @param impressionsQueueSize - number of queued impressions to call onFullQueueCb.
      * Default value is 0, that means no maximum value, in case we want to avoid this being triggered.
      */
     function UniqueKeysCacheInMemoryCS(uniqueKeysQueueSize) {

package/esm/storages/inRedis/SplitsCacheInRedis.js

@@ -161,10 +161,8 @@ var SplitsCacheInRedis = /** @class */ (function (_super) {
      * Get list of all split definitions.
      * The returned promise is resolved with the list of split definitions,
      * or rejected if redis operation fails.
-     *
-     * @TODO we need to benchmark which is the maximun number of commands we could
-     *       pipeline without kill redis performance.
      */
+    // @TODO we need to benchmark which is the maximun number of commands we could pipeline without kill redis performance.
     SplitsCacheInRedis.prototype.getAll = function () {
         var _this = this;
         return this.redis.keys(this.keys.searchPatternForSplitKeys())

package/esm/storages/inRedis/TelemetryCacheInRedis.js

@@ -7,9 +7,9 @@ import { parseLatencyField, parseExceptionField, parseMetadata } from '../utils'
 var TelemetryCacheInRedis = /** @class */ (function () {
     /**
      * Create a Telemetry cache that uses Redis as storage.
-     * @param log  Logger instance.
-     * @param keys  Key builder.
-     * @param redis  Redis client.
+     * @param log -  Logger instance.
+     * @param keys -  Key builder.
+     * @param redis -  Redis client.
      */
     function TelemetryCacheInRedis(log, keys, redis) {
         this.log = log;

package/esm/storages/inRedis/UniqueKeysCacheInRedis.js

@@ -51,7 +51,7 @@ var UniqueKeysCacheInRedis = /** @class */ (function (_super) {
     };
     /**
      * Async consumer API, used by synchronizer.
-     * @param count number of items to pop from the queue. If not provided or equal 0, all items will be popped.
+     * @param count - number of items to pop from the queue. If not provided or equal 0, all items will be popped.
      */
     UniqueKeysCacheInRedis.prototype.popNRaw = function (count) {
         var _this = this;

package/esm/storages/pluggable/EventsCachePluggable.js

@@ -8,7 +8,7 @@ var EventsCachePluggable = /** @class */ (function () {
     }
     /**
      * Push given event to the storage.
-     * @param eventData  Event item to push.
+     * @param eventData -  Event item to push.
      * @returns  A promise that is resolved with a boolean value indicating if the push operation succeeded or failed.
      * Unlike `impressions::track`, The promise will never be rejected.
      */

package/esm/storages/pluggable/ImpressionsCachePluggable.js

@@ -8,7 +8,7 @@ var ImpressionsCachePluggable = /** @class */ (function () {
     }
     /**
      * Push given impressions to the storage.
-     * @param impressions  List of impresions to push.
+     * @param impressions -  List of impresions to push.
      * @returns  A promise that is resolved if the push operation succeeded
      * or rejected if the wrapper operation fails.
      */

package/esm/storages/pluggable/SegmentsCachePluggable.js

@@ -68,7 +68,7 @@ var SegmentsCachePluggable = /** @class */ (function () {
     SegmentsCachePluggable.prototype.getRegisteredSegments = function () {
         return this.wrapper.getItems(this.keys.buildRegisteredSegmentsKey());
     };
-    /** @TODO implement if required by DataLoader or Producer mode  */
+    // @TODO implement if required by DataLoader or Producer mode
     SegmentsCachePluggable.prototype.clear = function () {
         return Promise.resolve(true);
     };

package/esm/storages/pluggable/SplitsCachePluggable.js

@@ -10,9 +10,9 @@ var SplitsCachePluggable = /** @class */ (function (_super) {
     __extends(SplitsCachePluggable, _super);
     /**
      * Create a SplitsCache that uses a storage wrapper.
-     * @param log  Logger instance.
-     * @param keys  Key builder.
-     * @param wrapper  Adapted wrapper storage.
+     * @param log -  Logger instance.
+     * @param keys -  Key builder.
+     * @param wrapper -  Adapted wrapper storage.
      */
     function SplitsCachePluggable(log, keys, wrapper, splitFiltersValidation) {
         var _this = _super.call(this) || this;

package/esm/storages/pluggable/TelemetryCachePluggable.js

@@ -7,9 +7,9 @@ import { parseLatencyField, parseExceptionField, parseMetadata } from '../utils'
 var TelemetryCachePluggable = /** @class */ (function () {
     /**
      * Create a Telemetry cache that uses a storage wrapper.
-     * @param log  Logger instance.
-     * @param keys  Key builder.
-     * @param wrapper  Adapted wrapper storage.
+     * @param log -  Logger instance.
+     * @param keys -  Key builder.
+     * @param wrapper -  Adapted wrapper storage.
      */
     function TelemetryCachePluggable(log, keys, wrapper) {
         this.log = log;