using Marathon.Application.Storage;

namespace Marathon.Application.Abstractions;

/// <summary>
/// Exports odds snapshots to an Excel file matching the customer's wide-column specification.
/// </summary>
public interface IExcelExporter
{
    /// <summary>
    /// Exports snapshots for the given date range to an XLSX file.
    /// </summary>
    /// <param name="range">The inclusive date range to export.</param>
    /// <param name="kind">Which snapshots to include: pre-match, live, or combined.</param>
    /// <param name="outputPath">
    /// Directory where the file will be written. The filename is auto-generated as
    /// <c>Marathon_yyyy-MM-dd_to_yyyy-MM-dd.xlsx</c>.
    /// </param>
    /// <param name="ct">Cancellation token.</param>
    /// <returns>The full path of the created file.</returns>
    Task<string> ExportAsync(DateRange range, ExportKind kind, string outputPath, CancellationToken ct = default);
}