npm - @ahoo-wang/fetcher-react - Versions diffs - 2.6.0 → 2.6.2 - Mend

@ahoo-wang/fetcher-react 2.6.0 → 2.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/core/useExecutePromise.d.ts +2 -2
package/dist/core/useExecutePromise.d.ts.map +1 -1
package/dist/fetcher/useFetcher.d.ts +3 -3
package/dist/fetcher/useFetcher.d.ts.map +1 -1
package/dist/index.es.js +71 -71
package/dist/index.es.js.map +1 -1
package/dist/index.umd.js +1 -1
package/dist/index.umd.js.map +1 -1
package/package.json +2 -2

package/dist/core/useExecutePromise.d.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import { PromiseState } from './usePromiseState';
+import { PromiseState, UsePromiseStateOptions } from './usePromiseState';
 /**
  * Type definition for a function that returns a Promise
  * @template R - The type of value the promise will resolve to
@@ -51,5 +51,5 @@ export interface UseExecutePromiseReturn<R, E = unknown> extends PromiseState<R,
  * }
  * ```
  */
-export declare function useExecutePromise<R = unknown>(): UseExecutePromiseReturn<R>;
+export declare function useExecutePromise<R = unknown, E = unknown>(options?: UsePromiseStateOptions<R, E>): UseExecutePromiseReturn<R, E>;
 //# sourceMappingURL=useExecutePromise.d.ts.map

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

	@@ -1 +1 @@
1	- {"version":3,"file":"useExecutePromise.d.ts","sourceRoot":"","sources":["../../src/core/useExecutePromise.ts"],"names":[],"mappings":"AAeA,OAAO,EAAmB,YAAY,EAAE,MAAM,mBAAmB,CAAC;~~AAGlE~~;;;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,~~KAAK~~,uBAAuB,CAAC,CAAC,CAAC,~~CAuD3E~~"}
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"}

package/dist/fetcher/useFetcher.d.ts CHANGED Viewed

@@ -1,10 +1,10 @@
 import { FetcherCapable, FetchExchange, FetchRequest, RequestOptions } from '@ahoo-wang/fetcher';
-import { PromiseState } from '../core';
+import { PromiseState, UsePromiseStateOptions } from '../core';
 /**
  * Configuration options for the useFetcher hook.
  * Extends RequestOptions and FetcherCapable interfaces.
  */
-export interface UseFetcherOptions extends RequestOptions, FetcherCapable {
+export interface UseFetcherOptions<R, E = unknown> extends RequestOptions, FetcherCapable, UsePromiseStateOptions<R, E> {
 }
 export interface UseFetcherReturn<R, E = unknown> extends PromiseState<R, E> {
     /** The FetchExchange object representing the ongoing fetch operation */
@@ -38,5 +38,5 @@ export interface UseFetcherReturn<R, E = unknown> extends PromiseState<R, E> {
  * }
  * ```
  */
-export declare function useFetcher<R, E = unknown>(options?: UseFetcherOptions): UseFetcherReturn<R, E>;
+export declare function useFetcher<R, E = unknown>(options?: UseFetcherOptions<R, E>): UseFetcherReturn<R, E>;
 //# sourceMappingURL=useFetcher.d.ts.map

package/dist/fetcher/useFetcher.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useFetcher.d.ts","sourceRoot":"","sources":["../../src/fetcher/useFetcher.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,cAAc,EACd,aAAa,EACb,YAAY,EAEZ,cAAc,EACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,~~EAAiC~~,MAAM,SAAS,CAAC;~~AAEtE~~;;;GAGG;AACH,MAAM,WAAW,~~iBAAkB~~,SAAQ,cAAc,EAAE,cAAc;~~CACxE~~;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1E,wEAAwE;IACxE,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,EACvC,OAAO,CAAC,EAAE,iBAAiB,~~GAC1B~~,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAgExB"}
1	+ {"version":3,"file":"useFetcher.d.ts","sourceRoot":"","sources":["../../src/fetcher/useFetcher.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,cAAc,EACd,aAAa,EACb,YAAY,EAEZ,cAAc,EACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAmB,sBAAsB,EAAgB,MAAM,SAAS,CAAC;AAE9F;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,cAAc,EAAE,cAAc,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC;CACtH;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1E,wEAAwE;IACxE,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,EACvC,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAgExB"}

package/dist/index.es.js CHANGED Viewed

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

package/dist/index.es.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.es.js","sources":["../../../node_modules/.pnpm/react-use@17.6.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/react-use/esm/useMountedState.js","../src/core/usePromiseState.ts","../src/core/useRequestId.ts","../src/core/useExecutePromise.ts","../src/storage/useKeyStorage.ts","../src/fetcher/useFetcher.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nexport default function useMountedState() {\n var mountedRef = useRef(false);\n var get = useCallback(function () { return mountedRef.current; }, []);\n useEffect(function () {\n mountedRef.current = true;\n return function () {\n mountedRef.current = false;\n };\n }, []);\n return get;\n}\n","/\n Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useMemo, useState } from 'react';\nimport { useMountedState } from 'react-use';\n\n/\n Enumeration of possible promise execution states\n /\nexport enum PromiseStatus {\n IDLE = 'idle',\n LOADING = 'loading',\n SUCCESS = 'success',\n ERROR = 'error',\n}\n\nexport interface PromiseState<R, E = unknown> {\n /* Current status of the promise /\n status: PromiseStatus;\n /* Indicates if currently loading /\n loading: boolean;\n /* The result value /\n result: R \| undefined;\n /* The error value /\n error: E \| undefined;\n}\n\n/\n Options for configuring usePromiseState behavior\n * @template R - The type of result\n \n @example\n * ```typescript\n * const options: UsePromiseStateOptions<string> = {\n * initialStatus: PromiseStatus.IDLE,\n * onSuccess: (result) => console.log('Success:', result),\n * onError: (error) => console.error('Error:', error),\n * };\n * ```\n /\nexport interface UsePromiseStateOptions<R, E = unknown> {\n /* Initial status, defaults to IDLE /\n initialStatus?: PromiseStatus;\n /* Callback invoked on success /\n onSuccess?: (result: R) => void;\n /* Callback invoked on error /\n onError?: (error: E) => void;\n}\n\n/\n Return type for usePromiseState hook\n * @template R - The type of result\n /\nexport interface UsePromiseStateReturn<R, E = unknown> extends PromiseState<R, E> {\n /* Set status to LOADING /\n setLoading: () => void;\n /* Set status to SUCCESS with result /\n setSuccess: (result: R) => void;\n /* Set status to ERROR with error /\n setError: (error: E) => void;\n /* Set status to IDLE /\n setIdle: () => void;\n}\n\n/\n A React hook for managing promise state without execution logic\n * @template R - The type of result\n * @param options - Configuration options\n * @returns State management object\n \n @example\n * ```typescript\n * import { usePromiseState, PromiseStatus } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { status, loading, result, error, setSuccess, setError, setIdle } = usePromiseState<string>();\n \n const handleSuccess = () => setSuccess('Data loaded');\n * const handleError = () => setError(new Error('Failed to load'));\n \n return (\n * <div>\n * <button onClick={handleSuccess}>Set Success</button>\n * <button onClick={handleError}>Set Error</button>\n * <button onClick={setIdle}>Reset</button>\n * <p>Status: {status}</p>\n * {loading && <p>Loading...</p>}\n * {result && <p>Result: {result}</p>}\n * {error && <p>Error: {error.message}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function usePromiseState<R = unknown, E = unknown>(\n options?: UsePromiseStateOptions<R, E>,\n): UsePromiseStateReturn<R, E> {\n const [status, setStatus] = useState<PromiseStatus>(\n options?.initialStatus ?? PromiseStatus.IDLE,\n );\n const [result, setResult] = useState<R \| undefined>(undefined);\n const [error, setErrorState] = useState<E \| undefined>(undefined);\n const isMounted = useMountedState();\n\n const setLoadingFn = useCallback(() => {\n if (isMounted()) {\n setStatus(PromiseStatus.LOADING);\n setErrorState(undefined);\n }\n }, [isMounted]);\n\n const setSuccessFn = useCallback(\n (result: R) => {\n if (isMounted()) {\n setResult(result);\n setStatus(PromiseStatus.SUCCESS);\n setErrorState(undefined);\n options?.onSuccess?.(result);\n }\n },\n [isMounted, options],\n );\n\n const setErrorFn = useCallback(\n (error: E) => {\n if (isMounted()) {\n setErrorState(error);\n setStatus(PromiseStatus.ERROR);\n setResult(undefined);\n options?.onError?.(error);\n }\n },\n [isMounted, options],\n );\n\n const setIdleFn = useCallback(() => {\n if (isMounted()) {\n setStatus(PromiseStatus.IDLE);\n setErrorState(undefined);\n setResult(undefined);\n }\n }, [isMounted]);\n return useMemo(() => ({\n status,\n loading: status === PromiseStatus.LOADING,\n result,\n error,\n setLoading: setLoadingFn,\n setSuccess: setSuccessFn,\n setError: setErrorFn,\n setIdle: setIdleFn,\n }), [status, result, error, setLoadingFn, setSuccessFn, setErrorFn, setIdleFn]);\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useRef, useCallback } from 'react';\n\n/\n Return type for useRequestId hook\n /\nexport interface UseRequestIdReturn {\n /* Generate a new request ID and get the current one /\n generate: () => number;\n /* Get the current request ID without generating a new one /\n current: () => number;\n /* Check if a given request ID is the latest /\n isLatest: (requestId: number) => boolean;\n /* Invalidate current request ID (mark as stale) /\n invalidate: () => void;\n /* Reset request ID counter /\n reset: () => void;\n}\n\n/\n A React hook for managing request IDs and race condition protection\n \n @example\n * ```typescript\n * // Basic usage\n * const requestId = useRequestId();\n \n const execute = async () => {\n * const id = requestId.generate();\n \n try {\n * const result = await someAsyncOperation();\n \n // Check if this is still the latest request\n * if (requestId.isLatest(id)) {\n * setState(result);\n * }\n * } catch (error) {\n * if (requestId.isLatest(id)) {\n * setError(error);\n * }\n * }\n * };\n \n // Manual cancellation\n * const handleCancel = () => {\n * requestId.invalidate(); // All ongoing requests will be ignored\n * };\n * ```\n \n @example\n * ```typescript\n * // With async operation wrapper\n * const { execute, cancel } = useAsyncOperation(async (data) => {\n * return await apiCall(data);\n * }, [requestId]);\n * ```\n /\nexport function useRequestId(): UseRequestIdReturn {\n const requestIdRef = useRef<number>(0);\n\n const generate = useCallback((): number => {\n return ++requestIdRef.current;\n }, []);\n\n const current = useCallback((): number => {\n return requestIdRef.current;\n }, []);\n\n const isLatest = useCallback((requestId: number): boolean => {\n return requestId === requestIdRef.current;\n }, []);\n\n const invalidate = useCallback((): void => {\n requestIdRef.current++;\n }, []);\n\n const reset = useCallback((): void => {\n requestIdRef.current = 0;\n }, []);\n\n return {\n generate,\n current,\n isLatest,\n invalidate,\n reset,\n };\n}","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useMemo } from 'react';\nimport { useMountedState } from 'react-use';\nimport { usePromiseState, PromiseState } from './usePromiseState';\nimport { useRequestId } from './useRequestId';\n\n/\n Type definition for a function that returns a Promise\n * @template R - The type of value the promise will resolve to\n /\nexport type PromiseSupplier<R> = () => Promise<R>;\n\n/\n Interface defining the return type of useExecutePromise hook\n * @template R - The type of the result value\n /\nexport interface UseExecutePromiseReturn<R, E = unknown>\n extends PromiseState<R, E> {\n /* Function to execute a promise supplier or promise /\n execute: (input: PromiseSupplier<R> \| Promise<R>) => Promise<R>;\n /* Function to reset the state to initial values /\n reset: () => void;\n}\n\n/\n A React hook for managing asynchronous operations with proper state handling\n * @template R - The type of the result value\n * @returns An object containing the current state and control functions\n \n @example\n * ```typescript\n * import { useExecutePromise } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { loading, result, error, execute, reset } = useExecutePromise<string>();\n \n const fetchData = async () => {\n * const response = await fetch('/api/data');\n * return response.text();\n * };\n \n const handleFetch = () => {\n * execute(fetchData);\n * };\n \n const handleReset = () => {\n * reset();\n * };\n \n if (loading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n * return (\n * <div>\n * <button onClick={handleFetch}>Fetch Data</button>\n * <button onClick={handleReset}>Reset</button>\n * {result && <p>{result}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useExecutePromise<R = unknown>(): UseExecutePromiseReturn<R> {\n const state = usePromiseState<R>();\n const isMounted = useMountedState();\n const requestId = useRequestId();\n\n /\n Execute a promise supplier or promise and manage its state\n * @param input - A function that returns a Promise or a Promise to be executed\n * @returns A Promise that resolves with the result of the executed promise\n /\n const execute = useCallback(\n async (input: PromiseSupplier<R> \| Promise<R>): Promise<R> => {\n if (!isMounted()) {\n throw new Error('Component is unmounted');\n }\n const currentRequestId = requestId.generate();\n state.setLoading();\n try {\n const promise = typeof input === 'function' ? input() : input;\n const data = await promise;\n\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setSuccess(data);\n }\n return data;\n } catch (err) {\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setError(err);\n }\n throw err;\n }\n },\n [state, isMounted, requestId],\n );\n\n /\n Reset the state to initial values\n /\n const reset = useCallback(() => {\n if (isMounted()) {\n state.setIdle();\n }\n }, [state, isMounted]);\n\n return useMemo(\n () => ({\n loading: state.loading,\n result: state.result,\n error: state.error,\n execute,\n reset,\n status: state.status,\n }),\n [state.loading, state.result, state.error, execute, reset, state.status],\n );\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useSyncExternalStore } from 'react';\nimport { KeyStorage } from '@ahoo-wang/fetcher-storage';\n\n/\n A React hook that provides state management for a KeyStorage instance.\n * Subscribes to storage changes and returns the current value along with a setter function.\n \n @template T - The type of value stored in the key storage\n * @param keyStorage - The KeyStorage instance to subscribe to and manage\n * @returns A tuple containing the current stored value and a function to update it\n /\nexport function useKeyStorage<T>(\n keyStorage: KeyStorage<T>,\n): [T \| null, (value: T) => void] {\n const subscribe = useCallback(\n (callback: () => void) => keyStorage.addListener(callback),\n [keyStorage],\n );\n const getSnapshot = useCallback(() => keyStorage.get(), [keyStorage]);\n const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n const setValue = useCallback(\n (value: T) => keyStorage.set(value),\n [keyStorage],\n );\n return [value, setValue];\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport {\n fetcher as defaultFetcher,\n FetcherCapable,\n FetchExchange,\n FetchRequest,\n getFetcher,\n RequestOptions,\n} from '@ahoo-wang/fetcher';\nimport { useRef, useCallback, useEffect, useState, useMemo } from 'react';\nimport { useMountedState } from 'react-use';\nimport { PromiseState, usePromiseState, useRequestId } from '../core';\n\n/\n Configuration options for the useFetcher hook.\n * Extends RequestOptions and FetcherCapable interfaces.\n /\nexport interface UseFetcherOptions extends RequestOptions, FetcherCapable {\n}\n\nexport interface UseFetcherReturn<R, E = unknown> extends PromiseState<R, E> {\n /* The FetchExchange object representing the ongoing fetch operation /\n exchange?: FetchExchange;\n execute: (request: FetchRequest) => Promise<void>;\n}\n\n/\n A React hook for managing asynchronous operations with proper state handling\n * @param options - Configuration options for the fetcher\n * @returns An object containing the current state and control functions\n \n @example\n * ```typescript\n * import { useFetcher } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { loading, result, error, execute } = useFetcher<string>();\n \n const handleFetch = () => {\n * execute({ url: '/api/data', method: 'GET' });\n * };\n \n if (loading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n * return (\n * <div>\n * <button onClick={handleFetch}>Fetch Data</button>\n * {result && <p>{result}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useFetcher<R, E = unknown>(\n options?: UseFetcherOptions,\n): UseFetcherReturn<R, E> {\n const { fetcher = defaultFetcher } = options \|\| {};\n const state = usePromiseState<R, E>();\n const [exchange, setExchange] = useState<FetchExchange \| undefined>(\n undefined,\n );\n const isMounted = useMountedState();\n const abortControllerRef = useRef<AbortController \| undefined>();\n const requestId = useRequestId();\n\n const currentFetcher = getFetcher(fetcher);\n /\n Execute the fetch operation.\n * Cancels any ongoing fetch before starting a new one.\n */\n const execute = useCallback(\n async (request: FetchRequest) => {\n if (abortControllerRef.current) {\n abortControllerRef.current.abort();\n }\n abortControllerRef.current =\n request.abortController ?? new AbortController();\n request.abortController = abortControllerRef.current;\n const currentRequestId = requestId.generate();\n state.setLoading();\n try {\n const exchange = await currentFetcher.exchange(request, options);\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n setExchange(exchange);\n }\n const result = await exchange.extractResult<R>();\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setSuccess(result);\n }\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n if (isMounted()) {\n state.setIdle();\n }\n return;\n }\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setError(error as E);\n }\n } finally {\n if (abortControllerRef.current === request.abortController) {\n abortControllerRef.current = undefined;\n }\n }\n },\n [currentFetcher, isMounted, options, state, requestId],\n );\n\n useEffect(() => {\n return () => {\n abortControllerRef.current?.abort();\n abortControllerRef.current = undefined;\n };\n }, []);\n return useMemo(() => ({\n ...state,\n exchange,\n execute,\n }), [state, exchange, execute]);\n}\n"],"names":["useMountedState","mountedRef","useRef","get","useCallback","useEffect","PromiseStatus","usePromiseState","options","status","setStatus","useState","result","setResult","error","setErrorState","isMounted","setLoadingFn","setSuccessFn","setErrorFn","setIdleFn","useMemo","useRequestId","requestIdRef","generate","current","isLatest","requestId","invalidate","reset","useExecutePromise","state","execute","input","currentRequestId","data","err","useKeyStorage","keyStorage","subscribe","callback","getSnapshot","value","useSyncExternalStore","setValue","useFetcher","fetcher","defaultFetcher","exchange","setExchange","abortControllerRef","currentFetcher","getFetcher","request"],"mappings":"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","x_google_ignoreList":[0]}
1	+ {"version":3,"file":"index.es.js","sources":["../../../node_modules/.pnpm/react-use@17.6.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/react-use/esm/useMountedState.js","../src/core/usePromiseState.ts","../src/core/useRequestId.ts","../src/core/useExecutePromise.ts","../src/storage/useKeyStorage.ts","../src/fetcher/useFetcher.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nexport default function useMountedState() {\n var mountedRef = useRef(false);\n var get = useCallback(function () { return mountedRef.current; }, []);\n useEffect(function () {\n mountedRef.current = true;\n return function () {\n mountedRef.current = false;\n };\n }, []);\n return get;\n}\n","/\n Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useMemo, useState } from 'react';\nimport { useMountedState } from 'react-use';\n\n/\n Enumeration of possible promise execution states\n /\nexport enum PromiseStatus {\n IDLE = 'idle',\n LOADING = 'loading',\n SUCCESS = 'success',\n ERROR = 'error',\n}\n\nexport interface PromiseState<R, E = unknown> {\n /* Current status of the promise /\n status: PromiseStatus;\n /* Indicates if currently loading /\n loading: boolean;\n /* The result value /\n result: R \| undefined;\n /* The error value /\n error: E \| undefined;\n}\n\n/\n Options for configuring usePromiseState behavior\n * @template R - The type of result\n \n @example\n * ```typescript\n * const options: UsePromiseStateOptions<string> = {\n * initialStatus: PromiseStatus.IDLE,\n * onSuccess: (result) => console.log('Success:', result),\n * onError: (error) => console.error('Error:', error),\n * };\n * ```\n /\nexport interface UsePromiseStateOptions<R, E = unknown> {\n /* Initial status, defaults to IDLE /\n initialStatus?: PromiseStatus;\n /* Callback invoked on success /\n onSuccess?: (result: R) => void;\n /* Callback invoked on error /\n onError?: (error: E) => void;\n}\n\n/\n Return type for usePromiseState hook\n * @template R - The type of result\n /\nexport interface UsePromiseStateReturn<R, E = unknown> extends PromiseState<R, E> {\n /* Set status to LOADING /\n setLoading: () => void;\n /* Set status to SUCCESS with result /\n setSuccess: (result: R) => void;\n /* Set status to ERROR with error /\n setError: (error: E) => void;\n /* Set status to IDLE /\n setIdle: () => void;\n}\n\n/\n A React hook for managing promise state without execution logic\n * @template R - The type of result\n * @param options - Configuration options\n * @returns State management object\n \n @example\n * ```typescript\n * import { usePromiseState, PromiseStatus } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { status, loading, result, error, setSuccess, setError, setIdle } = usePromiseState<string>();\n \n const handleSuccess = () => setSuccess('Data loaded');\n * const handleError = () => setError(new Error('Failed to load'));\n \n return (\n * <div>\n * <button onClick={handleSuccess}>Set Success</button>\n * <button onClick={handleError}>Set Error</button>\n * <button onClick={setIdle}>Reset</button>\n * <p>Status: {status}</p>\n * {loading && <p>Loading...</p>}\n * {result && <p>Result: {result}</p>}\n * {error && <p>Error: {error.message}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function usePromiseState<R = unknown, E = unknown>(\n options?: UsePromiseStateOptions<R, E>,\n): UsePromiseStateReturn<R, E> {\n const [status, setStatus] = useState<PromiseStatus>(\n options?.initialStatus ?? PromiseStatus.IDLE,\n );\n const [result, setResult] = useState<R \| undefined>(undefined);\n const [error, setErrorState] = useState<E \| undefined>(undefined);\n const isMounted = useMountedState();\n\n const setLoadingFn = useCallback(() => {\n if (isMounted()) {\n setStatus(PromiseStatus.LOADING);\n setErrorState(undefined);\n }\n }, [isMounted]);\n\n const setSuccessFn = useCallback(\n (result: R) => {\n if (isMounted()) {\n setResult(result);\n setStatus(PromiseStatus.SUCCESS);\n setErrorState(undefined);\n options?.onSuccess?.(result);\n }\n },\n [isMounted, options],\n );\n\n const setErrorFn = useCallback(\n (error: E) => {\n if (isMounted()) {\n setErrorState(error);\n setStatus(PromiseStatus.ERROR);\n setResult(undefined);\n options?.onError?.(error);\n }\n },\n [isMounted, options],\n );\n\n const setIdleFn = useCallback(() => {\n if (isMounted()) {\n setStatus(PromiseStatus.IDLE);\n setErrorState(undefined);\n setResult(undefined);\n }\n }, [isMounted]);\n return useMemo(() => ({\n status,\n loading: status === PromiseStatus.LOADING,\n result,\n error,\n setLoading: setLoadingFn,\n setSuccess: setSuccessFn,\n setError: setErrorFn,\n setIdle: setIdleFn,\n }), [status, result, error, setLoadingFn, setSuccessFn, setErrorFn, setIdleFn]);\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useRef, useCallback } from 'react';\n\n/\n Return type for useRequestId hook\n /\nexport interface UseRequestIdReturn {\n /* Generate a new request ID and get the current one /\n generate: () => number;\n /* Get the current request ID without generating a new one /\n current: () => number;\n /* Check if a given request ID is the latest /\n isLatest: (requestId: number) => boolean;\n /* Invalidate current request ID (mark as stale) /\n invalidate: () => void;\n /* Reset request ID counter /\n reset: () => void;\n}\n\n/\n A React hook for managing request IDs and race condition protection\n \n @example\n * ```typescript\n * // Basic usage\n * const requestId = useRequestId();\n \n const execute = async () => {\n * const id = requestId.generate();\n \n try {\n * const result = await someAsyncOperation();\n \n // Check if this is still the latest request\n * if (requestId.isLatest(id)) {\n * setState(result);\n * }\n * } catch (error) {\n * if (requestId.isLatest(id)) {\n * setError(error);\n * }\n * }\n * };\n \n // Manual cancellation\n * const handleCancel = () => {\n * requestId.invalidate(); // All ongoing requests will be ignored\n * };\n * ```\n \n @example\n * ```typescript\n * // With async operation wrapper\n * const { execute, cancel } = useAsyncOperation(async (data) => {\n * return await apiCall(data);\n * }, [requestId]);\n * ```\n /\nexport function useRequestId(): UseRequestIdReturn {\n const requestIdRef = useRef<number>(0);\n\n const generate = useCallback((): number => {\n return ++requestIdRef.current;\n }, []);\n\n const current = useCallback((): number => {\n return requestIdRef.current;\n }, []);\n\n const isLatest = useCallback((requestId: number): boolean => {\n return requestId === requestIdRef.current;\n }, []);\n\n const invalidate = useCallback((): void => {\n requestIdRef.current++;\n }, []);\n\n const reset = useCallback((): void => {\n requestIdRef.current = 0;\n }, []);\n\n return {\n generate,\n current,\n isLatest,\n invalidate,\n reset,\n };\n}","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useMemo } from 'react';\nimport { useMountedState } from 'react-use';\nimport { usePromiseState, PromiseState, UsePromiseStateOptions } from './usePromiseState';\nimport { useRequestId } from './useRequestId';\n\n/\n Type definition for a function that returns a Promise\n * @template R - The type of value the promise will resolve to\n /\nexport type PromiseSupplier<R> = () => Promise<R>;\n\n/\n Interface defining the return type of useExecutePromise hook\n * @template R - The type of the result value\n /\nexport interface UseExecutePromiseReturn<R, E = unknown>\n extends PromiseState<R, E> {\n /* Function to execute a promise supplier or promise /\n execute: (input: PromiseSupplier<R> \| Promise<R>) => Promise<R>;\n /* Function to reset the state to initial values /\n reset: () => void;\n}\n\n/\n A React hook for managing asynchronous operations with proper state handling\n * @template R - The type of the result value\n * @returns An object containing the current state and control functions\n \n @example\n * ```typescript\n * import { useExecutePromise } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { loading, result, error, execute, reset } = useExecutePromise<string>();\n \n const fetchData = async () => {\n * const response = await fetch('/api/data');\n * return response.text();\n * };\n \n const handleFetch = () => {\n * execute(fetchData);\n * };\n \n const handleReset = () => {\n * reset();\n * };\n \n if (loading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n * return (\n * <div>\n * <button onClick={handleFetch}>Fetch Data</button>\n * <button onClick={handleReset}>Reset</button>\n * {result && <p>{result}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useExecutePromise<R = unknown, E = unknown>(options?: UsePromiseStateOptions<R, E>): UseExecutePromiseReturn<R, E> {\n const state = usePromiseState<R, E>(options);\n const isMounted = useMountedState();\n const requestId = useRequestId();\n\n /\n Execute a promise supplier or promise and manage its state\n * @param input - A function that returns a Promise or a Promise to be executed\n * @returns A Promise that resolves with the result of the executed promise\n /\n const execute = useCallback(\n async (input: PromiseSupplier<R> \| Promise<R>): Promise<R> => {\n if (!isMounted()) {\n throw new Error('Component is unmounted');\n }\n const currentRequestId = requestId.generate();\n state.setLoading();\n try {\n const promise = typeof input === 'function' ? input() : input;\n const data = await promise;\n\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setSuccess(data);\n }\n return data;\n } catch (err) {\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setError(err as E);\n }\n throw err;\n }\n },\n [state, isMounted, requestId],\n );\n\n /\n Reset the state to initial values\n /\n const reset = useCallback(() => {\n if (isMounted()) {\n state.setIdle();\n }\n }, [state, isMounted]);\n\n return useMemo(\n () => ({\n loading: state.loading,\n result: state.result,\n error: state.error,\n execute,\n reset,\n status: state.status,\n }),\n [state.loading, state.result, state.error, execute, reset, state.status],\n );\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useSyncExternalStore } from 'react';\nimport { KeyStorage } from '@ahoo-wang/fetcher-storage';\n\n/\n A React hook that provides state management for a KeyStorage instance.\n * Subscribes to storage changes and returns the current value along with a setter function.\n \n @template T - The type of value stored in the key storage\n * @param keyStorage - The KeyStorage instance to subscribe to and manage\n * @returns A tuple containing the current stored value and a function to update it\n /\nexport function useKeyStorage<T>(\n keyStorage: KeyStorage<T>,\n): [T \| null, (value: T) => void] {\n const subscribe = useCallback(\n (callback: () => void) => keyStorage.addListener(callback),\n [keyStorage],\n );\n const getSnapshot = useCallback(() => keyStorage.get(), [keyStorage]);\n const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n const setValue = useCallback(\n (value: T) => keyStorage.set(value),\n [keyStorage],\n );\n return [value, setValue];\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport {\n fetcherRegistrar,\n FetcherCapable,\n FetchExchange,\n FetchRequest,\n getFetcher,\n RequestOptions,\n} from '@ahoo-wang/fetcher';\nimport { useRef, useCallback, useEffect, useState, useMemo } from 'react';\nimport { useMountedState } from 'react-use';\nimport { PromiseState, usePromiseState, UsePromiseStateOptions, useRequestId } from '../core';\n\n/\n Configuration options for the useFetcher hook.\n * Extends RequestOptions and FetcherCapable interfaces.\n /\nexport interface UseFetcherOptions<R, E = unknown> extends RequestOptions, FetcherCapable, UsePromiseStateOptions<R, E> {\n}\n\nexport interface UseFetcherReturn<R, E = unknown> extends PromiseState<R, E> {\n /* The FetchExchange object representing the ongoing fetch operation /\n exchange?: FetchExchange;\n execute: (request: FetchRequest) => Promise<void>;\n}\n\n/\n A React hook for managing asynchronous operations with proper state handling\n * @param options - Configuration options for the fetcher\n * @returns An object containing the current state and control functions\n \n @example\n * ```typescript\n * import { useFetcher } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { loading, result, error, execute } = useFetcher<string>();\n \n const handleFetch = () => {\n * execute({ url: '/api/data', method: 'GET' });\n * };\n \n if (loading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n * return (\n * <div>\n * <button onClick={handleFetch}>Fetch Data</button>\n * {result && <p>{result}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useFetcher<R, E = unknown>(\n options?: UseFetcherOptions<R, E>,\n): UseFetcherReturn<R, E> {\n const { fetcher = fetcherRegistrar.default } = options \|\| {};\n const state = usePromiseState<R, E>(options);\n const [exchange, setExchange] = useState<FetchExchange \| undefined>(\n undefined,\n );\n const isMounted = useMountedState();\n const abortControllerRef = useRef<AbortController \| undefined>();\n const requestId = useRequestId();\n\n const currentFetcher = getFetcher(fetcher);\n /\n Execute the fetch operation.\n * Cancels any ongoing fetch before starting a new one.\n */\n const execute = useCallback(\n async (request: FetchRequest) => {\n if (abortControllerRef.current) {\n abortControllerRef.current.abort();\n }\n abortControllerRef.current =\n request.abortController ?? new AbortController();\n request.abortController = abortControllerRef.current;\n const currentRequestId = requestId.generate();\n state.setLoading();\n try {\n const exchange = await currentFetcher.exchange(request, options);\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n setExchange(exchange);\n }\n const result = await exchange.extractResult<R>();\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setSuccess(result);\n }\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n if (isMounted()) {\n state.setIdle();\n }\n return;\n }\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setError(error as E);\n }\n } finally {\n if (abortControllerRef.current === request.abortController) {\n abortControllerRef.current = undefined;\n }\n }\n },\n [currentFetcher, isMounted, options, state, requestId],\n );\n\n useEffect(() => {\n return () => {\n abortControllerRef.current?.abort();\n abortControllerRef.current = undefined;\n };\n }, []);\n return useMemo(() => ({\n ...state,\n exchange,\n execute,\n }), [state, exchange, execute]);\n}\n"],"names":["useMountedState","mountedRef","useRef","get","useCallback","useEffect","PromiseStatus","usePromiseState","options","status","setStatus","useState","result","setResult","error","setErrorState","isMounted","setLoadingFn","setSuccessFn","setErrorFn","setIdleFn","useMemo","useRequestId","requestIdRef","generate","current","isLatest","requestId","invalidate","reset","useExecutePromise","state","execute","input","currentRequestId","data","err","useKeyStorage","keyStorage","subscribe","callback","getSnapshot","value","useSyncExternalStore","setValue","useFetcher","fetcher","fetcherRegistrar","exchange","setExchange","abortControllerRef","currentFetcher","getFetcher","request"],"mappings":"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","x_google_ignoreList":[0]}

package/dist/index.umd.js CHANGED Viewed

@@ -1,2 +1,2 @@
-(function(c,t){typeof exports=="object"&&typeof module<"u"?t(exports,require("react"),require("@ahoo-wang/fetcher")):typeof define=="function"&&define.amd?define(["exports","react","@ahoo-wang/fetcher"],t):(c=typeof globalThis<"u"?globalThis:c||self,t(c.FetcherReact={},c.React,c.Fetcher))})(this,(function(c,t,S){"use strict";function C(){var e=t.useRef(!1),s=t.useCallback(function(){return e.current},[]);return t.useEffect(function(){return e.current=!0,function(){e.current=!1}},[]),s}var v=(e=>(e.IDLE="idle",e.LOADING="loading",e.SUCCESS="success",e.ERROR="error",e))(v||{});function g(e){const[s,r]=t.useState(e?.initialStatus??"idle"),[i,a]=t.useState(void 0),[n,u]=t.useState(void 0),o=C(),d=t.useCallback(()=>{o()&&(r("loading"),u(void 0))},[o]),h=t.useCallback(l=>{o()&&(a(l),r("success"),u(void 0),e?.onSuccess?.(l))},[o,e]),f=t.useCallback(l=>{o()&&(u(l),r("error"),a(void 0),e?.onError?.(l))},[o,e]),b=t.useCallback(()=>{o()&&(r("idle"),u(void 0),a(void 0))},[o]);return t.useMemo(()=>({status:s,loading:s==="loading",result:i,error:n,setLoading:d,setSuccess:h,setError:f,setIdle:b}),[s,i,n,d,h,f,b])}function E(){const e=t.useRef(0),s=t.useCallback(()=>++e.current,[]),r=t.useCallback(()=>e.current,[]),i=t.useCallback(u=>u===e.current,[]),a=t.useCallback(()=>{e.current++},[]),n=t.useCallback(()=>{e.current=0},[]);return{generate:s,current:r,isLatest:i,invalidate:a,reset:n}}function m(){const e=g(),s=C(),r=E(),i=t.useCallback(async n=>{if(!s())throw new Error("Component is unmounted");const u=r.generate();e.setLoading();try{const d=await(typeof n=="function"?n():n);return s()&&r.isLatest(u)&&e.setSuccess(d),d}catch(o){throw s()&&r.isLatest(u)&&e.setError(o),o}},[e,s,r]),a=t.useCallback(()=>{s()&&e.setIdle()},[e,s]);return t.useMemo(()=>({loading:e.loading,result:e.result,error:e.error,execute:i,reset:a,status:e.status}),[e.loading,e.result,e.error,i,a,e.status])}function I(e){const s=t.useCallback(n=>e.addListener(n),[e]),r=t.useCallback(()=>e.get(),[e]),i=t.useSyncExternalStore(s,r,r),a=t.useCallback(n=>e.set(n),[e]);return[i,a]}function L(e){const{fetcher:s=S.fetcher}=e||{},r=g(),[i,a]=t.useState(void 0),n=C(),u=t.useRef(),o=E(),d=S.getFetcher(s),h=t.useCallback(async f=>{u.current&&u.current.abort(),u.current=f.abortController??new AbortController,f.abortController=u.current;const b=o.generate();r.setLoading();try{const l=await d.exchange(f,e);n()&&o.isLatest(b)&&a(l);const k=await l.extractResult();n()&&o.isLatest(b)&&r.setSuccess(k)}catch(l){if(l instanceof Error&&l.name==="AbortError"){n()&&r.setIdle();return}n()&&o.isLatest(b)&&r.setError(l)}finally{u.current===f.abortController&&(u.current=void 0)}},[d,n,e,r,o]);return t.useEffect(()=>()=>{u.current?.abort(),u.current=void 0},[]),t.useMemo(()=>({...r,exchange:i,execute:h}),[r,i,h])}c.PromiseStatus=v,c.useExecutePromise=m,c.useFetcher=L,c.useKeyStorage=I,c.usePromiseState=g,c.useRequestId=E,Object.defineProperty(c,Symbol.toStringTag,{value:"Module"})}));
+(function(a,t){typeof exports=="object"&&typeof module<"u"?t(exports,require("react"),require("@ahoo-wang/fetcher")):typeof define=="function"&&define.amd?define(["exports","react","@ahoo-wang/fetcher"],t):(a=typeof globalThis<"u"?globalThis:a||self,t(a.FetcherReact={},a.React,a.Fetcher))})(this,(function(a,t,S){"use strict";function C(){var e=t.useRef(!1),r=t.useCallback(function(){return e.current},[]);return t.useEffect(function(){return e.current=!0,function(){e.current=!1}},[]),r}var v=(e=>(e.IDLE="idle",e.LOADING="loading",e.SUCCESS="success",e.ERROR="error",e))(v||{});function g(e){const[r,s]=t.useState(e?.initialStatus??"idle"),[c,i]=t.useState(void 0),[u,n]=t.useState(void 0),o=C(),d=t.useCallback(()=>{o()&&(s("loading"),n(void 0))},[o]),f=t.useCallback(l=>{o()&&(i(l),s("success"),n(void 0),e?.onSuccess?.(l))},[o,e]),b=t.useCallback(l=>{o()&&(n(l),s("error"),i(void 0),e?.onError?.(l))},[o,e]),h=t.useCallback(()=>{o()&&(s("idle"),n(void 0),i(void 0))},[o]);return t.useMemo(()=>({status:r,loading:r==="loading",result:c,error:u,setLoading:d,setSuccess:f,setError:b,setIdle:h}),[r,c,u,d,f,b,h])}function E(){const e=t.useRef(0),r=t.useCallback(()=>++e.current,[]),s=t.useCallback(()=>e.current,[]),c=t.useCallback(n=>n===e.current,[]),i=t.useCallback(()=>{e.current++},[]),u=t.useCallback(()=>{e.current=0},[]);return{generate:r,current:s,isLatest:c,invalidate:i,reset:u}}function m(e){const r=g(e),s=C(),c=E(),i=t.useCallback(async n=>{if(!s())throw new Error("Component is unmounted");const o=c.generate();r.setLoading();try{const f=await(typeof n=="function"?n():n);return s()&&c.isLatest(o)&&r.setSuccess(f),f}catch(d){throw s()&&c.isLatest(o)&&r.setError(d),d}},[r,s,c]),u=t.useCallback(()=>{s()&&r.setIdle()},[r,s]);return t.useMemo(()=>({loading:r.loading,result:r.result,error:r.error,execute:i,reset:u,status:r.status}),[r.loading,r.result,r.error,i,u,r.status])}function I(e){const r=t.useCallback(u=>e.addListener(u),[e]),s=t.useCallback(()=>e.get(),[e]),c=t.useSyncExternalStore(r,s,s),i=t.useCallback(u=>e.set(u),[e]);return[c,i]}function L(e){const{fetcher:r=S.fetcherRegistrar.default}=e||{},s=g(e),[c,i]=t.useState(void 0),u=C(),n=t.useRef(),o=E(),d=S.getFetcher(r),f=t.useCallback(async b=>{n.current&&n.current.abort(),n.current=b.abortController??new AbortController,b.abortController=n.current;const h=o.generate();s.setLoading();try{const l=await d.exchange(b,e);u()&&o.isLatest(h)&&i(l);const k=await l.extractResult();u()&&o.isLatest(h)&&s.setSuccess(k)}catch(l){if(l instanceof Error&&l.name==="AbortError"){u()&&s.setIdle();return}u()&&o.isLatest(h)&&s.setError(l)}finally{n.current===b.abortController&&(n.current=void 0)}},[d,u,e,s,o]);return t.useEffect(()=>()=>{n.current?.abort(),n.current=void 0},[]),t.useMemo(()=>({...s,exchange:c,execute:f}),[s,c,f])}a.PromiseStatus=v,a.useExecutePromise=m,a.useFetcher=L,a.useKeyStorage=I,a.usePromiseState=g,a.useRequestId=E,Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})}));
 //# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.umd.js","sources":["../../../node_modules/.pnpm/react-use@17.6.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/react-use/esm/useMountedState.js","../src/core/usePromiseState.ts","../src/core/useRequestId.ts","../src/core/useExecutePromise.ts","../src/storage/useKeyStorage.ts","../src/fetcher/useFetcher.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nexport default function useMountedState() {\n var mountedRef = useRef(false);\n var get = useCallback(function () { return mountedRef.current; }, []);\n useEffect(function () {\n mountedRef.current = true;\n return function () {\n mountedRef.current = false;\n };\n }, []);\n return get;\n}\n","/\n Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useMemo, useState } from 'react';\nimport { useMountedState } from 'react-use';\n\n/\n Enumeration of possible promise execution states\n /\nexport enum PromiseStatus {\n IDLE = 'idle',\n LOADING = 'loading',\n SUCCESS = 'success',\n ERROR = 'error',\n}\n\nexport interface PromiseState<R, E = unknown> {\n /* Current status of the promise /\n status: PromiseStatus;\n /* Indicates if currently loading /\n loading: boolean;\n /* The result value /\n result: R \| undefined;\n /* The error value /\n error: E \| undefined;\n}\n\n/\n Options for configuring usePromiseState behavior\n * @template R - The type of result\n \n @example\n * ```typescript\n * const options: UsePromiseStateOptions<string> = {\n * initialStatus: PromiseStatus.IDLE,\n * onSuccess: (result) => console.log('Success:', result),\n * onError: (error) => console.error('Error:', error),\n * };\n * ```\n /\nexport interface UsePromiseStateOptions<R, E = unknown> {\n /* Initial status, defaults to IDLE /\n initialStatus?: PromiseStatus;\n /* Callback invoked on success /\n onSuccess?: (result: R) => void;\n /* Callback invoked on error /\n onError?: (error: E) => void;\n}\n\n/\n Return type for usePromiseState hook\n * @template R - The type of result\n /\nexport interface UsePromiseStateReturn<R, E = unknown> extends PromiseState<R, E> {\n /* Set status to LOADING /\n setLoading: () => void;\n /* Set status to SUCCESS with result /\n setSuccess: (result: R) => void;\n /* Set status to ERROR with error /\n setError: (error: E) => void;\n /* Set status to IDLE /\n setIdle: () => void;\n}\n\n/\n A React hook for managing promise state without execution logic\n * @template R - The type of result\n * @param options - Configuration options\n * @returns State management object\n \n @example\n * ```typescript\n * import { usePromiseState, PromiseStatus } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { status, loading, result, error, setSuccess, setError, setIdle } = usePromiseState<string>();\n \n const handleSuccess = () => setSuccess('Data loaded');\n * const handleError = () => setError(new Error('Failed to load'));\n \n return (\n * <div>\n * <button onClick={handleSuccess}>Set Success</button>\n * <button onClick={handleError}>Set Error</button>\n * <button onClick={setIdle}>Reset</button>\n * <p>Status: {status}</p>\n * {loading && <p>Loading...</p>}\n * {result && <p>Result: {result}</p>}\n * {error && <p>Error: {error.message}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function usePromiseState<R = unknown, E = unknown>(\n options?: UsePromiseStateOptions<R, E>,\n): UsePromiseStateReturn<R, E> {\n const [status, setStatus] = useState<PromiseStatus>(\n options?.initialStatus ?? PromiseStatus.IDLE,\n );\n const [result, setResult] = useState<R \| undefined>(undefined);\n const [error, setErrorState] = useState<E \| undefined>(undefined);\n const isMounted = useMountedState();\n\n const setLoadingFn = useCallback(() => {\n if (isMounted()) {\n setStatus(PromiseStatus.LOADING);\n setErrorState(undefined);\n }\n }, [isMounted]);\n\n const setSuccessFn = useCallback(\n (result: R) => {\n if (isMounted()) {\n setResult(result);\n setStatus(PromiseStatus.SUCCESS);\n setErrorState(undefined);\n options?.onSuccess?.(result);\n }\n },\n [isMounted, options],\n );\n\n const setErrorFn = useCallback(\n (error: E) => {\n if (isMounted()) {\n setErrorState(error);\n setStatus(PromiseStatus.ERROR);\n setResult(undefined);\n options?.onError?.(error);\n }\n },\n [isMounted, options],\n );\n\n const setIdleFn = useCallback(() => {\n if (isMounted()) {\n setStatus(PromiseStatus.IDLE);\n setErrorState(undefined);\n setResult(undefined);\n }\n }, [isMounted]);\n return useMemo(() => ({\n status,\n loading: status === PromiseStatus.LOADING,\n result,\n error,\n setLoading: setLoadingFn,\n setSuccess: setSuccessFn,\n setError: setErrorFn,\n setIdle: setIdleFn,\n }), [status, result, error, setLoadingFn, setSuccessFn, setErrorFn, setIdleFn]);\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useRef, useCallback } from 'react';\n\n/\n Return type for useRequestId hook\n /\nexport interface UseRequestIdReturn {\n /* Generate a new request ID and get the current one /\n generate: () => number;\n /* Get the current request ID without generating a new one /\n current: () => number;\n /* Check if a given request ID is the latest /\n isLatest: (requestId: number) => boolean;\n /* Invalidate current request ID (mark as stale) /\n invalidate: () => void;\n /* Reset request ID counter /\n reset: () => void;\n}\n\n/\n A React hook for managing request IDs and race condition protection\n \n @example\n * ```typescript\n * // Basic usage\n * const requestId = useRequestId();\n \n const execute = async () => {\n * const id = requestId.generate();\n \n try {\n * const result = await someAsyncOperation();\n \n // Check if this is still the latest request\n * if (requestId.isLatest(id)) {\n * setState(result);\n * }\n * } catch (error) {\n * if (requestId.isLatest(id)) {\n * setError(error);\n * }\n * }\n * };\n \n // Manual cancellation\n * const handleCancel = () => {\n * requestId.invalidate(); // All ongoing requests will be ignored\n * };\n * ```\n \n @example\n * ```typescript\n * // With async operation wrapper\n * const { execute, cancel } = useAsyncOperation(async (data) => {\n * return await apiCall(data);\n * }, [requestId]);\n * ```\n /\nexport function useRequestId(): UseRequestIdReturn {\n const requestIdRef = useRef<number>(0);\n\n const generate = useCallback((): number => {\n return ++requestIdRef.current;\n }, []);\n\n const current = useCallback((): number => {\n return requestIdRef.current;\n }, []);\n\n const isLatest = useCallback((requestId: number): boolean => {\n return requestId === requestIdRef.current;\n }, []);\n\n const invalidate = useCallback((): void => {\n requestIdRef.current++;\n }, []);\n\n const reset = useCallback((): void => {\n requestIdRef.current = 0;\n }, []);\n\n return {\n generate,\n current,\n isLatest,\n invalidate,\n reset,\n };\n}","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useMemo } from 'react';\nimport { useMountedState } from 'react-use';\nimport { usePromiseState, PromiseState } from './usePromiseState';\nimport { useRequestId } from './useRequestId';\n\n/\n Type definition for a function that returns a Promise\n * @template R - The type of value the promise will resolve to\n /\nexport type PromiseSupplier<R> = () => Promise<R>;\n\n/\n Interface defining the return type of useExecutePromise hook\n * @template R - The type of the result value\n /\nexport interface UseExecutePromiseReturn<R, E = unknown>\n extends PromiseState<R, E> {\n /* Function to execute a promise supplier or promise /\n execute: (input: PromiseSupplier<R> \| Promise<R>) => Promise<R>;\n /* Function to reset the state to initial values /\n reset: () => void;\n}\n\n/\n A React hook for managing asynchronous operations with proper state handling\n * @template R - The type of the result value\n * @returns An object containing the current state and control functions\n \n @example\n * ```typescript\n * import { useExecutePromise } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { loading, result, error, execute, reset } = useExecutePromise<string>();\n \n const fetchData = async () => {\n * const response = await fetch('/api/data');\n * return response.text();\n * };\n \n const handleFetch = () => {\n * execute(fetchData);\n * };\n \n const handleReset = () => {\n * reset();\n * };\n \n if (loading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n * return (\n * <div>\n * <button onClick={handleFetch}>Fetch Data</button>\n * <button onClick={handleReset}>Reset</button>\n * {result && <p>{result}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useExecutePromise<R = unknown>(): UseExecutePromiseReturn<R> {\n const state = usePromiseState<R>();\n const isMounted = useMountedState();\n const requestId = useRequestId();\n\n /\n Execute a promise supplier or promise and manage its state\n * @param input - A function that returns a Promise or a Promise to be executed\n * @returns A Promise that resolves with the result of the executed promise\n /\n const execute = useCallback(\n async (input: PromiseSupplier<R> \| Promise<R>): Promise<R> => {\n if (!isMounted()) {\n throw new Error('Component is unmounted');\n }\n const currentRequestId = requestId.generate();\n state.setLoading();\n try {\n const promise = typeof input === 'function' ? input() : input;\n const data = await promise;\n\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setSuccess(data);\n }\n return data;\n } catch (err) {\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setError(err);\n }\n throw err;\n }\n },\n [state, isMounted, requestId],\n );\n\n /\n Reset the state to initial values\n /\n const reset = useCallback(() => {\n if (isMounted()) {\n state.setIdle();\n }\n }, [state, isMounted]);\n\n return useMemo(\n () => ({\n loading: state.loading,\n result: state.result,\n error: state.error,\n execute,\n reset,\n status: state.status,\n }),\n [state.loading, state.result, state.error, execute, reset, state.status],\n );\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useSyncExternalStore } from 'react';\nimport { KeyStorage } from '@ahoo-wang/fetcher-storage';\n\n/\n A React hook that provides state management for a KeyStorage instance.\n * Subscribes to storage changes and returns the current value along with a setter function.\n \n @template T - The type of value stored in the key storage\n * @param keyStorage - The KeyStorage instance to subscribe to and manage\n * @returns A tuple containing the current stored value and a function to update it\n /\nexport function useKeyStorage<T>(\n keyStorage: KeyStorage<T>,\n): [T \| null, (value: T) => void] {\n const subscribe = useCallback(\n (callback: () => void) => keyStorage.addListener(callback),\n [keyStorage],\n );\n const getSnapshot = useCallback(() => keyStorage.get(), [keyStorage]);\n const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n const setValue = useCallback(\n (value: T) => keyStorage.set(value),\n [keyStorage],\n );\n return [value, setValue];\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport {\n fetcher as defaultFetcher,\n FetcherCapable,\n FetchExchange,\n FetchRequest,\n getFetcher,\n RequestOptions,\n} from '@ahoo-wang/fetcher';\nimport { useRef, useCallback, useEffect, useState, useMemo } from 'react';\nimport { useMountedState } from 'react-use';\nimport { PromiseState, usePromiseState, useRequestId } from '../core';\n\n/\n Configuration options for the useFetcher hook.\n * Extends RequestOptions and FetcherCapable interfaces.\n /\nexport interface UseFetcherOptions extends RequestOptions, FetcherCapable {\n}\n\nexport interface UseFetcherReturn<R, E = unknown> extends PromiseState<R, E> {\n /* The FetchExchange object representing the ongoing fetch operation /\n exchange?: FetchExchange;\n execute: (request: FetchRequest) => Promise<void>;\n}\n\n/\n A React hook for managing asynchronous operations with proper state handling\n * @param options - Configuration options for the fetcher\n * @returns An object containing the current state and control functions\n \n @example\n * ```typescript\n * import { useFetcher } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { loading, result, error, execute } = useFetcher<string>();\n \n const handleFetch = () => {\n * execute({ url: '/api/data', method: 'GET' });\n * };\n \n if (loading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n * return (\n * <div>\n * <button onClick={handleFetch}>Fetch Data</button>\n * {result && <p>{result}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useFetcher<R, E = unknown>(\n options?: UseFetcherOptions,\n): UseFetcherReturn<R, E> {\n const { fetcher = defaultFetcher } = options \|\| {};\n const state = usePromiseState<R, E>();\n const [exchange, setExchange] = useState<FetchExchange \| undefined>(\n undefined,\n );\n const isMounted = useMountedState();\n const abortControllerRef = useRef<AbortController \| undefined>();\n const requestId = useRequestId();\n\n const currentFetcher = getFetcher(fetcher);\n /\n Execute the fetch operation.\n * Cancels any ongoing fetch before starting a new one.\n */\n const execute = useCallback(\n async (request: FetchRequest) => {\n if (abortControllerRef.current) {\n abortControllerRef.current.abort();\n }\n abortControllerRef.current =\n request.abortController ?? new AbortController();\n request.abortController = abortControllerRef.current;\n const currentRequestId = requestId.generate();\n state.setLoading();\n try {\n const exchange = await currentFetcher.exchange(request, options);\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n setExchange(exchange);\n }\n const result = await exchange.extractResult<R>();\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setSuccess(result);\n }\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n if (isMounted()) {\n state.setIdle();\n }\n return;\n }\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setError(error as E);\n }\n } finally {\n if (abortControllerRef.current === request.abortController) {\n abortControllerRef.current = undefined;\n }\n }\n },\n [currentFetcher, isMounted, options, state, requestId],\n );\n\n useEffect(() => {\n return () => {\n abortControllerRef.current?.abort();\n abortControllerRef.current = undefined;\n };\n }, []);\n return useMemo(() => ({\n ...state,\n exchange,\n execute,\n }), [state, exchange, execute]);\n}\n"],"names":["useMountedState","mountedRef","useRef","get","useCallback","useEffect","PromiseStatus","usePromiseState","options","status","setStatus","useState","result","setResult","error","setErrorState","isMounted","setLoadingFn","setSuccessFn","setErrorFn","setIdleFn","useMemo","useRequestId","requestIdRef","generate","current","isLatest","requestId","invalidate","reset","useExecutePromise","state","execute","input","currentRequestId","data","err","useKeyStorage","keyStorage","subscribe","callback","getSnapshot","value","useSyncExternalStore","setValue","useFetcher","fetcher","defaultFetcher","exchange","setExchange","abortControllerRef","currentFetcher","getFetcher","request"],"mappings":"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","x_google_ignoreList":[0]}
1	+ {"version":3,"file":"index.umd.js","sources":["../../../node_modules/.pnpm/react-use@17.6.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/react-use/esm/useMountedState.js","../src/core/usePromiseState.ts","../src/core/useRequestId.ts","../src/core/useExecutePromise.ts","../src/storage/useKeyStorage.ts","../src/fetcher/useFetcher.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nexport default function useMountedState() {\n var mountedRef = useRef(false);\n var get = useCallback(function () { return mountedRef.current; }, []);\n useEffect(function () {\n mountedRef.current = true;\n return function () {\n mountedRef.current = false;\n };\n }, []);\n return get;\n}\n","/\n Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useMemo, useState } from 'react';\nimport { useMountedState } from 'react-use';\n\n/\n Enumeration of possible promise execution states\n /\nexport enum PromiseStatus {\n IDLE = 'idle',\n LOADING = 'loading',\n SUCCESS = 'success',\n ERROR = 'error',\n}\n\nexport interface PromiseState<R, E = unknown> {\n /* Current status of the promise /\n status: PromiseStatus;\n /* Indicates if currently loading /\n loading: boolean;\n /* The result value /\n result: R \| undefined;\n /* The error value /\n error: E \| undefined;\n}\n\n/\n Options for configuring usePromiseState behavior\n * @template R - The type of result\n \n @example\n * ```typescript\n * const options: UsePromiseStateOptions<string> = {\n * initialStatus: PromiseStatus.IDLE,\n * onSuccess: (result) => console.log('Success:', result),\n * onError: (error) => console.error('Error:', error),\n * };\n * ```\n /\nexport interface UsePromiseStateOptions<R, E = unknown> {\n /* Initial status, defaults to IDLE /\n initialStatus?: PromiseStatus;\n /* Callback invoked on success /\n onSuccess?: (result: R) => void;\n /* Callback invoked on error /\n onError?: (error: E) => void;\n}\n\n/\n Return type for usePromiseState hook\n * @template R - The type of result\n /\nexport interface UsePromiseStateReturn<R, E = unknown> extends PromiseState<R, E> {\n /* Set status to LOADING /\n setLoading: () => void;\n /* Set status to SUCCESS with result /\n setSuccess: (result: R) => void;\n /* Set status to ERROR with error /\n setError: (error: E) => void;\n /* Set status to IDLE /\n setIdle: () => void;\n}\n\n/\n A React hook for managing promise state without execution logic\n * @template R - The type of result\n * @param options - Configuration options\n * @returns State management object\n \n @example\n * ```typescript\n * import { usePromiseState, PromiseStatus } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { status, loading, result, error, setSuccess, setError, setIdle } = usePromiseState<string>();\n \n const handleSuccess = () => setSuccess('Data loaded');\n * const handleError = () => setError(new Error('Failed to load'));\n \n return (\n * <div>\n * <button onClick={handleSuccess}>Set Success</button>\n * <button onClick={handleError}>Set Error</button>\n * <button onClick={setIdle}>Reset</button>\n * <p>Status: {status}</p>\n * {loading && <p>Loading...</p>}\n * {result && <p>Result: {result}</p>}\n * {error && <p>Error: {error.message}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function usePromiseState<R = unknown, E = unknown>(\n options?: UsePromiseStateOptions<R, E>,\n): UsePromiseStateReturn<R, E> {\n const [status, setStatus] = useState<PromiseStatus>(\n options?.initialStatus ?? PromiseStatus.IDLE,\n );\n const [result, setResult] = useState<R \| undefined>(undefined);\n const [error, setErrorState] = useState<E \| undefined>(undefined);\n const isMounted = useMountedState();\n\n const setLoadingFn = useCallback(() => {\n if (isMounted()) {\n setStatus(PromiseStatus.LOADING);\n setErrorState(undefined);\n }\n }, [isMounted]);\n\n const setSuccessFn = useCallback(\n (result: R) => {\n if (isMounted()) {\n setResult(result);\n setStatus(PromiseStatus.SUCCESS);\n setErrorState(undefined);\n options?.onSuccess?.(result);\n }\n },\n [isMounted, options],\n );\n\n const setErrorFn = useCallback(\n (error: E) => {\n if (isMounted()) {\n setErrorState(error);\n setStatus(PromiseStatus.ERROR);\n setResult(undefined);\n options?.onError?.(error);\n }\n },\n [isMounted, options],\n );\n\n const setIdleFn = useCallback(() => {\n if (isMounted()) {\n setStatus(PromiseStatus.IDLE);\n setErrorState(undefined);\n setResult(undefined);\n }\n }, [isMounted]);\n return useMemo(() => ({\n status,\n loading: status === PromiseStatus.LOADING,\n result,\n error,\n setLoading: setLoadingFn,\n setSuccess: setSuccessFn,\n setError: setErrorFn,\n setIdle: setIdleFn,\n }), [status, result, error, setLoadingFn, setSuccessFn, setErrorFn, setIdleFn]);\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useRef, useCallback } from 'react';\n\n/\n Return type for useRequestId hook\n /\nexport interface UseRequestIdReturn {\n /* Generate a new request ID and get the current one /\n generate: () => number;\n /* Get the current request ID without generating a new one /\n current: () => number;\n /* Check if a given request ID is the latest /\n isLatest: (requestId: number) => boolean;\n /* Invalidate current request ID (mark as stale) /\n invalidate: () => void;\n /* Reset request ID counter /\n reset: () => void;\n}\n\n/\n A React hook for managing request IDs and race condition protection\n \n @example\n * ```typescript\n * // Basic usage\n * const requestId = useRequestId();\n \n const execute = async () => {\n * const id = requestId.generate();\n \n try {\n * const result = await someAsyncOperation();\n \n // Check if this is still the latest request\n * if (requestId.isLatest(id)) {\n * setState(result);\n * }\n * } catch (error) {\n * if (requestId.isLatest(id)) {\n * setError(error);\n * }\n * }\n * };\n \n // Manual cancellation\n * const handleCancel = () => {\n * requestId.invalidate(); // All ongoing requests will be ignored\n * };\n * ```\n \n @example\n * ```typescript\n * // With async operation wrapper\n * const { execute, cancel } = useAsyncOperation(async (data) => {\n * return await apiCall(data);\n * }, [requestId]);\n * ```\n /\nexport function useRequestId(): UseRequestIdReturn {\n const requestIdRef = useRef<number>(0);\n\n const generate = useCallback((): number => {\n return ++requestIdRef.current;\n }, []);\n\n const current = useCallback((): number => {\n return requestIdRef.current;\n }, []);\n\n const isLatest = useCallback((requestId: number): boolean => {\n return requestId === requestIdRef.current;\n }, []);\n\n const invalidate = useCallback((): void => {\n requestIdRef.current++;\n }, []);\n\n const reset = useCallback((): void => {\n requestIdRef.current = 0;\n }, []);\n\n return {\n generate,\n current,\n isLatest,\n invalidate,\n reset,\n };\n}","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useMemo } from 'react';\nimport { useMountedState } from 'react-use';\nimport { usePromiseState, PromiseState, UsePromiseStateOptions } from './usePromiseState';\nimport { useRequestId } from './useRequestId';\n\n/\n Type definition for a function that returns a Promise\n * @template R - The type of value the promise will resolve to\n /\nexport type PromiseSupplier<R> = () => Promise<R>;\n\n/\n Interface defining the return type of useExecutePromise hook\n * @template R - The type of the result value\n /\nexport interface UseExecutePromiseReturn<R, E = unknown>\n extends PromiseState<R, E> {\n /* Function to execute a promise supplier or promise /\n execute: (input: PromiseSupplier<R> \| Promise<R>) => Promise<R>;\n /* Function to reset the state to initial values /\n reset: () => void;\n}\n\n/\n A React hook for managing asynchronous operations with proper state handling\n * @template R - The type of the result value\n * @returns An object containing the current state and control functions\n \n @example\n * ```typescript\n * import { useExecutePromise } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { loading, result, error, execute, reset } = useExecutePromise<string>();\n \n const fetchData = async () => {\n * const response = await fetch('/api/data');\n * return response.text();\n * };\n \n const handleFetch = () => {\n * execute(fetchData);\n * };\n \n const handleReset = () => {\n * reset();\n * };\n \n if (loading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n * return (\n * <div>\n * <button onClick={handleFetch}>Fetch Data</button>\n * <button onClick={handleReset}>Reset</button>\n * {result && <p>{result}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useExecutePromise<R = unknown, E = unknown>(options?: UsePromiseStateOptions<R, E>): UseExecutePromiseReturn<R, E> {\n const state = usePromiseState<R, E>(options);\n const isMounted = useMountedState();\n const requestId = useRequestId();\n\n /\n Execute a promise supplier or promise and manage its state\n * @param input - A function that returns a Promise or a Promise to be executed\n * @returns A Promise that resolves with the result of the executed promise\n /\n const execute = useCallback(\n async (input: PromiseSupplier<R> \| Promise<R>): Promise<R> => {\n if (!isMounted()) {\n throw new Error('Component is unmounted');\n }\n const currentRequestId = requestId.generate();\n state.setLoading();\n try {\n const promise = typeof input === 'function' ? input() : input;\n const data = await promise;\n\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setSuccess(data);\n }\n return data;\n } catch (err) {\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setError(err as E);\n }\n throw err;\n }\n },\n [state, isMounted, requestId],\n );\n\n /\n Reset the state to initial values\n /\n const reset = useCallback(() => {\n if (isMounted()) {\n state.setIdle();\n }\n }, [state, isMounted]);\n\n return useMemo(\n () => ({\n loading: state.loading,\n result: state.result,\n error: state.error,\n execute,\n reset,\n status: state.status,\n }),\n [state.loading, state.result, state.error, execute, reset, state.status],\n );\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport { useCallback, useSyncExternalStore } from 'react';\nimport { KeyStorage } from '@ahoo-wang/fetcher-storage';\n\n/\n A React hook that provides state management for a KeyStorage instance.\n * Subscribes to storage changes and returns the current value along with a setter function.\n \n @template T - The type of value stored in the key storage\n * @param keyStorage - The KeyStorage instance to subscribe to and manage\n * @returns A tuple containing the current stored value and a function to update it\n /\nexport function useKeyStorage<T>(\n keyStorage: KeyStorage<T>,\n): [T \| null, (value: T) => void] {\n const subscribe = useCallback(\n (callback: () => void) => keyStorage.addListener(callback),\n [keyStorage],\n );\n const getSnapshot = useCallback(() => keyStorage.get(), [keyStorage]);\n const value = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n const setValue = useCallback(\n (value: T) => keyStorage.set(value),\n [keyStorage],\n );\n return [value, setValue];\n}\n","/\n * Copyright [2021-present] [ahoo wang <ahoowang@qq.com> (https://github.com/Ahoo-Wang)].\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n * http://www.apache.org/licenses/LICENSE-2.0\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n /\n\nimport {\n fetcherRegistrar,\n FetcherCapable,\n FetchExchange,\n FetchRequest,\n getFetcher,\n RequestOptions,\n} from '@ahoo-wang/fetcher';\nimport { useRef, useCallback, useEffect, useState, useMemo } from 'react';\nimport { useMountedState } from 'react-use';\nimport { PromiseState, usePromiseState, UsePromiseStateOptions, useRequestId } from '../core';\n\n/\n Configuration options for the useFetcher hook.\n * Extends RequestOptions and FetcherCapable interfaces.\n /\nexport interface UseFetcherOptions<R, E = unknown> extends RequestOptions, FetcherCapable, UsePromiseStateOptions<R, E> {\n}\n\nexport interface UseFetcherReturn<R, E = unknown> extends PromiseState<R, E> {\n /* The FetchExchange object representing the ongoing fetch operation /\n exchange?: FetchExchange;\n execute: (request: FetchRequest) => Promise<void>;\n}\n\n/\n A React hook for managing asynchronous operations with proper state handling\n * @param options - Configuration options for the fetcher\n * @returns An object containing the current state and control functions\n \n @example\n * ```typescript\n * import { useFetcher } from '@ahoo-wang/fetcher-react';\n \n function MyComponent() {\n * const { loading, result, error, execute } = useFetcher<string>();\n \n const handleFetch = () => {\n * execute({ url: '/api/data', method: 'GET' });\n * };\n \n if (loading) return <div>Loading...</div>;\n * if (error) return <div>Error: {error.message}</div>;\n * return (\n * <div>\n * <button onClick={handleFetch}>Fetch Data</button>\n * {result && <p>{result}</p>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useFetcher<R, E = unknown>(\n options?: UseFetcherOptions<R, E>,\n): UseFetcherReturn<R, E> {\n const { fetcher = fetcherRegistrar.default } = options \|\| {};\n const state = usePromiseState<R, E>(options);\n const [exchange, setExchange] = useState<FetchExchange \| undefined>(\n undefined,\n );\n const isMounted = useMountedState();\n const abortControllerRef = useRef<AbortController \| undefined>();\n const requestId = useRequestId();\n\n const currentFetcher = getFetcher(fetcher);\n /\n Execute the fetch operation.\n * Cancels any ongoing fetch before starting a new one.\n */\n const execute = useCallback(\n async (request: FetchRequest) => {\n if (abortControllerRef.current) {\n abortControllerRef.current.abort();\n }\n abortControllerRef.current =\n request.abortController ?? new AbortController();\n request.abortController = abortControllerRef.current;\n const currentRequestId = requestId.generate();\n state.setLoading();\n try {\n const exchange = await currentFetcher.exchange(request, options);\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n setExchange(exchange);\n }\n const result = await exchange.extractResult<R>();\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setSuccess(result);\n }\n } catch (error) {\n if (error instanceof Error && error.name === 'AbortError') {\n if (isMounted()) {\n state.setIdle();\n }\n return;\n }\n if (isMounted() && requestId.isLatest(currentRequestId)) {\n state.setError(error as E);\n }\n } finally {\n if (abortControllerRef.current === request.abortController) {\n abortControllerRef.current = undefined;\n }\n }\n },\n [currentFetcher, isMounted, options, state, requestId],\n );\n\n useEffect(() => {\n return () => {\n abortControllerRef.current?.abort();\n abortControllerRef.current = undefined;\n };\n }, []);\n return useMemo(() => ({\n ...state,\n exchange,\n execute,\n }), [state, exchange, execute]);\n}\n"],"names":["useMountedState","mountedRef","useRef","get","useCallback","useEffect","PromiseStatus","usePromiseState","options","status","setStatus","useState","result","setResult","error","setErrorState","isMounted","setLoadingFn","setSuccessFn","setErrorFn","setIdleFn","useMemo","useRequestId","requestIdRef","generate","current","isLatest","requestId","invalidate","reset","useExecutePromise","state","execute","input","currentRequestId","data","err","useKeyStorage","keyStorage","subscribe","callback","getSnapshot","value","useSyncExternalStore","setValue","useFetcher","fetcher","fetcherRegistrar","exchange","setExchange","abortControllerRef","currentFetcher","getFetcher","request"],"mappings":"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","x_google_ignoreList":[0]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher-react",
-  "version": "2.6.0",
+  "version": "2.6.2",
   "description": "React integration for Fetcher HTTP client. Provides React Hooks and components for seamless data fetching with automatic re-rendering and loading states.",
   "keywords": [
     "fetch",
@@ -55,7 +55,7 @@
     "eslint": "^9.36.0",
     "globals": "^16.4.0",
     "prettier": "^3.6.2",
-    "typescript": "^5.9.2",
+    "typescript": "^5.9.3",
     "typescript-eslint": "^8.45.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "unplugin-dts": "1.0.0-beta.6",