@qiaopeng/tanstack-query-plus 0.5.7 → 0.5.9

package/README.md

@@ -291,18 +291,32 @@ function App() {
   queries: {
     staleTime: 30000,
     gcTime: 600000,
-    retry: defaultQueryRetryStrategy,
+    retry: defaultQueryRetryStrategy,  // 智能重试：4XX不重试，5XX最多1次
     retryDelay: exponentialBackoff,
     refetchOnWindowFocus: true,
     refetchOnReconnect: true,
+    refetchOnMount: true,
   },
   mutations: {
-    retry: 0,
+    retry: 0,  // Mutation 默认不重试
+    retryDelay: exponentialBackoff,
     gcTime: 600000,
   }
 }
 ```
 
+**重试策略说明：**
+
+- **Query 重试**（`defaultQueryRetryStrategy`）：
+  - 4XX 客户端错误：不重试（客户端问题，重试无意义）
+  - 5XX 服务端错误：最多重试 1 次（避免过度重试）
+  - 网络错误：最多重试 2 次
+  
+- **Mutation 重试**（`defaultMutationRetryStrategy`）：
+  - 4XX 客户端错误：不重试
+  - 5XX 服务端错误：不重试（避免重复操作）
+  - 网络错误：最多重试 1 次
+
 这些值是经过实践验证的最佳实践，适合大多数应用场景。
 
 ### 3.4 根据环境选择配置
@@ -313,7 +327,13 @@ function App() {
 import { getConfigByEnvironment } from '@qiaopeng/tanstack-query-plus/core'
 
 // 根据环境自动选择配置
-const config = getConfigByEnvironment(process.env.NODE_ENV)
+const env =
+  process.env.NODE_ENV === 'production'
+    ? 'production'
+    : process.env.NODE_ENV === 'test'
+      ? 'test'
+      : 'development'
+const config = getConfigByEnvironment(env)
 const queryClient = new QueryClient({ defaultOptions: config })
 ```
 
@@ -322,10 +342,60 @@ const queryClient = new QueryClient({ defaultOptions: config })
 | 配置项 | development | production | test |
 |--------|-------------|------------|------|
 | staleTime | 0 | 10 分钟 | 0 |
-| retry | 1 | 3 | 0 |
+| retry (Query) | 智能重试* | 智能重试* | 0 |
+| retry (Mutation) | 0 | 0 | 0 |
 | refetchOnWindowFocus | true | true | false |
 
-### 3.5 添加 DevTools（开发环境）
+*智能重试：4XX 不重试，5XX 最多 1 次，网络错误最多 2 次
+
+补充：还支持 `getConfigByEnvironment('longCache')` 与 `getConfigByEnvironment('realtime')` 两种预设，分别适用于“长缓存”与“高实时”场景。
+
+### 3.5 自定义重试策略
+
+如果默认的重试策略不满足你的需求，可以使用 `createSafeRetryStrategy` 和 `createErrorSafeConfig` 来自定义：
+
+```tsx
+import { 
+  createSafeRetryStrategy, 
+  createErrorSafeConfig 
+} from '@qiaopeng/tanstack-query-plus/core'
+
+// 方式一：创建自定义重试策略
+const customRetry = createSafeRetryStrategy(
+  0,  // 4XX 错误重试次数
+  1,  // 5XX 错误重试次数
+  2   // 其他错误重试次数
+)
+
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      retry: customRetry,
+    }
+  }
+})
+
+// 方式二：使用错误安全配置（推荐）
+const errorSafeConfig = createErrorSafeConfig({
+  maxRetries4xx: 0,       // 4XX 不重试
+  maxRetries5xx: 0,       // 5XX 不重试（严格模式）
+  maxRetriesOther: 1,     // 网络错误最多 1 次
+  disableFocus: false,    // 是否禁用窗口聚焦时 refetch
+  disableReconnect: false // 是否禁用重连时 refetch
+})
+
+const queryClient = new QueryClient({
+  defaultOptions: errorSafeConfig
+})
+```
+
+**使用场景：**
+
+1. **严格模式**：完全禁用 4XX/5XX 重试，避免不必要的请求
+2. **宽松模式**：增加重试次数，适合网络不稳定的环境
+3. **自定义场景**：根据业务需求精确控制重试行为
+
+### 3.6 添加 DevTools（开发环境）
 
 在开发环境中，强烈建议添加 DevTools 来调试查询状态：
 
@@ -1069,13 +1139,21 @@ batchDelete.mutate(['id1', 'id2', 'id3'])
 2. 使用离线队列在恢复网络后批量执行（稳健且可持久化）：
 
 ```tsx
-import { createOfflineQueueManager, mutationRegistry } from '@qiaopeng/tanstack-query-plus/features'
+import { createOfflineQueueManager, mutationRegistry, serializeMutationKey } from '@qiaopeng/tanstack-query-plus/features'
+import { MutationOperationType } from '@qiaopeng/tanstack-query-plus/types'
 
 const queue = createOfflineQueueManager({ storageKey: 'todo-ops', concurrency: 3 })
 
-function registerDelete(id: string) {
-  mutationRegistry.register(['todos','delete',id].join('-'), () => api.deleteTodo(id))
-  queue.add({ mutationKey: ['todos','delete',id], mutationFn: () => api.deleteTodo(id), priority: 1 })
+async function registerDelete(id: string) {
+  const key = serializeMutationKey(['todos', 'delete', id])
+  mutationRegistry.register(key, () => api.deleteTodo(id))
+  await queue.add({
+    type: MutationOperationType.DELETE,
+    mutationKey: ['todos', 'delete', id],
+    variables: { id },
+    mutationFn: () => api.deleteTodo(id),
+    priority: 1
+  })
 }
 ```
 
@@ -2650,7 +2728,8 @@ console.log({
 对于需要在离线时也能操作的应用，可以使用离线队列管理器：
 
 ```tsx
-import { createOfflineQueueManager, mutationRegistry } from '@qiaopeng/tanstack-query-plus/features'
+import { createOfflineQueueManager, isOnline, mutationRegistry, serializeMutationKey } from '@qiaopeng/tanstack-query-plus/features'
+import { MutationOperationType } from '@qiaopeng/tanstack-query-plus/types'
 
 // 创建队列管理器
 const queueManager = createOfflineQueueManager({
@@ -2663,15 +2742,17 @@ const queueManager = createOfflineQueueManager({
 
 // 注册 mutation 函数（用于恢复队列时执行）
 // 注册函数签名为 () => Promise<unknown>，如需变量请使用闭包或在入队项的 mutationFn 捕获
-mutationRegistry.register('updateUser', () => updateUserAPI(savedUserData))
-mutationRegistry.register('createPost', () => createPostAPI(savedPostData))
+mutationRegistry.register(serializeMutationKey(['updateUser']), () => updateUserAPI(savedUserData))
+mutationRegistry.register(serializeMutationKey(['createPost']), () => createPostAPI(savedPostData))
 
 // 添加操作到队列
 async function handleUpdateUser(userData) {
   if (!isOnline()) {
     // 离线时添加到队列
     await queueManager.add({
+      type: MutationOperationType.UPDATE,
       mutationKey: ['updateUser'],
+      variables: userData,
       mutationFn: () => updateUserAPI(userData),
       priority: 1,  // 优先级（数字越大越优先）
     })
@@ -2712,6 +2793,7 @@ queueManager.destroy()
 ```tsx
 import { useState, useEffect } from 'react'
 import { createOfflineQueueManager } from '@qiaopeng/tanstack-query-plus/features'
+import { MutationOperationType } from '@qiaopeng/tanstack-query-plus/types'
 import { useEnhancedQuery } from '@qiaopeng/tanstack-query-plus/hooks'
 import { useQueryClient, usePersistenceStatus } from '@qiaopeng/tanstack-query-plus'
 
@@ -2757,7 +2839,9 @@ function TodoApp() {
     if (!networkStatus) {
       // 离线：添加到队列
       await offlineQueue.add({
+        type: MutationOperationType.CREATE,
         mutationKey: ['addTodo'],
+        variables: todoData,
         mutationFn: () => api.createTodo(todoData),
         priority: 1,
       })
@@ -3615,7 +3699,13 @@ function UserProfile({ userId }) {
 import { QueryClient } from '@qiaopeng/tanstack-query-plus'
 import { getConfigByEnvironment, ensureBestPractices } from '@qiaopeng/tanstack-query-plus/core'
 
-const baseConfig = getConfigByEnvironment(process.env.NODE_ENV)
+const env =
+  process.env.NODE_ENV === 'production'
+    ? 'production'
+    : process.env.NODE_ENV === 'test'
+      ? 'test'
+      : 'development'
+const baseConfig = getConfigByEnvironment(env)
 
 // 确保配置符合最佳实践
 const config = ensureBestPractices({
@@ -3691,12 +3781,12 @@ function useUser(userId: string): EnhancedQueryResult<User, ApiError> {
 }
 
 // 类型安全的 mutation
-function useUpdateUser() {
+function useUpdateUser(userId: string) {
   return useMutation<User, ApiError, Partial<User>>({
-    mutationFn: (data) => updateUser(data),
+    mutationFn: (patch) => updateUser(userId, patch),
     optimistic: {
-      queryKey: ['user', data.id],
-      updater: (old, newData) => ({ ...old, ...newData }),
+      queryKey: ['user', userId],
+      updater: (old, patch) => (old ? ({ ...old, ...patch }) : old),
     },
   })
 }
@@ -3826,32 +3916,6 @@ useEnhancedQuery({
 3. **处理认证过期**：在全局错误处理中处理 401 错误
 4. **清理敏感缓存**：用户登出时清除缓存
 
----
-
-## 总结
-
-恭喜你完成了本教程！现在你已经掌握了 `@qiaopeng/tanstack-query-plus` 的所有核心功能：
-
-1. ✅ 配置 Provider 和最佳实践
-2. ✅ 基础查询和增强查询
-3. ✅ Query Key 管理
-4. ✅ 数据变更和乐观更新
-5. ✅ 无限滚动和分页
-6. ✅ 批量查询和仪表盘
-7. ✅ 智能预取策略
-8. ✅ Suspense 模式
-9. ✅ 离线支持和持久化
-10. ✅ 数据防护与安全
-11. ✅ 焦点管理
-12. ✅ 工具函数和选择器
-
-### 下一步
-
-- 查看 [GitHub 仓库](https://github.com/qiaopengg/qiaopeng-tanstack-query-plus) 获取最新更新
-- 阅读 [TanStack Query 官方文档](https://tanstack.com/query/latest) 了解更多底层概念
-- 在 [Issues](https://github.com/qiaopengg/qiaopeng-tanstack-query-plus/issues) 中提问或反馈
-
-祝你编码愉快！🚀
 ### 16.9 类型与错误处理规范
 
 - 明确类型参数：在增强 hooks 中显式标注 `TData` 与 `TError`，避免 `any` 漏出
@@ -3902,8 +3966,8 @@ useEnhancedQuery({
   - `QueryClient`、`QueryClientProvider`、`useQueryClient`、`skipToken`、`useIsMutating`（直接再导出原生 API）
 
 - `@qiaopeng/tanstack-query-plus/core`
-  - 配置：`GLOBAL_QUERY_CONFIG`、`createCustomConfig`、`DEFAULT_STALE_TIME`、`DEFAULT_GC_TIME`
-  - 重试：`defaultQueryRetryStrategy`、`defaultMutationRetryStrategy`、`exponentialBackoff`
+  - 配置：`GLOBAL_QUERY_CONFIG`、`createCustomConfig`、`createErrorSafeConfig`、`DEFAULT_STALE_TIME`、`DEFAULT_GC_TIME`
+  - 重试：`defaultQueryRetryStrategy`、`defaultMutationRetryStrategy`、`createSafeRetryStrategy`、`exponentialBackoff`
   - 环境：`isDev`、`isProd`、`isTest`
   - DevTools：`ReactQueryDevtools`、`isDevToolsEnabled`、`createDevToolsConfig`（src/core/devtools.ts:28）
   - 焦点管理：`focusManager`、`getSmartFocusManager`、`pauseFocusManager`、`resumeFocusManager`
@@ -3919,7 +3983,7 @@ useEnhancedQuery({
   - 数据防护：`useDataGuardQueryConfig`、`useDataGuardMutation`
 
 - `@qiaopeng/tanstack-query-plus/features`
-  - 离线：`setupOnlineManager`、`isOnline`、`createOfflineQueueManager`、`OfflineQueueManager`、`mutationRegistry`、`subscribeToOnlineStatus`
+  - 离线：`setupOnlineManager`、`isOnline`、`createOfflineQueueManager`、`OfflineQueueManager`、`mutationRegistry`、`serializeMutationKey`、`subscribeToOnlineStatus`
   - 持久化：`createPersistOptions`、`createPersister`、`clearCache`、`clearExpiredCache`、`checkStorageSize`、`getStorageStats`、`migrateToIndexedDB`
 
 - `@qiaopeng/tanstack-query-plus/components`
@@ -3939,3 +4003,28 @@ useEnhancedQuery({
   - 原生 API 再导出：`useQuery`、`useMutation`、`useInfiniteQuery`、`useSuspenseQuery` 等（src/react-query/index.ts:1）
 
 提示：完整导出列表可在 `package.json:33` 的 `exports` 字段中查看；顶层入口再导出常用原生 API，子路径按模块分层导出，便于 tree-shaking。
+
+---
+
+## 总结
+
+你已经覆盖了 `@qiaopeng/tanstack-query-plus` 的核心能力：
+
+1. ✅ 配置 Provider 和最佳实践
+2. ✅ 基础查询和增强查询
+3. ✅ Query Key 管理
+4. ✅ 数据变更和乐观更新
+5. ✅ 无限滚动和分页
+6. ✅ 批量查询和仪表盘
+7. ✅ 智能预取策略
+8. ✅ Suspense 模式
+9. ✅ 离线支持和持久化
+10. ✅ 数据防护与安全
+11. ✅ 焦点管理
+12. ✅ 工具函数和选择器
+
+### 下一步
+
+- 查看 [GitHub 仓库](https://github.com/qiaopengg/qiaopeng-tanstack-query-plus) 获取最新更新
+- 阅读 [TanStack Query 官方文档](https://tanstack.com/query/latest) 了解更多底层概念
+- 在 [Issues](https://github.com/qiaopengg/qiaopeng-tanstack-query-plus/issues) 中提问或反馈

package/dist/PersistQueryClientProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PersistQueryClientProvider.d.ts","sourceRoot":"","sources":["../src/PersistQueryClientProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,MAAM,EACN,QAAiC,EACjC,iBAAwB,EACxB,oBAA2B,EAC3B,cAAc,EAAE,eAAe,EAC/B,gBAAgB,EACjB,EAAE,+BAA+B,2CA0BjC;AAED,wBAAgB,oBAAoB;;;EASnC;AAED,wBAAgB,qBAAqB;;;EAWpC;AAED,eAAe,0BAA0B,CAAC"}
+{"version":3,"file":"PersistQueryClientProvider.d.ts","sourceRoot":"","sources":["../src/PersistQueryClientProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,MAAM,EACN,QAAiC,EACjC,iBAAwB,EACxB,oBAA2B,EAC3B,cAAc,EAAE,eAAe,EAC/B,gBAAgB,EACjB,EAAE,+BAA+B,2CAmCjC;AAED,wBAAgB,oBAAoB;;;EASnC;AAED,wBAAgB,qBAAqB;;;EAWpC;AAED,eAAe,0BAA0B,CAAC"}

package/dist/PersistQueryClientProvider.js

@@ -1,7 +1,8 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { QueryClientProvider } from "@tanstack/react-query";
 import { PersistQueryClientProvider as TanStackPersistProvider } from "@tanstack/react-query-persist-client";
-import { useEffect, useState } from "react";
+import { useEffect, useMemo, useState } from "react";
+import { TIME_CONSTANTS } from "./core/config.js";
 import { isOnline, setupOnlineManager, subscribeToOnlineStatus } from "./features/offline.js";
 import { clearCache, createPersister } from "./features/persistence.js";
 export function PersistQueryClientProvider({ children, client, cacheKey = "tanstack-query-cache", enablePersistence = true, enableOfflineSupport = true, onPersistError: _onPersistError, onPersistRestore }) {
@@ -10,15 +11,24 @@ export function PersistQueryClientProvider({ children, client, cacheKey = "tanst
             setupOnlineManager();
         }
     }, [enableOfflineSupport]);
+    const persister = useMemo(() => {
+        if (!enablePersistence)
+            return null;
+        return createPersister(cacheKey, undefined, _onPersistError);
+    }, [cacheKey, enablePersistence, _onPersistError]);
+    const persistOptions = useMemo(() => {
+        if (!persister)
+            return null;
+        return {
+            persister,
+            maxAge: TIME_CONSTANTS.ONE_DAY
+        };
+    }, [persister]);
     if (enablePersistence) {
-        const persister = createPersister(cacheKey, undefined, _onPersistError);
-        if (!persister) {
+        if (!persistOptions) {
             return _jsx(QueryClientProvider, { client: client, children: children });
         }
-        return (_jsx(TanStackPersistProvider, { client: client, persistOptions: {
-                persister,
-                maxAge: 1000 * 60 * 60 * 24
-            }, onSuccess: onPersistRestore, children: children }));
+        return (_jsx(TanStackPersistProvider, { client: client, persistOptions: persistOptions, onSuccess: onPersistRestore, children: children }));
     }
     return _jsx(QueryClientProvider, { client: client, children: children });
 }

package/dist/core/config.d.ts

@@ -11,18 +11,30 @@ export declare const TIME_CONSTANTS: {
 };
 export declare const DEFAULT_STALE_TIME: number;
 export declare const DEFAULT_GC_TIME: number;
+/**
+ * 默认 Query 重试策略
+ * - 4XX 客户端错误：不重试（客户端问题，重试无意义）
+ * - 5XX 服务端错误：最多重试 1 次（避免过度重试）
+ * - 其他错误（网络等）：最多重试 2 次
+ */
 export declare function defaultQueryRetryStrategy(failureCount: number, error: unknown): boolean;
+/**
+ * 默认 Mutation 重试策略
+ * - 4XX 客户端错误：不重试
+ * - 5XX 服务端错误：不重试（Mutation 更谨慎，避免重复操作）
+ * - 其他错误：最多重试 1 次
+ */
 export declare function defaultMutationRetryStrategy(failureCount: number, error: unknown): boolean;
 export declare function exponentialBackoff(attemptIndex: number): number;
-export declare const DEFAULT_QUERY_CONFIG: DefaultOptions["queries"];
-export declare const DEFAULT_MUTATION_CONFIG: DefaultOptions["mutations"];
+export declare const DEFAULT_QUERY_CONFIG: NonNullable<DefaultOptions["queries"]>;
+export declare const DEFAULT_MUTATION_CONFIG: NonNullable<DefaultOptions["mutations"]>;
 export declare const GLOBAL_QUERY_CONFIG: DefaultOptions;
 export declare const SMART_RETRY_MUTATION_CONFIG: DefaultOptions["mutations"];
 export declare const DEVELOPMENT_CONFIG: DefaultOptions;
 export declare const PRODUCTION_CONFIG: DefaultOptions;
 export declare const LONG_CACHE_CONFIG: DefaultOptions;
 export declare const REALTIME_CONFIG: DefaultOptions;
-export declare function getConfigByEnvironment(env: "development" | "production" | "test"): DefaultOptions;
+export declare function getConfigByEnvironment(env: "development" | "production" | "test" | "realtime" | "longCache"): DefaultOptions;
 export declare function createCustomConfig(overrides: Partial<DefaultOptions>): DefaultOptions;
 export declare function validateGcTime(staleTime: number, gcTime: number): {
     isValid: boolean;
@@ -33,13 +45,36 @@ export declare function validateConfig(config: DefaultOptions): {
     warnings: string[];
 };
 export declare function ensureBestPractices(config: DefaultOptions): DefaultOptions;
-export declare function createSafeRetryStrategy(maxRetries500?: number, maxRetriesOther?: number): (failureCount: number, error: unknown) => boolean;
+/**
+ * 创建安全的重试策略
+ * @param maxRetries4xx - 4XX 错误最大重试次数（默认 0，不重试）
+ * @param maxRetries5xx - 5XX 错误最大重试次数（默认 0，不重试）
+ * @param maxRetriesOther - 其他错误最大重试次数（默认 1）
+ */
+export declare function createSafeRetryStrategy(maxRetries4xx?: number, maxRetries5xx?: number, maxRetriesOther?: number): (failureCount: number, error: unknown) => boolean;
+/**
+ * 创建错误安全配置
+ * 适用于需要严格控制重试和 refetch 行为的场景
+ *
+ * @example
+ * ```typescript
+ * // 完全禁用重试
+ * const config = createErrorSafeConfig({
+ *   maxRetries4xx: 0,
+ *   maxRetries5xx: 0,
+ *   maxRetriesOther: 0,
+ *   disableFocus: true,
+ *   disableReconnect: true
+ * });
+ * ```
+ */
 export declare function createErrorSafeConfig(options?: {
-    maxRetries500?: number;
+    maxRetries4xx?: number;
+    maxRetries5xx?: number;
     maxRetriesOther?: number;
     disableFocus?: boolean;
     disableReconnect?: boolean;
-    conditionalRefetchInterval?: number | ((data: unknown, query: any) => number | false);
+    conditionalRefetchInterval?: number | ((query: any) => number | false) | ((data: unknown, query: any) => number | false);
     overrides?: Partial<DefaultOptions>;
 }): DefaultOptions;
 //# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,eAAO,MAAM,cAAc;;;;;;;;;CASjB,CAAC;AAEX,eAAO,MAAM,kBAAkB,QAAgC,CAAC;AAChE,eAAO,MAAM,eAAe,QAA6B,CAAC;AAO1D,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAIvF;AAED,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1F;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,SAAS,CAQ1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAAC,WAAW,CAI/D,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAGjC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,cAAc,CAAC,WAAW,CAInE,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAYhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAY/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAa/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAW7B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,CAwBjG;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAWrF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAQxG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B/F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAkC1E;AAED,wBAAgB,uBAAuB,CAAC,aAAa,GAAE,MAAU,EAAE,eAAe,GAAE,MAAU,IACpF,cAAc,MAAM,EAAE,OAAO,OAAO,KAAG,OAAO,CAMvD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0BAA0B,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC;IACtF,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAChC,GAAG,cAAc,CA6BtB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,eAAO,MAAM,cAAc;;;;;;;;;CASjB,CAAC;AAEX,eAAO,MAAM,kBAAkB,QAAgC,CAAC;AAChE,eAAO,MAAM,eAAe,QAA6B,CAAC;AAkC1D;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAevF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAe1F;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAQvE,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAI5E,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAGjC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,cAAc,CAAC,WAAW,CAInE,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAYhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAY/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAa/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAW7B,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GACpE,cAAc,CA4BhB;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAWrF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAQxG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B/F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAyC1E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,GAAE,MAAU,EACzB,aAAa,GAAE,MAAU,EACzB,eAAe,GAAE,MAAU,IAEnB,cAAc,MAAM,EAAE,OAAO,OAAO,KAAG,OAAO,CAgBvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0BAA0B,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC;IACzH,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAChC,GAAG,cAAc,CAuCtB"}

package/dist/core/config.js

@@ -11,19 +11,65 @@ export const TIME_CONSTANTS = {
 };
 export const DEFAULT_STALE_TIME = TIME_CONSTANTS.THIRTY_SECONDS;
 export const DEFAULT_GC_TIME = TIME_CONSTANTS.TEN_MINUTES;
+/**
+ * 从错误对象中提取 HTTP 状态码
+ * 兼容多种错误对象结构：axios、fetch、自定义等
+ */
+function extractHttpStatus(error) {
+    if (!error || typeof error !== "object")
+        return undefined;
+    const err = error;
+    // 直接在错误对象上的 status
+    if (typeof err.status === "number")
+        return err.status;
+    if (typeof err.statusCode === "number")
+        return err.statusCode;
+    // 在 response 对象中的 status (axios 等)
+    if (err.response) {
+        if (typeof err.response.status === "number")
+            return err.response.status;
+        if (typeof err.response.statusCode === "number")
+            return err.response.statusCode;
+    }
+    return undefined;
+}
+/**
+ * 默认 Query 重试策略
+ * - 4XX 客户端错误：不重试（客户端问题，重试无意义）
+ * - 5XX 服务端错误：最多重试 1 次（避免过度重试）
+ * - 其他错误（网络等）：最多重试 2 次
+ */
 export function defaultQueryRetryStrategy(failureCount, error) {
-    const httpError = error;
-    if (httpError?.status && httpError.status >= 400 && httpError.status < 600)
-        return failureCount < 2;
+    const status = extractHttpStatus(error);
+    // 4XX 客户端错误：不重试
+    if (status && status >= 400 && status < 500) {
+        return false;
+    }
+    // 5XX 服务端错误：最多重试 1 次
+    if (status && status >= 500 && status < 600) {
+        return failureCount < 1;
+    }
+    // 其他错误（网络错误等）：最多重试 2 次
     return failureCount < 2;
 }
+/**
+ * 默认 Mutation 重试策略
+ * - 4XX 客户端错误：不重试
+ * - 5XX 服务端错误：不重试（Mutation 更谨慎，避免重复操作）
+ * - 其他错误：最多重试 1 次
+ */
 export function defaultMutationRetryStrategy(failureCount, error) {
-    const httpError = error;
-    if (httpError?.status && httpError.status >= 400 && httpError.status < 500)
+    const status = extractHttpStatus(error);
+    // 4XX 客户端错误：不重试
+    if (status && status >= 400 && status < 500) {
         return false;
-    if (httpError?.status && httpError.status >= 500)
-        return failureCount < 2;
-    return failureCount < 2;
+    }
+    // 5XX 服务端错误：不重试（Mutation 避免重复操作）
+    if (status && status >= 500 && status < 600) {
+        return false;
+    }
+    // 其他错误（网络错误等）：最多重试 1 次
+    return failureCount < 1;
 }
 export function exponentialBackoff(attemptIndex) {
     return Math.min(1000 * 2 ** attemptIndex, 30000);
@@ -109,6 +155,10 @@ export function getConfigByEnvironment(env) {
             return DEVELOPMENT_CONFIG;
         case "production":
             return PRODUCTION_CONFIG;
+        case "realtime":
+            return REALTIME_CONFIG;
+        case "longCache":
+            return LONG_CACHE_CONFIG;
         case "test":
             return {
                 queries: {
@@ -180,9 +230,10 @@ export function ensureBestPractices(config) {
     const result = { ...config };
     if (result.queries) {
         const queries = { ...result.queries };
+        // Handle deprecated cacheTime -> gcTime mapping
         if ("cacheTime" in queries) {
             const cacheTime = queries.cacheTime;
-            if (typeof cacheTime === "number" && typeof queries.gcTime !== "number") {
+            if (typeof cacheTime === "number" && queries.gcTime === undefined) {
                 queries.gcTime = cacheTime;
             }
             delete queries.cacheTime;
@@ -199,7 +250,7 @@ export function ensureBestPractices(config) {
                 console.warn(`[TanStack Query Config] 自动调整 gcTime 从 ${gcTime}ms 到 ${queries.gcTime}ms，以确保大于 staleTime (${staleTime}ms)。`);
             }
         }
-        if (typeof queries.retryDelay === "number" || !queries.retryDelay) {
+        if (queries.retryDelay === undefined) {
             queries.retryDelay = exponentialBackoff;
         }
         if (queries.refetchOnWindowFocus === undefined) {
@@ -209,34 +260,65 @@ export function ensureBestPractices(config) {
     }
     return result;
 }
-export function createSafeRetryStrategy(maxRetries500 = 1, maxRetriesOther = 2) {
+/**
+ * 创建安全的重试策略
+ * @param maxRetries4xx - 4XX 错误最大重试次数（默认 0，不重试）
+ * @param maxRetries5xx - 5XX 错误最大重试次数（默认 0，不重试）
+ * @param maxRetriesOther - 其他错误最大重试次数（默认 1）
+ */
+export function createSafeRetryStrategy(maxRetries4xx = 0, maxRetries5xx = 0, maxRetriesOther = 1) {
     return (failureCount, error) => {
-        const httpError = error;
-        if (httpError?.status && httpError.status >= 400 && httpError.status < 500)
-            return false;
-        if (httpError?.status && httpError.status >= 500)
-            return failureCount < maxRetries500;
+        const status = extractHttpStatus(error);
+        // 4XX 客户端错误
+        if (status && status >= 400 && status < 500) {
+            return failureCount < maxRetries4xx;
+        }
+        // 5XX 服务端错误
+        if (status && status >= 500 && status < 600) {
+            return failureCount < maxRetries5xx;
+        }
+        // 其他错误（网络等）
         return failureCount < maxRetriesOther;
     };
 }
+/**
+ * 创建错误安全配置
+ * 适用于需要严格控制重试和 refetch 行为的场景
+ *
+ * @example
+ * ```typescript
+ * // 完全禁用重试
+ * const config = createErrorSafeConfig({
+ *   maxRetries4xx: 0,
+ *   maxRetries5xx: 0,
+ *   maxRetriesOther: 0,
+ *   disableFocus: true,
+ *   disableReconnect: true
+ * });
+ * ```
+ */
 export function createErrorSafeConfig(options = {}) {
-    const { maxRetries500 = 1, maxRetriesOther = 2, disableFocus = false, disableReconnect = false, conditionalRefetchInterval, overrides } = options;
+    const { maxRetries4xx = 0, maxRetries5xx = 0, maxRetriesOther = 1, disableFocus = false, disableReconnect = false, conditionalRefetchInterval, overrides } = options;
     const queries = {
         ...DEFAULT_QUERY_CONFIG,
-        retry: createSafeRetryStrategy(maxRetries500, maxRetriesOther),
+        retry: createSafeRetryStrategy(maxRetries4xx, maxRetries5xx, maxRetriesOther),
         retryDelay: exponentialBackoff,
         refetchOnWindowFocus: disableFocus ? false : true,
         refetchOnReconnect: disableReconnect ? false : true
     };
     if (conditionalRefetchInterval !== undefined) {
         if (typeof conditionalRefetchInterval === "number") {
-            queries.refetchInterval = (_data, query) => (query?.state?.error ? false : conditionalRefetchInterval);
+            queries.refetchInterval = (query) => (query?.state?.error ? false : conditionalRefetchInterval);
         }
         else {
-            queries.refetchInterval = conditionalRefetchInterval;
+            const fn = conditionalRefetchInterval;
+            queries.refetchInterval = (query) => (fn.length >= 2 ? fn(query?.state?.data, query) : fn(query));
         }
     }
-    const mutations = { ...DEFAULT_MUTATION_CONFIG };
+    const mutations = {
+        ...DEFAULT_MUTATION_CONFIG,
+        retry: createSafeRetryStrategy(maxRetries4xx, maxRetries5xx, maxRetriesOther)
+    };
     const result = {
         queries: { ...queries, ...(overrides?.queries || {}) },
         mutations: { ...mutations, ...(overrides?.mutations || {}) }

package/dist/core/queryOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryOptions.d.ts","sourceRoot":"","sources":["../../src/core/queryOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIpG,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CAalI;AAED,MAAM,WAAW,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,CAAE,SAAQ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC1G,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC;CACpC;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,CAahL;AAED,MAAM,WAAW,eAAe,CAAC,KAAK,CAAE,SAAQ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CAanI"}
+{"version":3,"file":"queryOptions.d.ts","sourceRoot":"","sources":["../../src/core/queryOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAIpG,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CASlI;AAED,MAAM,WAAW,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,CAAE,SAAQ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC1G,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC;CACpC;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,CAShL;AAED,MAAM,WAAW,eAAe,CAAC,KAAK,CAAE,SAAQ,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CASnI"}

package/dist/core/queryOptions.js

@@ -1,44 +1,32 @@
 import { queryOptions } from "@tanstack/react-query";
-import { DEFAULT_GC_TIME, DEFAULT_STALE_TIME, defaultQueryRetryStrategy, exponentialBackoff } from "./config.js";
+import { DEFAULT_GC_TIME, DEFAULT_QUERY_CONFIG, DEFAULT_STALE_TIME } from "./config.js";
 export function createAppQueryOptions(config) {
     return queryOptions({
+        ...DEFAULT_QUERY_CONFIG,
         queryKey: config.queryKey,
         queryFn: config.queryFn,
-        staleTime: config.staleTime ?? DEFAULT_STALE_TIME,
-        gcTime: config.gcTime ?? DEFAULT_GC_TIME,
+        staleTime: config.staleTime ?? DEFAULT_QUERY_CONFIG.staleTime ?? DEFAULT_STALE_TIME,
+        gcTime: config.gcTime ?? DEFAULT_QUERY_CONFIG.gcTime ?? DEFAULT_GC_TIME,
         enabled: config.enabled,
-        retry: defaultQueryRetryStrategy,
-        retryDelay: exponentialBackoff,
-        refetchOnWindowFocus: true,
-        refetchOnReconnect: true,
-        refetchOnMount: true
     });
 }
 export function createAppQueryOptionsWithSelect(config) {
     return queryOptions({
+        ...DEFAULT_QUERY_CONFIG,
         queryKey: config.queryKey,
         queryFn: config.queryFn,
         select: config.select,
-        staleTime: config.staleTime ?? DEFAULT_STALE_TIME,
-        gcTime: config.gcTime ?? DEFAULT_GC_TIME,
-        retry: defaultQueryRetryStrategy,
-        retryDelay: exponentialBackoff,
-        refetchOnWindowFocus: true,
-        refetchOnReconnect: true,
-        refetchOnMount: true
+        staleTime: config.staleTime ?? DEFAULT_QUERY_CONFIG.staleTime ?? DEFAULT_STALE_TIME,
+        gcTime: config.gcTime ?? DEFAULT_QUERY_CONFIG.gcTime ?? DEFAULT_GC_TIME,
     });
 }
 export function createListQueryOptions(config) {
     return queryOptions({
+        ...DEFAULT_QUERY_CONFIG,
         queryKey: config.queryKey,
         queryFn: config.queryFn,
         staleTime: config.staleTime ?? 0,
-        gcTime: config.gcTime ?? DEFAULT_GC_TIME,
+        gcTime: config.gcTime ?? DEFAULT_QUERY_CONFIG.gcTime ?? DEFAULT_GC_TIME,
         enabled: config.enabled,
-        retry: defaultQueryRetryStrategy,
-        retryDelay: exponentialBackoff,
-        refetchOnWindowFocus: true,
-        refetchOnReconnect: true,
-        refetchOnMount: true
     });
 }

package/dist/features/index.d.ts

@@ -1,4 +1,4 @@
 export { cancelQueriesBatch, invalidateQueriesBatch, setQueryDataBatch } from "../hooks/useMutation.js";
-export { calculateExponentialBackoff, configureOfflineQueries, createOfflineQueueManager, isOnline, mutationRegistry, OfflineQueueManager, setupOnlineManager, subscribeToOnlineStatus } from "./offline.js";
+export { calculateExponentialBackoff, configureOfflineQueries, createOfflineQueueManager, isOnline, mutationRegistry, OfflineQueueManager, serializeMutationKey, setupOnlineManager, subscribeToOnlineStatus } from "./offline.js";
 export { checkStorageSize, clearCache, clearExpiredCache, createPersister, createPersistOptions, getStorageStats, migrateToIndexedDB, type PersistedClient, type Persister, type PersistOptions } from "./persistence.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACxG,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC7M,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACxG,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACnO,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/features/index.js

@@ -1,3 +1,3 @@
 export { cancelQueriesBatch, invalidateQueriesBatch, setQueryDataBatch } from "../hooks/useMutation.js";
-export { calculateExponentialBackoff, configureOfflineQueries, createOfflineQueueManager, isOnline, mutationRegistry, OfflineQueueManager, setupOnlineManager, subscribeToOnlineStatus } from "./offline.js";
+export { calculateExponentialBackoff, configureOfflineQueries, createOfflineQueueManager, isOnline, mutationRegistry, OfflineQueueManager, serializeMutationKey, setupOnlineManager, subscribeToOnlineStatus } from "./offline.js";
 export { checkStorageSize, clearCache, clearExpiredCache, createPersister, createPersistOptions, getStorageStats, migrateToIndexedDB } from "./persistence.js";

package/dist/features/offline.d.ts

@@ -4,6 +4,7 @@ export declare function setupOnlineManager(): void;
 export declare const isOnline: () => boolean;
 export declare function subscribeToOnlineStatus(callback: (online: boolean) => void): () => void;
 export declare function configureOfflineQueries(_queryClient: QueryClient): void;
+export declare function serializeMutationKey(mutationKey: unknown): string;
 export declare function calculateExponentialBackoff(attempt: number, baseDelay?: number, maxDelay?: number): number;
 declare class MutationRegistry implements MutationFunctionRegistry {
     private registry;

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

@@ -1 +1 @@
-{"version":3,"file":"offline.d.ts","sourceRoot":"","sources":["../../src/features/offline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAK7H,wBAAgB,kBAAkB,SAYjC;AACD,eAAO,MAAM,QAAQ,eAAiC,CAAC;AACvD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,cAA+C;AAC1H,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,WAAW,QAAI;AAGrE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAO,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAIvG;AACD,cAAM,gBAAiB,YAAW,wBAAwB;IACxD,OAAO,CAAC,QAAQ,CAA6C;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IACvD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS;IACtD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAC7B,KAAK,IAAI,IAAI;IACb,OAAO,IAAI,MAAM,EAAE;CACpB;AACD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC;AAEvD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,mBAAmB,CAAqB;gBACpC,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAM9C,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,WAAW,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IASlG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnD,QAAQ,IAAI,YAAY;IAIxB,aAAa,IAAI,wBAAwB,EAAE;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;YAmBhE,gBAAgB;IAsB9B,OAAO,CAAC,0BAA0B;IAsBlC,OAAO,CAAC,aAAa;YAKP,YAAY;IAe1B,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,mBAAmB;IAG3B,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,iBAAiB;IAGzB,OAAO,IAAI,IAAI;CAKhB;AACD,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,mBAAmB,CAA4C"}
+{"version":3,"file":"offline.d.ts","sourceRoot":"","sources":["../../src/features/offline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAK7H,wBAAgB,kBAAkB,SAYjC;AACD,eAAO,MAAM,QAAQ,eAAiC,CAAC;AACvD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,cAA+C;AAC1H,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,WAAW,QAAI;AAWrE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAOjE;AAGD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAO,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAIvG;AACD,cAAM,gBAAiB,YAAW,wBAAwB;IACxD,OAAO,CAAC,QAAQ,CAA6C;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IACvD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS;IACtD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAC7B,KAAK,IAAI,IAAI;IACb,OAAO,IAAI,MAAM,EAAE;CACpB;AACD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC;AAEvD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,mBAAmB,CAAqB;gBACpC,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAO9C,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,WAAW,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnD,QAAQ,IAAI,YAAY;IAIxB,aAAa,IAAI,wBAAwB,EAAE;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;YAoBhE,gBAAgB;IAuB9B,OAAO,CAAC,0BAA0B;IAsBlC,OAAO,CAAC,aAAa;YAKP,YAAY;IAe1B,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,mBAAmB;IAG3B,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,iBAAiB;IAGzB,OAAO,IAAI,IAAI;CAKhB;AACD,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,mBAAmB,CAA4C"}

package/dist/features/offline.js

@@ -18,6 +18,27 @@ export function setupOnlineManager() {
 export const isOnline = () => onlineManager.isOnline();
 export function subscribeToOnlineStatus(callback) { return onlineManager.subscribe(callback); }
 export function configureOfflineQueries(_queryClient) { }
+function sortObjectKeys(value) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value !== "object")
+        return value;
+    if (Array.isArray(value))
+        return value.map(sortObjectKeys);
+    const sorted = {};
+    Object.keys(value).sort().forEach((key) => { sorted[key] = sortObjectKeys(value[key]); });
+    return sorted;
+}
+export function serializeMutationKey(mutationKey) {
+    try {
+        if (typeof mutationKey === "string")
+            return mutationKey;
+        return JSON.stringify(sortObjectKeys(mutationKey));
+    }
+    catch {
+        return String(mutationKey);
+    }
+}
 const DEFAULT_QUEUE_CONFIG = { enabled: true, maxSize: 100, persist: true, storageKey: "tanstack-query-offline-queue", autoExecuteInterval: 5000, executeOnReconnect: true, operationTimeout: 30000, concurrency: 3 };
 export function calculateExponentialBackoff(attempt, baseDelay = 1000, maxDelay = 30000) {
     const delay = Math.min(baseDelay * 2 ** attempt, maxDelay);
@@ -43,6 +64,9 @@ export class OfflineQueueManager {
         this.unsubscribeOnline = null;
         this.executingOperations = new Set();
         this.config = { ...DEFAULT_QUEUE_CONFIG, ...config };
+        if (!this.config.enabled) {
+            return;
+        }
         if (this.config.persist) {
             this.loadQueue();
         }
@@ -54,6 +78,9 @@ export class OfflineQueueManager {
         }
     }
     async add(operation) {
+        if (!this.config.enabled) {
+            throw new Error("Offline queue is disabled");
+        }
         const id = `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
         const newOperation = { ...operation, id, createdAt: new Date(), retryCount: 0 };
         if (this.queue.length >= this.config.maxSize) {
@@ -90,6 +117,9 @@ export class OfflineQueueManager {
         await this.persistQueue();
     } }
     async execute() {
+        if (!this.config.enabled) {
+            return { success: 0, failed: 0, skipped: this.queue.length };
+        }
         if (this.isExecuting) {
             return { success: 0, failed: 0, skipped: this.queue.length };
         }
@@ -141,8 +171,9 @@ export class OfflineQueueManager {
         }
         this.executingOperations.add(operation.id);
         try {
-            const mutationKey = Array.isArray(operation.mutationKey) ? operation.mutationKey.join("-") : String(operation.mutationKey);
-            const mutationFn = mutationRegistry.get(mutationKey) || operation.mutationFn;
+            const mutationKey = serializeMutationKey(operation.mutationKey);
+            const legacyMutationKey = Array.isArray(operation.mutationKey) ? operation.mutationKey.join("-") : String(operation.mutationKey);
+            const mutationFn = mutationRegistry.get(mutationKey) || mutationRegistry.get(legacyMutationKey) || operation.mutationFn;
             const timeoutPromise = new Promise((_, reject) => { setTimeout(() => reject(new Error("Operation timeout")), this.config.operationTimeout); });
             await Promise.race([mutationFn(), timeoutPromise]);
             await this.remove(operation.id);

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,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"}
+{"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;AAuBvF,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,SAAyB,GAAG,IAAI,CAQrG;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

@@ -1,3 +1,4 @@
+import { TIME_CONSTANTS } from "../core/config.js";
 function isSerializable(data) {
     try {
         JSON.stringify(data);
@@ -54,7 +55,7 @@ function createSafeStorage(storage, key) {
     };
 }
 export function createPersistOptions(config = {}) {
-    const { maxAge = 1000 * 60 * 60 * 24, onlyPersistSuccess = true, dehydrateOptions } = config;
+    const { maxAge = TIME_CONSTANTS.ONE_DAY, onlyPersistSuccess = true, dehydrateOptions } = config;
     return {
         maxAge,
         dehydrateOptions: {
@@ -120,7 +121,7 @@ export function clearCache(key = "tanstack-query-cache") { try {
     window.localStorage.removeItem(key);
 }
 catch { } }
-export function clearExpiredCache(key = "tanstack-query-cache", maxAge = 1000 * 60 * 60 * 24) {
+export function clearExpiredCache(key = "tanstack-query-cache", maxAge = TIME_CONSTANTS.ONE_DAY) {
     try {
         const stored = window.localStorage.getItem(key);
         if (!stored)

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

@@ -1 +1 @@
-{"version":3,"file":"useDataGuardMutation.d.ts","sourceRoot":"","sources":["../../src/hooks/useDataGuardMutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAA8B,MAAM,uBAAuB,CAAC;AAuBzF,MAAM,WAAW,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAE,SAAQ,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC;IACzI,aAAa;IACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,SAAS,eAAe,GAAG,eAAe,EAC/C,MAAM,GAAG,KAAK,EACd,UAAU,SAAS,eAAe,GAAG,eAAe,EACpD,QAAQ,GAAG,OAAO,EAElB,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,GACtE,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAkHxD"}
+{"version":3,"file":"useDataGuardMutation.d.ts","sourceRoot":"","sources":["../../src/hooks/useDataGuardMutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAA8B,MAAM,uBAAuB,CAAC;AAOzF,MAAM,WAAW,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAE,SAAQ,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC;IACzI,aAAa;IACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,SAAS,eAAe,GAAG,eAAe,EAC/C,MAAM,GAAG,KAAK,EACd,UAAU,SAAS,eAAe,GAAG,eAAe,EACpD,QAAQ,GAAG,OAAO,EAElB,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,KAAK,CAAC,EAChD,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,GACtE,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAkHxD"}

package/dist/hooks/useDataGuardMutation.js

@@ -2,21 +2,7 @@ import { useQueryClient } from "@tanstack/react-query";
 import { useMutation } from "./useMutation.js";
 import { ConflictError } from "../types/dataGuard.js";
 import { hashObject, markRecentlyUpdated, clearRecentlyUpdated, updateFamilyMetadata } from "../utils/dataGuard.js";
-/**
- * Check if a query key starts with a given prefix
- */
-function startsWithKeyPrefix(key, prefix) {
-    const k = Array.isArray(key) ? key : [key];
-    const p = Array.isArray(prefix) ? prefix : [prefix];
-    if (p.length > k.length)
-        return false;
-    for (let i = 0; i < p.length; i++) {
-        if (JSON.stringify(k[i]) !== JSON.stringify(p[i])) {
-            return false;
-        }
-    }
-    return true;
-}
+import { startsWithKeyPrefix } from "../utils/queryKey.js";
 /**
  * 带数据防护的 Mutation Hook
  *

package/dist/hooks/useMutation.js

@@ -34,9 +34,9 @@ export function useMutation(options) {
     const { optimistic, onMutate, onError, onSuccess, onSettled, ...restOptions } = options;
     const mutationConfig = {
         ...restOptions,
-        retry: restOptions.retry ?? DEFAULT_MUTATION_CONFIG?.retry,
-        retryDelay: restOptions.retryDelay ?? DEFAULT_MUTATION_CONFIG?.retryDelay,
-        gcTime: restOptions.gcTime ?? DEFAULT_MUTATION_CONFIG?.gcTime
+        retry: restOptions.retry ?? DEFAULT_MUTATION_CONFIG.retry,
+        retryDelay: restOptions.retryDelay ?? DEFAULT_MUTATION_CONFIG.retryDelay,
+        gcTime: restOptions.gcTime ?? DEFAULT_MUTATION_CONFIG.gcTime
     };
     if (!optimistic) {
         if (onMutate) {

package/dist/types/dataGuard.d.ts

@@ -22,7 +22,7 @@ export interface VersionedPaginatedResponse<T> {
     version?: number;
     updatedAt?: string;
     _hash?: string;
-    _recentlyUpdatedIds?: Set<string | number>;
+    _recentlyUpdatedIds?: Array<string | number> | Set<string | number>;
 }
 /**
  * 旧数据检测信息

package/dist/types/dataGuard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataGuard.d.ts","sourceRoot":"","sources":["../../src/types/dataGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,sBAAsB;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yBAAyB;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB;IACjB,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACpD,eAAe;IACf,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CACpD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACnB,OAAO,EAAE,GAAG;gBAAZ,OAAO,EAAE,GAAG;CAIhC"}
+{"version":3,"file":"dataGuard.d.ts","sourceRoot":"","sources":["../../src/types/dataGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,sBAAsB;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yBAAyB;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB;IACjB,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACpD,eAAe;IACf,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CACpD;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACnB,OAAO,EAAE,GAAG;gBAAZ,OAAO,EAAE,GAAG;CAIhC"}

package/dist/utils/dataGuard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataGuard.d.ts","sourceRoot":"","sources":["../../src/utils/dataGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC3B,MAAM,uBAAuB,CAAC;AA+C/B;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAO3C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,eAAe,EACtD,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC,EACtC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,SAAS,EACjD,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,gBAAqB,GAC7B;IACD,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,YAAY,EAAE,GAAG,CAAC;CACnB,CA+IA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,eAAe,EACrD,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAClC,0BAA0B,CAAC,CAAC,CAAC,CAK/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAC3D,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC,EACnC,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,0BAA0B,CAAC,CAAC,CAAC,CAQ/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAC5D,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC,EACnC,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,0BAA0B,CAAC,CAAC,CAAC,CAU/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAC5D,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,QAAQ,EACnB,QAAQ,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,GAC/C,IAAI,CAiCN"}
+{"version":3,"file":"dataGuard.d.ts","sourceRoot":"","sources":["../../src/utils/dataGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC3B,MAAM,uBAAuB,CAAC;AA+B/B;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAO3C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,eAAe,EACtD,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC,EACtC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,SAAS,EACjD,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,gBAAqB,GAC7B;IACD,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,YAAY,EAAE,GAAG,CAAC;CACnB,CAqJA;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,eAAe,EACrD,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAClC,0BAA0B,CAAC,CAAC,CAAC,CAK/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,EAC3D,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC,EACnC,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,0BAA0B,CAAC,CAAC,CAAC,CAY/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAC5D,IAAI,EAAE,0BAA0B,CAAC,CAAC,CAAC,EACnC,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,0BAA0B,CAAC,CAAC,CAAC,CAU/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,EAC5D,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,QAAQ,EACnB,QAAQ,EAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,GAC/C,IAAI,CAiCN"}

package/dist/utils/dataGuard.js

@@ -1,18 +1,4 @@
-/**
- * Check if a query key starts with a given prefix
- */
-function startsWithKeyPrefix(key, prefix) {
-    const k = Array.isArray(key) ? key : [key];
-    const p = Array.isArray(prefix) ? prefix : [prefix];
-    if (p.length > k.length)
-        return false;
-    for (let i = 0; i < p.length; i++) {
-        if (JSON.stringify(k[i]) !== JSON.stringify(p[i])) {
-            return false;
-        }
-    }
-    return true;
-}
+import { startsWithKeyPrefix } from "./queryKey.js";
 /**
  * 简单的字符串哈希函数（DJB2算法变体）
  */
@@ -156,7 +142,11 @@ export function applyDataGuard(newData, cached, queryKey, options = {}) {
             shouldReject = true;
             reason = "内容哈希相同，数据未变化";
         }
-        else if (cachedHash && cached._recentlyUpdatedIds && cached._recentlyUpdatedIds.size > 0) {
+        else if (cachedHash &&
+            cached._recentlyUpdatedIds &&
+            (Array.isArray(cached._recentlyUpdatedIds)
+                ? cached._recentlyUpdatedIds.length > 0
+                : cached._recentlyUpdatedIds.size > 0)) {
             // 检查最近更新的项是否被回退
             let hasRevert = false;
             for (const id of cached._recentlyUpdatedIds) {
@@ -201,11 +191,15 @@ export function addHashToData(data) {
  * 标记最近更新的项
  */
 export function markRecentlyUpdated(data, updatedId) {
-    const recentlyUpdatedIds = new Set(data._recentlyUpdatedIds || []);
-    recentlyUpdatedIds.add(updatedId);
+    const existing = data._recentlyUpdatedIds
+        ? (Array.isArray(data._recentlyUpdatedIds) ? [...data._recentlyUpdatedIds] : Array.from(data._recentlyUpdatedIds))
+        : [];
+    if (!existing.includes(updatedId)) {
+        existing.push(updatedId);
+    }
     return {
         ...data,
-        _recentlyUpdatedIds: recentlyUpdatedIds
+        _recentlyUpdatedIds: existing
     };
 }
 /**
@@ -214,11 +208,11 @@ export function markRecentlyUpdated(data, updatedId) {
 export function clearRecentlyUpdated(data, updatedId) {
     if (!data._recentlyUpdatedIds)
         return data;
-    const recentlyUpdatedIds = new Set(data._recentlyUpdatedIds);
-    recentlyUpdatedIds.delete(updatedId);
+    const existing = Array.isArray(data._recentlyUpdatedIds) ? data._recentlyUpdatedIds : Array.from(data._recentlyUpdatedIds);
+    const remaining = existing.filter((id) => id !== updatedId);
     return {
         ...data,
-        _recentlyUpdatedIds: recentlyUpdatedIds.size > 0 ? recentlyUpdatedIds : undefined
+        _recentlyUpdatedIds: remaining.length > 0 ? remaining : undefined
     };
 }
 /**

package/dist/utils/index.d.ts

@@ -3,7 +3,7 @@ export { getNetworkInfo, getNetworkSpeed, isFastNetwork, isSlowNetwork, type Nav
 export { batchRemoveItems, batchUpdateItems, conditionalUpdateItems, createAddItemConfig, createListOperationConfig, createRemoveItemConfig, createUpdateItemConfig, type ListOperationVariables, listUpdater, reorderItems } from "./optimisticUtils.js";
 export { keepPreviousData, stableListPlaceholder } from "./placeholderData.js";
 export { getPrefetchManager, type InteractionRecord, type NetworkSpeed, type PredictionResult, type PrefetchConfig, type PrefetchStats, type PrefetchTask, resetPrefetchManager, SmartPrefetchManager } from "./prefetchManager.js";
-export { createQueryKeyFactory, createSimpleQueryKeyFactory, extractParamsFromKey, isQueryKeyEqual, type NormalizeConfig, normalizeQueryParams, type QueryKeyFactory, type QueryKeyFactoryConfig } from "./queryKey.js";
+export { createQueryKeyFactory, createSimpleQueryKeyFactory, extractParamsFromKey, isQueryKeyEqual, startsWithKeyPrefix, type NormalizeConfig, normalizeQueryParams, type QueryKeyFactory, type QueryKeyFactoryConfig } from "./queryKey.js";
 export { compose, selectById, selectByIds, selectCount, selectField, selectFields, selectFirst, selectItems, selectLast, selectMap, selectors, selectTotal, selectWhere } from "./selectors.js";
 export { deepClone, formatBytes, getStorageUsage, isStorageAvailable } from "./storage.js";
 export { applyDataGuard, addHashToData, hashObject, markRecentlyUpdated, clearRecentlyUpdated, updateFamilyMetadata } from "./dataGuard.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACpH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC3H,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1P,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpO,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACxN,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChM,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACpH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC3H,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1P,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpO,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,eAAe,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC7O,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChM,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/utils/index.js

@@ -3,7 +3,7 @@ export { getNetworkInfo, getNetworkSpeed, isFastNetwork, isSlowNetwork } from ".
 export { batchRemoveItems, batchUpdateItems, conditionalUpdateItems, createAddItemConfig, createListOperationConfig, createRemoveItemConfig, createUpdateItemConfig, listUpdater, reorderItems } from "./optimisticUtils.js";
 export { keepPreviousData, stableListPlaceholder } from "./placeholderData.js";
 export { getPrefetchManager, resetPrefetchManager, SmartPrefetchManager } from "./prefetchManager.js";
-export { createQueryKeyFactory, createSimpleQueryKeyFactory, extractParamsFromKey, isQueryKeyEqual, normalizeQueryParams } from "./queryKey.js";
+export { createQueryKeyFactory, createSimpleQueryKeyFactory, extractParamsFromKey, isQueryKeyEqual, startsWithKeyPrefix, normalizeQueryParams } from "./queryKey.js";
 export { compose, selectById, selectByIds, selectCount, selectField, selectFields, selectFirst, selectItems, selectLast, selectMap, selectors, selectTotal, selectWhere } from "./selectors.js";
 export { deepClone, formatBytes, getStorageUsage, isStorageAvailable } from "./storage.js";
 export { applyDataGuard, addHashToData, hashObject, markRecentlyUpdated, clearRecentlyUpdated, updateFamilyMetadata } from "./dataGuard.js";

package/dist/utils/queryKey.d.ts

@@ -1,3 +1,4 @@
+import type { QueryKey } from "@tanstack/react-query";
 export interface NormalizeConfig<T = any> {
     required?: (keyof T)[];
     defaults?: Partial<T>;
@@ -21,4 +22,5 @@ export declare function createQueryKeyFactory<TParams = any>(config: QueryKeyFac
 export declare function createSimpleQueryKeyFactory(namespace: string): QueryKeyFactory;
 export declare function isQueryKeyEqual(key1: readonly any[], key2: readonly any[]): boolean;
 export declare function extractParamsFromKey(queryKey: readonly any[]): Record<string, any> | undefined;
+export declare function startsWithKeyPrefix(key: QueryKey, prefix: QueryKey): boolean;
 //# sourceMappingURL=queryKey.d.ts.map

package/dist/utils/queryKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queryKey.d.ts","sourceRoot":"","sources":["../../src/utils/queryKey.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IAAI,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE;AACtI,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,MAAM,GAAE,eAAe,CAAC,CAAC,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAuB/I;AACD,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,GAAG;IAAI,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAA;CAAE;AACvH,MAAM,WAAW,eAAe,CAAC,OAAO,GAAG,GAAG;IAAI,GAAG,EAAE,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;CAAE;AAC/X,wBAAgB,qBAAqB,CAAC,OAAO,GAAG,GAAG,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAUrH;AACD,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAAiD;AAChI,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE,GAAG,OAAO,CAUnF;AACD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAI9F"}
+{"version":3,"file":"queryKey.d.ts","sourceRoot":"","sources":["../../src/utils/queryKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IAAI,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE;AACtI,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,EAAE,MAAM,GAAE,eAAe,CAAC,CAAC,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAuB/I;AACD,MAAM,WAAW,qBAAqB,CAAC,OAAO,GAAG,GAAG;IAAI,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAA;CAAE;AACvH,MAAM,WAAW,eAAe,CAAC,OAAO,GAAG,GAAG;IAAI,GAAG,EAAE,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;CAAE;AAC/X,wBAAgB,qBAAqB,CAAC,OAAO,GAAG,GAAG,EAAE,MAAM,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAUrH;AACD,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAAiD;AAChI,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE,GAAG,OAAO,CAUnF;AACD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAI9F;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAU5E"}

package/dist/utils/queryKey.js

@@ -75,3 +75,15 @@ export function extractParamsFromKey(queryKey) {
     }
     return undefined;
 }
+export function startsWithKeyPrefix(key, prefix) {
+    const k = Array.isArray(key) ? key : [key];
+    const p = Array.isArray(prefix) ? prefix : [prefix];
+    if (p.length > k.length)
+        return false;
+    for (let i = 0; i < p.length; i++) {
+        if (JSON.stringify(k[i]) !== JSON.stringify(p[i])) {
+            return false;
+        }
+    }
+    return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qiaopeng/tanstack-query-plus",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "description": "Enhanced TanStack Query toolkit: defaults, hooks, persistence, offline, data guard, utils",
   "author": "qiaopeng",
   "license": "MIT",