@zwa73/utils 1.0.224 → 1.0.226

package/dist/mjs/UtilHttp.mjs

@@ -1,475 +0,0 @@
-import http from 'http';
-import https from 'https';
-import { URL } from 'url';
-import { SLogger } from "./UtilLogger.mjs";
-import { UtilFunc } from "./UtilFunctions.mjs";
-import qs from "querystring";
-import FormData from "form-data";
-import HttpProxyAgent from "http-proxy-agent";
-import HttpsProxyAgent from "https-proxy-agent";
-import { PromiseQueue } from "@zwa73/js-utils";
-import fs from "fs";
-import path from "pathe";
-const AcceptTypeList = ["json", "string"];
-const SendTypeList = ["json", "query", "formData", "none"];
-const SendNoneProc = {
-    proc: (opt) => (req) => void req.end()
-};
-const AcceptStringProc = {
-    init: '',
-    reduce: (acc, dat) => acc + dat,
-    parse: (result) => result
-};
-const AcceptNoneProc = {
-    init: undefined,
-    reduce: () => undefined,
-    parse: () => undefined
-};
-/**http请求工具 */
-export class UtilHttp {
-    _data;
-    _send;
-    _accept;
-    constructor(_data, _send, _accept) {
-        this._data = _data;
-        this._send = _send;
-        this._accept = _accept;
-    }
-    //#region 流式创建
-    /**设为https请求 */
-    static https() {
-        return new UtilHttp({ protocol: 'https:' }, SendNoneProc, AcceptStringProc);
-    }
-    /**设为http请求 */
-    static http() {
-        return new UtilHttp({ protocol: 'http:' }, SendNoneProc, AcceptStringProc);
-    }
-    /**从url创建 */
-    static url(urlStr) {
-        const { protocol, hostname, port, pathname } = new URL(urlStr);
-        if (!['http:', 'https:'].includes(protocol))
-            UtilFunc.throwError(`url协议错误: ${urlStr}`);
-        const req = new UtilHttp({ protocol: protocol }, SendNoneProc, AcceptStringProc);
-        return req.option({
-            hostname,
-            path: pathname,
-            port: port ? parseInt(port) : undefined,
-        });
-    }
-    /**设为get方式的请求 */
-    get() {
-        this._data.method = 'GET';
-        return this;
-    }
-    /**设为Post方式的请求 */
-    post() {
-        this._data.method = 'POST';
-        return this;
-    }
-    /**补充参数
-     * 不会检查必要参数完整性
-     * 将会替换对应字段, 修改headers请用header函数
-     */
-    option(option) {
-        this._data = { ...this._data, ...option };
-        return this;
-    }
-    /**完成参数
-     * 会检查必要参数完整性
-     * 将会替换对应字段, 修改headers请用header函数
-     */
-    finalize(option) {
-        this._data = { ...this._data, ...option };
-        return this;
-    }
-    /**补充header */
-    header(headers) {
-        this._data.headers = {
-            ...this._data.headers,
-            ...headers,
-        };
-        return this;
-    }
-    /**设置agent */
-    proxyAgent(url) {
-        this._data.agent = UtilFunc.match(this._data['protocol'], {
-            'http:': () => HttpProxyAgent(url),
-            'https:': () => HttpsProxyAgent(url),
-        });
-        return this;
-    }
-    /**添加一段query */
-    query(data) {
-        this._data.path = UtilHttp.buildQuery(this._data.path ?? '', data);
-        return this;
-    }
-    /**克隆 */
-    clone() {
-        return new UtilHttp({ ...this._data }, this._send, this._accept);
-    }
-    //#endregion
-    //#region 快速预设
-    /**收发皆为json的预设 */
-    json() {
-        return this.sendJson().acceptJson();
-    }
-    /**收发皆为json的post预设 */
-    postJson() {
-        return this.post().json();
-    }
-    /**无查询参数获取json的get预设 */
-    getJson() {
-        return this.get().sendNone().acceptJson();
-    }
-    /**有查询参数获取json的get预设 */
-    queryJson() {
-        return this.get().sendQuery().acceptJson();
-    }
-    /**收发皆为json的https-post预设 */
-    static httpsPostJson() {
-        return UtilHttp.https().postJson();
-    }
-    /**收发皆为json的http-post预设 */
-    static httpPostJson() {
-        return UtilHttp.http().postJson();
-    }
-    /**无查询参数获取json的https-get预设 */
-    static httpsGetJson() {
-        return UtilHttp.https().getJson();
-    }
-    /**有查询参数获取json的https-get预设 */
-    static httpsQueryJson() {
-        return UtilHttp.http().queryJson();
-    }
-    /**无查询参数获取json的http-get预设 */
-    static httpGetJson() {
-        return UtilHttp.http().getJson();
-    }
-    /**有查询参数获取json的http-get预设 */
-    static httpQueryJson() {
-        return UtilHttp.http().queryJson();
-    }
-    //#endregion
-    //#region 接收数据类型
-    /**预设的接收数据类型*/
-    accept(t) {
-        const map = {
-            'json': this.acceptJson(),
-            'string': this.acceptString(),
-            'none': this.acceptNone(),
-        };
-        return map[t];
-    }
-    acceptJson() {
-        const proc = {
-            init: '',
-            reduce: (acc, curr) => acc + curr,
-            parse: (result) => {
-                if (result == undefined) {
-                    SLogger.warn(`json accept 接收反馈错误: 响应结果无效`);
-                    return undefined;
-                }
-                const { data, ...rest } = result;
-                if (data.trim() == "") {
-                    SLogger.warn(`json accept 接收反馈错误: 原始字符串为空`, UtilFunc.stringifyJToken(result, { compress: true, space: 2 }));
-                    return { ...result, raw: "", data: null };
-                }
-                try {
-                    const obj = JSON.parse(data.trim());
-                    SLogger.http(`json accept 接受信息 data:`, UtilFunc.stringifyJToken(obj, { compress: true, space: 2 }), `result:`, UtilFunc.stringifyJToken(rest, { compress: true, space: 2 }));
-                    return { ...rest, data: obj };
-                }
-                catch (e) {
-                    SLogger.warn(`json accept 接收反馈错误:${e}`, UtilFunc.stringifyJToken(result, { compress: true, space: 2 }));
-                    return { ...result, raw: data, data: null };
-                }
-            }
-        };
-        this._accept = proc;
-        return this;
-    }
-    acceptString() {
-        this._accept = AcceptStringProc;
-        return this;
-    }
-    acceptNone() {
-        this._accept = AcceptNoneProc;
-        return this;
-    }
-    /**自定的接收数据类型*/
-    acceptRaw(proc) {
-        this._accept = proc;
-        return this;
-    }
-    //#endregion
-    //#region 发送数据类型
-    /**预设的发送数据类型 */
-    send(t) {
-        const map = {
-            'json': this.sendJson(),
-            'query': this.sendQuery(),
-            'formData': this.sendFormData(),
-            'form': this.sendForm(),
-            'file': this.sendFile(),
-            'none': this.sendNone(),
-        };
-        return map[t];
-    }
-    /**发送json
-     * 请求参数为 (token:JToken)
-     */
-    sendJson() {
-        const proc = {
-            proc: (opt, token) => {
-                const { method } = opt;
-                const isPost = (method == "POST");
-                const data = JSON.stringify(token);
-                this._data.headers ??= {};
-                this._data.headers['Content-Length'] = Buffer.byteLength(data);
-                const procReq = (req) => {
-                    if (isPost)
-                        req.write(data);
-                    req.end();
-                };
-                return procReq;
-            }
-        };
-        this._send = proc;
-        this._data.headers ??= {};
-        this._data.headers['Content-Type'] = 'application/json';
-        return this;
-    }
-    /**利用 appendQuery 直接将数据附加在path上发送请求
-     * 请求参数为 (form:QueryRequestData)
-     */
-    sendQuery() {
-        const proc = {
-            proc: (opt, form) => {
-                opt.path = UtilHttp.buildQuery(opt.path ?? '', form);
-                const procReq = (req) => void req.end();
-                return procReq;
-            }
-        };
-        this._send = proc;
-        return this;
-    }
-    /**发送表单数据
-     * 请求参数为 (formData: FormData)
-     */
-    sendFormData() {
-        const proc = {
-            proc: (opt, formData) => {
-                opt.headers = formData.getHeaders();
-                const procReq = (req) => {
-                    formData.pipe(req);
-                };
-                return procReq;
-            },
-        };
-        this._send = proc;
-        this._data.headers ??= {};
-        this._data.headers['Content-Type'] = 'multipart/form-data';
-        return this;
-    }
-    /**发送表单
-     * 请求参数为 (form:QueryRequestData)
-     */
-    sendForm() {
-        const proc = {
-            proc: (opt, form) => {
-                const { method } = opt;
-                const isPost = (method == "POST");
-                const data = qs.stringify(form);
-                this._data.headers ??= {};
-                this._data.headers['Content-Length'] = Buffer.byteLength(data);
-                const procReq = (req) => {
-                    if (isPost)
-                        req.write(data);
-                    req.end();
-                };
-                return procReq;
-            }
-        };
-        this._send = proc;
-        this._data.headers ??= {};
-        this._data.headers['Content-Type'] = 'application/x-www-form-urlencoded';
-        return this;
-    }
-    /**发送文件
-     * 请求参数为 (filepath:string, filename?: string)
-     */
-    sendFile() {
-        const proc = {
-            proc: (opt, filepath, filename) => {
-                const formData = new FormData();
-                filename = filename ?? path.basename(filepath);
-                formData.append(filename, fs.createReadStream(filepath));
-                opt.headers = formData.getHeaders();
-                const procReq = (req) => {
-                    formData.pipe(req);
-                };
-                return procReq;
-            },
-        };
-        this._send = proc;
-        this._data.headers ??= {};
-        this._data.headers['Content-Type'] = 'multipart/form-data';
-        return this;
-    }
-    sendNone() {
-        this._send = SendNoneProc;
-        return this;
-    }
-    /**自定的发送数据类型 */
-    sendRaw(proc) {
-        this._send = proc;
-        return this;
-    }
-    //#endregion
-    /**发送请求
-     * @param datas  - 数据对象
-     */
-    async once(...datas) {
-        const fullopt = this._data;
-        const proc = await this._send.proc(fullopt, ...datas);
-        const { reduce, init, parse } = this._accept;
-        const res = await UtilHttp.request(fullopt, proc, reduce, init);
-        return parse(res);
-    }
-    /**重复发送网络请求
-     * @param verify  - 有效性验证函数
-     * @param retries - 重试选项 默认 延迟:1000ms 间隔:180_000ms 重试:3次
-     * @param datas   - 数据对象
-     */
-    async retry(opt, ...datas) {
-        let { retries, verify } = opt;
-        retries ??= {};
-        retries.tryDelay = retries.tryDelay ?? 1000;
-        const procFn = async () => this.once(...datas);
-        return UtilFunc.retryPromise(procFn, verify, retries);
-    }
-    /**发送网络请求
-     * @param option  - 网络请求选项
-     * @param proc    - 请求处理函数 需调用req.end()
-     * @param reduce  - 数据处理函数
-     * @param init    - 初始数据
-     */
-    static async request(option, proc, reduce, init) {
-        const { protocol, timeout, ...baseReqOpt } = option;
-        const hasTimeLimit = (timeout ? timeout >= 10_000 : false);
-        const flagName = `UtilCom.request ${protocol}${baseReqOpt.method} ${UtilFunc.genUUID()}`;
-        const reduceQueue = new PromiseQueue();
-        let dataPromise = null;
-        return new Promise(async (resolve, rejecte) => {
-            const resFunc = (res) => {
-                try {
-                    //请求超时
-                    if (hasTimeLimit) {
-                        res.setTimeout(timeout, () => {
-                            SLogger.warn(`${flagName} 接收反馈超时: ${timeout} ms`);
-                            res.destroy();
-                        });
-                    }
-                    let mergedata = init;
-                    res.setEncoding(option.responseEncode ?? 'utf8');
-                    res.on('data', chunk => {
-                        dataPromise = reduceQueue
-                            .enqueue(async () => mergedata = await reduce(mergedata, chunk))
-                            .catch(e => {
-                            SLogger.error(`${flagName} reduce函数错误:${e}\nchunk:${chunk}\nmergedata:`, mergedata);
-                            resolve(undefined);
-                        });
-                    });
-                    res.on('error', e => {
-                        SLogger.warn(`${flagName} 接收反馈错误:${e}`);
-                        resolve(undefined);
-                    });
-                    res.on('end', async () => {
-                        await dataPromise;
-                        resolve({
-                            headers: res.headers,
-                            statusCode: res.statusCode,
-                            data: mergedata,
-                        });
-                    });
-                }
-                catch (err) {
-                    SLogger.warn(`${flagName} 未知错误:${err}`);
-                    resolve(undefined);
-                    return;
-                }
-            };
-            //路由 http/https
-            const req = protocol == "https:"
-                ? https.request(baseReqOpt, resFunc)
-                : http.request(baseReqOpt, resFunc);
-            //请求超时
-            if (hasTimeLimit) {
-                req.setTimeout(timeout, () => {
-                    SLogger.warn(`${flagName} 发送请求超时: ${timeout} ms`);
-                    req.destroy();
-                });
-            }
-            req.on('error', e => {
-                SLogger.warn(`${flagName} 发送请求错误:${e}`);
-                resolve(undefined);
-            });
-            try {
-                await proc(req);
-            }
-            catch (e) {
-                SLogger.error(`${flagName} proc函数错误:${e}`);
-                resolve(undefined);
-            }
-        });
-    }
-    /**构建query */
-    static buildQuery(base, data) {
-        const queryString = qs.stringify(data);
-        if (queryString) {
-            // 检查当前路径是否已经包含问号
-            const separator = base.includes('?') ? '&' : '?';
-            base += separator + queryString;
-        }
-        return base;
-    }
-}
-if (false)
-    void ((async () => {
-        const tool = UtilHttp
-            .url('https://httpbin.org/post')
-            .post()
-            .finalize({ timeout: 10000 });
-        //json
-        const sj = await tool.clone()
-            .sendJson()
-            .acceptJson()
-            .once({ test: 1 });
-        console.log(sj);
-        //form
-        const sf = await tool.clone()
-            .sendForm()
-            .acceptJson()
-            .once({ test: 1 });
-        console.log(sf);
-        //query
-        const sq = await tool.clone()
-            .sendQuery()
-            .acceptJson()
-            .once({ test: 1 });
-        console.log(sq);
-        const filepath = path.join(`${process.platform === 'win32' ? '' : '/'}${/file:\/{2,3}(.+)\/[^/]/.exec(import.meta.url)[1]}`, '..', 'input.wav');
-        //formData
-        //const form = new FormData();
-        //form.append('name', 'input.wav');
-        //form.append('file', fs.createReadStream(path.join(`${process.platform === 'win32' ? '' : '/'}${/file:\/{2,3}(.+)\/[^/]/.exec(import.meta.url)[1]}`,'..','input.wav')));
-        //const sfd = await tool.clone()
-        //    .sendFormData()
-        //    .acceptJson()
-        //    .once(form);
-        const sfile = await tool.clone()
-            .sendFile()
-            .acceptJson()
-            .once(filepath);
-        console.log(sfile);
-    })());

package/dist/mjs/UtilI18n.mjs

@@ -1,206 +0,0 @@
-import { UtilFT } from "./UtilFileTools.mjs";
-import { UtilFunc } from "./UtilFunctions.mjs";
-import { SLogger } from "./UtilLogger.mjs";
-import path from 'pathe';
-/**语言:地区 表 */
-const I18nFlagTable = {
-    "zh": ["CN", "TW"],
-    "en": ["US"]
-};
-/**语言标签列表 */
-const LangFlagList = Object.entries(I18nFlagTable)
-    .map(([k, v]) => `${k}-${v}`)
-    .concat(Object.keys(I18nFlagTable));
-const parseLangFlag = (lf) => {
-    const match = lf.match(/^([^-]+)(.+)/);
-    return { 1: match[1], 2: match[2] != '' ? match[2] : undefined };
-};
-const MarkRegex = /%([^%]+)%$/;
-const BaseFile = 'base_lang.json';
-const TemplateFile = 'template.json';
-const LangDir = 'lang';
-/**运行时I18n工具
- * 需先调用 init初始化
- */
-export class SI18n {
-    static _table;
-    static _lang;
-    static _dataDir;
-    static _vaildLang;
-    /**解析i18n索引 */
-    static parseI18nKey(i18nKey) {
-        const match = i18nKey.match(/([\s\S]+?)((?<!\\)%[^%]+(?<!\\)%$)?$/);
-        const base = match[1];
-        const mark = match[2] == '' || match[2] == undefined
-            ? undefined
-            : match[2].match(/^%([^%]+)%$/)[1];
-        return { base, mark };
-    }
-    /**格式化文本与mark为i18n索引key */
-    static formatI18nKey(str, mark) {
-        return str + (mark == undefined ? '' : SI18n.mark(mark));
-    }
-    /**特殊标记
-     * 若添加在文本末尾则不会作为原文文本显示, 仅供索引
-     * @param mk - 特殊标记文本
-     */
-    static mark(mk) {
-        return `%${mk}%`;
-    }
-    /**初始化函数，加载国际化数据，设置语言，并在进程退出前保存数据。
-     * @param i18nDataDir - 国际化数据的路径。
-     * @param lang        - 要设置的语言。
-     */
-    static async init(i18nDataDir, lang = '*') {
-        const date = new Date().toISOString();
-        const mergePath = path.join(i18nDataDir, BaseFile);
-        const table = await UtilFT.loadJSONFile(mergePath, { default: {
-                base_lang: 'zh-CN',
-                texts: [],
-            } });
-        const { texts, ...rest } = table;
-        SI18n._table = {
-            ...rest,
-            text_table: texts.reduce((acc, cur) => ({ ...acc, [SI18n.formatI18nKey(cur.original, cur.mark)]: { ...cur, lang_table: {} } }), {}),
-        };
-        SI18n._vaildLang = ['template'];
-        //覆盖入单语言文件
-        const singleDir = path.join(i18nDataDir, LangDir);
-        (await Promise.all((await UtilFT.fileSearchGlob(singleDir, `**/${parseLangFlag(lang)[1]}*.json`))
-            .map(async (p) => await UtilFT.loadJSONFile(p))))
-            .forEach(t => {
-            SI18n._vaildLang?.push(t.target_lang);
-            return Object.entries(t.translate_table)
-                .forEach(([k, v]) => {
-                if (v == null)
-                    return;
-                const ttable = SI18n._table.text_table;
-                ttable[k] ??= {
-                    original: k,
-                    scan_time: date,
-                    source: 'Runtime',
-                    lang_table: {}
-                };
-                const ltable = ttable[k].lang_table;
-                ltable[t.target_lang] ??= v;
-            });
-        });
-        if (lang != undefined && lang != '*' && !SI18n._vaildLang.includes(lang))
-            SI18n._vaildLang.push(lang);
-        SI18n._lang = lang == "*" ? undefined : lang;
-        SI18n._dataDir = i18nDataDir;
-    }
-    static t(strings, ...values) {
-        if (typeof strings == 'string') {
-            const mark = values.length >= 1 ? SI18n.mark(values[0]) : '';
-            return SI18n.getI18n(strings.replace(/%/g, '\\%') + mark, SI18n._lang)
-                .replace(/\\%/g, '%');
-        }
-        let i18nKey = ``;
-        const vakyeKeys = values.map((v, i) => `%${i}`);
-        for (let i = 0; i < values.length; i++)
-            i18nKey += strings[i].replace(/%/g, '\\%') + vakyeKeys[i];
-        i18nKey += strings[strings.length - 1];
-        //检查是否为mark
-        if (MarkRegex.test(String(values[values.length - 1])) && strings[strings.length - 1] == '')
-            i18nKey = i18nKey.replace(vakyeKeys[vakyeKeys.length - 1], '') + String(values[values.length - 1]);
-        //console.log(1,i18nKey)
-        let trans = SI18n.getI18n(i18nKey, SI18n._lang);
-        //console.log(2,trans)
-        vakyeKeys.forEach((k, i) => trans = trans.replace(new RegExp(`((?<!\\\\)${k})`), String(values[i])));
-        //console.log(3,trans)
-        return trans.replace(/\\%/g, '%');
-    }
-    /**根据提供的键和语言，返回对应的国际化字符串。
-     * 如果没有找到对应的字符串，将会抛出错误。
-     * @param key  - 要查找的键。
-     * @param lang - 要查找的语言。
-     * @returns 对应的国际化字符串。
-     */
-    static getI18n(key, lang) {
-        if (SI18n._table == undefined)
-            return UtilFunc.throwError('SI18n 未初始化');
-        let obj = SI18n._table.text_table[key];
-        if (obj == undefined) {
-            SLogger.warn(`SI18n 未在 ${SI18n._dataDir} 找到 ${key} 对应的数据, 已自动添加`);
-            const p = SI18n.parseI18nKey(key);
-            obj = SI18n.addOriginalText({
-                original: p.base,
-                scan_time: new Date().toISOString(),
-                lang_table: {},
-                mark: p.mark,
-                source: 'Runtime'
-            });
-        }
-        if (lang == undefined)
-            return obj.original;
-        if (obj.invalid === true)
-            return obj.original;
-        return SI18n.tryAndRollback(lang, obj);
-    }
-    /**尝试获取指定语言的翻译，如果没有找到，将回滚到其他可用的语言。
-     * @param lang - 要查找的语言。
-     * @param dat  - 包含翻译的数据对象。
-     * @returns 找到的翻译，如果没有找到，将返回原始字符串。
-     */
-    static tryAndRollback(lang, dat) {
-        const langTable = {
-            [SI18n._table.base_lang]: dat.original,
-            ...dat.lang_table
-        };
-        if (langTable[lang] != undefined)
-            return langTable[lang];
-        const l1 = lang.match(/^([^-]+)/)[1];
-        const rb = Object.entries(langTable).find(([k, v]) => k.includes(l1));
-        if (rb)
-            return rb[1];
-        return dat.original;
-    }
-    /**覆盖性的添加一处原文 */
-    static addOriginalText(dat) {
-        const key = SI18n.formatI18nKey(dat.original, dat.mark);
-        SI18n._table.text_table[key] = dat;
-        return SI18n._table.text_table[key];
-    }
-    /**保存数据 */
-    static async saveTable() {
-        const { text_table, ...rest } = SI18n._table;
-        const date = new Date().toISOString();
-        //console.log(text_table)
-        //保存原始文本数据
-        const tb = {
-            ...rest,
-            texts: Object.values(text_table).map((d) => {
-                const { lang_table, ...rest } = d;
-                return rest;
-            })
-        };
-        const mergePath = path.join(SI18n._dataDir, BaseFile);
-        await UtilFT.writeJSONFile(mergePath, tb);
-        //保存所有语言数据
-        const tbMap = {};
-        Object.values(text_table).forEach(d => {
-            if (d.invalid === true)
-                return;
-            SI18n._vaildLang?.forEach((vl) => {
-                const lf = vl;
-                tbMap[lf] ??= {
-                    base_lang: rest.base_lang,
-                    modify_time: date,
-                    target_lang: lf,
-                    translate_table: {}
-                };
-                const v = d.lang_table[lf];
-                tbMap[lf].translate_table[SI18n.formatI18nKey(d.original, d.mark)] = v ?? null;
-            });
-        });
-        await Promise.all(Object.values(tbMap).map(async (t) => {
-            if (t.target_lang == 'template') {
-                const tmppath = path.join(SI18n._dataDir, TemplateFile);
-                return await UtilFT.writeJSONFile(tmppath, t);
-            }
-            const singlePath = path.join(SI18n._dataDir, LangDir, t.target_lang);
-            return await UtilFT.writeJSONFile(singlePath, t);
-        }));
-    }
-}

package/dist/mjs/UtilInterfaces.mjs

@@ -1,2 +0,0 @@
-export {};
-//#endregion