@leyyo/common 1.3.17 → 1.3.19

package/dist/function/is-filled-arr.d.ts

@@ -1,10 +1 @@
-/**
- * Is filled array?
- * Means
- * - `constructor === "Array"`
- * - `arr.length > 0`
- *
- * @param {any} arr - given value
- * @return {boolean} - is filled array?
- * */
 export declare function isFilledArr(arr: unknown): boolean;

package/dist/function/is-filled-arr.js

@@ -1,12 +1,3 @@
-/**
- * Is filled array?
- * Means
- * - `constructor === "Array"`
- * - `arr.length > 0`
- *
- * @param {any} arr - given value
- * @return {boolean} - is filled array?
- * */
 export function isFilledArr(arr) {
     return Array.isArray(arr) && arr.length > 0;
 }

package/dist/function/is-filled-obj.d.ts

@@ -1,10 +1 @@
-/**
- * Is filled object?
- * Means:
- * - `constructor === "Object"`
- * - `obj.keys.length > 0`
- *
- * @param {any} obj - given value
- * @return {boolean} - is filled object?
- * */
 export declare function isFilledObj(obj: unknown): boolean;

package/dist/function/is-filled-obj.js

@@ -1,13 +1,4 @@
 import { isObj } from "./is-obj.js";
-/**
- * Is filled object?
- * Means:
- * - `constructor === "Object"`
- * - `obj.keys.length > 0`
- *
- * @param {any} obj - given value
- * @return {boolean} - is filled object?
- * */
 export function isFilledObj(obj) {
     return isObj(obj) && Object.keys(obj).length > 0;
 }

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

@@ -1,9 +1 @@
-/**
- * Is bare object?
- * Means:
- * - `constructor === "Object"`
- *
- * @param {any} obj - given value
- * @return {boolean} - is bare object?
- * */
 export declare function isObj(obj: unknown): boolean;

package/dist/function/is-obj.js

@@ -1,11 +1,3 @@
-/**
- * Is bare object?
- * Means:
- * - `constructor === "Object"`
- *
- * @param {any} obj - given value
- * @return {boolean} - is bare object?
- * */
 export function isObj(obj) {
-    return obj && typeof obj === 'object' && !Array.isArray(obj);
+    return obj && typeof obj === "object" && !Array.isArray(obj);
 }

package/dist/function/is-test.d.ts

@@ -1,10 +1,2 @@
-/**
- * Initialize test
- * */
 export declare function initTest(): void;
-/**
- * Is test?
- *
- * @return {boolean}
- * */
 export declare function isTest(): boolean;

package/dist/function/is-test.js

@@ -1,32 +1,16 @@
-// noinspection JSUnusedGlobalSymbols
-// region properties
-/**
- * Is test?
- * */
 let _isTest;
-// endregion properties
-/**
- * Initialize test
- * */
 export function initTest() {
     _isTest = true;
     if (global) {
         if (!global.leyyo_is_testing) {
             global.leyyo_is_testing = true;
-            ['log', 'warn', 'info', 'debug', 'trace', 'error', 'fatal'].forEach(name => {
-                global.console[name] = () => {
-                };
-                console[name] = () => {
-                };
+            ["log", "warn", "info", "debug", "trace", "error", "fatal"].forEach((name) => {
+                global.console[name] = () => { };
+                console[name] = () => { };
             });
         }
     }
 }
-/**
- * Is test?
- *
- * @return {boolean}
- * */
 export function isTest() {
     return _isTest;
 }

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

@@ -1,11 +1 @@
-/**
- * Is text?
- * Means:
- * - `typeof === "string"`
- * - `not empty string`
- * - `not starts/ends with space`
- *
- * @param {any} str - given value
- * @return {boolean} - is text?
- * */
 export declare function isText(str: unknown): boolean;

package/dist/function/is-text.js

@@ -1,15 +1,5 @@
-/**
- * Is text?
- * Means:
- * - `typeof === "string"`
- * - `not empty string`
- * - `not starts/ends with space`
- *
- * @param {any} str - given value
- * @return {boolean} - is text?
- * */
 export function isText(str) {
-    if (typeof str !== 'string') {
+    if (typeof str !== "string") {
         return false;
     }
     const val = str.trim();

package/dist/function/jitter-interval.d.ts

@@ -1,10 +1 @@
-/**
- * Generate next delay time with exponential & randomized manner
- *
- * @param {number} tryCount - try count
- * @param {number} baseDelay - starting delay interval
- * @param {number} maxDelay - maximum delay interval
- * @param {number} maxTryCount - max try count, if `tryCount` excess it, it returns undefined
- * @return {number} - next interval time if (maxTryCount && `tryCount` >= `maxTryCount`)
- * */
 export declare function jitterInterval(tryCount: number, baseDelay: number, maxDelay: number, maxTryCount?: number): number;

package/dist/function/jitter-interval.js

@@ -1,15 +1,5 @@
-// noinspection JSUnusedGlobalSymbols
-/**
- * Generate next delay time with exponential & randomized manner
- *
- * @param {number} tryCount - try count
- * @param {number} baseDelay - starting delay interval
- * @param {number} maxDelay - maximum delay interval
- * @param {number} maxTryCount - max try count, if `tryCount` excess it, it returns undefined
- * @return {number} - next interval time if (maxTryCount && `tryCount` >= `maxTryCount`)
- * */
 export function jitterInterval(tryCount, baseDelay, maxDelay, maxTryCount) {
-    if ([tryCount, baseDelay, maxDelay].some(v => !isValid(v))) {
+    if ([tryCount, baseDelay, maxDelay].some((v) => !isValid(v))) {
         return undefined;
     }
     if (isValid(maxTryCount) && tryCount >= maxTryCount) {
@@ -19,12 +9,6 @@ export function jitterInterval(tryCount, baseDelay, maxDelay, maxTryCount) {
     const result = Math.floor(exp / 2 + Math.random() * (exp / 2));
     return Number.isSafeInteger(result) ? result : undefined;
 }
-/**
- * Check value is expected interval value
- *
- * @param {any} value - given value, possible number
- * @return {boolean} - is it expected?
- * */
 function isValid(value) {
-    return typeof value === 'number' && value > 0 && Number.isInteger(value) && Number.isSafeInteger(value);
+    return (typeof value === "number" && value > 0 && Number.isInteger(value) && Number.isSafeInteger(value));
 }

package/dist/function/load-config.d.ts

@@ -1,22 +1,3 @@
 import { LeyyoConfig } from "./index.types.js";
 export declare const leyyoConfig: LeyyoConfig;
-/**
- * Load config from `.leyyo.yaml` file
- *
- * `OBJECT` postfixes:
- * - !: only override (`don't merge`)
- * - ?: only merge (`don't override`)
- * - <empty>: only set if key is absent
- *
- * `ARRAY` postfixes:
- * - !: only override (`don't merge`)
- * - ?: only merge (`don't override`)
- * - <empty>: only set if key is absent
- *
- * Generics:
- * - `C`- config model
- *
- * @param {string} url
- * @return {LeyyoConfig}
- * */
 export declare function loadConfig(url: string): LeyyoConfig;

package/dist/function/load-config.js

@@ -2,39 +2,20 @@ import * as fs from "node:fs";
 import path from "node:path";
 import { dirname } from "path";
 import { fileURLToPath } from "url";
-import * as yaml from 'js-yaml';
+import * as yaml from "js-yaml";
 import { isObj } from "./is-obj.js";
 import { getRootStorage } from "../sys/index.js";
 import { isText } from "./is-text.js";
 import { isEmpty } from "./is-empty.js";
 import { secureJson, secureObject } from "./secure-json.js";
-const _NAME = '$$leyyo.config';
+const _NAME = "$$leyyo.config";
 export const leyyoConfig = getRootStorage(_NAME, {});
-/**
- * Load config from `.leyyo.yaml` file
- *
- * `OBJECT` postfixes:
- * - !: only override (`don't merge`)
- * - ?: only merge (`don't override`)
- * - <empty>: only set if key is absent
- *
- * `ARRAY` postfixes:
- * - !: only override (`don't merge`)
- * - ?: only merge (`don't override`)
- * - <empty>: only set if key is absent
- *
- * Generics:
- * - `C`- config model
- *
- * @param {string} url
- * @return {LeyyoConfig}
- * */
 export function loadConfig(url) {
     try {
         const __dirname = dirname(dirname(fileURLToPath(url)));
-        const yamlPath = path.normalize(__dirname + '/.leyyo.yaml');
+        const yamlPath = path.normalize(__dirname + "/.leyyo.yaml");
         if (fs.existsSync(yamlPath)) {
-            const input = fs.readFileSync(yamlPath, 'utf8');
+            const input = fs.readFileSync(yamlPath, "utf8");
             const data = yaml.load(input);
             if (isObj(data)) {
                 for (const [k, v] of Object.entries(data)) {
@@ -49,45 +30,33 @@ export function loadConfig(url) {
         return undefined;
     }
 }
-/**
- * Get key behaviour
- * @param {string} keyFull - key
- * @return {Array} - tuple as `[behaviour, key]`
- * */
 function _behaviour(keyFull) {
     if (!isText(keyFull)) {
         return [undefined, undefined];
     }
-    if (keyFull.endsWith('!')) {
+    if (keyFull.endsWith("!")) {
         keyFull = keyFull.substring(keyFull.length - 1).trim();
         if (!isText(keyFull)) {
             return [undefined, undefined];
         }
-        return ['override', keyFull];
+        return ["override", keyFull];
     }
-    else if (keyFull.endsWith('?')) {
+    else if (keyFull.endsWith("?")) {
         keyFull = keyFull.substring(keyFull.length - 1).trim();
         if (!isText(keyFull)) {
             return [undefined, undefined];
         }
-        return ['merge', keyFull];
+        return ["merge", keyFull];
     }
     return [undefined, keyFull];
 }
-/**
- * Merge array
- *
- * @param {Array} source
- * @param {string} key
- * @param {Array} value
- * */
 function _array(source, key, value) {
     value.forEach((item, index) => {
         if (isEmpty(item)) {
             console.warn(`[leyyoConfig] value empty at (${key}#${index})`);
             return;
         }
-        const clonedSource = source.map(item => JSON.stringify(item));
+        const clonedSource = source.map((item) => JSON.stringify(item));
         switch (typeof item) {
             case "string":
             case "number":
@@ -110,13 +79,6 @@ function _array(source, key, value) {
         }
     });
 }
-/**
- * Merge object
- *
- * @param {object} source
- * @param {string} keyFull - key
- * @param {any} value
- * */
 function _object(source, keyFull, value) {
     if (isEmpty(value)) {
         return;
@@ -129,7 +91,6 @@ function _object(source, keyFull, value) {
     if (!source) {
         source = {};
     }
-    // old is empty
     if (isEmpty(source[key])) {
         switch (typeof value) {
             case "string":
@@ -157,7 +118,7 @@ function _object(source, keyFull, value) {
                 case "override":
                     source[key] = value;
                     break;
-                default: // merge
+                default:
                     if (isEmpty(source[key])) {
                         source[key] = value;
                     }
@@ -165,9 +126,7 @@ function _object(source, keyFull, value) {
             }
             break;
         case "object":
-            // new is an array
             if (Array.isArray(value)) {
-                // old is an array (BOTH)
                 if (Array.isArray(source[key])) {
                     switch (behaviour) {
                         case "override":
@@ -177,44 +136,35 @@ function _object(source, keyFull, value) {
                             _array(source[key], key, value);
                             break;
                         default:
-                            // old exists, ignore
                             break;
                     }
                 }
-                // CONFLICT: old is not array
                 else {
                     switch (behaviour) {
                         case "override":
                             source[key] = secureObject(value);
                             break;
                         case "merge":
-                            // old is different, conflict
                             console.warn(`[leyyoConfig] type is conflicted at (${key})`);
                             break;
                         default:
-                            // old exists, ignore
                             break;
                     }
                 }
             }
-            // new is an object
             else {
-                // CONFLICT: old is not object
                 if (Array.isArray(source[key])) {
                     switch (behaviour) {
                         case "override":
                             source[key] = value;
                             break;
                         case "merge":
-                            // old is different, conflict
                             console.warn(`[leyyoConfig] type is conflicted at (${key})`);
                             break;
                         default:
-                            // old exists, ignore
                             break;
                     }
                 }
-                // old is an object (BOTH)
                 else {
                     switch (behaviour) {
                         case "override":
@@ -226,7 +176,6 @@ function _object(source, keyFull, value) {
                             }
                             break;
                         default:
-                            // old exists, ignore
                             break;
                     }
                 }

package/dist/function/on-fqn-set.js

@@ -3,13 +3,13 @@ export function onFqnSet(target, callback) {
     if (!target) {
         return false;
     }
-    if (typeof callback !== 'function') {
+    if (typeof callback !== "function") {
         return false;
     }
-    if (typeof target === 'function') { // function, class
+    if (typeof target === "function") {
         return _item(target, callback);
     }
-    else if (typeof target === 'object') {
+    else if (typeof target === "object") {
         if (Array.isArray(target)) {
             if (target[KEY_LITERAL_NAME]) {
                 return _item(target, callback);

package/dist/function/one-or-more.d.ts

@@ -1,8 +1,2 @@
 import { OneOrMore } from "../base/index.js";
-/**
- * Return array value from one or more type
- *
- * @param {OneOrMore} value - it can be one value or array value
- * @return {Array}
- * */
 export declare function oneOrMore<T = unknown>(value: OneOrMore<T>): Array<T> | undefined;

package/dist/function/one-or-more.js

@@ -1,10 +1,3 @@
-// noinspection JSUnusedGlobalSymbols
-/**
- * Return array value from one or more type
- *
- * @param {OneOrMore} value - it can be one value or array value
- * @return {Array}
- * */
 export function oneOrMore(value) {
     if (Array.isArray(value)) {
         return value;

package/dist/function/opt-add.d.ts

@@ -1,10 +1,2 @@
 import { Opt } from "./index.types.js";
-/**
- * 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 | Opt, key: keyof O | string, value: unknown): O;

package/dist/function/opt-add.js

@@ -1,19 +1,11 @@
 import { optField } from "./opt-field.js";
 import { isObj } from "./is-obj.js";
-/**
- * Add key=value into options
- *
- * @param {Opt} options - source options
- * @param {string} key - key
- * @param {any} value - value
- * @return {Opt} - added options
- * */
 export function optAdd(options, key, value) {
     const o = (isObj(options) ? options : {});
-    if (value === undefined || typeof key !== 'string') {
+    if (value === undefined || typeof key !== "string") {
         return o;
     }
-    if (key === 'field') {
+    if (key === "field") {
         return optField(o, value);
     }
     if (o[key] === undefined) {

package/dist/function/opt-append.d.ts

@@ -1,9 +1,2 @@
 import { Opt } from "./index.types.js";
-/**
- * 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;

package/dist/function/opt-append.js

@@ -1,12 +1,5 @@
 import { isObj } from "./is-obj.js";
 import { optAdd } from "./opt-add.js";
-/**
- * Merge two options
- *
- * @param {Opt} options - source options
- * @param {Opt} appended - appended options
- * @return {Opt} - merged options
- * */
 export function optAppend(options, appended) {
     const o = (isObj(options) ? options : {});
     if (!isObj(appended)) {

package/dist/function/opt-check.d.ts

@@ -1,8 +1,2 @@
 import { Opt, OptFn } from "./index.types.js";
-/**
- * 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;

package/dist/function/opt-check.js

@@ -1,18 +1,11 @@
-// noinspection JSUnusedGlobalSymbols
 import { $$get_leyyo_fn } from "./leyyo-fn.js";
 import { isObj } from "./is-obj.js";
 import { FQN } from "../internal.js";
 let _leyyo;
 const where = `${FQN}.optCheck`;
-/**
- * Check option, if it's invalid, create empty options
- *
- * @param {(Opt|OptFn)} options - options or options callback
- * @return {Opt} - checked options
- * */
 export function optCheck(options) {
     let o = options;
-    if (typeof options === 'function') {
+    if (typeof options === "function") {
         try {
             o = options();
         }
@@ -21,7 +14,7 @@ export function optCheck(options) {
             if (!_leyyo) {
                 _leyyo = $$get_leyyo_fn();
             }
-            new _leyyo.developerError('Raised callback run', 'optCheck#01', where).log(e);
+            new _leyyo.developerError("Raised callback run", "optCheck#01", where).log(e);
         }
     }
     else if (!isObj(options)) {

package/dist/function/opt-clone.d.ts

@@ -1,8 +1,2 @@
 import { Opt } from "./index.types.js";
-/**
- * Clone existing option
- *
- * @param {Opt} options - source options
- * @return {Opt} - cloned options
- * */
 export declare function optClone<O extends Opt = Opt>(options: O | Opt): O;

package/dist/function/opt-clone.js

@@ -1,12 +1,5 @@
-// noinspection JSUnusedGlobalSymbols
 import { isObj } from "./is-obj.js";
 import { secureClone } from "./secure-clone.js";
-/**
- * Clone existing option
- *
- * @param {Opt} options - source options
- * @return {Opt} - cloned options
- * */
 export function optClone(options) {
     return (isObj(options) ? secureClone(options) : {});
 }

package/dist/function/opt-field.d.ts

@@ -1,11 +1,3 @@
 import { Opt } from "./index.types.js";
 import { KeyValue } from "../base/index.js";
-/**
- * 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 | Opt, field: KeyValue): O;

package/dist/function/opt-field.js

@@ -1,31 +1,23 @@
 import { isObj } from "./is-obj.js";
-/**
- * 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 function optField(options, field) {
     const o = (isObj(options) ? options : {});
     const t = typeof field;
-    if (!['string', 'number'].includes(t)) {
+    if (!["string", "number"].includes(t)) {
         return o;
     }
     if (o.field !== undefined) {
-        if (typeof o.field !== 'string') {
-            o.field = '';
+        if (typeof o.field !== "string") {
+            o.field = "";
         }
     }
     else {
-        o.field = '';
+        o.field = "";
     }
     if (!o.field) {
-        o.field = (t === 'string') ? field : `$.[${field}]`;
+        o.field = t === "string" ? field : `$.[${field}]`;
     }
     else {
-        o.field += (t === 'string') ? `.${field}` : `[${field}]`;
+        o.field += t === "string" ? `.${field}` : `[${field}]`;
     }
     return o;
 }

package/dist/function/opt-fn.d.ts

@@ -1,8 +1,2 @@
 import { Opt } from "./index.types.js";
-/**
- * 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;

package/dist/function/opt-fn.js

@@ -1,11 +1,4 @@
 import { isObj } from "./is-obj.js";
-// noinspection JSUnusedGlobalSymbols
-/**
- * It's used to easy arrow function usage for lazy evaluation of options
- *
- * @param {Opt} options - options
- * @return {Opt} - options
- * */
 export function optFn(options) {
     return (isObj(options) ? options : {});
 }

package/dist/function/random-test-no.d.ts

@@ -1,6 +1 @@
-/**
- * Generate random test no
- *
- * @return {string}
- * */
 export declare function randomTestNo(): string;

package/dist/function/random-test-no.js

@@ -1,8 +1,3 @@
-/**
- * Generate random test no
- *
- * @return {string}
- * */
 export function randomTestNo() {
     return (Math.floor(Math.random() * 999) + 100).toString(10);
 }