snapshot of https://github.com/jitsi/jitsi-meet.git @ fd1749dd28f4138aa80234fc7f311b19aaffa0e7 (2026-09-15)

react/features/invite/_utils.ts

@@ -0,0 +1,88 @@
+/**
+ * Utility class with no dependencies. Used in components that are stripped in separate bundles
+ * and requires as less dependencies as possible.
+ */
+
+import { getURLWithoutParams } from '../base/connection/utils';
+import { doGetJSON } from '../base/util/httpUtils';
+
+/**
+ * Formats the conference pin in readable way for UI to display it.
+ * Formats the pin in 3 groups of digits:
+ * XXXX XXXX XX or XXXXX XXXXX XXX.
+ * The length of first and second group is Math.ceil(pin.length / 3).
+ *
+ * @param {Object} conferenceID - The conference id to format, string or number.
+ * @returns {string} - The formatted conference pin.
+ * @private
+ */
+export function _formatConferenceIDPin(conferenceID: Object) {
+    const conferenceIDStr = conferenceID.toString();
+
+    // let's split the conferenceID in 3 parts, to be easier to read
+    const partLen = Math.ceil(conferenceIDStr.length / 3);
+
+    return `${
+        conferenceIDStr.substring(0, partLen)} ${
+        conferenceIDStr.substring(partLen, 2 * partLen)} ${
+        conferenceIDStr.substring(2 * partLen, conferenceIDStr.length)}`;
+}
+
+/**
+ * Sends a GET request to obtain the conference ID necessary for identifying
+ * which conference to join after dialing the dial-in service.
+ * This function is used not only in the main app bundle but in separate bundles for the dial in numbers page,
+ * and we do want to limit the dependencies.
+ *
+ * @param {string} baseUrl - The url for obtaining the conference ID (pin) for
+ * dialing into a conference.
+ * @param {string} roomName - The conference name to find the associated
+ * conference ID.
+ * @param {string} mucURL - In which MUC the conference exists.
+ * @param {URL} url - The address we are loaded in.
+ * @returns {Promise} - The promise created by the request.
+ */
+export function getDialInConferenceID(
+        baseUrl: string,
+        roomName: string,
+        mucURL: string,
+        url: URL
+): Promise<any> {
+    const separator = baseUrl.includes('?') ? '&' : '?';
+    const conferenceIDURL
+        = `${baseUrl}${separator}conference=${roomName}@${mucURL}&url=${getURLWithoutParams(url).href}`;
+
+    return doGetJSON(conferenceIDURL, true);
+}
+
+/**
+ * Sends a GET request for phone numbers used to dial into a conference.
+ * This function is used not only in the main app bundle but in separate bundles for the dial in numbers page,
+ * and we do want to limit the dependencies.
+ *
+ * @param {string} url - The service that returns conference dial-in numbers.
+ * @param {string} roomName - The conference name to find the associated
+ * conference ID.
+ * @param {string} mucURL - In which MUC the conference exists.
+ * @returns {Promise} - The promise created by the request. The returned numbers
+ * may be an array of Objects containing numbers, with keys countryCode,
+ * tollFree, formattedNumber or an object with countries as keys and arrays of
+ * phone number strings, as the second one should not be used and is deprecated.
+ */
+export function getDialInNumbers(
+        url?: string,
+        roomName?: string,
+        mucURL?: string
+): Promise<any> {
+
+    if (!url || !roomName || !mucURL) {
+        return Promise.resolve();
+    }
+
+    const separator = url.includes('?') ? '&' : '?';
+
+    // when roomName and mucURL are available
+    // provide conference when looking up dial in numbers
+
+    return doGetJSON(url + (roomName && mucURL ? `${separator}conference=${roomName}@${mucURL}` : ''), true);
+}