@unwanted/matrix-sdk-mini 34.12.0-1

package/lib/models/read-receipt.js

@@ -0,0 +1,366 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/*
+Copyright 2022 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 { MAIN_ROOM_TIMELINE, ReceiptType } from "../@types/read_receipts.js";
+import { TypedEventEmitter } from "./typed-event-emitter.js";
+import { isSupportedReceiptType } from "../utils.js";
+import { MatrixEvent } from "./event.js";
+import { EventType } from "../@types/event.js";
+import { MapWithDefault } from "../utils.js";
+import { NotificationCountType } from "./room.js";
+import { logger } from "../logger.js";
+import { inMainTimelineForReceipt, threadIdForReceipt } from "../client.js";
+
+/**
+ * Create a synthetic receipt for the given event
+ * @param userId - The user ID if the receipt sender
+ * @param event - The event that is to be acknowledged
+ * @param receiptType - The type of receipt
+ * @param unthreaded - the receipt is unthreaded
+ * @returns a new event with the synthetic receipt in it
+ */
+export function synthesizeReceipt(userId, event, receiptType) {
+  var unthreaded = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+  return new MatrixEvent({
+    content: {
+      [event.getId()]: {
+        [receiptType]: {
+          [userId]: _objectSpread({
+            ts: event.getTs()
+          }, !unthreaded && {
+            thread_id: threadIdForReceipt(event)
+          })
+        }
+      }
+    },
+    type: EventType.Receipt,
+    room_id: event.getRoomId()
+  });
+}
+var ReceiptPairRealIndex = 0;
+var ReceiptPairSyntheticIndex = 1;
+export class ReadReceipt extends TypedEventEmitter {
+  constructor() {
+    super(...arguments);
+    // receipts should clobber based on receipt_type and user_id pairs hence
+    // the form of this structure. This is sub-optimal for the exposed APIs
+    // which pass in an event ID and get back some receipts, so we also store
+    // a pre-cached list for this purpose.
+    // Map: receipt type → user Id → receipt
+    _defineProperty(this, "receipts", new MapWithDefault(() => new Map()));
+    _defineProperty(this, "receiptCacheByEventId", new Map());
+  }
+  /**
+   * Gets the latest receipt for a given user in the room
+   * @param userId - The id of the user for which we want the receipt
+   * @param ignoreSynthesized - Whether to ignore synthesized receipts or not
+   * @param receiptType - Optional. The type of the receipt we want to get
+   * @returns the latest receipts of the chosen type for the chosen user
+   */
+  getReadReceiptForUserId(userId) {
+    var _this$receipts$get$ge, _this$receipts$get;
+    var ignoreSynthesized = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    var receiptType = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : ReceiptType.Read;
+    var [realReceipt, syntheticReceipt] = (_this$receipts$get$ge = (_this$receipts$get = this.receipts.get(receiptType)) === null || _this$receipts$get === void 0 ? void 0 : _this$receipts$get.get(userId)) !== null && _this$receipts$get$ge !== void 0 ? _this$receipts$get$ge : [null, null];
+    if (ignoreSynthesized) {
+      return realReceipt;
+    }
+    return syntheticReceipt !== null && syntheticReceipt !== void 0 ? syntheticReceipt : realReceipt;
+  }
+  compareReceipts(a, b) {
+    var _this$getUnfilteredTi;
+    // Try compare them in our unfiltered timeline set order, falling back to receipt timestamp which should be
+    // relatively sane as receipts are set only by the originating homeserver so as long as its clock doesn't
+    // jump around then it should be valid.
+    return (_this$getUnfilteredTi = this.getUnfilteredTimelineSet().compareEventOrdering(a.eventId, b.eventId)) !== null && _this$getUnfilteredTi !== void 0 ? _this$getUnfilteredTi : a.data.ts - b.data.ts;
+  }
+
+  /**
+   * Get the ID of the event that a given user has read up to, or null if:
+   * - we have received no read receipts for them, or
+   * - the receipt we have points at an event we don't have, or
+   * - the thread ID in the receipt does not match the thread root of the
+   *   referenced event.
+   *
+   * (The event might not exist if it is not loaded, and the thread ID might
+   * not match if the event has moved thread because it was redacted.)
+   *
+   * @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 existing event that the given user has read, or null.
+   */
+  getEventReadUpTo(userId) {
+    var ignoreSynthesized = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+    // Find what the latest receipt says is the latest event we have read
+    var latestReceipt = this.getLatestReceipt(userId, ignoreSynthesized);
+    if (!latestReceipt) {
+      return null;
+    }
+    return this.receiptPointsAtConsistentEvent(latestReceipt) ? latestReceipt.eventId : null;
+  }
+
+  /**
+   * Returns true if the event pointed at by this receipt exists, and its
+   * threadRootId is consistent with the thread information in the receipt.
+   */
+  receiptPointsAtConsistentEvent(receipt) {
+    var _receipt$data;
+    var event = this.findEventById(receipt.eventId);
+    if (!event) {
+      // If the receipt points at a non-existent event, we have multiple
+      // possibilities:
+      //
+      // 1. We don't have the event because it's not loaded yet - probably
+      //    it's old and we're best off ignoring the receipt - we can just
+      //    send a new one when we read a new event.
+      //
+      // 2. We have a bug e.g. we misclassified this event into the wrong
+      //    thread.
+      //
+      // 3. The referenced event moved out of this thread (e.g. because it
+      //    was deleted.)
+      //
+      // 4. The receipt had the incorrect thread ID (due to a bug in a
+      // client, or malicious behaviour).
+
+      // This receipt is not "valid" because it doesn't point at an event
+      // we have. We want to pretend it doesn't exist.
+      return false;
+    }
+    if (!((_receipt$data = receipt.data) !== null && _receipt$data !== void 0 && _receipt$data.thread_id)) {
+      // If this is an unthreaded receipt, it could point at any event, so
+      // there is no need to validate further - this receipt is valid.
+      return true;
+    }
+    // Otherwise it is a threaded receipt...
+
+    if (receipt.data.thread_id === MAIN_ROOM_TIMELINE) {
+      // The receipt is for the main timeline: we check that the event is
+      // in the main timeline.
+
+      // Check if the event is in the main timeline
+      var eventIsInMainTimeline = inMainTimelineForReceipt(event);
+      if (eventIsInMainTimeline) {
+        // The receipt is for the main timeline, and so is the event, so
+        // the receipt is valid.
+        return true;
+      }
+    } else {
+      // The receipt is for a different thread (not the main timeline)
+
+      if (event.threadRootId === receipt.data.thread_id) {
+        // If the receipt and event agree on the thread ID, the receipt
+        // is valid.
+        return true;
+      }
+    }
+
+    // The receipt thread ID disagrees with the event thread ID. There are 2
+    // possibilities:
+    //
+    // 1. The event moved to a different thread after the receipt was
+    //    created. This can happen if the event was redacted because that
+    //    moves it to the main timeline.
+    //
+    // 2. There is a bug somewhere - either we put the event into the wrong
+    //    thread, or someone sent an incorrect receipt.
+    //
+    // In many cases, we won't get here because the call to findEventById
+    // would have already returned null. We include this check to cover
+    // cases when `this` is a  room, meaning findEventById will find events
+    // in any thread, and to be defensive against unforeseen code paths.
+    logger.warn("Ignoring receipt because its thread_id (".concat(receipt.data.thread_id, ") disagrees ") + "with the thread root (".concat(event.threadRootId, ") of the referenced event ") + "(event ID = ".concat(receipt.eventId, ")"));
+
+    // This receipt is not "valid" because it disagrees with us about what
+    // thread the event is in. We want to pretend it doesn't exist.
+    return false;
+  }
+  getLatestReceipt(userId, ignoreSynthesized) {
+    var _ref, _ref2;
+    // XXX: This is very very ugly and I hope I won't have to ever add a new
+    // receipt type here again. IMHO this should be done by the server in
+    // some more intelligent manner or the client should just use timestamps
+
+    var publicReadReceipt = this.getReadReceiptForUserId(userId, ignoreSynthesized, ReceiptType.Read);
+    var privateReadReceipt = this.getReadReceiptForUserId(userId, ignoreSynthesized, ReceiptType.ReadPrivate);
+
+    // If we have both, compare them
+    var comparison;
+    if (publicReadReceipt !== null && publicReadReceipt !== void 0 && publicReadReceipt.eventId && privateReadReceipt !== null && privateReadReceipt !== void 0 && privateReadReceipt.eventId) {
+      comparison = this.compareReceipts(publicReadReceipt, privateReadReceipt);
+    }
+
+    // The public receipt is more likely to drift out of date so the private
+    // one has precedence
+    if (!comparison) return (_ref = privateReadReceipt !== null && privateReadReceipt !== void 0 ? privateReadReceipt : publicReadReceipt) !== null && _ref !== void 0 ? _ref : null;
+
+    // If public read receipt is older, return the private one
+    return (_ref2 = comparison < 0 ? privateReadReceipt : publicReadReceipt) !== null && _ref2 !== void 0 ? _ref2 : null;
+  }
+  addReceiptToStructure(eventId, receiptType, userId, receipt, synthetic) {
+    var _pair$ReceiptPairSynt2, _pair$ReceiptPairSynt3;
+    var receiptTypesMap = this.receipts.getOrCreate(receiptType);
+    var pair = receiptTypesMap.get(userId);
+    if (!pair) {
+      pair = [null, null];
+      receiptTypesMap.set(userId, pair);
+    }
+    var existingReceipt = pair[ReceiptPairRealIndex];
+    if (synthetic) {
+      var _pair$ReceiptPairSynt;
+      existingReceipt = (_pair$ReceiptPairSynt = pair[ReceiptPairSyntheticIndex]) !== null && _pair$ReceiptPairSynt !== void 0 ? _pair$ReceiptPairSynt : pair[ReceiptPairRealIndex];
+    }
+    var wrappedReceipt = {
+      eventId,
+      data: receipt
+    };
+    if (existingReceipt) {
+      // We only want to add this receipt if we think it is later than the one we already have.
+      // This is managed server-side, but because we synthesize RRs locally we have to do it here too.
+      var _ordering = this.compareReceipts(existingReceipt, wrappedReceipt);
+      if (_ordering >= 0) {
+        return;
+      }
+    }
+    var realReceipt = synthetic ? pair[ReceiptPairRealIndex] : wrappedReceipt;
+    var syntheticReceipt = synthetic ? wrappedReceipt : pair[ReceiptPairSyntheticIndex];
+    var ordering = null;
+    if (realReceipt && syntheticReceipt) {
+      ordering = this.getUnfilteredTimelineSet().compareEventOrdering(realReceipt.eventId, syntheticReceipt.eventId);
+    }
+    var preferSynthetic = ordering === null || ordering < 0;
+
+    // we don't bother caching just real receipts by event ID as there's nothing that would read it.
+    // Take the current cached receipt before we overwrite the pair elements.
+    var cachedReceipt = (_pair$ReceiptPairSynt2 = pair[ReceiptPairSyntheticIndex]) !== null && _pair$ReceiptPairSynt2 !== void 0 ? _pair$ReceiptPairSynt2 : pair[ReceiptPairRealIndex];
+    if (synthetic && preferSynthetic) {
+      pair[ReceiptPairSyntheticIndex] = wrappedReceipt;
+    } else if (!synthetic) {
+      pair[ReceiptPairRealIndex] = wrappedReceipt;
+      if (!preferSynthetic) {
+        pair[ReceiptPairSyntheticIndex] = null;
+      }
+    }
+    var newCachedReceipt = (_pair$ReceiptPairSynt3 = pair[ReceiptPairSyntheticIndex]) !== null && _pair$ReceiptPairSynt3 !== void 0 ? _pair$ReceiptPairSynt3 : pair[ReceiptPairRealIndex];
+    if (cachedReceipt === newCachedReceipt) return;
+
+    // clean up any previous cache entry
+    if (cachedReceipt && this.receiptCacheByEventId.get(cachedReceipt.eventId)) {
+      var previousEventId = cachedReceipt.eventId;
+      // Remove the receipt we're about to clobber out of existence from the cache
+      this.receiptCacheByEventId.set(previousEventId, this.receiptCacheByEventId.get(previousEventId).filter(r => {
+        return r.type !== receiptType || r.userId !== userId;
+      }));
+      if (this.receiptCacheByEventId.get(previousEventId).length < 1) {
+        this.receiptCacheByEventId.delete(previousEventId); // clean up the cache keys
+      }
+    }
+
+    // cache the new one
+    if (!this.receiptCacheByEventId.get(eventId)) {
+      this.receiptCacheByEventId.set(eventId, []);
+    }
+    this.receiptCacheByEventId.get(eventId).push({
+      userId: userId,
+      type: receiptType,
+      data: receipt
+    });
+  }
+
+  /**
+   * Get a list of receipts for the given event.
+   * @param event - the event to get receipts for
+   * @returns A list of receipts with a userId, type and data keys or
+   * an empty list.
+   */
+  getReceiptsForEvent(event) {
+    return this.receiptCacheByEventId.get(event.getId()) || [];
+  }
+
+  /**
+   * Look in this room/thread's timeline to find an event. If `this` is a
+   * room, we look in all threads, but if `this` is a thread, we look only
+   * inside this thread.
+   */
+
+  /**
+   * This issue should also be addressed on synapse's side and is tracked as part
+   * of https://github.com/matrix-org/synapse/issues/14837
+   *
+   * Retrieves the read receipt for the logged in user and checks if it matches
+   * the last event in the room and whether that event originated from the logged
+   * in user.
+   * Under those conditions we can consider the context as read. This is useful
+   * because we never send read receipts against our own events
+   * @param userId - the logged in user
+   */
+  fixupNotifications(userId) {
+    var receipt = this.getReadReceiptForUserId(userId, false);
+    var lastEvent = this.timeline[this.timeline.length - 1];
+    if (lastEvent && (receipt === null || receipt === void 0 ? void 0 : receipt.eventId) === lastEvent.getId() && userId === lastEvent.getSender()) {
+      this.setUnread(NotificationCountType.Total, 0);
+      this.setUnread(NotificationCountType.Highlight, 0);
+    }
+  }
+
+  /**
+   * Add a temporary local-echo receipt to the room to reflect in the
+   * client the fact that we've sent one.
+   * @param userId - The user ID if the receipt sender
+   * @param e - The event that is to be acknowledged
+   * @param receiptType - The type of receipt
+   * @param unthreaded - the receipt is unthreaded
+   */
+  addLocalEchoReceipt(userId, e, receiptType) {
+    var unthreaded = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+    this.addReceipt(synthesizeReceipt(userId, e, receiptType, unthreaded), true);
+  }
+
+  /**
+   * Get a list of user IDs who have <b>read up to</b> the given event.
+   * @param event - the event to get read receipts for.
+   * @returns A list of user IDs.
+   */
+  getUsersReadUpTo(event) {
+    return this.getReceiptsForEvent(event).filter(function (receipt) {
+      return isSupportedReceiptType(receipt.type);
+    }).map(function (receipt) {
+      return receipt.userId;
+    });
+  }
+
+  /**
+   * Determines if the given user has read a particular event ID with the known
+   * history of the room. This is not a definitive check as it relies only on
+   * what is available to the room 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.
+   */
+
+  /**
+   * 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).
+   *
+   * @deprecated use `hasUserReadEvent` or `getEventReadUpTo` instead
+   */
+}
+//# sourceMappingURL=read-receipt.js.map

package/lib/models/read-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-receipt.js","names":["MAIN_ROOM_TIMELINE","ReceiptType","TypedEventEmitter","isSupportedReceiptType","MatrixEvent","EventType","MapWithDefault","NotificationCountType","logger","inMainTimelineForReceipt","threadIdForReceipt","synthesizeReceipt","userId","event","receiptType","unthreaded","arguments","length","undefined","content","getId","_objectSpread","ts","getTs","thread_id","type","Receipt","room_id","getRoomId","ReceiptPairRealIndex","ReceiptPairSyntheticIndex","ReadReceipt","constructor","_defineProperty","Map","getReadReceiptForUserId","_this$receipts$get$ge","_this$receipts$get","ignoreSynthesized","Read","realReceipt","syntheticReceipt","receipts","get","compareReceipts","a","b","_this$getUnfilteredTi","getUnfilteredTimelineSet","compareEventOrdering","eventId","data","getEventReadUpTo","latestReceipt","getLatestReceipt","receiptPointsAtConsistentEvent","receipt","_receipt$data","findEventById","eventIsInMainTimeline","threadRootId","warn","concat","_ref","_ref2","publicReadReceipt","privateReadReceipt","ReadPrivate","comparison","addReceiptToStructure","synthetic","_pair$ReceiptPairSynt2","_pair$ReceiptPairSynt3","receiptTypesMap","getOrCreate","pair","set","existingReceipt","_pair$ReceiptPairSynt","wrappedReceipt","ordering","preferSynthetic","cachedReceipt","newCachedReceipt","receiptCacheByEventId","previousEventId","filter","r","delete","push","getReceiptsForEvent","fixupNotifications","lastEvent","timeline","getSender","setUnread","Total","Highlight","addLocalEchoReceipt","e","addReceipt","getUsersReadUpTo","map"],"sources":["../../src/models/read-receipt.ts"],"sourcesContent":["/*\nCopyright 2022 The Matrix.org Foundation C.I.C.\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n    http://www.apache.org/licenses/LICENSE-2.0\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\nimport {\n    CachedReceipt,\n    MAIN_ROOM_TIMELINE,\n    Receipt,\n    ReceiptCache,\n    ReceiptType,\n    WrappedReceipt,\n} from \"../@types/read_receipts.ts\";\nimport { ListenerMap, TypedEventEmitter } from \"./typed-event-emitter.ts\";\nimport { isSupportedReceiptType } from \"../utils.ts\";\nimport { MatrixEvent } from \"./event.ts\";\nimport { EventType } from \"../@types/event.ts\";\nimport { EventTimelineSet } from \"./event-timeline-set.ts\";\nimport { MapWithDefault } from \"../utils.ts\";\nimport { NotificationCountType } from \"./room.ts\";\nimport { logger } from \"../logger.ts\";\nimport { inMainTimelineForReceipt, threadIdForReceipt } from \"../client.ts\";\n\n/**\n * Create a synthetic receipt for the given event\n * @param userId - The user ID if the receipt sender\n * @param event - The event that is to be acknowledged\n * @param receiptType - The type of receipt\n * @param unthreaded - the receipt is unthreaded\n * @returns a new event with the synthetic receipt in it\n */\nexport function synthesizeReceipt(\n    userId: string,\n    event: MatrixEvent,\n    receiptType: ReceiptType,\n    unthreaded = false,\n): MatrixEvent {\n    return new MatrixEvent({\n        content: {\n            [event.getId()!]: {\n                [receiptType]: {\n                    [userId]: {\n                        ts: event.getTs(),\n                        ...(!unthreaded && { thread_id: threadIdForReceipt(event) }),\n                    },\n                },\n            },\n        },\n        type: EventType.Receipt,\n        room_id: event.getRoomId(),\n    });\n}\n\nconst ReceiptPairRealIndex = 0;\nconst ReceiptPairSyntheticIndex = 1;\n\nexport abstract class ReadReceipt<\n    Events extends string,\n    Arguments extends ListenerMap<Events>,\n    SuperclassArguments extends ListenerMap<any> = Arguments,\n> extends TypedEventEmitter<Events, Arguments, SuperclassArguments> {\n    // receipts should clobber based on receipt_type and user_id pairs hence\n    // the form of this structure. This is sub-optimal for the exposed APIs\n    // which pass in an event ID and get back some receipts, so we also store\n    // a pre-cached list for this purpose.\n    // Map: receipt type → user Id → receipt\n    private receipts = new MapWithDefault<\n        string,\n        Map<string, [realReceipt: WrappedReceipt | null, syntheticReceipt: WrappedReceipt | null]>\n    >(() => new Map());\n    private receiptCacheByEventId: ReceiptCache = new Map();\n\n    public abstract getUnfilteredTimelineSet(): EventTimelineSet;\n    public abstract get timeline(): MatrixEvent[];\n\n    /**\n     * Gets the latest receipt for a given user in the room\n     * @param userId - The id of the user for which we want the receipt\n     * @param ignoreSynthesized - Whether to ignore synthesized receipts or not\n     * @param receiptType - Optional. The type of the receipt we want to get\n     * @returns the latest receipts of the chosen type for the chosen user\n     */\n    public getReadReceiptForUserId(\n        userId: string,\n        ignoreSynthesized = false,\n        receiptType = ReceiptType.Read,\n    ): WrappedReceipt | null {\n        const [realReceipt, syntheticReceipt] = this.receipts.get(receiptType)?.get(userId) ?? [null, null];\n        if (ignoreSynthesized) {\n            return realReceipt;\n        }\n\n        return syntheticReceipt ?? realReceipt;\n    }\n\n    private compareReceipts(a: WrappedReceipt, b: WrappedReceipt): number {\n        // Try compare them in our unfiltered timeline set order, falling back to receipt timestamp which should be\n        // relatively sane as receipts are set only by the originating homeserver so as long as its clock doesn't\n        // jump around then it should be valid.\n        return this.getUnfilteredTimelineSet().compareEventOrdering(a.eventId, b.eventId) ?? a.data.ts - b.data.ts;\n    }\n\n    /**\n     * Get the ID of the event that a given user has read up to, or null if:\n     * - we have received no read receipts for them, or\n     * - the receipt we have points at an event we don't have, or\n     * - the thread ID in the receipt does not match the thread root of the\n     *   referenced event.\n     *\n     * (The event might not exist if it is not loaded, and the thread ID might\n     * not match if the event has moved thread because it was redacted.)\n     *\n     * @param userId - The user ID to get read receipt event ID for\n     * @param ignoreSynthesized - If true, return only receipts that have been\n     *                            sent by the server, not implicit ones generated\n     *                            by the JS SDK.\n     * @returns ID of the latest existing event that the given user has read, or null.\n     */\n    public getEventReadUpTo(userId: string, ignoreSynthesized = false): string | null {\n        // Find what the latest receipt says is the latest event we have read\n        const latestReceipt = this.getLatestReceipt(userId, ignoreSynthesized);\n\n        if (!latestReceipt) {\n            return null;\n        }\n\n        return this.receiptPointsAtConsistentEvent(latestReceipt) ? latestReceipt.eventId : null;\n    }\n\n    /**\n     * Returns true if the event pointed at by this receipt exists, and its\n     * threadRootId is consistent with the thread information in the receipt.\n     */\n    private receiptPointsAtConsistentEvent(receipt: WrappedReceipt): boolean {\n        const event = this.findEventById(receipt.eventId);\n        if (!event) {\n            // If the receipt points at a non-existent event, we have multiple\n            // possibilities:\n            //\n            // 1. We don't have the event because it's not loaded yet - probably\n            //    it's old and we're best off ignoring the receipt - we can just\n            //    send a new one when we read a new event.\n            //\n            // 2. We have a bug e.g. we misclassified this event into the wrong\n            //    thread.\n            //\n            // 3. The referenced event moved out of this thread (e.g. because it\n            //    was deleted.)\n            //\n            // 4. The receipt had the incorrect thread ID (due to a bug in a\n            // client, or malicious behaviour).\n\n            // This receipt is not \"valid\" because it doesn't point at an event\n            // we have. We want to pretend it doesn't exist.\n            return false;\n        }\n\n        if (!receipt.data?.thread_id) {\n            // If this is an unthreaded receipt, it could point at any event, so\n            // there is no need to validate further - this receipt is valid.\n            return true;\n        }\n        // Otherwise it is a threaded receipt...\n\n        if (receipt.data.thread_id === MAIN_ROOM_TIMELINE) {\n            // The receipt is for the main timeline: we check that the event is\n            // in the main timeline.\n\n            // Check if the event is in the main timeline\n            const eventIsInMainTimeline = inMainTimelineForReceipt(event);\n\n            if (eventIsInMainTimeline) {\n                // The receipt is for the main timeline, and so is the event, so\n                // the receipt is valid.\n                return true;\n            }\n        } else {\n            // The receipt is for a different thread (not the main timeline)\n\n            if (event.threadRootId === receipt.data.thread_id) {\n                // If the receipt and event agree on the thread ID, the receipt\n                // is valid.\n                return true;\n            }\n        }\n\n        // The receipt thread ID disagrees with the event thread ID. There are 2\n        // possibilities:\n        //\n        // 1. The event moved to a different thread after the receipt was\n        //    created. This can happen if the event was redacted because that\n        //    moves it to the main timeline.\n        //\n        // 2. There is a bug somewhere - either we put the event into the wrong\n        //    thread, or someone sent an incorrect receipt.\n        //\n        // In many cases, we won't get here because the call to findEventById\n        // would have already returned null. We include this check to cover\n        // cases when `this` is a  room, meaning findEventById will find events\n        // in any thread, and to be defensive against unforeseen code paths.\n        logger.warn(\n            `Ignoring receipt because its thread_id (${receipt.data.thread_id}) disagrees ` +\n                `with the thread root (${event.threadRootId}) of the referenced event ` +\n                `(event ID = ${receipt.eventId})`,\n        );\n\n        // This receipt is not \"valid\" because it disagrees with us about what\n        // thread the event is in. We want to pretend it doesn't exist.\n        return false;\n    }\n\n    private getLatestReceipt(userId: string, ignoreSynthesized: boolean): WrappedReceipt | null {\n        // XXX: This is very very ugly and I hope I won't have to ever add a new\n        // receipt type here again. IMHO this should be done by the server in\n        // some more intelligent manner or the client should just use timestamps\n\n        const publicReadReceipt = this.getReadReceiptForUserId(userId, ignoreSynthesized, ReceiptType.Read);\n        const privateReadReceipt = this.getReadReceiptForUserId(userId, ignoreSynthesized, ReceiptType.ReadPrivate);\n\n        // If we have both, compare them\n        let comparison: number | null | undefined;\n        if (publicReadReceipt?.eventId && privateReadReceipt?.eventId) {\n            comparison = this.compareReceipts(publicReadReceipt, privateReadReceipt);\n        }\n\n        // The public receipt is more likely to drift out of date so the private\n        // one has precedence\n        if (!comparison) return privateReadReceipt ?? publicReadReceipt ?? null;\n\n        // If public read receipt is older, return the private one\n        return (comparison < 0 ? privateReadReceipt : publicReadReceipt) ?? null;\n    }\n\n    public addReceiptToStructure(\n        eventId: string,\n        receiptType: ReceiptType,\n        userId: string,\n        receipt: Receipt,\n        synthetic: boolean,\n    ): void {\n        const receiptTypesMap = this.receipts.getOrCreate(receiptType);\n        let pair = receiptTypesMap.get(userId);\n\n        if (!pair) {\n            pair = [null, null];\n            receiptTypesMap.set(userId, pair);\n        }\n\n        let existingReceipt = pair[ReceiptPairRealIndex];\n        if (synthetic) {\n            existingReceipt = pair[ReceiptPairSyntheticIndex] ?? pair[ReceiptPairRealIndex];\n        }\n\n        const wrappedReceipt: WrappedReceipt = {\n            eventId,\n            data: receipt,\n        };\n\n        if (existingReceipt) {\n            // We only want to add this receipt if we think it is later than the one we already have.\n            // This is managed server-side, but because we synthesize RRs locally we have to do it here too.\n            const ordering = this.compareReceipts(existingReceipt, wrappedReceipt);\n            if (ordering >= 0) {\n                return;\n            }\n        }\n\n        const realReceipt = synthetic ? pair[ReceiptPairRealIndex] : wrappedReceipt;\n        const syntheticReceipt = synthetic ? wrappedReceipt : pair[ReceiptPairSyntheticIndex];\n\n        let ordering: number | null = null;\n        if (realReceipt && syntheticReceipt) {\n            ordering = this.getUnfilteredTimelineSet().compareEventOrdering(\n                realReceipt.eventId,\n                syntheticReceipt.eventId,\n            );\n        }\n\n        const preferSynthetic = ordering === null || ordering < 0;\n\n        // we don't bother caching just real receipts by event ID as there's nothing that would read it.\n        // Take the current cached receipt before we overwrite the pair elements.\n        const cachedReceipt = pair[ReceiptPairSyntheticIndex] ?? pair[ReceiptPairRealIndex];\n\n        if (synthetic && preferSynthetic) {\n            pair[ReceiptPairSyntheticIndex] = wrappedReceipt;\n        } else if (!synthetic) {\n            pair[ReceiptPairRealIndex] = wrappedReceipt;\n\n            if (!preferSynthetic) {\n                pair[ReceiptPairSyntheticIndex] = null;\n            }\n        }\n\n        const newCachedReceipt = pair[ReceiptPairSyntheticIndex] ?? pair[ReceiptPairRealIndex];\n        if (cachedReceipt === newCachedReceipt) return;\n\n        // clean up any previous cache entry\n        if (cachedReceipt && this.receiptCacheByEventId.get(cachedReceipt.eventId)) {\n            const previousEventId = cachedReceipt.eventId;\n            // Remove the receipt we're about to clobber out of existence from the cache\n            this.receiptCacheByEventId.set(\n                previousEventId,\n                this.receiptCacheByEventId.get(previousEventId)!.filter((r) => {\n                    return r.type !== receiptType || r.userId !== userId;\n                }),\n            );\n\n            if (this.receiptCacheByEventId.get(previousEventId)!.length < 1) {\n                this.receiptCacheByEventId.delete(previousEventId); // clean up the cache keys\n            }\n        }\n\n        // cache the new one\n        if (!this.receiptCacheByEventId.get(eventId)) {\n            this.receiptCacheByEventId.set(eventId, []);\n        }\n        this.receiptCacheByEventId.get(eventId)!.push({\n            userId: userId,\n            type: receiptType as ReceiptType,\n            data: receipt,\n        });\n    }\n\n    /**\n     * Get a list of receipts for the given event.\n     * @param event - the event to get receipts for\n     * @returns A list of receipts with a userId, type and data keys or\n     * an empty list.\n     */\n    public getReceiptsForEvent(event: MatrixEvent): CachedReceipt[] {\n        return this.receiptCacheByEventId.get(event.getId()!) || [];\n    }\n\n    public abstract addReceipt(event: MatrixEvent, synthetic: boolean): void;\n\n    public abstract setUnread(type: NotificationCountType, count: number): void;\n\n    /**\n     * Look in this room/thread's timeline to find an event. If `this` is a\n     * room, we look in all threads, but if `this` is a thread, we look only\n     * inside this thread.\n     */\n    public abstract findEventById(eventId: string): MatrixEvent | undefined;\n\n    /**\n     * This issue should also be addressed on synapse's side and is tracked as part\n     * of https://github.com/matrix-org/synapse/issues/14837\n     *\n     * Retrieves the read receipt for the logged in user and checks if it matches\n     * the last event in the room and whether that event originated from the logged\n     * in user.\n     * Under those conditions we can consider the context as read. This is useful\n     * because we never send read receipts against our own events\n     * @param userId - the logged in user\n     */\n    public fixupNotifications(userId: string): void {\n        const receipt = this.getReadReceiptForUserId(userId, false);\n\n        const lastEvent = this.timeline[this.timeline.length - 1];\n        if (lastEvent && receipt?.eventId === lastEvent.getId() && userId === lastEvent.getSender()) {\n            this.setUnread(NotificationCountType.Total, 0);\n            this.setUnread(NotificationCountType.Highlight, 0);\n        }\n    }\n\n    /**\n     * Add a temporary local-echo receipt to the room to reflect in the\n     * client the fact that we've sent one.\n     * @param userId - The user ID if the receipt sender\n     * @param e - The event that is to be acknowledged\n     * @param receiptType - The type of receipt\n     * @param unthreaded - the receipt is unthreaded\n     */\n    public addLocalEchoReceipt(userId: string, e: MatrixEvent, receiptType: ReceiptType, unthreaded = false): void {\n        this.addReceipt(synthesizeReceipt(userId, e, receiptType, unthreaded), true);\n    }\n\n    /**\n     * Get a list of user IDs who have <b>read up to</b> the given event.\n     * @param event - the event to get read receipts for.\n     * @returns A list of user IDs.\n     */\n    public getUsersReadUpTo(event: MatrixEvent): string[] {\n        return this.getReceiptsForEvent(event)\n            .filter(function (receipt) {\n                return isSupportedReceiptType(receipt.type);\n            })\n            .map(function (receipt) {\n                return receipt.userId;\n            });\n    }\n\n    /**\n     * Determines if the given user has read a particular event ID with the known\n     * history of the room. This is not a definitive check as it relies only on\n     * what is available to the room at the time of execution.\n     * @param userId - The user ID to check the read state of.\n     * @param eventId - The event ID to check if the user read.\n     * @returns True if the user has read the event, false otherwise.\n     */\n    public abstract hasUserReadEvent(userId: string, eventId: string): boolean;\n\n    /**\n     * Returns the most recent unthreaded receipt for a given user\n     * @param userId - the MxID of the User\n     * @returns an unthreaded Receipt. Can be undefined if receipts have been disabled\n     * or a user chooses to use private read receipts (or we have simply not received\n     * a receipt from this user yet).\n     *\n     * @deprecated use `hasUserReadEvent` or `getEventReadUpTo` instead\n     */\n    public abstract getLastUnthreadedReceiptFor(userId: string): Receipt | undefined;\n}\n"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAEIA,kBAAkB,EAGlBC,WAAW,QAER,4BAA4B;AACnC,SAAsBC,iBAAiB,QAAQ,0BAA0B;AACzE,SAASC,sBAAsB,QAAQ,aAAa;AACpD,SAASC,WAAW,QAAQ,YAAY;AACxC,SAASC,SAAS,QAAQ,oBAAoB;AAE9C,SAASC,cAAc,QAAQ,aAAa;AAC5C,SAASC,qBAAqB,QAAQ,WAAW;AACjD,SAASC,MAAM,QAAQ,cAAc;AACrC,SAASC,wBAAwB,EAAEC,kBAAkB,QAAQ,cAAc;;AAE3E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAC7BC,MAAc,EACdC,KAAkB,EAClBC,WAAwB,EAEb;EAAA,IADXC,UAAU,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,KAAK;EAElB,OAAO,IAAIZ,WAAW,CAAC;IACnBe,OAAO,EAAE;MACL,CAACN,KAAK,CAACO,KAAK,CAAC,CAAC,GAAI;QACd,CAACN,WAAW,GAAG;UACX,CAACF,MAAM,GAAAS,aAAA;YACHC,EAAE,EAAET,KAAK,CAACU,KAAK,CAAC;UAAC,GACb,CAACR,UAAU,IAAI;YAAES,SAAS,EAAEd,kBAAkB,CAACG,KAAK;UAAE,CAAC;QAEnE;MACJ;IACJ,CAAC;IACDY,IAAI,EAAEpB,SAAS,CAACqB,OAAO;IACvBC,OAAO,EAAEd,KAAK,CAACe,SAAS,CAAC;EAC7B,CAAC,CAAC;AACN;AAEA,IAAMC,oBAAoB,GAAG,CAAC;AAC9B,IAAMC,yBAAyB,GAAG,CAAC;AAEnC,OAAO,MAAeC,WAAW,SAIvB7B,iBAAiB,CAAyC;EAAA8B,YAAA;IAAA,SAAAhB,SAAA;IAChE;IACA;IACA;IACA;IACA;IAAAiB,eAAA,mBACmB,IAAI3B,cAAc,CAGnC,MAAM,IAAI4B,GAAG,CAAC,CAAC,CAAC;IAAAD,eAAA,gCAC4B,IAAIC,GAAG,CAAC,CAAC;EAAA;EAKvD;AACJ;AACA;AACA;AACA;AACA;AACA;EACWC,uBAAuBA,CAC1BvB,MAAc,EAGO;IAAA,IAAAwB,qBAAA,EAAAC,kBAAA;IAAA,IAFrBC,iBAAiB,GAAAtB,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,KAAK;IAAA,IACzBF,WAAW,GAAAE,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAGf,WAAW,CAACsC,IAAI;IAE9B,IAAM,CAACC,WAAW,EAAEC,gBAAgB,CAAC,IAAAL,qBAAA,IAAAC,kBAAA,GAAG,IAAI,CAACK,QAAQ,CAACC,GAAG,CAAC7B,WAAW,CAAC,cAAAuB,kBAAA,uBAA9BA,kBAAA,CAAgCM,GAAG,CAAC/B,MAAM,CAAC,cAAAwB,qBAAA,cAAAA,qBAAA,GAAI,CAAC,IAAI,EAAE,IAAI,CAAC;IACnG,IAAIE,iBAAiB,EAAE;MACnB,OAAOE,WAAW;IACtB;IAEA,OAAOC,gBAAgB,aAAhBA,gBAAgB,cAAhBA,gBAAgB,GAAID,WAAW;EAC1C;EAEQI,eAAeA,CAACC,CAAiB,EAAEC,CAAiB,EAAU;IAAA,IAAAC,qBAAA;IAClE;IACA;IACA;IACA,QAAAA,qBAAA,GAAO,IAAI,CAACC,wBAAwB,CAAC,CAAC,CAACC,oBAAoB,CAACJ,CAAC,CAACK,OAAO,EAAEJ,CAAC,CAACI,OAAO,CAAC,cAAAH,qBAAA,cAAAA,qBAAA,GAAIF,CAAC,CAACM,IAAI,CAAC7B,EAAE,GAAGwB,CAAC,CAACK,IAAI,CAAC7B,EAAE;EAC9G;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACW8B,gBAAgBA,CAACxC,MAAc,EAA4C;IAAA,IAA1C0B,iBAAiB,GAAAtB,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,KAAK;IAC7D;IACA,IAAMqC,aAAa,GAAG,IAAI,CAACC,gBAAgB,CAAC1C,MAAM,EAAE0B,iBAAiB,CAAC;IAEtE,IAAI,CAACe,aAAa,EAAE;MAChB,OAAO,IAAI;IACf;IAEA,OAAO,IAAI,CAACE,8BAA8B,CAACF,aAAa,CAAC,GAAGA,aAAa,CAACH,OAAO,GAAG,IAAI;EAC5F;;EAEA;AACJ;AACA;AACA;EACYK,8BAA8BA,CAACC,OAAuB,EAAW;IAAA,IAAAC,aAAA;IACrE,IAAM5C,KAAK,GAAG,IAAI,CAAC6C,aAAa,CAACF,OAAO,CAACN,OAAO,CAAC;IACjD,IAAI,CAACrC,KAAK,EAAE;MACR;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;MACA;;MAEA;MACA;MACA,OAAO,KAAK;IAChB;IAEA,IAAI,GAAA4C,aAAA,GAACD,OAAO,CAACL,IAAI,cAAAM,aAAA,eAAZA,aAAA,CAAcjC,SAAS,GAAE;MAC1B;MACA;MACA,OAAO,IAAI;IACf;IACA;;IAEA,IAAIgC,OAAO,CAACL,IAAI,CAAC3B,SAAS,KAAKxB,kBAAkB,EAAE;MAC/C;MACA;;MAEA;MACA,IAAM2D,qBAAqB,GAAGlD,wBAAwB,CAACI,KAAK,CAAC;MAE7D,IAAI8C,qBAAqB,EAAE;QACvB;QACA;QACA,OAAO,IAAI;MACf;IACJ,CAAC,MAAM;MACH;;MAEA,IAAI9C,KAAK,CAAC+C,YAAY,KAAKJ,OAAO,CAACL,IAAI,CAAC3B,SAAS,EAAE;QAC/C;QACA;QACA,OAAO,IAAI;MACf;IACJ;;IAEA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACAhB,MAAM,CAACqD,IAAI,CACP,2CAAAC,MAAA,CAA2CN,OAAO,CAACL,IAAI,CAAC3B,SAAS,6CAAAsC,MAAA,CACpCjD,KAAK,CAAC+C,YAAY,+BAA4B,kBAAAE,MAAA,CACxDN,OAAO,CAACN,OAAO,MACtC,CAAC;;IAED;IACA;IACA,OAAO,KAAK;EAChB;EAEQI,gBAAgBA,CAAC1C,MAAc,EAAE0B,iBAA0B,EAAyB;IAAA,IAAAyB,IAAA,EAAAC,KAAA;IACxF;IACA;IACA;;IAEA,IAAMC,iBAAiB,GAAG,IAAI,CAAC9B,uBAAuB,CAACvB,MAAM,EAAE0B,iBAAiB,EAAErC,WAAW,CAACsC,IAAI,CAAC;IACnG,IAAM2B,kBAAkB,GAAG,IAAI,CAAC/B,uBAAuB,CAACvB,MAAM,EAAE0B,iBAAiB,EAAErC,WAAW,CAACkE,WAAW,CAAC;;IAE3G;IACA,IAAIC,UAAqC;IACzC,IAAIH,iBAAiB,aAAjBA,iBAAiB,eAAjBA,iBAAiB,CAAEf,OAAO,IAAIgB,kBAAkB,aAAlBA,kBAAkB,eAAlBA,kBAAkB,CAAEhB,OAAO,EAAE;MAC3DkB,UAAU,GAAG,IAAI,CAACxB,eAAe,CAACqB,iBAAiB,EAAEC,kBAAkB,CAAC;IAC5E;;IAEA;IACA;IACA,IAAI,CAACE,UAAU,EAAE,QAAAL,IAAA,GAAOG,kBAAkB,aAAlBA,kBAAkB,cAAlBA,kBAAkB,GAAID,iBAAiB,cAAAF,IAAA,cAAAA,IAAA,GAAI,IAAI;;IAEvE;IACA,QAAAC,KAAA,GAAQI,UAAU,GAAG,CAAC,GAAGF,kBAAkB,GAAGD,iBAAiB,cAAAD,KAAA,cAAAA,KAAA,GAAK,IAAI;EAC5E;EAEOK,qBAAqBA,CACxBnB,OAAe,EACfpC,WAAwB,EACxBF,MAAc,EACd4C,OAAgB,EAChBc,SAAkB,EACd;IAAA,IAAAC,sBAAA,EAAAC,sBAAA;IACJ,IAAMC,eAAe,GAAG,IAAI,CAAC/B,QAAQ,CAACgC,WAAW,CAAC5D,WAAW,CAAC;IAC9D,IAAI6D,IAAI,GAAGF,eAAe,CAAC9B,GAAG,CAAC/B,MAAM,CAAC;IAEtC,IAAI,CAAC+D,IAAI,EAAE;MACPA,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;MACnBF,eAAe,CAACG,GAAG,CAAChE,MAAM,EAAE+D,IAAI,CAAC;IACrC;IAEA,IAAIE,eAAe,GAAGF,IAAI,CAAC9C,oBAAoB,CAAC;IAChD,IAAIyC,SAAS,EAAE;MAAA,IAAAQ,qBAAA;MACXD,eAAe,IAAAC,qBAAA,GAAGH,IAAI,CAAC7C,yBAAyB,CAAC,cAAAgD,qBAAA,cAAAA,qBAAA,GAAIH,IAAI,CAAC9C,oBAAoB,CAAC;IACnF;IAEA,IAAMkD,cAA8B,GAAG;MACnC7B,OAAO;MACPC,IAAI,EAAEK;IACV,CAAC;IAED,IAAIqB,eAAe,EAAE;MACjB;MACA;MACA,IAAMG,SAAQ,GAAG,IAAI,CAACpC,eAAe,CAACiC,eAAe,EAAEE,cAAc,CAAC;MACtE,IAAIC,SAAQ,IAAI,CAAC,EAAE;QACf;MACJ;IACJ;IAEA,IAAMxC,WAAW,GAAG8B,SAAS,GAAGK,IAAI,CAAC9C,oBAAoB,CAAC,GAAGkD,cAAc;IAC3E,IAAMtC,gBAAgB,GAAG6B,SAAS,GAAGS,cAAc,GAAGJ,IAAI,CAAC7C,yBAAyB,CAAC;IAErF,IAAIkD,QAAuB,GAAG,IAAI;IAClC,IAAIxC,WAAW,IAAIC,gBAAgB,EAAE;MACjCuC,QAAQ,GAAG,IAAI,CAAChC,wBAAwB,CAAC,CAAC,CAACC,oBAAoB,CAC3DT,WAAW,CAACU,OAAO,EACnBT,gBAAgB,CAACS,OACrB,CAAC;IACL;IAEA,IAAM+B,eAAe,GAAGD,QAAQ,KAAK,IAAI,IAAIA,QAAQ,GAAG,CAAC;;IAEzD;IACA;IACA,IAAME,aAAa,IAAAX,sBAAA,GAAGI,IAAI,CAAC7C,yBAAyB,CAAC,cAAAyC,sBAAA,cAAAA,sBAAA,GAAII,IAAI,CAAC9C,oBAAoB,CAAC;IAEnF,IAAIyC,SAAS,IAAIW,eAAe,EAAE;MAC9BN,IAAI,CAAC7C,yBAAyB,CAAC,GAAGiD,cAAc;IACpD,CAAC,MAAM,IAAI,CAACT,SAAS,EAAE;MACnBK,IAAI,CAAC9C,oBAAoB,CAAC,GAAGkD,cAAc;MAE3C,IAAI,CAACE,eAAe,EAAE;QAClBN,IAAI,CAAC7C,yBAAyB,CAAC,GAAG,IAAI;MAC1C;IACJ;IAEA,IAAMqD,gBAAgB,IAAAX,sBAAA,GAAGG,IAAI,CAAC7C,yBAAyB,CAAC,cAAA0C,sBAAA,cAAAA,sBAAA,GAAIG,IAAI,CAAC9C,oBAAoB,CAAC;IACtF,IAAIqD,aAAa,KAAKC,gBAAgB,EAAE;;IAExC;IACA,IAAID,aAAa,IAAI,IAAI,CAACE,qBAAqB,CAACzC,GAAG,CAACuC,aAAa,CAAChC,OAAO,CAAC,EAAE;MACxE,IAAMmC,eAAe,GAAGH,aAAa,CAAChC,OAAO;MAC7C;MACA,IAAI,CAACkC,qBAAqB,CAACR,GAAG,CAC1BS,eAAe,EACf,IAAI,CAACD,qBAAqB,CAACzC,GAAG,CAAC0C,eAAe,CAAC,CAAEC,MAAM,CAAEC,CAAC,IAAK;QAC3D,OAAOA,CAAC,CAAC9D,IAAI,KAAKX,WAAW,IAAIyE,CAAC,CAAC3E,MAAM,KAAKA,MAAM;MACxD,CAAC,CACL,CAAC;MAED,IAAI,IAAI,CAACwE,qBAAqB,CAACzC,GAAG,CAAC0C,eAAe,CAAC,CAAEpE,MAAM,GAAG,CAAC,EAAE;QAC7D,IAAI,CAACmE,qBAAqB,CAACI,MAAM,CAACH,eAAe,CAAC,CAAC,CAAC;MACxD;IACJ;;IAEA;IACA,IAAI,CAAC,IAAI,CAACD,qBAAqB,CAACzC,GAAG,CAACO,OAAO,CAAC,EAAE;MAC1C,IAAI,CAACkC,qBAAqB,CAACR,GAAG,CAAC1B,OAAO,EAAE,EAAE,CAAC;IAC/C;IACA,IAAI,CAACkC,qBAAqB,CAACzC,GAAG,CAACO,OAAO,CAAC,CAAEuC,IAAI,CAAC;MAC1C7E,MAAM,EAAEA,MAAM;MACda,IAAI,EAAEX,WAA0B;MAChCqC,IAAI,EAAEK;IACV,CAAC,CAAC;EACN;;EAEA;AACJ;AACA;AACA;AACA;AACA;EACWkC,mBAAmBA,CAAC7E,KAAkB,EAAmB;IAC5D,OAAO,IAAI,CAACuE,qBAAqB,CAACzC,GAAG,CAAC9B,KAAK,CAACO,KAAK,CAAC,CAAE,CAAC,IAAI,EAAE;EAC/D;;EAMA;AACJ;AACA;AACA;AACA;;EAGI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACWuE,kBAAkBA,CAAC/E,MAAc,EAAQ;IAC5C,IAAM4C,OAAO,GAAG,IAAI,CAACrB,uBAAuB,CAACvB,MAAM,EAAE,KAAK,CAAC;IAE3D,IAAMgF,SAAS,GAAG,IAAI,CAACC,QAAQ,CAAC,IAAI,CAACA,QAAQ,CAAC5E,MAAM,GAAG,CAAC,CAAC;IACzD,IAAI2E,SAAS,IAAI,CAAApC,OAAO,aAAPA,OAAO,uBAAPA,OAAO,CAAEN,OAAO,MAAK0C,SAAS,CAACxE,KAAK,CAAC,CAAC,IAAIR,MAAM,KAAKgF,SAAS,CAACE,SAAS,CAAC,CAAC,EAAE;MACzF,IAAI,CAACC,SAAS,CAACxF,qBAAqB,CAACyF,KAAK,EAAE,CAAC,CAAC;MAC9C,IAAI,CAACD,SAAS,CAACxF,qBAAqB,CAAC0F,SAAS,EAAE,CAAC,CAAC;IACtD;EACJ;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;EACWC,mBAAmBA,CAACtF,MAAc,EAAEuF,CAAc,EAAErF,WAAwB,EAA4B;IAAA,IAA1BC,UAAU,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,KAAK;IACnG,IAAI,CAACoF,UAAU,CAACzF,iBAAiB,CAACC,MAAM,EAAEuF,CAAC,EAAErF,WAAW,EAAEC,UAAU,CAAC,EAAE,IAAI,CAAC;EAChF;;EAEA;AACJ;AACA;AACA;AACA;EACWsF,gBAAgBA,CAACxF,KAAkB,EAAY;IAClD,OAAO,IAAI,CAAC6E,mBAAmB,CAAC7E,KAAK,CAAC,CACjCyE,MAAM,CAAC,UAAU9B,OAAO,EAAE;MACvB,OAAOrD,sBAAsB,CAACqD,OAAO,CAAC/B,IAAI,CAAC;IAC/C,CAAC,CAAC,CACD6E,GAAG,CAAC,UAAU9C,OAAO,EAAE;MACpB,OAAOA,OAAO,CAAC5C,MAAM;IACzB,CAAC,CAAC;EACV;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;;EAGI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA","ignoreList":[]}

package/lib/models/related-relations.d.ts

@@ -0,0 +1,11 @@
+import { Relations, RelationsEvent, EventHandlerMap } from "./relations.ts";
+import { MatrixEvent } from "./event.ts";
+import { Listener } from "./typed-event-emitter.ts";
+export declare class RelatedRelations {
+    private relations;
+    constructor(relations: Relations[]);
+    getRelations(): MatrixEvent[];
+    on<T extends RelationsEvent>(ev: T, fn: Listener<RelationsEvent, EventHandlerMap, T>): void;
+    off<T extends RelationsEvent>(ev: T, fn: Listener<RelationsEvent, EventHandlerMap, T>): void;
+}
+//# sourceMappingURL=related-relations.d.ts.map

package/lib/models/related-relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-relations.d.ts","sourceRoot":"","sources":["../../src/models/related-relations.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,qBAAa,gBAAgB;IACzB,OAAO,CAAC,SAAS,CAAc;gBAEZ,SAAS,EAAE,SAAS,EAAE;IAIlC,YAAY,IAAI,WAAW,EAAE;IAI7B,EAAE,CAAC,CAAC,SAAS,cAAc,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,cAAc,EAAE,eAAe,EAAE,CAAC,CAAC,GAAG,IAAI;IAI3F,GAAG,CAAC,CAAC,SAAS,cAAc,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,cAAc,EAAE,eAAe,EAAE,CAAC,CAAC,GAAG,IAAI;CAGtG"}

package/lib/models/related-relations.js

@@ -0,0 +1,33 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2022 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.
+*/
+
+export class RelatedRelations {
+  constructor(relations) {
+    _defineProperty(this, "relations", void 0);
+    this.relations = relations.filter(r => !!r);
+  }
+  getRelations() {
+    return this.relations.reduce((c, p) => [...c, ...p.getRelations()], []);
+  }
+  on(ev, fn) {
+    this.relations.forEach(r => r.on(ev, fn));
+  }
+  off(ev, fn) {
+    this.relations.forEach(r => r.off(ev, fn));
+  }
+}
+//# sourceMappingURL=related-relations.js.map

package/lib/models/related-relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-relations.js","names":["RelatedRelations","constructor","relations","_defineProperty","filter","r","getRelations","reduce","c","p","on","ev","fn","forEach","off"],"sources":["../../src/models/related-relations.ts"],"sourcesContent":["/*\nCopyright 2022 The Matrix.org Foundation C.I.C.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\nimport { Relations, RelationsEvent, EventHandlerMap } from \"./relations.ts\";\nimport { MatrixEvent } from \"./event.ts\";\nimport { Listener } from \"./typed-event-emitter.ts\";\n\nexport class RelatedRelations {\n    private relations: Relations[];\n\n    public constructor(relations: Relations[]) {\n        this.relations = relations.filter((r) => !!r);\n    }\n\n    public getRelations(): MatrixEvent[] {\n        return this.relations.reduce<MatrixEvent[]>((c, p) => [...c, ...p.getRelations()], []);\n    }\n\n    public on<T extends RelationsEvent>(ev: T, fn: Listener<RelationsEvent, EventHandlerMap, T>): void {\n        this.relations.forEach((r) => r.on(ev, fn));\n    }\n\n    public off<T extends RelationsEvent>(ev: T, fn: Listener<RelationsEvent, EventHandlerMap, T>): void {\n        this.relations.forEach((r) => r.off(ev, fn));\n    }\n}\n"],"mappings":";AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,OAAO,MAAMA,gBAAgB,CAAC;EAGnBC,WAAWA,CAACC,SAAsB,EAAE;IAAAC,eAAA;IACvC,IAAI,CAACD,SAAS,GAAGA,SAAS,CAACE,MAAM,CAAEC,CAAC,IAAK,CAAC,CAACA,CAAC,CAAC;EACjD;EAEOC,YAAYA,CAAA,EAAkB;IACjC,OAAO,IAAI,CAACJ,SAAS,CAACK,MAAM,CAAgB,CAACC,CAAC,EAAEC,CAAC,KAAK,CAAC,GAAGD,CAAC,EAAE,GAAGC,CAAC,CAACH,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;EAC1F;EAEOI,EAAEA,CAA2BC,EAAK,EAAEC,EAAgD,EAAQ;IAC/F,IAAI,CAACV,SAAS,CAACW,OAAO,CAAER,CAAC,IAAKA,CAAC,CAACK,EAAE,CAACC,EAAE,EAAEC,EAAE,CAAC,CAAC;EAC/C;EAEOE,GAAGA,CAA2BH,EAAK,EAAEC,EAAgD,EAAQ;IAChG,IAAI,CAACV,SAAS,CAACW,OAAO,CAAER,CAAC,IAAKA,CAAC,CAACS,GAAG,CAACH,EAAE,EAAEC,EAAE,CAAC,CAAC;EAChD;AACJ","ignoreList":[]}

package/lib/models/relations-container.d.ts

@@ -0,0 +1,44 @@
+import { Relations } from "./relations.ts";
+import { EventType, RelationType } from "../@types/event.ts";
+import { MatrixEvent } from "./event.ts";
+import { EventTimelineSet } from "./event-timeline-set.ts";
+import { MatrixClient } from "../client.ts";
+import { Room } from "./room.ts";
+export declare class RelationsContainer {
+    private readonly client;
+    private readonly room?;
+    private relations;
+    constructor(client: MatrixClient, room?: Room | undefined);
+    /**
+     * Get a collection of child events to a given event in this timeline set.
+     *
+     * @param eventId - The ID of the event that you'd like to access child events for.
+     * For example, with annotations, this would be the ID of the event being annotated.
+     * @param relationType - The type of relationship involved, such as "m.annotation", "m.reference", "m.replace", etc.
+     * @param eventType - The relation event's type, such as "m.reaction", etc.
+     * @throws If `eventId</code>, <code>relationType</code> or <code>eventType`
+     * are not valid.
+     *
+     * @returns
+     * A container for relation events or undefined if there are no relation events for
+     * the relationType.
+     */
+    getChildEventsForEvent(eventId: string, relationType: RelationType | string, eventType: EventType | string): Relations | undefined;
+    getAllChildEventsForEvent(parentEventId: string): MatrixEvent[];
+    /**
+     * Set an event as the target event if any Relations exist for it already.
+     * Child events can point to other child events as their parent, so this method may be
+     * called for events which are also logically child events.
+     *
+     * @param event - The event to check as relation target.
+     */
+    aggregateParentEvent(event: MatrixEvent): void;
+    /**
+     * Add relation events to the relevant relation collection.
+     *
+     * @param event - The new child event to be aggregated.
+     * @param timelineSet - The event timeline set within which to search for the related event if any.
+     */
+    aggregateChildEvent(event: MatrixEvent, timelineSet?: EventTimelineSet): void;
+}
+//# sourceMappingURL=relations-container.d.ts.map

package/lib/models/relations-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations-container.d.ts","sourceRoot":"","sources":["../../src/models/relations-container.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAe,WAAW,EAAoB,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,qBAAa,kBAAkB;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IAJ1B,OAAO,CAAC,SAAS,CAAqF;gBAGjF,MAAM,EAAE,YAAY,EACpB,IAAI,CAAC,EAAE,IAAI,YAAA;IAGhC;;;;;;;;;;;;;OAaG;IACI,sBAAsB,CACzB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,GAAG,MAAM,EACnC,SAAS,EAAE,SAAS,GAAG,MAAM,GAC9B,SAAS,GAAG,SAAS;IAIjB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,EAAE;IAYtE;;;;;;OAMG;IACI,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAWrD;;;;;OAKG;IACI,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,gBAAgB,GAAG,IAAI;CAyDvF"}