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

namespace StellaOps.Cli.Services;

/// <summary>
/// Client for observability API operations.
/// Per CLI-OBS-51-001/52-001.
/// </summary>
internal interface IObservabilityClient
{
    /// <summary>
    /// Gets platform health summary for obs top command.
    /// </summary>
    Task<ObsTopResult> GetHealthSummaryAsync(
        ObsTopRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Gets a distributed trace by ID.
    /// Per CLI-OBS-52-001.
    /// </summary>
    Task<ObsTraceResult> GetTraceAsync(
        ObsTraceRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Gets logs within a time window.
    /// Per CLI-OBS-52-001.
    /// </summary>
    Task<ObsLogsResult> GetLogsAsync(
        ObsLogsRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Gets current incident mode status.
    /// Per CLI-OBS-55-001.
    /// </summary>
    Task<IncidentModeResult> GetIncidentModeStatusAsync(
        string? tenant,
        CancellationToken cancellationToken);

    /// <summary>
    /// Enables incident mode.
    /// Per CLI-OBS-55-001.
    /// </summary>
    Task<IncidentModeResult> EnableIncidentModeAsync(
        IncidentModeEnableRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Disables incident mode.
    /// Per CLI-OBS-55-001.
    /// </summary>
    Task<IncidentModeResult> DisableIncidentModeAsync(
        IncidentModeDisableRequest request,
        CancellationToken cancellationToken);
}