using System.Collections.ObjectModel;
using System.Text.Json.Serialization;

namespace Jellyfin.Plugin.JRay.Models;

/// <summary>
/// One shareable actor timeline for one cut of one title, as the public server
/// serves it. See the server specification §2.
/// </summary>
/// <remarks>
/// This is the <b>exchange envelope</b>, versioned by <c>jmanifest_version</c>
/// and deliberately separate from the truth file's <c>schema_version</c>: a
/// change to how manifests are transported need not force a truth-file bump.
/// They currently coincide at 2 only because the SR-003 bump touched both.
/// <para>
/// A manifest is never trusted merely because a server served it (JR-027). Every
/// field below is re-validated on receipt against the same rules the server
/// applies on upload.
/// </para>
/// </remarks>
// TRACES: JR-025, JR-027 | SR-003
public class Jmanifest
{
    /// <summary>Gets or sets the exchange envelope version this manifest speaks.</summary>
    [JsonPropertyName("jmanifest_version")]
    public int JmanifestVersion { get; set; }

    /// <summary>Gets or sets what the work is — TMDB/IMDB ids and episode coordinates.</summary>
    [JsonPropertyName("identity")]
    public JmanifestIdentity? Identity { get; set; }

    /// <summary>Gets or sets which encode the timings apply to.</summary>
    [JsonPropertyName("cut")]
    public JmanifestCut? Cut { get; set; }

    /// <summary>Gets or sets extraction provenance.</summary>
    [JsonPropertyName("extraction")]
    public JmanifestExtraction? Extraction { get; set; }

    /// <summary>Gets the actors and their presence windows.</summary>
    [JsonPropertyName("actors")]
    [JsonObjectCreationHandling(JsonObjectCreationHandling.Populate)]
    public Collection<JmanifestActor> Actors { get; } = new();
}