feat: recommend server-generated mixes from Musify and YouTube Music

Mixes are their own concept, not playlists: they live in their own Mixes/MixItems tables, cannot be edited and never show up among the user's playlists. Each item is either a Musify track or a YouTube Music reference, so YouTube songs stream directly instead of being downloaded. A daily Hangfire job seeds the mixes from the listening history: one discovery mix, one daily mix and one per top artist. The per-user YouTube filler query was already in the working tree and rides along here because it shares files with this change.
2026-07-21 18:13:07 +02:00
parent 637e1ae583
commit 496a5f4a0b
36 changed files with 2667 additions and 13 deletions
@@ -0,0 +1,51 @@
+using Mediator;
+using Musify.Api.Authentication;
+using Musify.Api.Extensions;
+using Musify.Application.Mixes;
+using Musify.Application.Mixes.Responses;
+
+namespace Musify.Api.Endpoints;
+
+public static class MixEndpoints
+{
+    public static IEndpointRouteBuilder MapMixEndpoints(this IEndpointRouteBuilder app)
+    {
+        var group = app.MapGroup("/mixes")
+            .WithTags("Mixes")
+            .RequireAuthorization();
+
+        group.MapGet("/", GetMixes)
+            .WithName("GetMixes")
+            .WithSummary("Get The Server-Generated Mixes Of The Current User.")
+            .Produces<IReadOnlyList<MixApplicationResponse>>()
+            .Produces(StatusCodes.Status401Unauthorized);
+
+        group.MapGet("/{id}", GetMixById)
+            .WithName("GetMixById")
+            .WithSummary("Get A Mix With All Of Its Songs.")
+            .Produces<MixApplicationResponse>()
+            .Produces(StatusCodes.Status401Unauthorized)
+            .Produces(StatusCodes.Status404NotFound);
+
+        return app;
+    }
+
+    private static async Task<IResult> GetMixes(
+        IMediator mediator,
+        CurrentUser currentUser,
+        CancellationToken cancellationToken)
+    {
+        var result = await mediator.Send(new GetMixesByUserIdQuery(currentUser.RequiredId), cancellationToken);
+        return result.ToHttpResult();
+    }
+
+    private static async Task<IResult> GetMixById(
+        IMediator mediator,
+        CurrentUser currentUser,
+        Guid id,
+        CancellationToken cancellationToken)
+    {
+        var result = await mediator.Send(new GetMixByIdQuery(currentUser.RequiredId, id), cancellationToken);
+        return result.ToHttpResult();
+    }
+}