using System.Threading;
using System.Threading.Tasks;
using StellaOps.Cli.Services.Models;

namespace StellaOps.Cli.Services;

/// <summary>
/// Client for VEX observation queries.
/// Per CLI-LNM-22-002.
/// </summary>
internal interface IVexObservationsClient
{
    /// <summary>
    /// Gets VEX observations matching the query.
    /// </summary>
    Task<VexObservationResponse> GetObservationsAsync(
        VexObservationQuery query,
        CancellationToken cancellationToken);

    /// <summary>
    /// Gets a VEX linkset for a vulnerability ID.
    /// </summary>
    Task<VexLinksetResponse> GetLinksetAsync(
        VexLinksetQuery query,
        CancellationToken cancellationToken);

    /// <summary>
    /// Gets a single VEX observation by ID.
    /// </summary>
    Task<VexObservation?> GetObservationByIdAsync(
        string tenant,
        string observationId,
        CancellationToken cancellationToken);
}