@chzky/reqwest 0.0.1 → 0.1.1

package/esm/lib/core/class.js

@@ -0,0 +1,173 @@
+import { normal_dispatch, see_reqwest, ws_reqwest } from './core.js';
+import Axios from 'axios';
+/** ## `Reqwest` : 基于`Axios`二次封装的请求库 */
+export class Reqwest {
+    constructor(
+    // biome-ignore lint/suspicious/noExplicitAny: <>
+    interceptors_req = [], 
+    // biome-ignore lint/suspicious/noExplicitAny: <>
+    interceptors_res = [], cof = {}) {
+        Object.defineProperty(this, "interceptors_req", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: interceptors_req
+        });
+        Object.defineProperty(this, "interceptors_res", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: interceptors_res
+        });
+        Object.defineProperty(this, "cof", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: cof
+        });
+        Object.defineProperty(this, "internal_axios", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: Axios.create({})
+        });
+        cof && this.conf(cof);
+    }
+    /** ### `conf` : 更新配置 */
+    conf(conf) {
+        for (const key in conf) {
+            if (Object.hasOwn(conf, key)) {
+                this.internal_axios.defaults[key] =
+                    conf[key];
+            }
+        }
+        this.cof = this.internal_axios.defaults;
+        return this;
+    }
+    request(...interceptors) {
+        return new Reqwest([...this.interceptors_req, ...interceptors], this.interceptors_res, this.cof);
+    }
+    response(...interceptor) {
+        return new Reqwest(this.interceptors_req, [...this.interceptors_res, ...interceptor], this.cof);
+    }
+    use(interceptor) {
+        return new Reqwest([...this.interceptors_req, interceptor.request], [...this.interceptors_res, interceptor.response], this.cof);
+    }
+    dispatch() {
+        return normal_dispatch.call(this);
+    }
+    clone() {
+        return new Reqwest(this.interceptors_req, this.interceptors_res, this.cof);
+    }
+    /** ### `new`
+    实现{@link NewAble}接口 */
+    static new() {
+        return new Reqwest();
+    }
+    /** ### `default`
+    实现{@link Default}接口 : 以默认配置生成一个`Reqwest`
+    #### 默认配置
+    + `timeout` : `6000`ms
+     */
+    static default() {
+        return new Reqwest().conf({ timeout: 6000 });
+    }
+    /** ## `sse` : 进行[SSE](https://developer.mozilla.org/zh-CN/docs/Web/API/Server-sent_events/Using_server-sent_events)请求
+    api使用见[rxjs-webSocket](https://rxjs.dev/api/webSocket/webSocket)
+    + 实际请求只有在第一次`gen.next()`时才会发出请求
+    + 由于请求带来的错误不会抛出，而是返回`{done:true,value:underfine}`
+    @example for await to take
+    ```ts
+    const sse_url = 'https://stream.wikimedia.org/v2/stream/recentchange'
+
+    const abort = new AbortController()
+
+    const gen = Reqwest.sse({
+        abort,
+        url: sse_url,
+    })
+
+    let index = 0
+    // 开始循环时才会调用接口获取数据
+    for await (const item of gen) {
+        if (index === 10) abort.abort() //主动终止数据获取
+        index++
+        const message = parse_sse_data(item)
+        assert(typeof message.data === 'string')
+    }
+
+    const { done, value } = await gen.next()
+    assert(done)
+    assert.equal(value, undefined)
+    ```
+    @example AsyncVector to take
+    ```ts
+    const sse_url = 'https://stream.wikimedia.org/v2/stream/recentchange'
+
+    const abort = new AbortController()
+
+    const gen = Reqwest.sse({
+        abort,
+        url: sse_url,
+    })
+
+    const vec = AsyncVec(gen, false)
+
+    const result = await vec
+        .map(item => parse_sse_data(item))
+        .filter(i => Boolean(i.data))
+        .take(10)
+        .collect()
+
+    const { done, value } = await gen.next()
+
+    assert(done)
+    assert.equal(value, undefined)
+    assert.equal(result.length, 10)
+    assert(result.every(i => i.data.length > 1))
+    ```
+     */
+    static sse(conf) {
+        return see_reqwest(conf);
+    }
+    /** ## `sse` : 进行[WebSocket](https://developer.mozilla.org/zh-CN/docs/Web/API/WebSocket)请求
+    @example Usage
+    ```ts
+    const MOCK_URL = 'wss://echo.websocket.org'
+
+    const { promise, resolve } = Promise.withResolvers<void>()
+
+    const abort = new AbortController()
+
+    type TansShape = { type: 'event' | 'message'; data: JsonX }
+
+    const wss = Reqwest.ws({
+        url: MOCK_URL,
+        abort: abort.signal,
+        deserialize: data => result(() => JSON.parse(data.data) as TansShape).unwrap_or(data.data),
+        serialize: (data: TansShape) => JSON.stringify(data),
+    })
+
+    wss.subscribe({
+        complete: resolve,
+        next: data => {
+            if (typeof data === 'string') return
+            const rdata = data as TansShape
+            if (!rdata.data) return
+
+            abort.abort() // 触发complete函数,执行complete回调
+            assert(rdata.data)
+            assert.equal(rdata.type, 'message')
+        },
+    })
+
+    wss.next({ type: 'event', data: false })
+    wss.next({ type: 'message', data: true })
+
+    await promise
+    ```
+     */
+    static ws(conf) {
+        return ws_reqwest(conf);
+    }
+}

package/esm/lib/core/core.d.ts

@@ -0,0 +1,11 @@
+import { ExtendWebSocketSubject, ReqwestSSEConfig, ReqwestWsConfig } from './interface.js';
+/** 正常的dispatch */
+export declare function normal_dispatch(this: any): Promise<any>;
+/** 请求拦截器运行核心 */
+export declare function request_interceptor_run(conf: any, arrs: any[]): Promise<void>;
+/** 响应拦截器运行核心 */
+export declare function response_interceptor_run(res: any, arrs: any[], wrap?: boolean): Promise<any>;
+/** sse请求转Generator */
+export declare const see_reqwest: (conf: ReqwestSSEConfig) => AsyncGenerator<Uint8Array, undefined, void>;
+export declare const ws_reqwest: <A, B>(conf: ReqwestWsConfig<A, B>) => ExtendWebSocketSubject<A, B>;
+//# sourceMappingURL=core.d.ts.map

package/esm/lib/core/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/lib/core/core.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAG1F,kBAAkB;AAClB,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAuCvD;AAED,gBAAgB;AAChB,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnF;AAED,gBAAgB;AAChB,wBAAsB,wBAAwB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,UAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAQhG;AAiBD,sBAAsB;AACtB,eAAO,MAAM,WAAW,SAAU,gBAAgB,gDAwCjD,CAAA;AAMD,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,CAAC,QAAQ,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAWzC,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAC7C,CAAA"}

package/esm/lib/core/core.js

@@ -0,0 +1,157 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = {}, verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+/** biome-ignore-all lint/suspicious/noExplicitAny: < core file should ignore any type > */
+import { AbortedError, AnyError, AnyHowError, CheckingError, Err, is_err, is_ok, None, Ok, rjx_ws, throwing, UnexpectedError, } from '@chzky/core';
+import { AxiosError, CanceledError } from 'axios';
+/** 正常的dispatch */
+export function normal_dispatch() {
+    const { resolve, promise } = Promise.withResolvers();
+    /** request_interceptor */
+    this.internal_axios.interceptors.request.use((conf) => __awaiter(this, void 0, void 0, function* () {
+        yield request_interceptor_run(conf, this.interceptors_req);
+        return conf;
+    }));
+    /** response_interceptor */
+    this.internal_axios.interceptors.response.use((r) => r /* 2xx 范围内的状态码都会触发该函数。 */, throwing /* 超出 2xx 范围的状态码都会触发该函数。 */);
+    this.internal_axios({})
+        .then((res) => __awaiter(this, void 0, void 0, function* () {
+        const result = yield response_interceptor_run(res, this.interceptors_res);
+        return Ok(result);
+    }))
+        .then(resolve, (e) => {
+        /* 异常的可能情况
+  1. interceptors.request的异常
+    1.1 CanceledError - 请求终止错误
+  2. interceptors.response超出200~300的code
+  3. interceptors.response执行过程中的异常:<返回Err类型,或是执行过程中直接throw>
+  */
+        resolve(e instanceof AnyError
+            ? Err(e)
+            : e instanceof CanceledError
+                ? AbortedError.err(e.message || 'Request has been canceled')
+                : e instanceof AxiosError
+                    ? AnyHowError.err(e.message)
+                    : UnexpectedError.err(e));
+    });
+    return promise;
+}
+/** 请求拦截器运行核心 */
+export function request_interceptor_run(conf, arrs) {
+    return __awaiter(this, void 0, void 0, function* () {
+        for (const fn of arrs) {
+            const res = yield Promise.resolve(fn(conf));
+            if (is_err(res) || is_ok(res))
+                res.unwrap(); /* 解包 */
+            else
+                throw CheckingError.new('RequestInterceptor must return Err<E> or Ok<void>');
+        }
+    });
+}
+/** 响应拦截器运行核心 */
+export function response_interceptor_run(res_1, arrs_1) {
+    return __awaiter(this, arguments, void 0, function* (res, arrs, wrap = false) {
+        let result = res;
+        for (const fn of arrs) {
+            result = yield Promise.resolve(fn(result));
+            if (is_err(result) || is_ok(result))
+                result = result.unwrap(); /* 解包 */
+            else
+                throw CheckingError.new('ResponseInterceptor must return Err<E> or Ok<O>');
+        }
+        return wrap ? Ok(result) : result;
+    });
+}
+const is_aborteder = (err) => err instanceof DOMException && err.name === 'AbortError';
+const cleanup_reader = (readerr) => __awaiter(void 0, void 0, void 0, function* () {
+    /**
+                1. 数据读取完毕
+                2. gen被关闭读取
+                3. aborted
+            */
+    try {
+        yield (readerr === null || readerr === void 0 ? void 0 : readerr.cancel());
+    }
+    catch (_) {
+        // ignore exception
+    }
+});
+/** sse请求转Generator */
+export const see_reqwest = (conf) => {
+    const { url, abort, method = 'GET' } = conf;
+    let response;
+    let reader;
+    const init_reader = () => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        if (reader !== undefined)
+            return;
+        response = yield fetch(url, {
+            method,
+            headers: { Accept: 'text/event-stream', 'Cache-Control': 'no-cache' },
+            signal: abort ? (abort instanceof AbortController ? abort.signal : abort) : undefined,
+        });
+        const lreader = (_a = response.body) === null || _a === void 0 ? void 0 : _a.getReader();
+        if (lreader === undefined)
+            throw None;
+        reader = lreader;
+    });
+    function start_sse() {
+        return __asyncGenerator(this, arguments, function* start_sse_1() {
+            try {
+                yield __await(init_reader());
+            }
+            catch (_) {
+                return yield __await(void 0);
+            }
+            try {
+                while (true) {
+                    const { done, value } = yield __await(reader.read());
+                    if (done)
+                        break;
+                    yield yield __await(value);
+                }
+                return yield __await(void 0);
+            }
+            catch (error) {
+                if (!is_aborteder(error))
+                    throw error;
+            }
+            finally {
+                yield __await(cleanup_reader(reader));
+            }
+        });
+    }
+    return start_sse();
+};
+const default_deserialize = (data) => JSON.parse(data.data);
+const default_serialize = (data) => JSON.stringify(data);
+export const ws_reqwest = (conf) => {
+    const { url, abort, deserialize = default_deserialize, serialize = default_serialize } = conf;
+    const subject = rjx_ws.webSocket({ url, serializer: serialize, deserializer: deserialize });
+    if (abort instanceof AbortController) {
+        abort === null || abort === void 0 ? void 0 : abort.signal.addEventListener('abort', subject.complete.bind(subject));
+    }
+    else {
+        abort === null || abort === void 0 ? void 0 : abort.addEventListener('abort', subject.complete.bind(subject));
+    }
+    return subject;
+};

package/esm/lib/{reqwest → core}/factor.d.ts

@@ -1,11 +1,59 @@
 /** 工厂函数,省去类型声明的步骤 */
-import type { RequestInterceptor, MergeErrors, ResponseInterceptor, ReqwestInterceptor } from './interface.js';
-/** ### `merge_request` : 工厂函数 of `Reqwest-request`
-+ 将多个request拦截器合并成一个拦截器
+import type { MergeErrors, RequestInterceptor, ReqwestInterceptor, ResponseInterceptor } from './interface.js';
+/** ### `merge_request` : `request`拦截器合并
+@example Usage
+```ts
+    const reqs = merge_request(
+        get('/1/', { id: 1 }),
+        input_validate(zod.object({ id: zod.number() })), // 输出判断类型
+        response_type('arraybuffer') // 改变接受的响应类型
+    )
+
+    const res = await mock_reqwest.clone().request(reqs).dispatch()
+
+    const RR = res.unwrap().data as Uint8Array
+    const json_text = new TextDecoder('utf-8').decode(RR)
+    assert.equal(JSON.parse(json_text).id, 1)
+
+    mock_reqwest.conf({ timeout: 6000 })
+```
+@Category Factory
 */
-export declare function merge_request<Interceptors extends RequestInterceptor<any>[]>(...interceptors: Interceptors): RequestInterceptor<MergeErrors<Interceptors>>;
-/** ### `merge_response` : 工厂函数 of `Reqwest-response`
-+ 将多个response拦截器合并成一个拦截器
+export declare function merge_request<Interceptors extends RequestInterceptor<unknown>[]>(...interceptors: Interceptors): RequestInterceptor<MergeErrors<Interceptors>>;
+/** ### `merge_response` : `response`拦截器合并
+@example
+```ts
+    const reqwest = Reqwest.new().conf({ baseURL: 'https://jsonplaceholder.typicode.com/posts/' })
+
+    const reps = merge_response(
+        // 返回值映射
+        response_map((data: AxiosResponse<unknown, unknown, object>) => {
+            if (data.status !== 200) return AnyHowError.err(data.statusText)
+            const rdata = data.data as { userId: number; id: number; title: string; body: string }
+            return Ok({ data: rdata, msg: 'success' })
+        }),
+        // 数据校验
+        output_validate(
+            zod.object({
+                data: zod
+                    .object({
+                        userId: zod.exchange.string(), // number --> string
+                        title: zod.string(),
+                    })
+                    .passthrough(), //允许溢出数据
+            })
+        )
+    )
+
+    const result = await reqwest.request(append_url('/1')).response(reps).dispatch()
+
+    const {
+        data: { userId },
+    } = result.unwrap()
+
+    assert.strict_equal(userId, '1')
+```
+@Category Factory
 */
 export declare function merge_response<I, O, E>(...interceptor: [ResponseInterceptor<I, O, E>]): ResponseInterceptor<I, O, E>;
 export declare function merge_response<I, O, E, O2, E2>(...interceptor: [ResponseInterceptor<I, O, E>, ResponseInterceptor<O, O2, E2>]): ResponseInterceptor<I, O2, E | E2>;
@@ -65,8 +113,8 @@ export declare function merge_response<I, O, E, O2, E2, O3, E3, O4, E4, O5, E5,
     ResponseInterceptor<O7, O8, E8>,
     ResponseInterceptor<O8, O9, E9>
 ]): ResponseInterceptor<I, O9, E | E2 | E3 | E4 | E5 | E6 | E7 | E8 | E9>;
-/** ### `merge_response` : 工厂函数 of `Reqwest-use`
-+ 快捷生成`ReqwestInterceptor`供`use`使用
-*/
+/** ### `merge_response` : 合并生成`ReqwestInterceptor`
+@Category Factory
+ */
 export declare function merge_reqwest<O, E, OO, EE>(request: RequestInterceptor<E>, response: ResponseInterceptor<O, OO, EE>): ReqwestInterceptor<O, E, OO, EE>;
 //# sourceMappingURL=factor.d.ts.map

package/esm/lib/core/factor.d.ts.map

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

package/esm/lib/core/factor.js

@@ -0,0 +1,48 @@
+/** 工厂函数,省去类型声明的步骤 */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Ok } from '@chzky/core';
+import { request_interceptor_run, response_interceptor_run } from './core.js';
+/** ### `merge_request` : `request`拦截器合并
+@example Usage
+```ts
+    const reqs = merge_request(
+        get('/1/', { id: 1 }),
+        input_validate(zod.object({ id: zod.number() })), // 输出判断类型
+        response_type('arraybuffer') // 改变接受的响应类型
+    )
+
+    const res = await mock_reqwest.clone().request(reqs).dispatch()
+
+    const RR = res.unwrap().data as Uint8Array
+    const json_text = new TextDecoder('utf-8').decode(RR)
+    assert.equal(JSON.parse(json_text).id, 1)
+
+    mock_reqwest.conf({ timeout: 6000 })
+```
+@Category Factory
+*/
+export function merge_request(...interceptors) {
+    return (conf) => __awaiter(this, void 0, void 0, function* () {
+        yield request_interceptor_run(conf, interceptors);
+        return Ok();
+    });
+}
+export function merge_response(...interceptor) {
+    return (res) => __awaiter(this, void 0, void 0, function* () {
+        return yield response_interceptor_run(res, interceptor, true);
+    });
+}
+/** ### `merge_response` : 合并生成`ReqwestInterceptor`
+@Category Factory
+ */
+export function merge_reqwest(request, response) {
+    return { request, response };
+}

package/esm/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