@tagea/capacitor-matrix 1.2.0 → 1.2.1

package/README.md

@@ -1229,18 +1229,31 @@ 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>                                               |
+| **`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/dist/docs.json

@@ -1179,6 +1179,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;
@@ -126,6 +134,7 @@ export interface RoomSummary {
     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  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.js

@@ -1092,7 +1092,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;
         // Detect DM: check m.direct account data or guess from room state
         let isDirect = false;
         try {
@@ -1107,7 +1107,7 @@ export class MatrixWeb extends WebPlugin {
                 }
             }
         }
-        catch (_g) {
+        catch (_k) {
             // ignore
         }
         // Get avatar URL
@@ -1119,17 +1119,41 @@ 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,
             membership: room.getMyMembership(),
             avatarUrl,
             isDirect,
+            latestEvent,
         };
     }
     async searchUsers(options) {