feat(system): implement graceful shutdown and expand websocket events

Improve system reliability and real-time capabilities by implementing a robust lifecycle management system and adding new broadcast events for attachments and voice recordings.

- Implement asynchronous graceful shutdown in backend to close HTTP, WebSocket, Redis, and database connections.
- Add new WebSocket broadcast events: `attachment_created`, `voice_recording_started`, `voice_recording_stopped`, `voice_recording_uploaded`, and `analysis_queue_status`.
- Refactor media status handling to use boolean `playing` state instead of string-based status.
- Centralize `PageResult` and `VoiceRecording` types to improve consistency between frontend and backend.
- Update frontend API client to include `listRecordings` and handle new WebSocket event types.
- Fix type mismatches in voice command handling and media status reporting.

services/backend/src/ws/broadcast.ts

@@ -18,9 +18,14 @@ export interface BroadcastFunctions {
   messageUpdated: BroadcastFn;
   messageDeleted: BroadcastFn;
   messageAnalyzed: BroadcastFn;
+  attachmentCreated: BroadcastFn;
   attachmentUploaded: BroadcastFn;
+  voiceRecordingStarted: BroadcastFn;
+  voiceRecordingStopped: BroadcastFn;
+  voiceRecordingUploaded: BroadcastFn;
   voicePcmData: BroadcastFn;
   voiceActiveUser: BroadcastFn;
+  analysisQueueStatus: BroadcastFn;
   raw: BroadcastRawFn;
   binary: BroadcastBinaryFn;
 }
@@ -53,18 +58,33 @@ export const broadcastMessageUpdated: BroadcastFn = (data) =>
 export const broadcastMessageDeleted: BroadcastFn = (data) =>
   (_fns?.messageDeleted ?? noop)(data);
 
+export const broadcastAttachmentCreated: BroadcastFn = (data) =>
+  (_fns?.attachmentCreated ?? noop)(data);
+
 export const broadcastAttachmentUploaded: BroadcastFn = (data) =>
   (_fns?.attachmentUploaded ?? noop)(data);
 
 export const broadcastMessageAnalyzed: BroadcastFn = (data) =>
   (_fns?.messageAnalyzed ?? noop)(data);
 
+export const broadcastVoiceRecordingStarted: BroadcastFn = (data) =>
+  (_fns?.voiceRecordingStarted ?? noop)(data);
+
+export const broadcastVoiceRecordingStopped: BroadcastFn = (data) =>
+  (_fns?.voiceRecordingStopped ?? noop)(data);
+
+export const broadcastVoiceRecordingUploaded: BroadcastFn = (data) =>
+  (_fns?.voiceRecordingUploaded ?? noop)(data);
+
 export const broadcastVoicePcmData: BroadcastFn = (data) =>
   (_fns?.voicePcmData ?? noop)(data);
 
 export const broadcastVoiceActiveUser: BroadcastFn = (data) =>
   (_fns?.voiceActiveUser ?? noop)(data);
 
+export const broadcastAnalysisQueueStatus: BroadcastFn = (data) =>
+  (_fns?.analysisQueueStatus ?? noop)(data);
+
 export const broadcastRaw: BroadcastRawFn = (type, data) =>
   (_fns?.raw ?? noopRaw)(type, data);
 

services/backend/src/ws/server.ts

@@ -11,6 +11,9 @@ interface BroadcastEvent {
   timestamp: string;
 }
 
+// Track the active WebSocket server for lifecycle management
+let _wss: WebSocketServer | null = null;
+
 async function sendInitialStates(ws: WebSocket): Promise<void> {
   // Send initial user state
   ws.send(
@@ -51,10 +54,18 @@ async function sendInitialStates(ws: WebSocket): Promise<void> {
   }
 }
 
+export function closeWebSocketServer(): void {
+  if (!_wss) return;
+  logger.info("Closing WebSocket server");
+  _wss.close(() => logger.info("WebSocket server closed"));
+  _wss = null;
+}
+
 export function createWebSocketServer(server: Server): WebSocketServer {
   const clients = new Set<WebSocket>();
 
   const wss = new WebSocketServer({ server, path: "/ws" });
+  _wss = wss;
 
   wss.on("connection", (ws: WebSocket) => {
     clients.add(ws);
@@ -188,12 +199,22 @@ export function createWebSocketServer(server: Server): WebSocketServer {
       broadcast({ type: "message_deleted", data }),
     messageAnalyzed: (data: unknown) =>
       broadcast({ type: "message_analyzed", data }),
+    attachmentCreated: (data: unknown) =>
+      broadcast({ type: "attachment_created", data }),
     attachmentUploaded: (data: unknown) =>
       broadcast({ type: "attachment_uploaded", data }),
+    voiceRecordingStarted: (data: unknown) =>
+      broadcast({ type: "voice_recording_started", data }),
+    voiceRecordingStopped: (data: unknown) =>
+      broadcast({ type: "voice_recording_stopped", data }),
+    voiceRecordingUploaded: (data: unknown) =>
+      broadcast({ type: "voice_recording_uploaded", data }),
     voicePcmData: (data: unknown) =>
       broadcast({ type: "voice_pcm_data", data }),
     voiceActiveUser: (data: unknown) =>
       broadcast({ type: "voice_active_user", data }),
+    analysisQueueStatus: (data: unknown) =>
+      broadcast({ type: "analysis_queue_status", data }),
     raw: (type: string, data: unknown) => broadcast({ type, data }),
     binary: broadcastBinary,
   });