namespace FrameworkBLL.SystemJob
{
    /// <summary>
    /// Strongly-typed contract for server-to-client SysJob SignalR push messages.
    /// Defined in FrameworkBLL so both FrameworkBLL (SysJobShareBLL) and
    /// FrameworkSL (SysJobHub) can reference it without a circular dependency.
    /// </summary>
    public interface ISysJobClient
    {
        /// <summary>Job has been claimed and execution started.</summary>
        Task JobStarted(int sysJobId, int sysJobRunId, string worker, DateTime startedAt);

        /// <summary>Job completed successfully.</summary>
        Task JobCompleted(int sysJobId, int sysJobRunId, string? resultLocation, DateTime endedAt);

        /// <summary>Job failed and will be retried.</summary>
        Task JobRetrying(int sysJobId, int sysJobRunId, int retryCount, int maxRetries, string error, DateTime endedAt);

        /// <summary>Job has permanently failed (retry limit reached).</summary>
        Task JobFailed(int sysJobId, int sysJobRunId, string error, DateTime endedAt);

        /// <summary>Job was cancelled by a user before or during execution.</summary>
        Task JobCancelled(int sysJobId, DateTime cancelledAt);

        /// <summary>A job has been shared with the connected user.</summary>
        Task JobShared(int sysJobId, string sharedByName);

        /// <summary>Progress update for a running job (0–100).</summary>
        Task JobProgress(int sysJobId, int progressPct, string progressMessage);
    }
}