@qiaopeng/tanstack-query-plus 0.2.0 → 0.2.2

package/README.md

@@ -126,6 +126,7 @@ function App() {
   enableOfflineSupport={true} // 启用离线状态监听（默认 true）
   cacheKey="my-app-cache"     // 自定义缓存 key（默认 'tanstack-query-cache'）
   onPersistRestore={() => console.log('缓存已恢复')}  // 缓存恢复回调
+  onPersistError={(err) => console.error('持久化错误', err)}
 >
   <YourApp />
 </PersistQueryClientProvider>
@@ -150,15 +151,15 @@ function App() {
 ```typescript
 {
   queries: {
-    staleTime: 30000,        // 数据 30 秒内视为新鲜
-    gcTime: 600000,          // 缓存保留 10 分钟
-    retry: smartRetry,       // 智能重试（4xx 不重试，5xx 最多重试 3 次）
-    retryDelay: exponential, // 指数退避（1s, 2s, 4s...最大 30s）
-    refetchOnWindowFocus: true,   // 窗口聚焦时刷新
-    refetchOnReconnect: true,     // 网络恢复时刷新
+    staleTime: 30000,
+    gcTime: 600000,
+    retry: defaultQueryRetryStrategy,
+    retryDelay: exponentialBackoff,
+    refetchOnWindowFocus: true,
+    refetchOnReconnect: true,
   },
   mutations: {
-    retry: 0,                // mutation 默认不重试
+    retry: 0,
     gcTime: 600000,
   }
 }
@@ -2479,8 +2480,9 @@ const queueManager = createOfflineQueueManager({
 })
 
 // 注册 mutation 函数（用于恢复队列时执行）
-mutationRegistry.register('updateUser', () => updateUserAPI(data))
-mutationRegistry.register('createPost', () => createPostAPI(data))
+// 注册函数签名为 () => Promise<unknown>，如需变量请使用闭包或在入队项的 mutationFn 捕获
+mutationRegistry.register('updateUser', () => updateUserAPI(savedUserData))
+mutationRegistry.register('createPost', () => createPostAPI(savedPostData))
 
 // 添加操作到队列
 async function handleUpdateUser(userData) {
@@ -2895,7 +2897,7 @@ const { data: adminEmails } = useQuery({
   queryFn: fetchUsers,
   select: selectors.compose(
     selectors.where(u => u.role === 'admin'),
-    selectors.field('email')
+    selectors.map(u => u.email)
   ),
 })
 ```
@@ -3260,12 +3262,14 @@ src/
 ```tsx
 // queries/users.ts
 import { useEnhancedQuery } from '@qiaopeng/tanstack-query-plus/hooks'
-import { queryKeys } from './keys'
+import { createDomainKeyFactory } from '@qiaopeng/tanstack-query-plus/core'
 import { fetchUser, fetchUsers } from '@/api/users'
 
+const userKeys = createDomainKeyFactory('users')
+
 export function useUser(userId: string) {
   return useEnhancedQuery({
-    queryKey: queryKeys.user(userId),
+    queryKey: userKeys.detail(userId),
     queryFn: () => fetchUser(userId),
     enabled: !!userId,
     trackPerformance: true,
@@ -3274,7 +3278,7 @@ export function useUser(userId: string) {
 
 export function useUsers(filters?: UserFilters) {
   return useEnhancedQuery({
-    queryKey: queryKeys.users(filters),
+    queryKey: userKeys.list(filters),
     queryFn: () => fetchUsers(filters),
   })
 }

package/dist/PersistQueryClientProvider.js

@@ -11,7 +11,7 @@ export function PersistQueryClientProvider({ children, client, cacheKey = "tanst
         }
     }, [enableOfflineSupport]);
     if (enablePersistence) {
-        const persister = createPersister(cacheKey);
+        const persister = createPersister(cacheKey, undefined, _onPersistError);
         if (!persister) {
             return _jsx(QueryClientProvider, { client: client, children: children });
         }

package/dist/features/persistence.d.ts

@@ -13,7 +13,7 @@ export declare function createPersistOptions(config?: Partial<PersistOptions>):
         shouldDehydrateQuery?: (query: Query) => boolean;
     };
 };
-export declare function createPersister(storageKey?: string, storage?: Storage): Persister | undefined;
+export declare function createPersister(storageKey?: string, storage?: Storage, onError?: (error: Error) => void): Persister | undefined;
 export declare function clearCache(key?: string): void;
 export declare function clearExpiredCache(key?: string, maxAge?: number): void;
 export declare function migrateToIndexedDB(localStorageKey: string | undefined, indexedDBKey: string | undefined, indexedDBStorage: Storage | {

package/dist/features/persistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/features/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAsBvF,MAAM,WAAW,cAAc;IAAG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;KAAE,CAAA;CAAE;AAC1J,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;KAAE,CAAA;CAAE,CAiBtK;AACD,wBAAgB,eAAe,CAAC,UAAU,SAAyB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAa7G;AACD,wBAAgB,UAAU,CAAC,GAAG,SAAyB,GAAG,IAAI,CAA0D;AACxH,wBAAgB,iBAAiB,CAAC,GAAG,SAAyB,EAAE,MAAM,SAAsB,GAAG,IAAI,CAQlG;AACD,wBAAsB,kBAAkB,CAAC,eAAe,oBAAyB,EAAE,YAAY,oBAAyB,EAAE,gBAAgB,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlO;AACD,wBAAgB,gBAAgB,CAAC,GAAG,SAAyB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CASjJ;AACD,wBAAgB,eAAe,CAAC,GAAG,SAAyB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA;CAAE,CAS9L;AACD,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/features/persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAsBvF,MAAM,WAAW,cAAc;IAAG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;KAAE,CAAA;CAAE;AAC1J,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;KAAE,CAAA;CAAE,CAiBtK;AACD,wBAAgB,eAAe,CAAC,UAAU,SAAyB,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,SAAS,GAAG,SAAS,CAa/I;AACD,wBAAgB,UAAU,CAAC,GAAG,SAAyB,GAAG,IAAI,CAA0D;AACxH,wBAAgB,iBAAiB,CAAC,GAAG,SAAyB,EAAE,MAAM,SAAsB,GAAG,IAAI,CAQlG;AACD,wBAAsB,kBAAkB,CAAC,eAAe,oBAAyB,EAAE,YAAY,oBAAyB,EAAE,gBAAgB,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlO;AACD,wBAAgB,gBAAgB,CAAC,GAAG,SAAyB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CASjJ;AACD,wBAAgB,eAAe,CAAC,GAAG,SAAyB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA;CAAE,CAS9L;AACD,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC"}

package/dist/features/persistence.js

@@ -72,7 +72,7 @@ export function createPersistOptions(config = {}) {
         }
     };
 }
-export function createPersister(storageKey = "tanstack-query-cache", storage) {
+export function createPersister(storageKey = "tanstack-query-cache", storage, onError) {
     if (typeof window === "undefined") {
         return undefined;
     }
@@ -86,18 +86,29 @@ export function createPersister(storageKey = "tanstack-query-cache", storage) {
             persistClient: async (client) => { try {
                 safeStorage.setItem(storageKey, JSON.stringify(client));
             }
-            catch { } },
+            catch (e) {
+                if (onError && e instanceof Error) {
+                    onError(e);
+                }
+            } },
             restoreClient: async () => { try {
                 const raw = safeStorage.getItem(storageKey);
                 return raw ? JSON.parse(raw) : undefined;
             }
-            catch {
+            catch (e) {
+                if (onError && e instanceof Error) {
+                    onError(e);
+                }
                 return undefined;
             } },
             removeClient: async () => { try {
                 safeStorage.removeItem(storageKey);
             }
-            catch { } }
+            catch (e) {
+                if (onError && e instanceof Error) {
+                    onError(e);
+                }
+            } }
         };
         return persister;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qiaopeng/tanstack-query-plus",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Enhanced TanStack Query toolkit: defaults, hooks, persistence, offline, utils",
   "author": "qiaopeng",
   "license": "MIT",
@@ -108,4 +108,4 @@
     "typecheck": "tsc -p ./tsconfig.json --noEmit",
     "prepublishOnly": "npm run typecheck && npm run build"
   }
-}
+}