topkat-utils 1.0.60 → 1.1.2

package/dist/src/private/config.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerConfig = exports.configFn = void 0;
+const isset_1 = require("../isset");
+let 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 = {};
+    const newconfig = Object.assign(Object.assign({}, config), customConfig);
+    newconfig.terminal = Object.assign(Object.assign({}, config.terminal), customConfig.terminal);
+    newconfig.terminal.theme = Object.assign(Object.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/private/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/private/config.ts"],"names":[],"mappings":";;;AACA,oCAAgC;AAwBhC,IAAI,MAAM,GAAW;IACjB,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,MAAM,SAAS,mCACR,MAAM,GACN,YAAY,CAClB,CAAA;IACD,SAAS,CAAC,QAAQ,mCACX,MAAM,CAAC,QAAQ,GACf,YAAY,CAAC,QAAQ,CAC3B,CAAA;IACD,SAAS,CAAC,QAAQ,CAAC,KAAK,mCACjB,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/private/error-handler.d.ts

@@ -0,0 +1,10 @@
+export declare class dataValidationUtilErrorHandler extends Error {
+    fromDataValidation: boolean;
+    code: number;
+    extraInfos: object;
+    msg: string;
+    errorDescription: {
+        [k: string]: any;
+    };
+    constructor(msg: any, code: any, extraInfos?: any);
+}

package/dist/src/private/error-handler.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataValidationUtilErrorHandler = void 0;
+class dataValidationUtilErrorHandler extends Error {
+    constructor(msg, code, extraInfos) {
+        super(msg);
+        this.message = msg;
+        this.msg = msg;
+        this.name = `${code} ${msg}`;
+        this.fromDataValidation = true; // will be catched by express error handler
+        this.code = code;
+        this.extraInfos = extraInfos;
+        this.errorDescription = Object.assign({ msg,
+            code }, extraInfos);
+    }
+}
+exports.dataValidationUtilErrorHandler = dataValidationUtilErrorHandler;
+//# sourceMappingURL=error-handler.js.map

package/dist/src/private/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../../src/private/error-handler.ts"],"names":[],"mappings":";;;AAAA,MAAa,8BAA+B,SAAQ,KAAK;IAMrD,YAAY,GAAG,EAAE,IAAI,EAAE,UAAW;QAC9B,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,OAAO,GAAG,GAAG,CAAA;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE,CAAA;QAC5B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAA,CAAC,2CAA2C;QAC1E,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,gBAAgB,mBACjB,GAAG;YACH,IAAI,IACD,UAAU,CAChB,CAAA;IACL,CAAC;CACJ;AApBD,wEAoBC"}

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

@@ -0,0 +1,4 @@
+export declare type ObjectGeneric = {
+    [k: string]: any;
+};
+export declare type Color = [number, number, number];

package/dist/src/private/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/private/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/private/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,12 @@
+export declare function escapeRegexp(str: string, config?: {
+    parseStarChar?: boolean;
+}): string;
+/** Get first match of the first capturing group of regexp
+ * Eg: const basePath = firstMatch(apiFile, /basePath = '(.*?)'/); will get what is inside quotes
+ */
+export declare function firstMatch(str: string, regExp: RegExp): string | undefined;
+/** Get all matches from regexp with g flag
+ * Eg: [ [full, match1, m2], [f, m1, m2]... ]
+ * NOTE: the G flag will be appended to regexp
+ */
+export declare function allMatches(str: string, reg: RegExp): string[];

package/dist/src/regexp-utils.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allMatches = exports.firstMatch = exports.escapeRegexp = void 0;
+//----------------------------------------
+// REGEXP UTILS
+//----------------------------------------
+const logger_utils_1 = require("./logger-utils");
+function escapeRegexp(str, config = {}) {
+    const { parseStarChar = false } = config;
+    if (parseStarChar)
+        return str.replace(/[-[\]{}()+?.,\\^$|#\s]/g, '\\$&').replace(/\*/g, '.*');
+    else
+        return str.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&');
+}
+exports.escapeRegexp = escapeRegexp;
+/** Get first match of the first capturing group of regexp
+ * Eg: const basePath = firstMatch(apiFile, /basePath = '(.*?)'/); will get what is inside quotes
+ */
+function firstMatch(str, regExp) { return (str.match(regExp) || [])[1]; }
+exports.firstMatch = firstMatch;
+/** Get all matches from regexp with g flag
+ * Eg: [ [full, match1, m2], [f, m1, m2]... ]
+ * NOTE: the G flag will be appended to regexp
+ */
+function allMatches(str, reg) {
+    let i = 0;
+    let matches;
+    const arr = [];
+    if (typeof str !== 'string')
+        logger_utils_1.C.error('Not a string provided as first argument for allMatches()');
+    else {
+        reg = new RegExp(reg, 'g');
+        while ((matches = reg.exec(str))) {
+            arr.push(matches);
+            if (i++ > 99) {
+                logger_utils_1.C.error('error', 'Please provide the G flag in regexp for allMatches');
+                break;
+            }
+        }
+    }
+    return arr;
+}
+exports.allMatches = allMatches;
+//# sourceMappingURL=regexp-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"regexp-utils.js","sourceRoot":"","sources":["../../src/regexp-utils.ts"],"names":[],"mappings":";;;AAAA,0CAA0C;AAC1C,eAAe;AACf,0CAA0C;AAC1C,iDAAkC;AAElC,SAAgB,YAAY,CAAC,GAAW,EAAE,SAAsC,EAAE;IAC9E,MAAM,EAAE,aAAa,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;IACxC,IAAI,aAAa;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;;QACxF,OAAO,GAAG,CAAC,OAAO,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAA;AAC/D,CAAC;AAJD,oCAIC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,GAAW,EAAE,MAAc,IAAwB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA,CAAC,CAAC;AAAnH,gCAAmH;AAEnH;;;GAGG;AACH,SAAgB,UAAU,CAAC,GAAW,EAAE,GAAW;IAC/C,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,IAAI,OAAO,CAAA;IACX,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,gBAAC,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAA;SAC3F;QACD,GAAG,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAC1B,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE;YAC9B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACjB,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE;gBACV,gBAAC,CAAC,KAAK,CAAC,OAAO,EAAE,oDAAoD,CAAC,CAAA;gBACtE,MAAK;aACR;SACJ;KACJ;IACD,OAAO,GAAG,CAAA;AACd,CAAC;AAhBD,gCAgBC"}

package/dist/src/remove-circular-json-stringify.d.ts

@@ -0,0 +1 @@
+export declare function removeCircularJSONstringify(object: any, indent?: number): string;

package/dist/src/remove-circular-json-stringify.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeCircularJSONstringify = void 0;
+function removeCircularJSONstringify(object, indent = 2) {
+    const getCircularReplacer = () => {
+        const seen = new WeakSet();
+        return (key, value) => {
+            if (typeof value === 'object' && value !== null) {
+                if (seen.has(value)) {
+                    return;
+                }
+                seen.add(value);
+            }
+            return value;
+        };
+    };
+    return JSON.stringify(object, getCircularReplacer(), indent);
+}
+exports.removeCircularJSONstringify = removeCircularJSONstringify;
+//# sourceMappingURL=remove-circular-json-stringify.js.map

package/dist/src/remove-circular-json-stringify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-circular-json-stringify.js","sourceRoot":"","sources":["../../src/remove-circular-json-stringify.ts"],"names":[],"mappings":";;;AACA,SAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC;IAC1D,MAAM,mBAAmB,GAAG,GAAG,EAAE;QAC7B,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAA;QAC1B,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YAClB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE;gBAC7C,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;oBACjB,OAAM;iBACT;gBACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;aAClB;YACD,OAAO,KAAK,CAAA;QAChB,CAAC,CAAA;IACL,CAAC,CAAA;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,mBAAmB,EAAE,EAAE,MAAM,CAAC,CAAA;AAChE,CAAC;AAfD,kEAeC"}

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

@@ -0,0 +1,77 @@
+import { ObjectGeneric } from "./private/types";
+/**Eg: camelCase */
+export declare function camelCase(...wordBits: any[]): string;
+/**Eg: snake_case
+ * trimmed but not lowerCased
+ */
+export declare function snakeCase(...wordBits: any[]): string;
+/**Eg: kebab-case
+ * trimmed AND lowerCased
+ * undefined, null... => ''
+ */
+export declare function kebabCase(...wordBits: any[]): string;
+/**Eg: PascalCase undefined, null... => '' */
+export declare function pascalCase(...wordBits: any[]): string;
+/**Eg: Titlecase undefined, null... => '' */
+export declare function titleCase(...wordBits: any[]): string;
+/**Eg: UPPERCASE undefined, null... => '' */
+export declare function upperCase(...wordBits: any[]): string;
+/**Eg: lowercase undefined, null... => '' */
+export declare function lowerCase(...wordBits: any[]): string;
+export declare function capitalize1st(str?: string): string;
+export declare function camelCaseToWords(str: any): any;
+/** GIVEN A STRING '{ blah;2}, ['nested,(what,ever)']' AND A SEPARATOR ",""
+ *  This will return the content separated by first level of separators
+ *  @return ["{ blah;2}", "['nested,(what,ever)']"]
+ */
+export declare function getValuesBetweenSeparator(str: string, separator: string, removeTrailingSpaces?: boolean): any;
+/** GIVEN A STRING "a: [ 'str', /[^]]/, '[aa]]]str', () => [ nestedArray ] ], b: ['arr']"
+ * @return matching: [ "'str', /[^]]/, '[aa]]]str', () => [ nestedArray ]", "'arr'" ], between: [ "a:", ", b: " ]
+ * @param str base string
+ * @param openingOrSeparator opening character OR separator if closing not set
+ * @param closing
+ * @param ignoreBetweenOpen default ['\'', '`', '"', '/'], when reaching an opening char, it will ignore all until it find the corresponding closing char
+ * @param ignoreBetweenClose default ['\'', '`', '"', '/'] list of corresponding closing chars
+ */
+export declare function getValuesBetweenStrings(str: string, openingOrSeparator: any, closing: any, ignoreBetweenOpen?: string[], ignoreBetweenClose?: string[], removeTrailingSpaces?: boolean): {
+    inner: any;
+    outer: any;
+};
+/** Remove accentued character from string and eventually special chars and numbers
+ * @param {String} str input string
+ * @param {Object} config { removeSpecialChars: false, removeNumbers: false, removeSpaces: false }
+ * @returns String with all accentued char replaced by their non accentued version + config formattting
+ */
+export declare function convertAccentedCharacters(str: any, config?: {
+    removeNumbers?: boolean;
+    removeSpecialChars?: boolean;
+    removeSpaces?: boolean;
+}): any;
+/** minLength 8 if unique
+* @param {Number} length default: 20
+* @param {Boolean} unique default: true. Generate a real unique token base on the date. min length will be min 8 in this case
+* @param {string} mode one of ['alphanumeric', 'hexadecimal']
+* NOTE: to generate a mongoDB Random Id, use the params: 24, true, 'hexadecimal'
+*/
+export declare function generateToken(length?: number, unique?: boolean, mode?: 'alphanumeric' | 'hexadecimal'): any;
+export declare function generateObjectId(): any;
+/** Useful to join differents bits of url with normalizing slashes
+ * * urlPathJoin('https://', 'www.kikou.lol/', '/user', '//2//') => https://www.kikou.lol/user/2/
+ * * urlPathJoin('http:/', 'kikou.lol') => https://www.kikou.lol
+ */
+export declare function urlPathJoin(...bits: string[]): string;
+export declare type MiniTemplaterOptions = {
+    valueWhenNotSet?: string;
+    regexp?: RegExp;
+    valueWhenContentUndefined?: string;
+};
+/** Replace variables in a string like: `Hello {{userName}}!`
+ * @param {String} content
+ * @param {Object} varz object with key => value === toReplace => replacer
+ * @param {Object} options
+ * * valueWhenNotSet => replacer for undefined values. Default: ''
+ * * regexp          => must be 'g' and first capturing group matching the value to replace. Default: /{{\s*([^}]*)\s*}}/g
+ */
+export declare function miniTemplater(content: string, varz: ObjectGeneric, options?: MiniTemplaterOptions): string;
+/** Clean output for outside world. All undefined / null / NaN / Infinity values are changed to '-' */
+export declare function cln(val: any, replacerInCaseItIsUndefinNaN?: string): any;

package/dist/src/string-utils.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cln = exports.miniTemplater = exports.urlPathJoin = exports.generateObjectId = exports.generateToken = exports.convertAccentedCharacters = exports.getValuesBetweenStrings = exports.getValuesBetweenSeparator = exports.camelCaseToWords = exports.capitalize1st = exports.lowerCase = exports.upperCase = exports.titleCase = exports.pascalCase = exports.kebabCase = exports.snakeCase = exports.camelCase = void 0;
+//----------------------------------------
+// STRING UTILS
+//----------------------------------------
+const error_utils_1 = require("./error-utils");
+const isset_1 = require("./isset");
+/**Eg: camelCase */
+function camelCase(...wordBits) {
+    return wordBits.filter(e => e).map((w, i) => i === 0 ? w : capitalize1st(w)).join('');
+}
+exports.camelCase = camelCase;
+/**Eg: snake_case
+ * trimmed but not lowerCased
+ */
+function snakeCase(...wordBits) {
+    return wordBits.filter(e => e).map(w => w.trim()).join('_');
+}
+exports.snakeCase = snakeCase;
+/**Eg: kebab-case
+ * trimmed AND lowerCased
+ * undefined, null... => ''
+ */
+function kebabCase(...wordBits) {
+    return wordBits.filter(e => e).map(w => w.trim().toLowerCase()).join('-');
+}
+exports.kebabCase = kebabCase;
+/**Eg: PascalCase undefined, null... => '' */
+function pascalCase(...wordBits) {
+    return wordBits.filter(e => e).map((w, i) => capitalize1st(w)).join('');
+}
+exports.pascalCase = pascalCase;
+/**Eg: Titlecase undefined, null... => '' */
+function titleCase(...wordBits) {
+    return capitalize1st(wordBits.filter(e => e).map(w => w.trim()).join(''));
+}
+exports.titleCase = titleCase;
+/**Eg: UPPERCASE undefined, null... => '' */
+function upperCase(...wordBits) {
+    return wordBits.filter(e => e).map(w => w.trim().toUpperCase()).join('');
+}
+exports.upperCase = upperCase;
+/**Eg: lowercase undefined, null... => '' */
+function lowerCase(...wordBits) {
+    return wordBits.filter(e => e).map(w => w.trim().toLowerCase()).join('');
+}
+exports.lowerCase = lowerCase;
+function capitalize1st(str = '') { return str[0].toUpperCase() + str.slice(1); }
+exports.capitalize1st = capitalize1st;
+function camelCaseToWords(str) {
+    return str ? str.trim().replace(/([A-Z])/g, '-$1').toLowerCase().split('-') : [];
+}
+exports.camelCaseToWords = camelCaseToWords;
+/** GIVEN A STRING '{ blah;2}, ['nested,(what,ever)']' AND A SEPARATOR ",""
+ *  This will return the content separated by first level of separators
+ *  @return ["{ blah;2}", "['nested,(what,ever)']"]
+ */
+function getValuesBetweenSeparator(str, separator, removeTrailingSpaces = true) {
+    (0, error_utils_1.err500IfEmptyOrNotSet)({ separator, str });
+    const { outer } = getValuesBetweenStrings(str, separator, undefined, undefined, undefined, removeTrailingSpaces);
+    return outer;
+}
+exports.getValuesBetweenSeparator = getValuesBetweenSeparator;
+/** GIVEN A STRING "a: [ 'str', /[^]]/, '[aa]]]str', () => [ nestedArray ] ], b: ['arr']"
+ * @return matching: [ "'str', /[^]]/, '[aa]]]str', () => [ nestedArray ]", "'arr'" ], between: [ "a:", ", b: " ]
+ * @param str base string
+ * @param openingOrSeparator opening character OR separator if closing not set
+ * @param closing
+ * @param ignoreBetweenOpen default ['\'', '`', '"', '/'], when reaching an opening char, it will ignore all until it find the corresponding closing char
+ * @param ignoreBetweenClose default ['\'', '`', '"', '/'] list of corresponding closing chars
+ */
+function getValuesBetweenStrings(str, openingOrSeparator, closing, ignoreBetweenOpen = ['\'', '`', '"', '/'], ignoreBetweenClose = ['\'', '`', '"', '/'], removeTrailingSpaces = true) {
+    (0, error_utils_1.err500IfEmptyOrNotSet)({ openingOrSeparator, str });
+    str = str.replace(/<</g, '§§"').replace(/>>/g, '"§§');
+    const arrayValues = [];
+    const betweenArray = [];
+    let level = 0;
+    let ignoreUntil = false;
+    let actualValue = '';
+    let precedingChar = '';
+    let separatorMode = false;
+    if (!closing)
+        separatorMode = true;
+    const separator = separatorMode ? openingOrSeparator : false;
+    const openingChars = separatorMode ? ['(', '{', '['] : [openingOrSeparator];
+    const closingChars = separatorMode ? [')', '}', ']'] : [closing];
+    const pushActualValue = () => {
+        if (level === 0)
+            betweenArray.push(removeTrailingSpaces ? actualValue.replace(/(?:^\s+|\s+$)/g, '') : actualValue);
+        else
+            arrayValues.push(removeTrailingSpaces ? actualValue.replace(/(?:^\s+|\s+$)/g, '') : actualValue);
+        actualValue = '';
+    };
+    str.split('').forEach(char => {
+        // handle unwanted nested structure like characters in a strings that may be a unmatched closing / opening character
+        // Eg: {'azer}aze'}
+        if (ignoreUntil && char === ignoreUntil && precedingChar !== '\\')
+            ignoreUntil = false;
+        else if (ignoreUntil && char !== ignoreUntil)
+            true;
+        else if (ignoreBetweenOpen.includes(char)) {
+            const indexChar = ignoreBetweenOpen.findIndex(char2 => char2 === char);
+            ignoreUntil = ignoreBetweenClose[indexChar];
+        }
+        else if (openingChars.includes(char)) {
+            // handle nested structures
+            if (!separatorMode && level === 0)
+                pushActualValue();
+            level++;
+            if (!separatorMode)
+                return;
+        }
+        else if (closingChars.includes(char)) {
+            // handle nested structures
+            if (!separatorMode && level === 1)
+                pushActualValue();
+            level--;
+        }
+        else if (separatorMode && level === 0 && char === separator) {
+            // SEPARATOR MODE
+            pushActualValue();
+            return;
+        }
+        actualValue += char;
+        precedingChar = char;
+    });
+    pushActualValue();
+    const replaceValz = arr => arr.map(v => v.replace(/§§"/g, '<<').replace(/"§§/g, '>>')).filter(v => v);
+    return { inner: replaceValz(arrayValues), outer: replaceValz(betweenArray) };
+}
+exports.getValuesBetweenStrings = getValuesBetweenStrings;
+/** Remove accentued character from string and eventually special chars and numbers
+ * @param {String} str input string
+ * @param {Object} config { removeSpecialChars: false, removeNumbers: false, removeSpaces: false }
+ * @returns String with all accentued char replaced by their non accentued version + config formattting
+ */
+function convertAccentedCharacters(str, config = {}) {
+    let output = str
+        .replace(/[àáâãäå]/g, 'a')
+        .replace(/ç/g, 'c')
+        .replace(/[èéêë]/g, 'e')
+        .replace(/[ìíîï]/g, 'i')
+        .replace(/[ôö]/g, 'o')
+        .replace(/[ùúû]/g, 'u')
+        .replace(/(^\s*|\s*$)/g, '');
+    if (config.removeNumbers === true)
+        output = output.replace(/\d+/g, '');
+    if (config.removeSpecialChars === true)
+        output = output.replace(/[^A-Za-z0-9 ]/g, '');
+    if (config.removeSpaces === true)
+        output = output.replace(/\s+/g, '');
+    return output;
+}
+exports.convertAccentedCharacters = convertAccentedCharacters;
+let generatedTokens = []; // cache to avoid collision
+let lastTs = new Date().getTime();
+/** minLength 8 if unique
+* @param {Number} length default: 20
+* @param {Boolean} unique default: true. Generate a real unique token base on the date. min length will be min 8 in this case
+* @param {string} mode one of ['alphanumeric', 'hexadecimal']
+* NOTE: to generate a mongoDB Random Id, use the params: 24, true, 'hexadecimal'
+*/
+function generateToken(length = 20, unique = true, mode = 'alphanumeric') {
+    let charConvNumeric = mode === 'alphanumeric' ? 36 : 16;
+    if (unique && length < 8)
+        length = 8;
+    let token;
+    let tokenTs;
+    do {
+        tokenTs = (new Date()).getTime();
+        token = unique ? tokenTs.toString(charConvNumeric) : '';
+        while (token.length < length)
+            token += Math.random().toString(charConvNumeric).substr(2, 1); // char alphaNumeric aléatoire
+    } while (generatedTokens.includes(token));
+    if (lastTs < tokenTs)
+        generatedTokens = []; // reset generated token on new timestamp because cannot collide
+    generatedTokens.push(token);
+    return token;
+}
+exports.generateToken = generateToken;
+function generateObjectId() {
+    return generateToken(24, true, 'hexadecimal');
+}
+exports.generateObjectId = generateObjectId;
+/** Useful to join differents bits of url with normalizing slashes
+ * * urlPathJoin('https://', 'www.kikou.lol/', '/user', '//2//') => https://www.kikou.lol/user/2/
+ * * urlPathJoin('http:/', 'kikou.lol') => https://www.kikou.lol
+ */
+function urlPathJoin(...bits) {
+    return bits.join('/').replace(/\/+/g, '/').replace(/(https?:)\/\/?/, '$1//');
+}
+exports.urlPathJoin = urlPathJoin;
+/** Replace variables in a string like: `Hello {{userName}}!`
+ * @param {String} content
+ * @param {Object} varz object with key => value === toReplace => replacer
+ * @param {Object} options
+ * * valueWhenNotSet => replacer for undefined values. Default: ''
+ * * regexp          => must be 'g' and first capturing group matching the value to replace. Default: /{{\s*([^}]*)\s*}}/g
+ */
+function miniTemplater(content, varz, options = {}) {
+    options = Object.assign({ valueWhenNotSet: '', regexp: /{{\s*([^}]*)\s*}}/g, valueWhenContentUndefined: '' }, options);
+    return (0, isset_1.isset)(content) ? content.replace(options.regexp, (m, $1) => (0, isset_1.isset)(varz[$1]) ? varz[$1] : options.valueWhenNotSet) : options.valueWhenContentUndefined;
+}
+exports.miniTemplater = miniTemplater;
+/** Clean output for outside world. All undefined / null / NaN / Infinity values are changed to '-' */
+function cln(val, replacerInCaseItIsUndefinNaN = '-') { return ['undefined', undefined, 'indéfini', 'NaN', NaN, Infinity, null].includes(val) ? replacerInCaseItIsUndefinNaN : val; }
+exports.cln = cln;
+//# sourceMappingURL=string-utils.js.map

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

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

package/dist/src/tests-utils.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assert = exports.restTestMini = void 0;
+//----------------------------------------
+// TESTS UTILS
+//----------------------------------------
+const logger_utils_1 = require("./logger-utils");
+const isset_1 = require("./isset");
+const validation_utils_1 = require("./validation-utils");
+const is_object_1 = require("./is-object");
+exports.restTestMini = {
+    throwOnErr: false,
+    reset(throwOnErr = false) {
+        exports.restTestMini.nbSuccess = 0;
+        exports.restTestMini.nbError = 0;
+        exports.restTestMini.lastErrors = [];
+        exports.restTestMini.throwOnErr = throwOnErr;
+    },
+    newErr(err) {
+        exports.restTestMini.nbError++;
+        exports.restTestMini.lastErrors.push(err);
+        if (exports.restTestMini.throwOnErr)
+            throw new Error(err);
+        else
+            logger_utils_1.C.error(false, err);
+    },
+    printStats() {
+        // TODO print last errz
+        logger_utils_1.C.info(`ERRORS RESUME =========`);
+        if (exports.restTestMini.lastErrors.length)
+            logger_utils_1.C.log('\n\n\n');
+        for (const lastErr of exports.restTestMini.lastErrors)
+            logger_utils_1.C.error(false, lastErr);
+        logger_utils_1.C.log('\n\n\n');
+        logger_utils_1.C.info(`STATS =========`);
+        logger_utils_1.C.info(`Total: ${exports.restTestMini.nbSuccess + exports.restTestMini.nbError}`);
+        logger_utils_1.C.success(`Success: ${exports.restTestMini.nbSuccess}`);
+        logger_utils_1.C.error(false, `    Errors: ${exports.restTestMini.nbError}`);
+    },
+    nbSuccess: 0,
+    nbError: 0,
+    lastErrors: []
+};
+/** if validatorObject param is not set then it will consider checking that the value is set
+ *
+ * @param description
+ * @param value
+ * @param validatorObject
+ */
+function assert(description, value, validatorObject) {
+    try {
+        const validatorObjReal = {
+            value,
+            name: description,
+        };
+        if ((0, is_object_1.isObject)(validatorObject))
+            Object.assign(validatorObjReal, validatorObject);
+        else if ((0, isset_1.isset)(validatorObject))
+            validatorObjReal.eq = validatorObject;
+        const issetCheck = !(0, isset_1.isset)(validatorObjReal); // isEmpty()
+        const [errMsg, , extraInfos] = (0, validation_utils_1.validatorReturnErrArray)(validatorObjReal);
+        const msg2 = description + ` ${issetCheck ? 'isset' : `${JSON.stringify(validatorObject)}`}`;
+        if ((0, isset_1.isset)(errMsg)) {
+            const err = msg2 + `\n    ${errMsg}\n    ${JSON.stringify(extraInfos)}`;
+            exports.restTestMini.newErr(err);
+        }
+        else {
+            exports.restTestMini.nbSuccess++;
+            logger_utils_1.C.success(msg2);
+        }
+    }
+    catch (err) {
+        exports.restTestMini.newErr(err);
+    }
+}
+exports.assert = assert;
+//# sourceMappingURL=tests-utils.js.map

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

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

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

@@ -0,0 +1,16 @@
+export declare function timeout(ms: any, fn?: () => void): Promise<void>;
+export declare function runAsync(callback: any, milliseconds$?: number): Promise<void>;
+/**
+ *
+ * @param {Function} callback function that shall return ===true asynchronously
+ * @param {Number} timeoutSec default:10; general timeout in seconds
+ * @param {Boolean|String} errorAfterNSeconds default:true output an error in case of timeout, can be the displayed error message
+ * @param {*} cliOutput write a cli progress to show that a process is running
+ */
+export declare function waitUntilTrue(callback: any, timeoutSec?: number, errorAfterNSeconds?: boolean, cliOutput?: boolean): Promise<void>;
+/** Allow to perform an action in a delayed loop, useful for example to avoid reaching limits on servers. This function can be securely called multiple times.
+ * @param {Function} callback
+ * @param {Number} time default: 500ms;
+ * @param {Function} errorCallback default: e => C.error(e)
+ */
+export declare function executeInDelayedLoop(callback: any, time?: number, errorCallback?: (e: any) => any): Promise<void>;