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/models/membership.py

@@ -26,6 +26,13 @@ class RoomMembership(Base):
     joined_at: Mapped[datetime] = mapped_column(
         DateTime(timezone=True), server_default=func.now(), nullable=False
     )
+    # A server_default (not an app-code default) so every membership-creation
+    # call site (create_room, join_room, add_member) gets a sane starting
+    # point automatically: joining counts as being caught up as of then, not
+    # retroactively unread for the room's entire prior history.
+    last_read_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), nullable=False
+    )
 
     room = relationship("Room", back_populates="memberships")
     user = relationship("User")

backend/app/routers/rooms.py

@@ -62,6 +62,7 @@ from app.services.room_service import (
     list_member_rooms,
     list_open_rooms,
     list_room_members,
+    mark_room_read,
     remove_member,
     transfer_ownership,
     update_room,
@@ -138,8 +139,9 @@ async def list_my_rooms_endpoint(
             owner_id=room.owner_id,
             created_at=room.created_at,
             role=role,
+            has_unread=has_unread,
         )
-        for room, role in rooms
+        for room, role, has_unread in rooms
     ]
 
 
@@ -206,6 +208,16 @@ async def leave_room_endpoint(
         raise HTTPException(status_code=404, detail="Not a member of this room")
 
 
+@router.post("/{room_id}/read", status_code=204)
+async def mark_room_read_endpoint(
+    room_id: uuid.UUID,
+    current_user: User = Depends(get_current_user),
+    db: AsyncSession = Depends(get_db),
+):
+    await require_room_member(room_id, current_user, db)
+    await mark_room_read(db, room_id, current_user.id)
+
+
 def _member_status(user: User, online_ids: set[uuid.UUID]) -> str:
     # appear_offline always wins, regardless of actual connection -- that's
     # the whole point of the override (lurking in a room undetected).

backend/app/schemas/room.py

@@ -35,6 +35,10 @@ class RoomListItem(RoomRead):
 
 class MyRoomItem(RoomRead):
     role: RoomRole
+    # Whether this room has a message newer than the caller's last_read_at --
+    # computed by the router/service, not a stored column on Room itself
+    # (it's inherently per-viewer, unlike everything else on RoomRead).
+    has_unread: bool
 
 
 class RoomMemberRead(BaseModel):

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:

backend/app/ws/chat.py

@@ -21,6 +21,7 @@ from app.services.message_service import (
     edit_message,
     toggle_reaction,
 )
+from app.services.room_service import mark_room_read
 
 router = APIRouter(tags=["ws"])
 
@@ -162,6 +163,15 @@ async def chat_endpoint(websocket: WebSocket, db: AsyncSession = Depends(get_db)
                 message = await create_message(
                     db, envelope.room_id, user.id, envelope.content, image_id, file_id
                 )
+                # Sending implies having seen the room as of now -- without
+                # this, GET /rooms/mine would show the sender's own room as
+                # unread the instant they send into it (last_read_at isn't
+                # otherwise bumped until the frontend's own message echo
+                # triggers a mark-read call, which is a real but avoidable
+                # race). Deliberately not done in create_message() itself:
+                # the incoming-webhook path also calls it, and a webhook's
+                # attributed sender may not actually be watching.
+                await mark_room_read(db, envelope.room_id, user.id)
                 await broadcast_new_message(db, broadcaster, presence, envelope.room_id, message, user)
 
             elif envelope.type == "edit":