namespace Jellyfin.Plugin.JRay.Models;

/// <summary>
/// Which comparison produced the offset that was applied to a fetched manifest.
/// </summary>
/// <remarks>
/// Recorded because the two are not equally strong evidence. The server has
/// never seen the local file, so its offset is at best a runtime-difference
/// inference; a local alignment compares the manifest's own audio signature
/// against the file the windows will actually be drawn over.
/// </remarks>
public enum AlignmentSource
{
    /// <summary>
    /// The server's offset was applied — no local alignment was possible.
    /// </summary>
    /// <remarks>
    /// Either signatures are switched off, the item is under the 120 s window,
    /// the manifest carried no signature, or the decode failed. A signature is
    /// an enhancement, so every one of those degrades to this rather than
    /// failing the fetch.
    /// </remarks>
    Server = 0,

    /// <summary>
    /// A local audio alignment was computed and its offset was applied.
    /// </summary>
    Local = 1,

    /// <summary>
    /// A local alignment was attempted and the two signatures did not match at
    /// any tier; the server's offset was applied and the disagreement recorded.
    /// </summary>
    /// <remarks>
    /// Deliberately not a failure. The audio may legitimately differ — a
    /// different language track, a heavy re-encode — and a signature must never
    /// be able to break a fetch. But it is the strongest available hint that a
    /// manifest describes different content, so it is surfaced as a caveat
    /// rather than discarded.
    /// </remarks>
    LocalMismatch = 2,
}