up

src/Signals/StellaOps.Signals/Options/SignalsEventsOptions.cs

@@ -13,7 +13,7 @@ public sealed class SignalsEventsOptions
     public bool Enabled { get; set; } = true;
 
     /// <summary>
-    /// Transport driver: "inmemory" or "redis".
+    /// Transport driver: "inmemory", "redis", or "router".
     /// </summary>
     public string Driver { get; set; } = "inmemory";
 
@@ -62,6 +62,11 @@ public sealed class SignalsEventsOptions
     /// </summary>
     public string DefaultTenant { get; set; } = "tenant-default";
 
+    /// <summary>
+    /// Router transport configuration (when Driver=router).
+    /// </summary>
+    public SignalsRouterEventsOptions Router { get; } = new();
+
     public void Validate()
     {
         var normalizedDriver = Driver?.Trim();
@@ -71,9 +76,10 @@ public sealed class SignalsEventsOptions
         }
 
         if (!string.Equals(normalizedDriver, "redis", StringComparison.OrdinalIgnoreCase)
-            && !string.Equals(normalizedDriver, "inmemory", StringComparison.OrdinalIgnoreCase))
+            && !string.Equals(normalizedDriver, "inmemory", StringComparison.OrdinalIgnoreCase)
+            && !string.Equals(normalizedDriver, "router", StringComparison.OrdinalIgnoreCase))
         {
-            throw new InvalidOperationException("Signals events driver must be 'redis' or 'inmemory'.");
+            throw new InvalidOperationException("Signals events driver must be 'redis', 'router', or 'inmemory'.");
         }
 
         if (string.IsNullOrWhiteSpace(Stream))
@@ -101,5 +107,23 @@ public sealed class SignalsEventsOptions
         {
             throw new InvalidOperationException("Signals events Redis driver requires ConnectionString.");
         }
+
+        if (string.Equals(normalizedDriver, "router", StringComparison.OrdinalIgnoreCase))
+        {
+            if (string.IsNullOrWhiteSpace(Router.BaseUrl))
+            {
+                throw new InvalidOperationException("Signals events router driver requires BaseUrl.");
+            }
+
+            if (string.IsNullOrWhiteSpace(Router.Path))
+            {
+                throw new InvalidOperationException("Signals events router driver requires Path.");
+            }
+
+            if (Router.TimeoutSeconds < 0)
+            {
+                throw new InvalidOperationException("Signals events router timeout must be >= 0 seconds.");
+            }
+        }
     }
 }

src/Signals/StellaOps.Signals/Options/SignalsRouterEventsOptions.cs

@@ -0,0 +1,42 @@
+namespace StellaOps.Signals.Options;
+
+/// <summary>
+/// Router event transport configuration for reachability fact updates.
+/// </summary>
+public sealed class SignalsRouterEventsOptions
+{
+    /// <summary>
+    /// Base URL for the StellaOps Router gateway (HTTP ingress).
+    /// </summary>
+    public string BaseUrl { get; set; } = "https://gateway.stella-ops.local";
+
+    /// <summary>
+    /// Relative path that receives fact update envelopes.
+    /// </summary>
+    public string Path { get; set; } = "/router/events/signals.fact.updated";
+
+    /// <summary>
+    /// Optional API key value used for gateway authentication.
+    /// </summary>
+    public string? ApiKey { get; set; }
+
+    /// <summary>
+    /// Header name that carries the API key when set.
+    /// </summary>
+    public string ApiKeyHeader { get; set; } = "X-API-Key";
+
+    /// <summary>
+    /// Optional additional header passed with every publish (key/value).
+    /// </summary>
+    public Dictionary<string, string> Headers { get; set; } = new(StringComparer.OrdinalIgnoreCase);
+
+    /// <summary>
+    /// Publish timeout in seconds. 0 disables the timeout.
+    /// </summary>
+    public int TimeoutSeconds { get; set; } = 5;
+
+    /// <summary>
+    /// Allow self-signed TLS when talking to the gateway (development only).
+    /// </summary>
+    public bool AllowInsecureTls { get; set; }
+}