@splitsoftware/splitio-commons 2.5.0-rc.0 → 11.5.0-rc.0

package/esm/utils/inputValidation/key.js

@@ -1,47 +0,0 @@
-import { isObject, isString, isFiniteNumber, toString } from '../lang';
-import { ERROR_NULL, WARN_CONVERTING, ERROR_EMPTY, ERROR_TOO_LONG, ERROR_INVALID, ERROR_INVALID_KEY_OBJECT } from '../../logger/constants';
-var KEY_MAX_LENGTH = 250;
-function validateKeyValue(log, maybeKey, method, type) {
-    if (maybeKey == undefined) { // eslint-disable-line eqeqeq
-        log.error(ERROR_NULL, [method, type]);
-        return false;
-    }
-    if (isFiniteNumber(maybeKey)) {
-        log.warn(WARN_CONVERTING, [method, type, maybeKey]);
-        return toString(maybeKey);
-    }
-    if (isString(maybeKey)) {
-        // It's a string, start by trimming the value.
-        maybeKey = maybeKey.trim();
-        // It's aaaaaall good.
-        if (maybeKey.length > 0 && maybeKey.length <= KEY_MAX_LENGTH)
-            return maybeKey;
-        if (maybeKey.length === 0) {
-            log.error(ERROR_EMPTY, [method, type]);
-        }
-        else if (maybeKey.length > KEY_MAX_LENGTH) {
-            log.error(ERROR_TOO_LONG, [method, type]);
-        }
-    }
-    else {
-        log.error(ERROR_INVALID, [method, type]);
-    }
-    return false;
-}
-export function validateKey(log, maybeKey, method) {
-    if (isObject(maybeKey)) {
-        // Validate key object
-        var matchingKey = validateKeyValue(log, maybeKey.matchingKey, method, 'matchingKey');
-        var bucketingKey = validateKeyValue(log, maybeKey.bucketingKey, method, 'bucketingKey');
-        if (matchingKey && bucketingKey)
-            return {
-                matchingKey: matchingKey,
-                bucketingKey: bucketingKey
-            };
-        log.error(ERROR_INVALID_KEY_OBJECT, [method]);
-        return false;
-    }
-    else {
-        return validateKeyValue(log, maybeKey, method, 'key');
-    }
-}

package/esm/utils/inputValidation/preloadedData.js

@@ -1,55 +0,0 @@
-import { isObject, isString, isFiniteNumber } from '../lang';
-import { validateSplit } from './split';
-function validateTimestampData(log, maybeTimestamp, method, item) {
-    if (isFiniteNumber(maybeTimestamp) && maybeTimestamp > -1)
-        return true;
-    log.error(method + ": preloadedData." + item + " must be a positive number.");
-    return false;
-}
-function validateSplitsData(log, maybeSplitsData, method) {
-    if (isObject(maybeSplitsData)) {
-        var splitNames = Object.keys(maybeSplitsData);
-        if (splitNames.length === 0)
-            log.warn(method + ": preloadedData.splitsData doesn't contain feature flag definitions.");
-        // @TODO in the future, consider handling the possibility of having parsed definitions of splits
-        if (splitNames.every(function (splitName) { return validateSplit(log, splitName, method) && isString(maybeSplitsData[splitName]); }))
-            return true;
-    }
-    log.error(method + ": preloadedData.splitsData must be a map of feature flag names to their stringified definitions.");
-    return false;
-}
-function validateMySegmentsData(log, maybeMySegmentsData, method) {
-    if (isObject(maybeMySegmentsData)) {
-        var userKeys = Object.keys(maybeMySegmentsData);
-        if (userKeys.every(function (userKey) {
-            var segmentNames = maybeMySegmentsData[userKey];
-            // an empty list is valid
-            return Array.isArray(segmentNames) && segmentNames.every(function (segmentName) { return isString(segmentName); });
-        }))
-            return true;
-    }
-    log.error(method + ": preloadedData.mySegmentsData must be a map of user keys to their list of segment names.");
-    return false;
-}
-function validateSegmentsData(log, maybeSegmentsData, method) {
-    if (isObject(maybeSegmentsData)) {
-        var segmentNames = Object.keys(maybeSegmentsData);
-        if (segmentNames.every(function (segmentName) { return isString(maybeSegmentsData[segmentName]); }))
-            return true;
-    }
-    log.error(method + ": preloadedData.segmentsData must be a map of segment names to their stringified definitions.");
-    return false;
-}
-export function validatePreloadedData(log, maybePreloadedData, method) {
-    if (!isObject(maybePreloadedData)) {
-        log.error(method + ": preloadedData must be an object.");
-    }
-    else if (validateTimestampData(log, maybePreloadedData.lastUpdated, method, 'lastUpdated') &&
-        validateTimestampData(log, maybePreloadedData.since, method, 'since') &&
-        validateSplitsData(log, maybePreloadedData.splitsData, method) &&
-        (!maybePreloadedData.mySegmentsData || validateMySegmentsData(log, maybePreloadedData.mySegmentsData, method)) &&
-        (!maybePreloadedData.segmentsData || validateSegmentsData(log, maybePreloadedData.segmentsData, method))) {
-        return true;
-    }
-    return false;
-}

package/esm/utils/inputValidation/split.js

@@ -1,26 +0,0 @@
-import { ERROR_NULL, ERROR_INVALID, WARN_TRIMMING, ERROR_EMPTY } from '../../logger/constants';
-import { isString } from '../lang';
-// include BOM and nbsp
-var TRIMMABLE_SPACES_REGEX = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/;
-export function validateSplit(log, maybeSplit, method, item) {
-    if (item === void 0) { item = 'feature flag name'; }
-    if (maybeSplit == undefined) { // eslint-disable-line eqeqeq
-        log.error(ERROR_NULL, [method, item]);
-    }
-    else if (!isString(maybeSplit)) {
-        log.error(ERROR_INVALID, [method, item]);
-    }
-    else {
-        if (TRIMMABLE_SPACES_REGEX.test(maybeSplit)) {
-            log.warn(WARN_TRIMMING, [method, item, maybeSplit]);
-            maybeSplit = maybeSplit.trim();
-        }
-        if (maybeSplit.length > 0) {
-            return maybeSplit;
-        }
-        else {
-            log.error(ERROR_EMPTY, [method, item]);
-        }
-    }
-    return false;
-}

package/esm/utils/inputValidation/splitExistence.js

@@ -1,15 +0,0 @@
-import { SPLIT_NOT_FOUND } from '../labels';
-import { WARN_NOT_EXISTENT_SPLIT } from '../../logger/constants';
-/**
- * This is defined here and in this format mostly because of the logger and the fact that it's considered a validation at product level.
- * But it's not going to run on the input validation layer. In any case, the most compeling reason to use it as we do is to avoid going to Redis and get a split twice.
- */
-export function validateSplitExistence(log, readinessManager, splitName, labelOrSplitObj, method) {
-    if (readinessManager.isReady()) { // Only if it's ready we validate this, otherwise it may just be that the SDK is not ready yet.
-        if (labelOrSplitObj === SPLIT_NOT_FOUND || labelOrSplitObj == null) {
-            log.warn(WARN_NOT_EXISTENT_SPLIT, [method, splitName]);
-            return false;
-        }
-    }
-    return true;
-}

package/esm/utils/inputValidation/splits.js

@@ -1,21 +0,0 @@
-import { ERROR_EMPTY_ARRAY } from '../../logger/constants';
-import { uniq } from '../lang';
-import { validateSplit } from './split';
-export function validateSplits(log, maybeSplits, method, listName, item) {
-    if (listName === void 0) { listName = 'feature flag names'; }
-    if (item === void 0) { item = 'feature flag name'; }
-    if (Array.isArray(maybeSplits) && maybeSplits.length > 0) {
-        var validatedArray_1 = [];
-        // Remove invalid values
-        maybeSplits.forEach(function (maybeSplit) {
-            var splitName = validateSplit(log, maybeSplit, method, item);
-            if (splitName)
-                validatedArray_1.push(splitName);
-        });
-        // Strip off duplicated values if we have valid split names then return
-        if (validatedArray_1.length)
-            return uniq(validatedArray_1);
-    }
-    log.error(ERROR_EMPTY_ARRAY, [method, listName]);
-    return false;
-}

package/esm/utils/inputValidation/trafficType.js

@@ -1,25 +0,0 @@
-import { ERROR_NULL, ERROR_INVALID, ERROR_EMPTY, WARN_LOWERCASE_TRAFFIC_TYPE } from '../../logger/constants';
-import { isString } from '../lang';
-var CAPITAL_LETTERS_REGEX = /[A-Z]/;
-var item = 'traffic_type';
-export function validateTrafficType(log, maybeTT, method) {
-    if (maybeTT == undefined) { // eslint-disable-line eqeqeq
-        log.error(ERROR_NULL, [method, item]);
-    }
-    else if (!isString(maybeTT)) {
-        log.error(ERROR_INVALID, [method, item]);
-    }
-    else {
-        if (maybeTT.length === 0) {
-            log.error(ERROR_EMPTY, [method, item]);
-        }
-        else {
-            if (CAPITAL_LETTERS_REGEX.test(maybeTT)) {
-                log.warn(WARN_LOWERCASE_TRAFFIC_TYPE, [method]);
-                maybeTT = maybeTT.toLowerCase();
-            }
-            return maybeTT;
-        }
-    }
-    return false;
-}

package/esm/utils/inputValidation/trafficTypeExistence.js

@@ -1,27 +0,0 @@
-import { thenable } from '../promise/thenable';
-import { LOCALHOST_MODE } from '../constants';
-import { WARN_NOT_EXISTENT_TT } from '../../logger/constants';
-function logTTExistenceWarning(log, maybeTT, method) {
-    log.warn(WARN_NOT_EXISTENT_TT, [method, maybeTT]);
-}
-/**
- * Separated from the previous method since on some cases it'll be async.
- */
-export function validateTrafficTypeExistence(log, readinessManager, splitsCache, mode, maybeTT, method) {
-    // If not ready or in localhost mode, we won't run the validation
-    if (!readinessManager.isReady() || mode === LOCALHOST_MODE)
-        return true;
-    var res = splitsCache.trafficTypeExists(maybeTT); // never rejects or throws error
-    if (thenable(res)) {
-        return res.then(function (isValid) {
-            if (!isValid)
-                logTTExistenceWarning(log, maybeTT, method);
-            return isValid; // propagate result
-        });
-    }
-    else {
-        if (!res)
-            logTTExistenceWarning(log, maybeTT, method);
-        return res;
-    }
-}

package/esm/utils/jwt/index.js

@@ -1,13 +0,0 @@
-import { decodeFromBase64 } from '../base64';
-/**
- * Decode a JWT token.
- */
-export function decodeJWTtoken(token) {
-    var base64Url = token.split('.')[1];
-    var base64 = base64Url.replace(/-/g, '+').replace(/_/g, '/');
-    // no need to check availability of `encodeURIComponent`, since it is a function highly supported in browsers, node and other platforms.
-    var jsonPayload = decodeURIComponent(decodeFromBase64(base64).split('').map(function (c) {
-        return '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2);
-    }).join(''));
-    return JSON.parse(jsonPayload);
-}

package/esm/utils/jwt/types.js

@@ -1 +0,0 @@
-export {};

package/esm/utils/key/index.js

@@ -1,30 +0,0 @@
-import { isObject } from '../lang';
-// function isSplitKeyObject(key: any): key is SplitIO.SplitKeyObject {
-//   return key !== undefined && key !== null && typeof key.matchingKey === 'string';
-// }
-// returns the matchingKey if the Key is defined as an object or the key itself if it is a string
-export function getMatching(key) {
-    return isObject(key) ? key.matchingKey : key;
-}
-// if the key is a string, there's no bucketingKey (undefined)
-export function getBucketing(key) {
-    return isObject(key) ? key.bucketingKey : undefined;
-}
-/**
- * Verify type of key and return a valid object key used for get treatment for a
- * specific split.
- */
-export function keyParser(key) {
-    if (isObject(key)) {
-        return {
-            matchingKey: key.matchingKey,
-            bucketingKey: key.bucketingKey
-        };
-    }
-    else {
-        return {
-            matchingKey: key,
-            bucketingKey: key
-        };
-    }
-}

package/esm/utils/labels/index.js

@@ -1,9 +0,0 @@
-export var SPLIT_KILLED = 'killed';
-export var NO_CONDITION_MATCH = 'default rule';
-export var SPLIT_NOT_FOUND = 'definition not found';
-export var SDK_NOT_READY = 'not ready';
-export var EXCEPTION = 'exception';
-export var SPLIT_ARCHIVED = 'archived';
-export var NOT_IN_SPLIT = 'not in split';
-export var UNSUPPORTED_MATCHER_TYPE = 'targeting rule type unsupported by sdk';
-export var PREREQUISITES_NOT_MET = 'prerequisites not met';

package/esm/utils/lang/binarySearch.js

@@ -1,38 +0,0 @@
-/**
- * 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
- * @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.
- */
-export function binarySearch(items, value) {
-    var startIndex = 0;
-    var stopIndex = items.length - 1;
-    var middle = Math.floor((stopIndex + startIndex) / 2);
-    var minIndex = startIndex;
-    var maxIndex = stopIndex;
-    while (items[middle] !== value && startIndex < stopIndex) {
-        // adjust search area
-        if (value < items[middle]) {
-            stopIndex = middle - 1;
-        }
-        else if (value > items[middle]) {
-            startIndex = middle + 1;
-        }
-        // recalculate middle
-        middle = Math.floor((stopIndex + startIndex) / 2);
-    }
-    // correct if middle is out of range
-    if (middle < minIndex) {
-        middle = minIndex;
-    }
-    else if (middle > maxIndex) {
-        middle = maxIndex;
-    }
-    // we want to always return based on strict minor comparation
-    if (value < items[middle] && middle > minIndex) {
-        return middle - 1;
-    }
-    return middle;
-}

package/esm/utils/lang/getFnName.js

@@ -1,8 +0,0 @@
-/**
- * Returns the name of a given function.
- */
-export function getFnName(fn) {
-    if (fn.name)
-        return fn.name;
-    return (fn.toString().match(/function (.+?)\(/) || ['', ''])[1];
-}

package/esm/utils/lang/getGlobal.js

@@ -1,14 +0,0 @@
-/* eslint-disable no-undef */
-// Reference to the global object if it exists: https://github.com/tc39/proposal-global
-// The only reliable means to get the global object is `Function('return this')()`. However, this causes CSP violations in Chrome apps.
-var globalRef = typeof global !== 'undefined' ? global : // reference to global object in Node runtime environment
-    typeof window !== 'undefined' ? window : // reference to global object in browsers
-        typeof self !== 'undefined' ? self : // reference to global object in browsers, web workers and others
-            typeof globalThis !== 'undefined' ? globalThis : undefined; // ECMAScript proposal for global reference
-/**
- * Get a global object passing its key
- */
-export function getGlobal(key) {
-    // @ts-ignore
-    return globalRef && globalRef[key];
-}

package/esm/utils/lang/index.js

@@ -1,258 +0,0 @@
-import { __spreadArray } from "tslib";
-/**
- * Checks if the target string ends with the sub string.
- */
-export function endsWith(target, sub, caseInsensitive) {
-    if (caseInsensitive === void 0) { caseInsensitive = false; }
-    if (!(isString(target) && isString(sub))) {
-        return false;
-    }
-    if (caseInsensitive) {
-        target = target.toLowerCase();
-        sub = sub.toLowerCase();
-    }
-    return target.slice(target.length - sub.length) === sub;
-}
-/**
- * Loops through a source collection (an object or an array) running iteratee
- * against each element. It returns the first element for which iteratee returned
- * a truthy value and stops the loop.
- * Iteratee receives three arguments (element, key/index, collection)
- */
-export function find(source, iteratee) {
-    var res;
-    if (isObject(source)) {
-        var keys = Object.keys(source);
-        for (var i = 0; i < keys.length && !res; i++) {
-            var key = keys[i];
-            var iterateeResult = iteratee(source[key], key, source);
-            if (iterateeResult)
-                res = source[key];
-        }
-    }
-    else if (Array.isArray(source)) {
-        for (var i = 0; i < source.length && !res; i++) {
-            var iterateeResult = iteratee(source[i], i, source);
-            if (iterateeResult)
-                res = source[i];
-        }
-    }
-    return res;
-}
-/**
- * Evaluates iteratee for each element of the source array. Returns the index of the first element
- * for which iteratee returns truthy. If no element is found or there's an issue with the params it returns -1.
- */
-export function findIndex(source, iteratee) {
-    if (Array.isArray(source) && typeof iteratee === 'function') {
-        for (var i = 0; i < source.length; i++) {
-            if (iteratee(source[i], i, source) === true) {
-                return i;
-            }
-        }
-    }
-    return -1;
-}
-/**
- * Executes iteratee for given obj own props.
- */
-export function forOwn(obj, iteratee) {
-    var keys = Object.keys(obj);
-    keys.forEach(function (key) { return iteratee(obj[key], key, obj); });
-    return obj;
-}
-/**
- * Safely retrieve the specified prop from obj. If we can't retrieve
- * that property value, we return the default value.
- */
-export function get(obj, prop, val) {
-    var res = val;
-    try { // No risks nor lots of checks.
-        var pathPieces = prop.split('.');
-        var partial_1 = obj;
-        pathPieces.forEach(function (pathPiece) { return partial_1 = partial_1[pathPiece]; });
-        if (typeof partial_1 !== 'undefined')
-            res = partial_1;
-    }
-    catch (e) {
-        // noop
-    }
-    return res;
-}
-/**
- * Parses an array into a map of different arrays, grouping by the specified prop value.
- */
-export function groupBy(source, prop) {
-    var map = {};
-    if (Array.isArray(source) && isString(prop)) {
-        for (var i = 0; i < source.length; i++) {
-            var key = source[i][prop];
-            // Skip the element if the key is not a string.
-            if (isString(key)) {
-                if (!map[key])
-                    map[key] = [];
-                map[key].push(source[i]);
-            }
-        }
-    }
-    return map;
-}
-/**
- * Checks if a given value is a boolean.
- */
-export function isBoolean(val) {
-    return val === true || val === false;
-}
-/**
- * Checks if a given value is a finite value of number type or Number object.
- * Unlike `Number.isFinite`, it also tests Number object instances.
- * Unlike global `isFinite`, it returns false if the value is not a number or Number object instance.
- */
-export function isFiniteNumber(val) {
-    if (val instanceof Number)
-        val = val.valueOf();
-    return typeof val === 'number' ?
-        Number.isFinite ? Number.isFinite(val) : isFinite(val) :
-        false;
-}
-/**
- * Checks if a given value is an integer value of number type or Number object.
- * Unlike `Number.isInteger`, it also tests Number object instances.
- */
-export function isIntegerNumber(val) {
-    if (val instanceof Number)
-        val = val.valueOf();
-    return typeof val === 'number' ?
-        Number.isInteger ? Number.isInteger(val) : isFinite(val) && Math.floor(val) === val :
-        false;
-}
-/**
- * Checks if a given value is a NaN value of number type or Number object.
- * Unlike `Number.isNaN`, it also tests Number object instances.
- * Unlike global `isNan`, it returns false if the value is not a number or Number object instance.
- */
-export function isNaNNumber(val) {
-    if (val instanceof Number)
-        val = val.valueOf();
-    // @TODO replace with `Number.isNaN` once it is fully supported by targets
-    return val !== val;
-}
-/**
- * Validates if a value is an object created by the Object constructor (plain object).
- * It checks `constructor.name` to avoid false negatives when validating values on a separate VM context, which has its own global built-ins.
- */
-export function isObject(obj) {
-    return obj !== null && typeof obj === 'object' && (obj.constructor === Object ||
-        (obj.constructor != null && obj.constructor.name === 'Object'));
-}
-/**
- * Checks if a given value is a string.
- */
-export function isString(val) {
-    return typeof val === 'string' || val instanceof String;
-}
-/**
- * String sanitizer. Returns the provided value converted to uppercase if it is a string.
- */
-export function stringToUpperCase(val) {
-    return isString(val) ? val.toUpperCase() : val;
-}
-/**
- * Deep copy version of Object.assign using recursion.
- * There are some assumptions here. It's for internal use and we don't need verbose errors
- * or to ensure the data types or whatever. Parameters should always be correct (at least have a target and a source, of type object).
- */
-export function merge(target, source) {
-    var rest = [];
-    for (var _i = 2; _i < arguments.length; _i++) {
-        rest[_i - 2] = arguments[_i];
-    }
-    var res = target;
-    isObject(source) && Object.keys(source).forEach(function (key) {
-        var val = source[key];
-        if (isObject(val)) {
-            if (res[key] && isObject(res[key])) { // If both are objects, merge into a new one.
-                val = merge({}, res[key], val);
-            }
-            else { // else make a copy.
-                val = merge({}, val);
-            }
-        }
-        // We skip undefined values.
-        if (val !== undefined)
-            res[key] = val;
-    });
-    if (rest && rest.length) {
-        var nextSource = rest.splice(0, 1)[0];
-        res = merge.apply(void 0, __spreadArray([res, nextSource], rest, false));
-    }
-    return res;
-}
-/**
- * Checks if the target string starts with the sub string.
- */
-export function startsWith(target, sub) {
-    if (!(isString(target) && isString(sub))) {
-        return false;
-    }
-    return target.slice(0, sub.length) === sub;
-}
-/**
- * Transforms a value into a number.
- * Note: We're not expecting anything fancy here. If we are at some point, add more type checks.
- */
-export function toNumber(val) {
-    if (typeof val === 'number')
-        return val;
-    if (isObject(val) && typeof val.valueOf === 'function') {
-        var valOf = val.valueOf();
-        val = isObject(valOf) ? valOf + '' : valOf;
-    }
-    if (typeof val !== 'string') {
-        return val === 0 ? val : +val;
-    }
-    // Remove trailing whitespaces.
-    val = val.replace(/^\s+|\s+$/g, '');
-    return +val;
-}
-/**
- * Transforms a value into it's string representation.
- */
-export function toString(val) {
-    if (val == null)
-        return '';
-    if (typeof val === 'string')
-        return val;
-    if (Array.isArray(val))
-        return val.map(function (val) { return isString(val) ? val : ''; }) + '';
-    var result = val + '';
-    return (result === '0' && (1 / val) === Number.NEGATIVE_INFINITY) ? '-0' : result;
-}
-/**
- * Removes duplicate items on an array of strings.
- */
-export function uniq(arr) {
-    var seen = {};
-    return arr.filter(function (item) {
-        return Object.prototype.hasOwnProperty.call(seen, item) ? false : seen[item] = true;
-    });
-}
-/**
- * Removes duplicate items on an array of objects using an optional `stringify` function as equality criteria.
- * It uses JSON.stringify as default criteria.
- */
-export function uniqAsStrings(arr, stringify) {
-    if (stringify === void 0) { stringify = JSON.stringify; }
-    var seen = {};
-    return arr.filter(function (item) {
-        var itemString = stringify(item);
-        return Object.prototype.hasOwnProperty.call(seen, itemString) ? false : seen[itemString] = true;
-    });
-}
-var uniqueIdCounter = -1;
-/**
- * Returns a number to be used as ID, which will be unique.
- */
-export function uniqueId() {
-    return uniqueIdCounter++;
-}

package/esm/utils/lang/objectAssign.js

@@ -1,17 +0,0 @@
-/**
- * A tiny polyfill for Object.assign
- */
-export var objectAssign = Object.assign || function (target) {
-    if (target === null || target === undefined)
-        throw new TypeError('Object.assign cannot be called with null or undefined');
-    target = Object(target);
-    for (var i = 1; i < arguments.length; i++) {
-        var source = Object(arguments[i]); // eslint-disable-next-line no-restricted-syntax
-        for (var key in source) {
-            if (Object.prototype.hasOwnProperty.call(source, key)) {
-                target[key] = source[key];
-            }
-        }
-    }
-    return target;
-};

package/esm/utils/lang/sets.js

@@ -1,17 +0,0 @@
-export function setToArray(set) {
-    if (Array.from)
-        return Array.from(set);
-    var array = [];
-    set.forEach(function (value) {
-        array.push(value);
-    });
-    return array;
-}
-export function returnSetsUnion(set, set2) {
-    return new Set(setToArray(set).concat(setToArray(set2)));
-}
-export function returnDifference(list, list2) {
-    if (list === void 0) { list = []; }
-    if (list2 === void 0) { list2 = []; }
-    return list.filter(function (item) { return list2.indexOf(item) === -1; });
-}