SharepointToolbox-Web/Services/Reports/IScheduledReportRunner.cs

using SharepointToolbox.Web.Core.Models;

namespace SharepointToolbox.Web.Services.Reports;

public interface IScheduledReportRunner
{
    /// <summary>
    /// Generates one report for the given schedule using app-only auth, writes the
    /// file under the client's exports subfolder, records it in the report index, and
    /// audit-logs the run. Never throws for report-level failures — a failed run is
    /// captured as a <see cref="GeneratedReport"/> with <see cref="ReportRunStatus.Failed"/>.
    /// </summary>
    Task<GeneratedReport> RunAsync(ScheduledReport schedule, CancellationToken ct = default);
}