using System.ComponentModel.DataAnnotations; using ErsatzTV.Application.MediaCollections; using ErsatzTV.Controllers.Api.Requests; using ErsatzTV.Core; using ErsatzTV.Core.Api.LibraryBrowse; using ErsatzTV.Extensions; using MediatR; using Microsoft.AspNetCore.Http; using Microsoft.AspNetCore.Mvc; namespace ErsatzTV.Controllers.Api; [ApiController] public class CollectionController(IMediator mediator) : ControllerBase { [HttpGet("/api/collections")] [Tags("Collections")] [EndpointSummary("Get all collections")] [EndpointGroupName("general")] [ProducesResponseType(typeof(List), StatusCodes.Status200OK)] public async Task> GetAll(CancellationToken cancellationToken) => await mediator.Send(new GetAllCollections(), cancellationToken); [HttpGet("/api/collections/{id:int}", Name = "GetCollectionById")] [Tags("Collections")] [EndpointSummary("Get a collection by id")] [EndpointGroupName("general")] [ProducesResponseType(typeof(MediaCollectionViewModel), StatusCodes.Status200OK)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)] public async Task GetById(int id, CancellationToken cancellationToken) { Option result = await mediator.Send(new GetCollectionById(id), cancellationToken); return result.ToGetResult(); } [HttpGet("/api/collections/{id:int}/items", Name = "GetCollectionItems")] [Tags("Collections")] [EndpointSummary("Get the items in a manual collection")] [EndpointDescription("Returns a manual collection's full contents (all media kinds), paged.")] [EndpointGroupName("general")] [ProducesResponseType(typeof(PagedLibraryBrowseItemsResponseModel), StatusCodes.Status200OK)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)] public async Task GetItems( int id, [FromQuery] int pageNum = 0, [FromQuery] int pageSize = 100, CancellationToken cancellationToken = default) { int clampedPageNum = Math.Max(0, pageNum); int clampedPageSize = Math.Clamp(pageSize, 1, 100); Either result = await mediator.Send( new GetCollectionItems(id, clampedPageNum, clampedPageSize), cancellationToken); return result.ToUpdatedResult(); } [HttpPost("/api/collections")] [Tags("Collections")] [EndpointSummary("Create a collection")] [EndpointGroupName("general")] [ProducesResponseType(typeof(MediaCollectionViewModel), StatusCodes.Status201Created)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status422UnprocessableEntity)] public async Task Create( [Required] [FromBody] CreateCollectionRequest request, CancellationToken cancellationToken) { Either result = await mediator.Send(request.ToCommand(), cancellationToken); return result.ToCreatedResult(vm => $"/api/collections/{vm.Id}", vm => vm); } [HttpPut("/api/collections/{id:int}")] [Tags("Collections")] [EndpointSummary("Update a collection")] [EndpointGroupName("general")] [ProducesResponseType(typeof(MediaCollectionViewModel), StatusCodes.Status200OK)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status422UnprocessableEntity)] public async Task Update( int id, [Required] [FromBody] UpdateCollectionRequest request, CancellationToken cancellationToken) { Either result = await mediator.Send(request.ToCommand(id), cancellationToken); return await result.Match( Left: error => Task.FromResult(error.ToErrorResult()), Right: async _ => { Option collection = await mediator.Send(new GetCollectionById(id), cancellationToken); return collection.Match( Some: vm => (IActionResult)new OkObjectResult(vm), None: () => ApiResults.NotFoundProblem()); }); } [HttpDelete("/api/collections/{id:int}")] [Tags("Collections")] [EndpointSummary("Delete a collection")] [EndpointGroupName("general")] [ProducesResponseType(StatusCodes.Status204NoContent)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status422UnprocessableEntity)] public async Task Delete(int id, CancellationToken cancellationToken) { Either result = await mediator.Send(new DeleteCollection(id), cancellationToken); return result.ToDeletedResult(); } [HttpPost("/api/collections/{id:int}/items")] [Tags("Collections")] [EndpointSummary("Add items to a collection")] [EndpointGroupName("general")] [ProducesResponseType(StatusCodes.Status204NoContent)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status422UnprocessableEntity)] public async Task AddItems( int id, [Required] [FromBody] AddItemsToCollectionRequest request, CancellationToken cancellationToken) { Either result = await mediator.Send(request.ToCommand(id), cancellationToken); return result.ToDeletedResult(); } [HttpDelete("/api/collections/{id:int}/items/{mediaItemId:int}")] [Tags("Collections")] [EndpointSummary("Remove an item from a collection")] [EndpointGroupName("general")] [ProducesResponseType(StatusCodes.Status204NoContent)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status404NotFound)] [ProducesResponseType(typeof(ProblemDetails), StatusCodes.Status422UnprocessableEntity)] public async Task RemoveItem(int id, int mediaItemId, CancellationToken cancellationToken) { Either result = await mediator.Send( new RemoveItemsFromCollection(id) { MediaItemIds = [mediaItemId] }, cancellationToken); return result.ToDeletedResult(); } }