refactor: atomic, DRY, and logging improvements across codebase

- Split llmModerationClient.ts (2170 lines) into 5 focused sub-modules - Split aiAnalyzer.ts (1282 lines) into 4 modular pipelines - Split messages.db.ts (826 lines) into 5 domain-specific modules - Moved shared schema to @bete/shared, eliminated backend duplication - Added createChildLogger to all voice-recording and AI moderation modules - Extracted tryCommandThenFallback, normalizeMediaState, DEFAULT_VOICE_STATUS - Created shared pagination.ts utility, eliminated 5+ cursor-pagination duplications - Created shared messageMapper.ts for row mapping - Standardized backend error handling with asyncHandler - Added frontend createLogger utility and useAsyncAction hook - Added structured logging to frontend hooks, socket, and API client Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 19:46:08 +07:00
parent b68789fffc
commit 07032ab521
61 changed files with 3808 additions and 3043 deletions
@@ -0,0 +1,100 @@
+import { decodeCursor, encodeCursor, pageResult } from "@bete/shared";
+import { createChildLogger, type Logger } from "@bete/shared/logger";
+import { and, desc, eq, type SQL, sql } from "drizzle-orm";
+import type { NodePgDatabase } from "drizzle-orm/node-postgres";
+import type * as schema from "../../shared/database/schema.js";
+import { messagesTable } from "../../shared/database/schema.js";
+import type {
+  MessageQuery,
+  MessageRecord,
+  PageResult,
+} from "../message-capture/types.js";
+import { channelOrThreadCondition } from "./messages.crud.js";
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+export function buildListMessageConditions(query: MessageQuery): SQL[] {
+  const conditions: SQL[] = [];
+
+  if (query.guildId) {
+    conditions.push(eq(messagesTable.guild_id, query.guildId));
+  }
+
+  if (query.channelId) {
+    conditions.push(channelOrThreadCondition(query.channelId));
+  }
+
+  if (query.threadId) {
+    conditions.push(eq(messagesTable.thread_id, query.threadId));
+  }
+
+  if (query.userId) {
+    conditions.push(eq(messagesTable.user_id, query.userId));
+  }
+
+  if (query.status && query.status.length > 0) {
+    conditions.push(sql`${messagesTable.ai_status} in ${query.status}`);
+  }
+
+  if (query.q) {
+    const pattern = `%${query.q.toLowerCase()}%`;
+    conditions.push(sql`lower(${messagesTable.content}) like ${pattern}`);
+  }
+
+  const cursorData = decodeCursor(query.cursor);
+  if (cursorData) {
+    conditions.push(
+      sql`(${messagesTable.created_at} < ${cursorData.created_at} or (${messagesTable.created_at} = ${cursorData.created_at} and ${messagesTable.id} < ${cursorData.id}))`,
+    );
+  }
+
+  return conditions;
+}
+
+const pageRows = pageResult;
+
+// ─── MessagesPagination Class ────────────────────────────────────────────────
+
+export class MessagesPagination {
+  private logger: Logger;
+
+  constructor(
+    private db: NodePgDatabase<typeof schema>,
+    _parentLogger?: Logger,
+  ) {
+    this.logger = createChildLogger("messages-pagination");
+  }
+
+  async listMessages(query: MessageQuery): Promise<PageResult<MessageRecord>> {
+    this.logger.debug({ query }, "listMessages entry");
+    try {
+      const conditions = buildListMessageConditions(query);
+      const rows = await this.db
+        .select()
+        .from(messagesTable)
+        .where(conditions.length > 0 ? and(...conditions) : undefined)
+        .orderBy(desc(messagesTable.created_at), desc(messagesTable.id))
+        .limit(query.limit + 1);
+
+      return pageRows<MessageRecord>(rows, query.limit);
+    } catch (error) {
+      this.logger.error(
+        {
+          query,
+          error: error instanceof Error ? error.message : String(error),
+        },
+        "Failed to list messages",
+      );
+      throw error;
+    }
+  }
+
+  async listReviewMessages(
+    query: Omit<MessageQuery, "status">,
+  ): Promise<PageResult<MessageRecord>> {
+    return this.listMessages({
+      ...query,
+      status: ["warn", "flagged", "error"],
+    });
+  }
+}