refactor: atomic, DRY, and logging improvements

- Shared Redis channel constants as single source of truth (redis-channels.ts) - commandHandler.ts split into VoiceHandler, MediaHandler, GuildHandler, ModerationHandler with handler-registry.ts dispatch - messageStore.ts (1322 lines) split into domain-specific DB files: messages.db.ts, attachments.db.ts, reviews.db.ts, moderation-actions.db.ts, retention.db.ts - recorder.ts startSpeaking callback extracted into speakingHandler.ts, streamSetup.ts, segmentFinalizer.ts - autoDeleteManager.ts split into autoDeleteEligibility.ts, autoDeleteNotify.ts, autoDeleteLogger.ts - Added createChildLogger() logging across 8 service files - Backend messages.repository.ts migrated from raw SQL to Drizzle ORM - Fixed biome.json to exclude packages/**/dist/* from lint - Fixed config.ts GUILD_ID pre-existing type error Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 17:34:18 +07:00
parent 7108f6bb47
commit b68789fffc
37 changed files with 3620 additions and 2345 deletions
@@ -0,0 +1,185 @@
+import { createChildLogger, type Logger } from "@bete/shared/logger";
+import { and, desc, eq, inArray, or, type SQL } from "drizzle-orm";
+import type { NodePgDatabase } from "drizzle-orm/node-postgres";
+import type * as schema from "../../shared/database/schema.js";
+import { attachmentsTable } from "../../shared/database/schema.js";
+import type { AttachmentRecord } from "../message-capture/types.js";
+
+// ─── AttachmentsDb Class ────────────────────────────────────────────────────
+
+export class AttachmentsDb {
+  private logger: Logger;
+
+  constructor(
+    private db: NodePgDatabase<typeof schema>,
+    _parentLogger?: Logger,
+  ) {
+    this.logger = createChildLogger("attachments-db");
+  }
+
+  async insertAttachment(attachment: AttachmentRecord): Promise<void> {
+    this.logger.debug(
+      { attachmentId: attachment.id },
+      "insertAttachment entry",
+    );
+    try {
+      await this.db
+        .insert(attachmentsTable)
+        .values(attachment)
+        .onConflictDoNothing();
+    } catch (error) {
+      this.logger.error(
+        {
+          attachmentId: attachment.id,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to insert attachment",
+      );
+      throw error;
+    }
+  }
+
+  async getAttachmentsByChannel(
+    channelId: string,
+    limit: number = 50,
+    offset: number = 0,
+    guildId?: string,
+  ): Promise<AttachmentRecord[]> {
+    this.logger.debug(
+      { channelId, limit, offset },
+      "getAttachmentsByChannel entry",
+    );
+    try {
+      const conditions: SQL[] = [
+        or(
+          eq(attachmentsTable.channel_id, channelId),
+          eq(attachmentsTable.thread_id, channelId),
+        ) as SQL,
+      ];
+
+      if (guildId) {
+        conditions.push(eq(attachmentsTable.guild_id, guildId));
+      }
+
+      const rows = await this.db
+        .select()
+        .from(attachmentsTable)
+        .where(and(...conditions))
+        .orderBy(desc(attachmentsTable.created_at))
+        .limit(limit)
+        .offset(offset);
+
+      return rows as AttachmentRecord[];
+    } catch (error) {
+      this.logger.error(
+        {
+          channelId,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to get attachments by channel",
+      );
+      throw error;
+    }
+  }
+
+  async updateAttachmentAsUploaded(
+    attachmentId: string,
+    uploadedUrl: string,
+    uploadedAt: number,
+  ): Promise<void> {
+    this.logger.debug({ attachmentId }, "updateAttachmentAsUploaded entry");
+    try {
+      await this.db
+        .update(attachmentsTable)
+        .set({
+          uploaded_url: uploadedUrl,
+          upload_status: "uploaded",
+          uploaded_at: uploadedAt,
+        })
+        .where(eq(attachmentsTable.id, attachmentId));
+    } catch (error) {
+      this.logger.error(
+        {
+          attachmentId,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to update attachment as uploaded",
+      );
+      throw error;
+    }
+  }
+
+  async updateAttachmentDiscordUrl(
+    attachmentId: string,
+    discordUrl: string,
+  ): Promise<void> {
+    this.logger.debug({ attachmentId }, "updateAttachmentDiscordUrl entry");
+    try {
+      await this.db
+        .update(attachmentsTable)
+        .set({ discord_url: discordUrl })
+        .where(eq(attachmentsTable.id, attachmentId));
+    } catch (error) {
+      this.logger.error(
+        {
+          attachmentId,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to update attachment Discord URL",
+      );
+      throw error;
+    }
+  }
+
+  async updateAttachmentAsFailedUpload(
+    attachmentId: string,
+    error: string,
+  ): Promise<void> {
+    this.logger.debug({ attachmentId }, "updateAttachmentAsFailedUpload entry");
+    try {
+      await this.db
+        .update(attachmentsTable)
+        .set({
+          upload_status: "failed",
+          upload_error: error,
+        })
+        .where(eq(attachmentsTable.id, attachmentId));
+    } catch (error) {
+      this.logger.error(
+        {
+          attachmentId,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to update attachment as failed",
+      );
+      throw error;
+    }
+  }
+
+  async getAttachmentsForMessages(
+    messageIds: string[],
+  ): Promise<AttachmentRecord[]> {
+    this.logger.debug(
+      { messageIdsCount: messageIds.length },
+      "getAttachmentsForMessages entry",
+    );
+    try {
+      if (messageIds.length === 0) return [];
+      const rows = await this.db
+        .select()
+        .from(attachmentsTable)
+        .where(inArray(attachmentsTable.message_id, messageIds));
+
+      return rows as AttachmentRecord[];
+    } catch (error) {
+      this.logger.error(
+        {
+          messageIds,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to get attachments for messages",
+      );
+      throw error;
+    }
+  }
+}