git.stella-ops.org/src/Notifier/StellaOps.Notifier/StellaOps.Notifier.Worker/Channels/INotifyChannelAdapter.cs

using StellaOps.Notify.Models;

namespace StellaOps.Notifier.Worker.Channels;

/// <summary>
/// Sends rendered notifications through a specific channel type.
/// </summary>
public interface INotifyChannelAdapter
{
    /// <summary>
    /// The channel type this adapter handles.
    /// </summary>
    NotifyChannelType ChannelType { get; }

    /// <summary>
    /// Sends a rendered notification through the channel.
    /// </summary>
    /// <param name="channel">The channel configuration.</param>
    /// <param name="rendered">The rendered notification content.</param>
    /// <param name="cancellationToken">Cancellation token.</param>
    /// <returns>The dispatch result with status and any error details.</returns>
    Task<ChannelDispatchResult> SendAsync(
        NotifyChannel channel,
        NotifyDeliveryRendered rendered,
        CancellationToken cancellationToken);
}

/// <summary>
/// Result of a channel dispatch attempt.
/// </summary>
public sealed record ChannelDispatchResult
{
    public required bool Success { get; init; }
    public int? StatusCode { get; init; }
    public string? Reason { get; init; }
    public bool ShouldRetry { get; init; }

    public static ChannelDispatchResult Ok(int? statusCode = null) => new()
    {
        Success = true,
        StatusCode = statusCode
    };

    public static ChannelDispatchResult Fail(string reason, int? statusCode = null, bool shouldRetry = true) => new()
    {
        Success = false,
        StatusCode = statusCode,
        Reason = reason,
        ShouldRetry = shouldRetry
    };
}