Add unread message indicators for rooms (#38)

Shows a dot on rooms with unread messages in the sidebar, updated live
over WebSocket. Reuses the same offline-member audience computation
already used for push notifications: a member gets the real-time signal
whenever they aren't currently connected to that room's channel, which
correctly covers both "room not open" and "room open but tab
backgrounded" (the client leaves a room's channel while hidden).

Persisted server-side via a new room_memberships.last_read_at column so
state survives reload and stays consistent across devices, advanced by
an explicit mark-read call the frontend makes on room-open and on each
live message received while the room is genuinely visible -- gated on a
live visibility check, not a cached ref, so a backgrounded-but-open room
keeps accumulating unread instead of auto-marking-read the instant a
message arrives somewhere it can't be seen.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

backend/app/services/message_events.py

@@ -12,7 +12,12 @@ from app.ws.presence import Presence
 
 
 async def _notify_offline_members(
-    db: AsyncSession, presence: Presence, room_id: uuid.UUID, sender: User, message: Message
+    db: AsyncSession,
+    broadcaster: Broadcaster,
+    presence: Presence,
+    room_id: uuid.UUID,
+    sender: User,
+    message: Message,
 ) -> None:
     result = await db.execute(
         select(RoomMembership.user_id).where(RoomMembership.room_id == room_id)
@@ -26,6 +31,17 @@ async def _notify_offline_members(
     if not offline_ids:
         return
 
+    # This is also exactly the right audience for "give this room an unread
+    # dot": presence.connected_user_ids(room_id) means "has this room's
+    # channel joined right now" -- which the client only does while the tab
+    # is genuinely foregrounded (see useChatSocket.ts's visibility-gated
+    # join/leave), so a backgrounded-but-open room correctly lands here too,
+    # not just rooms that aren't open at all.
+    for user_id in offline_ids:
+        await broadcaster.publish_to_user(
+            user_id, {"type": "unread_update", "room_id": str(room_id)}
+        )
+
     room = await db.get(Room, room_id)
     if message.content:
         body = f"{sender.username}: {message.content}"[:120]
@@ -81,7 +97,7 @@ async def broadcast_new_message(
     trigger identical fan-out/push/event behavior."""
     payload = await _message_payload(db, message, sender.username)
     await broadcaster.publish(room_id, payload)
-    await _notify_offline_members(db, presence, room_id, sender, message)
+    await _notify_offline_members(db, broadcaster, presence, room_id, sender, message)
     await dispatch_event(db, "message.created", room_id, payload)
 
 

backend/app/services/room_service.py

@@ -1,6 +1,6 @@
 import uuid
 
-from sqlalchemy import delete, select
+from sqlalchemy import delete, func, select
 from sqlalchemy.exc import IntegrityError
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import selectinload
@@ -79,14 +79,25 @@ async def list_open_rooms(db: AsyncSession, user_id: uuid.UUID) -> list[tuple[Ro
     ]
 
 
-async def list_member_rooms(db: AsyncSession, user_id: uuid.UUID) -> list[tuple[Room, RoomRole]]:
+async def list_member_rooms(
+    db: AsyncSession, user_id: uuid.UUID
+) -> list[tuple[Room, RoomRole, bool]]:
+    last_message_at = (
+        select(func.max(Message.created_at))
+        .where(Message.room_id == Room.id)
+        .correlate(Room)
+        .scalar_subquery()
+    )
     result = await db.execute(
-        select(Room, RoomMembership.role)
+        select(Room, RoomMembership.role, RoomMembership.last_read_at, last_message_at)
         .join(RoomMembership, RoomMembership.room_id == Room.id)
         .where(RoomMembership.user_id == user_id)
         .order_by(Room.created_at)
     )
-    return [(room, role) for room, role in result.all()]
+    return [
+        (room, role, last_message_at is not None and last_message_at > last_read_at)
+        for room, role, last_read_at, last_message_at in result.all()
+    ]
 
 
 async def get_room(db: AsyncSession, room_id: uuid.UUID) -> Room:
@@ -244,6 +255,12 @@ async def transfer_ownership(
     return room
 
 
+async def mark_room_read(db: AsyncSession, room_id: uuid.UUID, user_id: uuid.UUID) -> None:
+    membership = await _get_membership(db, room_id, user_id)
+    membership.last_read_at = func.now()
+    await db.commit()
+
+
 async def leave_room(db: AsyncSession, room_id: uuid.UUID, user_id: uuid.UUID) -> None:
     membership = await _get_membership(db, room_id, user_id)
     if membership.role == RoomRole.owner: