You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

functions.any.ts 10KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342
  1. // @ts-ignore
  2. import Bourne from '@hapi/bourne';
  3. // eslint-disable-next-line lines-around-comment
  4. // @ts-ignore
  5. import { jitsiLocalStorage } from '@jitsi/js-utils';
  6. import _ from 'lodash';
  7. import { IReduxState } from '../../app/types';
  8. import { browser } from '../lib-jitsi-meet';
  9. import { parseURLParams } from '../util/parseURLParams';
  10. import { IConfig } from './configType';
  11. import CONFIG_WHITELIST from './configWhitelist';
  12. import {
  13. DEFAULT_HELP_CENTRE_URL,
  14. DEFAULT_PRIVACY_URL,
  15. DEFAULT_TERMS_URL,
  16. FEATURE_FLAGS,
  17. _CONFIG_STORE_PREFIX
  18. } from './constants';
  19. import INTERFACE_CONFIG_WHITELIST from './interfaceConfigWhitelist';
  20. import logger from './logger';
  21. // XXX The function getRoomName is split out of
  22. // functions.any.js because it is bundled in both app.bundle and
  23. // do_external_connect, webpack 1 does not support tree shaking, and we don't
  24. // want all functions to be bundled in do_external_connect.
  25. export { default as getRoomName } from './getRoomName';
  26. /**
  27. * Create a "fake" configuration object for the given base URL. This is used in case the config
  28. * couldn't be loaded in the welcome page, so at least we have something to try with.
  29. *
  30. * @param {string} baseURL - URL of the deployment for which we want the fake config.
  31. * @returns {Object}
  32. */
  33. export function createFakeConfig(baseURL: string) {
  34. const url = new URL(baseURL);
  35. return {
  36. hosts: {
  37. domain: url.hostname,
  38. muc: `conference.${url.hostname}`
  39. },
  40. bosh: `${baseURL}http-bind`,
  41. p2p: {
  42. enabled: true
  43. }
  44. };
  45. }
  46. /**
  47. * Selector used to get the meeting region.
  48. *
  49. * @param {Object} state - The global state.
  50. * @returns {string}
  51. */
  52. export function getMeetingRegion(state: IReduxState) {
  53. return state['features/base/config']?.deploymentInfo?.region || '';
  54. }
  55. /**
  56. * Selector for determining if sending multiple stream support is enabled.
  57. *
  58. * @param {Object} _state - The global state.
  59. * @returns {boolean}
  60. */
  61. export function getMultipleVideoSendingSupportFeatureFlag(_state: IReduxState) {
  62. return browser.supportsUnifiedPlan();
  63. }
  64. /**
  65. * Selector used to get the SSRC-rewriting feature flag.
  66. *
  67. * @param {Object} state - The global state.
  68. * @returns {boolean}
  69. */
  70. export function getSsrcRewritingFeatureFlag(state: IReduxState) {
  71. return getFeatureFlag(state, FEATURE_FLAGS.SSRC_REWRITING);
  72. }
  73. /**
  74. * Selector used to get a feature flag.
  75. *
  76. * @param {Object} state - The global state.
  77. * @param {string} featureFlag - The name of the feature flag.
  78. * @returns {boolean}
  79. */
  80. export function getFeatureFlag(state: IReduxState, featureFlag: string) {
  81. const featureFlags = state['features/base/config']?.flags || {};
  82. return featureFlags[featureFlag as keyof typeof featureFlags];
  83. }
  84. /**
  85. * Selector used to get the disableRemoveRaisedHandOnFocus.
  86. *
  87. * @param {Object} state - The global state.
  88. * @returns {boolean}
  89. */
  90. export function getDisableRemoveRaisedHandOnFocus(state: IReduxState) {
  91. return state['features/base/config']?.disableRemoveRaisedHandOnFocus || false;
  92. }
  93. /**
  94. * Selector used to get the endpoint used for fetching the recording.
  95. *
  96. * @param {Object} state - The global state.
  97. * @returns {string}
  98. */
  99. export function getRecordingSharingUrl(state: IReduxState) {
  100. return state['features/base/config'].recordingSharingUrl;
  101. }
  102. /**
  103. * Overrides JSON properties in {@code config} and
  104. * {@code interfaceConfig} Objects with the values from {@code newConfig}.
  105. * Overrides only the whitelisted keys.
  106. *
  107. * @param {Object} config - The config Object in which we'll be overriding
  108. * properties.
  109. * @param {Object} interfaceConfig - The interfaceConfig Object in which we'll
  110. * be overriding properties.
  111. * @param {Object} json - Object containing configuration properties.
  112. * Destination object is selected based on root property name:
  113. * {
  114. * config: {
  115. * // config.js properties here
  116. * },
  117. * interfaceConfig: {
  118. * // interface_config.js properties here
  119. * }
  120. * }.
  121. * @returns {void}
  122. */
  123. export function overrideConfigJSON(config: IConfig, interfaceConfig: any, json: any) {
  124. for (const configName of Object.keys(json)) {
  125. let configObj;
  126. if (configName === 'config') {
  127. configObj = config;
  128. } else if (configName === 'interfaceConfig') {
  129. configObj = interfaceConfig;
  130. }
  131. if (configObj) {
  132. const configJSON
  133. = getWhitelistedJSON(configName as 'interfaceConfig' | 'config', json[configName]);
  134. if (!_.isEmpty(configJSON)) {
  135. logger.info(
  136. `Extending ${configName} with: ${
  137. JSON.stringify(configJSON)}`);
  138. // eslint-disable-next-line arrow-body-style
  139. _.mergeWith(configObj, configJSON, (oldValue, newValue) => {
  140. // XXX We don't want to merge the arrays, we want to
  141. // overwrite them.
  142. return Array.isArray(oldValue) ? newValue : undefined;
  143. });
  144. }
  145. }
  146. }
  147. }
  148. /* eslint-enable max-params, no-shadow */
  149. /**
  150. * Apply whitelist filtering for configs with whitelists.
  151. * Only extracts overridden values for keys we allow to be overridden.
  152. *
  153. * @param {string} configName - The config name, one of config or interfaceConfig.
  154. * @param {Object} configJSON - The object with keys and values to override.
  155. * @returns {Object} - The result object only with the keys
  156. * that are whitelisted.
  157. */
  158. export function getWhitelistedJSON(configName: 'interfaceConfig' | 'config', configJSON: any): Object {
  159. if (configName === 'interfaceConfig') {
  160. return _.pick(configJSON, INTERFACE_CONFIG_WHITELIST);
  161. } else if (configName === 'config') {
  162. return _.pick(configJSON, CONFIG_WHITELIST);
  163. }
  164. return configJSON;
  165. }
  166. /**
  167. * Selector for determining if the display name is read only.
  168. *
  169. * @param {Object} state - The state of the app.
  170. * @returns {boolean}
  171. */
  172. export function isNameReadOnly(state: IReduxState): boolean {
  173. return Boolean(state['features/base/config'].disableProfile
  174. || state['features/base/config'].readOnlyName);
  175. }
  176. /**
  177. * Selector for determining if the display name is visible.
  178. *
  179. * @param {Object} state - The state of the app.
  180. * @returns {boolean}
  181. */
  182. export function isDisplayNameVisible(state: IReduxState): boolean {
  183. return !state['features/base/config'].hideDisplayName;
  184. }
  185. /**
  186. * Restores a Jitsi Meet config.js from {@code localStorage} if it was
  187. * previously downloaded from a specific {@code baseURL} and stored with
  188. * {@link storeConfig}.
  189. *
  190. * @param {string} baseURL - The base URL from which the config.js was
  191. * previously downloaded and stored with {@code storeConfig}.
  192. * @returns {?Object} The Jitsi Meet config.js which was previously downloaded
  193. * from {@code baseURL} and stored with {@code storeConfig} if it was restored;
  194. * otherwise, {@code undefined}.
  195. */
  196. export function restoreConfig(baseURL: string) {
  197. const key = `${_CONFIG_STORE_PREFIX}/${baseURL}`;
  198. const config = jitsiLocalStorage.getItem(key);
  199. if (config) {
  200. try {
  201. return Bourne.parse(config) || undefined;
  202. } catch (e) {
  203. // Somehow incorrect data ended up in the storage. Clean it up.
  204. jitsiLocalStorage.removeItem(key);
  205. }
  206. }
  207. return undefined;
  208. }
  209. /* eslint-disable max-params */
  210. /**
  211. * Inspects the hash part of the location URI and overrides values specified
  212. * there in the corresponding config objects given as the arguments. The syntax
  213. * is: {@code https://server.com/room#config.debug=true
  214. * &interfaceConfig.showButton=false}.
  215. *
  216. * In the hash part each parameter will be parsed to JSON and then the root
  217. * object will be matched with the corresponding config object given as the
  218. * argument to this function.
  219. *
  220. * @param {Object} config - This is the general config.
  221. * @param {Object} interfaceConfig - This is the interface config.
  222. * @param {URI} location - The new location to which the app is navigating to.
  223. * @returns {void}
  224. */
  225. export function setConfigFromURLParams(
  226. config: IConfig, interfaceConfig: any, location: string | URL) {
  227. const params = parseURLParams(location);
  228. const json: any = {};
  229. // At this point we have:
  230. // params = {
  231. // "config.disableAudioLevels": false,
  232. // "config.channelLastN": -1,
  233. // "interfaceConfig.APP_NAME": "Jitsi Meet"
  234. // }
  235. // We want to have:
  236. // json = {
  237. // config: {
  238. // "disableAudioLevels": false,
  239. // "channelLastN": -1
  240. // },
  241. // interfaceConfig: {
  242. // "APP_NAME": "Jitsi Meet"
  243. // }
  244. // }
  245. config && (json.config = {});
  246. interfaceConfig && (json.interfaceConfig = {});
  247. for (const param of Object.keys(params)) {
  248. let base = json;
  249. const names = param.split('.');
  250. const last = names.pop() ?? '';
  251. for (const name of names) {
  252. base = base[name] = base[name] || {};
  253. }
  254. base[last] = params[param];
  255. }
  256. overrideConfigJSON(config, interfaceConfig, json);
  257. }
  258. /* eslint-enable max-params */
  259. /**
  260. * Returns the dial out url.
  261. *
  262. * @param {Object} state - The state of the app.
  263. * @returns {string}
  264. */
  265. export function getDialOutStatusUrl(state: IReduxState) {
  266. return state['features/base/config'].guestDialOutStatusUrl;
  267. }
  268. /**
  269. * Returns the dial out status url.
  270. *
  271. * @param {Object} state - The state of the app.
  272. * @returns {string}
  273. */
  274. export function getDialOutUrl(state: IReduxState) {
  275. return state['features/base/config'].guestDialOutUrl;
  276. }
  277. /**
  278. * Selector to return the security UI config.
  279. *
  280. * @param {IReduxState} state - State object.
  281. * @returns {Object}
  282. */
  283. export function getSecurityUiConfig(state: IReduxState) {
  284. return state['features/base/config']?.securityUi || {};
  285. }
  286. /**
  287. * Returns the terms, privacy and help centre URL's.
  288. *
  289. * @param {IReduxState} state - The state of the application.
  290. * @returns {{
  291. * privacy: string,
  292. * helpCentre: string,
  293. * terms: string
  294. * }}
  295. */
  296. export function getLegalUrls(state: IReduxState) {
  297. const helpCentreURL = state['features/base/config']?.helpCentreURL;
  298. const configLegalUrls = state['features/base/config']?.legalUrls;
  299. return {
  300. privacy: configLegalUrls?.privacy || DEFAULT_PRIVACY_URL,
  301. helpCentre: helpCentreURL || configLegalUrls?.helpCentre || DEFAULT_HELP_CENTRE_URL,
  302. terms: configLegalUrls?.terms || DEFAULT_TERMS_URL
  303. };
  304. }