/* * Copyright (c) 2019 Zender & Kurtz GbR. * * Authors: * Christian Pauly * Marcel Radzio * * This file is part of famedlysdk. * * famedlysdk is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * famedlysdk is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with famedlysdk. If not, see . */ import 'package:famedlysdk/src/Client.dart'; import 'package:famedlysdk/src/Event.dart'; import 'package:famedlysdk/src/State.dart'; import 'package:famedlysdk/src/responses/ErrorResponse.dart'; import 'package:famedlysdk/src/sync/EventUpdate.dart'; import 'package:famedlysdk/src/utils/ChatTime.dart'; import 'package:famedlysdk/src/utils/MxContent.dart'; import './User.dart'; import 'Connection.dart'; import 'Timeline.dart'; /// Represents a Matrix room. class Room { /// The full qualified Matrix ID for the room in the format '!localid:server.abc'. final String id; /// Membership status of the user for this room. Membership membership; /// The count of unread notifications. int notificationCount; /// The count of highlighted notifications. int highlightCount; String prev_batch; List mHeroes; int mJoinedMemberCount; int mInvitedMemberCount; Map states; /// Time when the user has last read the chat. ChatTime unread; /// ID of the fully read marker event. String fullyRead; /// The name of the room if set by a participant. String get name { if (states["m.room.name"] != null && !states["m.room.name"].content["name"].isEmpty) return states["m.room.name"].content["name"]; if (canonicalAlias != null && !canonicalAlias.isEmpty) return canonicalAlias.substring(1, canonicalAlias.length).split(":")[0]; if (mHeroes.length > 0) { String displayname = ""; for (int i = 0; i < mHeroes.length; i++) displayname += User(mHeroes[i]).calcDisplayname() + ", "; return displayname.substring(0, displayname.length - 2); } return "Empty chat"; } /// The topic of the room if set by a participant. String get topic => states["m.room.topic"] != null ? states["m.room.topic"].content["topic"] : ""; /// The avatar of the room if set by a participant. MxContent get avatar { if (states["m.room.avatar"] != null) return MxContent(states["m.room.avatar"].content["avatar_url"]); if (mHeroes.length == 1) return getUserByMXID(mHeroes[0]).avatar; return MxContent(""); } /// The address in the format: #roomname:homeserver.org. String get canonicalAlias => states["m.room.canonical_alias"] != null ? states["m.room.canonical_alias"].content["canonical_alias"] : ""; /// If this room is a direct chat, this is the matrix ID of the user String get directChatMatrixID => ""; // TODO: Needs account_data in client /// Must be one of [all, mention] String notificationSettings; Event get lastEvent => states["m.room.message"] as Event; /// Your current client instance. final Client client; Room({ this.id, this.membership, this.notificationCount, this.highlightCount, this.prev_batch = "", this.client, this.notificationSettings, this.mHeroes, this.mInvitedMemberCount, this.mJoinedMemberCount, this.states, }); /// Calculates the displayname. First checks if there is a name, then checks for a canonical alias and /// then generates a name from the heroes. String get displayname { if (name != null && !name.isEmpty) return name; if (canonicalAlias != null && !canonicalAlias.isEmpty && canonicalAlias.length > 3) return canonicalAlias.substring(1, canonicalAlias.length).split(":")[0]; if (mHeroes.length > 0) { String displayname = ""; for (int i = 0; i < mHeroes.length; i++) displayname += User(mHeroes[i]).calcDisplayname() + ", "; return displayname.substring(0, displayname.length - 2); } return "Empty chat"; } /// The last message sent to this room. String get lastMessage { if (lastEvent != null) return lastEvent.getBody(); else return ""; } /// When the last message received. ChatTime get timeCreated { if (lastEvent != null) return lastEvent.time; else return ChatTime.now(); } /// Call the Matrix API to change the name of this room. Future setName(String newName) async { dynamic res = await client.connection.jsonRequest( type: HTTPType.PUT, action: "/client/r0/rooms/${id}/state/m.room.name", data: {"name": newName}); if (res is ErrorResponse) client.connection.onError.add(res); return res; } /// Call the Matrix API to change the topic of this room. Future setDescription(String newName) async { dynamic res = await client.connection.jsonRequest( type: HTTPType.PUT, action: "/client/r0/rooms/${id}/state/m.room.topic", data: {"topic": newName}); if (res is ErrorResponse) client.connection.onError.add(res); return res; } /// Call the Matrix API to send a simple text message. Future sendText(String message, {String txid = null}) async { if (txid == null) txid = "txid${DateTime.now().millisecondsSinceEpoch}"; final dynamic res = await client.connection.jsonRequest( type: HTTPType.PUT, action: "/client/r0/rooms/${id}/send/m.room.message/$txid", data: {"msgtype": "m.text", "body": message}); if (res is ErrorResponse) client.connection.onError.add(res); return res; } Future sendTextEvent(String message, {String txid = null}) async { final String type = "m.room.message"; // Create new transaction id String messageID; final int now = DateTime.now().millisecondsSinceEpoch; if (txid == null) { messageID = "msg$now"; } else messageID = txid; // Display a *sending* event and store it. EventUpdate eventUpdate = EventUpdate(type: "timeline", roomID: id, eventType: type, content: { "type": type, "event_id": messageID, "sender": client.userID, "status": 0, "origin_server_ts": now, "content": { "msgtype": "m.text", "body": message, } }); client.connection.onEvent.add(eventUpdate); await client.store?.transaction(() { client.store.storeEventUpdate(eventUpdate); return; }); // Send the text and on success, store and display a *sent* event. final dynamic res = await sendText(message, txid: messageID); if (res is ErrorResponse || !(res["event_id"] is String)) { // On error, set status to -1 eventUpdate.content["status"] = -1; eventUpdate.content["unsigned"] = {"transaction_id": messageID}; client.connection.onEvent.add(eventUpdate); await client.store?.transaction(() { client.store.storeEventUpdate(eventUpdate); return; }); } else { eventUpdate.content["status"] = 1; eventUpdate.content["unsigned"] = {"transaction_id": messageID}; eventUpdate.content["event_id"] = res["event_id"]; client.connection.onEvent.add(eventUpdate); await client.store?.transaction(() { client.store.storeEventUpdate(eventUpdate); return; }); return res["event_id"]; } return null; } /// Call the Matrix API to leave this room. Future leave() async { dynamic res = await client.connection.jsonRequest( type: HTTPType.POST, action: "/client/r0/rooms/${id}/leave"); if (res is ErrorResponse) client.connection.onError.add(res); return res; } /// Call the Matrix API to forget this room if you already left it. Future forget() async { client.store.forgetRoom(id); dynamic res = await client.connection.jsonRequest( type: HTTPType.POST, action: "/client/r0/rooms/${id}/forget"); if (res is ErrorResponse) client.connection.onError.add(res); return res; } /// Call the Matrix API to kick a user from this room. Future kick(String userID) async { dynamic res = await client.connection.jsonRequest( type: HTTPType.POST, action: "/client/r0/rooms/${id}/kick", data: {"user_id": userID}); if (res is ErrorResponse) client.connection.onError.add(res); return res; } /// Call the Matrix API to ban a user from this room. Future ban(String userID) async { dynamic res = await client.connection.jsonRequest( type: HTTPType.POST, action: "/client/r0/rooms/${id}/ban", data: {"user_id": userID}); if (res is ErrorResponse) client.connection.onError.add(res); return res; } /// Call the Matrix API to unban a banned user from this room. Future unban(String userID) async { dynamic res = await client.connection.jsonRequest( type: HTTPType.POST, action: "/client/r0/rooms/${id}/unban", data: {"user_id": userID}); if (res is ErrorResponse) client.connection.onError.add(res); return res; } /// Call the Matrix API to unban a banned user from this room. Future setPower(String userID, int power) async { Map powerMap = await client.store.getPowerLevels(id); powerMap[userID] = power; dynamic res = await client.connection.jsonRequest( type: HTTPType.PUT, action: "/client/r0/rooms/$id/state/m.room.power_levels", data: {"users": powerMap}); if (res is ErrorResponse) client.connection.onError.add(res); return res; } /// Call the Matrix API to invite a user to this room. Future invite(String userID) async { dynamic res = await client.connection.jsonRequest( type: HTTPType.POST, action: "/client/r0/rooms/${id}/invite", data: {"user_id": userID}); if (res is ErrorResponse) client.connection.onError.add(res); return res; } /// Request more previous events from the server. Future requestHistory({int historyCount = 100}) async { final dynamic resp = await client.connection.jsonRequest( type: HTTPType.GET, action: "/client/r0/rooms/$id/messages?from=${prev_batch}&dir=b&limit=$historyCount"); if (resp is ErrorResponse) return; prev_batch = resp["end"]; client.store?.storeRoomPrevBatch(this); if (!(resp["chunk"] is List && resp["chunk"].length > 0 && resp["end"] is String)) return; List history = resp["chunk"]; client.store?.transaction(() { for (int i = 0; i < history.length; i++) { EventUpdate eventUpdate = EventUpdate( type: "history", roomID: id, eventType: history[i]["type"], content: history[i], ); client.connection.onEvent.add(eventUpdate); client.store.storeEventUpdate(eventUpdate); client.store.txn.rawUpdate( "UPDATE Rooms SET prev_batch=? WHERE id=?", [resp["end"], id]); } return; }); if (client.store == null) { for (int i = 0; i < history.length; i++) { EventUpdate eventUpdate = EventUpdate( type: "history", roomID: id, eventType: history[i]["type"], content: history[i], ); client.connection.onEvent.add(eventUpdate); } } } /// Sets this room as a direct chat for this user. Future addToDirectChat(String userID) async { Map> directChats = await client.store.getAccountDataDirectChats(); if (directChats.containsKey(userID)) if (!directChats[userID].contains(id)) directChats[userID].add(id); else return null; // Is already in direct chats else directChats[userID] = [id]; final resp = await client.connection.jsonRequest( type: HTTPType.PUT, action: "/client/r0/user/${client.userID}/account_data/m.direct", data: directChats); return resp; } /// Sends *m.fully_read* and *m.read* for the given event ID. Future sendReadReceipt(String eventID) async { final dynamic resp = client.connection.jsonRequest( type: HTTPType.POST, action: "/client/r0/rooms/$id/read_markers", data: { "m.fully_read": eventID, "m.read": eventID, }); return resp; } /// Returns a Room from a json String which comes normally from the store. If the /// state are also given, the method will await them. static Future getRoomFromTableRow( Map row, Client matrix, {Future>> states}) async { Room newRoom = Room( id: row["id"], notificationCount: row["notification_count"], highlightCount: row["highlight_count"], notificationSettings: row["notification_settings"], prev_batch: row["prev_batch"], mInvitedMemberCount: row["invited_member_count"], mJoinedMemberCount: row["joined_member_count"], mHeroes: row["heroes"]?.split(",") ?? [], client: matrix, ); Map newStates = {}; if (states != null) { List> rawStates = await states; for (int i = 0; i < rawStates.length; i++) { State newState = State.fromJson(rawStates[i], newRoom); newStates[newState.key] = newState; } newRoom.states = newStates; } return newRoom; } @Deprecated("Use client.store.getRoomById(String id) instead!") static Future getRoomById(String id, Client matrix) async { Room room = await matrix.store.getRoomById(id); return room; } /// Load a room from the store including all room events. static Future loadRoomEvents(String id, Client matrix) async { Room room = await matrix.store.getRoomById(id); await room.loadEvents(); return room; } /// Creates a timeline from the store. Returns a [Timeline] object. Future getTimeline( {onTimelineUpdateCallback onUpdate, onTimelineInsertCallback onInsert}) async { List events = await loadEvents(); return Timeline( room: this, events: events, onUpdate: onUpdate, onInsert: onInsert, ); } /// Load all events for a given room from the store. This includes all /// senders of those events, who will be added to the participants list. Future> loadEvents() async { return await client.store.getEventList(this); } /// Load all participants for a given room from the store. Future> loadParticipants() async { return await client.store.loadParticipants(this); } /// Request the full list of participants from the server. The local list /// from the store is not complete if the client uses lazy loading. Future> requestParticipants() async { List participants = []; dynamic res = await client.connection.jsonRequest( type: HTTPType.GET, action: "/client/r0/rooms/${id}/members"); if (res is ErrorResponse || !(res["chunk"] is List)) return participants; for (num i = 0; i < res["chunk"].length; i++) { User newUser = User(res["chunk"][i]["state_key"], displayName: res["chunk"][i]["content"]["displayname"] ?? "", membership: Membership.values.firstWhere((e) => e.toString() == 'Membership.' + res["chunk"][i]["content"]["membership"] ?? ""), avatarUrl: MxContent(res["chunk"][i]["content"]["avatar_url"] ?? ""), room: this); if (newUser.membership != Membership.leave) participants.add(newUser); } return participants; } Future getUserByMXID(String mxID) async { if (states[mxID] != null) return states[mxID] as User; final dynamic resp = await client.connection.jsonRequest( type: HTTPType.GET, action: "/client/r0/rooms/$id/state/m.room.member/$mxID"); if (resp is ErrorResponse) return null; // Somehow we miss the mxid in the response and only get the content of the event. resp["matrix_id"] = mxID; return User.fromJson(resp, this); } /// Searches for the event in the store. If it isn't found, try to request it /// from the server. Returns null if not found. Future getEventById(String eventID) async { if (client.store != null) { final Event storeEvent = await client.store.getEventById(eventID, this); if (storeEvent != null) return storeEvent; } final dynamic resp = await client.connection.jsonRequest( type: HTTPType.GET, action: "/client/r0/rooms/$id/event/$eventID"); if (resp is ErrorResponse) return null; return Event.fromJson(resp, this); } }