namespace ytLive.Services;

/// <summary>
/// TASK 21: a media file decoder exposed to <see cref="MediaVideoSourceManager"/>.
/// Mirrors <c>IScreenCaptureSource</c>/<c>ICameraFrameSource</c> so the manager
/// (and tests) treat a local video file like any other frame source: start/stop
/// and a per-frame <see cref="FrameAvailable"/> event consumers coalesce.
/// </summary>
public interface IMediaFrameSource : IDisposable
{
    string Key { get; }

    /// <summary>Raised (on a worker thread) for each decoded frame.</summary>
    event Action<VideoFrame>? FrameAvailable;

    /// <summary>Raised when the file finishes decoding (natural EOF).</summary>
    event Action? Completed;

    Task StartAsync(CancellationToken cancellationToken = default);
    Task StopAsync();
}