Membership aware room routes (#2709)

* Remove the invites button when room list invites are enabled

* element-hq/element-x-ios/issues/2632 - Handle room permalinks based on their membership state and show the according room joining screens:
- modify the room flow coordinator to only take a roomID and be able to decide its own room flows (especially for unjoined rooms)
- add support for the new room preview API
- have RoomDirectorySearch go through the same paths

ElementX/Sources/Services/Client/ClientProxy.swift

@@ -456,6 +456,16 @@ class ClientProxy: ClientProxyProtocol {
                                room: room,
                                backgroundTaskService: backgroundTaskService)
     }
+    
+    func roomPreviewForIdentifier(_ identifier: String) async -> Result<RoomPreviewDetails, ClientProxyError> {
+        do {
+            let roomPreview = try await client.getRoomPreview(roomIdOrAlias: identifier)
+            return .success(.init(roomPreview))
+        } catch {
+            MXLog.error("Failed retrieving preview for room: \(identifier) with error: \(error)")
+            return .failure(.sdkError(error))
+        }
+    }
 
     func loadUserDisplayName() async -> Result<Void, ClientProxyError> {
         await Task.dispatch(on: clientQueue) {
@@ -930,3 +940,19 @@ private class IgnoredUsersListenerProxy: IgnoredUsersListener {
         onUpdateClosure(ignoredUserIds)
     }
 }
+
+private extension RoomPreviewDetails {
+    init(_ roomPreview: RoomPreview) {
+        self = RoomPreviewDetails(roomID: roomPreview.roomId,
+                                  name: roomPreview.name,
+                                  canonicalAlias: roomPreview.canonicalAlias,
+                                  topic: roomPreview.topic,
+                                  avatarURL: roomPreview.avatarUrl.flatMap(URL.init(string:)),
+                                  memberCount: UInt(roomPreview.numJoinedMembers),
+                                  isHistoryWorldReadable: roomPreview.isHistoryWorldReadable,
+                                  isJoined: roomPreview.isJoined,
+                                  isInvited: roomPreview.isInvited,
+                                  isPublic: roomPreview.isPublic,
+                                  canKnock: roomPreview.canKnock)
+    }
+}

ElementX/Sources/Services/Client/ClientProxyProtocol.swift

@@ -67,6 +67,20 @@ enum SessionVerificationState {
     case unverified
 }
 
+struct RoomPreviewDetails {
+    let roomID: String
+    let name: String?
+    let canonicalAlias: String?
+    let topic: String?
+    let avatarURL: URL?
+    let memberCount: UInt
+    let isHistoryWorldReadable: Bool
+    let isJoined: Bool
+    let isInvited: Bool
+    let isPublic: Bool
+    let canKnock: Bool
+}
+
 // sourcery: AutoMockable
 protocol ClientProxyProtocol: AnyObject, MediaLoaderProtocol {
     var actionsPublisher: AnyPublisher<ClientProxyAction, Never> { get }
@@ -123,6 +137,8 @@ protocol ClientProxyProtocol: AnyObject, MediaLoaderProtocol {
     
     func roomForIdentifier(_ identifier: String) async -> RoomProxyProtocol?
     
+    func roomPreviewForIdentifier(_ identifier: String) async -> Result<RoomPreviewDetails, ClientProxyError>
+    
     @discardableResult func loadUserDisplayName() async -> Result<Void, ClientProxyError>
     
     func setUserDisplayName(_ name: String) async -> Result<Void, ClientProxyError>