@tagea/capacitor-matrix 1.1.1 → 1.2.1

package/README.md

@@ -370,6 +370,8 @@ The full API reference is auto-generated below from the TypeScript definitions.
 * [`addListener('typingChanged', ...)`](#addlistenertypingchanged-)
 * [`addListener('receiptReceived', ...)`](#addlistenerreceiptreceived-)
 * [`addListener('presenceChanged', ...)`](#addlistenerpresencechanged-)
+* [`updateAccessToken(...)`](#updateaccesstoken)
+* [`addListener('tokenRefreshRequired', ...)`](#addlistenertokenrefreshrequired-)
 * [`removeAllListeners()`](#removealllisteners)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
@@ -1155,6 +1157,35 @@ addListener(event: 'presenceChanged', listenerFunc: (data: PresenceChangedEvent)
 --------------------
 
 
+### updateAccessToken(...)
+
+```typescript
+updateAccessToken(options: { accessToken: string; }) => Promise<void>
+```
+
+| Param         | Type                                  |
+| ------------- | ------------------------------------- |
+| **`options`** | <code>{ accessToken: string; }</code> |
+
+--------------------
+
+
+### addListener('tokenRefreshRequired', ...)
+
+```typescript
+addListener(event: 'tokenRefreshRequired', listenerFunc: () => void) => Promise<PluginListenerHandle>
+```
+
+| Param              | Type                                |
+| ------------------ | ----------------------------------- |
+| **`event`**        | <code>'tokenRefreshRequired'</code> |
+| **`listenerFunc`** | <code>() =&gt; void</code>          |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+--------------------
+
+
 ### removeAllListeners()
 
 ```typescript
@@ -1198,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/android/src/main/kotlin/de/tremaze/capacitor/matrix/CapMatrix.kt

@@ -186,6 +186,53 @@ class MatrixSDKBridge(private val context: Context) {
         return sessionStore.load()
     }
 
+    suspend fun updateAccessToken(accessToken: String) {
+        requireClient()
+
+        // Stop sync service and clean up references
+        syncService?.stop()
+        syncService = null
+        receiptSyncJob?.cancel()
+        receiptSyncJob = null
+        receiptCache.clear()
+        timelineListenerHandles.clear()
+        roomTimelines.clear()
+        subscribedRoomIds.clear()
+
+        val oldSession = sessionStore.load()
+            ?: throw IllegalStateException("No persisted session to update")
+
+        // Build a new client pointing to the same data directory (preserves crypto store).
+        // The Rust SDK's restoreSession() can only be called once per Client instance.
+        val safeUserId = oldSession.userId.replace(Regex("[^a-zA-Z0-9_.-]"), "_")
+        val dataDir = context.filesDir.resolve("matrix_sdk/$safeUserId")
+        dataDir.mkdirs()
+        val dataDirPath = dataDir.absolutePath
+
+        val newClient = ClientBuilder()
+            .homeserverUrl(oldSession.homeserverUrl)
+            .slidingSyncVersionBuilder(SlidingSyncVersionBuilder.NATIVE)
+            .autoEnableCrossSigning(true)
+            .sqliteStore(SqliteStoreBuilder(dataDirPath, dataDirPath))
+            .build()
+
+        val newSession = Session(
+            accessToken = accessToken,
+            refreshToken = null,
+            userId = oldSession.userId,
+            deviceId = oldSession.deviceId,
+            homeserverUrl = oldSession.homeserverUrl,
+            oidcData = null,
+            slidingSyncVersion = SlidingSyncVersion.NATIVE,
+        )
+
+        newClient.restoreSession(newSession)
+        client = newClient
+
+        val updatedInfo = oldSession.copy(accessToken = accessToken)
+        sessionStore.save(updatedInfo)
+    }
+
     // ── Sync ──────────────────────────────────────────────
 
     suspend fun startSync(
@@ -997,6 +1044,101 @@ class MatrixSDKBridge(private val context: Context) {
         )
     }
 
+    // ── Presence ─────────────────────────────────────────
+
+    suspend fun setPresence(presence: String, statusMsg: String?) {
+        val session = sessionStore.load() ?: throw IllegalStateException("Not logged in")
+        val baseUrl = session.homeserverUrl.trimEnd('/')
+        val encodedUserId = URLEncoder.encode(session.userId, "UTF-8")
+        val url = URL("$baseUrl/_matrix/client/v3/presence/$encodedUserId/status")
+        val connection = url.openConnection() as HttpURLConnection
+        connection.requestMethod = "PUT"
+        connection.setRequestProperty("Authorization", "Bearer ${session.accessToken}")
+        connection.setRequestProperty("Content-Type", "application/json")
+        connection.doOutput = true
+
+        val body = org.json.JSONObject()
+        body.put("presence", presence)
+        if (statusMsg != null) body.put("status_msg", statusMsg)
+        val writer = OutputStreamWriter(connection.outputStream)
+        writer.write(body.toString())
+        writer.flush()
+        writer.close()
+
+        val responseCode = connection.responseCode
+        if (responseCode !in 200..299) {
+            throw Exception("setPresence failed with status $responseCode")
+        }
+    }
+
+    suspend fun getPresence(userId: String): Map<String, Any?> {
+        val session = sessionStore.load() ?: throw IllegalStateException("Not logged in")
+        val baseUrl = session.homeserverUrl.trimEnd('/')
+        val encodedUserId = URLEncoder.encode(userId, "UTF-8")
+        val url = URL("$baseUrl/_matrix/client/v3/presence/$encodedUserId/status")
+        val connection = url.openConnection() as HttpURLConnection
+        connection.requestMethod = "GET"
+        connection.setRequestProperty("Authorization", "Bearer ${session.accessToken}")
+
+        val responseCode = connection.responseCode
+        if (responseCode !in 200..299) {
+            throw Exception("getPresence failed with status $responseCode")
+        }
+
+        val responseBody = connection.inputStream.bufferedReader().readText()
+        val json = org.json.JSONObject(responseBody)
+        return mapOf(
+            "presence" to json.optString("presence", "offline"),
+            "statusMsg" to if (json.has("status_msg")) json.getString("status_msg") else null,
+            "lastActiveAgo" to if (json.has("last_active_ago")) json.getLong("last_active_ago") else null,
+        )
+    }
+
+    // ── Pushers ───────────────────────────────────────────
+
+    suspend fun setPusher(
+        pushkey: String,
+        kind: String?,
+        appId: String,
+        appDisplayName: String,
+        deviceDisplayName: String,
+        lang: String,
+        dataUrl: String,
+        dataFormat: String?,
+    ) {
+        val session = sessionStore.load() ?: throw IllegalStateException("Not logged in")
+        val baseUrl = session.homeserverUrl.trimEnd('/')
+        val url = URL("$baseUrl/_matrix/client/v3/pushers/set")
+        val connection = url.openConnection() as HttpURLConnection
+        connection.requestMethod = "POST"
+        connection.setRequestProperty("Authorization", "Bearer ${session.accessToken}")
+        connection.setRequestProperty("Content-Type", "application/json")
+        connection.doOutput = true
+
+        val dataObj = org.json.JSONObject()
+        dataObj.put("url", dataUrl)
+        if (dataFormat != null) dataObj.put("format", dataFormat)
+
+        val body = org.json.JSONObject()
+        body.put("pushkey", pushkey)
+        body.put("kind", if (kind != null) kind else org.json.JSONObject.NULL)
+        body.put("app_id", appId)
+        body.put("app_display_name", appDisplayName)
+        body.put("device_display_name", deviceDisplayName)
+        body.put("lang", lang)
+        body.put("data", dataObj)
+
+        val writer = OutputStreamWriter(connection.outputStream)
+        writer.write(body.toString())
+        writer.flush()
+        writer.close()
+
+        val responseCode = connection.responseCode
+        if (responseCode !in 200..299) {
+            throw Exception("setPusher failed with status $responseCode")
+        }
+    }
+
     // ── Helpers ───────────────────────────────────────────
 
     private fun requireClient(): Client {

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

@@ -54,6 +54,20 @@ class MatrixPlugin : Plugin() {
         }
     }
 
+    @PluginMethod
+    fun updateAccessToken(call: PluginCall) {
+        val accessToken = call.getString("accessToken") ?: return call.reject("Missing accessToken")
+
+        scope.launch {
+            try {
+                bridge.updateAccessToken(accessToken)
+                call.resolve()
+            } catch (e: Exception) {
+                call.reject(e.message ?: "updateAccessToken failed", e)
+            }
+        }
+    }
+
     @PluginMethod
     fun logout(call: PluginCall) {
         scope.launch {
@@ -530,7 +544,24 @@ class MatrixPlugin : Plugin() {
 
     @PluginMethod
     fun setPusher(call: PluginCall) {
-        call.reject("setPusher is not yet supported on this platform")
+        val pushkey = call.getString("pushkey") ?: return call.reject("Missing pushkey")
+        val kind = call.getString("kind")
+        val appId = call.getString("appId") ?: return call.reject("Missing appId")
+        val appDisplayName = call.getString("appDisplayName") ?: return call.reject("Missing appDisplayName")
+        val deviceDisplayName = call.getString("deviceDisplayName") ?: return call.reject("Missing deviceDisplayName")
+        val lang = call.getString("lang") ?: return call.reject("Missing lang")
+        val dataObj = call.getObject("data") ?: return call.reject("Missing data")
+        val dataUrl = dataObj.getString("url") ?: return call.reject("Missing data.url")
+        val dataFormat = dataObj.optString("format", null)
+
+        scope.launch {
+            try {
+                bridge.setPusher(pushkey, kind, appId, appDisplayName, deviceDisplayName, lang, dataUrl, dataFormat)
+                call.resolve()
+            } catch (e: Exception) {
+                call.reject(e.message ?: "setPusher failed", e)
+            }
+        }
     }
 
     @PluginMethod
@@ -625,12 +656,31 @@ class MatrixPlugin : Plugin() {
 
     @PluginMethod
     fun setPresence(call: PluginCall) {
-        call.reject("setPresence is not supported on this platform")
+        val presence = call.getString("presence") ?: return call.reject("Missing presence")
+        val statusMsg = call.getString("statusMsg")
+
+        scope.launch {
+            try {
+                bridge.setPresence(presence, statusMsg)
+                call.resolve()
+            } catch (e: Exception) {
+                call.reject(e.message ?: "setPresence failed", e)
+            }
+        }
     }
 
     @PluginMethod
     fun getPresence(call: PluginCall) {
-        call.reject("getPresence is not supported on this platform")
+        val userId = call.getString("userId") ?: return call.reject("Missing userId")
+
+        scope.launch {
+            try {
+                val result = bridge.getPresence(userId)
+                call.resolve(mapToJSObject(result))
+            } catch (e: Exception) {
+                call.reject(e.message ?: "getPresence failed", e)
+            }
+        }
     }
 
     @PluginMethod

package/dist/docs.json

@@ -946,6 +946,45 @@
         ],
         "slug": "addlistenerpresencechanged-"
       },
+      {
+        "name": "updateAccessToken",
+        "signature": "(options: { accessToken: string; }) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "{ accessToken: string; }"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [],
+        "slug": "updateaccesstoken"
+      },
+      {
+        "name": "addListener",
+        "signature": "(event: 'tokenRefreshRequired', listenerFunc: () => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "event",
+            "docs": "",
+            "type": "'tokenRefreshRequired'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "() => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [
+          "PluginListenerHandle"
+        ],
+        "slug": "addlistenertokenrefreshrequired-"
+      },
       {
         "name": "removeAllListeners",
         "signature": "() => Promise<void>",
@@ -1140,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;
@@ -388,5 +397,9 @@ export interface MatrixPlugin {
     addListener(event: 'typingChanged', listenerFunc: (data: TypingEvent) => void): Promise<PluginListenerHandle>;
     addListener(event: 'receiptReceived', listenerFunc: (data: ReceiptReceivedEvent) => void): Promise<PluginListenerHandle>;
     addListener(event: 'presenceChanged', listenerFunc: (data: PresenceChangedEvent) => void): Promise<PluginListenerHandle>;
+    updateAccessToken(options: {
+        accessToken: string;
+    }): Promise<void>;
+    addListener(event: 'tokenRefreshRequired', listenerFunc: () => void): Promise<PluginListenerHandle>;
     removeAllListeners(): Promise<void>;
 }

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  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.d.ts

@@ -6,12 +6,17 @@ export declare class MatrixWeb extends WebPlugin implements MatrixPlugin {
     private secretStorageKeyId?;
     private recoveryPassphrase?;
     private fallbackPassphrase?;
+    private _tokenRefreshResolve?;
+    private _tokenRefreshTimeout?;
     private readonly _cryptoCallbacks;
     login(options: LoginOptions): Promise<SessionInfo>;
     loginWithToken(options: LoginWithTokenOptions): Promise<SessionInfo>;
     logout(): Promise<void>;
     clearAllData(): Promise<void>;
     getSession(): Promise<SessionInfo | null>;
+    updateAccessToken(options: {
+        accessToken: string;
+    }): Promise<void>;
     startSync(): Promise<void>;
     stopSync(): Promise<void>;
     getSyncState(): Promise<{
@@ -188,6 +193,7 @@ export declare class MatrixWeb extends WebPlugin implements MatrixPlugin {
     private requireCrypto;
     private ensureCrypto;
     private persistSession;
+    private createTokenRefreshFunction;
     private serializeEvent;
     private serializeRoom;
     searchUsers(options: {