feat(switches): add SwitchEmbedRenderer (embed, control row, pairing prompt)

Author: HandyS11

src/RustPlusBot.Features.Switches/Rendering/SwitchEmbedRenderer.cs

@@ -0,0 +1,71 @@
+using Discord;
+using RustPlusBot.Domain.Switches;
+
+namespace RustPlusBot.Features.Switches.Rendering;
+
+/// <summary>Renders a Smart Switch as a Discord embed + control row, and the pairing-prompt embed + row. Pure.</summary>
+/// <param name="localizer">The switch localizer.</param>
+internal sealed class SwitchEmbedRenderer(ISwitchLocalizer localizer)
+{
+    /// <summary>Renders the switch embed and its control buttons. <paramref name="isActive"/> null ⇒ unreachable.</summary>
+    /// <param name="sw">The switch.</param>
+    /// <param name="isActive">On (true), off (false), or unreachable (null).</param>
+    /// <param name="culture">The guild culture.</param>
+    /// <returns>The embed and the component rows.</returns>
+    public (Embed Embed, MessageComponent Components) RenderSwitch(SmartSwitch sw, bool? isActive, string culture)
+    {
+        ArgumentNullException.ThrowIfNull(sw);
+        var unreachable = isActive is null;
+        var statusKey = isActive switch
+        {
+            true => "switch.status.on",
+            false => "switch.status.off",
+            null => "switch.status.unreachable",
+        };
+
+        var embed = new EmbedBuilder()
+            .WithTitle(sw.Name)
+            .WithDescription(localizer.Get(statusKey, culture))
+            .WithFooter(localizer.Get("switch.embed.footer", culture, sw.EntityId))
+            .Build();
+
+        var tail = $"{sw.ServerId}:{sw.EntityId}";
+        var components = new ComponentBuilder()
+            .WithButton(localizer.Get("switch.button.on", culture), SwitchComponentIds.OnPrefix + tail,
+                ButtonStyle.Success, disabled: unreachable || isActive == true)
+            .WithButton(localizer.Get("switch.button.off", culture), SwitchComponentIds.OffPrefix + tail,
+                ButtonStyle.Secondary, disabled: unreachable || isActive == false)
+            .WithButton(localizer.Get("switch.button.strobe", culture), SwitchComponentIds.StrobePrefix + tail,
+                ButtonStyle.Primary, disabled: unreachable)
+            .WithButton(localizer.Get("switch.button.rename", culture), SwitchComponentIds.RenamePrefix + tail,
+                ButtonStyle.Secondary, disabled: unreachable)
+            .Build();
+
+        return (embed, components);
+    }
+
+    /// <summary>Renders the transient "New switch detected — Add it?" prompt.</summary>
+    /// <param name="serverId">The server id.</param>
+    /// <param name="entityId">The entity id.</param>
+    /// <param name="defaultName">The generated default name.</param>
+    /// <param name="culture">The guild culture.</param>
+    /// <returns>The prompt embed and Accept/Dismiss row.</returns>
+    public (Embed Embed, MessageComponent Components) RenderPrompt(
+        Guid serverId, ulong entityId, string defaultName, string culture)
+    {
+        var embed = new EmbedBuilder()
+            .WithTitle(localizer.Get("switch.prompt.title", culture))
+            .WithDescription(localizer.Get("switch.prompt.body", culture, defaultName))
+            .Build();
+
+        var tail = $"{serverId}:{entityId}";
+        var components = new ComponentBuilder()
+            .WithButton(localizer.Get("switch.prompt.accept", culture), SwitchComponentIds.AcceptPrefix + tail,
+                ButtonStyle.Success)
+            .WithButton(localizer.Get("switch.prompt.dismiss", culture), SwitchComponentIds.DismissPrefix + tail,
+                ButtonStyle.Secondary)
+            .Build();
+
+        return (embed, components);
+    }
+}

tests/RustPlusBot.Features.Switches.Tests/SwitchEmbedRendererTests.cs

@@ -0,0 +1,73 @@
+using Discord;
+using RustPlusBot.Domain.Switches;
+using RustPlusBot.Features.Switches.Rendering;
+
+namespace RustPlusBot.Features.Switches.Tests;
+
+public sealed class SwitchEmbedRendererTests
+{
+    private static SwitchEmbedRenderer Create() =>
+        new(new SwitchLocalizer(SwitchLocalizationCatalog.Default));
+
+    private static SmartSwitch Sample(string name = "Front gate", bool lastActive = false) => new()
+    {
+        GuildId = 10UL, ServerId = Guid.NewGuid(), EntityId = 42UL, Name = name, LastIsActive = lastActive,
+    };
+
+    [Fact]
+    public void RenderSwitch_on_shows_on_status_and_off_button_enabled()
+    {
+        var (embed, components) = Create().RenderSwitch(Sample(), isActive: true, "en");
+
+        Assert.Contains("ON", embed.Description ?? embed.Title ?? string.Empty, StringComparison.Ordinal);
+        // Find the on/off buttons by custom id and assert disabled-state reflects current value.
+        var buttons = components.Components.OfType<ActionRowComponent>().SelectMany(r => r.Components).OfType<ButtonComponent>().ToList();
+        var onBtn = buttons.Single(b => b.CustomId!.StartsWith(SwitchComponentIds.OnPrefix, StringComparison.Ordinal));
+        var offBtn = buttons.Single(b => b.CustomId!.StartsWith(SwitchComponentIds.OffPrefix, StringComparison.Ordinal));
+        Assert.True(onBtn.IsDisabled);   // already on
+        Assert.False(offBtn.IsDisabled);
+    }
+
+    [Fact]
+    public void RenderSwitch_off_shows_off_status_and_on_button_enabled()
+    {
+        var (embed, components) = Create().RenderSwitch(Sample(), isActive: false, "en");
+
+        Assert.Contains("OFF", embed.Description ?? embed.Title ?? string.Empty, StringComparison.Ordinal);
+        var buttons = components.Components.OfType<ActionRowComponent>().SelectMany(r => r.Components).OfType<ButtonComponent>().ToList();
+        var onBtn = buttons.Single(b => b.CustomId!.StartsWith(SwitchComponentIds.OnPrefix, StringComparison.Ordinal));
+        var offBtn = buttons.Single(b => b.CustomId!.StartsWith(SwitchComponentIds.OffPrefix, StringComparison.Ordinal));
+        Assert.False(onBtn.IsDisabled);
+        Assert.True(offBtn.IsDisabled);  // already off
+    }
+
+    [Fact]
+    public void RenderSwitch_unreachable_disables_all_control_buttons()
+    {
+        var (embed, components) = Create().RenderSwitch(Sample(), isActive: null, "en");
+
+        Assert.Contains("Unreachable", embed.Description ?? string.Empty, StringComparison.Ordinal);
+        var buttons = components.Components.OfType<ActionRowComponent>().SelectMany(r => r.Components).OfType<ButtonComponent>().ToList();
+        Assert.All(buttons, b => Assert.True(b.IsDisabled));
+    }
+
+    [Fact]
+    public void RenderSwitch_french_uses_french_status()
+    {
+        var (embed, _) = Create().RenderSwitch(Sample(), isActive: true, "fr");
+        Assert.Contains("ALLUMÉ", embed.Description ?? string.Empty, StringComparison.Ordinal);
+    }
+
+    [Fact]
+    public void RenderPrompt_carries_accept_and_dismiss_with_identity_tail()
+    {
+        var serverId = Guid.NewGuid();
+        var (_, components) = Create().RenderPrompt(serverId, 42UL, "Switch 42", "en");
+
+        var buttons = components.Components.OfType<ActionRowComponent>().SelectMany(r => r.Components).OfType<ButtonComponent>().ToList();
+        Assert.Contains(buttons, b =>
+            b.CustomId == $"{SwitchComponentIds.AcceptPrefix}{serverId}:42");
+        Assert.Contains(buttons, b =>
+            b.CustomId == $"{SwitchComponentIds.DismissPrefix}{serverId}:42");
+    }
+}