utilitas.mjs

import { assertPath, decodeBase64DataURL, readJson } from './storage.mjs';
import { basename as _basename, dirname, join, sep } from 'path';
import { fileURLToPath } from 'node:url';
import { promisify } from 'util';
import { validate as verifyUuid } from 'uuid';
import * as boxes from './boxes.mjs';
import color from './color.mjs';

const call = (f, ...a) => promisify(Array.isArray(f) ? f[0].bind(f[1]) : f)(...a);
const invalidTime = 'Invalid time.';
const [Chrome, Edge] = ['Chrome', 'Edge'];
const getDateByUnixTimestamp = timestamp => new Date(~~timestamp * 1000);
const getUnixTimestampByDate = date => Math.round(date.getTime() / 1000);
const getRandomInt = max => Math.floor(Math.random() * Math.floor(max));
const randomArray = array => array.sort(() => .5 - Math.random());
const extError = (err, status, opt = {}) => Object.assign(err, { status }, opt);
const newError = (msg, status, opt) => extError(new Error(msg), status, opt);
const throwError = (msg, status, opt) => { throw newError(msg, status, opt); };
const uniqueArray = array => [...new Set(ensureArray(array))];
const is = (type, any) => getType(any) === type;
const isUndefined = any => is('Undefined', any);
const isModule = module => is('Module', module);
const isNull = object => is('Null', object);
const isSet = (o, strict) => !isUndefined(o) && (strict ? !isNull(o) : true);
const convertBase = (ipt, from, to) => parseInt(ipt || 0, from).toString(to);
const convertFrom16to10 = ipt => parseInt(convertBase(ipt, 16, 10));
const base64Encode = (object, isBuf) => encode(object, isBuf, 'base64');
const base64Decode = (string, toBuf) => decode(string, toBuf, 'base64');
const hexEncode = (object, isBuf) => encode(object, isBuf, 'hex');
const hexDecode = (string, toBuf) => decode(string, toBuf, 'hex');
const base64Pack = object => base64Encode(JSON.stringify(object));
const base64Unpack = string => JSON.parse(base64Decode(string));
const toExponential = (x, f) => Number.parseFloat(x).toExponential(f);
const timeout = m => new Promise(rs => (m ? setTimeout : setImmediate)(rs, m));
const trim = (str, opts) => ensureString(str, { trim: true, ...opts || {} });
const verifyPhone = phone => /^\+?[0-9]{4,}$/.test(phone);
const resolve = async resp => resp instanceof Promise ? await resp : resp;
const assembleApiUrl = (hst, path, args) => assembleUrl(`${hst}/${path}`, args);
const encode = (any, isBuf, e) => (isBuf ? any : Buffer.from(any)).toString(e);
const shiftTime = (dif, base) => new Date((base ?? new Date()).getTime() + dif);
const ensureLines = (any, op) => Array.isArray(any) ? any : lineSplit(any, op);
const voidFunc = () => undefined;
const lastItem = array => array.slice(-1)[0];
const clarify = str => str.toLowerCase().split(/[^a-zA-Z0-9]+/).filter(x => x);
const modules = {};
const defaultName = filename => String(filename || __filename);
const basename = f => _basename(defaultName(f)).replace(/\.[^\.]*$/, '').trim();
const checkChance = chance => Math.random() < 1 / (~~chance || 100);

const timeEmojis = {
    '00:00': '🕛', '00:30': '🕧', '01:00': '🕐', '01:30': '🕜', '02:00': '🕑',
    '02:30': '🕝', '03:00': '🕒', '03:30': '🕞', '04:00': '🕓', '04:30': '🕟',
    '05:00': '🕔', '05:30': '🕠', '06:00': '🕕', '06:30': '🕡', '07:00': '🕖',
    '07:30': '🕢', '08:00': '🕗', '08:30': '🕣', '09:00': '🕘', '09:30': '🕤',
    '10:00': '🕙', '10:30': '🕥', '11:00': '🕚', '11:30': '🕦', '00:00': '🕛',
};

const __ = (url, r) => {
    assert(url, 'Invalid URL.', 500);
    const __filename = fileURLToPath(url);
    const __dirname = dirname(__filename);
    return (r = String(r ?? '')) ? join(__dirname, r) : { __filename, __dirname };
};

const { __filename } = __(import.meta.url);

const clone = (any) => {
    let resp = any;                       // typeof Object === 'function' || etc
    switch (getType(any)) {
        case 'Object':                    // Object instance of Object
            resp = {};
            for (let i in any) { resp[i] = clone(any[i]); }
            break;
        case 'Array':                     // Object instance of Array
            resp = [];
            any.map(x => { resp.push(clone(x)); });
    }
    return resp;
};

const distill = (any, strict) => {
    let [resp, rs] = [any, null];
    switch (getType(any)) {
        case 'Object':
            resp = {};
            for (let i in any) {
                isSet((rs = distill(any[i], strict)), strict) && (resp[i] = rs);
            }
            resp = Object.keys(resp).length ? resp : undefined;
            break;
        case 'Array':
            resp = [];
            any.map(x => {
                isSet((x = distill(x, strict)), strict) && resp.push(x);
            });
            resp = resp.length ? resp : undefined;
    }
    return resp;
};

const deepCleanBigInt = (any, func = String) => {
    let resp = any;
    switch (getType(any)) {
        case 'Object':
            resp = {};
            for (let i in any) { resp[i] = deepCleanBigInt(any[i], func); }
            break;
        case 'Array':
            resp = [];
            any.map(x => { resp.push(deepCleanBigInt(x, func)); });
            break;
        case 'BigInt':
            resp = func(any);
    }
    return resp;
};

const assembleBuffer = any => {
    let resp = any;
    switch (getType(any)) {
        case 'Object':
            if (any.type === 'Buffer' && Array.isArray(any.data)) {
                resp = Buffer.from(any.data);
            } else if (any.type === 'DataURL' && String.isString(any.data)) {
                resp = decodeBase64DataURL(any.data)?.buffer;
            } else {
                resp = {};
                for (let i in any) { resp[i] = assembleBuffer(any[i]); }
            }
            break;
        case 'Array':
            resp = [];
            any.map(x => { resp.push(assembleBuffer(x)); });
    }
    return resp;
};

const mapKeys = (any, map, strict, path) => {
    let [resp, func] = [any, map];
    if (Object.isObject(map)) { func = (key) => { return map[key]; } }
    assertFunction(func);
    switch (getType(any)) {
        case 'Object':
            resp = {};
            for (let i in any) {
                const newKey = func(i, any[i], path || []);
                assert(!strict || newKey, `Error maping key: '${i}'.`, 400);
                resp[newKey || i] = mapKeys(
                    any[i], func, strict, [...path || [], i]
                );
            }
            break;
        case 'Array':
            resp = [];
            any.map((x, i) => {
                resp.push(mapKeys(x, func, strict, [...path || [], i]));
            });
    }
    return resp;
};

const ensureArray = (any) => isSet(any, true)
    ? ((Array.isArray(any) || Set.isSet(any)) ? [...any] : [any]) : [];

const ensureInt = (any, options) => {
    options = options || {};
    let int = parseInt(any);
    int = isNaN(int) ? 0 : int;
    int = isSet(options.min, true) && int < options.min ? options.min : int;
    int = isSet(options.max, true) && int > options.max ? options.max : int;
    return options.pad > 0 ? String(int).padStart(options.pad, '0') : int;
};

const toString = (any, options) => {
    if (Object.isObject(any)) { return JSON.stringify(any); }
    else if (Date.isDate(any)) { return any.toISOString(); }
    else if (Error.isError(any)) { return options?.trace ? any.stack : any.message; }
    return String(any ?? '');
};

const ensureString = (str, options) => {
    str = toString(str, options);
    if (options?.case) {
        switch (toString(options?.case).trim().toUpperCase()) {
            case 'UP':
                str = str.toUpperCase();
                break;
            case 'LOW':
                str = str.toLowerCase();
                break;
            case 'CAP': // capitalize
                str = `${str.charAt(0).toUpperCase()}${str.slice(1)}`;
                break;
            case 'CAMEL':
                str = clarify(str).map((x, i) => i ? `${x.charAt(0).toUpperCase()}${x.slice(1)}` : x).join('');
                break;
            case 'SNAKE':
                str = clarify(str).join('_');
                assert(str, 'String can not convert to snake case.', 500);
                break;
            default:
                throwError(`Invalid case option: '${options?.case}'.`, 500);
        }
    }
    options?.trim && (str = str.trim());
    options?.compact && (str = str.replace(/\s+/g, ' ').trim());
    options?.limit && (str = str.trim()) && str.length > options.limit
        && (str = `${str.slice(0, options.limit).trim()}...`);
    return str;
};

const ensureDate = (dt, options) => {
    dt && assertDate(dt = new Date(dt), options?.message);
    if (!dt && options?.required) { return throwError(invalidTime, 400); }
    else if (!dt) { return null; }
    else if (options?.asTimestamp) { return dt.getTime(); }
    else if (options?.asUnixtime) { return getUnixTimestampByDate(dt); }
    return dt;
};

const getRandomIndexInArray = (array, options) => {
    const count = ~~options?.count;
    const result = randomArray([...array.keys()]).slice(0, count || 1);
    return count ? result : result[0];
};

const getRandomItemInArray = (array, options) => {
    const count = ~~options?.count;
    const result = randomArray(getRandomIndexInArray(
        array, { count: count || 1 }
    ).sort((x, y) => y - x).map(
        x => options?.splice ? array.splice(x, 1)[0] : array[x]
    ));
    return count ? result : result[0];
};

const getItemFromStringOrArray = (any) => Array.isArray(any)
    ? getRandomItemInArray(any) : any;

const getType = (any) => typeof any === 'undefined' ? 'Undefined'
    : Object.prototype.toString.call(any).replace(/^\[[^\ ]*\ (.*)\]$/, '$1');

// Based on: https://github.com/validatorjs/validator.js, and enhanced.
const verifyUrl = (url) => {
    const str = String(url ?? '').replace(/^magnet:/, 'magnet:localhost');
    const reg = '^(?:(http://|https://|ftp://|chrome://|mailto:|magnet:))(?:\\S'
        + '+(?::\\S*)?@)?(?:(?:(?:[1-9]\\d?|1\\d\\d|2[01]\\d|22[0-3])(?:\\.(?:1'
        + '?\\d{1,2}|2[0-4]\\d|25[0-5])){2}(?:\\.(?:[0-9]\\d?|1\\d\\d|2[0-4]\\d'
        + '|25[0-4]))|(?:(?:[a-z\\u00a1-\\uffff0-9]+-?)*[a-z\\u00a1-\\uffff0-9]'
        + '+)(?:\\.(?:[a-z\\u00a1-\\uffff0-9]+-?)*[a-z\\u00a1-\\uffff0-9]+)*(?:'
        + '\\.(?:[a-z\\u00a1-\\uffff]{2,})))|localhost)(?::\\d{2,5})?(?:(/|\\?|'
        + '#)[^\\s]*)?$';
    return str.length < 2083 && new RegExp(reg, 'i').test(str);
};

const verifyEmail = (any) =>
    /^([a-zA-Z0-9_\-\.]+)@([a-zA-Z0-9_\-\.]+)\.([a-zA-Z]{2,5})$/.test(any);

const assembleUrl = (url, componens) => {
    let args = [];
    for (let i in componens || []) {
        ensureArray(componens[i]).map(x => {
            args.push(`${i}=${encodeURIComponent(x)}`);
        });
    }
    return `${url}${args.length ? `?${args.join('&')}` : ''}`;
};

const prettyJson = (object, opt) => {
    let resp = JSON.stringify(object, opt?.replacer ?? null, ~~opt?.space || 2);
    opt?.code ? (resp = renderCode(resp, opt)) : (opt?.log && console.log(resp));
    return resp;
};

const asyncTimeout = async (pms, timeout, err) => {
    let timer = null;
    let race = Promise.race([pms, new Promise((_, reject) => {
        timer = setTimeout((
        ) => { reject(new Error(err || 'Timed out.')); }, timeout);
    })]);
    const result = await race;
    try { clearTimeout(timer) } catch (err) { }
    return result;
};

const decode = (string, toBuf, encoding) => {
    const buf = Buffer.from(string, encoding);
    return toBuf ? buf : buf.toString('utf8');
};

const parseJson = (any, fallback, options) => {
    try {
        return JSON.parse(any, options?.reviver || ((key, value) => {
            if (value && value.type === 'Buffer' && Array.isArray(value.data)) {
                return Buffer.from(value.data);
            }
            return value;
        }));
    } catch (e) { return isSet(fallback) ? fallback : {}; }
};

const extract = (...path) => {
    let r = null;
    path.map((v, k) => k ? (r = r?.[v] ?? null) : (r = v));
    return r;
};

// https://stackoverflow.com/questions/34309988/byte-array-to-hex-string-conversion-in-javascript
const byteToHexString = (byteArray) => Array.from(byteArray, (byte) => {
    return ('0' + (byte & 0xFF).toString(16)).slice(-2);
}).join('');

const getShortestInArray = (arr) => {
    let [idx, len] = [0, -1];
    for (let i in arr) {
        if (len === -1 || len > arr[i].length) {
            idx = i;
            len = arr[i].length;
        }
    }
    return idx;
};

const arrayEqual = (arrA, arrB) => {
    if (!Array.isArray(arrA) || !Array.isArray(arrB)) { return false; }
    arrA.sort();
    arrB.sort();
    return arrA.join(',') === arrB.join(',');
};

const assertEmail = (email, message, status, options) => assert(
    verifyEmail(email), message || 'Invalid email.', status || 400, options
);

const assertUuid = (uuid, message, status, options) => assert(
    verifyUuid(uuid), message || 'Invalid UUID.', status || 400, options
);

const assertUrl = (url, message, status, options) => assert(
    verifyUrl(url), message || 'Invalid URL.', status || 400, options
);

const assertSet = (value, message, status, options) => assert(
    isSet(value), message || 'Undefined value.', status || 400, options
);

const assertDate = (time, message, status, options) => assert(
    Date.isDate(time, true), message || invalidTime, status || 400, options
);

const assertArray = (arr, message, status, opts) => assert(
    Array.isObject(arr), message || 'Invalid Array.', status || 400, opts
);

const assertObject = (obj, message, status, opts) => assert(
    Object.isObject(obj), message || 'Invalid Object.', status || 400, opts
);

const assertModule = (mdl, message, status, opts) => assert(
    isModule(mdl), message || 'Invalid Module.', status || 400, opts
);

const assertFunction = (fn, message, status, opts) => assert(
    Function.isFunction(fn), message || 'Invalid Function.', status || 400, opts
);

const assertBuffer = (buffer, message, status, options) => assert(
    Buffer.isBuffer(buffer) || ArrayBuffer.isArrayBuffer(buffer),
    message || 'Invalid Buffer.', status || 400, options
);

const getKeyByValue = (object, value) => {
    for (let i in object || {}) {
        if (value === object[i]) {
            return i;
        }
    }
};

// @todo: add support for other types of logs
// 'log', 'info', 'debug', 'warn', 'error'
// @todo: add support for other types of randerers
// 'table'
const log = (content, filename, options) => {
    const isErr = Error.isError(content);
    content = Object.isObject(content) ? JSON.stringify(content) : content;
    const name = options?.keepName
        ? defaultName(filename) : basename(filename).toUpperCase();
    const strTime = options?.time ? ` ${(Date.isDate(
        options.time, true
    ) ? options.time : new Date()).toISOString()}` : '';
    const args = ['[' + color.red(name) + color.yellow(strTime) + ']'
        + (isErr ? '' : ` ${content}`)];
    if (isErr) { args.push(content); }
    return console.info.apply(null, args);
};

const locate = async (rootPack) => {
    await assertPath(rootPack, 'F', 'R');
    return globalThis._manifest = rootPack;
};

const which = async (any) => { // @todo: need more precise way to detect by @Leask
    if (!Object.isObject(any = any || globalThis._manifest)) {
        any = any || import.meta.url;
        any = any.startsWith('file://') ? fileURLToPath(any) : any;
        if (!any?.endsWith?.('.json')) {
            any = ['/', ...any.split(sep).slice(1)];
            const arrPath = [];
            for (let sub of any) {
                arrPath.push(sub);
                const curPath = join(...arrPath, 'package.json');
                try { await assertPath(curPath, 'F', 'R'); any = curPath; break; }
                catch (e) { }
            }
        }
        any = await readJson(any);
        // https://nodejs.org/api/esm.html#import-assertions
        // const { default: barData } =
        //     await import('./bar.json', { assert: { type: 'json' } });
    }
    any.name = any.name || '';
    any.versionNormalized = parseVersion(any.version = any.version || '');
    any.title = `${any.name}${any.version ? (' v' + any.version) : ''}`;
    any.userAgent = `${any.name}${any.version ? `/${any.version}` : ''}`;
    return any;
};

const mergeAtoB = (objA, objB, o) => {
    objA = objA || {};
    objB = objB || {};
    for (let i in objA) {
        if (isUndefined(objA[i])) { if (o?.mergeUndefined) { delete objB[i]; } }
        else { objB[i] = objA[i]; }
    }
    return objB;
};

const insensitiveCompare = (strA, strB, options) => {
    options = { case: 'UP', ...options || {} };
    let [cmpA, cmpB] = [strA, strB].map(str => {
        str = trim(str, options);
        options.w && (str = str.replace(/[^\w]*/gi, ''));
        return str;
    });
    return cmpA === cmpB;
};

const insensitiveHas = (list, srt, options) =>
    ensureArray(list).some(item => insensitiveCompare(item, srt, options));

const makeStringByLength = (string, length) => {
    string = String(string ?? '')[0] ?? '';
    length = parseInt(length) || 0;
    let result = '';
    while (string && length && result.length < length) {
        result += string;
    }
    return result;
};

const rotate = (any, step, opts) => {
    let i = false;
    switch (getType(any)) {
        case 'String': any = ensureString(any, opts).split(''); i = true; break;
        case 'Array': break;
        default: throwError('The object can only be a string or array.', 400);
    }
    step = ~~step - any.length * Math.floor(~~step / any.length);
    any.push.apply(any, any.splice(0, step));
    return i ? any.join('') : any;
};

const humanReadableBoolean = any => [
    '✓', '1', '10-4', 'AYE', 'COOL', 'DO', 'ENABLE', 'ENABLED', 'ENGAGE',
    'ENGAGED', 'GOOD', 'GREAT', 'JA', 'OK', 'OKEY', 'ON', 'RIGHT', 'RIGHTO',
    'ROGER', 'SURE', 'TRUE', 'YEP', 'YEPPERS', 'YES', 'YUP', 'YUPPERS', '好',
    '对', '對', '开', '开启', '是', '開', '開啟', '🔊',
].includes(ensureString(any, { case: 'UP' }));

const parseVersion = (verstr) => {
    verstr = ensureString(verstr, { case: 'UP' });
    const [rules, result, s] = [{
        version: [
            [/^[^\.\d]*([\.\d]+).*$/i, '$1']
        ],
        build: [
            [/^[^\.\d]*[\.\d]+.*\-([0-9a-z]*).*/i, '$1'],
            [/^[^\.\d]*[\.\d]+.*\(([0-9a-z]*)\).*/i, '$1'],
        ],
        channel: [
            'INTERNAL', 'DEV', 'ALPHA', 'TESTING',
            'STAGING', 'BETA', 'PRODUCTION', 'STABLE',
        ],
    }, { normalized: 0 }, 5];
    for (let i in rules) {
        let resp = '';
        for (let j in rules[i]) {
            const [reg, cth] = Array.isArray(rules[i][j])
                ? [rules[i][j][0], rules[i][j][1]]
                : [new RegExp(`^.*(${rules[i][j]}).*$`, 'i'), '$1'];
            if (reg.test(verstr)) { resp = verstr.replace(reg, cth); break; }
        }
        result[i] = resp;
    }
    if (result.version) {
        const ver = result.version.split('.');
        while (ver.length < s) { ver.push(0); }
        while (ver.length) {
            result.normalized += Math.pow(10, (s - ver.length) * 5) * ver.pop();
        }
    }
    return result;
};

const matchVersion = (curVer, tgtVer) => {
    const [cV, tV] = [parseVersion(curVer), parseVersion(tgtVer)];
    return cV.normalized >= tV.normalized;
};

const fullLengthLog = (string, options) => {
    options = options || {};
    string = String(string ?? '');
    const maxLength = ensureInt(options.maxLength) || process.stdout.columns;
    const pad = options.padding ?? '=';
    if (string.length + 4 > maxLength) {
        const full = makeStringByLength(pad, maxLength);
        console.log(`${full} \n${string} \n${full} `);
    } else {
        string = string ? ` ${string} ` : '';
        const lLen = Math.floor((maxLength - string.length) / 2);
        const rLen = maxLength - lLen - string.length;
        console.log(`${makeStringByLength(pad,
            lLen)}${string}${makeStringByLength(pad, rLen)}`);
    }
    return { string, maxLength };
};

const lineSplit = (string, options) => {
    const str = ensureString(string, options);
    return str.length ? str.split(options?.separator || /\r\n|\n\r|\r|\n/) : [];
};

const renderCode = (code, options) => {
    let i = options?.initLine ?? 1;
    const arrCode = ensureLines(code);
    const bits = String(arrCode.length).length;
    const s = options?.separator ?? '|';
    const resp = arrCode.map(
        x => `${String(i++).padStart(bits, '0')} ${s} ${ensureString(x).replace('```', '\\`\\`\\`')}`
    );
    const output = options?.asArray ? resp : resp.join('\n');
    options?.log && console.log(output);
    return output;
};

const renderObject = (obj, options) => {
    assertObject(obj, 'Invalid object');
    const [keys, s] = [Object.keys(obj), options?.separator ?? ':'];
    let len = 0;
    keys.map(k => len = Math.max(len, k.length));
    const resp = keys.map(key => `${key.padEnd(len, ' ')} ${s} ${(
        options?.render || ensureString
    )(obj[key], { ...options || {}, key })}`);
    return options?.asArray ? resp : resp.join('\n');
};

const renderText = (text, options) => {
    const [arrText, code, result] = [ensureLines(text), [], []];
    arrText.map(line => {
        const codeBlock = /^```/.test(line);
        if (codeBlock && !code.length) { // start code block
            options?.noCode || result.push(line);
            const lang = line.replace(/^```/, '').trim();
            code.push(lang ? `> ${lang}` : '');
        } else if (codeBlock && code.length) { // end code block
            if (!options?.noCode) {
                const withLang = options?.extraCodeBlock && code[0].length;
                withLang || code.shift();
                result.push(renderCode(code, {
                    ...options || {}, initLine: withLang ? 0 : 1
                }), line);
            }
            code.length = 0;
        } else if (code.length) { // in code block
            code.push(line);
        } else { // normal text
            result.push(line);
        }
    });
    return options?.asArray ? result : result.join('\n');
};

const renderBox = (content, options) => {
    const [minWidth, defWidth, maxWidth, output, style]
        = [10, 80, 1024 * 2, [], boxes[options?.style || 'round']];
    let [width, title] = [~~options?.width, options?.title || ''];
    assert(content.length, 'Content must not be empty.');
    assert(style, `Style must be one of ${Object.keys(boxes).join(', ')}.`);
    assert(
        !width || (width >= minWidth && width <= maxWidth),
        `Width must be between ${minWidth} and ${maxWidth}.`
    );
    const innWidth = (width || (width = defWidth)) - 2;
    const cntWidth = innWidth - 2;
    const cut = txt => `${txt.slice(0, cntWidth - 3)}...`;
    const pushContent = cnt => output.push(
        [style.left, cnt.padEnd(cntWidth, ' '), style.right].join(' ')
    );
    title.length > cntWidth && (title = cut(title));
    title.length && (title = ` ${title} `);
    output.push(style.topLeft + title + style.top.repeat(
        innWidth - title.length
    ) + style.topRight);
    title.length && pushContent('');
    ensureLines(content).map(line => {
        line = line || ' ';
        while (line.length) {
            pushContent(options?.noWrap ? cut(line) : line.slice(0, cntWidth));
            line = options?.noWrap ? '' : line.slice(cntWidth);
        }
    });
    pushContent('');
    output.push(
        style.bottomLeft + style.bottom.repeat(innWidth) + style.bottomRight
    );
    const result = options?.asArray ? output : output.join('\n');
    options?.log && console.log(result);
    return result;
};

const range = (from, to, options) => {
    options = options || {};
    options.base = ensureInt(options.base, { min: 0 });
    options.step = ensureInt(options.step, { min: 1 });
    [from, to] = [ensureInt(from), ensureInt(to)];
    const [d, resp] = [from <= to ? 1 : -1, []];
    for (let i = from; d > 0 ? i <= to : i >= to; i += options.step * d) {
        if (options.noBoundary && (i === from || i === to)) { continue; }
        resp.push(options.base + i);
    }
    return resp;
};

const checkInterval = (itv, sed) =>
    !((Math.round(Date.now() / 1000) + ensureInt(sed)) % ensureInt(itv));

const ignoreErrFunc = async (func, options) => {
    const run = async () => {
        try { return await func(...options?.args || []) }
        catch (err) { options?.log && console.error(err); }
    };
    if (options?.await) { await timeout(options.await); return await run(); }
    else if (options?.wait) { return setTimeout(run, options.wait); }
    return await run();
};

const tryUntil = async (fnTry, options) => {
    options = {
        interval: 1000 * 1, maxTry: Infinity, log: false, error: 'Operation failed.',
        verify: async (err, res) => { return !err; }, ...options || {}
    };
    let [curTry, result, err] = [0, null, null];
    do {
        try {
            assert(await options.verify((err = null), (result = await fnTry())), options.error);
        } catch (e) {
            (err = e) && options?.log && console.error(e);
            await timeout(options.interval);
        }
    } while (++curTry < options.maxTry && err)
    if (err) { throw err; }
    return result;
};

const split = (str, options) => trim(str, options).split(
    options?.separator ?? /[,|;\ \t\n]+/
).map(x => x.trim()).filter(x => x.length);

const isAscii = (str) => {
    if (String.isString(str)) {
        for (let i = 0; i < str.length; i++) {
            if (str.charCodeAt(i) > 127) { return false; }
        }
    }
    return true;
};

const escapeHtml = unsafe => unsafe
    .replaceAll('&', '&amp;')
    .replaceAll('<', '&lt;')
    .replaceAll('>', '&gt;')
    .replaceAll('"', '&quot;')
    .replaceAll("'", '&#039;');

// https://www.unicode.org/Public/13.0.0/ucd/emoji/emoji-data.txt
// https://stackoverflow.com/questions/10992921/how-to-remove-emoji-code-using-javascript
// https://twitter.com/_cxa/status/1384304473493831681?s=20
// /[^\p{L}\p{N}\p{P}\p{Z}{\^\$}]/gu
// /(?:[\u2700-\u27bf]|(?:\ud83c[\udde6-\uddff]){2}|[\ud800-\udbff][\udc00-\udfff]|[\u0023-\u0039]\ufe0f?\u20e3|\u3299|\u3297|\u303d|\u3030|\u24c2|\ud83c[\udd70-\udd71]|\ud83c[\udd7e-\udd7f]|\ud83c\udd8e|\ud83c[\udd91-\udd9a]|\ud83c[\udde6-\uddff]|\ud83c[\ude01-\ude02]|\ud83c\ude1a|\ud83c\ude2f|\ud83c[\ude32-\ude3a]|\ud83c[\ude50-\ude51]|\u203c|\u2049|[\u25aa-\u25ab]|\u25b6|\u25c0|[\u25fb-\u25fe]|\u00a9|\u00ae|\u2122|\u2139|\ud83c\udc04|[\u2600-\u26FF]|\u2b05|\u2b06|\u2b07|\u2b1b|\u2b1c|\u2b50|\u2b55|\u231a|\u231b|\u2328|\u23cf|[\u23e9-\u23f3]|[\u23f8-\u23fa]|\ud83c\udccf|\u2934|\u2935|[\u2190-\u21ff])/g
const purgeEmoji = (any, replace) => toString(any).replace(
    /(?!\d)(?!\*)[\p{Emoji_Modifier}\p{Emoji_Component}\p{Extended_Pictographic}]/ug,
    replace ?? ''
);

const mask = (str, options) => {
    options = options || {};
    str = ensureString(str);
    options.kepp = (options.kepp = ~~options.kepp || 1) >= str.length
        ? str.length - 1 : options.kepp;
    return str.replace(/.{1}/g, options.replace || '*').replace(
        new RegExp(`^.{${options.kepp}}`), str.substr(0, options.kepp)
    );
};

const once = (fn, context) => {
    let result;
    return function() {
        if (fn) {
            result = fn.apply(context || this, arguments);
            fn = null;
        }
        return result;
    }
};

// https://stackoverflow.com/questions/1007981/how-to-get-function-parameter-names-values-dynamically
const getFuncParams = (func) => {
    const STRIP_COMMENTS = /(\/\/.*$)|(\/\*[\s\S]*?\*\/)|(\s*=[^,\)]*(('(?:\\'|[^'\r\n])*')|("(?:\\"|[^"\r\n])*"))|(\s*=[^,\)]*))/mg;
    const ARGUMENT_NAMES = /([^\s,]+)/g;
    const strFunc = func.toString().replace(STRIP_COMMENTS, '');
    return (strFunc.slice(
        strFunc.indexOf('(') + 1, strFunc.indexOf(')')
    ).match(ARGUMENT_NAMES) || []).filter(x => !/\:|\'|\"|\{|\}|^\d+$/ig.test(x));
};

const analyzeModule = (obj) => {
    assertModule(obj);
    const [keys, result] = [Object.getOwnPropertyNames(obj), {}];
    keys.sort().map(key => result[key] = {
        type: getType(obj[key]), ...Function.isFunction(obj[key])
            ? { params: getFuncParams(obj[key]) } : { value: ensureString(obj[key]) }
    });
    return result;
};

const need = async (name, options) => {
    assert(name, `Module \`${name}\` is required.`, 500);
    modules[name] || (modules[name] = await import(name));
    return !options?.raw && modules[name].default
        ? modules[name].default : modules[name];
};

const countKeys = (any) => {
    if (Array.isArray(any)) { return any.length; }
    else if (Object.isObject(any)) { return Object.keys(any).length; }
    return 0;
};

const exclude = (obj, keys) => {
    const resp = {};
    Object.keys(obj).filter(k => !keys.includes(k)).map(k => resp[k] = obj[k]);
    return resp;
};

const inBrowser = () => {
    const browsers = [
        'Firefox', [Edge, 'Edg'], Chrome, ['MSIE', 'Trident'], 'Safari',
    ].map(ensureArray);
    try {
        for (let name of browsers) {
            for (let item of name) {
                if (navigator.userAgent.includes(item)) {
                    return name[0];
                }
            }
        }
        return typeof window === 'object';
    } catch (err) { }
    return false;
};

const supportAnsiColor = () => {
    try {
        if (process.stdout.isTTY && process.env.TERM !== 'dumb') {
            return 'Node.js';
        }
    } catch (err) { }
    const browser = inBrowser();
    return [Chrome, Edge].includes(browser) ? browser : false;
};

const splitArgs = str => ((str || '').match(/"[^"]+"|'[^']+'|\S+/g) || []).map(
    x => x.replace(/^['"]|['"]$/g, '')
);

const getTimeIcon = (objTime) => {
    assertDate(objTime, null, null, { strict: true });
    const [iH, iM] = [objTime.getHours(), objTime.getMinutes()];
    const [inputTime, timeIcon] = [(iH >= 12 ? (iH - 12) : iH) * 60 + iM, []];
    for (const i in timeEmojis) {
        const [tH, tM] = i.split(':').map(x => parseInt(x));
        timeIcon.push([Math.abs(inputTime - (tH * 60 + tM)), i, tH, tM]);
    }
    timeIcon.sort((x, y) => x[0] - y[0]);
    return timeEmojis[timeIcon[0][1]];
};

export {
    __,
    analyzeModule,
    arrayEqual,
    assembleApiUrl,
    assembleBuffer,
    assembleUrl,
    assertArray,
    assertBuffer,
    assertDate,
    assertEmail,
    assertFunction,
    assertModule,
    assertObject,
    assertSet,
    assertUrl,
    assertUuid,
    asyncTimeout,
    base64Decode,
    base64Encode,
    base64Pack,
    base64Unpack,
    basename,
    byteToHexString,
    call,
    checkChance,
    checkInterval,
    clarify,
    clone,
    convertBase,
    convertFrom16to10,
    countKeys,
    deepCleanBigInt,
    distill,
    ensureArray,
    ensureDate,
    ensureInt,
    ensureLines,
    ensureString,
    escapeHtml,
    exclude,
    extError,
    extract,
    fileURLToPath,
    fullLengthLog,
    getDateByUnixTimestamp,
    getFuncParams,
    getItemFromStringOrArray,
    getKeyByValue,
    getRandomIndexInArray,
    getRandomInt,
    getRandomItemInArray,
    getShortestInArray,
    getTimeIcon,
    getType,
    getUnixTimestampByDate,
    hexDecode,
    hexEncode,
    humanReadableBoolean,
    ignoreErrFunc,
    inBrowser,
    insensitiveCompare,
    insensitiveHas,
    is,
    isAscii,
    isModule,
    isNull,
    isSet,
    isUndefined,
    lastItem,
    lineSplit,
    locate,
    log,
    makeStringByLength,
    mapKeys,
    mask,
    matchVersion,
    mergeAtoB,
    need,
    newError,
    once,
    parseJson,
    parseVersion,
    prettyJson,
    purgeEmoji,
    randomArray,
    range,
    renderBox,
    renderCode,
    renderObject,
    renderText,
    resolve,
    rotate,
    shiftTime,
    split,
    splitArgs,
    supportAnsiColor,
    throwError,
    timeout,
    toExponential,
    toString,
    trim,
    tryUntil,
    uniqueArray,
    verifyEmail,
    verifyPhone,
    verifyUrl,
    verifyUuid,
    voidFunc,
    which,
};