@koine/utils 2.0.0-beta.13 → 2.0.0-beta.15

package/getUrlHashParams.mjs

@@ -1,14 +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 = "") {
-    hash = hash || location.hash;
-    const hashParts = hash.split("?");
-    if (hashParts.length >= 1) {
-        return Object.fromEntries(new URLSearchParams(hashParts[1]));
-    }
-    return {};
-}
-export default getUrlHashParams;

package/getUrlHashPathname.mjs

@@ -1,11 +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 = "") {
-    hash = hash || location.hash;
-    return hash.split("?")[0].replace(/^#\//, "");
-}
-export default getUrlHashPathname;

package/getUrlPathnameParts.mjs

@@ -1,15 +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 = "") {
-    pathname = pathname || isBrowser ? location.pathname : "";
-    return pathname.replace(/^\//, "").split("/").filter((part)=>part);
-}
-export default getUrlPathnameParts;

package/getUrlQueryParams.mjs

@@ -1,26 +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) {
-    let params = {};
-    const search = url ? url.split("?")?.[1] : isBrowser ? location.search.substring(1) : "";
-    if (!search) {
-        return {};
-    }
-    try {
-        // @see https://stackoverflow.com/a/8649003/1938970
-        const paramsAsObj = `{"${search.replace(/&/g, '","').replace(/=/g, '":"')}"}`;
-        params = JSON.parse(paramsAsObj, (key, value)=>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,6 +0,0 @@
-/**
- * Empty img pixel as a string to inline
- *
- * @category img
- */ export const imgEmptyPixel = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=";
-export default imgEmptyPixel;

package/invariant.mjs

@@ -1,32 +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;
-        }
-        const msgProvided = typeof message === "function" ? message() : message;
-        let msgPrefix = "";
-        if (lib && prefix) {
-            msgPrefix = `[${lib}:${prefix}] `;
-        } else if (lib) {
-            msgPrefix = `[${lib}] `;
-        }
-        throw new Error(msgPrefix + msgProvided);
-    }
-}
-export default invariant;

package/isAnyObject.mjs

@@ -1,9 +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,9 +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,9 +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,9 +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,5 +0,0 @@
-/**
- * @category ssr
- * @category is
- */ export const isBrowser = typeof window !== "undefined";
-export default isBrowser;

package/isBrowserNow.mjs

@@ -1,6 +0,0 @@
-import isUndefined from "./isUndefined";
-/**
- * @category ssr
- * @category is
- */ export const isBrowserNow = ()=>!isUndefined(window);
-export default isBrowserNow;

package/isDate.mjs

@@ -1,9 +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,9 +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,9 +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,8 +0,0 @@
-/**
- * Returns whether the payload is ''
- *
- * @category is
- */ export function isEmptyString(payload) {
-    return payload === "";
-}
-export default isEmptyString;

package/isError.mjs

@@ -1,9 +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,19 +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) {
-    const reg = /https?:\/\/((?:[\w\d-]+\.)+[\w\d]{2,})/i;
-    const 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 ? reg.exec(currentUrl)?.[1] !== urlMatches[1] : true;
-}
-export default isExternalUrl;

package/isFile.mjs

@@ -1,9 +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,9 +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,9 +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,9 +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,9 +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,9 +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,8 +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,9 +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,9 +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,9 +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,9 +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,9 +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;

package/isNullOrUndefined.mjs

@@ -1,9 +0,0 @@
-import isNull from "./isNull";
-import isOneOf from "./isOneOf";
-import isUndefined from "./isUndefined";
-/**
- * Returns true whether the payload is null or undefined
- *
- * @category is
- */ export const isNullOrUndefined = isOneOf(isNull, isUndefined);
-export default isNullOrUndefined;

package/isNumber.mjs

@@ -1,11 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is a number (but not NaN)
- *
- * This will return `false` for `NaN`!!
- *
- * @category is
- */ export function isNumber(payload) {
-    return getType(payload) === "Number" && !isNaN(payload);
-}
-export default isNumber;

package/isObject.mjs

@@ -1,9 +0,0 @@
-import isPlainObject from "./isPlainObject";
-/**
- * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
- *
- * @category is
- */ export function isObject(payload) {
-    return isPlainObject(payload);
-}
-export default isObject;

package/isObjectLike.mjs

@@ -1,11 +0,0 @@
-import isAnyObject from "./isAnyObject";
-/**
- * Returns whether the payload is an object like a type passed in < >
- *
- * Usage: isObjectLike<{id: any}>(payload) // will make sure it's an object and has an `id` prop.
- *
- * @category is
- */ export function isObjectLike(payload) {
-    return isAnyObject(payload);
-}
-export default isObjectLike;

package/isOneOf.mjs

@@ -1,4 +0,0 @@
-export function isOneOf(a, b, c, d, e) {
-    return (value)=>a(value) || b(value) || !!c && c(value) || !!d && d(value) || !!e && e(value);
-}
-export default isOneOf;

package/isPlainObject.mjs

@@ -1,10 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is a plain JavaScript object (excluding special classes or objects with other prototypes)
- *
- * @category is
- */ export function isPlainObject(payload) {
-    if (getType(payload) !== "Object") return false;
-    return payload.constructor === Object && Object.getPrototypeOf(payload) === Object.prototype;
-}
-export default isPlainObject;

package/isPositiveNumber.mjs

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

package/isPrimitive.mjs

@@ -1,14 +0,0 @@
-import isBoolean from "./isBoolean";
-import isNull from "./isNull";
-import isNumber from "./isNumber";
-import isString from "./isString";
-import isSymbol from "./isSymbol";
-import isUndefined from "./isUndefined";
-/**
- * Returns whether the payload is a primitive type (eg. Boolean | Null | Undefined | Number | String | Symbol)
- *
- * @category is
- */ export function isPrimitive(payload) {
-    return isBoolean(payload) || isNull(payload) || isUndefined(payload) || isNumber(payload) || isString(payload) || isSymbol(payload);
-}
-export default isPrimitive;

package/isPromise.mjs

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

package/isRegExp.mjs

@@ -1,9 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is a regular expression (RegExp)
- *
- * @category is
- */ export function isRegExp(payload) {
-    return getType(payload) === "RegExp";
-}
-export default isRegExp;

package/isServer.mjs

@@ -1,7 +0,0 @@
-import isBrowser from "./isBrowser";
-/**
- * @category ssr
- * @category is
- */ export const isServer = !isBrowser;
-// export const isServer = typeof window === "undefined";
-export default isServer;

package/isServerNow.mjs

@@ -1,6 +0,0 @@
-import isUndefined from "./isUndefined";
-/**
- * @category ssr
- * @category is
- */ export const isServerNow = ()=>isUndefined(window);
-export default isServerNow;

package/isSet.mjs

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

package/isString.mjs

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

package/isSymbol.mjs

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

package/isType.mjs

@@ -1,20 +0,0 @@
-import getType from "./getType";
-/**
- * Does a generic check to check that the given payload is of a given type.
- * In cases like Number, it will return true for NaN as NaN is a Number (thanks javascript!);
- * It will, however, differentiate between object and null
- *
- * @category is
- * @throws {TypeError} Will throw type error if type is an invalid type
- */ export function isType(payload, type) {
-    if (!(type instanceof Function)) {
-        throw new TypeError("Type must be a function");
-    }
-    if (!Object.prototype.hasOwnProperty.call(type, "prototype")) {
-        throw new TypeError("Type is not a class");
-    }
-    // Classes usually have names (as functions usually have names)
-    const name = type.name;
-    return getType(payload) === name || Boolean(payload && payload.constructor === type);
-}
-export default isType;

package/isUndefined.mjs

@@ -1,9 +0,0 @@
-import getType from "./getType";
-/**
- * Returns whether the payload is undefined
- *
- * @category is
- */ export function isUndefined(payload) {
-    return getType(payload) === "Undefined";
-}
-export default isUndefined;

package/isWeakMap.mjs

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

package/isWeakSet.mjs

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

package/kbToBytes.mjs

@@ -1,6 +0,0 @@
-/**
- * Kilobytes to bytes
- *
- * @category format
- */ export const kbToBytes = (bytes)=>bytes * 1000;
-export default kbToBytes;

package/location.mjs

@@ -1,3 +0,0 @@
-/**
- * @category location
- */ export { };

package/lowercase.mjs

@@ -1,6 +0,0 @@
-/**
- * Replacement for native `toLowercase` tyescript ready (type narrowing ready)
- *
- * @category native
- */ export const lowercase = (str)=>(str || "").toLowerCase();
-export default lowercase;

package/mapListBy.mjs

@@ -1,11 +0,0 @@
-/**
- * Maps an array of objects into a map keyed with the given key
- *
- * @category array
- */ export function mapListBy(array = [], key = "") {
-    return array.reduce((obj, item)=>{
-        obj[item[key]] = item;
-        return obj;
-    }, {});
-}
-export default mapListBy;