daniel-c-harvey
35 lines
1.4 KiB
C#
35 lines
1.4 KiB
C#
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 narrowed by medium ("cut" | "session" | "mix"), free-text search, and genre.</summary>
|
|
Task<ApiResult<PagedResult<ReleaseDto>>> GetPaged(
|
|
string? medium,
|
|
int page,
|
|
int pageSize,
|
|
string? sortColumn = null,
|
|
bool sortDescending = false,
|
|
string? search = null,
|
|
string? genre = null);
|
|
|
|
/// <summary>Single release resolved by its opaque public EntryKey, with both metadata satellites (nulls for non-matching media).</summary>
|
|
Task<ApiResult<ReleaseDto>> GetByEntryKey(string entryKey);
|
|
|
|
/// <summary>
|
|
/// The Mix waveform datum for a release addressed by its public EntryKey. 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(string entryKey);
|
|
}
|