using DeepDrftModels.DTOs;
using Models.Common;
using NetBlocks.Models;

namespace DeepDrftData;

/// <summary>
/// SQL-side track service. Repository outputs entities; this service outputs DTOs via
/// TrackConverter. In-process consumers (UnifiedTrackService, CLI, DeepDrftPublic) all
/// receive DTOs.
/// </summary>
public interface ITrackService
{
    Task<ResultContainer<TrackDto?>> GetById(long id);
    Task<ResultContainer<TrackDto?>> GetByEntryKey(string entryKey);

    /// <summary>
    /// Returns a single track chosen uniformly at random, or null when the library is empty
    /// (a valid state, not a failure). Backs the public "Stream Now" instant-play feature.
    /// </summary>
    Task<ResultContainer<TrackDto?>> GetRandom(CancellationToken cancellationToken = default);
    Task<ResultContainer<List<TrackDto>>> GetAll();
    Task<ResultContainer<PagedResult<TrackDto>>> GetPaged(int pageNumber, int pageSize, string? sortColumn, bool sortDescending, TrackFilter? filter = null, CancellationToken cancellationToken = default);

    /// <summary>All releases, title-ascending, each carrying its non-deleted track count.</summary>
    Task<ResultContainer<List<ReleaseDto>>> GetReleases(CancellationToken cancellationToken = default);

    /// <summary>Distinct non-null genres with track counts, genre-ascending.</summary>
    Task<ResultContainer<List<GenreSummaryDto>>> GetDistinctGenres(CancellationToken cancellationToken = default);

    /// <summary>
    /// Resolve the release matching <paramref name="title"/> + <paramref name="artist"/>, creating
    /// one from <paramref name="releaseData"/> when none exists. Backs the upload flow's FK
    /// resolution so a track lands on a shared release rather than duplicating release-cardinal data.
    /// </summary>
    Task<ResultContainer<ReleaseDto>> FindOrCreateRelease(
        string title, string artist, ReleaseDto releaseData, CancellationToken cancellationToken = default);

    Task<ResultContainer<TrackDto>> Create(TrackDto newTrack);
    Task<ResultContainer<TrackDto>> Update(TrackDto track);
    Task<Result> Delete(long id);
}