/* Copyright 2024 New Vector Ltd. Copyright 2022 The Matrix.org Foundation C.I.C. SPDX-License-Identifier: AGPL-3.0-only OR GPL-3.0-only Please see LICENSE files in the repository root for full details. */ import { SlidingSync } from "matrix-js-sdk/src/sliding-sync"; import { mocked } from "jest-mock"; import { MatrixClient, MatrixEvent, Room } from "matrix-js-sdk/src/matrix"; import fetchMockJest from "fetch-mock-jest"; import { SlidingSyncManager } from "../src/SlidingSyncManager"; import { stubClient } from "./test-utils"; import SlidingSyncController from "../src/settings/controllers/SlidingSyncController"; import SettingsStore from "../src/settings/SettingsStore"; jest.mock("matrix-js-sdk/src/sliding-sync"); const MockSlidingSync = >(SlidingSync); describe("SlidingSyncManager", () => { let manager: SlidingSyncManager; let slidingSync: SlidingSync; let client: MatrixClient; beforeEach(() => { slidingSync = new MockSlidingSync(); manager = new SlidingSyncManager(); client = stubClient(); // by default the client has no rooms: stubClient magically makes rooms annoyingly. mocked(client.getRoom).mockReturnValue(null); manager.configure(client, "invalid"); manager.slidingSync = slidingSync; fetchMockJest.reset(); fetchMockJest.get("https://proxy/client/server.json", {}); }); describe("setRoomVisible", () => { it("adds a subscription for the room", async () => { const roomId = "!room:id"; const subs = new Set(); mocked(slidingSync.getRoomSubscriptions).mockReturnValue(subs); mocked(slidingSync.modifyRoomSubscriptions).mockResolvedValue("yep"); await manager.setRoomVisible(roomId, true); expect(slidingSync.modifyRoomSubscriptions).toHaveBeenCalledWith(new Set([roomId])); }); it("adds a custom subscription for a lazy-loadable room", async () => { const roomId = "!lazy:id"; const room = new Room(roomId, client, client.getUserId()!); room.getLiveTimeline().initialiseState([ new MatrixEvent({ type: "m.room.create", state_key: "", event_id: "$abc123", sender: client.getUserId()!, content: { creator: client.getUserId()!, }, }), ]); mocked(client.getRoom).mockImplementation((r: string): Room | null => { if (roomId === r) { return room; } return null; }); const subs = new Set(); mocked(slidingSync.getRoomSubscriptions).mockReturnValue(subs); mocked(slidingSync.modifyRoomSubscriptions).mockResolvedValue("yep"); await manager.setRoomVisible(roomId, true); expect(slidingSync.modifyRoomSubscriptions).toHaveBeenCalledWith(new Set([roomId])); // we aren't prescriptive about what the sub name is. expect(slidingSync.useCustomSubscription).toHaveBeenCalledWith(roomId, expect.anything()); }); }); describe("ensureListRegistered", () => { it("creates a new list based on the key", async () => { const listKey = "key"; mocked(slidingSync.getListParams).mockReturnValue(null); mocked(slidingSync.setList).mockResolvedValue("yep"); await manager.ensureListRegistered(listKey, { sort: ["by_recency"], }); expect(slidingSync.setList).toHaveBeenCalledWith( listKey, expect.objectContaining({ sort: ["by_recency"], }), ); }); it("updates an existing list based on the key", async () => { const listKey = "key"; mocked(slidingSync.getListParams).mockReturnValue({ ranges: [[0, 42]], }); mocked(slidingSync.setList).mockResolvedValue("yep"); await manager.ensureListRegistered(listKey, { sort: ["by_recency"], }); expect(slidingSync.setList).toHaveBeenCalledWith( listKey, expect.objectContaining({ sort: ["by_recency"], ranges: [[0, 42]], }), ); }); it("updates ranges on an existing list based on the key if there's no other changes", async () => { const listKey = "key"; mocked(slidingSync.getListParams).mockReturnValue({ ranges: [[0, 42]], }); mocked(slidingSync.setList).mockResolvedValue("yep"); await manager.ensureListRegistered(listKey, { ranges: [[0, 52]], }); expect(slidingSync.setList).not.toHaveBeenCalled(); expect(slidingSync.setListRanges).toHaveBeenCalledWith(listKey, [[0, 52]]); }); it("no-ops for idential changes", async () => { const listKey = "key"; mocked(slidingSync.getListParams).mockReturnValue({ ranges: [[0, 42]], sort: ["by_recency"], }); mocked(slidingSync.setList).mockResolvedValue("yep"); await manager.ensureListRegistered(listKey, { ranges: [[0, 42]], sort: ["by_recency"], }); expect(slidingSync.setList).not.toHaveBeenCalled(); expect(slidingSync.setListRanges).not.toHaveBeenCalled(); }); }); describe("startSpidering", () => { it("requests in batchSizes", async () => { const gapMs = 1; const batchSize = 10; mocked(slidingSync.setList).mockResolvedValue("yep"); mocked(slidingSync.setListRanges).mockResolvedValue("yep"); mocked(slidingSync.getListData).mockImplementation((key) => { return { joinedCount: 64, roomIndexToRoomId: {}, }; }); await manager.startSpidering(batchSize, gapMs); // we expect calls for 10,19 -> 20,29 -> 30,39 -> 40,49 -> 50,59 -> 60,69 const wantWindows = [ [10, 19], [20, 29], [30, 39], [40, 49], [50, 59], [60, 69], ]; expect(slidingSync.getListData).toHaveBeenCalledTimes(wantWindows.length); expect(slidingSync.setList).toHaveBeenCalledTimes(1); expect(slidingSync.setListRanges).toHaveBeenCalledTimes(wantWindows.length - 1); wantWindows.forEach((range, i) => { if (i === 0) { // eslint-disable-next-line jest/no-conditional-expect expect(slidingSync.setList).toHaveBeenCalledWith( SlidingSyncManager.ListSearch, // eslint-disable-next-line jest/no-conditional-expect expect.objectContaining({ ranges: [[0, batchSize - 1], range], }), ); return; } expect(slidingSync.setListRanges).toHaveBeenCalledWith(SlidingSyncManager.ListSearch, [ [0, batchSize - 1], range, ]); }); }); it("handles accounts with zero rooms", async () => { const gapMs = 1; const batchSize = 10; mocked(slidingSync.setList).mockResolvedValue("yep"); mocked(slidingSync.getListData).mockImplementation((key) => { return { joinedCount: 0, roomIndexToRoomId: {}, }; }); await manager.startSpidering(batchSize, gapMs); expect(slidingSync.getListData).toHaveBeenCalledTimes(1); expect(slidingSync.setList).toHaveBeenCalledTimes(1); expect(slidingSync.setList).toHaveBeenCalledWith( SlidingSyncManager.ListSearch, expect.objectContaining({ ranges: [ [0, batchSize - 1], [batchSize, batchSize + batchSize - 1], ], }), ); }); it("continues even when setList rejects", async () => { const gapMs = 1; const batchSize = 10; mocked(slidingSync.setList).mockRejectedValue("narp"); mocked(slidingSync.getListData).mockImplementation((key) => { return { joinedCount: 0, roomIndexToRoomId: {}, }; }); await manager.startSpidering(batchSize, gapMs); expect(slidingSync.getListData).toHaveBeenCalledTimes(1); expect(slidingSync.setList).toHaveBeenCalledTimes(1); expect(slidingSync.setList).toHaveBeenCalledWith( SlidingSyncManager.ListSearch, expect.objectContaining({ ranges: [ [0, batchSize - 1], [batchSize, batchSize + batchSize - 1], ], }), ); }); }); describe("checkSupport", () => { beforeEach(() => { SlidingSyncController.serverSupportsSlidingSync = false; jest.spyOn(manager, "getProxyFromWellKnown").mockResolvedValue("https://proxy/"); }); it("shorts out if the server has 'native' sliding sync support", async () => { jest.spyOn(manager, "nativeSlidingSyncSupport").mockResolvedValue(true); expect(SlidingSyncController.serverSupportsSlidingSync).toBeFalsy(); await manager.checkSupport(client); expect(manager.getProxyFromWellKnown).not.toHaveBeenCalled(); // We return earlier expect(SlidingSyncController.serverSupportsSlidingSync).toBeTruthy(); }); it("tries to find a sliding sync proxy url from the client well-known if there's no 'native' support", async () => { jest.spyOn(manager, "nativeSlidingSyncSupport").mockResolvedValue(false); expect(SlidingSyncController.serverSupportsSlidingSync).toBeFalsy(); await manager.checkSupport(client); expect(manager.getProxyFromWellKnown).toHaveBeenCalled(); expect(SlidingSyncController.serverSupportsSlidingSync).toBeTruthy(); }); it("should query well-known on server_name not baseUrl", async () => { fetchMockJest.get("https://matrix.org/.well-known/matrix/client", { "m.homeserver": { base_url: "https://matrix-client.matrix.org", server: "matrix.org", }, "org.matrix.msc3575.proxy": { url: "https://proxy/", }, }); fetchMockJest.get("https://matrix-client.matrix.org/_matrix/client/versions", { versions: ["v1.4"] }); mocked(manager.getProxyFromWellKnown).mockRestore(); jest.spyOn(manager, "nativeSlidingSyncSupport").mockResolvedValue(false); expect(SlidingSyncController.serverSupportsSlidingSync).toBeFalsy(); await manager.checkSupport(client); expect(SlidingSyncController.serverSupportsSlidingSync).toBeTruthy(); expect(fetchMockJest).not.toHaveFetched("https://matrix-client.matrix.org/.well-known/matrix/client"); }); }); describe("nativeSlidingSyncSupport", () => { beforeEach(() => { SlidingSyncController.serverSupportsSlidingSync = false; }); it("should make an OPTIONS request to avoid unintended side effects", async () => { // See https://github.com/element-hq/element-web/issues/27426 const unstableSpy = jest .spyOn(client, "doesServerSupportUnstableFeature") .mockImplementation(async (feature: string) => { expect(feature).toBe("org.matrix.msc3575"); return true; }); const proxySpy = jest.spyOn(manager, "getProxyFromWellKnown").mockResolvedValue("https://proxy/"); expect(SlidingSyncController.serverSupportsSlidingSync).toBeFalsy(); await manager.checkSupport(client); // first thing it does is call nativeSlidingSyncSupport expect(proxySpy).not.toHaveBeenCalled(); expect(unstableSpy).toHaveBeenCalled(); expect(SlidingSyncController.serverSupportsSlidingSync).toBeTruthy(); }); }); describe("setup", () => { beforeEach(() => { jest.spyOn(manager, "configure"); jest.spyOn(manager, "startSpidering"); }); it("uses the baseUrl as a proxy if no proxy is set in the client well-known and the server has no native support", async () => { await manager.setup(client); expect(manager.configure).toHaveBeenCalled(); expect(manager.configure).toHaveBeenCalledWith(client, client.baseUrl); expect(manager.startSpidering).toHaveBeenCalled(); }); it("uses the proxy declared in the client well-known", async () => { jest.spyOn(manager, "getProxyFromWellKnown").mockResolvedValue("https://proxy/"); await manager.setup(client); expect(manager.configure).toHaveBeenCalled(); expect(manager.configure).toHaveBeenCalledWith(client, "https://proxy/"); expect(manager.startSpidering).toHaveBeenCalled(); }); it("uses the legacy `feature_sliding_sync_proxy_url` if it was set", async () => { jest.spyOn(manager, "getProxyFromWellKnown").mockResolvedValue("https://proxy/"); jest.spyOn(SettingsStore, "getValue").mockImplementation((name: string) => { if (name === "feature_sliding_sync_proxy_url") return "legacy-proxy"; }); await manager.setup(client); expect(manager.configure).toHaveBeenCalled(); expect(manager.configure).toHaveBeenCalledWith(client, "legacy-proxy"); expect(manager.startSpidering).toHaveBeenCalled(); }); }); });