import { AxiosInstance, InternalAxiosRequestConfig } from 'axios';
export type ServerErrorHandling = 'toast' | 'none';
export type CreateApiClientOptions = {
    baseURL: string;
    attachJwt?: boolean;
    /** How to surface 5xx responses. Defaults to 'toast'. */
    serverErrorHandling?: ServerErrorHandling;
    augmentRequest?: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig;
};
/**
 * Shared API client: JWT attachment + global 5xx dispatchError toast.
 * Handled 5xx responses resolve (they do not reach .catch()).
 * 4xx are left to front-end callers unless the app opts in via
 * applyAuthErrorHandling() in its local api.ts wrapper.
 */
export declare function createApiClient(options: CreateApiClientOptions): AxiosInstance;