feature(room preview): Add option to forget room, improve the room preview screen for banned rooms.

Some internal refactoring was done too:
- Remove RoomInfo.isPublic to only use JoinRule.
- Also take into account restricted access rooms for previews.

libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/MatrixClient.kt

@@ -25,8 +25,8 @@ import io.element.android.libraries.matrix.api.oidc.AccountManagementAction
 import io.element.android.libraries.matrix.api.pusher.PushersService
 import io.element.android.libraries.matrix.api.room.MatrixRoom
 import io.element.android.libraries.matrix.api.room.MatrixRoomInfo
-import io.element.android.libraries.matrix.api.room.PendingRoom
 import io.element.android.libraries.matrix.api.room.RoomMembershipObserver
+import io.element.android.libraries.matrix.api.room.RoomPreview
 import io.element.android.libraries.matrix.api.room.alias.ResolvedRoomAlias
 import io.element.android.libraries.matrix.api.room.preview.RoomPreviewInfo
 import io.element.android.libraries.matrix.api.roomdirectory.RoomDirectoryService
@@ -55,7 +55,7 @@ interface MatrixClient : Closeable {
     val sessionCoroutineScope: CoroutineScope
     val ignoredUsersFlow: StateFlow<ImmutableList<UserId>>
     suspend fun getRoom(roomId: RoomId): MatrixRoom?
-    suspend fun getPendingRoom(roomId: RoomId): PendingRoom?
+    suspend fun getPendingRoom(roomId: RoomId): RoomPreview?
     suspend fun findDM(userId: UserId): RoomId?
     suspend fun ignoreUser(userId: UserId): Result<Unit>
     suspend fun unignoreUser(userId: UserId): Result<Unit>

libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/room/MatrixRoomInfo.kt

@@ -28,7 +28,6 @@ data class MatrixRoomInfo(
     val topic: String?,
     val avatarUrl: String?,
     val isDirect: Boolean,
-    val isPublic: Boolean,
     val joinRule: JoinRule?,
     val isSpace: Boolean,
     val isTombstoned: Boolean,

libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/room/RoomMember.kt

@@ -20,6 +20,7 @@ data class RoomMember(
     val normalizedPowerLevel: Long,
     val isIgnored: Boolean,
     val role: Role,
+    val membershipChangeReason: String?,
 ) {
     /**
      * Role of the RoomMember, based on its [powerLevel].

libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/room/RoomPreview.kt

@@ -10,11 +10,16 @@ package io.element.android.libraries.matrix.api.room
 import io.element.android.libraries.matrix.api.core.RoomId
 import io.element.android.libraries.matrix.api.core.SessionId
 
-/** A reference to a room the current user has knocked to or has been invited to, with the ability to leave the room. */
-interface PendingRoom : AutoCloseable {
+/** A reference to a room either invited, knocked or banned. */
+interface RoomPreview : AutoCloseable {
     val sessionId: SessionId
     val roomId: RoomId
 
     /** Leave the room ie.decline invite or cancel knock. */
     suspend fun leave(): Result<Unit>
+
+    /**
+     * Forget the room if we had access to it, and it was left or banned.
+     */
+    suspend fun forget(): Result<Unit>
 }

libraries/matrix/api/src/main/kotlin/io/element/android/libraries/matrix/api/room/preview/RoomPreviewInfo.kt

@@ -9,7 +9,9 @@ package io.element.android.libraries.matrix.api.room.preview
 
 import io.element.android.libraries.matrix.api.core.RoomAlias
 import io.element.android.libraries.matrix.api.core.RoomId
+import io.element.android.libraries.matrix.api.room.CurrentUserMembership
 import io.element.android.libraries.matrix.api.room.RoomType
+import io.element.android.libraries.matrix.api.room.join.JoinRule
 
 data class RoomPreviewInfo(
     /** The room id for this room. */
@@ -28,12 +30,8 @@ data class RoomPreviewInfo(
     val roomType: RoomType,
     /** Is the history world-readable for this room? */
     val isHistoryWorldReadable: Boolean,
-    /** Is the room joined by the current user? */
-    val isJoined: Boolean,
-    /** Is the current user invited to this room? */
-    val isInvited: Boolean,
-    /** is the join rule public for this room? */
-    val isPublic: Boolean,
-    /** Can we knock (or restricted-knock) to this room? */
-    val canKnock: Boolean,
+    /** the membership of the current user. */
+    val membership: CurrentUserMembership?,
+    /** The room's join rule. */
+    val joinRule: JoinRule,
 )