[dylanjeffers]

Summary

Group DMs on web and mobile, behind a new group_messages flag (on in dev, off in prod). The flag only gates creating groups; a group someone else made always renders correctly. Backend: AudiusProject/api#1067. Push copy: AudiusProject/pedalboard#109.

Changes

SDK (changeset: minor)

• chats.create with more than one invitee makes a group with a grp_<ulid> id (optional chatId param). 1:1 ids are unchanged.
• New chats.leave({ chatId }) → chat.leave RPC.
• UserChat.is_group, plus the makeGroupChatId / isGroupChatId helpers.

Common

• FeatureFlags.GROUP_MESSAGES.
• createChat({ userIds }) with 2+ users creates a group, or reuses an already-loaded group with exactly the same members. On failure it backs out of the optimistic navigation and shows a group-specific toast.
• leaveChat({ chatId }) saga.
• useCanSendMessage always allows sending in groups. useCanCreateChat and getUserList ignore group chats, so sharing a group never counts as an existing 1:1.
• New helpers: useIsGroupChat, formatGroupChatTitle ("Ann, Bo & 2 others"), isFirstInSenderRun, and MAX_GROUP_CHAT_MEMBERS (10, matches the api).

Web

• New Message modal: when the flag is on, each user gets a checkbox; users you can't message can't be selected. Once anything is selected, clicking a row toggles it, and the footer becomes "Start Chat" (1 selected) or "Start Group Chat (n)".
• Group inbox row and header: stacked avatars, member names, "N members".
• Header menu: View Members, Priority/General, Delete Conversation, Leave Group. Clicking the title opens the members list.
• In groups, others' messages show the sender's name at the start of a run and their avatar on the last message of a run. Messages from users you've blocked are hidden.

Mobile: the same set.

• Select circles in the new-message screen, with a sticky "Start chat" / "Start group chat (n)" button.
• Group inbox row and header.
• Members screen (ChatMembers route).
• Group variant of the actions drawer, with a Leave Group confirm drawer.
• Sender name and avatar on group messages; blocked senders hidden.

Test plan

• packages/common: vitest run src/store/pages/chat src/utils src/hooks/chats → 106 passed. New saga tests cover a new group id, reusing a group with the same members, the 1:1 id staying deterministic, and leave.
• packages/web: tsc --noEmit, eslint on changed files, chat-page vitest (9 passed).
• packages/mobile: tsc --noEmit, eslint on changed files.
• Web, local stack (api#1067 running on localhost against a seeded local Postgres; web dev server with VITE_API_URL=http://localhost:1323; four local-only test wallets, nothing on prod):
  • Ann selected Bo and Cy. Di, whose inbox is closed, showed "Cannot Be Messaged" and couldn't be checked.
  • "Start Group Chat (2)" created grp_… and opened a header reading "Local Cy & Local Bo · 3 members".
  • Bo and Cy each decrypted Ann's message, with sender name, avatar and unread badge. Bo replied, and Cy saw both senders attributed.
  • View Members listed all three.
  • After Cy blocked Bo, Bo's message was hidden for Cy.
  • Cy left via Leave Group: the chat was removed and the "You left the group" toast showed. Ann then saw "Local Bo · 2 members".
  • 1:1 regression: Ann → Bo from Bo's profile opened the deterministic a:b chat, not the group, and sent normally.
• Mobile on a simulator: not run yet. It needs a build pointed at a local api; sims are signed in to prod accounts, so test with local accounts only.
• With the flag off, confirm the new-message flows look exactly as before (no checkboxes).

Rollout

Merge api#1067 first. Keep group_messages off in prod until mobile has been checked on a device.

Not in this PR

• Group names.
• Adding members: the SDK has chats.invite, but the api has no chat.invite handler.
• A "X left the group" system message.

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 6ea2727

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@audius/sdk	Minor
@audius/sdk-legacy	Patch
@audius/protocol-dashboard	Patch
@audius/sp-actions	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR