@koine/utils 1.0.26 → 1.0.29

package/node/parseCookie.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCookie = void 0;
+/**
+ * Try decoding a string using a decoding function.
+ */
+function tryDecode(str, decode) {
+    try {
+        return decode(str);
+    }
+    catch (e) {
+        return str;
+    }
+}
+/**
+ * Parse a cookie header.
+ *
+ * Parse the given cookie header string into an object
+ * The object has the various cookies as keys(names) => values
+ *
+ * @category cookie
+ */
+function parseCookie(str, attributes) {
+    if (attributes === void 0) { attributes = {}; }
+    if (typeof str !== "string") {
+        throw new TypeError("argument str must be a string");
+    }
+    var obj = {};
+    var pairs = str.split(";");
+    var _a = attributes.decode, decode = _a === void 0 ? decodeURIComponent : _a;
+    for (var i = 0; i < pairs.length; i++) {
+        var pair = pairs[i];
+        var index = pair.indexOf("=");
+        // skip things that don't look like key=value
+        if (index < 0) {
+            continue;
+        }
+        var key = pair.substring(0, index).trim();
+        // only assign once
+        if (undefined == obj[key]) {
+            var val = pair.substring(index + 1, pair.length).trim();
+            // quoted values
+            if (val[0] === '"') {
+                val = val.slice(1, -1);
+            }
+            obj[key] = tryDecode(val, decode);
+        }
+    }
+    return obj;
+}
+exports.parseCookie = parseCookie;
+exports.default = parseCookie;

package/node/parseURL.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseURL = void 0;
+/**
+ * Solution without DOM or specific env native methods
+ *
+ * @category location
+ * @see https://stackoverflow.com/a/21553982/1938970
+ */
+function parseURL(url) {
+    var match = url.match(/^(https?:)\/\/(([^:/?#]*)(?::([0-9]+))?)([/]{0,1}[^?#]*)(\?[^#]*|)(#.*|)$/);
+    return (match && {
+        href: url,
+        protocol: match[1],
+        host: match[2],
+        hostname: match[3],
+        port: match[4],
+        pathname: match[5],
+        search: match[6],
+        hash: match[7],
+    });
+}
+exports.parseURL = parseURL;
+exports.default = parseURL;

package/node/randomInt.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomInt = void 0;
+/**
+ * Get random int (min and max included)
+ *
+ * @category math
+ */
+function randomInt(min, max) {
+    return Math.floor(Math.random() * (max - min + 1) + min);
+}
+exports.randomInt = randomInt;
+exports.default = randomInt;

package/node/{misc.js → randomKey.js}

@@ -4,6 +4,7 @@ exports.randomKey = void 0;
 /**
  * Get random key from given object
  *
+ * @category misc
  * @see https://stackoverflow.com/a/15106541/1938970
  */
 function randomKey(obj) {
@@ -11,3 +12,4 @@ function randomKey(obj) {
     return keys[(keys.length * Math.random()) << 0];
 }
 exports.randomKey = randomKey;
+exports.default = randomKey;

package/node/readCookie.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCookie = void 0;
+function converterRead(value) {
+    if (value[0] === '"') {
+        value = value.slice(1, -1);
+    }
+    return value.replace(/(%[\dA-F]{2})+/gi, decodeURIComponent);
+}
+function readCookie(name) {
+    if (typeof document === "undefined") {
+        if (process.env["NODE_ENV"] !== "production") {
+            console.warn("@koine/utils:cookie readCookie, document is undefined");
+        }
+        return name ? "" : {};
+    }
+    var cookies = document.cookie ? document.cookie.split("; ") : [];
+    var all = {};
+    for (var i = 0; i < cookies.length; i++) {
+        var parts = cookies[i].split("=");
+        var value = parts.slice(1).join("=");
+        try {
+            var found = decodeURIComponent(parts[0]);
+            all[found] = converterRead(value);
+            if (name === found) {
+                break;
+            }
+        }
+        catch (e) {
+            if (process.env["NODE_ENV"] !== "production") {
+                console.warn("@koine/utils:cookie readCookie, failed to decode", value);
+            }
+        }
+    }
+    return name ? all[name] : all;
+}
+exports.readCookie = readCookie;
+exports.default = readCookie;

package/node/redirectTo.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redirectTo = void 0;
+var buildUrlQueryString_1 = require("./buildUrlQueryString");
+var isBrowser_1 = require("./isBrowser");
+/**
+ * Redirect to url with params {optionally}, removes eventual trailing question
+ * marks from the given URL, it uses `location`
+ *
+ * @category location
+ */
+function redirectTo(url, params) {
+    if (isBrowser_1.default) {
+        var queryString = (0, buildUrlQueryString_1.default)(params);
+        location.href = url.replace(/\?+$/g, "") + queryString;
+    }
+}
+exports.redirectTo = redirectTo;
+exports.default = redirectTo;

package/node/removeAccents.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeAccents = void 0;
+var accentSets_1 = require("./accentSets");
+/**
+ * @category text
+ */
+function removeAccents(text, sets) {
+    if (text === void 0) { text = ""; }
+    if (sets === void 0) { sets = accentSets_1.accentsSets; }
+    var len = sets.length;
+    while (len--) {
+        var _a = sets[len], to = _a[0], from = _a[1];
+        text = text.replace(new RegExp("[".concat(from, "]"), "gi"), to);
+    }
+    return text;
+}
+exports.removeAccents = removeAccents;
+exports.default = removeAccents;

package/node/removeCookie.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeCookie = void 0;
+var tslib_1 = require("tslib");
+var cookie_1 = require("./cookie");
+var setCookie_1 = require("./setCookie");
+/**
+ * @category cookie
+ *
+ * All cookie related code is inspired and adapted from:
+ * - [js-cookie](https://github.com/js-cookie/js-cookie)
+ * - [cookie](https://github.com/jshttp/cookie)
+ */
+function removeCookie(name, attributes) {
+    if (attributes === void 0) { attributes = {}; }
+    (0, setCookie_1.setCookie)(name, "", tslib_1.__assign(tslib_1.__assign(tslib_1.__assign({}, cookie_1.defaultAttributesClient), attributes), { expires: -1 }));
+}
+exports.removeCookie = removeCookie;
+exports.default = removeCookie;

package/node/removeDuplicatesByKey.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeDuplicatesByKey = void 0;
+/**
+ * Remove duplicated array objects, equality is determined by a strict (`===`)
+ * comparison of each object's given key
+ *
+ * @category array
+ */
+function removeDuplicatesByKey(array, key) {
+    if (array === void 0) { array = []; }
+    if (key === void 0) { key = ""; }
+    var keysMap = {};
+    var output = [];
+    for (var i = 0; i < array.length; i++) {
+        var item = array[i];
+        if (!keysMap[item[key]]) {
+            output.push(item);
+            keysMap[item[key]] = true;
+        }
+    }
+    return output;
+}
+exports.removeDuplicatesByKey = removeDuplicatesByKey;
+exports.default = removeDuplicatesByKey;

package/node/removeDuplicatesComparing.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeDuplicatesComparing = void 0;
+var removeIndexesFromArray_1 = require("./removeIndexesFromArray");
+var findDuplicatedIndexes_1 = require("./findDuplicatedIndexes");
+/**
+ * @category array
+ */
+function removeDuplicatesComparing(from, to) {
+    var indexes = (0, findDuplicatedIndexes_1.findDuplicatedIndexes)(from);
+    return (0, removeIndexesFromArray_1.removeIndexesFromArray)(to, indexes);
+}
+exports.removeDuplicatesComparing = removeDuplicatesComparing;
+exports.default = removeDuplicatesComparing;

package/node/removeIndexesFromArray.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeIndexesFromArray = void 0;
+/**
+ * @category array
+ */
+function removeIndexesFromArray(arr, indexes) {
+    var output = [];
+    for (var i = 0; i < arr.length; i++) {
+        // eslint-disable-next-line no-prototype-builtins
+        if (!indexes.hasOwnProperty(i)) {
+            output.push(arr[i]);
+        }
+    }
+    return output;
+}
+exports.removeIndexesFromArray = removeIndexesFromArray;
+exports.default = removeIndexesFromArray;

package/node/removeTrailingSlash.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeTralingSlash = void 0;
+/**
+ * Strips out the trailing slash
+ *
+ * @category location
+ */
+function removeTralingSlash(urlLike) {
+    if (urlLike === void 0) { urlLike = ""; }
+    return urlLike.replace(/\/*$/, "");
+}
+exports.removeTralingSlash = removeTralingSlash;
+exports.default = removeTralingSlash;

package/node/{math.js → roundTo.js}

@@ -1,25 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertRange = exports.roundTo = exports.clamp = exports.randomInt = void 0;
-/**
- * Get random int (min and max included)
- */
-function randomInt(min, max) {
-    return Math.floor(Math.random() * (max - min + 1) + min);
-}
-exports.randomInt = randomInt;
-/**
- * Returns a number whose value is limited to the given range.
- *
- * @see https://stackoverflow.com/a/11409944/1938970
- */
-function clamp(num, min, max) {
-    return Math.min(Math.max(num, min), max);
-}
-exports.clamp = clamp;
+exports.roundTo = void 0;
 /**
  * Round to given number of the given number of decimals
  *
+ * @category math
  * @see https://stackoverflow.com/a/15762794/1938970
  */
 function roundTo(num, decimals) {
@@ -50,18 +35,4 @@ function roundTo(num, decimals) {
     return "";
 }
 exports.roundTo = roundTo;
-/**
- * Convert range of a number
- *
- * e.g. converting number 5 in a scale/range from 0 10 to a scale/range from 50
- * to 100 would return 75
- * ```
- * convertRange(5, [0, 10], [50, 100]);
- * ```
- *
- * @see https://stackoverflow.com/a/14224813
- */
-function convertRange(num, r1, r2) {
-    return ((num - r1[0]) * (r2[1] - r2[0])) / (r1[1] - r1[0]) + r2[0];
-}
-exports.convertRange = convertRange;
+exports.default = roundTo;

package/node/serializeCookie.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * @file
+ *
+ * @category cookie
+ *
+ * All cookie related code is inspired and adapted from:
+ * - [js-cookie](https://github.com/js-cookie/js-cookie)
+ * - [cookie](https://github.com/jshttp/cookie)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeCookie = void 0;
+var isNumber_1 = require("./isNumber");
+/**
+ * RegExp to match field-content in RFC 7230 sec 3.2
+ *
+ * field-content = field-vchar [ 1*( SP / HTAB ) field-vchar ]
+ * field-vchar   = VCHAR / obs-text
+ * obs-text      = %x80-FF
+ */
+// eslint-disable-next-line no-control-regex
+var fieldContentRegExp = /^[\u0009\u0020-\u007e\u0080-\u00ff]+$/;
+/**
+ * Serialize data into a cookie header.
+ *
+ * Serialize the a name value pair into a cookie string suitable for
+ * http headers. An optional attributes object specified cookie parameters.
+ *
+ * serialize('foo', 'bar', { httpOnly: true })
+ *   => "foo=bar; httpOnly"
+ *
+ * @category cookie
+ *
+ * All cookie related code is inspired and adapted from:
+ * - [js-cookie](https://github.com/js-cookie/js-cookie)
+ * - [cookie](https://github.com/jshttp/cookie)
+ */
+function serializeCookie(name, val, attributes) {
+    if (attributes === void 0) { attributes = {}; }
+    var _a = attributes.encode, encode = _a === void 0 ? encodeURIComponent : _a, domain = attributes.domain, path = attributes.path, httpOnly = attributes.httpOnly, secure = attributes.secure, sameSite = attributes.sameSite;
+    var maxAge = attributes.maxAge, expires = attributes.expires;
+    var value = encode(val);
+    if (process.env["NODE_ENV"] !== "production") {
+        if (!fieldContentRegExp.test(name)) {
+            throw new TypeError("argument name is invalid");
+        }
+        if (typeof attributes.encode !== "function") {
+            throw new TypeError("option encode is invalid");
+        }
+        if (value && !fieldContentRegExp.test(value)) {
+            throw new TypeError("argument val is invalid");
+        }
+    }
+    var str = name + "=" + value;
+    if (null != maxAge) {
+        maxAge = maxAge - 0;
+        if (isNaN(maxAge) || !isFinite(maxAge)) {
+            throw new TypeError("option maxAge is invalid");
+        }
+        str += "; Max-Age=" + Math.floor(maxAge);
+    }
+    if (domain) {
+        if (process.env["NODE_ENV"] !== "production") {
+            if (!fieldContentRegExp.test(domain)) {
+                throw new TypeError("option domain is invalid");
+            }
+        }
+        str += "; Domain=" + domain;
+    }
+    if (path) {
+        if (process.env["NODE_ENV"] !== "production") {
+            if (!fieldContentRegExp.test(path)) {
+                throw new TypeError("option path is invalid");
+            }
+        }
+        str += "; Path=" + path;
+    }
+    if (expires) {
+        if ((0, isNumber_1.isNumber)(expires)) {
+            expires = new Date(Date.now() + expires * 864e5);
+        }
+        str += "; Expires=" + expires.toUTCString();
+    }
+    if (httpOnly) {
+        str += "; HttpOnly";
+    }
+    if (secure) {
+        str += "; Secure";
+    }
+    if (sameSite) {
+        switch (sameSite.toLowerCase()) {
+            case "lax":
+                str += "; SameSite=Lax";
+                break;
+            case "strict":
+                str += "; SameSite=Strict";
+                break;
+            case "none":
+                str += "; SameSite=None";
+                break;
+            //  default:
+            //    throw new TypeError('option sameSite is invalid');
+        }
+    }
+    return str;
+}
+exports.serializeCookie = serializeCookie;
+exports.default = serializeCookie;

package/node/setCookie.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCookie = void 0;
+var tslib_1 = require("tslib");
+var cookie_1 = require("./cookie");
+var isNumber_1 = require("./isNumber");
+function converterWrite(value) {
+    return encodeURIComponent(value).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g, decodeURIComponent);
+}
+/**
+ * @category cookie
+ *
+ * All cookie related code is inspired and adapted from:
+ * - [js-cookie](https://github.com/js-cookie/js-cookie)
+ * - [cookie](https://github.com/jshttp/cookie)
+ */
+function setCookie(name, value, attributes) {
+    if (attributes === void 0) { attributes = {}; }
+    // eslint-disable-next-line prefer-const
+    var expires = attributes.expires, restAttrs = tslib_1.__rest(attributes, ["expires"]);
+    var cleanedAttrs = tslib_1.__assign(tslib_1.__assign({ expires: "" }, cookie_1.defaultAttributesClient), restAttrs);
+    if (typeof document === "undefined") {
+        if (process.env["NODE_ENV"] !== "production") {
+            console.warn("@koine/utils:cookie setCookie, document is undefined");
+        }
+        return;
+    }
+    if ((0, isNumber_1.default)(expires)) {
+        expires = new Date(Date.now() + expires * 864e5);
+    }
+    if (expires) {
+        cleanedAttrs.expires = expires.toUTCString();
+    }
+    name = encodeURIComponent(name)
+        .replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent)
+        .replace(/[()]/g, escape);
+    var stringifiedAttributes = "";
+    for (var name_1 in attributes) {
+        var attrName = name_1;
+        if (!attributes[attrName]) {
+            continue;
+        }
+        stringifiedAttributes += "; " + attrName;
+        if (attributes[attrName] === true) {
+            continue;
+        }
+        // Considers RFC 6265 section 5.2:
+        // ...
+        // 3.  If the remaining unparsed-attributes contains a %x3B (";")
+        //     character:
+        // Consume the characters of the unparsed-attributes up to,
+        // not including, the first %x3B (";") character.
+        // ...
+        stringifiedAttributes +=
+            "=" + String(attributes[attrName]).split(";")[0];
+    }
+    return (document.cookie =
+        name + "=" + converterWrite(value) + stringifiedAttributes);
+}
+exports.setCookie = setCookie;
+exports.default = setCookie;

package/node/shuffle.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shuffle = void 0;
+var tslib_1 = require("tslib");
+/**
+ * Creates an array of shuffled values, using a version of the
+ * [Fisher-Yates shuffle](https://en.wikipedia.org/wiki/Fisher-Yates_shuffle).
+ *
+ * @see lodash.shuffle
+ * @since 0.1.0
+ * @category arrays
+ * @param {Array} array The array to shuffle.
+ * @returns {Array} Returns the new shuffled array.
+ * @example
+ *
+ * shuffle([1, 2, 3, 4])
+ * // => [4, 1, 3, 2]
+ */
+function shuffle(array) {
+    var length = array == null ? 0 : array.length;
+    if (!length) {
+        return [];
+    }
+    var index = -1;
+    var lastIndex = length - 1;
+    var result = tslib_1.__spreadArray([], array, true);
+    while (++index < length) {
+        var rand = index + Math.floor(Math.random() * (lastIndex - index + 1));
+        var value = result[rand];
+        result[rand] = result[index];
+        result[index] = value;
+    }
+    return result;
+}
+exports.shuffle = shuffle;
+exports.default = shuffle;

package/node/slugify.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugify = void 0;
+var accentSets_1 = require("./accentSets");
+var removeAccents_1 = require("./removeAccents");
+/**
+ * Slugify a text
+ *
+ * - replaces the accented letters
+ * - replaces the punctuation with dashes
+ *
+ * @category text
+ * @see https://gist.github.com/mathewbyrne/1280286#gistcomment-3498021
+ */
+function slugify(text, separator) {
+    if (separator === void 0) { separator = "-"; }
+    return (0, removeAccents_1.removeAccents)(text.toString().toLowerCase().trim(), accentSets_1.accentsSets.concat([["-", "[·/_,:;']"]]))
+        .replace(/\s+/g, "-") // replace spaces with -
+        .replace(/&/g, "-and-") // replace & with 'and'
+        .replace(/[^\w-]+/g, "") // remove all non-word chars
+        .replace(/--+/g, "-") // replace multiple - with single -
+        .replace(/^-+/, "") // trim - from start of text
+        .replace(/-+$/, "") // trim - from end of text
+        .replace(/-/g, separator);
+}
+exports.slugify = slugify;
+exports.default = slugify;

package/node/swapMap.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swapMap = void 0;
+/**
+ * Swap object map key/value
+ *
+ * @category objects
+ */
+function swapMap(map) {
+    if (map === void 0) { map = {}; }
+    var output = {};
+    for (var key in map) {
+        output[map[key]] = key;
+    }
+    return output;
+}
+exports.swapMap = swapMap;
+exports.default = swapMap;

package/node/{typography.js → titleCase.js}

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.truncate = exports.titleCase = void 0;
+exports.titleCase = void 0;
 /**
+ * @category typography
  * @see https://github.com/blakeembrey/change-case/blob/master/packages/title-case/src/index.ts
  * @author Blake Embrey (hello@blakeembrey.com)
  */
@@ -11,14 +12,4 @@ var titleCase = function (input) {
         : "";
 };
 exports.titleCase = titleCase;
-/**
- * Truncate string
- */
-var truncate = function (input, length) {
-    return input
-        ? input.length > length
-            ? input.substring(0, length) + "..."
-            : input
-        : "";
-};
-exports.truncate = truncate;
+exports.default = exports.titleCase;

package/node/toNumber.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toNumber = void 0;
+var isNumber_1 = require("./isNumber");
+/**
+ * @category cast
+ */
+function toNumber(input, fallback) {
+    return (0, isNumber_1.isNumber)(input) ? input : input ? parseFloat(input) : fallback || 0;
+}
+exports.toNumber = toNumber;
+exports.default = toNumber;

package/node/{colors.js → toRgba.js}

@@ -5,6 +5,9 @@ exports.toRgba = void 0;
 // export const toRgb = (hexColor: string) => hexRgb(hexColor, { format: "css" });
 // export const toRgba = (hexColor: string, alpha: number) =>
 //   hexRgb(hexColor, { format: "css", alpha });
+/**
+ * @category colors
+ */
 function toRgba(hex, alpha) {
     if (alpha === void 0) { alpha = 1; }
     var r = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
@@ -14,3 +17,4 @@ function toRgba(hex, alpha) {
     return "";
 }
 exports.toRgba = toRgba;
+exports.default = toRgba;

package/node/transformToUrlPathname.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformToUrlPathname = void 0;
+var isString_1 = require("./isString");
+/**
+ * Transform string in a URL pathname (relative URL)
+ *
+ * - adds an initial slash
+ * - encode the string
+ * - replaces whitespaces with dashes
+ *
+ * @category location
+ */
+function transformToUrlPathname(toPathname) {
+    return (0, isString_1.default)(toPathname)
+        ? "/".concat(encodeURIComponent(toPathname.replace(/\s/g, "-").toLowerCase()))
+        : "";
+}
+exports.transformToUrlPathname = transformToUrlPathname;
+exports.default = transformToUrlPathname;

package/node/truncate.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncate = void 0;
+/**
+ * Truncate string
+ *
+ * @category typography
+ */
+var truncate = function (input, length) {
+    return input
+        ? input.length > length
+            ? input.substring(0, length) + "..."
+            : input
+        : "";
+};
+exports.truncate = truncate;
+exports.default = exports.truncate;