feat: add integration options for API v2 update booking location endpoint

apps/api/v2/src/ee/bookings/2024-08-13/bookings.module.ts

@@ -8,7 +8,11 @@ import { BookingReferencesRepository_2024_08_13 } from "@/ee/bookings/2024-08-13
 import { BookingsRepository_2024_08_13 } from "@/ee/bookings/2024-08-13/repositories/bookings.repository";
 import { BookingAttendeesService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/booking-attendees.service";
 import { BookingGuestsService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/booking-guests.service";
+import { BookingLocationCalendarSyncService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/booking-location-calendar-sync.service";
+import { BookingLocationCredentialService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/booking-location-credential.service";
+import { BookingLocationIntegrationService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/booking-location-integration.service";
 import { BookingLocationService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/booking-location.service";
+import { BookingVideoService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/booking-video.service";
 import { BookingReferencesService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/booking-references.service";
 import { BookingsService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/bookings.service";
 import { CalVideoOutputService } from "@/ee/bookings/2024-08-13/services/cal-video.output.service";
@@ -108,7 +112,11 @@ import { UsersModule } from "@/modules/users/users.module";
     CalVideoService,
     CalVideoOutputService,
     BookingPbacGuard,
+    BookingLocationCalendarSyncService_2024_08_13,
+    BookingLocationCredentialService_2024_08_13,
+    BookingLocationIntegrationService_2024_08_13,
     BookingLocationService_2024_08_13,
+    BookingVideoService_2024_08_13,
     PrismaFeaturesRepository,
   ],
   controllers: [

apps/api/v2/src/ee/bookings/2024-08-13/controllers/booking-location.controller.ts

@@ -1,26 +1,26 @@
+import { BOOKING_WRITE, SUCCESS_STATUS } from "@calcom/platform-constants";
+import {
+  UpdateBookingInputAttendeeAddressLocation_2024_08_13,
+  UpdateBookingInputAttendeeDefinedLocation_2024_08_13,
+  UpdateBookingInputAttendeePhoneLocation_2024_08_13,
+  UpdateBookingInputLinkLocation_2024_08_13,
+  UpdateBookingInputPhoneLocation_2024_08_13,
+  UpdateBookingLocationInput_2024_08_13,
+  UpdateInputAddressLocation_2024_08_13,
+} from "@calcom/platform-types";
+import { Body, Controller, HttpCode, HttpStatus, Param, Patch, UseGuards } from "@nestjs/common";
+import { ApiExtraModels, ApiHeader, ApiOperation, ApiTags as DocsTags } from "@nestjs/swagger";
 import { BookingUidGuard } from "@/ee/bookings/2024-08-13/guards/booking-uid.guard";
 import { UpdateBookingLocationOutput_2024_08_13 } from "@/ee/bookings/2024-08-13/outputs/update-location.output";
 import { BookingLocationService_2024_08_13 } from "@/ee/bookings/2024-08-13/services/booking-location.service";
-import { VERSION_2024_08_13_VALUE, VERSION_2024_08_13 } from "@/lib/api-versions";
+import { VERSION_2024_08_13, VERSION_2024_08_13_VALUE } from "@/lib/api-versions";
 import { API_KEY_OR_ACCESS_TOKEN_HEADER } from "@/lib/docs/headers";
+import { Throttle } from "@/lib/endpoint-throttler-decorator";
 import { GetUser } from "@/modules/auth/decorators/get-user/get-user.decorator";
 import { Permissions } from "@/modules/auth/decorators/permissions/permissions.decorator";
 import { ApiAuthGuard } from "@/modules/auth/guards/api-auth/api-auth.guard";
 import { PermissionsGuard } from "@/modules/auth/guards/permissions/permissions.guard";
 import { ApiAuthGuardUser } from "@/modules/auth/strategies/api-auth/api-auth.strategy";
-import { Controller, Patch, Logger, Body, UseGuards, Param, HttpCode, HttpStatus } from "@nestjs/common";
-import { ApiExtraModels, ApiOperation, ApiTags as DocsTags, ApiHeader } from "@nestjs/swagger";
-
-import { BOOKING_WRITE, SUCCESS_STATUS } from "@calcom/platform-constants";
-import {
-  UpdateBookingLocationInput_2024_08_13,
-  UpdateInputAddressLocation_2024_08_13,
-  UpdateBookingInputAttendeeAddressLocation_2024_08_13,
-  UpdateBookingInputAttendeeDefinedLocation_2024_08_13,
-  UpdateBookingInputAttendeePhoneLocation_2024_08_13,
-  UpdateBookingInputLinkLocation_2024_08_13,
-  UpdateBookingInputPhoneLocation_2024_08_13,
-} from "@calcom/platform-types";
 
 @Controller({
   path: "/v2/bookings/:bookingUid/location",
@@ -43,20 +43,23 @@ import {
   required: true,
 })
 export class BookingLocationController_2024_08_13 {
-  private readonly logger = new Logger("BookingLocationController_2024_08_13");
-
   constructor(private readonly bookingLocationService: BookingLocationService_2024_08_13) {}
 
   @Patch("/")
   @HttpCode(HttpStatus.OK)
+  @Throttle({ name: "booking_location_update", limit: 5, ttl: 60000, blockDuration: 60000 })
   @Permissions([BOOKING_WRITE])
   @UseGuards(ApiAuthGuard, BookingUidGuard)
   @ApiHeader(API_KEY_OR_ACCESS_TOKEN_HEADER)
   @ApiOperation({
     summary: "Update booking location for an existing booking",
-    description: `**Current Limitation:** Updating a booking location will update the location in Cal.com, but the corresponding Calendar event will not be updated automatically. The old location will persist in the Calendar event. This is a known limitation that will be addressed in a future update.
-
-    <Note>The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error.</Note>`,
+    description: `Updates the location for an existing booking.
+
+**Integration Fallback Behavior:**
+- **Google Meet**: Requires Google Calendar to be connected. If the booking has no Google Calendar event, it will automatically fall back to Cal Video.
+- **MS Teams**: If Office 365 Calendar is connected, generates the meeting link via calendar. Otherwise, uses the MS Teams video integration directly.
+
+<Note>The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error.</Note>`,
   })
   async updateBookingLocation(
     @Param("bookingUid") bookingUid: string,