@ahoo-wang/fetcher-react 2.15.2 → 2.15.5

package/README.md

@@ -11,6 +11,7 @@ robust data fetching capabilities.
 [![npm downloads](https://img.shields.io/npm/dm/@ahoo-wang/fetcher-react.svg)](https://www.npmjs.com/package/@ahoo-wang/fetcher-react)
 [![npm bundle size](https://img.shields.io/bundlephobia/minzip/%40ahoo-wang%2Ffetcher-react)](https://www.npmjs.com/package/@ahoo-wang/fetcher-react)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Ahoo-Wang/fetcher)
+[![Storybook](https://img.shields.io/badge/Storybook-Interactive%20Docs-FF4785)](https://fetcher.ahoo.me/?path=/docs/react-introduction--docs)
 
 ## Features
 

package/README.zh-CN.md

@@ -9,6 +9,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/@ahoo-wang/fetcher-react.svg)](https://www.npmjs.com/package/@ahoo-wang/fetcher-react)
 [![npm bundle size](https://img.shields.io/bundlephobia/minzip/%40ahoo-wang%2Ffetcher-react)](https://www.npmjs.com/package/@ahoo-wang/fetcher-react)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Ahoo-Wang/fetcher)
+[![Storybook](https://img.shields.io/badge/Storybook-交互式文档-FF4785)](https://fetcher.ahoo.me/?path=/docs/react-introduction--docs)
 
 ## 功能特性
 

package/dist/index.es.js

@@ -1,384 +1,438 @@
 var k = Object.defineProperty;
-var b = (e, t) => k(e, "name", { value: t, configurable: !0 });
-import { useRef as y, useCallback as u, useEffect as R, useState as F, useMemo as m, useSyncExternalStore as A } from "react";
+var y = (e, t) => k(e, "name", { value: t, configurable: !0 });
+import { useRef as m, useCallback as u, useEffect as C, useState as Q, useMemo as h, useSyncExternalStore as A } from "react";
 import { nameGenerator as z } from "@ahoo-wang/fetcher-eventbus";
 import { fetcherRegistrar as G, getFetcher as K } from "@ahoo-wang/fetcher";
-function Q() {
-  const e = y(!1), t = u(() => e.current, []);
-  return R(() => (e.current = !0, () => {
+function M() {
+  const e = m(!1), t = u(() => e.current, []);
+  return C(() => (e.current = !0, () => {
     e.current = !1;
   }), []), t;
 }
-b(Q, "useMounted");
+y(M, "useMounted");
 function S(e) {
-  const t = y(e);
+  const t = m(e);
   return t.current = e, t;
 }
-b(S, "useLatest");
+y(S, "useLatest");
 var T = /* @__PURE__ */ ((e) => (e.IDLE = "idle", e.LOADING = "loading", e.SUCCESS = "success", e.ERROR = "error", e))(T || {});
-function M(e) {
-  const [t, n] = F(
+function D(e) {
+  const [t, r] = Q(
     e?.initialStatus ?? "idle"
     /* IDLE */
-  ), [c, o] = F(void 0), [a, r] = F(void 0), s = Q(), l = S(e), i = u(() => {
-    s() && (n(
+  ), [c, o] = Q(void 0), [i, n] = Q(void 0), s = M(), a = S(e), l = u(() => {
+    s() && (r(
       "loading"
       /* LOADING */
-    ), r(void 0));
-  }, [s]), E = u(
-    async (g) => {
+    ), n(void 0));
+  }, [s]), f = u(
+    async (b) => {
       if (s()) {
-        o(g), n(
+        o(b), r(
           "success"
           /* SUCCESS */
-        ), r(void 0);
+        ), n(void 0);
         try {
-          await l.current?.onSuccess?.(g);
-        } catch (h) {
-          console.warn("PromiseState onSuccess callback error:", h);
+          await a.current?.onSuccess?.(b);
+        } catch (E) {
+          console.warn("PromiseState onSuccess callback error:", E);
         }
       }
     },
-    [s, l]
+    [s, a]
   ), d = u(
-    async (g) => {
+    async (b) => {
       if (s()) {
-        r(g), n(
+        n(b), r(
           "error"
           /* ERROR */
         ), o(void 0);
         try {
-          await l.current?.onError?.(g);
-        } catch (h) {
-          console.warn("PromiseState onError callback error:", h);
+          await a.current?.onError?.(b);
+        } catch (E) {
+          console.warn("PromiseState onError callback error:", E);
         }
       }
     },
-    [s, l]
-  ), f = u(() => {
-    s() && (n(
+    [s, a]
+  ), g = u(() => {
+    s() && (r(
       "idle"
       /* IDLE */
-    ), r(void 0), o(void 0));
+    ), n(void 0), o(void 0));
   }, [s]);
-  return m(
+  return h(
     () => ({
       status: t,
       loading: t === "loading",
       result: c,
-      error: a,
-      setLoading: i,
-      setSuccess: E,
+      error: i,
+      setLoading: l,
+      setSuccess: f,
       setError: d,
-      setIdle: f
+      setIdle: g
     }),
-    [t, c, a, i, E, d, f]
+    [t, c, i, l, f, d, g]
   );
 }
-b(M, "usePromiseState");
-function D() {
-  const e = y(0), t = u(() => ++e.current, []), n = u(() => e.current, []), c = u((r) => r === e.current, []), o = u(() => {
+y(D, "usePromiseState");
+function P() {
+  const e = m(0), t = u(() => ++e.current, []), r = u(() => e.current, []), c = u((n) => n === e.current, []), o = u(() => {
     e.current++;
-  }, []), a = u(() => {
+  }, []), i = u(() => {
     e.current = 0;
   }, []);
-  return m(() => ({
+  return h(() => ({
     generate: t,
-    current: n,
+    current: r,
     isLatest: c,
     invalidate: o,
-    reset: a
-  }), [t, n, c, o, a]);
+    reset: i
+  }), [t, r, c, o, i]);
 }
-b(D, "useRequestId");
+y(P, "useRequestId");
 function O(e) {
   const {
     loading: t,
-    result: n,
+    result: r,
     error: c,
     status: o,
-    setLoading: a,
-    setSuccess: r,
+    setLoading: i,
+    setSuccess: n,
     setError: s,
-    setIdle: l
-  } = M(e), i = Q(), E = D(), d = e?.propagateError, f = u(
-    async (h) => {
-      if (!i())
+    setIdle: a
+  } = D(e), l = M(), f = P(), d = e?.propagateError, g = u(
+    async (E) => {
+      if (!l())
         throw new Error("Component is unmounted");
-      const L = E.generate();
-      a();
+      const w = f.generate();
+      i();
       try {
-        const w = await (typeof h == "function" ? h() : h);
-        return i() && E.isLatest(L) && await r(w), w;
+        const R = await (typeof E == "function" ? E() : E);
+        return l() && f.isLatest(w) && await n(R), R;
       } catch (x) {
-        if (i() && E.isLatest(L) && await s(x), d)
+        if (l() && f.isLatest(w) && await s(x), d)
           throw x;
         return x;
       }
     },
-    [a, r, s, i, E, d]
-  ), g = u(() => {
-    i() && l();
-  }, [l, i]);
-  return m(
+    [i, n, s, l, f, d]
+  ), b = u(() => {
+    l() && a();
+  }, [a, l]);
+  return h(
     () => ({
       loading: t,
-      result: n,
+      result: r,
       error: c,
       status: o,
-      execute: f,
-      reset: g
+      execute: g,
+      reset: b
     }),
-    [t, n, c, o, f, g]
+    [t, r, c, o, g, b]
   );
 }
-b(O, "useExecutePromise");
+y(O, "useExecutePromise");
 function H() {
-  const e = y(/* @__PURE__ */ new Map()), t = u((d) => e.current.get(d), []), n = u(
-    (d, f) => e.current.set(d, f),
+  const e = m(/* @__PURE__ */ new Map()), t = u((d) => e.current.get(d), []), r = u(
+    (d, g) => e.current.set(d, g),
     []
-  ), c = u((d) => e.current.has(d), []), o = u((d) => e.current.delete(d), []), a = u(() => e.current.clear(), []), r = u(() => e.current.keys(), []), s = u(() => e.current.values(), []), l = u(() => e.current.entries(), []), i = u(() => e.current[Symbol.iterator](), []), E = u((d) => (f) => {
-    f ? e.current.set(d, f) : e.current.delete(d);
+  ), c = u((d) => e.current.has(d), []), o = u((d) => e.current.delete(d), []), i = u(() => e.current.clear(), []), n = u(() => e.current.keys(), []), s = u(() => e.current.values(), []), a = u(() => e.current.entries(), []), l = u(() => e.current[Symbol.iterator](), []), f = u((d) => (g) => {
+    g ? e.current.set(d, g) : e.current.delete(d);
   }, []);
-  return R(() => () => {
+  return C(() => () => {
     e.current.clear();
-  }, []), m(
+  }, []), h(
     () => ({
-      register: E,
+      register: f,
       get: t,
-      set: n,
+      set: r,
       has: c,
       delete: o,
-      clear: a,
-      keys: r,
+      clear: i,
+      keys: n,
       values: s,
-      entries: l,
+      entries: a,
       get size() {
         return e.current.size;
       },
-      [Symbol.iterator]: i
+      [Symbol.iterator]: l
     }),
-    [E, t, n, c, o, a, r, s, l, i]
+    [f, t, r, c, o, i, n, s, a, l]
   );
 }
-b(H, "useRefs");
-function P(e, t) {
+y(H, "useRefs");
+function p(e, t) {
   if (t.leading === !1 && t.trailing === !1)
     throw new Error(
       "useDebouncedCallback: at least one of leading or trailing must be true"
     );
-  const n = y(
+  const r = m(
     void 0
-  ), c = y(!1), o = S(e), a = S(t), r = u(() => n.current !== void 0, []), s = u(() => {
-    n.current !== void 0 && (clearTimeout(n.current), n.current = void 0);
+  ), c = m(!1), o = S(e), i = S(t), n = u(() => r.current !== void 0, []), s = u(() => {
+    r.current !== void 0 && (clearTimeout(r.current), r.current = void 0);
   }, []);
-  R(() => () => {
+  C(() => () => {
     s();
   }, [s]);
-  const l = u(
-    (...i) => {
-      const { leading: E = !1, trailing: d = !0, delay: f } = a.current;
-      s(), E && !c.current && (o.current(...i), c.current = !0), d && (n.current = setTimeout(() => {
-        c.current || o.current(...i), c.current = !1, n.current = void 0;
-      }, f));
+  const a = u(
+    (...l) => {
+      const { leading: f = !1, trailing: d = !0, delay: g } = i.current;
+      s(), f && !c.current && (o.current(...l), c.current = !0), d && (r.current = setTimeout(() => {
+        c.current || o.current(...l), c.current = !1, r.current = void 0;
+      }, g));
     },
-    [o, a, s]
+    [o, i, s]
   );
-  return m(
+  return h(
     () => ({
-      run: l,
+      run: a,
       cancel: s,
-      isPending: r
+      isPending: n
     }),
-    [l, s, r]
+    [a, s, n]
   );
 }
-b(P, "useDebouncedCallback");
+y(p, "useDebouncedCallback");
 function J(e) {
-  const { loading: t, result: n, error: c, execute: o, reset: a, status: r } = O(e), { run: s, cancel: l, isPending: i } = P(
+  const { loading: t, result: r, error: c, execute: o, reset: i, status: n } = O(e), { run: s, cancel: a, isPending: l } = p(
     o,
     e.debounce
   );
-  return m(
+  return h(
     () => ({
       loading: t,
-      result: n,
+      result: r,
       error: c,
-      status: r,
+      status: n,
       run: s,
-      cancel: l,
-      isPending: i,
-      reset: a
+      cancel: a,
+      isPending: l,
+      reset: i
     }),
-    [t, n, c, r, s, l, i, a]
+    [t, r, c, n, s, a, l, i]
   );
 }
-b(J, "useDebouncedExecutePromise");
+y(J, "useDebouncedExecutePromise");
 function W(e, t) {
-  const n = u(
-    (r) => e.addListener({
+  const r = u(
+    (n) => e.addListener({
       name: z.generate("useKeyStorage"),
       // Generate unique listener name
-      handle: r
+      handle: n
       // Callback to trigger React re-render on storage changes
     }),
     [e]
     // Recreate subscription only if keyStorage changes
   ), c = u(() => {
-    const r = e.get();
-    return r !== null ? r : t ?? null;
-  }, [e, t]), o = A(n, c, c), a = u(
-    (r) => e.set(r),
+    const n = e.get();
+    return n !== null ? n : t ?? null;
+  }, [e, t]), o = A(r, c, c), i = u(
+    (n) => e.set(n),
     [e]
     // Recreate setter only if keyStorage changes
   );
-  return [o, a];
+  return [o, i];
 }
-b(W, "useKeyStorage");
+y(W, "useKeyStorage");
 function N(e) {
   const { fetcher: t = G.default } = e || {}, {
-    loading: n,
+    loading: r,
     result: c,
     error: o,
-    status: a,
-    setLoading: r,
+    status: i,
+    setLoading: n,
     setSuccess: s,
-    setError: l,
-    setIdle: i
-  } = M(e), [E, d] = F(
+    setError: a,
+    setIdle: l
+  } = D(e), [f, d] = Q(
     void 0
-  ), f = Q(), g = y(void 0), h = D(), L = S(e), x = K(t), w = u(
+  ), g = M(), b = m(void 0), E = P(), w = S(e), x = K(t), R = u(
     async (I) => {
-      g.current && g.current.abort(), g.current = I.abortController ?? new AbortController(), I.abortController = g.current;
-      const p = h.generate();
-      r();
+      b.current && b.current.abort(), b.current = I.abortController ?? new AbortController(), I.abortController = b.current;
+      const F = E.generate();
+      n();
       try {
         const v = await x.exchange(
           I,
-          L.current
+          w.current
         );
-        f() && h.isLatest(p) && d(v);
+        g() && E.isLatest(F) && d(v);
         const q = await v.extractResult();
-        f() && h.isLatest(p) && await s(q);
+        g() && E.isLatest(F) && await s(q);
       } catch (v) {
         if (v instanceof Error && v.name === "AbortError") {
-          f() && i();
+          g() && l();
           return;
         }
-        f() && h.isLatest(p) && await l(v);
+        g() && E.isLatest(F) && await a(v);
       } finally {
-        g.current === I.abortController && (g.current = void 0);
+        b.current === I.abortController && (b.current = void 0);
       }
     },
     [
       x,
-      f,
-      L,
-      r,
+      g,
+      w,
+      n,
       s,
-      i,
       l,
-      h
+      a,
+      E
     ]
   );
-  return R(() => () => {
-    g.current?.abort(), g.current = void 0;
-  }, []), m(
+  return C(() => () => {
+    b.current?.abort(), b.current = void 0;
+  }, []), h(
     () => ({
-      loading: n,
+      loading: r,
       result: c,
       error: o,
-      status: a,
-      exchange: E,
-      execute: w
+      status: i,
+      exchange: f,
+      execute: R
     }),
-    [n, c, o, a, E, w]
+    [r, c, o, i, f, R]
   );
 }
-b(N, "useFetcher");
+y(N, "useFetcher");
 function X(e) {
-  const { loading: t, result: n, error: c, status: o, exchange: a, execute: r } = N(e), { run: s, cancel: l, isPending: i } = P(
-    r,
+  const { loading: t, result: r, error: c, status: o, exchange: i, execute: n } = N(e), { run: s, cancel: a, isPending: l } = p(
+    n,
     e.debounce
   );
-  return m(
+  return h(
     () => ({
       loading: t,
-      result: n,
+      result: r,
       error: c,
       status: o,
-      exchange: a,
+      exchange: i,
       run: s,
-      cancel: l,
-      isPending: i
+      cancel: a,
+      isPending: l
     }),
-    [t, n, c, o, a, s, l, i]
+    [t, r, c, o, i, s, a, l]
   );
 }
-b(X, "useDebouncedFetcher");
-function C(e) {
-  const t = S(e), n = O(t.current), c = y(e.initialQuery), o = u(async () => t.current.execute(
-    c.current,
+y(X, "useDebouncedFetcher");
+function L(e) {
+  const t = S(e), {
+    loading: r,
+    result: c,
+    error: o,
+    status: i,
+    execute: n,
+    reset: s
+  } = O(t.current), a = m(e.initialQuery), l = u(async () => t.current.execute(
+    a.current,
     t.current.attributes
-  ), [c, t]), { execute: a } = n, r = u(() => a(o), [a, o]), s = u(() => c.current, [c]), l = u(
-    (i) => {
-      c.current = i, t.current.autoExecute && r();
+  ), [a, t]), f = u(() => n(l), [n, l]), d = u(() => a.current, [a]), g = u(
+    (b) => {
+      a.current = b, t.current.autoExecute && f();
     },
-    [c, t, r]
+    [a, t, f]
   );
-  return R(() => {
-    t.current.autoExecute && r();
-  }, [t, r]), m(
+  return C(() => {
+    t.current.autoExecute && f();
+  }, [t, f]), h(
     () => ({
-      ...n,
-      execute: r,
-      getQuery: s,
-      setQuery: l
+      loading: r,
+      result: c,
+      error: o,
+      status: i,
+      execute: f,
+      reset: s,
+      getQuery: d,
+      setQuery: g
     }),
-    [n, r, s, l]
+    [
+      r,
+      c,
+      o,
+      i,
+      f,
+      s,
+      d,
+      g
+    ]
   );
 }
-b(C, "useQuery");
+y(L, "useQuery");
 function Y(e) {
-  return C(e);
+  return L(e);
 }
-b(Y, "usePagedQuery");
+y(Y, "usePagedQuery");
 function Z(e) {
-  return C(e);
+  return L(e);
 }
-b(Z, "useSingleQuery");
+y(Z, "useSingleQuery");
 function _(e) {
-  return C(e);
+  return L(e);
 }
-b(_, "useCountQuery");
+y(_, "useCountQuery");
 function $(e) {
-  return C(e);
+  return L(e);
 }
-b($, "useListQuery");
+y($, "useListQuery");
 function ee(e) {
-  return C(
+  return L(
     e
   );
 }
-b(ee, "useListStreamQuery");
+y(ee, "useListStreamQuery");
+function te(e) {
+  const { loading: t, result: r, error: c, status: o, execute: i, reset: n, getQuery: s, setQuery: a } = L(e), { run: l, cancel: f, isPending: d } = p(
+    i,
+    e.debounce
+  );
+  return h(
+    () => ({
+      loading: t,
+      result: r,
+      error: c,
+      status: o,
+      reset: n,
+      getQuery: s,
+      setQuery: a,
+      run: l,
+      cancel: f,
+      isPending: d
+    }),
+    [
+      t,
+      r,
+      c,
+      o,
+      n,
+      s,
+      a,
+      l,
+      f,
+      d
+    ]
+  );
+}
+y(te, "useDebouncedQuery");
 export {
   T as PromiseStatus,
   _ as useCountQuery,
-  P as useDebouncedCallback,
+  p as useDebouncedCallback,
   J as useDebouncedExecutePromise,
   X as useDebouncedFetcher,
+  te as useDebouncedQuery,
   O as useExecutePromise,
   N as useFetcher,
   W as useKeyStorage,
   S as useLatest,
   $ as useListQuery,
   ee as useListStreamQuery,
-  Q as useMounted,
+  M as useMounted,
   Y as usePagedQuery,
-  M as usePromiseState,
-  C as useQuery,
+  D as usePromiseState,
+  L as useQuery,
   H as useRefs,
-  D as useRequestId,
+  P as useRequestId,
   Z as useSingleQuery
 };
 //# sourceMappingURL=index.es.js.map