@leyyo/common 1.3.18 → 1.3.19

package/dist/error/http.error.js

@@ -1,14 +1,7 @@
 import { LeyyoError } from "./leyyo.error.js";
 import { KEY_ERROR_DEFAULT_MESSAGE, KEY_ERROR_HTTP_STATUS } from "../const/index.js";
-/**
- * Http error
- * */
 export class HttpError extends LeyyoError {
     status;
-    /**
-     * @param {(string|Opt)} p1 - error message or error parameters
-     * @param {Opt?} p2 - error parameters
-     * */
     constructor(p1, p2) {
         super(p1, p2);
         const clazz = this.constructor;
@@ -20,6 +13,6 @@ export class HttpError extends LeyyoError {
         }
     }
     static {
-        this[KEY_ERROR_DEFAULT_MESSAGE] = 'Http error';
+        this[KEY_ERROR_DEFAULT_MESSAGE] = "Http error";
     }
 }

package/dist/error/index.d.ts

@@ -1,7 +1,7 @@
-export * from './index.types.js';
-export * from './caused.error.js';
-export * from './developer.error.js';
-export * from './http.error.js';
-export * from './invalid-value.error.js';
-export * from './leyyo.error.js';
-export * from './multiple.error.js';
+export * from "./index.types.js";
+export * from "./caused.error.js";
+export * from "./developer.error.js";
+export * from "./http.error.js";
+export * from "./invalid-value.error.js";
+export * from "./leyyo.error.js";
+export * from "./multiple.error.js";

package/dist/error/index.js

@@ -1,7 +1,7 @@
-export * from './index.types.js';
-export * from './caused.error.js';
-export * from './developer.error.js';
-export * from './http.error.js';
-export * from './invalid-value.error.js';
-export * from './leyyo.error.js';
-export * from './multiple.error.js';
+export * from "./index.types.js";
+export * from "./caused.error.js";
+export * from "./developer.error.js";
+export * from "./http.error.js";
+export * from "./invalid-value.error.js";
+export * from "./leyyo.error.js";
+export * from "./multiple.error.js";

package/dist/error/index.types.d.ts

@@ -1,195 +1,46 @@
 import { ClassLike, Obj, OneOrMore, ShiftMain, ShiftSecure } from "../base/index.js";
 import { Opt } from "../function/index.js";
 import { Logger } from "../common/index.js";
-/**
- * {@link LeyyoError}
- * */
 export interface LeyyoErrorCtor {
-    /**
-     * Create without any parameter
-     * */
     new (): LeyyoErrorLike;
-    /**
-     * Create with only message
-     *
-     * @param {string} message - error message
-     * */
     new (message: string): LeyyoErrorLike;
-    /**
-     * Create with only params
-     *
-     * @param {Opt} params - error parameters
-     * */
     new (params: Opt): LeyyoErrorLike;
-    /**
-     * Create with message and params
-     *
-     * @param {string} message - error message
-     * @param {Opt} params - error parameters
-     * */
     new (message: string, params: Opt): LeyyoErrorLike;
 }
-/**
- * {@link DeveloperError}
- * */
 export interface DeveloperErrorCtor {
-    /**
-     * Create developer error
-     *
-     * @param {string} message - error message
-     * @param {string} issue - test case
-     * @param {string} where - where
-     * */
     new (message: string, issue?: string, where?: string): DeveloperErrorLike;
 }
-export type LeyyoErrorTag = 'printed' | 'sent';
-/**
- * Stack line
- * */
+export type LeyyoErrorTag = "printed" | "sent";
 export interface ErrorStackLine {
-    /**
-     * File of error
-     * */
     file: string;
-    /**
-     * Method of error
-     * */
     method?: string;
-    /**
-     * Position of error
-     * */
     pos?: string;
 }
 export interface DeveloperErrorLike extends Error {
-    /**
-     * Formatted stack trace
-     * */
     stackTrace?: Array<ErrorStackLine>;
-    /**
-     * Log error
-     *
-     * @param {Error?} err - optional caused error
-     * */
     log(err?: Error): void;
 }
 export interface LeyyoErrorLike extends Error, ShiftSecure<LeyyoErrorSecure> {
-    /**
-     * Parameters for error
-     * */
     params?: Opt;
-    /**
-     * Formatted stack trace
-     * */
     stackTrace?: Array<ErrorStackLine>;
-    /**
-     * Caused error
-     * */
     causedBy?: OneOrMore<Error>;
-    /**
-     * Bind caused error
-     *
-     * @param {Error} err
-     * @return {LeyyoErrorLike}
-     * */
     causes(err: Error): this;
-    /**
-     * Bind holder class name
-     *
-     * @param {string} name - name of class
-     * @param {string?} fqn - fqn
-     * @return {LeyyoErrorLike}
-     * */
     where(name: string, fqn?: string): this;
-    /**
-     * Bind holder instance
-     *
-     * @param {Obj} instance - this instance
-     * @return {LeyyoErrorLike}
-     * */
     where(instance: Obj): this;
-    /**
-     * Bind holder instance
-     *
-     * @param {function} clazz - class
-     * @return {LeyyoErrorLike}
-     * */
     where(clazz: ClassLike): this;
-    /**
-     * Alias for {@link logError}
-     *
-     * @param {Logger?} logger - optional bound logger
-     * */
     log(logger?: Logger): void;
-    /**
-     * Log as `fatal`
-     *
-     * @param {Logger?} logger - optional bound logger
-     * */
     logFatal(logger?: Logger): void;
-    /**
-     * Log as `error`
-     *
-     * @param {Logger?} logger - optional bound logger
-     * */
     logError(logger?: Logger): void;
-    /**
-     * Log as `warn`
-     *
-     * @param {Logger?} logger - optional bound logger
-     * */
     logWarn(logger?: Logger): void;
-    /**
-     * Log as `debug`
-     *
-     * @param {Logger?} logger - optional bound logger
-     * */
     logDebug(logger?: Logger): void;
-    /**
-     * Log as `info`
-     *
-     * @param {Logger?} logger - optional bound logger
-     * */
     logInfo(logger?: Logger): void;
-    /**
-     * Log as `trace`
-     *
-     * @param {Logger?} logger - optional bound logger
-     * */
     logTrace(logger?: Logger): void;
 }
 export interface LeyyoErrorSecure extends ShiftMain<LeyyoErrorLike> {
     get $where(): string;
-    /**
-     * List flags
-     *
-     * @return {Array<string>} - flags
-     * */
     $list<T extends LeyyoErrorTag | string = LeyyoErrorTag | string>(): Array<T>;
-    /**
-     * Append a flag
-     *
-     * @param {string} key - flag key
-     * @return {boolean} - is it appended?
-     * */
     $append<T extends LeyyoErrorTag | string = LeyyoErrorTag | string>(key: T): boolean;
-    /**
-     * Remove a flag
-     *
-     * @param {string} key - flag key
-     * @return {boolean} - is it removed?
-     * */
     $remove<T extends LeyyoErrorTag | string = LeyyoErrorTag | string>(key: T): boolean;
-    /**
-     * Has a flag?
-     *
-     * @param {string} key - flag key
-     * @return {boolean} - has it?
-     * */
     $has<T extends LeyyoErrorTag | string = LeyyoErrorTag | string>(key: T): boolean;
-    /**
-     * Copy source properties into target parameters
-     *
-     * @param {Error} source - source error
-     * */
     $copyProperties(source: Error): void;
 }

package/dist/error/invalid-value.error.d.ts

@@ -1,6 +1,3 @@
 import { LeyyoError } from "./leyyo.error.js";
-/**
- * Invalid value error
- * */
 export declare class InvalidValueError extends LeyyoError {
 }

package/dist/error/invalid-value.error.js

@@ -1,10 +1,7 @@
 import { LeyyoError } from "./leyyo.error.js";
 import { KEY_ERROR_DEFAULT_MESSAGE } from "../const/index.js";
-/**
- * Invalid value error
- * */
 export class InvalidValueError extends LeyyoError {
     static {
-        this[KEY_ERROR_DEFAULT_MESSAGE] = 'Invalid value';
+        this[KEY_ERROR_DEFAULT_MESSAGE] = "Invalid value";
     }
 }

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

@@ -4,64 +4,31 @@ import { ClassLike, LeyyoLike, Obj, OneOrMore } from "../base/index.js";
 import { Opt } from "../function/index.js";
 import { KEY_ERROR_FLAGS, KEY_LEYYO_SECURE } from "../const/index.js";
 type T2 = LeyyoErrorTag;
-/**
- * Leyyo base error
- * */
 export declare class LeyyoError extends Error implements LeyyoErrorLike, LeyyoErrorSecure {
-    /**
-     * Error flags
-     * */
     private [KEY_ERROR_FLAGS];
-    /**
-     * Error parameters
-     * */
     params?: Opt;
-    /**
-     * Caused by error
-     * */
     causedBy?: OneOrMore<Error>;
-    /**
-     * Stack trace
-     * */
     stackTrace?: Array<ErrorStackLine>;
-    /**
-     * */
     constructor();
-    /**
-     * @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);
     static [KEY_LEYYO_SECURE](leyyo: LeyyoLike): void;
     causes(err: Error): this;
     where(p1: ClassLike | Obj | string, fqn?: string): this;
     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;
     get $where(): string;
     $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;

package/dist/error/leyyo.error.js

@@ -1,38 +1,17 @@
-import { getFqn, getSymbol, isFilledObj, isObj, optAdd, optAppend, setSymbol } from "../function/index.js";
-import { KEY_ERROR_FLAGS, KEY_ERROR_WHERE, KEY_LEYYO_SECURE, VAL_ERROR_UNKNOWN_MESSAGE } from "../const/index.js";
+import { getFqn, getSymbol, isFilledObj, isObj, optAdd, optAppend, setSymbol, } from "../function/index.js";
+import { KEY_ERROR_FLAGS, KEY_ERROR_WHERE, KEY_LEYYO_SECURE, VAL_ERROR_UNKNOWN_MESSAGE, } from "../const/index.js";
 let _leyyo;
-// region property
-const _errorField = ['name', 'message', 'stack'];
-const _leyyoErrorFields = [..._errorField, 'params', 'causedBy', 'stackTrace'];
-// endregion property
-/**
- * Leyyo base error
- * */
+const _errorField = ["name", "message", "stack"];
+const _leyyoErrorFields = [..._errorField, "params", "causedBy", "stackTrace"];
 export class LeyyoError extends Error {
-    /**
-     * Error flags
-     * */
     [KEY_ERROR_FLAGS];
-    /**
-     * Error parameters
-     * */
     params;
-    /**
-     * Caused by error
-     * */
     causedBy;
-    /**
-     * Stack trace
-     * */
     stackTrace;
-    /**
-     * @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') {
+        if (typeof p1 === "string") {
             message = p1;
             params = p2;
         }
@@ -47,7 +26,7 @@ export class LeyyoError extends Error {
             const conf = _leyyo.errorCommon.getConfigItem(clazz);
             this.message = conf?.message;
         }
-        if (params && typeof params === 'object' && !Array.isArray(params)) {
+        if (params && typeof params === "object" && !Array.isArray(params)) {
             this.params = params;
         }
         this.name = getFqn(clazz);
@@ -59,7 +38,6 @@ export class LeyyoError extends Error {
             _leyyo = leyyo;
         }
     }
-    // region bind
     causes(err) {
         if (err instanceof Error) {
             if (!this.causedBy) {
@@ -78,26 +56,24 @@ export class LeyyoError extends Error {
         return this;
     }
     where(p1, fqn) {
-        if (typeof p1 === 'function') {
+        if (typeof p1 === "function") {
             setSymbol(this, KEY_ERROR_WHERE, getFqn(p1));
         }
-        else if (p1 && typeof p1 === 'object') {
+        else if (p1 && typeof p1 === "object") {
             setSymbol(this, KEY_ERROR_WHERE, getFqn(p1));
         }
-        else if (p1 && typeof p1 === 'string' && p1.trim()) {
-            if (typeof fqn === 'string') {
+        else if (p1 && typeof p1 === "string" && p1.trim()) {
+            if (typeof fqn === "string") {
                 fqn = fqn.trim();
-                fqn = fqn ? `${fqn}.` : '';
+                fqn = fqn ? `${fqn}.` : "";
             }
             else {
-                fqn = '';
+                fqn = "";
             }
             setSymbol(this, KEY_ERROR_WHERE, fqn + p1.trim());
         }
         return this;
     }
-    // endregion bind
-    // region log
     _log(level, logger) {
         if (logger) {
             logger[level](this);
@@ -106,34 +82,27 @@ export class LeyyoError extends Error {
             _leyyo.logCommon.emitLog(level, undefined, this, {});
         }
     }
-    /** @inheritDoc */
     log(logger) {
-        this._log('error', logger);
+        this._log("error", logger);
     }
     logFatal(logger) {
-        this._log('fatal', logger);
+        this._log("fatal", logger);
     }
     logError(logger) {
-        this._log('error', logger);
+        this._log("error", logger);
     }
-    /** @inheritDoc */
     logWarn(logger) {
-        this._log('warn', logger);
+        this._log("warn", logger);
     }
-    /** @inheritDoc */
     logDebug(logger) {
-        this._log('debug', logger);
+        this._log("debug", logger);
     }
-    /** @inheritDoc */
     logInfo(logger) {
-        this._log('info', logger);
+        this._log("info", logger);
     }
-    /** @inheritDoc */
     logTrace(logger) {
-        this._log('trace', logger);
+        this._log("trace", logger);
     }
-    // endregion log
-    // region flags
     get $where() {
         return getSymbol(this, KEY_ERROR_WHERE);
     }
@@ -172,9 +141,6 @@ export class LeyyoError extends Error {
         }
         return this[KEY_ERROR_FLAGS].has(key);
     }
-    // endregion flags
-    // region methods
-    /** @inheritDoc */
     $copyProperties(source) {
         if (!(source instanceof Error)) {
             return;
@@ -184,7 +150,9 @@ export class LeyyoError extends Error {
         }
         if (source instanceof LeyyoError) {
             for (const [k, v] of Object.entries(source)) {
-                if (!_leyyoErrorFields.includes(k) && (typeof k === 'string') && !['symbol', 'function', 'undefined'].includes(typeof v)) {
+                if (!_leyyoErrorFields.includes(k) &&
+                    typeof k === "string" &&
+                    !["symbol", "function", "undefined"].includes(typeof v)) {
                     optAdd(this.params, k, v);
                 }
                 if (isFilledObj(source.params)) {
@@ -194,14 +162,14 @@ export class LeyyoError extends Error {
         }
         else {
             for (const [k, v] of Object.entries(source)) {
-                if (!_errorField.includes(k) && (typeof k === 'string') && !['symbol', 'function', 'undefined'].includes(typeof v)) {
+                if (!_errorField.includes(k) &&
+                    typeof k === "string" &&
+                    !["symbol", "function", "undefined"].includes(typeof v)) {
                     optAdd(this.params, k, v);
                 }
             }
         }
     }
-    // endregion methods
-    // region modes
     get $back() {
         return this;
     }

package/dist/error/multiple.error.d.ts

@@ -1,13 +1,7 @@
 import { LeyyoErrorLike } from "./index.types.js";
 import { LeyyoError } from "./leyyo.error.js";
-/**
- * Multiple error which manages multiple errors
- * */
 export declare class MultipleError extends LeyyoError {
     causedBy: Array<LeyyoErrorLike>;
-    /**
-     * @param {...Error[]} errors
-     * */
     constructor(...errors: Array<Error>);
     push(...errors: Array<Error>): this;
 }

package/dist/error/multiple.error.js

@@ -1,21 +1,14 @@
 import { LeyyoError } from "./leyyo.error.js";
 import { CausedError } from "./caused.error.js";
-// noinspection Annotator
-/**
- * Multiple error which manages multiple errors
- * */
 export class MultipleError extends LeyyoError {
-    /**
-     * @param {...Error[]} errors
-     * */
     constructor(...errors) {
         const first = errors.length > 0 ? errors[0] : undefined;
-        super(first?.message ?? 'Multiple error', {});
+        super(first?.message ?? "Multiple error", {});
         this.causedBy = [];
         this.push(...errors);
     }
     push(...errors) {
-        errors.forEach(e => {
+        errors.forEach((e) => {
             if (e instanceof MultipleError) {
                 this.causedBy.push(...e.causedBy);
             }

package/dist/function/define-loader.d.ts

@@ -1,8 +1,2 @@
 import { LoaderItem, LoaderLike } from "./index.types.js";
-/**
- * Set name of a loader
- *
- * @param {string} fqn - component name
- * @param {...LoaderItem[]} items - items
- * */
 export declare function defineLoader(fqn: string, ...items: Array<LoaderItem>): LoaderLike;

package/dist/function/define-loader.js

@@ -1,12 +1,6 @@
 import { isFilledArr } from "./is-filled-arr.js";
 import { isText } from "./is-text.js";
 import { KEY_LOADER_NAME } from "../const/index.js";
-/**
- * Set name of a loader
- *
- * @param {string} fqn - component name
- * @param {...LoaderItem[]} items - items
- * */
 export function defineLoader(fqn, ...items) {
     if (!isText(fqn)) {
         fqn = `leyyo/@${Date.now()}`;

package/dist/function/delay.d.ts

@@ -1,9 +1 @@
-/**
- * Delay or sleep n msec
- *
- * @param {number} waiting - waiting as milliseconds
- * @param {any} response - response value
- * @return {any}
- * @async
- * */
 export declare function delay<R = undefined>(waiting?: number, response?: R): Promise<R>;

package/dist/function/delay.js

@@ -1,12 +1,3 @@
-// noinspection JSUnusedGlobalSymbols
-/**
- * Delay or sleep n msec
- *
- * @param {number} waiting - waiting as milliseconds
- * @param {any} response - response value
- * @return {any}
- * @async
- * */
 export function delay(waiting, response) {
     if (typeof waiting !== "number" || waiting < 10) {
         waiting = Math.round(Math.random() * 1_000);

package/dist/function/delete-prop.d.ts

@@ -1,24 +1,3 @@
-/**
- * Delete target property
- *
- * @param {any} target - target
- * @param {string} key - key
- * @return {boolean} - is deleted?
- * */
 export declare function deleteKey(target: unknown, key: string): boolean;
-/**
- * Delete target hidden property
- *
- * @param {any} target - target
- * @param {symbol} key - hidden key
- * @return {boolean} - is deleted?
- * */
 export declare function deleteSymbol(target: unknown, key: symbol): boolean;
-/**
- * Delete target property
- *
- * @param {any} target - target
- * @param {(symbol|string)} key - key
- * @return {boolean} - is deleted?
- * */
 export declare function deleteProp(target: unknown, key: symbol | string): boolean;