@chzky/reqwest 0.0.1 → 0.1.1

package/script/lib/helper/request/baseConf.js

@@ -2,26 +2,41 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.header = header;
 exports.response_type = response_type;
-const fp_1 = require("@chzky/fp");
+exports.timeout = timeout;
+const core_1 = require("@chzky/core");
 /** ## `header` : 修改请求头数据
-@param header `AxiosRequestHeaders` - 请求头数据
+@param head `AxiosRequestHeaders` - 请求头数据
 @type `Interceptor` - `Request`
-@category `Request`
+@category Helper
  */
-function header(header) {
-    return (conf) => {
-        conf.headers = header;
-        return (0, fp_1.Ok)();
+function header(head) {
+    return conf => {
+        for (const key in head) {
+            if (Object.hasOwn(head, key))
+                conf.headers.set(String(key), head[key]);
+        }
+        return (0, core_1.Ok)();
     };
 }
 /** ## `response_type` : 修改响应数据类型
 @param type `ResponseType` - 响应数据类型
 @type `Interceptor` - `Request`
-@category `Request`
+@category Helper
 */
 function response_type(type) {
-    return (conf) => {
+    return conf => {
         conf.responseType = type;
-        return (0, fp_1.Ok)();
+        return (0, core_1.Ok)();
+    };
+}
+/** ## `timeout` : 修改请求超时时间
+@param time `PositiveInteger<N>` - 请求超时时间
+@type `Interceptor` - `Request`
+@category Helper
+*/
+function timeout(time) {
+    return conf => {
+        conf.timeout = time;
+        return (0, core_1.Ok)();
     };
 }

package/script/lib/helper/request/factors.d.ts

@@ -0,0 +1,31 @@
+import type { Fn, JsonXObject, zod } from '@chzky/core';
+import type { RequestInterceptor } from '../../../mod.js';
+import { CheckingError } from '@chzky/core';
+type Methods = 'get' | 'post' | 'put' | 'delete' | 'form';
+/** ## `restful_request` : `url配置` + `类型校验` + `数据输入`
++ 对于`get`请求 , data传数据到`query`上
++ 对于`post`|`put`|`delete`|`form`请求 , data传数据到`body`上
+@example Usage
+```ts
+// GET请求 - 验证
+const get_user = restful_request('get', '/api/users', z.object({ id: z.number() }))
+get_user({ id: 1 }) // params: { id: 1 }
+
+// POST请求 - 验证
+const create_user = restful_request('post', '/api/users', z.object({ name: z.string() }))
+create_user({ name: 'john' }) // body: { name: 'john' }
+
+// PUT请求 - 无验证
+const update_user = restful_request('put', '/api/users')
+update_user({ name: 'john' }) // body: { name: 'john' }
+
+// 表单请求 - 无验证
+const upload = restful_request('form', '/api/upload')
+upload(new FormData()) // body: FormData
+```
+@type `Interceptor` - `Request`
+@cataegory Factor
+ */
+export declare function restful_request<T extends JsonXObject & Record<string | number, string | Blob> = never>(method: Methods, url: string, validate?: zod.Schema<T>): Fn<T, RequestInterceptor<T extends never ? never : CheckingError>>;
+export {};
+//# sourceMappingURL=factors.d.ts.map

package/script/lib/helper/request/factors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factors.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/factors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,OAAO,EAAE,aAAa,EAAS,MAAM,aAAa,CAAA;AAGlD,KAAK,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;AAGzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC9B,CAAC,SAAS,WAAW,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,KAAK,EAEtE,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GACtB,EAAE,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,aAAa,CAAC,CAAC,CAYpE"}

package/script/lib/helper/request/factors.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.restful_request = restful_request;
+const core_1 = require("@chzky/core");
+const mod_js_1 = require("../../../mod.js");
+const ERROR_MSG = `param checktype must be 'data' or 'params`;
+/** ## `restful_request` : `url配置` + `类型校验` + `数据输入`
++ 对于`get`请求 , data传数据到`query`上
++ 对于`post`|`put`|`delete`|`form`请求 , data传数据到`body`上
+@example Usage
+```ts
+// GET请求 - 验证
+const get_user = restful_request('get', '/api/users', z.object({ id: z.number() }))
+get_user({ id: 1 }) // params: { id: 1 }
+
+// POST请求 - 验证
+const create_user = restful_request('post', '/api/users', z.object({ name: z.string() }))
+create_user({ name: 'john' }) // body: { name: 'john' }
+
+// PUT请求 - 无验证
+const update_user = restful_request('put', '/api/users')
+update_user({ name: 'john' }) // body: { name: 'john' }
+
+// 表单请求 - 无验证
+const upload = restful_request('form', '/api/upload')
+upload(new FormData()) // body: FormData
+```
+@type `Interceptor` - `Request`
+@cataegory Factor
+ */
+function restful_request(method, url, validate) {
+    return ((data) => {
+        const METHOD = (0, core_1.match)(method)
+            .case('delete', mod_js_1.del)
+            .case('get', mod_js_1.get)
+            .case('post', mod_js_1.post)
+            .case('put', mod_js_1.put)
+            .case('form', mod_js_1.form)
+            .done()
+            .expect(core_1.CheckingError.new(ERROR_MSG));
+        return validate ? (0, mod_js_1.merge_request)(METHOD(url, data), (0, mod_js_1.input_validate)(validate)) : METHOD(url, data);
+    });
+}

package/script/lib/helper/request/input.d.ts

@@ -1,11 +1,12 @@
-import { CheckingError, type zod } from '@chzky/fp';
+import type { zod } from '@chzky/core';
 import type { RequestInterceptor } from '../../../mod.js';
-/** ## `input` : 使用`zod`对输入的data数据进行校验
+import { CheckingError } from '@chzky/core';
+/** ## `input_validate` : 使用`zod`对输入的data数据进行解析校验(使用`zod.parse`)
 + 该方法会返回一个`RequestInterceptor`拦截器,如果校验失败会返回`CheckingError`
 @param schema `zod.Schema<unknown>` - 校验规则
 @param [checktype] `'data' | 'params'` - 校验类型,如果是`get`请求则默认为`params`,其他类型的请求默认为`data`,
 @type `Interceptor` - `Request`
-@category `Request`
+@category Helper
 */
-export declare function input(schema: zod.Schema<unknown>, checktype?: 'data' | 'params'): RequestInterceptor<CheckingError>;
+export declare function input_validate(schema: zod.Schema<unknown>, checktype?: 'data' | 'params'): RequestInterceptor<CheckingError>;
 //# sourceMappingURL=input.d.ts.map

package/script/lib/helper/request/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,GAAG,EAAM,MAAM,WAAW,CAAA;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIzD;;;;;;EAME;AACF,wBAAgB,KAAK,CACnB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAC5B,kBAAkB,CAAC,aAAa,CAAC,CAYnC"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,OAAO,EAAE,aAAa,EAAM,MAAM,aAAa,CAAA;AAI/C;;;;;;EAME;AACF,wBAAgB,cAAc,CAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAC3B,kBAAkB,CAAC,aAAa,CAAC,CAYnC"}

package/script/lib/helper/request/input.js

@@ -1,27 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.input = input;
-const fp_1 = require("@chzky/fp");
+exports.input_validate = input_validate;
+const core_1 = require("@chzky/core");
 const ERROR_MSG = `param checktype must be 'data' or 'params'`;
-/** ## `input` : 使用`zod`对输入的data数据进行校验
+/** ## `input_validate` : 使用`zod`对输入的data数据进行解析校验(使用`zod.parse`)
 + 该方法会返回一个`RequestInterceptor`拦截器,如果校验失败会返回`CheckingError`
 @param schema `zod.Schema<unknown>` - 校验规则
 @param [checktype] `'data' | 'params'` - 校验类型,如果是`get`请求则默认为`params`,其他类型的请求默认为`data`,
 @type `Interceptor` - `Request`
-@category `Request`
+@category Helper
 */
-function input(schema, checktype) {
-    return (conf) => {
+function input_validate(schema, checktype) {
+    return conf => {
         conf.timeout;
-        const ct = checktype || conf.method == 'get' ? 'params' : 'data';
+        const ct = checktype || conf.method === 'get' ? 'params' : 'data';
         if (ct !== 'data' && ct !== 'params')
-            return fp_1.CheckingError.err(ERROR_MSG);
+            return core_1.CheckingError.err(ERROR_MSG);
         try {
-            schema.parse(ct == 'data' ? conf.data : conf.params);
-            return (0, fp_1.Ok)();
+            schema.parse(ct === 'data' ? conf.data : conf.params);
+            return (0, core_1.Ok)();
         }
         catch (e) {
-            return fp_1.CheckingError.err(e);
+            return core_1.CheckingError.err(e);
         }
     };
 }

package/script/lib/helper/request/mod.d.ts

@@ -1,4 +1,7 @@
-export * from './RESTful.js';
 export * from './baseConf.js';
+export * from './factors.js';
 export * from './input.js';
+export * from './process.js';
+export * from './RESTful.js';
+export * from './wait.js';
 //# sourceMappingURL=mod.d.ts.map

package/script/lib/helper/request/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/mod.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/mod.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}

package/script/lib/helper/request/mod.js

@@ -14,6 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./RESTful.js"), exports);
-__exportStar(require("./baseConf.js"), exports);
-__exportStar(require("./input.js"), exports);
+__exportStar(require("./baseConf.js"), exports); /* 提供基础配置 */
+__exportStar(require("./factors.js"), exports); /* 请求集合 */
+__exportStar(require("./input.js"), exports); /* 请求参数校验 */
+__exportStar(require("./process.js"), exports); /* 进度 */
+__exportStar(require("./RESTful.js"), exports); /* 提供restful配置 */
+__exportStar(require("./wait.js"), exports); /* 请求等待 */

package/script/lib/helper/request/process.d.ts

@@ -0,0 +1,16 @@
+import { RequestInterceptor } from '../../../mod.js';
+/** ## `upload_process` : 上传进度查询(浏览器专属)
++ 进度只保留两位小数,即`xx.yy%`
++ 存在两种情况,进度不可计算时,返回`-1%`
+  + `event.lengthComputable`为`false` (长度不可计算)
+  + `event.total`为`0`(数据的总大小不可知)
+*/
+export default function upload_process(progress: (percent: number) => void): RequestInterceptor<never>;
+/** ## `download_process` : 下载进度查询(浏览器专属)
++ 进度只保留两位小数,即`xx.yy%`
++ 存在两种情况,进度不可计算时,返回`-1%`
+  + `event.lengthComputable`为`false` (长度不可计算)
+  + `event.total`为`0`(数据的总大小不可知)
+*/
+export declare function download_process(progress: (percent: number) => void): RequestInterceptor<never>;
+//# sourceMappingURL=process.d.ts.map

package/script/lib/helper/request/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/process.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;EAKE;AACF,MAAM,CAAC,OAAO,UAAU,cAAc,CACrC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,kBAAkB,CAAC,KAAK,CAAC,CAS3B;AAED;;;;;EAKE;AACF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAU/F"}

package/script/lib/helper/request/process.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = upload_process;
+exports.download_process = download_process;
+const core_1 = require("@chzky/core");
+/** ## `upload_process` : 上传进度查询(浏览器专属)
++ 进度只保留两位小数,即`xx.yy%`
++ 存在两种情况,进度不可计算时,返回`-1%`
+  + `event.lengthComputable`为`false` (长度不可计算)
+  + `event.total`为`0`(数据的总大小不可知)
+*/
+function upload_process(progress) {
+    return conf => {
+        conf.onUploadProgress = event => {
+            if (event.lengthComputable && event.total) {
+                progress(Number.parseFloat(((event.loaded * 100) / event.total).toFixed(2)));
+            }
+            else
+                progress(-1);
+        };
+        return (0, core_1.Ok)();
+    };
+}
+/** ## `download_process` : 下载进度查询(浏览器专属)
++ 进度只保留两位小数,即`xx.yy%`
++ 存在两种情况,进度不可计算时,返回`-1%`
+  + `event.lengthComputable`为`false` (长度不可计算)
+  + `event.total`为`0`(数据的总大小不可知)
+*/
+function download_process(progress) {
+    return conf => {
+        conf.onDownloadProgress = event => {
+            if (event.lengthComputable && event.total) {
+                progress(Number.parseFloat(((event.loaded * 100) / event.total).toFixed(2)));
+            }
+            else
+                progress(-1);
+        };
+        return (0, core_1.Ok)();
+    };
+}

package/script/lib/helper/request/wait.d.ts

@@ -0,0 +1,9 @@
+import type { PositiveInteger } from '@chzky/core';
+import type { RequestInterceptor } from '../../../mod.js';
+/** ## `wait` : 等待指定时间后继续执行请求
+@param time `PositiveInteger<N>` - The time to wait in milliseconds (must be a positive integer)@type `Interceptor` - `Request`
+@returns A Promise that resolves after the specified time delay
+@category Helper
+ */
+export declare function wait<N extends number>(time: PositiveInteger<N>): RequestInterceptor<never>;
+//# sourceMappingURL=wait.d.ts.map

package/script/lib/helper/request/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/wait.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIzD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAO1F"}

package/script/lib/helper/request/wait.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wait = wait;
+const core_1 = require("@chzky/core");
+/** ## `wait` : 等待指定时间后继续执行请求
+@param time `PositiveInteger<N>` - The time to wait in milliseconds (must be a positive integer)@type `Interceptor` - `Request`
+@returns A Promise that resolves after the specified time delay
+@category Helper
+ */
+function wait(time) {
+    return () => new Promise(res => {
+        setTimeout(() => {
+            res((0, core_1.Ok)());
+        }, time);
+    });
+}

package/script/lib/helper/response/blobToUrl.d.ts

@@ -0,0 +1,11 @@
+import type { ResponseInterceptor } from '../../../mod.js';
+/** ## blob2url : `blob`转化成`url`,赋值在`src`字段上
++ 一般用于
+1. 图片显示
+2. 显示PDF
+@returns [`revoke`:用于取消对`ObjectURL`对象的引用, `interceptor`:拦截器]
+@type `Interceptor` - `Response`
+@category Helper
+*/
+export declare function blob2url(): [() => void, ResponseInterceptor<Blob, string, never>];
+//# sourceMappingURL=blobToUrl.d.ts.map

package/script/lib/helper/response/blobToUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobToUrl.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/response/blobToUrl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAI1D;;;;;;;EAOE;AACF,wBAAgB,QAAQ,IAAI,CAAC,MAAM,IAAI,EAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAWjF"}

package/script/lib/helper/response/blobToUrl.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blob2url = blob2url;
+const core_1 = require("@chzky/core");
+/** ## blob2url : `blob`转化成`url`,赋值在`src`字段上
++ 一般用于
+1. 图片显示
+2. 显示PDF
+@returns [`revoke`:用于取消对`ObjectURL`对象的引用, `interceptor`:拦截器]
+@type `Interceptor` - `Response`
+@category Helper
+*/
+function blob2url() {
+    let object_url;
+    return [
+        () => {
+            if (object_url)
+                URL.revokeObjectURL(object_url);
+        },
+        blob => {
+            object_url = URL.createObjectURL(blob);
+            return (0, core_1.Ok)(object_url);
+        },
+    ];
+}

package/script/lib/helper/response/mod.d.ts

@@ -1,3 +1,5 @@
-export * from './pick.js';
+export * from './blobToUrl.js';
+export * from './openLink.js';
 export * from './output.js';
+export * from './pick.js';
 //# sourceMappingURL=mod.d.ts.map

package/script/lib/helper/response/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/response/mod.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/response/mod.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA"}

package/script/lib/helper/response/mod.js

@@ -14,5 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./pick.js"), exports);
-__exportStar(require("./output.js"), exports);
+__exportStar(require("./blobToUrl.js"), exports); /* blob赋值src */
+__exportStar(require("./openLink.js"), exports); /* blob下载 */
+__exportStar(require("./output.js"), exports); /* 输出校验|输出map */
+__exportStar(require("./pick.js"), exports); /* 字段提取 */

package/script/lib/helper/response/openLink.d.ts

@@ -0,0 +1,8 @@
+import type { ResponseInterceptor } from '../../../mod.js';
+/** ### `open_link` : 将获取到的blob文件直接进行下载
+@tips : 只能在浏览器环境下使用,在非浏览器环境下会直接返回blob
+@type `Interceptor` - `Response`
+@category Helper
+*/
+export declare function open_link(name: string): ResponseInterceptor<Blob, Blob, never>;
+//# sourceMappingURL=openLink.d.ts.map

package/script/lib/helper/response/openLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openLink.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/response/openLink.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAI1D;;;;EAIE;AACF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAY9E"}

package/script/lib/helper/response/openLink.js

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.open_link = open_link;
+const dntShim = __importStar(require("../../../_dnt.shims.js"));
+const core_1 = require("@chzky/core");
+/** ### `open_link` : 将获取到的blob文件直接进行下载
+@tips : 只能在浏览器环境下使用,在非浏览器环境下会直接返回blob
+@type `Interceptor` - `Response`
+@category Helper
+*/
+function open_link(name) {
+    return blob => {
+        var _a;
+        if (typeof dntShim.dntGlobalThis === 'undefined' || !((_a = dntShim.dntGlobalThis) === null || _a === void 0 ? void 0 : _a.document))
+            return (0, core_1.Ok)(blob);
+        // biome-ignore lint/suspicious/noExplicitAny: <>
+        const a = dntShim.dntGlobalThis.document.createElement('a');
+        a.href = URL.createObjectURL(blob);
+        a.download = name;
+        a.click();
+        a.remove();
+        return (0, core_1.Ok)(blob);
+    };
+}

package/script/lib/helper/response/output.d.ts

@@ -1,5 +1,16 @@
+import type { Fn, Result, zod } from '@chzky/core';
 import type { ResponseInterceptor } from '../../../mod.js';
-import { type zod, CheckingError } from '@chzky/fp';
-/** ### `output` : 对输出类型进行类型校验 */
-export declare function output<T>(schema: zod.Schema<T>): ResponseInterceptor<any, zod.infer<typeof schema>, CheckingError>;
+import { CheckingError } from '@chzky/core';
+/** ### `output_validate` : 对输出类型进行类型校验
++ 会自动将放回类型进行校验(使用`zod.parse`)，如果校验失败，则返回 `CheckingError`
+@type `Interceptor` - `Response`
+@category Helper
+*/
+export declare function output_validate<T>(schema: zod.Schema<T>): ResponseInterceptor<unknown, zod.infer<typeof schema>, CheckingError>;
+/** ## `response_map` : 对返回类型进行`map`操作
++ 用于`AxiosResponse`的业务场景映射
++ 用于返回数据映射
+@category ResponseInterceptor
+*/
+export declare function response_map<T, R, E>(fn: Fn<T, Result<R, E>>): ResponseInterceptor<T, R, E>;
 //# sourceMappingURL=output.d.ts.map

package/script/lib/helper/response/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/response/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,KAAK,GAAG,EAAE,aAAa,EAAM,MAAM,WAAW,CAAA;AAEvD,iCAAiC;AACjC,wBAAgB,MAAM,CAAC,CAAC,EACtB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GACpB,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,EAAE,aAAa,CAAC,CAQnE"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/response/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,EAAE,aAAa,EAAM,MAAM,aAAa,CAAA;AAE/C;;;;EAIE;AACF,wBAAgB,eAAe,CAAC,CAAC,EAChC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GACnB,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,EAAE,aAAa,CAAC,CAQvE;AAED;;;;EAIE;AACF,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAE3F"}

package/script/lib/helper/response/output.js

@@ -1,15 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.output = output;
-const fp_1 = require("@chzky/fp");
-/** ### `output` : 对输出类型进行类型校验 */
-function output(schema) {
-    return (response) => {
+exports.output_validate = output_validate;
+exports.response_map = response_map;
+const core_1 = require("@chzky/core");
+/** ### `output_validate` : 对输出类型进行类型校验
++ 会自动将放回类型进行校验(使用`zod.parse`)，如果校验失败，则返回 `CheckingError`
+@type `Interceptor` - `Response`
+@category Helper
+*/
+function output_validate(schema) {
+    return response => {
         try {
-            return (0, fp_1.Ok)(schema.parse(response));
+            return (0, core_1.Ok)(schema.parse(response));
         }
         catch (e) {
-            return fp_1.CheckingError.err(e);
+            return core_1.CheckingError.err(e);
         }
     };
 }
+/** ## `response_map` : 对返回类型进行`map`操作
++ 用于`AxiosResponse`的业务场景映射
++ 用于返回数据映射
+@category ResponseInterceptor
+*/
+function response_map(fn) {
+    return response => fn(response);
+}

package/script/lib/helper/response/pick.d.ts

@@ -1,7 +1,24 @@
 import type { ResponseInterceptor } from '../../../mod.js';
 import type { AxiosResponse } from 'axios';
-/** ### `pick` : 提取data字段
+type AxiosResponseKey = 'data' | 'status' | 'statusText' | 'headers' | 'config' | 'request';
+/** ### `pick` : 提取`Axios`请求返回字段
++ 默认返回`data`字段
 一般来说axios返回的数据是一个AxiosResponse对象,而我们只需要其中的data字段作为业务数据需要的字段
+@example Usage
+```ts
+    const mock_reqwest = Reqwest.new().conf({ baseURL: 'https://jsonplaceholder.typicode.com/todos/' })
+
+    const result = await mock_reqwest
+        .request(get('/1'))
+        .response(pick<{ userId: number; id: number; title: string; completed: boolean }>('data'))
+        .dispatch()
+
+    assert.not(result.unwrap().completed)
+
+```
+@type `Interceptor` - `Response`
+@category Helper
 */
-export declare function pick<T = never>(key?: keyof AxiosResponse): ResponseInterceptor<AxiosResponse, T extends never ? AxiosResponse[typeof key] : T, never>;
+export declare function pick<T = never>(key: AxiosResponseKey): ResponseInterceptor<AxiosResponse, T extends never ? AxiosResponse[typeof key] : T, never>;
+export {};
 //# sourceMappingURL=pick.d.ts.map

package/script/lib/helper/response/pick.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/response/pick.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAG1C;;EAEE;AACF,wBAAgB,IAAI,CAAC,CAAC,GAAG,KAAK,EAC5B,GAAG,GAAE,MAAM,aAAsB,GAChC,mBAAmB,CAAC,aAAa,EAAE,CAAC,SAAS,KAAK,GAAG,aAAa,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAI5F"}
+{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/response/pick.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAI1C,KAAK,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE3F;;;;;;;;;;;;;;;;;EAiBE;AACF,wBAAgB,IAAI,CAAC,CAAC,GAAG,KAAK,EAC7B,GAAG,EAAE,gBAAgB,GACnB,mBAAmB,CAAC,aAAa,EAAE,CAAC,SAAS,KAAK,GAAG,aAAa,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAK5F"}

package/script/lib/helper/response/pick.js

@@ -1,12 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pick = pick;
-const fp_1 = require("@chzky/fp");
-/** ### `pick` : 提取data字段
+const core_1 = require("@chzky/core");
+/** ### `pick` : 提取`Axios`请求返回字段
++ 默认返回`data`字段
 一般来说axios返回的数据是一个AxiosResponse对象,而我们只需要其中的data字段作为业务数据需要的字段
+@example Usage
+```ts
+    const mock_reqwest = Reqwest.new().conf({ baseURL: 'https://jsonplaceholder.typicode.com/todos/' })
+
+    const result = await mock_reqwest
+        .request(get('/1'))
+        .response(pick<{ userId: number; id: number; title: string; completed: boolean }>('data'))
+        .dispatch()
+
+    assert.not(result.unwrap().completed)
+
+```
+@type `Interceptor` - `Response`
+@category Helper
 */
-function pick(key = 'data') {
-    return (response) => {
-        return (0, fp_1.Ok)(response[key]);
+function pick(key) {
+    return response => {
+        if (key in response && Object.hasOwn(response, key))
+            return (0, core_1.Ok)(response[key]);
+        throw new Error(`Key '${key}' does not exist on AxiosResponse`);
     };
 }

package/script/lib/helper/use/mod.js

@@ -14,5 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./useCancel.js"), exports);
-__exportStar(require("./useLoading.js"), exports);
+__exportStar(require("./useCancel.js"), exports); /* 取消控制 */
+__exportStar(require("./useLoading.js"), exports); /* loading控制 */

package/script/lib/helper/use/useCancel.d.ts

@@ -1,4 +1,34 @@
 import type { RequestInterceptor } from '../../../mod.js';
-/** ### `cancel` : 允许取消的请求 */
-export declare function cancel(control?: AbortController): [AbortController, RequestInterceptor<never>];
+import { AbortedError, PromiseOr, Result } from '@chzky/core';
+type CancelInterceptor = [
+    AbortController,
+    {
+        request: RequestInterceptor<AbortedError>;
+        response: <O>(response: O) => PromiseOr<Result<O, AbortedError>>;
+    }
+];
+/** ### `cancel` : 允许取消操作
++ 在请求时取消,会直接取消请求
++ 在响应时取消,会直接丢弃响应值
+@example Usage
+```ts
+    const [abort_controler, interceptor] = cancel()
+
+    const reqwest = mock_reqwest.clone().request(wait(2000), get('/1')).use(interceptor)
+
+    const mock_cause = 'mock abort'
+    abort_controler.abort(mock_cause)
+
+    const result = await reqwest.dispatch()
+
+    const error = result.unwrap_err()
+    assert(error.instance_of(AbortedError))
+    assert.equal(error.cause, mock_cause)
+```
+@returns [ `abort_controler` - 控制取消的`AbortController` , `interceptor` - 拦截器 ]
+@type `Interceptor`
+@category Helper
+ */
+export declare function cancel(control?: AbortController): CancelInterceptor;
+export {};
 //# sourceMappingURL=useCancel.d.ts.map