@openclaw/matrix 2026.7.1-beta.2 → 2026.7.1-beta.5

package/node_modules/matrix-js-sdk/lib/models/room-receipts.js.map

@@ -1 +1 @@
-{"version":3,"file":"room-receipts.js","names":["MAIN_ROOM_TIMELINE","threadIdForReceipt","RoomEvent","logger","RoomReceipts","constructor","room","_defineProperty","event","eventId","getId","danglingReceipts","remove","forEach","danglingReceipt","receipt","thread_id","threadedReceipts","set","receiptType","userId","ts","synthetic","unthreadedReceipts","ThreadedReceipts","ReceiptsByUser","DanglingReceipts","on","Timeline","onTimelineEvent","add","receiptContent","_ref3","Object","entries","_ref2","_slicedToArray","eventReceipt","_ref6","_ref5","receiptsByUser","_ref9","_ref8","referencedEvent","findEventById","DanglingReceipt","hasUserReadEvent","unthreaded","get","isAfterOrSame","warn","concat","roomId","threadId","threaded","userSentLatestEventInThread","_this$room$getThread","timeline","getLiveTimeline","getEvents","getThread","length","getSender","ReceiptInfo","UserReceipts","real","undefined","receiptInfo","_this$synthetic","getByType","data","Map","userReceipts","getOrCreate","existingReceipt","isAfter","_this$data$get","_this$data$get2","push","delete","m","key","createFn","found","created","leftEventId","rightEventId","comparison","compareEventOrdering"],"sources":["../../src/models/room-receipts.ts"],"sourcesContent":["/*\nCopyright 2023 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 { MAIN_ROOM_TIMELINE, type Receipt, type ReceiptContent } from \"../@types/read_receipts.ts\";\nimport { threadIdForReceipt } from \"../client.ts\";\nimport { type Room, RoomEvent } from \"./room.ts\";\nimport { type MatrixEvent } from \"./event.ts\";\nimport { logger } from \"../logger.ts\";\n\n/**\n * The latest receipts we have for a room.\n */\nexport class RoomReceipts {\n    private room: Room;\n    private threadedReceipts: ThreadedReceipts;\n    private unthreadedReceipts: ReceiptsByUser;\n    private danglingReceipts: DanglingReceipts;\n\n    public constructor(room: Room) {\n        this.room = room;\n        this.threadedReceipts = new ThreadedReceipts(room);\n        this.unthreadedReceipts = new ReceiptsByUser(room);\n        this.danglingReceipts = new DanglingReceipts();\n        // We listen for timeline events so we can process dangling receipts\n        room.on(RoomEvent.Timeline, this.onTimelineEvent);\n    }\n\n    /**\n     * Remember the receipt information supplied. For each receipt:\n     *\n     * If we don't have the event for this receipt, store it as \"dangling\" so we\n     * can process it later.\n     *\n     * Otherwise store it per-user in either the threaded store for its\n     * thread_id, or the unthreaded store if there is no thread_id.\n     *\n     * Ignores any receipt that is before an existing receipt for the same user\n     * (in the same thread, if applicable). \"Before\" is defined by the\n     * unfilteredTimelineSet of the room.\n     */\n    public add(receiptContent: ReceiptContent, synthetic: boolean): void {\n        /*\n            Transform this structure:\n            {\n              \"$EVENTID\": {\n                \"m.read|m.read.private\": {\n                  \"@user:example.org\": {\n                    \"ts\": 1661,\n                    \"thread_id\": \"main|$THREAD_ROOT_ID\" // or missing/undefined for an unthreaded receipt\n                  }\n                }\n              },\n              ...\n            }\n            into maps of:\n            threaded :: threadid :: userId :: ReceiptInfo\n            unthreaded :: userId :: ReceiptInfo\n            dangling :: eventId :: DanglingReceipt\n        */\n        for (const [eventId, eventReceipt] of Object.entries(receiptContent)) {\n            for (const [receiptType, receiptsByUser] of Object.entries(eventReceipt)) {\n                for (const [userId, receipt] of Object.entries(receiptsByUser)) {\n                    const referencedEvent = this.room.findEventById(eventId);\n                    if (!referencedEvent) {\n                        this.danglingReceipts.add(\n                            new DanglingReceipt(eventId, receiptType, userId, receipt, synthetic),\n                        );\n                    } else if (receipt.thread_id) {\n                        this.threadedReceipts.set(\n                            receipt.thread_id,\n                            eventId,\n                            receiptType,\n                            userId,\n                            receipt.ts,\n                            synthetic,\n                        );\n                    } else {\n                        this.unthreadedReceipts.set(eventId, receiptType, userId, receipt.ts, synthetic);\n                    }\n                }\n            }\n        }\n    }\n\n    /**\n     * Look for dangling receipts for the given event ID,\n     * and add them to the thread of unthread receipts if found.\n     * @param event - the event to look for\n     */\n    private onTimelineEvent = (event: MatrixEvent): void => {\n        const eventId = event.getId();\n        if (!eventId) return;\n\n        const danglingReceipts = this.danglingReceipts.remove(eventId);\n\n        danglingReceipts?.forEach((danglingReceipt) => {\n            // The receipt is a thread receipt\n            if (danglingReceipt.receipt.thread_id) {\n                this.threadedReceipts.set(\n                    danglingReceipt.receipt.thread_id,\n                    danglingReceipt.eventId,\n                    danglingReceipt.receiptType,\n                    danglingReceipt.userId,\n                    danglingReceipt.receipt.ts,\n                    danglingReceipt.synthetic,\n                );\n            } else {\n                this.unthreadedReceipts.set(\n                    eventId,\n                    danglingReceipt.receiptType,\n                    danglingReceipt.userId,\n                    danglingReceipt.receipt.ts,\n                    danglingReceipt.synthetic,\n                );\n            }\n        });\n    };\n\n    public hasUserReadEvent(userId: string, eventId: string): boolean {\n        const unthreaded = this.unthreadedReceipts.get(userId);\n        if (unthreaded) {\n            if (isAfterOrSame(unthreaded.eventId, eventId, this.room)) {\n                // The unthreaded receipt is after this event, so we have read it.\n                return true;\n            }\n        }\n\n        const event = this.room.findEventById(eventId);\n        if (!event) {\n            // We don't know whether the user has read it - default to caution and say no.\n            // This shouldn't really happen and feels like it ought to be an exception: let's\n            // log a warn for now.\n            logger.warn(\n                `hasUserReadEvent event ID ${eventId} not found in room ${this.room.roomId}: this shouldn't happen!`,\n            );\n            return false;\n        }\n\n        const threadId = threadIdForReceipt(event);\n        const threaded = this.threadedReceipts.get(threadId, userId);\n        if (threaded) {\n            if (isAfterOrSame(threaded.eventId, eventId, this.room)) {\n                // The threaded receipt is after this event, so we have read it.\n                return true;\n            }\n        }\n\n        // TODO: what if they sent the second-last event in the thread?\n        if (this.userSentLatestEventInThread(threadId, userId)) {\n            // The user sent the latest message in this event's thread, so we\n            // consider everything in the thread to be read.\n            //\n            // Note: maybe we don't need this because synthetic receipts should\n            // do this job for us?\n            return true;\n        }\n\n        // Neither of the receipts were after the event, so it's unread.\n        return false;\n    }\n\n    /**\n     * @returns true if the thread with this ID can be found, and the supplied\n     *          user sent the latest message in it.\n     */\n    private userSentLatestEventInThread(threadId: string, userId: string): boolean {\n        const timeline =\n            threadId === MAIN_ROOM_TIMELINE\n                ? this.room.getLiveTimeline().getEvents()\n                : this.room.getThread(threadId)?.timeline;\n\n        return !!(timeline && timeline.length > 0 && timeline[timeline.length - 1].getSender() === userId);\n    }\n}\n\n// --- implementation details ---\n\n/**\n * The information \"inside\" a receipt once it has been stored inside\n * RoomReceipts - what eventId it refers to, its type, and its ts.\n *\n * Does not contain userId or threadId since these are stored as keys of the\n * maps in RoomReceipts.\n */\nclass ReceiptInfo {\n    public constructor(\n        public eventId: string,\n        public receiptType: string,\n        public ts: number,\n    ) {}\n}\n\n/**\n * Everything we know about a receipt that is \"dangling\" because we can't find\n * the event to which it refers.\n */\nclass DanglingReceipt {\n    public constructor(\n        public eventId: string,\n        public receiptType: string,\n        public userId: string,\n        public receipt: Receipt,\n        public synthetic: boolean,\n    ) {}\n}\n\nclass UserReceipts {\n    private room: Room;\n\n    /**\n     * The real receipt for this user.\n     */\n    private real: ReceiptInfo | undefined;\n\n    /**\n     * The synthetic receipt for this user. If this is defined, it is later than real.\n     */\n    private synthetic: ReceiptInfo | undefined;\n\n    public constructor(room: Room) {\n        this.room = room;\n        this.real = undefined;\n        this.synthetic = undefined;\n    }\n\n    public set(synthetic: boolean, receiptInfo: ReceiptInfo): void {\n        if (synthetic) {\n            this.synthetic = receiptInfo;\n        } else {\n            this.real = receiptInfo;\n        }\n\n        // Preserve the invariant: synthetic is only defined if it's later than real\n        if (this.synthetic && this.real) {\n            if (isAfterOrSame(this.real.eventId, this.synthetic.eventId, this.room)) {\n                this.synthetic = undefined;\n            }\n        }\n    }\n\n    /**\n     * Return the latest receipt we have - synthetic if we have one (and it's\n     * later), otherwise real.\n     */\n    public get(): ReceiptInfo | undefined {\n        // Relies on the invariant that synthetic is only defined if it's later than real.\n        return this.synthetic ?? this.real;\n    }\n\n    /**\n     * Return the latest receipt we have of the specified type (synthetic or not).\n     */\n    public getByType(synthetic: boolean): ReceiptInfo | undefined {\n        return synthetic ? this.synthetic : this.real;\n    }\n}\n\n/**\n * The latest receipt info we have, either for a single thread, or all the\n * unthreaded receipts for a room.\n *\n * userId: ReceiptInfo\n */\nclass ReceiptsByUser {\n    private room: Room;\n\n    /** map of userId: UserReceipts */\n    private data: Map<string, UserReceipts>;\n\n    public constructor(room: Room) {\n        this.room = room;\n        this.data = new Map<string, UserReceipts>();\n    }\n\n    /**\n     * Add the supplied receipt to our structure, if it is not earlier than the\n     * one we already hold for this user.\n     */\n    public set(eventId: string, receiptType: string, userId: string, ts: number, synthetic: boolean): void {\n        const userReceipts = getOrCreate(this.data, userId, () => new UserReceipts(this.room));\n\n        const existingReceipt = userReceipts.getByType(synthetic);\n        if (existingReceipt && isAfter(existingReceipt.eventId, eventId, this.room)) {\n            // The new receipt is before the existing one - don't store it.\n            return;\n        }\n\n        // Possibilities:\n        //\n        // 1. there was no existing receipt, or\n        // 2. the existing receipt was before this one, or\n        // 3. we were unable to compare the receipts.\n        //\n        // In the case of 3 it's difficult to decide what to do, so the\n        // most-recently-received receipt wins.\n        //\n        // Case 3 can only happen if the events for these receipts have\n        // disappeared, which is quite unlikely since the new one has just been\n        // checked, and the old one was checked before it was inserted here.\n        //\n        // We go ahead and store this receipt (replacing the other if it exists)\n        userReceipts.set(synthetic, new ReceiptInfo(eventId, receiptType, ts));\n    }\n\n    /**\n     * Find the latest receipt we have for this user. (Note - there is only one\n     * receipt per user, because we are already inside a specific thread or\n     * unthreaded list.)\n     *\n     * If there is a later synthetic receipt for this user, return that.\n     * Otherwise, return the real receipt.\n     *\n     * @returns the found receipt info, or undefined if we have no receipt for this user.\n     */\n    public get(userId: string): ReceiptInfo | undefined {\n        return this.data.get(userId)?.get();\n    }\n}\n\n/**\n * The latest threaded receipts we have for a room.\n */\nclass ThreadedReceipts {\n    private room: Room;\n\n    /** map of threadId: ReceiptsByUser */\n    private data: Map<string, ReceiptsByUser>;\n\n    public constructor(room: Room) {\n        this.room = room;\n        this.data = new Map<string, ReceiptsByUser>();\n    }\n\n    /**\n     * Add the supplied receipt to our structure, if it is not earlier than one\n     * we already hold for this user in this thread.\n     */\n    public set(\n        threadId: string,\n        eventId: string,\n        receiptType: string,\n        userId: string,\n        ts: number,\n        synthetic: boolean,\n    ): void {\n        const receiptsByUser = getOrCreate(this.data, threadId, () => new ReceiptsByUser(this.room));\n        receiptsByUser.set(eventId, receiptType, userId, ts, synthetic);\n    }\n\n    /**\n     * Find the latest threaded receipt for the supplied user in the supplied thread.\n     *\n     * @returns the found receipt info or undefined if we don't have one.\n     */\n    public get(threadId: string, userId: string): ReceiptInfo | undefined {\n        return this.data.get(threadId)?.get(userId);\n    }\n}\n\n/**\n * All the receipts that we have received but can't process because we can't\n * find the event they refer to.\n *\n * We hold on to them so we can process them if their event arrives later.\n */\nclass DanglingReceipts {\n    /**\n     * eventId: DanglingReceipt[]\n     */\n    private data = new Map<string, Array<DanglingReceipt>>();\n\n    /**\n     * Remember the supplied dangling receipt.\n     */\n    public add(danglingReceipt: DanglingReceipt): void {\n        const danglingReceipts = getOrCreate(this.data, danglingReceipt.eventId, () => []);\n        danglingReceipts.push(danglingReceipt);\n    }\n\n    /**\n     * Remove and return the dangling receipts for the given event ID.\n     * @param eventId - the event ID to look for\n     * @returns the found dangling receipts, or undefined if we don't have one.\n     */\n    public remove(eventId: string): Array<DanglingReceipt> | undefined {\n        const danglingReceipts = this.data.get(eventId);\n        this.data.delete(eventId);\n        return danglingReceipts;\n    }\n}\n\nfunction getOrCreate<K, V>(m: Map<K, V>, key: K, createFn: () => V): V {\n    const found = m.get(key);\n    if (found) {\n        return found;\n    } else {\n        const created = createFn();\n        m.set(key, created);\n        return created;\n    }\n}\n\n/**\n * Is left after right (or the same)?\n *\n * Only returns true if both events can be found, and left is after or the same\n * as right.\n *\n * @returns left \\>= right\n */\nfunction isAfterOrSame(leftEventId: string, rightEventId: string, room: Room): boolean {\n    const comparison = room.compareEventOrdering(leftEventId, rightEventId);\n    return comparison !== null && comparison >= 0;\n}\n\n/**\n * Is left strictly after right?\n *\n * Only returns true if both events can be found, and left is strictly after right.\n *\n * @returns left \\> right\n */\nfunction isAfter(leftEventId: string, rightEventId: string, room: Room): boolean {\n    const comparison = room.compareEventOrdering(leftEventId, rightEventId);\n    return comparison !== null && comparison > 0;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"room-receipts.js","names":[],"sources":["../../src/models/room-receipts.ts"],"sourcesContent":["/*\nCopyright 2023 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 { MAIN_ROOM_TIMELINE, type Receipt, type ReceiptContent } from \"../@types/read_receipts.ts\";\nimport { threadIdForReceipt } from \"../client.ts\";\nimport { type Room, RoomEvent } from \"./room.ts\";\nimport { type MatrixEvent } from \"./event.ts\";\nimport { logger } from \"../logger.ts\";\n\n/**\n * The latest receipts we have for a room.\n */\nexport class RoomReceipts {\n    private room: Room;\n    private threadedReceipts: ThreadedReceipts;\n    private unthreadedReceipts: ReceiptsByUser;\n    private danglingReceipts: DanglingReceipts;\n\n    public constructor(room: Room) {\n        this.room = room;\n        this.threadedReceipts = new ThreadedReceipts(room);\n        this.unthreadedReceipts = new ReceiptsByUser(room);\n        this.danglingReceipts = new DanglingReceipts();\n        // We listen for timeline events so we can process dangling receipts\n        room.on(RoomEvent.Timeline, this.onTimelineEvent);\n    }\n\n    /**\n     * Remember the receipt information supplied. For each receipt:\n     *\n     * If we don't have the event for this receipt, store it as \"dangling\" so we\n     * can process it later.\n     *\n     * Otherwise store it per-user in either the threaded store for its\n     * thread_id, or the unthreaded store if there is no thread_id.\n     *\n     * Ignores any receipt that is before an existing receipt for the same user\n     * (in the same thread, if applicable). \"Before\" is defined by the\n     * unfilteredTimelineSet of the room.\n     */\n    public add(receiptContent: ReceiptContent, synthetic: boolean): void {\n        /*\n            Transform this structure:\n            {\n              \"$EVENTID\": {\n                \"m.read|m.read.private\": {\n                  \"@user:example.org\": {\n                    \"ts\": 1661,\n                    \"thread_id\": \"main|$THREAD_ROOT_ID\" // or missing/undefined for an unthreaded receipt\n                  }\n                }\n              },\n              ...\n            }\n            into maps of:\n            threaded :: threadid :: userId :: ReceiptInfo\n            unthreaded :: userId :: ReceiptInfo\n            dangling :: eventId :: DanglingReceipt\n        */\n        for (const [eventId, eventReceipt] of Object.entries(receiptContent)) {\n            for (const [receiptType, receiptsByUser] of Object.entries(eventReceipt)) {\n                for (const [userId, receipt] of Object.entries(receiptsByUser)) {\n                    const referencedEvent = this.room.findEventById(eventId);\n                    if (!referencedEvent) {\n                        this.danglingReceipts.add(\n                            new DanglingReceipt(eventId, receiptType, userId, receipt, synthetic),\n                        );\n                    } else if (receipt.thread_id) {\n                        this.threadedReceipts.set(\n                            receipt.thread_id,\n                            eventId,\n                            receiptType,\n                            userId,\n                            receipt.ts,\n                            synthetic,\n                        );\n                    } else {\n                        this.unthreadedReceipts.set(eventId, receiptType, userId, receipt.ts, synthetic);\n                    }\n                }\n            }\n        }\n    }\n\n    /**\n     * Look for dangling receipts for the given event ID,\n     * and add them to the thread of unthread receipts if found.\n     * @param event - the event to look for\n     */\n    private onTimelineEvent = (event: MatrixEvent): void => {\n        const eventId = event.getId();\n        if (!eventId) return;\n\n        const danglingReceipts = this.danglingReceipts.remove(eventId);\n\n        danglingReceipts?.forEach((danglingReceipt) => {\n            // The receipt is a thread receipt\n            if (danglingReceipt.receipt.thread_id) {\n                this.threadedReceipts.set(\n                    danglingReceipt.receipt.thread_id,\n                    danglingReceipt.eventId,\n                    danglingReceipt.receiptType,\n                    danglingReceipt.userId,\n                    danglingReceipt.receipt.ts,\n                    danglingReceipt.synthetic,\n                );\n            } else {\n                this.unthreadedReceipts.set(\n                    eventId,\n                    danglingReceipt.receiptType,\n                    danglingReceipt.userId,\n                    danglingReceipt.receipt.ts,\n                    danglingReceipt.synthetic,\n                );\n            }\n        });\n    };\n\n    public hasUserReadEvent(userId: string, eventId: string): boolean {\n        const unthreaded = this.unthreadedReceipts.get(userId);\n        if (unthreaded) {\n            if (isAfterOrSame(unthreaded.eventId, eventId, this.room)) {\n                // The unthreaded receipt is after this event, so we have read it.\n                return true;\n            }\n        }\n\n        const event = this.room.findEventById(eventId);\n        if (!event) {\n            // We don't know whether the user has read it - default to caution and say no.\n            // This shouldn't really happen and feels like it ought to be an exception: let's\n            // log a warn for now.\n            logger.warn(\n                `hasUserReadEvent event ID ${eventId} not found in room ${this.room.roomId}: this shouldn't happen!`,\n            );\n            return false;\n        }\n\n        const threadId = threadIdForReceipt(event);\n        const threaded = this.threadedReceipts.get(threadId, userId);\n        if (threaded) {\n            if (isAfterOrSame(threaded.eventId, eventId, this.room)) {\n                // The threaded receipt is after this event, so we have read it.\n                return true;\n            }\n        }\n\n        // TODO: what if they sent the second-last event in the thread?\n        if (this.userSentLatestEventInThread(threadId, userId)) {\n            // The user sent the latest message in this event's thread, so we\n            // consider everything in the thread to be read.\n            //\n            // Note: maybe we don't need this because synthetic receipts should\n            // do this job for us?\n            return true;\n        }\n\n        // Neither of the receipts were after the event, so it's unread.\n        return false;\n    }\n\n    /**\n     * @returns true if the thread with this ID can be found, and the supplied\n     *          user sent the latest message in it.\n     */\n    private userSentLatestEventInThread(threadId: string, userId: string): boolean {\n        const timeline =\n            threadId === MAIN_ROOM_TIMELINE\n                ? this.room.getLiveTimeline().getEvents()\n                : this.room.getThread(threadId)?.timeline;\n\n        return !!(timeline && timeline.length > 0 && timeline[timeline.length - 1].getSender() === userId);\n    }\n}\n\n// --- implementation details ---\n\n/**\n * The information \"inside\" a receipt once it has been stored inside\n * RoomReceipts - what eventId it refers to, its type, and its ts.\n *\n * Does not contain userId or threadId since these are stored as keys of the\n * maps in RoomReceipts.\n */\nclass ReceiptInfo {\n    public constructor(\n        public eventId: string,\n        public receiptType: string,\n        public ts: number,\n    ) {}\n}\n\n/**\n * Everything we know about a receipt that is \"dangling\" because we can't find\n * the event to which it refers.\n */\nclass DanglingReceipt {\n    public constructor(\n        public eventId: string,\n        public receiptType: string,\n        public userId: string,\n        public receipt: Receipt,\n        public synthetic: boolean,\n    ) {}\n}\n\nclass UserReceipts {\n    private room: Room;\n\n    /**\n     * The real receipt for this user.\n     */\n    private real: ReceiptInfo | undefined;\n\n    /**\n     * The synthetic receipt for this user. If this is defined, it is later than real.\n     */\n    private synthetic: ReceiptInfo | undefined;\n\n    public constructor(room: Room) {\n        this.room = room;\n        this.real = undefined;\n        this.synthetic = undefined;\n    }\n\n    public set(synthetic: boolean, receiptInfo: ReceiptInfo): void {\n        if (synthetic) {\n            this.synthetic = receiptInfo;\n        } else {\n            this.real = receiptInfo;\n        }\n\n        // Preserve the invariant: synthetic is only defined if it's later than real\n        if (this.synthetic && this.real) {\n            if (isAfterOrSame(this.real.eventId, this.synthetic.eventId, this.room)) {\n                this.synthetic = undefined;\n            }\n        }\n    }\n\n    /**\n     * Return the latest receipt we have - synthetic if we have one (and it's\n     * later), otherwise real.\n     */\n    public get(): ReceiptInfo | undefined {\n        // Relies on the invariant that synthetic is only defined if it's later than real.\n        return this.synthetic ?? this.real;\n    }\n\n    /**\n     * Return the latest receipt we have of the specified type (synthetic or not).\n     */\n    public getByType(synthetic: boolean): ReceiptInfo | undefined {\n        return synthetic ? this.synthetic : this.real;\n    }\n}\n\n/**\n * The latest receipt info we have, either for a single thread, or all the\n * unthreaded receipts for a room.\n *\n * userId: ReceiptInfo\n */\nclass ReceiptsByUser {\n    private room: Room;\n\n    /** map of userId: UserReceipts */\n    private data: Map<string, UserReceipts>;\n\n    public constructor(room: Room) {\n        this.room = room;\n        this.data = new Map<string, UserReceipts>();\n    }\n\n    /**\n     * Add the supplied receipt to our structure, if it is not earlier than the\n     * one we already hold for this user.\n     */\n    public set(eventId: string, receiptType: string, userId: string, ts: number, synthetic: boolean): void {\n        const userReceipts = getOrCreate(this.data, userId, () => new UserReceipts(this.room));\n\n        const existingReceipt = userReceipts.getByType(synthetic);\n        if (existingReceipt && isAfter(existingReceipt.eventId, eventId, this.room)) {\n            // The new receipt is before the existing one - don't store it.\n            return;\n        }\n\n        // Possibilities:\n        //\n        // 1. there was no existing receipt, or\n        // 2. the existing receipt was before this one, or\n        // 3. we were unable to compare the receipts.\n        //\n        // In the case of 3 it's difficult to decide what to do, so the\n        // most-recently-received receipt wins.\n        //\n        // Case 3 can only happen if the events for these receipts have\n        // disappeared, which is quite unlikely since the new one has just been\n        // checked, and the old one was checked before it was inserted here.\n        //\n        // We go ahead and store this receipt (replacing the other if it exists)\n        userReceipts.set(synthetic, new ReceiptInfo(eventId, receiptType, ts));\n    }\n\n    /**\n     * Find the latest receipt we have for this user. (Note - there is only one\n     * receipt per user, because we are already inside a specific thread or\n     * unthreaded list.)\n     *\n     * If there is a later synthetic receipt for this user, return that.\n     * Otherwise, return the real receipt.\n     *\n     * @returns the found receipt info, or undefined if we have no receipt for this user.\n     */\n    public get(userId: string): ReceiptInfo | undefined {\n        return this.data.get(userId)?.get();\n    }\n}\n\n/**\n * The latest threaded receipts we have for a room.\n */\nclass ThreadedReceipts {\n    private room: Room;\n\n    /** map of threadId: ReceiptsByUser */\n    private data: Map<string, ReceiptsByUser>;\n\n    public constructor(room: Room) {\n        this.room = room;\n        this.data = new Map<string, ReceiptsByUser>();\n    }\n\n    /**\n     * Add the supplied receipt to our structure, if it is not earlier than one\n     * we already hold for this user in this thread.\n     */\n    public set(\n        threadId: string,\n        eventId: string,\n        receiptType: string,\n        userId: string,\n        ts: number,\n        synthetic: boolean,\n    ): void {\n        const receiptsByUser = getOrCreate(this.data, threadId, () => new ReceiptsByUser(this.room));\n        receiptsByUser.set(eventId, receiptType, userId, ts, synthetic);\n    }\n\n    /**\n     * Find the latest threaded receipt for the supplied user in the supplied thread.\n     *\n     * @returns the found receipt info or undefined if we don't have one.\n     */\n    public get(threadId: string, userId: string): ReceiptInfo | undefined {\n        return this.data.get(threadId)?.get(userId);\n    }\n}\n\n/**\n * All the receipts that we have received but can't process because we can't\n * find the event they refer to.\n *\n * We hold on to them so we can process them if their event arrives later.\n */\nclass DanglingReceipts {\n    /**\n     * eventId: DanglingReceipt[]\n     */\n    private data = new Map<string, Array<DanglingReceipt>>();\n\n    /**\n     * Remember the supplied dangling receipt.\n     */\n    public add(danglingReceipt: DanglingReceipt): void {\n        const danglingReceipts = getOrCreate(this.data, danglingReceipt.eventId, () => []);\n        danglingReceipts.push(danglingReceipt);\n    }\n\n    /**\n     * Remove and return the dangling receipts for the given event ID.\n     * @param eventId - the event ID to look for\n     * @returns the found dangling receipts, or undefined if we don't have one.\n     */\n    public remove(eventId: string): Array<DanglingReceipt> | undefined {\n        const danglingReceipts = this.data.get(eventId);\n        this.data.delete(eventId);\n        return danglingReceipts;\n    }\n}\n\nfunction getOrCreate<K, V>(m: Map<K, V>, key: K, createFn: () => V): V {\n    const found = m.get(key);\n    if (found) {\n        return found;\n    } else {\n        const created = createFn();\n        m.set(key, created);\n        return created;\n    }\n}\n\n/**\n * Is left after right (or the same)?\n *\n * Only returns true if both events can be found, and left is after or the same\n * as right.\n *\n * @returns left \\>= right\n */\nfunction isAfterOrSame(leftEventId: string, rightEventId: string, room: Room): boolean {\n    const comparison = room.compareEventOrdering(leftEventId, rightEventId);\n    return comparison !== null && comparison >= 0;\n}\n\n/**\n * Is left strictly after right?\n *\n * Only returns true if both events can be found, and left is strictly after right.\n *\n * @returns left \\> right\n */\nfunction isAfter(leftEventId: string, rightEventId: string, room: Room): boolean {\n    const comparison = room.compareEventOrdering(leftEventId, rightEventId);\n    return comparison !== null && comparison > 0;\n}\n"],"mappings":";AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAAS,kBAAkB,QAA2C,4BAA4B;AAClG,SAAS,kBAAkB,QAAQ,cAAc;AACjD,SAAoB,SAAS,QAAQ,WAAW;AAEhD,SAAS,MAAM,QAAQ,cAAc;;AAErC;AACA;AACA;AACA,OAAO,MAAM,YAAY,CAAC;EAMf,WAAW,CAAC,IAAU,EAAE;IAAA;IAAA;IAAA;IAAA;IAkE/B;AACJ;AACA;AACA;AACA;IAJI,yCAK2B,KAAkB,IAAW;MACpD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;MAC7B,IAAI,CAAC,OAAO,EAAE;MAEd,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC;MAE9D,gBAAgB,EAAE,OAAO,CAAE,eAAe,IAAK;QAC3C;QACA,IAAI,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE;UACnC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CACrB,eAAe,CAAC,OAAO,CAAC,SAAS,EACjC,eAAe,CAAC,OAAO,EACvB,eAAe,CAAC,WAAW,EAC3B,eAAe,CAAC,MAAM,EACtB,eAAe,CAAC,OAAO,CAAC,EAAE,EAC1B,eAAe,CAAC,SACpB,CAAC;QACL,CAAC,MAAM;UACH,IAAI,CAAC,kBAAkB,CAAC,GAAG,CACvB,OAAO,EACP,eAAe,CAAC,WAAW,EAC3B,eAAe,CAAC,MAAM,EACtB,eAAe,CAAC,OAAO,CAAC,EAAE,EAC1B,eAAe,CAAC,SACpB,CAAC;QACL;MACJ,CAAC,CAAC;IACN,CAAC;IAjGG,IAAI,CAAC,IAAI,GAAG,IAAI;IAChB,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC;IAClD,IAAI,CAAC,kBAAkB,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC;IAClD,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,CAAC;IAC9C;IACA,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC;EACrD;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACW,GAAG,CAAC,cAA8B,EAAE,SAAkB,EAAQ;IACjE;AACR;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACQ,KAAK,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;MAClE,KAAK,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;QACtE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;UAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;UACxD,IAAI,CAAC,eAAe,EAAE;YAClB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CACrB,IAAI,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CACxE,CAAC;UACL,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE;YAC1B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CACrB,OAAO,CAAC,SAAS,EACjB,OAAO,EACP,WAAW,EACX,MAAM,EACN,OAAO,CAAC,EAAE,EACV,SACJ,CAAC;UACL,CAAC,MAAM;YACH,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC;UACpF;QACJ;MACJ;IACJ;EACJ;EAoCO,gBAAgB,CAAC,MAAc,EAAE,OAAe,EAAW;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC;IACtD,IAAI,UAAU,EAAE;MACZ,IAAI,aAAa,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;QACvD;QACA,OAAO,IAAI;MACf;IACJ;IAEA,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE;MACR;MACA;MACA;MACA,MAAM,CAAC,IAAI,CACP,6BAA6B,OAAO,sBAAsB,IAAI,CAAC,IAAI,CAAC,MAAM,0BAC9E,CAAC;MACD,OAAO,KAAK;IAChB;IAEA,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC5D,IAAI,QAAQ,EAAE;MACV,IAAI,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;QACrD;QACA,OAAO,IAAI;MACf;IACJ;;IAEA;IACA,IAAI,IAAI,CAAC,2BAA2B,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;MACpD;MACA;MACA;MACA;MACA;MACA,OAAO,IAAI;IACf;;IAEA;IACA,OAAO,KAAK;EAChB;;EAEA;AACJ;AACA;AACA;EACY,2BAA2B,CAAC,QAAgB,EAAE,MAAc,EAAW;IAC3E,MAAM,QAAQ,GACV,QAAQ,KAAK,kBAAkB,GACzB,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GACvC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ;IAEjD,OAAO,CAAC,EAAE,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,MAAM,CAAC;EACtG;AACJ;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,WAAW,CAAC;EACP,WAAW,CACP,OAAe,EACf,WAAmB,EACnB,EAAU,EACnB;IAAA,KAHS,OAAe,GAAf,OAAe;IAAA,KACf,WAAmB,GAAnB,WAAmB;IAAA,KACnB,EAAU,GAAV,EAAU;EAClB;AACP;;AAEA;AACA;AACA;AACA;AACA,MAAM,eAAe,CAAC;EACX,WAAW,CACP,OAAe,EACf,WAAmB,EACnB,MAAc,EACd,OAAgB,EAChB,SAAkB,EAC3B;IAAA,KALS,OAAe,GAAf,OAAe;IAAA,KACf,WAAmB,GAAnB,WAAmB;IAAA,KACnB,MAAc,GAAd,MAAc;IAAA,KACd,OAAgB,GAAhB,OAAgB;IAAA,KAChB,SAAkB,GAAlB,SAAkB;EAC1B;AACP;AAEA,MAAM,YAAY,CAAC;EAaR,WAAW,CAAC,IAAU,EAAE;IAAA;IAV/B;AACJ;AACA;IAFI;IAKA;AACJ;AACA;IAFI;IAMI,IAAI,CAAC,IAAI,GAAG,IAAI;IAChB,IAAI,CAAC,IAAI,GAAG,SAAS;IACrB,IAAI,CAAC,SAAS,GAAG,SAAS;EAC9B;EAEO,GAAG,CAAC,SAAkB,EAAE,WAAwB,EAAQ;IAC3D,IAAI,SAAS,EAAE;MACX,IAAI,CAAC,SAAS,GAAG,WAAW;IAChC,CAAC,MAAM;MACH,IAAI,CAAC,IAAI,GAAG,WAAW;IAC3B;;IAEA;IACA,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE;MAC7B,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;QACrE,IAAI,CAAC,SAAS,GAAG,SAAS;MAC9B;IACJ;EACJ;;EAEA;AACJ;AACA;AACA;EACW,GAAG,GAA4B;IAClC;IACA,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI;EACtC;;EAEA;AACJ;AACA;EACW,SAAS,CAAC,SAAkB,EAA2B;IAC1D,OAAO,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI;EACjD;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,cAAc,CAAC;EAMV,WAAW,CAAC,IAAU,EAAE;IAAA;IAH/B;IAAA;IAII,IAAI,CAAC,IAAI,GAAG,IAAI;IAChB,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAuB,CAAC;EAC/C;;EAEA;AACJ;AACA;AACA;EACW,GAAG,CAAC,OAAe,EAAE,WAAmB,EAAE,MAAc,EAAE,EAAU,EAAE,SAAkB,EAAQ;IACnG,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtF,MAAM,eAAe,GAAG,YAAY,CAAC,SAAS,CAAC,SAAS,CAAC;IACzD,IAAI,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;MACzE;MACA;IACJ;;IAEA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;EAC1E;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACW,GAAG,CAAC,MAAc,EAA2B;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;EACvC;AACJ;;AAEA;AACA;AACA;AACA,MAAM,gBAAgB,CAAC;EAMZ,WAAW,CAAC,IAAU,EAAE;IAAA;IAH/B;IAAA;IAII,IAAI,CAAC,IAAI,GAAG,IAAI;IAChB,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAyB,CAAC;EACjD;;EAEA;AACJ;AACA;AACA;EACW,GAAG,CACN,QAAgB,EAChB,OAAe,EACf,WAAmB,EACnB,MAAc,EACd,EAAU,EACV,SAAkB,EACd;IACJ,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5F,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,CAAC;EACnE;;EAEA;AACJ;AACA;AACA;AACA;EACW,GAAG,CAAC,QAAgB,EAAE,MAAc,EAA2B;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC;EAC/C;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,gBAAgB,CAAC;EAAA;IACnB;AACJ;AACA;IAFI,8BAGe,IAAI,GAAG,CAAiC,CAAC;EAAA;EAExD;AACJ;AACA;EACW,GAAG,CAAC,eAAgC,EAAQ;IAC/C,MAAM,gBAAgB,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClF,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC;EAC1C;;EAEA;AACJ;AACA;AACA;AACA;EACW,MAAM,CAAC,OAAe,EAAsC;IAC/D,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IACzB,OAAO,gBAAgB;EAC3B;AACJ;AAEA,SAAS,WAAW,CAAO,CAAY,EAAE,GAAM,EAAE,QAAiB,EAAK;EACnE,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;EACxB,IAAI,KAAK,EAAE;IACP,OAAO,KAAK;EAChB,CAAC,MAAM;IACH,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC;IAC1B,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC;IACnB,OAAO,OAAO;EAClB;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,aAAa,CAAC,WAAmB,EAAE,YAAoB,EAAE,IAAU,EAAW;EACnF,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,WAAW,EAAE,YAAY,CAAC;EACvE,OAAO,UAAU,KAAK,IAAI,IAAI,UAAU,IAAI,CAAC;AACjD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,OAAO,CAAC,WAAmB,EAAE,YAAoB,EAAE,IAAU,EAAW;EAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,WAAW,EAAE,YAAY,CAAC;EACvE,OAAO,UAAU,KAAK,IAAI,IAAI,UAAU,GAAG,CAAC;AAChD","ignoreList":[]}

package/node_modules/matrix-js-sdk/lib/models/room-retention.d.ts

@@ -0,0 +1,28 @@
+import { MatrixEvent } from "../models/event.ts";
+import { type Room } from "./room.ts";
+import type { RetentionPolicyService } from "../retentionPolicy.ts";
+import type { IStore } from "../store/index.ts";
+/**
+ * Applies https://github.com/matrix-org/matrix-spec-proposals/pull/1763 by checking the current
+ * state of the room and applying the *latest* retention policy to all preceeding events.
+ * Currently does not:
+ *   - Apply global server policies (requires Synapse work)
+ *   - React at all to `min_retention` configs.
+ *   - Loop
+ */
+export declare class RoomRetentionPolicy {
+    private readonly room;
+    private readonly retentionService;
+    private readonly store;
+    private maxRetention;
+    private retentionTimeout?;
+    private readonly logger;
+    constructor(room: Room, retentionService: RetentionPolicyService, store: IStore);
+    shouldEventBeRetained(ev: MatrixEvent): boolean;
+    private readonly handleRetentionUpdate;
+    private readonly recalculateRetention;
+    private readonly timelineUpdated;
+    private readonly scheduleTimelineCheck;
+    private processTimeline;
+}
+//# sourceMappingURL=room-retention.d.ts.map

package/node_modules/matrix-js-sdk/lib/models/room-retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-retention.d.ts","sourceRoot":"","sources":["../../src/models/room-retention.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;;;;;GAOG;AACH,qBAAa,mBAAmB;IAOxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAP1B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,gBAAgB,CAAC,CAAgC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGX,IAAI,EAAE,IAAI,EACV,gBAAgB,EAAE,sBAAsB,EACxC,KAAK,EAAE,MAAM;IA0B3B,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO;IAQtD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAqBpC;IAEF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CA6DnC;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG9B;IAEF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAQpC;IAEF,OAAO,CAAC,eAAe;CAoD1B"}

package/node_modules/matrix-js-sdk/lib/models/room-retention.js

@@ -0,0 +1,192 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2026 Element Creations Ltd.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { MatrixEvent } from "../models/event.js";
+import { RoomEvent } from "./room.js";
+import { RoomStateEvent } from "./room-state.js";
+import { logger as rootLogger } from "../logger.js";
+import { EventType } from "../@types/event.js";
+import { ROOM_RETENTION_TYPE } from "../@types/retention.js";
+
+/**
+ * Applies https://github.com/matrix-org/matrix-spec-proposals/pull/1763 by checking the current
+ * state of the room and applying the *latest* retention policy to all preceeding events.
+ * Currently does not:
+ *   - Apply global server policies (requires Synapse work)
+ *   - React at all to `min_retention` configs.
+ *   - Loop
+ */
+export class RoomRetentionPolicy {
+  constructor(room, retentionService, store) {
+    // minRetention is not implemented.
+    _defineProperty(this, "maxRetention", null);
+    _defineProperty(this, "retentionTimeout", void 0);
+    _defineProperty(this, "logger", void 0);
+    _defineProperty(this, "handleRetentionUpdate", async () => {
+      // First store if we currently have a retention period.
+      const hadRetentionPeriod = this.maxRetention !== null;
+      try {
+        await this.recalculateRetention(this.room.currentState);
+      } catch (err) {
+        this.logger.warn("Failed to recalculate retention policy", err);
+        return;
+      }
+
+      // Bind/unbind the Timeline event handler based on whether we should be running retention.
+      if (hadRetentionPeriod !== (this.maxRetention !== null)) {
+        this.logger.info("retention recalculated to be", this.maxRetention);
+        // We've changed
+        if (this.maxRetention) {
+          this.room.on(RoomEvent.Timeline, this.timelineUpdated);
+        } else {
+          this.room.off(RoomEvent.Timeline, this.timelineUpdated);
+        }
+      }
+    });
+    _defineProperty(this, "recalculateRetention", async roomState => {
+      const unstableEvent = roomState.getStateEvents(ROOM_RETENTION_TYPE.name).find(e => e.getStateKey() === "");
+      const stableEvent = roomState.getStateEvents(ROOM_RETENTION_TYPE.altName).find(e => e.getStateKey() === "");
+      const serverPolicy = this.retentionService.getCached();
+      const serverRoomPolicy = serverPolicy?.policies?.[this.room.roomId];
+      const roomStatePolicy = unstableEvent?.getContent() ?? stableEvent?.getContent();
+      const content =
+      // * if the homeserver defines a specific retention policy for this room, then use this policy as the effective retention policy of the room.
+      serverRoomPolicy ??
+      // * otherwise, if the state of the room includes a `m.room.retention` event with an empty state key:
+      roomStatePolicy ??
+      // * otherwise, if the state of the room does not include a m.room.retention event with an empty state key:
+      serverPolicy?.policies?.["*"];
+      if (!content) {
+        // * otherwise, don't apply a retention policy in this room.
+        this.maxRetention = null;
+        return;
+      }
+      const validatePolicy = !serverRoomPolicy && roomStatePolicy;
+
+      // Parse it
+      let {
+        max_lifetime: maxLifetime
+      } = content;
+      if (!maxLifetime && validatePolicy) {
+        // if there is no value specified in the room's state, use the limit's min value for the effective retention policy of the room (which can be null or absent).
+        maxLifetime = serverPolicy?.limits?.max_lifetime?.min;
+        if (!maxLifetime) {
+          this.maxRetention = null;
+          return;
+        }
+      }
+      if (typeof maxLifetime !== "number") {
+        throw Error(`max_lifetime must be a number, got "${maxLifetime}"`);
+      }
+      if (maxLifetime < 0 || !Number.isInteger(maxLifetime)) {
+        throw Error(`max_lifetime must be >= 0, got ${maxLifetime}`);
+      }
+      this.maxRetention = maxLifetime;
+      if (validatePolicy && serverPolicy?.limits?.max_lifetime) {
+        // We're using room state so we need to validate this policy matches the server.
+        /**
+        if the value specified in the room's state complies with the limit, use this value for the effective retention policy of the room.
+        if the value specified in the room's state is lower than the limit's min value, use the min value for the effective retention policy of the room.
+        if the value specified in the room's state is greater than the limit's max value, use the max value for the effective retention policy of the room.
+        */
+        this.maxRetention = Math.max(this.maxRetention, serverPolicy.limits.max_lifetime.min ?? 0);
+        this.maxRetention = Math.min(this.maxRetention, serverPolicy.limits.max_lifetime.max ?? Number.MAX_SAFE_INTEGER);
+      }
+      this.processTimeline();
+    });
+    _defineProperty(this, "timelineUpdated", () => {
+      this.logger.info("timelineUpdated");
+      this.scheduleTimelineCheck(200);
+    });
+    _defineProperty(this, "scheduleTimelineCheck", nextTs => {
+      if (this.retentionTimeout) {
+        clearTimeout(this.retentionTimeout);
+      }
+      this.retentionTimeout = setTimeout(() => {
+        this.processTimeline();
+        this.retentionTimeout = undefined;
+      }, nextTs);
+    });
+    this.room = room;
+    this.retentionService = retentionService;
+    this.store = store;
+    this.logger = rootLogger.getChild(`RetentionPolicy ${room.roomId}`);
+
+    // Recalculate on room state update.
+    room.on(RoomStateEvent.Events, event => {
+      if (event.getStateKey() !== "" || event.getType() !== "org.matrix.msc1763.retention" && event.getType() !== "m.room.retention") {
+        return;
+      }
+      void this.handleRetentionUpdate();
+    });
+
+    // Recalculate our retention whenever the global policy changes.
+    this.retentionService.on("update", () => {
+      this.logger.info("Got global retention policy update!");
+      void this.handleRetentionUpdate();
+    });
+    // Do an initial check on construction.
+    void this.handleRetentionUpdate();
+
+    // Only bind RoomEvent.Timeline once we know we have a retention policy.
+  }
+  shouldEventBeRetained(ev) {
+    if (!this.maxRetention) {
+      return true;
+    }
+    const expireBefore = Date.now() - this.maxRetention;
+    return ev.getTs() > expireBefore;
+  }
+  processTimeline() {
+    if (!this.maxRetention) {
+      return; // No policy, skip.
+    }
+    this.logger.info(`Running processTimeline`);
+    const expireBefore = Date.now() - this.maxRetention;
+    const events = this.room.getLiveTimeline().getEvents().filter(ev => ev.getStateKey() === undefined && !ev.isRedacted() && ev.getType() !== "m.room.redaction");
+    const expiredEvents = events.filter(ev => ev.getTs() < expireBefore);
+    const [earliestExpiringEvent] = events.filter(ev => ev.getTs() >= expireBefore).sort((a, b) => a.getTs() - b.getTs());
+    if (earliestExpiringEvent) {
+      const nextTs = earliestExpiringEvent.getTs() + this.maxRetention - Date.now();
+      this.logger.info(`Next expiry scheduled for ${nextTs}`);
+      this.scheduleTimelineCheck(nextTs);
+    }
+    if (expiredEvents.length === 0) {
+      this.logger.info("Found no expired events");
+      return;
+    }
+    this.logger.info(`Found ${expiredEvents.length} expired events`);
+    for (const event of expiredEvents) {
+      this.room.tryApplyRedaction(new MatrixEvent({
+        type: EventType.RoomRedaction,
+        sender: event.getSender(),
+        event_id: "$synthetic_redaction",
+        room_id: this.room.roomId,
+        redacts: event.getId(),
+        content: {
+          reason: "Retention policy"
+        },
+        origin_server_ts: Date.now(),
+        unsigned: {}
+      }));
+    }
+    void this.store.removeEventsFromRoom(this.room.roomId, expiredEvents.map(e => e.getId())).catch(ex => {
+      this.logger.warn(`Failed to remove events from store`, ex);
+    });
+  }
+}
+//# sourceMappingURL=room-retention.js.map

package/node_modules/matrix-js-sdk/lib/models/room-retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-retention.js","names":[],"sources":["../../src/models/room-retention.ts"],"sourcesContent":["/*\nCopyright 2026 Element Creations Ltd.\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 { MatrixEvent } from \"../models/event.ts\";\nimport { RoomEvent, type Room } from \"./room.ts\";\nimport { RoomStateEvent, type RoomState } from \"./room-state.ts\";\nimport { type Logger, logger as rootLogger } from \"../logger.ts\";\nimport { EventType } from \"../@types/event.ts\";\nimport type { RetentionPolicyService } from \"../retentionPolicy.ts\";\nimport type { IStore } from \"../store/index.ts\";\nimport { ROOM_RETENTION_TYPE, type RoomRetentionContent } from \"../@types/retention.ts\";\n\n/**\n * Applies https://github.com/matrix-org/matrix-spec-proposals/pull/1763 by checking the current\n * state of the room and applying the *latest* retention policy to all preceeding events.\n * Currently does not:\n *   - Apply global server policies (requires Synapse work)\n *   - React at all to `min_retention` configs.\n *   - Loop\n */\nexport class RoomRetentionPolicy {\n    // minRetention is not implemented.\n    private maxRetention: number | null = null;\n    private retentionTimeout?: ReturnType<typeof setTimeout>;\n    private readonly logger: Logger;\n\n    public constructor(\n        private readonly room: Room,\n        private readonly retentionService: RetentionPolicyService,\n        private readonly store: IStore,\n    ) {\n        this.logger = rootLogger.getChild(`RetentionPolicy ${room.roomId}`);\n\n        // Recalculate on room state update.\n        room.on(RoomStateEvent.Events, (event) => {\n            if (\n                event.getStateKey() !== \"\" ||\n                (event.getType() !== \"org.matrix.msc1763.retention\" && event.getType() !== \"m.room.retention\")\n            ) {\n                return;\n            }\n            void this.handleRetentionUpdate();\n        });\n\n        // Recalculate our retention whenever the global policy changes.\n        this.retentionService.on(\"update\", () => {\n            this.logger.info(\"Got global retention policy update!\");\n            void this.handleRetentionUpdate();\n        });\n        // Do an initial check on construction.\n        void this.handleRetentionUpdate();\n\n        // Only bind RoomEvent.Timeline once we know we have a retention policy.\n    }\n\n    public shouldEventBeRetained(ev: MatrixEvent): boolean {\n        if (!this.maxRetention) {\n            return true;\n        }\n        const expireBefore = Date.now() - this.maxRetention;\n        return ev.getTs() > expireBefore;\n    }\n\n    private readonly handleRetentionUpdate = async (): Promise<void> => {\n        // First store if we currently have a retention period.\n        const hadRetentionPeriod = this.maxRetention !== null;\n\n        try {\n            await this.recalculateRetention(this.room.currentState);\n        } catch (err) {\n            this.logger.warn(\"Failed to recalculate retention policy\", err);\n            return;\n        }\n\n        // Bind/unbind the Timeline event handler based on whether we should be running retention.\n        if (hadRetentionPeriod !== (this.maxRetention !== null)) {\n            this.logger.info(\"retention recalculated to be\", this.maxRetention);\n            // We've changed\n            if (this.maxRetention) {\n                this.room.on(RoomEvent.Timeline, this.timelineUpdated);\n            } else {\n                this.room.off(RoomEvent.Timeline, this.timelineUpdated);\n            }\n        }\n    };\n\n    private readonly recalculateRetention = async (roomState: RoomState): Promise<void> => {\n        const unstableEvent = roomState.getStateEvents(ROOM_RETENTION_TYPE.name).find((e) => e.getStateKey() === \"\");\n        const stableEvent = roomState.getStateEvents(ROOM_RETENTION_TYPE.altName).find((e) => e.getStateKey() === \"\");\n\n        const serverPolicy = this.retentionService.getCached();\n\n        const serverRoomPolicy = serverPolicy?.policies?.[this.room.roomId];\n        const roomStatePolicy =\n            unstableEvent?.getContent<RoomRetentionContent>() ?? stableEvent?.getContent<RoomRetentionContent>();\n\n        const content =\n            // * if the homeserver defines a specific retention policy for this room, then use this policy as the effective retention policy of the room.\n            serverRoomPolicy ??\n            // * otherwise, if the state of the room includes a `m.room.retention` event with an empty state key:\n            roomStatePolicy ??\n            // * otherwise, if the state of the room does not include a m.room.retention event with an empty state key:\n            serverPolicy?.policies?.[\"*\"];\n\n        if (!content) {\n            // * otherwise, don't apply a retention policy in this room.\n            this.maxRetention = null;\n            return;\n        }\n\n        const validatePolicy = !serverRoomPolicy && roomStatePolicy;\n\n        // Parse it\n        let { max_lifetime: maxLifetime } = content;\n\n        if (!maxLifetime && validatePolicy) {\n            // if there is no value specified in the room's state, use the limit's min value for the effective retention policy of the room (which can be null or absent).\n            maxLifetime = serverPolicy?.limits?.max_lifetime?.min;\n            if (!maxLifetime) {\n                this.maxRetention = null;\n                return;\n            }\n        }\n\n        if (typeof maxLifetime !== \"number\") {\n            throw Error(`max_lifetime must be a number, got \"${maxLifetime}\"`);\n        }\n        if (maxLifetime < 0 || !Number.isInteger(maxLifetime)) {\n            throw Error(`max_lifetime must be >= 0, got ${maxLifetime}`);\n        }\n        this.maxRetention = maxLifetime;\n\n        if (validatePolicy && serverPolicy?.limits?.max_lifetime) {\n            // We're using room state so we need to validate this policy matches the server.\n            /**\n            if the value specified in the room's state complies with the limit, use this value for the effective retention policy of the room.\n            if the value specified in the room's state is lower than the limit's min value, use the min value for the effective retention policy of the room.\n            if the value specified in the room's state is greater than the limit's max value, use the max value for the effective retention policy of the room.\n            */\n            this.maxRetention = Math.max(this.maxRetention, serverPolicy.limits.max_lifetime.min ?? 0);\n            this.maxRetention = Math.min(\n                this.maxRetention,\n                serverPolicy.limits.max_lifetime.max ?? Number.MAX_SAFE_INTEGER,\n            );\n        }\n\n        this.processTimeline();\n    };\n\n    private readonly timelineUpdated = (): void => {\n        this.logger.info(\"timelineUpdated\");\n        this.scheduleTimelineCheck(200);\n    };\n\n    private readonly scheduleTimelineCheck = (nextTs: number): void => {\n        if (this.retentionTimeout) {\n            clearTimeout(this.retentionTimeout);\n        }\n        this.retentionTimeout = setTimeout(() => {\n            this.processTimeline();\n            this.retentionTimeout = undefined;\n        }, nextTs);\n    };\n\n    private processTimeline(): void {\n        if (!this.maxRetention) {\n            return; // No policy, skip.\n        }\n        this.logger.info(`Running processTimeline`);\n        const expireBefore = Date.now() - this.maxRetention;\n        const events = this.room\n            .getLiveTimeline()\n            .getEvents()\n            .filter((ev) => ev.getStateKey() === undefined && !ev.isRedacted() && ev.getType() !== \"m.room.redaction\");\n\n        const expiredEvents = events.filter((ev) => ev.getTs() < expireBefore);\n        const [earliestExpiringEvent] = events\n            .filter((ev) => ev.getTs() >= expireBefore)\n            .sort((a, b) => a.getTs() - b.getTs());\n\n        if (earliestExpiringEvent) {\n            const nextTs = earliestExpiringEvent.getTs() + this.maxRetention - Date.now();\n            this.logger.info(`Next expiry scheduled for ${nextTs}`);\n            this.scheduleTimelineCheck(nextTs);\n        }\n\n        if (expiredEvents.length === 0) {\n            this.logger.info(\"Found no expired events\");\n            return;\n        }\n        this.logger.info(`Found ${expiredEvents.length} expired events`);\n        for (const event of expiredEvents) {\n            this.room.tryApplyRedaction(\n                new MatrixEvent({\n                    type: EventType.RoomRedaction,\n                    sender: event.getSender(),\n                    event_id: \"$synthetic_redaction\",\n                    room_id: this.room.roomId,\n                    redacts: event.getId(),\n                    content: {\n                        reason: \"Retention policy\",\n                    },\n                    origin_server_ts: Date.now(),\n                    unsigned: {},\n                }),\n            );\n        }\n        void this.store\n            .removeEventsFromRoom(\n                this.room.roomId,\n                expiredEvents.map((e) => e.getId()!),\n            )\n            .catch((ex) => {\n                this.logger.warn(`Failed to remove events from store`, ex);\n            });\n    }\n}\n"],"mappings":"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","ignoreList":[]}