Introduce message delivery receipts

[andremion]

🎯 Goal

• Send message delivery receipts, supporting local data buffering, batched reporting, event handling, and UI indicators.
• Marks messages as delivered on:
  • Single channel query result (first page only)
  • Channel list query result
  • Push notification received
  • WS message.new event

https://linear.app/stream/issue/AND-769

🛠 Implementation details

Client module

• New persistence and repository for delivery receipts (MessageReceiptDao/Entity/Repository, ChatClientDatabase, DateConverter).
• New delivery reporting pipeline (MessageReceiptManager, MessageReceiptReporter) with 1s buffer and max 100 confirmations per call.
• message.delivered WS event support.
• Introduced new Channel extensions: readsOf, deliveredReadsOf.
• Introduced ChatClient.markMessageAsDelivered to mark a message as delivered for the current user.
• PrivacySettings.delivery_receipts support.
• Channel read state extended with last_delivered_at and last_delivered_message_id.

Delivery receipts are:

• Buffered and sent every 1s, max 100 per request.
• Not sent for own messages, not sent if already read or already delivered.
• Reconciled against reads (reads supersede delivered).

Privacy:

• Suppressed if ownUser.privacySettings.deliveryReceipts.enabled == false.

UI:

• Compose and XML indicators updated to support the new grey double tick (delivered)
• Unified logic to hide the message status indicator when a message is deleted / ephemeral / sync status failed permanently.

🎨 UI Changes

1-to-1 chat

Screen.Recording.2025-11-04.at.08.43.56.mov

Group chat

Screen.Recording.2025-11-04.at.10.06.56.mov

🧪 Testing

• Open the channel list from two devices connected with different users.
• Send a message from user A to user B.
• Long-press on the new message from user A.
• Click on Message Info.
• The message should be delivered.
• Enter the chat from user B.
• From user A, notice that the message should now be read.

[github-actions]

SDK Size Comparison 📏

SDK	Before	After	Difference	Status
stream-chat-android-client	5.18 MB	5.22 MB	0.04 MB	🟢
stream-chat-android-offline	5.45 MB	5.46 MB	0.02 MB	🟢
stream-chat-android-ui-components	10.55 MB	10.57 MB	0.02 MB	🟢
stream-chat-android-compose	12.77 MB	12.80 MB	0.03 MB	🟢

[github-actions]

DB Entities have been updated. Do we need to upgrade DB Version?
Modified Entities :

stream-chat-android-client/src/main/java/io/getstream/chat/android/client/persistence/db/entity/MessageReceiptEntity.kt
stream-chat-android-offline/src/main/java/io/getstream/chat/android/offline/repository/domain/channelconfig/internal/ChannelConfigEntity.kt
stream-chat-android-offline/src/main/java/io/getstream/chat/android/offline/repository/domain/user/internal/UserEntity.kt

[Copilot]

Pull Request Overview

This pull request adds delivery status indicators for messages in the Stream Chat SDK. It introduces a new "delivered" state between "sent" and "read" states, allowing the UI to display when messages have been delivered to recipients but not yet read.

Key changes:

• Added isMessageDelivered property to message and channel state classes
• Introduced new delivery status icon and UI indicators
• Updated database schema version to support delivery events persistence
• Added new drawable resource for the delivered state (double checkmark in grey)

Reviewed Changes

Copilot reviewed 116 out of 122 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
stream-chat-android-core/src/main/java/io/getstream/chat/android/models/ChannelUserRead.kt	Added lastDeliveredAt and lastDeliveredMessageId properties
stream-chat-android-core/src/main/java/io/getstream/chat/android/models/Config.kt	Added deliveryEventsEnabled configuration flag
stream-chat-android-core/src/main/java/io/getstream/chat/android/PrivacySettings.kt	Added delivery receipts privacy settings
stream-chat-android-ui-components/src/main/res/drawable/stream_ui_ic_check_double_grey.xml	New drawable for delivered status indicator
stream-chat-android-ui-components/src/main/kotlin/io/getstream/chat/android/ui/feature/messages/list/adapter/MessageListItem.kt	Added isMessageDelivered property to MessageItem
stream-chat-android-compose/src/main/java/io/getstream/chat/android/compose/ui/components/channels/MessageReadStatusIcon.kt	Updated to support delivered status icon
stream-chat-android-compose/src/main/java/io/getstream/chat/android/compose/ui/theme/ChatComponentFactory.kt	Added new MessageFooterStatusIndicator overload with params
stream-chat-android-offline/src/main/java/io/getstream/chat/android/offline/repository/database/internal/ChatDatabase.kt	Incremented database version to 96
stream-chat-android-state/src/main/java/io/getstream/chat/android/state/event/handler/internal/utils/ChatEventUtils.kt	Added MessageDeliveredEvent to ChannelUserRead conversion

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull Request Overview

Copilot reviewed 131 out of 137 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sonarqubecloud]

Quality Gate failed

Failed conditions
77.9% Coverage on New Code (required ≥ 80%)

See analysis details on SonarQube Cloud