@leyyo/common 1.2.6 → 1.3.1

package/dist/error/leyyo.error.d.ts

@@ -0,0 +1,87 @@
+import { ClassLike, ErrorStackLine, LeyyoErrorLike, LeyyoErrorSecure, LeyyoErrorTag, Logger, Obj, OneOrMore, Opt } from "../index.types";
+import { LY_ERROR_FLAGS } from "../const";
+type T2 = LeyyoErrorTag;
+declare const LY_ERROR_WHERE = "1";
+/**
+ * Leyyo base error
+ * */
+export declare class LeyyoError extends Error implements LeyyoErrorLike, LeyyoErrorSecure {
+    /**
+     * Error flags
+     * */
+    private [LY_ERROR_FLAGS];
+    /**
+     * Error parameters
+     * */
+    params?: Opt;
+    /**
+     * Caused by error
+     * */
+    causedBy?: OneOrMore<Error>;
+    /**
+     * Stack trace
+     * */
+    stackTrace?: Array<ErrorStackLine>;
+    private [LY_ERROR_WHERE]?;
+    /**
+     * @param {string} message - error message
+     * */
+    constructor(message: string);
+    /**
+     * @param {Opt} params - error parameters
+     * */
+    constructor(params: Opt);
+    /**
+     * @param {string} message - error message
+     * @param {Opt} params - error parameters
+     * */
+    constructor(message: string, params: Opt);
+    causes(err: Error): this;
+    where(p1: ClassLike | Obj | string, fqn?: string): this;
+    /**
+     * Cast a native error to given error class
+     *
+     * @param {function} clazz - new error class
+     * @param {Error} e - native error instance
+     * @param {Opt?} params - params for error
+     * @return {LeyyoErrorLike} - new error instance
+     * */
+    static cast<E extends LeyyoErrorLike>(clazz: ClassLike, e: Error, params?: Opt): E;
+    /**
+     * Add known package to shorten stack paths
+     *
+     * @param {string} packageName - original package name, like @package/component
+     * @param {string} shortName - short name for given package
+     * */
+    static addKnownPackage(packageName: string, shortName: string): void;
+    /**
+     * Build easy error text as `<info> [err:error.name] => [error.message]`
+     *
+     * @param {Error} e - error instance
+     * @param {...Array<string|number>} parts - parts for info
+     * @return {string}
+     * */
+    static text(e: Error, ...parts: Array<string | number>): string;
+    private _log;
+    /** @inheritDoc */
+    log(logger?: Logger): void;
+    logFatal(logger?: Logger): void;
+    logError(logger?: Logger): void;
+    /** @inheritDoc */
+    logWarn(logger?: Logger): void;
+    /** @inheritDoc */
+    logDebug(logger?: Logger): void;
+    /** @inheritDoc */
+    logInfo(logger?: Logger): void;
+    /** @inheritDoc */
+    logTrace(logger?: Logger): void;
+    $list<T extends T2 | string = T2 | string>(): Array<T>;
+    $append<T extends T2 | string = T2 | string>(key: T): boolean;
+    $remove<T extends LeyyoErrorTag | string = LeyyoErrorTag | string>(key: T): boolean;
+    $has<T extends LeyyoErrorTag | string = LeyyoErrorTag | string>(key: T): boolean;
+    /** @inheritDoc */
+    $copyProperties(source: Error): void;
+    get $back(): LeyyoErrorLike;
+    get $secure(): LeyyoErrorSecure;
+}
+export {};

package/dist/error/leyyo.error.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeyyoError = void 0;
+const internal_1 = require("../internal");
+const common_1 = require("../common");
+const function_1 = require("../function");
+const developer_error_1 = require("./developer.error");
+const const_1 = require("../const");
+const log_fn_1 = require("../common/log.fn");
+// region property
+const ERROR_FIELDS = ['name', 'message', 'stack'];
+const LEYYO_ERROR_FIELDS = [...ERROR_FIELDS, 'params', 'causedBy', 'stackTrace'];
+const where = `${internal_1.FQN}.LeyyoError`;
+const knownPackages = new Map;
+const LY_ERROR_WHERE = '1';
+// endregion property
+/**
+ * Leyyo base error
+ * */
+class LeyyoError extends Error {
+    /**
+     * @param {(string|Opt)} p1 - error message or error parameters
+     * @param {Opt?} p2 - error parameters
+     * */
+    constructor(p1, p2) {
+        let message;
+        let params;
+        if (typeof p1 === 'string') {
+            message = p1;
+            params = p2;
+        }
+        else {
+            message = const_1.LY_ERROR_UNKNOWN_MESSAGE;
+            params = p1;
+        }
+        super(message);
+        const clazz = this.constructor;
+        if (!message && typeof clazz[const_1.LY_ERROR_DEFAULT_MESSAGE] === 'string') {
+            this.message = clazz[const_1.LY_ERROR_DEFAULT_MESSAGE];
+        }
+        if (params && typeof params === 'object' && !Array.isArray(params)) {
+            this.params = params;
+        }
+        this.name = (0, common_1.getFqn)(clazz);
+        (0, common_1.errorStack)(this);
+        if (clazz[const_1.LY_ERROR_EMIT]) {
+            (0, common_1.emitError)(this);
+        }
+    }
+    // region bind
+    causes(err) {
+        if (err instanceof Error) {
+            if (!this.causedBy) {
+                this.causedBy = err;
+            }
+            else if (this.causedBy instanceof Error) {
+                this.causedBy = [this.causedBy, err];
+            }
+            else if (Array.isArray(this.causedBy)) {
+                this.causedBy.push(err);
+            }
+            else {
+                this.causedBy = [this.causedBy, err];
+            }
+        }
+        return this;
+    }
+    where(p1, fqn) {
+        if (typeof p1 === 'function') {
+            this[LY_ERROR_WHERE] = (0, common_1.getFqn)(p1);
+        }
+        else if (p1 && typeof p1 === 'object') {
+            this[LY_ERROR_WHERE] = (0, common_1.getFqn)(p1);
+        }
+        else if (p1 && typeof p1 === 'string' && p1.trim()) {
+            if (typeof fqn === 'string') {
+                fqn = fqn.trim();
+                fqn = fqn ? `${fqn}.` : '';
+            }
+            else {
+                fqn = '';
+            }
+            this[LY_ERROR_WHERE] = fqn + p1.trim();
+        }
+        return this;
+    }
+    // endregion bind
+    // region static
+    /**
+     * Cast a native error to given error class
+     *
+     * @param {function} clazz - new error class
+     * @param {Error} e - native error instance
+     * @param {Opt?} params - params for error
+     * @return {LeyyoErrorLike} - new error instance
+     * */
+    static cast(clazz, e, params) {
+        const err = new clazz(e.message, params);
+        err.$copyProperties(e);
+        err.causedBy = e;
+        return err;
+    }
+    // noinspection JSUnusedGlobalSymbols
+    /**
+     * Add known package to shorten stack paths
+     *
+     * @param {string} packageName - original package name, like @package/component
+     * @param {string} shortName - short name for given package
+     * */
+    static addKnownPackage(packageName, shortName) {
+        if (!(0, function_1.isText)(packageName)) {
+            throw new developer_error_1.DeveloperError('Invalid package name', 'addKnownPackage#01', where);
+        }
+        if (!(0, function_1.isText)(shortName)) {
+            throw new developer_error_1.DeveloperError('Invalid short name', 'addKnownPackage#02', where);
+        }
+        if (knownPackages.has(shortName)) {
+            throw new developer_error_1.DeveloperError('Duplicated package name', 'addKnownPackage#03', where);
+        }
+        knownPackages.set(packageName, shortName);
+    }
+    /**
+     * Build easy error text as `<info> [err:error.name] => [error.message]`
+     *
+     * @param {Error} e - error instance
+     * @param {...Array<string|number>} parts - parts for info
+     * @return {string}
+     * */
+    static text(e, ...parts) {
+        parts = parts.map(p => {
+            if (typeof p === 'string') {
+                p = p.trim();
+                return (p !== '') ? p : undefined;
+            }
+            else if (typeof p === 'number') {
+                return p.toString(10);
+            }
+            else {
+                return undefined;
+            }
+        }).filter(p => p !== undefined);
+        const info = parts.length > 0 ? '<' + parts.join('/') + '> ' : '';
+        if (!(e instanceof Error)) {
+            return info;
+        }
+        return `${info}${(0, function_1.errorText)(e)}`;
+    }
+    // endregion static
+    // region log
+    _log(level, logger) {
+        if (logger) {
+            logger[level](this);
+        }
+        else {
+            (0, log_fn_1.emitLog)(level, undefined, this, {});
+        }
+    }
+    /** @inheritDoc */
+    log(logger) {
+        this._log('error', logger);
+    }
+    logFatal(logger) {
+        this._log('fatal', logger);
+    }
+    logError(logger) {
+        this._log('error', logger);
+    }
+    /** @inheritDoc */
+    logWarn(logger) {
+        this._log('warn', logger);
+    }
+    /** @inheritDoc */
+    logDebug(logger) {
+        this._log('debug', logger);
+    }
+    /** @inheritDoc */
+    logInfo(logger) {
+        this._log('info', logger);
+    }
+    /** @inheritDoc */
+    logTrace(logger) {
+        this._log('trace', logger);
+    }
+    // endregion log
+    // region flags
+    $list() {
+        if (this[const_1.LY_ERROR_FLAGS] === undefined) {
+            return [];
+        }
+        return Array.from(this[const_1.LY_ERROR_FLAGS].values());
+    }
+    $append(key) {
+        if (this[const_1.LY_ERROR_FLAGS] === undefined) {
+            this[const_1.LY_ERROR_FLAGS] = new Set();
+        }
+        else if (this[const_1.LY_ERROR_FLAGS].has(key)) {
+            return false;
+        }
+        this[const_1.LY_ERROR_FLAGS].add(key);
+        return true;
+    }
+    $remove(key) {
+        if (this[const_1.LY_ERROR_FLAGS] === undefined) {
+            return false;
+        }
+        if (!this[const_1.LY_ERROR_FLAGS].has(key)) {
+            return false;
+        }
+        this[const_1.LY_ERROR_FLAGS].delete(key);
+        if (this[const_1.LY_ERROR_FLAGS].size === 0) {
+            delete this[const_1.LY_ERROR_FLAGS];
+        }
+        return true;
+    }
+    $has(key) {
+        if (this[const_1.LY_ERROR_FLAGS] === undefined) {
+            return false;
+        }
+        return this[const_1.LY_ERROR_FLAGS].has(key);
+    }
+    // endregion flags
+    // region methods
+    /** @inheritDoc */
+    $copyProperties(source) {
+        if (!(source instanceof Error)) {
+            return;
+        }
+        if (!(0, function_1.isObj)(this.params)) {
+            this.params = {};
+        }
+        if (source instanceof LeyyoError) {
+            for (const [k, v] of Object.entries(source)) {
+                if (!LEYYO_ERROR_FIELDS.includes(k) && (typeof k === 'string') && !['symbol', 'function', 'undefined'].includes(typeof v)) {
+                    (0, common_1.optAdd)(this.params, k, v);
+                }
+                if ((0, function_1.isFilledObj)(source.params)) {
+                    (0, common_1.optAppend)(this.params, source.params);
+                }
+            }
+        }
+        else {
+            for (const [k, v] of Object.entries(source)) {
+                if (!ERROR_FIELDS.includes(k) && (typeof k === 'string') && !['symbol', 'function', 'undefined'].includes(typeof v)) {
+                    (0, common_1.optAdd)(this.params, k, v);
+                }
+            }
+        }
+    }
+    // endregion methods
+    // region modes
+    get $back() {
+        return this;
+    }
+    get $secure() {
+        return this;
+    }
+}
+exports.LeyyoError = LeyyoError;
+//# sourceMappingURL=leyyo.error.js.map

package/dist/error/leyyo.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leyyo.error.js","sourceRoot":"","sources":["../../src/error/leyyo.error.ts"],"names":[],"mappings":";;;AAYA,0CAAgC;AAChC,sCAA2E;AAC3E,0CAAkE;AAClE,uDAAiD;AACjD,oCAA2G;AAE3G,6CAAyC;AAIzC,kBAAkB;AAClB,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAyB,CAAC;AAC1E,MAAM,kBAAkB,GAAG,CAAC,GAAG,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAkC,CAAC;AAClH,MAAM,KAAK,GAAG,GAAG,cAAG,aAAa,CAAC;AAClC,MAAM,aAAa,GAAG,IAAI,GAAmB,CAAC;AAE9C,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,qBAAqB;AAErB;;KAEK;AACL,MAAa,UAAW,SAAQ,KAAK;IAsCjC;;;SAGK;IACL,YAAY,EAAgB,EAAE,EAAQ;QAClC,IAAI,OAAe,CAAC;QACpB,IAAI,MAAW,CAAC;QAChB,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YACzB,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,EAAE,CAAC;QAChB,CAAC;aACI,CAAC;YACF,OAAO,GAAG,gCAAwB,CAAC;YACnC,MAAM,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/B,IAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,gCAAwB,CAAC,KAAK,QAAQ,EAAE,CAAC;YACnE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,gCAAwB,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC;QAC1B,IAAA,mBAAU,EAAC,IAAI,CAAC,CAAC;QAEjB,IAAI,KAAK,CAAC,qBAAa,CAAC,EAAE,CAAC;YACvB,IAAA,kBAAS,EAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAED,cAAc;IACd,MAAM,CAAC,GAAU;QACb,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACjB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;YACxB,CAAC;iBACI,IAAI,IAAI,CAAC,QAAQ,YAAY,KAAK,EAAE,CAAC;gBACtC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACzC,CAAC;iBACI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;iBACI,CAAC;gBACF,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,EAAwB,EAAE,GAAY;QACxC,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC,cAAc,CAAC,GAAG,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC;QACtC,CAAC;aACI,IAAI,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,cAAc,CAAC,GAAG,IAAA,eAAM,EAAC,EAAE,CAAC,CAAC;QACtC,CAAC;aACI,IAAI,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YACjD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC1B,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;gBACjB,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,CAAC;iBACI,CAAC;gBACF,GAAG,GAAG,EAAE,CAAC;YACb,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,iBAAiB;IAEjB,gBAAgB;IAChB;;;;;;;SAOK;IACL,MAAM,CAAC,IAAI,CAA2B,KAAgB,EAAE,CAAQ,EAAE,MAAY;QAC1E,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAM,CAAC;QAC7C,GAAmC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACxD,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;QACjB,OAAO,GAAG,CAAC;IACf,CAAC;IAED,qCAAqC;IACrC;;;;;SAKK;IACL,MAAM,CAAC,eAAe,CAAC,WAAmB,EAAE,SAAiB;QACzD,IAAK,CAAC,IAAA,iBAAM,EAAC,WAAW,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,gCAAc,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAClF,CAAC;QACD,IAAK,CAAC,IAAA,iBAAM,EAAC,SAAS,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,gCAAc,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,gCAAc,CAAC,yBAAyB,EAAE,oBAAoB,EAAE,KAAK,CAAC,CAAC;QACrF,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;SAMK;IACL,MAAM,CAAC,IAAI,CAAC,CAAQ,EAAE,GAAG,KAA6B;QAClD,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAClB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACxB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBACb,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACtC,CAAC;iBACI,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC7B,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC1B,CAAC;iBACI,CAAC;gBACF,OAAO,SAAS,CAAC;YACrB,CAAC;QACL,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,IAAK,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,GAAG,IAAI,GAAG,IAAA,oBAAS,EAAC,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC;IAED,mBAAmB;IAEnB,aAAa;IACL,IAAI,CAAC,KAAe,EAAE,MAAe;QACzC,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;aACI,CAAC;YACF,IAAA,gBAAO,EAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,GAAG,CAAC,MAAe;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAC,MAAe;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAC,MAAe;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,kBAAkB;IAClB,OAAO,CAAC,MAAe;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,kBAAkB;IAClB,QAAQ,CAAC,MAAe;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,kBAAkB;IAClB,OAAO,CAAC,MAAe;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,kBAAkB;IAClB,QAAQ,CAAC,MAAe;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,gBAAgB;IAEhB,eAAe;IACf,KAAK;QACD,IAAI,IAAI,CAAC,sBAAc,CAAC,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,EAAE,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAc,CAAC,CAAC,MAAM,EAAE,CAAa,CAAC;IACjE,CAAC;IAED,OAAO,CAAsC,GAAM;QAC/C,IAAI,IAAI,CAAC,sBAAc,CAAC,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,sBAAc,CAAC,GAAG,IAAI,GAAG,EAAM,CAAC;QACzC,CAAC;aACI,IAAI,IAAI,CAAC,sBAAc,CAAC,CAAC,GAAG,CAAC,GAAS,CAAC,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,sBAAc,CAAC,CAAC,GAAG,CAAC,GAAS,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CAA4D,GAAM;QACrE,IAAI,IAAI,CAAC,sBAAc,CAAC,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAK,CAAC,IAAI,CAAC,sBAAc,CAAC,CAAC,GAAG,CAAC,GAAS,CAAC,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,sBAAc,CAAC,CAAC,MAAM,CAAC,GAAS,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,sBAAc,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,sBAAc,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAA4D,GAAM;QAClE,IAAI,IAAI,CAAC,sBAAc,CAAC,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,OAAO,IAAI,CAAC,sBAAc,CAAC,CAAC,GAAG,CAAC,GAAS,CAAC,CAAC;IAC/C,CAAC;IAED,kBAAkB;IAElB,iBAAiB;IAEjB,kBAAkB;IAClB,eAAe,CAAC,MAAa;QACzB,IAAK,CAAC,CAAC,MAAM,YAAY,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO;QACX,CAAC;QACD,IAAK,CAAC,IAAA,gBAAK,EAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,YAAY,UAAU,EAAE,CAAC;YAC/B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,IAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;oBACnJ,IAAA,eAAM,EAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9B,CAAC;gBACD,IAAI,IAAA,sBAAW,EAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC7B,IAAA,kBAAS,EAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1C,CAAC;YACL,CAAC;QACL,CAAC;aACI,CAAC;YACF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,IAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;oBACpI,IAAA,eAAM,EAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9B,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,oBAAoB;IAEpB,eAAe;IACf,IAAI,KAAK;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC;IAChB,CAAC;CAGJ;AAhTD,gCAgTC"}

package/dist/error/{items/multiple.error.d.ts → multiple.error.d.ts}

@@ -4,7 +4,7 @@ import { LeyyoErrorLike } from "../index.types";
  * Multiple error which manages multiple errors
  * */
 export declare class MultipleError extends LeyyoError {
-    errors: Array<LeyyoErrorLike>;
+    causedBy: Array<LeyyoErrorLike>;
     /**
      * @param {...Error[]} errors
      * */

package/dist/error/{items/multiple.error.js → multiple.error.js}

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MultipleError = void 0;
 const leyyo_error_1 = require("./leyyo.error");
+const caused_error_1 = require("./caused.error");
 // noinspection Annotator
 /**
  * Multiple error which manages multiple errors
@@ -14,19 +15,19 @@ class MultipleError extends leyyo_error_1.LeyyoError {
         var _a;
         const first = errors.length > 0 ? errors[0] : undefined;
         super((_a = first === null || first === void 0 ? void 0 : first.message) !== null && _a !== void 0 ? _a : 'Multiple error', {});
-        this.errors = [];
+        this.causedBy = [];
         this.push(...errors);
     }
     push(...errors) {
         errors.forEach(e => {
             if (e instanceof MultipleError) {
-                this.errors.push(...e.errors);
+                this.causedBy.push(...e.causedBy);
             }
             else if (e instanceof leyyo_error_1.LeyyoError) {
-                this.errors.push(e);
+                this.causedBy.push(e);
             }
             else {
-                this.errors.push(leyyo_error_1.LeyyoError.$error.cast(e));
+                this.causedBy.push(caused_error_1.CausedError.of(e));
             }
         });
         return this;

package/dist/error/multiple.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiple.error.js","sourceRoot":"","sources":["../../src/error/multiple.error.ts"],"names":[],"mappings":";;;AAAA,+CAAyC;AAEzC,iDAA2C;AAE3C,yBAAyB;AACzB;;KAEK;AACL,MAAa,aAAc,SAAQ,wBAAU;IAGzC;;SAEK;IACL,YAAY,GAAG,MAAoB;;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxD,KAAK,CAAC,MAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,mCAAI,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,GAAG,MAAoB;QACxB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACf,IAAI,CAAC,YAAY,aAAa,EAAE,CAAC;gBAC7B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtC,CAAC;iBAAM,IAAI,CAAC,YAAY,wBAAU,EAAE,CAAC;gBACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,0BAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,CAAC;QACL,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAzBD,sCAyBC"}

package/dist/{util → function}/delay.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.delay = delay;
+// noinspection JSUnusedGlobalSymbols
 /**
  * Delay or sleep n msec
  *

package/dist/function/delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/function/delay.ts"],"names":[],"mappings":";;AASA,sBAQC;AAjBD,qCAAqC;AACrC;;;;;;;KAOK;AACL,SAAgB,KAAK,CAAgB,OAAgB,EAAE,QAAY;IAC/D,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QAC9C,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAK,CAAC,CAAC;IAChD,CAAC;SACI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,OAAO,CAAI,GAAG,EAAE,CAAC,UAAU,CAAC,GAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/function/empty.fn.d.ts

@@ -0,0 +1,8 @@
+import { Arr } from "../index.types";
+/**
+ * Empty function, it can be more useful sometimes
+ *
+ * @param {Arr} _args - insignificant parameters
+ * @return {any}
+ * */
+export declare function emptyFn<R = unknown>(..._args: Arr): R | void;

package/dist/{util → function}/empty.fn.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.emptyFn = emptyFn;
+// noinspection JSUnusedGlobalSymbols
 /**
  * Empty function, it can be more useful sometimes
  *
- * @param {Arr} args - insignificant parameters
+ * @param {Arr} _args - insignificant parameters
  * @return {any}
  * */
-function emptyFn(...args) { }
+function emptyFn(..._args) { }
 //# sourceMappingURL=empty.fn.js.map

package/dist/function/empty.fn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"empty.fn.js","sourceRoot":"","sources":["../../src/function/empty.fn.ts"],"names":[],"mappings":";;AASA,0BAA8D;AAP9D,qCAAqC;AACrC;;;;;KAKK;AACL,SAAgB,OAAO,CAAc,GAAG,KAAU,IAAW,CAAC"}

package/dist/function/error-obj.d.ts

@@ -0,0 +1,8 @@
+import { ErrorObject } from "../index.types";
+/**
+ * Build a standard error text
+ *
+ * @param {Error} err - error instance
+ * @return {string} - error text
+ * */
+export declare function errorObj(err: Error): ErrorObject;

package/dist/function/error-obj.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorObj = errorObj;
+const const_1 = require("../const");
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Build a standard error text
+ *
+ * @param {Error} err - error instance
+ * @return {string} - error text
+ * */
+function errorObj(err) {
+    var _a, _b;
+    if (err instanceof Error) {
+        return {
+            name: (_a = err.name) !== null && _a !== void 0 ? _a : const_1.LY_ERROR_UNKNOWN_NAME,
+            message: (_b = err.message) !== null && _b !== void 0 ? _b : const_1.LY_ERROR_UNKNOWN_MESSAGE,
+        };
+    }
+    return {
+        name: const_1.LY_ERROR_UNKNOWN_NAME,
+        message: const_1.LY_ERROR_UNKNOWN_MESSAGE,
+    };
+}
+//# sourceMappingURL=error-obj.js.map

package/dist/function/error-obj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-obj.js","sourceRoot":"","sources":["../../src/function/error-obj.ts"],"names":[],"mappings":";;AAUA,4BAWC;AApBD,oCAAyE;AAEzE,qCAAqC;AACrC;;;;;KAKK;AACL,SAAgB,QAAQ,CAAC,GAAU;;IAC/B,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO;YACH,IAAI,EAAE,MAAA,GAAG,CAAC,IAAI,mCAAI,6BAAqB;YACvC,OAAO,EAAE,MAAA,GAAG,CAAC,OAAO,mCAAI,gCAAwB;SACnD,CAAC;IACN,CAAC;IACD,OAAO;QACH,IAAI,EAAE,6BAAqB;QAC3B,OAAO,EAAE,gCAAwB;KACpC,CAAC;AACN,CAAC"}

package/dist/function/error-text.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Build a standard error text
+ *
+ * @param {Error} err - error instance
+ * @return {string} - error text
+ * */
+export declare function errorText(err: Error): string;

package/dist/function/error-text.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorText = errorText;
+const const_1 = require("../const");
+/**
+ * Build a standard error text
+ *
+ * @param {Error} err - error instance
+ * @return {string} - error text
+ * */
+function errorText(err) {
+    var _a, _b;
+    if (err instanceof Error) {
+        return `[err:${(_a = err === null || err === void 0 ? void 0 : err.name) !== null && _a !== void 0 ? _a : const_1.LY_ERROR_UNKNOWN_NAME}] => ^/${(_b = err === null || err === void 0 ? void 0 : err.message) !== null && _b !== void 0 ? _b : const_1.LY_ERROR_UNKNOWN_MESSAGE}/$`;
+    }
+    return `[err:${const_1.LY_ERROR_UNKNOWN_NAME}] => ^/${const_1.LY_ERROR_UNKNOWN_MESSAGE}/$`;
+}
+//# sourceMappingURL=error-text.js.map

package/dist/function/error-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-text.js","sourceRoot":"","sources":["../../src/function/error-text.ts"],"names":[],"mappings":";;AAQA,8BAKC;AAbD,oCAAyE;AAEzE;;;;;KAKK;AACL,SAAgB,SAAS,CAAC,GAAU;;IAChC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACvB,OAAO,QAAQ,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,IAAI,mCAAI,6BAAqB,UAAU,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,OAAO,mCAAI,gCAAwB,IAAI,CAAC;IAC5G,CAAC;IACD,OAAO,QAAQ,6BAAqB,UAAU,gCAAwB,IAAI,CAAC;AAC/E,CAAC"}

package/dist/function/extended-type.d.ts

@@ -0,0 +1,8 @@
+import { ExtendedType } from "../index.types";
+/**
+ * Get extended type of value
+ *
+ * @param {any} value - given value
+ * @return {ExtendedType}
+ * */
+export declare function extendedType(value: unknown): ExtendedType;

package/dist/function/extended-type.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extendedType = extendedType;
+const is_1 = require("./is");
+const class_1 = require("../class");
+const const_1 = require("../const");
+// noinspection JSUnusedGlobalSymbols
+/**
+ * Get extended type of value
+ *
+ * @param {any} value - given value
+ * @return {ExtendedType}
+ * */
+function extendedType(value) {
+    switch (typeof value) {
+        case "string":
+            const trimmed = value.trim();
+            if (trimmed === '') {
+                return 'empty';
+            }
+            else if (trimmed === value) {
+                return 'text';
+            }
+            return 'string';
+        case 'number':
+            if (isNaN(value)) {
+                return 'nan';
+            }
+            return Number.isInteger(value) ? 'integer' : 'number';
+        case 'object':
+            if (!value) {
+                return 'null';
+            }
+            if (Array.isArray(value)) {
+                if (value[const_1.LY_ENUM_NAME]) {
+                    return 'enum';
+                }
+                return (value instanceof class_1.List) ? 'list' : 'array';
+            }
+            if (value instanceof Date) {
+                return 'date';
+            }
+            if (value instanceof Map) {
+                return 'map';
+            }
+            if (value instanceof Set) {
+                return 'set';
+            }
+            return value[const_1.LY_ENUM_NAME] ? 'enum' : 'object';
+        case "function":
+            return (0, is_1.isClass)(value) ? 'class' : 'function';
+        default:
+            return typeof value;
+    }
+}
+//# sourceMappingURL=extended-type.js.map

package/dist/function/extended-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extended-type.js","sourceRoot":"","sources":["../../src/function/extended-type.ts"],"names":[],"mappings":";;AAYA,oCAyCC;AApDD,6BAA6B;AAC7B,oCAA8B;AAC9B,oCAAsC;AAEtC,qCAAqC;AACrC;;;;;KAKK;AACL,SAAgB,YAAY,CAAC,KAAc;IACvC,QAAQ,OAAO,KAAK,EAAE,CAAC;QACnB,KAAK,QAAQ;YACT,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;gBACjB,OAAO,OAAO,CAAC;YACnB,CAAC;iBACI,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACzB,OAAO,MAAM,CAAC;YAClB,CAAC;YACD,OAAO,QAAQ,CAAC;QACpB,KAAK,QAAQ;YACT,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1D,KAAK,QAAQ;YACT,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,OAAO,MAAM,CAAC;YAClB,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,IAAI,KAAK,CAAC,oBAAY,CAAC,EAAE,CAAC;oBACtB,OAAO,MAAM,CAAC;gBAClB,CAAC;gBACD,OAAO,CAAC,KAAK,YAAY,YAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YACtD,CAAC;YACD,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;gBACxB,OAAO,MAAM,CAAC;YAClB,CAAC;YACD,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;gBACvB,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;gBACvB,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,OAAO,KAAK,CAAC,oBAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnD,KAAK,UAAU;YACX,OAAO,IAAA,YAAO,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QACjD;YACI,OAAO,OAAO,KAAK,CAAC;IAC5B,CAAC;AACL,CAAC"}

package/dist/{util → function}/index.d.ts

@@ -1,10 +1,10 @@
-export * from './$enum-name';
-export * from './$loader';
 export * from './delay';
 export * from './empty.fn';
+export * from './error-text';
+export * from './error-obj';
+export * from './extended-type';
 export * from './is';
 export * from './jitter-interval';
-export * from './$loader';
 export * from './one-or-more';
-export * from './secure-json';
 export * from './secure-clone';
+export * from './secure-json';

package/dist/{util → function}/index.js

@@ -14,14 +14,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./$enum-name"), exports);
-__exportStar(require("./$loader"), exports);
 __exportStar(require("./delay"), exports);
 __exportStar(require("./empty.fn"), exports);
+__exportStar(require("./error-text"), exports);
+__exportStar(require("./error-obj"), exports);
+__exportStar(require("./extended-type"), exports);
 __exportStar(require("./is"), exports);
 __exportStar(require("./jitter-interval"), exports);
-__exportStar(require("./$loader"), exports);
 __exportStar(require("./one-or-more"), exports);
-__exportStar(require("./secure-json"), exports);
 __exportStar(require("./secure-clone"), exports);
+__exportStar(require("./secure-json"), exports);
 //# sourceMappingURL=index.js.map

package/dist/function/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/function/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6CAA2B;AAC3B,+CAA6B;AAC7B,8CAA4B;AAC5B,kDAAgC;AAChC,uCAAqB;AACrB,oDAAkC;AAClC,gDAA8B;AAC9B,iDAA+B;AAC/B,gDAA8B"}