ersatztv/ErsatzTV.Application/MediaCollections/Commands/AddImageToCollectionHandler.cs

using System.Threading.Channels;
using ErsatzTV.Application.Playouts;
using ErsatzTV.Application.Search;
using ErsatzTV.Core;
using ErsatzTV.Core.Domain;
using ErsatzTV.Core.Interfaces.Repositories;
using ErsatzTV.Core.Scheduling;
using ErsatzTV.Infrastructure.Data;
using ErsatzTV.Infrastructure.Extensions;
using Microsoft.EntityFrameworkCore;

namespace ErsatzTV.Application.MediaCollections;

public class AddImageToCollectionHandler : IRequestHandler<AddImageToCollection, Either<BaseError, Unit>>
{
    private readonly ChannelWriter<IBackgroundServiceRequest> _channel;
    private readonly IDbContextFactory<TvContext> _dbContextFactory;
    private readonly IMediaCollectionRepository _mediaCollectionRepository;
    private readonly ChannelWriter<ISearchIndexBackgroundServiceRequest> _searchChannel;

    public AddImageToCollectionHandler(
        IDbContextFactory<TvContext> dbContextFactory,
        IMediaCollectionRepository mediaCollectionRepository,
        ChannelWriter<IBackgroundServiceRequest> channel,
        ChannelWriter<ISearchIndexBackgroundServiceRequest> searchChannel)
    {
        _dbContextFactory = dbContextFactory;
        _mediaCollectionRepository = mediaCollectionRepository;
        _channel = channel;
        _searchChannel = searchChannel;
    }

    public async Task<Either<BaseError, Unit>> Handle(
        AddImageToCollection request,
        CancellationToken cancellationToken)
    {
        await using TvContext dbContext = await _dbContextFactory.CreateDbContextAsync(cancellationToken);
        Validation<BaseError, Parameters> validation = await Validate(dbContext, request, cancellationToken);
        return await validation.Apply(parameters => ApplyAddImageRequest(dbContext, parameters));
    }

    private async Task<Unit> ApplyAddImageRequest(TvContext dbContext, Parameters parameters)
    {
        // No-op on an idempotent re-add: don't rotate the ETag or fan out rebuilds for an item that is
        // already a member (also avoids a duplicate CollectionItem row) — #269.
        if (parameters.Collection.MediaItems.Any(mi => mi.Id == parameters.Image.Id))
        {
            return Unit.Default;
        }

        parameters.Collection.MediaItems.Add(parameters.Image);

        // Rotate the collection ETag so an open custom-order editor's If-Match invalidates (#269);
        // force-write past a concurrent replace-all Version bump — this add takes no If-Match, so a
        // benign race must not 500 (#253/#269 §7a). Post-commit enqueues run on CancellationToken.None.
        parameters.Collection.Version++;
        await dbContext.SaveChangesForcingVersion(CancellationToken.None);

        await _searchChannel.WriteAsync(new ReindexMediaItems([parameters.Image.Id]), CancellationToken.None);

        // refresh all playouts that use this collection
        foreach (int playoutId in await _mediaCollectionRepository
                     .PlayoutIdsUsingCollection(parameters.Collection.Id))
        {
            await _channel.WriteAsync(new BuildPlayout(playoutId, PlayoutBuildMode.Refresh), CancellationToken.None);
        }

        return Unit.Default;
    }

    private static async Task<Validation<BaseError, Parameters>> Validate(
        TvContext dbContext,
        AddImageToCollection request,
        CancellationToken cancellationToken) =>
        (await CollectionMustExist(dbContext, request, cancellationToken),
            await ValidateImage(dbContext, request, cancellationToken))
        .Apply((collection, episode) => new Parameters(collection, episode));

    private static Task<Validation<BaseError, Collection>> CollectionMustExist(
        TvContext dbContext,
        AddImageToCollection request,
        CancellationToken cancellationToken) =>
        dbContext.Collections
            .Include(c => c.MediaItems)
            .SelectOneAsync(c => c.Id, c => c.Id == request.CollectionId, cancellationToken)
            .Map(o => o.ToValidation<BaseError>("Collection does not exist."));

    private static Task<Validation<BaseError, Image>> ValidateImage(
        TvContext dbContext,
        AddImageToCollection request,
        CancellationToken cancellationToken) =>
        dbContext.Images
            .SelectOneAsync(m => m.Id, e => e.Id == request.ImageId, cancellationToken)
            .Map(o => o.ToValidation<BaseError>("Image does not exist"));

    private sealed record Parameters(Collection Collection, Image Image);
}