using Marathon.Domain.Entities;

namespace Marathon.Application.Abstractions;

/// <summary>
/// Repository for <see cref="Anomaly"/> domain entities.
/// </summary>
public interface IAnomalyRepository : IRepository<Guid, Anomaly>
{
    /// <summary>
    /// Server-side count of anomalies detected strictly after <paramref name="since"/>.
    /// Backs the unread badge without materialising the table.
    /// </summary>
    Task<int> CountSinceAsync(DateTimeOffset since, CancellationToken ct = default);

    /// <summary>
    /// Anomalies whose <see cref="Anomaly.DetectedAt"/> falls in the inclusive
    /// [<paramref name="from"/>..<paramref name="to"/>] window (either bound may be
    /// null for open-ended), ordered newest-first. Pushes the temporal filter to SQL;
    /// severity / sport filtering remains a service concern (needs the event join).
    /// </summary>
    Task<IReadOnlyList<Anomaly>> ListByDateRangeAsync(
        DateTimeOffset? from,
        DateTimeOffset? to,
        CancellationToken ct = default);
}