topkat-utils 1.1.13 → 1.1.14

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+export * from './src/array-utils';
+export * from './src/date-utils';
+export * from './src/env-utils';
+export * from './src/error-utils';
+export * from './src/isset';
+export * from './src/logger-utils';
+export * from './src/loop-utils';
+export * from './src/math-utils';
+export * from './src/mongo-utils';
+export * from './src/object-utils';
+export * from './src/string-utils';
+export * from './src/wtf-utils';
+export * from './src/validation-utils';
+export * from './src/transaction-utils';
+export * from './src/timer-utils';
+export * from './src/is-empty';
+export * from './src/remove-circular-json-stringify';
+export * from './src/is-object';
+export * from './src/regexp-utils';
+export * from './src/private/error-handler';
+export { registerConfig } from './src/config';
+import { moyenne } from './src/math-utils';
+import { kebabCase, snakeCase } from './src/string-utils';
+import { shuffleArray, noDuplicateFilter } from './src/array-utils';
+import { issetOr, validator } from './src/validation-utils';
+import { objFilterUndefinedRecursive } from './src/object-utils';
+export declare const int: typeof parseInt;
+export declare const average: typeof moyenne;
+export declare const arrayUniqueValue: typeof noDuplicateFilter;
+export declare const JSONstringyParse: (o: any) => any;
+export declare const removeUndefinedKeys: typeof objFilterUndefinedRecursive;
+export declare const randomizeArray: typeof shuffleArray;
+export declare const dashCase: typeof kebabCase;
+export declare const underscoreCase: typeof snakeCase;
+export declare const required: typeof validator;
+export declare const orIsset: typeof issetOr;

package/dist/index.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orIsset = exports.required = exports.underscoreCase = exports.dashCase = exports.randomizeArray = exports.removeUndefinedKeys = exports.JSONstringyParse = exports.arrayUniqueValue = exports.average = exports.int = exports.registerConfig = void 0;
+__exportStar(require("./src/array-utils"), exports);
+__exportStar(require("./src/date-utils"), exports);
+__exportStar(require("./src/env-utils"), exports);
+__exportStar(require("./src/error-utils"), exports);
+__exportStar(require("./src/isset"), exports);
+__exportStar(require("./src/logger-utils"), exports);
+__exportStar(require("./src/loop-utils"), exports);
+__exportStar(require("./src/math-utils"), exports);
+__exportStar(require("./src/mongo-utils"), exports);
+__exportStar(require("./src/object-utils"), exports);
+__exportStar(require("./src/string-utils"), exports);
+__exportStar(require("./src/wtf-utils"), exports);
+__exportStar(require("./src/validation-utils"), exports);
+__exportStar(require("./src/transaction-utils"), exports);
+__exportStar(require("./src/timer-utils"), exports);
+__exportStar(require("./src/is-empty"), exports);
+__exportStar(require("./src/remove-circular-json-stringify"), exports);
+__exportStar(require("./src/is-object"), exports);
+__exportStar(require("./src/regexp-utils"), exports);
+__exportStar(require("./src/private/error-handler"), exports);
+var config_1 = require("./src/config");
+Object.defineProperty(exports, "registerConfig", { enumerable: true, get: function () { return config_1.registerConfig; } });
+var math_utils_1 = require("./src/math-utils");
+var string_utils_1 = require("./src/string-utils");
+var array_utils_1 = require("./src/array-utils");
+var validation_utils_1 = require("./src/validation-utils");
+var object_utils_1 = require("./src/object-utils");
+var remove_circular_json_stringify_1 = require("./src/remove-circular-json-stringify");
+// ALIASES
+exports.int = parseInt;
+exports.average = math_utils_1.moyenne;
+exports.arrayUniqueValue = array_utils_1.noDuplicateFilter;
+var JSONstringyParse = function (o) { return JSON.parse((0, remove_circular_json_stringify_1.removeCircularJSONstringify)(o)); };
+exports.JSONstringyParse = JSONstringyParse;
+exports.removeUndefinedKeys = object_utils_1.objFilterUndefinedRecursive;
+exports.randomizeArray = array_utils_1.shuffleArray;
+exports.dashCase = string_utils_1.kebabCase;
+exports.underscoreCase = string_utils_1.snakeCase;
+exports.required = validation_utils_1.validator; // alias for readability
+exports.orIsset = validation_utils_1.issetOr;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAiC;AACjC,mDAAgC;AAChC,kDAA+B;AAC/B,oDAAiC;AACjC,8CAA2B;AAC3B,qDAAkC;AAClC,mDAAgC;AAChC,mDAAgC;AAChC,oDAAiC;AACjC,qDAAkC;AAClC,qDAAkC;AAClC,kDAA+B;AAC/B,yDAAsC;AACtC,0DAAuC;AACvC,oDAAiC;AACjC,iDAA8B;AAC9B,uEAAoD;AACpD,kDAA+B;AAC/B,qDAAkC;AAClC,8DAA2C;AAC3C,uCAA6C;AAApC,wGAAA,cAAc,OAAA;AAEvB,+CAA0C;AAC1C,mDAAyD;AACzD,iDAAmE;AACnE,2DAA2D;AAC3D,mDAAgE;AAChE,uFAAkF;AAElF,UAAU;AACG,QAAA,GAAG,GAAG,QAAQ,CAAA;AACd,QAAA,OAAO,GAAG,oBAAO,CAAA;AACjB,QAAA,gBAAgB,GAAG,+BAAiB,CAAA;AAC1C,IAAM,gBAAgB,GAAG,UAAA,CAAC,IAAI,OAAA,IAAI,CAAC,KAAK,CAAC,IAAA,4DAA2B,EAAC,CAAC,CAAC,CAAC,EAA1C,CAA0C,CAAA;AAAlE,QAAA,gBAAgB,oBAAkD;AAClE,QAAA,mBAAmB,GAAG,0CAA2B,CAAA;AACjD,QAAA,cAAc,GAAG,0BAAY,CAAA;AAC7B,QAAA,QAAQ,GAAG,wBAAS,CAAA;AACpB,QAAA,cAAc,GAAG,wBAAS,CAAA;AAC1B,QAAA,QAAQ,GAAG,4BAAS,CAAA,CAAC,wBAAwB;AAC7C,QAAA,OAAO,GAAG,0BAAO,CAAA"}

package/dist/src/array-utils.d.ts

@@ -0,0 +1,56 @@
+export declare function shuffleArray(array: any): any;
+/**
+ * Maye sure obj[addr] is an array and push a value to it
+ * @param {Object} obj parent object
+ * @param {String} addr field name in parent
+ * @param {Any} valToPush
+ * @param {Boolean} onlyUniqueValues default:false; may be true or a comparision function; (a,b) => return true if they are the same like (a, b) => a.name === b.name
+ * @return obj[addr] eventually processed by the callback
+ */
+export declare function ensureIsArrayAndPush(obj: object, addr: string, valToPush: any, onlyUniqueValues: Function): any;
+/** If a string is provided, return it as array else return the value */
+export declare function strAsArray(arrOrStr: any): any;
+/** If not an array provided, return the array with the value
+ * /!\ NOTE /!\ In case the value is null or undefined, it will return that value
+ */
+export declare function asArray<T extends any[] | any>(item: T): T extends undefined ? undefined : T extends any[] ? T : T[];
+/** Array comparison
+ * @return {object} { inCommon, notInB, notInA }
+ */
+export declare function compareArrays(arrayA: any[], arrayB: any[], compare?: (a: any, b: any) => boolean): {
+    inCommon: any[];
+    notInB: any[];
+    notInA: any[];
+};
+/**
+ * @return [] only elements that are both in arrayA and arrayB
+ */
+export declare function getArrayInCommon(arrayA?: any[], arrayB?: any[], compare?: (a: any, b: any) => boolean): any[];
+/**
+ * @return [] only elements that are in arrayB and not in arrayA
+ */
+export declare function getNotInArrayA(arrayA?: any[], arrayB?: any[], compare?: (a: any, b: any) => boolean): any[];
+/**
+ * @return [] only elements that are in neither arrayA and arrayB
+ */
+export declare function getArrayDiff(arrayA?: any[], arrayB?: any[], compare?: (a: any, b: any) => boolean): any[];
+/** filter duplicate values in an array
+ * @param {function} comparisonFn default:(a, b) => a === b. A function that shall return true if two values are considered equal
+ * @return {array|function}
+ */
+export declare function noDuplicateFilter(arr: any, comparisonFn?: (a: any, b: any) => boolean): any[];
+/** Count number of occurence of item in array */
+export declare function arrayCount(item: any, arr: any[]): number;
+/**
+ * Sort an array in an object of subArrays, no duplicate.
+ * @param {Array} array
+ * @param {function} getFieldFromItem (itemOfArray) => field[String|Number]
+ * tell me how you want to sort your Array
+ */
+export declare function arrayToObjectSorted(array: any, getFieldFromItem: any): {};
+/**
+ * @param {Function} comparisonFunction default: (itemToPush, itemAlreadyInArray) => itemToPush === itemAlreadyInArray; comparison function to consider the added item duplicate
+ */
+export declare function pushIfNotExist(arrayToPushInto: any, valueOrArrayOfValuesToBePushed: any, comparisonFunction?: (a: any, b: any) => boolean): any[];
+export declare function isNotEmptyArray(arr: any): boolean;
+export declare function randomItemInArray<T>(array: T[]): T;

package/dist/src/array-utils.js

@@ -0,0 +1,160 @@
+"use strict";
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomItemInArray = exports.isNotEmptyArray = exports.pushIfNotExist = exports.arrayToObjectSorted = exports.arrayCount = exports.noDuplicateFilter = exports.getArrayDiff = exports.getNotInArrayA = exports.getArrayInCommon = exports.compareArrays = exports.asArray = exports.strAsArray = exports.ensureIsArrayAndPush = exports.shuffleArray = void 0;
+//----------------------------------------
+// ARRAY UTILS
+//----------------------------------------
+var object_utils_1 = require("./object-utils");
+var isset_1 = require("./isset");
+function shuffleArray(array) {
+    var _a;
+    for (var i = array.length - 1; i > 0; i--) {
+        var j = Math.floor(Math.random() * (i + 1));
+        _a = [array[j], array[i]], array[i] = _a[0], array[j] = _a[1];
+    }
+    return array;
+}
+exports.shuffleArray = shuffleArray;
+/**
+ * Maye sure obj[addr] is an array and push a value to it
+ * @param {Object} obj parent object
+ * @param {String} addr field name in parent
+ * @param {Any} valToPush
+ * @param {Boolean} onlyUniqueValues default:false; may be true or a comparision function; (a,b) => return true if they are the same like (a, b) => a.name === b.name
+ * @return obj[addr] eventually processed by the callback
+ */
+function ensureIsArrayAndPush(obj, addr, valToPush, onlyUniqueValues) {
+    return (0, object_utils_1.ensureObjectProp)(obj, addr, [], function (objValue) {
+        if ((0, isset_1.isset)(onlyUniqueValues)) {
+            var duplicateFound = false;
+            if (typeof onlyUniqueValues === 'function')
+                duplicateFound = objValue.some(function (a) { return onlyUniqueValues(a, valToPush); });
+            else
+                duplicateFound = objValue.includes(valToPush);
+            if (!duplicateFound)
+                objValue.push(valToPush);
+        }
+        else
+            objValue.push(valToPush);
+    });
+}
+exports.ensureIsArrayAndPush = ensureIsArrayAndPush;
+/** If a string is provided, return it as array else return the value */
+function strAsArray(arrOrStr) {
+    return typeof arrOrStr === 'string' ? [arrOrStr] : arrOrStr;
+}
+exports.strAsArray = strAsArray;
+/** If not an array provided, return the array with the value
+ * /!\ NOTE /!\ In case the value is null or undefined, it will return that value
+ */
+function asArray(item) {
+    return (typeof item === 'undefined' ? item : Array.isArray(item) ? item : [item]);
+}
+exports.asArray = asArray;
+/** Array comparison
+ * @return {object} { inCommon, notInB, notInA }
+ */
+function compareArrays(arrayA, arrayB, compare) {
+    if (compare === void 0) { compare = function (a, b) { return a === b; }; }
+    return {
+        inCommon: getArrayInCommon(arrayA, arrayB, compare),
+        notInB: getNotInArrayA(arrayB, arrayA, compare),
+        notInA: getNotInArrayA(arrayA, arrayB, compare),
+    };
+}
+exports.compareArrays = compareArrays;
+/**
+ * @return [] only elements that are both in arrayA and arrayB
+ */
+function getArrayInCommon(arrayA, arrayB, compare) {
+    if (arrayA === void 0) { arrayA = []; }
+    if (arrayB === void 0) { arrayB = []; }
+    if (compare === void 0) { compare = function (a, b) { return a === b; }; }
+    if (!Array.isArray(arrayA) || !Array.isArray(arrayB))
+        return [];
+    else
+        return arrayA.filter(function (a) { return arrayB.some(function (b) { return compare(a, b); }); });
+}
+exports.getArrayInCommon = getArrayInCommon;
+/**
+ * @return [] only elements that are in arrayB and not in arrayA
+ */
+function getNotInArrayA(arrayA, arrayB, compare) {
+    if (arrayA === void 0) { arrayA = []; }
+    if (arrayB === void 0) { arrayB = []; }
+    if (compare === void 0) { compare = function (a, b) { return a === b; }; }
+    if (!Array.isArray(arrayA) && Array.isArray(arrayB))
+        return arrayB;
+    else if (!Array.isArray(arrayB))
+        return [];
+    else
+        return arrayB.filter(function (b) { return !arrayA.some(function (a) { return compare(a, b); }); });
+}
+exports.getNotInArrayA = getNotInArrayA;
+/**
+ * @return [] only elements that are in neither arrayA and arrayB
+ */
+function getArrayDiff(arrayA, arrayB, compare) {
+    if (arrayA === void 0) { arrayA = []; }
+    if (arrayB === void 0) { arrayB = []; }
+    if (compare === void 0) { compare = function (a, b) { return a === b; }; }
+    return __spreadArray(__spreadArray([], getNotInArrayA(arrayA, arrayB, compare), true), getNotInArrayA(arrayB, arrayA, compare), true);
+}
+exports.getArrayDiff = getArrayDiff;
+/** filter duplicate values in an array
+ * @param {function} comparisonFn default:(a, b) => a === b. A function that shall return true if two values are considered equal
+ * @return {array|function}
+ */
+function noDuplicateFilter(arr, comparisonFn) {
+    if (comparisonFn === void 0) { comparisonFn = function (a, b) { return a === b; }; }
+    return arr.filter(function (a, i, arr) { return arr.findIndex(function (b) { return comparisonFn(a, b); }) === i; });
+}
+exports.noDuplicateFilter = noDuplicateFilter;
+/** Count number of occurence of item in array */
+function arrayCount(item, arr) {
+    return arr.reduce(function (total, item2) { return item === item2 ? total + 1 : total; }, 0);
+}
+exports.arrayCount = arrayCount;
+/**
+ * Sort an array in an object of subArrays, no duplicate.
+ * @param {Array} array
+ * @param {function} getFieldFromItem (itemOfArray) => field[String|Number]
+ * tell me how you want to sort your Array
+ */
+function arrayToObjectSorted(array, getFieldFromItem) {
+    var res = {};
+    array.forEach(function (item) {
+        (0, object_utils_1.objForceWriteIfNotSet)(res, getFieldFromItem(item), []);
+        res[getFieldFromItem(item)].push(item);
+    });
+    return res;
+}
+exports.arrayToObjectSorted = arrayToObjectSorted;
+/**
+ * @param {Function} comparisonFunction default: (itemToPush, itemAlreadyInArray) => itemToPush === itemAlreadyInArray; comparison function to consider the added item duplicate
+ */
+function pushIfNotExist(arrayToPushInto, valueOrArrayOfValuesToBePushed, comparisonFunction) {
+    if (comparisonFunction === void 0) { comparisonFunction = function (a, b) { return a === b; }; }
+    var valuesToPush = asArray(valueOrArrayOfValuesToBePushed).filter(function (a) { return !arrayToPushInto.some(function (b) { return comparisonFunction(a, b); }); });
+    arrayToPushInto.push.apply(arrayToPushInto, valuesToPush);
+    return arrayToPushInto;
+}
+exports.pushIfNotExist = pushIfNotExist;
+function isNotEmptyArray(arr) {
+    return Array.isArray(arr) && !!arr.length;
+}
+exports.isNotEmptyArray = isNotEmptyArray;
+function randomItemInArray(array) {
+    return array[Math.floor(Math.random() * array.length)];
+}
+exports.randomItemInArray = randomItemInArray;
+//# sourceMappingURL=array-utils.js.map

package/dist/src/array-utils.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,44 @@
+import { Color } from './private/types';
+export declare type TopkatUtilConfig = {
+    env: string;
+    isProd: boolean;
+    nbOfLogsToKeep?: number;
+    customTypes: object;
+    preprocessLog?: Function;
+    terminal: {
+        noColor: boolean;
+        theme: {
+            primary: Color;
+            shade1: Color;
+            shade2: Color;
+            bgColor?: Color;
+            paddingX?: number;
+            paddingY?: number;
+            fontColor?: Color;
+            pageWidth?: number;
+            debugModeColor?: Color;
+        };
+    };
+};
+/** Allow dynamic changing of config */
+export declare function configFn(): TopkatUtilConfig;
+/** Register custom config
+ * @param {object} customConfig { 'email': email => /.+@.+/.test(email), type2 : myTestFunction() }
+ * * env: 'development',
+ * * customTypes: {},
+ * * terminal: {
+ * *     noColor: false, // disable colored escape sequences like /mOO35...etc
+ * *     theme: {
+ * *         primary: [61, 167, 32], // main color (title font)
+ * *         shade1: [127, 192, 39], // gradient shade 1
+ * *         shade2: [194, 218, 47], // gradient shade 2
+ * *         bgColor: false,         // background color
+ * *         paddingX: 2,            // nb spaces added before an outputted str
+ * *         paddingY: 2,            //
+ * *         fontColor: false,       // default font color
+ * *         pageWidth: 53,          // page size in character
+ * *         debugModeColor: [147, 212, 6], // usually orange
+ * *     }
+ * * },
+ */
+export declare function registerConfig(customConfig: any): void;

package/dist/src/config.js

@@ -0,0 +1,66 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerConfig = exports.configFn = void 0;
+var isset_1 = require("./isset");
+var config = {
+    env: 'development',
+    isProd: false,
+    nbOfLogsToKeep: 25,
+    customTypes: {},
+    terminal: {
+        noColor: false,
+        theme: {
+            primary: [0, 149, 250],
+            shade1: [0, 90, 250],
+            shade2: [0, 208, 245],
+            paddingX: 2,
+            paddingY: 2,
+            pageWidth: 53,
+            debugModeColor: [201, 27, 169],
+        }
+    },
+};
+/** Allow dynamic changing of config */
+function configFn() { return config; }
+exports.configFn = configFn;
+/** Register custom config
+ * @param {object} customConfig { 'email': email => /.+@.+/.test(email), type2 : myTestFunction() }
+ * * env: 'development',
+ * * customTypes: {},
+ * * terminal: {
+ * *     noColor: false, // disable colored escape sequences like /mOO35...etc
+ * *     theme: {
+ * *         primary: [61, 167, 32], // main color (title font)
+ * *         shade1: [127, 192, 39], // gradient shade 1
+ * *         shade2: [194, 218, 47], // gradient shade 2
+ * *         bgColor: false,         // background color
+ * *         paddingX: 2,            // nb spaces added before an outputted str
+ * *         paddingY: 2,            //
+ * *         fontColor: false,       // default font color
+ * *         pageWidth: 53,          // page size in character
+ * *         debugModeColor: [147, 212, 6], // usually orange
+ * *     }
+ * * },
+ */
+function registerConfig(customConfig) {
+    if (!(0, isset_1.isset)(customConfig.terminal))
+        customConfig.terminal = {};
+    var newconfig = __assign(__assign({}, config), customConfig);
+    newconfig.terminal = __assign(__assign({}, config.terminal), customConfig.terminal);
+    newconfig.terminal.theme = __assign(__assign({}, config.terminal.theme), (customConfig.terminal.theme || {}));
+    config = newconfig;
+    config.isProd = config.env.includes('prod');
+}
+exports.registerConfig = registerConfig;
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AACA,iCAA+B;AAwB/B,IAAI,MAAM,GAAqB;IAC3B,GAAG,EAAE,aAAa;IAClB,MAAM,EAAE,KAAK;IACb,cAAc,EAAE,EAAE;IAClB,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE;QACN,OAAO,EAAE,KAAK;QACd,KAAK,EAAE;YACH,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC;YACtB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC;YACrB,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,EAAE;YACb,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC;SACjC;KACJ;CACJ,CAAA;AAED,uCAAuC;AACvC,SAAgB,QAAQ,KAAK,OAAO,MAAM,CAAA,CAAC,CAAC;AAA5C,4BAA4C;AAG5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,cAAc,CAAC,YAAY;IACvC,IAAI,CAAC,IAAA,aAAK,EAAC,YAAY,CAAC,QAAQ,CAAC;QAAE,YAAY,CAAC,QAAQ,GAAG,EAAE,CAAA;IAC7D,IAAM,SAAS,yBACR,MAAM,GACN,YAAY,CAClB,CAAA;IACD,SAAS,CAAC,QAAQ,yBACX,MAAM,CAAC,QAAQ,GACf,YAAY,CAAC,QAAQ,CAC3B,CAAA;IACD,SAAS,CAAC,QAAQ,CAAC,KAAK,yBACjB,MAAM,CAAC,QAAQ,CAAC,KAAK,GACrB,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CACzC,CAAA;IACD,MAAM,GAAG,SAAS,CAAA;IAElB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC/C,CAAC;AAjBD,wCAiBC"}

package/dist/src/date-utils.d.ts

@@ -0,0 +1,100 @@
+export declare function getDateAsInt12(dateAllFormat?: Date | string | number, errIfNotValid?: any): string;
+export declare function humanReadableTimestamp(dateAllFormat: any): number;
+/** format for 6/8/2018 => 20180806
+ * @param dateAllFormat multiple format allowed 2012, 20120101, 201201011200, new Date(), "2019-12-08T16:19:10.341Z" and all string that new Date() can parse
+ */
+export declare function getDateAsInt(dateAllFormat?: Date | string | number, errIfNotValid$?: boolean, withHoursAndMinutes$?: boolean): string;
+export declare function getMonthAsInt(dateAllFormat?: Date | string | number): number;
+/**
+ * @param dateAllFormat multiple format allowed 2012, 20120101, 201201011200, new Date(), "2019-12-08T16:19:10.341Z" and all string that new Date() can parse
+ */
+export declare function getDateAsObject(dateAllFormat?: any, errIfNotValid$?: boolean): Date;
+/** [2018,01,06] */
+export declare function dateStringToArray(strOrInt: any): any[];
+/**
+ * @param dateAllFormat default: actualDate
+ * @returns ['01', '01', '2019'] OR **string** if separator is provided */
+export declare function dateArray(dateAllFormat?: Date | string | number): [string, string, string];
+/**
+ * @param dateAllFormat default: actualDate
+ * @returns ['01', '01', '2019'] OR **string** if separator is provided */
+export declare function dateArrayInt(dateAllFormat?: Date | string | number): [number, number, number];
+/**
+ * @return 01/01/2012 (alias of dateArrayFormatted(date, '/'))
+ */
+export declare function dateFormatted(dateAllFormat: Date | string | number, separator?: string): string;
+/** Date with custom offset (Ex: +2 for France) */
+export declare function dateOffset(offsetHours: any, dateObj?: Date): Date;
+/**  */
+export declare function getTimeAsInt(timeOrDateInt?: any): number | "dateInvalid";
+/**
+ * @param {timeInt|dateInt12} Eg: 2222 OR 201201012222. Default, actual dateInt12
+ * @param {String} separator default: ":"
+ */
+export declare function getIntAsTime(intOrDateTimeInt?: string, separator?: string): string;
+export declare function isTimeStringValid(timeStr: any, outputAnError$?: boolean): boolean;
+export declare function getDuration(startDate: any, endDate: any, inMinutes?: boolean): number | number[];
+/** compare two object with DATE INT, if they overlap return true
+ * @param {Object} event1 {startDate, endDate}
+ * @param {Object} event2 {startDate, endDate}
+ * @param {String} fieldNameForStartDate$ replace startDate with this string
+ * @param {String} fieldNameForEndDate$ replace endDate with this string
+ * @param {Boolean} allowNull$ if false, retrun false if any of the startdates or enddates are not set
+ * @param {Boolean} strict$ if true,
+ */
+export declare function doDateOverlap(event1: any, event2: any, fieldNameForStartDate$?: string, fieldNameForEndDate$?: string, allowNull$?: boolean, strict$?: boolean): boolean;
+declare type DateAllFormat = DateObjectFormat | DateStringFormats;
+declare type DateStringFormats = 'dateInt8' | 'dateInt12' | 'humanReadableTimestamp';
+declare type DateObjectFormat = 'date';
+export declare function nextWeekDay(fromDate: any, weekDayInt?: 0 | 1 | 2 | 3 | 4 | 5 | 6, outputFormat?: DateStringFormats, sameDayAllowed?: boolean): number;
+export declare function nextWeekDay(fromDate: any, weekDayInt?: 0 | 1 | 2 | 3 | 4 | 5 | 6, outputFormat?: DateObjectFormat, sameDayAllowed?: boolean): Date;
+/**
+ * @param {String} outputFormat dateInt, dateInt8, dateInt12, date, humanReadableTimestamp, int (dateInt8)
+ */
+export declare function addDays(dateAllFormat?: Date | string | number, numberOfDays?: number, outputFormat?: 'dateInt8' | 'dateInt12' | 'humanReadableTimestamp'): string;
+export declare function addDays(dateAllFormat?: Date | string | number, numberOfDays?: number, outputFormat?: 'date'): Date;
+/**
+ * @param {String} outputFormat dateInt, dateInt8, dateInt12, date, humanReadableTimestamp, int (dateInt8)
+ */
+export declare function addMinutes(dateAllFormat?: Date | string | number, numberOfMinutes?: number, outputFormat?: DateStringFormats): string;
+export declare function addMinutes(dateAllFormat?: Date | string | number, numberOfMinutes?: number, outputFormat?: DateObjectFormat): Date;
+/**
+ * @param {String} outputFormat dateInt, dateInt8, dateInt12, date, humanReadableTimestamp, int (dateInt8)
+ */
+export declare function addHours(dateAllFormat?: Date | string | number, numberOfHours?: number, outputFormat?: 'dateInt8' | 'dateInt12' | 'humanReadableTimestamp'): string;
+export declare function addHours(dateAllFormat?: Date | string | number, numberOfHours?: number, outputFormat?: 'date'): Date;
+/**
+ * @param {String} outputFormat dateInt, dateInt8, dateInt12, date, humanReadableTimestamp, int (dateInt8)
+ */
+export declare function addMonths(dateAllFormat?: Date | string | number, numberOfMonths?: number, outputFormat?: 'dateInt8' | 'dateInt12' | 'humanReadableTimestamp'): string;
+export declare function addMonths(dateAllFormat?: Date | string | number, numberOfMonths?: number, outputFormat?: 'date'): Date;
+/**
+ * @param {String} outputFormat dateInt, dateInt8, dateInt12, date, humanReadableTimestamp, int (dateInt8)
+ */
+export declare function addYears(dateAllFormat?: Date | string | number, numberOfYears?: number, outputFormat?: DateAllFormat): Date;
+export declare function getDayOfMonth(dateAllFormat?: Date | string | number): any;
+export declare function getYear(dateAllFormat?: Date | string | number): any;
+export declare function getHours(dateAllFormat?: Date | string | number): any;
+export declare function getMinutes(dateAllFormat?: Date | string | number): any;
+/**
+ * @param {String} outputFormat dateInt, dateInt8, dateInt12, date, humanReadableTimestamp, int (dateInt8)
+ */
+export declare function lastDayOfMonth(dateAllFormat?: Date | string | number, outputFormat?: DateAllFormat): Date;
+/**
+ * @param {String} outputFormat dateInt, dateInt8, dateInt12, date, humanReadableTimestamp, int (dateInt8)
+ */
+export declare function firstDayOfMonth(dateAllFormat?: Date | string | number, outputFormat?: DateAllFormat): Date;
+export declare function differenceInMilliseconds(startDateAllFormat: any, endDateAllFormat: any): number;
+export declare function differenceInSeconds(startDateAllFormat: any, endDateAllFormat: any): number;
+export declare function differenceInMinutes(startDateAllFormat: any, endDateAllFormat: any): number;
+export declare function differenceInHours(startDateAllFormat: any, endDateAllFormat: any): number;
+export declare function differenceInDays(startDateAllFormat: any, endDateAllFormat: any): number;
+export declare function differenceInWeeks(startDateAllFormat: any, endDateAllFormat: any): number;
+/**
+ * @param {String} outputDateFormat dateInt, dateInt8, dateInt12, date, humanReadableTimestamp, int (dateInt8)
+ */
+export declare function getDateAs(dateAllFormat?: Date | string | number, outputFormat?: 'dateInt8' | 'dateInt12' | 'humanReadableTimestamp'): string;
+export declare function getDateAs(dateAllFormat?: Date | string | number, outputFormat?: 'date'): Date;
+export declare function isDateIntOrStringValid(dateStringOrInt: any, outputAnError?: boolean, length?: any): boolean;
+export declare function isDateIsoOrObjectValid(dateIsoOrObj: any, outputAnError?: boolean): boolean;
+export {};