using SameBeat.Application.DTO;
using SameBeat.Application.Komendy;

namespace SameBeat.Application.Interfejsy;

/// <summary>
/// Logika muzyki (ETAP 4) -- biblioteka utworow, playlista biezacego wydarzenia i "zegar" odtwarzania.
/// Muzyka NIE idzie przez LiveKit/SignalR jako dzwiek -- kazdy klient sam odtwarza plik spod Utwor.Url
/// i synchronizuje swoja pozycje do CzasStartuUtc/PozycjaStartowaMs zwracanych w StanMuzykiDto (to jak
/// radio internetowe). Metody sterujace (Odtworz/Wstrzymaj/Nastepny/Poprzedni/UstawGlosnosc) dzialaja
/// na biezacym wydarzeniu, tak samo jak ISerwisSceny.
/// </summary>
public interface ISerwisMuzyki
{
    /// <summary>Dodaje utwor do globalnej biblioteki. Waliduje tytul/url/czasTrwaniaMs przez WynikOperacji, nie wyjatek.</summary>
    Task<WynikOperacji<UtworDto>> DodajUtworAsync(DodajUtworKomenda komenda, CancellationToken token = default);

    /// <summary>Cala biblioteka utworow.</summary>
    Task<WynikOperacji<List<UtworDto>>> PobierzUtworyAsync(CancellationToken token = default);

    /// <summary>Dodaje utwor na koniec kolejki biezacego wydarzenia. Zwraca cala kolejke po zmianie.</summary>
    Task<WynikOperacji<List<PozycjaPlaylistyDto>>> DodajDoPlaylistyAsync(Guid utworId, CancellationToken token = default);

    /// <summary>Usuwa pozycje z kolejki. Zwraca cala kolejke po zmianie.</summary>
    Task<WynikOperacji<List<PozycjaPlaylistyDto>>> UsunZPlaylistyAsync(Guid pozycjaId, CancellationToken token = default);

    /// <summary>Aktualna kolejka biezacego wydarzenia, uporzadkowana, z info ktora pozycja jest aktualnie grana.</summary>
    Task<WynikOperacji<List<PozycjaPlaylistyDto>>> PobierzPlaylisteAsync(CancellationToken token = default);

    /// <summary>Biezacy stan zegara -- do wyswietlenia w panelu hosta po odswiezeniu strony i do GET /api/events/current.</summary>
    Task<WynikOperacji<StanMuzykiDto>> PobierzStanAsync(CancellationToken token = default);

    /// <summary>
    /// UtworId podany -- przelacza na ten utwor od 0ms. UtworId brak i muzyka Wstrzymana -- wznawia
    /// od zapisanej pozycji. UtworId brak i juz Odtwarzana -- no-op (sukces bez zmian).
    /// </summary>
    Task<WynikOperacji<StanMuzykiDto>> OdtworzAsync(Guid? utworId, CancellationToken token = default);

    /// <summary>Wstrzymuje zegar na aktualnie przeliczonej pozycji. Idempotentne.</summary>
    Task<WynikOperacji<StanMuzykiDto>> WstrzymajAsync(CancellationToken token = default);

    /// <summary>Nastepny utwor w kolejce (po Kolejnosc) od 0ms. Gdy to byl ostatni -- zatrzymuje (Zatrzymana, UtworId=null).</summary>
    Task<WynikOperacji<StanMuzykiDto>> NastepnyAsync(CancellationToken token = default);

    /// <summary>Poprzedni utwor w kolejce od 0ms. Gdy to byl pierwszy -- zatrzymuje (Zatrzymana, UtworId=null).</summary>
    Task<WynikOperacji<StanMuzykiDto>> PoprzedniAsync(CancellationToken token = default);

    /// <summary>Ustawia glosnosc master (0.0-1.0). Nie rusza stanu odtwarzania.</summary>
    Task<WynikOperacji<StanMuzykiDto>> UstawGlosnoscAsync(float wartosc, CancellationToken token = default);
}