Files
zulip/web/src/compose_call_ui.ts
Lauryn Menard 8561800676 video-calls: Add Zoom Serverto Server OAuth integration.
Adds a second Zoom integration that uses the Zoom Server to Server
OAuth app process. Only one of the two Zoom integrations can be
configured on a Zulip server.

Adds a cache for the access token from the Zoom server so that it
can be used by the server to create meetings for the approximate
duration of the access token

In the web-app compose box, if the user's delivery email does not
match a user on the configured Zoom account for the server to server
integration, then a compose box error banner will be shown when the
error response is received after clicking/selecting the video or
audio call button.

Also updates the production documentation for the both types of Zoom
integration apps (Server to Server and General). The General app
process for Zoom now requires unlisted apps to go through their
review process, which we now have documented.

Fixes #33117.
2025-02-13 16:35:43 -08:00

178 lines
7.3 KiB
TypeScript

import $ from "jquery";
import {z} from "zod";
import * as channel from "./channel.ts";
import * as compose_banner from "./compose_banner.ts";
import * as compose_call from "./compose_call.ts";
import {get_recipient_label} from "./compose_closed_ui.ts";
import * as compose_ui from "./compose_ui.ts";
import {$t, $t_html} from "./i18n.ts";
import * as rows from "./rows.ts";
import {current_user, realm} from "./state_data.ts";
import * as ui_report from "./ui_report.ts";
import * as util from "./util.ts";
const call_response_schema = z.object({
msg: z.string(),
result: z.string(),
url: z.string(),
});
export function update_audio_and_video_chat_button_display(): void {
update_audio_chat_button_display();
update_video_chat_button_display();
}
export function update_video_chat_button_display(): void {
const show_video_chat_button = compose_call.compute_show_video_chat_button();
$(".compose-control-buttons-container .video_link").toggle(show_video_chat_button);
$(".message-edit-feature-group .video_link").toggle(show_video_chat_button);
}
export function update_audio_chat_button_display(): void {
const show_audio_chat_button = compose_call.compute_show_audio_chat_button();
$(".compose-control-buttons-container .audio_link").toggle(show_audio_chat_button);
$(".message-edit-feature-group .audio_link").toggle(show_audio_chat_button);
}
function insert_video_call_url(url: string, $target_textarea: JQuery<HTMLTextAreaElement>): void {
const link_text = $t({defaultMessage: "Join video call."});
compose_ui.insert_syntax_and_focus(`[${link_text}](${url})`, $target_textarea, "block", 1);
}
function insert_audio_call_url(url: string, $target_textarea: JQuery<HTMLTextAreaElement>): void {
const link_text = $t({defaultMessage: "Join voice call."});
compose_ui.insert_syntax_and_focus(`[${link_text}](${url})`, $target_textarea, "block", 1);
}
export function generate_and_insert_audio_or_video_call_link(
$target_element: JQuery,
is_audio_call: boolean,
): void {
let $target_textarea: JQuery<HTMLTextAreaElement>;
let edit_message_id: string | undefined;
if ($target_element.parents(".message_edit_form").length === 1) {
edit_message_id = rows.id($target_element.parents(".message_row")).toString();
$target_textarea = $(`#edit_form_${CSS.escape(edit_message_id)} .message_edit_content`);
} else {
$target_textarea = $<HTMLTextAreaElement>("textarea#compose-textarea");
}
const available_providers = realm.realm_available_video_chat_providers;
const provider_is_zoom =
available_providers.zoom && realm.realm_video_chat_provider === available_providers.zoom.id;
const provider_is_zoom_server_to_server =
available_providers.zoom_server_to_server &&
realm.realm_video_chat_provider === available_providers.zoom_server_to_server.id;
if (provider_is_zoom || provider_is_zoom_server_to_server) {
compose_call.abort_video_callbacks(edit_message_id);
const key = edit_message_id ?? "";
const request = {
is_video_call: !is_audio_call,
};
const make_zoom_call = (): void => {
const xhr = channel.post({
url: "/json/calls/zoom/create",
data: request,
success(res) {
const data = call_response_schema.parse(res);
compose_call.video_call_xhrs.delete(key);
if (is_audio_call) {
insert_audio_call_url(data.url, $target_textarea);
} else {
insert_video_call_url(data.url, $target_textarea);
}
},
error(xhr, status) {
compose_call.video_call_xhrs.delete(key);
const parsed = z.object({code: z.string()}).safeParse(xhr.responseJSON);
if (
status === "error" &&
parsed.success &&
parsed.data.code === "INVALID_ZOOM_TOKEN"
) {
current_user.has_zoom_token = false;
}
if (
status === "error" &&
parsed.success &&
parsed.data.code === "UNKNOWN_ZOOM_USER"
) {
compose_banner.show_unknown_zoom_user_error(current_user.delivery_email);
} else if (status !== "abort") {
ui_report.generic_embed_error(
$t_html({defaultMessage: "Failed to create video call."}),
);
}
},
});
if (xhr !== undefined) {
compose_call.video_call_xhrs.set(key, xhr);
}
};
if (current_user.has_zoom_token || provider_is_zoom_server_to_server) {
make_zoom_call();
} else {
compose_call.zoom_token_callbacks.set(key, make_zoom_call);
window.open(
window.location.protocol + "//" + window.location.host + "/calls/zoom/register",
"_blank",
"width=800,height=500,noopener,noreferrer",
);
}
} else if (
available_providers.big_blue_button &&
realm.realm_video_chat_provider === available_providers.big_blue_button.id
) {
const meeting_name = `${get_recipient_label()?.label_text ?? ""} meeting`;
const request = {
meeting_name,
voice_only: is_audio_call,
};
void channel.get({
url: "/json/calls/bigbluebutton/create",
data: request,
success(response) {
const data = call_response_schema.parse(response);
if (is_audio_call) {
insert_audio_call_url(data.url, $target_textarea);
} else {
insert_video_call_url(data.url, $target_textarea);
}
},
});
} else {
// TODO: Use `new URL` to generate the URLs here.
const video_call_id = util.random_int(100000000000000, 999999999999999);
const video_call_link = compose_call.get_jitsi_server_url() + "/" + video_call_id;
if (is_audio_call) {
insert_audio_call_url(
video_call_link + "#config.startWithVideoMuted=true",
$target_textarea,
);
} else {
/* Because Jitsi remembers what last call type you joined
in browser local storage, we need to specify that video
should not be muted in the video call case, or your
next call will also join without video after joining an
audio-only call.
This has the annoying downside that it requires users
who have a personal preference to disable video every
time, but Jitsi's UI makes that very easy to do, and
that inconvenience is probably less important than letting
the person organizing a call specify their intended
call type (video vs audio).
*/
insert_video_call_url(
video_call_link + "#config.startWithVideoMuted=false",
$target_textarea,
);
}
}
}