imterah/element-portable
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Convert SettingsStore to TS

Browse source
This commit is contained in:
Travis Ralston 2020-07-29 10:57:14 -06:00
parent 51968a8072
commit 9d124ff09b
3 changed files with 107 additions and 71 deletions
Download patch file Download diff file Expand all files Collapse all files

2
src/@types/global.d.ts vendored
View file

@ -25,6 +25,7 @@ import { PlatformPeg } from "../PlatformPeg";
import RoomListLayoutStore from "../stores/room-list/RoomListLayoutStore"; import RoomListLayoutStore from "../stores/room-list/RoomListLayoutStore";
import {IntegrationManagers} from "../integrations/IntegrationManagers"; import {IntegrationManagers} from "../integrations/IntegrationManagers";
import {ModalManager} from "../Modal"; import {ModalManager} from "../Modal";
import SettingsStore from "../settings/SettingsStore";
declare global { declare global {
interface Window { interface Window {
@ -43,6 +44,7 @@ declare global {
mxPlatformPeg: PlatformPeg; mxPlatformPeg: PlatformPeg;
mxIntegrationManagers: typeof IntegrationManagers; mxIntegrationManagers: typeof IntegrationManagers;
singletonModalManager: ModalManager; singletonModalManager: ModalManager;
mxSettingsStore: SettingsStore;
} }
// workaround for https://github.com/microsoft/TypeScript/issues/30933 // workaround for https://github.com/microsoft/TypeScript/issues/30933

2
src/settings/Settings.ts
View file

@ -71,7 +71,7 @@ const LEVELS_DEVICE_ONLY_SETTINGS_WITH_CONFIG = [
SettingLevel.CONFIG, SettingLevel.CONFIG,
]; ];
interface ISetting { export interface ISetting {
// Must be set to true for features. Default is 'false'. // Must be set to true for features. Default is 'false'.
isFeature?: boolean; isFeature?: boolean;

174
src/settings/SettingsStore.js → src/settings/SettingsStore.ts
View file

@ -1,6 +1,6 @@
/* /*
Copyright 2017 Travis Ralston Copyright 2017 Travis Ralston
Copyright 2019 New Vector Ltd. Copyright 2019, 2020 The Matrix.org Foundation C.I.C.
Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
@ -22,12 +22,14 @@ import RoomAccountSettingsHandler from "./handlers/RoomAccountSettingsHandler";
import AccountSettingsHandler from "./handlers/AccountSettingsHandler"; import AccountSettingsHandler from "./handlers/AccountSettingsHandler";
import RoomSettingsHandler from "./handlers/RoomSettingsHandler"; import RoomSettingsHandler from "./handlers/RoomSettingsHandler";
import ConfigSettingsHandler from "./handlers/ConfigSettingsHandler"; import ConfigSettingsHandler from "./handlers/ConfigSettingsHandler";
import {_t} from '../languageHandler'; import { _t } from '../languageHandler';
import SdkConfig from "../SdkConfig"; import SdkConfig from "../SdkConfig";
import dis from '../dispatcher/dispatcher'; import dis from '../dispatcher/dispatcher';
import {SETTINGS} from "./Settings"; import { ISetting, SETTINGS } from "./Settings";
import LocalEchoWrapper from "./handlers/LocalEchoWrapper"; import LocalEchoWrapper from "./handlers/LocalEchoWrapper";
import {WatchManager} from "./WatchManager"; import { WatchManager } from "./WatchManager";
import { SettingLevel } from "./SettingLevel";
import SettingsHandler from "./handlers/SettingsHandler";
const defaultWatchManager = new WatchManager(); const defaultWatchManager = new WatchManager();
@ -46,13 +48,13 @@ for (const key of Object.keys(SETTINGS)) {
} }
const LEVEL_HANDLERS = { const LEVEL_HANDLERS = {
"device": new DeviceSettingsHandler(featureNames, defaultWatchManager), [SettingLevel.DEVICE]: new DeviceSettingsHandler(featureNames, defaultWatchManager),
"room-device": new RoomDeviceSettingsHandler(defaultWatchManager), [SettingLevel.ROOM_DEVICE]: new RoomDeviceSettingsHandler(defaultWatchManager),
"room-account": new RoomAccountSettingsHandler(defaultWatchManager), [SettingLevel.ROOM_ACCOUNT]: new RoomAccountSettingsHandler(defaultWatchManager),
"account": new AccountSettingsHandler(defaultWatchManager), [SettingLevel.ACCOUNT]: new AccountSettingsHandler(defaultWatchManager),
"room": new RoomSettingsHandler(defaultWatchManager), [SettingLevel.ROOM]: new RoomSettingsHandler(defaultWatchManager),
"config": new ConfigSettingsHandler(), [SettingLevel.CONFIG]: new ConfigSettingsHandler(),
"default": new DefaultSettingsHandler(defaultSettings, invertedDefaultSettings), [SettingLevel.DEFAULT]: new DefaultSettingsHandler(defaultSettings, invertedDefaultSettings),
}; };
// Wrap all the handlers with local echo // Wrap all the handlers with local echo
@ -61,20 +63,39 @@ for (const key of Object.keys(LEVEL_HANDLERS)) {
} }
const LEVEL_ORDER = [ const LEVEL_ORDER = [
'device', 'room-device', 'room-account', 'account', 'room', 'config', 'default', SettingLevel.DEVICE,
SettingLevel.ROOM_DEVICE,
SettingLevel.ROOM_ACCOUNT,
SettingLevel.ACCOUNT,
SettingLevel.ROOM,
SettingLevel.CONFIG,
SettingLevel.DEFAULT,
]; ];
export type CallbackFn = (
settingName: string,
roomId: string,
atLevel: SettingLevel,
newValAtLevel: any,
newVal: any,
) => void;
interface HandlerMap {
// @ts-ignore - TS wants this to be a string key but we know better
[level: SettingLevel]: SettingsHandler;
}
/** /**
* Controls and manages application settings by providing varying levels at which the * Controls and manages application settings by providing varying levels at which the
* setting value may be specified. The levels are then used to determine what the setting * setting value may be specified. The levels are then used to determine what the setting
* value should be given a set of circumstances. The levels, in priority order, are: * value should be given a set of circumstances. The levels, in priority order, are:
* - "device" - Values are determined by the current device * - SettingLevel.DEVICE - Values are determined by the current device
* - "room-device" - Values are determined by the current device for a particular room * - SettingLevel.ROOM_DEVICE - Values are determined by the current device for a particular room
* - "room-account" - Values are determined by the current account for a particular room * - SettingLevel.ROOM_ACCOUNT - Values are determined by the current account for a particular room
* - "account" - Values are determined by the current account * - SettingLevel.ACCOUNT - Values are determined by the current account
* - "room" - Values are determined by a particular room (by the room admins) * - SettingLevel.ROOM - Values are determined by a particular room (by the room admins)
* - "config" - Values are determined by the config.json * - SettingLevel.CONFIG - Values are determined by the config.json
* - "default" - Values are determined by the hardcoded defaults * - SettingLevel.DEFAULT - Values are determined by the hardcoded defaults
* *
* Each level has a different method to storing the setting value. For implementation * Each level has a different method to storing the setting value. For implementation
* specific details, please see the handlers. The "config" and "default" levels are * specific details, please see the handlers. The "config" and "default" levels are
@ -95,11 +116,11 @@ export default class SettingsStore {
// We also maintain a list of monitors which are special watchers: they cause dispatches // We also maintain a list of monitors which are special watchers: they cause dispatches
// when the setting changes. We track which rooms we're monitoring though to ensure we // when the setting changes. We track which rooms we're monitoring though to ensure we
// don't duplicate updates on the bus. // don't duplicate updates on the bus.
static _watchers = {}; // { callbackRef => { callbackFn } } private static watchers = {}; // { callbackRef => { callbackFn } }
static _monitors = {}; // { settingName => { roomId => callbackRef } } private static monitors = {}; // { settingName => { roomId => callbackRef } }
// Counter used for generation of watcher IDs // Counter used for generation of watcher IDs
static _watcherCount = 1; private static watcherCount = 1;
/** /**
* Watches for changes in a particular setting. This is done without any local echo * Watches for changes in a particular setting. This is done without any local echo
@ -117,7 +138,7 @@ export default class SettingsStore {
* if the change in value is worthwhile enough to react upon. * if the change in value is worthwhile enough to react upon.
* @returns {string} A reference to the watcher that was employed. * @returns {string} A reference to the watcher that was employed.
*/ */
static watchSetting(settingName, roomId, callbackFn) { public static watchSetting(settingName: string, roomId: string, callbackFn: CallbackFn): string {
const setting = SETTINGS[settingName]; const setting = SETTINGS[settingName];
const originalSettingName = settingName; const originalSettingName = settingName;
if (!setting) throw new Error(`${settingName} is not a setting`); if (!setting) throw new Error(`${settingName} is not a setting`);
@ -126,14 +147,14 @@ export default class SettingsStore {
settingName = setting.invertedSettingName; settingName = setting.invertedSettingName;
} }
const watcherId = `${new Date().getTime()}_${SettingsStore._watcherCount++}_${settingName}_${roomId}`; const watcherId = `${new Date().getTime()}_${SettingsStore.watcherCount++}_${settingName}_${roomId}`;
const localizedCallback = (changedInRoomId, atLevel, newValAtLevel) => { const localizedCallback = (changedInRoomId, atLevel, newValAtLevel) => {
const newValue = SettingsStore.getValue(originalSettingName); const newValue = SettingsStore.getValue(originalSettingName);
callbackFn(originalSettingName, changedInRoomId, atLevel, newValAtLevel, newValue); callbackFn(originalSettingName, changedInRoomId, atLevel, newValAtLevel, newValue);
}; };
SettingsStore._watchers[watcherId] = localizedCallback; SettingsStore.watchers[watcherId] = localizedCallback;
defaultWatchManager.watchSetting(settingName, roomId, localizedCallback); defaultWatchManager.watchSetting(settingName, roomId, localizedCallback);
return watcherId; return watcherId;
@ -145,14 +166,14 @@ export default class SettingsStore {
* @param {string} watcherReference The watcher reference (received from #watchSetting) * @param {string} watcherReference The watcher reference (received from #watchSetting)
* to cancel. * to cancel.
*/ */
static unwatchSetting(watcherReference) { public static unwatchSetting(watcherReference: string) {
if (!SettingsStore._watchers[watcherReference]) { if (!SettingsStore.watchers[watcherReference]) {
console.warn(`Ending non-existent watcher ID ${watcherReference}`); console.warn(`Ending non-existent watcher ID ${watcherReference}`);
return; return;
} }
defaultWatchManager.unwatchSetting(SettingsStore._watchers[watcherReference]); defaultWatchManager.unwatchSetting(SettingsStore.watchers[watcherReference]);
delete SettingsStore._watchers[watcherReference]; delete SettingsStore.watchers[watcherReference];
} }
/** /**
@ -163,13 +184,13 @@ export default class SettingsStore {
* @param {string} settingName The setting name to monitor. * @param {string} settingName The setting name to monitor.
* @param {String} roomId The room ID to monitor for changes in. Use null for all rooms. * @param {String} roomId The room ID to monitor for changes in. Use null for all rooms.
*/ */
static monitorSetting(settingName, roomId) { public static monitorSetting(settingName: string, roomId: string) {
roomId = roomId || null; // the thing wants null specifically to work, so appease it. roomId = roomId || null; // the thing wants null specifically to work, so appease it.
if (!this._monitors[settingName]) this._monitors[settingName] = {}; if (!this.monitors[settingName]) this.monitors[settingName] = {};
const registerWatcher = () => { const registerWatcher = () => {
this._monitors[settingName][roomId] = SettingsStore.watchSetting( this.monitors[settingName][roomId] = SettingsStore.watchSetting(
settingName, roomId, (settingName, inRoomId, level, newValueAtLevel, newValue) => { settingName, roomId, (settingName, inRoomId, level, newValueAtLevel, newValue) => {
dis.dispatch({ dis.dispatch({
action: 'setting_updated', action: 'setting_updated',
@ -183,16 +204,16 @@ export default class SettingsStore {
); );
}; };
const hasRoom = Object.keys(this._monitors[settingName]).find((r) => r === roomId || r === null); const hasRoom = Object.keys(this.monitors[settingName]).find((r) => r === roomId || r === null);
if (!hasRoom) { if (!hasRoom) {
registerWatcher(); registerWatcher();
} else { } else {
if (roomId === null) { if (roomId === null) {
// Unregister all existing watchers and register the new one // Unregister all existing watchers and register the new one
for (const roomId of Object.keys(this._monitors[settingName])) { for (const roomId of Object.keys(this.monitors[settingName])) {
SettingsStore.unwatchSetting(this._monitors[settingName][roomId]); SettingsStore.unwatchSetting(this.monitors[settingName][roomId]);
} }
this._monitors[settingName] = {}; this.monitors[settingName] = {};
registerWatcher(); registerWatcher();
} // else a watcher is already registered for the room, so don't bother registering it again } // else a watcher is already registered for the room, so don't bother registering it again
} }
@ -201,11 +222,11 @@ export default class SettingsStore {
/** /**
* Gets the translated display name for a given setting * Gets the translated display name for a given setting
* @param {string} settingName The setting to look up. * @param {string} settingName The setting to look up.
* @param {"device"|"room-device"|"room-account"|"account"|"room"|"config"|"default"} atLevel * @param {SettingLevel} atLevel
* The level to get the display name for; Defaults to 'default'. * The level to get the display name for; Defaults to 'default'.
* @return {String} The display name for the setting, or null if not found. * @return {String} The display name for the setting, or null if not found.
*/ */
static getDisplayName(settingName, atLevel = "default") { public static getDisplayName(settingName: string, atLevel = SettingLevel.DEFAULT) {
if (!SETTINGS[settingName] || !SETTINGS[settingName].displayName) return null; if (!SETTINGS[settingName] || !SETTINGS[settingName].displayName) return null;
let displayName = SETTINGS[settingName].displayName; let displayName = SETTINGS[settingName].displayName;
@ -214,20 +235,20 @@ export default class SettingsStore {
else displayName = displayName["default"]; else displayName = displayName["default"];
} }
return _t(displayName); return _t(displayName as string);
} }
/** /**
* Returns a list of all available labs feature names * Returns a list of all available labs feature names
* @returns {string[]} The list of available feature names * @returns {string[]} The list of available feature names
*/ */
static getLabsFeatures() { public static getLabsFeatures(): string[] {
const possibleFeatures = Object.keys(SETTINGS).filter((s) => SettingsStore.isFeature(s)); const possibleFeatures = Object.keys(SETTINGS).filter((s) => SettingsStore.isFeature(s));
const enableLabs = SdkConfig.get()["enableLabs"]; const enableLabs = SdkConfig.get()["enableLabs"];
if (enableLabs) return possibleFeatures; if (enableLabs) return possibleFeatures;
return possibleFeatures.filter((s) => SettingsStore._getFeatureState(s) === "labs"); return possibleFeatures.filter((s) => SettingsStore.getFeatureState(s) === "labs");
} }
/** /**
@ -235,7 +256,7 @@ export default class SettingsStore {
* @param {string} settingName The setting to look up. * @param {string} settingName The setting to look up.
* @return {boolean} True if the setting is a feature. * @return {boolean} True if the setting is a feature.
*/ */
static isFeature(settingName) { public static isFeature(settingName: string) {
if (!SETTINGS[settingName]) return false; if (!SETTINGS[settingName]) return false;
return SETTINGS[settingName].isFeature; return SETTINGS[settingName].isFeature;
} }
@ -247,7 +268,7 @@ export default class SettingsStore {
* @param {String} roomId The optional room ID to validate in, may be null. * @param {String} roomId The optional room ID to validate in, may be null.
* @return {boolean} True if the feature is enabled, false otherwise * @return {boolean} True if the feature is enabled, false otherwise
*/ */
static isFeatureEnabled(settingName, roomId = null) { public static isFeatureEnabled(settingName: string, roomId: string = null) {
if (!SettingsStore.isFeature(settingName)) { if (!SettingsStore.isFeature(settingName)) {
throw new Error("Setting " + settingName + " is not a feature"); throw new Error("Setting " + settingName + " is not a feature");
} }
@ -261,7 +282,7 @@ export default class SettingsStore {
* @param {boolean} value True to enable the feature, false otherwise. * @param {boolean} value True to enable the feature, false otherwise.
* @returns {Promise} Resolves when the setting has been set. * @returns {Promise} Resolves when the setting has been set.
*/ */
static setFeatureEnabled(settingName, value) { public static setFeatureEnabled(settingName: string, value: any): Promise<void> {
// Verify that the setting is actually a setting // Verify that the setting is actually a setting
if (!SETTINGS[settingName]) { if (!SETTINGS[settingName]) {
throw new Error("Setting '" + settingName + "' does not appear to be a setting."); throw new Error("Setting '" + settingName + "' does not appear to be a setting.");
@ -281,7 +302,7 @@ export default class SettingsStore {
* @param {boolean} excludeDefault True to disable using the default value. * @param {boolean} excludeDefault True to disable using the default value.
* @return {*} The value, or null if not found * @return {*} The value, or null if not found
*/ */
static getValue(settingName, roomId = null, excludeDefault = false) { public static getValue(settingName: string, roomId: string = null, excludeDefault = false): any {
// Verify that the setting is actually a setting // Verify that the setting is actually a setting
if (!SETTINGS[settingName]) { if (!SETTINGS[settingName]) {
throw new Error("Setting '" + settingName + "' does not appear to be a setting."); throw new Error("Setting '" + settingName + "' does not appear to be a setting.");
@ -295,7 +316,7 @@ export default class SettingsStore {
/** /**
* Gets a setting's value at a particular level, ignoring all levels that are more specific. * Gets a setting's value at a particular level, ignoring all levels that are more specific.
* @param {"device"|"room-device"|"room-account"|"account"|"room"|"config"|"default"} level The * @param {SettingLevel|"config"|"default"} level The
* level to look at. * level to look at.
* @param {string} settingName The name of the setting to read. * @param {string} settingName The name of the setting to read.
* @param {String} roomId The room ID to read the setting value in, may be null. * @param {String} roomId The room ID to read the setting value in, may be null.
@ -304,7 +325,13 @@ export default class SettingsStore {
* @param {boolean} excludeDefault True to disable using the default value. * @param {boolean} excludeDefault True to disable using the default value.
* @return {*} The value, or null if not found. * @return {*} The value, or null if not found.
*/ */
static getValueAt(level, settingName, roomId = null, explicit = false, excludeDefault = false) { public static getValueAt(
level: SettingLevel,
settingName: string,
roomId: string = null,
explicit = false,
excludeDefault = false,
): any {
// Verify that the setting is actually a setting // Verify that the setting is actually a setting
const setting = SETTINGS[settingName]; const setting = SETTINGS[settingName];
if (!setting) { if (!setting) {
@ -312,19 +339,19 @@ export default class SettingsStore {
} }
const levelOrder = (setting.supportedLevelsAreOrdered ? setting.supportedLevels : LEVEL_ORDER); const levelOrder = (setting.supportedLevelsAreOrdered ? setting.supportedLevels : LEVEL_ORDER);
if (!levelOrder.includes("default")) levelOrder.push("default"); // always include default if (!levelOrder.includes(SettingLevel.DEFAULT)) levelOrder.push(SettingLevel.DEFAULT); // always include default
const minIndex = levelOrder.indexOf(level); const minIndex = levelOrder.indexOf(level);
if (minIndex === -1) throw new Error("Level " + level + " is not prioritized"); if (minIndex === -1) throw new Error("Level " + level + " is not prioritized");
if (SettingsStore.isFeature(settingName)) { if (SettingsStore.isFeature(settingName)) {
const configValue = SettingsStore._getFeatureState(settingName); const configValue = SettingsStore.getFeatureState(settingName);
if (configValue === "enable") return true; if (configValue === "enable") return true;
if (configValue === "disable") return false; if (configValue === "disable") return false;
// else let it fall through the default process // else let it fall through the default process
} }
const handlers = SettingsStore._getHandlers(settingName); const handlers = SettingsStore.getHandlers(settingName);
// Check if we need to invert the setting at all. Do this after we get the setting // Check if we need to invert the setting at all. Do this after we get the setting
// handlers though, otherwise we'll fail to read the value. // handlers though, otherwise we'll fail to read the value.
@ -336,10 +363,10 @@ export default class SettingsStore {
if (explicit) { if (explicit) {
const handler = handlers[level]; const handler = handlers[level];
if (!handler) { if (!handler) {
return SettingsStore._getFinalValue(setting, level, roomId, null, null); return SettingsStore.getFinalValue(setting, level, roomId, null, null);
} }
const value = handler.getValue(settingName, roomId); const value = handler.getValue(settingName, roomId);
return SettingsStore._getFinalValue(setting, level, roomId, value, level); return SettingsStore.getFinalValue(setting, level, roomId, value, level);
} }
for (let i = minIndex; i < levelOrder.length; i++) { for (let i = minIndex; i < levelOrder.length; i++) {
@ -349,10 +376,10 @@ export default class SettingsStore {
const value = handler.getValue(settingName, roomId); const value = handler.getValue(settingName, roomId);
if (value === null || value === undefined) continue; if (value === null || value === undefined) continue;
return SettingsStore._getFinalValue(setting, level, roomId, value, levelOrder[i]); return SettingsStore.getFinalValue(setting, level, roomId, value, levelOrder[i]);
} }
return SettingsStore._getFinalValue(setting, level, roomId, null, null); return SettingsStore.getFinalValue(setting, level, roomId, null, null);
} }
/** /**
@ -361,7 +388,7 @@ export default class SettingsStore {
* @param {String} roomId The room ID to read the setting value in, may be null. * @param {String} roomId The room ID to read the setting value in, may be null.
* @return {*} The default value * @return {*} The default value
*/ */
static getDefaultValue(settingName) { public static getDefaultValue(settingName: string): any {
// Verify that the setting is actually a setting // Verify that the setting is actually a setting
if (!SETTINGS[settingName]) { if (!SETTINGS[settingName]) {
throw new Error("Setting '" + settingName + "' does not appear to be a setting."); throw new Error("Setting '" + settingName + "' does not appear to be a setting.");
@ -370,7 +397,13 @@ export default class SettingsStore {
return SETTINGS[settingName].default; return SETTINGS[settingName].default;
} }
static _getFinalValue(setting, level, roomId, calculatedValue, calculatedAtLevel) { private static getFinalValue(
setting: ISetting,
level: SettingLevel,
roomId: string,
calculatedValue: any,
calculatedAtLevel: any,
): any {
let resultingValue = calculatedValue; let resultingValue = calculatedValue;
if (setting.controller) { if (setting.controller) {
@ -389,20 +422,21 @@ export default class SettingsStore {
* to indicate that the level should no longer have an override. * to indicate that the level should no longer have an override.
* @param {string} settingName The name of the setting to change. * @param {string} settingName The name of the setting to change.
* @param {String} roomId The room ID to change the value in, may be null. * @param {String} roomId The room ID to change the value in, may be null.
* @param {"device"|"room-device"|"room-account"|"account"|"room"} level The level * @param {SettingLevel} level The level
* to change the value at. * to change the value at.
* @param {*} value The new value of the setting, may be null. * @param {*} value The new value of the setting, may be null.
* @return {Promise} Resolves when the setting has been changed. * @return {Promise} Resolves when the setting has been changed.
*/ */
/* eslint-enable valid-jsdoc */ /* eslint-enable valid-jsdoc */
static async setValue(settingName, roomId, level, value) { public static async setValue(settingName: string, roomId: string, level: SettingLevel, value: any): Promise<void> {
// Verify that the setting is actually a setting // Verify that the setting is actually a setting
const setting = SETTINGS[settingName]; const setting = SETTINGS[settingName];
if (!setting) { if (!setting) {
throw new Error("Setting '" + settingName + "' does not appear to be a setting."); throw new Error("Setting '" + settingName + "' does not appear to be a setting.");
} }
const handler = SettingsStore._getHandler(settingName, level); const handler = SettingsStore.getHandler(settingName, level);
if (!handler) { if (!handler) {
throw new Error("Setting " + settingName + " does not have a handler for " + level); throw new Error("Setting " + settingName + " does not have a handler for " + level);
} }
@ -434,28 +468,28 @@ export default class SettingsStore {
* set for a particular room, otherwise it should be supplied. * set for a particular room, otherwise it should be supplied.
* @param {string} settingName The name of the setting to check. * @param {string} settingName The name of the setting to check.
* @param {String} roomId The room ID to check in, may be null. * @param {String} roomId The room ID to check in, may be null.
* @param {"device"|"room-device"|"room-account"|"account"|"room"} level The level to * @param {SettingLevel} level The level to
* check at. * check at.
* @return {boolean} True if the user may set the setting, false otherwise. * @return {boolean} True if the user may set the setting, false otherwise.
*/ */
static canSetValue(settingName, roomId, level) { public static canSetValue(settingName: string, roomId: string, level: SettingLevel): boolean {
// Verify that the setting is actually a setting // Verify that the setting is actually a setting
if (!SETTINGS[settingName]) { if (!SETTINGS[settingName]) {
throw new Error("Setting '" + settingName + "' does not appear to be a setting."); throw new Error("Setting '" + settingName + "' does not appear to be a setting.");
} }
const handler = SettingsStore._getHandler(settingName, level); const handler = SettingsStore.getHandler(settingName, level);
if (!handler) return false; if (!handler) return false;
return handler.canSetValue(settingName, roomId); return handler.canSetValue(settingName, roomId);
} }
/** /**
* Determines if the given level is supported on this device. * Determines if the given level is supported on this device.
* @param {"device"|"room-device"|"room-account"|"account"|"room"} level The level * @param {SettingLevel} level The level
* to check the feasibility of. * to check the feasibility of.
* @return {boolean} True if the level is supported, false otherwise. * @return {boolean} True if the level is supported, false otherwise.
*/ */
static isLevelSupported(level) { public static isLevelSupported(level: SettingLevel): boolean {
if (!LEVEL_HANDLERS[level]) return false; if (!LEVEL_HANDLERS[level]) return false;
return LEVEL_HANDLERS[level].isSupported(); return LEVEL_HANDLERS[level].isSupported();
} }
@ -467,7 +501,7 @@ export default class SettingsStore {
* @param {string} realSettingName The setting name to try and read. * @param {string} realSettingName The setting name to try and read.
* @param {string} roomId Optional room ID to test the setting in. * @param {string} roomId Optional room ID to test the setting in.
*/ */
static debugSetting(realSettingName, roomId) { public static debugSetting(realSettingName: string, roomId: string) {
console.log(`--- DEBUG ${realSettingName}`); console.log(`--- DEBUG ${realSettingName}`);
// Note: we intentionally use JSON.stringify here to avoid the console masking the // Note: we intentionally use JSON.stringify here to avoid the console masking the
@ -555,13 +589,13 @@ export default class SettingsStore {
console.log(`--- END DEBUG`); console.log(`--- END DEBUG`);
} }
static _getHandler(settingName, level) { private static getHandler(settingName: string, level: SettingLevel): SettingsHandler {
const handlers = SettingsStore._getHandlers(settingName); const handlers = SettingsStore.getHandlers(settingName);
if (!handlers[level]) return null; if (!handlers[level]) return null;
return handlers[level]; return handlers[level];
} }
static _getHandlers(settingName) { private static getHandlers(settingName: string): HandlerMap {
if (!SETTINGS[settingName]) return {}; if (!SETTINGS[settingName]) return {};
const handlers = {}; const handlers = {};
@ -576,7 +610,7 @@ export default class SettingsStore {
return handlers; return handlers;
} }
static _getFeatureState(settingName) { private static getFeatureState(settingName: string): "labs" | "disable" | "enable" | string {
const featuresConfig = SdkConfig.get()['features']; const featuresConfig = SdkConfig.get()['features'];
const enableLabs = SdkConfig.get()['enableLabs']; // we'll honour the old flag const enableLabs = SdkConfig.get()['enableLabs']; // we'll honour the old flag
@ -596,4 +630,4 @@ export default class SettingsStore {
} }
// For debugging purposes // For debugging purposes
global.mxSettingsStore = SettingsStore; window.mxSettingsStore = SettingsStore;