mirror of
https://github.com/element-hq/element-web.git
synced 2024-12-16 13:51:32 +03:00
453 lines
18 KiB
TypeScript
453 lines
18 KiB
TypeScript
/*
|
|
Copyright 2016 OpenMarket Ltd
|
|
Copyright 2019, 2020 The Matrix.org Foundation C.I.C.
|
|
Copyright 2019 Michael Telatynski <7t3chguy@gmail.com>
|
|
|
|
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, { ReactChildren } from 'react';
|
|
import { MatrixEvent } from "matrix-js-sdk/src/models/event";
|
|
import { RoomMember } from "matrix-js-sdk/src/models/room-member";
|
|
|
|
import { _t } from '../../../languageHandler';
|
|
import { formatCommaSeparatedList } from '../../../utils/FormattingUtils';
|
|
import { isValid3pidInvite } from "../../../RoomInvite";
|
|
import EventListSummary from "./EventListSummary";
|
|
import {replaceableComponent} from "../../../utils/replaceableComponent";
|
|
|
|
interface IProps {
|
|
// An array of member events to summarise
|
|
events: MatrixEvent[];
|
|
// The maximum number of names to show in either each summary e.g. 2 would result "A, B and 234 others left"
|
|
summaryLength?: number;
|
|
// The maximum number of avatars to display in the summary
|
|
avatarsMaxLength?: number;
|
|
// The minimum number of events needed to trigger summarisation
|
|
threshold?: number,
|
|
// Whether or not to begin with state.expanded=true
|
|
startExpanded?: boolean,
|
|
// An array of EventTiles to render when expanded
|
|
children: ReactChildren;
|
|
// Called when the MELS expansion is toggled
|
|
onToggle?(): void,
|
|
}
|
|
|
|
interface IUserEvents {
|
|
// The original event
|
|
mxEvent: MatrixEvent;
|
|
// The display name of the user (if not, then user ID)
|
|
displayName: string;
|
|
// The original index of the event in this.props.events
|
|
index: number;
|
|
}
|
|
|
|
enum TransitionType {
|
|
Joined = "joined",
|
|
Left = "left",
|
|
JoinedAndLeft = "joined_and_left",
|
|
LeftAndJoined = "left_and_joined",
|
|
InviteReject = "invite_reject",
|
|
InviteWithdrawal = "invite_withdrawal",
|
|
Invited = "invited",
|
|
Banned = "banned",
|
|
Unbanned = "unbanned",
|
|
Kicked = "kicked",
|
|
ChangedName = "changed_name",
|
|
ChangedAvatar = "changed_avatar",
|
|
NoChange = "no_change",
|
|
}
|
|
|
|
const SEP = ",";
|
|
|
|
@replaceableComponent("views.elements.MemberEventListSummary")
|
|
export default class MemberEventListSummary extends React.Component<IProps> {
|
|
static defaultProps = {
|
|
summaryLength: 1,
|
|
threshold: 3,
|
|
avatarsMaxLength: 5,
|
|
};
|
|
|
|
shouldComponentUpdate(nextProps) {
|
|
// Update if
|
|
// - The number of summarised events has changed
|
|
// - or if the summary is about to toggle to become collapsed
|
|
// - or if there are fewEvents, meaning the child eventTiles are shown as-is
|
|
return (
|
|
nextProps.events.length !== this.props.events.length ||
|
|
nextProps.events.length < this.props.threshold
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Generate the text for users aggregated by their transition sequences (`eventAggregates`) where
|
|
* the sequences are ordered by `orderedTransitionSequences`.
|
|
* @param {object} eventAggregates a map of transition sequence to array of user display names
|
|
* or user IDs.
|
|
* @param {string[]} orderedTransitionSequences an array which is some ordering of
|
|
* `Object.keys(eventAggregates)`.
|
|
* @returns {string} the textual summary of the aggregated events that occurred.
|
|
*/
|
|
private generateSummary(eventAggregates: Record<string, string[]>, orderedTransitionSequences: string[]) {
|
|
const summaries = orderedTransitionSequences.map((transitions) => {
|
|
const userNames = eventAggregates[transitions];
|
|
const nameList = this.renderNameList(userNames);
|
|
|
|
const splitTransitions = transitions.split(SEP) as TransitionType[];
|
|
|
|
// Some neighbouring transitions are common, so canonicalise some into "pair"
|
|
// transitions
|
|
const canonicalTransitions = MemberEventListSummary.getCanonicalTransitions(splitTransitions);
|
|
// Transform into consecutive repetitions of the same transition (like 5
|
|
// consecutive 'joined_and_left's)
|
|
const coalescedTransitions = MemberEventListSummary.coalesceRepeatedTransitions(canonicalTransitions);
|
|
|
|
const descs = coalescedTransitions.map((t) => {
|
|
return MemberEventListSummary.getDescriptionForTransition(
|
|
t.transitionType, userNames.length, t.repeats,
|
|
);
|
|
});
|
|
|
|
const desc = formatCommaSeparatedList(descs);
|
|
|
|
return _t('%(nameList)s %(transitionList)s', { nameList: nameList, transitionList: desc });
|
|
});
|
|
|
|
if (!summaries) {
|
|
return null;
|
|
}
|
|
|
|
return summaries.join(", ");
|
|
}
|
|
|
|
/**
|
|
* @param {string[]} users an array of user display names or user IDs.
|
|
* @returns {string} a comma-separated list that ends with "and [n] others" if there are
|
|
* more items in `users` than `this.props.summaryLength`, which is the number of names
|
|
* included before "and [n] others".
|
|
*/
|
|
private renderNameList(users: string[]) {
|
|
return formatCommaSeparatedList(users, this.props.summaryLength);
|
|
}
|
|
|
|
/**
|
|
* Canonicalise an array of transitions such that some pairs of transitions become
|
|
* single transitions. For example an input ['joined','left'] would result in an output
|
|
* ['joined_and_left'].
|
|
* @param {string[]} transitions an array of transitions.
|
|
* @returns {string[]} an array of transitions.
|
|
*/
|
|
private static getCanonicalTransitions(transitions: TransitionType[]): TransitionType[] {
|
|
const modMap = {
|
|
[TransitionType.Joined]: {
|
|
after: TransitionType.Left,
|
|
newTransition: TransitionType.JoinedAndLeft,
|
|
},
|
|
[TransitionType.Left]: {
|
|
after: TransitionType.Joined,
|
|
newTransition: TransitionType.LeftAndJoined,
|
|
},
|
|
// $currentTransition : {
|
|
// 'after' : $nextTransition,
|
|
// 'newTransition' : 'new_transition_type',
|
|
// },
|
|
};
|
|
const res: TransitionType[] = [];
|
|
|
|
for (let i = 0; i < transitions.length; i++) {
|
|
const t = transitions[i];
|
|
const t2 = transitions[i + 1];
|
|
|
|
let transition = t;
|
|
|
|
if (i < transitions.length - 1 && modMap[t] && modMap[t].after === t2) {
|
|
transition = modMap[t].newTransition;
|
|
i++;
|
|
}
|
|
|
|
res.push(transition);
|
|
}
|
|
return res;
|
|
}
|
|
|
|
/**
|
|
* Transform an array of transitions into an array of transitions and how many times
|
|
* they are repeated consecutively.
|
|
*
|
|
* An array of 123 "joined_and_left" transitions, would result in:
|
|
* ```
|
|
* [{
|
|
* transitionType: "joined_and_left"
|
|
* repeats: 123
|
|
* }]
|
|
* ```
|
|
* @param {string[]} transitions the array of transitions to transform.
|
|
* @returns {object[]} an array of coalesced transitions.
|
|
*/
|
|
private static coalesceRepeatedTransitions(transitions: TransitionType[]) {
|
|
const res: {
|
|
transitionType: TransitionType;
|
|
repeats: number;
|
|
}[] = [];
|
|
|
|
for (let i = 0; i < transitions.length; i++) {
|
|
if (res.length > 0 && res[res.length - 1].transitionType === transitions[i]) {
|
|
res[res.length - 1].repeats += 1;
|
|
} else {
|
|
res.push({
|
|
transitionType: transitions[i],
|
|
repeats: 1,
|
|
});
|
|
}
|
|
}
|
|
return res;
|
|
}
|
|
|
|
/**
|
|
* For a certain transition, t, describe what happened to the users that
|
|
* underwent the transition.
|
|
* @param {string} t the transition type.
|
|
* @param {number} userCount number of usernames
|
|
* @param {number} repeats the number of times the transition was repeated in a row.
|
|
* @returns {string} the written Human Readable equivalent of the transition.
|
|
*/
|
|
private static getDescriptionForTransition(t: TransitionType, userCount: number, repeats: number) {
|
|
// The empty interpolations 'severalUsers' and 'oneUser'
|
|
// are there only to show translators to non-English languages
|
|
// that the verb is conjugated to plural or singular Subject.
|
|
let res = null;
|
|
switch (t) {
|
|
case "joined":
|
|
res = (userCount > 1)
|
|
? _t("%(severalUsers)sjoined %(count)s times", { severalUsers: "", count: repeats })
|
|
: _t("%(oneUser)sjoined %(count)s times", { oneUser: "", count: repeats });
|
|
break;
|
|
case "left":
|
|
res = (userCount > 1)
|
|
? _t("%(severalUsers)sleft %(count)s times", { severalUsers: "", count: repeats })
|
|
: _t("%(oneUser)sleft %(count)s times", { oneUser: "", count: repeats });
|
|
break;
|
|
case "joined_and_left":
|
|
res = (userCount > 1)
|
|
? _t("%(severalUsers)sjoined and left %(count)s times", { severalUsers: "", count: repeats })
|
|
: _t("%(oneUser)sjoined and left %(count)s times", { oneUser: "", count: repeats });
|
|
break;
|
|
case "left_and_joined":
|
|
res = (userCount > 1)
|
|
? _t("%(severalUsers)sleft and rejoined %(count)s times", { severalUsers: "", count: repeats })
|
|
: _t("%(oneUser)sleft and rejoined %(count)s times", { oneUser: "", count: repeats });
|
|
break;
|
|
case "invite_reject":
|
|
res = (userCount > 1)
|
|
? _t("%(severalUsers)srejected their invitations %(count)s times", {
|
|
severalUsers: "",
|
|
count: repeats,
|
|
})
|
|
: _t("%(oneUser)srejected their invitation %(count)s times", { oneUser: "", count: repeats });
|
|
break;
|
|
case "invite_withdrawal":
|
|
res = (userCount > 1)
|
|
? _t("%(severalUsers)shad their invitations withdrawn %(count)s times", {
|
|
severalUsers: "",
|
|
count: repeats,
|
|
})
|
|
: _t("%(oneUser)shad their invitation withdrawn %(count)s times", { oneUser: "", count: repeats });
|
|
break;
|
|
case "invited":
|
|
res = (userCount > 1)
|
|
? _t("were invited %(count)s times", { count: repeats })
|
|
: _t("was invited %(count)s times", { count: repeats });
|
|
break;
|
|
case "banned":
|
|
res = (userCount > 1)
|
|
? _t("were banned %(count)s times", { count: repeats })
|
|
: _t("was banned %(count)s times", { count: repeats });
|
|
break;
|
|
case "unbanned":
|
|
res = (userCount > 1)
|
|
? _t("were unbanned %(count)s times", { count: repeats })
|
|
: _t("was unbanned %(count)s times", { count: repeats });
|
|
break;
|
|
case "kicked":
|
|
res = (userCount > 1)
|
|
? _t("were kicked %(count)s times", { count: repeats })
|
|
: _t("was kicked %(count)s times", { count: repeats });
|
|
break;
|
|
case "changed_name":
|
|
res = (userCount > 1)
|
|
? _t("%(severalUsers)schanged their name %(count)s times", { severalUsers: "", count: repeats })
|
|
: _t("%(oneUser)schanged their name %(count)s times", { oneUser: "", count: repeats });
|
|
break;
|
|
case "changed_avatar":
|
|
res = (userCount > 1)
|
|
? _t("%(severalUsers)schanged their avatar %(count)s times", { severalUsers: "", count: repeats })
|
|
: _t("%(oneUser)schanged their avatar %(count)s times", { oneUser: "", count: repeats });
|
|
break;
|
|
case "no_change":
|
|
res = (userCount > 1)
|
|
? _t("%(severalUsers)smade no changes %(count)s times", { severalUsers: "", count: repeats })
|
|
: _t("%(oneUser)smade no changes %(count)s times", { oneUser: "", count: repeats });
|
|
break;
|
|
}
|
|
|
|
return res;
|
|
}
|
|
|
|
private static getTransitionSequence(events: MatrixEvent[]) {
|
|
return events.map(MemberEventListSummary.getTransition);
|
|
}
|
|
|
|
/**
|
|
* Label a given membership event, `e`, where `getContent().membership` has
|
|
* changed for each transition allowed by the Matrix protocol. This attempts to
|
|
* label the membership changes that occur in `../../../TextForEvent.js`.
|
|
* @param {MatrixEvent} e the membership change event to label.
|
|
* @returns {string?} the transition type given to this event. This defaults to `null`
|
|
* if a transition is not recognised.
|
|
*/
|
|
private static getTransition(e: MatrixEvent): TransitionType {
|
|
if (e.mxEvent.getType() === 'm.room.third_party_invite') {
|
|
// Handle 3pid invites the same as invites so they get bundled together
|
|
if (!isValid3pidInvite(e.mxEvent)) {
|
|
return TransitionType.InviteWithdrawal;
|
|
}
|
|
return TransitionType.Invited;
|
|
}
|
|
|
|
switch (e.mxEvent.getContent().membership) {
|
|
case 'invite': return TransitionType.Invited;
|
|
case 'ban': return TransitionType.Banned;
|
|
case 'join':
|
|
if (e.mxEvent.getPrevContent().membership === 'join') {
|
|
if (e.mxEvent.getContent().displayname !==
|
|
e.mxEvent.getPrevContent().displayname) {
|
|
return TransitionType.ChangedName;
|
|
} else if (e.mxEvent.getContent().avatar_url !==
|
|
e.mxEvent.getPrevContent().avatar_url) {
|
|
return TransitionType.ChangedAvatar;
|
|
}
|
|
// console.log("MELS ignoring duplicate membership join event");
|
|
return TransitionType.NoChange;
|
|
} else {
|
|
return TransitionType.Joined;
|
|
}
|
|
case 'leave':
|
|
if (e.mxEvent.getSender() === e.mxEvent.getStateKey()) {
|
|
switch (e.mxEvent.getPrevContent().membership) {
|
|
case 'invite': return TransitionType.InviteReject;
|
|
default: return TransitionType.Left;
|
|
}
|
|
}
|
|
switch (e.mxEvent.getPrevContent().membership) {
|
|
case 'invite': return TransitionType.InviteWithdrawal;
|
|
case 'ban': return TransitionType.Unbanned;
|
|
// sender is not target and made the target leave, if not from invite/ban then this is a kick
|
|
default: return TransitionType.Kicked;
|
|
}
|
|
default: return null;
|
|
}
|
|
}
|
|
|
|
getAggregate(userEvents: Record<string, IUserEvents[]>) {
|
|
// A map of aggregate type to arrays of display names. Each aggregate type
|
|
// is a comma-delimited string of transitions, e.g. "joined,left,kicked".
|
|
// The array of display names is the array of users who went through that
|
|
// sequence during eventsToRender.
|
|
const aggregate: Record<string, string[]> = {
|
|
// $aggregateType : []:string
|
|
};
|
|
// A map of aggregate types to the indices that order them (the index of
|
|
// the first event for a given transition sequence)
|
|
const aggregateIndices: Record<string, number> = {
|
|
// $aggregateType : int
|
|
};
|
|
|
|
const users = Object.keys(userEvents);
|
|
users.forEach(
|
|
(userId) => {
|
|
const firstEvent = userEvents[userId][0];
|
|
const displayName = firstEvent.displayName;
|
|
|
|
const seq = MemberEventListSummary.getTransitionSequence(userEvents[userId]).join(SEP);
|
|
if (!aggregate[seq]) {
|
|
aggregate[seq] = [];
|
|
aggregateIndices[seq] = -1;
|
|
}
|
|
|
|
aggregate[seq].push(displayName);
|
|
|
|
if (aggregateIndices[seq] === -1 ||
|
|
firstEvent.index < aggregateIndices[seq]
|
|
) {
|
|
aggregateIndices[seq] = firstEvent.index;
|
|
}
|
|
},
|
|
);
|
|
|
|
return {
|
|
names: aggregate,
|
|
indices: aggregateIndices,
|
|
};
|
|
}
|
|
|
|
render() {
|
|
const eventsToRender = this.props.events;
|
|
|
|
// Map user IDs to latest Avatar Member. ES6 Maps are ordered by when the key was created,
|
|
// so this works perfectly for us to match event order whilst storing the latest Avatar Member
|
|
const latestUserAvatarMember = new Map<string, RoomMember>();
|
|
|
|
// Object mapping user IDs to an array of IUserEvents
|
|
const userEvents: Record<string, IUserEvents[]> = {};
|
|
eventsToRender.forEach((e, index) => {
|
|
const userId = e.getStateKey();
|
|
// Initialise a user's events
|
|
if (!userEvents[userId]) {
|
|
userEvents[userId] = [];
|
|
}
|
|
|
|
if (e.target) {
|
|
latestUserAvatarMember.set(userId, e.target);
|
|
}
|
|
|
|
let displayName = userId;
|
|
if (e.getType() === 'm.room.third_party_invite') {
|
|
displayName = e.getContent().display_name;
|
|
} else if (e.target) {
|
|
displayName = e.target.name;
|
|
}
|
|
|
|
userEvents[userId].push({
|
|
mxEvent: e,
|
|
displayName,
|
|
index: index,
|
|
});
|
|
});
|
|
|
|
const aggregate = this.getAggregate(userEvents);
|
|
|
|
// Sort types by order of lowest event index within sequence
|
|
const orderedTransitionSequences = Object.keys(aggregate.names).sort(
|
|
(seq1, seq2) => aggregate.indices[seq1] - aggregate.indices[seq2],
|
|
);
|
|
|
|
return <EventListSummary
|
|
events={this.props.events}
|
|
threshold={this.props.threshold}
|
|
onToggle={this.props.onToggle}
|
|
startExpanded={this.props.startExpanded}
|
|
children={this.props.children}
|
|
summaryMembers={[...latestUserAvatarMember.values()]}
|
|
summaryText={this.generateSummary(aggregate.names, orderedTransitionSequences)} />;
|
|
}
|
|
}
|