using StellaOps.Signals.Models;

namespace StellaOps.Signals.Persistence;

/// <summary>
/// Repository for persisting and querying proc snapshot documents.
/// </summary>
public interface IProcSnapshotRepository
{
    /// <summary>
    /// Upsert a proc snapshot document.
    /// </summary>
    Task<ProcSnapshotDocument> UpsertAsync(ProcSnapshotDocument document, CancellationToken cancellationToken);

    /// <summary>
    /// Get a proc snapshot by ID.
    /// </summary>
    Task<ProcSnapshotDocument?> GetByIdAsync(string id, CancellationToken cancellationToken);

    /// <summary>
    /// Get all proc snapshots for a specific image digest.
    /// </summary>
    Task<IReadOnlyList<ProcSnapshotDocument>> GetByImageDigestAsync(
        string tenant,
        string imageDigest,
        int limit = 100,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// Get the most recent proc snapshot for an image digest and runtime type.
    /// </summary>
    Task<ProcSnapshotDocument?> GetLatestAsync(
        string tenant,
        string imageDigest,
        string runtimeType,
        CancellationToken cancellationToken);

    /// <summary>
    /// Delete expired proc snapshots.
    /// </summary>
    Task<int> DeleteExpiredAsync(CancellationToken cancellationToken);
}