v3: added a chatbox

api/model/interfaces.ts

@@ -309,6 +309,25 @@ export interface CreateCommentRequest {
   parentId?: string;
 }
 
+/**
+ * Chat
+ */
+
+export interface ChatMessage {
+  id: string;
+  userId: string;
+  body: string;
+  createdAt: Date;
+  updatedAt?: Date;
+  authorUsername: string;
+  authorAvatarMime?: string;
+}
+
+/** Wire format — createdAt arrives as an ISO string over JSON. */
+export type RawChatMessage = Omit<ChatMessage, "createdAt"> & {
+  createdAt: string;
+};
+
 export function isCreateCommentRequest(
   obj: unknown,
 ): obj is CreateCommentRequest {
@@ -532,13 +551,40 @@ export interface CommentLikeRemoveMessage {
   commentId: string;
 }
 
+export interface ChatSendMessage {
+  type: "chat_send";
+  body: string;
+}
+
+// Tells the server whether this client currently has the chatbox open, so that
+// mention notifications can be skipped for users who are already reading chat.
+export interface ChatFocusMessage {
+  type: "chat_focus";
+  open: boolean;
+}
+
+export interface ChatEditMessage {
+  type: "chat_edit";
+  id: string;
+  body: string;
+}
+
+export interface ChatDeleteMessage {
+  type: "chat_delete";
+  id: string;
+}
+
 export type ClientToServerMessage =
   | PingMessage
   | PongMessage
   | VoteCastMessage
   | VoteRemoveMessage
   | CommentLikeCastMessage
-  | CommentLikeRemoveMessage;
+  | CommentLikeRemoveMessage
+  | ChatSendMessage
+  | ChatFocusMessage
+  | ChatEditMessage
+  | ChatDeleteMessage;
 
 // ── Server → Client ──────────────────────────────────────────────────────────
 
@@ -669,6 +715,21 @@ export interface ForceLogoutMessage {
   type: "force_logout";
 }
 
+export interface ChatMessageMessage {
+  type: "chat_message";
+  message: ChatMessage;
+}
+
+export interface ChatMessageUpdatedMessage {
+  type: "chat_message_updated";
+  message: ChatMessage;
+}
+
+export interface ChatMessageDeletedMessage {
+  type: "chat_message_deleted";
+  id: string;
+}
+
 export type ServerToClientMessage =
   | PingMessage
   | WelcomeMessage
@@ -690,7 +751,10 @@ export type ServerToClientMessage =
   | CommentDeletedMessage
   | NotificationCreatedMessage
   | ErrorMessage
-  | ForceLogoutMessage;
+  | ForceLogoutMessage
+  | ChatMessageMessage
+  | ChatMessageUpdatedMessage
+  | ChatMessageDeletedMessage;
 
 /**
  * Follows
@@ -751,7 +815,7 @@ export interface DumpUpvotedData {
 export interface UserMentionedData {
   mentionerId: string;
   mentionerUsername: string;
-  contextType: "comment" | "dump" | "playlist";
+  contextType: "comment" | "dump" | "playlist" | "chat";
   contextId: string;
   contextTitle: string;
   dumpId?: string;