Phase 9 Wave 4: ARCHIVE nav + Cuts/Sessions/Mixes pages + MixWaveformVisualizer

Replaces flat RELEASES/SESSIONS/MIXES nav with ARCHIVE dropdown (PageRoute.Children, one-level cap, dual-role node). Adds /archive overview, /cuts (AlbumsView + medium filter; /albums redirects), /sessions + /sessions/{id} (hero-dominant), /mixes + /mixes/{id} (MixWaveformVisualizer full-page background). Extracts ReleaseDetailScaffold from TrackDetail (invariant trio). PersistentComponentState bridge on all new pages. Click-to-seek seam designed on MixWaveformVisualizer (inert until wired).
2026-06-12 23:05:25 -04:00
parent 5f7eaed112
commit af724ce570
31 changed files with 1334 additions and 122 deletions
@@ -0,0 +1,31 @@
+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);
+}
@@ -0,0 +1,35 @@
+using DeepDrftModels.DTOs;
+using DeepDrftPublic.Client.Clients;
+using Models.Common;
+using NetBlocks.Models;
+
+namespace DeepDrftPublic.Client.Services;
+
+/// <summary>
+/// <see cref="IReleaseDataService"/> backed by <see cref="ReleaseClient"/> (HTTP to the
+/// <c>DeepDrft.API</c> backend). Used on both the SSR prerender and WASM interactive passes —
+/// the release read surface is HTTP-only, so there is no separate in-process implementation.
+/// </summary>
+public class ReleaseClientDataService : IReleaseDataService
+{
+    private readonly ReleaseClient _releaseClient;
+
+    public ReleaseClientDataService(ReleaseClient releaseClient)
+    {
+        _releaseClient = releaseClient;
+    }
+
+    public Task<ApiResult<PagedResult<ReleaseDto>>> GetPaged(
+        string? medium,
+        int page,
+        int pageSize,
+        string? sortColumn = null,
+        bool sortDescending = false)
+        => _releaseClient.GetPaged(medium, page, pageSize, sortColumn, sortDescending);
+
+    public Task<ApiResult<ReleaseDto>> GetById(long id)
+        => _releaseClient.GetById(id);
+
+    public Task<ApiResult<WaveformProfileDto?>> GetMixWaveform(long id)
+        => _releaseClient.GetMixWaveform(id);
+}