daniel-c-harvey
a19a734757
Add GET api/track/{trackEntryKey}/waveform/high-res (+ proxy), ITrackDataService.GetTrackWaveform; rewire visualizer to resolve the current track's EntryKey and re-fetch on track change. Retire the client mix-waveform read path.
48 lines
1.9 KiB
C#
48 lines
1.9 KiB
C#
using DeepDrftModels.DTOs;
|
|
using Models.Common;
|
|
using NetBlocks.Models;
|
|
|
|
namespace DeepDrftPublic.Client.Services;
|
|
|
|
/// <summary>
|
|
/// Track metadata fetch abstraction. Both SSR and WASM renders are served by
|
|
/// <c>TrackClientDataService</c> in this assembly, which delegates to
|
|
/// <see cref="Clients.TrackClient"/> over HTTP. Components inject this single seam
|
|
/// so they do not branch on render mode.
|
|
/// </summary>
|
|
public interface ITrackDataService
|
|
{
|
|
Task<ApiResult<PagedResult<TrackDto>>> GetPage(
|
|
int pageNumber,
|
|
int pageSize,
|
|
string? sortColumn = null,
|
|
bool sortDescending = false,
|
|
string? searchText = null,
|
|
string? album = null,
|
|
string? genre = null,
|
|
long? releaseId = null);
|
|
|
|
/// <summary>All releases with track counts, title-ascending.</summary>
|
|
Task<ApiResult<List<ReleaseDto>>> GetAlbums();
|
|
|
|
/// <summary>Distinct non-null genres with track counts.</summary>
|
|
Task<ApiResult<List<GenreSummaryDto>>> GetGenres();
|
|
|
|
Task<ApiResult<TrackDto>> GetTrack(string trackId);
|
|
|
|
/// <summary>
|
|
/// The per-track high-res waveform datum, addressed by the track's EntryKey (phase-12 §5b — the
|
|
/// datum is the track's; the release is only addressing context). Success with a value when a
|
|
/// high-res datum is stored; success with a null value when none is (a not-yet-backfilled track —
|
|
/// a valid state, not a failure, the visualizer blanks); failure on any other transport error.
|
|
/// </summary>
|
|
Task<ApiResult<WaveformProfileDto?>> GetTrackWaveform(string trackEntryKey);
|
|
|
|
/// <summary>
|
|
/// Fetches a random track from the public library for instant play. Success with a value on a
|
|
/// hit; success with a null value when the library is empty (a valid state, not a failure);
|
|
/// failure on any other transport error.
|
|
/// </summary>
|
|
Task<ApiResult<TrackDto?>> GetRandomTrack();
|
|
}
|