@kwiz/common 1.0.73 → 1.0.74

package/lib/esm/helpers/collections.base.js

@@ -0,0 +1,372 @@
+import { getFromFullName, isBoolean, isDate, isFunction, isNotEmptyArray, isNullOrEmptyArray, isNullOrEmptyString, isNullOrUndefined, isNumber, isString, isTypeofFullNameFunction } from "./typecheckers";
+/** Finds an object in array based on a filter and moves it to the start of the array  */
+export function moveToStart(arr, filter) {
+    let index = firstIndexOf(arr, filter);
+    if (index > 0) {
+        let obj = arr[index];
+        arr.splice(index, 1);
+        arr.unshift(obj);
+    }
+}
+/** Finds an object in array based on a filter and moves it to the end of the array  */
+export function moveToEnd(arr, filter) {
+    let index = firstIndexOf(arr, filter);
+    if (index !== -1 && index !== arr.length - 1) {
+        let obj = arr[index];
+        arr.splice(index, 1);
+        arr.push(obj);
+    }
+}
+/** Get the first index of an object of an array, or -1  if the array is empty / null  */
+// export function firstIndexOf<T extends Element>(arr: HTMLCollectionOf<T>, filter?: (item: T, index?: number) => boolean, startFrom?: number): number;
+// export function firstIndexOf<T>(arr: T[], filter?: (item: T, index?: number) => boolean, startFrom?: number): number;
+export function firstIndexOf(arr, filter, startFrom) {
+    if (!isNullOrUndefined(arr) && arr.length > 0) {
+        if (isFunction(filter)) {
+            //use for loop so we can stop when it is found
+            for (let i = startFrom > 0 ? startFrom : 0; i < arr.length; i++)
+                if (filter(arr[i], i) === true)
+                    return i;
+        }
+        else
+            return 0;
+    }
+    return -1;
+}
+/** Get the first object of an array, or null if the array is empty / null
+ * If you pass a filter, it will find the first element that matches the filter and return it, stopping the loop when it is found
+ * */
+export function firstOrNull(arr, filter) {
+    let index = firstIndexOf(arr, filter);
+    return index < 0 ? null : arr[index];
+}
+/** Get the last index of an object of an array, or -1  if the array is empty / null  */
+export function lastIndexOf(arr, filter) {
+    if (!isNullOrUndefined(arr) && arr.length > 0) {
+        if (isFunction(filter)) {
+            //use for loop so we can stop when it is found
+            for (let i = arr.length - 1; i >= 0; i--)
+                if (filter(arr[i]) === true)
+                    return i;
+        }
+        else
+            return arr.length - 1;
+    }
+    return -1;
+}
+/** get the last element or null */
+export function lastOrNull(arr, filter) {
+    let index = lastIndexOf(arr, filter);
+    return index < 0 ? null : arr[index];
+}
+/** Get the first index of an object of an array, or -1  if the array is empty / null  */
+export async function firstIndexOfAsync(arr, filter, startFrom) {
+    if (!isNullOrUndefined(arr) && arr.length > 0) {
+        if (isFunction(filter)) {
+            //use for loop so we can stop when it is found
+            for (let i = startFrom > 0 ? startFrom : 0; i < arr.length; i++)
+                if ((await filter(arr[i], i)) === true)
+                    return i;
+        }
+        else
+            return 0;
+    }
+    return -1;
+}
+/** Get the first object of an array, or null if the array is empty / null
+ * If you pass a filter, it will find the first element that matches the filter and return it, stopping the loop when it is found
+ * */
+export async function firstOrNullAsync(arr, filter) {
+    let index = await firstIndexOfAsync(arr, filter);
+    return index < 0 ? null : arr[index];
+}
+/** Get the last index of an object of an array, or -1  if the array is empty / null  */
+export async function lastIndexOfAsync(arr, filter) {
+    if (!isNullOrUndefined(arr) && arr.length > 0) {
+        if (isFunction(filter)) {
+            //use for loop so we can stop when it is found
+            for (let i = arr.length - 1; i >= 0; i--)
+                if ((await filter(arr[i])) === true)
+                    return i;
+        }
+        else
+            return arr.length - 1;
+    }
+    return -1;
+}
+/** get the last element or null */
+export async function lastOrNullAsync(arr, filter) {
+    let index = await lastIndexOfAsync(arr, filter);
+    return index < 0 ? null : arr[index];
+}
+/** Sorts an array of complex objects, use defaultPrimitiveGetValue for default functionality */
+export function sortArray(arr, getValue) {
+    if (!isNullOrEmptyArray(arr)) {
+        if (isTypeofFullNameFunction("Intl.Collator")) {
+            //todo: should probably use the SharePoint locale isntead of 'undefined'
+            let collator = new Intl.Collator(undefined, { numeric: true, sensitivity: 'base' });
+            arr.sort((a, b) => {
+                let va = getValue(a);
+                let vb = getValue(b);
+                return collator.compare(va, vb);
+            });
+        }
+        else {
+            arr.sort((a, b) => {
+                let va = getValue(a);
+                if (isString(va))
+                    va = va.toLowerCase();
+                let vb = getValue(b);
+                if (isString(vb))
+                    vb = vb.toLowerCase();
+                return va === vb ? 0 : va > vb ? 1 : -1;
+            });
+        }
+    }
+    return arr;
+}
+/** removes null, undefined or "" elements from the array */
+export function filterEmptyEntries(arr) {
+    return arr.filter(val => !isNullOrEmptyString(val));
+}
+export function sortNumberArrayAsc(a, b) {
+    return a - b;
+}
+export function sortNumberArray(a, b) {
+    return b - a;
+}
+/** call a foreach on an object or an array, with an option to break when returning false */
+export function forEach(obj, func, args) {
+    if (obj && func && isFunction(func)) {
+        if (Array.isArray(obj) || obj.constructor && getFromFullName("constructor.name", obj) === "Array") {
+            for (let i = 0; i < obj.length; i++) {
+                let property = i;
+                let value = obj[property];
+                let result = func(property.toString(10), value, args);
+                if (result === false) {
+                    break;
+                }
+            }
+        }
+        else {
+            let keys = Object.keys(obj);
+            for (let i = 0; i < keys.length; i++) {
+                let property = keys[i];
+                let value = obj[property];
+                let result = func(property, value, args);
+                if (result === false) {
+                    break;
+                }
+            }
+        }
+    }
+}
+export async function forEachAsync(arr, handler, options) {
+    if (!isNullOrUndefined(arr) && Object.keys(arr).length > 0) {
+        let keys = Object.keys(arr);
+        if (options && options.parallel) {
+            let promises = [];
+            keys.forEach((key, i) => {
+                promises.push(handler(arr[key], i));
+            });
+            return Promise.all(promises);
+        }
+        else {
+            let results = [];
+            for (let i = 0; i < keys.length; i++) {
+                results.push(await handler(arr[keys[i]], i));
+            }
+            return results;
+        }
+    }
+    else
+        return [];
+}
+export function sizeOf(obj) {
+    if (Array.isArray(obj))
+        return obj.length;
+    return Object.keys(obj).length;
+}
+export function chunkArray(array, chunkSize) {
+    let chunkedArray = [];
+    for (var i = 0; i < array.length; i += chunkSize) {
+        chunkedArray.push(array.slice(i, i + chunkSize));
+    }
+    return chunkedArray;
+}
+/** Takes an array and transforms it into a hash. this will assign 1 item per key, assumig getKey will be unique per item. */
+export function toHash(arr, getKey, filter, transformValue) {
+    let hash = {};
+    if (!isFunction(transformValue))
+        transformValue = v => v;
+    if (isNotEmptyArray(arr))
+        arr.forEach(i => {
+            if (!isFunction(filter) || filter(i))
+                hash[getKey(i)] = transformValue(i);
+        });
+    return hash;
+}
+/** Returns an array from the values of the dictionary. */
+export function toArray(hash, filter, transform) {
+    let arr = [];
+    if (!isFunction(transform))
+        transform = (key, element) => element;
+    if (!isNullOrUndefined(hash))
+        Object.keys(hash).forEach(key => {
+            if (!isFunction(filter) || filter(hash[key]))
+                arr.push(transform(key, hash[key]));
+        });
+    return arr;
+}
+/** returns a new dictionary, converting each entry in source using the transform function */
+export function convertDictionary(source, transform) {
+    let result = {};
+    forEach(source, (key, value) => { result[key] = transform(value); });
+    return result;
+}
+export function flattenArray(array) {
+    return array.reduce((acc, val) => acc.concat(val), []);
+}
+/** careful, does not work for date/complex objects. Use GetUniqueArrayInfo if you suspect you might have Date/complex objects. */
+export function makeUniqueArray(arr) {
+    return arr.filter((v, i, a) => a.indexOf(v) === i);
+}
+/** return an array of unique values, and the first index they were found, use defaultPrimitiveGetValue for default functionality */
+export function GetUniqueArrayInfo(arr, getValue) {
+    var uniqueValues = [];
+    var uniqueArray = [];
+    var foundValues = [];
+    var hasDuplicates = false;
+    var duplicateIndexes = [];
+    if (isNotEmptyArray(arr)) {
+        arr.forEach((item, index) => {
+            let value = getValue(item);
+            if (foundValues.includes(value)) {
+                hasDuplicates = true;
+                duplicateIndexes.push(index);
+            }
+            else {
+                foundValues.push(value);
+                uniqueValues.push({ item: item, value: value, firstIndex: index });
+                uniqueArray.push(item);
+            }
+        });
+    }
+    return {
+        /** true if duplicate values found */
+        hasDuplicates: hasDuplicates,
+        /** all duplicate item indexes */
+        duplicateIndexes: duplicateIndexes,
+        /** unique values and their info */
+        uniqueValues: uniqueValues,
+        /** the unique version of this array */
+        uniqueArray: uniqueArray
+    };
+}
+/** returns true if the element is a group of items */
+export function IsMultiLevelGroup(groupOrItem) {
+    let asGroup = groupOrItem;
+    return !isNullOrUndefined(asGroup.subGroups) && Array.isArray(asGroup.groupItems) && isNumber(asGroup.index) && isNumber(asGroup.depth);
+}
+/** returns a flat array of groups>items ordered by groups */
+export function FlattenGroupItems(groups) {
+    let flatItems = [];
+    Object.keys(groups).forEach(groupName => {
+        let group = groups[groupName];
+        if (!isNullOrEmptyString(groupName))
+            flatItems.push(group);
+        let subGroups = Object.keys(group.subGroups);
+        if (isNotEmptyArray(subGroups)) {
+            flatItems.push(...FlattenGroupItems(group.subGroups));
+        }
+        else
+            flatItems.push(...group.groupItems);
+    });
+    return flatItems;
+}
+/** split a collection by page size and return the info */
+export function GetPagedCollectionInfo(collection, pageSize, currentPage) {
+    let pagedItems = [];
+    if (pageSize < 1) {
+        pagedItems = [collection.slice()];
+    }
+    else {
+        let copy = collection.slice();
+        while (isNotEmptyArray(copy)) {
+            pagedItems.push(copy.splice(0, pageSize));
+        }
+    }
+    currentPage = isNumber(currentPage) && currentPage >= 0 && currentPage < pagedItems.length ? currentPage : 0;
+    return {
+        /** nubmer of pages */
+        pages: pagedItems.length,
+        /** page items, per page (Array of pages, each has an array of the page items) */
+        pagedItems: pagedItems,
+        /** the current page */
+        currentPage: currentPage,
+        /** the current page items */
+        currentPageItems: pagedItems[currentPage] || [],
+        /** has more than 1 page */
+        hasPages: pagedItems.length > 1,
+        allowPrev: currentPage > 0,
+        allowNext: currentPage < pagedItems.length - 1
+    };
+}
+/** use with sortArray or get unique array to handle premitive types or dates, with a JSON.stringify to all other values */
+export function defaultPrimitiveGetValue(item) {
+    return isNullOrUndefined(item)
+        ? ""
+        : isDate(item) ? item.getTime()
+            : isBoolean(item)
+                ? item === true ? 1 : 0
+                : isNumber(item) || isString(item)
+                    ? item
+                    : JSON.stringify(item);
+}
+export function RemoveItemFromArr(arr, item) {
+    let idx = arr.indexOf(item);
+    if (idx >= 0)
+        arr.splice(idx, 1);
+}
+export function PushNoDuplicate(arr, item) {
+    if (!arr.includes(item))
+        arr.push(item);
+}
+/** fills an array with a value. Array.fill isn't available on SPFx. */
+export function ArrayFill(arr, value, onlyEmpty) {
+    for (let i = 0; i < arr.length; i++) {
+        if (onlyEmpty !== true || isNullOrUndefined(arr[i]))
+            arr[i] = value;
+    }
+    return arr;
+}
+/** give a name and a collection, and it will return a unique name availalbe, suffixing a _# to the name
+ * example: file
+ * return file, file_2, file_9 etc... whichever is availalbe first.
+ */
+export function FindNextAvailableName(name, usedNames, options) {
+    let nameForTest = name;
+    if (options && options.caseSensitive !== true) {
+        usedNames = usedNames.map(n => n.toLowerCase());
+        nameForTest = name.toLowerCase();
+    }
+    let nameSuffix = options && options.suffix || "";
+    let suffixIdx = 0;
+    let suffixStr = "";
+    while (usedNames.indexOf(`${nameForTest}${suffixStr}${nameSuffix}`) >= 0) {
+        suffixIdx++;
+        suffixStr = "_" + suffixIdx;
+    }
+    return `${name}${suffixStr}${nameSuffix}`;
+}
+//** returns an array of numbers from 0,1,2... */
+export function numbersArray(length, startFrom = 0) {
+    //dvp build will fail without any type
+    if (isNullOrUndefined(length) || length < 0)
+        length = 0;
+    let arr = Array.from(Array(length).keys());
+    return startFrom > 0
+        ? arr.map(i => i + startFrom)
+        : arr;
+}
+//# sourceMappingURL=collections.base.js.map

package/lib/esm/helpers/collections.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.base.js","sourceRoot":"","sources":["../../../src/helpers/collections.base.ts"],"names":[],"mappings":"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"}

package/lib/esm/helpers/collections.js

@@ -0,0 +1,96 @@
+import { hasOwnProperty, objectsEqual } from "./objects";
+import { isFunction, isNotEmptyArray, isNullOrEmptyArray, isNullOrEmptyString, isNullOrUndefined, isNumber, isString } from "./typecheckers";
+/** check that every element in the arrays are the same value */
+export function arraysEqual(arr1, arr2) {
+    if (isNullOrEmptyArray(arr1) && isNullOrEmptyArray(arr2))
+        return true;
+    return Array.isArray(arr1) && Array.isArray(arr2) && arr1.length === arr2.length && arr1.every((v1, i) => {
+        var v2 = arr2[i];
+        if (isString(v1) || isNumber(v1)) {
+            return v1 === v2;
+        }
+        else if (Array.isArray(v1) && Array.isArray(v2)) {
+            return arraysEqual(v1, v2);
+        }
+        else {
+            return objectsEqual(v1, v2);
+        }
+    });
+}
+/** Takes an array and transforms it into a dictionary. this will assign all items of the same key as an array. */
+export function groupBy(arr, getKeys, filter) {
+    let dic = {};
+    if (isNotEmptyArray(arr))
+        arr.forEach(i => {
+            if (!isFunction(filter) || filter(i)) {
+                let keys = getKeys(i);
+                keys.forEach(key => {
+                    if (isNullOrEmptyString(key))
+                        key = "";
+                    if (!hasOwnProperty(dic, key))
+                        dic[key] = [i];
+                    else
+                        dic[key].push(i);
+                });
+            }
+        });
+    return dic;
+}
+var groupByMultipleCacheKey = "$groupByMultipleCache";
+/** allows nested multi-level grouping */
+export function GroupByMultiple(arr, groupDefinitions, options) {
+    options = options || {};
+    if (options.clearCache || isNullOrUndefined(arr[groupByMultipleCacheKey])) {
+        let dic = {};
+        let groupDefinition = groupDefinitions[0]; //get first
+        let getKeys = groupDefinition.getGroupsForThisElement;
+        if (isNotEmptyArray(arr)) {
+            let groupIndex = 0;
+            arr.forEach(i => {
+                if (!isFunction(options.filter) || options.filter(i)) {
+                    let keys = getKeys(i);
+                    keys.forEach(key => {
+                        if (isNullOrEmptyString(key))
+                            key = "";
+                        if (!hasOwnProperty(dic, key)) {
+                            let groupKey = groupIndex.toString(10);
+                            let groupKeyParent = options.parentGroup;
+                            while (groupKeyParent) {
+                                groupKey = groupKeyParent.index + "_" + groupKey;
+                                groupKeyParent = groupKeyParent.parentGroup;
+                            }
+                            dic[key] = {
+                                groupItems: [],
+                                subGroups: {},
+                                depth: options.parentGroup ? options.parentGroup.depth + 1 : 0,
+                                parentGroup: options.parentGroup,
+                                key: groupKey,
+                                index: groupIndex,
+                                title: key,
+                                groupPrefix: groupDefinition.groupPrefix,
+                                fullTitle: `${isNullOrEmptyString(groupDefinition.groupPrefix) ? "" : groupDefinition.groupPrefix}${key}`
+                            };
+                            groupIndex++;
+                        }
+                        let itemWithGroup = i;
+                        itemWithGroup.parentGroup = dic[key];
+                        dic[key].groupItems.push(itemWithGroup);
+                    });
+                }
+            });
+        }
+        if (isNotEmptyArray(groupDefinitions) && groupDefinitions.length > 1) {
+            //run for every group and call this again
+            Object.keys(dic).forEach(groupName => {
+                let currentGroup = dic[groupName];
+                currentGroup.subGroups = GroupByMultiple(currentGroup.groupItems, groupDefinitions.slice(1), {
+                    ...options,
+                    parentGroup: currentGroup
+                });
+            });
+        }
+        arr[groupByMultipleCacheKey] = dic;
+    }
+    return arr[groupByMultipleCacheKey];
+}
+//# sourceMappingURL=collections.js.map

package/lib/esm/helpers/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../../src/helpers/collections.ts"],"names":[],"mappings":"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"}

package/lib/esm/helpers/color.js

@@ -0,0 +1,51 @@
+import { isNullOrEmptyString } from "./typecheckers";
+/** get the oposite color of a color, or the best contrasting black or white. This is useful to know which color text to show on a dynamic background color */
+export function invertColor(color, blackOrWhite, defaultIfEmpty) {
+    if (isNullOrEmptyString(color) && !isNullOrEmptyString(defaultIfEmpty))
+        return defaultIfEmpty;
+    let rgba = colorToRGBA(color);
+    if (blackOrWhite) {
+        // http://stackoverflow.com/a/3943023/112731
+        return (rgba.r * 0.299 + rgba.g * 0.587 + rgba.b * 0.114) > 186
+            ? '#000000'
+            : '#FFFFFF';
+    }
+    // invert color components
+    let _r = (255 - rgba.r);
+    let _g = (255 - rgba.g);
+    let _b = (255 - rgba.b);
+    // pad each with zeros and return
+    return "#" + byteToHex(_r) + byteToHex(_g) + byteToHex(_b);
+}
+/** Returns the color as an array of [r, g, b, a] -- all range from 0 - 255 */
+export function colorToRGBA(color) {
+    // Returns the color as an array of [r, g, b, a] -- all range from 0 - 255
+    // color must be a valid canvas fillStyle. This will cover most anything
+    // you'd want to use.
+    // Examples:
+    // colorToRGBA('red')  # [255, 0, 0, 255]
+    // colorToRGBA('#f00') # [255, 0, 0, 255]
+    let cvs = document.createElement('canvas');
+    cvs.height = 1;
+    cvs.width = 1;
+    let ctx = cvs.getContext('2d');
+    ctx.fillStyle = color;
+    ctx.fillRect(0, 0, 1, 1);
+    let data = ctx.getImageData(0, 0, 1, 1).data;
+    return { r: data[0], g: data[1], b: data[2], a: data[3] };
+}
+function byteToHex(num) {
+    // Turns a number (0-255) into a 2-character hex number (00-ff)
+    return ('0' + num.toString(16)).slice(-2);
+}
+/** Convert any CSS color to a hex representation, returns #000000 */
+export function colorToHex(color) {
+    // 
+    // Examples:
+    // colorToHex('red')            # '#ff0000'
+    // colorToHex('rgb(255, 0, 0)') # '#ff0000'
+    let rgba = colorToRGBA(color);
+    let hex = byteToHex(rgba.r) + byteToHex(rgba.g) + byteToHex(rgba.b);
+    return "#" + hex;
+}
+//# sourceMappingURL=color.js.map

package/lib/esm/helpers/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../../src/helpers/color.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,8JAA8J;AAC9J,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,YAAsB,EAAE,cAAuB;IACtF,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC;QAAE,OAAO,cAAc,CAAC;IAC9F,IAAI,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAE9B,IAAI,YAAY,EAAE,CAAC;QACf,4CAA4C;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG;YAC3D,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,CAAC;IACpB,CAAC;IACD,0BAA0B;IAC1B,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,iCAAiC;IACjC,OAAO,GAAG,GAAG,SAAS,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC;AAGD,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,KAAa;IACrC,0EAA0E;IAC1E,wEAAwE;IACxE,qBAAqB;IACrB,YAAY;IACZ,yCAAyC;IACzC,yCAAyC;IACzC,IAAI,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACf,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC;IACtB,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzB,IAAI,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC1B,+DAA+D;IAC/D,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,UAAU,CAAC,KAAa;IACpC,GAAG;IACH,YAAY;IACZ,2CAA2C;IAC3C,2CAA2C;IAC3C,IAAI,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,GAAG,GAAG,GAAG,CAAC;AACrB,CAAC"}

package/lib/esm/helpers/cookies.js

@@ -0,0 +1,53 @@
+import { trim } from "./strings";
+import { isNullOrEmptyString, isNumeric, isString } from "./typecheckers";
+var _zeroDay = new Date(0);
+var _today = new Date();
+export function deleteCookie(cookieName, path) {
+    var days = (_zeroDay.getTime() - _today.getTime()) / (24 * 60 * 60 * 1000);
+    setCookie(cookieName, "", Math.round(days), path);
+}
+export function getAllCookies(prefix) {
+    let cookies = document.cookie.split(';');
+    let names = [];
+    for (var k = 0; k < cookies.length; k++) {
+        let cookieSplit = cookies[k].split('=');
+        let cookieName = trim(cookieSplit[0]);
+        if (isNullOrEmptyString(prefix) || cookieName.indexOf(prefix) === 0)
+            names.push(cookieName);
+    }
+    return names;
+}
+/** get a cookie's value by that name, or null */
+export function getCookie(cookieName) {
+    try {
+        let cookies = document.cookie.split(';');
+        for (var k = 0; k < cookies.length; k++) {
+            let cookieSplit = cookies[k].split('=');
+            if (trim(cookieSplit[0]) === cookieName) {
+                return decodeURIComponent(trim(cookieSplit[1]));
+            }
+        }
+    }
+    catch (e) { }
+    return null;
+}
+/** set a cookie by that name and value. if you do not send expireDays, it will be a session cookie (in memory) */
+export function setCookie(name, value, expireDays, path) {
+    var cookie = [];
+    var cookieValue = `${name}=${isString(value) ? value : ""}`;
+    cookie.push(cookieValue);
+    if (isNumeric(expireDays)) {
+        var d = new Date();
+        d.setTime(d.getTime() + (expireDays * 24 * 60 * 60 * 1000));
+        var cookieExpires = "expires=" + d.toUTCString();
+        cookie.push(cookieExpires);
+    }
+    var cookiePath = `${isString(path) ? `path=` + path : "path=/"}`;
+    cookie.push(cookiePath);
+    document.cookie = cookie.join(";");
+}
+export function cookieEnabled() {
+    let enabled = "navigator" in globalThis && navigator.cookieEnabled === true;
+    return enabled;
+}
+//# sourceMappingURL=cookies.js.map

package/lib/esm/helpers/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../../src/helpers/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1E,IAAI,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3B,IAAI,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;AAExB,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,IAAa;IAC1D,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3E,SAAS,CAAC,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAe;IACzC,IAAI,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,SAAS,CAAC,UAAkB;IACxC,IAAI,CAAC;QACD,IAAI,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;gBACtC,OAAO,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpD,CAAC;QACL,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,OAAO,IAAI,CAAC;AAChB,CAAC;AACD,kHAAkH;AAClH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,UAAmB,EAAE,IAAa;IACrF,IAAI,MAAM,GAAa,EAAE,CAAC;IAE1B,IAAI,WAAW,GAAG,GAAG,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC5D,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEzB,IAAI,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QACnB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,aAAa,GAAG,UAAU,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,UAAU,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAExB,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa;IACzB,IAAI,OAAO,GAAG,WAAW,IAAI,UAAU,IAAI,SAAS,CAAC,aAAa,KAAK,IAAI,CAAC;IAC5E,OAAO,OAAO,CAAC;AACnB,CAAC"}