feat(bot): implement report and cancel commands for user moderation

- Add `ReportCommand` class:
  - Introduced functionality for users to report messages to group admins.
  - Reports are sent only to admins without publicly tagging them, maintaining privacy.

- `report` method:
  - Allows users to report a message by replying to it.
  - Gathers reported user details, message link, and notifier information.
  - Collects admin mentions and prepares a formatted notification message.
  - Sends a confirmation message to the reporter about the report being queued.
  - Adds a 5-minute delay before sending the report to admins, allowing time for cancellation.
  - Stores pending reports in `pendingReports` using user IDs as keys and timeout IDs as values.

- `cancel` method:
  - Enables reporters to cancel their pending reports.
  - Checks if a report is queued for the user and clears the associated timeout.
  - Notifies the user if their report was successfully canceled or if no pending report exists.

- Enhancements:
  - Improved user experience with detailed notifications.
  - Ensured admins receive concise and well-formatted reports with clickable links to reported messages.
  - Prevents spamming admins with immediate reports by introducing a delay mechanism.

- Pending Reports:
  - Maintains a map of pending reports to manage and track active report requests.
  - Supports cleanup by removing processed or canceled reports.

- Future Improvements:
  - Extend moderation tools for admins, such as automated actions based on reports.
  - Add analytics or tracking for repeated offenses.

Author: m-mdy-m

src/bot/service/user/ReportCommand.ts

@@ -0,0 +1,80 @@
+import { Context } from 'grammy';
+import { BotReply } from '../../../utils/chat/BotReply';
+
+export class ReportCommand {
+  // Store pending reports with user IDs as keys
+  private static pendingReports = new Map<number, number>();
+
+  /**
+   * Sends a report to the group admins without publicly tagging them.
+   * If the report is canceled before notification, the message will be deleted.
+   *
+   * @param ctx - The context object containing information about the incoming update.
+   */
+  static async report(ctx: Context) {
+    const reply = new BotReply(ctx);
+
+    // Ensure the report command is a reply to another message
+    const reportedMessage = ctx.message?.reply_to_message;
+    if (!reportedMessage || !reportedMessage.from) {
+      await ctx.reply('Please use the /report command by replying to the message you want to report.');
+      return;
+    }
+
+    // Get reported user details
+    const reportedUser = reportedMessage.from;
+    const reportedUserName = reportedUser.first_name;
+    const reportedUserId = reportedUser.id;
+    const chatId = Math.abs(ctx.chat!.id + 1000000000000);
+    const messageLink = `https://t.me/c/${chatId}/${reportedMessage.message_id}`;
+    // Collect secret mentions of all admins
+    const admins = await ctx.api.getChatAdministrators(ctx.chat!.id);
+    const adminMentions = admins
+      .filter((admin) => !admin.user.is_bot)
+      .map((admin) => `<a href="tg://user?id=${admin.user.id}"> </a>`)
+      .join('');
+
+    // Format the report message for admins
+    const reportMessage = `
+<b>🚨 Report Notification</b>
+- Reported User: ${reportedUserName} (ID: ${reportedUserId})
+- Reported by: @${ctx.from?.username || ctx.from?.first_name} (ID: ${ctx.from?.id})
+- Message Link: <a href="${messageLink}">Click here to view the message</a>
+    `.trim();
+    const finalMessage = `${reportMessage}`;
+    // Notify the reporter
+    await reply.replyToMessage(`${reportedUserName}${adminMentions}(${reportedUserId}) was reported to administrators.`);
+
+    // Send the report to admins only after a delay, allowing time for cancellation
+    const delayForCancel = 300000; // 5 minutes (300,000 milliseconds)  delay for cancellation
+    const reportTimeout = setTimeout(async () => {
+      for (const admin of admins) {
+        if (admin.user.is_bot) continue;
+        await ctx.api.sendMessage(admin.user.id, finalMessage, { parse_mode: 'HTML' });
+      }
+      // Remove the report from pendingReports after sending
+      ReportCommand.pendingReports.delete(ctx.from!.id);
+    }, delayForCancel);
+
+    // Store the report with user ID and the setTimeout ID for canceling
+    ReportCommand.pendingReports.set(ctx.from!.id, Number(reportTimeout));
+  }
+
+  /**
+   * Cancels the pending report.
+   * If the report is canceled, it will not be sent to the admins.
+   *
+   * @param ctx - The context object containing information about the incoming update.
+   */
+  static async cancel(ctx: Context) {
+    const reply = new BotReply(ctx);
+    const reportTimeout = ReportCommand.pendingReports.get(ctx.from!.id);
+    if (reportTimeout) {
+      clearTimeout(reportTimeout);
+      ReportCommand.pendingReports.delete(ctx.from!.id);
+      await reply.textReply('Your report has been canceled and will not be sent to the admins.');
+    } else {
+      await reply.textReply('There is no report to cancel.');
+    }
+  }
+}