namespace StellaOps.Findings.Ledger.Infrastructure.AirGap;

/// <summary>
/// Repository for managing evidence snapshot links.
/// </summary>
public interface IEvidenceSnapshotRepository
{
    /// <summary>
    /// Inserts a new evidence snapshot record.
    /// </summary>
    Task InsertAsync(EvidenceSnapshotRecord record, CancellationToken cancellationToken);

    /// <summary>
    /// Gets evidence snapshots for a finding.
    /// </summary>
    Task<IReadOnlyList<EvidenceSnapshotRecord>> GetByFindingIdAsync(
        string tenantId,
        string findingId,
        CancellationToken cancellationToken);

    /// <summary>
    /// Gets the latest evidence snapshot for a finding.
    /// </summary>
    Task<EvidenceSnapshotRecord?> GetLatestByFindingIdAsync(
        string tenantId,
        string findingId,
        CancellationToken cancellationToken);

    /// <summary>
    /// Gets all evidence snapshots for a bundle.
    /// </summary>
    Task<IReadOnlyList<EvidenceSnapshotRecord>> GetByBundleUriAsync(
        string tenantId,
        string bundleUri,
        CancellationToken cancellationToken);

    /// <summary>
    /// Checks if an evidence snapshot exists and is not expired.
    /// </summary>
    Task<bool> ExistsValidAsync(
        string tenantId,
        string findingId,
        string dsseDigest,
        CancellationToken cancellationToken);
}