topkat-utils 1.0.60 → 1.1.2

package/dist/src/math-utils.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.minMax = exports.pad = exports.moyenne = exports.sumArray = exports.random = exports.isBetween = exports.round2 = exports.round = void 0;
+//----------------------------------------
+// MATH UTILS
+//----------------------------------------
+const isset_1 = require("./isset");
+/** Round with custom number of decimals (default:0) */
+function round(number, decimals = 0) { return Math.round((typeof number === 'number' ? number : parseFloat(number)) * Math.pow(10, decimals)) / Math.pow(10, decimals); }
+exports.round = round;
+/** Round with custom number of decimals (default:2) */
+function round2(number, decimals = 2) { return round(number, decimals); }
+exports.round2 = round2;
+/** Is number between two numbers (including those numbers) */
+function isBetween(number, min, max, inclusive = true) { return inclusive ? number <= max && number >= min : number < max && number > min; }
+exports.isBetween = isBetween;
+/** Random number between two values with 0 decimals by default */
+function random(nb1, nb2, nbOfDecimals = 0) { return round(Math.random() * (nb2 - nb1) + nb1, nbOfDecimals); }
+exports.random = random;
+/** Sum all values of an array, all values MUST be numbers */
+function sumArray(array) {
+    return array.filter(item => typeof item === 'number').reduce((sum, val) => (0, isset_1.isset)(val) ? val + sum : sum, 0);
+}
+exports.sumArray = sumArray;
+/** Moyenne / average between array of values
+ * @param {Number} round number of decimals to keep. Default:2
+*/
+function moyenne(array, nbOfDecimals = 2) {
+    return round(sumArray(array) / array.length, nbOfDecimals);
+}
+exports.moyenne = moyenne;
+/** length default 2, shortcut for 1 to 01 */
+function pad(numberOrStr, length = 2) { return ('' + numberOrStr).padStart(length, '0'); }
+exports.pad = pad;
+/** return the number or the closest number of the range
+ * * nb min max  => returns
+ * * 7  5   10   => 7 // in the range
+ * * 2  5   10   => 5 // below the min value
+ * * 99 5   10   => 10// above the max value
+ */
+function minMax(nb, min, max) { return Math.max(min, Math.min(nb, max)); }
+exports.minMax = minMax;
+//# sourceMappingURL=math-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"math-utils.js","sourceRoot":"","sources":["../../src/math-utils.ts"],"names":[],"mappings":";;;AAAA,0CAA0C;AAC1C,aAAa;AACb,0CAA0C;AAC1C,mCAA+B;AAE/B,uDAAuD;AACvD,SAAgB,KAAK,CAAC,MAAuB,EAAE,QAAQ,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA,CAAC,CAAC;AAAhM,sBAAgM;AAChM,uDAAuD;AACvD,SAAgB,MAAM,CAAC,MAAuB,EAAE,QAAQ,GAAG,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA,CAAC,CAAC;AAAhG,wBAAgG;AAEhG,8DAA8D;AAC9D,SAAgB,SAAS,CAAC,MAAc,EAAE,GAAW,EAAE,GAAW,EAAE,SAAS,GAAG,IAAI,IAAI,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,GAAG,GAAG,CAAA,CAAC,CAAC;AAA1K,8BAA0K;AAE1K,kEAAkE;AAClE,SAAgB,MAAM,CAAC,GAAW,EAAE,GAAW,EAAE,YAAY,GAAG,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,YAAY,CAAC,CAAA,CAAC,CAAC;AAApI,wBAAoI;AAEpI,6DAA6D;AAC7D,SAAgB,QAAQ,CAAC,KAAe;IACpC,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAA,aAAK,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;AAC/G,CAAC;AAFD,4BAEC;AAED;;EAEE;AACF,SAAgB,OAAO,CAAC,KAAe,EAAE,YAAY,GAAG,CAAC;IACrD,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAC9D,CAAC;AAFD,0BAEC;AAED,6CAA6C;AAC7C,SAAgB,GAAG,CAAC,WAA4B,EAAE,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA,CAAC,CAAC;AAAjH,kBAAiH;AAEjH;;;;;GAKG;AACH,SAAgB,MAAM,CAAC,EAAU,EAAE,GAAW,EAAE,GAAW,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAA,CAAC,CAAC;AAAxG,wBAAwG"}

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

@@ -0,0 +1,11 @@
+/** @return undefined if cannot find _id */
+export declare function getId(obj?: any): string;
+/** Merge filter with correct handling of OR and AND
+ * @param {Object} filterA
+ * @param {Object} filterB
+ * @param {Boolean} assignToFilterA defualt false: if true, it will modify filterA, else it will return merged filters as a new object
+ */
+export declare function mongoFilterMerger(filterA: any, filterB: any, assignToFilterA?: boolean): any;
+export declare function mongoPush(field: string, value: any, fields: {
+    [k: string]: any;
+}): void;

package/dist/src/mongo-utils.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mongoPush = exports.mongoFilterMerger = exports.getId = void 0;
+//----------------------------------------
+// MONGO UTILS
+//----------------------------------------
+const validation_utils_1 = require("./validation-utils");
+const isset_1 = require("./isset");
+/** @return undefined if cannot find _id */
+function getId(obj = {}) {
+    if (!obj)
+        return; // null case
+    if (obj._id)
+        return obj._id.toString();
+    else if ((0, validation_utils_1.isType)(obj, 'objectId'))
+        return obj.toString();
+}
+exports.getId = getId;
+/** Merge filter with correct handling of OR and AND
+ * @param {Object} filterA
+ * @param {Object} filterB
+ * @param {Boolean} assignToFilterA defualt false: if true, it will modify filterA, else it will return merged filters as a new object
+ */
+function mongoFilterMerger(filterA, filterB, assignToFilterA = false) {
+    if ((0, isset_1.isset)(filterA.$and) && (0, isset_1.isset)(filterB.$and)) {
+        filterA.$and.push(...filterB.$and);
+        delete filterB.$and;
+    }
+    if ((0, isset_1.isset)(filterA.$or) && (0, isset_1.isset)(filterB.$or)) {
+        if (!(0, isset_1.isset)(filterA.$and))
+            filterA.$and = [];
+        filterA.$and.push({ $or: filterA.$or }, { $or: filterA.$or });
+        delete filterB.$or;
+    }
+    if (assignToFilterA) {
+        Object.assign(filterA, filterB);
+        return filterA;
+    }
+    else
+        return Object.assign(Object.assign({}, filterA), filterB);
+}
+exports.mongoFilterMerger = mongoFilterMerger;
+function mongoPush(field, value, fields) {
+    if (!(0, isset_1.isset)(fields.$push))
+        fields.$push = {};
+    fields.$push[field] = value;
+}
+exports.mongoPush = mongoPush;
+//# sourceMappingURL=mongo-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-utils.js","sourceRoot":"","sources":["../../src/mongo-utils.ts"],"names":[],"mappings":";;;AAAA,0CAA0C;AAC1C,cAAc;AACd,0CAA0C;AAC1C,yDAA2C;AAC3C,mCAA+B;AAE/B,2CAA2C;AAC3C,SAAgB,KAAK,CAAC,MAAW,EAAE;IAC/B,IAAI,CAAC,GAAG;QAAE,OAAM,CAAC,YAAY;IAC7B,IAAI,GAAG,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;SACjC,IAAI,IAAA,yBAAM,EAAC,GAAG,EAAE,UAAU,CAAC;QAAE,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;AAC3D,CAAC;AAJD,sBAIC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,KAAK;IACvE,IAAI,IAAA,aAAK,EAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAA,aAAK,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QAC5C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAClC,OAAO,OAAO,CAAC,IAAI,CAAA;KACtB;IACD,IAAI,IAAA,aAAK,EAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAA,aAAK,EAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC1C,IAAI,CAAC,IAAA,aAAK,EAAC,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,GAAG,EAAE,CAAA;QAC3C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QAC7D,OAAO,OAAO,CAAC,GAAG,CAAA;KACrB;IACD,IAAI,eAAe,EAAE;QACjB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC/B,OAAO,OAAO,CAAA;KACjB;;QAAM,uCAAY,OAAO,GAAK,OAAO,EAAE;AAC5C,CAAC;AAdD,8CAcC;AAED,SAAgB,SAAS,CAAC,KAAa,EAAE,KAAU,EAAE,MAA4B;IAC7E,IAAI,CAAC,IAAA,aAAK,EAAC,MAAM,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,KAAK,GAAG,EAAE,CAAA;IAC3C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAA;AAC/B,CAAC;AAHD,8BAGC"}

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

@@ -0,0 +1,96 @@
+import { ObjectGeneric } from "./private/types";
+/**
+ *
+ * @param {Object} object main object
+ * @param {String[]} maskedOrSelectedFields array of fields
+ * @param {Boolean} isMask default: true; determine the behavior of the function. If is mask, selected fields will not appear in the resulting object. If it's a select, only selected fields will appear.
+ * @param {Boolean} deleteKeysInsteadOfReturningAnewObject default:false; modify the existing object instead of creating a new instance
+ */
+export declare function simpleObjectMaskOrSelect(object: ObjectGeneric, maskedOrSelectedFields: string[], isMask?: boolean, deleteKeysInsteadOfReturningAnewObject?: boolean): ObjectGeneric;
+/**
+ * check if **object OR array** has property Safely (avoid cannot read property x of null and such)
+ * @param {Object} obj object to test against
+ * @param {string} addr `a.b.c.0.1` will test if myObject has props a that has prop b. Work wit arrays as well (like `arr.0`)
+ */
+export declare function has(obj: ObjectGeneric, addr: string): boolean;
+/** Find address in an object "a.b.c" IN { a : { b : {c : 'blah' }}} RETURNS 'blah'
+ * @param obj
+ * @param addr accept syntax like "obj.subItem.[0].sub2" OR "obj.subItem.0.sub2" OR "obj.subItem[0].sub2"
+ * @returns the last item of the chain OR undefined if not found
+ */
+export declare function findByAddress(obj: ObjectGeneric, addr: string): any | undefined;
+/** Will return all objects matching that path. Eg: user.*.myVar */
+export declare function findByAddressAll(obj: any, addr: any, returnAddresses?: true): Array<[string, any]>;
+export declare function findByAddressAll(obj: any, addr: any, returnAddresses?: false): Array<any>;
+/** Enforce writing subItems. Eg: user.name.blah will ensure all are set until the writing of the last item
+ * NOTE: doesn't work with arrays
+ */
+export declare function objForceWrite(obj: ObjectGeneric, addr: string, item: any): void;
+/** Enforce writing subItems, only if obj.addr is empty.
+ * Eg: user.name.blah will ensure all are set until the writing of the last item
+ * if user.name.blah has a value it will not change it.
+ * NOTE: doesn't work with arrays
+ */
+export declare function objForceWriteIfNotSet(obj: ObjectGeneric, addr: string, item: any): void;
+/** Merge mixins into class. Use it in the constructor like: mergeMixins(this, {myMixin: true}) */
+export declare function mergeMixins(that: any, ...mixins: any[]): void;
+export declare function cloneObject(o: any): any;
+/** Deep clone. WILL REMOVE circular references */
+export declare function deepClone<T>(obj: T, cache?: any[]): T;
+/**
+ * @param {Object} obj the object on which we want to filter the keys
+ * @param {function} filterFunc function that returns true if the key match the wanted criteria
+ */
+export declare function filterKeys(obj: object, filter: any): any;
+/**
+ * @param {Object} obj the object on which we want to delete a property
+ * @param {Array} addr addressArray on which to delete the property
+ */
+export declare function deleteByAddress(obj: object, addr: string[]): void;
+/** Remove all key/values pair if value is undefined  */
+export declare function objFilterUndefined(o: any): any;
+/** Lock all 1st level props of an object to read only */
+export declare function readOnly(o: any): any;
+/** Fields of the object can be created BUT NOT reassignated */
+export declare function reassignForbidden(o: any): any;
+/** All fileds and subFields of the object will become readOnly */
+export declare function readOnlyForAll(object: any): any;
+export declare function objFilterUndefinedRecursive(obj: any): any;
+export declare function sortObjKeyAccordingToValue(unorderedObj: any, ascending?: boolean): {};
+/**
+ * Make default value if object key do not exist
+ * @param {object} obj
+ * @param {string} addr
+ * @param {any} defaultValue
+ * @param {function} callback (obj[addr]) => processValue. Eg: myObjAddr => myObjAddr.push('bikou')
+ * @return obj[addr] eventually processed by the callback
+ */
+export declare function ensureObjectProp(obj: object, addr: string, defaultValue: any, callback?: (o: any) => any): any;
+/** object and array merge
+ * @warn /!\ Array will be merged and duplicate values will be deleted /!\
+ * @return {Object} new object result from merge
+ * NOTE: objects in params will NOT be modified*/
+export declare function mergeDeep(...objects: any[]): any;
+/** object and array merge
+ * @warn /!\ Array will be replaced by the latest object /!\
+ * @return {Object} new object result from merge
+ * NOTE: objects in params will NOT be modified */
+export declare function mergeDeepOverrideArrays(...objects: any[]): any;
+/** object and array merge
+ * @param {Function} replacerForArrays item[key] = (prevValue, currentVal) => () When 2 values are arrays,
+ * @param {Function} replacerForObjects item[key] = (prevValue, currentVal) => () When 2 values are objects,
+ * @param {Function} replacerDefault item[key] = (prevValue, currentVal) => () For all other values
+ * @param  {...Object} objects
+ * @return {Object} new object result from merge
+ * NOTE: objects in params will NOT be modified
+ */
+export declare function mergeDeepConfigurable(replacerForArrays: (prev: any, curr: any) => any, replacerForObjects: any, replacerDefault?: (prev: any, curr: any) => any, ...objects: any[]): any;
+/** { a: {b:2}} => {'a.b':2} useful for translations
+ * NOTE: will remove circular references
+ */
+export declare function flattenObject(data: any, config?: {
+    withoutArraySyntax?: boolean;
+    withArraySyntaxMinified?: boolean;
+}): {};
+/** {'a.b':2} => { a: {b:2}} */
+export declare function unflattenObject(data: any): {};

package/dist/src/object-utils.js

@@ -0,0 +1,369 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unflattenObject = exports.flattenObject = exports.mergeDeepConfigurable = exports.mergeDeepOverrideArrays = exports.mergeDeep = exports.ensureObjectProp = exports.sortObjKeyAccordingToValue = exports.objFilterUndefinedRecursive = exports.readOnlyForAll = exports.reassignForbidden = exports.readOnly = exports.objFilterUndefined = exports.deleteByAddress = exports.filterKeys = exports.deepClone = exports.cloneObject = exports.mergeMixins = exports.objForceWriteIfNotSet = exports.objForceWrite = exports.findByAddressAll = exports.findByAddress = exports.has = exports.simpleObjectMaskOrSelect = void 0;
+const error_utils_1 = require("./error-utils");
+const loop_utils_1 = require("./loop-utils");
+const isset_1 = require("./isset");
+const is_object_1 = require("./is-object");
+const error_handler_1 = require("./private/error-handler");
+/**
+ *
+ * @param {Object} object main object
+ * @param {String[]} maskedOrSelectedFields array of fields
+ * @param {Boolean} isMask default: true; determine the behavior of the function. If is mask, selected fields will not appear in the resulting object. If it's a select, only selected fields will appear.
+ * @param {Boolean} deleteKeysInsteadOfReturningAnewObject default:false; modify the existing object instead of creating a new instance
+ */
+function simpleObjectMaskOrSelect(object, maskedOrSelectedFields, isMask = true, deleteKeysInsteadOfReturningAnewObject = false) {
+    const allKeys = Object.keys(object);
+    const keysToMask = allKeys.filter(keyName => {
+        if (isMask)
+            return maskedOrSelectedFields.includes(keyName);
+        else
+            return !maskedOrSelectedFields.includes(keyName);
+    });
+    if (deleteKeysInsteadOfReturningAnewObject) {
+        keysToMask.forEach(keyNameToDelete => delete object[keyNameToDelete]);
+        return object;
+    }
+    else {
+        return allKeys.reduce((newObject, key) => {
+            if (!keysToMask.includes(key))
+                newObject[key] = object[key];
+            return newObject;
+        }, {});
+    }
+}
+exports.simpleObjectMaskOrSelect = simpleObjectMaskOrSelect;
+/**
+ * check if **object OR array** has property Safely (avoid cannot read property x of null and such)
+ * @param {Object} obj object to test against
+ * @param {string} addr `a.b.c.0.1` will test if myObject has props a that has prop b. Work wit arrays as well (like `arr.0`)
+ */
+function has(obj, addr) {
+    if (!(0, isset_1.isset)(obj) || typeof obj !== 'object')
+        return;
+    let propsArr = addr.replace(/\.?\[(\d+)\]/g, '.$1').split('.'); // replace a[3] => a.3;
+    let objChain = obj;
+    return propsArr.every(prop => {
+        objChain = objChain[prop];
+        return (0, isset_1.isset)(objChain);
+    });
+}
+exports.has = has;
+/** Find address in an object "a.b.c" IN { a : { b : {c : 'blah' }}} RETURNS 'blah'
+ * @param obj
+ * @param addr accept syntax like "obj.subItem.[0].sub2" OR "obj.subItem.0.sub2" OR "obj.subItem[0].sub2"
+ * @returns the last item of the chain OR undefined if not found
+ */
+function findByAddress(obj, addr) {
+    if (addr === '')
+        return obj;
+    if (!(0, isset_1.isset)(obj) || typeof obj !== 'object')
+        return console.warn('Main object in `findByAddress` function is undefined or has the wrong type');
+    const propsArr = addr.replace(/\.?\[(\d+)\]/g, '.$1').split('.'); // replace .[4] AND [4] TO .4
+    const objRef = propsArr.reduce((objChain, prop) => {
+        if (!(0, isset_1.isset)(objChain) || typeof objChain !== 'object' || !(0, isset_1.isset)(objChain[prop]))
+            return;
+        else
+            return objChain[prop];
+    }, obj);
+    return objRef;
+}
+exports.findByAddress = findByAddress;
+function findByAddressAll(obj, addr, returnAddresses = false) {
+    (0, error_utils_1.err500IfNotSet)({ obj, addr });
+    if (addr === '')
+        return obj;
+    const addrRegexp = new RegExp('^' + addr
+        .replace(/\.?\[(\d+)\]/g, '.$1') // replace .[4] AND [4] TO .4
+        .replace(/\./g, '\\.')
+        .replace(/\.\*/g, '.[^.]+') // replace * by [^. (all but a point)]
+        + '$');
+    const matchingItems = [];
+    (0, loop_utils_1.recursiveGenericFunctionSync)(obj, (item, address) => {
+        if (addrRegexp.test(address))
+            matchingItems.push(returnAddresses ? [address, item] : item);
+    });
+    return matchingItems;
+}
+exports.findByAddressAll = findByAddressAll;
+/** Enforce writing subItems. Eg: user.name.blah will ensure all are set until the writing of the last item
+ * NOTE: doesn't work with arrays
+ */
+function objForceWrite(obj, addr, item) {
+    const chunks = addr.replace(/\.?\[(\d+)\]/g, '.[$1').split('.');
+    let lastItem = obj;
+    chunks.forEach((chunkRaw, i) => {
+        const chunk = chunkRaw.replace(/^\[/, '');
+        if (i === chunks.length - 1)
+            lastItem[chunk] = item;
+        else if (!(0, isset_1.isset)(lastItem[chunk])) {
+            const nextChunk = chunks[i + 1];
+            if ((0, isset_1.isset)(nextChunk) && nextChunk.startsWith('['))
+                lastItem[chunk] = [];
+            else
+                lastItem[chunk] = {};
+        }
+        else if (typeof lastItem[chunk] !== 'object')
+            throw new error_handler_1.dataValidationUtilErrorHandler(`itemNotTypeObjectOrArrayInAddrChainForObjForceWrite`, 500, { origin: 'Validator', chunks, actualValueOfItem: lastItem[chunk], actualChunk: chunk });
+        lastItem = lastItem[chunk];
+    });
+}
+exports.objForceWrite = objForceWrite;
+/** Enforce writing subItems, only if obj.addr is empty.
+ * Eg: user.name.blah will ensure all are set until the writing of the last item
+ * if user.name.blah has a value it will not change it.
+ * NOTE: doesn't work with arrays
+ */
+function objForceWriteIfNotSet(obj, addr, item) {
+    if (!(0, isset_1.isset)(findByAddress(obj, addr)))
+        return objForceWrite(obj, addr, item);
+}
+exports.objForceWriteIfNotSet = objForceWriteIfNotSet;
+/** Merge mixins into class. Use it in the constructor like: mergeMixins(this, {myMixin: true}) */
+function mergeMixins(that, ...mixins) {
+    mixins.forEach(mixin => {
+        for (const method in mixin) {
+            that[method] = mixin[method];
+        }
+    });
+}
+exports.mergeMixins = mergeMixins;
+function cloneObject(o) {
+    return JSON.parse(JSON.stringify(o));
+}
+exports.cloneObject = cloneObject;
+/** Deep clone. WILL REMOVE circular references */
+function deepClone(obj, cache = []) {
+    let copy;
+    // usefull to not modify 1st level objet by lower levels
+    // this is required for the same object to be referenced not in a redundant way
+    const newCache = [...cache];
+    if (obj instanceof Date)
+        return new Date(obj);
+    // Handle Array
+    if (Array.isArray(obj)) {
+        if (newCache.includes(obj))
+            return [];
+        newCache.push(obj);
+        copy = [];
+        for (var i = 0, len = obj.length; i < len; i++) {
+            copy[i] = deepClone(obj[i], newCache);
+        }
+        return copy;
+    }
+    if (typeof obj === 'object' && obj !== null && Object.getPrototypeOf(obj) === Object.prototype) {
+        if (newCache.includes(obj))
+            return {};
+        newCache.push(obj);
+        copy = {};
+        for (var key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                copy[key] = deepClone(obj[key], newCache);
+            }
+        }
+        return copy;
+    }
+    return obj; // number, string...
+}
+exports.deepClone = deepClone;
+/**
+ * @param {Object} obj the object on which we want to filter the keys
+ * @param {function} filterFunc function that returns true if the key match the wanted criteria
+ */
+function filterKeys(obj, filter) {
+    const clone = cloneObject(obj);
+    (0, loop_utils_1.recursiveGenericFunctionSync)(obj, (item, addr, lastElementKey) => {
+        if (!filter(lastElementKey))
+            deleteByAddress(clone, addr.split('.'));
+    });
+    return clone;
+}
+exports.filterKeys = filterKeys;
+/**
+ * @param {Object} obj the object on which we want to delete a property
+ * @param {Array} addr addressArray on which to delete the property
+ */
+function deleteByAddress(obj, addr) {
+    let current = obj;
+    for (let i = 0; i < addr.length - 2; i++)
+        current = current[addr[i]];
+    delete current[addr[addr.length - 1]];
+}
+exports.deleteByAddress = deleteByAddress;
+/** Remove all key/values pair if value is undefined  */
+function objFilterUndefined(o) {
+    Object.keys(o).forEach(k => !(0, isset_1.isset)(o[k]) && delete o[k]);
+    return o;
+}
+exports.objFilterUndefined = objFilterUndefined;
+/** Lock all 1st level props of an object to read only */
+function readOnly(o) {
+    const throwErr = () => { throw new error_handler_1.dataValidationUtilErrorHandler('Cannot modify object that is read only', 500); };
+    return new Proxy(o, {
+        set: throwErr,
+        defineProperty: throwErr,
+        deleteProperty: throwErr,
+    });
+}
+exports.readOnly = readOnly;
+/** Fields of the object can be created BUT NOT reassignated */
+function reassignForbidden(o) {
+    return new Proxy(o, {
+        defineProperty: function (that, key, value) {
+            if (key in that)
+                throw new error_handler_1.dataValidationUtilErrorHandler(`Cannot reassign the property ${key.toString()} of this object`, 500);
+            else {
+                that[key] = value;
+                return true;
+            }
+        },
+        deleteProperty: function (_, key) {
+            throw new error_handler_1.dataValidationUtilErrorHandler(`Cannot delete the property ${key.toString()} of this object`, 500);
+        }
+    });
+}
+exports.reassignForbidden = reassignForbidden;
+/** All fileds and subFields of the object will become readOnly */
+function readOnlyForAll(object) {
+    (0, loop_utils_1.recursiveGenericFunctionSync)(object, (item, _, lastElementKey, parent) => {
+        if (typeof item === 'object')
+            parent[lastElementKey] = readOnly(item);
+    });
+    return object;
+}
+exports.readOnlyForAll = readOnlyForAll;
+function objFilterUndefinedRecursive(obj) {
+    if (obj) {
+        const flattenedObj = flattenObject(obj);
+        Object.keys(flattenedObj).forEach(key => {
+            if (!(0, isset_1.isset)(flattenedObj[key])) {
+                delete flattenedObj[key];
+            }
+        });
+        return unflattenObject(flattenedObj);
+    }
+    else
+        return obj;
+}
+exports.objFilterUndefinedRecursive = objFilterUndefinedRecursive;
+function sortObjKeyAccordingToValue(unorderedObj, ascending = true) {
+    const orderedObj = {};
+    const sortingConst = ascending ? 1 : -1;
+    Object.keys(unorderedObj)
+        .sort((keyA, keyB) => unorderedObj[keyA] < unorderedObj[keyB] ? sortingConst : -sortingConst)
+        .forEach(key => { orderedObj[key] = unorderedObj[key]; });
+    return orderedObj;
+}
+exports.sortObjKeyAccordingToValue = sortObjKeyAccordingToValue;
+/**
+ * Make default value if object key do not exist
+ * @param {object} obj
+ * @param {string} addr
+ * @param {any} defaultValue
+ * @param {function} callback (obj[addr]) => processValue. Eg: myObjAddr => myObjAddr.push('bikou')
+ * @return obj[addr] eventually processed by the callback
+ */
+function ensureObjectProp(obj, addr, defaultValue, callback = o => o) {
+    (0, error_utils_1.err500IfNotSet)({ obj, addr, defaultValue, callback });
+    if (!(0, isset_1.isset)(obj[addr]))
+        obj[addr] = defaultValue;
+    callback(obj[addr]);
+    return obj[addr];
+}
+exports.ensureObjectProp = ensureObjectProp;
+/** object and array merge
+ * @warn /!\ Array will be merged and duplicate values will be deleted /!\
+ * @return {Object} new object result from merge
+ * NOTE: objects in params will NOT be modified*/
+function mergeDeep(...objects) {
+    return mergeDeepConfigurable((previousVal, currentVal) => [...previousVal, ...currentVal].filter((elm, i, arr) => arr.indexOf(elm) === i), (previousVal, currentVal) => mergeDeep(previousVal, currentVal), undefined, ...objects);
+}
+exports.mergeDeep = mergeDeep;
+/** object and array merge
+ * @warn /!\ Array will be replaced by the latest object /!\
+ * @return {Object} new object result from merge
+ * NOTE: objects in params will NOT be modified */
+function mergeDeepOverrideArrays(...objects) {
+    return mergeDeepConfigurable(undefined, (previousVal, currentVal) => mergeDeepOverrideArrays(previousVal, currentVal), undefined, ...objects);
+}
+exports.mergeDeepOverrideArrays = mergeDeepOverrideArrays;
+/** object and array merge
+ * @param {Function} replacerForArrays item[key] = (prevValue, currentVal) => () When 2 values are arrays,
+ * @param {Function} replacerForObjects item[key] = (prevValue, currentVal) => () When 2 values are objects,
+ * @param {Function} replacerDefault item[key] = (prevValue, currentVal) => () For all other values
+ * @param  {...Object} objects
+ * @return {Object} new object result from merge
+ * NOTE: objects in params will NOT be modified
+ */
+function mergeDeepConfigurable(replacerForArrays = (prev, curr) => curr, replacerForObjects, replacerDefault = (prev, curr) => curr, ...objects) {
+    return objects.reduce((actuallyMerged, obj) => {
+        Object.keys(obj).forEach(key => {
+            const previousVal = actuallyMerged[key];
+            const currentVal = obj[key];
+            if (Array.isArray(previousVal) && Array.isArray(currentVal)) {
+                actuallyMerged[key] = replacerForArrays(previousVal, currentVal);
+            }
+            else if ((0, is_object_1.isObject)(previousVal) && (0, is_object_1.isObject)(currentVal)) {
+                actuallyMerged[key] = replacerForObjects(previousVal, currentVal);
+            }
+            else {
+                actuallyMerged[key] = replacerDefault(previousVal, currentVal);
+            }
+        });
+        return actuallyMerged;
+    }, {});
+}
+exports.mergeDeepConfigurable = mergeDeepConfigurable;
+/** { a: {b:2}} => {'a.b':2} useful for translations
+ * NOTE: will remove circular references
+ */
+function flattenObject(data, config = {}) {
+    const { withoutArraySyntax = false, withArraySyntaxMinified = false } = config;
+    const result = {};
+    const seenObjects = []; // avoidCircular reference to infinite loop
+    const recurse = (cur, prop) => {
+        if (Array.isArray(cur)) {
+            let l = cur.length;
+            let i = 0;
+            if (withoutArraySyntax)
+                recurse(cur[0], prop);
+            else {
+                for (; i < l; i++)
+                    recurse(cur[i], prop + (withArraySyntaxMinified ? `.${i}` : `[${i}]`));
+                if (l == 0)
+                    result[prop] = [];
+            }
+        }
+        else if ((0, is_object_1.isObject)(cur)) { // is object
+            try {
+                if (seenObjects.includes(cur))
+                    cur = deepClone(cur); // avoid circular ref but allow duplicate objects
+                else
+                    seenObjects.push(cur);
+                const isEmpty = Object.keys(cur).length === 0;
+                for (const p in cur)
+                    recurse(cur[p], (prop ? prop + '.' : '') + p.replace(/\./g, '%')); // allow prop to contain special chars like points);
+                if (isEmpty && prop)
+                    result[prop] = {};
+            }
+            catch (error) {
+                console.warn('Circular reference in flattenObject, impossible to parse');
+            }
+        }
+        else
+            result[prop] = cur;
+    };
+    recurse(data, '');
+    return result;
+}
+exports.flattenObject = flattenObject;
+/** {'a.b':2} => { a: {b:2}} */
+function unflattenObject(data) {
+    const newO = {};
+    for (const [addr, value] of Object.entries(data))
+        objForceWrite(newO, addr, value);
+    return newO;
+}
+exports.unflattenObject = unflattenObject;
+//# sourceMappingURL=object-utils.js.map

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

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

package/dist/src/private/config.d.ts

@@ -0,0 +1,44 @@
+import { Color } from './types';
+export declare type Config = {
+    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(): Config;
+/** 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;