soon-fetch 4.0.0-beta.1 → 4.0.0-beta.3

package/README.md

@@ -1,1417 +1,1417 @@
-[English](#soon-fetch) | [中文](#soon-fetch-1) | [Installation](#安装-installation)
-
-<!-- omit in toc -->
-
-### soon-fetch
-
-**A lightweight http request lib , alternative to axios with timeout, request reusing, race, response cache ...**
-
-> - 🌐 automatic parse restful api url parameters
-> - ⭐ rapid define a request api
-> - ⌛ timeout disconnect
-> - 📦 request reusing
-> - 🚀 request race
-> - 📝 response cache
-> - 🔤 automatic serialization of JSON
-> - 📏 .min size less than **6K**, smaller after zip
-> - 💡 smart type tips with Typescript
-
-- [Example](#example)
-- [Features](#features)
-  - [Shortcut](#shortcut)
-  - [Restful Url Params](#restful-url-params)
-  - [Timeout](#timeout)
-  - [Share pending request](#share-pending-request)
-  - [Response cache](#response-cache)
-  - [Request race](#request-race)
-  - [Rapid Define APIs](#rapid-define-apis)
-- [API](#api)
-
-### Example
-
-> [github: soon-admin-vue3 ](https://github.com/leafio/soon-admin-vue3)  
-> [github: soon-admin-react-nextjs ](https://github.com/leafio/soon-admin-react-nextjs)
-
-```typescript
-import { createSoon, soonFetch } from "soon-fetch";
-
-// 使用 soonFetch 作为基础请求函数
-const request = async <T>(url: string, options?: SoonOptions) => {
-  const isGet = !options?.method || options?.method.toLocaleLowerCase() === "get";
-  const response = await soonFetch<T>({
-    url,
-    options,
-    baseURL: '/api',
-    baseOptions: {
-      timeout: 20 * 1000,
-      headers: new Headers({
-        Authorization: "Bearer " + localStorage.getItem("token"),
-      }),
-      share: isGet ? true : false,
-      staleTime: isGet ? 2 * 1000 : 0,
-    },
-  });
-  return response;
-};
-
-const soon = createSoon(request);
-
-/** GET */
-soon.get("/user?id=123");
-soon.get("/user", { query: { id: 123 } });
-soon.get("/user/:id", { params: { id: 123 } });
-
-/** POST */
-soon.post("/login", { body: { username: "admin", password: "123456" } });
-
-/**Define API */
-export const login = soon
-  .POST("/user/login")
-  .Body<{ username: string; password: string }>()
-  .Ok<{ token: string }>();
-//the develop tools will have type tips for request and response
-login({ username: "admin", password: "123" }).then((res) => {
-  localStorage.setItem("token", res.token);
-});
-```
-
-### Features
-
-##### Shortcut
-
-```typescript
-soon.get(url, options);
-soon.post(url, options);
-soon.put(url, options);
-soon.patch(url, options);
-soon.delete(url, options);
-soon.head(url, options);
-soon.options(url, options);
-```
-
-##### Restful Url Params
-
-url like /:key , will handle the key
-
-```typescript
-soon.get("/api/user/:id", { params: { id: 1 } });
-// api/user/1
-soon.get("/api/:job/:year", { params: { job: "engineer", year: 5 } });
-//api/engineer/5
-```
-
-##### Timeout
-
-```typescript
-//** the request level timeout, will override the instance level timeout  */
-soon.get(url, { timeout: 1000 * 20 });
-```
-
-##### Share pending request
-
-If a request is made again before the first completes, will reuse the first request instead of making a new request.
-
-```ts
-soon.get(url, { share: true });
-```
-
-##### Response cache
-
-A cached response will be returned if the request is made again within the specified time.
-
-```ts
-soon.get(url, { staleTime: 1000 * 60 * 5 });
-```
-
-##### Request race
-
-‌If a second request is made before the first completes, abort the first to avoid race conditions from out-of-order responses.
-
-```tsx
-import { useEffect, useRef, useState } from "react";
-
-type User = { name: string; job: string };
-const api = soon.GET("/api/users").Query<{ page: number }>().Ok<User[]>();
-export default function App() {
-  const refAbort = useRef([]);
-  const [list, setList] = useState<User[]>([]);
-  const [page, setPage] = useState(1);
-  useEffect(() => {
-    api({ page }, { aborts: refAbort.current })
-      .then(setList)
-      .catch(console.log);
-  }, [page]);
-  return (
-    <div>
-      <button onClick={() => setPage((pre) => pre + 1)}>next</button>
-      <div>
-        {list.map((item) => (
-          <div key={item.name}>{item.name}</div>
-        ))}
-      </div>
-    </div>
-  );
-}
-```
-
-##### Rapid Define APIs
-
-```typescript
-//can be GET POST PATCH PUT DELETE
-  soon.GET(url:string).Query<Query>().Ok<Response>()
-  soon.POST(url:string).Body<Body>().Ok<Response>()
-  soon.GET(url:string).Options({ timeout: 5000 }).Ok<Response>()
-  soon.POST(url:string).Body<Body>().Options({ timeout: 5000 }).Ok<Response>()
-//define an api
-export const getUserInfo = soon.GET("/user/:id").Ok();
-//then use in any where
-getUserInfo({ id: 2 }).then((res) => console.log(res));
-//define an api with options
-export const getUserInfoWithOptions = soon.GET("/user/:id").Options({ timeout: 5000 }).Ok();
-//then use in any where
-getUserInfoWithOptions({ id: 2 }).then((res) => console.log(res));
-
-//with typescript,
-export const login = soon
-  .POST("/user/login")
-  .Body<{ username: string; password: string }>()
-  .Ok<{ token: string }>();
-//the develop tools will have type tips for request and response
-login({ username: "admin", password: "123" }).then((res) => {
-  localStorage.setItem("token", res.token);
-});
-```
-
-### API
-
-#### SoonOptions
-
-```ts
-// function fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>
-// RequestInit  is fetch's init options
-type SoonOptions = Omit<RequestInit, "body"> & {
-  body?: RequestInit["body"] | object;
-  query?:
-    | Record<
-        string,
-        | string
-        | number
-        | boolean
-        | null
-        | undefined
-        | (string | number | boolean | null | undefined)[]
-      >
-    | URLSearchParams;
-  params?: Record<string, string | number>;
-  timeout?: number;
-  aborts?: AbortController[] | never[];
-  share?: boolean;
-  staleTime?: number;
-};
-```
-
-#### createSoon
-
-Create a soon request instance.
-
-**Parameters:**
-
-- `request`: A function to handle the actual request, receives url and options, returns a Promise
-
-**Returns:** An object containing request method, API methods (GET, POST, PUT, DELETE, PATCH), and shortcut methods (get, post, put, delete, patch, head, options)
-
-**Example:**
-
-```typescript
-const soon = createSoon(
-  async <T>(url: string, options?: SoonOptions): Promise<T> => {
-    const response = await fetch(url, options);
-    return response.json();
-  }
-);
-
-// Usage example
-const data = await soon.get<{ id: number; name: string }[]> ("/api/users");
-
-// Define API with options
-export const login = soon
-  .POST("/user/login")
-  .Body<{ username: string; password: string }>()
-  .Ok<{ token: string }>();
-
-login({ username: "admin", password: "123" }).then((res) => {
-  localStorage.setItem("token", res.token);
-});
-```
-
-#### createShortApi
-
-Factory function to create API shortcut methods.
-Used to generate type-safe API calling methods, supporting path parameters, query parameters, and request body.
-
-**Parameters:**
-
-- `wrapper`: Wrapper function to handle actual request logic
-
-**Returns:** An object containing GET, POST, PUT, DELETE, PATCH and other methods, each method supports chain calling
-
-**Example:**
-
-```typescript
-const API = createShortApi(
-  async <T>(url: string, method: string, params: Record<string, string | number> | undefined, query: any, body: any, options: any): Promise<T> => {
-    // Handle request logic
-    const { url: _url } = parseUrl(url, { params, query });
-    const response = await fetch(_url, { ...options, method, body });
-    return response.json();
-  }
-);
-
-// Usage example
-const getUser = API.GET("/api/users/:id").Ok<{ id: number; name: string }>();
-const userData = await getUser({ id: 1 });
-```
-
-#### createShortMethods
-
-Factory function to create shortcut methods.
-
-**Parameters:**
-
-- `methods`: HTTP methods array
-- `wrapper`: Wrapper function that receives method name and returns a function to process requests
-
-**Returns:** Shortcut call object containing specified methods
-
-**Example:**
-
-```typescript
-const methods = createShortMethods(["get", "post"] as const, (method) => {
-  return async <T>(url: string, options?: SoonOptions): Promise<T> => {
-    const response = await fetch(url, { ...options, method });
-    return response.json();
-  };
-});
-// Usage: methods.get<{ id: number; name: string }[]>('/api/users')
-```
-
-#### parseUrlOptions
-
-Parse URL options.
-
-**Parameters:**
-
-- `urlOptions`: Object containing url, options, baseURL and baseOptions
-
-**Returns:** Tuple of processed url and options
-
-**Example:**
-
-```typescript
-const [url, options] = parseUrlOptions({
-  url: "/api/users/:id",
-  options: { params: { id: "123" } },
-  baseURL: "https://api.example.com",
-});
-// Returns: ['https://api.example.com/api/users/123', options]
-```
-
-#### mergeHeaders
-
-Merge multiple Headers objects.
-
-**Parameters:**
-
-- `headersList`: List of Headers objects to merge
-
-**Returns:** Merged Headers object, later ones will overwrite earlier ones with the same name
-
-**Example:**
-
-```typescript
-const headers1: HeadersInit = { "Content-Type": "application/json" };
-const headers2: HeadersInit = { Authorization: "Bearer token" };
-const mergedHeaders = mergeHeaders(headers1, headers2);
-```
-
-#### mergeSignals
-
-Merge multiple AbortSignal signals.
-
-**Parameters:**
-
-- `signals`: Array of AbortSignals to merge
-- `timeout`: Optional timeout time (milliseconds)
-
-**Returns:** Merged AbortSignal, any signal termination will trigger termination
-
-**Example:**
-
-```typescript
-const controller1 = new AbortController();
-const controller2 = new AbortController();
-const mergedSignal = mergeSignals(
-  [controller1.signal, controller2.signal],
-  5000
-);
-```
-
-#### mergeUrl
-
-Merge URL and its related parameters.
-Handle baseURL, path parameters and query parameters to generate complete URL.
-
-**Parameters:**
-
-- `url`: Original URL
-- `config`: Configuration object, including query parameters, path parameters and base URL
-
-**Returns:** Processed complete URL
-
-**Example:**
-
-```typescript
-const { url } = parseUrl("/api/users/:id", {
-  params: { id: "123" },
-  query: { filter: "active" },
-  baseURL: "https://api.example.com",
-});
-// Returns: 'https://api.example.com/api/users/123?filter=active'
-```
-
-#### mergeOptions
-
-Merge multiple option objects.
-Merge request options, including special handling of headers and signals.
-
-**Parameters:**
-
-- `optionsList`: List of option objects to merge
-
-**Returns:** Merged option object
-
-**Example:**
-
-```typescript
-const defaultOptions = {
-  timeout: 5000,
-  headers: { "Content-Type": "application/json" },
-};
-const requestOptions = {
-  method: "POST",
-  body: JSON.stringify({ name: "John" }),
-};
-const mergedOptions = mergeOptions(defaultOptions, requestOptions);
-```
-
-#### isBodyJson
-
-Determine if the request body is a JSON object.
-Check if body is a plain object, not special types like FormData or Blob.
-
-**Parameters:**
-
-- `body`: Request body
-
-**Returns:** Returns true if it is a JSON object, otherwise false
-
-**Example:**
-
-```typescript
-isBodyJson({ name: "John" }); // true
-isBodyJson(new FormData()); // false
-isBodyJson("string"); // false
-```
-
-#### genRequestKey
-
-Generate a unique identification key for the request.
-Generate a unique key value based on the request's URL, method, headers, body, query parameters, etc., used for caching and request sharing.
-
-**Parameters:**
-
-- `req`: Request object containing url and options
-
-**Returns:** Unique identification string of the request
-
-**Example:**
-
-```typescript
-const key = genRequestKey({
-  url: "/api/users",
-  options: { method: "GET", params: { id: 1 } },
-});
-```
-
-#### raceAbort
-
-Race condition handling function.
-Used to handle request race conditions, terminating previous requests.
-
-**Parameters:**
-
-- `abortController`: Controller of the current request
-- `controllers`: Array of existing controllers
-
-**Example:**
-
-```typescript
-const controller = new AbortController();
-const controllers: AbortController[] = [];
-// 注意：raceAbort 函数已不再直接导出，而是通过 createRequestStore 使用
-```
-
-#### createRequestStore
-
-Create request store instance.
-Provides request caching, sharing, and race condition handling.
-
-**Parameters:**
-
-- `options`: Configuration options
-  - `maxCacheSize`: Maximum cache size (default: 100000)
-  - `checkInterval`: Cache check interval in milliseconds (default: 60000)
-
-**Returns:** Request store object with the following methods:
-- `entry(key)`: Get entry for specific request key
-- `dispose()`: Dispose the store and clear intervals
-- `get(key)`: Get request by key
-- `set(key, value)`: Set request by key
-- `remove(key)`: Remove request by key
-- `getAll()`: Get all requests
-- `removeAll()`: Remove all requests
-- `clearCache()`: Clear all cache
-- `clearExpiredCache()`: Clear expired cache
-- `abortAll()`: Abort all requests
-
-**Example:**
-
-```typescript
-const store = createRequestStore({ maxCacheSize: 1000, checkInterval: 30000 });
-// Use store in requests
-```
-
-#### deepSort
-
-Deep sort object keys.
-Recursively sort the keys of an object to generate a stable object serialization result.
-
-**Parameters:**
-
-- `obj`: Object to sort
-- `sortArr`: Whether to sort arrays (default: false)
-
-**Returns:** Object with sorted keys
-
-**Example:**
-
-```typescript
-const obj = { b: 2, a: 1, c: { z: 3, y: 2 } };
-const sorted = deepSort(obj);
-// Returns: { a: 1, b: 2, c: { y: 2, z: 3 } }
-```
-
-#### createSilentRefresh
-
-Create silent refresh instance.
-Used to handle silent refresh functionality when token expires.
-
-**Parameters:**
-
-- `refresh_token_fn`: Function to refresh token
-
-**Returns:** Function that accepts success and failure callbacks
-
-**Example:**
-
-```typescript
-const silentRefresh = createSilentRefresh(async () => {
-  // Refresh token logic
-  await refreshToken();
-});
-
-// Usage example
-silentRefresh(
-  () => console.log("Refresh successful"),
-  () => console.log("Refresh failed")
-);
-```
-
-#### soonFetch
-
-A lightweight fetch wrapper with caching, sharing, and race condition handling.
-
-**Parameters:**
-
-- `config`: Configuration object
-  - `url`: Request URL
-  - `options`: Request options (SoonOptions)
-  - `baseURL`: Base URL
-  - `baseOptions`: Base request options
-  - `store`: Custom request store
-  - `sortRequestKey`: Whether to sort request key
-
-**Returns:** Promise that resolves to the response
-
-**Example:**
-
-```typescript
-const data = await soonFetch<User[]>({
-  url: "/api/users",
-  options: {
-    method: "GET",
-    query: { page: 1 },
-    share: true,
-    staleTime: 5000,
-  },
-  baseURL: "https://api.example.com",
-});
-```
-
-#### parseWithBase
-
-Parse base URL configuration.
-Process baseURL, headers, body and other configuration items to generate final request configuration.
-
-**Parameters:**
-
-- `urlOptions`: Object containing url, options, baseURL and baseOptions
-
-**Returns:** Processed url, options, is_body_json and abortController
-
-**Example:**
-
-```typescript
-const result = parseWithBase({
-  url: "/api/users",
-  options: { method: "GET" },
-  baseURL: "https://api.example.com",
-});
-```
-
-#### toFormData
-
-Convert object to FormData.
-Used to convert plain objects to FormData format, supports files and regular values.
-
-**Parameters:**
-
-- `body`: Object to convert
-
-**Returns:** Converted FormData object
-
-**Example:**
-
-```typescript
-const formData = toFormData({
-  name: "John",
-  avatar: fileBlob,
-  age: 30,
-});
-```
-
-#### progressDownload
-
-Download with progress tracking.
-Used to download files with progress updates.
-
-**Parameters:**
-
-- `response`: Response object
-- `onProgress`: Progress callback function
-
-**Returns:** Promise that resolves to ArrayBuffer
-
-**Example:**
-
-```typescript
-const response = await fetch("/api/download");
-const buffer = await progressDownload(response, (progress, downloaded, total) => {
-  console.log(`Progress: ${progress}%, Downloaded: ${downloaded}/${total}`);
-});
-```
-
-#### progressReadBody
-
-Read response body with progress tracking.
-Used to read response bodies with progress updates.
-
-**Parameters:**
-
-- `body`: ReadableStream<Uint8Array>
-- `onProgress`: Progress callback function
-- `total`: Total size in bytes (default: 0)
-
-**Returns:** Promise that resolves to ArrayBuffer
-
-**Example:**
-
-```typescript
-const response = await fetch("/api/download");
-const buffer = await progressReadBody(response.body!, (progress, downloaded, total) => {
-  console.log(`Progress: ${progress}%, Downloaded: ${downloaded}/${total}`);
-});
-```
-
-#### parseOptions
-
-Parse and merge request options.
-Used to process request options, including baseURL, headers, and body.
-
-**Parameters:**
-
-- `urlOptions`: Object containing url, options, baseURL, and baseOptions
-
-**Returns:** Object containing parsed url, options, is_body_json, and abortController
-
-**Example:**
-
-```typescript
-const parsed = parseOptions({
-  url: "/api/users",
-  options: { method: "GET", query: { page: 1 } },
-  baseURL: "https://api.example.com",
-  baseOptions: { timeout: 5000 },
-});
-```
-
-#### requestWithStore
-
-Request wrapper with store support.
-Used to handle requests with caching, sharing, and race condition handling.
-
-**Parameters:**
-
-- `store`: Request store instance
-- `requestFn`: Request function
-- `requestKey`: Request key
-- `fetchAbort`: AbortController
-- `options`: Options object
-
-**Returns:** Promise that resolves to the response
-
-**Example:**
-
-```typescript
-const store = createRequestStore();
-const data = await requestWithStore(store, () => fetch(url, options), requestKey, abortController, {
-  share: true,
-  staleTime: 5000,
-});
-```
-
-[English](#soon-fetch) | [中文](#soon-fetch-1) | [Installation](#安装-installation)
-
-<!-- omit in toc -->
-
-#### soon-fetch
-
-**极轻量的请求库，不到 6K**
-
-> - 🌐 自动解析 rest Url 的参数
-> - ⭐ 快捷定义请求 api
-> - ⌛ 超时断开
-> - 📦 请求复用
-> - 🚀 请求竞态
-> - 📝 响应缓存
-> - 🔤 自动处理 JSON
-> - 📏 不到 **6K** , zip 后会更小
-> - 💡 用 typescript 有智能类型提醒
-
-- [示例](#示例)
-
-- [特别功能](#特别功能)
-
-  - [快捷方法](#快捷方法)
-  - [Restful Url 参数自动处理](#restful-url-参数自动处理)
-  - [共享未完成的请求](#共享未完成的请求)
-  - [超时](#超时)
-  - [响应缓存](#响应缓存)
-  - [请求竞态](#请求竞态)
-  - [快速定义 API](#快速定义-api)
-
-- [API](#api-1)
-
-### 示例
-
-> [github: soon-admin-vue3 ](https://github.com/leafio/soon-admin-vue3)  
-> [github: soon-admin-react-nextjs ](https://github.com/leafio/soon-admin-react-nextjs)
-
-```typescript
-import { createSoon, soonFetch } from "soon-fetch";
-
-// 使用 soonFetch 作为基础请求函数
-const request = async <T>(url: string, options?: SoonOptions) => {
-  const isGet = !options?.method || options?.method.toLocaleLowerCase() === "get";
-  const response = await soonFetch<T>({
-    url,
-    options,
-    baseURL: '/api',
-    baseOptions: {
-      timeout: 20 * 1000,
-      headers: new Headers({
-        Authorization: "Bearer " + localStorage.getItem("token"),
-      }),
-      share: isGet ? true : false,
-      staleTime: isGet ? 2 * 1000 : 0,
-    },
-  });
-  return response;
-};
-
-const soon = createSoon(request);
-
-/** GET */
-soon.get("/user?id=123");
-soon.get("/user", { query: { id: 123 } });
-soon.get("/user/:id", { params: { id: 123 } });
-
-/** POST */
-soon.post("/login", { body: { username: "admin", password: "123456" } });
-
-/**定义 API */
-export const login = soon
-  .POST("/user/login")
-  .Body<{ username: string; password: string }>()
-  .Ok<{ token: string }>();
-
-//开发工具会有请求和响应的智能提醒
-login({ username: "admin", password: "123" }).then((res) => {
-  localStorage.setItem("token", res.token);
-});
-```
-
-### 特别功能
-
-##### 快捷方法
-
-```typescript
-soon.get(url, options);
-soon.post(url, options);
-soon.put(url, options);
-soon.patch(url, options);
-soon.delete(url, options);
-soon.head(url, options);
-soon.options(url, options);
-```
-
-###### Restful Url 参数自动处理
-
-url 包含 /:key 会解析匹配 key
-
-```typescript
-soon.get("/api/user/:id", { params: { id: 1 } });
-// api/user/1
-soon.get("/api/:job/:year", { params: { job: "engineer", year: 5 } });
-//api/engineer/5
-```
-
-##### 超时
-
-```typescript
-//** 请求级超时, 会覆盖实例级超时  */
-soon.get(url, { timeout: 1000 * 20 });
-```
-
-##### 共享未完成的请求
-
-如果在第一个请求完成之前再次发起相同的请求，则会复用第一个请求，而不是发起新的请求。
-
-```ts
-soon.get(url, { share: true });
-```
-
-##### 响应缓存
-
-如果在指定时间内再次发起相同的请求，则会返回缓存的响应。
-
-```ts
-soon.get(url, { staleTime: 1000 * 60 * 5 });
-```
-
-##### 请求竞态
-
-如果在第一个请求完成之前发起第二个请求，则会中止第一个请求，以避免因响应顺序错乱导致的问题。
-
-```tsx
-import { useEffect, useRef, useState } from "react";
-
-type User = { name: string; job: string };
-const api = soon.GET("/api/users").Query<{ page: number }>().Ok<User[]>();
-export default function App() {
-  const refAbort = useRef([]);
-  const [list, setList] = useState<User[]>([]);
-  const [page, setPage] = useState(1);
-  useEffect(() => {
-    api({ page }, { aborts: refAbort.current })
-      .then(setList)
-      .catch(console.log);
-  }, [page]);
-  return (
-    <div>
-      <button onClick={() => setPage((pre) => pre + 1)}>next</button>
-      <div>
-        {list.map((item) => (
-          <div key={item.name}>{item.name}</div>
-        ))}
-      </div>
-    </div>
-  );
-}
-```
-
-##### 快速定义 API
-
-```ts
-  //可以是 GET POST PATCH PUT DELETE
-  //GET 请求数据传递至query,其他方法请求数据传递至body
-  soon.GET(url:string).Query<Query>().Ok<Response>()
-  soon.POST(url:string).Body<Body>().Ok<Response>()
-  soon.GET(url:string).Options({ timeout: 5000 }).Ok<Response>()
-  soon.POST(url:string).Body<Body>().Options({ timeout: 5000 }).Ok<Response>()
-
-  //定义一个api
- export const getUserInfo=soon.GET('/user/:id').Ok()
-  //使用
-  getUserInfo({id:2}).then(res=>console.log(res))
-  //定义一个带选项的api
- export const getUserInfoWithOptions=soon.GET('/user/:id').Options({ timeout: 5000 }).Ok()
-  //使用
-  getUserInfoWithOptions({id:2}).then(res=>console.log(res))
-
-  //用typescript,
- export const login=soon
-  .POST('/user/login')
-  .Body<{username:string,password:string}>()
-  .Ok<{token:string}>()
- //开发工具会有请求和响应的智能提醒
-  login({username:'admin',password:'123'}).then(res=>{
-    localStorage.setItem('token', res.token);
-  })
-```
-
-### API
-
-#### SoonOptions
-
-```ts
-// function fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>
-// RequestInit  为原生 fetch 的 init 选项
-type SoonOptions = Omit<RequestInit, "body"> & {
-  body?: RequestInit["body"] | object;
-  query?:
-    | Record<
-        string,
-        | string
-        | number
-        | boolean
-        | null
-        | undefined
-        | (string | number | boolean | null | undefined)[]
-      >
-    | URLSearchParams;
-  params?: Record<string, string | number>;
-  timeout?: number;
-  aborts?: AbortController[] | never[];
-  share?: boolean;
-  staleTime?: number;
-};
-```
-
-#### createSoon
-
-创建一个 soon 请求实例。
-
-**参数:**
-
-- `request`: 用于处理实际请求的函数，接收 url 和 options，返回一个 Promise
-
-**返回:** 包含 request 方法、API 方法（GET、POST、PUT、DELETE、PATCH）和快捷方法（get、post、put、delete、patch、head、options）的对象
-
-**示例:**
-
-```typescript
-const soon = createSoon(
-  async (url, options) => {
-    const response = await fetch(url, options);
-    return response.json();
-  }
-);
-
-// 使用示例
-const data = await soon.get("/api/users");
-
-// 定义带选项的 API
-export const login = soon
-  .POST("/user/login")
-  .Body<{ username: string; password: string }>()
-  .Ok<{ token: string }>();
-
-login({ username: "admin", password: "123" }).then((res) => {
-  localStorage.setItem("token", res.token);
-});
-```
-
-#### createShortApi
-
-创建 API 快捷方法的工厂函数。
-用于生成类型安全的 API 调用方法，支持路径参数、查询参数和请求体。
-
-**参数:**
-
-- `wrapper`: 包装函数，用于处理实际的请求逻辑
-
-**返回:** 包含 GET、POST、PUT、DELETE、PATCH 等方法的对象，每个方法都支持链式调用
-
-**示例:**
-
-```typescript
-const API = createShortApi(
-  async (url, method, params, query, body, options) => {
-    // 处理请求逻辑
-    const _url = mergeUrl(url, { params, query });
-    const response = await fetch(_url, { ...options, method, body });
-    return response.json();
-  }
-);
-
-// 使用示例
-const getUser = API.GET("/api/users/:id").Ok();
-const userData = await getUser({ id: 1 });
-```
-
-#### createShortMethods
-
-创建快捷方法的工厂函数。
-
-**参数:**
-
-- `methods`: HTTP 方法数组
-- `wrapper`: 包装函数，接收方法名，返回处理请求的函数
-
-**返回:** 包含指定方法的快捷调用对象
-
-**示例:**
-
-```typescript
-const methods = createShortMethods(["get", "post"] as const, (method) => {
-  return (url, options) => fetch(url, { ...options, method });
-});
-// 使用: methods.get('/api/users')
-```
-
-#### parseUrlOptions
-
-解析 URL 选项。
-
-**参数:**
-
-- `urlOptions`: 包含 url、options、baseURL 和 baseOptions 的对象
-
-**返回:** 处理后的 url 和 options 元组
-
-**示例:**
-
-```typescript
-const [url, options] = parseUrlOptions({
-  url: "/api/users/:id",
-  options: { params: { id: "123" } },
-  baseURL: "https://api.example.com",
-});
-// 返回: ['https://api.example.com/api/users/123', options]
-```
-
-#### mergeHeaders
-
-合并多个 Headers 对象。
-
-**参数:**
-
-- `headersList`: 要合并的 Headers 对象列表
-
-**返回:** 合并后的 Headers 对象，后面的会覆盖前面的同名 header
-
-**示例:**
-
-```typescript
-const headers1: HeadersInit = { "Content-Type": "application/json" };
-const headers2: HeadersInit = { Authorization: "Bearer token" };
-const mergedHeaders = mergeHeaders(headers1, headers2);
-```
-
-#### mergeSignals
-
-合并多个 AbortSignal 信号。
-
-**参数:**
-
-- `signals`: 要合并的 AbortSignal 数组
-- `timeout`: 可选的超时时间（毫秒）
-
-**返回:** 合并后的 AbortSignal，任意一个信号终止都会触发终止
-
-**示例:**
-
-```typescript
-const controller1 = new AbortController();
-const controller2 = new AbortController();
-const mergedSignal = mergeSignals(
-  [controller1.signal, controller2.signal],
-  5000
-);
-```
-
-#### mergeUrl
-
-合并 URL 及其相关参数。
-处理 baseURL、路径参数和查询参数，生成完整 URL。
-
-**参数:**
-
-- `url`: 原始 URL
-- `config`: 配置对象，包含查询参数、路径参数和基础 URL
-
-**返回:** 处理后的完整 URL
-
-**示例:**
-
-```typescript
-const url = mergeUrl("/api/users/:id", {
-  params: { id: "123" },
-  query: { filter: "active" },
-  baseURL: "https://api.example.com",
-});
-// 返回: 'https://api.example.com/api/users/123?filter=active'
-```
-
-#### mergeOptions
-
-合并多个选项对象。
-合并请求选项，包括 headers 和 signal 等特殊处理。
-
-**参数:**
-
-- `optionsList`: 要合并的选项对象列表
-
-**返回:** 合并后的选项对象
-
-**示例:**
-
-```typescript
-const defaultOptions = {
-  timeout: 5000,
-  headers: { "Content-Type": "application/json" },
-};
-const requestOptions = {
-  method: "POST",
-  body: JSON.stringify({ name: "John" }),
-};
-const mergedOptions = mergeOptions(defaultOptions, requestOptions);
-```
-
-#### isBodyJson
-
-判断请求体是否为 JSON 对象。
-检查 body 是否为普通对象，而不是 FormData、Blob 等特殊类型。
-
-**参数:**
-
-- `body`: 请求体
-
-**返回:** 如果是 JSON 对象返回 true，否则返回 false
-
-**示例:**
-
-```typescript
-isBodyJson({ name: "John" }); // true
-isBodyJson(new FormData()); // false
-isBodyJson("string"); // false
-```
-
-#### genRequestKey
-
-生成请求的唯一标识键。
-根据请求的 URL、方法、headers、body、查询参数等生成唯一键值，用于缓存和请求共享。
-
-**参数:**
-
-- `req`: 包含 url 和 options 的请求对象
-
-**返回:** 请求的唯一标识字符串
-
-**示例:**
-
-```typescript
-const key = genRequestKey({
-  url: "/api/users",
-  options: { method: "GET", params: { id: 1 } },
-});
-```
-
-#### raceAbort
-
-竞态处理函数。
-用于处理请求竞态，终止之前的请求。
-
-**参数:**
-
-- `abortController`: 当前请求的控制器
-- `controllers`: 已存在的控制器数组
-
-**示例:**
-
-```typescript
-const controller = new AbortController();
-const controllers = [];
-raceAbort(controller, controllers); // 终止之前的请求并添加当前控制器
-```
-
-#### createRequestStore
-
-创建请求存储实例。
-提供请求缓存、共享和竞态条件处理。
-
-**参数:**
-
-- `options`: 配置选项
-  - `maxCacheSize`: 最大缓存大小（默认: 100000）
-  - `checkInterval`: 缓存检查间隔（毫秒，默认: 60000）
-
-**返回:** 请求存储对象，包含以下方法：
-- `entry(key)`: 获取特定请求键的条目
-- `dispose()`: 销毁存储并清除定时器
-- `get(key)`: 根据键获取请求
-- `set(key, value)`: 根据键设置请求
-- `remove(key)`: 根据键移除请求
-- `getAll()`: 获取所有请求
-- `removeAll()`: 移除所有请求
-- `clearCache()`: 清除所有缓存
-- `clearExpiredCache()`: 清除过期缓存
-- `abortAll()`: 中止所有请求
-
-**示例:**
-
-```typescript
-const store = createRequestStore({ maxCacheSize: 1000, checkInterval: 30000 });
-// 在请求中使用 store
-```
-
-#### deepSort
-
-深度排序对象键。
-递归地对对象的键进行排序，用于生成稳定的对象序列化结果。
-
-**参数:**
-
-- `obj`: 要排序的对象
-- `sortArr`: 是否对数组进行排序（默认: false）
-
-**返回:** 键排序后的对象
-
-**示例:**
-
-```typescript
-const obj = { b: 2, a: 1, c: { z: 3, y: 2 } };
-const sorted = deepSort(obj);
-// 返回: { a: 1, b: 2, c: { y: 2, z: 3 } }
-```
-
-#### createSilentRefresh
-
-创建静默刷新实例。
-用于处理 token 过期时的静默刷新功能。
-
-**参数:**
-
-- `refresh_token_fn`: 刷新 token 的函数
-
-**返回:** 接收成功和失败回调的函数
-
-**示例:**
-
-```typescript
-const silentRefresh = createSilentRefresh(async () => {
-  // 刷新token逻辑
-  await refreshToken();
-});
-
-// 使用示例
-silentRefresh(
-  () => console.log("刷新成功"),
-  () => console.log("刷新失败")
-);
-```
-
-#### soonFetch
-
-一个轻量级的 fetch 包装器，支持缓存、共享和竞态条件处理。
-
-**参数:**
-
-- `config`: 配置对象
-  - `url`: 请求 URL
-  - `options`: 请求选项 (SoonOptions)
-  - `baseURL`: 基础 URL
-  - `baseOptions`: 基础请求选项
-  - `store`: 自定义请求存储
-  - `sortRequestKey`: 是否对请求键进行排序
-
-**返回:** 解析为响应的 Promise
-
-**示例:**
-
-```typescript
-const data = await soonFetch<User[]>({
-  url: "/api/users",
-  options: {
-    method: "GET",
-    query: { page: 1 },
-    share: true,
-    staleTime: 5000,
-  },
-  baseURL: "https://api.example.com",
-});
-```
-
-#### parseWithBase
-
-解析基础 URL 配置。
-处理 baseURL、headers、body 等配置项，生成最终的请求配置。
-
-**参数:**
-
-- `urlOptions`: 包含 url、options、baseURL 和 baseOptions 的对象
-
-**返回:** 处理后的 url、options、is_body_json 和 abortController
-
-**示例:**
-
-```typescript
-const result = parseWithBase({
-  url: "/api/users",
-  options: { method: "GET" },
-  baseURL: "https://api.example.com",
-});
-```
-
-#### toFormData
-
-将对象转换为 FormData。
-用于将普通对象转换为 FormData 格式，支持文件和普通值。
-
-**参数:**
-
-- `body`: 要转换的对象
-
-**返回:** 转换后的 FormData 对象
-
-**示例:**
-
-```typescript
-const formData = toFormData({
-  name: "John",
-  avatar: fileBlob,
-  age: 30,
-});
-```
-
-#### progressDownload
-
-带进度的下载。
-用于下载文件并跟踪进度。
-
-**参数:**
-
-- `response`: 响应对象
-- `onProgress`: 进度回调函数
-
-**返回:** 解析为 ArrayBuffer 的 Promise
-
-**示例:**
-
-```typescript
-const response = await fetch("/api/download");
-const buffer = await progressDownload(response, (progress, downloaded, total) => {
-  console.log(`进度: ${progress}%, 已下载: ${downloaded}/${total}`);
-});
-```
-
-#### progressReadBody
-
-带进度的读取响应体。
-用于读取响应体并跟踪进度。
-
-**参数:**
-
-- `body`: ReadableStream<Uint8Array>
-- `onProgress`: 进度回调函数
-- `total`: 总大小（字节，默认: 0）
-
-**返回:** 解析为 ArrayBuffer 的 Promise
-
-**示例:**
-
-```typescript
-const response = await fetch("/api/download");
-const buffer = await progressReadBody(response.body, (progress, downloaded, total) => {
-  console.log(`进度: ${progress}%, 已下载: ${downloaded}/${total}`);
-});
-```
-
-#### parseOptions
-
-解析和合并请求选项。
-用于处理请求选项，包括 baseURL、headers 和 body。
-
-**参数:**
-
-- `urlOptions`: 包含 url、options、baseURL 和 baseOptions 的对象
-
-**返回:** 包含解析后的 url、options、is_body_json 和 abortController 的对象
-
-**示例:**
-
-```typescript
-const parsed = parseOptions({
-  url: "/api/users",
-  options: { method: "GET", query: { page: 1 } },
-  baseURL: "https://api.example.com",
-  baseOptions: { timeout: 5000 },
-});
-```
-
-#### requestWithStore
-
-带存储支持的请求包装器。
-用于处理带有缓存、共享和竞态条件处理的请求。
-
-**参数:**
-
-- `store`: 请求存储实例
-- `requestFn`: 请求函数
-- `requestKey`: 请求键
-- `fetchAbort`: AbortController
-- `options`: 选项对象
-
-**返回:** 解析为响应的 Promise
-
-**示例:**
-
-```typescript
-const store = createRequestStore();
-const data = await requestWithStore(store, () => fetch(url, options), requestKey, abortController, {
-  share: true,
-  staleTime: 5000,
-});
-```
-
-
-[English](#soon-fetch) | [中文](#soon-fetch-1) | [Installation](#安装-installation)
-
-<!-- omit in toc -->
-
-##### 安装 Installation
-
-```bash
-    npm install soon-fetch
-```
+[English](#soon-fetch) | [中文](#soon-fetch-1) | [Installation](#安装-installation)
+
+<!-- omit in toc -->
+
+### soon-fetch
+
+**A lightweight http request lib , alternative to axios with timeout, request reusing, race, response cache ...**
+
+> - 🌐 automatic parse restful api url parameters
+> - ⭐ rapid define a request api
+> - ⌛ timeout disconnect
+> - 📦 request reusing
+> - 🚀 request race
+> - 📝 response cache
+> - 🔤 automatic serialization of JSON
+> - 📏 .min size less than **6K**, smaller after zip
+> - 💡 smart type tips with Typescript
+
+- [Example](#example)
+- [Features](#features)
+  - [Shortcut](#shortcut)
+  - [Restful Url Params](#restful-url-params)
+  - [Timeout](#timeout)
+  - [Share pending request](#share-pending-request)
+  - [Response cache](#response-cache)
+  - [Request race](#request-race)
+  - [Rapid Define APIs](#rapid-define-apis)
+- [API](#api)
+
+### Example
+
+> [github: soon-admin-vue3 ](https://github.com/leafio/soon-admin-vue3)  
+> [github: soon-admin-react-nextjs ](https://github.com/leafio/soon-admin-react-nextjs)
+
+```typescript
+import { createSoon, soonFetch } from "soon-fetch";
+
+// 使用 soonFetch 作为基础请求函数
+const request = async <T>(url: string, options?: SoonOptions) => {
+  const isGet = !options?.method || options?.method.toLocaleLowerCase() === "get";
+  const response = await soonFetch<T>({
+    url,
+    options,
+    baseURL: '/api',
+    baseOptions: {
+      timeout: 20 * 1000,
+      headers: new Headers({
+        Authorization: "Bearer " + localStorage.getItem("token"),
+      }),
+      share: isGet ? true : false,
+      staleTime: isGet ? 2 * 1000 : 0,
+    },
+  });
+  return response;
+};
+
+const soon = createSoon(request);
+
+/** GET */
+soon.get("/user?id=123");
+soon.get("/user", { query: { id: 123 } });
+soon.get("/user/:id", { params: { id: 123 } });
+
+/** POST */
+soon.post("/login", { body: { username: "admin", password: "123456" } });
+
+/**Define API */
+export const login = soon
+  .POST("/user/login")
+  .Body<{ username: string; password: string }>()
+  .Ok<{ token: string }>();
+//the develop tools will have type tips for request and response
+login({ username: "admin", password: "123" }).then((res) => {
+  localStorage.setItem("token", res.token);
+});
+```
+
+### Features
+
+##### Shortcut
+
+```typescript
+soon.get(url, options);
+soon.post(url, options);
+soon.put(url, options);
+soon.patch(url, options);
+soon.delete(url, options);
+soon.head(url, options);
+soon.options(url, options);
+```
+
+##### Restful Url Params
+
+url like /:key , will handle the key
+
+```typescript
+soon.get("/api/user/:id", { params: { id: 1 } });
+// api/user/1
+soon.get("/api/:job/:year", { params: { job: "engineer", year: 5 } });
+//api/engineer/5
+```
+
+##### Timeout
+
+```typescript
+//** the request level timeout, will override the instance level timeout  */
+soon.get(url, { timeout: 1000 * 20 });
+```
+
+##### Share pending request
+
+If a request is made again before the first completes, will reuse the first request instead of making a new request.
+
+```ts
+soon.get(url, { share: true });
+```
+
+##### Response cache
+
+A cached response will be returned if the request is made again within the specified time.
+
+```ts
+soon.get(url, { staleTime: 1000 * 60 * 5 });
+```
+
+##### Request race
+
+‌If a second request is made before the first completes, abort the first to avoid race conditions from out-of-order responses.
+
+```tsx
+import { useEffect, useRef, useState } from "react";
+
+type User = { name: string; job: string };
+const api = soon.GET("/api/users").Query<{ page: number }>().Ok<User[]>();
+export default function App() {
+  const refAbort = useRef([]);
+  const [list, setList] = useState<User[]>([]);
+  const [page, setPage] = useState(1);
+  useEffect(() => {
+    api({ page }, { aborts: refAbort.current })
+      .then(setList)
+      .catch(console.log);
+  }, [page]);
+  return (
+    <div>
+      <button onClick={() => setPage((pre) => pre + 1)}>next</button>
+      <div>
+        {list.map((item) => (
+          <div key={item.name}>{item.name}</div>
+        ))}
+      </div>
+    </div>
+  );
+}
+```
+
+##### Rapid Define APIs
+
+```typescript
+//can be GET POST PATCH PUT DELETE
+  soon.GET(url:string).Query<Query>().Ok<Response>()
+  soon.POST(url:string).Body<Body>().Ok<Response>()
+  soon.GET(url:string).Options({ timeout: 5000 }).Ok<Response>()
+  soon.POST(url:string).Body<Body>().Options({ timeout: 5000 }).Ok<Response>()
+//define an api
+export const getUserInfo = soon.GET("/user/:id").Ok();
+//then use in any where
+getUserInfo({ id: 2 }).then((res) => console.log(res));
+//define an api with options
+export const getUserInfoWithOptions = soon.GET("/user/:id").Options({ timeout: 5000 }).Ok();
+//then use in any where
+getUserInfoWithOptions({ id: 2 }).then((res) => console.log(res));
+
+//with typescript,
+export const login = soon
+  .POST("/user/login")
+  .Body<{ username: string; password: string }>()
+  .Ok<{ token: string }>();
+//the develop tools will have type tips for request and response
+login({ username: "admin", password: "123" }).then((res) => {
+  localStorage.setItem("token", res.token);
+});
+```
+
+### API
+
+#### SoonOptions
+
+```ts
+// function fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>
+// RequestInit  is fetch's init options
+type SoonOptions = Omit<RequestInit, "body"> & {
+  body?: RequestInit["body"] | object;
+  query?:
+    | Record<
+        string,
+        | string
+        | number
+        | boolean
+        | null
+        | undefined
+        | (string | number | boolean | null | undefined)[]
+      >
+    | URLSearchParams;
+  params?: Record<string, string | number>;
+  timeout?: number;
+  aborts?: AbortController[] | never[];
+  share?: boolean;
+  staleTime?: number;
+};
+```
+
+#### createSoon
+
+Create a soon request instance.
+
+**Parameters:**
+
+- `request`: A function to handle the actual request, receives url and options, returns a Promise
+
+**Returns:** An object containing request method, API methods (GET, POST, PUT, DELETE, PATCH), and shortcut methods (get, post, put, delete, patch, head, options)
+
+**Example:**
+
+```typescript
+const soon = createSoon(
+  async <T>(url: string, options?: SoonOptions): Promise<T> => {
+    const response = await fetch(url, options);
+    return response.json();
+  }
+);
+
+// Usage example
+const data = await soon.get<{ id: number; name: string }[]> ("/api/users");
+
+// Define API with options
+export const login = soon
+  .POST("/user/login")
+  .Body<{ username: string; password: string }>()
+  .Ok<{ token: string }>();
+
+login({ username: "admin", password: "123" }).then((res) => {
+  localStorage.setItem("token", res.token);
+});
+```
+
+#### createShortApi
+
+Factory function to create API shortcut methods.
+Used to generate type-safe API calling methods, supporting path parameters, query parameters, and request body.
+
+**Parameters:**
+
+- `wrapper`: Wrapper function to handle actual request logic
+
+**Returns:** An object containing GET, POST, PUT, DELETE, PATCH and other methods, each method supports chain calling
+
+**Example:**
+
+```typescript
+const API = createShortApi(
+  async <T>(url: string, method: string, params: Record<string, string | number> | undefined, query: any, body: any, options: any): Promise<T> => {
+    // Handle request logic
+    const { url: _url } = parseUrl(url, { params, query });
+    const response = await fetch(_url, { ...options, method, body });
+    return response.json();
+  }
+);
+
+// Usage example
+const getUser = API.GET("/api/users/:id").Ok<{ id: number; name: string }>();
+const userData = await getUser({ id: 1 });
+```
+
+#### createShortMethods
+
+Factory function to create shortcut methods.
+
+**Parameters:**
+
+- `methods`: HTTP methods array
+- `wrapper`: Wrapper function that receives method name and returns a function to process requests
+
+**Returns:** Shortcut call object containing specified methods
+
+**Example:**
+
+```typescript
+const methods = createShortMethods(["get", "post"] as const, (method) => {
+  return async <T>(url: string, options?: SoonOptions): Promise<T> => {
+    const response = await fetch(url, { ...options, method });
+    return response.json();
+  };
+});
+// Usage: methods.get<{ id: number; name: string }[]>('/api/users')
+```
+
+#### parseUrlOptions
+
+Parse URL options.
+
+**Parameters:**
+
+- `urlOptions`: Object containing url, options, baseURL and baseOptions
+
+**Returns:** Tuple of processed url and options
+
+**Example:**
+
+```typescript
+const [url, options] = parseUrlOptions({
+  url: "/api/users/:id",
+  options: { params: { id: "123" } },
+  baseURL: "https://api.example.com",
+});
+// Returns: ['https://api.example.com/api/users/123', options]
+```
+
+#### mergeHeaders
+
+Merge multiple Headers objects.
+
+**Parameters:**
+
+- `headersList`: List of Headers objects to merge
+
+**Returns:** Merged Headers object, later ones will overwrite earlier ones with the same name
+
+**Example:**
+
+```typescript
+const headers1: HeadersInit = { "Content-Type": "application/json" };
+const headers2: HeadersInit = { Authorization: "Bearer token" };
+const mergedHeaders = mergeHeaders(headers1, headers2);
+```
+
+#### mergeSignals
+
+Merge multiple AbortSignal signals.
+
+**Parameters:**
+
+- `signals`: Array of AbortSignals to merge
+- `timeout`: Optional timeout time (milliseconds)
+
+**Returns:** Merged AbortSignal, any signal termination will trigger termination
+
+**Example:**
+
+```typescript
+const controller1 = new AbortController();
+const controller2 = new AbortController();
+const mergedSignal = mergeSignals(
+  [controller1.signal, controller2.signal],
+  5000
+);
+```
+
+#### mergeUrl
+
+Merge URL and its related parameters.
+Handle baseURL, path parameters and query parameters to generate complete URL.
+
+**Parameters:**
+
+- `url`: Original URL
+- `config`: Configuration object, including query parameters, path parameters and base URL
+
+**Returns:** Processed complete URL
+
+**Example:**
+
+```typescript
+const { url } = parseUrl("/api/users/:id", {
+  params: { id: "123" },
+  query: { filter: "active" },
+  baseURL: "https://api.example.com",
+});
+// Returns: 'https://api.example.com/api/users/123?filter=active'
+```
+
+#### mergeOptions
+
+Merge multiple option objects.
+Merge request options, including special handling of headers and signals.
+
+**Parameters:**
+
+- `optionsList`: List of option objects to merge
+
+**Returns:** Merged option object
+
+**Example:**
+
+```typescript
+const defaultOptions = {
+  timeout: 5000,
+  headers: { "Content-Type": "application/json" },
+};
+const requestOptions = {
+  method: "POST",
+  body: JSON.stringify({ name: "John" }),
+};
+const mergedOptions = mergeOptions(defaultOptions, requestOptions);
+```
+
+#### isBodyJson
+
+Determine if the request body is a JSON object.
+Check if body is a plain object, not special types like FormData or Blob.
+
+**Parameters:**
+
+- `body`: Request body
+
+**Returns:** Returns true if it is a JSON object, otherwise false
+
+**Example:**
+
+```typescript
+isBodyJson({ name: "John" }); // true
+isBodyJson(new FormData()); // false
+isBodyJson("string"); // false
+```
+
+#### genRequestKey
+
+Generate a unique identification key for the request.
+Generate a unique key value based on the request's URL, method, headers, body, query parameters, etc., used for caching and request sharing.
+
+**Parameters:**
+
+- `req`: Request object containing url and options
+
+**Returns:** Unique identification string of the request
+
+**Example:**
+
+```typescript
+const key = genRequestKey({
+  url: "/api/users",
+  options: { method: "GET", params: { id: 1 } },
+});
+```
+
+#### raceAbort
+
+Race condition handling function.
+Used to handle request race conditions, terminating previous requests.
+
+**Parameters:**
+
+- `abortController`: Controller of the current request
+- `controllers`: Array of existing controllers
+
+**Example:**
+
+```typescript
+const controller = new AbortController();
+const controllers: AbortController[] = [];
+// 注意：raceAbort 函数已不再直接导出，而是通过 createRequestStore 使用
+```
+
+#### createRequestStore
+
+Create request store instance.
+Provides request caching, sharing, and race condition handling.
+
+**Parameters:**
+
+- `options`: Configuration options
+  - `maxCacheSize`: Maximum cache size (default: 100000)
+  - `checkInterval`: Cache check interval in milliseconds (default: 60000)
+
+**Returns:** Request store object with the following methods:
+- `entry(key)`: Get entry for specific request key
+- `dispose()`: Dispose the store and clear intervals
+- `get(key)`: Get request by key
+- `set(key, value)`: Set request by key
+- `remove(key)`: Remove request by key
+- `getAll()`: Get all requests
+- `removeAll()`: Remove all requests
+- `clearCache()`: Clear all cache
+- `clearExpiredCache()`: Clear expired cache
+- `abortAll()`: Abort all requests
+
+**Example:**
+
+```typescript
+const store = createRequestStore({ maxCacheSize: 1000, checkInterval: 30000 });
+// Use store in requests
+```
+
+#### deepSort
+
+Deep sort object keys.
+Recursively sort the keys of an object to generate a stable object serialization result.
+
+**Parameters:**
+
+- `obj`: Object to sort
+- `sortArr`: Whether to sort arrays (default: false)
+
+**Returns:** Object with sorted keys
+
+**Example:**
+
+```typescript
+const obj = { b: 2, a: 1, c: { z: 3, y: 2 } };
+const sorted = deepSort(obj);
+// Returns: { a: 1, b: 2, c: { y: 2, z: 3 } }
+```
+
+#### createSilentRefresh
+
+Create silent refresh instance.
+Used to handle silent refresh functionality when token expires.
+
+**Parameters:**
+
+- `refresh_token_fn`: Function to refresh token
+
+**Returns:** Function that accepts success and failure callbacks
+
+**Example:**
+
+```typescript
+const silentRefresh = createSilentRefresh(async () => {
+  // Refresh token logic
+  await refreshToken();
+});
+
+// Usage example
+silentRefresh(
+  () => console.log("Refresh successful"),
+  () => console.log("Refresh failed")
+);
+```
+
+#### soonFetch
+
+A lightweight fetch wrapper with caching, sharing, and race condition handling.
+
+**Parameters:**
+
+- `config`: Configuration object
+  - `url`: Request URL
+  - `options`: Request options (SoonOptions)
+  - `baseURL`: Base URL
+  - `baseOptions`: Base request options
+  - `store`: Custom request store
+  - `sortRequestKey`: Whether to sort request key
+
+**Returns:** Promise that resolves to the response
+
+**Example:**
+
+```typescript
+const data = await soonFetch<User[]>({
+  url: "/api/users",
+  options: {
+    method: "GET",
+    query: { page: 1 },
+    share: true,
+    staleTime: 5000,
+  },
+  baseURL: "https://api.example.com",
+});
+```
+
+#### parseWithBase
+
+Parse base URL configuration.
+Process baseURL, headers, body and other configuration items to generate final request configuration.
+
+**Parameters:**
+
+- `urlOptions`: Object containing url, options, baseURL and baseOptions
+
+**Returns:** Processed url, options, is_body_json and abortController
+
+**Example:**
+
+```typescript
+const result = parseWithBase({
+  url: "/api/users",
+  options: { method: "GET" },
+  baseURL: "https://api.example.com",
+});
+```
+
+#### toFormData
+
+Convert object to FormData.
+Used to convert plain objects to FormData format, supports files and regular values.
+
+**Parameters:**
+
+- `body`: Object to convert
+
+**Returns:** Converted FormData object
+
+**Example:**
+
+```typescript
+const formData = toFormData({
+  name: "John",
+  avatar: fileBlob,
+  age: 30,
+});
+```
+
+#### progressDownload
+
+Download with progress tracking.
+Used to download files with progress updates.
+
+**Parameters:**
+
+- `response`: Response object
+- `onProgress`: Progress callback function
+
+**Returns:** Promise that resolves to ArrayBuffer
+
+**Example:**
+
+```typescript
+const response = await fetch("/api/download");
+const buffer = await progressDownload(response, (progress, downloaded, total) => {
+  console.log(`Progress: ${progress}%, Downloaded: ${downloaded}/${total}`);
+});
+```
+
+#### progressReadBody
+
+Read response body with progress tracking.
+Used to read response bodies with progress updates.
+
+**Parameters:**
+
+- `body`: ReadableStream<Uint8Array>
+- `onProgress`: Progress callback function
+- `total`: Total size in bytes (default: 0)
+
+**Returns:** Promise that resolves to ArrayBuffer
+
+**Example:**
+
+```typescript
+const response = await fetch("/api/download");
+const buffer = await progressReadBody(response.body!, (progress, downloaded, total) => {
+  console.log(`Progress: ${progress}%, Downloaded: ${downloaded}/${total}`);
+});
+```
+
+#### parseOptions
+
+Parse and merge request options.
+Used to process request options, including baseURL, headers, and body.
+
+**Parameters:**
+
+- `urlOptions`: Object containing url, options, baseURL, and baseOptions
+
+**Returns:** Object containing parsed url, options, is_body_json, and abortController
+
+**Example:**
+
+```typescript
+const parsed = parseOptions({
+  url: "/api/users",
+  options: { method: "GET", query: { page: 1 } },
+  baseURL: "https://api.example.com",
+  baseOptions: { timeout: 5000 },
+});
+```
+
+#### requestWithStore
+
+Request wrapper with store support.
+Used to handle requests with caching, sharing, and race condition handling.
+
+**Parameters:**
+
+- `store`: Request store instance
+- `requestFn`: Request function
+- `requestKey`: Request key
+- `fetchAbort`: AbortController
+- `options`: Options object
+
+**Returns:** Promise that resolves to the response
+
+**Example:**
+
+```typescript
+const store = createRequestStore();
+const data = await requestWithStore(store, () => fetch(url, options), requestKey, abortController, {
+  share: true,
+  staleTime: 5000,
+});
+```
+
+[English](#soon-fetch) | [中文](#soon-fetch-1) | [Installation](#安装-installation)
+
+<!-- omit in toc -->
+
+#### soon-fetch
+
+**极轻量的请求库，不到 6K**
+
+> - 🌐 自动解析 rest Url 的参数
+> - ⭐ 快捷定义请求 api
+> - ⌛ 超时断开
+> - 📦 请求复用
+> - 🚀 请求竞态
+> - 📝 响应缓存
+> - 🔤 自动处理 JSON
+> - 📏 不到 **6K** , zip 后会更小
+> - 💡 用 typescript 有智能类型提醒
+
+- [示例](#示例)
+
+- [特别功能](#特别功能)
+
+  - [快捷方法](#快捷方法)
+  - [Restful Url 参数自动处理](#restful-url-参数自动处理)
+  - [共享未完成的请求](#共享未完成的请求)
+  - [超时](#超时)
+  - [响应缓存](#响应缓存)
+  - [请求竞态](#请求竞态)
+  - [快速定义 API](#快速定义-api)
+
+- [API](#api-1)
+
+### 示例
+
+> [github: soon-admin-vue3 ](https://github.com/leafio/soon-admin-vue3)  
+> [github: soon-admin-react-nextjs ](https://github.com/leafio/soon-admin-react-nextjs)
+
+```typescript
+import { createSoon, soonFetch } from "soon-fetch";
+
+// 使用 soonFetch 作为基础请求函数
+const request = async <T>(url: string, options?: SoonOptions) => {
+  const isGet = !options?.method || options?.method.toLocaleLowerCase() === "get";
+  const response = await soonFetch<T>({
+    url,
+    options,
+    baseURL: '/api',
+    baseOptions: {
+      timeout: 20 * 1000,
+      headers: new Headers({
+        Authorization: "Bearer " + localStorage.getItem("token"),
+      }),
+      share: isGet ? true : false,
+      staleTime: isGet ? 2 * 1000 : 0,
+    },
+  });
+  return response;
+};
+
+const soon = createSoon(request);
+
+/** GET */
+soon.get("/user?id=123");
+soon.get("/user", { query: { id: 123 } });
+soon.get("/user/:id", { params: { id: 123 } });
+
+/** POST */
+soon.post("/login", { body: { username: "admin", password: "123456" } });
+
+/**定义 API */
+export const login = soon
+  .POST("/user/login")
+  .Body<{ username: string; password: string }>()
+  .Ok<{ token: string }>();
+
+//开发工具会有请求和响应的智能提醒
+login({ username: "admin", password: "123" }).then((res) => {
+  localStorage.setItem("token", res.token);
+});
+```
+
+### 特别功能
+
+##### 快捷方法
+
+```typescript
+soon.get(url, options);
+soon.post(url, options);
+soon.put(url, options);
+soon.patch(url, options);
+soon.delete(url, options);
+soon.head(url, options);
+soon.options(url, options);
+```
+
+###### Restful Url 参数自动处理
+
+url 包含 /:key 会解析匹配 key
+
+```typescript
+soon.get("/api/user/:id", { params: { id: 1 } });
+// api/user/1
+soon.get("/api/:job/:year", { params: { job: "engineer", year: 5 } });
+//api/engineer/5
+```
+
+##### 超时
+
+```typescript
+//** 请求级超时, 会覆盖实例级超时  */
+soon.get(url, { timeout: 1000 * 20 });
+```
+
+##### 共享未完成的请求
+
+如果在第一个请求完成之前再次发起相同的请求，则会复用第一个请求，而不是发起新的请求。
+
+```ts
+soon.get(url, { share: true });
+```
+
+##### 响应缓存
+
+如果在指定时间内再次发起相同的请求，则会返回缓存的响应。
+
+```ts
+soon.get(url, { staleTime: 1000 * 60 * 5 });
+```
+
+##### 请求竞态
+
+如果在第一个请求完成之前发起第二个请求，则会中止第一个请求，以避免因响应顺序错乱导致的问题。
+
+```tsx
+import { useEffect, useRef, useState } from "react";
+
+type User = { name: string; job: string };
+const api = soon.GET("/api/users").Query<{ page: number }>().Ok<User[]>();
+export default function App() {
+  const refAbort = useRef([]);
+  const [list, setList] = useState<User[]>([]);
+  const [page, setPage] = useState(1);
+  useEffect(() => {
+    api({ page }, { aborts: refAbort.current })
+      .then(setList)
+      .catch(console.log);
+  }, [page]);
+  return (
+    <div>
+      <button onClick={() => setPage((pre) => pre + 1)}>next</button>
+      <div>
+        {list.map((item) => (
+          <div key={item.name}>{item.name}</div>
+        ))}
+      </div>
+    </div>
+  );
+}
+```
+
+##### 快速定义 API
+
+```ts
+  //可以是 GET POST PATCH PUT DELETE
+  //GET 请求数据传递至query,其他方法请求数据传递至body
+  soon.GET(url:string).Query<Query>().Ok<Response>()
+  soon.POST(url:string).Body<Body>().Ok<Response>()
+  soon.GET(url:string).Options({ timeout: 5000 }).Ok<Response>()
+  soon.POST(url:string).Body<Body>().Options({ timeout: 5000 }).Ok<Response>()
+
+  //定义一个api
+ export const getUserInfo=soon.GET('/user/:id').Ok()
+  //使用
+  getUserInfo({id:2}).then(res=>console.log(res))
+  //定义一个带选项的api
+ export const getUserInfoWithOptions=soon.GET('/user/:id').Options({ timeout: 5000 }).Ok()
+  //使用
+  getUserInfoWithOptions({id:2}).then(res=>console.log(res))
+
+  //用typescript,
+ export const login=soon
+  .POST('/user/login')
+  .Body<{username:string,password:string}>()
+  .Ok<{token:string}>()
+ //开发工具会有请求和响应的智能提醒
+  login({username:'admin',password:'123'}).then(res=>{
+    localStorage.setItem('token', res.token);
+  })
+```
+
+### API
+
+#### SoonOptions
+
+```ts
+// function fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>
+// RequestInit  为原生 fetch 的 init 选项
+type SoonOptions = Omit<RequestInit, "body"> & {
+  body?: RequestInit["body"] | object;
+  query?:
+    | Record<
+        string,
+        | string
+        | number
+        | boolean
+        | null
+        | undefined
+        | (string | number | boolean | null | undefined)[]
+      >
+    | URLSearchParams;
+  params?: Record<string, string | number>;
+  timeout?: number;
+  aborts?: AbortController[] | never[];
+  share?: boolean;
+  staleTime?: number;
+};
+```
+
+#### createSoon
+
+创建一个 soon 请求实例。
+
+**参数:**
+
+- `request`: 用于处理实际请求的函数，接收 url 和 options，返回一个 Promise
+
+**返回:** 包含 request 方法、API 方法（GET、POST、PUT、DELETE、PATCH）和快捷方法（get、post、put、delete、patch、head、options）的对象
+
+**示例:**
+
+```typescript
+const soon = createSoon(
+  async (url, options) => {
+    const response = await fetch(url, options);
+    return response.json();
+  }
+);
+
+// 使用示例
+const data = await soon.get("/api/users");
+
+// 定义带选项的 API
+export const login = soon
+  .POST("/user/login")
+  .Body<{ username: string; password: string }>()
+  .Ok<{ token: string }>();
+
+login({ username: "admin", password: "123" }).then((res) => {
+  localStorage.setItem("token", res.token);
+});
+```
+
+#### createShortApi
+
+创建 API 快捷方法的工厂函数。
+用于生成类型安全的 API 调用方法，支持路径参数、查询参数和请求体。
+
+**参数:**
+
+- `wrapper`: 包装函数，用于处理实际的请求逻辑
+
+**返回:** 包含 GET、POST、PUT、DELETE、PATCH 等方法的对象，每个方法都支持链式调用
+
+**示例:**
+
+```typescript
+const API = createShortApi(
+  async (url, method, params, query, body, options) => {
+    // 处理请求逻辑
+    const _url = mergeUrl(url, { params, query });
+    const response = await fetch(_url, { ...options, method, body });
+    return response.json();
+  }
+);
+
+// 使用示例
+const getUser = API.GET("/api/users/:id").Ok();
+const userData = await getUser({ id: 1 });
+```
+
+#### createShortMethods
+
+创建快捷方法的工厂函数。
+
+**参数:**
+
+- `methods`: HTTP 方法数组
+- `wrapper`: 包装函数，接收方法名，返回处理请求的函数
+
+**返回:** 包含指定方法的快捷调用对象
+
+**示例:**
+
+```typescript
+const methods = createShortMethods(["get", "post"] as const, (method) => {
+  return (url, options) => fetch(url, { ...options, method });
+});
+// 使用: methods.get('/api/users')
+```
+
+#### parseUrlOptions
+
+解析 URL 选项。
+
+**参数:**
+
+- `urlOptions`: 包含 url、options、baseURL 和 baseOptions 的对象
+
+**返回:** 处理后的 url 和 options 元组
+
+**示例:**
+
+```typescript
+const [url, options] = parseUrlOptions({
+  url: "/api/users/:id",
+  options: { params: { id: "123" } },
+  baseURL: "https://api.example.com",
+});
+// 返回: ['https://api.example.com/api/users/123', options]
+```
+
+#### mergeHeaders
+
+合并多个 Headers 对象。
+
+**参数:**
+
+- `headersList`: 要合并的 Headers 对象列表
+
+**返回:** 合并后的 Headers 对象，后面的会覆盖前面的同名 header
+
+**示例:**
+
+```typescript
+const headers1: HeadersInit = { "Content-Type": "application/json" };
+const headers2: HeadersInit = { Authorization: "Bearer token" };
+const mergedHeaders = mergeHeaders(headers1, headers2);
+```
+
+#### mergeSignals
+
+合并多个 AbortSignal 信号。
+
+**参数:**
+
+- `signals`: 要合并的 AbortSignal 数组
+- `timeout`: 可选的超时时间（毫秒）
+
+**返回:** 合并后的 AbortSignal，任意一个信号终止都会触发终止
+
+**示例:**
+
+```typescript
+const controller1 = new AbortController();
+const controller2 = new AbortController();
+const mergedSignal = mergeSignals(
+  [controller1.signal, controller2.signal],
+  5000
+);
+```
+
+#### mergeUrl
+
+合并 URL 及其相关参数。
+处理 baseURL、路径参数和查询参数，生成完整 URL。
+
+**参数:**
+
+- `url`: 原始 URL
+- `config`: 配置对象，包含查询参数、路径参数和基础 URL
+
+**返回:** 处理后的完整 URL
+
+**示例:**
+
+```typescript
+const url = mergeUrl("/api/users/:id", {
+  params: { id: "123" },
+  query: { filter: "active" },
+  baseURL: "https://api.example.com",
+});
+// 返回: 'https://api.example.com/api/users/123?filter=active'
+```
+
+#### mergeOptions
+
+合并多个选项对象。
+合并请求选项，包括 headers 和 signal 等特殊处理。
+
+**参数:**
+
+- `optionsList`: 要合并的选项对象列表
+
+**返回:** 合并后的选项对象
+
+**示例:**
+
+```typescript
+const defaultOptions = {
+  timeout: 5000,
+  headers: { "Content-Type": "application/json" },
+};
+const requestOptions = {
+  method: "POST",
+  body: JSON.stringify({ name: "John" }),
+};
+const mergedOptions = mergeOptions(defaultOptions, requestOptions);
+```
+
+#### isBodyJson
+
+判断请求体是否为 JSON 对象。
+检查 body 是否为普通对象，而不是 FormData、Blob 等特殊类型。
+
+**参数:**
+
+- `body`: 请求体
+
+**返回:** 如果是 JSON 对象返回 true，否则返回 false
+
+**示例:**
+
+```typescript
+isBodyJson({ name: "John" }); // true
+isBodyJson(new FormData()); // false
+isBodyJson("string"); // false
+```
+
+#### genRequestKey
+
+生成请求的唯一标识键。
+根据请求的 URL、方法、headers、body、查询参数等生成唯一键值，用于缓存和请求共享。
+
+**参数:**
+
+- `req`: 包含 url 和 options 的请求对象
+
+**返回:** 请求的唯一标识字符串
+
+**示例:**
+
+```typescript
+const key = genRequestKey({
+  url: "/api/users",
+  options: { method: "GET", params: { id: 1 } },
+});
+```
+
+#### raceAbort
+
+竞态处理函数。
+用于处理请求竞态，终止之前的请求。
+
+**参数:**
+
+- `abortController`: 当前请求的控制器
+- `controllers`: 已存在的控制器数组
+
+**示例:**
+
+```typescript
+const controller = new AbortController();
+const controllers = [];
+raceAbort(controller, controllers); // 终止之前的请求并添加当前控制器
+```
+
+#### createRequestStore
+
+创建请求存储实例。
+提供请求缓存、共享和竞态条件处理。
+
+**参数:**
+
+- `options`: 配置选项
+  - `maxCacheSize`: 最大缓存大小（默认: 100000）
+  - `checkInterval`: 缓存检查间隔（毫秒，默认: 60000）
+
+**返回:** 请求存储对象，包含以下方法：
+- `entry(key)`: 获取特定请求键的条目
+- `dispose()`: 销毁存储并清除定时器
+- `get(key)`: 根据键获取请求
+- `set(key, value)`: 根据键设置请求
+- `remove(key)`: 根据键移除请求
+- `getAll()`: 获取所有请求
+- `removeAll()`: 移除所有请求
+- `clearCache()`: 清除所有缓存
+- `clearExpiredCache()`: 清除过期缓存
+- `abortAll()`: 中止所有请求
+
+**示例:**
+
+```typescript
+const store = createRequestStore({ maxCacheSize: 1000, checkInterval: 30000 });
+// 在请求中使用 store
+```
+
+#### deepSort
+
+深度排序对象键。
+递归地对对象的键进行排序，用于生成稳定的对象序列化结果。
+
+**参数:**
+
+- `obj`: 要排序的对象
+- `sortArr`: 是否对数组进行排序（默认: false）
+
+**返回:** 键排序后的对象
+
+**示例:**
+
+```typescript
+const obj = { b: 2, a: 1, c: { z: 3, y: 2 } };
+const sorted = deepSort(obj);
+// 返回: { a: 1, b: 2, c: { y: 2, z: 3 } }
+```
+
+#### createSilentRefresh
+
+创建静默刷新实例。
+用于处理 token 过期时的静默刷新功能。
+
+**参数:**
+
+- `refresh_token_fn`: 刷新 token 的函数
+
+**返回:** 接收成功和失败回调的函数
+
+**示例:**
+
+```typescript
+const silentRefresh = createSilentRefresh(async () => {
+  // 刷新token逻辑
+  await refreshToken();
+});
+
+// 使用示例
+silentRefresh(
+  () => console.log("刷新成功"),
+  () => console.log("刷新失败")
+);
+```
+
+#### soonFetch
+
+一个轻量级的 fetch 包装器，支持缓存、共享和竞态条件处理。
+
+**参数:**
+
+- `config`: 配置对象
+  - `url`: 请求 URL
+  - `options`: 请求选项 (SoonOptions)
+  - `baseURL`: 基础 URL
+  - `baseOptions`: 基础请求选项
+  - `store`: 自定义请求存储
+  - `sortRequestKey`: 是否对请求键进行排序
+
+**返回:** 解析为响应的 Promise
+
+**示例:**
+
+```typescript
+const data = await soonFetch<User[]>({
+  url: "/api/users",
+  options: {
+    method: "GET",
+    query: { page: 1 },
+    share: true,
+    staleTime: 5000,
+  },
+  baseURL: "https://api.example.com",
+});
+```
+
+#### parseWithBase
+
+解析基础 URL 配置。
+处理 baseURL、headers、body 等配置项，生成最终的请求配置。
+
+**参数:**
+
+- `urlOptions`: 包含 url、options、baseURL 和 baseOptions 的对象
+
+**返回:** 处理后的 url、options、is_body_json 和 abortController
+
+**示例:**
+
+```typescript
+const result = parseWithBase({
+  url: "/api/users",
+  options: { method: "GET" },
+  baseURL: "https://api.example.com",
+});
+```
+
+#### toFormData
+
+将对象转换为 FormData。
+用于将普通对象转换为 FormData 格式，支持文件和普通值。
+
+**参数:**
+
+- `body`: 要转换的对象
+
+**返回:** 转换后的 FormData 对象
+
+**示例:**
+
+```typescript
+const formData = toFormData({
+  name: "John",
+  avatar: fileBlob,
+  age: 30,
+});
+```
+
+#### progressDownload
+
+带进度的下载。
+用于下载文件并跟踪进度。
+
+**参数:**
+
+- `response`: 响应对象
+- `onProgress`: 进度回调函数
+
+**返回:** 解析为 ArrayBuffer 的 Promise
+
+**示例:**
+
+```typescript
+const response = await fetch("/api/download");
+const buffer = await progressDownload(response, (progress, downloaded, total) => {
+  console.log(`进度: ${progress}%, 已下载: ${downloaded}/${total}`);
+});
+```
+
+#### progressReadBody
+
+带进度的读取响应体。
+用于读取响应体并跟踪进度。
+
+**参数:**
+
+- `body`: ReadableStream<Uint8Array>
+- `onProgress`: 进度回调函数
+- `total`: 总大小（字节，默认: 0）
+
+**返回:** 解析为 ArrayBuffer 的 Promise
+
+**示例:**
+
+```typescript
+const response = await fetch("/api/download");
+const buffer = await progressReadBody(response.body, (progress, downloaded, total) => {
+  console.log(`进度: ${progress}%, 已下载: ${downloaded}/${total}`);
+});
+```
+
+#### parseOptions
+
+解析和合并请求选项。
+用于处理请求选项，包括 baseURL、headers 和 body。
+
+**参数:**
+
+- `urlOptions`: 包含 url、options、baseURL 和 baseOptions 的对象
+
+**返回:** 包含解析后的 url、options、is_body_json 和 abortController 的对象
+
+**示例:**
+
+```typescript
+const parsed = parseOptions({
+  url: "/api/users",
+  options: { method: "GET", query: { page: 1 } },
+  baseURL: "https://api.example.com",
+  baseOptions: { timeout: 5000 },
+});
+```
+
+#### requestWithStore
+
+带存储支持的请求包装器。
+用于处理带有缓存、共享和竞态条件处理的请求。
+
+**参数:**
+
+- `store`: 请求存储实例
+- `requestFn`: 请求函数
+- `requestKey`: 请求键
+- `fetchAbort`: AbortController
+- `options`: 选项对象
+
+**返回:** 解析为响应的 Promise
+
+**示例:**
+
+```typescript
+const store = createRequestStore();
+const data = await requestWithStore(store, () => fetch(url, options), requestKey, abortController, {
+  share: true,
+  staleTime: 5000,
+});
+```
+
+
+[English](#soon-fetch) | [中文](#soon-fetch-1) | [Installation](#安装-installation)
+
+<!-- omit in toc -->
+
+##### 安装 Installation
+
+```bash
+    npm install soon-fetch
+```