import type { WritebackReceipt } from '@relayfile/adapter-core/vfs-client';
import { type ProviderClient } from './provider-client.js';
import type { RelayClientOptions } from './transport.js';
export type TelegramChatId = string | number;
export type TelegramMessageId = string | number;
export type TelegramParseMode = 'Markdown' | 'MarkdownV2' | 'HTML';
export interface TelegramSendMessageOptions {
    replyToMessageId?: TelegramMessageId;
    threadId?: TelegramMessageId;
    parseMode?: TelegramParseMode;
    disableWebPagePreview?: boolean;
    disableNotification?: boolean;
    replyMarkup?: Record<string, unknown>;
    businessConnectionId?: string;
}
export interface TelegramEditMessageOptions {
    parseMode?: TelegramParseMode;
    disableWebPagePreview?: boolean;
    replyMarkup?: Record<string, unknown>;
    businessConnectionId?: string;
}
export interface TelegramMessageResult {
    ok: boolean;
    chatId: TelegramChatId;
    messageId: string;
    ref: string;
}
export interface TelegramReactionResult {
    ok: boolean;
    chatId: TelegramChatId;
    messageId: string;
}
/**
 * The delivered Telegram message id off a writeback receipt.
 *
 * Kept as `telegramReceiptTs` to mirror `slackReceiptTs` for callers moving
 * between Slack and Telegram helpers.
 */
export declare function telegramReceiptTs(receipt: (WritebackReceipt & {
    ok?: unknown;
    messageId?: unknown;
    message_id?: unknown;
}) | undefined): string;
export declare const telegramReceiptMessageId: typeof telegramReceiptTs;
export interface TelegramClient extends ProviderClient<'telegram'> {
    /** Send a message to a chat. */
    sendMessage(chatId: TelegramChatId, text: string, opts?: TelegramSendMessageOptions): Promise<TelegramMessageResult>;
    /** Edit a delivered message. */
    editMessage(chatId: TelegramChatId, messageId: TelegramMessageId, text: string, opts?: TelegramEditMessageOptions): Promise<TelegramMessageResult>;
    /** Set an emoji reaction on a message. */
    react(chatId: TelegramChatId, messageId: TelegramMessageId, emoji: string): Promise<TelegramReactionResult>;
}
/**
 * Ergonomic Telegram client over the writeback-path catalog, plus the uniform
 * resource-keyed access (`.messages`, `.reactions`, `.callback-queries`, ...).
 */
export declare function telegramClient(opts?: RelayClientOptions): TelegramClient;
//# sourceMappingURL=telegram.d.ts.map