@leyyo/common 1.2.6 → 1.3.1

package/dist/common/log.fn.js

@@ -0,0 +1,321 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setLogFormatter = setLogFormatter;
+exports.setLogDeploymentStylerLog = setLogDeploymentStylerLog;
+exports.setLogLocalStylerLog = setLogLocalStylerLog;
+exports.emitLog = emitLog;
+const event_fn_1 = require("./event.fn");
+const error_1 = require("../error");
+const internal_1 = require("../internal");
+const test_fn_1 = require("./test.fn");
+const function_1 = require("../function");
+const const_1 = require("../const");
+const error_fn_1 = require("./error.fn");
+// region properties
+const where = `${internal_1.FQN}.LogFn`;
+let logFormatter;
+let logDeploymentStyler;
+let logLocalStyler;
+let logStyler;
+const emptyWhere = ''.padStart(20);
+let contextFinder;
+// endregion properties
+/**
+ * Local console colors
+ *
+ * @type {LocalColorLike}
+ * */
+const localColor = {
+    bold: '\x1b[1m',
+    normal: '\x1b[21m',
+    end: '\x1b[0m',
+    param: '\x1b[90m',
+    levels: {
+        fatal: [true, '\x1b[31m', '\x1b[91m'], // bold red
+        error: [false, '\x1b[31m', '\x1b[91m'], // red
+        warn: [false, '\x1b[35m', '\x1b[95m'], // magenta
+        info: [false, '\x1b[32m', '\x1b[92m'], // green
+        debug: [false, '\x1b[33m', '\x1b[93m'], // yellow
+        trace: [false, '\x1b[36m', '\x1b[96m'], // yellow
+    }
+};
+// region setters
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Set formatter
+ *
+ * @param {function} fn - lambda for formatter
+ * */
+function setLogFormatter(fn) {
+    if (typeof fn !== 'function') {
+        throw new error_1.DeveloperError('Invalid log formatter', (0, test_fn_1.testCase)(internal_1.FQN, 161), where);
+    }
+    logFormatter = fn;
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Set deployment styler
+ *
+ * @param {function} fn - lambda for styler
+ * */
+function setLogDeploymentStylerLog(fn) {
+    if (typeof fn !== 'function') {
+        throw new error_1.DeveloperError('Invalid log styler', (0, test_fn_1.testCase)(internal_1.FQN, 162), where);
+    }
+    logDeploymentStyler = fn;
+    if (process.env['NODE_ENV'] !== 'local') {
+        logStyler = logDeploymentStyler;
+    }
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Set local style
+ *
+ * @param {function} fn - lambda for styler
+ * */
+function setLogLocalStylerLog(fn) {
+    if (typeof fn !== 'function') {
+        throw new error_1.DeveloperError('Invalid log local styler', (0, test_fn_1.testCase)(internal_1.FQN, 162), where);
+    }
+    logLocalStyler = fn;
+    if (process.env['NODE_ENV'] === 'local') {
+        logStyler = logLocalStyler;
+    }
+}
+// endregion setters
+// region local-functions
+/**
+ * Build short style of logger name
+ *
+ * @param {string} where - original logger name
+ * @param {string} - short style
+ * */
+function shortenWhere(where) {
+    if (!where) {
+        return undefined;
+    }
+    if (!where.includes('.')) {
+        return where;
+    }
+    const parts = where.split('.');
+    where = parts.pop();
+    if (parts.length > 0) {
+        where = parts.map(w => w.slice(0, 1)).join('.') + '.' + where;
+    }
+    return where;
+}
+/**
+ * Log consumer
+ *
+ * @param {LogItem} item
+ * */
+function consumeLog(item) {
+    if (!(0, function_1.isObj)(item)) {
+        return;
+    }
+    item.where = shortenWhere(item.where);
+    try {
+        logFormatter(item);
+    }
+    catch (e) {
+    }
+    let message;
+    try {
+        message = logStyler(item);
+    }
+    catch (e) {
+    }
+    if (typeof message !== 'string') {
+        message = `${item === null || item === void 0 ? void 0 : item.now} - ${typeof item.message === 'string' ? item.message : (0, function_1.secureJson)(item.message)}`;
+        if (item.params) {
+            message += ` ~^~ ${(0, function_1.secureJson)(item.params)}`;
+        }
+    }
+    console[item.level](message);
+}
+// endregion local-functions
+// region defaults
+/**
+ * Default log formatter
+ *
+ * @param {LogItem} item
+ * */
+logFormatter = (item) => {
+    var _a, _b;
+    if (item === null || item === void 0 ? void 0 : item.ctx) {
+        const ctx = item.ctx;
+        item.ctx = {
+            tid: ctx === null || ctx === void 0 ? void 0 : ctx.id,
+            cid: ((_a = ctx === null || ctx === void 0 ? void 0 : ctx.req) === null || _a === void 0 ? void 0 : _a.headers) ? (_b = ctx === null || ctx === void 0 ? void 0 : ctx.req) === null || _b === void 0 ? void 0 : _b.headers["correlation-id"] : undefined,
+        };
+    }
+    item.paramStr = item.params ? (0, function_1.secureJson)(item.params) : undefined;
+    delete item.params;
+    if (item.paramStr && ['{}', '[]'].includes(item.paramStr)) {
+        delete item.paramStr;
+    }
+};
+/**
+ * Default log deployment styler (on server)
+ *
+ * @param {LogItem} item
+ * @return {string}
+ * */
+logDeploymentStyler = (item) => {
+    let message = item.now;
+    if (item === null || item === void 0 ? void 0 : item.ctx) {
+        if (item.ctx['pid']) {
+            message += ` [p:${item.ctx['pid']}]`;
+        }
+        else {
+            message += ` [p:]`;
+        }
+        if (item.ctx['tid']) {
+            message += ` [t:${item.ctx['tid']}]`;
+        }
+        else {
+            message += ` [t:]`;
+        }
+        if (item.ctx['cid']) {
+            message += ` [c:${item.ctx['cid']}]`;
+        }
+        else {
+            message += ` [c:]`;
+        }
+    }
+    if (item.where) {
+        message += ` [w:${item.where}]`;
+    }
+    else {
+        message += ` [w:]`;
+    }
+    message += ' ' + item.message;
+    return message + (item.paramStr ? ' ~^~ ' + item.paramStr : '');
+};
+/**
+ * Default log locale styler (on local computer)
+ *
+ * @param {LogItem} item
+ * @return {string}
+ * */
+logLocalStyler = (item) => {
+    var _a;
+    const { bold, end, param } = localColor;
+    const [isBold, regular, light] = (_a = localColor.levels[item.level]) !== null && _a !== void 0 ? _a : localColor.levels.debug;
+    let message = item.now.substring(10, 11) + ` ${param}[p:${process.pid}]${end}`;
+    if (item === null || item === void 0 ? void 0 : item.ctx) {
+        if (item.ctx['tid']) {
+            message += ` ${regular}[t:${item.ctx['tid']}]`;
+        }
+        else {
+            message += ` ${param}[t:]`;
+        }
+        if (item.ctx['cid']) {
+            message += ` ${light}[c:${item.ctx['cid']}]`;
+        }
+        else {
+            message += ` ${param}[c:]`;
+        }
+    }
+    if (item.where) {
+        message += ` ${regular}[${item.where}]`;
+    }
+    else {
+        message += ` ${param}[${emptyWhere}]`;
+    }
+    message += ` ${isBold ? bold : ''}${light}${item.message}${end}`;
+    return message + (item.paramStr ? ` ~^~ ${param}${item.paramStr}${end}` : '');
+};
+/**
+ * Set current styler by environment
+ * */
+if (process.env['NODE_ENV'] === 'local') {
+    logStyler = logLocalStyler;
+}
+else {
+    logStyler = logDeploymentStyler;
+}
+// endregion defaults
+function emitLog(level, where, message, params) {
+    var _a;
+    const item = {
+        level,
+        where,
+        now: new Date().toISOString(),
+        message: undefined,
+        params: undefined,
+    };
+    if (message instanceof Error) {
+        const err = message;
+        try {
+            if (err[const_1.LY_LOG_ALREADY]) {
+                return;
+            }
+            err[const_1.LY_LOG_ALREADY] = true;
+        }
+        catch (e) {
+        }
+        item.message = (0, function_1.errorText)(message);
+        item.params = (0, error_fn_1.toErrorJsonBasic)(message, params);
+    }
+    else {
+        if (typeof message !== 'string') {
+            if ((0, function_1.isEmpty)(message)) {
+                message = '??';
+            }
+            else {
+                if (typeof message === 'object') {
+                    try {
+                        if (message[const_1.LY_LOG_ALREADY]) {
+                            return;
+                        }
+                        message[const_1.LY_LOG_ALREADY] = true;
+                    }
+                    catch (e) {
+                    }
+                }
+                message = (0, function_1.secureJson)(message);
+            }
+        }
+        item.message = message;
+        item.params = (0, function_1.isFilledObj)(params) ? params : {};
+    }
+    if (!item.where && (params === null || params === void 0 ? void 0 : params.where)) {
+        try {
+            if (typeof params.where === 'string') {
+                item.where = params.where;
+                delete params.where;
+            }
+            else if (params.where instanceof Set) {
+                const whereList = Array.from(params.where.values());
+                item.where = whereList[0];
+                params.where.delete(item.where);
+            }
+        }
+        catch (e) {
+        }
+    }
+    if (contextFinder) {
+        try {
+            item.ctx = contextFinder((_a = item.params) === null || _a === void 0 ? void 0 : _a.req);
+        }
+        catch (e) {
+        }
+    }
+    (0, event_fn_1.emitEvent)('log', item);
+}
+// region binding
+(0, event_fn_1.listenEvent)('context:finder', (v) => {
+    if (typeof v === 'function') {
+        contextFinder = v;
+    }
+    else {
+        new error_1.DeveloperError('Invalid context finder lambda', (0, test_fn_1.testCase)(internal_1.FQN, '150'), where).log();
+    }
+});
+// bind to event emitter
+(0, event_fn_1.listenEvent)('log', consumeLog);
+// bind to developer error
+error_1.DeveloperError.boundLog(consumeLog);
+// endregion binding
+//# sourceMappingURL=log.fn.js.map

package/dist/common/log.fn.js.map

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

package/dist/common/map.fn.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Create new map
+ *
+ * @param {string} name - name of collection
+ * @param {boolean} volatile - if yes: it will be removed after lifecycle run
+ * @return {Map<any, any>}
+ * */
+export declare function newRepoMap<K, V>(name: string, volatile?: boolean): Map<K, V>;
+/**
+ * Remove map by given key
+ *
+ * @param {symbol} key - key of collection
+ * @return {number}
+ *
+ * Return possibilities:
+ *  - `-2`: key is not valid symbol
+ *  - `-1`: key does not exist
+ *  - `>= 0`: length of removed items in collection
+ * */
+export declare function removeRepoMap(key: symbol): number;
+/**
+ * Clear map by given key
+ *
+ * @param {symbol} key - key of collection
+ * @return {number}
+ *
+ * Return possibilities:
+ *  - `-2`: key is not valid symbol
+ *  - `-1`: key does not exist
+ *  - `>= 0`: length of cleared items in collection
+ * */
+export declare function clearRepoMap(key: symbol): number;
+/**
+ * List all map keys
+ *
+ * @return {Array<symbol>}
+ * */
+export declare function listRepoMaps(): Array<symbol>;
+/**
+ * Print all maps
+ *
+ * @return {Record} - as {key: length of collection}
+ *
+ * Note: if stringified symbol is duplicated, add index postfix with `#` symbol
+ * */
+export declare function printMaps(): Record<string, number>;

package/dist/common/map.fn.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newRepoMap = newRepoMap;
+exports.removeRepoMap = removeRepoMap;
+exports.clearRepoMap = clearRepoMap;
+exports.listRepoMaps = listRepoMaps;
+exports.printMaps = printMaps;
+const function_1 = require("../function");
+const error_1 = require("../error");
+const internal_1 = require("../internal");
+// region properties
+/**
+ * Internal items which stores collections
+ * */
+const items = new Map();
+/**
+ * Internal volatiles repo which could be cleared after lifecycle run
+ * */
+const volatiles = new Set();
+/**
+ * Identifier of file
+ * */
+const where = `${internal_1.FQN}.MapFn`;
+// endregion properties
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Create new map
+ *
+ * @param {string} name - name of collection
+ * @param {boolean} volatile - if yes: it will be removed after lifecycle run
+ * @return {Map<any, any>}
+ * */
+function newRepoMap(name, volatile) {
+    if (!(0, function_1.isText)(name)) {
+        throw new error_1.DeveloperError('Invalid new map name', 'newMap#01', where);
+    }
+    const item = new Map();
+    const code = Symbol.for(name.split('#').join(''));
+    items.set(code, item);
+    if (volatile) {
+        volatiles.add(code);
+    }
+    return item;
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Remove map by given key
+ *
+ * @param {symbol} key - key of collection
+ * @return {number}
+ *
+ * Return possibilities:
+ *  - `-2`: key is not valid symbol
+ *  - `-1`: key does not exist
+ *  - `>= 0`: length of removed items in collection
+ * */
+function removeRepoMap(key) {
+    const cleared = clearRepoMap(key);
+    if (cleared >= 0) {
+        items.delete(key);
+        if (volatiles.has(key)) {
+            volatiles.delete(key);
+        }
+    }
+    return cleared;
+}
+/**
+ * Clear map by given key
+ *
+ * @param {symbol} key - key of collection
+ * @return {number}
+ *
+ * Return possibilities:
+ *  - `-2`: key is not valid symbol
+ *  - `-1`: key does not exist
+ *  - `>= 0`: length of cleared items in collection
+ * */
+function clearRepoMap(key) {
+    if (typeof key !== 'symbol') {
+        return -2;
+    }
+    if (!items.has(key)) {
+        return -1;
+    }
+    const item = items.get(key);
+    const length = item.size;
+    item.clear();
+    return length;
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * List all map keys
+ *
+ * @return {Array<symbol>}
+ * */
+function listRepoMaps() {
+    return Array.from(items.keys());
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Print all maps
+ *
+ * @return {Record} - as {key: length of collection}
+ *
+ * Note: if stringified symbol is duplicated, add index postfix with `#` symbol
+ * */
+function printMaps() {
+    const result = {};
+    let index = 0;
+    for (const [sym, item] of items.entries()) {
+        const key = sym.description;
+        if (result[key] === undefined) {
+            result[key] = item.size;
+            index = 0;
+        }
+        else {
+            index++;
+            result[`${key}#${index}`] = item.size;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=map.fn.js.map

package/dist/common/map.fn.js.map

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

package/dist/common/opt.fn.d.ts

@@ -0,0 +1,48 @@
+import { KeyValue, Opt, OptFn } from "../index.types";
+/**
+ * It's used to easy arrow function usage for lazy evaluation of options
+ *
+ * @param {Opt} options - options
+ * @return {Opt} - options
+ * */
+export declare function optFn<O extends Opt = Opt>(options: O | Opt): O;
+/**
+ * Check option, if it's invalid, create empty options
+ *
+ * @param {(Opt|OptFn)} options - options or options callback
+ * @return {Opt} - checked options
+ * */
+export declare function optCheck<O extends Opt = Opt>(options: O | OptFn<O> | Opt): O;
+/**
+ * Clone existing option
+ *
+ * @param {Opt} options - source options
+ * @return {Opt} - cloned options
+ * */
+export declare function optClone<O extends Opt = Opt>(options: O | Opt): O;
+/**
+ * Merge two options
+ *
+ * @param {Opt} options - source options
+ * @param {Opt} appended - appended options
+ * @return {Opt} - merged options
+ * */
+export declare function optAppend<O extends Opt = Opt>(options: O | Opt, appended: O | Opt): O;
+/**
+ * Add key=value into options
+ *
+ * @param {Opt} options - source options
+ * @param {string} key - key
+ * @param {any} value - value
+ * @return {Opt} - added options
+ * */
+export declare function optAdd<O extends Opt = Opt>(options: O | OptFn<O> | Opt, key: keyof O | string, value: unknown): O;
+/**
+ * Add field into options
+ * Note: field could not be multiple in option
+ *
+ * @param {Opt} options - source options
+ * @param {KeyValue} field - value
+ * @return {Opt} - added options
+ * */
+export declare function optField<O extends Opt = Opt>(options: O | OptFn<O> | Opt, field: KeyValue): O;

package/dist/common/opt.fn.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optFn = optFn;
+exports.optCheck = optCheck;
+exports.optClone = optClone;
+exports.optAppend = optAppend;
+exports.optAdd = optAdd;
+exports.optField = optField;
+const function_1 = require("../function");
+const error_1 = require("../error");
+const internal_1 = require("../internal");
+// region properties
+const where = `${internal_1.FQN}.OptFn`;
+// endregion properties
+// noinspection JSUnusedGlobalSymbols
+/**
+ * It's used to easy arrow function usage for lazy evaluation of options
+ *
+ * @param {Opt} options - options
+ * @return {Opt} - options
+ * */
+function optFn(options) {
+    return ((0, function_1.isObj)(options) ? options : {});
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Check option, if it's invalid, create empty options
+ *
+ * @param {(Opt|OptFn)} options - options or options callback
+ * @return {Opt} - checked options
+ * */
+function optCheck(options) {
+    let o = options;
+    if (typeof options === 'function') {
+        try {
+            o = options();
+        }
+        catch (e) {
+            o = {};
+            new error_1.DeveloperError('Raised callback run', 'optCheck#01', where).log(e);
+        }
+    }
+    else if (!(0, function_1.isObj)(options)) {
+        o = {};
+    }
+    return o;
+}
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Clone existing option
+ *
+ * @param {Opt} options - source options
+ * @return {Opt} - cloned options
+ * */
+function optClone(options) {
+    return (0, function_1.secureClone)((0, function_1.isObj)(options) ? options : {});
+}
+/**
+ * Merge two options
+ *
+ * @param {Opt} options - source options
+ * @param {Opt} appended - appended options
+ * @return {Opt} - merged options
+ * */
+function optAppend(options, appended) {
+    const o = ((0, function_1.isObj)(options) ? options : {});
+    if (!(0, function_1.isObj)(appended)) {
+        return o;
+    }
+    for (const [k, v] of Object.entries(appended)) {
+        if (o[k] === undefined) {
+            o[k] = v;
+        }
+        else {
+            optAdd(o, k, v);
+        }
+    }
+    return o;
+}
+/**
+ * Add key=value into options
+ *
+ * @param {Opt} options - source options
+ * @param {string} key - key
+ * @param {any} value - value
+ * @return {Opt} - added options
+ * */
+function optAdd(options, key, value) {
+    const o = ((0, function_1.isObj)(options) ? options : {});
+    if (value === undefined || typeof key !== 'string') {
+        return o;
+    }
+    if (key === 'field') {
+        return optField(o, value);
+    }
+    if (o[key] === undefined) {
+        o[key] = value;
+    }
+    else if (o[key] instanceof Set) {
+        o[key].add(value);
+    }
+    else {
+        o[key] = new Set([o[key], value]);
+    }
+    return o;
+}
+/**
+ * Add field into options
+ * Note: field could not be multiple in option
+ *
+ * @param {Opt} options - source options
+ * @param {KeyValue} field - value
+ * @return {Opt} - added options
+ * */
+function optField(options, field) {
+    const o = ((0, function_1.isObj)(options) ? options : {});
+    const t = typeof field;
+    if (!['string', 'number'].includes(t)) {
+        return o;
+    }
+    if (o.field !== undefined) {
+        if (typeof o.field !== 'string') {
+            o.field = '';
+        }
+    }
+    else {
+        o.field = '';
+    }
+    if (o.field === '') {
+        o.field = (t === 'string') ? field : `$.[${field}]`;
+    }
+    else {
+        o.field += (t === 'string') ? `.${field}` : `[${field}]`;
+    }
+    return o;
+}
+//# sourceMappingURL=opt.fn.js.map