/**
 * Transport-agnostic error type for failed Telegram Bot API calls.
 *
 * The streaming delivery logic ({@link import("./message-stream.js")}) and its
 * recovery policy (`classifyTelegramError`) depend only on this shape, never on
 * how the request was made. The grammY-backed client maps `GrammyError` /
 * `HttpError` onto it, so the delivery layer is unaware of the transport.
 */
export type TelegramApiErrorKind = "http" | "telegram" | "malformed" | "network" | "aborted";
export interface TelegramApiErrorDetails {
    kind: TelegramApiErrorKind;
    method: string;
    status?: number;
    errorCode?: number;
    telegramDescription?: string;
    /**
     * How long to wait before retrying, in milliseconds. Lifted from a Telegram
     * `parameters.retry_after` value (seconds) when present. Only the integer is
     * carried — never a raw response body — so bot tokens cannot leak.
     */
    retryAfterMs?: number;
    cause?: unknown;
}
export declare class TelegramApiError extends Error {
    readonly kind: TelegramApiErrorKind;
    readonly method: string;
    readonly status?: number;
    readonly errorCode?: number;
    readonly telegramDescription?: string;
    readonly retryAfterMs?: number;
    readonly cause?: unknown;
    constructor(message: string, details: TelegramApiErrorDetails);
}
//# sourceMappingURL=telegram-error.d.ts.map