using System.Text.Json.Serialization;

namespace Jellyfin.Plugin.JRay.Models;

/// <summary>
/// One presence window in a <see cref="TruthFile"/>.
/// </summary>
/// <remarks>
/// <b>A window is a claim about scene membership, not a recognition event</b>
/// (SR-002). An actor who turns away, is occluded, or is off-camera while the
/// shot cuts to whoever they are speaking to is still present — so a consumer
/// must never read a boundary as "the face was detected here", and must not
/// merge, split, trim or reorder windows.
/// <para>
/// In <c>schema_version</c> 1 this was a bare <c>[start, end]</c> float pair. It
/// became an object in the SR-003 bump so a window can carry the evidence behind
/// it: a consumer that shows presence should be able to say how strongly it is
/// believed and how it was arrived at, which a pair of numbers cannot express.
/// </para>
/// </remarks>
// TRACES: JR-002, JR-004 | SR-002, SR-003
public class TruthScene
{
    /// <summary>Gets or sets the window start, in seconds, inclusive.</summary>
    [JsonPropertyName("start")]
    public double Start { get; set; }

    /// <summary>Gets or sets the window end, in seconds, inclusive.</summary>
    [JsonPropertyName("end")]
    public double End { get; set; }

    /// <summary>
    /// Gets or sets the accumulated posterior that justified this claim, in
    /// <c>[0, 1]</c>, or <c>null</c> when the producer did not record one.
    /// </summary>
    /// <remarks>
    /// Optional rather than defaulted to zero: absent and "believed with
    /// probability zero" are different statements, and a claim nobody believes
    /// would not have been written.
    /// </remarks>
    [JsonPropertyName("belief")]
    public double? Belief { get; set; }

    /// <summary>
    /// Gets or sets how the actor was identified: <c>live</c>, <c>deferred</c>
    /// or <c>pooled</c> (extraction AR-017).
    /// </summary>
    [JsonPropertyName("route")]
    public string? Route { get; set; }
}