up

src/Notifier/StellaOps.Notifier/StellaOps.Notifier.Worker/Channels/INotifyChannelAdapter.cs

@@ -0,0 +1,51 @@
+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
+    };
+}