@qiaopeng/tanstack-query-plus 0.5.9 → 0.5.10

package/dist/utils/dataGuard.js

@@ -1,251 +0,0 @@
-import { startsWithKeyPrefix } from "./queryKey.js";
-/**
- * 简单的字符串哈希函数（DJB2算法变体）
- */
-function simpleHash(str) {
-    let hash = 0;
-    for (let i = 0; i < str.length; i++) {
-        const char = str.charCodeAt(i);
-        hash = ((hash << 5) - hash) + char;
-        hash = hash | 0; // 转换为32位整数
-    }
-    return Math.abs(hash).toString(36);
-}
-/**
- * 对象键排序（确保一致的哈希值）
- */
-function sortObjectKeys(obj) {
-    if (obj === null || obj === undefined)
-        return obj;
-    if (typeof obj !== 'object')
-        return obj;
-    if (Array.isArray(obj))
-        return obj.map(sortObjectKeys);
-    const sorted = {};
-    Object.keys(obj).sort().forEach(key => {
-        sorted[key] = sortObjectKeys(obj[key]);
-    });
-    return sorted;
-}
-/**
- * 计算对象的哈希值（键排序后计算，确保一致性）
- */
-export function hashObject(obj) {
-    try {
-        const sorted = sortObjectKeys(obj);
-        return simpleHash(JSON.stringify(sorted));
-    }
-    catch {
-        return simpleHash(String(obj));
-    }
-}
-/**
- * 自适应数据防护：根据数据特征自动选择最佳防护策略
- *
- * 策略优先级：
- * 1. version（版本号）- 最可靠
- * 2. updatedAt（时间戳）- 次优
- * 3. hash（内容哈希）- 兜底
- */
-export function applyDataGuard(newData, cached, queryKey, options = {}) {
-    const { maxDataAge = 10000, enableVersionCheck = true, enableTimestampCheck = true, enableHashCheck = true } = options;
-    // 如果没有缓存，接受新数据
-    if (!cached) {
-        return {
-            shouldReject: false,
-            reason: "No cached data",
-            strategy: "none",
-            guardDetails: {}
-        };
-    }
-    let shouldReject = false;
-    let reason = "";
-    let strategy = "none";
-    let guardDetails = {};
-    // ============================================
-    // 策略1：版本号比较（最可靠）
-    // ============================================
-    if (enableVersionCheck && cached.version !== undefined && newData.version !== undefined) {
-        strategy = "version";
-        if (newData.version < cached.version) {
-            shouldReject = true;
-            reason = `版本号回退：缓存版本 ${cached.version} > 新数据版本 ${newData.version}`;
-            guardDetails = {
-                cachedVersion: cached.version,
-                newVersion: newData.version,
-                diff: cached.version - newData.version
-            };
-        }
-        else if (newData.version === cached.version) {
-            guardDetails = {
-                version: newData.version,
-                status: "identical"
-            };
-        }
-        else {
-            guardDetails = {
-                cachedVersion: cached.version,
-                newVersion: newData.version,
-                status: "updated"
-            };
-        }
-    }
-    // ============================================
-    // 策略2：时间戳比较（次优）
-    // ============================================
-    else if (enableTimestampCheck && cached.updatedAt && newData.updatedAt) {
-        strategy = "timestamp";
-        try {
-            const cachedTime = new Date(cached.updatedAt).getTime();
-            const newTime = new Date(newData.updatedAt).getTime();
-            const timeDiff = cachedTime - newTime;
-            const dataAge = Date.now() - newTime;
-            guardDetails = {
-                cachedTime: cached.updatedAt,
-                newTime: newData.updatedAt,
-                timeDiff,
-                dataAge
-            };
-            // 新数据的时间戳更旧
-            if (newTime < cachedTime) {
-                // 如果数据年龄超过阈值，拒绝
-                if (dataAge > maxDataAge) {
-                    shouldReject = true;
-                    reason = `时间戳过期：新数据时间 ${newData.updatedAt} 早于缓存 ${cached.updatedAt}，且数据年龄 ${dataAge}ms 超过阈值 ${maxDataAge}ms`;
-                }
-                else {
-                    // 数据年龄在可接受范围内，记录警告但接受
-                    guardDetails.warning = `时间戳略旧但在可接受范围内（${dataAge}ms < ${maxDataAge}ms）`;
-                }
-            }
-        }
-        catch (error) {
-            guardDetails.error = `时间戳解析失败: ${error}`;
-            // 时间戳解析失败，不使用时间戳策略
-            // 将在下一个 else if 中尝试 hash 策略
-        }
-    }
-    // ============================================
-    // 策略3：内容哈希比较（兜底）
-    // ============================================
-    else if (enableHashCheck) {
-        strategy = "hash";
-        const newHash = hashObject(newData.items);
-        const cachedHash = cached._hash;
-        guardDetails = {
-            cachedHash,
-            newHash,
-            identical: cachedHash === newHash
-        };
-        if (cachedHash && cachedHash === newHash) {
-            // 内容完全相同，不需要更新
-            shouldReject = true;
-            reason = "内容哈希相同，数据未变化";
-        }
-        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) {
-                const cachedItem = cached.items.find(item => item.id === id);
-                const newItem = newData.items.find(item => item.id === id);
-                if (cachedItem && newItem) {
-                    const cachedItemHash = hashObject(cachedItem);
-                    const newItemHash = hashObject(newItem);
-                    if (cachedItemHash !== newItemHash) {
-                        // 简单启发式：如果缓存项有更多字段，可能是新的
-                        if (Object.keys(cachedItem).length > Object.keys(newItem).length) {
-                            hasRevert = true;
-                            guardDetails.revertedItem = { id, cachedItem, newItem };
-                            break;
-                        }
-                    }
-                }
-            }
-            if (hasRevert) {
-                shouldReject = true;
-                reason = "检测到最近更新的项可能被回退";
-            }
-        }
-    }
-    return {
-        shouldReject,
-        reason,
-        strategy,
-        guardDetails
-    };
-}
-/**
- * 为查询数据添加哈希标记
- */
-export function addHashToData(data) {
-    return {
-        ...data,
-        _hash: hashObject(data.items)
-    };
-}
-/**
- * 标记最近更新的项
- */
-export function markRecentlyUpdated(data, 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: existing
-    };
-}
-/**
- * 清理最近更新的标记
- */
-export function clearRecentlyUpdated(data, updatedId) {
-    if (!data._recentlyUpdatedIds)
-        return data;
-    const existing = Array.isArray(data._recentlyUpdatedIds) ? data._recentlyUpdatedIds : Array.from(data._recentlyUpdatedIds);
-    const remaining = existing.filter((id) => id !== updatedId);
-    return {
-        ...data,
-        _recentlyUpdatedIds: remaining.length > 0 ? remaining : undefined
-    };
-}
-/**
- * 更新所有家族缓存的元数据（版本号、时间戳、哈希）
- */
-export function updateFamilyMetadata(queryClient, familyKey, response) {
-    const cache = queryClient.getQueryCache();
-    const queries = cache.findAll({
-        predicate: (q) => startsWithKeyPrefix(q.queryKey, familyKey)
-    });
-    queries.forEach((q) => {
-        const old = queryClient.getQueryData(q.queryKey);
-        if (old) {
-            const updated = { ...old };
-            // 更新版本号
-            if (response.version !== undefined) {
-                updated.version = response.version;
-            }
-            else if (old.version !== undefined) {
-                updated.version = old.version + 1;
-            }
-            // 更新时间戳
-            if (response.updatedAt) {
-                updated.updatedAt = response.updatedAt;
-            }
-            else if (old.updatedAt !== undefined) {
-                updated.updatedAt = new Date().toISOString();
-            }
-            // 更新哈希（安全检查：确保 items 存在）
-            if (old._hash !== undefined && updated.items) {
-                updated._hash = hashObject(updated.items);
-            }
-            queryClient.setQueryData(q.queryKey, updated);
-        }
-    });
-}

package/dist/utils/fieldMapper.d.ts

@@ -1,9 +0,0 @@
-import type { QueryClient } from "@tanstack/react-query";
-export interface FieldMappingConfig {
-    nameField: string;
-    configKey: string;
-}
-export declare function createFieldEnricher<T = any>(queryKey: any, mappings: Record<string, FieldMappingConfig>): (data: T, queryClient: QueryClient) => T;
-export declare function createTempId(prefix?: string): string;
-export declare function createOptimisticBase(customFields?: Record<string, any>): Record<string, any>;
-//# sourceMappingURL=fieldMapper.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fieldMapper.d.ts","sourceRoot":"","sources":["../../src/utils/fieldMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,MAAM,WAAW,kBAAkB;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC5E,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAC9F,MAAM,CAAC,EAAE,aAAa,WAAW,KAAG,CAAC,CAe9C;AACD,wBAAgB,YAAY,CAAC,MAAM,SAAS,GAAG,MAAM,CAAgF;AACrI,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAG5F"}

package/dist/utils/fieldMapper.js

@@ -1,27 +0,0 @@
-export function createFieldEnricher(queryKey, mappings) {
-    return (data, queryClient) => {
-        const config = queryClient.getQueryData(queryKey);
-        if (!config)
-            return data;
-        const result = { ...data };
-        Object.entries(mappings).forEach(([idField, { nameField, configKey }]) => {
-            const idValue = data[idField];
-            if (idValue == null)
-                return;
-            const options = config[configKey];
-            if (!options?.length)
-                return;
-            const optionMap = new Map(options.map((item) => [String(item.value), item.label]));
-            const label = optionMap.get(String(idValue));
-            if (label) {
-                result[nameField] = label;
-            }
-        });
-        return result;
-    };
-}
-export function createTempId(prefix = "temp") { return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`; }
-export function createOptimisticBase(customFields) {
-    const now = new Date().toISOString();
-    return { createTime: now, updateTime: now, createUser: "", updateUser: "", deleteStatus: 0, ...customFields };
-}

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

@@ -1 +0,0 @@
-{"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/network.d.ts

@@ -1,9 +0,0 @@
-import type { NetworkInformation } from "../types/base";
-export interface NavigatorWithConnection extends Navigator {
-    connection?: NetworkInformation;
-}
-export declare function isSlowNetwork(): boolean;
-export declare function getNetworkInfo(): NetworkInformation | null;
-export declare function isFastNetwork(): boolean;
-export declare function getNetworkSpeed(): "fast" | "medium" | "slow" | "unknown";
-//# sourceMappingURL=network.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,MAAM,WAAW,uBAAwB,SAAQ,SAAS;IAAG,UAAU,CAAC,EAAE,kBAAkB,CAAA;CAAE;AAE9F,wBAAgB,aAAa,IAAI,OAAO,CAMvC;AACD,wBAAgB,cAAc,IAAI,kBAAkB,GAAG,IAAI,CAI1D;AACD,wBAAgB,aAAa,IAAI,OAAO,CAIvC;AACD,wBAAgB,eAAe,IAAI,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAUxE"}

package/dist/utils/network.js

@@ -1,43 +0,0 @@
-function hasConnectionAPI(nav) { return "connection" in nav; }
-export function isSlowNetwork() {
-    if (typeof navigator === "undefined") {
-        return false;
-    }
-    if (!hasConnectionAPI(navigator)) {
-        return false;
-    }
-    const connection = navigator.connection;
-    if (!connection) {
-        return false;
-    }
-    return connection.effectiveType === "slow-2g" || connection.effectiveType === "2g" || connection.saveData === true;
-}
-export function getNetworkInfo() {
-    if (typeof navigator === "undefined") {
-        return null;
-    }
-    if (!hasConnectionAPI(navigator)) {
-        return null;
-    }
-    return navigator.connection || null;
-}
-export function isFastNetwork() {
-    const networkInfo = getNetworkInfo();
-    if (!networkInfo) {
-        return true;
-    }
-    return networkInfo.effectiveType === "4g" && networkInfo.saveData !== true;
-}
-export function getNetworkSpeed() {
-    const networkInfo = getNetworkInfo();
-    if (!networkInfo || !networkInfo.effectiveType) {
-        return "unknown";
-    }
-    switch (networkInfo.effectiveType) {
-        case "4g": return "fast";
-        case "3g": return "medium";
-        case "2g":
-        case "slow-2g": return "slow";
-        default: return "unknown";
-    }
-}

package/dist/utils/optimisticUtils.d.ts

@@ -1,45 +0,0 @@
-import type { QueryKey } from "@tanstack/react-query";
-import type { ListOperationConfig, OptimisticUpdateConfig } from "../types/optimistic";
-import type { EntityWithId } from "../types/selectors";
-import { ListOperationType } from "../types/optimistic.js";
-/**
- * Loose equality check for IDs (string vs number)
- */
-export declare function idsAreEqual(a: unknown, b: unknown): boolean;
-export declare const listUpdater: {
-    add: <T extends EntityWithId>(items: T[] | undefined, newItem: T) => T[];
-    update: <T extends EntityWithId>(items: T[] | undefined, updatedItem: Partial<T> & {
-        id: T["id"];
-    }) => T[];
-    remove: <T extends EntityWithId>(items: T[] | undefined, itemId: T["id"]) => T[];
-};
-export declare function createAddItemConfig<T extends EntityWithId>(queryKey: QueryKey, options?: {
-    addToTop?: boolean;
-    onRollback?: (error: Error) => void;
-}): OptimisticUpdateConfig<T[], T>;
-export declare function createUpdateItemConfig<T extends EntityWithId>(queryKey: QueryKey, options?: {
-    onRollback?: (error: Error) => void;
-}): OptimisticUpdateConfig<T[], Partial<T> & {
-    id: T["id"];
-}>;
-export declare function createRemoveItemConfig<T extends EntityWithId>(queryKey: QueryKey, options?: {
-    onRollback?: (error: Error) => void;
-}): OptimisticUpdateConfig<T[], T["id"]>;
-export type ListOperationVariables<T extends EntityWithId, TOperation extends ListOperationType> = TOperation extends ListOperationType.ADD ? T : TOperation extends ListOperationType.UPDATE ? Partial<T> & {
-    id: T["id"];
-} : TOperation extends ListOperationType.REMOVE ? T["id"] : never;
-export declare function createListOperationConfig<T extends EntityWithId, TOperation extends ListOperationType = ListOperationType>(config: ListOperationConfig<T>): OptimisticUpdateConfig<T[], ListOperationVariables<T, TOperation>>;
-export declare function batchUpdateItems<T extends EntityWithId>(items: T[] | undefined | null, updates: Array<Partial<T> & {
-    id: T["id"];
-}>): T[];
-export declare function batchRemoveItems<T extends EntityWithId>(items: T[] | undefined | null, itemIds: Array<T["id"]>): T[];
-export declare function reorderItems<T extends EntityWithId>(items: T[] | undefined | null, fromIndex: number, toIndex: number): T[];
-export declare function conditionalUpdateItems<T extends EntityWithId>(items: T[] | undefined | null, predicate: (item: T) => boolean, updater: (item: T) => Partial<T>): T[];
-export declare function applyListOperationToPaginated<T extends EntityWithId>(data: {
-    items: T[];
-    total?: number;
-}, operation: ListOperationType, payload: Partial<T>): {
-    items: T[];
-    total?: number;
-};
-//# sourceMappingURL=optimisticUtils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"optimisticUtils.d.ts","sourceRoot":"","sources":["../../src/utils/optimisticUtils.ts"],"names":[],"mappings":"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"}

package/dist/utils/optimisticUtils.js

@@ -1,116 +0,0 @@
-import { ListOperationType } from "../types/optimistic.js";
-/**
- * Loose equality check for IDs (string vs number)
- */
-export function idsAreEqual(a, b) {
-    if (a === b)
-        return true;
-    if (a === undefined || a === null || b === undefined || b === null)
-        return false;
-    return String(a) === String(b);
-}
-export const listUpdater = {
-    add: (items, newItem) => {
-        const currentItems = items || [];
-        const existingIndex = currentItems.findIndex((item) => idsAreEqual(item.id, newItem.id));
-        if (existingIndex >= 0) {
-            const updatedItems = [...currentItems];
-            updatedItems[existingIndex] = newItem;
-            return updatedItems;
-        }
-        return [newItem, ...currentItems];
-    },
-    update: (items, updatedItem) => {
-        const currentItems = items || [];
-        return currentItems.map((item) => (idsAreEqual(item.id, updatedItem.id) ? { ...item, ...updatedItem } : item));
-    },
-    remove: (items, itemId) => {
-        const currentItems = items || [];
-        return currentItems.filter((item) => !idsAreEqual(item.id, itemId));
-    }
-};
-export function createAddItemConfig(queryKey, options) {
-    return { queryKey, updater: (oldData, newItem) => { const currentItems = oldData || []; if (options?.addToTop !== false) {
-            return [newItem, ...currentItems];
-        } return [...currentItems, newItem]; }, rollback: options?.onRollback ? (_previousData, error) => { options.onRollback(error); } : undefined, enabled: true };
-}
-export function createUpdateItemConfig(queryKey, options) {
-    return { queryKey, updater: (oldData, updatedItem) => { return listUpdater.update(oldData, updatedItem); }, rollback: options?.onRollback ? (_previousData, error) => { options.onRollback(error); } : undefined, enabled: true };
-}
-export function createRemoveItemConfig(queryKey, options) {
-    return { queryKey, updater: (oldData, itemId) => { return listUpdater.remove(oldData, itemId); }, rollback: options?.onRollback ? (_previousData, error) => { options.onRollback(error); } : undefined, enabled: true };
-}
-export function createListOperationConfig(config) {
-    return {
-        queryKey: config.queryKey,
-        updater: (oldData, variables) => {
-            switch (config.operation) {
-                case ListOperationType.ADD:
-                    return listUpdater.add(oldData, variables);
-                case ListOperationType.UPDATE:
-                    return listUpdater.update(oldData, variables);
-                case ListOperationType.REMOVE:
-                    return listUpdater.remove(oldData, variables);
-                default:
-                    return oldData || [];
-            }
-        },
-        rollback: config.onRollback
-            ? (previousData, error) => {
-                const opType = config.operation === ListOperationType.ADD
-                    ? "create"
-                    : config.operation === ListOperationType.REMOVE
-                        ? "delete"
-                        : "update";
-                config.onRollback(error, { previousData, timestamp: Date.now(), operationType: opType });
-            }
-            : undefined,
-        enabled: true
-    };
-}
-export function batchUpdateItems(items, updates) {
-    let currentItems = items || [];
-    updates.forEach((update) => { currentItems = listUpdater.update(currentItems, update); });
-    return currentItems;
-}
-export function batchRemoveItems(items, itemIds) {
-    let currentItems = items || [];
-    itemIds.forEach((itemId) => { currentItems = listUpdater.remove(currentItems, itemId); });
-    return currentItems;
-}
-export function reorderItems(items, fromIndex, toIndex) {
-    const currentItems = [...(items || [])];
-    if (fromIndex < 0 || fromIndex >= currentItems.length || toIndex < 0 || toIndex >= currentItems.length) {
-        return currentItems;
-    }
-    const [movedItem] = currentItems.splice(fromIndex, 1);
-    currentItems.splice(toIndex, 0, movedItem);
-    return currentItems;
-}
-export function conditionalUpdateItems(items, predicate, updater) {
-    const currentItems = items || [];
-    return currentItems.map((item) => { if (predicate(item)) {
-        return { ...item, ...updater(item) };
-    } return item; });
-}
-export function applyListOperationToPaginated(data, operation, payload) {
-    let items = data.items || [];
-    if (operation === ListOperationType.ADD) {
-        items = listUpdater.add(items, payload);
-    }
-    else if (operation === ListOperationType.UPDATE) {
-        items = listUpdater.update(items, payload);
-    }
-    else if (operation === ListOperationType.REMOVE) {
-        const id = payload?.id;
-        items = listUpdater.remove(items, id);
-    }
-    const total = typeof data.total === "number"
-        ? operation === ListOperationType.ADD
-            ? data.total + 1
-            : operation === ListOperationType.REMOVE
-                ? Math.max(0, data.total - 1)
-                : data.total
-        : data.total;
-    return { ...data, items, total };
-}

package/dist/utils/placeholderData.d.ts

@@ -1,3 +0,0 @@
-export { keepPreviousData } from "@tanstack/react-query";
-export declare function stableListPlaceholder<T = any>(previousData: T | undefined): T | undefined;
-//# sourceMappingURL=placeholderData.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"placeholderData.d.ts","sourceRoot":"","sources":["../../src/utils/placeholderData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,wBAAgB,qBAAqB,CAAC,CAAC,GAAG,GAAG,EAAE,YAAY,EAAE,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAuBzF"}

package/dist/utils/placeholderData.js

@@ -1,28 +0,0 @@
-export { keepPreviousData } from "@tanstack/react-query";
-export function stableListPlaceholder(previousData) {
-    if (previousData === undefined || previousData === null)
-        return previousData;
-    if (Array.isArray(previousData)) {
-        return [];
-    }
-    if (typeof previousData === "object") {
-        const obj = { ...previousData };
-        if (Array.isArray(obj.Rows)) {
-            obj.Rows = [];
-            if (typeof obj.Total === "number")
-                obj.Total = obj.Total;
-            return obj;
-        }
-        if (Array.isArray(obj.items)) {
-            obj.items = [];
-            if (typeof obj.total === "number")
-                obj.total = obj.total;
-            return obj;
-        }
-        if (Array.isArray(obj.data)) {
-            obj.data = [];
-            return obj;
-        }
-    }
-    return previousData;
-}

package/dist/utils/prefetchManager.d.ts

@@ -1,111 +0,0 @@
-import type { QueryClient, QueryFunction, QueryKey } from "@tanstack/react-query";
-export interface PrefetchConfig {
-    priority?: "high" | "medium" | "low";
-    delay?: number;
-    staleTime?: number;
-    allowSlowNetwork?: boolean;
-}
-export interface PrefetchTask {
-    queryKey: QueryKey;
-    queryFn: QueryFunction<any>;
-    config: PrefetchConfig;
-    timestamp: number;
-    id: string;
-    predictionScore?: number;
-}
-export type NetworkSpeed = "slow" | "medium" | "fast" | "unknown";
-export interface PrefetchStats {
-    queueSize: number;
-    historySize: number;
-    networkSpeed: NetworkSpeed;
-    isProcessing: boolean;
-    totalPrefetches: number;
-    successfulPrefetches: number;
-    failedPrefetches: number;
-    averagePrefetchTime: number;
-    skippedPrefetches: number;
-}
-export interface InteractionRecord {
-    queryKey: QueryKey;
-    timestamp: number;
-    type: "view" | "hover" | "click" | "focus";
-}
-export interface PredictionResult {
-    queryKey: QueryKey;
-    score: number;
-    reason: string;
-}
-export declare class SmartPrefetchManager {
-    private queryClient;
-    private prefetchQueue;
-    private prefetchHistory;
-    private networkSpeed;
-    private isProcessing;
-    private maxQueueSize;
-    private maxHistorySize;
-    private totalPrefetches;
-    private successfulPrefetches;
-    private failedPrefetches;
-    private skippedPrefetches;
-    private prefetchTimes;
-    private maxPrefetchTimesSize;
-    private interactionHistory;
-    private maxInteractionHistorySize;
-    private queryAccessCounts;
-    private querySequences;
-    private maxSequenceSize;
-    private networkCleanup?;
-    constructor(queryClient: QueryClient);
-    private initNetworkMonitoring;
-    private updateNetworkSpeed;
-    getNetworkSpeed(): NetworkSpeed;
-    isSlowNetwork(): boolean;
-    shouldPrefetch(queryKey: QueryKey, config?: PrefetchConfig): boolean;
-    addPrefetchTask(queryKey: QueryKey, queryFn: QueryFunction<any>, config?: PrefetchConfig): boolean;
-    private processQueue;
-    private getSortedTasks;
-    prefetchNow<TData = unknown>(queryKey: QueryKey, queryFn: QueryFunction<TData>, config?: PrefetchConfig): Promise<void>;
-    private addToHistory;
-    clearHistory(): void;
-    clearQueue(): void;
-    reset(): void;
-    destroy(): void;
-    recordInteraction(queryKey: QueryKey, type?: "view" | "hover" | "click" | "focus"): void;
-    getPredictions(currentQueryKey?: QueryKey, limit?: number): PredictionResult[];
-    prefetchPredicted(currentQueryKey: QueryKey | undefined, queryFnMap: Map<string, QueryFunction<any>>, config?: PrefetchConfig): Promise<void>;
-    clearInteractionHistory(): void;
-    private recordPrefetchTime;
-    private getAveragePrefetchTime;
-    getStats(): PrefetchStats;
-    getPerformanceReport(): {
-        stats: PrefetchStats;
-        successRate: number;
-        predictions: {
-            totalInteractions: number;
-            uniqueQueries: number;
-            sequencePatterns: number;
-        };
-        queue: {
-            size: number;
-            byPriority: {
-                high: number;
-                medium: number;
-                low: number;
-            };
-        };
-    };
-    resetStats(): void;
-    private getQueryKeyString;
-    private delay;
-    setMaxQueueSize(size: number): void;
-    setMaxHistorySize(size: number): void;
-    getQueuedTasks(): PrefetchTask[];
-    removeTask(queryKey: QueryKey): boolean;
-    hasTask(queryKey: QueryKey): boolean;
-    updateTaskPriority(queryKey: QueryKey, priority: "high" | "medium" | "low"): boolean;
-    pauseQueue(): void;
-    resumeQueue(): void;
-}
-export declare function getPrefetchManager(queryClient: QueryClient): SmartPrefetchManager;
-export declare function resetPrefetchManager(): void;
-//# sourceMappingURL=prefetchManager.d.ts.map