@chzky/reqwest 0.0.1 → 0.1.1

package/script/lib/core/interface.d.ts

@@ -0,0 +1,172 @@
+import type { AsyncResult, Copy, Fn, PromiseOr, Result, rjx_ws, UnexpectedError, zod } from '@chzky/core';
+import type { AxiosResponse, CreateAxiosDefaults, InternalAxiosRequestConfig } from 'axios';
+type WebSocketMessage = string | ArrayBuffer | Blob | ArrayBufferView;
+/** ### `ReqwestWsConfig` : WebSocket连接配置 */
+export type ReqwestWsConfig<A, B> = {
+    /** WebSocket连接地址 */
+    url: string;
+    /** 终止控制器 */
+    abort?: AbortController | AbortSignal;
+    /** 反序列化函数 , 将获取的数据反序列化为`B`类型
+    @default `(data)=>JSON.parse(data.data)` */
+    deserialize?: Fn<MessageEvent, B>;
+    /** 序列化函数 , 将发送的数据序列化为`WebSocketMessage`类型
+    @default `(data)=>JSON.stringify(data)` */
+    serialize?: Fn<A, WebSocketMessage>;
+};
+export type ExtendWebSocketSubject<A, B> = {
+    next: (data: A) => void;
+    subscribe: Fn<Fn<B, void>, void>;
+} & {
+    complete?: Fn<void, void>;
+    error?: Fn<Fn<unknown, void>, void>;
+    next?: Fn<Fn<B, void>, void>;
+} & rjx_ws.WebSocketSubject<unknown>;
+/** ### `ReqwestSSEConfig` : SSE连接配置 */
+export type ReqwestSSEConfig = {
+    /** SSE连接地址 */
+    url: string;
+    /** 终止控制器 */
+    abort?: AbortController | AbortSignal;
+    /** SSE连接方法 : 默认`get` */
+    method?: 'GET' | 'POST';
+    /** 解码器 : 默认不使用,直接返回`Uint8Array` */
+    decode?: {
+        decode: (input: Uint8Array<ArrayBuffer>) => string;
+    };
+    /** 数据校验器,用于校验解码后的数据 : 默认不使用,直接返回解码后的数据 */
+    validator?: zod.ZodSchema<unknown>;
+};
+/** ### `RequestInterceptor` : 请求拦截器 | 返回`Ok()` or `Err(E)`
++ `Ok()`表示通过拦截器 , 会运行下一个拦截器
++ `Err(E)`表示拦截器拦截 , 会直接短路返回`Err(E)`
+ */
+export type RequestInterceptor<E = never> = (conf: InternalAxiosRequestConfig<unknown>) => PromiseOr<Result<void, E>>;
+/** ### `ResponseInterceptor` : 响应拦截器 | 返回`Ok(O)` or `Err(E)`
++ `Ok(O)` 表示通过拦截器 , 会自动解包并将值传递给下一个拦截器
++ `Err(E)`表示拦截器拦截 , 会直接短路返回`Err(E)`
+ */
+export type ResponseInterceptor<O = AxiosResponse<unknown, unknown>, OO = AxiosResponse<unknown, unknown>, EE = never> = (response: O) => PromiseOr<Result<OO, EE>>;
+/** ### `ReqwestInterceptor` : `请求-响应拦截器` | 分成响应拦截和请求拦截 */
+export interface ReqwestInterceptor<O, E, OO = O, EE = never> {
+    request: RequestInterceptor<E>;
+    response: ResponseInterceptor<O, OO, EE>;
+}
+export type MergeErrors<T extends unknown[]> = T extends [
+    RequestInterceptor<infer E>,
+    ...infer Rest
+] ? E | MergeErrors<Rest> : never;
+type FinalResult<Interceptors extends ResponseInterceptor<unknown, unknown, unknown>[], CurrentOutput = AxiosResponse<unknown>, CurrentError = UnexpectedError> = Interceptors extends [
+    infer First,
+    ...infer Rest extends ResponseInterceptor<unknown, unknown, unknown>[]
+] ? First extends ResponseInterceptor<CurrentOutput, infer NextOutput, infer NextError> ? FinalResult<Rest, NextOutput, NextError | CurrentError> : never : Result<CurrentOutput, CurrentError>;
+export type ResponseResult<O, E, ER, Interceptors extends ResponseInterceptor<unknown, unknown, unknown>[]> = ReqwestInterface<FinalResult<Interceptors, O, ER> extends Result<infer O, unknown> ? O : never, E, FinalResult<Interceptors, O, ER> extends Result<unknown, infer E> ? E : never>;
+export interface ReqwestInterface<O = AxiosResponse<unknown, unknown>, E = never, ER = UnexpectedError> extends Copy {
+    /** ### `conf` : 更新配置
+    @example Usage
+    ```ts
+    const conf = { baseURL: 'https://jsonplaceholder.typicode.com/todos/' }
+    const mock_reqwest = Reqwest.new().conf(conf)
+    mock_reqwest.dispatch() // curl https://jsonplaceholder.typicode.com/todos/
+    ```
+     */
+    conf(conf: CreateAxiosDefaults): ReqwestInterface<O, E, ER>;
+    /** ### `dispatch` : 发送请求,获取请求结果
+    @example Usage
+    ```ts
+    const conf = { baseURL: 'https://jsonplaceholder.typicode.com/todos/' }
+    const mock_reqwest = Reqwest.new().conf(conf)
+    mock_reqwest.dispatch() // dispatch to get https://jsonplaceholder.typicode.com/todos/
+    ```
+     */
+    dispatch(): AsyncResult<O, E | ER>;
+    /** ### `request` : 增加请求拦截器,拦截器会按顺序执行
+  + 该方法会返回一个新的`Reqwest`,并且与原`Reqwest`保持独立 */
+    request<I extends RequestInterceptor<unknown>[]>(...interceptors: I): ReqwestInterface<O, MergeErrors<I> | E, ER>;
+    /** ### `response` : 增加响应拦截器,拦截器会按顺序执行
+    + 该方法会返回一个新的`Reqwest`,并且与原`Reqwest`保持独立 */
+    response<OO, EE>(interceptor: ResponseInterceptor<O, OO, EE>): ReqwestInterface<OO, E, EE | ER>;
+    response<OO, EE, O2, E2>(...interceptor: [ResponseInterceptor<O, OO, EE>, ResponseInterceptor<OO, O2, E2>]): ReqwestInterface<O2, E, E2 | EE | ER>;
+    response<OO, EE, O2, E2, O3, E3>(...interceptor: [
+        ResponseInterceptor<O, OO, EE>,
+        ResponseInterceptor<OO, O2, E2>,
+        ResponseInterceptor<O2, O3, E3>
+    ]): ReqwestInterface<O3, E, E3 | E2 | EE | ER>;
+    response<OO, EE, O2, E2, O3, E3, O4, E4>(...interceptor: [
+        ResponseInterceptor<O, OO, EE>,
+        ResponseInterceptor<OO, O2, E2>,
+        ResponseInterceptor<O2, O3, E3>,
+        ResponseInterceptor<O3, O4, E4>
+    ]): ReqwestInterface<O4, E, E4 | E3 | E2 | EE | ER>;
+    response<OO, EE, O2, E2, O3, E3, O4, E4, O5, E5>(...interceptor: [
+        ResponseInterceptor<O, OO, EE>,
+        ResponseInterceptor<OO, O2, E2>,
+        ResponseInterceptor<O2, O3, E3>,
+        ResponseInterceptor<O3, O4, E4>
+    ]): ReqwestInterface<O5, E, E5 | E4 | E3 | E2 | EE | ER>;
+    response<OO, EE, O2, E2, O3, E3, O4, E4, O5, E5, O6, E6>(...interceptor: [
+        ResponseInterceptor<O, OO, EE>,
+        ResponseInterceptor<OO, O2, E2>,
+        ResponseInterceptor<O2, O3, E3>,
+        ResponseInterceptor<O3, O4, E4>,
+        ResponseInterceptor<O4, O5, E5>,
+        ResponseInterceptor<O5, O6, E6>
+    ]): ReqwestInterface<O6, E, E6 | E5 | E4 | E3 | E2 | EE | ER>;
+    response<OO, EE, O2, E2, O3, E3, O4, E4, O5, E5, O6, E6, O7, E7>(...interceptor: [
+        ResponseInterceptor<O, OO, EE>,
+        ResponseInterceptor<OO, O2, E2>,
+        ResponseInterceptor<O2, O3, E3>,
+        ResponseInterceptor<O3, O4, E4>,
+        ResponseInterceptor<O4, O5, E5>,
+        ResponseInterceptor<O5, O6, E6>,
+        ResponseInterceptor<O6, O7, E7>
+    ]): ReqwestInterface<O7, E, E7 | E6 | E5 | E4 | E3 | E2 | EE | ER>;
+    response<OO, EE, O2, E2, O3, E3, O4, E4, O5, E5, O6, E6, O7, E7, O8, E8>(...interceptor: [
+        ResponseInterceptor<O, OO, EE>,
+        ResponseInterceptor<OO, O2, E2>,
+        ResponseInterceptor<O2, O3, E3>,
+        ResponseInterceptor<O3, O4, E4>,
+        ResponseInterceptor<O4, O5, E5>,
+        ResponseInterceptor<O5, O6, E6>,
+        ResponseInterceptor<O6, O7, E7>,
+        ResponseInterceptor<O7, O8, E8>
+    ]): ReqwestInterface<O8, E, E8 | E7 | E6 | E5 | E4 | E3 | E2 | EE | ER>;
+    response<OO, EE, O2, E2, O3, E3, O4, E4, O5, E5, O6, E6, O7, E7, O8, E8, O9, E9>(...interceptor: [
+        ResponseInterceptor<O, OO, EE>,
+        ResponseInterceptor<OO, O2, E2>,
+        ResponseInterceptor<O2, O3, E3>,
+        ResponseInterceptor<O3, O4, E4>,
+        ResponseInterceptor<O4, O5, E5>,
+        ResponseInterceptor<O5, O6, E6>,
+        ResponseInterceptor<O6, O7, E7>,
+        ResponseInterceptor<O7, O8, E8>,
+        ResponseInterceptor<O8, O9, E9>
+    ]): ReqwestInterface<O9, E, E9 | E8 | E7 | E6 | E5 | E4 | E3 | E2 | EE | ER>;
+    /** ### `use` : 增加`请求-响应拦截器`,拦截器会按顺序执行
+    + 该方法会返回一个新的`Reqwest`,并且与原`Reqwest`保持独立
+    @example Usage - cancel
+    ```ts
+    const conf = { baseURL: 'https://jsonplaceholder.typicode.com/todos/' }
+    const mock_reqwest = Reqwest.new().conf(conf)
+
+    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)
+    ```
+     */
+    use<OO, EC, EE>(interceptor: ReqwestInterceptor<O, EC, OO, EE>): ReqwestInterface<OO, EC | E, EE | ER>;
+    /** ### `clone`
+    + 实现{@link Copy}接口 : 生成一个全新的`Reqwest` */
+    clone(): ReqwestInterface<O, E, ER>;
+}
+export {};
+//# sourceMappingURL=interface.d.ts.map

package/script/lib/core/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/lib/core/interface.ts"],"names":[],"mappings":"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"}

package/script/lib/core/mod.d.ts

@@ -0,0 +1,5 @@
+/** @module core */
+export type { RequestInterceptor, ReqwestInterceptor, ResponseInterceptor, } from './interface.js';
+export * from './class.js';
+export * from './factor.js';
+//# sourceMappingURL=mod.d.ts.map

package/script/lib/core/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/lib/core/mod.ts"],"names":[],"mappings":"AAAA,mBAAmB;AAEnB,YAAY,EACX,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,gBAAgB,CAAA;AAEvB,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/script/lib/{reqwest → core}/mod.js

@@ -1,4 +1,5 @@
 "use strict";
+/** @module core */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

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

@@ -1,3 +1,5 @@
+/** @module helper */
+export * from './other/mod.js';
 export * from './request/mod.js';
 export * from './response/mod.js';
 export * from './use/mod.js';

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/lib/helper/mod.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/lib/helper/mod.ts"],"names":[],"mappings":"AAAA,qBAAqB;AAErB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA"}

package/script/lib/helper/mod.js

@@ -1,4 +1,5 @@
 "use strict";
+/** @module helper */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,6 +15,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("./other/mod.js"), exports);
 __exportStar(require("./request/mod.js"), exports);
 __exportStar(require("./response/mod.js"), exports);
 __exportStar(require("./use/mod.js"), exports);

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

@@ -0,0 +1,2 @@
+export * from './sseParse.js';
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/other/mod.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA"}

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

@@ -0,0 +1,17 @@
+"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 __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("./sseParse.js"), exports);

package/script/lib/helper/other/sseParse.d.ts

@@ -0,0 +1,34 @@
+/** `SSEMessageEvent` : 经典的SSE事件名
++ `message` : 默认事件（不写 event: 时就是它）
++ `open` : 	连接建立后服务器推送的第一条欢迎消息
++ `ping` : 服务端保活
++ `update` : 数据增量更新
++ `error` : 服务端主动通知前端“出错了”
++ `close` : 服务端优雅关闭连接
+ */
+export type SSEMessageEvent = 'message' | 'open' | 'ping' | 'update' | 'error' | 'close';
+export interface SSEMessage {
+    /** 数据 */
+    data: string;
+    /** 事件类型 */
+    event?: SSEMessageEvent | string;
+    /** 消息ID */
+    id?: string;
+    /** 重连时间(毫秒) */
+    retry?: number;
+}
+/** ## `parse_sse_data` : 解析[标准SSE格式](https://developer.mozilla.org/zh-CN/docs/Web/API/Server-sent_events/Using_server-sent_events)的数据
+@example Usage
+```ts
+  const generator = Reqwest.sse({
+    url: 'http://localhost:7788/api/ping/sse',
+  })
+
+  for await (const item of generator) {
+    const { data } = parse_sse_data(item)
+    assert(typeof data === 'string')
+  }
+```
+ */
+export declare function parse_sse_data(data: string | Uint8Array): SSEMessage;
+//# sourceMappingURL=sseParse.d.ts.map

package/script/lib/helper/other/sseParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sseParse.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/other/sseParse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAExF,MAAM,WAAW,UAAU;IAC1B,SAAS;IACT,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW;IACX,KAAK,CAAC,EAAE,eAAe,GAAG,MAAM,CAAA;IAChC,WAAW;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAGpE"}

package/script/lib/helper/other/sseParse.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parse_sse_data = parse_sse_data;
+/** ## `parse_sse_data` : 解析[标准SSE格式](https://developer.mozilla.org/zh-CN/docs/Web/API/Server-sent_events/Using_server-sent_events)的数据
+@example Usage
+```ts
+  const generator = Reqwest.sse({
+    url: 'http://localhost:7788/api/ping/sse',
+  })
+
+  for await (const item of generator) {
+    const { data } = parse_sse_data(item)
+    assert(typeof data === 'string')
+  }
+```
+ */
+function parse_sse_data(data) {
+    if (typeof data === 'string')
+        return parse_core(data);
+    return parse_core(new TextDecoder().decode(data));
+}
+const MSG_SPLIT = '\n';
+const EVENT_LINE = 'event: ';
+const ID_LINE = 'id: ';
+const RETRY_LINE = 'retry: ';
+const DATA_LINE = 'data: ';
+function parse_core(str) {
+    const result = { data: '' };
+    const lines = str.split(MSG_SPLIT);
+    for (const line of lines) {
+        if (line.startsWith(DATA_LINE)) {
+            if (result.data.length === 0)
+                result.data += line.slice(DATA_LINE.length);
+            else
+                result.data += `\n${line.slice(DATA_LINE.length)}`;
+        }
+        if (line.startsWith(ID_LINE))
+            result.id = line.slice(ID_LINE.length);
+        if (line.startsWith(EVENT_LINE))
+            result.event = line.slice(EVENT_LINE.length);
+        if (line.startsWith(RETRY_LINE))
+            result.retry = Number(line.slice(RETRY_LINE.length));
+    }
+    return result;
+}

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

@@ -1,40 +1,72 @@
-import { type JsonXObject } from '@chzky/fp';
+import type { JsonXObject } from '@chzky/core';
 import type { RequestInterceptor } from '../../../mod.js';
 /** ### `post` : post请求
-@param url `string` - 请求地址
+@param  `string` - 请求地址
 @param [data={}] `unknown` - 请求数据
 @param [query={}] `Record<string, unknown>` - URL形式的请求参数
-@type `Interceptor` - `Request`
-@category `Request`
+@category `RequestInterceptor`
 */
 export declare function post(url: string, data?: unknown, query?: JsonXObject): RequestInterceptor<never>;
 /** ### `get` : get请求
 @param url `string` - 请求地址
 @param [query={}] `Record<string, unknown>` - URL形式的请求参数
-@type `Interceptor` - `Request`
-@category `Request`
+@category `RequestInterceptor`
 */
 export declare function get(url: string, query?: JsonXObject): RequestInterceptor<never>;
 /** ### `put` : put请求
 @param url `string` - 请求地址
 @param [data={}] `unknown` - 请求数据
 @param [query={}] `Record<string, unknown>` - URL形式的请求参数
-@type `Interceptor` - `Request`
-@category `Request`
+@category `RequestInterceptor`
  */
 export declare function put(url: string, data?: unknown, query?: JsonXObject): RequestInterceptor<never>;
 /** ### `del` : delete请求
 @param url `string` - 请求地址
 @param [query={}] `Record<string, unknown>` - query形式的请求参数
-@type `Interceptor` - `Request`
-@category `Request`
+@category `RequestInterceptor`
 */
 export declare function del(url: string, query?: JsonXObject): RequestInterceptor<never>;
 /** ### `form` : FormData形式请求
 @param url `string` - 请求地址
 @param data `Record<string, string | Blob>` - 请求数据
-@type `Interceptor` - `Request`
 @category `Request`
 */
 export declare function form(url: string, data: Record<string | number, string | Blob>): RequestInterceptor<never>;
+/** ### `set_body` : 覆盖Body参数
+该方法会覆盖请求的Body参数
+@example Usage
+```ts
+const request = post('/api')
+request.use(set_body({ foo: 'bar' })) // Will override request body
+```
+@param data `unknown` - 请求数据
+@category `RequestInterceptor`
+*/
+export declare function set_body(data: unknown): RequestInterceptor<never>;
+/** ### `set_params` : 覆盖URL参数
+该方法会覆盖请求的URL参数
+@example Usage
+```ts
+const request = get('/api')
+request.use(set_params({ foo: 'bar' })) // Will override request params
+```
+@param params `Record<string, unknown>` - URL形式的请求参数
+@type `Interceptor` - `Request`
+@category `RequestInterceptor`
+*/
+export declare function set_params(params: JsonXObject): RequestInterceptor<never>;
+/** ### `append_url` : URL
+该方法会将url添加到请求地址的后面;如果没有url,则直接添加
+@param url `string` - 请求地址
+@type `Interceptor` - `Request`
+@category `RequestInterceptor`
+ */
+export declare function append_url(url: string): RequestInterceptor<never>;
+/** ## `RESTful` : `RESTful`请求  */
+export declare const RESTful: {
+    readonly Get: typeof get;
+    readonly Post: typeof post;
+    readonly Put: typeof put;
+    readonly Del: typeof del;
+};
 //# sourceMappingURL=RESTful.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RESTful.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/RESTful.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAM,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD;;;;;;EAME;AACF,wBAAgB,IAAI,CAClB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,OAAY,EAClB,KAAK,GAAE,WAAgB,GACtB,kBAAkB,CAAC,KAAK,CAAC,CAQ3B;AAED;;;;;EAKE;AACF,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,WAAgB,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAOnF;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CACjB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,OAAY,EAClB,KAAK,GAAE,WAAgB,GACtB,kBAAkB,CAAC,KAAK,CAAC,CAQ3B;AAED;;;;;EAKE;AACF,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,WAAgB,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAOnF;AAED;;;;;EAKE;AACF,wBAAgB,IAAI,CAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAC3C,kBAAkB,CAAC,KAAK,CAAC,CAW3B"}
+{"version":3,"file":"RESTful.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/RESTful.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIzD;;;;;EAKE;AACF,wBAAgB,IAAI,CACnB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,OAAY,EAClB,KAAK,GAAE,WAAgB,GACrB,kBAAkB,CAAC,KAAK,CAAC,CAQ3B;AAED;;;;EAIE;AACF,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,WAAgB,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAOnF;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAClB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,OAAY,EAClB,KAAK,GAAE,WAAgB,GACrB,kBAAkB,CAAC,KAAK,CAAC,CAQ3B;AAED;;;;EAIE;AACF,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,WAAgB,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAOnF;AAED;;;;EAIE;AACF,wBAAgB,IAAI,CACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAC1C,kBAAkB,CAAC,KAAK,CAAC,CAW3B;AAED;;;;;;;;;EASE;AACF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAKjE;AAED;;;;;;;;;;EAUE;AACF,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAMjE;AAED,kCAAkC;AAClC,eAAO,MAAM,OAAO;;;;;CAKV,CAAA"}

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

@@ -1,79 +1,78 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESTful = void 0;
 exports.post = post;
 exports.get = get;
 exports.put = put;
 exports.del = del;
 exports.form = form;
-const fp_1 = require("@chzky/fp");
+exports.set_body = set_body;
+exports.set_params = set_params;
+exports.append_url = append_url;
+const core_1 = require("@chzky/core");
 /** ### `post` : post请求
-@param url `string` - 请求地址
+@param  `string` - 请求地址
 @param [data={}] `unknown` - 请求数据
 @param [query={}] `Record<string, unknown>` - URL形式的请求参数
-@type `Interceptor` - `Request`
-@category `Request`
+@category `RequestInterceptor`
 */
 function post(url, data = {}, query = {}) {
-    return (conf) => {
+    return conf => {
         conf.method = 'post';
         conf.url = url;
         conf.data = data;
         conf.params = query;
-        return (0, fp_1.Ok)();
+        return (0, core_1.Ok)();
     };
 }
 /** ### `get` : get请求
 @param url `string` - 请求地址
 @param [query={}] `Record<string, unknown>` - URL形式的请求参数
-@type `Interceptor` - `Request`
-@category `Request`
+@category `RequestInterceptor`
 */
 function get(url, query = {}) {
-    return (conf) => {
+    return conf => {
         conf.method = 'get';
         conf.url = url;
         conf.params = query;
-        return (0, fp_1.Ok)();
+        return (0, core_1.Ok)();
     };
 }
 /** ### `put` : put请求
 @param url `string` - 请求地址
 @param [data={}] `unknown` - 请求数据
 @param [query={}] `Record<string, unknown>` - URL形式的请求参数
-@type `Interceptor` - `Request`
-@category `Request`
+@category `RequestInterceptor`
  */
 function put(url, data = {}, query = {}) {
-    return (conf) => {
+    return conf => {
         conf.method = 'put';
         conf.url = url;
         conf.data = data;
         conf.params = query;
-        return (0, fp_1.Ok)();
+        return (0, core_1.Ok)();
     };
 }
 /** ### `del` : delete请求
 @param url `string` - 请求地址
 @param [query={}] `Record<string, unknown>` - query形式的请求参数
-@type `Interceptor` - `Request`
-@category `Request`
+@category `RequestInterceptor`
 */
 function del(url, query = {}) {
-    return (conf) => {
+    return conf => {
         conf.method = 'delete';
         conf.url = url;
         conf.params = query;
-        return (0, fp_1.Ok)();
+        return (0, core_1.Ok)();
     };
 }
 /** ### `form` : FormData形式请求
 @param url `string` - 请求地址
 @param data `Record<string, string | Blob>` - 请求数据
-@type `Interceptor` - `Request`
 @category `Request`
 */
 function form(url, data) {
-    return (conf) => {
+    return conf => {
         conf.method = 'post';
         conf.url = url;
         const fdata = new FormData();
@@ -81,6 +80,61 @@ function form(url, data) {
             fdata.append(key, value);
         });
         conf.data = fdata;
-        return (0, fp_1.Ok)();
+        return (0, core_1.Ok)();
+    };
+}
+/** ### `set_body` : 覆盖Body参数
+该方法会覆盖请求的Body参数
+@example Usage
+```ts
+const request = post('/api')
+request.use(set_body({ foo: 'bar' })) // Will override request body
+```
+@param data `unknown` - 请求数据
+@category `RequestInterceptor`
+*/
+function set_body(data) {
+    return conf => {
+        conf.data = data;
+        return (0, core_1.Ok)();
+    };
+}
+/** ### `set_params` : 覆盖URL参数
+该方法会覆盖请求的URL参数
+@example Usage
+```ts
+const request = get('/api')
+request.use(set_params({ foo: 'bar' })) // Will override request params
+```
+@param params `Record<string, unknown>` - URL形式的请求参数
+@type `Interceptor` - `Request`
+@category `RequestInterceptor`
+*/
+function set_params(params) {
+    return conf => {
+        conf.params = params;
+        return (0, core_1.Ok)();
+    };
+}
+/** ### `append_url` : URL
+该方法会将url添加到请求地址的后面;如果没有url,则直接添加
+@param url `string` - 请求地址
+@type `Interceptor` - `Request`
+@category `RequestInterceptor`
+ */
+function append_url(url) {
+    return conf => {
+        if (!conf.url)
+            conf.url = url;
+        else
+            conf.url = `${url}/${conf.url}`.replace(/\/{2,}/g, '/');
+        return (0, core_1.Ok)();
     };
 }
+/** ## `RESTful` : `RESTful`请求  */
+exports.RESTful = {
+    Get: get,
+    Post: post,
+    Put: put,
+    Del: del,
+};

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

@@ -1,15 +1,22 @@
+import type { PositiveInteger } from '@chzky/core';
 import type { RequestInterceptor } from '../../../mod.js';
 import type { AxiosRequestHeaders, ResponseType } from 'axios';
 /** ## `header` : 修改请求头数据
-@param header `AxiosRequestHeaders` - 请求头数据
+@param head `AxiosRequestHeaders` - 请求头数据
 @type `Interceptor` - `Request`
-@category `Request`
+@category Helper
  */
-export declare function header(header: AxiosRequestHeaders): RequestInterceptor<never>;
+export declare function header(head: AxiosRequestHeaders): RequestInterceptor<never>;
 /** ## `response_type` : 修改响应数据类型
 @param type `ResponseType` - 响应数据类型
 @type `Interceptor` - `Request`
-@category `Request`
+@category Helper
 */
 export declare function response_type(type: ResponseType): RequestInterceptor<never>;
+/** ## `timeout` : 修改请求超时时间
+@param time `PositiveInteger<N>` - 请求超时时间
+@type `Interceptor` - `Request`
+@category Helper
+*/
+export declare function timeout<N extends number>(time: PositiveInteger<N>): RequestInterceptor<never>;
 //# sourceMappingURL=baseConf.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"baseConf.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/baseConf.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAE9D;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAK7E;AAED;;;;EAIE;AACF,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAK3E"}
+{"version":3,"file":"baseConf.d.ts","sourceRoot":"","sources":["../../../../src/lib/helper/request/baseConf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAI9D;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAO3E;AAED;;;;EAIE;AACF,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAK3E;AAED;;;;EAIE;AACF,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAK7F"}