@koine/utils 2.0.0-beta.2 → 2.0.0-beta.21

package/debounceRaf.mjs

@@ -1,27 +0,0 @@
-/**
- * Debounce function (with `requestAnimationFrame`)
- *
- * (c) 2021 Chris Ferdinandi, MIT License, https://gomakethings.com
- * @category function
- * @borrows [vanillajstoolkit/debounce](https://vanillajstoolkit.com/helpers/debounce/)
- */
-export function debounceRaf(fn) {
-    var timeout;
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
-        var context = this;
-        // If there's a timer, cancel it
-        if (timeout) {
-            window.cancelAnimationFrame(timeout);
-        }
-        // Setup the new requestAnimationFrame()
-        timeout = window.requestAnimationFrame(function () {
-            fn.apply(context, args);
-        });
-    };
-}
-export default debounceRaf;

package/decode.mjs

@@ -1,10 +0,0 @@
-/**
- * @category security
- * @see https://stackoverflow.com/a/22405578/9122820
- */
-export function decode(str) {
-    return str.replace(/.{3}/g, function (c) {
-        return String.fromCharCode(parseInt(c, 10));
-    });
-}
-export default decode;

package/encode.mjs

@@ -1,10 +0,0 @@
-/**
- * @category security
- * @see https://stackoverflow.com/a/22405578/9122820
- */
-export function encode(str) {
-    return str.replace(/./g, function (c) {
-        return ("00" + c.charCodeAt(0)).slice(-3);
-    });
-}
-export default encode;

package/ensureInt.mjs

@@ -1,9 +0,0 @@
-/**
- * Ensure input to be an integer
- *
- * @category cast
- */
-export var ensureInt = function (input) {
-    return typeof input === "string" ? parseInt(input, 10) : Math.round(input);
-};
-export default ensureInt;

package/env.mjs

@@ -1,3 +0,0 @@
-"use strict";
-// export const __DEV__ = process.env["NODE_ENV"] !== "production";
-// export const __TEST__ = process.env["NODE_ENV"] === "test";

package/errorToString.mjs

@@ -1,10 +0,0 @@
-import isString from "./isString";
-/**
- * Ensure to transform a JavaScript `Error` into a string (uses its `message`)
- *
- * @category Error
- */
-export var errorToString = function (e) {
-    return e instanceof Error ? e.message : isString(e) ? e : "";
-};
-export default errorToString;

package/findDuplicatedIndexes.mjs

@@ -1,14 +0,0 @@
-/**
- * @category array
- */
-export function findDuplicatedIndexes(arr) {
-    var indexes = {};
-    for (var i = 0; i < arr.length; i++) {
-        var idxInArray = arr.indexOf(arr[i]);
-        if (idxInArray !== i && idxInArray !== -1) {
-            indexes[i] = true;
-        }
-    }
-    return indexes;
-}
-export default findDuplicatedIndexes;

package/forin.mjs

@@ -1,11 +0,0 @@
-/**
- * To easily get typed native `for in`
- *
- * @category objects
- */
-export function forin(object, cb) {
-    for (var key in object) {
-        cb(key, object[key]);
-    }
-}
-export default forin;

package/gbToBytes.mjs

@@ -1,7 +0,0 @@
-/**
- * Gigabytes to bytes
- *
- * @category format
- */
-export var gbToBytes = function (bytes) { return bytes * 1000 * 1000 * 1000; };
-export default gbToBytes;

package/getEmptyArray.mjs

@@ -1,15 +0,0 @@
-import isNumber from "./isNumber";
-/**
- *
- * Returns an array of undefined values of the desired length, useful to build
- * skeleton UIs.
- *
- * @category array
- */
-export function getEmptyArray /* <T extends undefined | null = undefined> */(length) {
-    if (!isNumber(length)) {
-        length = parseInt(length, 10);
-    }
-    return Array.from({ length: length });
-}
-export default getEmptyArray;

package/getKeys.mjs

@@ -1,9 +0,0 @@
-/**
- * Type safe replacement for `Object.keys(myObject)` to iterate over a record
- * without loosing the key's types in simple `string`s.
- *
- * @category objects
- * @see https://stackoverflow.com/a/59459000/1938970
- */
-export var getKeys = Object.keys;
-export default getKeys;

package/getNonce.mjs

@@ -1,9 +0,0 @@
-import { isUndefined } from "./isUndefined";
-/**
- * @category security
- * @see https://github.com/styled-components/styled-components/blob/main/packages/styled-components/src/utils/nonce.ts
- */
-export function getNonce() {
-    return isUndefined(__webpack_nonce__) ? null : __webpack_nonce__;
-}
-export default getNonce;

package/getParamAmong.mjs

@@ -1,17 +0,0 @@
-import getParamAsString from "./getParamAsString";
-/**
- * Get query parameter as `string` treating the `ParsedUrlQuery` result of
- * [`querystring`](https://nodejs.org/api/querystring.html) (used in next.js
- * router and elsewhere)
- *
- * @category location
- *
- * @param {string} [raw] - The _raw_ query parameter
- * @param {string[]} [allowedValues=[]] - The list of values (as strings) that the parameter can have, if not one of them `null` is returned
- */
-export function getParamAmong(raw, allowedValues) {
-    if (allowedValues === void 0) { allowedValues = []; }
-    var string = getParamAsString(raw);
-    return allowedValues.includes(string) ? string : null;
-}
-export default getParamAmong;

package/getParamAsInt.mjs

@@ -1,20 +0,0 @@
-import getParamAsString from "./getParamAsString";
-/**
- * Get query parameter as `int`eger treating the `ParsedUrlQuery` result of
- * [`querystring`](https://nodejs.org/api/querystring.html) (used in next.js
- * router and elsewhere)
- *
- * @category location
- *
- * @param {string} [raw] - The _raw_ query parameter
- * @param {number} [fallback] - Fallback number, we return `null` if not provided
- */
-export function getParamAsInt(raw, fallback) {
-    if (fallback === void 0) { fallback = null; }
-    var string = getParamAsString(raw);
-    if (string) {
-        return parseInt(string, 10);
-    }
-    return fallback;
-}
-export default getParamAsInt;

package/getParamAsString.mjs

@@ -1,14 +0,0 @@
-import isArray from "./isArray";
-/**
- * Get query parameter as `string` treating the `ParsedUrlQuery` result of
- * [`querystring`](https://nodejs.org/api/querystring.html) (used in next.js
- * router and elsewhere)
- *
- * @category location
- *
- * @param {string} [raw] - The _raw_ query parameter
- */
-export function getParamAsString(raw) {
-    return (isArray(raw) ? raw[0] : raw) || "";
-}
-export default getParamAsString;

package/getType.mjs

@@ -1,19 +0,0 @@
-/**
- * @file
- *
- * Same as [is-what](https://github.com/mesqueeb/is-what) plus:
- *
- * - `isFormData`
- * - `isInt`
- * - `isFloat`
- */
-/**
- * Returns the object type of the given payload
- *
- * @param {*} payload
- * @returns {string}
- */
-export function getType(payload) {
-    return Object.prototype.toString.call(payload).slice(8, -1);
-}
-export default getType;

package/getUrlHashParams.mjs

@@ -1,16 +0,0 @@
-/**
- * It returns the "query params" as an object extracting it from the given `hash`
- * string or, if not provided, failling back reading the `location.hash`
- *
- * @category location
- */
-export function getUrlHashParams(hash) {
-    if (hash === void 0) { hash = ""; }
-    hash = hash || location.hash;
-    var hashParts = hash.split("?");
-    if (hashParts.length >= 1) {
-        return Object.fromEntries(new URLSearchParams(hashParts[1]));
-    }
-    return {};
-}
-export default getUrlHashParams;

package/getUrlHashPathname.mjs

@@ -1,13 +0,0 @@
-/**
- * It returns the "pathname" cleaned up from the `#` and the initial slashes
- * extracting it from the given `hash` string or, if not provided, failling
- * back reading the `location.hash`
- *
- * @category location
- */
-export function getUrlHashPathname(hash) {
-    if (hash === void 0) { hash = ""; }
-    hash = hash || location.hash;
-    return hash.split("?")[0].replace(/^#\//, "");
-}
-export default getUrlHashPathname;

package/getUrlPathnameParts.mjs

@@ -1,20 +0,0 @@
-import isBrowser from "./isBrowser";
-/**
- * Get pathname parts
- *
- * First clean the pathname from the first slash if any then split the pathname
- * in parts,
- * Given a pathname like: `"/en/{prefix}/{collection}/{slug}"` we obtain
- * `[locale, prefix, collection, slug]`
- *
- * @category location
- */
-export function getUrlPathnameParts(pathname) {
-    if (pathname === void 0) { pathname = ""; }
-    pathname = pathname || isBrowser ? location.pathname : "";
-    return pathname
-        .replace(/^\//, "")
-        .split("/")
-        .filter(function (part) { return part; });
-}
-export default getUrlPathnameParts;

package/getUrlQueryParams.mjs

@@ -1,38 +0,0 @@
-import isBrowser from "./isBrowser";
-/**
- * Get parsed query parameters as object dictionary (from URL or given query string)
- *
- * @category location
- * @param url A URL which contains a  `?`, e.g. `?myparam=x` or `https://a.com?myparams=x`.
- *                    If not provided it defaults reading the current URL query string with
- *                    `location.search`. Through this argument you can use this
- *                    same function to parse, for instance, the query params of
- *                    the `href` of a `<a href="...">` HTML tag.
- *
- */
-export function getUrlQueryParams(url) {
-    var _a;
-    var params = {};
-    var search = url
-        ? (_a = url.split("?")) === null || _a === void 0 ? void 0 : _a[1]
-        : isBrowser
-            ? location.search.substring(1)
-            : "";
-    if (!search) {
-        return {};
-    }
-    try {
-        // @see https://stackoverflow.com/a/8649003/1938970
-        var paramsAsObj = "{\"".concat(search
-            .replace(/&/g, '","')
-            .replace(/=/g, '":"'), "\"}");
-        params = JSON.parse(paramsAsObj, function (key, value) {
-            return key === "" ? value : decodeURIComponent(value);
-        });
-    }
-    catch (e) {
-        // do nothing or warn on process.env["NODE_ENV"] !== "production"
-    }
-    return params;
-}
-export default getUrlQueryParams;

package/imgEmptyPixel.mjs

@@ -1,7 +0,0 @@
-/**
- * Empty img pixel as a string to inline
- *
- * @category img
- */
-export var imgEmptyPixel = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=";
-export default imgEmptyPixel;

package/invariant.mjs

@@ -1,34 +0,0 @@
-/**
- * FIXME: invariant calls do not get tree shaked in minified output of projects
- * using it. Let's not use it internally and not export it from `@koine/utils`
- * until we find a tree-shakeable way of doing this. For now just wrapping
- * the logging code into `if (process.env["NODE_ENV"] !== "production") {}`
- * works better despite it is more verbose.
- *
- * @resources
- * - https://github.com/alexreardon/tiny-invariant
- * - https://github.com/zertosh/invariant
- * - https://stackoverflow.com/q/39055159/1938970
- *
- * @param condition The condition that, if `true` will throw the error during development
- * @param message A string or a function that returns a string
- * @param lib The library name to show in the error message prefix. When `lib` is also specified it outputs `[lib:prefix]: the message`, otherwise just `[lib|prefix]: the message`)
- * @param prefix The library name to show in the error message prefix. When `lib` is also specified it outputs `[lib:prefix]: the message`, otherwise just `[lib|prefix]: the message`)
- */
-export function invariant(condition, message, lib, prefix) {
-    if (process.env["NODE_ENV"] !== "production") {
-        if (condition) {
-            return;
-        }
-        var msgProvided = typeof message === "function" ? message() : message;
-        var msgPrefix = "";
-        if (lib && prefix) {
-            msgPrefix = "[".concat(lib, ":").concat(prefix, "] ");
-        }
-        else if (lib) {
-            msgPrefix = "[".concat(lib, "] ");
-        }
-        throw new Error(msgPrefix + msgProvided);
-    }
-}
-export default invariant;

package/isAnyObject.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is an any kind of object (including special classes or objects with different prototypes)
- *
- * @category is
- */
-export function isAnyObject(payload) {
-    return getType(payload) === "Object";
-}
-export default isAnyObject;

package/isArray.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is an array
- *
- * @category is
- */
-export function isArray(payload) {
-    return getType(payload) === "Array";
-}
-export default isArray;

package/isBlob.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is a Blob
- *
- * @category is
- */
-export function isBlob(payload) {
-    return getType(payload) === "Blob";
-}
-export default isBlob;

package/isBoolean.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is a boolean
- *
- * @category is
- */
-export function isBoolean(payload) {
-    return getType(payload) === "Boolean";
-}
-export default isBoolean;

package/isBrowser.mjs

@@ -1,6 +0,0 @@
-/**
- * @category ssr
- * @category is
- */
-export var isBrowser = typeof window !== "undefined";
-export default isBrowser;

package/isBrowserNow.mjs

@@ -1,7 +0,0 @@
-import isUndefined from "./isUndefined";
-/**
- * @category ssr
- * @category is
- */
-export var isBrowserNow = function () { return !isUndefined(window); };
-export default isBrowserNow;

package/isDate.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is a Date, and that the date is valid
- *
- * @category is
- */
-export function isDate(payload) {
-    return getType(payload) === "Date" && !isNaN(payload);
-}
-export default isDate;

package/isEmptyArray.mjs

@@ -1,10 +0,0 @@
-import isArray from "./isArray";
-/**
- * Returns whether the payload is a an empty array
- *
- * @category is
- */
-export function isEmptyArray(payload) {
-    return isArray(payload) && payload.length === 0;
-}
-export default isEmptyArray;

package/isEmptyObject.mjs

@@ -1,10 +0,0 @@
-import isPlainObject from "./isPlainObject";
-/**
- * Returns whether the payload is a an empty object (excluding special classes or objects with other prototypes)
- *
- * @category is
- */
-export function isEmptyObject(payload) {
-    return isPlainObject(payload) && Object.keys(payload).length === 0;
-}
-export default isEmptyObject;

package/isEmptyString.mjs

@@ -1,9 +0,0 @@
-/**
- * Returns whether the payload is ''
- *
- * @category is
- */
-export function isEmptyString(payload) {
-    return payload === "";
-}
-export default isEmptyString;

package/isError.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is an Error
- *
- * @category is
- */
-export function isError(payload) {
-    return getType(payload) === "Error";
-}
-export default isError;

package/isExternalUrl.mjs

@@ -1,21 +0,0 @@
-import isBrowser from "./isBrowser";
-/**
- * Is external url compared to the given current URL (if not provided it falls
- * back to `location.href`)
- *
- * @category location
- *
- */
-export function isExternalUrl(url, currentUrl) {
-    var _a;
-    var reg = /https?:\/\/((?:[\w\d-]+\.)+[\w\d]{2,})/i;
-    var urlMatches = reg.exec(url);
-    // if no matches are found it means we either have an invalid URL, a relative
-    // URL or a hash link, and those are not considered externals
-    if (!urlMatches) {
-        return false;
-    }
-    currentUrl = currentUrl || isBrowser ? location.href : "";
-    return currentUrl ? ((_a = reg.exec(currentUrl)) === null || _a === void 0 ? void 0 : _a[1]) !== urlMatches[1] : true;
-}
-export default isExternalUrl;

package/isFile.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is a File
- *
- * @category is
- */
-export function isFile(payload) {
-    return getType(payload) === "File";
-}
-export default isFile;

package/isFloat.mjs

@@ -1,10 +0,0 @@
-import isNumber from "./isNumber";
-/**
- * Returns whether the payload is a float number
- *
- * @category is
- */
-export function isFloat(payload) {
-    return isNumber(payload) && payload % 1 !== 0;
-}
-export default isFloat;

package/isFormData.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is a FormData
- *
- * @category is
- */
-export function isFormData(payload) {
-    return getType(payload) === "FormData";
-}
-export default isFormData;

package/isFullArray.mjs

@@ -1,10 +0,0 @@
-import isArray from "./isArray";
-/**
- * Returns whether the payload is a an array with at least 1 item
- *
- * @category is
- */
-export function isFullArray(payload) {
-    return isArray(payload) && payload.length > 0;
-}
-export default isFullArray;

package/isFullObject.mjs

@@ -1,10 +0,0 @@
-import isPlainObject from "./isPlainObject";
-/**
- * Returns whether the payload is a an empty object (excluding special classes or objects with other prototypes)
- *
- * @category is
- */
-export function isFullObject(payload) {
-    return isPlainObject(payload) && Object.keys(payload).length > 0;
-}
-export default isFullObject;

package/isFullString.mjs

@@ -1,10 +0,0 @@
-import isString from "./isString";
-/**
- * Returns whether the payload is a string, BUT returns false for ''
- *
- * @category is
- */
-export function isFullString(payload) {
-    return isString(payload) && payload !== "";
-}
-export default isFullString;

package/isFunction.mjs

@@ -1,9 +0,0 @@
-/**
- * Returns whether the payload is a function (regular or async)
- *
- * @category is
- */
-export function isFunction(payload) {
-    return typeof payload === "function";
-}
-export default isFunction;

package/isInt.mjs

@@ -1,10 +0,0 @@
-import isNumber from "./isNumber";
-/**
- * Returns whether the payload is an integer number
- *
- * @category is
- */
-export function isInt(payload) {
-    return isNumber(payload) && payload % 1 === 0;
-}
-export default isInt;

package/isMap.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is a Map
- *
- * @category is
- */
-export function isMap(payload) {
-    return getType(payload) === "Map";
-}
-export default isMap;

package/isNaNValue.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is literally the value `NaN` (it's `NaN` and also a `number`)
- *
- * @category is
- */
-export function isNaNValue(payload) {
-    return getType(payload) === "Number" && isNaN(payload);
-}
-export default isNaNValue;

package/isNegativeNumber.mjs

@@ -1,10 +0,0 @@
-import isNumber from "./isNumber";
-/**
- * Returns whether the payload is a negative number (but not 0)
- *
- * @category is
- */
-export function isNegativeNumber(payload) {
-    return isNumber(payload) && payload < 0;
-}
-export default isNegativeNumber;

package/isNull.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is null
- *
- * @category is
- */
-export function isNull(payload) {
-    return getType(payload) === "Null";
-}
-export default isNull;