import { InvalidateQueryFilters, QueryKey, QueryState } from '@tanstack/react-query';
/**
 * Prefetch query options
 */
export interface PrefetchOptions {
    staleTime?: number;
    force?: boolean;
}
/**
 * Hook to prefetch queries on demand
 */
export declare function usePrefetch(): {
    prefetch: <T>(queryKey: QueryKey, queryFn: () => Promise<T>, options?: PrefetchOptions) => Promise<void>;
};
/**
 * Hook to invalidate queries by pattern
 */
export declare function useInvalidateQueries(): {
    invalidate: (filters: InvalidateQueryFilters) => Promise<void>;
    invalidateAll: () => Promise<void>;
    invalidateByKey: (queryKey: QueryKey) => Promise<void>;
};
/**
 * Hook to get query state information
 */
export declare function useQueryState<T>(queryKey: QueryKey): {
    state: QueryState<T, Error> | undefined;
    data: T | undefined;
    isLoading: boolean;
    isError: boolean;
    isSuccess: boolean;
    isPending: boolean;
};
/**
 * Hook to manage optimistic updates
 */
export declare function useOptimisticUpdate<T>(): {
    update: <R>(queryKey: QueryKey, updateFn: (old: T | undefined) => T, mutationFn: () => Promise<R>, options?: {
        onError?: (error: Error, previousData: T | undefined) => void;
        onSuccess?: (result: R) => void;
    }) => Promise<R>;
};
/**
 * Merge paginated data helper
 */
export declare function mergePaginatedData<T extends {
    id: string;
}>(existing: T[] | undefined, incoming: T[]): T[];
/**
 * Infinite query page merger
 */
export declare function mergeInfinitePages<T>(pages: T[][], newPage: T[], pageIndex: number): T[][];
/**
 * Query retry delay calculator (exponential backoff)
 */
export declare function calculateRetryDelay(attemptIndex: number): number;
/**
 * Check if query data is stale
 */
export declare function isQueryStale(state: QueryState<unknown, Error> | undefined, staleTime: number): boolean;
/**
 * Create a typed query key factory
 */
export declare function createQueryKeyFactory<T extends Record<string, unknown>>(scope: string): {
    all: readonly [string];
    lists: () => readonly [string, 'list'];
    list: (filters?: T) => readonly [string, 'list', T | undefined];
    details: () => readonly [string, 'detail'];
    detail: (id: string) => readonly [string, 'detail', string];
};
/**
 * Batch query updates for performance
 */
export declare function useBatchQueryUpdates(): {
    batchUpdate: (updates: Array<{
        queryKey: QueryKey;
        data: unknown;
    }>) => void;
};