using System.Text.Json.Serialization;

namespace Jellyfin.Plugin.JRay.Models;

/// <summary>
/// Which encode the timings in a <see cref="TruthFile"/> apply to (SPEC.md §1,
/// JR-002).
/// </summary>
/// <remarks>
/// Timings are only meaningful against a particular cut. Recording the runtime
/// they were measured from is what lets a consumer notice that a file has been
/// re-encoded, re-trimmed, or replaced with a different release — rather than
/// silently showing an actor twenty seconds late.
/// </remarks>
// TRACES: JR-002 | SR-003
public class TruthCut
{
    /// <summary>
    /// Gets or sets the decoded duration the timings came from, in seconds.
    /// </summary>
    [JsonPropertyName("runtime_sec")]
    public double? RuntimeSec { get; set; }

    /// <summary>
    /// Gets or sets the version-prefixed spectral-peak audio signature, or
    /// <c>null</c> when the producer emitted none.
    /// </summary>
    /// <remarks>
    /// Carries its own <c>v1:</c> prefix so a DSP change is detectable rather
    /// than silently non-matching (JR-045). Media shorter than 120 s carries no
    /// signature at all (JR-044).
    /// </remarks>
    [JsonPropertyName("audio_signature")]
    public string? AudioSignature { get; set; }
}