feat(api): add library browse endpoint

refs #65
2026-07-06 00:01:06 +02:00
parent a5de775480
commit 127a130737
10 changed files with 1397 additions and 0 deletions
@@ -0,0 +1,33 @@
+using ErsatzTV.Application.LibraryBrowse;
+using ErsatzTV.Core.Api.LibraryBrowse;
+using MediatR;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+
+namespace ErsatzTV.Controllers.Api;
+
+[ApiController]
+public class LibraryBrowseController(IMediator mediator) : ControllerBase
+{
+    private const int MaxPageSize = 100;
+
+    [HttpGet("/api/library/browse", Name = "BrowseLibrary")]
+    [Tags("Library")]
+    [EndpointSummary("Browse and search library items")]
+    [EndpointGroupName("general")]
+    [ProducesResponseType(typeof(PagedLibraryBrowseItemsResponseModel), StatusCodes.Status200OK)]
+    public async Task<PagedLibraryBrowseItemsResponseModel> Browse(
+        [FromQuery] string query = "",
+        [FromQuery] int? libraryId = null,
+        [FromQuery] LibraryBrowseMediaType? mediaType = null,
+        [FromQuery] int pageNum = 0,
+        [FromQuery] int pageSize = 100,
+        CancellationToken cancellationToken = default)
+    {
+        int clampedPageNum = Math.Max(0, pageNum);
+        int clampedPageSize = Math.Clamp(pageSize, 1, MaxPageSize);
+        return await mediator.Send(
+            new GetLibraryBrowseItems(query, libraryId, mediaType, clampedPageNum, clampedPageSize),
+            cancellationToken);
+    }
+}