using DigitalData.EmailProfiler.Domain.Entities;

namespace DigitalData.EmailProfiler.Application.Interfaces.Repositories;

/// <summary>
/// Repository interface for EmailHistory entity.
/// </summary>
public interface IEmailHistoryRepository : IRepository<EmailHistory>
{
    /// <summary>
    /// Get email history by message ID hash.
    /// </summary>
    Task<EmailHistory?> GetByMessageIdHashAsync(string messageIdHash, CancellationToken cancellationToken = default);

    /// <summary>
    /// Get email history with attachments.
    /// </summary>
    Task<EmailHistory?> GetWithAttachmentsAsync(int id, CancellationToken cancellationToken = default);

    /// <summary>
    /// Get email history by profile ID with pagination.
    /// </summary>
    Task<(IEnumerable<EmailHistory> Items, int TotalCount)> GetByProfileIdAsync(
        int profileId, 
        int pageNumber = 1, 
        int pageSize = 50, 
        CancellationToken cancellationToken = default);

    /// <summary>
    /// Get failed emails that need retry.
    /// </summary>
    Task<IEnumerable<EmailHistory>> GetFailedEmailsAsync(int? profileId = null, CancellationToken cancellationToken = default);

    /// <summary>
    /// Get emails processed within date range.
    /// </summary>
    Task<IEnumerable<EmailHistory>> GetByDateRangeAsync(
        DateTime startDate, 
        DateTime endDate, 
        int? profileId = null, 
        CancellationToken cancellationToken = default);

    /// <summary>
    /// Check if email with given message ID hash already exists.
    /// </summary>
    Task<bool> IsDuplicateAsync(string messageIdHash, CancellationToken cancellationToken = default);
}