ersatztv/ErsatzTV/Controllers/Api/Requests/PlayoutAlternateScheduleItemRequest.cs

#nullable enable
using ErsatzTV.Application.Playouts;
using ErsatzTV.Core.Scheduling;

namespace ErsatzTV.Controllers.Api.Requests;

public record PlayoutAlternateScheduleItemRequest(
    int Id,
    int ProgramScheduleId,
    List<DayOfWeek>? DaysOfWeek,
    List<int>? DaysOfMonth,
    List<int>? MonthsOfYear,
    bool LimitToDateRange,
    int StartMonth,
    int StartDay,
    int? StartYear,
    int EndMonth,
    int EndDay,
    int? EndYear)
{
    // An ABSENT recurrence array means UNRESTRICTED, not "matches nothing" (#880). The three sets are
    // conjunctive in AlternateScheduleSelector.GetScheduleForDate -- a miss on any one `continue`s -- so
    // the previous `?? []` stored an item that could never apply on any date, and returned 200 while
    // doing it. Absence now normalizes to the same All*() sets the READ side substitutes for a NULL
    // column (AlternateScheduleSelector's read guard and both Mapper.ProjectToViewModel overloads), so
    // the two halves of "this field is absent" finally agree -- residual (3) of
    // `media.nullable-primitive-collection-mutation`.
    //
    // These are nullable so that ABSENT is distinguishable from an explicitly-sent `[]`, which is a
    // different request and is REJECTED with a 422 in PlayoutController rather than normalized here.
    // Newtonsoft maps both a missing property and an explicit `null` to null, so both read as absent;
    // only a literal `[]` survives as empty.
    public ReplacePlayoutAlternateSchedule ToReplaceItem(int index) =>
        new(
            Id,
            index,
            ProgramScheduleId,
            DaysOfWeek ?? AlternateScheduleSelector.AllDaysOfWeek(),
            DaysOfMonth ?? AlternateScheduleSelector.AllDaysOfMonth(),
            MonthsOfYear ?? AlternateScheduleSelector.AllMonthsOfYear(),
            LimitToDateRange,
            StartMonth,
            StartDay,
            StartYear,
            EndMonth,
            EndDay,
            EndYear);
}