using GB5Shared.DTO.JobEngine;
using System.Threading;
using System.Threading.Tasks;

namespace FrameworkBLL.SchedulerTaskGenerator
{
    // ============================================================
    // IJobEngineHubNotifier — abstraction over SignalR hub push for
    // Track A job execution status. Mirrors FrameworkBLL/GOP/IGopHubNotifier.
    //
    // The concrete implementation (JobEngineHubNotifier in FrameworkSL)
    // wraps IHubContext<JobEngineHub, IJobEngineClient>. This abstraction
    // keeps FrameworkBLL free of ASP.NET types.
    //
    // Registration (FrameworkSL Program.cs):
    //   services.AddSingleton<IJobEngineHubNotifier, JobEngineHubNotifier>();
    // ============================================================
    public interface IJobEngineHubNotifier
    {
        /// <summary>Pushed by the Quartz executor right after marking a job InProgress.</summary>
        Task PushJobStarted(int tenantId, JobStartedDTO status, CancellationToken ct = default);

        /// <summary>Pushed by the Quartz executor once the job's actions are published to Scheduler.Ready.</summary>
        Task PushJobDispatched(int tenantId, JobDispatchedDTO status, CancellationToken ct = default);

        /// <summary>Pushed by ActionProcessorWorker once every fanned-out action for a JobExecutionId reaches a terminal SUCCESS state.</summary>
        Task PushJobCompleted(int tenantId, JobCompletedDTO status, CancellationToken ct = default);

        /// <summary>Pushed by ActionProcessorWorker when a fanned-out action for a JobExecutionId fails.</summary>
        Task PushJobFailed(int tenantId, JobFailedDTO status, CancellationToken ct = default);
    }
}