element-web/src/TextForEvent.tsx

/*
Copyright 2015, 2016 OpenMarket 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.
*/
import React from 'react';
import { MatrixClientPeg } from './MatrixClientPeg';
import { _t } from './languageHandler';
import * as Roles from './Roles';
import { isValid3pidInvite } from "./RoomInvite";
import SettingsStore from "./settings/SettingsStore";
import { ALL_RULE_TYPES, ROOM_RULE_TYPES, SERVER_RULE_TYPES, USER_RULE_TYPES } from "./mjolnir/BanList";
import { WIDGET_LAYOUT_EVENT_TYPE } from "./stores/widgets/WidgetLayoutStore";
import { RightPanelPhases } from './stores/RightPanelStorePhases';
import { Action } from './dispatcher/actions';
import defaultDispatcher from './dispatcher/dispatcher';
import { SetRightPanelPhasePayload } from './dispatcher/payloads/SetRightPanelPhasePayload';
import { MatrixEvent } from "matrix-js-sdk/src/models/event";

// These functions are frequently used just to check whether an event has
// any text to display at all. For this reason they return deferred values
// to avoid the expense of looking up translations when they're not needed.

function textForMemberEvent(ev: MatrixEvent, allowJSX: boolean, showHiddenEvents?: boolean): () => string | null {
    // XXX: SYJS-16 "sender is sometimes null for join messages"
    const senderName = ev.sender ? ev.sender.name : ev.getSender();
    const targetName = ev.target ? ev.target.name : ev.getStateKey();
    const prevContent = ev.getPrevContent();
    const content = ev.getContent();
    const reason = content.reason;

    switch (content.membership) {
        case 'invite': {
            const threePidContent = content.third_party_invite;
            if (threePidContent) {
                if (threePidContent.display_name) {
                    return () => _t('%(targetName)s accepted the invitation for %(displayName)s', {
                        targetName,
                        displayName: threePidContent.display_name,
                    });
                } else {
                    return () => _t('%(targetName)s accepted an invitation', { targetName });
                }
            } else {
                return () => _t('%(senderName)s invited %(targetName)s', { senderName, targetName });
            }
        }
        case 'ban':
            return () => reason
                ? _t('%(senderName)s banned %(targetName)s: %(reason)s', { senderName, targetName, reason })
                : _t('%(senderName)s banned %(targetName)s', { senderName, targetName });
        case 'join':
            if (prevContent && prevContent.membership === 'join') {
                if (prevContent.displayname && content.displayname && prevContent.displayname !== content.displayname) {
                    return () => _t('%(oldDisplayName)s changed their display name to %(displayName)s', {
                        oldDisplayName: prevContent.displayname,
                        displayName: content.displayname,
                    });
                } else if (!prevContent.displayname && content.displayname) {
                    return () => _t('%(senderName)s set their display name to %(displayName)s', {
                        senderName: ev.getSender(),
                        displayName: content.displayname,
                    });
                } else if (prevContent.displayname && !content.displayname) {
                    return () => _t('%(senderName)s removed their display name (%(oldDisplayName)s)', {
                        senderName,
                        oldDisplayName: prevContent.displayname,
                    });
                } else if (prevContent.avatar_url && !content.avatar_url) {
                    return () => _t('%(senderName)s removed their profile picture', { senderName });
                } else if (prevContent.avatar_url && content.avatar_url &&
                    prevContent.avatar_url !== content.avatar_url) {
                    return () => _t('%(senderName)s changed their profile picture', { senderName });
                } else if (!prevContent.avatar_url && content.avatar_url) {
                    return () => _t('%(senderName)s set a profile picture', { senderName });
                } else if (showHiddenEvents ?? SettingsStore.getValue("showHiddenEventsInTimeline")) {
                    // This is a null rejoin, it will only be visible if using 'show hidden events' (labs)
                    return () => _t("%(senderName)s made no change", { senderName });
                } else {
                    return null;
                }
            } else {
                if (!ev.target) console.warn("Join message has no target! -- " + ev.getContent().state_key);
                return () => _t('%(targetName)s joined the room', { targetName });
            }
        case 'leave':
            if (ev.getSender() === ev.getStateKey()) {
                if (prevContent.membership === "invite") {
                    return () => _t('%(targetName)s rejected the invitation', { targetName });
                } else {
                    return () => reason
                        ? _t('%(targetName)s left the room: %(reason)s', { targetName, reason })
                        : _t('%(targetName)s left the room', { targetName });
                }
            } else if (prevContent.membership === "ban") {
                return () => _t('%(senderName)s unbanned %(targetName)s', { senderName, targetName });
            } else if (prevContent.membership === "invite") {
                return () => reason
                    ? _t('%(senderName)s withdrew %(targetName)s\'s invitation: %(reason)s', {
                        senderName,
                        targetName,
                        reason,
                    })
                    : _t('%(senderName)s withdrew %(targetName)s\'s invitation', { senderName, targetName });
            } else if (prevContent.membership === "join") {
                return () => reason
                    ? _t('%(senderName)s kicked %(targetName)s: %(reason)s', {
                        senderName,
                        targetName,
                        reason,
                    })
                    : _t('%(senderName)s kicked %(targetName)s', { senderName, targetName });
            } else {
                return null;
            }
    }
}

function textForTopicEvent(ev: MatrixEvent): () => string | null {
    const senderDisplayName = ev.sender && ev.sender.name ? ev.sender.name : ev.getSender();
    return () => _t('%(senderDisplayName)s changed the topic to "%(topic)s".', {
        senderDisplayName,
        topic: ev.getContent().topic,
    });
}

function textForRoomNameEvent(ev: MatrixEvent): () => string | null {
    const senderDisplayName = ev.sender && ev.sender.name ? ev.sender.name : ev.getSender();

    if (!ev.getContent().name || ev.getContent().name.trim().length === 0) {
        return () => _t('%(senderDisplayName)s removed the room name.', { senderDisplayName });
    }
    if (ev.getPrevContent().name) {
        return () => _t('%(senderDisplayName)s changed the room name from %(oldRoomName)s to %(newRoomName)s.', {
            senderDisplayName,
            oldRoomName: ev.getPrevContent().name,
            newRoomName: ev.getContent().name,
        });
    }
    return () => _t('%(senderDisplayName)s changed the room name to %(roomName)s.', {
        senderDisplayName,
        roomName: ev.getContent().name,
    });
}

function textForTombstoneEvent(ev: MatrixEvent): () => string | null {
    const senderDisplayName = ev.sender && ev.sender.name ? ev.sender.name : ev.getSender();
    return () => _t('%(senderDisplayName)s upgraded this room.', { senderDisplayName });
}

function textForJoinRulesEvent(ev: MatrixEvent): () => string | null {
    const senderDisplayName = ev.sender && ev.sender.name ? ev.sender.name : ev.getSender();
    switch (ev.getContent().join_rule) {
        case "public":
            return () => _t('%(senderDisplayName)s made the room public to whoever knows the link.', {
                senderDisplayName,
            });
        case "invite":
            return () => _t('%(senderDisplayName)s made the room invite only.', {
                senderDisplayName,
            });
        default:
            // The spec supports "knock" and "private", however nothing implements these.
            return () => _t('%(senderDisplayName)s changed the join rule to %(rule)s', {
                senderDisplayName,
                rule: ev.getContent().join_rule,
            });
    }
}

function textForGuestAccessEvent(ev: MatrixEvent): () => string | null {
    const senderDisplayName = ev.sender && ev.sender.name ? ev.sender.name : ev.getSender();
    switch (ev.getContent().guest_access) {
        case "can_join":
            return () => _t('%(senderDisplayName)s has allowed guests to join the room.', { senderDisplayName });
        case "forbidden":
            return () => _t('%(senderDisplayName)s has prevented guests from joining the room.', { senderDisplayName });
        default:
            // There's no other options we can expect, however just for safety's sake we'll do this.
            return () => _t('%(senderDisplayName)s changed guest access to %(rule)s', {
                senderDisplayName,
                rule: ev.getContent().guest_access,
            });
    }
}

function textForRelatedGroupsEvent(ev: MatrixEvent): () => string | null {
    const senderDisplayName = ev.sender && ev.sender.name ? ev.sender.name : ev.getSender();
    const groups = ev.getContent().groups || [];
    const prevGroups = ev.getPrevContent().groups || [];
    const added = groups.filter((g) => !prevGroups.includes(g));
    const removed = prevGroups.filter((g) => !groups.includes(g));

    if (added.length && !removed.length) {
        return () => _t('%(senderDisplayName)s enabled flair for %(groups)s in this room.', {
            senderDisplayName,
            groups: added.join(', '),
        });
    } else if (!added.length && removed.length) {
        return () => _t('%(senderDisplayName)s disabled flair for %(groups)s in this room.', {
            senderDisplayName,
            groups: removed.join(', '),
        });
    } else if (added.length && removed.length) {
        return () => _t('%(senderDisplayName)s enabled flair for %(newGroups)s and disabled flair for ' +
            '%(oldGroups)s in this room.', {
            senderDisplayName,
            newGroups: added.join(', '),
            oldGroups: removed.join(', '),
        });
    } else {
        // Don't bother rendering this change (because there were no changes)
        return null;
    }
}

function textForServerACLEvent(ev: MatrixEvent): () => string | null {
    const senderDisplayName = ev.sender && ev.sender.name ? ev.sender.name : ev.getSender();
    const prevContent = ev.getPrevContent();
    const current = ev.getContent();
    const prev = {
        deny: Array.isArray(prevContent.deny) ? prevContent.deny : [],
        allow: Array.isArray(prevContent.allow) ? prevContent.allow : [],
        allow_ip_literals: !(prevContent.allow_ip_literals === false),
    };

    let getText = null;
    if (prev.deny.length === 0 && prev.allow.length === 0) {
        getText = () => _t("%(senderDisplayName)s set the server ACLs for this room.", { senderDisplayName });
    } else {
        getText = () => _t("%(senderDisplayName)s changed the server ACLs for this room.", { senderDisplayName });
    }

    if (!Array.isArray(current.allow)) {
        current.allow = [];
    }

    // If we know for sure everyone is banned, mark the room as obliterated
    if (current.allow.length === 0) {
        return () => getText() + " " +
            _t("🎉 All servers are banned from participating! This room can no longer be used.");
    }

    return getText;
}

function textForMessageEvent(ev: MatrixEvent): () => string | null {
    return () => {
        const senderDisplayName = ev.sender && ev.sender.name ? ev.sender.name : ev.getSender();
        let message = senderDisplayName + ': ' + ev.getContent().body;
        if (ev.getContent().msgtype === "m.emote") {
            message = "* " + senderDisplayName + " " + message;
        } else if (ev.getContent().msgtype === "m.image") {
            message = _t('%(senderDisplayName)s sent an image.', { senderDisplayName });
        }
        return message;
    };
}

function textForCanonicalAliasEvent(ev: MatrixEvent): () => string | null {
    const senderName = ev.sender && ev.sender.name ? ev.sender.name : ev.getSender();
    const oldAlias = ev.getPrevContent().alias;
    const oldAltAliases = ev.getPrevContent().alt_aliases || [];
    const newAlias = ev.getContent().alias;
    const newAltAliases = ev.getContent().alt_aliases || [];
    const removedAltAliases = oldAltAliases.filter(alias => !newAltAliases.includes(alias));
    const addedAltAliases = newAltAliases.filter(alias => !oldAltAliases.includes(alias));

    if (!removedAltAliases.length && !addedAltAliases.length) {
        if (newAlias) {
            return () => _t('%(senderName)s set the main address for this room to %(address)s.', {
                senderName: senderName,
                address: ev.getContent().alias,
            });
        } else if (oldAlias) {
            return () => _t('%(senderName)s removed the main address for this room.', {
                senderName: senderName,
            });
        }
    } else if (newAlias === oldAlias) {
        if (addedAltAliases.length && !removedAltAliases.length) {
            return () => _t('%(senderName)s added the alternative addresses %(addresses)s for this room.', {
                senderName: senderName,
                addresses: addedAltAliases.join(", "),
                count: addedAltAliases.length,
            });
        } if (removedAltAliases.length && !addedAltAliases.length) {
            return () => _t('%(senderName)s removed the alternative addresses %(addresses)s for this room.', {
                senderName: senderName,
                addresses: removedAltAliases.join(", "),
                count: removedAltAliases.length,
            });
        } if (removedAltAliases.length && addedAltAliases.length) {
            return () => _t('%(senderName)s changed the alternative addresses for this room.', {
                senderName: senderName,
            });
        }
    } else {
        // both alias and alt_aliases where modified
        return () => _t('%(senderName)s changed the main and alternative addresses for this room.', {
            senderName: senderName,
        });
    }
    // in case there is no difference between the two events,
    // say something as we can't simply hide the tile from here
    return () => _t('%(senderName)s changed the addresses for this room.', {
        senderName: senderName,
    });
}

function textForCallAnswerEvent(event: MatrixEvent): () => string | null {
    return () => {
        const senderName = event.sender ? event.sender.name : _t('Someone');
        const supported = MatrixClientPeg.get().supportsVoip() ? '' : _t('(not supported by this browser)');
        return _t('%(senderName)s answered the call.', { senderName }) + ' ' + supported;
    };
}

function textForCallHangupEvent(event: MatrixEvent): () => string | null {
    const getSenderName = () => event.sender ? event.sender.name : _t('Someone');
    const eventContent = event.getContent();
    let getReason = () => "";
    if (!MatrixClientPeg.get().supportsVoip()) {
        getReason = () => _t('(not supported by this browser)');
    } else if (eventContent.reason) {
        if (eventContent.reason === "ice_failed") {
            // We couldn't establish a connection at all
            getReason = () => _t('(could not connect media)');
        } else if (eventContent.reason === "ice_timeout") {
            // We established a connection but it died
            getReason = () => _t('(connection failed)');
        } else if (eventContent.reason === "user_media_failed") {
            // The other side couldn't open capture devices
            getReason = () => _t("(their device couldn't start the camera / microphone)");
        } else if (eventContent.reason === "unknown_error") {
            // An error code the other side doesn't have a way to express
            // (as opposed to an error code they gave but we don't know about,
            // in which case we show the error code)
            getReason = () => _t("(an error occurred)");
        } else if (eventContent.reason === "invite_timeout") {
            getReason = () => _t('(no answer)');
        } else if (eventContent.reason === "user hangup" || eventContent.reason === "user_hangup") {
            // workaround for https://github.com/vector-im/element-web/issues/5178
            // it seems Android randomly sets a reason of "user hangup" which is
            // interpreted as an error code :(
            // https://github.com/vector-im/riot-android/issues/2623
            // Also the correct hangup code as of VoIP v1 (with underscore)
            getReason = () => '';
        } else {
            getReason = () => _t('(unknown failure: %(reason)s)', { reason: eventContent.reason });
        }
    }
    return () => _t('%(senderName)s ended the call.', { senderName: getSenderName() }) + ' ' + getReason();
}

function textForCallRejectEvent(event: MatrixEvent): () => string | null {
    return () => {
        const senderName = event.sender ? event.sender.name : _t('Someone');
        return _t('%(senderName)s declined the call.', { senderName });
    };
}

function textForCallInviteEvent(event: MatrixEvent): () => string | null {
    const getSenderName = () => event.sender ? event.sender.name : _t('Someone');
    // FIXME: Find a better way to determine this from the event?
    let isVoice = true;
    if (event.getContent().offer && event.getContent().offer.sdp &&
            event.getContent().offer.sdp.indexOf('m=video') !== -1) {
        isVoice = false;
    }
    const isSupported = MatrixClientPeg.get().supportsVoip();

    // This ladder could be reduced down to a couple string variables, however other languages
    // can have a hard time translating those strings. In an effort to make translations easier
    // and more accurate, we break out the string-based variables to a couple booleans.
    if (isVoice && isSupported) {
        return () => _t("%(senderName)s placed a voice call.", {
            senderName: getSenderName(),
        });
    } else if (isVoice && !isSupported) {
        return () => _t("%(senderName)s placed a voice call. (not supported by this browser)", {
            senderName: getSenderName(),
        });
    } else if (!isVoice && isSupported) {
        return () => _t("%(senderName)s placed a video call.", {
            senderName: getSenderName(),
        });
    } else if (!isVoice && !isSupported) {
        return () => _t("%(senderName)s placed a video call. (not supported by this browser)", {
            senderName: getSenderName(),
        });
    }
}

function textForThreePidInviteEvent(event: MatrixEvent): () => string | null {
    const senderName = event.sender ? event.sender.name : event.getSender();

    if (!isValid3pidInvite(event)) {
        return () => _t('%(senderName)s revoked the invitation for %(targetDisplayName)s to join the room.', {
            senderName,
            targetDisplayName: event.getPrevContent().display_name || _t("Someone"),
        });
    }

    return () => _t('%(senderName)s sent an invitation to %(targetDisplayName)s to join the room.', {
        senderName,
        targetDisplayName: event.getContent().display_name,
    });
}

function textForHistoryVisibilityEvent(event: MatrixEvent): () => string | null {
    const senderName = event.sender ? event.sender.name : event.getSender();
    switch (event.getContent().history_visibility) {
        case 'invited':
            return () => _t('%(senderName)s made future room history visible to all room members, '
                + 'from the point they are invited.', { senderName });
        case 'joined':
            return () => _t('%(senderName)s made future room history visible to all room members, '
                + 'from the point they joined.', { senderName });
        case 'shared':
            return () => _t('%(senderName)s made future room history visible to all room members.', { senderName });
        case 'world_readable':
            return () => _t('%(senderName)s made future room history visible to anyone.', { senderName });
        default:
            return () => _t('%(senderName)s made future room history visible to unknown (%(visibility)s).', {
                senderName,
                visibility: event.getContent().history_visibility,
            });
    }
}

// Currently will only display a change if a user's power level is changed
function textForPowerEvent(event: MatrixEvent): () => string | null {
    const senderName = event.sender ? event.sender.name : event.getSender();
    if (!event.getPrevContent() || !event.getPrevContent().users ||
        !event.getContent() || !event.getContent().users) {
        return null;
    }
    const userDefault = event.getContent().users_default || 0;
    // Construct set of userIds
    const users = [];
    Object.keys(event.getContent().users).forEach(
        (userId) => {
            if (users.indexOf(userId) === -1) users.push(userId);
        },
    );
    Object.keys(event.getPrevContent().users).forEach(
        (userId) => {
            if (users.indexOf(userId) === -1) users.push(userId);
        },
    );
    const diffs = [];
    users.forEach((userId) => {
        // Previous power level
        const from = event.getPrevContent().users[userId];
        // Current power level
        const to = event.getContent().users[userId];
        if (to !== from) {
            diffs.push({ userId, from, to });
        }
    });
    if (!diffs.length) {
        return null;
    }
    // XXX: This is also surely broken for i18n
    return () => _t('%(senderName)s changed the power level of %(powerLevelDiffText)s.', {
        senderName,
        powerLevelDiffText: diffs.map(diff =>
            _t('%(userId)s from %(fromPowerLevel)s to %(toPowerLevel)s', {
                userId: diff.userId,
                fromPowerLevel: Roles.textualPowerLevel(diff.from, userDefault),
                toPowerLevel: Roles.textualPowerLevel(diff.to, userDefault),
            }),
        ).join(", "),
    });
}

const onPinnedMessagesClick = (): void => {
    defaultDispatcher.dispatch<SetRightPanelPhasePayload>({
        action: Action.SetRightPanelPhase,
        phase: RightPanelPhases.PinnedMessages,
        allowClose: false,
    });
};

function textForPinnedEvent(event: MatrixEvent, allowJSX: boolean): () => string | JSX.Element | null {
    if (!SettingsStore.getValue("feature_pinning")) return null;
    const senderName = event.sender ? event.sender.name : event.getSender();

    if (allowJSX) {
        return () => (
            <span>
                {
                    _t(
                        "%(senderName)s changed the <a>pinned messages</a> for the room.",
                        { senderName },
                        { "a": (sub) => <a onClick={onPinnedMessagesClick}> { sub } </a> },
                    )
                }
            </span>
        );
    }

    return () => _t("%(senderName)s changed the pinned messages for the room.", { senderName });
}

function textForWidgetEvent(event: MatrixEvent): () => string | null {
    const senderName = event.getSender();
    const { name: prevName, type: prevType, url: prevUrl } = event.getPrevContent();
    const { name, type, url } = event.getContent() || {};

    let widgetName = name || prevName || type || prevType || '';
    // Apply sentence case to widget name
    if (widgetName && widgetName.length > 0) {
        widgetName = widgetName[0].toUpperCase() + widgetName.slice(1);
    }

    // If the widget was removed, its content should be {}, but this is sufficiently
    // equivalent to that condition.
    if (url) {
        if (prevUrl) {
            return () => _t('%(widgetName)s widget modified by %(senderName)s', {
                widgetName, senderName,
            });
        } else {
            return () => _t('%(widgetName)s widget added by %(senderName)s', {
                widgetName, senderName,
            });
        }
    } else {
        return () => _t('%(widgetName)s widget removed by %(senderName)s', {
            widgetName, senderName,
        });
    }
}

function textForWidgetLayoutEvent(event: MatrixEvent): () => string | null {
    const senderName = event.sender?.name || event.getSender();
    return () => _t("%(senderName)s has updated the widget layout", { senderName });
}

function textForMjolnirEvent(event: MatrixEvent): () => string | null {
    const senderName = event.getSender();
    const { entity: prevEntity } = event.getPrevContent();
    const { entity, recommendation, reason } = event.getContent();

    // Rule removed
    if (!entity) {
        if (USER_RULE_TYPES.includes(event.getType())) {
            return () => _t("%(senderName)s removed the rule banning users matching %(glob)s",
                { senderName, glob: prevEntity });
        } else if (ROOM_RULE_TYPES.includes(event.getType())) {
            return () => _t("%(senderName)s removed the rule banning rooms matching %(glob)s",
                { senderName, glob: prevEntity });
        } else if (SERVER_RULE_TYPES.includes(event.getType())) {
            return () => _t("%(senderName)s removed the rule banning servers matching %(glob)s",
                { senderName, glob: prevEntity });
        }

        // Unknown type. We'll say something, but we shouldn't end up here.
        return () => _t("%(senderName)s removed a ban rule matching %(glob)s", { senderName, glob: prevEntity });
    }

    // Invalid rule
    if (!recommendation || !reason) return () => _t(`%(senderName)s updated an invalid ban rule`, { senderName });

    // Rule updated
    if (entity === prevEntity) {
        if (USER_RULE_TYPES.includes(event.getType())) {
            return () => _t("%(senderName)s updated the rule banning users matching %(glob)s for %(reason)s",
                { senderName, glob: entity, reason });
        } else if (ROOM_RULE_TYPES.includes(event.getType())) {
            return () => _t("%(senderName)s updated the rule banning rooms matching %(glob)s for %(reason)s",
                { senderName, glob: entity, reason });
        } else if (SERVER_RULE_TYPES.includes(event.getType())) {
            return () => _t("%(senderName)s updated the rule banning servers matching %(glob)s for %(reason)s",
                { senderName, glob: entity, reason });
        }

        // Unknown type. We'll say something but we shouldn't end up here.
        return () => _t("%(senderName)s updated a ban rule matching %(glob)s for %(reason)s",
            { senderName, glob: entity, reason });
    }

    // New rule
    if (!prevEntity) {
        if (USER_RULE_TYPES.includes(event.getType())) {
            return () => _t("%(senderName)s created a rule banning users matching %(glob)s for %(reason)s",
                { senderName, glob: entity, reason });
        } else if (ROOM_RULE_TYPES.includes(event.getType())) {
            return () => _t("%(senderName)s created a rule banning rooms matching %(glob)s for %(reason)s",
                { senderName, glob: entity, reason });
        } else if (SERVER_RULE_TYPES.includes(event.getType())) {
            return () => _t("%(senderName)s created a rule banning servers matching %(glob)s for %(reason)s",
                { senderName, glob: entity, reason });
        }

        // Unknown type. We'll say something but we shouldn't end up here.
        return () => _t("%(senderName)s created a ban rule matching %(glob)s for %(reason)s",
            { senderName, glob: entity, reason });
    }

    // else the entity !== prevEntity - count as a removal & add
    if (USER_RULE_TYPES.includes(event.getType())) {
        return () => _t(
            "%(senderName)s changed a rule that was banning users matching %(oldGlob)s to matching " +
            "%(newGlob)s for %(reason)s",
            { senderName, oldGlob: prevEntity, newGlob: entity, reason },
        );
    } else if (ROOM_RULE_TYPES.includes(event.getType())) {
        return () => _t(
            "%(senderName)s changed a rule that was banning rooms matching %(oldGlob)s to matching " +
            "%(newGlob)s for %(reason)s",
            { senderName, oldGlob: prevEntity, newGlob: entity, reason },
        );
    } else if (SERVER_RULE_TYPES.includes(event.getType())) {
        return () => _t(
            "%(senderName)s changed a rule that was banning servers matching %(oldGlob)s to matching " +
            "%(newGlob)s for %(reason)s",
            { senderName, oldGlob: prevEntity, newGlob: entity, reason },
        );
    }

    // Unknown type. We'll say something but we shouldn't end up here.
    return () => _t("%(senderName)s updated a ban rule that was matching %(oldGlob)s to matching %(newGlob)s " +
        "for %(reason)s", { senderName, oldGlob: prevEntity, newGlob: entity, reason });
}

interface IHandlers {
    [type: string]:
        (ev: MatrixEvent, allowJSX: boolean, showHiddenEvents?: boolean) =>
            (() => string | JSX.Element | null);
}

const handlers: IHandlers = {
    'm.room.message': textForMessageEvent,
    'm.call.invite': textForCallInviteEvent,
    'm.call.answer': textForCallAnswerEvent,
    'm.call.hangup': textForCallHangupEvent,
    'm.call.reject': textForCallRejectEvent,
};

const stateHandlers: IHandlers = {
    'm.room.canonical_alias': textForCanonicalAliasEvent,
    'm.room.name': textForRoomNameEvent,
    'm.room.topic': textForTopicEvent,
    'm.room.member': textForMemberEvent,
    'm.room.third_party_invite': textForThreePidInviteEvent,
    'm.room.history_visibility': textForHistoryVisibilityEvent,
    'm.room.power_levels': textForPowerEvent,
    'm.room.pinned_events': textForPinnedEvent,
    'm.room.server_acl': textForServerACLEvent,
    'm.room.tombstone': textForTombstoneEvent,
    'm.room.join_rules': textForJoinRulesEvent,
    'm.room.guest_access': textForGuestAccessEvent,
    'm.room.related_groups': textForRelatedGroupsEvent,

    // TODO: Enable support for m.widget event type (https://github.com/vector-im/element-web/issues/13111)
    'im.vector.modular.widgets': textForWidgetEvent,
    [WIDGET_LAYOUT_EVENT_TYPE]: textForWidgetLayoutEvent,
};

// Add all the Mjolnir stuff to the renderer
for (const evType of ALL_RULE_TYPES) {
    stateHandlers[evType] = textForMjolnirEvent;
}

/**
 * Determines whether the given event has text to display.
 * @param ev The event
 * @param showHiddenEvents An optional cached setting value for showHiddenEventsInTimeline
 *     to avoid hitting the settings store
 */
export function hasText(ev: MatrixEvent, showHiddenEvents?: boolean): boolean {
    const handler = (ev.isState() ? stateHandlers : handlers)[ev.getType()];
    return Boolean(handler?.(ev, false, showHiddenEvents));
}

/**
 * Gets the textual content of the given event.
 * @param ev The event
 * @param allowJSX Whether to output rich JSX content
 * @param showHiddenEvents An optional cached setting value for showHiddenEventsInTimeline
 *     to avoid hitting the settings store
 */
export function textForEvent(
    ev: MatrixEvent, allowJSX: boolean = false, showHiddenEvents?: boolean
): string | JSX.Element {
    const handler = (ev.isState() ? stateHandlers : handlers)[ev.getType()];
    return handler?.(ev, allowJSX, showHiddenEvents)?.() ?? '';
}