DEBUG_READ_RECEIPTS.md

## Read Receipts Debug Steps

### Current Issue
Read receipts always show single tick (sent) - never upgrade to double tick (delivered/read).

### What We've Found
1. Client sends messages ✓
2. Client receives messages ✓
3. Client emits `message-delivered` and `message-read` ✓
4. Server receives these events (should be in logs) ✓
5. **Server broadcasts `message-status` but sender doesn't receive it** ❌

### Problem
The server terminal shows NO Socket.IO logs at all! This means either:
- Socket.IO isn't starting
- Logs are being buffered by Bun

### Next Steps
1. **Stop the server** (Ctrl+C in terminal)
2. **Restart**: `bun dev`
3. **Look for**: 
   - "✓ Socket.IO server initialized"
   - "NEW CLIENT CONNECTED:" when you open the chat

4. **If NO logs appear:**
   - Socket.IO might not be working
   - Try using `node server.ts` instead of `bun server.ts`

5. **If logs DO appear:**
   - Send a message
   - Look for "Received message-delivered" in server logs
   - Look for "Broadcasted message-status to room" in server logs
   - Check if "Received message-status" appears in SENDER browser console

### Expected Flow
```
Sender -> send-message -> Server
Server -> receive-message -> Receiver
Receiver -> message-delivered/read -> Server
Server -> message-status -> Sender (THIS ISN'T WORKING)
Sender updates UI with ✓✓
```