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

namespace SameBeat.Application.Interfejsy;

/// <summary>
/// Logika czatu na zywo (ETAP 6) -- dostepnego dla kazdego widza, nie tylko uczestnikow na scenie.
/// Tozsamosc czatu (UczestnikCzatu) jest lekka i celowo osobna od poczekalni: bez sekretu sesji, bez
/// LiveKit, tworzona przy pierwszym wejsciu na czat.
/// </summary>
public interface ISerwisCzatu
{
    /// <summary>Tworzy nowa tozsamosc czatu dla biezacego wydarzenia.</summary>
    Task<WynikOperacji<OdpowiedzDolaczeniaDoCzatuDto>> DolaczAsync(DolaczDoCzatuKomenda komenda, CancellationToken token = default);

    /// <summary>
    /// Wysyla wiadomosc -- odmawia, gdy tozsamosc jest zbanowana, wyciszona, albo pisze za szybko
    /// (rate limit liczony z ostatniej wiadomosci w bazie, nie ze stanu w pamieci procesu). Zwraca
    /// wariant "hostowy" (z UczestnikCzatuId) -- to controller decyduje, ktora czesc rozglosic
    /// publicznie (bez ID), a ktora tylko do grupy "host" (z ID), patrz WiadomoscCzatuHostaDto.
    /// </summary>
    Task<WynikOperacji<WiadomoscCzatuHostaDto>> WyslijWiadomoscAsync(WyslijWiadomoscKomenda komenda, CancellationToken token = default);

    /// <summary>Ostatnie wiadomosci NIE usuniete dla biezacego wydarzenia -- do zaladowania historii przed pierwszymi zdarzeniami SignalR.</summary>
    Task<WynikOperacji<List<WiadomoscCzatuDto>>> PobierzHistorieAsync(CancellationToken token = default);

    /// <summary>Jak PobierzHistorieAsync, ale z UczestnikCzatuId nadawcy kazdej wiadomosci -- wylacznie dla hosta, potrzebne do moderacji (wycisz/odcisz/zbanuj).</summary>
    Task<WynikOperacji<List<WiadomoscCzatuHostaDto>>> PobierzHistorieDlaHostaAsync(CancellationToken token = default);

    /// <summary>Soft-delete wiadomosci przez hosta.</summary>
    Task<WynikOperacji> UsunWiadomoscAsync(Guid wiadomoscId, CancellationToken token = default);

    Task<WynikOperacji> WyciszAsync(Guid uczestnikCzatuId, CancellationToken token = default);

    Task<WynikOperacji> OdciszAsync(Guid uczestnikCzatuId, CancellationToken token = default);

    Task<WynikOperacji> ZbanujAsync(Guid uczestnikCzatuId, CancellationToken token = default);
}