ersatztv/ErsatzTV.Core/Interfaces/Scheduling/IPlayoutTimeShifter.cs

namespace ErsatzTV.Core.Interfaces.Scheduling;

public interface IPlayoutTimeShifter
{
    /// <summary>
    /// Slides an on-demand playout's materialized timeline forward so the item the viewer had
    /// reached is active again at <paramref name="now" />.
    /// </summary>
    /// <returns>
    /// The channel numbers whose cached XMLTV guide is now stale and should be rebuilt — the shifted
    /// channel plus any channels that mirror it — when a non-zero shift was persisted; otherwise an
    /// empty list.
    /// </returns>
    Task<List<string>> TimeShift(int playoutId, DateTimeOffset now, bool force, CancellationToken cancellationToken);
}