Catalogger.NET/Catalogger.Backend/Bot/Responders/Roles/RoleUpdateResponder.cs

// Copyright (C) 2021-present sam (starshines.gay)
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published
// by the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.

using Catalogger.Backend.Cache.InMemoryCache;
using Catalogger.Backend.Database.Repositories;
using Catalogger.Backend.Extensions;
using Catalogger.Backend.Services;
using Humanizer;
using Remora.Discord.API.Abstractions.Gateway.Events;
using Remora.Discord.API.Abstractions.Objects;
using Remora.Discord.Extensions.Embeds;
using Remora.Discord.Gateway.Responders;
using Remora.Results;

namespace Catalogger.Backend.Bot.Responders.Roles;

public class RoleUpdateResponder(
    ILogger logger,
    GuildRepository guildRepository,
    RoleCache roleCache,
    WebhookExecutorService webhookExecutor
) : IResponder<IGuildRoleUpdate>
{
    private readonly ILogger _logger = logger.ForContext<RoleUpdateResponder>();

    public async Task<Result> RespondAsync(IGuildRoleUpdate evt, CancellationToken ct = default)
    {
        using var _ = LogUtils.Enrich(evt);

        try
        {
            var newRole = evt.Role;

            if (!roleCache.TryGet(evt.Role.ID, out var oldRole))
            {
                _logger.Information(
                    "Received role update event for {RoleId} but it wasn't cached, ignoring",
                    evt.Role.ID
                );
                return Result.Success;
            }

            var embed = new EmbedBuilder()
                .WithTitle($"Role \"{evt.Role.Name}\" updated")
                .WithColour(DiscordUtils.Blue)
                .WithFooter($"ID: {evt.Role.ID}")
                .WithCurrentTimestamp();

            if (newRole.Name != oldRole.Name)
            {
                embed.AddField("Name", $"**Before:** {oldRole.Name}\n**After:** {newRole.Name}");
            }

            if (
                newRole.IsHoisted != oldRole.IsHoisted
                || newRole.IsMentionable != oldRole.IsMentionable
            )
            {
                embed.AddField(
                    "\u200b",
                    $"**Mentionable:** {newRole.IsMentionable}\n**Shown separately:** {newRole.IsHoisted}"
                );
            }

            if (newRole.Colour != oldRole.Colour)
            {
                embed.AddField(
                    "Colour",
                    $"**Before:** {oldRole.Colour.ToPrettyString()}\n**After:** {newRole.Colour.ToPrettyString()}"
                );
            }

            if (newRole.Permissions.Value != oldRole.Permissions.Value)
            {
                var diff = string.Join(
                    "\n",
                    PermissionUpdate(oldRole.Permissions, newRole.Permissions)
                );
                embed.AddField("Permissions", $"```diff\n{diff}\n```");
            }

            // All updates are shown in fields. If there are no fields, there were no updates we care about
            // (we don't care about position, for example, because it's not actually useful)
            if (embed.Fields.Count == 0)
                return Result.Success;

            var guildConfig = await guildRepository.GetAsync(evt.GuildID);
            webhookExecutor.QueueLog(
                webhookExecutor.GetLogChannel(
                    guildConfig,
                    LogChannelType.GuildRoleUpdate,
                    roleId: evt.Role.ID
                ),
                embed.Build().GetOrThrow()
            );
        }
        finally
        {
            roleCache.Set(evt.Role, evt.GuildID);
        }

        return Result.Success;
    }

    private static IEnumerable<string> PermissionUpdate(
        IDiscordPermissionSet oldValue,
        IDiscordPermissionSet newValue
    )
    {
        foreach (var perm in Enum.GetValues<DiscordPermission>())
        {
            if (!oldValue.HasPermission(perm) && newValue.HasPermission(perm))
            {
                yield return $"+ {perm.Humanize(LetterCasing.Title)}";
            }
            else if (oldValue.HasPermission(perm) && !newValue.HasPermission(perm))
            {
                yield return $"- {perm.Humanize(LetterCasing.Title)}";
            }
        }
    }
}