import type { Logger } from "pino";
export interface HttpRequestOptions {
    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
    headers?: Record<string, string>;
    body?: unknown;
    timeout?: number;
    /**
     * Number of retry attempts for transient failures (network errors, 5xx responses).
     * Retries use exponential backoff starting at 500ms.
     * @default 0
     */
    retries?: number;
}
export interface HttpResponse<T = unknown> {
    status: number;
    ok: boolean;
    headers: Headers;
    data: T;
}
export declare class HttpClient {
    private readonly logger;
    constructor(logger: Logger);
    /**
     * Make an HTTP request. Uses Bun's native fetch under the hood.
     *
     * @param url The URL to request
     * @param options Request options (method, headers, body, timeout, retries)
     * @returns Typed response with parsed JSON body
     */
    request<T = unknown>(url: string, options?: HttpRequestOptions): Promise<HttpResponse<T>>;
    /**
     * Parse a delivered response body. Handles JSON, text, and empty
     * (`204`/no content) responses. On a JSON parse failure, throws a descriptive
     * error including the status and sanitized URL — this is a terminal error and
     * must NOT trigger a retry.
     */
    private parseBody;
    /** Convenience: GET request */
    get<T = unknown>(url: string, headers?: Record<string, string>): Promise<HttpResponse<T>>;
    /** Convenience: POST request */
    post<T = unknown>(url: string, body: unknown, headers?: Record<string, string>): Promise<HttpResponse<T>>;
    /** Convenience: PUT request */
    put<T = unknown>(url: string, body: unknown, headers?: Record<string, string>): Promise<HttpResponse<T>>;
    /** Convenience: PATCH request */
    patch<T = unknown>(url: string, body: unknown, headers?: Record<string, string>): Promise<HttpResponse<T>>;
    /** Convenience: DELETE request */
    del<T = unknown>(url: string, headers?: Record<string, string>): Promise<HttpResponse<T>>;
}
//# sourceMappingURL=http-client.d.ts.map