@chzky/reqwest 0.0.1 → 0.1.1

package/script/_dnt.shims.js

@@ -1,26 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dntGlobalThis = exports.setTimeout = exports.setInterval = exports.prompt = exports.confirm = exports.alert = exports.Deno = void 0;
-const shim_deno_1 = require("@deno/shim-deno");
-var shim_deno_2 = require("@deno/shim-deno");
-Object.defineProperty(exports, "Deno", { enumerable: true, get: function () { return shim_deno_2.Deno; } });
-const shim_prompts_1 = require("@deno/shim-prompts");
-var shim_prompts_2 = require("@deno/shim-prompts");
-Object.defineProperty(exports, "alert", { enumerable: true, get: function () { return shim_prompts_2.alert; } });
-Object.defineProperty(exports, "confirm", { enumerable: true, get: function () { return shim_prompts_2.confirm; } });
-Object.defineProperty(exports, "prompt", { enumerable: true, get: function () { return shim_prompts_2.prompt; } });
-const shim_timers_1 = require("@deno/shim-timers");
-var shim_timers_2 = require("@deno/shim-timers");
-Object.defineProperty(exports, "setInterval", { enumerable: true, get: function () { return shim_timers_2.setInterval; } });
-Object.defineProperty(exports, "setTimeout", { enumerable: true, get: function () { return shim_timers_2.setTimeout; } });
-const dntGlobals = {
-    Deno: shim_deno_1.Deno,
-    alert: shim_prompts_1.alert,
-    confirm: shim_prompts_1.confirm,
-    prompt: shim_prompts_1.prompt,
-    setInterval: shim_timers_1.setInterval,
-    setTimeout: shim_timers_1.setTimeout,
-};
+exports.dntGlobalThis = void 0;
+const dntGlobals = {};
 exports.dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
 function createMergeProxy(baseObj, extObj) {
     return new Proxy(baseObj, {

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

@@ -0,0 +1,122 @@
+import type { AsyncResult, UnexpectedError } from '@chzky/core';
+import type { AxiosResponse, CreateAxiosDefaults } from 'axios';
+import type { ExtendWebSocketSubject, MergeErrors, RequestInterceptor, ReqwestInterceptor, ReqwestInterface, ReqwestSSEConfig, ReqwestWsConfig, ResponseInterceptor, ResponseResult } from './interface.js';
+/** ## `Reqwest` : 基于`Axios`二次封装的请求库 */
+export declare class Reqwest<O = AxiosResponse<unknown, unknown>, E = never, ER = UnexpectedError> implements ReqwestInterface<O, E, ER> {
+    private readonly interceptors_req;
+    private readonly interceptors_res;
+    private cof;
+    private readonly internal_axios;
+    constructor(interceptors_req?: any[], interceptors_res?: any[], cof?: CreateAxiosDefaults);
+    /** ### `conf` : 更新配置 */
+    conf(conf: CreateAxiosDefaults): ReqwestInterface<O, E, ER>;
+    request<I extends RequestInterceptor<unknown>[]>(...interceptors: I): ReqwestInterface<O, MergeErrors<I> | E, ER>;
+    response<T extends ResponseInterceptor<unknown, unknown, unknown>[]>(...interceptor: T): ResponseResult<O, E, ER, T>;
+    use<OO, EC, EE>(interceptor: ReqwestInterceptor<O, EC, OO, EE>): ReqwestInterface<OO, EC | E, EE | ER>;
+    dispatch(): AsyncResult<O, E | ER>;
+    clone(): ReqwestInterface<O, E, ER>;
+    /** ### `new`
+    实现{@link NewAble}接口 */
+    static new(): ReqwestInterface;
+    /** ### `default`
+    实现{@link Default}接口 : 以默认配置生成一个`Reqwest`
+    #### 默认配置
+    + `timeout` : `6000`ms
+     */
+    static default(): ReqwestInterface;
+    /** ## `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: ReqwestSSEConfig): AsyncGenerator<Uint8Array, undefined, void>;
+    /** ## `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<A, B>(conf: ReqwestWsConfig<A, B>): ExtendWebSocketSubject<A, B>;
+}
+//# sourceMappingURL=class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"class.d.ts","sourceRoot":"","sources":["../../../src/lib/core/class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAC/D,OAAO,KAAK,EACX,sBAAsB,EACtB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,MAAM,gBAAgB,CAAA;AAKvB,uCAAuC;AACvC,qBAAa,OAAO,CACnB,CAAC,GAAG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EACnC,CAAC,GAAG,KAAK,EACT,EAAE,GAAG,eAAe,CACnB,YAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IAMrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAEjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,GAAG;IAPZ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmB;gBAIhC,gBAAgB,GAAE,GAAG,EAAO,EAE5B,gBAAgB,GAAE,GAAG,EAAO,EACrC,GAAG,GAAE,mBAAwB;IAKtC,wBAAwB;IACxB,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IAW3D,OAAO,CAAC,CAAC,SAAS,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAC9C,GAAG,YAAY,EAAE,CAAC,GAChB,gBAAgB,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IAQ9C,QAAQ,CAAC,CAAC,SAAS,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAClE,GAAG,WAAW,EAAE,CAAC,GACf,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAQ9B,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EACb,WAAW,EAAE,kBAAkB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAC5C,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;IAQxC,QAAQ,IAAI,WAAW,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IAIlC,KAAK,IAAI,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IAQnC;0BACsB;IACtB,MAAM,CAAC,GAAG,IAAI,gBAAgB;IAI9B;;;;OAIG;IACH,MAAM,CAAC,OAAO,IAAI,gBAAgB;IAIlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsDG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,cAAc,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC;IAI/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC;CAG1E"}

package/script/lib/core/class.js

@@ -0,0 +1,180 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reqwest = void 0;
+const core_js_1 = require("./core.js");
+const axios_1 = __importDefault(require("axios"));
+/** ## `Reqwest` : 基于`Axios`二次封装的请求库 */
+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_1.default.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 core_js_1.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 (0, core_js_1.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 (0, core_js_1.ws_reqwest)(conf);
+    }
+}
+exports.Reqwest = Reqwest;

package/script/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/script/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/script/lib/core/core.js

@@ -0,0 +1,165 @@
+"use strict";
+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]); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ws_reqwest = exports.see_reqwest = void 0;
+exports.normal_dispatch = normal_dispatch;
+exports.request_interceptor_run = request_interceptor_run;
+exports.response_interceptor_run = response_interceptor_run;
+/** biome-ignore-all lint/suspicious/noExplicitAny: < core file should ignore any type > */
+const core_1 = require("@chzky/core");
+const axios_1 = require("axios");
+/** 正常的dispatch */
+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 范围内的状态码都会触发该函数。 */, core_1.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 (0, core_1.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 core_1.AnyError
+            ? (0, core_1.Err)(e)
+            : e instanceof axios_1.CanceledError
+                ? core_1.AbortedError.err(e.message || 'Request has been canceled')
+                : e instanceof axios_1.AxiosError
+                    ? core_1.AnyHowError.err(e.message)
+                    : core_1.UnexpectedError.err(e));
+    });
+    return promise;
+}
+/** 请求拦截器运行核心 */
+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 ((0, core_1.is_err)(res) || (0, core_1.is_ok)(res))
+                res.unwrap(); /* 解包 */
+            else
+                throw core_1.CheckingError.new('RequestInterceptor must return Err<E> or Ok<void>');
+        }
+    });
+}
+/** 响应拦截器运行核心 */
+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 ((0, core_1.is_err)(result) || (0, core_1.is_ok)(result))
+                result = result.unwrap(); /* 解包 */
+            else
+                throw core_1.CheckingError.new('ResponseInterceptor must return Err<E> or Ok<O>');
+        }
+        return wrap ? (0, core_1.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 */
+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 core_1.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();
+};
+exports.see_reqwest = see_reqwest;
+const default_deserialize = (data) => JSON.parse(data.data);
+const default_serialize = (data) => JSON.stringify(data);
+const ws_reqwest = (conf) => {
+    const { url, abort, deserialize = default_deserialize, serialize = default_serialize } = conf;
+    const subject = core_1.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;
+};
+exports.ws_reqwest = ws_reqwest;

package/script/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/script/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/script/lib/{reqwest → core}/factor.js

@@ -13,25 +13,41 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.merge_request = merge_request;
 exports.merge_response = merge_response;
 exports.merge_reqwest = merge_reqwest;
-const fp_1 = require("@chzky/fp");
+const core_1 = require("@chzky/core");
 const core_js_1 = require("./core.js");
-/** ### `merge_request` : 工厂函数 of `Reqwest-request`
-+ 将多个request拦截器合并成一个拦截器
+/** ### `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
 */
 function merge_request(...interceptors) {
     return (conf) => __awaiter(this, void 0, void 0, function* () {
         yield (0, core_js_1.request_interceptor_run)(conf, interceptors);
-        return (0, fp_1.Ok)();
+        return (0, core_1.Ok)();
     });
 }
 function merge_response(...interceptor) {
     return (res) => __awaiter(this, void 0, void 0, function* () {
-        return yield (0, core_js_1.response_interceptor_run)(res, interceptor);
+        return yield (0, core_js_1.response_interceptor_run)(res, interceptor, true);
     });
 }
-/** ### `merge_response` : 工厂函数 of `Reqwest-use`
-+ 快捷生成`ReqwestInterceptor`供`use`使用
-*/
+/** ### `merge_response` : 合并生成`ReqwestInterceptor`
+@Category Factory
+ */
 function merge_reqwest(request, response) {
     return { request, response };
 }