feat(devices): persist per-device Reachability (+ migration, store mutators)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: HandyS11

src/RustPlusBot.Domain/Alarms/SmartAlarm.cs

@@ -1,3 +1,5 @@
+using RustPlusBot.Abstractions.Connections;
+
 namespace RustPlusBot.Domain.Alarms;
 
 /// <summary>A paired Smart Alarm the bot manages, surviving restarts. Guild- and server-scoped. Driven by the live socket (primed on connect, reacts to SmartDeviceTriggered) — the entity id is the switch-vs-alarm discriminant.</summary>
@@ -38,4 +40,7 @@ public sealed class SmartAlarm
 
     /// <summary>When the alarm most recently went active (UTC), or null if never triggered.</summary>
     public DateTimeOffset? LastTriggeredUtc { get; set; }
+
+    /// <summary>Per-device reachability; defaults to Reachable. Orthogonal to whole-server connection status.</summary>
+    public DeviceReachability Reachability { get; set; } = DeviceReachability.Reachable;
 }

src/RustPlusBot.Domain/StorageMonitors/SmartStorageMonitor.cs

@@ -1,3 +1,5 @@
+using RustPlusBot.Abstractions.Connections;
+
 namespace RustPlusBot.Domain.StorageMonitors;
 
 /// <summary>A paired Smart Storage Monitor the bot manages, surviving restarts. Guild- and server-scoped.</summary>
@@ -26,4 +28,7 @@ public sealed class SmartStorageMonitor
 
     /// <summary>When the monitor was accepted (UTC).</summary>
     public DateTimeOffset CreatedUtc { get; set; }
+
+    /// <summary>Per-device reachability; defaults to Reachable. Orthogonal to whole-server connection status.</summary>
+    public DeviceReachability Reachability { get; set; } = DeviceReachability.Reachable;
 }

src/RustPlusBot.Domain/Switches/SmartSwitch.cs

@@ -1,3 +1,5 @@
+using RustPlusBot.Abstractions.Connections;
+
 namespace RustPlusBot.Domain.Switches;
 
 /// <summary>A paired Smart Switch the bot manages, surviving restarts. Guild- and server-scoped.</summary>
@@ -29,4 +31,7 @@ public sealed class SmartSwitch
 
     /// <summary>When the switch was accepted (UTC).</summary>
     public DateTimeOffset CreatedUtc { get; set; }
+
+    /// <summary>Per-device reachability; defaults to Reachable. Orthogonal to whole-server connection status.</summary>
+    public DeviceReachability Reachability { get; set; } = DeviceReachability.Reachable;
 }

src/RustPlusBot.Persistence/Alarms/AlarmStore.cs

@@ -1,4 +1,5 @@
 using Microsoft.EntityFrameworkCore;
+using RustPlusBot.Abstractions.Connections;
 using RustPlusBot.Abstractions.Time;
 using RustPlusBot.Domain.Alarms;
 
@@ -136,6 +137,15 @@ public Task UpdateStateAsync(
             }
         }, ct);
 
+    /// <inheritdoc />
+    public Task SetReachabilityAsync(
+        ulong guildId,
+        Guid serverId,
+        ulong entityId,
+        DeviceReachability reachability,
+        CancellationToken ct = default) =>
+        MutateAsync(guildId, serverId, entityId, a => a.Reachability = reachability, ct);
+
     /// <inheritdoc />
     public async Task RemoveAsync(
         ulong guildId,

src/RustPlusBot.Persistence/Alarms/IAlarmStore.cs

@@ -1,3 +1,4 @@
+using RustPlusBot.Abstractions.Connections;
 using RustPlusBot.Domain.Alarms;
 
 namespace RustPlusBot.Persistence.Alarms;
@@ -127,6 +128,20 @@ Task UpdateStateAsync(
         DateTimeOffset? triggeredUtc,
         CancellationToken ct = default);
 
+    /// <summary>Sets a device's reachability (no-op if absent).</summary>
+    /// <param name="guildId">Owning Discord guild snowflake.</param>
+    /// <param name="serverId">The Rust server id.</param>
+    /// <param name="entityId">The in-game smart-alarm entity id.</param>
+    /// <param name="reachability">The new reachability value.</param>
+    /// <param name="ct">A cancellation token.</param>
+    /// <returns>A task that completes when the reachability has been persisted.</returns>
+    Task SetReachabilityAsync(
+        ulong guildId,
+        Guid serverId,
+        ulong entityId,
+        DeviceReachability reachability,
+        CancellationToken ct = default);
+
     /// <summary>Removes an alarm (no-op if absent).</summary>
     /// <param name="guildId">Owning Discord guild snowflake.</param>
     /// <param name="serverId">The Rust server id.</param>

src/RustPlusBot.Persistence/Configurations/SmartAlarmConfiguration.cs

@@ -1,5 +1,6 @@
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using RustPlusBot.Abstractions.Connections;
 using RustPlusBot.Domain.Alarms;
 using RustPlusBot.Domain.Servers;
 
@@ -17,6 +18,10 @@ public void Configure(EntityTypeBuilder<SmartAlarm> builder)
             a.GuildId, a.ServerId, a.EntityId
         }).IsUnique();
 
+        builder.Property(a => a.Reachability)
+            .HasConversion<int>()
+            .HasDefaultValue(DeviceReachability.Reachable);
+
         // Removing a RustServer cascades to its alarms so no orphaned rows linger.
         builder.HasOne<RustServer>()
             .WithMany()

src/RustPlusBot.Persistence/Configurations/SmartStorageMonitorConfiguration.cs

@@ -1,5 +1,6 @@
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using RustPlusBot.Abstractions.Connections;
 using RustPlusBot.Domain.Servers;
 using RustPlusBot.Domain.StorageMonitors;
 
@@ -17,6 +18,10 @@ public void Configure(EntityTypeBuilder<SmartStorageMonitor> builder)
             s.GuildId, s.ServerId, s.EntityId
         }).IsUnique();
 
+        builder.Property(s => s.Reachability)
+            .HasConversion<int>()
+            .HasDefaultValue(DeviceReachability.Reachable);
+
         // Removing a RustServer cascades to its storage monitors so no orphaned rows linger.
         builder.HasOne<RustServer>()
             .WithMany()

src/RustPlusBot.Persistence/Configurations/SmartSwitchConfiguration.cs

@@ -1,5 +1,6 @@
 using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using RustPlusBot.Abstractions.Connections;
 using RustPlusBot.Domain.Servers;
 using RustPlusBot.Domain.Switches;
 
@@ -17,6 +18,10 @@ public void Configure(EntityTypeBuilder<SmartSwitch> builder)
             s.GuildId, s.ServerId, s.EntityId
         }).IsUnique();
 
+        builder.Property(s => s.Reachability)
+            .HasConversion<int>()
+            .HasDefaultValue(DeviceReachability.Reachable);
+
         // Removing a RustServer cascades to its switches so no orphaned rows linger.
         builder.HasOne<RustServer>()
             .WithMany()