refactor(bot): restructure logging, utils, and event architecture

- **Directory Structure**: Reorganized `src/utils` and `src/events` into domain-specific subfolders (logging, jobs, moderation, guilds, channels, etc.) to reduce clutter.
- **Logging Refactor**: Split monolithic event handlers (ChannelUpdate, GuildUpdate) into the "Logic/Embeds/Utils" 3-file pattern for better readability and maintainability.
- **TypeScript Config**: Fixed path aliases to correctly resolve `@utils`, `@lib`, etc., in WebStorm and build tools.
- **Tooling**: Fixed `nodemon` watch scripts and resolved Prisma/Monorepo database connection issues.
- **Events**: grouped flat event files into resource-based folders (channels/, members/, etc.) and updated loader logic.

Author: arsabutispik

apps/bot/package.json

@@ -11,7 +11,7 @@
   },
   "scripts": {
     "deploy-commands": "tsc && tsc-alias && node --enable-source-maps dist/utils/deploy-commands.js",
-    "db:deploy": "pnpm -F @repo/database exec prisma migrate deploy",
+    "db:deploy": "pnpm -F @repo/database exec -- dotenv -e ../../.env -- prisma migrate deploy",
     "build": "pnpm run db:deploy && tsc && tsc-alias",
     "start": "node --enable-source-maps .",
     "validate-translations": "node scripts/ValidateI18nKeys.js",
@@ -50,6 +50,7 @@
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-jsonc": "^2.21.0",
     "globals": "^15.15.0",
+    "nodemon": "^3.1.11",
     "prettier": "^3.6.2",
     "ts-node": "^10.9.2",
     "tsc-alias": "^1.8.16",

apps/bot/src/config-functions/miscConfig.ts

@@ -6,7 +6,7 @@ import {
 } from "discord.js";
 import { GuildWithLogs, updateGuildConfig } from "@repo/database";
 import { dynamicChannel, dynamicMessage, waitForMessageComponent } from "./utils.js";
-import { localeFlags } from "src/constants/index.js";
+import { localeFlags } from "@constants";
 import { TFunction } from "i18next";
 
 export async function miscConfig(interaction: ChatInputCommandInteraction<"cached">, guildData: GuildWithLogs) {

apps/bot/src/config-functions/moderationConfig.ts

@@ -10,7 +10,7 @@ import {
 } from "discord.js";
 import { GuildWithLogs, updateGuildConfig } from "@repo/database";
 import { waitForMessageComponent, dynamicChannel, dynamicRole } from "./utils.js";
-import { logger } from "src/lib/Logger.js";
+import { logger } from "@lib";
 import { TFunction } from "i18next";
 
 export async function moderationConfig(interaction: ChatInputCommandInteraction<"cached">, guildData: GuildWithLogs) {

apps/bot/src/config-functions/roleConfig.ts

@@ -1,6 +1,6 @@
 import { ActionRowBuilder, ChatInputCommandInteraction, StringSelectMenuBuilder } from "discord.js";
 import { dynamicRole, waitForMessageComponent } from "./utils.js";
-import { RoleType } from "src/types/index.js";
+import { RoleType } from "@types";
 import { GuildWithLogs } from "@repo/database";
 
 export async function roleConfig(interaction: ChatInputCommandInteraction<"cached">, guildData: GuildWithLogs) {

apps/bot/src/config-functions/utils.ts

@@ -15,11 +15,11 @@ import {
   TextInputBuilder,
   TextInputStyle,
 } from "discord.js";
-import { logger } from "src/lib/index.js";
+import { logger } from "@lib";
 import { GuildWithLogs, updateGuildConfig } from "@repo/database";
-import { trimString, getCurrentValue, getUpdatePayload } from "src/utils/index.js";
+import { trimString, getCurrentValue, getUpdatePayload } from "@utils";
 import { TFunction } from "i18next";
-import { DbConfigKey } from "src/constants/index.js";
+import { DbConfigKey } from "@constants";
 export async function waitForMessageComponent(
   interaction: ChatInputCommandInteraction<"cached"> | StringSelectMenuInteraction<"cached">,
   actionRow: ActionRowBuilder<StringSelectMenuBuilder>,

apps/bot/src/events/autoModerationActionExecution.ts

@@ -1,6 +1,6 @@
-import type { EventBase } from "src/types/index.js";
+import type { EventBase } from "@types";
 import { AutoModerationActionType, Events, User } from "discord.js";
-import { modLog } from "src/utils/index.js";
+import { modLog } from "@utils";
 import dayjs from "dayjs";
 
 export default {

apps/bot/src/events/channelCreate.ts

@@ -1,16 +1,9 @@
-import { EventBase } from "src/types/index.js";
+import { EventBase } from "@types";
 import {
-  AuditLogEvent,
-  ChannelType,
-  EmbedBuilder,
   Events,
-  NonThreadGuildBasedChannel,
-  time,
-  TimestampStyles,
 } from "discord.js";
 import { getOrCreateGuild, GuildWithLogs } from "@repo/database";
-import { returnWebhook, sleep, WebhookType } from "src/utils/index.js";
-import { logger } from "src/lib/index.js";
+import { logChannelCreate } from "@utils";
 
 export default {
   name: Events.ChannelCreate,
@@ -20,58 +13,4 @@ export default {
     if (!guildConfig) return;
     await logChannelCreate(channel, guildConfig);
   },
-} satisfies EventBase<Events.ChannelCreate>;
-
-async function logChannelCreate(channel: NonThreadGuildBasedChannel, guildConfig: GuildWithLogs) {
-  if (!guildConfig.logConfig?.channelLogsChannelId) return;
-  const t = channel.client.i18next.getFixedT(guildConfig.language, "events", "channelCreate");
-  const logChannel = channel.guild.channels.cache.get(guildConfig.logConfig?.channelLogsChannelId);
-  if (logChannel?.type !== ChannelType.GuildText) return;
-
-  await sleep(2000); // Wait for 2 seconds to ensure audit logs are updated
-
-  const auditLogs = await channel.guild
-    .fetchAuditLogs({
-      limit: 1,
-      type: AuditLogEvent.ChannelCreate,
-    })
-    .catch(() => null);
-
-  const logEntry = auditLogs?.entries.first();
-  const executor = logEntry && logEntry.target?.id === channel.id ? logEntry.executor : null;
-
-  const embed = new EmbedBuilder()
-    .setColor("Green")
-    .setTitle(t("embed.title"))
-    .setDescription(
-      t("embed.description", {
-        channel: channel.toString(), // Explicitly stringify to <#ID>
-        channel_type: t(`channel_types.${channel.type}`),
-        timestamp: time(channel.createdAt, TimestampStyles.LongDateShortTime),
-      }),
-    )
-    .setThumbnail(channel.guild.iconURL() ?? null)
-    .setTimestamp()
-    .setFooter({
-      text: executor?.tag ?? t("unknown_executor"),
-      iconURL: executor?.displayAvatarURL() ?? undefined,
-    });
-
-  const webhook = await returnWebhook(channel.client, logChannel, channel.guildId, guildConfig, {
-    id: guildConfig.logConfig.channelLogsWebhookId,
-    type: WebhookType.CHANNEL_LOGS,
-  });
-  if (!webhook) return;
-  await webhook
-    .send({
-      embeds: [embed],
-    })
-    .catch((error) => {
-      logger.log({
-        level: "error",
-        error,
-        message: `Failed to send channelCreate embed in ${channel.guild.name} (${channel.guild.id})`,
-        channel: logChannel.id,
-      });
-    });
-}
+} satisfies EventBase<Events.ChannelCreate>;

apps/bot/src/events/channelDelete.ts

@@ -1,16 +1,9 @@
-import { EventBase } from "src/types/index.js";
+import { EventBase } from "@types";
 import {
-  AuditLogEvent,
-  ChannelType,
-  EmbedBuilder,
   Events,
-  NonThreadGuildBasedChannel,
-  time,
-  TimestampStyles,
 } from "discord.js";
-import { getOrCreateGuild, GuildWithLogs } from "@repo/database";
-import { returnWebhook, sleep, WebhookType } from "src/utils/index.js";
-import { logger } from "src/lib/index.js";
+import { getOrCreateGuild } from "@repo/database";
+import { logsChannelDelete } from "@utils";
 
 export default {
   name: Events.ChannelDelete,
@@ -21,57 +14,4 @@ export default {
     if (!guildConfig) return;
     await logsChannelDelete(channel, guildConfig);
   },
-} satisfies EventBase<Events.ChannelDelete>;
-
-async function logsChannelDelete(channel: NonThreadGuildBasedChannel, guildConfig: GuildWithLogs) {
-  if (!guildConfig.logConfig?.channelLogsChannelId) return;
-  const t = channel.client.i18next.getFixedT(guildConfig.language, "events", "channelDelete");
-  const logChannel = channel.guild.channels.cache.get(guildConfig.logConfig.channelLogsChannelId);
-  if (logChannel?.type !== ChannelType.GuildText) return;
-
-  await sleep(2000); // Wait for 2 seconds to ensure audit logs are updated
-
-  const auditLogs = await channel.guild
-    .fetchAuditLogs({
-      limit: 1,
-      type: AuditLogEvent.ChannelDelete,
-    })
-    .catch(() => null);
-  const logEntry = auditLogs?.entries.first();
-  const executor = logEntry && logEntry.target?.id === channel.id ? logEntry.executor : null;
-
-  const embed = new EmbedBuilder()
-    .setColor("Red")
-    .setTitle(t("embed.title"))
-    .setDescription(
-      t("embed.description", {
-        channel: channel,
-        channel_type: t(`channel_types.${channel.type}`),
-        timestamp: time(channel.createdAt, TimestampStyles.LongDateShortTime),
-      }),
-    )
-    .setThumbnail(channel.guild.iconURL() ?? null)
-    .setTimestamp()
-    .setFooter({
-      text: executor?.tag ?? t("unknown_executor"),
-      iconURL: executor?.displayAvatarURL() ?? undefined,
-    });
-
-  const webhook = await returnWebhook(channel.client, logChannel, channel.guildId, guildConfig, {
-    id: guildConfig.logConfig.channelLogsWebhookId,
-    type: WebhookType.CHANNEL_LOGS,
-  });
-  if (!webhook) return;
-  await webhook
-    .send({
-      embeds: [embed],
-    })
-    .catch((error) => {
-      logger.log({
-        level: "error",
-        error,
-        message: `Failed to send channelDelete embed in ${channel.guild.name} (${channel.guild.id})`,
-        channelId: logChannel.id,
-      });
-    });
-}
+} satisfies EventBase<Events.ChannelDelete>;