feat: Implement general bot commands and date handling

- Added `GeneralCommands` class to handle common bot commands such as help, start, commands, and bot info retrieval.
- Implemented the `date` command to display both Gregorian and Persian dates.
- Introduced `DateCommand` class with methods to format and convert dates to Gregorian and Persian formats.
- Incorporated timezone adjustments for Tehran time zone and Persian date conversion.
- Added error handling for bot commands using the `@Catch` decorator to manage failures gracefully.
- Updated `BotInfo.json` and `BotMessages.json` for dynamic bot response generation.

This commit includes functionality for retrieving and displaying bot help, commands, and bot information, along with Persian date formatting.

Author: m-mdy-m

src/bot/commands/genearl/GeneralCommands.ts

@@ -0,0 +1,129 @@
+import { Context } from 'grammy';
+import { Catch } from '../../../decorators/ErrorHandlingDecorator';
+import { BotReply } from '../../../utils/chat/BotReply';
+import { help, start, commands } from '../../../utils/jsons/botMessages.json';
+import { ChatInfo } from '../../../utils/chat/ChatInfo';
+import { DateCommand } from './date';
+import { info, user_support } from '../../../../docs/BotInfo.json';
+/**
+ * Reason for lowercase command names:
+ *
+ * Since the names of all commands are written in lowercase for uniformity,
+ * and the commands are automatically generated, I needed to ensure that commands
+ * can be triggered in any case (e.g., "getBotInfo", "Getbotinfo", or "getbotinfo").
+ * To achieve this, I converted all command names to lowercase.
+ * This way, the system can recognize commands regardless of the case
+ * the user enters, providing a consistent user experience.
+ *
+ * Code for handling case-insensitivity bot/bot.ts
+ */
+export class GeneralCommands {
+  static getMessage(ctx: Context): { commands: string; help: string; start: string } {
+    const chatInfo = new ChatInfo(ctx);
+    const chattype = chatInfo.getChatType();
+    if (chattype === 'private') {
+      return {
+        help: help.general,
+        commands: commands.private,
+        start: start.Private,
+      };
+    }
+    return {
+      commands: commands.public,
+      help: help.general,
+      start: start.gorup,
+    };
+  }
+  // === General Command Handlers ===
+  @Catch({
+    message: 'Error displaying help message. Please try again later.',
+    category: 'Bot',
+    statusCode: 500,
+  })
+  public static async help(ctx: Context) {
+    const reply = new BotReply(ctx);
+    const { help } = GeneralCommands.getMessage(ctx);
+    const sanitizedHelp = help.replace(/([_*[\]()~`>#+\-=|{}.!])/g, '\\$1');
+    await reply.markdownReply(sanitizedHelp);
+  }
+
+  @Catch({
+    message: 'Error starting the bot. Please try again later.',
+    category: 'Bot',
+    statusCode: 500,
+  })
+  public static async start(ctx: Context) {
+    const reply = new BotReply(ctx);
+    const { start } = GeneralCommands.getMessage(ctx);
+    await reply.textReply(start);
+  }
+
+  @Catch({
+    message: 'Error retrieving the date. Please try again later.',
+    category: 'Bot',
+    statusCode: 500,
+  })
+  public static async date(ctx: Context) {
+    const reply = new BotReply(ctx);
+    const { gregorianDate, persianDate } = await DateCommand.date();
+    const message = `
+🌍 **Gregorian Date**:
+  ${gregorianDate}
+
+🌍 **Persian Date**:
+  ${persianDate}
+`;
+    reply.markdownReply(message);
+  }
+
+  static async commands(ctx: Context) {
+    const reply = new BotReply(ctx);
+    const { commands } = GeneralCommands.getMessage(ctx);
+    await reply.textReply(commands);
+  }
+  @Catch({
+    message: 'Error retrieving support contact information. Please try again later.',
+    category: 'Bot',
+    statusCode: 500,
+  })
+  /** viewSupportContact */
+  public static async viewsupportcontact(ctx: Context) {
+    const reply = new BotReply(ctx);
+
+    // Contact information from BotInfo.json
+    const contactMessage = `
+**Help Contact**: ${user_support.help_contact}\n\r
+**Support Email**: ${user_support.support_email}
+**Support Groups**:
+    ${user_support.support_groups.map((group) => `- ${group.name}: ${group.link}`).join('\n')}
+
+Please reach out to us for assistance.
+    `;
+    await reply.markdownReply(contactMessage);
+  }
+  @Catch({
+    message: 'Error retrieving bot information. Please try again later.',
+    category: 'Bot',
+    statusCode: 500,
+  })
+  /** getBotInfo */
+  public static async getbotinfo(ctx: Context) {
+    const reply = new BotReply(ctx);
+
+    // Extract detailed information from BotInfo.json
+    const botInfoMessage = `
+    **Bot Information**:
+    - **Name**: ${info.bot_name}
+    - **Version**: ${info.bot_version}
+    - **Status**: ${info.bot_status}
+    - **Creation Date**: ${new Date(info.created_at).toLocaleString()}
+    - **Last Updated**: ${new Date(info.last_update).toLocaleString()}
+    - **Supported Languages**: ${info.supported_languages.join(', ')}
+
+**Description**: ${info.description}
+    
+This bot is designed to deliver fast and secure responses to users.
+    `;
+    await reply.markdownReply(botInfoMessage);
+  }
+}

src/bot/commands/genearl/date.ts

@@ -0,0 +1,84 @@
+import { Context } from 'grammy';
+import { Catch } from '../../../decorators/ErrorHandlingDecorator';
+export function tehranZone() {
+  // Get current date and adjust to Tehran time zone
+  const now = new Date();
+  const utcTime = now.getTime() + now.getTimezoneOffset() * 60000;
+
+  // Tehran timezone offset in minutes (UTC+3:30)
+  const tehranOffset = 3.5 * 60;
+
+  // Adjust time to Tehran timezone without considering DST
+  return new Date(utcTime + tehranOffset * 60000);
+}
+export class DateCommand {
+  @Catch()
+  static async date(): Promise<{
+    gregorianDate: string;
+    persianDate: string;
+  }> {
+    const tehranTime = tehranZone();
+    // Format Gregorian Date
+    const gregorianDate = this.formatGregorianDate(tehranTime);
+    // Convert to Persian Date
+    const persianDate = this.convertToPersianDate(tehranTime);
+    return {
+      gregorianDate,
+      persianDate,
+    };
+  }
+  static formatGregorianDate(date: Date): string {
+    const days = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+    const months = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
+
+    const dayName = days[date.getDay()];
+    const day = date.getDate();
+    const monthName = months[date.getMonth()];
+    const year = date.getFullYear();
+    const hours = date.getHours().toString().padStart(2, '0');
+    const minutes = date.getMinutes().toString().padStart(2, '0');
+
+    return `${dayName}, ${monthName} ${day}, ${year}, time: ${hours}:${minutes}`;
+  }
+
+  static convertToPersianDate(date: Date): string {
+    // Gy: Gregorian year
+    // Gm: Gregorian month (1-12)
+    // Gd: Gregorian day of the month (1-31)
+    const persianDate = this.toJalaali(date.getFullYear(), date.getMonth() + 1, date.getDate());
+    const persianDays = ['شنبه', 'یکشنبه', 'دوشنبه', 'سه‌شنبه', 'چهارشنبه', 'پنج‌شنبه', 'جمعه'];
+
+    const persianMonths = ['فروردین', 'اردیبهشت', 'خرداد', 'تیر', 'مرداد', 'شهریور', 'مهر', 'آبان', 'آذر', 'دی', 'بهمن', 'اسفند'];
+    const dayName = Number(date.getDay() + 1) >= 7 ? persianDays[date.getDay() - 6] : persianDays[date.getDay() + 1];
+    const hours = date.getHours().toString().padStart(2, '0');
+    const minutes = date.getMinutes().toString().padStart(2, '0');
+
+    return `${dayName} ${persianDate.jd} ${persianMonths[persianDate.jm - 1]} ${persianDate.jy} ساعت: ${hours}:${minutes}`;
+  }
+
+  static toJalaali(gy: number, gm: number, gd: number) {
+    const g_d_m = [0, 31, (gy % 4 === 0 && gy % 100 !== 0) || gy % 400 === 0 ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+    let gy2 = gm > 2 ? gy + 1 : gy;
+    let days = 355666 + 365 * gy + Math.floor((gy2 + 3) / 4) - Math.floor((gy2 + 99) / 100) + Math.floor((gy2 + 399) / 400) + gd;
+
+    for (let i = 0; i < gm; ++i) days += g_d_m[i];
+
+    let jy = -1595 + 33 * Math.floor(days / 12053);
+    days %= 12053;
+
+    jy += 4 * Math.floor(days / 1461);
+    days %= 1461;
+
+    if (days > 365) {
+      jy += Math.floor((days - 1) / 365);
+      days = (days - 1) % 365;
+    }
+
+    // Month Calculation
+    const jm = days < 186 ? 1 + Math.floor(days / 31) : 7 + Math.floor((days - 186) / 30);
+
+    // Day Calculation
+    const jd = days < 186 ? days % 31 : (days - 186) % 30;
+    return { jy, jm, jd };
+  }
+}