Rallly is an open-source scheduling and collaboration tool designed to make organizing events and meetings easier.
TypeScript i18nextnext-authnextjspostgresqlprismareact-emailt3-stacktailwindcsstrpcturborepotypescriptzod
import { createHmac } from "node:crypto";
import { describe, expect, it } from "vitest";
import { conferencingSchema } from "./schema";
import {
createZoomUrlValidationResponse,
formatWebexDateTime,
getConferencingUri,
getMicrosoftTeamsAuthority,
getWebexMeetingWindow,
isTeamsMeetingRefusal,
meetSpaceResponseSchema,
meetSpaceToConferencing,
teamsMeetingResponseSchema,
teamsMeetingToConferencing,
verifyZoomWebhookSignature,
webexMeetingResponseSchema,
webexMeetingToConferencing,
zoomMeetingResponseSchema,
zoomMeetingToConferencing,
} from "./utils";
describe("zoomMeetingToConferencing", () => {
it("maps a Zoom meeting into the stored link shape", () => {
const meeting = zoomMeetingResponseSchema.parse({
id: 81234567890,
join_url: "https://zoom.us/j/81234567890?pwd=abc",
password: "abc",
topic: "ignored",
});
const conferencing = zoomMeetingToConferencing(meeting);
expect(conferencing).toEqual({
provider: "zoom",
uri: "https://zoom.us/j/81234567890?pwd=abc",
meetingId: "81234567890",
password: "abc",
});
expect(conferencingSchema.parse(conferencing)).toEqual(conferencing);
expect(getConferencingUri(conferencing)).toBe(
"https://zoom.us/j/81234567890?pwd=abc",
);
});
it("drops an empty password", () => {
const meeting = zoomMeetingResponseSchema.parse({
id: 1,
join_url: "https://zoom.us/j/1",
password: "",
});
expect(zoomMeetingToConferencing(meeting)).toEqual({
provider: "zoom",
uri: "https://zoom.us/j/1",
meetingId: "1",
password: undefined,
});
});
});
describe("meetSpaceToConferencing", () => {
it("maps a Meet space into the stored link shape", () => {
const space = meetSpaceResponseSchema.parse({
name: "spaces/abc",
meetingUri: "https://meet.google.com/abc-defg-hij",
meetingCode: "abc-defg-hij",
});
const conferencing = meetSpaceToConferencing(space);
expect(conferencing).toEqual({
provider: "meet",
uri: "https://meet.google.com/abc-defg-hij",
meetingId: "abc-defg-hij",
});
expect(conferencingSchema.parse(conferencing)).toEqual(conferencing);
});
it("rejects a space without a join link", () => {
expect(
meetSpaceResponseSchema.safeParse({ name: "spaces/abc" }).success,
).toBe(false);
});
});
describe("teamsMeetingToConferencing", () => {
it("maps a Teams meeting into the stored link shape", () => {
const meeting = teamsMeetingResponseSchema.parse({
id: "MSpkYzE3",
joinWebUrl:
"https://teams.microsoft.com/l/meetup-join/19%3ameeting_abc%40thread.v2/0",
subject: "ignored",
joinMeetingIdSettings: {
isPasscodeRequired: true,
joinMeetingId: "1234567890",
passcode: "Xy7Zq2",
},
audioConferencing: null,
});
const conferencing = teamsMeetingToConferencing(meeting);
expect(conferencing).toEqual({
provider: "teams",
uri: "https://teams.microsoft.com/l/meetup-join/19%3ameeting_abc%40thread.v2/0",
meetingId: "1234567890",
password: "Xy7Zq2",
});
expect(conferencingSchema.parse(conferencing)).toEqual(conferencing);
});
it("keeps the link when Graph omits the meeting id settings", () => {
const meeting = teamsMeetingResponseSchema.parse({
joinWebUrl: "https://teams.microsoft.com/l/meetup-join/abc",
joinMeetingIdSettings: null,
});
expect(teamsMeetingToConferencing(meeting)).toEqual({
provider: "teams",
uri: "https://teams.microsoft.com/l/meetup-join/abc",
meetingId: undefined,
password: undefined,
});
});
it("rejects a meeting without a join link", () => {
expect(teamsMeetingResponseSchema.safeParse({ id: "abc" }).success).toBe(
false,
);
});
});
describe("webexMeetingToConferencing", () => {
it("maps a Webex meeting into the stored link shape", () => {
const meeting = webexMeetingResponseSchema.parse({
id: "870f51ff287b41be84648412901e0402",
meetingNumber: "123456789",
title: "ignored",
password: "BgJep@43",
webLink:
"https://site4-example.webex.com/site4/j.php?MTID=md41817da6a55b0925530cb88b3577b1",
sipAddress: "[email protected]",
});
const conferencing = webexMeetingToConferencing(meeting);
expect(conferencing).toEqual({
provider: "webex",
uri: "https://site4-example.webex.com/site4/j.php?MTID=md41817da6a55b0925530cb88b3577b1",
meetingId: "123456789",
password: "BgJep@43",
});
expect(conferencingSchema.parse(conferencing)).toEqual(conferencing);
});
it("rejects a meeting without a join link", () => {
expect(
webexMeetingResponseSchema.safeParse({ meetingNumber: "123456789" })
.success,
).toBe(false);
});
});
describe("formatWebexDateTime", () => {
const date = new Date("2026-10-16T11:00:00Z");
it("writes a zoned time with that zone's offset", () => {
expect(formatWebexDateTime({ date, timeZone: "Europe/London" })).toBe(
"2026-10-16T12:00:00+01:00",
);
expect(formatWebexDateTime({ date, timeZone: "America/New_York" })).toBe(
"2026-10-16T07:00:00-04:00",
);
expect(formatWebexDateTime({ date, timeZone: "Asia/Kolkata" })).toBe(
"2026-10-16T16:30:00+05:30",
);
});
it("follows the offset in force on the day", () => {
expect(
formatWebexDateTime({
date: new Date("2026-12-01T11:00:00Z"),
timeZone: "Europe/London",
}),
).toBe("2026-12-01T11:00:00+00:00");
});
it("writes a floating time in UTC", () => {
expect(formatWebexDateTime({ date, timeZone: null })).toBe(
"2026-10-16T11:00:00.000Z",
);
});
});
describe("getWebexMeetingWindow", () => {
const now = new Date("2026-10-03T09:00:30Z");
it("keeps a future meeting within the allowed length unchanged", () => {
const start = new Date("2026-10-04T10:00:00Z");
const end = new Date("2026-10-04T11:00:00Z");
expect(getWebexMeetingWindow({ start, end, now })).toEqual({ start, end });
});
it("starts a meeting already under way at the next whole minute", () => {
expect(
getWebexMeetingWindow({
start: new Date("2026-10-03T08:30:00Z"),
end: new Date("2026-10-03T09:30:00Z"),
now,
}),
).toEqual({
start: new Date("2026-10-03T09:01:00Z"),
end: new Date("2026-10-03T09:30:00Z"),
});
});
it("lengthens a meeting shorter than 10 minutes", () => {
const start = new Date("2026-10-04T10:00:00Z");
expect(
getWebexMeetingWindow({
start,
end: new Date("2026-10-04T10:05:00Z"),
now,
}),
).toEqual({ start, end: new Date("2026-10-04T10:10:00Z") });
});
it("caps an all day event at 23 hours 59 minutes", () => {
const start = new Date("2026-10-04T00:00:00Z");
expect(
getWebexMeetingWindow({
start,
end: new Date("2026-10-05T00:00:00Z"),
now,
}),
).toEqual({ start, end: new Date("2026-10-04T23:59:00Z") });
});
it("gives an event that has already ended the shortest meeting", () => {
expect(
getWebexMeetingWindow({
start: new Date("2026-10-02T10:00:00Z"),
end: new Date("2026-10-02T11:00:00Z"),
now,
}),
).toEqual({
start: new Date("2026-10-03T09:01:00Z"),
end: new Date("2026-10-03T09:11:00Z"),
});
});
});
describe("isTeamsMeetingRefusal", () => {
it("reads a client error as the account being unable to host", () => {
expect(isTeamsMeetingRefusal(400)).toBe(true);
expect(isTeamsMeetingRefusal(403)).toBe(true);
expect(isTeamsMeetingRefusal(404)).toBe(true);
});
it("does not blame the account for a bad token, a timeout or throttling", () => {
expect(isTeamsMeetingRefusal(401)).toBe(false);
expect(isTeamsMeetingRefusal(408)).toBe(false);
expect(isTeamsMeetingRefusal(429)).toBe(false);
});
it("does not blame the account for a Microsoft outage or a success", () => {
expect(isTeamsMeetingRefusal(500)).toBe(false);
expect(isTeamsMeetingRefusal(503)).toBe(false);
expect(isTeamsMeetingRefusal(201)).toBe(false);
});
});
describe("getMicrosoftTeamsAuthority", () => {
it("keeps personal accounts out of a multitenant registration", () => {
expect(getMicrosoftTeamsAuthority("common")).toBe("organizations");
expect(getMicrosoftTeamsAuthority("consumers")).toBe("organizations");
expect(getMicrosoftTeamsAuthority("organizations")).toBe("organizations");
});
it("keeps a single tenant registration on its tenant", () => {
const tenantId = "6d0cfca5-dad4-4d15-a6cf-1552842fab87";
expect(getMicrosoftTeamsAuthority(tenantId)).toBe(tenantId);
});
});
describe("verifyZoomWebhookSignature", () => {
const secretToken = "zoom-secret-token";
const body = JSON.stringify({ event: "app_deauthorized" });
const now = new Date("2026-09-26T12:00:00Z");
const timestamp = String(now.getTime() / 1000);
const sign = (message: string) =>
`v0=${createHmac("sha256", secretToken).update(message).digest("hex")}`;
it("accepts a request Zoom signed", async () => {
await expect(
verifyZoomWebhookSignature({
secretToken,
signature: sign(`v0:${timestamp}:${body}`),
timestamp,
body,
now,
}),
).resolves.toEqual({ ok: true });
});
it("rejects a body changed after signing", async () => {
await expect(
verifyZoomWebhookSignature({
secretToken,
signature: sign(`v0:${timestamp}:${body}`),
timestamp,
body: body.replace("app_deauthorized", "something_else"),
now,
}),
).resolves.toEqual({ ok: false, reason: "invalid_signature" });
});
it("rejects a signature that is not hex", async () => {
await expect(
verifyZoomWebhookSignature({
secretToken,
signature: "v0=not-hex",
timestamp,
body,
now,
}),
).resolves.toEqual({ ok: false, reason: "invalid_signature" });
});
it("rejects a timestamp more than five minutes away", async () => {
const stale = String(now.getTime() / 1000 - 301);
await expect(
verifyZoomWebhookSignature({
secretToken,
signature: sign(`v0:${stale}:${body}`),
timestamp: stale,
body,
now,
}),
).resolves.toEqual({ ok: false, reason: "stale" });
});
it("rejects a request without the signing headers", async () => {
await expect(
verifyZoomWebhookSignature({
secretToken,
signature: null,
timestamp,
body,
now,
}),
).resolves.toEqual({ ok: false, reason: "missing_headers" });
});
});
describe("createZoomUrlValidationResponse", () => {
it("returns the plain token with its hex HMAC", async () => {
await expect(
createZoomUrlValidationResponse({
secretToken: "zoom-secret-token",
plainToken: "qgg8vlvZRS6UYooatFL8Aw",
}),
).resolves.toEqual({
plainToken: "qgg8vlvZRS6UYooatFL8Aw",
encryptedToken: createHmac("sha256", "zoom-secret-token")
.update("qgg8vlvZRS6UYooatFL8Aw")
.digest("hex"),
});
});
});