import type { ApiErrorBody, ApiResponse, ApiResponseBody, ApiSuccessBody } from '../types/api';
/**
 * 创建成功的 API 响应
 * @param data 响应数据
 * @param status HTTP 状态码，默认 200
 */
export declare function successResponse<TData = unknown>(data: TData, status?: number): ApiResponse<ApiSuccessBody<TData>>;
/**
 * 创建错误的 API 响应
 * @param error 错误信息
 * @param status HTTP 状态码，默认 500
 */
export declare function errorResponse<TError = unknown>(error: TError, status?: number): ApiResponse<ApiErrorBody<TError | string>>;
/**
 * 处理 API Promise，自动包装成功和错误响应
 * @param promise API 请求 Promise
 * @param options 可选配置
 */
export declare function handleApi<T = unknown, TData = unknown>(promise: Promise<T>, options?: {
    /** 成功时的数据转换函数 */
    transformData?: (data: T) => TData;
    /** 自定义状态码 */
    customStatus?: number;
    /** 是否记录错误日志 */
    logError?: boolean;
}): Promise<ApiResponse<ApiSuccessBody<TData | T> | ApiErrorBody<string>>>;
/**
 * 创建自定义结构的响应
 * @param body 响应体
 * @param status HTTP 状态码
 */
export declare function customResponse<TBody extends ApiResponseBody = ApiResponseBody>(body: TBody, status?: number): ApiResponse<TBody>;
/**
 * 处理 400 错误响应（参数错误）
 * @param message 错误消息
 */
export declare function badRequest(message: string): ApiResponse<ApiSuccessBody<string>>;