@qiaopeng/tanstack-query-plus 0.1.2 → 0.1.4

package/README.md

@@ -210,7 +210,7 @@ function Dashboard() {
 
 ## 8. 预取（Prefetch）
 
-提供多种预取策略：悬停、路由变化、智能预取、视口内预取（可选依赖）。
+提供多种预取策略：悬停、路由变化、智能预取、视口内预取（可选依赖），并支持 `minInterval` 节流与 `stale` 检查。
 
 ```tsx
 import { useEffect } from 'react'
@@ -218,21 +218,21 @@ import { useHoverPrefetch, useRoutePrefetch, useSmartPrefetch } from '@qiaopeng/
 import { queryKeys } from '@qiaopeng/tanstack-query-plus/core'
 
 function LinkWithPrefetch({ id }: { id: string }) {
-  const hover = useHoverPrefetch(queryKeys.user(id), () => fetch(`/api/users/${id}`).then(r => r.json()))
+  const hover = useHoverPrefetch(queryKeys.user(id), () => fetch(`/api/users/${id}`).then(r => r.json()), { hoverDelay: 200, minInterval: 1000 })
   return <a href={`/user/${id}`} {...hover}>用户详情</a>
 }
 
 function RouterChange() {
   const prefetch = useRoutePrefetch()
   useEffect(() => {
-    prefetch(queryKeys.settings(), () => fetch('/api/settings').then(r => r.json()))
+    prefetch(queryKeys.settings(), () => fetch('/api/settings').then(r => r.json()), { minInterval: 1000 })
   }, [])
   return null
 }
 
 function SmartCard({ id }: { id: string }) {
   const { prefetch } = useSmartPrefetch()
-  return <div onMouseEnter={() => prefetch(queryKeys.user(id), () => fetch(`/api/users/${id}`).then(r => r.json()))}>卡片</div>
+  return <div onMouseEnter={() => prefetch(queryKeys.user(id), () => fetch(`/api/users/${id}`).then(r => r.json()), { minInterval: 1000 })}>卡片</div>
 }
 ```
 

package/dist/hooks/usePrefetch.d.ts

@@ -3,6 +3,7 @@ export interface PrefetchOptions {
     delay?: number;
     enabled?: boolean;
     staleTime?: number;
+    minInterval?: number;
 }
 export interface HoverPrefetchOptions extends PrefetchOptions {
     hoverDelay?: number;

package/dist/hooks/usePrefetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePrefetch.d.ts","sourceRoot":"","sources":["../../src/hooks/usePrefetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMrE,MAAM,WAAW,eAAe;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAC1F,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAAG,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AACrF,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAAG,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE;AASjI,wBAAgB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,OAAO,GAAE,oBAAyB;;;;EAmBtI;AAGD,wBAAgB,gBAAgB,KAEV,KAAK,sBAAsB,QAAQ,WAAW,aAAa,CAAC,KAAK,CAAC,YAAY,eAAe,UAMlH;AAED,wBAAgB,gBAAgB,KAEV,KAAK,qBAAqB,KAAK,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,UAO/H;AAED,wBAAgB,gBAAgB;eASA,KAAK,sBAAsB,QAAQ,WAAW,aAAa,CAAC,KAAK,CAAC,YAAY,eAAe;;;EAU5H;AAED,wBAAgB,sBAAsB,CAAC,KAAK,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,QAgBvJ;AAED,wBAAgB,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,QAwBnJ;AAED,wBAAgB,mBAAmB,CAAC,KAAK,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,QAkBxJ;AAED,wBAAgB,qBAAqB;gCAIY,MAAM,UAAU,MAAM;;wBAa9B,KAAK,4BAA4B,CAAC,MAAM,EAAE,MAAM,KAAK;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;KAAE;;EASlJ;AAED,wBAAgB,mBAAmB;sBAII,KAAK,sBAAsB,QAAQ,WAAW,aAAa,CAAC,KAAK,CAAC,aAAY,MAAM,GAAG,QAAQ,GAAG,KAAK;;;;EAmB7I"}
+{"version":3,"file":"usePrefetch.d.ts","sourceRoot":"","sources":["../../src/hooks/usePrefetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMrE,MAAM,WAAW,eAAe;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;AAChH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAAG,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AACrF,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAAG,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE;AASjI,wBAAgB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,OAAO,GAAE,oBAAyB;;;;EAwBtI;AAGD,wBAAgB,gBAAgB,KAGV,KAAK,sBAAsB,QAAQ,WAAW,aAAa,CAAC,KAAK,CAAC,YAAY,eAAe,UAUlH;AAED,wBAAgB,gBAAgB,KAEV,KAAK,qBAAqB,KAAK,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,UAO/H;AAED,wBAAgB,gBAAgB;eAUA,KAAK,sBAAsB,QAAQ,WAAW,aAAa,CAAC,KAAK,CAAC,YAAY,eAAe;;;EAa5H;AAED,wBAAgB,sBAAsB,CAAC,KAAK,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,QAgBvJ;AAED,wBAAgB,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,QAwBnJ;AAED,wBAAgB,mBAAmB,CAAC,KAAK,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,QAkBxJ;AAED,wBAAgB,qBAAqB;gCAIY,MAAM,UAAU,MAAM;;wBAa9B,KAAK,4BAA4B,CAAC,MAAM,EAAE,MAAM,KAAK;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAA;KAAE;;EASlJ;AAED,wBAAgB,mBAAmB;sBAII,KAAK,sBAAsB,QAAQ,WAAW,aAAa,CAAC,KAAK,CAAC,aAAY,MAAM,GAAG,QAAQ,GAAG,KAAK;;;;EAmB7I"}

package/dist/hooks/usePrefetch.js

@@ -12,15 +12,21 @@ function isMissingOrStale(queryClient, queryKey, staleTime) {
 export function useHoverPrefetch(queryKey, queryFn, options = {}) {
     const queryClient = useQueryClient();
     const timeoutRef = useRef(undefined);
-    const { hoverDelay = 200, enabled = true, staleTime = DEFAULT_STALE_TIME } = options;
+    const { hoverDelay = 200, enabled = true, staleTime = DEFAULT_STALE_TIME, minInterval = 1000 } = options;
     const queryFnRef = useRef(queryFn);
     useEffect(() => { queryFnRef.current = queryFn; }, [queryFn]);
+    const lastPrefetchRef = useRef(new Map());
     const prefetch = useCallback(() => {
         if (!enabled)
             return;
+        const keyStr = JSON.stringify(queryKey);
+        const last = lastPrefetchRef.current.get(keyStr) ?? 0;
+        if (Date.now() - last < minInterval)
+            return;
         if (!isMissingOrStale(queryClient, queryKey, staleTime))
             return;
         queryClient.prefetchQuery({ queryKey, queryFn: queryFnRef.current, staleTime });
+        lastPrefetchRef.current.set(keyStr, Date.now());
     }, [queryClient, queryKey, enabled, staleTime]);
     const handleMouseEnter = useCallback(() => {
         if (!enabled)
@@ -40,13 +46,19 @@ export function useHoverPrefetch(queryKey, queryFn, options = {}) {
 }
 export function useRoutePrefetch() {
     const queryClient = useQueryClient();
+    const lastPrefetchRef = useRef(new Map());
     return useCallback((queryKey, queryFn, options) => {
-        const { enabled = true, staleTime = DEFAULT_STALE_TIME } = options || {};
+        const { enabled = true, staleTime = DEFAULT_STALE_TIME, minInterval = 1000 } = options || {};
         if (!enabled)
             return;
+        const keyStr = JSON.stringify(queryKey);
+        const last = lastPrefetchRef.current.get(keyStr) ?? 0;
+        if (Date.now() - last < minInterval)
+            return;
         if (!isMissingOrStale(queryClient, queryKey, staleTime))
             return;
         queryClient.prefetchQuery({ queryKey, queryFn, staleTime });
+        lastPrefetchRef.current.set(keyStr, Date.now());
     }, [queryClient]);
 }
 export function useBatchPrefetch() {
@@ -62,6 +74,7 @@ export function useBatchPrefetch() {
 export function useSmartPrefetch() {
     const queryClient = useQueryClient();
     const prefetchedRef = useRef(new Set());
+    const lastPrefetchRef = useRef(new Map());
     const shouldPrefetchQuery = useCallback((queryKey) => {
         const key = JSON.stringify(queryKey);
         if (prefetchedRef.current.has(key))
@@ -73,12 +86,16 @@ export function useSmartPrefetch() {
     const prefetch = useCallback((queryKey, queryFn, options) => {
         if (!shouldPrefetchQuery(queryKey))
             return;
-        const { staleTime = DEFAULT_STALE_TIME } = options || {};
+        const { staleTime = DEFAULT_STALE_TIME, minInterval = 1000 } = options || {};
+        const keyStr = JSON.stringify(queryKey);
+        const last = lastPrefetchRef.current.get(keyStr) ?? 0;
+        if (Date.now() - last < minInterval)
+            return;
         if (!isMissingOrStale(queryClient, queryKey, staleTime))
             return;
-        const key = JSON.stringify(queryKey);
-        prefetchedRef.current.add(key);
+        prefetchedRef.current.add(keyStr);
         queryClient.prefetchQuery({ queryKey, queryFn, staleTime });
+        lastPrefetchRef.current.set(keyStr, Date.now());
     }, [queryClient, shouldPrefetchQuery]);
     const clearPrefetchHistory = useCallback(() => { prefetchedRef.current.clear(); }, []);
     return { prefetch, shouldPrefetch: !isSlowNetwork(), clearPrefetchHistory };

package/dist/react-query/index.d.ts

@@ -1,3 +1,3 @@
-export { QueryClient, QueryClientProvider, useQueryClient, skipToken, useIsMutating } from "@tanstack/react-query";
-export type { UseQueryOptions, UseSuspenseQueryOptions, UseInfiniteQueryOptions, QueryKey, MutationKey, InfiniteData } from "@tanstack/react-query";
+export { QueryClient, QueryClientProvider, useQueryClient, skipToken, useIsMutating, useIsFetching, useQuery, useInfiniteQuery, useMutation, useSuspenseQuery, useSuspenseInfiniteQuery } from "@tanstack/react-query";
+export type { UseQueryOptions, UseSuspenseQueryOptions, UseInfiniteQueryOptions, QueryKey, MutationKey, InfiniteData, UseQueryResult, UseInfiniteQueryResult, UseMutationResult, DefaultError } from "@tanstack/react-query";
 //# sourceMappingURL=index.d.ts.map

package/dist/react-query/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react-query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,QAAQ,EACR,WAAW,EACX,YAAY,EACb,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react-query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,SAAS,EACT,aAAa,EACb,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACb,MAAM,uBAAuB,CAAC"}

package/dist/react-query/index.js

@@ -1 +1 @@
-export { QueryClient, QueryClientProvider, useQueryClient, skipToken, useIsMutating } from "@tanstack/react-query";
+export { QueryClient, QueryClientProvider, useQueryClient, skipToken, useIsMutating, useIsFetching, useQuery, useInfiniteQuery, useMutation, useSuspenseQuery, useSuspenseInfiniteQuery } from "@tanstack/react-query";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qiaopeng/tanstack-query-plus",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Enhanced TanStack Query toolkit: defaults, hooks, persistence, offline, utils",
   "license": "MIT",
   "type": "module",
@@ -75,7 +75,7 @@
     "@tanstack/react-query": "^5",
     "@tanstack/react-query-persist-client": "^5",
     "@tanstack/react-query-devtools": "^5",
-    "react-intersection-observer": "^9"
+    "react-intersection-observer": "^9 || ^10"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-query-devtools": {