feat(api): browse all media kinds, grouped search, delete media-items (#141, #161)

- Extend /api/library/browse to episodes, music videos, songs, other videos,
  images and remote streams (new LibraryBrowseMediaType values + hydrators);
  add optional Subtitle to LibraryBrowseItemResponseModel for leaf-item context
- Add GET /api/search: grouped per-kind results reusing the browse query/shape;
  empty query -> 422
- Add DELETE /api/media-items: body { ids }, empty -> 422, success -> 204
- Tests: SearchController, MediaItemsController, security + OpenAPI contract entries
- Regenerate openapi v1.json + web v1.d.ts

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

ErsatzTV/Controllers/Api/MediaItemsController.cs

@@ -0,0 +1,32 @@
+using System.ComponentModel.DataAnnotations;
+using ErsatzTV.Controllers.Api.Requests;
+using ErsatzTV.Core;
+using ErsatzTV.Extensions;
+using MediatR;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+
+namespace ErsatzTV.Controllers.Api;
+
+[ApiController]
+public class MediaItemsController(IMediator mediator) : ControllerBase
+{
+    [HttpDelete("/api/media-items", Name = "DeleteMediaItems")]
+    [Tags("Media Items")]
+    [EndpointSummary("Delete media items from the database")]
+    [EndpointGroupName("general")]
+    [ProducesResponseType(StatusCodes.Status204NoContent)]
+    [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status422UnprocessableEntity)]
+    public async Task<IActionResult> Delete(
+        [Required] [FromBody] DeleteMediaItemsRequest request,
+        CancellationToken cancellationToken)
+    {
+        if (request.Ids is null || request.Ids.Count == 0)
+        {
+            return BaseError.New("At least one media item id is required").ToErrorResult();
+        }
+
+        Either<BaseError, Unit> result = await mediator.Send(request.ToCommand(), cancellationToken);
+        return result.ToDeletedResult();
+    }
+}

ErsatzTV/Controllers/Api/Requests/DeleteMediaItemsRequest.cs

@@ -0,0 +1,8 @@
+using ErsatzTV.Application.Maintenance;
+
+namespace ErsatzTV.Controllers.Api.Requests;
+
+public record DeleteMediaItemsRequest(List<int> Ids)
+{
+    public DeleteItemsFromDatabase ToCommand() => new(Ids);
+}

ErsatzTV/Controllers/Api/SearchController.cs

@@ -0,0 +1,38 @@
+using ErsatzTV.Application.Search;
+using ErsatzTV.Core;
+using ErsatzTV.Core.Api.Search;
+using ErsatzTV.Extensions;
+using MediatR;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+
+namespace ErsatzTV.Controllers.Api;
+
+[ApiController]
+public class SearchController(IMediator mediator) : ControllerBase
+{
+    private const int MaxPageSize = 100;
+
+    [HttpGet("/api/search", Name = "Search")]
+    [Tags("Search")]
+    [EndpointSummary("Search library items across all media kinds")]
+    [EndpointGroupName("general")]
+    [ProducesResponseType(typeof(SearchResultsResponseModel), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status422UnprocessableEntity)]
+    public async Task<IActionResult> Search(
+        [FromQuery] string query = "",
+        [FromQuery] int pageSize = 50,
+        CancellationToken cancellationToken = default)
+    {
+        if (string.IsNullOrWhiteSpace(query))
+        {
+            return BaseError.New("A non-empty query is required").ToErrorResult();
+        }
+
+        int clampedPageSize = Math.Clamp(pageSize, 1, MaxPageSize);
+        SearchResultsResponseModel result = await mediator.Send(
+            new GetSearchResults(query, clampedPageSize),
+            cancellationToken);
+        return new OkObjectResult(result);
+    }
+}