@tagea/capacitor-matrix 1.1.1 → 1.2.0

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

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>",

package/dist/esm/definitions.d.ts

@@ -388,5 +388,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 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"]}

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: {

package/dist/esm/web.js

@@ -57,6 +57,8 @@ export class MatrixWeb extends WebPlugin {
             userId: res.user_id,
             deviceId: res.device_id,
             cryptoCallbacks: this._cryptoCallbacks,
+            refreshToken: 'jwt-placeholder',
+            tokenRefreshFunction: this.createTokenRefreshFunction(),
         });
         const session = {
             accessToken: res.access_token,
@@ -80,6 +82,8 @@ export class MatrixWeb extends WebPlugin {
             userId: options.userId,
             deviceId: options.deviceId,
             cryptoCallbacks: this._cryptoCallbacks,
+            refreshToken: 'jwt-placeholder',
+            tokenRefreshFunction: this.createTokenRefreshFunction(),
         });
         const session = {
             accessToken: options.accessToken,
@@ -127,6 +131,27 @@ export class MatrixWeb extends WebPlugin {
             return null;
         }
     }
+    async updateAccessToken(options) {
+        this.requireClient();
+        this.client.setAccessToken(options.accessToken);
+        // Update persisted session
+        const raw = localStorage.getItem(SESSION_KEY);
+        if (raw) {
+            const session = JSON.parse(raw);
+            session.accessToken = options.accessToken;
+            this.persistSession(session);
+        }
+        // Resolve pending tokenRefreshFunction promise (if SDK is waiting)
+        if (this._tokenRefreshResolve) {
+            const resolve = this._tokenRefreshResolve;
+            this._tokenRefreshResolve = undefined;
+            if (this._tokenRefreshTimeout) {
+                clearTimeout(this._tokenRefreshTimeout);
+                this._tokenRefreshTimeout = undefined;
+            }
+            resolve({ accessToken: options.accessToken, refreshToken: 'jwt-placeholder' });
+        }
+    }
     // ── Sync ──────────────────────────────────────────────
     async startSync() {
         this.requireClient();
@@ -957,6 +982,20 @@ export class MatrixWeb extends WebPlugin {
     persistSession(session) {
         localStorage.setItem(SESSION_KEY, JSON.stringify(session));
     }
+    createTokenRefreshFunction() {
+        return (_refreshToken) => {
+            this.notifyListeners('tokenRefreshRequired', {});
+            return new Promise((resolve, reject) => {
+                if (this._tokenRefreshTimeout)
+                    clearTimeout(this._tokenRefreshTimeout);
+                this._tokenRefreshResolve = resolve;
+                this._tokenRefreshTimeout = setTimeout(() => {
+                    this._tokenRefreshResolve = undefined;
+                    reject(new Error('Token refresh timed out'));
+                }, 30000);
+            });
+        };
+    }
     serializeEvent(event, fallbackRoomId) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
         const roomId = (_b = (_a = event.getRoomId()) !== null && _a !== void 0 ? _a : fallbackRoomId) !== null && _b !== void 0 ? _b : '';