namespace StellaOps.Provcache.Api;

/// <summary>
/// Response model for GET /v1/provcache/{veriKey}.
/// </summary>
public sealed class ProvcacheGetResponse
{
    /// <summary>
    /// The VeriKey that was looked up.
    /// </summary>
    public required string VeriKey { get; init; }

    /// <summary>
    /// The cache entry if found.
    /// </summary>
    public ProvcacheEntry? Entry { get; init; }

    /// <summary>
    /// The source of the cache hit (valkey, postgres, etc.).
    /// </summary>
    public string? Source { get; init; }

    /// <summary>
    /// Time taken for the lookup in milliseconds.
    /// </summary>
    public double ElapsedMs { get; init; }

    /// <summary>
    /// Status: "hit", "miss", "bypassed", "expired".
    /// </summary>
    public required string Status { get; init; }
}