@ahoo-wang/fetcher-react 2.6.3 → 2.6.5

package/README.zh-CN.md

@@ -12,11 +12,26 @@ Fetcher 生态的 React 集成包。提供 React Hooks 和组件，实现无缝
 
 ## 功能特性
 
-- 🔄 **React Hooks**: 提供 React hooks 与 Fetcher 无缝集成
-- 🌐 **TypeScript 支持**: 完整的 TypeScript 支持和全面的类型定义
-- 🚀 **现代化**: 使用现代 React 模式和最佳实践构建
-- 🧠 **智能缓存**: 内置缓存和自动重新验证
-- ⚡ **Promise 状态管理**: 用于管理异步操作和 promise 状态的 hooks
+- 🚀 **数据获取**: 完整的 HTTP 客户端与 React hooks 集成
+- 🔄 **Promise 状态管理**: 高级异步操作处理，具有竞态条件保护
+- 🛡️ **类型安全**: 完整的 TypeScript 支持和全面的类型定义
+- ⚡ **性能优化**: 使用 useMemo、useCallback 和智能依赖管理进行优化
+- 🎯 **选项灵活性**: 支持静态选项和动态选项供应商
+- 🔧 **开发者体验**: 内置加载状态、错误处理和自动重新渲染
+
+## 目录
+
+- [安装](#安装)
+- [快速开始](#快速开始)
+- [使用方法](#使用方法)
+    - [useFetcher Hook](#usefetcher-hook)
+    - [useExecutePromise Hook](#useexecutepromise-hook)
+    - [usePromiseState Hook](#usepromisestate-hook)
+    - [useRequestId Hook](#userequestid-hook)
+    - [useLatest Hook](#uselatest-hook)
+    - [useKeyStorage Hook](#usekeystorage-hook)
+- [API 参考](#api-参考)
+- [许可证](#许可证)
 
 ## 安装
 
@@ -24,30 +39,52 @@ Fetcher 生态的 React 集成包。提供 React Hooks 和组件，实现无缝
 npm install @ahoo-wang/fetcher-react
 ```
 
+## 快速开始
+
+只需几行代码即可开始使用 `@ahoo-wang/fetcher-react`：
+
+```typescript jsx
+import { useFetcher } from '@ahoo-wang/fetcher-react';
+
+function App() {
+  const { loading, result, error, execute } = useFetcher();
+
+  return (
+    <div>
+      <button onClick={() => execute({ url: '/api/data', method: 'GET' })}>
+        获取数据
+      </button>
+      {loading && <p>加载中...</p>}
+      {result && <pre>{JSON.stringify(result, null, 2)}</pre>}
+      {error && <p>错误: {error.message}</p>}
+    </div>
+  );
+}
+```
+
 ## 使用方法
 
-### usePromiseState Hook
+### useFetcher Hook
 
-`usePromiseState` hook 提供 promise 操作的状态管理，无执行逻辑。
+`useFetcher` hook 提供完整的数据获取功能，具有自动状态管理、竞态条件保护和灵活的配置选项。
 
 ```typescript jsx
-import { usePromiseState, PromiseStatus } from '@ahoo-wang/fetcher-react';
+import { useFetcher } from '@ahoo-wang/fetcher-react';
 
 const MyComponent = () => {
-  const { status, loading, result, error, setSuccess, setError, setIdle } = usePromiseState<string>();
+  const { loading, error, result, execute } = useFetcher<string>();
 
-  const handleSuccess = () => setSuccess('数据加载成功');
-  const handleError = () => setError(new Error('加载失败'));
+  const handleFetch = () => {
+    execute({ url: '/api/users', method: 'GET' });
+  };
+
+  if (loading) return <div>加载中...</div>;
+  if (error) return <div>错误: {error.message}</div>;
 
   return (
     <div>
-      <button onClick={handleSuccess}>设置成功</button>
-      <button onClick={handleError}>设置错误</button>
-      <button onClick={setIdle}>重置</button>
-      <p>状态: {status}</p>
-      {loading && <p>加载中...</p>}
-      {result && <p>结果: {result}</p>}
-      {error && <p>错误: {error.message}</p>}
+      <pre>{JSON.stringify(result, null, 2)}</pre>
+      <button onClick={handleFetch}>获取数据</button>
     </div>
   );
 };
@@ -55,7 +92,7 @@ const MyComponent = () => {
 
 ### useExecutePromise Hook
 
-`useExecutePromise` hook 管理异步操作，具有自动状态处理和内置竞态条件保护。
+`useExecutePromise` hook 管理异步操作，具有自动状态处理、竞态条件保护和 promise 状态选项支持。
 
 ```typescript jsx
 import { useExecutePromise } from '@ahoo-wang/fetcher-react';
@@ -90,6 +127,63 @@ const MyComponent = () => {
 };
 ```
 
+### usePromiseState Hook
+
+`usePromiseState` hook 提供 promise 操作的状态管理，无执行逻辑。支持静态选项和动态选项供应商。
+
+```typescript jsx
+import { usePromiseState, PromiseStatus } from '@ahoo-wang/fetcher-react';
+
+const MyComponent = () => {
+  const { status, loading, result, error, setSuccess, setError, setIdle } = usePromiseState<string>();
+
+  const handleSuccess = () => setSuccess('数据加载成功');
+  const handleError = () => setError(new Error('加载失败'));
+
+  return (
+    <div>
+      <button onClick={handleSuccess}>设置成功</button>
+      <button onClick={handleError}>设置错误</button>
+      <button onClick={setIdle}>重置</button>
+      <p>状态: {status}</p>
+      {loading && <p>加载中...</p>}
+      {result && <p>结果: {result}</p>}
+      {error && <p>错误: {error.message}</p>}
+    </div>
+  );
+};
+```
+
+#### usePromiseState with Options Supplier
+
+```typescript jsx
+import { usePromiseState, PromiseStatus } from '@ahoo-wang/fetcher-react';
+
+const MyComponent = () => {
+  // 使用选项供应商进行动态配置
+  const optionsSupplier = () => ({
+    initialStatus: PromiseStatus.IDLE,
+    onSuccess: async (result: string) => {
+      await saveToAnalytics(result);
+      console.log('成功:', result);
+    },
+    onError: async (error) => {
+      await logErrorToServer(error);
+      console.error('错误:', error);
+    },
+  });
+
+  const { setSuccess, setError } = usePromiseState<string>(optionsSupplier);
+
+  return (
+    <div>
+      <button onClick={() => setSuccess('动态成功!')}>设置成功</button>
+      <button onClick={() => setError(new Error('动态错误!'))}>设置错误</button>
+    </div>
+  );
+};
+```
+
 ### useRequestId Hook
 
 `useRequestId` hook 提供请求ID管理，用于防止异步操作中的竞态条件。
@@ -125,27 +219,27 @@ const MyComponent = () => {
 };
 ```
 
-### useFetcher Hook
+### useLatest Hook
 
-`useFetcher` hook 提供数据获取功能，具有自动状态管理。
+`useLatest` hook 返回包含最新值的 ref 对象，用于在异步回调中访问当前值。
 
 ```typescript jsx
-import { useFetcher } from '@ahoo-wang/fetcher-react';
+import { useLatest } from '@ahoo-wang/fetcher-react';
 
 const MyComponent = () => {
-  const { loading, error, result, execute } = useFetcher<string>();
+  const [count, setCount] = useState(0);
+  const latestCount = useLatest(count);
 
-  const handleFetch = () => {
-    execute({ url: '/api/users', method: 'GET' });
+  const handleAsync = async () => {
+    await someAsyncOperation();
+    console.log('最新计数:', latestCount.current); // 始终是最新值
   };
 
-  if (loading) return <div>加载中...</div>;
-  if (error) return <div>错误: {error.message}</div>;
-
   return (
     <div>
-      <pre>{JSON.stringify(result, null, 2)}</pre>
-      <button onClick={handleFetch}>获取数据</button>
+      <p>计数: {count}</p>
+      <button onClick={() => setCount(c => c + 1)}>递增</button>
+      <button onClick={handleAsync}>异步记录</button>
     </div>
   );
 };
@@ -198,19 +292,25 @@ const [user, setUser] = useKeyStorage(userStorage);
 
 ## API 参考
 
-### usePromiseState
+### useFetcher
 
 ```typescript
-function usePromiseState<R = unknown>(
-  options?: UsePromiseStateOptions<R>,
-): UsePromiseStateReturn<R>;
+function useFetcher<R = unknown, E = unknown>(
+  options?: UseFetcherOptions<R, E> | UseFetcherOptionsSupplier<R, E>,
+): UseFetcherReturn<R, E>;
 ```
 
-用于管理 promise 状态的 React hook，无执行逻辑。
+用于管理异步获取操作的 React hook，具有适当的状态处理、竞态条件保护和灵活的配置。
+
+**类型参数:**
+
+- `R`: 结果的类型
+- `E`: 错误的类型（默认为 `unknown`）
 
 **参数:**
 
-- `options`: 配置选项
+- `options`: 配置选项或供应商函数
+    - `fetcher`: 要使用的自定义获取器实例。默认为默认获取器。
     - `initialStatus`: 初始状态，默认为 IDLE
     - `onSuccess`: 成功时调用的回调
     - `onError`: 错误时调用的回调
@@ -223,30 +323,77 @@ function usePromiseState<R = unknown>(
 - `loading`: 指示当前是否加载中
 - `result`: 结果值
 - `error`: 错误值
-- `setLoading`: 设置状态为 LOADING
-- `setSuccess`: 设置状态为 SUCCESS 并提供结果
-- `setError`: 设置状态为 ERROR 并提供错误
-- `setIdle`: 设置状态为 IDLE
+- `exchange`: 表示正在进行的获取操作的 FetchExchange 对象
+- `execute`: 执行获取请求的函数
 
 ### useExecutePromise
 
 ```typescript
-function useExecutePromise<R = unknown>(): UseExecutePromiseReturn<R>;
+function useExecutePromise<R = unknown, E = unknown>(
+  options?: UseExecutePromiseOptions<R, E>,
+): UseExecutePromiseReturn<R, E>;
 ```
 
-用于管理异步操作的 React hook，具有适当的状态处理。
+用于管理异步操作的 React hook，具有适当的状态处理、竞态条件保护和 promise 状态选项。
+
+**类型参数:**
+
+- `R`: 结果的类型
+- `E`: 错误的类型（默认为 `unknown`）
+
+**参数:**
+
+- `options`: 配置选项
+    - `initialStatus`: 初始状态，默认为 IDLE
+    - `onSuccess`: 成功时调用的回调
+    - `onError`: 错误时调用的回调
 
 **返回值:**
 
 包含以下属性的对象：
 
-- `status`: 当前状态
+- `status`: 当前状态 (IDLE, LOADING, SUCCESS, ERROR)
 - `loading`: 指示当前是否加载中
 - `result`: 结果值
 - `error`: 错误值
 - `execute`: 执行 promise supplier 或 promise 的函数
 - `reset`: 重置状态到初始值的函数
 
+### usePromiseState
+
+```typescript
+function usePromiseState<R = unknown, E = unknown>(
+  options?: UsePromiseStateOptions<R, E> | UsePromiseStateOptionsSupplier<R, E>,
+): UsePromiseStateReturn<R, E>;
+```
+
+用于管理 promise 状态的 React hook，无执行逻辑。支持静态选项和动态选项供应商。
+
+**类型参数:**
+
+- `R`: 结果的类型
+- `E`: 错误的类型（默认为 `unknown`）
+
+**参数:**
+
+- `options`: 配置选项或供应商函数
+    - `initialStatus`: 初始状态，默认为 IDLE
+    - `onSuccess`: 成功时调用的回调（可以是异步的）
+    - `onError`: 错误时调用的回调（可以是异步的）
+
+**返回值:**
+
+包含以下属性的对象：
+
+- `status`: 当前状态 (IDLE, LOADING, SUCCESS, ERROR)
+- `loading`: 指示当前是否加载中
+- `result`: 结果值
+- `error`: 错误值
+- `setLoading`: 设置状态为 LOADING
+- `setSuccess`: 设置状态为 SUCCESS 并提供结果
+- `setError`: 设置状态为 ERROR 并提供错误
+- `setIdle`: 设置状态为 IDLE
+
 ### useRequestId
 
 ```typescript
@@ -265,29 +412,25 @@ function useRequestId(): UseRequestIdReturn;
 - `invalidate`: 使当前请求ID失效（标记为过时）
 - `reset`: 重置请求ID计数器
 
-### useFetcher
+### useLatest
 
 ```typescript
-function useFetcher<R>(options?: UseFetcherOptions): UseFetcherReturn<R>;
+function useLatest<T>(value: T): { current: T };
 ```
 
-用于管理异步获取操作的 React hook，具有适当的状态处理。
+返回包含最新值的 ref 对象的 React hook，用于在异步回调中访问当前值。
+
+**类型参数:**
+
+- `T`: 值的类型
 
 **参数:**
 
-- `options`: 配置选项
-    - `fetcher`: 要使用的自定义获取器实例。默认为默认获取器。
+- `value`: 要跟踪的值
 
 **返回值:**
 
-包含以下属性的对象：
-
-- `status`: 当前状态
-- `loading`: 指示当前是否加载中
-- `result`: 结果值
-- `error`: 错误值
-- `exchange`: FetchExchange 对象
-- `execute`: 执行获取请求的函数
+包含 `current` 属性（包含最新值）的 ref 对象
 
 ### useKeyStorage
 

package/dist/core/useExecutePromise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useExecutePromise.d.ts","sourceRoot":"","sources":["../../src/core/useExecutePromise.ts"],"names":[],"mappings":"AAeA,OAAO,EAAmB,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAG1F;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CACrD,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1B,wDAAwD;IACxD,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,oDAAoD;IACpD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,CAuDjI"}
+{"version":3,"file":"useExecutePromise.d.ts","sourceRoot":"","sources":["../../src/core/useExecutePromise.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,YAAY,EACZ,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CACrD,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1B,wDAAwD;IACxD,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,oDAAoD;IACpD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACxD,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GACrC,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,CAuD/B"}

package/dist/core/usePromiseState.d.ts

@@ -18,10 +18,10 @@ export interface PromiseState<R, E = unknown> {
     error: E | undefined;
 }
 export interface PromiseStateCallbacks<R, E = unknown> {
-    /** Callback invoked on success */
-    onSuccess?: (result: R) => void;
-    /** Callback invoked on error */
-    onError?: (error: E) => void;
+    /** Callback invoked on success (can be async) */
+    onSuccess?: (result: R) => void | Promise<void>;
+    /** Callback invoked on error (can be async) */
+    onError?: (error: E) => void | Promise<void>;
 }
 /**
  * Options for configuring usePromiseState behavior
@@ -32,7 +32,10 @@ export interface PromiseStateCallbacks<R, E = unknown> {
  * const options: UsePromiseStateOptions<string> = {
  *   initialStatus: PromiseStatus.IDLE,
  *   onSuccess: (result) => console.log('Success:', result),
- *   onError: (error) => console.error('Error:', error),
+ *   onError: async (error) => {
+ *     await logErrorToServer(error);
+ *     console.error('Error:', error);
+ *   },
  * };
  * ```
  */
@@ -48,9 +51,9 @@ export interface UsePromiseStateReturn<R, E = unknown> extends PromiseState<R, E
     /** Set status to LOADING */
     setLoading: () => void;
     /** Set status to SUCCESS with result */
-    setSuccess: (result: R) => void;
+    setSuccess: (result: R) => Promise<void>;
     /** Set status to ERROR with error */
-    setError: (error: E) => void;
+    setError: (error: E) => Promise<void>;
     /** Set status to IDLE */
     setIdle: () => void;
 }

package/dist/core/usePromiseState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePromiseState.d.ts","sourceRoot":"","sources":["../../src/core/usePromiseState.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO;IAC1C,oCAAoC;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IACtB,sBAAsB;IACtB,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO;IACnD,kCAAkC;IAClC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAChC,gCAAgC;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC;IACzF,uCAAuC;IACvC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CACnD,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,wCAAwC;IACxC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAChC,qCAAqC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,yBAAyB;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACtD,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GACrC,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CA2D7B"}
+{"version":3,"file":"usePromiseState.d.ts","sourceRoot":"","sources":["../../src/core/usePromiseState.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO;IAC1C,oCAAoC;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IACtB,sBAAsB;IACtB,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO;IACnD,iDAAiD;IACjD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CACpD,SAAQ,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC;IACnC,uCAAuC;IACvC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CACnD,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,wCAAwC;IACxC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,qCAAqC;IACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,yBAAyB;IACzB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACtD,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,GACrC,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,CAqE7B"}

package/dist/index.es.js

@@ -1,165 +1,179 @@
-import { useRef as v, useCallback as c, useEffect as I, useState as h, useMemo as L, useSyncExternalStore as C } from "react";
-import { fetcherRegistrar as w, getFetcher as F } from "@ahoo-wang/fetcher";
-function R() {
-  var t = v(!1), e = c(function() {
+import { useRef as w, useCallback as c, useEffect as R, useState as b, useMemo as v, useSyncExternalStore as x } from "react";
+import { fetcherRegistrar as C, getFetcher as y } from "@ahoo-wang/fetcher";
+function L() {
+  var t = w(!1), e = c(function() {
     return t.current;
   }, []);
-  return I(function() {
+  return R(function() {
     return t.current = !0, function() {
       t.current = !1;
     };
   }, []), e;
 }
-function b(t) {
-  const e = v(t);
+function S(t) {
+  const e = w(t);
   return e.current = t, e;
 }
-var p = /* @__PURE__ */ ((t) => (t.IDLE = "idle", t.LOADING = "loading", t.SUCCESS = "success", t.ERROR = "error", t))(p || {});
+var F = /* @__PURE__ */ ((t) => (t.IDLE = "idle", t.LOADING = "loading", t.SUCCESS = "success", t.ERROR = "error", t))(F || {});
 function m(t) {
-  const [e, r] = h(
+  const [e, r] = b(
     t?.initialStatus ?? "idle"
     /* IDLE */
-  ), [u, i] = h(void 0), [s, n] = h(void 0), o = R(), d = b(t), f = c(() => {
+  ), [a, u] = b(void 0), [s, n] = b(void 0), o = L(), l = S(t), d = c(() => {
     o() && (r(
       "loading"
       /* LOADING */
     ), n(void 0));
   }, [o]), E = c(
-    (a) => {
-      o() && (i(a), r(
-        "success"
-        /* SUCCESS */
-      ), n(void 0), d.current?.onSuccess?.(a));
+    async (i) => {
+      if (o()) {
+        u(i), r(
+          "success"
+          /* SUCCESS */
+        ), n(void 0);
+        try {
+          await l.current?.onSuccess?.(i);
+        } catch (h) {
+          console.warn("PromiseState onSuccess callback error:", h);
+        }
+      }
     },
-    [o, d]
-  ), l = c(
-    (a) => {
-      o() && (n(a), r(
-        "error"
-        /* ERROR */
-      ), i(void 0), d.current?.onError?.(a));
+    [o, l]
+  ), f = c(
+    async (i) => {
+      if (o()) {
+        n(i), r(
+          "error"
+          /* ERROR */
+        ), u(void 0);
+        try {
+          await l.current?.onError?.(i);
+        } catch (h) {
+          console.warn("PromiseState onError callback error:", h);
+        }
+      }
     },
-    [o, d]
+    [o, l]
   ), g = c(() => {
     o() && (r(
       "idle"
       /* IDLE */
-    ), n(void 0), i(void 0));
+    ), n(void 0), u(void 0));
   }, [o]);
-  return L(
+  return v(
     () => ({
       status: e,
       loading: e === "loading",
-      result: u,
+      result: a,
       error: s,
-      setLoading: f,
+      setLoading: d,
       setSuccess: E,
-      setError: l,
+      setError: f,
       setIdle: g
     }),
-    [e, u, s, f, E, l, g]
+    [e, a, s, d, E, f, g]
   );
 }
-function x() {
-  const t = v(0), e = c(() => ++t.current, []), r = c(() => t.current, []), u = c((n) => n === t.current, []), i = c(() => {
+function I() {
+  const t = w(0), e = c(() => ++t.current, []), r = c(() => t.current, []), a = c((n) => n === t.current, []), u = c(() => {
     t.current++;
   }, []), s = c(() => {
     t.current = 0;
   }, []);
-  return L(() => ({
+  return v(() => ({
     generate: e,
     current: r,
-    isLatest: u,
-    invalidate: i,
+    isLatest: a,
+    invalidate: u,
     reset: s
-  }), [e, r, u, i, s]);
+  }), [e, r, a, u, s]);
 }
-function q(t) {
-  const e = m(t), r = R(), u = x(), i = c(
+function O(t) {
+  const e = m(t), r = L(), a = I(), u = c(
     async (n) => {
       if (!r())
         throw new Error("Component is unmounted");
-      const o = u.generate();
+      const o = a.generate();
       e.setLoading();
       try {
-        const f = await (typeof n == "function" ? n() : n);
-        return r() && u.isLatest(o) && e.setSuccess(f), f;
-      } catch (d) {
-        throw r() && u.isLatest(o) && e.setError(d), d;
+        const d = await (typeof n == "function" ? n() : n);
+        return r() && a.isLatest(o) && await e.setSuccess(d), d;
+      } catch (l) {
+        throw r() && a.isLatest(o) && await e.setError(l), l;
       }
     },
-    [e, r, u]
+    [e, r, a]
   ), s = c(() => {
     r() && e.setIdle();
   }, [e, r]);
-  return L(
+  return v(
     () => ({
       loading: e.loading,
       result: e.result,
       error: e.error,
-      execute: i,
+      execute: u,
       reset: s,
       status: e.status
     }),
-    [e.loading, e.result, e.error, i, s, e.status]
+    [e.loading, e.result, e.error, u, s, e.status]
   );
 }
-function y(t) {
+function q(t) {
   const e = c(
     (s) => t.addListener(s),
     [t]
-  ), r = c(() => t.get(), [t]), u = C(e, r, r), i = c(
+  ), r = c(() => t.get(), [t]), a = x(e, r, r), u = c(
     (s) => t.set(s),
     [t]
   );
-  return [u, i];
+  return [a, u];
 }
 function A(t) {
-  const { fetcher: e = w.default } = t || {}, r = m(t), [u, i] = h(
+  const { fetcher: e = C.default } = t || {}, r = m(t), [a, u] = b(
     void 0
-  ), s = R(), n = v(), o = x(), d = b(t), f = F(e), E = c(
-    async (l) => {
-      n.current && n.current.abort(), n.current = l.abortController ?? new AbortController(), l.abortController = n.current;
+  ), s = L(), n = w(), o = I(), l = S(t), d = y(e), E = c(
+    async (f) => {
+      n.current && n.current.abort(), n.current = f.abortController ?? new AbortController(), f.abortController = n.current;
       const g = o.generate();
       r.setLoading();
       try {
-        const a = await f.exchange(
-          l,
-          d.current
+        const i = await d.exchange(
+          f,
+          l.current
         );
-        s() && o.isLatest(g) && i(a);
-        const S = await a.extractResult();
-        s() && o.isLatest(g) && r.setSuccess(S);
-      } catch (a) {
-        if (a instanceof Error && a.name === "AbortError") {
+        s() && o.isLatest(g) && u(i);
+        const h = await i.extractResult();
+        s() && o.isLatest(g) && await r.setSuccess(h);
+      } catch (i) {
+        if (i instanceof Error && i.name === "AbortError") {
           s() && r.setIdle();
           return;
         }
-        s() && o.isLatest(g) && r.setError(a);
+        s() && o.isLatest(g) && await r.setError(i);
       } finally {
-        n.current === l.abortController && (n.current = void 0);
+        n.current === f.abortController && (n.current = void 0);
       }
     },
-    [f, s, d, r, o]
+    [d, s, l, r, o]
   );
-  return I(() => () => {
+  return R(() => () => {
     n.current?.abort(), n.current = void 0;
-  }, []), L(
+  }, []), v(
     () => ({
       ...r,
-      exchange: u,
+      exchange: a,
       execute: E
     }),
-    [r, u, E]
+    [r, a, E]
   );
 }
 export {
-  p as PromiseStatus,
-  q as useExecutePromise,
+  F as PromiseStatus,
+  O as useExecutePromise,
   A as useFetcher,
-  y as useKeyStorage,
-  b as useLatest,
+  q as useKeyStorage,
+  S as useLatest,
   m as usePromiseState,
-  x as useRequestId
+  I as useRequestId
 };
 //# sourceMappingURL=index.es.js.map