using System.Text.Json.Serialization;
using Jellyfin.Plugin.JRay.Configuration;

namespace Jellyfin.Plugin.JRay.Models;

/// <summary>
/// How a fetched manifest was aligned to the local file, recorded alongside the
/// truth data.
/// </summary>
/// <remarks>
/// The offset is applied once, at store time (JR-030), after which the stored
/// windows look native and nothing would say they had been shifted. This block
/// is what makes that reconstructable: which comparison produced the offset, how
/// strong it was, and the local file's own signature, so a later fetch can
/// re-align without decoding the media again.
/// </remarks>
// TRACES: JR-047 | SR-003
public class TruthAlignment
{
    /// <summary>Gets or sets which comparison produced the applied offset.</summary>
    [JsonPropertyName("source")]
    public AlignmentSource Source { get; set; }

    /// <summary>Gets or sets the tier that was applied.</summary>
    [JsonPropertyName("tier")]
    public MatchTier Tier { get; set; }

    /// <summary>Gets or sets the offset applied to every window, in seconds.</summary>
    [JsonPropertyName("offset_sec")]
    public double OffsetSec { get; set; }

    /// <summary>
    /// Gets or sets the local alignment's score, or <c>null</c> when none was
    /// computed.
    /// </summary>
    [JsonPropertyName("score")]
    public double? Score { get; set; }

    /// <summary>
    /// Gets or sets the recovered slide between the two analysis windows, in
    /// frames, or <c>null</c> when no local alignment was computed.
    /// </summary>
    /// <remarks>
    /// Only part of <see cref="OffsetSec"/>: the rest comes from the two windows
    /// being anchored at different points when the runtimes differ.
    /// </remarks>
    [JsonPropertyName("offset_frames")]
    public int? OffsetFrames { get; set; }

    /// <summary>
    /// Gets or sets the local file's own <c>v1:</c> audio signature, or
    /// <c>null</c> when none was computed.
    /// </summary>
    /// <remarks>
    /// Kept so a later fetch can align against a new manifest without running
    /// FFmpeg over the media again — the expensive half of the operation, and
    /// the reason signatures are opt-in. It never leaves the instance: it is
    /// stored beside the truth file, and contribution strips provenance
    /// entirely (JR-034).
    /// </remarks>
    [JsonPropertyName("local_signature")]
    public string? LocalSignature { get; set; }

    /// <summary>
    /// Gets or sets the offset the server claimed, retained even when a local
    /// alignment superseded it.
    /// </summary>
    [JsonPropertyName("server_offset_sec")]
    public double ServerOffsetSec { get; set; }

    /// <summary>Gets or sets the tier the server claimed.</summary>
    [JsonPropertyName("server_tier")]
    public MatchTier ServerTier { get; set; }
}