v3: added a chatbox

api/services/ws-service.ts

@@ -1,8 +1,10 @@
 import type {
+  ChatMessage,
   Comment,
   Dump,
   OnlineUser,
   Playlist,
+  Role,
   ServerToClientMessage,
   User,
 } from "../model/interfaces.ts";
@@ -11,9 +13,12 @@ export interface WsClient {
   socket: WebSocket;
   userId?: string;
   username?: string;
+  role?: Role;
   avatarMime?: string;
   avatarVersion?: number;
   pongReceived?: boolean;
+  /** Whether this client currently has the chatbox open (is reading chat). */
+  chatOpen?: boolean;
 }
 
 const clients = new Set<WsClient>();
@@ -209,6 +214,34 @@ export function broadcastCommentUpdated(comment: Comment): void {
   }
 }
 
+// Global chat room: every connected client receives every message.
+export function broadcastChatMessage(message: ChatMessage): void {
+  for (const client of clients) {
+    send(client.socket, { type: "chat_message", message });
+  }
+}
+
+export function broadcastChatMessageUpdated(message: ChatMessage): void {
+  for (const client of clients) {
+    send(client.socket, { type: "chat_message_updated", message });
+  }
+}
+
+export function broadcastChatMessageDeleted(id: string): void {
+  for (const client of clients) {
+    send(client.socket, { type: "chat_message_deleted", id });
+  }
+}
+
+// True if the user has the chatbox open on any of their connected clients — i.e.
+// they're already reading chat, so a mention notification would be redundant.
+export function isUserChatOpen(userId: string): boolean {
+  for (const client of clients) {
+    if (client.userId === userId && client.chatOpen) return true;
+  }
+  return false;
+}
+
 export function handleClientPong(client: WsClient): void {
   client.pongReceived = true;
 }