namespace ChatBot.Services.Telegram.Commands
{
    /// <summary>
    /// Интерфейс для обработки команд Telegram
    /// </summary>
    public interface ITelegramCommandProcessor
    {
        /// <summary>
        /// Обрабатывает входящее сообщение и возвращает ответ
        /// </summary>
        /// <param name="messageText">Текст сообщения</param>
        /// <param name="chatId">ID чата</param>
        /// <param name="username">Имя пользователя</param>
        /// <param name="chatType">Тип чата</param>
        /// <param name="chatTitle">Название чата</param>
        /// <param name="cancellationToken">Токен отмены</param>
        /// <returns>Ответ на сообщение или пустую строку</returns>
        Task<string> ProcessMessageAsync(
            string messageText,
            long chatId,
            string username,
            string chatType,
            string chatTitle,
            CancellationToken cancellationToken = default
        );
    }
}