2020-08-14 12:27:12 +00:00
|
|
|
/*
|
|
|
|
Copyright 2020 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.
|
|
|
|
*/
|
|
|
|
|
2023-08-09 07:18:41 +00:00
|
|
|
import { IClientWellKnown, MatrixClient } from "matrix-js-sdk/src/matrix";
|
2022-01-27 09:51:06 +00:00
|
|
|
import { UnstableValue } from "matrix-js-sdk/src/NamespacedValue";
|
|
|
|
|
2021-01-29 14:26:33 +00:00
|
|
|
const CALL_BEHAVIOUR_WK_KEY = "io.element.call_behaviour";
|
2020-08-24 15:33:23 +00:00
|
|
|
const E2EE_WK_KEY = "io.element.e2ee";
|
2020-08-14 12:27:12 +00:00
|
|
|
const E2EE_WK_KEY_DEPRECATED = "im.vector.riot.e2ee";
|
2022-04-14 13:14:05 +00:00
|
|
|
export const TILE_SERVER_WK_KEY = new UnstableValue("m.tile_server", "org.matrix.msc3488.tile_server");
|
2022-05-30 19:01:55 +00:00
|
|
|
const EMBEDDED_PAGES_WK_PROPERTY = "io.element.embedded_pages";
|
2020-08-14 12:27:12 +00:00
|
|
|
|
2020-09-22 14:22:39 +00:00
|
|
|
/* eslint-disable camelcase */
|
2021-01-29 14:26:33 +00:00
|
|
|
export interface ICallBehaviourWellKnown {
|
|
|
|
widget_build_url?: string;
|
2023-06-06 14:07:51 +00:00
|
|
|
ignore_dm?: boolean;
|
2021-01-29 14:26:33 +00:00
|
|
|
}
|
|
|
|
|
2020-08-14 12:27:12 +00:00
|
|
|
export interface IE2EEWellKnown {
|
|
|
|
default?: boolean;
|
2023-06-21 21:50:01 +00:00
|
|
|
/**
|
|
|
|
* Forces the encryption to disabled for all new rooms
|
|
|
|
* When true, overrides configured 'default' behaviour
|
|
|
|
* Hides the option to enable encryption on room creation
|
|
|
|
* Disables the option to enable encryption in room settings for all new and existing rooms
|
|
|
|
*/
|
|
|
|
force_disable?: boolean;
|
2020-09-22 14:22:39 +00:00
|
|
|
secure_backup_required?: boolean;
|
|
|
|
secure_backup_setup_methods?: SecureBackupSetupMethod[];
|
2020-08-14 12:27:12 +00:00
|
|
|
}
|
2022-01-27 09:51:06 +00:00
|
|
|
|
|
|
|
export interface ITileServerWellKnown {
|
|
|
|
map_style_url?: string;
|
|
|
|
}
|
2022-05-30 19:01:55 +00:00
|
|
|
|
|
|
|
export interface IEmbeddedPagesWellKnown {
|
|
|
|
home_url?: string;
|
|
|
|
}
|
2020-09-22 14:22:39 +00:00
|
|
|
/* eslint-enable camelcase */
|
2020-08-14 12:27:12 +00:00
|
|
|
|
2023-05-23 15:24:12 +00:00
|
|
|
export function getCallBehaviourWellKnown(matrixClient: MatrixClient): ICallBehaviourWellKnown {
|
|
|
|
const clientWellKnown = matrixClient.getClientWellKnown();
|
2021-01-29 14:26:33 +00:00
|
|
|
return clientWellKnown?.[CALL_BEHAVIOUR_WK_KEY];
|
|
|
|
}
|
|
|
|
|
2023-05-23 15:24:12 +00:00
|
|
|
export function getE2EEWellKnown(matrixClient: MatrixClient): IE2EEWellKnown | null {
|
|
|
|
const clientWellKnown = matrixClient.getClientWellKnown();
|
2023-02-13 17:01:43 +00:00
|
|
|
if (clientWellKnown?.[E2EE_WK_KEY]) {
|
2020-08-14 12:27:12 +00:00
|
|
|
return clientWellKnown[E2EE_WK_KEY];
|
|
|
|
}
|
2023-02-13 17:01:43 +00:00
|
|
|
if (clientWellKnown?.[E2EE_WK_KEY_DEPRECATED]) {
|
2021-06-29 12:11:58 +00:00
|
|
|
return clientWellKnown[E2EE_WK_KEY_DEPRECATED];
|
2020-08-14 12:27:12 +00:00
|
|
|
}
|
|
|
|
return null;
|
|
|
|
}
|
2020-08-14 17:06:35 +00:00
|
|
|
|
2023-05-23 15:24:12 +00:00
|
|
|
export function getTileServerWellKnown(matrixClient: MatrixClient): ITileServerWellKnown | undefined {
|
|
|
|
return tileServerFromWellKnown(matrixClient.getClientWellKnown());
|
2022-01-27 09:51:06 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
export function tileServerFromWellKnown(clientWellKnown?: IClientWellKnown | undefined): ITileServerWellKnown {
|
|
|
|
return clientWellKnown?.[TILE_SERVER_WK_KEY.name] ?? clientWellKnown?.[TILE_SERVER_WK_KEY.altName];
|
|
|
|
}
|
|
|
|
|
2023-05-23 15:24:12 +00:00
|
|
|
export function getEmbeddedPagesWellKnown(matrixClient: MatrixClient | undefined): IEmbeddedPagesWellKnown | undefined {
|
|
|
|
return embeddedPagesFromWellKnown(matrixClient?.getClientWellKnown());
|
2022-05-30 19:01:55 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
export function embeddedPagesFromWellKnown(clientWellKnown?: IClientWellKnown): IEmbeddedPagesWellKnown {
|
|
|
|
return clientWellKnown?.[EMBEDDED_PAGES_WK_PROPERTY];
|
|
|
|
}
|
|
|
|
|
2023-05-23 15:24:12 +00:00
|
|
|
export function isSecureBackupRequired(matrixClient: MatrixClient): boolean {
|
|
|
|
return getE2EEWellKnown(matrixClient)?.["secure_backup_required"] === true;
|
2020-08-14 17:06:35 +00:00
|
|
|
}
|
2020-09-21 14:48:47 +00:00
|
|
|
|
2020-09-22 14:22:39 +00:00
|
|
|
export enum SecureBackupSetupMethod {
|
|
|
|
Key = "key",
|
|
|
|
Passphrase = "passphrase",
|
|
|
|
}
|
|
|
|
|
2023-05-23 15:24:12 +00:00
|
|
|
export function getSecureBackupSetupMethods(matrixClient: MatrixClient): SecureBackupSetupMethod[] {
|
|
|
|
const wellKnown = getE2EEWellKnown(matrixClient);
|
2020-09-21 14:48:47 +00:00
|
|
|
if (
|
|
|
|
!wellKnown ||
|
|
|
|
!wellKnown["secure_backup_setup_methods"] ||
|
|
|
|
!wellKnown["secure_backup_setup_methods"].length ||
|
|
|
|
!(
|
2020-09-22 14:22:39 +00:00
|
|
|
wellKnown["secure_backup_setup_methods"].includes(SecureBackupSetupMethod.Key) ||
|
|
|
|
wellKnown["secure_backup_setup_methods"].includes(SecureBackupSetupMethod.Passphrase)
|
2020-09-21 14:48:47 +00:00
|
|
|
)
|
|
|
|
) {
|
2020-09-22 14:22:39 +00:00
|
|
|
return [SecureBackupSetupMethod.Key, SecureBackupSetupMethod.Passphrase];
|
2020-09-21 14:48:47 +00:00
|
|
|
}
|
|
|
|
return wellKnown["secure_backup_setup_methods"];
|
|
|
|
}
|