Adds ping-protection module.

locales/en.json

@@ -928,5 +928,57 @@
     "nicknames": {
         "owner-cannot-be-renamed": "The owner of the server (%u) cannot be renamed.",
         "nickname-error": "An error occurred while trying to change the nickname of %u: %e"
-    }
+    },
+    "ping-protection": {
+    "not-a-member": "Punishment failed: The pinger is not a member.",
+    "punish-role-error": "Punishment failed: I cannot punish %tag because their role is higher than or equal to my highest role.",
+    "log-mute-success": "Muted %tag for %dur minutes because they exceeded the ping limit.",
+    "log-kick-success": "Kicked %tag because they exceeded the ping limit.",
+    "log-mute-error": "Punishment failed: I cannot mute %tag: %e",
+    "log-kick-error": "Punishment failed: I cannot kick %tag: %e",
+    "log-manual-delete": "All data for <@%u> (%u) has been deleted successfully.",
+    "log-manual-delete-logs": "All data for user with ID %u has been deleted successfully.",
+    "reason-basic": "User reached %c pings in the last %w weeks.",
+    "reason-advanced": "User reached %c pings in the last %d days (Custom timeframe).",
+    "cmd-desc-module": "Ping protection related commands",
+    "cmd-desc-group-user": "Every command related to the users",
+    "cmd-desc-history": "View the ping history of a user",
+    "cmd-opt-user": "The user to check",
+    "cmd-desc-actions": "View the moderation action history of a user",
+    "cmd-desc-panel": "Admin: Open the user management panel",
+    "cmd-desc-group-list": "Lists protected or whitelisted entities",
+    "cmd-desc-list-protected": "List all protected users and roles",
+    "cmd-desc-list-wl": "List all whitelisted roles and channels",
+    "embed-history-title": "Ping history of %u",
+    "embed-leaver-warning": "This user left the server at %t. These logs will stay until automatic deletion.",
+    "no-data-found": "No logs found for this user.",
+    "embed-actions-title": "Moderation history of %u",
+    "label-reason": "Reason",
+    "actions-retention-note": "Note: Moderation actions are retained for 1 - 12 months based on the configuration.",
+    "no-permission": "You don't have sufficient permissions to use this command.",
+    "panel-title": "User Panel: %u",
+    "panel-description": "Manage and view data for %u (%i). View a quick recap of their ping and moderation history, or delete all data stored for this user (Risky).",
+    "btn-history": "Ping history",
+    "btn-actions": "Actions history",
+    "btn-delete": "Delete all data (Risky)",
+    "list-protected-title": "Protected Users and Roles",
+    "list-protected-desc": "View all protected users and roles here. When someone pings one of these protected user(s)/role(s), a warning will be sent. Exceptions are whitelisted roles, and when sent in a whitelisted channel.",
+    "field-prot-users": "Protected Users",
+    "field-prot-roles": "Protected Roles",
+    "list-whitelist-title": "Whitelisted Roles and Channels",
+    "list-whitelist-desc": "View all whitelisted roles and channels here. Whitelisted roles will not get a warning for pinging a protected entity, and pings will be ignored in whitelisted channels.",
+    "field-wl-roles": "Whitelisted Roles",
+    "field-wl-channels": "Whitelisted Channels",
+    "list-none": "None are configured.",
+    "modal-title": "Confirm data deletion for this user",
+    "modal-label": "Confirm data deletion by typing this phrase:",
+    "modal-phrase": "I understand that all data of this user will be deleted and that this action cannot be undone.",
+    "modal-failed": "The phrase you entered is incorrect. Data deletion cancelled.",
+    "field-quick-history": "Quick history view (Last %w weeks)",
+    "field-quick-desc": "Pings history amount: %p\nModeration actions amount: %m",
+    "history-disabled": "History logging has been disabled by a bot-configurator.\nAre you (one of) the bot-configurators? You can enable history logging in the \"storage\" tab in the 'ping-protection' module ^^",
+    "leaver-warning-long": "User left at %d. These logs will stay until automatic deletion.",
+    "leaver-warning-short": "User left at %d.",
+    "warning-mod-disabled": "⚠️ **Moderation Actions are disabled!**\nYou can enable them in the dashboard under 'Moderation' to start logging punishments automatically."
+  }
 }

modules/ping-protection/commands/ping-protection.js

@@ -0,0 +1,206 @@
+const { 
+  fetchModHistory, 
+  getPingCountInWindow,
+  generateHistoryResponse,
+  generateActionsResponse
+} = require('../ping-protection');
+const { localize } = require('../../../src/functions/localize');
+const { ActionRowBuilder, ButtonBuilder, EmbedBuilder, ButtonStyle, MessageFlags } = require('discord.js');
+
+module.exports.run = async function (interaction) {
+  const group = interaction.options.getSubcommandGroup(false);
+  const sub = interaction.options.getSubcommand(false);
+
+  if (group) {
+    return module.exports.subcommands[group][sub](interaction);
+  }
+  return module.exports.subcommands[sub](interaction);
+};
+
+// Handles subcommands
+module.exports.subcommands = {
+  'user': {
+    'history': async function (interaction) {
+      const user = interaction.options.getUser('user');
+      const payload = await generateHistoryResponse(interaction.client, user.id, 1);
+      await interaction.reply(payload); 
+    },
+    'actions-history': async function (interaction) {
+      const user = interaction.options.getUser('user');
+      const payload = await generateActionsResponse(interaction.client, user.id, 1);
+      await interaction.reply(payload);
+    },
+    'panel': async function (interaction) {
+      const isAdmin = interaction.member.permissions.has('Administrator') || 
+                      (interaction.client.config.admins || []).includes(interaction.user.id);
+
+      if (!isAdmin) return interaction.reply({ 
+        content: localize('ping-protection', 'no-permission'), 
+        flags: MessageFlags.Ephemeral 
+      });
+
+      const user = interaction.options.getUser('user');
+      const pingerId = user.id;
+      const storageConfig = interaction.client.configurations['ping-protection']['storage'];
+      const retentionWeeks = (storageConfig && storageConfig.pingHistoryRetention) 
+        ? storageConfig.pingHistoryRetention 
+        : 12;
+      const timeframeDays = retentionWeeks * 7;
+
+      const pingCount = await getPingCountInWindow(interaction.client, pingerId, timeframeDays);
+      const modData = await fetchModHistory(interaction.client, pingerId, 1, 1000); 
+
+      const row = new ActionRowBuilder().addComponents(
+        new ButtonBuilder()
+            .setCustomId(`ping-protection_history_${user.id}`)
+            .setLabel(localize('ping-protection', 'btn-history'))
+            .setStyle(ButtonStyle.Secondary),
+        new ButtonBuilder()
+            .setCustomId(`ping-protection_actions_${user.id}`)
+            .setLabel(localize('ping-protection', 'btn-actions'))
+            .setStyle(ButtonStyle.Secondary),
+        new ButtonBuilder()
+            .setCustomId(`ping-protection_delete_${user.id}`)
+            .setLabel(localize('ping-protection', 'btn-delete'))
+            .setStyle(ButtonStyle.Danger)
+      );
+
+      const embed = new EmbedBuilder()
+        .setTitle(localize('ping-protection', 'panel-title', { u: user.tag }))
+        .setDescription(localize('ping-protection', 'panel-description', { u: user.toString(), i: user.id }))
+        .setColor('Blue')
+        .setThumbnail(user.displayAvatarURL({ dynamic: true }))
+        .addFields([{
+          name: localize('ping-protection', 'field-quick-history', { w: retentionWeeks }),
+          value: localize('ping-protection', 'field-quick-desc', { p: pingCount, m: modData.total }),
+          inline: false
+        }]);
+
+      await interaction.reply({ embeds: [embed.toJSON()], components: [row.toJSON()] });
+    }
+  },
+  'list': {
+    'protected': async function (interaction) {
+      await listHandler(interaction, 'protected');
+    },
+    'whitelisted': async function (interaction) {
+      await listHandler(interaction, 'whitelisted');
+    }
+  }
+};
+
+// Handles list subcommands
+async function listHandler(interaction, type) {
+  const config = interaction.client.configurations['ping-protection']['configuration'];
+  const embed = new EmbedBuilder()
+    .setColor('Green')
+    .setFooter({ 
+        text: interaction.client.strings.footer, 
+        iconURL: interaction.client.strings.footerImgUrl 
+    });
+
+  if (!interaction.client.strings.disableFooterTimestamp) embed.setTimestamp();
+
+  if (type === 'protected') {
+    embed.setTitle(localize('ping-protection', 'list-protected-title'));
+    embed.setDescription(localize('ping-protection', 'list-protected-desc'));
+
+    const usersList = config.protectedUsers.length > 0 
+      ? config.protectedUsers.map(id => `<@${id}>`).join('\n') 
+      : localize('ping-protection', 'list-none');
+
+    const rolesList = config.protectedRoles.length > 0 
+      ? config.protectedRoles.map(id => `<@&${id}>`).join('\n') 
+      : localize('ping-protection', 'list-none');
+
+    embed.addFields([
+      { name: localize('ping-protection', 'field-prot-users'), value: usersList, inline: true },
+      { name: localize('ping-protection', 'field-prot-roles'), value: rolesList, inline: true }
+    ]);
+
+  } else if (type === 'whitelisted') {
+    embed.setTitle(localize('ping-protection', 'list-whitelist-title'));
+    embed.setDescription(localize('ping-protection', 'list-whitelist-desc'));
+
+    const rolesList = config.ignoredRoles.length > 0 
+      ? config.ignoredRoles.map(id => `<@&${id}>`).join('\n') 
+      : localize('ping-protection', 'list-none');
+
+    const channelsList = config.ignoredChannels.length > 0 
+      ? config.ignoredChannels.map(id => `<#${id}>`).join('\n') 
+      : localize('ping-protection', 'list-none');
+
+    embed.addFields([
+      { name: localize('ping-protection', 'field-wl-roles'), value: rolesList, inline: true },
+      { name: localize('ping-protection', 'field-wl-channels'), value: channelsList, inline: true }
+    ]);
+  }
+
+  await interaction.reply({ embeds: [embed.toJSON()] });
+}
+
+module.exports.config = {
+  name: 'ping-protection',
+  description: localize('ping-protection', 'cmd-desc-module'), 
+  usage: '/ping-protection',
+  type: 'slash',
+  options: [
+    {
+            type: 'SUB_COMMAND_GROUP',
+            name: 'user',
+            description: localize('ping-protection', 'cmd-desc-group-user'),
+            options: [
+                {
+                    type: 'SUB_COMMAND',
+                    name: 'history',
+                    description: localize('ping-protection', 'cmd-desc-history'),
+                    options: [{
+                        type: 'USER',
+                        name: 'user',
+                        description: localize('ping-protection', 'cmd-opt-user'),
+                        required: true
+                    }]
+                },
+                {
+                    type: 'SUB_COMMAND',
+                    name: 'actions-history',
+                    description: localize('ping-protection', 'cmd-desc-actions'),
+                    options: [{
+                        type: 'USER',
+                        name: 'user',
+                        description: localize('ping-protection', 'cmd-opt-user'),
+                        required: true
+                    }]
+                },
+                {
+                    type: 'SUB_COMMAND',
+                    name: 'panel',
+                    description: localize('ping-protection', 'cmd-desc-panel'),
+                    options: [{
+                        type: 'USER',
+                        name: 'user',
+                        description: localize('ping-protection', 'cmd-opt-user'),
+                        required: true
+                    }]
+                }
+            ]
+        },
+        {
+            type: 'SUB_COMMAND_GROUP',
+            name: 'list',
+            description: localize('ping-protection', 'cmd-desc-group-list'),
+            options: [
+                {
+                    type: 'SUB_COMMAND',
+                    name: 'protected',
+                    description: localize('ping-protection', 'cmd-desc-list-protected')
+                },
+                {
+                    type: 'SUB_COMMAND',
+                    name: 'whitelisted',
+                    description: localize('ping-protection', 'cmd-desc-list-wl')
+                }
+            ]
+        }
+    ]
+};