namespace BotPages.Core
{
    /// <summary>
    /// Сервис работы с файлами: загрузка и отправка пакетами.
    /// </summary>
    public interface IFileService
    {
        /// <summary>
        /// Загружает файл по идентификатору транспорта.
        /// </summary>
        Task<FileDescriptor> DownloadAsync(string fileId, CancellationToken ct);

        /// <summary>
        /// Загружает несколько файлов по их идентификаторам.
        /// </summary>
        Task<IReadOnlyList<FileDescriptor>> DownloadManyAsync(IEnumerable<string> fileIds, CancellationToken ct);

        /// <summary>
        /// Отправляет один файл в чат.
        /// </summary>
        Task SendAsync(IChatClient client, long chatId, FileDescriptor file, CancellationToken ct);

        /// <summary>
        /// Отправляет несколько файлов в чат.
        /// </summary>
        Task SendManyAsync(IChatClient client, long chatId, IEnumerable<FileDescriptor> files, CancellationToken ct);
    }
}