docs: have new slots controller in docs

apps/api/v2/src/ee/platform-endpoints-module.ts

@@ -9,6 +9,7 @@ import { ProviderModule } from "@/ee/provider/provider.module";
 import { SchedulesModule_2024_04_15 } from "@/ee/schedules/schedules_2024_04_15/schedules.module";
 import { SchedulesModule_2024_06_11 } from "@/ee/schedules/schedules_2024_06_11/schedules.module";
 import { SlotsModule_2024_04_15 } from "@/modules/slots/slots-2024-04-15/slots.module";
+import { SlotsModule_2024_09_04 } from "@/modules/slots/slots-2024-09-04/slots.module";
 import { TeamsEventTypesModule } from "@/modules/teams/event-types/teams-event-types.module";
 import { TeamsMembershipsModule } from "@/modules/teams/memberships/teams-memberships.module";
 import { TeamsModule } from "@/modules/teams/teams/teams.module";
@@ -30,6 +31,7 @@ import { Module } from "@nestjs/common";
     BookingsModule_2024_08_13,
     TeamsMembershipsModule,
     SlotsModule_2024_04_15,
+    SlotsModule_2024_09_04,
     TeamsModule,
   ],
 })

apps/api/v2/src/modules/slots/slots-2024-04-15/controllers/slots.controller.ts

@@ -1,7 +1,7 @@
-import { API_VERSIONS_VALUES } from "@/lib/api-versions";
 import { SlotsOutputService_2024_04_15 } from "@/modules/slots/slots-2024-04-15/services/slots-output.service";
 import { SlotsService_2024_04_15 } from "@/modules/slots/slots-2024-04-15/services/slots.service";
 import { Query, Body, Controller, Get, Delete, Post, Req, Res } from "@nestjs/common";
+import { ApiExcludeController as DocsExcludeController } from "@nestjs/swagger";
 import { ApiTags as DocsTags, ApiCreatedResponse, ApiOkResponse, ApiOperation } from "@nestjs/swagger";
 import { Response as ExpressResponse, Request as ExpressRequest } from "express";
 
@@ -20,7 +20,7 @@ import { ApiResponse, GetAvailableSlotsInput_2024_04_15 } from "@calcom/platform
   path: "/v2/slots",
   version: [VERSION_2024_04_15, VERSION_2024_06_11, VERSION_2024_06_14],
 })
-@DocsTags("Slots")
+@DocsExcludeController(true)
 export class SlotsController_2024_04_15 {
   constructor(
     private readonly slotsService: SlotsService_2024_04_15,

apps/api/v2/src/modules/slots/slots-2024-09-04/controllers/slots.controller.ts

@@ -39,26 +39,6 @@ export class SlotsController_2024_09_04 {
     summary: "Reserve a slot",
     description: "Prevent double booking by reserving a slot.",
   })
-  @ApiHeader({
-    name: "cookie",
-    description:
-      "Contains the `uid` cookie representing the user's existing slot reservation. This cookie is optional and may not be present if the user hasn't reserved a slot yet.",
-    required: false,
-    example: "uid=12345-abcde-67890-fghij",
-  })
-  @DocsResponse({
-    status: 201,
-    description:
-      "Slot reservation was successful. A new `uid` cookie representing the reservation will be included in the response in addition to response body containing the uid.",
-    schema: {
-      example: {
-        status: "success",
-        data: {
-          uid: "98765-zyxwv-43210-qwerty",
-        },
-      },
-    },
-  })
   async reserveSlot(
     @Body() body: ReserveSlotInput_2024_09_04,
     @Cookies("uid") uidCookie: string | undefined,

apps/api/v2/src/modules/slots/slots-2024-09-04/outputs/reserve-slot.output.ts

@@ -1,12 +1,17 @@
+import { ApiProperty } from "@nestjs/swagger";
 import { Type } from "class-transformer";
-import { ValidateNested } from "class-validator";
+import { IsNotEmptyObject, ValidateNested } from "class-validator";
 
 import {
   ApiResponseWithoutData,
   ReserveSlotOutput_2024_09_04 as ReserveSlotOutputType_2024_09_04,
 } from "@calcom/platform-types";
 
 export class ReserveSlotOutput_2024_09_04 extends ApiResponseWithoutData {
+  @ApiProperty({
+    type: ReserveSlotOutputType_2024_09_04,
+  })
+  @IsNotEmptyObject()
   @ValidateNested()
   @Type(() => ReserveSlotOutputType_2024_09_04)
   data!: ReserveSlotOutputType_2024_09_04;