using System;
using System.Threading;
using System.Threading.Tasks;
using HC_APTBS.Models;

namespace HC_APTBS.Services
{
    /// <summary>
    /// Manages the immobilizer unlock sequence required by certain pump ECUs
    /// (e.g. Ford VP44 models) before they respond to test commands.
    /// </summary>
    public interface IUnlockService
    {
        /// <summary>Raised with progress text during the unlock sequence.</summary>
        event Action<string>? StatusChanged;

        /// <summary>Raised when the unlock sequence completes. Argument is true if successful.</summary>
        event Action<bool>? UnlockCompleted;

        /// <summary>
        /// Runs the immobilizer unlock sequence for the given pump.
        /// Returns immediately if <see cref="PumpDefinition.UnlockType"/> is 0 (no unlock needed).
        /// The persistent CAN senders remain active after this method returns;
        /// call <see cref="StopSenders"/> when the pump is deselected.
        /// </summary>
        /// <param name="pump">Pump definition with unlock type and CAN parameters.</param>
        /// <param name="ct">Cancellation token to abort the unlock sequence.</param>
        Task UnlockAsync(PumpDefinition pump, CancellationToken ct);

        /// <summary>
        /// Stops the persistent CAN unlock senders. Call this when the pump is
        /// deselected or the application is shutting down. Safe to call when no
        /// senders are active.
        /// </summary>
        void StopSenders();
    }
}