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

package/esm/storages/pluggable/UniqueKeysCachePluggable.js

@@ -45,7 +45,7 @@ var UniqueKeysCachePluggable = /** @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.
      */
     UniqueKeysCachePluggable.prototype.popNRaw = function (count) {
         var _this = this;

package/esm/storages/pluggable/inMemoryWrapper.js

@@ -5,7 +5,7 @@ import { setToArray } from '../../utils/lang/sets';
  * The `_cache` property is the object were items are stored.
  * Intended for testing purposes.
  *
- * @param connDelay delay in millis for `connect` resolve. If not provided, `connect` resolves immediately.
+ * @param connDelay - delay in millis for `connect` resolve. If not provided, `connect` resolves immediately.
  */
 export function inMemoryWrapperFactory(connDelay) {
     var _cache = {};

package/esm/storages/pluggable/index.js

@@ -24,7 +24,7 @@ var NO_VALID_WRAPPER_INTERFACE = 'The provided wrapper instance doesn’t follow
 /**
  * Validate pluggable storage factory options.
  *
- * @param options user options
+ * @param options - user options
  * @throws Will throw an error if the options are invalid. Example: wrapper is not provided or doesn't have some methods.
  */
 function validatePluggableStorageOptions(options) {

package/esm/storages/pluggable/wrapperAdapter.js

@@ -22,8 +22,8 @@ export var METHODS_TO_PROMISE_WRAP = [
  * 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 storage wrapper to adapt
+ * @param log - logger instance
+ * @param wrapper - storage wrapper to adapt
  * @returns an adapted version of the given storage wrapper
  */
 export function wrapperAdapter(log, wrapper) {

package/esm/sync/offline/splitsParser/splitsParserFromSettings.js

@@ -30,7 +30,7 @@ export function splitsParserFromSettingsFactory() {
     }
     /**
      *
-     * @param settings validated object with mocked features mapping.
+     * @param settings - validated object with mocked features mapping.
      */
     return function splitsParserFromSettings(settings) {
         var features = settings.features || {};

package/esm/sync/offline/syncManagerOffline.js

@@ -8,7 +8,7 @@ function flush() {
  * Offline SyncManager factory.
  * Can be used for server-side API, and client-side API with or without multiple clients.
  *
- * @param splitsParser e.g., `splitsParserFromFile`, `splitsParserFromSettings`.
+ * @param splitsParser - e.g., `splitsParserFromFile`, `splitsParserFromSettings`.
  */
 export function syncManagerOfflineFactory(splitsParserFactory) {
     /**

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

@@ -63,12 +63,12 @@ export function mySegmentsUpdaterFactory(log, mySegmentsFetcher, storage, segmen
      * MySegments updater returns a promise that resolves with a `false` boolean value if it fails to fetch mySegments or synchronize them with the storage.
      * Returned promise will not be rejected.
      *
-     * @param {SegmentsData | undefined} segmentsData it can be:
+     * @param segmentsData - it can be:
      *  (1) the list of mySegments names to sync in the storage,
      *  (2) an object with a segment name and action (true: add, or false: delete) to update the storage,
      *  (3) or `undefined`, for which the updater will fetch mySegments in order to sync the storage.
-     * @param {boolean | undefined} noCache true to revalidate data to fetch
-     * @param {boolean | undefined} till query param to bypass CDN requests
+     * @param noCache - true to revalidate data to fetch
+     * @param till - query param to bypass CDN requests
      */
     return function mySegmentsUpdater(segmentsData, noCache, till) {
         return _mySegmentsUpdater(0, segmentsData, noCache, till);

package/esm/sync/polling/updaters/segmentChangesUpdater.js

@@ -6,10 +6,10 @@ import { LOG_PREFIX_INSTANTIATION, LOG_PREFIX_SYNC_SEGMENTS } from '../../../log
  *  - updates `segmentsCache`
  *  - uses `segmentsEventEmitter` to emit events related to segments data updates
  *
- * @param log logger instance
- * @param segmentChangesFetcher fetcher of `/segmentChanges`
- * @param segments segments storage, with sync or async methods
- * @param readiness optional readiness manager. Not required for synchronizer or producer mode.
+ * @param log - logger instance
+ * @param segmentChangesFetcher - fetcher of `/segmentChanges`
+ * @param segments - segments storage, with sync or async methods
+ * @param readiness - optional readiness manager. Not required for synchronizer or producer mode.
  */
 export function segmentChangesUpdaterFactory(log, segmentChangesFetcher, segments, readiness) {
     var readyOnAlreadyExistentState = true;
@@ -35,11 +35,11 @@ export function segmentChangesUpdaterFactory(log, segmentChangesFetcher, segment
      * Thus, a false result doesn't imply that SDK_SEGMENTS_ARRIVED was not emitted.
      * Returned promise will not be rejected.
      *
-     * @param {boolean | undefined} fetchOnlyNew if true, only fetch the segments that not exists, i.e., which `changeNumber` is equal to -1.
+     * @param fetchOnlyNew - if true, only fetch the segments that not exists, i.e., which `changeNumber` is equal to -1.
      * This param is used by SplitUpdateWorker on server-side SDK, to fetch new registered segments on SPLIT_UPDATE notifications.
-     * @param {string | undefined} segmentName segment name to fetch. By passing `undefined` it fetches the list of segments registered at the storage
-     * @param {boolean | undefined} noCache true to revalidate data to fetch on a SEGMENT_UPDATE notifications.
-     * @param {number | undefined} till till target for the provided segmentName, for CDN bypass.
+     * @param segmentName - segment name to fetch. By passing `undefined` it fetches the list of segments registered at the storage
+     * @param noCache - true to revalidate data to fetch on a SEGMENT_UPDATE notifications.
+     * @param till - till target for the provided segmentName, for CDN bypass.
      */
     return function segmentChangesUpdater(fetchOnlyNew, segmentName, noCache, till) {
         log.debug(LOG_PREFIX_SYNC_SEGMENTS + "Started segments update");

package/esm/sync/polling/updaters/splitChangesUpdater.js

@@ -34,8 +34,8 @@ export function parseSegments(_a) {
  * If there are defined filters and one feature flag doesn't match with them, its status is changed to 'ARCHIVE' to avoid storing it
  * If there are set filter defined, names filter is ignored
  *
- * @param featureFlag feature flag to be evaluated
- * @param filters splitFiltersValidation bySet | byName
+ * @param featureFlag - feature flag to be evaluated
+ * @param filters - splitFiltersValidation bySet | byName
  */
 function matchFilters(featureFlag, filters) {
     var _a = filters.groupedFilters, setsFilter = _a.bySet, namesFilter = _a.byName, prefixFilter = _a.byPrefix;
@@ -77,13 +77,13 @@ export function computeSplitsMutation(entries, filters) {
  *  - updates `splitsCache`
  *  - uses `splitsEventEmitter` to emit events related to split data updates
  *
- * @param log  Logger instance
- * @param splitChangesFetcher  Fetcher of `/splitChanges`
- * @param splits  Splits storage, with sync or async methods
- * @param segments  Segments storage, with sync or async methods
- * @param splitsEventEmitter  Optional readiness manager. Not required for synchronizer or producer mode.
- * @param requestTimeoutBeforeReady  How long the updater will wait for the request to timeout. Default 0, i.e., never timeout.
- * @param retriesOnFailureBeforeReady  How many retries on `/splitChanges` we the updater do in case of failure or timeout. Default 0, i.e., no retries.
+ * @param log -  Logger instance
+ * @param splitChangesFetcher -  Fetcher of `/splitChanges`
+ * @param splits -  Splits storage, with sync or async methods
+ * @param segments -  Segments storage, with sync or async methods
+ * @param splitsEventEmitter -  Optional readiness manager. Not required for synchronizer or producer mode.
+ * @param requestTimeoutBeforeReady -  How long the updater will wait for the request to timeout. Default 0, i.e., never timeout.
+ * @param retriesOnFailureBeforeReady -  How many retries on `/splitChanges` we the updater do in case of failure or timeout. Default 0, i.e., no retries.
  */
 export function splitChangesUpdaterFactory(log, splitChangesFetcher, splits, segments, splitFiltersValidation, splitsEventEmitter, requestTimeoutBeforeReady, retriesOnFailureBeforeReady, isClientSide) {
     if (requestTimeoutBeforeReady === void 0) { requestTimeoutBeforeReady = 0; }
@@ -110,13 +110,13 @@ export function splitChangesUpdaterFactory(log, splitChangesFetcher, splits, seg
      * SplitChanges updater returns a promise that resolves with a `false` boolean value if it fails to fetch splits or synchronize them with the storage.
      * Returned promise will not be rejected.
      *
-     * @param {boolean | undefined} noCache true to revalidate data to fetch
-     * @param {boolean | undefined} till query param to bypass CDN requests
+     * @param noCache - true to revalidate data to fetch
+     * @param till - query param to bypass CDN requests
      */
     return function splitChangesUpdater(noCache, till, splitUpdateNotification) {
         /**
-         * @param {number} since current changeNumber at splitsCache
-         * @param {number} retry current number of retry attempts
+         * @param since - current changeNumber at splitsCache
+         * @param retry - current number of retry attempts
          */
         function _splitChangesUpdater(since, retry) {
             if (retry === void 0) { retry = 0; }

package/esm/sync/streaming/AuthClient/index.js

@@ -5,12 +5,12 @@ import { hash } from '../../../utils/murmur3/murmur3';
 /**
  * Factory of authentication function.
  *
- * @param fetchAuth `SplitAPI.fetchAuth` endpoint
+ * @param fetchAuth - `SplitAPI.fetchAuth` endpoint
  */
 export function authenticateFactory(fetchAuth) {
     /**
      * Run authentication requests to Auth Server, and returns a promise that resolves with the decoded JTW token.
-     * @param {string[] | undefined} userKeys set of user Keys to track membership updates. It is undefined for server-side API.
+     * @param userKeys - set of user Keys to track membership updates. It is undefined for server-side API.
      */
     return function authenticate(userKeys) {
         return fetchAuth(userKeys)

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

@@ -6,8 +6,8 @@ var CONTROL_CHANNEL_REGEX = /^control_/;
 /**
  * Build metadata headers for SSE connection.
  *
- * @param {ISettings} settings Validated settings.
- * @returns {Record<string, string>} Headers object
+ * @param settings - Validated settings.
+ * @returns Headers object
  */
 function buildSSEHeaders(settings) {
     var headers = {
@@ -29,8 +29,8 @@ var SSEClient = /** @class */ (function () {
     /**
      * SSEClient constructor.
      *
-     * @param settings Validated settings.
-     * @param platform object containing environment-specific dependencies
+     * @param settings - Validated settings.
+     * @param platform - object containing environment-specific dependencies
      * @throws 'EventSource API is not available.' if EventSource is not available.
      */
     function SSEClient(settings, _a) {
@@ -48,9 +48,6 @@ var SSEClient = /** @class */ (function () {
     };
     /**
      * Open the connection with a given authToken
-     *
-     * @param {IAuthTokenPushEnabled} authToken
-     * @throws {TypeError} Will throw an error if `authToken` is undefined
      */
     SSEClient.prototype.open = function (authToken) {
         var _a;

package/esm/sync/streaming/SSEHandler/NotificationKeeper.js

@@ -5,7 +5,7 @@ var STREAMING_EVENT_TYPES = [OCCUPANCY_PRI, OCCUPANCY_SEC];
 /**
  * Factory of notification keeper, which process OCCUPANCY and CONTROL notifications and emits the corresponding push events.
  *
- * @param pushEmitter emitter for events related to streaming support
+ * @param pushEmitter - emitter for events related to streaming support
  */
 // @TODO update logic to handle OCCUPANCY for any region and rename according to new spec (e.g.: PUSH_SUBSYSTEM_UP --> PUSH_SUBSYSTEM_UP)
 export function notificationKeeperFactory(pushEmitter, telemetryTracker) {

package/esm/sync/streaming/SSEHandler/NotificationParser.js

@@ -5,8 +5,9 @@ import { isString } from '../../../utils/lang';
  * HTTP errors handled by Ably (e.g., 400 due to invalid token, 401 due to expired token, 500) have the `data` property.
  * Other network and HTTP errors do not have this property.
  *
- * @param {Object} error
- * @throws {SyntaxError} if `error.data` is an invalid JSON string
+ * @param error - The error event to parse
+ * @returns parsed notification error
+ * @throws SyntaxError if `error.data` is an invalid JSON string
  */
 export function errorParser(error) {
     // @ts-ignore
@@ -18,10 +19,10 @@ export function errorParser(error) {
  * Parses the `data` JSON string of a given SSE message notifications.
  * Also assigns the type OCCUPANCY, if it corresponds, so that all supported messages (e.g., SPLIT_UPDATE, CONTROL) have a type.
  *
- * @param message
+ * @param message - The message event to parse
  * @returns parsed notification message or undefined if the given event data is falsy (e.g, '' or undefined).
  * For example, the EventSource implementation of React-Native for iOS emits a message event with empty data for Ably keepalive comments.
- * @throws {SyntaxError} if `message.data` or `JSON.parse(message.data).data` are invalid JSON strings
+ * @throws SyntaxError if `message.data` or `JSON.parse(message.data).data` are invalid JSON strings
  */
 export function messageParser(message) {
     if (!message.data)

package/esm/sync/streaming/SSEHandler/index.js

@@ -6,8 +6,8 @@ import { ABLY_ERROR, NON_REQUESTED, SSE_CONNECTION_ERROR } from '../../../utils/
 /**
  * Factory for SSEHandler, which processes SSEClient messages and emits the corresponding push events.
  *
- * @param log factory logger
- * @param pushEmitter emitter for events related to streaming support
+ * @param log - factory logger
+ * @param pushEmitter - emitter for events related to streaming support
  */
 export function SSEHandlerFactory(log, pushEmitter, telemetryTracker) {
     var notificationKeeper = notificationKeeperFactory(pushEmitter, telemetryTracker);

package/esm/sync/streaming/UpdateWorkers/MySegmentsUpdateWorker.js

@@ -76,9 +76,9 @@ export function MySegmentsUpdateWorker(log, storage, mySegmentsSyncTask, telemet
             /**
              * Invoked by NotificationProcessor on MY_(LARGE)_SEGMENTS_UPDATE notifications
              *
-             * @param changeNumber change number of the notification
-             * @param segmentsData data for KeyList or SegmentRemoval instant updates
-             * @param delay optional time to wait for BoundedFetchRequest or BoundedFetchRequest updates
+             * @param changeNumber - change number of the notification
+             * @param segmentsData - data for KeyList or SegmentRemoval instant updates
+             * @param delay - optional time to wait for BoundedFetchRequest or BoundedFetchRequest updates
              */
             put: function (mySegmentsData, payload, delay) {
                 var type = mySegmentsData.type, cn = mySegmentsData.cn;

package/esm/sync/streaming/UpdateWorkers/SegmentsUpdateWorker.js

@@ -72,8 +72,8 @@ export function SegmentsUpdateWorker(log, segmentsSyncTask, segmentsCache) {
         /**
          * Invoked by NotificationProcessor on SEGMENT_UPDATE event
          *
-         * @param {number} changeNumber change number of the SEGMENT_UPDATE notification
-         * @param {string} segmentName segment name of the SEGMENT_UPDATE notification
+         * @param changeNumber - change number of the SEGMENT_UPDATE notification
+         * @param segmentName - segment name of the SEGMENT_UPDATE notification
          */
         put: function (_a) {
             var changeNumber = _a.changeNumber, segmentName = _a.segmentName;

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

@@ -59,7 +59,7 @@ export function SplitsUpdateWorker(log, splitsCache, splitsSyncTask, splitsEvent
     /**
      * Invoked by NotificationProcessor on SPLIT_UPDATE event
      *
-     * @param {number} changeNumber change number of the SPLIT_UPDATE notification
+     * @param changeNumber - change number of the SPLIT_UPDATE notification
      */
     function put(_a, _payload) {
         var changeNumber = _a.changeNumber, pcn = _a.pcn;
@@ -82,9 +82,9 @@ export function SplitsUpdateWorker(log, splitsCache, splitsSyncTask, splitsEvent
         /**
          * Invoked by NotificationProcessor on SPLIT_KILL event
          *
-         * @param {number} changeNumber change number of the SPLIT_UPDATE notification
-         * @param {string} splitName name of split to kill
-         * @param {string} defaultTreatment default treatment value
+         * @param changeNumber - change number of the SPLIT_UPDATE notification
+         * @param splitName - name of split to kill
+         * @param defaultTreatment - default treatment value
          */
         killSplit: function (_a) {
             var changeNumber = _a.changeNumber, splitName = _a.splitName, defaultTreatment = _a.defaultTreatment;

package/esm/sync/streaming/parseUtils.js

@@ -13,9 +13,9 @@ function StringToUint8Array(myString) {
 /**
  * Decode and decompress 'data' with 'compression' algorithm
  *
- * @param {string} data
- * @param {number} compression 1 GZIP, 2 ZLIB
- * @returns {Uint8Array}
+ * @param data - base64 encoded string
+ * @param compression - 1 GZIP, 2 ZLIB
+ * @returns
  * @throws if data string cannot be decoded, decompressed or the provided compression value is invalid (not 1 or 2)
  */
 function decompress(data, compression) {
@@ -32,10 +32,10 @@ function decompress(data, compression) {
 /**
  * Decode, decompress and parse the provided 'data' into a KeyList object
  *
- * @param {string} data
- * @param {number} compression
- * @param {boolean} avoidPrecisionLoss true as default, set it as false if dont need to avoid precission loss
- * @returns {{a?: string[], r?: string[] }}
+ * @param data - base64 encoded string
+ * @param compression - 1 GZIP, 2 ZLIB
+ * @param avoidPrecisionLoss - true as default, set it as false if dont need to avoid precission loss
+ * @returns keyList
  * @throws if data string cannot be decoded, decompressed or parsed
  */
 export function parseKeyList(data, compression, avoidPrecisionLoss) {
@@ -50,9 +50,9 @@ export function parseKeyList(data, compression, avoidPrecisionLoss) {
 /**
  * Decode, decompress and parse the provided 'data' into a Bitmap object
  *
- * @param {string} data
- * @param {number} compression
- * @returns {Uint8Array}
+ * @param data - base64 encoded string
+ * @param compression - 1 GZIP, 2 ZLIB
+ * @returns Bitmap
  * @throws if data string cannot be decoded or decompressed
  */
 export function parseBitmap(data, compression) {
@@ -61,9 +61,9 @@ export function parseBitmap(data, compression) {
 /**
  * Check if the 'bitmap' bit at 'hash64hex' position is 1
  *
- * @param {Uint8Array} bitmap
- * @param {string} hash64hex 16-chars string, representing a number in hexa
- * @returns {boolean}
+ * @param bitmap - Uint8Array bitmap
+ * @param hash64hex - 16-chars string, representing a number in hexa
+ * @returns whether the provided 'hash64hex' index is set in the bitmap
  */
 export function isInBitmap(bitmap, hash64hex) {
     // using the lowest 32 bits as index, to avoid losing precision when converting to number

package/esm/sync/syncManagerOnline.js

@@ -7,9 +7,9 @@ import { POLLING, STREAMING, SYNC_MODE_UPDATE } from '../utils/constants';
  * Online SyncManager factory.
  * Can be used for server-side API, and client-side API with or without multiple clients.
  *
- * @param pollingManagerFactory allows to specialize the SyncManager for server-side or client-side API by passing
+ * @param pollingManagerFactory - allows to specialize the SyncManager for server-side or client-side API by passing
  * `pollingManagerSSFactory` or `pollingManagerCSFactory` respectively.
- * @param pushManagerFactory optional to build a SyncManager with or without streaming support
+ * @param pushManagerFactory - optional to build a SyncManager with or without streaming support
  */
 export function syncManagerOnlineFactory(pollingManagerFactory, pushManagerFactory) {
     /**

package/esm/sync/syncTask.js

@@ -3,10 +3,10 @@ import { SYNC_TASK_EXECUTE, SYNC_TASK_START, SYNC_TASK_STOP } from '../logger/co
  * Creates an object that handles the periodic execution of a given task via "start" and "stop" methods.
  * The task can be also executed by calling the "execute" method. Multiple calls run sequentially to avoid race conditions (e.g., submitters executed on SDK destroy or full queue, while periodic execution is pending).
  *
- * @param log  Logger instance.
- * @param task  Task to execute that returns a promise that NEVER REJECTS. Otherwise, periodic execution can result in Unhandled Promise Rejections.
- * @param period  Period in milliseconds to execute the task.
- * @param taskName  Optional task name for logging.
+ * @param log -  Logger instance.
+ * @param task -  Task to execute that returns a promise that NEVER REJECTS. Otherwise, periodic execution can result in Unhandled Promise Rejections.
+ * @param period -  Period in milliseconds to execute the task.
+ * @param taskName -  Optional task name for logging.
  * @returns A sync task that wraps the given task.
  */
 export function syncTaskFactory(log, task, period, taskName) {

package/esm/trackers/eventTracker.js

@@ -6,8 +6,8 @@ import { isConsumerMode } from '../utils/settingsValidation/mode';
 /**
  * Event tracker stores events in cache and pass them to the integrations manager if provided.
  *
- * @param eventsCache cache to save events
- * @param integrationsManager optional event handler used for integrations
+ * @param eventsCache - cache to save events
+ * @param integrationsManager - optional event handler used for integrations
  */
 export function eventTrackerFactory(settings, eventsCache, whenInit, integrationsManager, telemetryCache) {
     var log = settings.log, mode = settings.mode;

package/esm/trackers/impressionsTracker.js

@@ -5,11 +5,11 @@ import { CONSENT_DECLINED, DEDUPED, QUEUED } from '../utils/constants';
 /**
  * Impressions tracker stores impressions in cache and pass them to the listener and integrations manager if provided.
  *
- * @param impressionsCache cache to save impressions
- * @param metadata runtime metadata (ip, hostname and version)
- * @param impressionListener optional impression listener
- * @param integrationsManager optional integrations manager
- * @param strategy strategy for impressions tracking.
+ * @param impressionsCache - cache to save impressions
+ * @param metadata - runtime metadata (ip, hostname and version)
+ * @param impressionListener - optional impression listener
+ * @param integrationsManager - optional integrations manager
+ * @param strategy - strategy for impressions tracking.
  */
 export function impressionsTrackerFactory(settings, impressionsCache, strategy, whenInit, integrationsManager, telemetryCache) {
     var log = settings.log, impressionListener = settings.impressionListener, _a = settings.runtime, ip = _a.ip, hostname = _a.hostname, version = settings.version;

package/esm/trackers/strategy/strategyDebug.js

@@ -1,7 +1,7 @@
 /**
  * Debug strategy for impressions tracker. Wraps impressions to store and adds previousTime if it corresponds
  *
- * @param impressionsObserver impression observer. Previous time (pt property) is included in impression instances
+ * @param impressionsObserver - impression observer. Previous time (pt property) is included in impression instances
  * @returns IStrategyResult
  */
 export function strategyDebugFactory(impressionsObserver) {

package/esm/trackers/strategy/strategyNone.js

@@ -1,8 +1,8 @@
 /**
  * None strategy for impressions tracker.
  *
- * @param impressionsCounter cache to save impressions count. impressions will be deduped (OPTIMIZED mode)
- * @param uniqueKeysTracker unique keys tracker in charge of tracking the unique keys per split.
+ * @param impressionsCounter - cache to save impressions count. impressions will be deduped (OPTIMIZED mode)
+ * @param uniqueKeysTracker - unique keys tracker in charge of tracking the unique keys per split.
  * @returns IStrategyResult
  */
 export function strategyNoneFactory(impressionsCounter, uniqueKeysTracker) {

package/esm/trackers/strategy/strategyOptimized.js

@@ -2,8 +2,8 @@ import { truncateTimeFrame } from '../../utils/time';
 /**
  * Optimized strategy for impressions tracker. Wraps impressions to store and adds previousTime if it corresponds
  *
- * @param impressionsObserver impression observer. previous time (pt property) is included in impression instances
- * @param impressionsCounter cache to save impressions count. impressions will be deduped (OPTIMIZED mode)
+ * @param impressionsObserver - impression observer. previous time (pt property) is included in impression instances
+ * @param impressionsCounter - cache to save impressions count. impressions will be deduped (OPTIMIZED mode)
  * @returns IStrategyResult
  */
 export function strategyOptimizedFactory(impressionsObserver, impressionsCounter) {

package/esm/trackers/uniqueKeysTracker.js

@@ -9,9 +9,9 @@ var noopFilterAdapter = {
  * Unique Keys Tracker will be in charge of checking if the MTK was already sent to the BE in the last period
  * or schedule to be sent; if not it will be added in an internal cache and sent in the next post.
  *
- * @param log Logger instance
- * @param uniqueKeysCache cache to save unique keys
- * @param filterAdapter filter adapter
+ * @param log - Logger instance
+ * @param uniqueKeysCache - cache to save unique keys
+ * @param filterAdapter - filter adapter
  */
 export function uniqueKeysTrackerFactory(log, uniqueKeysCache, filterAdapter) {
     if (filterAdapter === void 0) { filterAdapter = noopFilterAdapter; }

package/esm/utils/Backoff.js

@@ -1,10 +1,6 @@
 var Backoff = /** @class */ (function () {
     /**
      * Schedule function calls with exponential backoff
-     *
-     * @param {function} cb
-     * @param {number} baseMillis
-     * @param {number} maxMillis
      */
     function Backoff(cb, baseMillis, maxMillis) {
         this.baseMillis = Backoff.__TEST__BASE_MILLIS || baseMillis || Backoff.DEFAULT_BASE_MILLIS;

package/esm/utils/Semver.js

@@ -70,7 +70,7 @@ var Semver = /** @class */ (function () {
     /**
      * Precedence comparision between 2 Semver objects.
      *
-     * @return `0` if `this === toCompare`, `-1` if `this < toCompare`, and `1` if `this > toCompare`
+     * @returns `0` if `this === toCompare`, `-1` if `this < toCompare`, and `1` if `this > toCompare`
      */
     Semver.prototype.compare = function (toCompare) {
         if (this.version === toCompare.version)

package/esm/utils/base64/index.js

@@ -20,7 +20,7 @@ var chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
 /**
  * Decode a given string value in Base64 format
  *
- * @param {string} input value to decode
+ * @param input - value to decode
  */
 export function decodeFromBase64(input) {
     var str = (String(input)).replace(/[=]+$/, ''); // #31: ExtendScript bad parse of /=
@@ -45,7 +45,7 @@ export function decodeFromBase64(input) {
 /**
  * Encode a given string value to Base64 format.
  *
- * @param {string} input value to encode
+ * @param input - value to encode
  */
 export function encodeToBase64(input) {
     var str = String(input);

package/esm/utils/decompress/index.js

@@ -404,8 +404,8 @@ export var algorithms = (function iifeDecompress() {
     return {
         /**
          * Expands GZIP data
-         * @param data The data to decompress
-         * @param out Where to write the data. GZIP already encodes the output size, so providing this doesn't save memory.
+         * @param data - The data to decompress
+         * @param out - Where to write the data. GZIP already encodes the output size, so providing this doesn't save memory.
          * @returns The decompressed version of the data
          */
         gunzipSync: function (data, out) {
@@ -413,8 +413,8 @@ export var algorithms = (function iifeDecompress() {
         },
         /**
          * Expands Zlib data
-         * @param data The data to decompress
-         * @param out Where to write the data. Saves memory if you know the decompressed size and provide an output buffer of that length.
+         * @param data - The data to decompress
+         * @param out - Where to write the data. Saves memory if you know the decompressed size and provide an output buffer of that length.
          * @returns The decompressed version of the data
          */
         unzlibSync: function (data, out) {

package/esm/utils/lang/binarySearch.js

@@ -1,8 +1,8 @@
 /**
  * Searches the index of the specified `value` inside an ordered array of `items` using the binary search algorithm.
  *
- * @param items the array to be searched
- * @param value the value to be searched for
+ * @param items - the array to be searched
+ * @param value - the value to be searched for
  * @returns integer number between 0 and `items.length`. This value is the index of the search value,
  * if it is contained in the array, or the index at which the value should be inserted to keep the array ordered.
  */

package/esm/utils/murmur3/murmur3_128.js

@@ -208,7 +208,7 @@ function hash128x64(key, seed) {
 /**
  * x64 version of Murmur3 for 128bits.
  *
- * @param {string} str
+ * @param str - The string to hash.
  */
 export function hash128(str, seed) {
     return hash128x64(UTF16ToUTF8(str), seed >>> 0);

package/esm/utils/murmur3/murmur3_128_x86.js

@@ -143,7 +143,7 @@ function hash128x86(key, seed) {
  * x86 version of Murmur3 for 128bits.
  * Used by hashImpression128 because in JS it is more efficient than the x64 version, no matter the underlying OS/CPU arch.
  *
- * @param {string} str
+ * @param str - The string to hash.
  */
 export function hash128(str, seed) {
     return hash128x86(UTF16ToUTF8(str), seed >>> 0);

package/esm/utils/murmur3/murmur3_64.js

@@ -21,7 +21,7 @@ function hex2dec(s) {
 /**
  * Gets the higher 64 bits of the x64 version of Murmur3 for 128bits, as decimal and hexadecimal number strings.
  * Used for MySegments channel V2 notifications.
- * @param {string} str
+ * @param str - The string to hash
  */
 export function hash64(str) {
     var hex = hash128(str).slice(0, 16);