using Cleanuparr.Domain.Enums;

namespace Cleanuparr.Infrastructure.Stats;

/// <summary>
/// Service for aggregating application statistics
/// </summary>
public interface IStatsService
{
    /// <summary>
    /// Gets aggregated statistics for the given timeframe. Every section except health is scoped to the timeframe and,
    /// by default, excludes dry-run activity.
    /// </summary>
    /// <param name="hours">Timeframe in hours</param>
    /// <param name="includeDryRun">When true, dry-run events are included in the timeframe-scoped sections</param>
    Task<StatsV2Response> GetStatsV2Async(int hours, bool includeDryRun = false);

    /// <summary>
    /// Gets a bucketed timeline for a single metric over the given timeframe.
    /// </summary>
    /// <param name="metric">strikesIssued | recovered | removed | malwareBlocked | events</param>
    /// <param name="hours">Timeframe in hours</param>
    /// <param name="bucket">Bucket size; when null, defaults to hourly for timeframes up to 24h, daily otherwise</param>
    /// <param name="includeDryRun">When true, dry-run events are included</param>
    Task<List<TimelineBucketDto>> GetTimelineAsync(string metric, int hours, TimelineBucketSize? bucket = null, bool includeDryRun = false);
}