git.stella-ops.org/src/Cli/StellaOps.Cli/Services/INotifyClient.cs

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

namespace StellaOps.Cli.Services;

/// <summary>
/// Client for Notify API operations.
/// Per CLI-PARITY-41-002.
/// </summary>
internal interface INotifyClient
{
    /// <summary>
    /// Lists notification channels.
    /// </summary>
    Task<NotifyChannelListResponse> ListChannelsAsync(
        NotifyChannelListRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Gets a notification channel by ID.
    /// </summary>
    Task<NotifyChannelDetail?> GetChannelAsync(
        string channelId,
        string? tenant,
        CancellationToken cancellationToken);

    /// <summary>
    /// Tests a notification channel.
    /// </summary>
    Task<NotifyChannelTestResult> TestChannelAsync(
        NotifyChannelTestRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Lists notification rules.
    /// </summary>
    Task<NotifyRuleListResponse> ListRulesAsync(
        NotifyRuleListRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Lists notification deliveries.
    /// </summary>
    Task<NotifyDeliveryListResponse> ListDeliveriesAsync(
        NotifyDeliveryListRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Gets a delivery by ID.
    /// </summary>
    Task<NotifyDeliveryDetail?> GetDeliveryAsync(
        string deliveryId,
        string? tenant,
        CancellationToken cancellationToken);

    /// <summary>
    /// Retries a failed delivery.
    /// </summary>
    Task<NotifyRetryResult> RetryDeliveryAsync(
        NotifyRetryRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Sends a notification.
    /// </summary>
    Task<NotifySendResult> SendAsync(
        NotifySendRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Simulate rule evaluation.
    /// </summary>
    Task<NotifySimulationResult> SimulateAsync(
        NotifySimulationRequest request,
        CancellationToken cancellationToken);

    /// <summary>
    /// Acknowledge an incident or signed token.
    /// </summary>
    Task<NotifyAckResult> AckAsync(
        NotifyAckRequest request,
        CancellationToken cancellationToken);
}