using System.Threading;
using System.Threading.Tasks;

namespace HC_APTBS.Services
{
    /// <summary>
    /// Handles DFI (injection timing offset) calibration read/write operations
    /// on the VP44 pump ECU over the K-Line / KWP2000 protocol.
    /// </summary>
    public interface ICalibrationService
    {
        // ── DFI ───────────────────────────────────────────────────────────────────

        /// <summary>
        /// Reads the current DFI calibration value stored in ECU EEPROM.
        /// </summary>
        /// <param name="ct">Cancellation token.</param>
        /// <returns>DFI offset in degrees.</returns>
        Task<double> ReadDfiAsync(CancellationToken ct = default);

        /// <summary>
        /// Writes a new DFI calibration value to ECU EEPROM and verifies the write
        /// by reading the value back.
        /// </summary>
        /// <param name="dfiDegrees">Target DFI value in degrees (clamped to ±1.45°).</param>
        /// <param name="ct">Cancellation token.</param>
        /// <returns>Verified DFI value read back after the write.</returns>
        Task<double> WriteDfiAsync(double dfiDegrees, CancellationToken ct = default);

        /// <summary>
        /// Writes DFI and then triggers a pump power cycle to activate the new calibration.
        /// Returns the DFI value verified after the restart.
        /// </summary>
        Task<double> WriteDfiAndRestartAsync(double dfiDegrees, CancellationToken ct = default);
    }
}