// @flow const logger = require('jitsi-meet-logger').getLogger(__filename); /** * The app linking scheme. * TODO: This should be read from the manifest files later. */ export const APP_LINK_SCHEME = 'org.jitsi.meet:'; /** * A list of characters to be excluded/removed from the room component/segment * of a conference/meeting URI/URL. The list is based on RFC 3986 and the jxmpp * library utilized by jicofo. */ const _ROOM_EXCLUDE_PATTERN = '[\\:\\?#\\[\\]@!$&\'()*+,;=> | null = regex.exec(uri); if (match) { // As an implementation convenience, pick up the last scheme and make // sure that it is a well-known one. let protocol = match[match.length - 1].toLowerCase(); if (protocol !== 'http:' && protocol !== 'https:') { protocol = 'https:'; } /* eslint-disable no-param-reassign */ uri = uri.substring(regex.lastIndex); if (uri.startsWith('//')) { // The specified URL was not a room name only, it contained an // authority. uri = protocol + uri; } /* eslint-enable no-param-reassign */ } return uri; } /** * Gets the (Web application) context root defined by a specific location (URI). * * @param {Object} location - The location (URI) which defines the (Web * application) context root. * @public * @returns {string} - The (Web application) context root defined by the * specified {@code location} (URI). */ export function getLocationContextRoot({ pathname }: { pathname: string }) { const contextRootEndIndex = pathname.lastIndexOf('/'); return ( contextRootEndIndex === -1 ? '/' : pathname.substring(0, contextRootEndIndex + 1)); } /** * Constructs a new {@code Array} with URL parameter {@code String}s out of a * specific {@code Object}. * * @param {Object} obj - The {@code Object} to turn into URL parameter * {@code String}s. * @returns {Array} The {@code Array} with URL parameter {@code String}s * constructed out of the specified {@code obj}. */ function _objectToURLParamsArray(obj = {}) { const params = []; for (const key in obj) { // eslint-disable-line guard-for-in try { params.push( `${key}=${encodeURIComponent(JSON.stringify(obj[key]))}`); } catch (e) { logger.warn(`Error encoding ${key}: ${e}`); } } return params; } /** * Parses a specific URI string into an object with the well-known properties of * the {@link Location} and/or {@link URL} interfaces implemented by Web * browsers. The parsing attempts to be in accord with IETF's RFC 3986. * * @param {string} str - The URI string to parse. * @public * @returns {{ * hash: string, * host: (string|undefined), * hostname: (string|undefined), * pathname: string, * port: (string|undefined), * protocol: (string|undefined), * search: string * }} */ export function parseStandardURIString(str: string) { /* eslint-disable no-param-reassign */ const obj: Object = { toString: _standardURIToString }; let regex; let match: Array | null; // XXX A URI string as defined by RFC 3986 does not contain any whitespace. // Usually, a browser will have already encoded any whitespace. In order to // avoid potential later problems related to whitespace in URI, strip any // whitespace. Anyway, the Jitsi Meet app is not known to utilize unencoded // whitespace so the stripping is deemed safe. str = str.replace(/\s/g, ''); // protocol regex = new RegExp(`^${URI_PROTOCOL_PATTERN}`, 'gi'); match = regex.exec(str); if (match) { obj.protocol = match[1].toLowerCase(); str = str.substring(regex.lastIndex); } // authority regex = new RegExp(`^${_URI_AUTHORITY_PATTERN}`, 'gi'); match = regex.exec(str); if (match) { let authority: string = match[1].substring(/* // */ 2); str = str.substring(regex.lastIndex); // userinfo const userinfoEndIndex = authority.indexOf('@'); if (userinfoEndIndex !== -1) { authority = authority.substring(userinfoEndIndex + 1); } obj.host = authority; // port const portBeginIndex = authority.lastIndexOf(':'); if (portBeginIndex !== -1) { obj.port = authority.substring(portBeginIndex + 1); authority = authority.substring(0, portBeginIndex); } // hostname obj.hostname = authority; } // pathname regex = new RegExp(`^${_URI_PATH_PATTERN}`, 'gi'); match = regex.exec(str); let pathname: ?string; if (match) { pathname = match[1]; str = str.substring(regex.lastIndex); } if (pathname) { pathname.startsWith('/') || (pathname = `/${pathname}`); } else { pathname = '/'; } obj.pathname = pathname; // query if (str.startsWith('?')) { let hashBeginIndex = str.indexOf('#', 1); if (hashBeginIndex === -1) { hashBeginIndex = str.length; } obj.search = str.substring(0, hashBeginIndex); str = str.substring(hashBeginIndex); } else { obj.search = ''; // Google Chrome } // fragment obj.hash = str.startsWith('#') ? str : ''; /* eslint-enable no-param-reassign */ return obj; } /** * Parses a specific URI which (supposedly) references a Jitsi Meet resource * (location). * * @param {(string|undefined)} uri - The URI to parse which (supposedly) * references a Jitsi Meet resource (location). * @public * @returns {{ * contextRoot: string, * hash: string, * host: string, * hostname: string, * pathname: string, * port: string, * protocol: string, * room: (string|undefined), * search: string * }} */ export function parseURIString(uri: ?string) { if (typeof uri !== 'string') { return undefined; } const obj = parseStandardURIString(_fixURIStringScheme(uri)); // Add the properties that are specific to a Jitsi Meet resource (location) // such as contextRoot, room: // contextRoot obj.contextRoot = getLocationContextRoot(obj); // The room (name) is the last component/segment of pathname. const { pathname } = obj; // XXX While the components/segments of pathname are URI encoded, Jitsi Meet // on the client and/or server sides still don't support certain characters. const contextRootEndIndex = pathname.lastIndexOf('/'); let room = pathname.substring(contextRootEndIndex + 1) || undefined; if (room) { const fixedRoom = _fixRoom(room); if (fixedRoom !== room) { room = fixedRoom; // XXX Drive fixedRoom into pathname (because room is derived from // pathname). obj.pathname = pathname.substring(0, contextRootEndIndex + 1) + (room || ''); } } obj.room = room; return obj; } /** * Implements {@code href} and {@code toString} for the {@code Object} returned * by {@link #parseStandardURIString}. * * @param {Object} [thiz] - An {@code Object} returned by * {@code #parseStandardURIString} if any; otherwise, it is presumed that the * function is invoked on such an instance. * @returns {string} */ function _standardURIToString(thiz: ?Object) { // eslint-disable-next-line no-invalid-this const { hash, host, pathname, protocol, search } = thiz || this; let str = ''; protocol && (str += protocol); // TODO userinfo host && (str += `//${host}`); str += pathname || '/'; search && (str += search); hash && (str += hash); return str; } /** * Attempts to return a {@code String} representation of a specific * {@code Object} which is supposed to represent a URL. Obviously, if a * {@code String} is specified, it is returned. If a {@code URL} is specified, * its {@code URL#href} is returned. Additionally, an {@code Object} similar to * the one accepted by the constructor of Web's ExternalAPI is supported on both * mobile/React Native and Web/React. * * @param {Object|string} obj - The URL to return a {@code String} * representation of. * @returns {string} - A {@code String} representation of the specified * {@code obj} which is supposed to represent a URL. */ export function toURLString(obj: ?(Object | string)): ?string { let str; switch (typeof obj) { case 'object': if (obj) { if (obj instanceof URL) { str = obj.href; } else { str = urlObjectToString(obj); } } break; case 'string': str = String(obj); break; } return str; } /** * Attempts to return a {@code String} representation of a specific * {@code Object} similar to the one accepted by the constructor * of Web's ExternalAPI. * * @param {Object} o - The URL to return a {@code String} representation of. * @returns {string} - A {@code String} representation of the specified * {@code Object}. */ export function urlObjectToString(o: Object): ?string { const url = parseStandardURIString(_fixURIStringScheme(o.url || '')); // protocol if (!url.protocol) { let protocol: ?string = o.protocol || o.scheme; if (protocol) { // Protocol is supposed to be the scheme and the final ':'. Anyway, // do not make a fuss if the final ':' is not there. protocol.endsWith(':') || (protocol += ':'); url.protocol = protocol; } } // authority & pathname let { pathname } = url; if (!url.host) { // Web's ExternalAPI domain // // It may be host/hostname and pathname with the latter denoting the // tenant. const domain: ?string = o.domain || o.host || o.hostname; if (domain) { const { host, hostname, pathname: contextRoot, port } = parseStandardURIString( // XXX The value of domain in supposed to be host/hostname // and, optionally, pathname. Make sure it is not taken for // a pathname only. _fixURIStringScheme(`${APP_LINK_SCHEME}//${domain}`)); // authority if (host) { url.host = host; url.hostname = hostname; url.port = port; } // pathname pathname === '/' && contextRoot !== '/' && (pathname = contextRoot); } } // pathname // Web's ExternalAPI roomName const room = o.roomName || o.room; if (room && (url.pathname.endsWith('/') || !url.pathname.endsWith(`/${room}`))) { pathname.endsWith('/') || (pathname += '/'); pathname += room; } url.pathname = pathname; // query/search // Web's ExternalAPI jwt const { jwt } = o; if (jwt) { let { search } = url; if (search.indexOf('?jwt=') === -1 && search.indexOf('&jwt=') === -1) { search.startsWith('?') || (search = `?${search}`); search.length === 1 || (search += '&'); search += `jwt=${jwt}`; url.search = search; } } // fragment/hash let { hash } = url; for (const configName of [ 'config', 'interfaceConfig' ]) { const urlParamsArray = _objectToURLParamsArray( o[`${configName}Overwrite`] || o[configName] || o[`${configName}Override`]); if (urlParamsArray.length) { let urlParamsString = `${configName}.${urlParamsArray.join(`&${configName}.`)}`; if (hash.length) { urlParamsString = `&${urlParamsString}`; } else { hash = '#'; } hash += urlParamsString; } } url.hash = hash; return url.toString() || undefined; }