e946674df3
* Add Stores and StoresContext and use it in MatrixChat and RoomView Added a new kind of class: - Add God object `Stores` which will hold refs to all known stores and the `MatrixClient`. This object is NOT a singleton. - Add `StoresContext` to hold onto a ref of `Stores` for use inside components. `StoresContext` is created via: - Create `Stores` in `MatrixChat`, assigning the `MatrixClient` when we have one set. Currently sets the RVS to `RoomViewStore.instance`. - Wrap `MatrixChat`s `render()` function in a `StoresContext.Provider` so it can be used anywhere. `StoresContext` is currently only used in `RoomView` via the following changes: - Remove the HOC, which redundantly set `mxClient` as a prop. We don't need this as `RoomView` was using the client from `this.context`. - Change the type of context accepted from `MatrixClientContext` to `StoresContext`. - Modify alllll the places where `this.context` is used to interact with the client and suffix `.client`. - Modify places where we use `RoomViewStore.instance` and replace them with `this.context.roomViewStore`. This makes `RoomView` use a non-global instance of RVS. * Linting * SDKContext and make client an optional constructor arg * Move SDKContext to /src/contexts * Inject all RVS deps * Linting * Remove reset calls; deep copy the INITIAL_STATE to avoid test pollution * DI singletons used in RoomView; DI them in RoomView-test too * Initial RoomViewStore.instance after all files are imported to avoid cyclical deps * Lazily init stores to allow for circular dependencies Rather than stores accepting a list of other stores in their constructors, which doesn't work when A needs B and B needs A, make new-style stores simply accept Stores. When a store needs another store, they access it via `Stores` which then lazily constructs that store if it needs it. This breaks the circular dependency at constructor time, without needing to introduce wiring diagrams or any complex DI framework. * Delete RoomViewStore.instance Replaced with Stores.instance.roomViewStore * Linting * Move OverridableStores to test/TestStores * Rejig how eager stores get made; don't automatically do it else tests break * Linting * Linting and review comments * Fix new code to use Stores.instance * s/Stores/SdkContextClass/g * Update docs * Remove unused imports * Update src/stores/RoomViewStore.tsx Co-authored-by: Michael Telatynski <7t3chguy@gmail.com> * Remove empty c'tor to make sonar happy Co-authored-by: Michael Telatynski <7t3chguy@gmail.com>
274 lines
11 KiB
TypeScript
274 lines
11 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 { SdkContextClass } from "../../../src/contexts/SDKContext";
|
|
import { MatrixClientPeg } from "../../../src/MatrixClientPeg";
|
|
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(SdkContextClass.instance.roomViewStore, 'getRoomId').mockReturnValue('!this-room-id');
|
|
|
|
client.relations.mockResolvedValue({
|
|
originalEvent: new MatrixEvent(),
|
|
events: [],
|
|
});
|
|
|
|
await expect(driver.readEventRelations('$event')).resolves.toEqual({
|
|
chunk: [],
|
|
nextBatch: undefined,
|
|
prevBatch: undefined,
|
|
});
|
|
|
|
expect(client.relations).toBeCalledWith('!this-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({
|
|
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({
|
|
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',
|
|
dir: Direction.Forward,
|
|
},
|
|
);
|
|
});
|
|
});
|
|
});
|