// <copyright file="AirGapBundle.cs" company="StellaOps">
// Copyright (c) StellaOps. Licensed under AGPL-3.0-or-later.
// </copyright>

namespace StellaOps.AirGap.Sync.Models;

/// <summary>
/// Represents an air-gap bundle containing job logs from one or more offline nodes.
/// </summary>
public sealed record AirGapBundle
{
    /// <summary>
    /// Gets the unique bundle identifier.
    /// </summary>
    public required Guid BundleId { get; init; }

    /// <summary>
    /// Gets the tenant ID for this bundle.
    /// </summary>
    public required string TenantId { get; init; }

    /// <summary>
    /// Gets when the bundle was created.
    /// </summary>
    public required DateTimeOffset CreatedAt { get; init; }

    /// <summary>
    /// Gets the node ID that created this bundle.
    /// </summary>
    public required string CreatedByNodeId { get; init; }

    /// <summary>
    /// Gets the job logs from each offline node.
    /// </summary>
    public required IReadOnlyList<NodeJobLog> JobLogs { get; init; }

    /// <summary>
    /// Gets the bundle manifest digest for integrity verification.
    /// </summary>
    public required string ManifestDigest { get; init; }

    /// <summary>
    /// Gets the optional DSSE signature over the manifest.
    /// </summary>
    public string? Signature { get; init; }

    /// <summary>
    /// Gets the key ID used for signing (if signed).
    /// </summary>
    public string? SignedBy { get; init; }
}