namespace PlaylistShared.Pwa.Services;

/// <summary>
/// Глобальный сервис управления аудиоплеером.
/// Позволяет управлять воспроизведением из любого компонента.
/// </summary>
public interface IAudioPlayerService
{
    #region Состояние плеера (для чтения)
    /// <summary>ID текущего воспроизводимого трека (null, если ничего не играет).</summary>
    string? CurrentTrackId { get; }

    /// <summary>Играет ли в данный момент (true) или приостановлен (false).</summary>
    bool IsPlaying { get; }

    /// <summary>Текущая громкость (0–100).</summary>
    double CurrentVolume { get; set; }

    /// <summary>Прогресс воспроизведения в процентах (0–100).</summary>
    double CurrentProgress { get; }

    /// <summary>Отформатированное текущее время (мм:сс).</summary>
    string CurrentTime { get; }

    /// <summary>Отформатированная общая длительность (мм:сс).</summary>
    string TotalTime { get; }

    /// <summary>Отформатированное название текущего трека.</summary>
    string? CurrentTrackTitle { get; }

    /// <summary>URL обложки текущего трека.</summary>
    string? CurrentTrackCoverUrl { get; }
    #endregion

    #region Команды управления (вызываются из компонентов)
    /// <summary>Загрузить и начать воспроизведение трека.</summary>
    /// <param name="trackId">ID трека.</param>
    /// <param name="accessToken">Опциональный access-токен (если не указан, будет взят из хранилища).</param>
    /// <param name="sharedPlaylistId">ID расшаренного плейлиста (для неавторизованного доступа).</param>
    /// <param name="title">Название трека. (Если не передано, вызывает api для получения)</param>
    /// <param name="coverUrl">URL обложки трека. (Если не передано, вызывает api для получения)</param>
    Task LoadAndPlayAsync(string trackId, string? accessToken = null, string? sharedPlaylistId = null, string? title = null, string? coverUrl = null);

    /// <summary>Воспроизвести (если трек загружен и на паузе).</summary>
    Task PlayAsync();

    /// <summary>Поставить на паузу.</summary>
    Task PauseAsync();

    /// <summary>Остановить воспроизведение и выгрузить трек.</summary>
    Task StopAsync();

    /// <summary>Перемотать на указанный процент (0–100).</summary>
    Task SeekToAsync(double percent);

    /// <summary>Установить громкость (0–100).</summary>
    Task SetVolumeAsync(double volume);
    #endregion

    #region События для подписки на изменения состояния
    /// <summary>
    /// Событие, возникающее при любом изменении состояния плеера:
    /// смена трека, старт/пауза/стоп, обновление прогресса, изменение громкости, окончание трека.
    /// Подписывайтесь на него, чтобы перерисовывать UI (например, иконку "пауза/плей").
    /// </summary>
    event Action? OnStateChanged;
    #endregion

    #region События для связи с реальным компонентом AudioPlayer (Эти события вызываются сервисом)
    /// <summary>Запрос на загрузку и воспроизведение трека.</summary>
    event Func<string, string?, string?, Task>? OnLoadAndPlayRequested;

    /// <summary>Запрос на воспроизведение (снять с паузы).</summary>
    event Func<Task>? OnPlayRequested;

    /// <summary>Запрос на паузу.</summary>
    event Func<Task>? OnPauseRequested;

    /// <summary>Запрос на остановку и выгрузку трека.</summary>
    event Func<Task>? OnStopRequested;

    /// <summary>Запрос на перемотку (процент 0–100).</summary>
    event Func<double, Task>? OnSeekRequested;

    /// <summary>Запрос на изменение громкости (0–100).</summary>
    event Func<double, Task>? OnVolumeChangeRequested;
    #endregion

    #region Методы для обновления состояния из AudioPlayer (Вызываются компонентом AudioPlayer, когда реальный аудиоэлемент меняет своё состояние.)
    /// <summary>Уведомить сервис о том, что трек начал или прекратил играть.</summary>
    void SetPlayingState(bool isPlaying);

    /// <summary>Установить ID текущего трека.</summary>
    void SetCurrentTrack(string? trackId);

    /// <summary>Обновить прогресс и отображаемое время.</summary>
    void UpdateProgress(double progress, string currentTime, string totalTime);

    /// <summary>Уведомить об окончании трека.</summary>
    void NotifyTrackEnded();
    #endregion
}