From 5697c9664f58a6194ce47f099d5b80d8b70e2c5b Mon Sep 17 00:00:00 2001
From: ganfra <francoisg@element.io>
Date: Fri, 12 Jun 2026 14:49:57 +0200
Subject: [PATCH] Add KDoc to InCall.callJoinedTs and clearUserStatus

---
 .../io/element/android/libraries/matrix/api/MatrixClient.kt  | 1 +
 .../android/libraries/matrix/api/user/DisplayedStatus.kt     | 5 ++++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/MatrixClient.kt b/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/MatrixClient.kt
index 4147333565..001bac0d30 100644
--- a/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/MatrixClient.kt
+++ b/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/MatrixClient.kt
@@ -86,6 +86,7 @@ interface MatrixClient {
     suspend fun uploadAvatar(mimeType: String, data: ByteArray): Result<Unit>
     suspend fun removeAvatar(): Result<Unit>
     suspend fun setUserStatus(status: UserStatus): Result<Unit>
+    /** Clears both m.status and m.call profile fields (maps to DELETE on the profile endpoint per MSC4426). */
     suspend fun clearUserStatus(): Result<Unit>
     suspend fun joinRoom(roomId: RoomId): Result<RoomInfo?>
     suspend fun joinRoomByIdOrAlias(roomIdOrAlias: RoomIdOrAlias, serverNames: List<String>): Result<RoomInfo?>
diff --git a/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/user/DisplayedStatus.kt b/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/user/DisplayedStatus.kt
index 1b1dd551ff..046191d7cf 100644
--- a/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/user/DisplayedStatus.kt
+++ b/libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/user/DisplayedStatus.kt
@@ -17,5 +17,8 @@ sealed interface DisplayedStatus : Parcelable {
 
     /** Status set automatically when the user is in a call via m.call. */
     @Parcelize
-    data class InCall(val callJoinedTs: Long) : DisplayedStatus
+    data class InCall(
+        /** Unix timestamp in seconds when the call was joined (from m.call.call_joined_ts). */
+        val callJoinedTs: Long,
+    ) : DisplayedStatus
 }