838 lines
37 KiB
JavaScript
838 lines
37 KiB
JavaScript
|
|
import _objectSpread from "@babel/runtime/helpers/objectSpread2";
|
||
|
|
import _defineProperty from "@babel/runtime/helpers/defineProperty";
|
||
|
|
/*
|
||
|
|
Copyright 2021 - 2023 The Matrix.org Foundation C.I.C.
|
||
|
|
|
||
|
|
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 { PendingEventOrdering } from "../client.js";
|
||
|
|
import { TypedReEmitter } from "../ReEmitter.js";
|
||
|
|
import { RelationType } from "../@types/event.js";
|
||
|
|
import { MatrixEvent, MatrixEventEvent } from "./event.js";
|
||
|
|
import { Direction, EventTimeline } from "./event-timeline.js";
|
||
|
|
import { EventTimelineSet } from "./event-timeline-set.js";
|
||
|
|
import { RoomEvent } from "./room.js";
|
||
|
|
import { ServerControlledNamespacedValue } from "../NamespacedValue.js";
|
||
|
|
import { logger } from "../logger.js";
|
||
|
|
import { ReadReceipt } from "./read-receipt.js";
|
||
|
|
import { ReceiptType } from "../@types/read_receipts.js";
|
||
|
|
import { Feature, ServerSupport } from "../feature.js";
|
||
|
|
export let ThreadEvent = /*#__PURE__*/function (ThreadEvent) {
|
||
|
|
ThreadEvent["New"] = "Thread.new";
|
||
|
|
ThreadEvent["Update"] = "Thread.update";
|
||
|
|
ThreadEvent["NewReply"] = "Thread.newReply";
|
||
|
|
ThreadEvent["ViewThread"] = "Thread.viewThread";
|
||
|
|
ThreadEvent["Delete"] = "Thread.delete";
|
||
|
|
return ThreadEvent;
|
||
|
|
}({});
|
||
|
|
export let FeatureSupport = /*#__PURE__*/function (FeatureSupport) {
|
||
|
|
FeatureSupport[FeatureSupport["None"] = 0] = "None";
|
||
|
|
FeatureSupport[FeatureSupport["Experimental"] = 1] = "Experimental";
|
||
|
|
FeatureSupport[FeatureSupport["Stable"] = 2] = "Stable";
|
||
|
|
return FeatureSupport;
|
||
|
|
}({});
|
||
|
|
export function determineFeatureSupport(stable, unstable) {
|
||
|
|
if (stable) {
|
||
|
|
return FeatureSupport.Stable;
|
||
|
|
} else if (unstable) {
|
||
|
|
return FeatureSupport.Experimental;
|
||
|
|
} else {
|
||
|
|
return FeatureSupport.None;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
export class Thread extends ReadReceipt {
|
||
|
|
constructor(id, rootEvent, opts) {
|
||
|
|
super();
|
||
|
|
|
||
|
|
// each Event in the thread adds a reemitter, so we could hit the listener limit.
|
||
|
|
/**
|
||
|
|
* A reference to all the events ID at the bottom of the threads
|
||
|
|
*/
|
||
|
|
_defineProperty(this, "timelineSet", void 0);
|
||
|
|
_defineProperty(this, "_currentUserParticipated", false);
|
||
|
|
_defineProperty(this, "reEmitter", void 0);
|
||
|
|
/**
|
||
|
|
* The last event in this thread, if we don't yet have this in the timeline.
|
||
|
|
*
|
||
|
|
* When we run {@link processRootEvent} (which I think happens during the
|
||
|
|
* setting-up of the thread), we set this to the event pointed to by the
|
||
|
|
* server in `latest_event` [1] that came through with the thread root.
|
||
|
|
*
|
||
|
|
* [1]: https://spec.matrix.org/v1.8/client-server-api/#server-side-aggregation-of-mthread-relationships
|
||
|
|
*
|
||
|
|
* Later, when we have populated the timeline, this is set to undefined, so
|
||
|
|
* that methods like {@link replyToEvent} fall through to use lastReply,
|
||
|
|
* which looks in the timeline for the latest event that is a "thread reply"
|
||
|
|
* i.e. directly refers to the thread root with an m.thread relation.
|
||
|
|
*
|
||
|
|
* So it looks like this is only really relevant when initialEventsFetched
|
||
|
|
* is false, because as soon as the initial events have been fetched, we
|
||
|
|
* should have a proper chunk of timeline from the pagination fetch.
|
||
|
|
*
|
||
|
|
* If all replies in this thread are redacted, this is set to the root
|
||
|
|
* event. I'm not clear what the meaning of this is, since usually after the
|
||
|
|
* initial events have been fetched, lastEvent should be undefined.
|
||
|
|
* In fact, the whole usage inside onRedaction looks suspect - it may be
|
||
|
|
* that we were thinking lastEvent always refers to the actual last event,
|
||
|
|
* but it only does so before initialEventsFetched becomes true.
|
||
|
|
*
|
||
|
|
* The usage of lastEvent inside {@link onEcho} looks suspicious, since I'd
|
||
|
|
* think we probably mean {@link replyToEvent} there - we are trying not to
|
||
|
|
* echo a duplicate event, and we probably want that behaviour even after
|
||
|
|
* initialEventsFetched has become true.
|
||
|
|
*
|
||
|
|
* -- andyb
|
||
|
|
*/
|
||
|
|
_defineProperty(this, "lastEvent", void 0);
|
||
|
|
_defineProperty(this, "replyCount", 0);
|
||
|
|
_defineProperty(this, "lastPendingEvent", void 0);
|
||
|
|
_defineProperty(this, "pendingReplyCount", 0);
|
||
|
|
_defineProperty(this, "room", void 0);
|
||
|
|
_defineProperty(this, "client", void 0);
|
||
|
|
_defineProperty(this, "pendingEventOrdering", void 0);
|
||
|
|
_defineProperty(this, "processRootEventPromise", void 0);
|
||
|
|
/**
|
||
|
|
* Whether or not we need to fetch the initial set of events for the thread. We can
|
||
|
|
* only do this if the server has support for it, so if it doesn't we just pretend
|
||
|
|
* that we've already fetched them.
|
||
|
|
*/
|
||
|
|
_defineProperty(this, "initialEventsFetched", !Thread.hasServerSideSupport);
|
||
|
|
_defineProperty(this, "initalEventFetchProm", void 0);
|
||
|
|
_defineProperty(this, "preInitEventTargets", new Map());
|
||
|
|
_defineProperty(this, "preInitObserverState", {
|
||
|
|
active: true
|
||
|
|
});
|
||
|
|
/**
|
||
|
|
* An array of events to add to the timeline once the thread has been initialised
|
||
|
|
* with server suppport.
|
||
|
|
*/
|
||
|
|
_defineProperty(this, "replayEvents", []);
|
||
|
|
_defineProperty(this, "onTimelineReset", async () => {
|
||
|
|
// We hit a gappy sync, ask the server for an update
|
||
|
|
await this.processRootEventPromise;
|
||
|
|
this.processRootEventPromise = undefined;
|
||
|
|
});
|
||
|
|
_defineProperty(this, "onBeforeRedaction", (event, redaction) => {
|
||
|
|
if (event?.isRelation(THREAD_RELATION_TYPE.name) && this.room.eventShouldLiveIn(event).threadId === this.id && event.getId() !== this.id &&
|
||
|
|
// the root event isn't counted in the length so ignore this redaction
|
||
|
|
!redaction.status // only respect it when it succeeds
|
||
|
|
) {
|
||
|
|
this.replyCount--;
|
||
|
|
this.updatePendingReplyCount();
|
||
|
|
this.emit(ThreadEvent.Update, this);
|
||
|
|
}
|
||
|
|
});
|
||
|
|
_defineProperty(this, "onRedaction", async (event, room, threadRootId) => {
|
||
|
|
if (threadRootId !== this.id) return; // ignore redactions for other timelines
|
||
|
|
if (this.replyCount <= 0) {
|
||
|
|
for (const threadEvent of this.timeline) {
|
||
|
|
this.clearEventMetadata(threadEvent);
|
||
|
|
}
|
||
|
|
this.lastEvent = this.rootEvent;
|
||
|
|
this._currentUserParticipated = false;
|
||
|
|
this.emit(ThreadEvent.Delete, this);
|
||
|
|
} else {
|
||
|
|
if (this.lastEvent?.getId() === event.getAssociatedId()) {
|
||
|
|
// XXX: If our last event got redacted we query the server for the last event once again
|
||
|
|
await this.processRootEventPromise;
|
||
|
|
this.processRootEventPromise = undefined;
|
||
|
|
}
|
||
|
|
await this.updateThreadMetadata();
|
||
|
|
}
|
||
|
|
});
|
||
|
|
_defineProperty(this, "onTimelineEvent", (event, room, toStartOfTimeline) => {
|
||
|
|
// Add a synthesized receipt when paginating forward in the timeline
|
||
|
|
if (!toStartOfTimeline) {
|
||
|
|
const sender = event.getSender();
|
||
|
|
if (sender && room && this.shouldSendLocalEchoReceipt(sender, event)) {
|
||
|
|
room.addLocalEchoReceipt(sender, event, ReceiptType.Read);
|
||
|
|
}
|
||
|
|
if (event.getId() !== this.id && event.isRelation(THREAD_RELATION_TYPE.name)) {
|
||
|
|
this.replyCount++;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
this.onEcho(event, toStartOfTimeline ?? false);
|
||
|
|
});
|
||
|
|
_defineProperty(this, "onLocalEcho", event => {
|
||
|
|
this.onEcho(event, false);
|
||
|
|
});
|
||
|
|
_defineProperty(this, "onEcho", async (event, toStartOfTimeline) => {
|
||
|
|
if (event.threadRootId !== this.id) return; // ignore echoes for other timelines
|
||
|
|
if (this.lastEvent === event) return; // ignore duplicate events
|
||
|
|
await this.updateThreadMetadata();
|
||
|
|
if (!event.isRelation(THREAD_RELATION_TYPE.name)) return; // don't send a new reply event for reactions or edits
|
||
|
|
if (toStartOfTimeline) return; // ignore messages added to the start of the timeline
|
||
|
|
// Clear the lastEvent and instead start tracking locally using lastReply
|
||
|
|
this.lastEvent = undefined;
|
||
|
|
this.emit(ThreadEvent.NewReply, this, event);
|
||
|
|
});
|
||
|
|
this.id = id;
|
||
|
|
this.rootEvent = rootEvent;
|
||
|
|
this.setMaxListeners(1000);
|
||
|
|
if (!opts?.room) {
|
||
|
|
// Logging/debugging for https://github.com/vector-im/element-web/issues/22141
|
||
|
|
// Hope is that we end up with a more obvious stack trace.
|
||
|
|
throw new Error("element-web#22141: A thread requires a room in order to function");
|
||
|
|
}
|
||
|
|
this.room = opts.room;
|
||
|
|
this.client = opts.client;
|
||
|
|
this.pendingEventOrdering = opts.pendingEventOrdering ?? PendingEventOrdering.Chronological;
|
||
|
|
this.timelineSet = new EventTimelineSet(this.room, {
|
||
|
|
timelineSupport: true,
|
||
|
|
pendingEvents: true
|
||
|
|
}, this.client, this);
|
||
|
|
this.reEmitter = new TypedReEmitter(this);
|
||
|
|
this.reEmitter.reEmit(this.timelineSet, [RoomEvent.Timeline, RoomEvent.TimelineReset]);
|
||
|
|
this.once(ThreadEvent.Delete, () => {
|
||
|
|
this.preInitObserverState.active = false;
|
||
|
|
});
|
||
|
|
this.room.on(MatrixEventEvent.BeforeRedaction, this.onBeforeRedaction);
|
||
|
|
this.room.on(RoomEvent.Redaction, this.onRedaction);
|
||
|
|
this.room.on(RoomEvent.LocalEchoUpdated, this.onLocalEcho);
|
||
|
|
this.room.on(RoomEvent.TimelineReset, this.onTimelineReset);
|
||
|
|
this.timelineSet.on(RoomEvent.Timeline, this.onTimelineEvent);
|
||
|
|
this.processReceipts(opts.receipts);
|
||
|
|
|
||
|
|
// even if this thread is thought to be originating from this client, we initialise it as we may be in a
|
||
|
|
// gappy sync and a thread around this event may already exist.
|
||
|
|
this.updateThreadMetadata();
|
||
|
|
this.setEventMetadata(this.rootEvent);
|
||
|
|
}
|
||
|
|
async fetchRootEvent() {
|
||
|
|
// Always fetch the root event, even if we already have it, so we can get the latest
|
||
|
|
// state (via unsigned).
|
||
|
|
try {
|
||
|
|
const eventData = await this.client.fetchRoomEvent(this.roomId, this.id);
|
||
|
|
const mapper = this.client.getEventMapper();
|
||
|
|
this.rootEvent = mapper(eventData); // will merge with existing event object if such is known
|
||
|
|
} catch (e) {
|
||
|
|
logger.error("Failed to fetch thread root to construct thread with", e);
|
||
|
|
}
|
||
|
|
await this.processEvent(this.rootEvent);
|
||
|
|
}
|
||
|
|
static setServerSideSupport(status) {
|
||
|
|
Thread.hasServerSideSupport = status;
|
||
|
|
// XXX: This global latching behaviour is really unexpected and means that you can't undo when moving to a server without support
|
||
|
|
if (status !== FeatureSupport.Stable) {
|
||
|
|
FILTER_RELATED_BY_SENDERS.setPreferUnstable(true);
|
||
|
|
FILTER_RELATED_BY_REL_TYPES.setPreferUnstable(true);
|
||
|
|
THREAD_RELATION_TYPE.setPreferUnstable(true);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
static setServerSideListSupport(status) {
|
||
|
|
Thread.hasServerSideListSupport = status;
|
||
|
|
}
|
||
|
|
static setServerSideFwdPaginationSupport(status) {
|
||
|
|
Thread.hasServerSideFwdPaginationSupport = status;
|
||
|
|
}
|
||
|
|
shouldSendLocalEchoReceipt(sender, event) {
|
||
|
|
const recursionSupport = this.client.canSupport.get(Feature.RelationsRecursion) ?? ServerSupport.Unsupported;
|
||
|
|
if (recursionSupport === ServerSupport.Unsupported) {
|
||
|
|
// Normally we add a local receipt, but if we don't have
|
||
|
|
// recursion support, then events may arrive out of order, so we
|
||
|
|
// only create a receipt if it's after our existing receipt.
|
||
|
|
const oldReceiptEventId = this.getReadReceiptForUserId(sender)?.eventId;
|
||
|
|
if (oldReceiptEventId) {
|
||
|
|
const receiptEvent = this.findEventById(oldReceiptEventId);
|
||
|
|
if (receiptEvent && receiptEvent.getTs() > event.getTs()) {
|
||
|
|
return false;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return true;
|
||
|
|
}
|
||
|
|
get roomState() {
|
||
|
|
return this.room.getLiveTimeline().getState(EventTimeline.FORWARDS);
|
||
|
|
}
|
||
|
|
addEventToTimeline(event, toStartOfTimeline) {
|
||
|
|
if (!this.findEventById(event.getId())) {
|
||
|
|
this.timelineSet.addEventToTimeline(event, this.liveTimeline, {
|
||
|
|
toStartOfTimeline,
|
||
|
|
fromCache: false,
|
||
|
|
roomState: this.roomState,
|
||
|
|
addToState: false
|
||
|
|
});
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* TEMPORARY. Only call this when MSC3981 is not available, and we have some
|
||
|
|
* late-arriving events to insert, because we recursively found them as part
|
||
|
|
* of populating a thread. When we have MSC3981 we won't need it, because
|
||
|
|
* they will all be supplied by the homeserver in one request, and they will
|
||
|
|
* already be in the right order in that response.
|
||
|
|
* This is a copy of addEventToTimeline above, modified to call
|
||
|
|
* insertEventIntoTimeline so this event is inserted into our best guess of
|
||
|
|
* the right place based on timestamp. (We should be using Sync Order but we
|
||
|
|
* don't have it.)
|
||
|
|
*
|
||
|
|
* @internal
|
||
|
|
*/
|
||
|
|
insertEventIntoTimeline(event) {
|
||
|
|
const eventId = event.getId();
|
||
|
|
if (!eventId) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
// If the event is already in this thread, bail out
|
||
|
|
if (this.findEventById(eventId)) {
|
||
|
|
return;
|
||
|
|
}
|
||
|
|
this.timelineSet.insertEventIntoTimeline(event, this.liveTimeline, this.roomState, false);
|
||
|
|
}
|
||
|
|
addEvents(events, toStartOfTimeline) {
|
||
|
|
events.forEach(ev => this.addEvent(ev, toStartOfTimeline, false));
|
||
|
|
this.updateThreadMetadata();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Add an event to the thread and updates
|
||
|
|
* the tail/root references if needed
|
||
|
|
* Will fire "Thread.update"
|
||
|
|
* @param event - The event to add
|
||
|
|
* @param toStartOfTimeline - whether the event is being added
|
||
|
|
* to the start (and not the end) of the timeline.
|
||
|
|
* @param emit - whether to emit the Update event if the thread was updated or not.
|
||
|
|
*/
|
||
|
|
addEvent(event, toStartOfTimeline, emit = true) {
|
||
|
|
// Modify this event to point at our room's state, and mark its thread
|
||
|
|
// as this.
|
||
|
|
this.setEventMetadata(event);
|
||
|
|
const eventId = event.getId();
|
||
|
|
if (!this.initialEventsFetched && eventId && !event.isRelation(RelationType.Annotation) && !event.isRelation(RelationType.Replace)) {
|
||
|
|
this.preInitEventTargets.set(eventId, event);
|
||
|
|
}
|
||
|
|
|
||
|
|
// Decide whether this event is going to be added at the end of the timeline.
|
||
|
|
const lastReply = this.lastReply();
|
||
|
|
const isNewestReply = !lastReply || event.localTimestamp >= lastReply.localTimestamp;
|
||
|
|
if (!Thread.hasServerSideSupport) {
|
||
|
|
// When there's no server-side support, just add it to the end of the timeline.
|
||
|
|
this.addEventToTimeline(event, toStartOfTimeline);
|
||
|
|
this.client.decryptEventIfNeeded(event);
|
||
|
|
} else if (event.isRelation(RelationType.Annotation) || event.isRelation(RelationType.Replace)) {
|
||
|
|
this.addRelatedThreadEvent(event, toStartOfTimeline);
|
||
|
|
return;
|
||
|
|
} else if (!toStartOfTimeline && isNewestReply) {
|
||
|
|
// When we've asked for the event to be added to the end,
|
||
|
|
// and this event belongs at the end, add it.
|
||
|
|
this.addEventToTimeline(event, false);
|
||
|
|
this.fetchEditsWhereNeeded(event);
|
||
|
|
} else {
|
||
|
|
// Otherwise, we should add it, but we suspect it is out of order.
|
||
|
|
// This may be because we've just created the thread object and are
|
||
|
|
// still fetching events, in which case add it where we think is sensible
|
||
|
|
// and it will be removed and replaced with the events from the pagination
|
||
|
|
// request once that completes.
|
||
|
|
if (toStartOfTimeline) {
|
||
|
|
// If we're adding at the start of the timeline, it doesn't
|
||
|
|
// matter that it's out of order.
|
||
|
|
this.addEventToTimeline(event, toStartOfTimeline);
|
||
|
|
} else {
|
||
|
|
// We think this event might be out of order, because isNewestReply
|
||
|
|
// is false (otherwise we would have gone into the earlier if
|
||
|
|
// clause), so try to insert it in the right place based on
|
||
|
|
// timestamp.
|
||
|
|
this.insertEventIntoTimeline(event);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
if (event.getId() !== this.id && event.isRelation(THREAD_RELATION_TYPE.name) && !toStartOfTimeline && isNewestReply) {
|
||
|
|
// Clear the last event as we have the latest end of the timeline
|
||
|
|
this.lastEvent = undefined;
|
||
|
|
}
|
||
|
|
if (emit) {
|
||
|
|
this.emit(ThreadEvent.NewReply, this, event);
|
||
|
|
this.updateThreadMetadata();
|
||
|
|
}
|
||
|
|
}
|
||
|
|
addRelatedThreadEvent(event, toStartOfTimeline) {
|
||
|
|
// If this event is not a direct member of the thread, but is a
|
||
|
|
// reference to something that is, then we have two cases:
|
||
|
|
|
||
|
|
if (!this.initialEventsFetched) {
|
||
|
|
// Case 1: we haven't yet fetched events from the server. In
|
||
|
|
// this case, when we do, the events we get back might only be
|
||
|
|
// the first-order ones, so this event (which is second-order -
|
||
|
|
// a reference to something directly in the thread) needs to be
|
||
|
|
// kept so we can replay it when the first-order ones turn up.
|
||
|
|
|
||
|
|
/**
|
||
|
|
* A thread can be fully discovered via a single sync response
|
||
|
|
* And when that's the case we still ask the server to do an initialisation
|
||
|
|
* as it's the safest to ensure we have everything.
|
||
|
|
* However when we are in that scenario we might loose annotation or edits
|
||
|
|
*
|
||
|
|
* This fix keeps a reference to those events and replay them once the thread
|
||
|
|
* has been initialised properly.
|
||
|
|
*/
|
||
|
|
this.replayEvents?.push(event);
|
||
|
|
|
||
|
|
// Aggregate annotations immediately to keep reaction counts visible.
|
||
|
|
if (event.isRelation(RelationType.Annotation)) {
|
||
|
|
this.timelineSet.relations?.aggregateChildEvent(event, this.timelineSet);
|
||
|
|
}
|
||
|
|
|
||
|
|
// Edits can also be aggregated immediately when their target is already
|
||
|
|
// known. If it is not known yet, replay still handles them after pagination.
|
||
|
|
if (event.isRelation(RelationType.Replace)) {
|
||
|
|
const targetEventId = event.getRelation()?.event_id;
|
||
|
|
const targetEvent = targetEventId ? this.findPreInitTargetEvent(targetEventId) : undefined;
|
||
|
|
if (targetEvent && targetEventId) {
|
||
|
|
const weakThread = new WeakRef(this);
|
||
|
|
const observerState = this.preInitObserverState;
|
||
|
|
const eventId = event.getId();
|
||
|
|
void this.timelineSet.relations.aggregateChildEvent(event, this.timelineSet, targetEvent).then(() => {
|
||
|
|
const thread = weakThread.deref();
|
||
|
|
if (!thread || !observerState.active) return;
|
||
|
|
const effectiveTarget = thread.findPreInitTargetEvent(targetEventId);
|
||
|
|
if (effectiveTarget?.replacingEvent()?.getId() === eventId) {
|
||
|
|
thread.emit(ThreadEvent.Update, thread);
|
||
|
|
}
|
||
|
|
}).catch(error => logger.error("Failed to aggregate pre-initialization thread edit: ", error));
|
||
|
|
}
|
||
|
|
}
|
||
|
|
} else {
|
||
|
|
// Case 2: this is happening later, and we have a timeline. In
|
||
|
|
// this case, these events might be out-of order.
|
||
|
|
//
|
||
|
|
// Specifically, if the server doesn't support recursion, so we
|
||
|
|
// only get these events through sync, they might be coming
|
||
|
|
// later than the first-order ones, so we insert them based on
|
||
|
|
// timestamp (despite the problems with this documented in
|
||
|
|
// #3325).
|
||
|
|
//
|
||
|
|
// If the server does support recursion, we should have got all
|
||
|
|
// the interspersed events from the server when we fetched the
|
||
|
|
// initial events, so if they are coming via sync they should be
|
||
|
|
// the latest ones, so we can add them as normal.
|
||
|
|
//
|
||
|
|
// (Note that both insertEventIntoTimeline and addEventToTimeline
|
||
|
|
// do nothing if we have seen this event before.)
|
||
|
|
|
||
|
|
const recursionSupport = this.client.canSupport.get(Feature.RelationsRecursion) ?? ServerSupport.Unsupported;
|
||
|
|
if (recursionSupport === ServerSupport.Unsupported) {
|
||
|
|
this.insertEventIntoTimeline(event);
|
||
|
|
} else {
|
||
|
|
this.addEventToTimeline(event, toStartOfTimeline);
|
||
|
|
}
|
||
|
|
// Aggregation is handled by EventTimelineSet when inserting/adding.
|
||
|
|
}
|
||
|
|
}
|
||
|
|
findPreInitTargetEvent(eventId) {
|
||
|
|
return this.timelineSet.findEventById(eventId) ?? this.room.findEventById(eventId) ?? this.preInitEventTargets.get(eventId) ?? (this.lastEvent?.getId() === eventId ? this.lastEvent : undefined);
|
||
|
|
}
|
||
|
|
async processEvent(event) {
|
||
|
|
if (event) {
|
||
|
|
this.setEventMetadata(event);
|
||
|
|
await this.fetchEditsWhereNeeded(event);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Processes the receipts that were caught during initial sync
|
||
|
|
* When clients become aware of a thread, they try to retrieve those read receipts
|
||
|
|
* and apply them to the current thread
|
||
|
|
* @param receipts - A collection of the receipts cached from initial sync
|
||
|
|
*/
|
||
|
|
processReceipts(receipts = []) {
|
||
|
|
for (const {
|
||
|
|
eventId,
|
||
|
|
receiptType,
|
||
|
|
userId,
|
||
|
|
receipt,
|
||
|
|
synthetic
|
||
|
|
} of receipts) {
|
||
|
|
this.addReceiptToStructure(eventId, receiptType, userId, receipt, synthetic);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
getRootEventBundledRelationship(rootEvent = this.rootEvent) {
|
||
|
|
return rootEvent?.getServerAggregatedRelation(THREAD_RELATION_TYPE.name);
|
||
|
|
}
|
||
|
|
async processRootEvent() {
|
||
|
|
const bundledRelationship = this.getRootEventBundledRelationship();
|
||
|
|
if (Thread.hasServerSideSupport && bundledRelationship) {
|
||
|
|
this.replyCount = bundledRelationship.count;
|
||
|
|
this._currentUserParticipated = !!bundledRelationship.current_user_participated;
|
||
|
|
const mapper = this.client.getEventMapper();
|
||
|
|
// re-insert roomId
|
||
|
|
this.lastEvent = mapper(_objectSpread(_objectSpread({}, bundledRelationship.latest_event), {}, {
|
||
|
|
room_id: this.roomId
|
||
|
|
}));
|
||
|
|
this.updatePendingReplyCount();
|
||
|
|
await this.processEvent(this.lastEvent);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
updatePendingReplyCount() {
|
||
|
|
const unfilteredPendingEvents = this.pendingEventOrdering === PendingEventOrdering.Detached ? this.room.getPendingEvents() : this.events;
|
||
|
|
const pendingEvents = unfilteredPendingEvents.filter(ev => ev.threadRootId === this.id && ev.isRelation(THREAD_RELATION_TYPE.name) && ev.status !== null && ev.getId() !== this.lastEvent?.getId());
|
||
|
|
this.lastPendingEvent = pendingEvents.length ? pendingEvents[pendingEvents.length - 1] : undefined;
|
||
|
|
this.pendingReplyCount = pendingEvents.length;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Reset the live timeline of all timelineSets, and start new ones.
|
||
|
|
*
|
||
|
|
* <p>This is used when /sync returns a 'limited' timeline. 'Limited' means that there's a gap between the messages
|
||
|
|
* /sync returned, and the last known message in our timeline. In such a case, our live timeline isn't live anymore
|
||
|
|
* and has to be replaced by a new one. To make sure we can continue paginating our timelines correctly, we have to
|
||
|
|
* set new pagination tokens on the old and the new timeline.
|
||
|
|
*
|
||
|
|
* @param backPaginationToken - token for back-paginating the new timeline
|
||
|
|
* @param forwardPaginationToken - token for forward-paginating the old live timeline,
|
||
|
|
* if absent or null, all timelines are reset, removing old ones (including the previous live
|
||
|
|
* timeline which would otherwise be unable to paginate forwards without this token).
|
||
|
|
* Removing just the old live timeline whilst preserving previous ones is not supported.
|
||
|
|
*/
|
||
|
|
async resetLiveTimeline(backPaginationToken, forwardPaginationToken) {
|
||
|
|
const oldLive = this.liveTimeline;
|
||
|
|
this.timelineSet.resetLiveTimeline(backPaginationToken ?? undefined, forwardPaginationToken ?? undefined);
|
||
|
|
const newLive = this.liveTimeline;
|
||
|
|
|
||
|
|
// FIXME: Remove the following as soon as https://github.com/matrix-org/synapse/issues/14830 is resolved.
|
||
|
|
//
|
||
|
|
// The pagination API for thread timelines currently can't handle the type of pagination tokens returned by sync
|
||
|
|
//
|
||
|
|
// To make this work anyway, we'll have to transform them into one of the types that the API can handle.
|
||
|
|
// One option is passing the tokens to /messages, which can handle sync tokens, and returns the right format.
|
||
|
|
// /messages does not return new tokens on requests with a limit of 0.
|
||
|
|
// This means our timelines might overlap a slight bit, but that's not an issue, as we deduplicate messages
|
||
|
|
// anyway.
|
||
|
|
|
||
|
|
let newBackward;
|
||
|
|
let oldForward;
|
||
|
|
if (backPaginationToken) {
|
||
|
|
const res = await this.client.createMessagesRequest(this.roomId, backPaginationToken, 1, Direction.Forward);
|
||
|
|
newBackward = res.end;
|
||
|
|
}
|
||
|
|
if (forwardPaginationToken) {
|
||
|
|
const res = await this.client.createMessagesRequest(this.roomId, forwardPaginationToken, 1, Direction.Backward);
|
||
|
|
oldForward = res.start;
|
||
|
|
}
|
||
|
|
// Only replace the token if we don't have paginated away from this position already. This situation doesn't
|
||
|
|
// occur today, but if the above issue is resolved, we'd have to go down this path.
|
||
|
|
if (forwardPaginationToken && oldLive.getPaginationToken(Direction.Forward) === forwardPaginationToken) {
|
||
|
|
oldLive.setPaginationToken(oldForward ?? null, Direction.Forward);
|
||
|
|
}
|
||
|
|
if (backPaginationToken && newLive.getPaginationToken(Direction.Backward) === backPaginationToken) {
|
||
|
|
newLive.setPaginationToken(newBackward ?? null, Direction.Backward);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
async updateThreadFromRootEvent() {
|
||
|
|
if (Thread.hasServerSideSupport) {
|
||
|
|
// Ensure we show *something* as soon as possible, we'll update it as soon as we get better data, but we
|
||
|
|
// don't want the thread preview to be empty if we can avoid it
|
||
|
|
if (!this.initialEventsFetched && !this.lastEvent) {
|
||
|
|
await this.processRootEvent();
|
||
|
|
}
|
||
|
|
await this.fetchRootEvent();
|
||
|
|
}
|
||
|
|
await this.processRootEvent();
|
||
|
|
}
|
||
|
|
async updateThreadMetadata() {
|
||
|
|
this.updatePendingReplyCount();
|
||
|
|
if (!this.processRootEventPromise) {
|
||
|
|
// We only want to do this once otherwise we end up rolling back to the last unsigned summary we have for the thread
|
||
|
|
this.processRootEventPromise = this.updateThreadFromRootEvent();
|
||
|
|
}
|
||
|
|
await this.processRootEventPromise;
|
||
|
|
if (!this.initialEventsFetched) {
|
||
|
|
if (this.initalEventFetchProm) {
|
||
|
|
await this.initalEventFetchProm;
|
||
|
|
} else {
|
||
|
|
// fetch initial events to allow proper pagination
|
||
|
|
try {
|
||
|
|
// clear out any events that were added before the pagination request
|
||
|
|
// completed (eg. from sync). They'll be replaced by those from the pagination.
|
||
|
|
// Really, we should do this after the pagination request completes, but
|
||
|
|
// paginateEventTimeline does the request and adds the events in one go, so
|
||
|
|
// this would need a refactor in order to do. It's therefore possible there's
|
||
|
|
// a remaining race where an event comes in while the pagination request is
|
||
|
|
// happening.
|
||
|
|
this.timelineSet.resetLiveTimeline();
|
||
|
|
// if the thread has regular events, this will just load the last reply.
|
||
|
|
// if the thread is newly created, this will load the root event.
|
||
|
|
if (this.replyCount === 0 && this.rootEvent) {
|
||
|
|
this.timelineSet.addEventsToTimeline([this.rootEvent], true, false, this.liveTimeline, null);
|
||
|
|
this.liveTimeline.setPaginationToken(null, Direction.Backward);
|
||
|
|
} else {
|
||
|
|
this.initalEventFetchProm = this.client.paginateEventTimeline(this.liveTimeline, {
|
||
|
|
backwards: true
|
||
|
|
});
|
||
|
|
await this.initalEventFetchProm;
|
||
|
|
}
|
||
|
|
// We have now fetched the initial events, so set the flag. We need to do this before
|
||
|
|
// we actually add the events, so `this.addEvents` knows that it can now safely add
|
||
|
|
// them rather than buffer them in the pending event list. The main thing is that this
|
||
|
|
// must remain false while the async fetch happens, so we don't try to add events before
|
||
|
|
// the pagination has finished. The important thing is that we're not await-ing anything
|
||
|
|
// else between setting this and adding events, so no races.
|
||
|
|
this.initialEventsFetched = true;
|
||
|
|
for (const event of this.replayEvents) {
|
||
|
|
this.addEvent(event, false);
|
||
|
|
}
|
||
|
|
this.replayEvents = null;
|
||
|
|
this.preInitEventTargets.clear();
|
||
|
|
// just to make sure that, if we've created a timeline window for this thread before the thread itself
|
||
|
|
// existed (e.g. when creating a new thread), we'll make sure the panel is force refreshed correctly.
|
||
|
|
this.emit(RoomEvent.TimelineReset, this.room, this.timelineSet, true);
|
||
|
|
} catch (e) {
|
||
|
|
logger.error("Failed to load start of newly created thread: ", e);
|
||
|
|
this.initialEventsFetched = false;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
this.emit(ThreadEvent.Update, this);
|
||
|
|
}
|
||
|
|
|
||
|
|
// XXX: Workaround for https://github.com/matrix-org/matrix-spec-proposals/pull/2676/files#r827240084
|
||
|
|
async fetchEditsWhereNeeded(...events) {
|
||
|
|
const recursionSupport = this.client.canSupport.get(Feature.RelationsRecursion) ?? ServerSupport.Unsupported;
|
||
|
|
if (recursionSupport === ServerSupport.Unsupported) {
|
||
|
|
return Promise.all(events.filter(isAnEncryptedThreadMessage).map(async event => {
|
||
|
|
try {
|
||
|
|
const relations = await this.client.relations(this.roomId, event.getId(), RelationType.Replace, event.getType(), {
|
||
|
|
limit: 1
|
||
|
|
});
|
||
|
|
if (relations.events.length) {
|
||
|
|
const editEvent = relations.events[0];
|
||
|
|
event.makeReplaced(editEvent);
|
||
|
|
this.insertEventIntoTimeline(editEvent);
|
||
|
|
}
|
||
|
|
} catch (e) {
|
||
|
|
logger.error("Failed to load edits for encrypted thread event", e);
|
||
|
|
}
|
||
|
|
}));
|
||
|
|
}
|
||
|
|
}
|
||
|
|
setEventMetadata(event) {
|
||
|
|
if (event) {
|
||
|
|
EventTimeline.setEventMetadata(event, this.roomState, false);
|
||
|
|
event.setThread(this);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
clearEventMetadata(event) {
|
||
|
|
if (event) {
|
||
|
|
event.setThread(undefined);
|
||
|
|
delete event.event?.unsigned?.["m.relations"]?.[THREAD_RELATION_TYPE.name];
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Finds an event by ID in the current thread
|
||
|
|
*/
|
||
|
|
findEventById(eventId) {
|
||
|
|
return this.timelineSet.findEventById(eventId);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Return last reply to the thread, if known.
|
||
|
|
*/
|
||
|
|
lastReply(matches = ev => ev.isRelation(THREAD_RELATION_TYPE.name)) {
|
||
|
|
for (let i = this.timeline.length - 1; i >= 0; i--) {
|
||
|
|
const event = this.timeline[i];
|
||
|
|
if (matches(event)) {
|
||
|
|
return event;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
get roomId() {
|
||
|
|
return this.room.roomId;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The number of messages in the thread
|
||
|
|
* Only count rel_type=m.thread as we want to
|
||
|
|
* exclude annotations from that number
|
||
|
|
*/
|
||
|
|
get length() {
|
||
|
|
return this.replyCount + this.pendingReplyCount;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* A getter for the last event of the thread.
|
||
|
|
* This might be a synthesized event, if so, it will not emit any events to listeners.
|
||
|
|
*/
|
||
|
|
get replyToEvent() {
|
||
|
|
return this.lastPendingEvent ?? this.lastEvent ?? this.lastReply();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The live event timeline for this thread.
|
||
|
|
* @deprecated Present for backwards compatibility.
|
||
|
|
* Use this.events instead
|
||
|
|
* @returns The live event timeline for this thread.
|
||
|
|
*/
|
||
|
|
get timeline() {
|
||
|
|
return this.events;
|
||
|
|
}
|
||
|
|
get events() {
|
||
|
|
return this.liveTimeline.getEvents();
|
||
|
|
}
|
||
|
|
has(eventId) {
|
||
|
|
return this.timelineSet.findEventById(eventId) instanceof MatrixEvent;
|
||
|
|
}
|
||
|
|
get hasCurrentUserParticipated() {
|
||
|
|
return this._currentUserParticipated;
|
||
|
|
}
|
||
|
|
get liveTimeline() {
|
||
|
|
return this.timelineSet.getLiveTimeline();
|
||
|
|
}
|
||
|
|
getUnfilteredTimelineSet() {
|
||
|
|
return this.timelineSet;
|
||
|
|
}
|
||
|
|
addReceipt(event, synthetic) {
|
||
|
|
throw new Error("Unsupported function on the thread model");
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get the ID of the event that a given user has read up to within this thread,
|
||
|
|
* or null if we have received no read receipt (at all) from them.
|
||
|
|
* @param userId - The user ID to get read receipt event ID for
|
||
|
|
* @param ignoreSynthesized - If true, return only receipts that have been
|
||
|
|
* sent by the server, not implicit ones generated
|
||
|
|
* by the JS SDK.
|
||
|
|
* @returns ID of the latest event that the given user has read, or null.
|
||
|
|
*/
|
||
|
|
getEventReadUpTo(userId, ignoreSynthesized) {
|
||
|
|
// TODO: we think the implementation here is not right. Here is a sketch
|
||
|
|
// of the right answer:
|
||
|
|
//
|
||
|
|
// for event in timeline.events.reversed():
|
||
|
|
// if room.hasUserReadEvent(event):
|
||
|
|
// return event
|
||
|
|
// return null
|
||
|
|
//
|
||
|
|
// If this is too slow, we might be able to improve it by trying walking
|
||
|
|
// forward from the threaded receipt in this thread. We could alternate
|
||
|
|
// between backwards-from-front and forwards-from-threaded-receipt to
|
||
|
|
// improve our chances of hitting the right answer sooner.
|
||
|
|
//
|
||
|
|
// Either way, it's still fundamentally slow because we have to walk
|
||
|
|
// events.
|
||
|
|
//
|
||
|
|
// We also might just want to limit the time we spend on this by giving
|
||
|
|
// up after, say, 100 events.
|
||
|
|
//
|
||
|
|
// --- andyb
|
||
|
|
|
||
|
|
const isCurrentUser = userId === this.client.getUserId();
|
||
|
|
const lastReply = this.timeline[this.timeline.length - 1];
|
||
|
|
if (isCurrentUser && lastReply) {
|
||
|
|
// If the last activity in a thread is prior to the first threaded read receipt
|
||
|
|
// sent in the room (suggesting that it was sent before the user started
|
||
|
|
// using a client that supported threaded read receipts), we want to
|
||
|
|
// consider this thread as read.
|
||
|
|
const beforeFirstThreadedReceipt = lastReply.getTs() < this.room.getOldestThreadedReceiptTs();
|
||
|
|
const lastReplyId = lastReply.getId();
|
||
|
|
// Some unsent events do not have an ID, we do not want to consider them read
|
||
|
|
if (beforeFirstThreadedReceipt && lastReplyId) {
|
||
|
|
return lastReplyId;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
const readUpToId = super.getEventReadUpTo(userId, ignoreSynthesized);
|
||
|
|
|
||
|
|
// Check whether the unthreaded read receipt for that user is more recent
|
||
|
|
// than the read receipt inside that thread.
|
||
|
|
if (lastReply) {
|
||
|
|
const unthreadedReceipt = this.room.getLastUnthreadedReceiptFor(userId);
|
||
|
|
if (!unthreadedReceipt) {
|
||
|
|
return readUpToId;
|
||
|
|
}
|
||
|
|
for (let i = this.timeline?.length - 1; i >= 0; --i) {
|
||
|
|
const ev = this.timeline[i];
|
||
|
|
// If we encounter the `readUpToId` we do not need to look further
|
||
|
|
// there is no "more recent" unthreaded read receipt
|
||
|
|
if (ev.getId() === readUpToId) return readUpToId;
|
||
|
|
|
||
|
|
// Inspecting events from most recent to oldest, we're checking
|
||
|
|
// whether an unthreaded read receipt is more recent that the current event.
|
||
|
|
// We usually prefer relying on the order of the DAG but in this scenario
|
||
|
|
// it is not possible and we have to rely on timestamp
|
||
|
|
if (ev.getTs() < unthreadedReceipt.ts) return ev.getId() ?? readUpToId;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return readUpToId;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Determine if the given user has read a particular event.
|
||
|
|
*
|
||
|
|
* It is invalid to call this method with an event that is not part of this thread.
|
||
|
|
*
|
||
|
|
* This is not a definitive check as it only checks the events that have been
|
||
|
|
* loaded client-side at the time of execution.
|
||
|
|
* @param userId - The user ID to check the read state of.
|
||
|
|
* @param eventId - The event ID to check if the user read.
|
||
|
|
* @returns True if the user has read the event, false otherwise.
|
||
|
|
*/
|
||
|
|
hasUserReadEvent(userId, eventId) {
|
||
|
|
if (userId === this.client.getUserId()) {
|
||
|
|
// Consider an event read if it's part of a thread that is before the
|
||
|
|
// first threaded receipt sent in that room. It is likely that it is
|
||
|
|
// part of a thread that was created before MSC3771 was implemented.
|
||
|
|
// Or before the last unthreaded receipt for the logged in user
|
||
|
|
const beforeFirstThreadedReceipt = (this.lastReply()?.getTs() ?? 0) < this.room.getOldestThreadedReceiptTs();
|
||
|
|
const unthreadedReceiptTs = this.room.getLastUnthreadedReceiptFor(userId)?.ts ?? 0;
|
||
|
|
const beforeLastUnthreadedReceipt = (this?.lastReply()?.getTs() ?? 0) < unthreadedReceiptTs;
|
||
|
|
if (beforeFirstThreadedReceipt || beforeLastUnthreadedReceipt) {
|
||
|
|
return true;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return this.room.hasUserReadEvent(userId, eventId);
|
||
|
|
}
|
||
|
|
setUnread(type, count) {
|
||
|
|
return this.room.setThreadUnreadNotificationCount(this.id, type, count);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the most recent unthreaded receipt for a given user
|
||
|
|
* @param userId - the MxID of the User
|
||
|
|
* @returns an unthreaded Receipt. Can be undefined if receipts have been disabled
|
||
|
|
* or a user chooses to use private read receipts (or we have simply not received
|
||
|
|
* a receipt from this user yet).
|
||
|
|
*/
|
||
|
|
getLastUnthreadedReceiptFor(userId) {
|
||
|
|
return this.room.getLastUnthreadedReceiptFor(userId);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Decide whether an event deserves to have its potential edits fetched.
|
||
|
|
*
|
||
|
|
* @returns true if this event is encrypted and is a message that is part of a
|
||
|
|
* thread - either inside it, or a root.
|
||
|
|
*/
|
||
|
|
_defineProperty(Thread, "hasServerSideSupport", FeatureSupport.None);
|
||
|
|
_defineProperty(Thread, "hasServerSideListSupport", FeatureSupport.None);
|
||
|
|
_defineProperty(Thread, "hasServerSideFwdPaginationSupport", FeatureSupport.None);
|
||
|
|
function isAnEncryptedThreadMessage(event) {
|
||
|
|
return event.isEncrypted() && (event.isRelation(THREAD_RELATION_TYPE.name) || event.isThreadRoot);
|
||
|
|
}
|
||
|
|
export const FILTER_RELATED_BY_SENDERS = new ServerControlledNamespacedValue("related_by_senders", "io.element.relation_senders");
|
||
|
|
export const FILTER_RELATED_BY_REL_TYPES = new ServerControlledNamespacedValue("related_by_rel_types", "io.element.relation_types");
|
||
|
|
export const THREAD_RELATION_TYPE = new ServerControlledNamespacedValue("m.thread", "io.element.thread");
|
||
|
|
export let ThreadFilterType = /*#__PURE__*/function (ThreadFilterType) {
|
||
|
|
ThreadFilterType[ThreadFilterType["My"] = 0] = "My";
|
||
|
|
ThreadFilterType[ThreadFilterType["All"] = 1] = "All";
|
||
|
|
return ThreadFilterType;
|
||
|
|
}({});
|
||
|
|
export function threadFilterTypeToFilter(type) {
|
||
|
|
switch (type) {
|
||
|
|
case ThreadFilterType.My:
|
||
|
|
return "participated";
|
||
|
|
default:
|
||
|
|
return "all";
|
||
|
|
}
|
||
|
|
}
|
||
|
|
//# sourceMappingURL=thread.js.map
|