[Room Details] Implement room details screen (#256)

* Implement Room Details screen

* Add option to create permalink from room id and alias, add share room action

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

@@ -0,0 +1,22 @@
+/*
+ * Copyright (c) 2023 New Vector Ltd
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.element.android.libraries.matrix.api.config
+
+object MatrixConfiguration {
+    const val matrixToPermalinkBaseUrl: String = "https://matrix.to/#/"
+    val clientPermalinkBaseUrl: String? = null
+}

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

@@ -17,14 +17,13 @@
 package io.element.android.libraries.matrix.api.permalink
 
 import android.net.Uri
+import io.element.android.libraries.matrix.api.config.MatrixConfiguration
 
 /**
  * Mapping of an input URI to a matrix.to compliant URI.
  */
 object MatrixToConverter {
 
-    const val MATRIX_TO_URL_BASE = "https://matrix.to/#/"
-
     /**
      * Try to convert a URL from an element web instance or from a client permalink to a matrix.to url.
      * To be successfully converted, URL path should contain one of the [SUPPORTED_PATHS].
@@ -35,14 +34,15 @@ object MatrixToConverter {
      */
     fun convert(uri: Uri): Uri? {
         val uriString = uri.toString()
+        val baseUrl = MatrixConfiguration.matrixToPermalinkBaseUrl
 
         return when {
             // URL is already a matrix.to
-            uriString.startsWith(MATRIX_TO_URL_BASE) -> uri
+            uriString.startsWith(baseUrl) -> uri
             // Web or client url
             SUPPORTED_PATHS.any { it in uriString } -> {
                 val path = SUPPORTED_PATHS.first { it in uriString }
-                Uri.parse(MATRIX_TO_URL_BASE + uriString.substringAfter(path))
+                Uri.parse(baseUrl + uriString.substringAfter(path))
             }
             // URL is not supported
             else -> null

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

@@ -0,0 +1,61 @@
+/*
+ * Copyright (c) 2023 New Vector Ltd
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.element.android.libraries.matrix.api.permalink
+
+import io.element.android.libraries.matrix.api.config.MatrixConfiguration
+import io.element.android.libraries.matrix.api.core.MatrixPatterns
+import io.element.android.libraries.matrix.api.core.RoomId
+
+object PermalinkBuilder {
+    private val permalinkBaseUrl get() = (MatrixConfiguration.clientPermalinkBaseUrl ?: MatrixConfiguration.matrixToPermalinkBaseUrl).also {
+        var baseUrl = it
+        if (!baseUrl.endsWith("/")) {
+            baseUrl += "/"
+        }
+        if (!baseUrl.endsWith("/#/")) {
+            baseUrl += "/#/"
+        }
+    }
+
+    fun permalinkForRoomAlias(roomAlias: String): Result<String> {
+        return if (MatrixPatterns.isRoomAlias(roomAlias)) {
+            Result.success(permalinkForRoomAliasOrId(roomAlias))
+        } else {
+            Result.failure(PermalinkBuilderError.InvalidRoomAlias)
+        }
+    }
+
+    fun permalinkForRoomId(roomId: RoomId): Result<String> {
+        return if (MatrixPatterns.isRoomId(roomId.value)) {
+            Result.success(permalinkForRoomAliasOrId(roomId.value))
+        } else {
+            Result.failure(PermalinkBuilderError.InvalidRoomId)
+        }
+    }
+
+    private fun permalinkForRoomAliasOrId(value: String): String {
+        val id = escapeId(value)
+        return permalinkBaseUrl + id
+    }
+
+    private fun escapeId(value: String) = value.replace("/", "%2F")
+}
+
+sealed class PermalinkBuilderError : Throwable() {
+    object InvalidRoomAlias : PermalinkBuilderError()
+    object InvalidRoomId : PermalinkBuilderError()
+}

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

@@ -27,8 +27,12 @@ interface MatrixRoom: Closeable {
     val name: String?
     val bestName: String
     val displayName: String
+    val alias: String?
+    val alternativeAliases: List<String>
     val topic: String?
     val avatarUrl: String?
+    val members: List<RoomMember>
+    val isEncrypted: Boolean
 
     fun syncUpdateFlow(): Flow<Long>
 

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

@@ -0,0 +1,31 @@
+/*
+ * Copyright (c) 2023 New Vector Ltd
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.element.android.libraries.matrix.api.room
+
+data class RoomMember(
+    val userId: String,
+    val displayName: String?,
+    val avatarUrl: String?,
+    val membership: RoomMembershipState,
+    val isNameAmbiguous: Boolean,
+    val powerLevel: Long,
+    val normalizedPowerLevel: Long
+)
+
+enum class RoomMembershipState {
+    BAN, INVITE, JOIN, KNOCK, LEAVE
+}