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);
+    }
+}

ErsatzTV/wwwroot/openapi/v1.json

@@ -3196,6 +3196,65 @@
         }
       }
     },
+    "/api/media-items": {
+      "delete": {
+        "tags": [
+          "Media Items"
+        ],
+        "summary": "Delete media items from the database",
+        "operationId": "DeleteMediaItems",
+        "requestBody": {
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/DeleteMediaItemsRequest"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DeleteMediaItemsRequest"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DeleteMediaItemsRequest"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/DeleteMediaItemsRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "422": {
+            "description": "Unprocessable Entity",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/media-sources": {
       "get": {
         "tags": [
@@ -4619,6 +4678,76 @@
         }
       }
     },
+    "/api/search": {
+      "get": {
+        "tags": [
+          "Search"
+        ],
+        "summary": "Search library items across all media kinds",
+        "operationId": "Search",
+        "parameters": [
+          {
+            "name": "query",
+            "in": "query",
+            "schema": {
+              "type": "string",
+              "default": ""
+            }
+          },
+          {
+            "name": "pageSize",
+            "in": "query",
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "default": 50
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchResultsResponseModel"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchResultsResponseModel"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SearchResultsResponseModel"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "Unprocessable Entity",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/sessions": {
       "get": {
         "tags": [
@@ -8649,6 +8778,24 @@
           }
         }
       },
+      "DeleteMediaItemsRequest": {
+        "required": [
+          "ids"
+        ],
+        "type": "object",
+        "properties": {
+          "ids": {
+            "type": [
+              "null",
+              "array"
+            ],
+            "items": {
+              "type": "integer",
+              "format": "int32"
+            }
+          }
+        }
+      },
       "FFmpegFullProfileResponseModel": {
         "required": [
           "id",
@@ -9450,6 +9597,12 @@
               "integer"
             ],
             "format": "int32"
+          },
+          "subtitle": {
+            "type": [
+              "null",
+              "string"
+            ]
           }
         }
       },
@@ -9463,7 +9616,13 @@
           "SmartCollection",
           "MultiCollection",
           "RerunCollection",
-          "Playlist"
+          "Playlist",
+          "Episode",
+          "MusicVideo",
+          "Song",
+          "OtherVideo",
+          "Image",
+          "RemoteStream"
         ],
         "type": "string"
       },
@@ -10887,6 +11046,72 @@
           }
         }
       },
+      "SearchResultGroupResponseModel": {
+        "required": [
+          "totalCount",
+          "items"
+        ],
+        "type": "object",
+        "properties": {
+          "totalCount": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/LibraryBrowseItemResponseModel"
+            }
+          }
+        }
+      },
+      "SearchResultsResponseModel": {
+        "required": [
+          "movies",
+          "shows",
+          "seasons",
+          "artists",
+          "episodes",
+          "musicVideos",
+          "songs",
+          "otherVideos",
+          "images",
+          "remoteStreams"
+        ],
+        "type": "object",
+        "properties": {
+          "movies": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          },
+          "shows": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          },
+          "seasons": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          },
+          "artists": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          },
+          "episodes": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          },
+          "musicVideos": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          },
+          "songs": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          },
+          "otherVideos": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          },
+          "images": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          },
+          "remoteStreams": {
+            "$ref": "#/components/schemas/SearchResultGroupResponseModel"
+          }
+        }
+      },
       "SmartCollectionResponseModel": {
         "required": [
           "id",
@@ -12252,6 +12477,9 @@
     {
       "name": "Maintenance"
     },
+    {
+      "name": "Media Items"
+    },
     {
       "name": "Media Sources"
     },
@@ -12267,6 +12495,9 @@
     {
       "name": "Schedules"
     },
+    {
+      "name": "Search"
+    },
     {
       "name": "Sessions"
     },