element-web/src/Rooms.ts

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

141 lines
5 KiB
TypeScript
Raw Normal View History

2015-09-18 17:39:16 +00:00
/*
2021-06-22 16:23:13 +00:00
Copyright 2015 - 2021 The Matrix.org Foundation C.I.C.
2015-09-18 17:39:16 +00:00
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.
*/
2021-06-22 16:23:13 +00:00
import { Room } from "matrix-js-sdk/src/models/room";
import { EventType } from "matrix-js-sdk/src/@types/event";
import { RoomMember } from "matrix-js-sdk/src/models/room-member";
import { MatrixClient } from "matrix-js-sdk/src/matrix";
2021-06-22 16:23:13 +00:00
import AliasCustomisations from "./customisations/Alias";
2016-09-07 10:45:32 +00:00
/**
* Given a room object, return the alias we should use for it,
* if any. This could be the canonical alias if one exists, otherwise
* an alias selected arbitrarily but deterministically from the list
* of aliases. Otherwise return null;
*
* @param {Object} room The room object
* @returns {string} A display alias for the given room
2016-09-07 10:45:32 +00:00
*/
export function getDisplayAliasForRoom(room: Room): string | null {
2021-07-09 16:04:37 +00:00
return getDisplayAliasForAliasSet(room.getCanonicalAlias(), room.getAltAliases());
}
2021-07-12 10:56:47 +00:00
// The various display alias getters should all feed through this one path so
// there's a single place to change the logic.
export function getDisplayAliasForAliasSet(canonicalAlias: string | null, altAliases: string[]): string | null {
if (AliasCustomisations.getDisplayAliasForAliasSet) {
return AliasCustomisations.getDisplayAliasForAliasSet(canonicalAlias, altAliases);
}
return (canonicalAlias || altAliases?.[0]) ?? "";
2016-09-07 10:45:32 +00:00
}
2021-06-22 16:23:13 +00:00
export function guessAndSetDMRoom(room: Room, isDirect: boolean): Promise<void> {
let newTarget;
if (isDirect) {
const guessedUserId = guessDMRoomTargetId(room, room.client.getSafeUserId());
newTarget = guessedUserId;
} else {
newTarget = null;
}
return setDMRoom(room.client, room.roomId, newTarget);
}
2016-09-07 16:46:45 +00:00
/**
* Marks or unmarks the given room as being as a DM room.
* @param client the Matrix Client instance of the logged-in user
2016-09-07 16:46:45 +00:00
* @param {string} roomId The ID of the room to modify
* @param {string | null} userId The user ID of the desired DM room target user or
* null to un-mark this room as a DM room
2016-09-07 16:46:45 +00:00
* @returns {object} A promise
*/
export async function setDMRoom(client: MatrixClient, roomId: string, userId: string | null): Promise<void> {
if (client.isGuest()) return;
2016-09-16 15:15:25 +00:00
const mDirectEvent = client.getAccountData(EventType.Direct);
const currentContent = mDirectEvent?.getContent() || {};
2016-09-07 16:46:45 +00:00
const dmRoomMap = new Map(Object.entries(currentContent));
let modified = false;
2016-09-07 16:46:45 +00:00
// remove it from the lists of any others users
// (it can only be a DM room for one person)
for (const thisUserId of dmRoomMap.keys()) {
const roomList = dmRoomMap.get(thisUserId) || [];
2016-09-07 16:46:45 +00:00
if (thisUserId != userId) {
2016-09-07 16:46:45 +00:00
const indexOfRoom = roomList.indexOf(roomId);
if (indexOfRoom > -1) {
roomList.splice(indexOfRoom, 1);
modified = true;
2016-09-07 16:46:45 +00:00
}
}
}
// now add it, if it's not already there
2016-09-13 10:06:07 +00:00
if (userId) {
const roomList = dmRoomMap.get(userId) || [];
2016-09-13 10:06:07 +00:00
if (roomList.indexOf(roomId) == -1) {
roomList.push(roomId);
modified = true;
2016-09-13 10:06:07 +00:00
}
dmRoomMap.set(userId, roomList);
}
// prevent unnecessary calls to setAccountData
if (!modified) return;
await client.setAccountData(EventType.Direct, Object.fromEntries(dmRoomMap));
2016-09-07 16:46:45 +00:00
}
/**
2016-09-08 12:56:45 +00:00
* Given a room, estimate which of its members is likely to
2016-09-07 16:46:45 +00:00
* be the target if the room were a DM room and return that user.
*
* @param {Object} room Target room
* @param {string} myUserId User ID of the current user
* @returns {string} User ID of the user that the room is probably a DM with
2016-09-07 16:46:45 +00:00
*/
2021-06-22 16:23:13 +00:00
function guessDMRoomTargetId(room: Room, myUserId: string): string {
let oldestTs: number | undefined;
let oldestUser: RoomMember | undefined;
2016-09-07 16:46:45 +00:00
// Pick the joined user who's been here longest (and isn't us),
for (const user of room.getJoinedMembers()) {
if (user.userId == myUserId) continue;
if (oldestTs === undefined || (user.events.member && user.events.member.getTs() < oldestTs)) {
oldestUser = user;
oldestTs = user.events.member?.getTs();
}
}
if (oldestUser) return oldestUser.userId;
// if there are no joined members other than us, use the oldest member
2016-09-07 16:46:45 +00:00
for (const user of room.currentState.getMembers()) {
if (user.userId == myUserId) continue;
2016-09-07 16:46:45 +00:00
if (oldestTs === undefined || (user.events.member && user.events.member.getTs() < oldestTs)) {
2016-09-07 16:46:45 +00:00
oldestUser = user;
oldestTs = user.events.member?.getTs();
2016-09-07 16:46:45 +00:00
}
}
if (oldestUser === undefined) return myUserId;
return oldestUser.userId;
2016-09-07 16:46:45 +00:00
}