@ahoo-wang/fetcher-react 1.8.5 → 1.8.6

package/dist/fetcher/index.d.ts

@@ -1 +1,2 @@
+export * from './useFetcher';
 //# sourceMappingURL=index.d.ts.map

package/dist/fetcher/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetcher/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fetcher/index.ts"],"names":[],"mappings":"AAaA,cAAc,cAAc,CAAC"}

package/dist/fetcher/useFetcher.d.ts

@@ -0,0 +1,41 @@
+import { FetcherCapable, FetchExchange, FetchRequest, RequestOptions } from '@ahoo-wang/fetcher';
+import { DependencyList } from 'react';
+/**
+ * Configuration options for the useFetcher hook.
+ * Extends RequestOptions and FetcherCapable interfaces.
+ */
+export interface UseFetcherOptions extends RequestOptions, FetcherCapable {
+    /**
+     * Dependencies list for the fetch operation.
+     * When provided, the hook will re-fetch when any of these values change.
+     */
+    readonly deps?: DependencyList;
+    /**
+     * Whether the fetch operation should execute immediately upon component mount.
+     * Defaults to true.
+     */
+    readonly immediate?: boolean;
+}
+/**
+ * The result object returned by the useFetcher hook.
+ * @template R - The type of the data returned by the fetch operation
+ */
+export interface UseFetcherResult<R> {
+    /** Indicates if the fetch operation is currently in progress */
+    loading: boolean;
+    /** The FetchExchange object representing the ongoing fetch operation */
+    exchange?: FetchExchange;
+    /** The data returned by the fetch operation, or undefined if not yet loaded or an error occurred */
+    result?: R;
+    /** Any error that occurred during the fetch operation, or undefined if no error */
+    error?: unknown;
+    /**
+     * Function to manually trigger the fetch operation.
+     * Useful for fetching data on demand rather than automatically.
+     */
+    execute: () => Promise<void>;
+    /** Function to cancel the ongoing fetch operation */
+    cancel: () => void;
+}
+export declare function useFetcher<R>(request: FetchRequest, options?: UseFetcherOptions): UseFetcherResult<R>;
+//# sourceMappingURL=useFetcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFetcher.d.ts","sourceRoot":"","sources":["../../src/fetcher/useFetcher.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAA4C,MAAM,OAAO,CAAC;AAGjF;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc,EAAE,cAAc;IACvE;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IAEjB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB,oGAAoG;IACpG,MAAM,CAAC,EAAE,CAAC,CAAC;IAEX,mFAAmF;IACnF,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B,qDAAqD;IACrD,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAmErG"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './storage';
+export * from './fetcher';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/index.es.js

@@ -1,22 +1,63 @@
-import { useCallback as n, useSyncExternalStore as l } from "react";
-function i(s) {
-  const e = n(
-    (t) => s.addListener(t),
-    [s]
-  ), c = n(
-    () => s.get(),
-    [s]
-  ), u = l(
+import { useCallback as o, useSyncExternalStore as F, useRef as v, useEffect as m, useState as i } from "react";
+import { fetcher as A, getFetcher as L } from "@ahoo-wang/fetcher";
+function V(t) {
+  const e = o(
+    (s) => t.addListener(s),
+    [t]
+  ), u = o(
+    () => t.get(),
+    [t]
+  ), f = F(
     e,
-    c,
-    c
-  ), o = n(
-    (t) => s.set(t),
-    [s]
+    u,
+    u
+  ), a = o(
+    (s) => t.set(s),
+    [t]
   );
-  return [u, o];
+  return [f, a];
+}
+function M() {
+  var t = v(!1), e = o(function() {
+    return t.current;
+  }, []);
+  return m(function() {
+    return t.current = !0, function() {
+      t.current = !1;
+    };
+  }, []), e;
+}
+function $(t, e) {
+  const { deps: u = [], fetcher: f = A, immediate: a = !0 } = e || {}, [s, d] = i(!1), [x, b] = i(void 0), [g, C] = i(void 0), [E, R] = i(void 0), n = M(), r = v(), h = L(f), l = o(async () => {
+    r.current && r.current.abort(), r.current = t.abortController ?? new AbortController(), t.abortController = r.current, n() && (d(!0), b(void 0));
+    try {
+      const c = await h.exchange(t, e);
+      n() && C(c);
+      const w = await c.extractResult();
+      n() && R(w);
+    } catch (c) {
+      if (c instanceof Error && c.name === "AbortError")
+        return;
+      n() && b(c);
+    } finally {
+      n() && d(!1), r.current === t.abortController && (r.current = void 0);
+    }
+  }, [h, n, e, ...u]), p = o(() => {
+    r.current?.abort();
+  }, []);
+  return m(() => (a && l(), () => {
+    r.current?.abort(), r.current = void 0;
+  }), [l, a, ...u]), {
+    loading: s,
+    exchange: g,
+    result: E,
+    error: x,
+    execute: l,
+    cancel: p
+  };
 }
 export {
-  i as useKeyStorage
+  $ as useFetcher,
+  V as useKeyStorage
 };
 //# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../src/storage/useKeyStorage.ts"],"sourcesContent":["/*\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(\n    () => keyStorage.get(),\n    [keyStorage],\n  );\n  const value = useSyncExternalStore(\n    subscribe,\n    getSnapshot,\n    getSnapshot,\n  );\n  const setValue = useCallback(\n    (value: T) => keyStorage.set(value),\n    [keyStorage],\n  );\n  return [value, setValue];\n}"],"names":["useKeyStorage","keyStorage","subscribe","useCallback","callback","getSnapshot","value","useSyncExternalStore","setValue"],"mappings":";AAwBO,SAASA,EACdC,GACgC;AAChC,QAAMC,IAAYC;AAAA,IAChB,CAACC,MAAyBH,EAAW,YAAYG,CAAQ;AAAA,IACzD,CAACH,CAAU;AAAA,EAAA,GAEPI,IAAcF;AAAA,IAClB,MAAMF,EAAW,IAAA;AAAA,IACjB,CAACA,CAAU;AAAA,EAAA,GAEPK,IAAQC;AAAA,IACZL;AAAA,IACAG;AAAA,IACAA;AAAA,EAAA,GAEIG,IAAWL;AAAA,IACf,CAACG,MAAaL,EAAW,IAAIK,CAAK;AAAA,IAClC,CAACL,CAAU;AAAA,EAAA;AAEb,SAAO,CAACK,GAAOE,CAAQ;AACzB;"}
+{"version":3,"file":"index.es.js","sources":["../src/storage/useKeyStorage.ts","../../../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/fetcher/useFetcher.ts"],"sourcesContent":["/*\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(\n    () => keyStorage.get(),\n    [keyStorage],\n  );\n  const value = useSyncExternalStore(\n    subscribe,\n    getSnapshot,\n    getSnapshot,\n  );\n  const setValue = useCallback(\n    (value: T) => keyStorage.set(value),\n    [keyStorage],\n  );\n  return [value, setValue];\n}","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 {\n  fetcher as defaultFetcher,\n  FetcherCapable,\n  FetchExchange,\n  FetchRequest, getFetcher,\n  RequestOptions,\n} from '@ahoo-wang/fetcher';\nimport { DependencyList, useRef, useCallback, useEffect, useState } from 'react';\nimport { useMountedState } from 'react-use';\n\n/**\n * Configuration options for the useFetcher hook.\n * Extends RequestOptions and FetcherCapable interfaces.\n */\nexport interface UseFetcherOptions extends RequestOptions, FetcherCapable {\n  /**\n   * Dependencies list for the fetch operation.\n   * When provided, the hook will re-fetch when any of these values change.\n   */\n  readonly deps?: DependencyList;\n\n  /**\n   * Whether the fetch operation should execute immediately upon component mount.\n   * Defaults to true.\n   */\n  readonly immediate?: boolean;\n}\n\n/**\n * The result object returned by the useFetcher hook.\n * @template R - The type of the data returned by the fetch operation\n */\nexport interface UseFetcherResult<R> {\n  /** Indicates if the fetch operation is currently in progress */\n  loading: boolean;\n\n  /** The FetchExchange object representing the ongoing fetch operation */\n  exchange?: FetchExchange;\n\n  /** The data returned by the fetch operation, or undefined if not yet loaded or an error occurred */\n  result?: R;\n\n  /** Any error that occurred during the fetch operation, or undefined if no error */\n  error?: unknown;\n\n  /**\n   * Function to manually trigger the fetch operation.\n   * Useful for fetching data on demand rather than automatically.\n   */\n  execute: () => Promise<void>;\n\n  /** Function to cancel the ongoing fetch operation */\n  cancel: () => void;\n}\n\nexport function useFetcher<R>(request: FetchRequest, options?: UseFetcherOptions): UseFetcherResult<R> {\n  const { deps = [], fetcher = defaultFetcher, immediate = true } = options || {};\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<unknown>(undefined);\n  const [exchange, setExchange] = useState<FetchExchange | undefined>(undefined);\n  const [result, setResult] = useState<R | undefined>(undefined);\n  const isMounted = useMountedState();\n  const abortControllerRef = useRef<AbortController | undefined>();\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(async () => {\n    if (abortControllerRef.current) {\n      abortControllerRef.current.abort();\n    }\n    abortControllerRef.current = request.abortController ?? new AbortController();\n    request.abortController = abortControllerRef.current;\n    if (isMounted()) {\n      setLoading(true);\n      setError(undefined);\n    }\n    try {\n      const exchange = await currentFetcher.exchange(request, options);\n      if (isMounted()) {\n        setExchange(exchange);\n      }\n      const result = await exchange.extractResult<R>();\n      if (isMounted()) {\n        setResult(result);\n      }\n    } catch (error) {\n      if (error instanceof Error && error.name === 'AbortError') {\n        return;\n      }\n      if (isMounted()) {\n        setError(error);\n      }\n    } finally {\n      if (isMounted()) {\n        setLoading(false);\n      }\n      if (abortControllerRef.current === request.abortController) {\n        abortControllerRef.current = undefined;\n      }\n    }\n  }, [currentFetcher, isMounted, options, ...deps]);\n  /**\n   * Cancel the ongoing fetch operation if one is in progress.\n   */\n  const cancel = useCallback(() => {\n    abortControllerRef.current?.abort();\n  }, []);\n  useEffect(() => {\n    if (immediate) {\n      execute();\n    }\n    return () => {\n      abortControllerRef.current?.abort();\n      abortControllerRef.current = undefined;\n    };\n  }, [execute, immediate, ...deps]);\n  return {\n    loading, exchange, result, error, execute, cancel,\n  };\n}"],"names":["useKeyStorage","keyStorage","subscribe","useCallback","callback","getSnapshot","value","useSyncExternalStore","setValue","useMountedState","mountedRef","useRef","get","useEffect","useFetcher","request","options","deps","fetcher","defaultFetcher","immediate","loading","setLoading","useState","error","setError","exchange","setExchange","result","setResult","isMounted","abortControllerRef","currentFetcher","getFetcher","execute","cancel"],"mappings":";;AAwBO,SAASA,EACdC,GACgC;AAChC,QAAMC,IAAYC;AAAA,IAChB,CAACC,MAAyBH,EAAW,YAAYG,CAAQ;AAAA,IACzD,CAACH,CAAU;AAAA,EAAA,GAEPI,IAAcF;AAAA,IAClB,MAAMF,EAAW,IAAA;AAAA,IACjB,CAACA,CAAU;AAAA,EAAA,GAEPK,IAAQC;AAAA,IACZL;AAAA,IACAG;AAAA,IACAA;AAAA,EAAA,GAEIG,IAAWL;AAAA,IACf,CAACG,MAAaL,EAAW,IAAIK,CAAK;AAAA,IAClC,CAACL,CAAU;AAAA,EAAA;AAEb,SAAO,CAACK,GAAOE,CAAQ;AACzB;AC5Ce,SAASC,IAAkB;AACtC,MAAIC,IAAaC,EAAO,EAAK,GACzBC,IAAMT,EAAY,WAAY;AAAE,WAAOO,EAAW;AAAA,EAAS,GAAG,EAAE;AACpE,SAAAG,EAAU,WAAY;AAClB,WAAAH,EAAW,UAAU,IACd,WAAY;AACf,MAAAA,EAAW,UAAU;AAAA,IACzB;AAAA,EACJ,GAAG,CAAA,CAAE,GACEE;AACX;ACyDO,SAASE,EAAcC,GAAuBC,GAAkD;AACrG,QAAM,EAAE,MAAAC,IAAO,CAAA,YAAIC,IAAUC,GAAgB,WAAAC,IAAY,OAASJ,KAAW,CAAA,GACvE,CAACK,GAASC,CAAU,IAAIC,EAAS,EAAK,GACtC,CAACC,GAAOC,CAAQ,IAAIF,EAAkB,MAAS,GAC/C,CAACG,GAAUC,CAAW,IAAIJ,EAAoC,MAAS,GACvE,CAACK,GAAQC,CAAS,IAAIN,EAAwB,MAAS,GACvDO,IAAYrB,EAAA,GACZsB,IAAqBpB,EAAA,GAErBqB,IAAiBC,EAAWf,CAAO,GAKnCgB,IAAU/B,EAAY,YAAY;AACtC,IAAI4B,EAAmB,WACrBA,EAAmB,QAAQ,MAAA,GAE7BA,EAAmB,UAAUhB,EAAQ,mBAAmB,IAAI,gBAAA,GAC5DA,EAAQ,kBAAkBgB,EAAmB,SACzCD,QACFR,EAAW,EAAI,GACfG,EAAS,MAAS;AAEpB,QAAI;AACF,YAAMC,IAAW,MAAMM,EAAe,SAASjB,GAASC,CAAO;AAC/D,MAAIc,OACFH,EAAYD,CAAQ;AAEtB,YAAME,IAAS,MAAMF,EAAS,cAAA;AAC9B,MAAII,OACFD,EAAUD,CAAM;AAAA,IAEpB,SAASJ,GAAO;AACd,UAAIA,aAAiB,SAASA,EAAM,SAAS;AAC3C;AAEF,MAAIM,OACFL,EAASD,CAAK;AAAA,IAElB,UAAA;AACE,MAAIM,OACFR,EAAW,EAAK,GAEdS,EAAmB,YAAYhB,EAAQ,oBACzCgB,EAAmB,UAAU;AAAA,IAEjC;AAAA,EACF,GAAG,CAACC,GAAgBF,GAAWd,GAAS,GAAGC,CAAI,CAAC,GAI1CkB,IAAShC,EAAY,MAAM;AAC/B,IAAA4B,EAAmB,SAAS,MAAA;AAAA,EAC9B,GAAG,CAAA,CAAE;AACL,SAAAlB,EAAU,OACJO,KACFc,EAAA,GAEK,MAAM;AACX,IAAAH,EAAmB,SAAS,MAAA,GAC5BA,EAAmB,UAAU;AAAA,EAC/B,IACC,CAACG,GAASd,GAAW,GAAGH,CAAI,CAAC,GACzB;AAAA,IACL,SAAAI;AAAA,IAAS,UAAAK;AAAA,IAAU,QAAAE;AAAA,IAAQ,OAAAJ;AAAA,IAAO,SAAAU;AAAA,IAAS,QAAAC;AAAA,EAAA;AAE/C;","x_google_ignoreList":[1]}

package/dist/index.umd.js

@@ -1,2 +1,2 @@
-(function(t,e){typeof exports=="object"&&typeof module<"u"?e(exports,require("react")):typeof define=="function"&&define.amd?define(["exports","react"],e):(t=typeof globalThis<"u"?globalThis:t||self,e(t.FetcherReact={},t.React))})(this,(function(t,e){"use strict";function i(n){const c=e.useCallback(s=>n.addListener(s),[n]),u=e.useCallback(()=>n.get(),[n]),o=e.useSyncExternalStore(c,u,u),d=e.useCallback(s=>n.set(s),[n]);return[o,d]}t.useKeyStorage=i,Object.defineProperty(t,Symbol.toStringTag,{value:"Module"})}));
+(function(r,e){typeof exports=="object"&&typeof module<"u"?e(exports,require("react"),require("@ahoo-wang/fetcher")):typeof define=="function"&&define.amd?define(["exports","react","@ahoo-wang/fetcher"],e):(r=typeof globalThis<"u"?globalThis:r||self,e(r.FetcherReact={},r.React,r.Fetcher))})(this,(function(r,e,d){"use strict";function v(t){const u=e.useCallback(i=>t.addListener(i),[t]),s=e.useCallback(()=>t.get(),[t]),a=e.useSyncExternalStore(u,s,s),f=e.useCallback(i=>t.set(i),[t]);return[a,f]}function g(){var t=e.useRef(!1),u=e.useCallback(function(){return t.current},[]);return e.useEffect(function(){return t.current=!0,function(){t.current=!1}},[]),u}function x(t,u){const{deps:s=[],fetcher:a=d.fetcher,immediate:f=!0}=u||{},[i,h]=e.useState(!1),[m,b]=e.useState(void 0),[E,S]=e.useState(void 0),[p,F]=e.useState(void 0),o=g(),n=e.useRef(),C=d.getFetcher(a),l=e.useCallback(async()=>{n.current&&n.current.abort(),n.current=t.abortController??new AbortController,t.abortController=n.current,o()&&(h(!0),b(void 0));try{const c=await C.exchange(t,u);o()&&S(c);const y=await c.extractResult();o()&&F(y)}catch(c){if(c instanceof Error&&c.name==="AbortError")return;o()&&b(c)}finally{o()&&h(!1),n.current===t.abortController&&(n.current=void 0)}},[C,o,u,...s]),w=e.useCallback(()=>{n.current?.abort()},[]);return e.useEffect(()=>(f&&l(),()=>{n.current?.abort(),n.current=void 0}),[l,f,...s]),{loading:i,exchange:E,result:p,error:m,execute:l,cancel:w}}r.useFetcher=x,r.useKeyStorage=v,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})}));
 //# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.umd.js","sources":["../src/storage/useKeyStorage.ts"],"sourcesContent":["/*\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(\n    () => keyStorage.get(),\n    [keyStorage],\n  );\n  const value = useSyncExternalStore(\n    subscribe,\n    getSnapshot,\n    getSnapshot,\n  );\n  const setValue = useCallback(\n    (value: T) => keyStorage.set(value),\n    [keyStorage],\n  );\n  return [value, setValue];\n}"],"names":["useKeyStorage","keyStorage","subscribe","useCallback","callback","getSnapshot","value","useSyncExternalStore","setValue"],"mappings":"wQAwBO,SAASA,EACdC,EACgC,CAChC,MAAMC,EAAYC,EAAAA,YACfC,GAAyBH,EAAW,YAAYG,CAAQ,EACzD,CAACH,CAAU,CAAA,EAEPI,EAAcF,EAAAA,YAClB,IAAMF,EAAW,IAAA,EACjB,CAACA,CAAU,CAAA,EAEPK,EAAQC,EAAAA,qBACZL,EACAG,EACAA,CAAA,EAEIG,EAAWL,EAAAA,YACdG,GAAaL,EAAW,IAAIK,CAAK,EAClC,CAACL,CAAU,CAAA,EAEb,MAAO,CAACK,EAAOE,CAAQ,CACzB"}
+{"version":3,"file":"index.umd.js","sources":["../src/storage/useKeyStorage.ts","../../../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/fetcher/useFetcher.ts"],"sourcesContent":["/*\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(\n    () => keyStorage.get(),\n    [keyStorage],\n  );\n  const value = useSyncExternalStore(\n    subscribe,\n    getSnapshot,\n    getSnapshot,\n  );\n  const setValue = useCallback(\n    (value: T) => keyStorage.set(value),\n    [keyStorage],\n  );\n  return [value, setValue];\n}","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 {\n  fetcher as defaultFetcher,\n  FetcherCapable,\n  FetchExchange,\n  FetchRequest, getFetcher,\n  RequestOptions,\n} from '@ahoo-wang/fetcher';\nimport { DependencyList, useRef, useCallback, useEffect, useState } from 'react';\nimport { useMountedState } from 'react-use';\n\n/**\n * Configuration options for the useFetcher hook.\n * Extends RequestOptions and FetcherCapable interfaces.\n */\nexport interface UseFetcherOptions extends RequestOptions, FetcherCapable {\n  /**\n   * Dependencies list for the fetch operation.\n   * When provided, the hook will re-fetch when any of these values change.\n   */\n  readonly deps?: DependencyList;\n\n  /**\n   * Whether the fetch operation should execute immediately upon component mount.\n   * Defaults to true.\n   */\n  readonly immediate?: boolean;\n}\n\n/**\n * The result object returned by the useFetcher hook.\n * @template R - The type of the data returned by the fetch operation\n */\nexport interface UseFetcherResult<R> {\n  /** Indicates if the fetch operation is currently in progress */\n  loading: boolean;\n\n  /** The FetchExchange object representing the ongoing fetch operation */\n  exchange?: FetchExchange;\n\n  /** The data returned by the fetch operation, or undefined if not yet loaded or an error occurred */\n  result?: R;\n\n  /** Any error that occurred during the fetch operation, or undefined if no error */\n  error?: unknown;\n\n  /**\n   * Function to manually trigger the fetch operation.\n   * Useful for fetching data on demand rather than automatically.\n   */\n  execute: () => Promise<void>;\n\n  /** Function to cancel the ongoing fetch operation */\n  cancel: () => void;\n}\n\nexport function useFetcher<R>(request: FetchRequest, options?: UseFetcherOptions): UseFetcherResult<R> {\n  const { deps = [], fetcher = defaultFetcher, immediate = true } = options || {};\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<unknown>(undefined);\n  const [exchange, setExchange] = useState<FetchExchange | undefined>(undefined);\n  const [result, setResult] = useState<R | undefined>(undefined);\n  const isMounted = useMountedState();\n  const abortControllerRef = useRef<AbortController | undefined>();\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(async () => {\n    if (abortControllerRef.current) {\n      abortControllerRef.current.abort();\n    }\n    abortControllerRef.current = request.abortController ?? new AbortController();\n    request.abortController = abortControllerRef.current;\n    if (isMounted()) {\n      setLoading(true);\n      setError(undefined);\n    }\n    try {\n      const exchange = await currentFetcher.exchange(request, options);\n      if (isMounted()) {\n        setExchange(exchange);\n      }\n      const result = await exchange.extractResult<R>();\n      if (isMounted()) {\n        setResult(result);\n      }\n    } catch (error) {\n      if (error instanceof Error && error.name === 'AbortError') {\n        return;\n      }\n      if (isMounted()) {\n        setError(error);\n      }\n    } finally {\n      if (isMounted()) {\n        setLoading(false);\n      }\n      if (abortControllerRef.current === request.abortController) {\n        abortControllerRef.current = undefined;\n      }\n    }\n  }, [currentFetcher, isMounted, options, ...deps]);\n  /**\n   * Cancel the ongoing fetch operation if one is in progress.\n   */\n  const cancel = useCallback(() => {\n    abortControllerRef.current?.abort();\n  }, []);\n  useEffect(() => {\n    if (immediate) {\n      execute();\n    }\n    return () => {\n      abortControllerRef.current?.abort();\n      abortControllerRef.current = undefined;\n    };\n  }, [execute, immediate, ...deps]);\n  return {\n    loading, exchange, result, error, execute, cancel,\n  };\n}"],"names":["useKeyStorage","keyStorage","subscribe","useCallback","callback","getSnapshot","value","useSyncExternalStore","setValue","useMountedState","mountedRef","useRef","get","useEffect","useFetcher","request","options","deps","fetcher","defaultFetcher","immediate","loading","setLoading","useState","error","setError","exchange","setExchange","result","setResult","isMounted","abortControllerRef","currentFetcher","getFetcher","execute","cancel"],"mappings":"uUAwBO,SAASA,EACdC,EACgC,CAChC,MAAMC,EAAYC,EAAAA,YACfC,GAAyBH,EAAW,YAAYG,CAAQ,EACzD,CAACH,CAAU,CAAA,EAEPI,EAAcF,EAAAA,YAClB,IAAMF,EAAW,IAAA,EACjB,CAACA,CAAU,CAAA,EAEPK,EAAQC,EAAAA,qBACZL,EACAG,EACAA,CAAA,EAEIG,EAAWL,EAAAA,YACdG,GAAaL,EAAW,IAAIK,CAAK,EAClC,CAACL,CAAU,CAAA,EAEb,MAAO,CAACK,EAAOE,CAAQ,CACzB,CC5Ce,SAASC,GAAkB,CACtC,IAAIC,EAAaC,EAAAA,OAAO,EAAK,EACzBC,EAAMT,EAAAA,YAAY,UAAY,CAAE,OAAOO,EAAW,OAAS,EAAG,EAAE,EACpEG,OAAAA,EAAAA,UAAU,UAAY,CAClB,OAAAH,EAAW,QAAU,GACd,UAAY,CACfA,EAAW,QAAU,EACzB,CACJ,EAAG,CAAA,CAAE,EACEE,CACX,CCyDO,SAASE,EAAcC,EAAuBC,EAAkD,CACrG,KAAM,CAAE,KAAAC,EAAO,CAAA,UAAIC,EAAUC,EAAAA,QAAgB,UAAAC,EAAY,IAASJ,GAAW,CAAA,EACvE,CAACK,EAASC,CAAU,EAAIC,EAAAA,SAAS,EAAK,EACtC,CAACC,EAAOC,CAAQ,EAAIF,EAAAA,SAAkB,MAAS,EAC/C,CAACG,EAAUC,CAAW,EAAIJ,EAAAA,SAAoC,MAAS,EACvE,CAACK,EAAQC,CAAS,EAAIN,EAAAA,SAAwB,MAAS,EACvDO,EAAYrB,EAAA,EACZsB,EAAqBpB,EAAAA,OAAA,EAErBqB,EAAiBC,EAAAA,WAAWf,CAAO,EAKnCgB,EAAU/B,EAAAA,YAAY,SAAY,CAClC4B,EAAmB,SACrBA,EAAmB,QAAQ,MAAA,EAE7BA,EAAmB,QAAUhB,EAAQ,iBAAmB,IAAI,gBAC5DA,EAAQ,gBAAkBgB,EAAmB,QACzCD,MACFR,EAAW,EAAI,EACfG,EAAS,MAAS,GAEpB,GAAI,CACF,MAAMC,EAAW,MAAMM,EAAe,SAASjB,EAASC,CAAO,EAC3Dc,KACFH,EAAYD,CAAQ,EAEtB,MAAME,EAAS,MAAMF,EAAS,cAAA,EAC1BI,KACFD,EAAUD,CAAM,CAEpB,OAASJ,EAAO,CACd,GAAIA,aAAiB,OAASA,EAAM,OAAS,aAC3C,OAEEM,KACFL,EAASD,CAAK,CAElB,QAAA,CACMM,KACFR,EAAW,EAAK,EAEdS,EAAmB,UAAYhB,EAAQ,kBACzCgB,EAAmB,QAAU,OAEjC,CACF,EAAG,CAACC,EAAgBF,EAAWd,EAAS,GAAGC,CAAI,CAAC,EAI1CkB,EAAShC,EAAAA,YAAY,IAAM,CAC/B4B,EAAmB,SAAS,MAAA,CAC9B,EAAG,CAAA,CAAE,EACLlB,OAAAA,EAAAA,UAAU,KACJO,GACFc,EAAA,EAEK,IAAM,CACXH,EAAmB,SAAS,MAAA,EAC5BA,EAAmB,QAAU,MAC/B,GACC,CAACG,EAASd,EAAW,GAAGH,CAAI,CAAC,EACzB,CACL,QAAAI,EAAS,SAAAK,EAAU,OAAAE,EAAQ,MAAAJ,EAAO,QAAAU,EAAS,OAAAC,CAAA,CAE/C","x_google_ignoreList":[1]}

package/dist/types.d.ts

@@ -0,0 +1,5 @@
+import { DependencyList } from 'react';
+export interface DepsCapable {
+    deps?: DependencyList;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahoo-wang/fetcher-react",
-  "version": "1.8.5",
+  "version": "1.8.6",
   "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",
@@ -37,8 +37,9 @@
     "dist"
   ],
   "dependencies": {
-    "@ahoo-wang/fetcher": "1.8.5",
-    "@ahoo-wang/fetcher-storage": "1.8.5"
+    "react-use": "^17.6.0",
+    "@ahoo-wang/fetcher": "1.8.6",
+    "@ahoo-wang/fetcher-storage": "1.8.6"
   },
   "peerDependencies": {
     "react": ">=16.8.0",