using DigitalData.MessagingService.Abstraction;
using DigitalData.MessagingService.Application.Common.Models.MailSearch;

namespace DigitalData.MessagingService.Application.Common.Interfaces;

/// <summary>
/// Service interface for reading emails via IMAP.
/// </summary>
public interface IImapEmailService
{
    /// <summary>
    /// Fetches emails from the specified mailbox folder.
    /// </summary>
    /// <param name="account">Account whose IMAP settings will be used.</param>
    /// <param name="filter">Filter to apply when fetching emails.</param>
    /// When <see langword="true"/> (default), fetched messages are marked as <c>\Seen</c> on the server.
    /// Set to <see langword="false"/> for a non-destructive read (uses <c>BODY.PEEK</c> internally).
    /// </param>
    /// <param name="cancellationToken">Cancellation token.</param>
    Task<IEnumerable<ReceivedEmailDto>> FetchEmailsAsync(
        EmailAccountDto account,
        MailSearchFilter filter,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// Marks a message as seen (read) on the server.
    /// </summary>
    Task MarkAsSeenAsync(
        EmailAccountDto account,
        long uid,
        string folder = "INBOX",
        CancellationToken cancellationToken = default);
}