/**
 * Mutation options factory for TanStack Query integration.
 * Creates type-safe mutation options from Eden route definitions.
 */
import type { MutationFunction, UseMutationOptions } from "@tanstack/react-query";
import type { EdenMutationKey } from "../keys/types";
import type { EmptyToVoid } from "../utils/types";
/** Reserved options that are set by the library */
type ReservedOptions = "mutationKey" | "mutationFn";
/** Base options for Eden requests */
interface EdenMutationBaseOptions {
    eden?: {
        /** Custom context for the mutation */
        context?: Record<string, unknown>;
    };
}
/** Result metadata added to mutation options */
export interface EdenMutationOptionsResult {
    eden: {
        path: string;
    };
}
/**
 * Input options for creating mutation options.
 * Omits reserved options that are set by the library.
 */
export type EdenMutationOptionsIn<TOutput, TError, TInput, TContext> = Omit<UseMutationOptions<TOutput, TError, TInput, TContext>, ReservedOptions> & EdenMutationBaseOptions;
/**
 * Output options returned by edenMutationOptions.
 * Includes the mutation key and eden metadata.
 * mutationFn is guaranteed to be defined.
 * Uses EmptyToVoid<TInput> so mutate() can be called without args when input is empty.
 */
export interface EdenMutationOptionsOut<TOutput, TError, TInput, TContext> extends UseMutationOptions<TOutput, TError, EmptyToVoid<TInput>, TContext>, EdenMutationOptionsResult {
    mutationKey: EdenMutationKey;
    mutationFn: MutationFunction<TOutput, EmptyToVoid<TInput>>;
}
/**
 * Arguments for creating mutation options.
 */
export interface EdenMutationOptionsArgs<TInput, TOutput, TError, TContext> {
    /** Path segments (e.g., ['api', 'users', 'post']) */
    path: string[];
    /** Function to perform the mutation */
    mutate: (input: TInput) => Promise<TOutput>;
    /** Optional mutation options */
    opts?: EdenMutationOptionsIn<TOutput, TError, TInput, TContext>;
}
/**
 * Creates TanStack Query mutation options for an Eden route.
 *
 * @example
 * ```typescript
 * const options = edenMutationOptions({
 *   path: ['api', 'users', 'post'],
 *   mutate: async (input) => {
 *     const response = await edenClient.api.users.post(input)
 *     return response.data
 *   },
 *   opts: {
 *     onMutate: (variables) => {
 *       // Called before mutation
 *       return { previousData: [...] } // context
 *     },
 *     onSuccess: (data, variables, context) => {
 *       // Called on success
 *     },
 *     onError: (error, variables, context) => {
 *       // Rollback using context
 *     },
 *     onSettled: (data, error, variables, context) => {
 *       // Always called
 *       queryClient.invalidateQueries({ queryKey: ['users'] })
 *     },
 *   },
 * })
 *
 * // Use with useMutation
 * const mutation = useMutation(options)
 * mutation.mutate({ name: 'John' })
 * ```
 */
export declare function edenMutationOptions<TInput, TOutput, TError = Error, TContext = unknown>(args: EdenMutationOptionsArgs<TInput, TOutput, TError, TContext>): EdenMutationOptionsOut<TOutput, TError, TInput, TContext>;
export {};
//# sourceMappingURL=mutationOptions.d.ts.map