@chzky/reqwest 0.0.1 → 0.1.1

package/README.md

@@ -0,0 +1,314 @@
+# `@chzky/reqwest`: HTTP Request Library for chzky
+[![JSR](https://jsr.io/badges/@chzky/reqwest)](https://jsr.io/@chzky/reqwest)
+
+@chzky/reqwest 是一个基于 Axios 的 HTTP 请求库。它采用函数式编程风格，通过不可变（immutable）的构建器模式和基于 Result 类型（来自 @chzky/core）的错误处理机制来构建和发送请求。
+
+## Features
+
+- **基于 Axios**: 底层使用 `axios` 发送请求，继承其稳定性。
+- **`Result` 驱动**: 所有请求的最终结果都被包装在 `Result<T, E>` 对象中，强制进行显式的错误处理，避免了 `try...catch` 块的泛滥。
+- **不可变 API**: 所有配置方法（如 `.request()`, `.response()`, `.conf()`）都会返回一个新的 `Reqwest` 实例，而不是修改当前实例。这使得创建可复用的基础客户端变得容易。
+- **链式调用**: 通过链式调用组合拦截器来构建请求。
+- **内置工具函数**: 提供了一系列用于 RESTful 请求、数据验证、取消请求和加载状态管理的辅助函数。
+
+## Install
+
+```bash
+pnpm install @chzky/reqwest 
+```
+or deno
+```bash
+deno add jsr:@chzky/reqwest
+```
+
+## 核心概念
+
+### 1. Result 结果类型
+
+本库不通过抛出异常来处理网络或逻辑错误。`dispatch()` 方法返回一个 `Promise<Result<SuccessType, ErrorType>>`。你需要通过 `@chzky/core` 提供的 `Result` 类型来处理请求结果。
+
+### 2. 不可变构建器
+
+`Reqwest` 实例是不可变的。每次调用配置方法时，都会基于当前配置克隆出一个新的实例。
+
+```typescript
+// baseClient 不会改变
+const baseClient = Reqwest.new().conf({ baseURL: '/api' });
+
+// userClient 是一个带有特定拦截器的新实例
+const userClient = baseClient.request(get('/user'));
+
+// postClient 也是一个独立的新实例
+const postClient = baseClient.request(get('/post'));
+```
+
+### 3. 拦截器 (Interceptors)
+
+库的核心功能由拦截器驱动。拦截器是普通的函数，分为两类：
+
+- **请求拦截器 (`RequestInterceptor`)**: 接收 `AxiosRequestConfig` 对象，用于在请求发送前修改配置。它必须返回 `Ok<void>` 或 `Err<E>`。
+- **响应拦截器 (`ResponseInterceptor`)**: 接收上一个拦截器或原始请求的响应数据，用于转换数据。它必须返回 `Ok<NewData>` 或 `Err<E>`。
+
+## 基本用法
+
+下面是一个获取用户数据并提取 `data` 字段的基础示例。
+
+```typescript
+import { Reqwest, get, pick } from '@chzky/reqwest';
+import { is_ok } from '@chzky/core';
+
+interface User {
+  id: number;
+  name: string;
+}
+
+async function fetchUser(id: number) {
+  // 1. 创建一个新的 Reqwest 实例
+  const result = await Reqwest.new()
+    .conf({ baseURL: 'https://jsonplaceholder.typicode.com/todos/' })
+    // 2. 添加一个请求拦截器来设置请求方法和 URL
+    .request(get(`/api/users/${id}`))
+    // 3. 添加一个响应拦截器来提取响应体中的 `data` 字段
+    .response(pick('data'))
+    // 4. 发送请求并等待 Result
+    .dispatch<User>();
+
+  if (is_ok(result)) {
+    const user = result.unwrap();
+    console.log('User data:', user);
+    // -> { id: 1, name: 'John Doe' }
+  } else {
+    const error = result.unwrap_err();
+    console.error('Failed to fetch user:', error.message);
+  }
+}
+
+fetchUser(1);
+```
+
+## [API 参考](https://jsr.io/@chzky/reqwest)
+
+### 添加请求头
+```typescript
+import { header } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .request(header({
+    'Authorization': 'Bearer token',
+    'X-Custom-Header': 'value'
+  }));
+```
+
+### 设置超时
+```typescript
+import { timeout } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .request(timeout(5000));
+```
+
+### 输入验证
+```typescript
+import { input_validate } from '@chzky/reqwest';
+import { z } from 'zod';
+
+const schema = z.object({
+  name: z.string().min(1),
+  age: z.number().min(0)
+});
+
+const client = Reqwest.default()
+  .request(input_validate(schema, 'data'));
+```
+
+### GET 请求
+```typescript
+import { get, pick } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .request(get('/api/users', { page: 1, limit: 10 }))
+  .response(pick('data'));
+
+const result = await client.dispatch();
+```
+
+### POST 请求
+```typescript
+import { post } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .request(post('/api/users', { name: 'John', age: 25 }));
+
+const result = await client.dispatch();
+```
+
+### PUT 请求
+```typescript
+import { put } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .request(put('/api/users/1', { name: 'John Updated' }));
+
+const result = await client.dispatch();
+```
+
+### DELETE 请求
+```typescript
+import { del } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .request(del('/api/users/1'));
+
+const result = await client.dispatch();
+```
+
+### 表单提交
+```typescript
+import { form } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .request(form('/api/upload', {
+    file: fileObject,
+    name: 'document'
+  }));
+
+const result = await client.dispatch();
+```
+
+### 输出验证
+```typescript
+import { output_validate } from '@chzky/reqwest';
+import { z } from 'zod';
+
+const responseSchema = z.object({
+  id: z.number(),
+  name: z.string()
+});
+
+const client = Reqwest.default()
+  .response(output_validate(responseSchema));
+
+const result = await client.dispatch();
+```
+
+### 数据映射
+```typescript
+import { response_map } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .response(response_map(data => ({
+    ...data,
+    processed: true
+  })));
+
+const result = await client.dispatch();
+```
+
+### 数据提取
+```typescript
+import { pick } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .response(pick('data'));
+
+const result = await client.dispatch();
+```
+
+### Server-Sent Events (SSE)
+```typescript
+import { Reqwest, parse_sse_data } from '@chzky/reqwest';
+
+const abort = new AbortController();
+const gen = Reqwest.sse({
+  abort: abort.signal,
+  url: 'https://stream.example.com/events'
+});
+
+// 使用 for await 循环
+for await (const item of gen) {
+  if (/* 条件 */) abort.abort();
+  const message = parse_sse_data(item);
+  console.log(message.data);
+}
+```
+
+### WebSocket
+```typescript
+import { Reqwest } from '@chzky/reqwest';
+
+const abort = new AbortController();
+const ws = Reqwest.ws({
+  url: 'wss://echo.websocket.org',
+  abort: abort.signal,
+  deserialize: data => JSON.parse(data.data),
+  serialize: data => JSON.stringify(data)
+});
+
+ws.subscribe({
+  next: data => console.log('Received:', data),
+  complete: () => console.log('Connection closed')
+});
+
+ws.next({ type: 'message', data: 'Hello' });
+```
+
+### 下载进度
+```typescript
+import { download_process } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .request(download_process(progress => {
+    console.log(`Download progress: ${progress}%`);
+  }));
+```
+
+### 文件下载
+```typescript
+import { open_link, blob2url } from '@chzky/reqwest';
+
+const [cleanup, createUrl] = blob2url();
+
+const client = Reqwest.default()
+  .response(open_link('file.pdf'))
+  .response(createUrl);
+
+const result = await client.dispatch();
+
+// 使用后清理
+cleanup();
+```
+
+### 请求取消
+```typescript
+import { cancel } from '@chzky/reqwest';
+
+const [abortController, interceptor] = cancel();
+
+const client = Reqwest.default()
+  .use(interceptor);
+
+// 取消请求
+abortController.abort();
+```
+
+### 加载状态
+```typescript
+import { loading_control } from '@chzky/reqwest';
+
+const loading = ref(false);
+const [controller, interceptor] = loading_control(loading, {
+  maximum: 10000,
+  maximun_handler: () => console.log('Request timeout')
+});
+
+const client = Reqwest.default()
+  .use(interceptor);
+```
+
+### 延迟请求
+```typescript
+import { wait } from '@chzky/reqwest';
+
+const client = Reqwest.default()
+  .request(wait(1000)); // 延迟 1 秒
+```

package/esm/_dnt.polyfills.d.ts

@@ -1,3 +1,14 @@
+declare global {
+    interface Object {
+        /**
+         * Determines whether an object has a property with the specified name.
+         * @param o An object.
+         * @param v A property name.
+         */
+        hasOwn(o: object, v: PropertyKey): boolean;
+    }
+}
+export {};
 declare global {
     interface PromiseConstructor {
         /**

package/esm/_dnt.polyfills.d.ts.map

@@ -1,10 +1 @@
-{
-  "version": 3,
-  "file": "_dnt.polyfills.d.ts",
-  "sourceRoot": "",
-  "sources": [
-    "../src/_dnt.polyfills.ts"
-  ],
-  "names": [],
-  "mappings": "AAAA,OAAO,CAAC,MAAM,CAAC;IAEb,UAAU,kBAAkB;QAC1B;;;WAGG;QACH,aAAa,CAAC,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;SAAE,CAAC;KAC3H;CACF"
-}
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAeA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC;AACV,OAAO,CAAC,MAAM,CAAC;IAEb,UAAU,kBAAkB;QAC1B;;;WAGG;QACH,aAAa,CAAC,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;SAAE,CAAC;KAC3H;CACF"}

package/esm/_dnt.polyfills.js

@@ -1,68 +1,26 @@
-'use strict'
-const _0x31d5ea = _0xac34
-;(function (_0x218eb6, _0x197562) {
-  const _0xace3fc = _0xac34,
-    _0x162a79 = _0x218eb6()
-  while (!![]) {
-    try {
-      const _0x33bcea =
-        (-parseInt(_0xace3fc(0x1ac)) / 0x1) * (-parseInt(_0xace3fc(0x1b3)) / 0x2) +
-        -parseInt(_0xace3fc(0x1af)) / 0x3 +
-        (-parseInt(_0xace3fc(0x1ad)) / 0x4) * (parseInt(_0xace3fc(0x1b4)) / 0x5) +
-        -parseInt(_0xace3fc(0x1b8)) / 0x6 +
-        (-parseInt(_0xace3fc(0x1b1)) / 0x7) * (-parseInt(_0xace3fc(0x1b6)) / 0x8) +
-        (-parseInt(_0xace3fc(0x1b7)) / 0x9) * (-parseInt(_0xace3fc(0x1b0)) / 0xa) +
-        (parseInt(_0xace3fc(0x1ae)) / 0xb) * (-parseInt(_0xace3fc(0x1b9)) / 0xc)
-      if (_0x33bcea === _0x197562) break
-      else _0x162a79['push'](_0x162a79['shift']())
-    } catch (_0x79caa0) {
-      _0x162a79['push'](_0x162a79['shift']())
-    }
-  }
-})(_0x1840, 0x90753)
-function _0xac34(_0x42e44f, _0x1ce41b) {
-  const _0x184000 = _0x1840()
-  return (
-    (_0xac34 = function (_0xac34be, _0x449ecd) {
-      _0xac34be = _0xac34be - 0x1ab
-      let _0x32ec58 = _0x184000[_0xac34be]
-      return _0x32ec58
-    }),
-    _0xac34(_0x42e44f, _0x1ce41b)
-  )
+// https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
+if (!Object.hasOwn) {
+    Object.defineProperty(Object, "hasOwn", {
+        value: function (object, property) {
+            if (object == null) {
+                throw new TypeError("Cannot convert undefined or null to object");
+            }
+            return Object.prototype.hasOwnProperty.call(Object(object), property);
+        },
+        configurable: true,
+        enumerable: false,
+        writable: true,
+    });
 }
-Promise[_0x31d5ea(0x1ab)] === undefined &&
-  (Promise[_0x31d5ea(0x1ab)] = () => {
-    const _0x3518a6 = _0x31d5ea,
-      _0x5a4145 = {}
-    return (
-      (_0x5a4145[_0x3518a6(0x1b2)] = new Promise((_0x449ccb, _0x2f4282) => {
-        const _0x2589c7 = _0x3518a6
-        ;(_0x5a4145['resolve'] = _0x449ccb), (_0x5a4145[_0x2589c7(0x1b5)] = _0x2f4282)
-      })),
-      _0x5a4145
-    )
-  })
-function _0x1840() {
-  const _0x20b7b6 = [
-    '185fhOclK',
-    'reject',
-    '24KaZOkY',
-    '8375013pOGIFB',
-    '1183158wBXZLS',
-    '684YPnMsq',
-    'withResolvers',
-    '495067IzAadC',
-    '90276LHDCpv',
-    '60401QhgZeF',
-    '1303824UqgQha',
-    '10hgNBTH',
-    '1051981DvvVBk',
-    'promise',
-    '4GxaeKo',
-  ]
-  _0x1840 = function () {
-    return _0x20b7b6
-  }
-  return _0x1840()
+// https://github.com/tc39/proposal-promise-with-resolvers/blob/3a78801e073e99217dbeb2c43ba7212f3bdc8b83/polyfills.js#L1C1-L9C2
+if (Promise.withResolvers === undefined) {
+    Promise.withResolvers = () => {
+        const out = {};
+        out.promise = new Promise((resolve_, reject_) => {
+            out.resolve = resolve_;
+            out.reject = reject_;
+        });
+        return out;
+    };
 }
+export {};

package/esm/_dnt.shims.d.ts

@@ -1,14 +1,2 @@
-import { Deno } from "@deno/shim-deno";
-export { Deno } from "@deno/shim-deno";
-export { alert, confirm, prompt } from "@deno/shim-prompts";
-import { setInterval, setTimeout } from "@deno/shim-timers";
-export { setInterval, setTimeout } from "@deno/shim-timers";
-export declare const dntGlobalThis: Omit<typeof globalThis, "alert" | "confirm" | "prompt" | "setInterval" | "setTimeout" | "Deno"> & {
-    Deno: typeof Deno;
-    alert: typeof globalThis.alert;
-    confirm: typeof globalThis.confirm;
-    prompt: typeof globalThis.prompt;
-    setInterval: typeof setInterval;
-    setTimeout: typeof setTimeout;
-};
+export declare const dntGlobalThis: Omit<typeof globalThis, never>;
 //# sourceMappingURL=_dnt.shims.d.ts.map

package/esm/_dnt.shims.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAU5D,eAAO,MAAM,aAAa;;;;;;;CAA2C,CAAC"}
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,gCAA2C,CAAC"}

package/esm/_dnt.shims.js

@@ -1 +1,57 @@
-(function(_0x1bfd95,_0x39097d){const _0x411f69=_0x4032,_0x31b370=_0x1bfd95();while(!![]){try{const _0x18787d=-parseInt(_0x411f69(0xed))/0x1*(parseInt(_0x411f69(0xef))/0x2)+parseInt(_0x411f69(0xee))/0x3+-parseInt(_0x411f69(0xe7))/0x4*(parseInt(_0x411f69(0xe9))/0x5)+parseInt(_0x411f69(0xe4))/0x6*(-parseInt(_0x411f69(0xec))/0x7)+-parseInt(_0x411f69(0xe3))/0x8*(-parseInt(_0x411f69(0xeb))/0x9)+-parseInt(_0x411f69(0xea))/0xa+parseInt(_0x411f69(0xe1))/0xb;if(_0x18787d===_0x39097d)break;else _0x31b370['push'](_0x31b370['shift']());}catch(_0x4781b0){_0x31b370['push'](_0x31b370['shift']());}}}(_0x5be7,0x7e7c7));import{Deno}from'@deno/shim-deno';export{Deno}from'@deno/shim-deno';function _0x4032(_0x5acdd8,_0x7ad30f){const _0x5be73c=_0x5be7();return _0x4032=function(_0x403274,_0x21cadc){_0x403274=_0x403274-0xe1;let _0x51f016=_0x5be73c[_0x403274];return _0x51f016;},_0x4032(_0x5acdd8,_0x7ad30f);}import{alert,confirm,prompt}from'@deno/shim-prompts';export{alert,confirm,prompt}from'@deno/shim-prompts';import{setInterval,setTimeout}from'@deno/shim-timers';function _0x5be7(){const _0x5c70ab=['7280170wXGpqC','212526EPPdXw','7qtoZFC','1BAnbyJ','483219avhdbg','1032328CiCAdz','7816149AlTGro','has','328YzAgoX','241482mMMCTj','filter','getOwnPropertyDescriptor','4COLHAT','ownKeys','186455dwBDyQ'];_0x5be7=function(){return _0x5c70ab;};return _0x5be7();}export{setInterval,setTimeout}from'@deno/shim-timers';const dntGlobals={'Deno':Deno,'alert':alert,'confirm':confirm,'prompt':prompt,'setInterval':setInterval,'setTimeout':setTimeout};export const dntGlobalThis=createMergeProxy(globalThis,dntGlobals);function createMergeProxy(_0x494ef5,_0xad92f9){return new Proxy(_0x494ef5,{'get'(_0x43c33c,_0xa03f44,_0x25c92e){return _0xa03f44 in _0xad92f9?_0xad92f9[_0xa03f44]:_0x494ef5[_0xa03f44];},'set'(_0x2b9dba,_0x11a134,_0x10c824){return _0x11a134 in _0xad92f9&&delete _0xad92f9[_0x11a134],_0x494ef5[_0x11a134]=_0x10c824,!![];},'deleteProperty'(_0x4ecc5d,_0xa9b848){let _0x310d92=![];return _0xa9b848 in _0xad92f9&&(delete _0xad92f9[_0xa9b848],_0x310d92=!![]),_0xa9b848 in _0x494ef5&&(delete _0x494ef5[_0xa9b848],_0x310d92=!![]),_0x310d92;},'ownKeys'(_0x67fb0b){const _0xa5e994=_0x4032,_0x34de2e=Reflect[_0xa5e994(0xe8)](_0x494ef5),_0x3218ca=Reflect[_0xa5e994(0xe8)](_0xad92f9),_0xfb95e9=new Set(_0x3218ca);return[..._0x34de2e[_0xa5e994(0xe5)](_0x5578e1=>!_0xfb95e9[_0xa5e994(0xe2)](_0x5578e1)),..._0x3218ca];},'defineProperty'(_0x5a3aa1,_0x1c6455,_0xb67c49){return _0x1c6455 in _0xad92f9&&delete _0xad92f9[_0x1c6455],Reflect['defineProperty'](_0x494ef5,_0x1c6455,_0xb67c49),!![];},'getOwnPropertyDescriptor'(_0xee0720,_0x34eb20){const _0x4f72bf=_0x4032;return _0x34eb20 in _0xad92f9?Reflect[_0x4f72bf(0xe6)](_0xad92f9,_0x34eb20):Reflect[_0x4f72bf(0xe6)](_0x494ef5,_0x34eb20);},'has'(_0x11bdb5,_0x46c9d6){return _0x46c9d6 in _0xad92f9||_0x46c9d6 in _0x494ef5;}});}
+const dntGlobals = {};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

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