import { QueryMeta, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
import { AxiosError } from 'axios';
/**
 * Extended query meta that includes API-specific options
 */
export interface ApiQueryMeta extends QueryMeta {
    /** Whether to handle global errors for this query. Defaults to true. */
    handleGlobalError?: boolean;
}
/**
 * Represents query parameters for an API call
 * @template TParams - Type of the request parameters
 */
interface QueryParams<TParams> {
    /** The actual parameters to be passed to the query function */
    params: TParams;
    meta?: ApiQueryMeta;
}
/**
 * Helper type to check if all properties in a type are optional
 */
type AllOptional<T> = T extends Record<string, unknown> ? ({} extends Pick<T, keyof T> ? true : false) : false;
/**
 * Configuration options for creating an API query hook
 * @template TResponse - Type of the API response
 * @template TParams - Type of the request parameters (use void for parameterless queries)
 */
interface CreateApiQueryOptions<TResponse, TParams = void> {
    /**
     * Query key generator
     * - For parameterless queries: provide a static string array
     * - For parameterized queries: provide a function that generates the key from params
     */
    queryKey: TParams extends void ? string[] : (params: TParams) => string[];
    /**
     * API function to call
     * - For parameterless queries: provide a function with no parameters
     * - For parameterized queries: provide a function that takes the params
     */
    queryFn: TParams extends void ? () => Promise<TResponse> : (params: TParams) => Promise<TResponse>;
    /**
     * Default query options to be merged with user-provided options
     * @optional
     */
    defaultOptions?: Omit<UseQueryOptions<TResponse, AxiosError>, 'queryKey' | 'queryFn'>;
}
/**
 * Creates a strongly-typed query hook with consistent parameter and options handling
 *
 * @example Parameterless query:
 * ```ts
 * const useGetProfileQuery = createApiQuery<Profile>({
 *   queryKey: ['profile'],
 *   queryFn: () => api.getProfile(),
 *   defaultOptions: { staleTime: 5000 }
 * });
 *
 * // Usage
 * const { data } = useGetProfileQuery();
 * const { data } = useGetProfileQuery({ enabled: false });
 * ```
 *
 * @example Parameterized query:
 * ```ts
 * const useGetUserQuery = createApiQuery<User, { userId: string }>({
 *   queryKey: (params) => ['user', params.userId],
 *   queryFn: (params) => api.getUser(params.userId)
 * });
 *
 * // Usage
 * const { data } = useGetUserQuery({
 *   params: { userId: '123' }
 * });
 * ```
 */
export declare function createApiQuery<TResponse, TParams = void>({ queryKey, queryFn, defaultOptions, }: CreateApiQueryOptions<TResponse, TParams>): {
    (options?: Omit<UseQueryOptions<TResponse, AxiosError, TResponse>, "queryKey" | "queryFn"> & {
        meta?: ApiQueryMeta;
    }): TParams extends void ? Omit<UseQueryResult<TResponse, AxiosError>, "data"> & {
        data: TResponse;
    } : AllOptional<TParams> extends true ? Omit<UseQueryResult<TResponse, AxiosError>, "data"> & {
        data: TResponse;
    } : never;
    (request: QueryParams<TParams>, options?: Omit<UseQueryOptions<TResponse, AxiosError, TResponse>, "queryKey" | "queryFn"> & {
        meta?: ApiQueryMeta;
    }): Omit<UseQueryResult<TResponse, AxiosError>, "data"> & {
        data: TResponse;
    };
};
export {};