* fix: validate Round Robin host availability in handleNewBooking - Add validation to ensure Round Robin events have at least one available non-fixed host - Throw NoAvailableUsersFound error when no Round Robin hosts are available - Add unit test to verify the fix works correctly - Fixes issue where Round Robin events with fixed hosts could be booked without Round Robin hosts Co-Authored-By: carina@cal.com <c.wollendorfer@me.com> * test: fix host configuration in Round Robin test Co-Authored-By: carina@cal.com <c.wollendorfer@me.com> * test: improve Round Robin test to only make RR host busy Co-Authored-By: carina@cal.com <c.wollendorfer@me.com> * fix: correct Round Robin validation to only check when RR hosts assigned Co-Authored-By: carina@cal.com <c.wollendorfer@me.com> * fix: refine Round Robin validation to only apply when both fixed and RR hosts present - Add fixedUserPool.length > 0 condition to validation - Ensures validation only triggers for specific bug scenario: events with fixed hosts + RR hosts but no available RR hosts - Prevents blocking normal Round Robin events that only have RR hosts - Updates test description to reflect more precise validation logic Co-Authored-By: carina@cal.com <c.wollendorfer@me.com> * fix: simplify Round Robin validation to resolve E2E test failures Remove overly restrictive fixedUserPool.length > 0 condition that was blocking valid Round Robin booking scenarios in E2E tests. The validation now only checks if Round Robin hosts are assigned but none are available, which is the intended behavior for the bug fix. Co-Authored-By: carina@cal.com <c.wollendorfer@me.com> * fix: restore fixedUserPool condition to Round Robin validation - Add back fixedUserPool.length > 0 condition to make validation specific to bug scenario - Only triggers when Round Robin events have both fixed hosts AND Round Robin hosts but no available Round Robin hosts - Prevents blocking normal Round Robin events that only have Round Robin hosts (like in organization settings E2E test) - Updates test description to reflect more precise validation logic Co-Authored-By: carina@cal.com <c.wollendorfer@me.com> Co-Authored-By: carina@cal.com <c.wollendorfer@me.com> * throw error if no RR user is available * add tests * fix comments * revert change * remove comments --------- Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Co-authored-by: CarinaWolli <wollencarina@gmail.com>
456 lines
15 KiB
TypeScript
456 lines
15 KiB
TypeScript
// eslint-disable-next-line no-restricted-imports
|
|
import { cloneDeep } from "lodash";
|
|
|
|
import { OrganizerDefaultConferencingAppType, getLocationValueForDB } from "@calcom/app-store/locations";
|
|
import dayjs from "@calcom/dayjs";
|
|
import {
|
|
sendRoundRobinCancelledEmailsAndSMS,
|
|
sendRoundRobinScheduledEmailsAndSMS,
|
|
sendRoundRobinUpdatedEmailsAndSMS,
|
|
} from "@calcom/emails";
|
|
import getBookingResponsesSchema from "@calcom/features/bookings/lib/getBookingResponsesSchema";
|
|
import { getCalEventResponses } from "@calcom/features/bookings/lib/getCalEventResponses";
|
|
import { ensureAvailableUsers } from "@calcom/features/bookings/lib/handleNewBooking/ensureAvailableUsers";
|
|
import { getEventTypesFromDB } from "@calcom/features/bookings/lib/handleNewBooking/getEventTypesFromDB";
|
|
import type { IsFixedAwareUser } from "@calcom/features/bookings/lib/handleNewBooking/types";
|
|
import AssignmentReasonRecorder, {
|
|
RRReassignmentType,
|
|
} from "@calcom/features/ee/round-robin/assignmentReason/AssignmentReasonRecorder";
|
|
import {
|
|
enrichHostsWithDelegationCredentials,
|
|
enrichUserWithDelegationCredentialsIncludeServiceAccountKey,
|
|
} from "@calcom/lib/delegationCredential/server";
|
|
import { getEventName } from "@calcom/lib/event";
|
|
import { IdempotencyKeyService } from "@calcom/lib/idempotencyKey/idempotencyKeyService";
|
|
import { isPrismaObjOrUndefined } from "@calcom/lib/isPrismaObj";
|
|
import logger from "@calcom/lib/logger";
|
|
import { getLuckyUser } from "@calcom/lib/server/getLuckyUser";
|
|
import { getTranslation } from "@calcom/lib/server/i18n";
|
|
import { getTimeFormatStringFromUserTimeFormat } from "@calcom/lib/timeFormat";
|
|
import { prisma } from "@calcom/prisma";
|
|
import { userMetadata as userMetadataSchema } from "@calcom/prisma/zod-utils";
|
|
import type { EventTypeMetadata, PlatformClientParams } from "@calcom/prisma/zod-utils";
|
|
import type { CalendarEvent } from "@calcom/types/Calendar";
|
|
|
|
import { handleRescheduleEventManager } from "./handleRescheduleEventManager";
|
|
import { handleWorkflowsUpdate } from "./roundRobinManualReassignment";
|
|
import { bookingSelect } from "./utils/bookingSelect";
|
|
import { getDestinationCalendar } from "./utils/getDestinationCalendar";
|
|
import { getTeamMembers } from "./utils/getTeamMembers";
|
|
|
|
export const roundRobinReassignment = async ({
|
|
bookingId,
|
|
orgId,
|
|
emailsEnabled = true,
|
|
platformClientParams,
|
|
reassignedById,
|
|
}: {
|
|
bookingId: number;
|
|
orgId: number | null;
|
|
emailsEnabled?: boolean;
|
|
platformClientParams?: PlatformClientParams;
|
|
reassignedById: number;
|
|
}) => {
|
|
const roundRobinReassignLogger = logger.getSubLogger({
|
|
prefix: ["roundRobinReassign", `${bookingId}`],
|
|
});
|
|
|
|
roundRobinReassignLogger.info(`User ${reassignedById} initiating round robin reassignment`);
|
|
|
|
let booking = await prisma.booking.findUnique({
|
|
where: {
|
|
id: bookingId,
|
|
},
|
|
select: bookingSelect,
|
|
});
|
|
|
|
if (!booking) {
|
|
logger.error(`Booking ${bookingId} not found`);
|
|
throw new Error("Booking not found");
|
|
}
|
|
|
|
if (!booking.user) {
|
|
logger.error(`No user associated with booking ${bookingId}`);
|
|
throw new Error("Booking not found");
|
|
}
|
|
|
|
const eventTypeId = booking.eventTypeId;
|
|
|
|
if (!eventTypeId) {
|
|
logger.error(`Booking ${bookingId} does not have an event type id`);
|
|
throw new Error("Event type not found");
|
|
}
|
|
|
|
const eventType = await getEventTypesFromDB(eventTypeId);
|
|
|
|
if (!eventType) {
|
|
logger.error(`Event type ${eventTypeId} not found`);
|
|
throw new Error("Event type not found");
|
|
}
|
|
|
|
eventType.hosts = eventType.hosts.length
|
|
? eventType.hosts
|
|
: eventType.users.map((user) => ({
|
|
user,
|
|
isFixed: false,
|
|
priority: 2,
|
|
weight: 100,
|
|
schedule: null,
|
|
createdAt: new Date(0), // use earliest possible date as fallback
|
|
}));
|
|
|
|
const roundRobinHosts = eventType.hosts.filter((host) => !host.isFixed);
|
|
|
|
const originalOrganizer = booking.user;
|
|
|
|
const attendeeEmailsSet = new Set(booking.attendees.map((attendee) => attendee.email));
|
|
|
|
// Find the current round robin host assigned
|
|
const previousRRHost = (() => {
|
|
for (const host of roundRobinHosts) {
|
|
if (host.user.id === booking.userId) {
|
|
return host.user;
|
|
}
|
|
if (attendeeEmailsSet.has(host.user.email)) {
|
|
return host.user;
|
|
}
|
|
}
|
|
})();
|
|
|
|
const previousRRHostT = await getTranslation(previousRRHost?.locale || "en", "common");
|
|
|
|
const eventTypeHosts = await enrichHostsWithDelegationCredentials({
|
|
orgId,
|
|
hosts: eventType.hosts,
|
|
});
|
|
// Filter out the current attendees of the booking from the event type
|
|
const availableEventTypeUsers = eventTypeHosts.reduce((availableUsers, host) => {
|
|
if (!attendeeEmailsSet.has(host.user.email) && host.user.email !== originalOrganizer.email) {
|
|
availableUsers.push({ ...host.user, isFixed: host.isFixed, priority: host?.priority ?? 2 });
|
|
}
|
|
return availableUsers;
|
|
}, [] as IsFixedAwareUser[]);
|
|
|
|
const availableUsers = await ensureAvailableUsers(
|
|
{ ...eventType, users: availableEventTypeUsers },
|
|
{
|
|
dateFrom: dayjs(booking.startTime).format(),
|
|
dateTo: dayjs(booking.endTime).format(),
|
|
timeZone: eventType.timeZone || originalOrganizer.timeZone,
|
|
},
|
|
roundRobinReassignLogger
|
|
);
|
|
|
|
const reassignedRRHost = await getLuckyUser({
|
|
availableUsers,
|
|
eventType,
|
|
allRRHosts: eventTypeHosts.filter((host) => !host.isFixed), // todo: only use hosts from virtual queue
|
|
routingFormResponse: null,
|
|
});
|
|
|
|
const hasOrganizerChanged = !previousRRHost || booking.userId === previousRRHost?.id;
|
|
const organizer = hasOrganizerChanged ? reassignedRRHost : booking.user;
|
|
const organizerT = await getTranslation(organizer?.locale || "en", "common");
|
|
|
|
const currentBookingTitle = booking.title;
|
|
let newBookingTitle = currentBookingTitle;
|
|
|
|
const reassignedRRHostT = await getTranslation(reassignedRRHost.locale || "en", "common");
|
|
|
|
const teamMembers = await getTeamMembers({
|
|
eventTypeHosts: eventType.hosts,
|
|
attendees: booking.attendees,
|
|
organizer: organizer,
|
|
previousHost: previousRRHost || null,
|
|
reassignedHost: reassignedRRHost,
|
|
});
|
|
|
|
const attendeePromises = [];
|
|
for (const attendee of booking.attendees) {
|
|
if (
|
|
attendee.email === reassignedRRHost.email ||
|
|
attendee.email === previousRRHost?.email ||
|
|
teamMembers.some((member) => member.email === attendee.email)
|
|
) {
|
|
continue;
|
|
}
|
|
|
|
attendeePromises.push(
|
|
getTranslation(attendee.locale ?? "en", "common").then((tAttendee) => ({
|
|
email: attendee.email,
|
|
name: attendee.name,
|
|
timeZone: attendee.timeZone,
|
|
language: { translate: tAttendee, locale: attendee.locale ?? "en" },
|
|
phoneNumber: attendee.phoneNumber || undefined,
|
|
}))
|
|
);
|
|
}
|
|
|
|
const attendeeList = await Promise.all(attendeePromises);
|
|
let bookingLocation = booking.location;
|
|
|
|
if (hasOrganizerChanged) {
|
|
const bookingResponses = booking.responses;
|
|
|
|
const responseSchema = getBookingResponsesSchema({
|
|
bookingFields: eventType.bookingFields,
|
|
view: "reschedule",
|
|
});
|
|
|
|
const responseSafeParse = await responseSchema.safeParseAsync(bookingResponses);
|
|
|
|
const responses = responseSafeParse.success ? responseSafeParse.data : undefined;
|
|
|
|
if (eventType.locations.some((location) => location.type === OrganizerDefaultConferencingAppType)) {
|
|
const organizerMetadataSafeParse = userMetadataSchema.safeParse(reassignedRRHost.metadata);
|
|
|
|
const defaultLocationUrl = organizerMetadataSafeParse.success
|
|
? organizerMetadataSafeParse?.data?.defaultConferencingApp?.appLink
|
|
: undefined;
|
|
|
|
const currentBookingLocation = booking.location || "integrations:daily";
|
|
|
|
bookingLocation =
|
|
defaultLocationUrl ||
|
|
getLocationValueForDB(currentBookingLocation, eventType.locations).bookingLocation;
|
|
}
|
|
|
|
const eventNameObject = {
|
|
attendeeName: responses?.name || "Nameless",
|
|
eventType: eventType.title,
|
|
eventName: eventType.eventName,
|
|
// we send on behalf of team if >1 round robin attendee | collective
|
|
teamName: teamMembers.length > 1 ? eventType.team?.name : null,
|
|
// TODO: Can we have an unnamed organizer? If not, I would really like to throw an error here.
|
|
host: organizer.name || "Nameless",
|
|
location: bookingLocation || "integrations:daily",
|
|
bookingFields: { ...responses },
|
|
eventDuration: dayjs(booking.endTime).diff(booking.startTime, "minutes"),
|
|
t: organizerT,
|
|
};
|
|
|
|
newBookingTitle = getEventName(eventNameObject);
|
|
|
|
booking = await prisma.booking.update({
|
|
where: {
|
|
id: bookingId,
|
|
},
|
|
data: {
|
|
userId: reassignedRRHost.id,
|
|
userPrimaryEmail: reassignedRRHost.email,
|
|
title: newBookingTitle,
|
|
idempotencyKey: IdempotencyKeyService.generate({
|
|
startTime: booking.startTime,
|
|
endTime: booking.endTime,
|
|
userId: reassignedRRHost.id,
|
|
reassignedById,
|
|
}),
|
|
},
|
|
select: bookingSelect,
|
|
});
|
|
} else {
|
|
const previousRRHostAttendee = booking.attendees.find(
|
|
(attendee) => attendee.email === previousRRHost.email
|
|
);
|
|
await prisma.attendee.update({
|
|
where: {
|
|
id: previousRRHostAttendee!.id,
|
|
},
|
|
data: {
|
|
name: reassignedRRHost.name || "",
|
|
email: reassignedRRHost.email,
|
|
timeZone: reassignedRRHost.timeZone,
|
|
locale: reassignedRRHost.locale,
|
|
},
|
|
});
|
|
}
|
|
|
|
roundRobinReassignLogger.info(`Successfully reassigned to user ${reassignedRRHost.id}`);
|
|
|
|
await AssignmentReasonRecorder.roundRobinReassignment({
|
|
bookingId,
|
|
reassignById: reassignedById,
|
|
reassignmentType: RRReassignmentType.ROUND_ROBIN,
|
|
});
|
|
|
|
const destinationCalendar = await getDestinationCalendar({
|
|
eventType,
|
|
booking,
|
|
newUserId: reassignedRRHost.id,
|
|
hasOrganizerChanged,
|
|
});
|
|
|
|
// If changed owner, also change destination calendar
|
|
const previousHostDestinationCalendar = hasOrganizerChanged
|
|
? await prisma.destinationCalendar.findFirst({
|
|
where: {
|
|
userId: originalOrganizer.id,
|
|
},
|
|
})
|
|
: null;
|
|
|
|
const evt: CalendarEvent = {
|
|
organizer: {
|
|
name: organizer.name || "",
|
|
email: organizer.email,
|
|
language: {
|
|
locale: organizer.locale || "en",
|
|
translate: organizerT,
|
|
},
|
|
timeZone: organizer.timeZone,
|
|
timeFormat: getTimeFormatStringFromUserTimeFormat(organizer.timeFormat),
|
|
},
|
|
startTime: dayjs(booking.startTime).utc().format(),
|
|
endTime: dayjs(booking.endTime).utc().format(),
|
|
type: eventType.slug,
|
|
title: newBookingTitle,
|
|
description: eventType.description,
|
|
attendees: attendeeList,
|
|
uid: booking.uid,
|
|
destinationCalendar,
|
|
team: {
|
|
members: teamMembers,
|
|
name: eventType.team?.name || "",
|
|
id: eventType.team?.id || 0,
|
|
},
|
|
customInputs: isPrismaObjOrUndefined(booking.customInputs),
|
|
...getCalEventResponses({
|
|
bookingFields: eventType?.bookingFields ?? null,
|
|
booking,
|
|
}),
|
|
hideOrganizerEmail: eventType.hideOrganizerEmail,
|
|
customReplyToEmail: eventType?.customReplyToEmail,
|
|
location: bookingLocation,
|
|
...(platformClientParams ? platformClientParams : {}),
|
|
};
|
|
|
|
const credentials = await prisma.credential.findMany({
|
|
where: {
|
|
userId: organizer.id,
|
|
},
|
|
include: {
|
|
user: {
|
|
select: {
|
|
email: true,
|
|
},
|
|
},
|
|
},
|
|
});
|
|
|
|
const organizerWithCredentials = await enrichUserWithDelegationCredentialsIncludeServiceAccountKey({
|
|
user: { ...organizer, credentials },
|
|
});
|
|
|
|
const { evtWithAdditionalInfo } = await handleRescheduleEventManager({
|
|
evt,
|
|
rescheduleUid: booking.uid,
|
|
newBookingId: undefined,
|
|
changedOrganizer: hasOrganizerChanged,
|
|
previousHostDestinationCalendar: previousHostDestinationCalendar ? [previousHostDestinationCalendar] : [],
|
|
initParams: {
|
|
user: organizerWithCredentials,
|
|
eventType,
|
|
},
|
|
bookingId,
|
|
bookingLocation,
|
|
bookingICalUID: booking.iCalUID,
|
|
bookingMetadata: booking.metadata,
|
|
});
|
|
|
|
const { cancellationReason, ...evtWithoutCancellationReason } = evtWithAdditionalInfo;
|
|
|
|
// Send to new RR host
|
|
if (emailsEnabled) {
|
|
await sendRoundRobinScheduledEmailsAndSMS({
|
|
calEvent: evtWithoutCancellationReason,
|
|
members: [
|
|
{
|
|
...reassignedRRHost,
|
|
name: reassignedRRHost.name || "",
|
|
username: reassignedRRHost.username || "",
|
|
timeFormat: getTimeFormatStringFromUserTimeFormat(reassignedRRHost.timeFormat),
|
|
language: { translate: reassignedRRHostT, locale: reassignedRRHost.locale || "en" },
|
|
},
|
|
],
|
|
});
|
|
}
|
|
|
|
if (previousRRHost) {
|
|
// Send to cancelled RR host
|
|
// First we need to replace the new RR host with the old RR host in the evt object
|
|
const cancelledRRHostEvt = cloneDeep(evtWithAdditionalInfo);
|
|
cancelledRRHostEvt.title = currentBookingTitle;
|
|
if (hasOrganizerChanged) {
|
|
cancelledRRHostEvt.organizer = {
|
|
name: previousRRHost.name || "",
|
|
email: previousRRHost.email,
|
|
language: {
|
|
locale: previousRRHost.locale || "en",
|
|
translate: previousRRHostT,
|
|
},
|
|
timeZone: previousRRHost.timeZone,
|
|
timeFormat: getTimeFormatStringFromUserTimeFormat(previousRRHost.timeFormat),
|
|
};
|
|
} else if (cancelledRRHostEvt.team) {
|
|
// Filter out the new RR host from attendees and add the old RR host
|
|
const newMembersArray = cancelledRRHostEvt.team?.members || [];
|
|
cancelledRRHostEvt.team.members = newMembersArray.filter(
|
|
(member) => member.email !== reassignedRRHost.email
|
|
);
|
|
cancelledRRHostEvt.team.members.unshift({
|
|
id: previousRRHost.id,
|
|
email: previousRRHost.email,
|
|
name: previousRRHost.name || "",
|
|
timeZone: previousRRHost.timeZone,
|
|
language: { translate: previousRRHostT, locale: previousRRHost.locale || "en" },
|
|
});
|
|
}
|
|
|
|
if (emailsEnabled) {
|
|
await sendRoundRobinCancelledEmailsAndSMS(
|
|
cancelledRRHostEvt,
|
|
[
|
|
{
|
|
...previousRRHost,
|
|
name: previousRRHost.name || "",
|
|
username: previousRRHost.username || "",
|
|
timeFormat: getTimeFormatStringFromUserTimeFormat(previousRRHost.timeFormat),
|
|
language: { translate: previousRRHostT, locale: previousRRHost.locale || "en" },
|
|
},
|
|
],
|
|
eventType?.metadata as EventTypeMetadata,
|
|
{ name: reassignedRRHost.name, email: reassignedRRHost.email }
|
|
);
|
|
}
|
|
}
|
|
|
|
// Handle changing workflows with organizer
|
|
if (hasOrganizerChanged) {
|
|
if (emailsEnabled && dayjs(evt.startTime).isAfter(dayjs())) {
|
|
// send email with event updates to attendees
|
|
await sendRoundRobinUpdatedEmailsAndSMS({
|
|
calEvent: evtWithoutCancellationReason,
|
|
});
|
|
}
|
|
|
|
await handleWorkflowsUpdate({
|
|
booking,
|
|
newUser: reassignedRRHost,
|
|
evt: evtWithAdditionalInfo,
|
|
eventType,
|
|
orgId,
|
|
});
|
|
}
|
|
|
|
return {
|
|
bookingId,
|
|
reassignedTo: {
|
|
id: reassignedRRHost.id,
|
|
name: reassignedRRHost.name,
|
|
email: reassignedRRHost.email,
|
|
},
|
|
};
|
|
};
|
|
|
|
export default roundRobinReassignment;
|