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

namespace FrameworkSL.Hubs.GOP
{
    // ============================================================
    // IGopExecutionClient — strongly-typed client contract for
    // the GopExecutionHub.
    //
    // Used as the type parameter in Hub<IGopExecutionClient> to
    // give compile-time verification of every client-side method
    // and its parameter types.
    //
    // DTOs are defined in GB5Shared so both FrameworkBLL (pipeline)
    // and FrameworkSL (hub) can reference them without circular deps.
    // ============================================================
    public interface IGopExecutionClient
    {
        /// <summary>
        /// Fired after each step completes (or fails) so the UI can
        /// update the execution status panel in real-time without polling.
        /// </summary>
        Task ReceiveExecutionUpdate(GopExecutionStatusDTO status);

        /// <summary>
        /// Fired when a new dead-letter item is created for this tenant.
        /// Allows the DLQ monitor panel to refresh its badge/count.
        /// </summary>
        Task ReceiveDLQUpdate(GopDLQSummaryDTO summary);
    }
}