import { QueryKey, UseMutationResult } from '@tanstack/react-query';
export type MessageResolver<TData, TError, TVariables> = string | ((ctx: {
    data?: TData;
    error?: TError;
    variables: TVariables;
}) => string | undefined);
export interface RealisticMutationOptions<TData, TError, TVariables, TCache> {
    /** Primary query key whose cache is optimistically mutated + later invalidated. */
    queryKey: QueryKey;
    /** The network call. */
    mutationFn: (variables: TVariables) => Promise<TData>;
    /** Transform the cached data into its optimistic shape. Called inside onMutate. */
    applyOptimistic?: (cache: TCache | undefined, variables: TVariables) => TCache | undefined;
    /** Additional query keys to invalidate in onSettled (e.g. related lists). */
    invalidateKeys?: ReadonlyArray<QueryKey>;
    /** Toast fired in onSettled on success. */
    onSuccessMessage?: MessageResolver<TData, TError, TVariables>;
    /** Toast fired in onError. Receives the raw error for contextual description. */
    onErrorMessage?: MessageResolver<TData, TError, TVariables>;
    /** Escape hatch: extra onSuccess behavior (e.g. navigate, focus, open a dialog). */
    onSuccess?: (data: TData, variables: TVariables) => void;
    /** Escape hatch: extra onError behavior (e.g. re-open a closed dialog). */
    onError?: (error: TError, variables: TVariables, snapshot: TCache | undefined) => void;
}
interface Context<TCache> {
    snapshot: TCache | undefined;
}
export declare function useRealisticMutation<TData = unknown, TError = Error, TVariables = void, TCache = unknown>(options: RealisticMutationOptions<TData, TError, TVariables, TCache>): UseMutationResult<TData, TError, TVariables, Context<TCache>>;
export {};
//# sourceMappingURL=useRealisticMutation.d.ts.map