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

namespace DeepDrftPublic.Client.Services;

/// <summary>
/// Release read abstraction (Phase 9). Both SSR and WASM renders are served by
/// <c>ReleaseClientDataService</c> in this assembly, which delegates to
/// <see cref="Clients.ReleaseClient"/> over HTTP. Components inject this single seam
/// so they do not branch on render mode — mirrors <see cref="ITrackDataService"/>.
/// </summary>
public interface IReleaseDataService
{
    /// <summary>Paged releases, optionally filtered to one medium ("cut" | "session" | "mix").</summary>
    Task<ApiResult<PagedResult<ReleaseDto>>> GetPaged(
        string? medium,
        int page,
        int pageSize,
        string? sortColumn = null,
        bool sortDescending = false);

    /// <summary>Single release with both metadata satellites (nulls for non-matching media).</summary>
    Task<ApiResult<ReleaseDto>> GetById(long id);

    /// <summary>
    /// The Mix waveform datum. Success with a value when present; success with a null value when
    /// no datum is stored (a valid state, not a failure); failure on any other transport error.
    /// </summary>
    Task<ApiResult<WaveformProfileDto?>> GetMixWaveform(long id);
}