docs: ✏️ Add an introduction to the Exponential-backoff algorith

.npmignore

@@ -6,6 +6,7 @@
 .vscode
 .npmrc
 coverage
+public
 **/demo
 **/mock
 **/src

README.md

@@ -218,6 +218,8 @@ Assuming an interface has a 10% failure rate, the probability of still failing a
 
 Using `idmp` to wrap the interface, it will automatically retry on timeouts or failures, which greatly reduces the occurrence of abnormal situations. Before each retry, you can monitor exceptions through the `onBeforeRetry` hook function (note that it will not capture the last error)
 
+`idmp` internally implements an algorithm similar to [Exponential backoff](https://en.m.wikipedia.org/wiki/Exponential_backoff), which dynamically changes the retry time to avoid DDoS to the server.
+
 ```typescript
 const getUserData = idmp(
   'using a deduplicated string as a key',

README.zh-CN.md

@@ -64,11 +64,11 @@ export const getInfoByIdIdmp = (id: string) =>
 
 ## 插件
 
-`idmp` 有一个强大的插件系统。 以下插件是官方维护的，您也可以参考源码创建自己的插件：
+`idmp` 有一个强大的插件系统。 以下是官方维护的插件列表，您也可以参考源码创建自己的插件：
 
-与高阶函数的类比优雅地传达了插件可以以非侵入性方式扩展 idmp 的核心功能，类似于数学函数 $g(f)(x)$。 这为插件系统提供了极大的灵活性和可扩展性。
+插件可以以非侵入性方式扩展 `idmp` 的核心功能，类似于数学函数 $g(f)(x)$。 这种优雅的设计为插件系统提供了极大的灵活性和可扩展性。
 
-- [使用node-fs进行数据持久化](plugins/node-fs/README.md)（将数据持久化到文件系统）
+- [使用 node-fs 进行数据持久化](plugins/node-fs/README.md)（将数据持久化到文件系统）
 - [使用 localStorage 进行数据持久化](https://github.com/ha0z1/idmp/blob/main/plugins/browser-storage/README.md)
 - [使用 sessionStorage 进行数据持久化](https://github.com/ha0z1/idmp/blob/main/plugins/browser-storage/README.md)
 - 使用 indexedDB 进行数据持久化 // TODO
@@ -212,7 +212,7 @@ $$
 
 当哪天页面不需要直接消费 dataA 的数据时，直接删除请求 dataA 的代码就好了，没有任何心智负担。
 
-## 健壮性
+## 鲁棒性
 
 假设一个接口的请求失败率为 10%, 那么通过 3 次尝试后，请求仍失败的可能性将降到 0.1%
 
@@ -233,6 +233,8 @@ const getUserData = idmp(
 )
 ```
 
+idmp 内部实现了类似 [指数退避](https://en.m.wikipedia.org/wiki/Exponential_backoff)的算法，会动态改变重试时间，避免对服务器造成 DDoS。
+
 ## 优化大计算
 
 虽然 `idmp` 的第二个参数必须是一个 Promise 函数，但由于同步函数都可以方便地包装成 Promise 对象。故 `idmp` 除了可以缓存网络请求外，原则上可以缓存任何函数调用。

demo/Item.tsx

@@ -5,11 +5,12 @@ interface IProps {
   id: string
 }
 export default (props: IProps) => {
-  const [data, setData] = useState({})
+  const [data, setData] = useState<any>(null)
   useEffect(() => {
     getUserData(props.id).then((res) => {
       setData(res)
     })
   }, [])
+  if (!data) return <>waiting server's data...</>
   return <>{JSON.stringify(data)}</>
 }

demo/ItemIdmp.tsx

@@ -5,11 +5,13 @@ interface IProps {
   id: string
 }
 export default (props: IProps) => {
-  const [data, setData] = useState({})
+  const [data, setData] = useState<any>(null)
   useEffect(() => {
     getUserDataIdmp(props.id).then((res) => {
       setData(res)
     })
   }, [])
+
+  if (!data) return <>waiting server's data...</>
   return <>{JSON.stringify(data)}</>
 }

demo/api.ts

@@ -7,10 +7,14 @@ import idmp, { g } from '../src'
 //   return res
 // }
 
+const sleep = (delay: number) =>
+  new Promise((resolve) => setTimeout(resolve, delay))
+
 export const getUserData = async (userId: string) => {
   const API = `https://haozi.me/?id=${userId}&t=${Math.random()}`
   await fetch(API).then((d) => d.text())
 
+  await sleep(2000)
   const res = {
     id: userId,
     val: Math.random(),

demo/pages/Storage/index.tsx

@@ -18,7 +18,9 @@ export default () => {
       setData(data)
     })
   }, [])
-  if (!data) return
+
+  if (!data) return <>waiting server's data...</>
+
   return (
     <div>
       Refresh the browser and still use the same data in 5 seconds. No network

vite.config.ts

@@ -6,6 +6,7 @@ import dts from 'vite-plugin-dts'
 
 export default defineConfig(({ mode }) => {
   return {
+    publicDir: false,
     plugins: [react(), dts()],
     build: {
       minify: !false,