ersatztv/ErsatzTV/Controllers/Api/CollectionController.cs

using System.ComponentModel.DataAnnotations;
using ErsatzTV.Application.MediaCollections;
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 CollectionController(IMediator mediator) : ControllerBase
{
    [HttpGet("/api/collections")]
    [Tags("Collections")]
    [EndpointSummary("Get all collections")]
    [EndpointGroupName("general")]
    [ProducesResponseType(typeof(List<MediaCollectionViewModel>), StatusCodes.Status200OK)]
    public async Task<List<MediaCollectionViewModel>> 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<IActionResult> GetById(int id, CancellationToken cancellationToken)
    {
        Option<MediaCollectionViewModel> result = await mediator.Send(new GetCollectionById(id), cancellationToken);
        return result.ToGetResult();
    }

    [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<IActionResult> Create(
        [Required] [FromBody] CreateCollectionRequest request,
        CancellationToken cancellationToken)
    {
        Either<BaseError, MediaCollectionViewModel> 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<IActionResult> Update(
        int id,
        [Required] [FromBody] UpdateCollectionRequest request,
        CancellationToken cancellationToken)
    {
        Either<BaseError, Unit> result = await mediator.Send(request.ToCommand(id), cancellationToken);
        return await result.Match(
            Left: error => Task.FromResult(error.ToErrorResult()),
            Right: async _ =>
            {
                Option<MediaCollectionViewModel> 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<IActionResult> Delete(int id, CancellationToken cancellationToken)
    {
        Either<BaseError, Unit> 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<IActionResult> AddItems(
        int id,
        [Required] [FromBody] AddItemsToCollectionRequest request,
        CancellationToken cancellationToken)
    {
        Either<BaseError, Unit> 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<IActionResult> RemoveItem(int id, int mediaItemId, CancellationToken cancellationToken)
    {
        Either<BaseError, Unit> result = await mediator.Send(
            new RemoveItemsFromCollection(id)
            {
                MediaItemIds = [mediaItemId]
            },
            cancellationToken);
        return result.ToDeletedResult();
    }
}