using SVSim.EmulatedEntrypoint.Models.Dtos;
using SVSim.EmulatedEntrypoint.Models.Dtos.BattlePass;

namespace SVSim.EmulatedEntrypoint.Services;

public interface IBattlePassService
{
    /// <summary>Global level curve as wire-string dictionary; null if no levels seeded.</summary>
    Task<IReadOnlyDictionary<string, BattlePassLevel>?> GetLevelCurveAsync(CancellationToken ct);

    /// <summary>
    /// /battle_pass/info payload. Returns null when no active season window covers <c>now</c>
    /// (controller emits empty body in that case).
    /// </summary>
    Task<BattlePassInfoResponse?> GetInfoAsync(long viewerId, CancellationToken ct);

    /// <summary>
    /// /battle_pass/item_list payload. Returns one product per active season; empty products
    /// array if the viewer already owns premium for the active season. Null when no active season.
    /// </summary>
    Task<BattlePassItemListResponse?> GetItemListAsync(long viewerId, CancellationToken ct);

    /// <summary>
    /// Purchase premium for the active season. Validates season_id matches active season,
    /// product id derives from season, viewer has crystals, viewer isn't already premium.
    /// On success: deducts crystals, flips IsPremium, retroactively grants premium rewards for
    /// every level &lt;= current_level not yet claimed. All-or-nothing transaction.
    /// </summary>
    Task<BattlePassBuyOutcome> BuyPremiumAsync(long viewerId, int seasonId, int productId, CancellationToken ct);
}