feat(unified-cal): connection-based unified calendar API with CRUD, freebusy, and list connections

apps/api/v2/src/ee/calendars/services/calendars.service.ts

@@ -1,4 +1,5 @@
 import { APPS_TYPE_ID_MAPPING } from "@calcom/platform-constants";
+import type { ConnectedDestinationCalendars } from "@calcom/platform-libraries";
 import {
   type EventBusyDate,
   getBusyCalendarTimes,
@@ -51,7 +52,10 @@ export class CalendarsService {
       .filter((credential) => !!credential);
   }
 
-  async getCalendars(userId: number, ensureDefaultSelectedCalendars = false) {
+  async getCalendars(
+    userId: number,
+    ensureDefaultSelectedCalendars = false
+  ): Promise<ConnectedDestinationCalendars> {
     const cachedResult = await this.calendarsCacheService.getConnectedAndDestinationCalendarsCache(userId);
 
     if (cachedResult && !ensureDefaultSelectedCalendars) {
@@ -79,6 +83,26 @@ export class CalendarsService {
     return result;
   }
 
+  /**
+   * Delegates to getCalendars() (which is cached by CalendarsCacheService) because the
+   * upstream platform-libraries API only supports fetching all credentials at once —
+   * a targeted single-credential query is tracked as a future optimisation.
+   */
+  async getCalendarsForConnection(
+    userId: number,
+    credentialId: number
+  ): Promise<ConnectedDestinationCalendars> {
+    const full = await this.getCalendars(userId);
+    const conn = full.connectedCalendars.find((c) => c.credentialId === credentialId);
+    if (!conn) {
+      throw new NotFoundException("Calendar connection not found");
+    }
+    return {
+      ...full,
+      connectedCalendars: [conn],
+    };
+  }
+
   async getBusyTimes(
     calendarsToLoad: Calendar[],
     userId: User["id"],

apps/api/v2/src/modules/cal-unified-calendars/cal-unified-calendars.module.ts

@@ -1,25 +1,29 @@
+import { Module } from "@nestjs/common";
 import { BookingReferencesRepository_2024_08_13 } from "@/ee/bookings/2024-08-13/repositories/booking-references.repository";
 import { CalendarsRepository } from "@/ee/calendars/calendars.repository";
-import { CalendarsCacheService } from "@/ee/calendars/services/calendars-cache.service";
 import { CalendarsService } from "@/ee/calendars/services/calendars.service";
+import { CalendarsCacheService } from "@/ee/calendars/services/calendars-cache.service";
 import { GoogleCalendarService as GCalService } from "@/ee/calendars/services/gcal.service";
 import { AppsRepository } from "@/modules/apps/apps.repository";
 import { CalUnifiedCalendarsController } from "@/modules/cal-unified-calendars/controllers/cal-unified-calendars.controller";
 import { GoogleCalendarService } from "@/modules/cal-unified-calendars/services/google-calendar.service";
+import { UnifiedCalendarService } from "@/modules/cal-unified-calendars/services/unified-calendar.service";
+import { UnifiedCalendarsFreebusyService } from "@/modules/cal-unified-calendars/services/unified-calendars-freebusy.service";
 import { CredentialsRepository } from "@/modules/credentials/credentials.repository";
 import { PrismaReadService } from "@/modules/prisma/prisma-read.service";
 import { PrismaWriteService } from "@/modules/prisma/prisma-write.service";
 import { RedisModule } from "@/modules/redis/redis.module";
 import { SelectedCalendarsRepository } from "@/modules/selected-calendars/selected-calendars.repository";
 import { TokensModule } from "@/modules/tokens/tokens.module";
 import { UsersRepository } from "@/modules/users/users.repository";
-import { Module } from "@nestjs/common";
 
 @Module({
   imports: [TokensModule, RedisModule],
   providers: [
     GCalService,
     GoogleCalendarService,
+    UnifiedCalendarService,
+    UnifiedCalendarsFreebusyService,
     AppsRepository,
     BookingReferencesRepository_2024_08_13,
     CredentialsRepository,