@bitbeater/ecma-utils 2.7.0

package/dist/collection/collectionOperations.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrayDifferences = arrayDifferences;
+exports.forEachConsPairs = forEachConsPairs;
+exports.isSorted = isSorted;
+exports.lastEl = lastEl;
+exports.takeRight = takeRight;
+exports.pickRandomElement = pickRandomElement;
+exports.pickRandomElements = pickRandomElements;
+exports.takeRandomElement = takeRandomElement;
+exports.takeRandomElements = takeRandomElements;
+const utils_1 = require("../utils/utils");
+/**
+ *
+ * Compute the element-wise absolute differences between two arrays of numbers.
+ * @example
+ * ```ts
+ *  arrayDifferences([1,2,3],[3,2,1]); // [2,0,2]
+ * ```
+ * @param a1 array to compare
+ * @param a2 array to compare
+ * @returns return the array difference a1-a2
+ */
+function arrayDifferences(a1 = [], a2 = []) {
+    const retVal = [];
+    for (let i = 0; i < a1.length; i++)
+        retVal.push(Math.abs((a1[i] || 0) - (a2[i] || 0)));
+    return retVal;
+}
+/**
+ * executes the provided function fn once for each pair of consecutive elements of the provided array.
+ *
+ * @example
+ * ```ts
+ * const array=[1,2,3,4];
+ *
+ * forEachConsPairs(array,console.log);
+ *
+ * // prints
+ * // 1 2
+ * // 2 3
+ * // 3 4
+ * ```
+ *
+ */
+function forEachConsPairs(array, fn) {
+    if (!array?.length || typeof fn !== 'function')
+        return;
+    for (let i = 1; i < array.length; i++) {
+        const item1 = array[i - 1];
+        const item2 = array[i];
+        fn(item1, item2);
+    }
+}
+/**
+ * check if the givven array is sorted or not.
+ *
+ * @example check array of numbers
+ * ```ts
+ *  isSorted([1,2,3])	//true
+ *  isSorted([1,3,2])	//false
+ * ```
+ *
+ *  @example check array of strings
+ *```ts
+ *  isSorted(['a','b','c'])	//true
+ *  isSorted(['a','c','b'])	//false
+ * ```
+ *
+ *   @example check array of objects, with compareFn
+ * ```ts
+ *  isSorted([{ x:1}, { x:2}, { x:3}], (o1,o2)=> o1.x-o2.x) // true
+ *  isSorted([{ x:1}, { x:3}, { x:2}], (o1,o2)=> o1.x-o2.x) // false
+ * ```
+ *
+ * @param array array to check if is sorted
+ * @param compareFn function to use for comparison operation
+ */
+function isSorted(array, compareFn = genericSortFunction) {
+    if (!array?.length)
+        return;
+    for (let i = 1; i < array.length; i++) {
+        const item1 = array[i - 1];
+        const item2 = array[i];
+        if (compareFn(item1, item2) > 0)
+            return false;
+    }
+    return true;
+}
+const genericSortFunction = (item1, item2) => {
+    try {
+        return item1 === item2 ? 0 : item1 > item2 ? 1 : -1;
+    }
+    catch (error) {
+        return 0;
+    }
+};
+/**
+ * get the last element of an aray.
+ *
+ * @example simply does:
+ * ```ts
+ *  array[array.length - 1];
+ * ```
+ */
+function lastEl(array) {
+    return array?.[array?.length - 1];
+}
+// /**
+//  * generate an array, of specified length using the generate function
+//  *
+//  * @example Generate an array with numbers from 0 to 9
+//  * ```ts
+//  *  gen(10, i => i); // [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+//  * ```
+//  */
+// export function gen<T>(length: number, genFn: (index: number) => T): T[] {
+// 	const retVal = new Array<T>(length);
+// 	for (var i = 0; i < length; i++) retVal[i] = genFn(i);
+// 	return retVal;
+// }
+/**
+ *
+ * like {@link https://lodash.com/docs/4.17.15#takeRight lodash's takeRight}, but also with offset.
+ *
+ *
+ *
+ *
+ ** * *
+ * simply does
+ * ```ts
+ * array?.slice(array.length - n - offset , array.length - offset);
+ * ```
+ * * * *
+ *
+ *
+ * @example
+ * ```ts
+ *	takeRight([0, 1, 2, 3])			//=> [3]
+ *	takeRight([0, 1, 2, 3], 2)		 //=> [2, 3]
+ *	takeRight([0, 1, 2, 3], 2, 1)	  //=> [1, 2]
+ * ```
+ *
+ * @param array The array to query.
+ * @param n The number of elements to take.
+ * @param offset The offset to apply for elements to take.
+ * @returns Returns the slice of array.
+ */
+function takeRight(array, n = 1, offset = 0) {
+    return array?.slice(array.length - offset - n, array.length - offset);
+}
+/**
+ *
+ * Returns a random element from the provided array.
+ *
+ * @param array
+ * @returns a random element from the provided array.
+ */
+function pickRandomElement(array) {
+    return array[Math.floor(Math.random() * array.length)];
+}
+/** *
+ * Returns an array of random elements from the provided array.
+ *
+ * @param array
+ * @param legth number of elements to pick
+ * @returns an array of random elements from the provided array.
+ */
+function pickRandomElements(array, legth) {
+    return takeRandomElements([...array], legth);
+}
+/**
+ * Returns a random element from the provided array,
+ * and **removes** the element from the array.
+ *
+ * @param array
+ * @returns a random element from the provided array.
+ */
+function takeRandomElement(array) {
+    return array.splice(Math.floor(Math.random() * array.length), 1)[0];
+}
+/** *
+ * Returns an array of random elements from the provided array,
+ * and **removes** the elements from the array.
+ *
+ * @param array
+ * @param legth number of elements to pick
+ * @returns an array of random elements from the provided array.
+ */
+function takeRandomElements(array, legth) {
+    return (0, utils_1.forEach)(legth, () => takeRandomElement(array));
+}
+//# sourceMappingURL=collectionOperations.js.map

package/dist/collection/collectionOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectionOperations.js","sourceRoot":"","sources":["../../src/collection/collectionOperations.ts"],"names":[],"mappings":";;AAaA,4CAMC;AAkBD,4CASC;AA0BD,4BAWC;AAkBD,wBAEC;AA6CD,8BAEC;AASD,8CAEC;AASD,gDAEC;AASD,8CAEC;AAUD,gDAEC;AAnMD,0CAAyC;AAEzC;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAAC,KAAe,EAAE,EAAE,KAAe,EAAE;IACpE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvF,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,gBAAgB,CAAI,KAAU,EAAE,EAAgC;IAC/E,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,OAAO;IAEvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAM,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAM,KAAK,CAAC,CAAC,CAAC,CAAC;QAE1B,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClB,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,QAAQ,CAAI,KAAU,EAAE,YAA4C,mBAAmB;IACtG,IAAI,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAM,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAM,KAAK,CAAC,CAAC,CAAC,CAAC;QAE1B,IAAI,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC/C,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,mBAAmB,GAAG,CAAI,KAAQ,EAAE,KAAQ,EAAE,EAAE;IACrD,IAAI,CAAC;QACJ,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC;IACV,CAAC;AACF,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,SAAgB,MAAM,CAAI,KAAU;IACnC,OAAO,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,MAAM;AACN,wEAAwE;AACxE,KAAK;AACL,yDAAyD;AACzD,WAAW;AACX,yDAAyD;AACzD,SAAS;AACT,MAAM;AACN,6EAA6E;AAC7E,wCAAwC;AAExC,0DAA0D;AAE1D,kBAAkB;AAClB,IAAI;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,SAAS,CAAI,KAAU,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC;IACzD,OAAO,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAI,KAAU;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAI,KAAU,EAAE,KAAa;IAC9D,OAAO,kBAAkB,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAI,KAAU;IAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAI,KAAU,EAAE,KAAa;IAC9D,OAAO,IAAA,eAAO,EAAC,KAAK,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/cons.d.ts

@@ -0,0 +1,34 @@
+export declare function printNl(n?: number): void;
+export declare const logColors: {
+    reset: string;
+    bright: string;
+    dim: string;
+    underscore: string;
+    blink: string;
+    reverse: string;
+    hidden: string;
+    fg: {
+        black: string;
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+        crimson: string;
+    };
+    bg: {
+        black: string;
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+        crimson: string;
+    };
+};
+export declare function printObj(obj: any): void;
+//# sourceMappingURL=cons.d.ts.map

package/dist/cons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cons.d.ts","sourceRoot":"","sources":["../src/cons.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,CAAC,GAAE,MAAU,QAIpC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCrB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,QAIhC"}

package/dist/cons.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logColors = void 0;
+exports.printNl = printNl;
+exports.printObj = printObj;
+function printNl(n = 5) {
+    for (let i = 0; i < n; i++) {
+        console.log();
+    }
+}
+exports.logColors = {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    dim: '\x1b[2m',
+    underscore: '\x1b[4m',
+    blink: '\x1b[5m',
+    reverse: '\x1b[7m',
+    hidden: '\x1b[8m',
+    // Foreground (text) colors
+    fg: {
+        black: '\x1b[30m',
+        red: '\x1b[31m',
+        green: '\x1b[32m',
+        yellow: '\x1b[33m',
+        blue: '\x1b[34m',
+        magenta: '\x1b[35m',
+        cyan: '\x1b[36m',
+        white: '\x1b[37m',
+        crimson: '\x1b[38m',
+    },
+    // Background colors
+    bg: {
+        black: '\x1b[40m',
+        red: '\x1b[41m',
+        green: '\x1b[42m',
+        yellow: '\x1b[43m',
+        blue: '\x1b[44m',
+        magenta: '\x1b[45m',
+        cyan: '\x1b[46m',
+        white: '\x1b[47m',
+        crimson: '\x1b[48m',
+    },
+};
+function printObj(obj) {
+    for (const key of Object.keys(obj)) {
+        console.log(key, ' : ', obj[key]);
+    }
+}
+//# sourceMappingURL=cons.js.map

package/dist/cons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cons.js","sourceRoot":"","sources":["../src/cons.ts"],"names":[],"mappings":";;;AAAA,0BAIC;AAoCD,4BAIC;AA5CD,SAAgB,OAAO,CAAC,IAAY,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;AACF,CAAC;AAEY,QAAA,SAAS,GAAG;IACxB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,GAAG,EAAE,SAAS;IACd,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,2BAA2B;IAC3B,EAAE,EAAE;QACH,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,UAAU;KACnB;IACD,oBAAoB;IACpB,EAAE,EAAE;QACH,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,UAAU;QACnB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,UAAU;KACnB;CACD,CAAC;AAEF,SAAgB,QAAQ,CAAC,GAAQ;IAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC;AACF,CAAC"}

package/dist/consts.d.ts

@@ -0,0 +1,2 @@
+export declare const ISO_8601_DATE_FORMAT_REX: RegExp;
+//# sourceMappingURL=consts.d.ts.map

package/dist/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,QAAgJ,CAAC"}

package/dist/consts.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ISO_8601_DATE_FORMAT_REX = void 0;
+exports.ISO_8601_DATE_FORMAT_REX = /^(\d{4})-(0[1-9]|1[0-2])-(0[1-9]|1\d|2\d|3[0-1])T([0-1][0-9]|2[0-3]):([0-5]\d):([0-5]\d(\.\d*)?)(([-|+]([0-1][0-9]|2[0-3]):?([0-5]\d)|Z)?)$/;
+//# sourceMappingURL=consts.js.map

package/dist/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":";;;AAAa,QAAA,wBAAwB,GAAG,6IAA6I,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * as bytes from './bytes';
+export * as collection from './collection/collection';
+export * as cons from './cons';
+export * as utils from './utils/utils';
+export * as log from './logger';
+export * as math from './math';
+export * as net from './net/http';
+export * as object from './object';
+export * as promises from './promises';
+export * as reviver from './revivers';
+export * as strings from './strings';
+export * as time from './time/time';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,OAAO,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.time = exports.strings = exports.reviver = exports.promises = exports.object = exports.net = exports.math = exports.log = exports.utils = exports.cons = exports.collection = exports.bytes = void 0;
+exports.bytes = __importStar(require("./bytes"));
+exports.collection = __importStar(require("./collection/collection"));
+exports.cons = __importStar(require("./cons"));
+exports.utils = __importStar(require("./utils/utils"));
+exports.log = __importStar(require("./logger"));
+exports.math = __importStar(require("./math"));
+exports.net = __importStar(require("./net/http"));
+exports.object = __importStar(require("./object"));
+exports.promises = __importStar(require("./promises"));
+exports.reviver = __importStar(require("./revivers"));
+exports.strings = __importStar(require("./strings"));
+exports.time = __importStar(require("./time/time"));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iDAAiC;AACjC,sEAAsD;AACtD,+CAA+B;AAC/B,uDAAuC;AACvC,gDAAgC;AAChC,+CAA+B;AAC/B,kDAAkC;AAClC,mDAAmC;AACnC,uDAAuC;AACvC,sDAAsC;AACtC,qDAAqC;AACrC,oDAAoC"}

package/dist/logger.d.ts

@@ -0,0 +1,95 @@
+export declare enum LogLevel {
+    TRACE = 0,
+    DEBUG = 1,
+    INFO = 2,
+    WARN = 3,
+    ERROR = 4,
+    FATAL = 5,
+    OFF = 6
+}
+export type Loggable = string | number | boolean | object | undefined | null | Error | Loggable[];
+export interface LogWriter {
+    /**
+     * Designates fine-grained informational events that are most useful to debug an application.
+     */
+    debug: (...msg: Loggable[]) => void;
+    /**
+     * Designates informational messages that highlight the progress of the application at coarse-grained level.
+     */
+    info: (...msg: Loggable[]) => void;
+    /**
+     * Designates potentially harmful situations.
+     */
+    warn: (...msg: Loggable[]) => void;
+    /**
+     * Designates error events that might still allow the application to continue running.
+     */
+    error: (...msg: Loggable[]) => void;
+    /**
+     * Designates very severe error events that will presumably lead the application to abort.
+     */
+    fatal: (...msg: Loggable[]) => void;
+    /**
+     * Designates finer-grained informational events than the DEBUG.
+     */
+    trace: (...msg: Loggable[]) => void;
+}
+export interface LoggerConfig {
+    logWriter?: LogWriter;
+    logLevel?: LogLevel;
+    prefix?: string;
+}
+export declare class Logger implements LogWriter {
+    logLevel: LogLevel;
+    logWriter: LogWriter;
+    prefix: string;
+    constructor(conf?: LoggerConfig | string);
+    trace(...data: Loggable[]): void;
+    debug(...data: Loggable[]): void;
+    info(...data: Loggable[]): void;
+    warn(...data: Loggable[]): void;
+    error(...data: Loggable[]): void;
+    fatal(...data: Loggable[]): void;
+    /**
+     * @unstable
+     * @todo needs testing
+     *
+     * Creates a new StepLogger with the given name.
+     * @example
+     * ```ts
+     * const logger = new Logger('[main]');
+     *
+     * logger.info('creating a step logger');
+     *
+     * const step = logger.step('[step]');
+     * step.info('doing something...');
+     * step.finish();
+     *
+     *
+     * logger.info('after step logger has finished');
+     *
+     * // Output:
+     * // [2021-08-31T14:00:00.000Z] INFO: [main] creating a step logger
+     * // [2021-08-31T14:00:00.000Z] INFO: [main]:[step] started
+     * // [2021-08-31T14:00:00.000Z] INFO: [main]:[step] doing something...
+     * // [2021-08-31T14:00:00.000Z] INFO: [main]:[step] finished in 0ms
+     * // [2021-08-31T14:00:00.000Z] INFO: [main] after step logger has finished
+     * ```
+     *
+     * @param name
+     * @returns a new StepLogger wrapping this logger.
+     *
+     */
+    step(name: string): StepLogger;
+}
+/**
+ * Wrapper Logger that logs the start and end of a step.
+ * When it is created, it logs the start of the step.
+ * When the finish method is called, it logs the end of the step, and the logWriter is set to null to prevent further logging.
+ */
+export declare class StepLogger extends Logger {
+    readonly startTime: number;
+    constructor(logger: Logger, stepName: string);
+    finish(): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IACnB,KAAK,IAAA;IACL,KAAK,IAAA;IACL,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,KAAK,IAAA;IACL,KAAK,IAAA;IACL,GAAG,IAAA;CACH;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAC;AAElG,MAAM,WAAW,SAAS;IACzB;;OAEG;IACH,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACpC;;OAEG;IACH,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACnC;;OAEG;IACH,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACnC;;OAEG;IACH,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACpC;;OAEG;IACH,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;IACpC;;OAEG;IACH,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC;CACpC;AAuED,MAAM,WAAW,YAAY;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,MAAO,YAAW,SAAS;IACvC,QAAQ,WAAiB;IACzB,SAAS,YAAoB;IAC7B,MAAM,SAAM;gBACA,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAWxC,KAAK,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE;IAIzB,KAAK,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE;IAIzB,IAAI,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE;IAGxB,IAAI,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE;IAGxB,KAAK,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE;IAGzB,KAAK,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE;IAIzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;CAG9B;AAED;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,MAAM;IACrC,QAAQ,CAAC,SAAS,SAAc;gBACpB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAM5C,MAAM;CAKN"}

package/dist/logger.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepLogger = exports.Logger = exports.LogLevel = void 0;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["TRACE"] = 0] = "TRACE";
+    LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["WARN"] = 3] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+    LogLevel[LogLevel["FATAL"] = 5] = "FATAL";
+    LogLevel[LogLevel["OFF"] = 6] = "OFF";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+const defaultLogWriter = {
+    debug: (...data) => console.debug(`[${new Date().toJSON()}] DEBUG:`, ...data),
+    info: (...data) => console.info(`[${new Date().toJSON()}] INFO:`, ...data),
+    warn: (...data) => console.warn(`[${new Date().toJSON()}] WARN:`, ...data),
+    error: (...data) => {
+        (console.error(`[${new Date().toJSON()}] ERROR:`, ...data), printStack(data));
+    },
+    fatal: (...data) => {
+        (console.error(`[${new Date().toJSON()}] FATAL:`, ...data), printStack(data));
+    },
+    trace: (...data) => console.info(`[${new Date().toJSON()}] TRACE:`, ...data),
+};
+let actualLogWriter = { ...defaultLogWriter };
+let _logLevel = LogLevel.OFF;
+const _logger = {
+    trace: (...data) => {
+        if (_logLevel <= LogLevel.TRACE)
+            actualLogWriter?.trace(...data);
+    },
+    debug: (...data) => {
+        if (_logLevel <= LogLevel.DEBUG)
+            actualLogWriter?.debug(...data);
+    },
+    info: (...data) => {
+        if (_logLevel <= LogLevel.INFO)
+            actualLogWriter?.info(...data);
+    },
+    warn: (...data) => {
+        if (_logLevel <= LogLevel.WARN)
+            actualLogWriter?.warn(...data);
+    },
+    error: (...data) => {
+        if (_logLevel <= LogLevel.ERROR)
+            actualLogWriter?.error(...data);
+    },
+    fatal: (...data) => {
+        if (_logLevel <= LogLevel.FATAL)
+            actualLogWriter?.error(...data);
+    },
+};
+// /** @deprecated */
+// export const debug = (...data: Loggable[]) => _logger.debug(...data);
+// /** @deprecated */
+// export const info = (...data: Loggable[]) => _logger.info(...data);
+// /** @deprecated */
+// export const warn = (...data: Loggable[]) => _logger.warn(...data);
+// /** @deprecated */
+// export const error = (...data: Loggable[]) => _logger.error(...data);
+// /** @deprecated */
+// export const fatal = (...data: Loggable[]) => _logger.fatal(...data);
+// /** @deprecated */
+// export const trace = (...data: Loggable[]) => _logger.trace(...data);
+// /** @deprecated */
+// export const getLogger = () => ({ ..._logger });
+// /** @deprecated */
+// export const setLogger = (logger: LogWriter) => {
+// 	if (!logger) console.warn('[LOGGER]', 'setting undefined logger');
+// 	actualLogWriter = logger;
+// };
+// /** @deprecated */
+// export const setLogLevel = (logLevel: LogLevel) => {
+// 	if (_logLevel == null) console.warn('[LOGGER]', 'setting undefined log level');
+// 	_logLevel = logLevel;
+// };
+function printStack(errors) {
+    errors?.filter(e => e?.stack)?.forEach(e => console.error(e?.stack));
+}
+class Logger {
+    constructor(conf) {
+        this.logLevel = LogLevel.WARN;
+        this.logWriter = defaultLogWriter;
+        this.prefix = '';
+        if (typeof conf === 'string') {
+            this.prefix = conf;
+            return;
+        }
+        this.logLevel = conf?.logLevel ?? this.logLevel;
+        this.logWriter = conf?.logWriter ?? this.logWriter;
+        this.prefix = conf?.prefix ?? this.prefix;
+    }
+    trace(...data) {
+        if (this.logLevel <= LogLevel.TRACE)
+            this.logWriter?.trace(this.prefix, ...data);
+    }
+    debug(...data) {
+        if (this.logLevel <= LogLevel.DEBUG)
+            this.logWriter?.debug(this.prefix, ...data);
+    }
+    info(...data) {
+        if (this.logLevel <= LogLevel.INFO)
+            this.logWriter?.info(this.prefix, ...data);
+    }
+    warn(...data) {
+        if (this.logLevel <= LogLevel.WARN)
+            this.logWriter?.warn(this.prefix, ...data);
+    }
+    error(...data) {
+        if (this.logLevel <= LogLevel.ERROR)
+            this.logWriter?.error(this.prefix, ...data);
+    }
+    fatal(...data) {
+        if (this.logLevel <= LogLevel.FATAL)
+            this.logWriter?.error(this.prefix, ...data);
+    }
+    /**
+     * @unstable
+     * @todo needs testing
+     *
+     * Creates a new StepLogger with the given name.
+     * @example
+     * ```ts
+     * const logger = new Logger('[main]');
+     *
+     * logger.info('creating a step logger');
+     *
+     * const step = logger.step('[step]');
+     * step.info('doing something...');
+     * step.finish();
+     *
+     *
+     * logger.info('after step logger has finished');
+     *
+     * // Output:
+     * // [2021-08-31T14:00:00.000Z] INFO: [main] creating a step logger
+     * // [2021-08-31T14:00:00.000Z] INFO: [main]:[step] started
+     * // [2021-08-31T14:00:00.000Z] INFO: [main]:[step] doing something...
+     * // [2021-08-31T14:00:00.000Z] INFO: [main]:[step] finished in 0ms
+     * // [2021-08-31T14:00:00.000Z] INFO: [main] after step logger has finished
+     * ```
+     *
+     * @param name
+     * @returns a new StepLogger wrapping this logger.
+     *
+     */
+    step(name) {
+        return new StepLogger(this, name);
+    }
+}
+exports.Logger = Logger;
+/**
+ * Wrapper Logger that logs the start and end of a step.
+ * When it is created, it logs the start of the step.
+ * When the finish method is called, it logs the end of the step, and the logWriter is set to null to prevent further logging.
+ */
+class StepLogger extends Logger {
+    constructor(logger, stepName) {
+        super(logger);
+        this.startTime = Date.now();
+        this.prefix = (logger.prefix ? logger.prefix + ':' : '') + stepName;
+        this.info(`started`);
+    }
+    finish() {
+        const duration = Date.now() - this.startTime;
+        this.info(`finished in ${duration}ms`);
+        this.logWriter = null;
+    }
+}
+exports.StepLogger = StepLogger;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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