import { VroomError } from '../errors/vroom.error';
/**
 * API error response from Vroom backend
 */
export interface ApiErrorResponse {
    code: string;
    message: string;
}
/**
 * Error context passed to custom error handlers
 */
export interface ErrorContext {
    response: Response;
    code: string;
    message: string;
}
/**
 * Custom error handler for endpoint-specific errors.
 * Return a VroomError to throw it, or null to fallback to common error handling.
 */
export type CustomErrorHandler = (ctx: ErrorContext) => VroomError | null;
/**
 * Base request options shared by request and requestVoid
 */
export interface BaseRequestOptions<TBody = unknown> {
    /** HTTP method */
    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
    /** Full URL to request */
    url: string;
    /** Request body (will be JSON stringified) */
    body?: TBody;
    /** Additional headers to include in the request */
    headers?: Record<string, string>;
    /** Custom error handler for endpoint-specific errors */
    customErrorHandler?: CustomErrorHandler;
}
/**
 * Request options for endpoints that return JSON data
 */
export interface RequestOptions<TBody = unknown> extends BaseRequestOptions<TBody> {
    /** Error message for NetworkError when fetch fails */
    errorMessage: string;
}
/**
 * Request options for endpoints that return no content (204, etc.)
 */
export interface RequestVoidOptions<TBody = unknown> extends BaseRequestOptions<TBody> {
    /** Error message for NetworkError when fetch fails (optional for void requests) */
    errorMessage?: string;
}
/**
 * Handle API error response with optional custom handler.
 *
 * Flow:
 * 1. Try custom handler first (for endpoint-specific errors)
 * 2. Handle common errors (BadRequest, PermissionDenied)
 * 3. HTTP status fallback (403, 5xx)
 * 4. Default to NetworkError
 *
 * @param response - Fetch response object
 * @param customHandler - Optional custom error handler
 */
export declare function handleApiError(response: Response, customHandler?: CustomErrorHandler): Promise<never>;
/**
 * Make an HTTP request to the Vroom API that returns JSON data.
 *
 * Use this for endpoints that return a response body.
 * For endpoints that return no content (204), use `requestVoid` instead.
 *
 * @param options - Request options
 * @returns Parsed JSON response
 * @throws NetworkError if response body is empty (unexpected)
 * @throws VroomError subclass based on error type
 */
export declare function request<TResponse, TBody = unknown>(options: RequestOptions<TBody>): Promise<TResponse>;
/**
 * Make an HTTP request to the Vroom API that returns no content.
 *
 * Use this for endpoints that return 204 No Content or empty body.
 * For endpoints that return JSON data, use `request` instead.
 *
 * @param options - Request options
 * @throws VroomError subclass based on error type
 */
export declare function requestVoid<TBody = unknown>(options: RequestVoidOptions<TBody>): Promise<void>;
//# sourceMappingURL=http.d.ts.map