@tagea/capacitor-matrix 1.2.0 → 1.3.0

package/README.md

@@ -1229,18 +1229,32 @@ removeAllListeners() => Promise<void>
 
 #### RoomSummary
 
-| Prop              | Type                                                |
-| ----------------- | --------------------------------------------------- |
-| **`roomId`**      | <code>string</code>                                 |
-| **`name`**        | <code>string</code>                                 |
-| **`topic`**       | <code>string</code>                                 |
-| **`memberCount`** | <code>number</code>                                 |
-| **`isEncrypted`** | <code>boolean</code>                                |
-| **`unreadCount`** | <code>number</code>                                 |
-| **`lastEventTs`** | <code>number</code>                                 |
-| **`membership`**  | <code>'join' \| 'invite' \| 'leave' \| 'ban'</code> |
-| **`avatarUrl`**   | <code>string</code>                                 |
-| **`isDirect`**    | <code>boolean</code>                                |
+| Prop              | Type                                                              |
+| ----------------- | ----------------------------------------------------------------- |
+| **`roomId`**      | <code>string</code>                                               |
+| **`name`**        | <code>string</code>                                               |
+| **`topic`**       | <code>string</code>                                               |
+| **`memberCount`** | <code>number</code>                                               |
+| **`isEncrypted`** | <code>boolean</code>                                              |
+| **`unreadCount`** | <code>number</code>                                               |
+| **`lastEventTs`** | <code>number</code>                                               |
+| **`createdAt`**   | <code>number</code>                                               |
+| **`membership`**  | <code>'join' \| 'invite' \| 'leave' \| 'ban'</code>               |
+| **`avatarUrl`**   | <code>string</code>                                               |
+| **`isDirect`**    | <code>boolean</code>                                              |
+| **`latestEvent`** | <code><a href="#latesteventpreview">LatestEventPreview</a></code> |
+
+
+#### LatestEventPreview
+
+| Prop                    | Type                                                             |
+| ----------------------- | ---------------------------------------------------------------- |
+| **`roomId`**            | <code>string</code>                                              |
+| **`senderId`**          | <code>string</code>                                              |
+| **`type`**              | <code>string</code>                                              |
+| **`content`**           | <code><a href="#record">Record</a>&lt;string, unknown&gt;</code> |
+| **`originServerTs`**    | <code>number</code>                                              |
+| **`senderDisplayName`** | <code>string</code>                                              |
 
 
 #### RoomMember

package/android/src/main/kotlin/de/tremaze/capacitor/matrix/CapMatrix.kt

@@ -16,8 +16,12 @@ import org.matrix.rustcomponents.sdk.EnableRecoveryProgressListener
 import org.matrix.rustcomponents.sdk.EventOrTransactionId
 import org.matrix.rustcomponents.sdk.EventSendState
 import org.matrix.rustcomponents.sdk.EventTimelineItem
+import org.matrix.rustcomponents.sdk.LatestEventValue
+import org.matrix.rustcomponents.sdk.ProfileDetails
+import org.matrix.rustcomponents.sdk.MembershipChange
 import org.matrix.rustcomponents.sdk.MembershipState
 import org.matrix.rustcomponents.sdk.MessageType
+import org.matrix.rustcomponents.sdk.OtherState
 import org.matrix.rustcomponents.sdk.MsgLikeKind
 import org.matrix.rustcomponents.sdk.ReceiptType
 import org.matrix.rustcomponents.sdk.RecoveryException
@@ -67,6 +71,7 @@ class MatrixSDKBridge(private val context: Context) {
     private val paginatingRooms = Collections.synchronizedSet(mutableSetOf<String>())
     // Per-room tracking of the oldest event ID returned to JS, used for pagination cursor
     private val oldestReturnedEventId = mutableMapOf<String, String>()
+    private val roomCreatedAtCache = mutableMapOf<String, Long>()
     private var receiptSyncJob: Job? = null
     // Receipt cache: roomId → (eventId → set of userIds who sent a read receipt)
     // Populated by the parallel v2 receipt sync since sliding sync doesn't deliver
@@ -283,10 +288,12 @@ class MatrixSDKBridge(private val context: Context) {
                 val handle = timeline.addListener(object : TimelineListener {
                     private fun emitRoomUpdate() {
                         scope.launch {
-                            val unreadCount = try {
-                                room.roomInfo().numUnreadMessages?.toInt() ?: 0
-                            } catch (_: Exception) { 0 }
-                            onRoomUpdate(roomId, mapOf("roomId" to roomId, "unreadCount" to unreadCount))
+                            val summary = try {
+                                serializeRoom(room)
+                            } catch (_: Exception) {
+                                mapOf<String, Any?>("roomId" to roomId)
+                            }
+                            onRoomUpdate(roomId, summary)
                         }
                     }
 
@@ -362,11 +369,45 @@ class MatrixSDKBridge(private val context: Context) {
         val c = requireClient()
         val result = mutableListOf<Map<String, Any?>>()
         for (room in c.rooms()) {
-            result.add(serializeRoom(room))
+            val dict = serializeRoom(room).toMutableMap()
+            if (dict["lastEventTs"] == null) {
+                fetchRoomCreatedAt(room.id())?.let { dict["createdAt"] = it }
+            }
+            result.add(dict)
         }
         return result
     }
 
+    private fun fetchRoomCreatedAt(roomId: String): Long? {
+        roomCreatedAtCache[roomId]?.let { return it }
+        val session = sessionStore.load() ?: return null
+        val baseUrl = session.homeserverUrl.trimEnd('/')
+        val encodedRoomId = java.net.URLEncoder.encode(roomId, "UTF-8")
+        val url = URL("$baseUrl/_matrix/client/v3/rooms/$encodedRoomId/state")
+        return try {
+            val connection = url.openConnection() as HttpURLConnection
+            connection.requestMethod = "GET"
+            connection.setRequestProperty("Authorization", "Bearer ${session.accessToken}")
+            val responseCode = connection.responseCode
+            if (responseCode !in 200..299) return null
+            val body = connection.inputStream.bufferedReader().readText()
+            val events = org.json.JSONArray(body)
+            for (i in 0 until events.length()) {
+                val event = events.getJSONObject(i)
+                if (event.optString("type") == "m.room.create") {
+                    val ts = event.optLong("origin_server_ts", -1)
+                    if (ts > 0) {
+                        roomCreatedAtCache[roomId] = ts
+                        return ts
+                    }
+                }
+            }
+            null
+        } catch (_: Exception) {
+            null
+        }
+    }
+
     suspend fun getRoomMembers(roomId: String): List<Map<String, Any?>> {
         val c = requireClient()
         val room = c.getRoom(roomId) ?: throw IllegalArgumentException("Room $roomId not found")
@@ -1167,18 +1208,99 @@ class MatrixSDKBridge(private val context: Context) {
         val avatarUrl = info.rawName?.let { null } // Rust SDK doesn't expose avatar URL via RoomInfo
         // TODO: Expose room avatar from Rust SDK when available
 
-        return mapOf(
+        val latestEvent = serializeLatestEvent(room.latestEvent(), room.id())
+
+        val result = mutableMapOf<String, Any?>(
             "roomId" to room.id(),
             "name" to (info.displayName ?: ""),
             "topic" to info.topic,
             "memberCount" to info.joinedMembersCount.toInt(),
             "isEncrypted" to (info.encryptionState != EncryptionState.NOT_ENCRYPTED),
             "unreadCount" to (info.numUnreadMessages?.toInt() ?: 0),
-            "lastEventTs" to null,
+            "lastEventTs" to latestEvent?.get("originServerTs"),
             "membership" to membership,
             "avatarUrl" to avatarUrl,
             "isDirect" to isDirect,
         )
+        if (latestEvent != null) {
+            result["latestEvent"] = latestEvent
+        }
+        return result
+    }
+
+    private fun serializeLatestEvent(value: LatestEventValue, roomId: String): Map<String, Any?>? {
+        val timestamp: Long
+        val sender: String
+        val profile: ProfileDetails
+        val content: TimelineItemContent
+
+        when (value) {
+            is LatestEventValue.None -> return null
+            is LatestEventValue.Remote -> {
+                timestamp = value.timestamp.toLong()
+                sender = value.sender
+                profile = value.profile
+                content = value.content
+            }
+            is LatestEventValue.Local -> {
+                timestamp = value.timestamp.toLong()
+                sender = value.sender
+                profile = value.profile
+                content = value.content
+            }
+            else -> return null
+        }
+
+        val contentMap = mutableMapOf<String, Any?>()
+        var eventType = "m.room.message"
+
+        when (content) {
+            is TimelineItemContent.MsgLike -> {
+                when (val kind = content.content.kind) {
+                    is MsgLikeKind.Message -> {
+                        contentMap["body"] = kind.content.body
+                        when (kind.content.msgType) {
+                            is MessageType.Text -> contentMap["msgtype"] = "m.text"
+                            is MessageType.Image -> contentMap["msgtype"] = "m.image"
+                            is MessageType.File -> contentMap["msgtype"] = "m.file"
+                            is MessageType.Audio -> contentMap["msgtype"] = "m.audio"
+                            is MessageType.Video -> contentMap["msgtype"] = "m.video"
+                            is MessageType.Emote -> contentMap["msgtype"] = "m.emote"
+                            is MessageType.Notice -> contentMap["msgtype"] = "m.notice"
+                            else -> contentMap["msgtype"] = "m.text"
+                        }
+                    }
+                    is MsgLikeKind.UnableToDecrypt -> {
+                        contentMap["body"] = "Unable to decrypt message"
+                        contentMap["msgtype"] = "m.text"
+                        contentMap["encrypted"] = true
+                    }
+                    is MsgLikeKind.Redacted -> {
+                        eventType = "m.room.redaction"
+                        contentMap["body"] = "Message deleted"
+                    }
+                    else -> eventType = "m.room.unknown"
+                }
+            }
+            else -> eventType = "m.room.unknown"
+        }
+
+        var senderDisplayName: String? = null
+        if (profile is ProfileDetails.Ready) {
+            senderDisplayName = profile.displayName
+        }
+
+        val result = mutableMapOf<String, Any?>(
+            "roomId" to roomId,
+            "senderId" to sender,
+            "type" to eventType,
+            "content" to contentMap,
+            "originServerTs" to timestamp,
+        )
+        if (senderDisplayName != null) {
+            result["senderDisplayName"] = senderDisplayName
+        }
+        return result
     }
 
     /**
@@ -1299,6 +1421,7 @@ class MatrixSDKBridge(private val context: Context) {
 
         val contentMap = mutableMapOf<String, Any?>()
         var eventType = "m.room.message"
+        var stateKey: String? = null
 
         try {
             val content = eventItem.content
@@ -1369,7 +1492,30 @@ class MatrixSDKBridge(private val context: Context) {
                         }
                     }
                 }
-                is TimelineItemContent.RoomMembership -> eventType = "m.room.member"
+                is TimelineItemContent.RoomMembership -> {
+                    eventType = "m.room.member"
+                    stateKey = content.userId
+                    val membership = when (content.change) {
+                        MembershipChange.JOINED, MembershipChange.INVITATION_ACCEPTED -> "join"
+                        MembershipChange.LEFT -> "leave"
+                        MembershipChange.BANNED, MembershipChange.KICKED_AND_BANNED -> "ban"
+                        MembershipChange.INVITED -> "invite"
+                        MembershipChange.KICKED -> "leave"
+                        MembershipChange.UNBANNED -> "leave"
+                        else -> "join"
+                    }
+                    contentMap["membership"] = membership
+                    contentMap["displayname"] = content.userDisplayName ?: content.userId
+                }
+                is TimelineItemContent.State -> {
+                    stateKey = content.stateKey
+                    when (content.content) {
+                        is OtherState.RoomCreate -> eventType = "m.room.create"
+                        is OtherState.RoomName -> eventType = "m.room.name"
+                        is OtherState.RoomTopic -> eventType = "m.room.topic"
+                        else -> eventType = "m.room.unknown"
+                    }
+                }
                 else -> {}
             }
         } catch (e: Exception) {
@@ -1408,7 +1554,13 @@ class MatrixSDKBridge(private val context: Context) {
             status = "sent"
         }
 
-        return mapOf(
+        // Build unsigned dict — include transaction_id when available
+        val unsigned: Map<String, Any?>? = when (val id = eventItem.eventOrTransactionId) {
+            is EventOrTransactionId.TransactionId -> mapOf("transaction_id" to id.transactionId)
+            else -> null
+        }
+
+        val result = mutableMapOf<String, Any?>(
             "eventId" to eventId,
             "roomId" to roomId,
             "senderId" to eventItem.sender,
@@ -1418,6 +1570,13 @@ class MatrixSDKBridge(private val context: Context) {
             "status" to status,
             "readBy" to readBy,
         )
+        if (stateKey != null) {
+            result["stateKey"] = stateKey
+        }
+        if (unsigned != null) {
+            result["unsigned"] = unsigned
+        }
+        return result
     }
 
     // ── Receipt Sync (parallel v2 sync for read receipts) ──────

package/dist/docs.json

@@ -1159,6 +1159,13 @@
           "complexTypes": [],
           "type": "number | undefined"
         },
+        {
+          "name": "createdAt",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
         {
           "name": "membership",
           "tags": [],
@@ -1179,6 +1186,68 @@
           "docs": "",
           "complexTypes": [],
           "type": "boolean | undefined"
+        },
+        {
+          "name": "latestEvent",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "LatestEventPreview"
+          ],
+          "type": "LatestEventPreview"
+        }
+      ]
+    },
+    {
+      "name": "LatestEventPreview",
+      "slug": "latesteventpreview",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "roomId",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "senderId",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "type",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "content",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "Record"
+          ],
+          "type": "Record<string, unknown>"
+        },
+        {
+          "name": "originServerTs",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "senderDisplayName",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
         }
       ]
     },

package/dist/esm/definitions.d.ts

@@ -115,6 +115,14 @@ export interface MatrixEvent {
     /** Unsigned data (e.g. m.relations for edits, transaction_id for local echo) */
     unsigned?: Record<string, unknown>;
 }
+export interface LatestEventPreview {
+    roomId: string;
+    senderId: string;
+    type: string;
+    content: Record<string, unknown>;
+    originServerTs: number;
+    senderDisplayName?: string;
+}
 export interface RoomSummary {
     roomId: string;
     name: string;
@@ -123,9 +131,11 @@ export interface RoomSummary {
     isEncrypted: boolean;
     unreadCount: number;
     lastEventTs?: number;
+    createdAt?: number;
     membership?: 'join' | 'invite' | 'leave' | 'ban';
     avatarUrl?: string;
     isDirect?: boolean;
+    latestEvent?: LatestEventPreview;
 }
 export interface RoomMember {
     userId: string;

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n// Auth & Session\n\nexport interface LoginOptions {\n  homeserverUrl: string;\n  userId: string;\n  password: string;\n}\n\nexport interface LoginWithTokenOptions {\n  homeserverUrl: string;\n  accessToken: string;\n  userId: string;\n  deviceId: string;\n}\n\nexport interface SessionInfo {\n  accessToken: string;\n  userId: string;\n  deviceId: string;\n  homeserverUrl: string;\n}\n\n// Messaging\n\nexport interface SendMessageOptions {\n  roomId: string;\n  body: string;\n  msgtype?: 'm.text' | 'm.notice' | 'm.emote' | 'm.image' | 'm.audio' | 'm.video' | 'm.file';\n  fileUri?: string;\n  fileName?: string;\n  mimeType?: string;\n  fileSize?: number;\n  /** Audio/video duration in milliseconds (sets info.duration per Matrix spec) */\n  duration?: number;\n  /** Image/video width in pixels (sets info.w per Matrix spec) */\n  width?: number;\n  /** Image/video height in pixels (sets info.h per Matrix spec) */\n  height?: number;\n}\n\n// Presence\n\nexport interface PresenceInfo {\n  presence: 'online' | 'offline' | 'unavailable';\n  statusMsg?: string;\n  lastActiveAgo?: number;\n}\n\n// Typing\n\nexport interface TypingEvent {\n  roomId: string;\n  userIds: string[];\n}\n\nexport interface ReceiptReceivedEvent {\n  roomId: string;\n  /** The event that was read */\n  eventId: string;\n  /** The user who sent the read receipt */\n  userId: string;\n}\n\nexport interface PresenceChangedEvent {\n  userId: string;\n  presence: PresenceInfo;\n}\n\n// Edit & Reply\n\nexport interface EditMessageOptions {\n  roomId: string;\n  eventId: string;\n  newBody: string;\n  /** Required when editing a media message; must match the original msgtype */\n  msgtype?: 'm.text' | 'm.notice' | 'm.emote' | 'm.image' | 'm.audio' | 'm.video' | 'm.file';\n  /** New file to replace the media content (optional for caption-only edits) */\n  fileUri?: string;\n  fileName?: string;\n  mimeType?: string;\n  fileSize?: number;\n  /** Audio/video duration in milliseconds */\n  duration?: number;\n  /** Image/video width in pixels */\n  width?: number;\n  /** Image/video height in pixels */\n  height?: number;\n}\n\nexport interface SendReplyOptions {\n  roomId: string;\n  body: string;\n  replyToEventId: string;\n  msgtype?: 'm.text' | 'm.notice' | 'm.emote' | 'm.image' | 'm.audio' | 'm.video' | 'm.file';\n  fileUri?: string;\n  fileName?: string;\n  mimeType?: string;\n  fileSize?: number;\n  /** Audio/video duration in milliseconds (sets info.duration per Matrix spec) */\n  duration?: number;\n  /** Image/video width in pixels (sets info.w per Matrix spec) */\n  width?: number;\n  /** Image/video height in pixels (sets info.h per Matrix spec) */\n  height?: number;\n}\n\n// Upload\n\nexport interface UploadContentOptions {\n  fileUri: string;\n  fileName: string;\n  mimeType: string;\n}\n\nexport interface UploadContentResult {\n  contentUri: string;\n}\n\n// Thumbnail\n\nexport interface ThumbnailUrlOptions {\n  mxcUrl: string;\n  width: number;\n  height: number;\n  method?: 'scale' | 'crop';\n}\n\nexport interface MatrixEvent {\n  eventId: string;\n  roomId: string;\n  senderId: string;\n  type: string;\n  /** State key for state events (e.g. target user ID for m.room.member) */\n  stateKey?: string;\n  content: Record<string, unknown>;\n  originServerTs: number;\n  /** Delivery/read status for own messages: 'sending' | 'sent' | 'delivered' | 'read' */\n  status?: 'sending' | 'sent' | 'delivered' | 'read';\n  /** User IDs that have read this event */\n  readBy?: string[];\n  /** Unsigned data (e.g. m.relations for edits, transaction_id for local echo) */\n  unsigned?: Record<string, unknown>;\n}\n\n// Rooms\n\nexport interface RoomSummary {\n  roomId: string;\n  name: string;\n  topic?: string;\n  memberCount: number;\n  isEncrypted: boolean;\n  unreadCount: number;\n  lastEventTs?: number;\n  membership?: 'join' | 'invite' | 'leave' | 'ban';\n  avatarUrl?: string;\n  isDirect?: boolean;\n}\n\nexport interface RoomMember {\n  userId: string;\n  displayName?: string;\n  membership: 'join' | 'invite' | 'leave' | 'ban';\n  avatarUrl?: string;\n}\n\n// Device Management\n\nexport interface DeviceInfo {\n  deviceId: string;\n  displayName?: string;\n  lastSeenTs?: number;\n  lastSeenIp?: string;\n  /** Whether this device is verified via cross-signing */\n  isCrossSigningVerified?: boolean;\n}\n\n// Pusher\n\nexport interface PusherOptions {\n  pushkey: string;\n  kind: string | null;\n  appId: string;\n  appDisplayName: string;\n  deviceDisplayName: string;\n  lang: string;\n  data: { url: string; format?: string };\n}\n\n// User Discovery\n\nexport interface UserProfile {\n  userId: string;\n  displayName?: string;\n  avatarUrl?: string;\n}\n\n// Encryption\n\nexport interface CrossSigningStatus {\n  hasMaster: boolean;\n  hasSelfSigning: boolean;\n  hasUserSigning: boolean;\n  isReady: boolean;\n}\n\nexport interface KeyBackupStatus {\n  exists: boolean;\n  version?: string;\n  enabled: boolean;\n}\n\nexport interface RecoveryKeyInfo {\n  recoveryKey: string;\n}\n\nexport interface EncryptionStatus {\n  isCrossSigningReady: boolean;\n  crossSigningStatus: CrossSigningStatus;\n  isKeyBackupEnabled: boolean;\n  keyBackupVersion?: string;\n  isSecretStorageReady: boolean;\n}\n\n// Events & Sync\n\nexport type SyncState = 'INITIAL' | 'SYNCING' | 'ERROR' | 'STOPPED';\n\nexport interface SyncStateChangeEvent {\n  state: SyncState;\n  error?: string;\n}\n\nexport interface MessageReceivedEvent {\n  event: MatrixEvent;\n}\n\nexport interface RoomUpdatedEvent {\n  roomId: string;\n  summary: RoomSummary;\n}\n\n// Plugin Interface\n\nexport interface MatrixPlugin {\n  // Auth\n  login(options: LoginOptions): Promise<SessionInfo>;\n  loginWithToken(options: LoginWithTokenOptions): Promise<SessionInfo>;\n  logout(): Promise<void>;\n  getSession(): Promise<SessionInfo | null>;\n\n  // Sync\n  startSync(): Promise<void>;\n  stopSync(): Promise<void>;\n  getSyncState(): Promise<{ state: SyncState }>;\n\n  // Rooms\n  createRoom(options: {\n    name?: string;\n    topic?: string;\n    isEncrypted?: boolean;\n    isDirect?: boolean;\n    invite?: string[];\n    preset?: 'private_chat' | 'trusted_private_chat' | 'public_chat';\n    historyVisibility?: 'invited' | 'joined' | 'shared' | 'world_readable';\n  }): Promise<{ roomId: string }>;\n  getRooms(): Promise<{ rooms: RoomSummary[] }>;\n  getRoomMembers(options: { roomId: string }): Promise<{ members: RoomMember[] }>;\n  joinRoom(options: { roomIdOrAlias: string }): Promise<{ roomId: string }>;\n  leaveRoom(options: { roomId: string }): Promise<void>;\n  forgetRoom(options: { roomId: string }): Promise<void>;\n\n  // Messaging\n  sendMessage(options: SendMessageOptions): Promise<{ eventId: string }>;\n  editMessage(options: EditMessageOptions): Promise<{ eventId: string }>;\n  sendReply(options: SendReplyOptions): Promise<{ eventId: string }>;\n  getRoomMessages(options: {\n    roomId: string;\n    limit?: number;\n    from?: string;\n  }): Promise<{ events: MatrixEvent[]; nextBatch?: string }>;\n  markRoomAsRead(options: {\n    roomId: string;\n    eventId: string;\n  }): Promise<void>;\n  refreshEventStatuses(options: {\n    roomId: string;\n    eventIds: string[];\n  }): Promise<{ events: MatrixEvent[] }>;\n  redactEvent(options: {\n    roomId: string;\n    eventId: string;\n    reason?: string;\n  }): Promise<void>;\n  sendReaction(options: {\n    roomId: string;\n    eventId: string;\n    key: string;\n  }): Promise<{ eventId: string }>;\n\n  // Room Management\n  setRoomName(options: { roomId: string; name: string }): Promise<void>;\n  setRoomTopic(options: { roomId: string; topic: string }): Promise<void>;\n  setRoomAvatar(options: { roomId: string; mxcUrl: string }): Promise<void>;\n  inviteUser(options: { roomId: string; userId: string }): Promise<void>;\n  kickUser(options: { roomId: string; userId: string; reason?: string }): Promise<void>;\n  banUser(options: { roomId: string; userId: string; reason?: string }): Promise<void>;\n  unbanUser(options: { roomId: string; userId: string }): Promise<void>;\n\n  // Typing\n  sendTyping(options: {\n    roomId: string;\n    isTyping: boolean;\n    timeout?: number;\n  }): Promise<void>;\n\n  // Media\n  getMediaUrl(options: { mxcUrl: string }): Promise<{ httpUrl: string }>;\n  getThumbnailUrl(options: ThumbnailUrlOptions): Promise<{ httpUrl: string }>;\n  uploadContent(options: UploadContentOptions): Promise<UploadContentResult>;\n\n  // User Discovery\n  searchUsers(options: {\n    searchTerm: string;\n    limit?: number;\n  }): Promise<{ results: UserProfile[]; limited: boolean }>;\n\n  // Presence\n  setPresence(options: {\n    presence: 'online' | 'offline' | 'unavailable';\n    statusMsg?: string;\n  }): Promise<void>;\n  getPresence(options: { userId: string }): Promise<PresenceInfo>;\n\n  // Device Management\n  getDevices(): Promise<{ devices: DeviceInfo[] }>;\n  deleteDevice(options: { deviceId: string; auth?: Record<string, unknown> }): Promise<void>;\n  verifyDevice(options: { deviceId: string }): Promise<void>;\n\n  // Push\n  setPusher(options: PusherOptions): Promise<void>;\n\n  // Encryption\n  initializeCrypto(): Promise<void>;\n  getEncryptionStatus(): Promise<EncryptionStatus>;\n  bootstrapCrossSigning(): Promise<void>;\n  setupKeyBackup(): Promise<KeyBackupStatus>;\n  getKeyBackupStatus(): Promise<KeyBackupStatus>;\n  restoreKeyBackup(options?: {\n    recoveryKey?: string;\n  }): Promise<{ importedKeys: number }>;\n  setupRecovery(options?: {\n    passphrase?: string;\n    /**\n     * Passphrase for the *existing* secret storage key, used by\n     * bootstrapSecretStorage to decrypt and migrate the current cross-signing\n     * and backup secrets into the newly created SSSS. Only needed on web;\n     * native platforms (Rust SDK) handle the migration internally.\n     */\n    existingPassphrase?: string;\n  }): Promise<RecoveryKeyInfo>;\n  /** Wipe all local Matrix state (crypto DB, session, caches). */\n  clearAllData(): Promise<void>;\n  isRecoveryEnabled(): Promise<{ enabled: boolean }>;\n  recoverAndSetup(options: {\n    recoveryKey?: string;\n    passphrase?: string;\n  }): Promise<void>;\n  resetRecoveryKey(options?: {\n    passphrase?: string;\n  }): Promise<RecoveryKeyInfo>;\n  exportRoomKeys(options: {\n    passphrase: string;\n  }): Promise<{ data: string }>;\n  importRoomKeys(options: {\n    data: string;\n    passphrase: string;\n  }): Promise<{ importedKeys: number }>;\n\n  // Listeners\n  addListener(\n    event: 'syncStateChange',\n    listenerFunc: (data: SyncStateChangeEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'messageReceived',\n    listenerFunc: (data: MessageReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'roomUpdated',\n    listenerFunc: (data: RoomUpdatedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'typingChanged',\n    listenerFunc: (data: TypingEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'receiptReceived',\n    listenerFunc: (data: ReceiptReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'presenceChanged',\n    listenerFunc: (data: PresenceChangedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  // Token Refresh\n  updateAccessToken(options: { accessToken: string }): Promise<void>;\n\n  addListener(\n    event: 'tokenRefreshRequired',\n    listenerFunc: () => void,\n  ): Promise<PluginListenerHandle>;\n\n  removeAllListeners(): Promise<void>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n// Auth & Session\n\nexport interface LoginOptions {\n  homeserverUrl: string;\n  userId: string;\n  password: string;\n}\n\nexport interface LoginWithTokenOptions {\n  homeserverUrl: string;\n  accessToken: string;\n  userId: string;\n  deviceId: string;\n}\n\nexport interface SessionInfo {\n  accessToken: string;\n  userId: string;\n  deviceId: string;\n  homeserverUrl: string;\n}\n\n// Messaging\n\nexport interface SendMessageOptions {\n  roomId: string;\n  body: string;\n  msgtype?: 'm.text' | 'm.notice' | 'm.emote' | 'm.image' | 'm.audio' | 'm.video' | 'm.file';\n  fileUri?: string;\n  fileName?: string;\n  mimeType?: string;\n  fileSize?: number;\n  /** Audio/video duration in milliseconds (sets info.duration per Matrix spec) */\n  duration?: number;\n  /** Image/video width in pixels (sets info.w per Matrix spec) */\n  width?: number;\n  /** Image/video height in pixels (sets info.h per Matrix spec) */\n  height?: number;\n}\n\n// Presence\n\nexport interface PresenceInfo {\n  presence: 'online' | 'offline' | 'unavailable';\n  statusMsg?: string;\n  lastActiveAgo?: number;\n}\n\n// Typing\n\nexport interface TypingEvent {\n  roomId: string;\n  userIds: string[];\n}\n\nexport interface ReceiptReceivedEvent {\n  roomId: string;\n  /** The event that was read */\n  eventId: string;\n  /** The user who sent the read receipt */\n  userId: string;\n}\n\nexport interface PresenceChangedEvent {\n  userId: string;\n  presence: PresenceInfo;\n}\n\n// Edit & Reply\n\nexport interface EditMessageOptions {\n  roomId: string;\n  eventId: string;\n  newBody: string;\n  /** Required when editing a media message; must match the original msgtype */\n  msgtype?: 'm.text' | 'm.notice' | 'm.emote' | 'm.image' | 'm.audio' | 'm.video' | 'm.file';\n  /** New file to replace the media content (optional for caption-only edits) */\n  fileUri?: string;\n  fileName?: string;\n  mimeType?: string;\n  fileSize?: number;\n  /** Audio/video duration in milliseconds */\n  duration?: number;\n  /** Image/video width in pixels */\n  width?: number;\n  /** Image/video height in pixels */\n  height?: number;\n}\n\nexport interface SendReplyOptions {\n  roomId: string;\n  body: string;\n  replyToEventId: string;\n  msgtype?: 'm.text' | 'm.notice' | 'm.emote' | 'm.image' | 'm.audio' | 'm.video' | 'm.file';\n  fileUri?: string;\n  fileName?: string;\n  mimeType?: string;\n  fileSize?: number;\n  /** Audio/video duration in milliseconds (sets info.duration per Matrix spec) */\n  duration?: number;\n  /** Image/video width in pixels (sets info.w per Matrix spec) */\n  width?: number;\n  /** Image/video height in pixels (sets info.h per Matrix spec) */\n  height?: number;\n}\n\n// Upload\n\nexport interface UploadContentOptions {\n  fileUri: string;\n  fileName: string;\n  mimeType: string;\n}\n\nexport interface UploadContentResult {\n  contentUri: string;\n}\n\n// Thumbnail\n\nexport interface ThumbnailUrlOptions {\n  mxcUrl: string;\n  width: number;\n  height: number;\n  method?: 'scale' | 'crop';\n}\n\nexport interface MatrixEvent {\n  eventId: string;\n  roomId: string;\n  senderId: string;\n  type: string;\n  /** State key for state events (e.g. target user ID for m.room.member) */\n  stateKey?: string;\n  content: Record<string, unknown>;\n  originServerTs: number;\n  /** Delivery/read status for own messages: 'sending' | 'sent' | 'delivered' | 'read' */\n  status?: 'sending' | 'sent' | 'delivered' | 'read';\n  /** User IDs that have read this event */\n  readBy?: string[];\n  /** Unsigned data (e.g. m.relations for edits, transaction_id for local echo) */\n  unsigned?: Record<string, unknown>;\n}\n\n// Rooms\n\nexport interface LatestEventPreview {\n  roomId: string;\n  senderId: string;\n  type: string;\n  content: Record<string, unknown>;\n  originServerTs: number;\n  senderDisplayName?: string;\n}\n\nexport interface RoomSummary {\n  roomId: string;\n  name: string;\n  topic?: string;\n  memberCount: number;\n  isEncrypted: boolean;\n  unreadCount: number;\n  lastEventTs?: number;\n  createdAt?: number;\n  membership?: 'join' | 'invite' | 'leave' | 'ban';\n  avatarUrl?: string;\n  isDirect?: boolean;\n  latestEvent?: LatestEventPreview;\n}\n\nexport interface RoomMember {\n  userId: string;\n  displayName?: string;\n  membership: 'join' | 'invite' | 'leave' | 'ban';\n  avatarUrl?: string;\n}\n\n// Device Management\n\nexport interface DeviceInfo {\n  deviceId: string;\n  displayName?: string;\n  lastSeenTs?: number;\n  lastSeenIp?: string;\n  /** Whether this device is verified via cross-signing */\n  isCrossSigningVerified?: boolean;\n}\n\n// Pusher\n\nexport interface PusherOptions {\n  pushkey: string;\n  kind: string | null;\n  appId: string;\n  appDisplayName: string;\n  deviceDisplayName: string;\n  lang: string;\n  data: { url: string; format?: string };\n}\n\n// User Discovery\n\nexport interface UserProfile {\n  userId: string;\n  displayName?: string;\n  avatarUrl?: string;\n}\n\n// Encryption\n\nexport interface CrossSigningStatus {\n  hasMaster: boolean;\n  hasSelfSigning: boolean;\n  hasUserSigning: boolean;\n  isReady: boolean;\n}\n\nexport interface KeyBackupStatus {\n  exists: boolean;\n  version?: string;\n  enabled: boolean;\n}\n\nexport interface RecoveryKeyInfo {\n  recoveryKey: string;\n}\n\nexport interface EncryptionStatus {\n  isCrossSigningReady: boolean;\n  crossSigningStatus: CrossSigningStatus;\n  isKeyBackupEnabled: boolean;\n  keyBackupVersion?: string;\n  isSecretStorageReady: boolean;\n}\n\n// Events & Sync\n\nexport type SyncState = 'INITIAL' | 'SYNCING' | 'ERROR' | 'STOPPED';\n\nexport interface SyncStateChangeEvent {\n  state: SyncState;\n  error?: string;\n}\n\nexport interface MessageReceivedEvent {\n  event: MatrixEvent;\n}\n\nexport interface RoomUpdatedEvent {\n  roomId: string;\n  summary: RoomSummary;\n}\n\n// Plugin Interface\n\nexport interface MatrixPlugin {\n  // Auth\n  login(options: LoginOptions): Promise<SessionInfo>;\n  loginWithToken(options: LoginWithTokenOptions): Promise<SessionInfo>;\n  logout(): Promise<void>;\n  getSession(): Promise<SessionInfo | null>;\n\n  // Sync\n  startSync(): Promise<void>;\n  stopSync(): Promise<void>;\n  getSyncState(): Promise<{ state: SyncState }>;\n\n  // Rooms\n  createRoom(options: {\n    name?: string;\n    topic?: string;\n    isEncrypted?: boolean;\n    isDirect?: boolean;\n    invite?: string[];\n    preset?: 'private_chat' | 'trusted_private_chat' | 'public_chat';\n    historyVisibility?: 'invited' | 'joined' | 'shared' | 'world_readable';\n  }): Promise<{ roomId: string }>;\n  getRooms(): Promise<{ rooms: RoomSummary[] }>;\n  getRoomMembers(options: { roomId: string }): Promise<{ members: RoomMember[] }>;\n  joinRoom(options: { roomIdOrAlias: string }): Promise<{ roomId: string }>;\n  leaveRoom(options: { roomId: string }): Promise<void>;\n  forgetRoom(options: { roomId: string }): Promise<void>;\n\n  // Messaging\n  sendMessage(options: SendMessageOptions): Promise<{ eventId: string }>;\n  editMessage(options: EditMessageOptions): Promise<{ eventId: string }>;\n  sendReply(options: SendReplyOptions): Promise<{ eventId: string }>;\n  getRoomMessages(options: {\n    roomId: string;\n    limit?: number;\n    from?: string;\n  }): Promise<{ events: MatrixEvent[]; nextBatch?: string }>;\n  markRoomAsRead(options: {\n    roomId: string;\n    eventId: string;\n  }): Promise<void>;\n  refreshEventStatuses(options: {\n    roomId: string;\n    eventIds: string[];\n  }): Promise<{ events: MatrixEvent[] }>;\n  redactEvent(options: {\n    roomId: string;\n    eventId: string;\n    reason?: string;\n  }): Promise<void>;\n  sendReaction(options: {\n    roomId: string;\n    eventId: string;\n    key: string;\n  }): Promise<{ eventId: string }>;\n\n  // Room Management\n  setRoomName(options: { roomId: string; name: string }): Promise<void>;\n  setRoomTopic(options: { roomId: string; topic: string }): Promise<void>;\n  setRoomAvatar(options: { roomId: string; mxcUrl: string }): Promise<void>;\n  inviteUser(options: { roomId: string; userId: string }): Promise<void>;\n  kickUser(options: { roomId: string; userId: string; reason?: string }): Promise<void>;\n  banUser(options: { roomId: string; userId: string; reason?: string }): Promise<void>;\n  unbanUser(options: { roomId: string; userId: string }): Promise<void>;\n\n  // Typing\n  sendTyping(options: {\n    roomId: string;\n    isTyping: boolean;\n    timeout?: number;\n  }): Promise<void>;\n\n  // Media\n  getMediaUrl(options: { mxcUrl: string }): Promise<{ httpUrl: string }>;\n  getThumbnailUrl(options: ThumbnailUrlOptions): Promise<{ httpUrl: string }>;\n  uploadContent(options: UploadContentOptions): Promise<UploadContentResult>;\n\n  // User Discovery\n  searchUsers(options: {\n    searchTerm: string;\n    limit?: number;\n  }): Promise<{ results: UserProfile[]; limited: boolean }>;\n\n  // Presence\n  setPresence(options: {\n    presence: 'online' | 'offline' | 'unavailable';\n    statusMsg?: string;\n  }): Promise<void>;\n  getPresence(options: { userId: string }): Promise<PresenceInfo>;\n\n  // Device Management\n  getDevices(): Promise<{ devices: DeviceInfo[] }>;\n  deleteDevice(options: { deviceId: string; auth?: Record<string, unknown> }): Promise<void>;\n  verifyDevice(options: { deviceId: string }): Promise<void>;\n\n  // Push\n  setPusher(options: PusherOptions): Promise<void>;\n\n  // Encryption\n  initializeCrypto(): Promise<void>;\n  getEncryptionStatus(): Promise<EncryptionStatus>;\n  bootstrapCrossSigning(): Promise<void>;\n  setupKeyBackup(): Promise<KeyBackupStatus>;\n  getKeyBackupStatus(): Promise<KeyBackupStatus>;\n  restoreKeyBackup(options?: {\n    recoveryKey?: string;\n  }): Promise<{ importedKeys: number }>;\n  setupRecovery(options?: {\n    passphrase?: string;\n    /**\n     * Passphrase for the *existing* secret storage key, used by\n     * bootstrapSecretStorage to decrypt and migrate the current cross-signing\n     * and backup secrets into the newly created SSSS. Only needed on web;\n     * native platforms (Rust SDK) handle the migration internally.\n     */\n    existingPassphrase?: string;\n  }): Promise<RecoveryKeyInfo>;\n  /** Wipe all local Matrix state (crypto DB, session, caches). */\n  clearAllData(): Promise<void>;\n  isRecoveryEnabled(): Promise<{ enabled: boolean }>;\n  recoverAndSetup(options: {\n    recoveryKey?: string;\n    passphrase?: string;\n  }): Promise<void>;\n  resetRecoveryKey(options?: {\n    passphrase?: string;\n  }): Promise<RecoveryKeyInfo>;\n  exportRoomKeys(options: {\n    passphrase: string;\n  }): Promise<{ data: string }>;\n  importRoomKeys(options: {\n    data: string;\n    passphrase: string;\n  }): Promise<{ importedKeys: number }>;\n\n  // Listeners\n  addListener(\n    event: 'syncStateChange',\n    listenerFunc: (data: SyncStateChangeEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'messageReceived',\n    listenerFunc: (data: MessageReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'roomUpdated',\n    listenerFunc: (data: RoomUpdatedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'typingChanged',\n    listenerFunc: (data: TypingEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'receiptReceived',\n    listenerFunc: (data: ReceiptReceivedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    event: 'presenceChanged',\n    listenerFunc: (data: PresenceChangedEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  // Token Refresh\n  updateAccessToken(options: { accessToken: string }): Promise<void>;\n\n  addListener(\n    event: 'tokenRefreshRequired',\n    listenerFunc: () => void,\n  ): Promise<PluginListenerHandle>;\n\n  removeAllListeners(): Promise<void>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -8,6 +8,7 @@ export declare class MatrixWeb extends WebPlugin implements MatrixPlugin {
     private fallbackPassphrase?;
     private _tokenRefreshResolve?;
     private _tokenRefreshTimeout?;
+    private _roomUpdateTimers;
     private readonly _cryptoCallbacks;
     login(options: LoginOptions): Promise<SessionInfo>;
     loginWithToken(options: LoginWithTokenOptions): Promise<SessionInfo>;

package/dist/esm/web.js

@@ -7,6 +7,7 @@ const SESSION_KEY = 'matrix_session';
 export class MatrixWeb extends WebPlugin {
     constructor() {
         super(...arguments);
+        this._roomUpdateTimers = new Map();
         this._cryptoCallbacks = {
             getSecretStorageKey: async (opts) => {
                 var _a, _b;
@@ -195,6 +196,19 @@ export class MatrixWeb extends WebPlugin {
                     }
                 }
             }
+            // Debounced roomUpdated emission so room list stays current (unread count, sort order)
+            if (room) {
+                const existing = this._roomUpdateTimers.get(room.roomId);
+                if (existing)
+                    clearTimeout(existing);
+                this._roomUpdateTimers.set(room.roomId, setTimeout(() => {
+                    this._roomUpdateTimers.delete(room.roomId);
+                    this.notifyListeners('roomUpdated', {
+                        roomId: room.roomId,
+                        summary: this.serializeRoom(room),
+                    });
+                }, 200));
+            }
         });
         this.client.on(RoomEvent.Receipt, (event, room) => {
             var _a, _b;
@@ -1092,7 +1106,7 @@ export class MatrixWeb extends WebPlugin {
         return Object.assign(Object.assign({ eventId: eventId !== null && eventId !== void 0 ? eventId : '', roomId, senderId: sender !== null && sender !== void 0 ? sender : '', type: event.getType() }, (sk !== undefined && { stateKey: sk })), { content, originServerTs: event.getTs(), status, readBy: readBy.length > 0 ? readBy : undefined, unsigned });
     }
     serializeRoom(room) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
         // Detect DM: check m.direct account data or guess from room state
         let isDirect = false;
         try {
@@ -1107,7 +1121,7 @@ export class MatrixWeb extends WebPlugin {
                 }
             }
         }
-        catch (_g) {
+        catch (_m) {
             // ignore
         }
         // Get avatar URL
@@ -1119,17 +1133,42 @@ export class MatrixWeb extends WebPlugin {
                 avatarUrl = mxcUrl;
             }
         }
+        // Build latestEvent from the room's last displayable timeline event
+        let latestEvent;
+        const timeline = room.getLiveTimeline().getEvents();
+        for (let i = timeline.length - 1; i >= 0; i--) {
+            const evt = timeline[i];
+            const evtType = evt.getType();
+            if (evtType === EventType.RoomMessage || evtType === EventType.Reaction) {
+                const relatesTo = (_c = evt.getContent()) === null || _c === void 0 ? void 0 : _c['m.relates_to'];
+                if ((relatesTo === null || relatesTo === void 0 ? void 0 : relatesTo['rel_type']) === RelationType.Replace)
+                    continue;
+                const sender = (_d = evt.getSender()) !== null && _d !== void 0 ? _d : '';
+                const senderMember = room.getMember(sender);
+                latestEvent = {
+                    roomId: room.roomId,
+                    senderId: sender,
+                    type: evtType,
+                    content: evt.getContent(),
+                    originServerTs: evt.getTs(),
+                    senderDisplayName: (_e = senderMember === null || senderMember === void 0 ? void 0 : senderMember.name) !== null && _e !== void 0 ? _e : undefined,
+                };
+                break;
+            }
+        }
         return {
             roomId: room.roomId,
             name: room.name,
-            topic: (_e = (_d = (_c = room.currentState.getStateEvents('m.room.topic', '')) === null || _c === void 0 ? void 0 : _c.getContent()) === null || _d === void 0 ? void 0 : _d.topic) !== null && _e !== void 0 ? _e : undefined,
+            topic: (_h = (_g = (_f = room.currentState.getStateEvents('m.room.topic', '')) === null || _f === void 0 ? void 0 : _f.getContent()) === null || _g === void 0 ? void 0 : _g.topic) !== null && _h !== void 0 ? _h : undefined,
             memberCount: room.getJoinedMemberCount(),
             isEncrypted: room.hasEncryptionStateEvent(),
-            unreadCount: (_f = room.getUnreadNotificationCount()) !== null && _f !== void 0 ? _f : 0,
+            unreadCount: (_j = room.getUnreadNotificationCount()) !== null && _j !== void 0 ? _j : 0,
             lastEventTs: room.getLastActiveTimestamp() || undefined,
+            createdAt: (_l = (_k = room.currentState.getStateEvents('m.room.create', '')) === null || _k === void 0 ? void 0 : _k.getTs()) !== null && _l !== void 0 ? _l : undefined,
             membership: room.getMyMembership(),
             avatarUrl,
             isDirect,
+            latestEvent,
         };
     }
     async searchUsers(options) {