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

namespace FrameworkSL.Hubs.JobEngine
{
    // ============================================================
    // IJobEngineClient — strongly-typed client contract for JobEngineHub.
    // Mirrors FrameworkSL/Hubs/GOP/IGopExecutionClient.cs.
    // ============================================================
    public interface IJobEngineClient
    {
        /// <summary>Fired right after a Quartz-triggered job is marked InProgress.</summary>
        Task ReceiveJobStarted(JobStartedDTO status);

        /// <summary>Fired once the job's actions are published to Scheduler.Ready — not yet complete, just handed off.</summary>
        Task ReceiveJobDispatched(JobDispatchedDTO status);

        /// <summary>Fired once every fanned-out action for a job execution has succeeded.</summary>
        Task ReceiveJobCompleted(JobCompletedDTO status);

        /// <summary>Fired when a fanned-out action for a job execution fails.</summary>
        Task ReceiveJobFailed(JobFailedDTO status);
    }
}