feat: crud for slots reservations

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

@@ -1,17 +1,28 @@
 import { VERSION_2024_09_04 } from "@/lib/api-versions";
-import { Cookies } from "@/lib/decorators/cookies.decorator";
+import { GetReservedSlotOutput_2024_09_04 } from "@/modules/slots/slots-2024-09-04/outputs/get-reserved-slot.output";
 import { GetSlotsOutput_2024_09_04 } from "@/modules/slots/slots-2024-09-04/outputs/get-slots.output";
 import { ReserveSlotOutput_2024_09_04 } from "@/modules/slots/slots-2024-09-04/outputs/reserve-slot.output";
 import { SlotsService_2024_09_04 } from "@/modules/slots/slots-2024-09-04/services/slots.service";
-import { Query, Body, Controller, Get, Delete, Post, Param, Res, HttpCode, HttpStatus } from "@nestjs/common";
+import {
+  Query,
+  Body,
+  Controller,
+  Get,
+  Delete,
+  Post,
+  Param,
+  Res,
+  HttpCode,
+  HttpStatus,
+  Patch,
+} from "@nestjs/common";
 import {
   ApiOperation,
   ApiTags as DocsTags,
   ApiHeader,
   ApiResponse as DocsResponse,
   ApiQuery,
 } from "@nestjs/swagger";
-import { Response as ExpressResponse } from "express";
 
 import { SUCCESS_STATUS } from "@calcom/platform-constants";
 import {
@@ -34,40 +45,23 @@ import { ApiResponse } from "@calcom/platform-types";
 export class SlotsController_2024_09_04 {
   constructor(private readonly slotsService: SlotsService_2024_09_04) {}
 
-  @Post("/")
+  @Get("/")
   @ApiOperation({
-    summary: "Reserve a slot",
-    description: "Prevent double booking by reserving a slot.",
-  })
-  async reserveSlot(
-    @Body() body: ReserveSlotInput_2024_09_04,
-    @Cookies("uid") uidCookie: string | undefined,
-    @Res({ passthrough: true }) response: ExpressResponse
-  ): Promise<ReserveSlotOutput_2024_09_04> {
-    const reservedSlot = await this.slotsService.reserveSlot(body, uidCookie);
-
-    response.cookie("uid", reservedSlot.reservationUid);
-
-    return {
-      status: SUCCESS_STATUS,
-      data: reservedSlot,
-    };
-  }
-
-  @Get("/available")
-  @ApiOperation({
-    summary: "Get available slots",
+    summary: "Find out when is an event type ready to be booked.",
     description: `
       There are 3 ways to get available slots:
 
-      1. By event type id: schema ById_2024_09_04. Example '/api/v2/slots/available?eventTypeId=10&start=2050-09-05&end=2050-09-06&timeZone=Europe/Rome'
+      1. By event type id. Example '/api/v2/slots/available?eventTypeId=10&start=2050-09-05&end=2050-09-06&timeZone=Europe/Rome'
 
-      2. By event type slug: schema BySlug_2024_09_04. Example '/api/v2/slots/available?eventTypeSlug=intro&start=2050-09-05&end=2050-09-06'
+      2. By event type slug + username. Example '/api/v2/slots/available?eventTypeSlug=intro&username=bob&start=2050-09-05&end=2050-09-06'
 
-      3. By usernames: schema ByUsernames_2024_09_04. Example '/api/v2/slots/available?usernames=alice,bob&start=2050-09-05&end=2050-09-06&duration=60'
+      3. By usernames (used for dynamic event type - there is no specific event but you want to know when 2 or more people are available). Example '/api/v2/slots/available?usernames=alice,bob&username=bob&start=2050-09-05&end=2050-09-06&duration=60'
 
-      All of them require "start" and "end" query parameters which define the time range for which available slots should be checked,
-      and "eventTypeId", "eventTypeSlug" or "usernames" query parameters to specify the event type or users for which available slots should be checked.
+      All of them require "start" and "end" query parameters which define the time range for which available slots should be checked.
+      Optional parameters are:
+      - timeZone: Time zone in which the available slots should be returned. Defaults to UTC.
+      - duration: Only use for event types that allow multiple durations or for dynamic event types. If not passed for multiple duration event types defaults to default duration. For dynamic event types defaults to 30 aka each returned slot is 30 minutes long. So duration=60 means that returned slots will be each 60 minutes long.
+      - slotFormat: Format of the slots. By default return is an object where each key is date and value is array of slots as string. If you want to get start and end of each slot use "range" as value.
       `,
   })
   @ApiQuery({
@@ -181,7 +175,51 @@ export class SlotsController_2024_09_04 {
     };
   }
 
-  @Delete("/:uid")
+  @Post("/reservations")
+  @ApiOperation({
+    summary: "Reserve a slot",
+    description: "Make a slot not available for others to book for a certain period of time.",
+  })
+  async reserveSlot(@Body() body: ReserveSlotInput_2024_09_04): Promise<ReserveSlotOutput_2024_09_04> {
+    const reservedSlot = await this.slotsService.reserveSlot(body);
+
+    return {
+      status: SUCCESS_STATUS,
+      data: reservedSlot,
+    };
+  }
+
+  @Get("/reservations/:uid")
+  @ApiOperation({
+    summary: "Get reserved slot",
+  })
+  async getReservedSlot(@Param("uid") uid: string): Promise<GetReservedSlotOutput_2024_09_04> {
+    const reservedSlot = await this.slotsService.getReservedSlot(uid);
+
+    return {
+      status: SUCCESS_STATUS,
+      data: reservedSlot,
+    };
+  }
+
+  @Patch("/reservations/:uid")
+  @ApiOperation({
+    summary: "Updated reserved a slot",
+  })
+  @HttpCode(HttpStatus.OK)
+  async updateReservedSlot(
+    @Body() body: ReserveSlotInput_2024_09_04,
+    @Param("uid") uid: string
+  ): Promise<ReserveSlotOutput_2024_09_04> {
+    const reservedSlot = await this.slotsService.updateReservedSlot(body, uid);
+
+    return {
+      status: SUCCESS_STATUS,
+      data: reservedSlot,
+    };
+  }
+
+  @Delete("/reservations/:uid")
   @HttpCode(HttpStatus.OK)
   @DocsResponse({
     status: 200,
@@ -192,8 +230,8 @@ export class SlotsController_2024_09_04 {
       },
     },
   })
-  async deleteSelectedSlot(@Param("uid") uid: string): Promise<ApiResponse> {
-    await this.slotsService.deleteSelectedSlot(uid);
+  async deleteReservedSlot(@Param("uid") uid: string): Promise<ApiResponse> {
+    await this.slotsService.deleteReservedSlot(uid);
 
     return {
       status: SUCCESS_STATUS,

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

@@ -0,0 +1,18 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { Type } from "class-transformer";
+import { IsNotEmptyObject, ValidateNested } from "class-validator";
+
+import {
+  ApiResponseWithoutData,
+  GetReservedSlotOutput_2024_09_04 as GetReservedSlotOutputType_2024_09_04,
+} from "@calcom/platform-types";
+
+export class GetReservedSlotOutput_2024_09_04 extends ApiResponseWithoutData {
+  @ApiProperty({
+    type: GetReservedSlotOutputType_2024_09_04,
+  })
+  @IsNotEmptyObject()
+  @ValidateNested()
+  @Type(() => GetReservedSlotOutputType_2024_09_04)
+  data!: GetReservedSlotOutputType_2024_09_04 | null;
+}

apps/api/v2/src/modules/slots/slots-2024-09-04/services/slots-output.service.ts

@@ -3,14 +3,51 @@ import { Injectable, BadRequestException } from "@nestjs/common";
 import { DateTime } from "luxon";
 
 import { SlotFormat } from "@calcom/platform-enums";
-import { RangeSlotsOutput_2024_09_04, SlotsOutput_2024_09_04 } from "@calcom/platform-types";
+import {
+  GetReservedSlotOutput_2024_09_04,
+  RangeSlotsOutput_2024_09_04,
+  ReserveSlotOutput_2024_09_04,
+  SlotsOutput_2024_09_04,
+} from "@calcom/platform-types";
+import { SelectedSlots } from "@calcom/prisma/client";
 
 type GetAvailableSlots = { slots: Record<string, { time: string }[]> };
 
 @Injectable()
 export class SlotsOutputService_2024_09_04 {
   constructor(private readonly eventTypesRepository: EventTypesRepository_2024_06_14) {}
 
+  getOutputSlot(slot: SelectedSlots): GetReservedSlotOutput_2024_09_04 {
+    return {
+      eventTypeId: slot.eventTypeId,
+      slotStart: DateTime.fromJSDate(slot.slotUtcStartDate, { zone: "utc" }).toISO() || "unknown-slot-start",
+      slotEnd: DateTime.fromJSDate(slot.slotUtcEndDate, { zone: "utc" }).toISO() || "unknown-slot-end",
+      slotDuration: DateTime.fromJSDate(slot.slotUtcEndDate, { zone: "utc" }).diff(
+        DateTime.fromJSDate(slot.slotUtcStartDate, { zone: "utc" }),
+        "minutes"
+      ).minutes,
+      reservationUid: slot.uid,
+      reservationUntil:
+        DateTime.fromJSDate(slot.releaseAt, { zone: "utc" }).toISO() || "unknown-reserved-until",
+    };
+  }
+
+  getOutputReservedSlot(slot: SelectedSlots, reservationDuration: number): ReserveSlotOutput_2024_09_04 {
+    return {
+      eventTypeId: slot.eventTypeId,
+      slotStart: DateTime.fromJSDate(slot.slotUtcStartDate, { zone: "utc" }).toISO() || "unknown-slot-start",
+      slotEnd: DateTime.fromJSDate(slot.slotUtcEndDate, { zone: "utc" }).toISO() || "unknown-slot-end",
+      slotDuration: DateTime.fromJSDate(slot.slotUtcEndDate, { zone: "utc" }).diff(
+        DateTime.fromJSDate(slot.slotUtcStartDate, { zone: "utc" }),
+        "minutes"
+      ).minutes,
+      reservationDuration,
+      reservationUid: slot.uid,
+      reservationUntil:
+        DateTime.fromJSDate(slot.releaseAt, { zone: "utc" }).toISO() || "unknown-reserved-until",
+    };
+  }
+
   async getOutputSlots(
     availableSlots: GetAvailableSlots,
     duration?: number,