@zwa73/utils 1.0.218 → 1.0.219

package/dist/UtilClass.d.ts

@@ -1 +1 @@
-export { Piper, Stream, Hbs, BridgeInterface, Bridge, SmartCache, DListMiddleNode, DLinkedList, PromoseQueueOption, PromiseQueue } from "@zwa73/js-utils";
+export { BridgeInterface, Bridge, Hbs, DListMiddleNode, DListHeadNode, DListTailNode, DListNode, DListMaybeNode, DLinkedList, Piper, PromoseQueueOption, PromiseQueue, SmartCache, Stream } from "@zwa73/js-utils";

package/dist/UtilClass.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PromiseQueue = exports.DLinkedList = exports.SmartCache = exports.Bridge = exports.Hbs = exports.Stream = exports.Piper = void 0;
+exports.Stream = exports.SmartCache = exports.PromiseQueue = exports.Piper = exports.DLinkedList = exports.Hbs = exports.Bridge = void 0;
 //#region UtilClass转导
 var js_utils_1 = require("@zwa73/js-utils");
-Object.defineProperty(exports, "Piper", { enumerable: true, get: function () { return js_utils_1.Piper; } });
-Object.defineProperty(exports, "Stream", { enumerable: true, get: function () { return js_utils_1.Stream; } });
-Object.defineProperty(exports, "Hbs", { enumerable: true, get: function () { return js_utils_1.Hbs; } });
 Object.defineProperty(exports, "Bridge", { enumerable: true, get: function () { return js_utils_1.Bridge; } });
-Object.defineProperty(exports, "SmartCache", { enumerable: true, get: function () { return js_utils_1.SmartCache; } });
+Object.defineProperty(exports, "Hbs", { enumerable: true, get: function () { return js_utils_1.Hbs; } });
 Object.defineProperty(exports, "DLinkedList", { enumerable: true, get: function () { return js_utils_1.DLinkedList; } });
+Object.defineProperty(exports, "Piper", { enumerable: true, get: function () { return js_utils_1.Piper; } });
 Object.defineProperty(exports, "PromiseQueue", { enumerable: true, get: function () { return js_utils_1.PromiseQueue; } });
+Object.defineProperty(exports, "SmartCache", { enumerable: true, get: function () { return js_utils_1.SmartCache; } });
+Object.defineProperty(exports, "Stream", { enumerable: true, get: function () { return js_utils_1.Stream; } });
 //#endregion

package/dist/{UtilCom.d.ts → UtilHttp.d.ts}

@@ -2,6 +2,7 @@ import { AnyString, JToken, MPromise, PartialOption, StatusVerifyFn } from "./Ut
 import http from 'http';
 import { PromiseRetries } from "./UtilFunctions";
 import FormData from "form-data";
+import { RequiredOnly } from "@zwa73/js-utils";
 /**网络请求返回值 */
 export type RequestResult<T> = {
     /**响应头 */
@@ -64,48 +65,64 @@ declare const AcceptNoneProc: AcceptProc<undefined, undefined>;
 type SendParams<P extends SendProc<any>> = P extends SendProc<infer T> ? T : never;
 /**accept处理的结果 */
 type ParseResult<P extends AcceptProc<any, any>> = P extends AcceptProc<any, infer T> ? Awaited<T> : never;
-/**网络请求工具 */
-export declare class UtilCom<D extends Partial<RequestOption> & Required<Pick<RequestOption, 'protocol'>>, S extends SendProc<any>, A extends AcceptProc<any, any>> {
+/**http请求工具 */
+export declare class UtilHttp<D extends Partial<RequestOption> & Required<Pick<RequestOption, 'protocol'>>, S extends SendProc<any>, A extends AcceptProc<any, any>> {
     private _data;
     private _send;
     private _accept;
     private constructor();
     /**设为https请求 */
-    static https(): UtilCom<{
+    static https(): UtilHttp<{
         readonly protocol: "https:";
     }, SendProc<[]>, AcceptProc<string, RequestResult<string> | undefined>>;
     /**设为http请求 */
-    static http(): UtilCom<{
+    static http(): UtilHttp<{
         readonly protocol: "http:";
     }, SendProc<[]>, AcceptProc<string, RequestResult<string> | undefined>>;
+    /**从url创建 */
+    static url(urlStr: `${'http:' | 'https:'}//${string}`): UtilHttp<{
+        protocol: "http:" | "https:";
+    } & {
+        hostname: string;
+        path: string;
+        port: number | undefined;
+    }, SendProc<[]>, AcceptProc<string, RequestResult<string> | undefined>>;
     /**设为get方式的请求 */
-    get(): UtilCom<D & {
+    get(): UtilHttp<D & {
         method: "GET";
     }, S, A>;
     /**设为Post方式的请求 */
-    post(): UtilCom<D & {
+    post(): UtilHttp<D & {
         method: "POST";
     }, S, A>;
     /**补充参数
+     * 不会检查必要参数完整性
+     * 将会替换对应字段, 修改headers请用header函数
+     */
+    option<OPT extends Partial<RequestOption>>(option: OPT): UtilHttp<D & OPT, S, A>;
+    /**完成参数
+     * 会检查必要参数完整性
      * 将会替换对应字段, 修改headers请用header函数
      */
-    option<OPT extends Partial<RequestOption>>(option: OPT): UtilCom<D & OPT, S, A>;
+    finalize<OPT extends PartialOption<RequestOption, D>>(option: OPT): UtilHttp<D & OPT, S, A>;
     /**补充header */
-    header<HAD extends http.OutgoingHttpHeaders>(headers: HAD): UtilCom<D & {
+    header<HAD extends http.OutgoingHttpHeaders>(headers: HAD): UtilHttp<D & {
         headers: HAD;
     }, S, A>;
     /**设置agent */
     proxyAgent(url: string): this;
     /**添加一段query */
     query(data: QueryRequestData): this;
+    /**克隆 */
+    clone(): UtilHttp<D, S, A>;
     /**收发皆为json的预设 */
-    json(): UtilCom<D & {
+    json(): UtilHttp<D & {
         headers: {
             "Content-Type": "application/json";
         };
     }, SendProc<[JToken]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**收发皆为json的post预设 */
-    postJson(): UtilCom<D & {
+    postJson(): UtilHttp<D & {
         method: "POST";
     } & {
         headers: {
@@ -113,15 +130,15 @@ export declare class UtilCom<D extends Partial<RequestOption> & Required<Pick<Re
         };
     }, SendProc<[JToken]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**无查询参数获取json的get预设 */
-    getJson(): UtilCom<D & {
+    getJson(): UtilHttp<D & {
         method: "GET";
     }, SendProc<[]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**有查询参数获取json的get预设 */
-    queryJson(): UtilCom<D & {
+    queryJson(): UtilHttp<D & {
         method: "GET";
     }, SendProc<[QueryRequestData]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**收发皆为json的https-post预设 */
-    static httpsPostJson(): UtilCom<{
+    static httpsPostJson(): UtilHttp<{
         readonly protocol: "https:";
     } & {
         method: "POST";
@@ -131,7 +148,7 @@ export declare class UtilCom<D extends Partial<RequestOption> & Required<Pick<Re
         };
     }, SendProc<[JToken]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**收发皆为json的http-post预设 */
-    static httpPostJson(): UtilCom<{
+    static httpPostJson(): UtilHttp<{
         readonly protocol: "http:";
     } & {
         method: "POST";
@@ -141,76 +158,75 @@ export declare class UtilCom<D extends Partial<RequestOption> & Required<Pick<Re
         };
     }, SendProc<[JToken]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**无查询参数获取json的https-get预设 */
-    static httpsGetJson(): UtilCom<{
+    static httpsGetJson(): UtilHttp<{
         readonly protocol: "https:";
     } & {
         method: "GET";
     }, SendProc<[]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**有查询参数获取json的https-get预设 */
-    static httpsQueryJson(): UtilCom<{
+    static httpsQueryJson(): UtilHttp<{
         readonly protocol: "http:";
     } & {
         method: "GET";
     }, SendProc<[QueryRequestData]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**无查询参数获取json的http-get预设 */
-    static httpGetJson(): UtilCom<{
+    static httpGetJson(): UtilHttp<{
         readonly protocol: "http:";
     } & {
         method: "GET";
     }, SendProc<[]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**有查询参数获取json的http-get预设 */
-    static httpQueryJson(): UtilCom<{
+    static httpQueryJson(): UtilHttp<{
         readonly protocol: "http:";
     } & {
         method: "GET";
     }, SendProc<[QueryRequestData]>, AcceptProc<string, RequestResult<JToken> | undefined>>;
     /**预设的接收数据类型*/
     accept<T extends AcceptType>(t: T): {
-        readonly json: UtilCom<D, S, AcceptProc<string, RequestResult<JToken> | undefined>>;
-        readonly string: UtilCom<D, S, AcceptProc<string, RequestResult<string> | undefined>>;
-        readonly none: UtilCom<D, S, AcceptProc<undefined, undefined>>;
+        readonly json: UtilHttp<D, S, AcceptProc<string, RequestResult<JToken> | undefined>>;
+        readonly string: UtilHttp<D, S, AcceptProc<string, RequestResult<string> | undefined>>;
+        readonly none: UtilHttp<D, S, AcceptProc<undefined, undefined>>;
     }[T];
-    acceptJson(): UtilCom<D, S, AcceptProc<string, RequestResult<JToken> | undefined>>;
-    acceptString(): UtilCom<D, S, typeof AcceptStringProc>;
-    acceptNone(): UtilCom<D, S, typeof AcceptNoneProc>;
+    acceptJson(): UtilHttp<D, S, AcceptProc<string, RequestResult<JToken> | undefined>>;
+    acceptString(): UtilHttp<D, S, typeof AcceptStringProc>;
+    acceptNone(): UtilHttp<D, S, typeof AcceptNoneProc>;
     /**自定的接收数据类型*/
-    acceptRaw<AD, AT>(proc: AcceptProc<AD, AT>): UtilCom<D, S, typeof proc>;
+    acceptRaw<AD, AT>(proc: AcceptProc<AD, AT>): UtilHttp<D, S, typeof proc>;
     /**预设的发送数据类型*/
     send<T extends SendType>(t: T): {
-        readonly json: UtilCom<D & {
+        readonly json: UtilHttp<D & {
             headers: {
                 "Content-Type": "application/json";
             };
         }, SendProc<[JToken]>, A>;
-        readonly query: UtilCom<D, SendProc<[QueryRequestData]>, A>;
-        readonly formData: UtilCom<D & {
+        readonly query: UtilHttp<D, SendProc<[QueryRequestData]>, A>;
+        readonly formData: UtilHttp<D & {
             headers: {
                 "Content-Type": "multipart/form-data";
             };
         }, SendProc<[FormData]>, A>;
-        readonly none: UtilCom<D, SendProc<[]>, A>;
+        readonly none: UtilHttp<D, SendProc<[]>, A>;
     }[T];
     /**利用 req.write 发送一段json */
-    sendJson(): UtilCom<D & {
+    sendJson(): UtilHttp<D & {
         headers: {
             "Content-Type": "application/json";
         };
     }, SendProc<[JToken]>, A>;
     /**利用 appendQuery 直接将数据附加在path上发送请求 */
-    sendQuery(): UtilCom<D, SendProc<[QueryRequestData]>, A>;
-    sendFormData(): UtilCom<D & {
+    sendQuery(): UtilHttp<D, SendProc<[QueryRequestData]>, A>;
+    sendFormData(): UtilHttp<D & {
         headers: {
             "Content-Type": "multipart/form-data";
         };
     }, SendProc<[FormData]>, A>;
-    sendNone(): UtilCom<D, typeof SendNoneProc, A>;
+    sendNone(): UtilHttp<D, typeof SendNoneProc, A>;
     /**自定的发送数据类型*/
-    sendRaw<T extends any[]>(proc: SendProc<T>): UtilCom<D, typeof proc, A>;
+    sendRaw<T extends any[]>(proc: SendProc<T>): UtilHttp<D, typeof proc, A>;
     /**发送请求
-     * @param option - 网络请求选项
      * @param datas  - 数据对象
      */
-    once(option: PartialOption<RequestOption, D>, ...datas: SendParams<S>): Promise<ParseResult<A>>;
+    once(...datas: {} extends RequiredOnly<PartialOption<RequestOption, D>> ? SendParams<S> : [Error & "RequestOption不完整, 请使用 finalize 完成必要项"]): Promise<ParseResult<A>>;
     /**重复发送网络请求
      * @param option  - 网络请求选项
      * @param verify  - 有效性验证函数
@@ -218,10 +234,9 @@ export declare class UtilCom<D extends Partial<RequestOption> & Required<Pick<Re
      * @param datas   - 数据对象
      */
     retry(opt: {
-        option: PartialOption<RequestOption, D>;
         verify?: StatusVerifyFn<ParseResult<A>>;
         retries?: PromiseRetries;
-    }, ...datas: SendParams<S>): Promise<import("@zwa73/js-utils").PromiseRetryResult<ParseResult<A>>>;
+    }, ...datas: {} extends RequiredOnly<PartialOption<RequestOption, D>> ? SendParams<S> : [Error & "RequestOption不完整, 请使用 finalize 完成必要项"]): Promise<import("@zwa73/js-utils").PromiseRetryResult<ParseResult<A>>>;
     /**发送网络请求
      * @param option  - 网络请求选项
      * @param proc    - 请求处理函数 需调用req.end()

package/dist/{UtilCom.js → UtilHttp.js}

@@ -3,9 +3,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UtilCom = void 0;
+exports.UtilHttp = void 0;
 const http_1 = __importDefault(require("http"));
 const https_1 = __importDefault(require("https"));
+const url_1 = require("url");
 const UtilLogger_1 = require("./UtilLogger");
 const UtilFunctions_1 = require("./UtilFunctions");
 const querystring_1 = __importDefault(require("querystring"));
@@ -27,8 +28,8 @@ const AcceptNoneProc = {
     reduce: () => undefined,
     parse: () => undefined
 };
-/**网络请求工具 */
-class UtilCom {
+/**http请求工具 */
+class UtilHttp {
     _data;
     _send;
     _accept;
@@ -40,11 +41,23 @@ class UtilCom {
     //#region 流式创建
     /**设为https请求 */
     static https() {
-        return new UtilCom({ protocol: 'https:' }, SendNoneProc, AcceptStringProc);
+        return new UtilHttp({ protocol: 'https:' }, SendNoneProc, AcceptStringProc);
     }
     /**设为http请求 */
     static http() {
-        return new UtilCom({ protocol: 'http:' }, SendNoneProc, AcceptStringProc);
+        return new UtilHttp({ protocol: 'http:' }, SendNoneProc, AcceptStringProc);
+    }
+    /**从url创建 */
+    static url(urlStr) {
+        const { protocol, hostname, port, pathname } = new url_1.URL(urlStr);
+        if (!['http:', 'https:'].includes(protocol))
+            UtilFunctions_1.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() {
@@ -57,12 +70,21 @@ class UtilCom {
         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 = {
@@ -81,9 +103,13 @@ class UtilCom {
     }
     /**添加一段query */
     query(data) {
-        this._data.path = UtilCom.buildQuery(this._data.path ?? '', 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的预设 */
@@ -104,27 +130,27 @@ class UtilCom {
     }
     /**收发皆为json的https-post预设 */
     static httpsPostJson() {
-        return UtilCom.https().postJson();
+        return UtilHttp.https().postJson();
     }
     /**收发皆为json的http-post预设 */
     static httpPostJson() {
-        return UtilCom.http().postJson();
+        return UtilHttp.http().postJson();
     }
     /**无查询参数获取json的https-get预设 */
     static httpsGetJson() {
-        return UtilCom.https().getJson();
+        return UtilHttp.https().getJson();
     }
     /**有查询参数获取json的https-get预设 */
     static httpsQueryJson() {
-        return UtilCom.http().queryJson();
+        return UtilHttp.http().queryJson();
     }
     /**无查询参数获取json的http-get预设 */
     static httpGetJson() {
-        return UtilCom.http().getJson();
+        return UtilHttp.http().getJson();
     }
     /**有查询参数获取json的http-get预设 */
     static httpQueryJson() {
-        return UtilCom.http().queryJson();
+        return UtilHttp.http().queryJson();
     }
     //#endregion
     //#region 接收数据类型
@@ -215,7 +241,7 @@ class UtilCom {
     sendQuery() {
         const proc = {
             proc: (opt, reqData) => {
-                opt.path = UtilCom.buildQuery(opt.path ?? '', reqData);
+                opt.path = UtilHttp.buildQuery(opt.path ?? '', reqData);
                 const procReq = (req) => void req.end();
                 return procReq;
             }
@@ -250,14 +276,13 @@ class UtilCom {
     }
     //#endregion
     /**发送请求
-     * @param option - 网络请求选项
      * @param datas  - 数据对象
      */
-    async once(option, ...datas) {
-        const fullopt = Object.assign({}, this._data, option);
+    async once(...datas) {
+        const fullopt = this._data;
         const proc = await this._send.proc(fullopt, ...datas);
         const { reduce, init, parse } = this._accept;
-        const res = await UtilCom.request(fullopt, proc, reduce, init);
+        const res = await UtilHttp.request(fullopt, proc, reduce, init);
         return parse(res);
     }
     /**重复发送网络请求
@@ -267,10 +292,10 @@ class UtilCom {
      * @param datas   - 数据对象
      */
     async retry(opt, ...datas) {
-        let { option, retries, verify } = opt;
+        let { retries, verify } = opt;
         retries ??= {};
         retries.tryDelay = retries.tryDelay ?? 1000;
-        const procFn = async () => this.once(option, ...datas);
+        const procFn = async () => this.once(...datas);
         return UtilFunctions_1.UtilFunc.retryPromise(procFn, verify, retries);
     }
     /**发送网络请求
@@ -359,14 +384,13 @@ class UtilCom {
         return base;
     }
 }
-exports.UtilCom = UtilCom;
+exports.UtilHttp = UtilHttp;
 if (false)
     void ((async () => {
-        const t = await UtilCom.https().postJson()
-            .once({
-            hostname: 'httpbin.org',
-            path: '/post',
-            timeout: 10000
-        }, { test: 1 });
+        const t = await UtilHttp
+            .url('https://httpbin.org/post')
+            .postJson()
+            .finalize({ timeout: 10000 })
+            .once({ test: 1 });
         console.log(t);
     })());

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export * from './UtilFunctions';
 export * from './UtilInterfaces';
 export * from './UtilSymbol';
 export * from './UtilClass';
-export * from './UtilCom';
+export * from './UtilHttp';
 export * from './UtilCodecs';
 export * from './UtilDecorators';
 export * from './UtilFileTools';

package/dist/index.js

@@ -35,7 +35,7 @@ __exportStar(require("./UtilFunctions"), exports);
 __exportStar(require("./UtilInterfaces"), exports);
 __exportStar(require("./UtilSymbol"), exports);
 __exportStar(require("./UtilClass"), exports);
-__exportStar(require("./UtilCom"), exports);
+__exportStar(require("./UtilHttp"), exports);
 __exportStar(require("./UtilCodecs"), exports);
 __exportStar(require("./UtilDecorators"), exports);
 __exportStar(require("./UtilFileTools"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zwa73/utils",
-	"version": "1.0.218",
+	"version": "1.0.219",
 	"description": "my utils",
 	"main": "index.js",
 	"scripts": {