296 lines
		
	
	
		
			12 KiB
		
	
	
	
		
			TypeScript
		
	
	
			
		
		
	
	
			296 lines
		
	
	
		
			12 KiB
		
	
	
	
		
			TypeScript
		
	
	
| /*
 | |
| 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 { mocked, MockedObject } from "jest-mock";
 | |
| import { MatrixClient, ClientEvent, ITurnServer as IClientTurnServer } from "matrix-js-sdk/src/client";
 | |
| import { DeviceInfo } from "matrix-js-sdk/src/crypto/deviceinfo";
 | |
| import { Direction, MatrixEvent } from "matrix-js-sdk/src/matrix";
 | |
| import { Widget, MatrixWidgetType, WidgetKind, WidgetDriver, ITurnServer } from "matrix-widget-api";
 | |
| 
 | |
| import { MatrixClientPeg } from "../../../src/MatrixClientPeg";
 | |
| import { RoomViewStore } from "../../../src/stores/RoomViewStore";
 | |
| import { StopGapWidgetDriver } from "../../../src/stores/widgets/StopGapWidgetDriver";
 | |
| import { stubClient } from "../../test-utils";
 | |
| 
 | |
| describe("StopGapWidgetDriver", () => {
 | |
|     let client: MockedObject<MatrixClient>;
 | |
| 
 | |
|     const mkDefaultDriver = (): WidgetDriver => new StopGapWidgetDriver(
 | |
|         [],
 | |
|         new Widget({
 | |
|             id: "test",
 | |
|             creatorUserId: "@alice:example.org",
 | |
|             type: "example",
 | |
|             url: "https://example.org",
 | |
|         }),
 | |
|         WidgetKind.Room,
 | |
|         false,
 | |
|         "!1:example.org",
 | |
|     );
 | |
| 
 | |
|     beforeEach(() => {
 | |
|         stubClient();
 | |
|         client = mocked(MatrixClientPeg.get());
 | |
|         client.getUserId.mockReturnValue("@alice:example.org");
 | |
|     });
 | |
| 
 | |
|     it("auto-approves capabilities of virtual Element Call widgets", async () => {
 | |
|         const driver = new StopGapWidgetDriver(
 | |
|             [],
 | |
|             new Widget({
 | |
|                 id: "group_call",
 | |
|                 creatorUserId: "@alice:example.org",
 | |
|                 type: MatrixWidgetType.Custom,
 | |
|                 url: "https://call.element.io",
 | |
|             }),
 | |
|             WidgetKind.Room,
 | |
|             true,
 | |
|             "!1:example.org",
 | |
|         );
 | |
| 
 | |
|         // These are intentionally raw identifiers rather than constants, so it's obvious what's being requested
 | |
|         const requestedCapabilities = new Set([
 | |
|             "m.always_on_screen",
 | |
|             "town.robin.msc3846.turn_servers",
 | |
|             "org.matrix.msc2762.timeline:!1:example.org",
 | |
|             "org.matrix.msc2762.receive.state_event:m.room.member",
 | |
|             "org.matrix.msc2762.send.state_event:org.matrix.msc3401.call",
 | |
|             "org.matrix.msc2762.receive.state_event:org.matrix.msc3401.call",
 | |
|             "org.matrix.msc2762.send.state_event:org.matrix.msc3401.call.member#@alice:example.org",
 | |
|             "org.matrix.msc2762.receive.state_event:org.matrix.msc3401.call.member",
 | |
|             "org.matrix.msc3819.send.to_device:m.call.invite",
 | |
|             "org.matrix.msc3819.receive.to_device:m.call.invite",
 | |
|             "org.matrix.msc3819.send.to_device:m.call.candidates",
 | |
|             "org.matrix.msc3819.receive.to_device:m.call.candidates",
 | |
|             "org.matrix.msc3819.send.to_device:m.call.answer",
 | |
|             "org.matrix.msc3819.receive.to_device:m.call.answer",
 | |
|             "org.matrix.msc3819.send.to_device:m.call.hangup",
 | |
|             "org.matrix.msc3819.receive.to_device:m.call.hangup",
 | |
|             "org.matrix.msc3819.send.to_device:m.call.reject",
 | |
|             "org.matrix.msc3819.receive.to_device:m.call.reject",
 | |
|             "org.matrix.msc3819.send.to_device:m.call.select_answer",
 | |
|             "org.matrix.msc3819.receive.to_device:m.call.select_answer",
 | |
|             "org.matrix.msc3819.send.to_device:m.call.negotiate",
 | |
|             "org.matrix.msc3819.receive.to_device:m.call.negotiate",
 | |
|             "org.matrix.msc3819.send.to_device:m.call.sdp_stream_metadata_changed",
 | |
|             "org.matrix.msc3819.receive.to_device:m.call.sdp_stream_metadata_changed",
 | |
|             "org.matrix.msc3819.send.to_device:org.matrix.call.sdp_stream_metadata_changed",
 | |
|             "org.matrix.msc3819.receive.to_device:org.matrix.call.sdp_stream_metadata_changed",
 | |
|             "org.matrix.msc3819.send.to_device:m.call.replaces",
 | |
|             "org.matrix.msc3819.receive.to_device:m.call.replaces",
 | |
|         ]);
 | |
| 
 | |
|         // As long as this resolves, we'll know that it didn't try to pop up a modal
 | |
|         const approvedCapabilities = await driver.validateCapabilities(requestedCapabilities);
 | |
|         expect(approvedCapabilities).toEqual(requestedCapabilities);
 | |
|     });
 | |
| 
 | |
|     describe("sendToDevice", () => {
 | |
|         const contentMap = {
 | |
|             "@alice:example.org": {
 | |
|                 "*": {
 | |
|                     hello: "alice",
 | |
|                 },
 | |
|             },
 | |
|             "@bob:example.org": {
 | |
|                 "bobDesktop": {
 | |
|                     hello: "bob",
 | |
|                 },
 | |
|             },
 | |
|         };
 | |
| 
 | |
|         let driver: WidgetDriver;
 | |
| 
 | |
|         beforeEach(() => { driver = mkDefaultDriver(); });
 | |
| 
 | |
|         it("sends unencrypted messages", async () => {
 | |
|             await driver.sendToDevice("org.example.foo", false, contentMap);
 | |
|             expect(client.queueToDevice.mock.calls).toMatchSnapshot();
 | |
|         });
 | |
| 
 | |
|         it("sends encrypted messages", async () => {
 | |
|             const aliceWeb = new DeviceInfo("aliceWeb");
 | |
|             const aliceMobile = new DeviceInfo("aliceMobile");
 | |
|             const bobDesktop = new DeviceInfo("bobDesktop");
 | |
| 
 | |
|             mocked(client.crypto.deviceList).downloadKeys.mockResolvedValue({
 | |
|                 "@alice:example.org": { aliceWeb, aliceMobile },
 | |
|                 "@bob:example.org": { bobDesktop },
 | |
|             });
 | |
| 
 | |
|             await driver.sendToDevice("org.example.foo", true, contentMap);
 | |
|             expect(client.encryptAndSendToDevices.mock.calls).toMatchSnapshot();
 | |
|         });
 | |
|     });
 | |
| 
 | |
|     describe("getTurnServers", () => {
 | |
|         let driver: WidgetDriver;
 | |
| 
 | |
|         beforeEach(() => { driver = mkDefaultDriver(); });
 | |
| 
 | |
|         it("stops if VoIP isn't supported", async () => {
 | |
|             jest.spyOn(client, "pollingTurnServers", "get").mockReturnValue(false);
 | |
|             const servers = driver.getTurnServers();
 | |
|             expect(await servers.next()).toEqual({ value: undefined, done: true });
 | |
|         });
 | |
| 
 | |
|         it("stops if the homeserver provides no TURN servers", async () => {
 | |
|             const servers = driver.getTurnServers();
 | |
|             expect(await servers.next()).toEqual({ value: undefined, done: true });
 | |
|         });
 | |
| 
 | |
|         it("gets TURN servers", async () => {
 | |
|             const server1: ITurnServer = {
 | |
|                 uris: [
 | |
|                     "turn:turn.example.com:3478?transport=udp",
 | |
|                     "turn:10.20.30.40:3478?transport=tcp",
 | |
|                     "turns:10.20.30.40:443?transport=tcp",
 | |
|                 ],
 | |
|                 username: "1443779631:@user:example.com",
 | |
|                 password: "JlKfBy1QwLrO20385QyAtEyIv0=",
 | |
|             };
 | |
|             const server2: ITurnServer = {
 | |
|                 uris: [
 | |
|                     "turn:turn.example.com:3478?transport=udp",
 | |
|                     "turn:10.20.30.40:3478?transport=tcp",
 | |
|                     "turns:10.20.30.40:443?transport=tcp",
 | |
|                 ],
 | |
|                 username: "1448999322:@user:example.com",
 | |
|                 password: "hunter2",
 | |
|             };
 | |
|             const clientServer1: IClientTurnServer = {
 | |
|                 urls: server1.uris,
 | |
|                 username: server1.username,
 | |
|                 credential: server1.password,
 | |
|             };
 | |
|             const clientServer2: IClientTurnServer = {
 | |
|                 urls: server2.uris,
 | |
|                 username: server2.username,
 | |
|                 credential: server2.password,
 | |
|             };
 | |
| 
 | |
|             client.getTurnServers.mockReturnValue([clientServer1]);
 | |
|             const servers = driver.getTurnServers();
 | |
|             expect(await servers.next()).toEqual({ value: server1, done: false });
 | |
| 
 | |
|             const nextServer = servers.next();
 | |
|             client.getTurnServers.mockReturnValue([clientServer2]);
 | |
|             client.emit(ClientEvent.TurnServers, [clientServer2]);
 | |
|             expect(await nextServer).toEqual({ value: server2, done: false });
 | |
| 
 | |
|             await servers.return(undefined);
 | |
|         });
 | |
|     });
 | |
| 
 | |
|     describe("readEventRelations", () => {
 | |
|         let driver: WidgetDriver;
 | |
| 
 | |
|         beforeEach(() => { driver = mkDefaultDriver(); });
 | |
| 
 | |
|         it('reads related events from the current room', async () => {
 | |
|             jest.spyOn(RoomViewStore.instance, 'getRoomId').mockReturnValue('!this-room-id');
 | |
| 
 | |
|             client.relations.mockResolvedValue({
 | |
|                 originalEvent: new MatrixEvent(),
 | |
|                 events: [],
 | |
|             });
 | |
| 
 | |
|             await expect(driver.readEventRelations('$event')).resolves.toEqual({
 | |
|                 originalEvent: expect.objectContaining({ content: {} }),
 | |
|                 chunk: [],
 | |
|                 nextBatch: undefined,
 | |
|                 prevBatch: undefined,
 | |
|             });
 | |
| 
 | |
|             expect(client.relations).toBeCalledWith('!this-room-id', '$event', null, null, {});
 | |
|         });
 | |
| 
 | |
|         it('reads related events if the original event is missing', async () => {
 | |
|             client.relations.mockResolvedValue({
 | |
|                 // the relations function can return an undefined event, even
 | |
|                 // though the typings don't permit an undefined value.
 | |
|                 originalEvent: undefined as any,
 | |
|                 events: [],
 | |
|             });
 | |
| 
 | |
|             await expect(driver.readEventRelations('$event', '!room-id')).resolves.toEqual({
 | |
|                 originalEvent: undefined,
 | |
|                 chunk: [],
 | |
|                 nextBatch: undefined,
 | |
|                 prevBatch: undefined,
 | |
|             });
 | |
| 
 | |
|             expect(client.relations).toBeCalledWith('!room-id', '$event', null, null, {});
 | |
|         });
 | |
| 
 | |
|         it('reads related events from a selected room', async () => {
 | |
|             client.relations.mockResolvedValue({
 | |
|                 originalEvent: new MatrixEvent(),
 | |
|                 events: [new MatrixEvent(), new MatrixEvent()],
 | |
|                 nextBatch: 'next-batch-token',
 | |
|             });
 | |
| 
 | |
|             await expect(driver.readEventRelations('$event', '!room-id')).resolves.toEqual({
 | |
|                 originalEvent: expect.objectContaining({ content: {} }),
 | |
|                 chunk: [
 | |
|                     expect.objectContaining({ content: {} }),
 | |
|                     expect.objectContaining({ content: {} }),
 | |
|                 ],
 | |
|                 nextBatch: 'next-batch-token',
 | |
|                 prevBatch: undefined,
 | |
|             });
 | |
| 
 | |
|             expect(client.relations).toBeCalledWith('!room-id', '$event', null, null, {});
 | |
|         });
 | |
| 
 | |
|         it('reads related events with custom parameters', async () => {
 | |
|             client.relations.mockResolvedValue({
 | |
|                 originalEvent: new MatrixEvent(),
 | |
|                 events: [],
 | |
|             });
 | |
| 
 | |
|             await expect(driver.readEventRelations(
 | |
|                 '$event',
 | |
|                 '!room-id',
 | |
|                 'm.reference',
 | |
|                 'm.room.message',
 | |
|                 'from-token',
 | |
|                 'to-token',
 | |
|                 25,
 | |
|                 'f',
 | |
|             )).resolves.toEqual({
 | |
|                 originalEvent: expect.objectContaining({ content: {} }),
 | |
|                 chunk: [],
 | |
|                 nextBatch: undefined,
 | |
|                 prevBatch: undefined,
 | |
|             });
 | |
| 
 | |
|             expect(client.relations).toBeCalledWith(
 | |
|                 '!room-id',
 | |
|                 '$event',
 | |
|                 'm.reference',
 | |
|                 'm.room.message',
 | |
|                 {
 | |
|                     limit: 25,
 | |
|                     from: 'from-token',
 | |
|                     to: 'to-token',
 | |
|                     direction: Direction.Forward,
 | |
|                 },
 | |
|             );
 | |
|         });
 | |
|     });
 | |
| });
 |