feat: track when an attendee joined a seated booking

apps/api/v2/src/ee/bookings/2024-08-13/controllers/e2e/seated-bookings.e2e-spec.ts

@@ -211,7 +211,9 @@ describe("Bookings Endpoints 2024-08-13", () => {
                 ...body.bookingFieldsResponses,
               },
               metadata: body.metadata,
+              createdAt: expect.any(String),
             });
+            expect(data.attendees[0].createdAt).toBeDefined();
             expect(data.location).toBeDefined();
             expect(data.absentHost).toEqual(false);
             createdSeatedBooking = data;
@@ -287,7 +289,9 @@ describe("Bookings Endpoints 2024-08-13", () => {
                 ...createdSeatedBooking.attendees[0].bookingFieldsResponses,
               },
               metadata: createdSeatedBooking.attendees[0].metadata,
+              createdAt: expect.any(String),
             });
+            expect(firstAttendee?.createdAt).toBeDefined();
             const secondAttendee = data.attendees.find((attendee) => attendee.name === nameAttendeeTwo);
             expect(secondAttendee).toEqual({
               name: body.attendee.name,
@@ -303,7 +307,9 @@ describe("Bookings Endpoints 2024-08-13", () => {
                 ...body.bookingFieldsResponses,
               },
               metadata: body.metadata,
+              createdAt: expect.any(String),
             });
+            expect(secondAttendee?.createdAt).toBeDefined();
             expect(data.location).toBeDefined();
             expect(data.absentHost).toEqual(false);
             createdSeatedBooking = data;
@@ -609,7 +615,9 @@ describe("Bookings Endpoints 2024-08-13", () => {
                 ...attendee?.bookingFieldsResponses,
               },
               metadata: attendee?.metadata,
+              createdAt: expect.any(String),
             });
+            expect(data.attendees[0].createdAt).toBeDefined();
             expect(data.location).toBeDefined();
             expect(data.absentHost).toEqual(false);
             createdSeatedBooking = data;
@@ -876,6 +884,7 @@ describe("Bookings Endpoints 2024-08-13", () => {
               expect(data.attendees[0].name).toEqual(nameAttendeeOne);
               expect(data.attendees[0].language).toEqual("it");
               expect(data.attendees[0].seatUid).toBeDefined();
+              expect(data.attendees[0].createdAt).toBeDefined();
               expect(data.location).toBeDefined();
               expect(data.absentHost).toEqual(false);
               booking = data;
@@ -919,6 +928,7 @@ describe("Bookings Endpoints 2024-08-13", () => {
               expect(data.attendees[0].name).toEqual(nameAttendeeOne);
               expect(data.attendees[0].language).toEqual("it");
               expect(data.attendees[0].seatUid).toBeDefined();
+              expect(data.attendees[0].createdAt).toBeDefined();
               expect(data.location).toBeDefined();
               expect(data.absentHost).toEqual(false);
               await bookingsRepositoryFixture.deleteById(data.id);
@@ -1034,7 +1044,9 @@ describe("Bookings Endpoints 2024-08-13", () => {
                     ...body.bookingFieldsResponses,
                   },
                   metadata: body.metadata,
+                  createdAt: expect.any(String),
                 });
+                expect(data.attendees[0].createdAt).toBeDefined();
                 expect(data.location).toBeDefined();
                 expect(data.absentHost).toEqual(false);
                 createdSeatedBooking2 = data;
@@ -1103,13 +1115,11 @@ describe("Bookings Endpoints 2024-08-13", () => {
     });
 
     function responseDataIsCreateSeatedBooking(data: any): data is CreateSeatedBookingOutput_2024_08_13 {
-      return Object.prototype.hasOwnProperty.call(data, "seatUid");
+      return "seatUid" in data;
     }
 
     function responseDataIsGetSeatedBooking(data: any): data is GetSeatedBookingOutput_2024_08_13 {
-      return data?.attendees?.every((attendee: any) =>
-        Object.prototype.hasOwnProperty.call(attendee, "seatUid")
-      );
+      return data?.attendees?.every((attendee: any) => "seatUid" in attendee);
     }
 
     afterAll(async () => {

apps/api/v2/src/ee/bookings/2024-08-13/services/output.service.ts

@@ -1,3 +1,21 @@
+import { bookingMetadataSchema } from "@calcom/platform-libraries";
+import type {
+  CreateRecurringSeatedBookingOutput_2024_08_13,
+  CreateSeatedBookingOutput_2024_08_13,
+  ReassignBookingOutput_2024_08_13,
+} from "@calcom/platform-types";
+import {
+  BookingOutput_2024_08_13,
+  GetRecurringSeatedBookingOutput_2024_08_13,
+  GetSeatedBookingOutput_2024_08_13,
+  RecurringBookingOutput_2024_08_13,
+  SeatedAttendee,
+} from "@calcom/platform-types";
+import type { Booking, BookingSeat } from "@calcom/prisma/client";
+import { Injectable } from "@nestjs/common";
+import { plainToClass } from "class-transformer";
+import { DateTime } from "luxon";
+import { z } from "zod";
 import { BookingsRepository_2024_08_13 } from "@/ee/bookings/2024-08-13/repositories/bookings.repository";
 import {
   defaultBookingMetadata,
@@ -6,25 +24,6 @@ import {
   defaultSeatedBookingMetadata,
 } from "@/lib/safe-parse/default-responses-booking";
 import { safeParse } from "@/lib/safe-parse/safe-parse";
-import { Injectable } from "@nestjs/common";
-import { plainToClass } from "class-transformer";
-import { DateTime } from "luxon";
-import { z } from "zod";
-
-import { bookingMetadataSchema } from "@calcom/platform-libraries";
-import {
-  GetRecurringSeatedBookingOutput_2024_08_13,
-  RecurringBookingOutput_2024_08_13,
-  SeatedAttendee,
-  BookingOutput_2024_08_13,
-  GetSeatedBookingOutput_2024_08_13,
-} from "@calcom/platform-types";
-import type {
-  CreateRecurringSeatedBookingOutput_2024_08_13,
-  CreateSeatedBookingOutput_2024_08_13,
-  ReassignBookingOutput_2024_08_13,
-} from "@calcom/platform-types";
-import type { Booking, BookingSeat } from "@calcom/prisma/client";
 
 export const bookingResponsesSchema = z
   .object({
@@ -80,6 +79,7 @@ type DatabaseBooking = Booking & {
     phoneNumber?: string | null;
     noShow: boolean | null;
     bookingSeat?: BookingSeat | null;
+    createdAt?: Date | null;
   }[];
   user: DatabaseUser | null;
   createdAt: Date;
@@ -168,9 +168,8 @@ export class OutputBookingsService_2024_08_13 {
       bookingTransformed.bookingFieldsResponses?.guests &&
       Array.isArray(bookingTransformed.bookingFieldsResponses.guests)
     ) {
-      bookingTransformed.bookingFieldsResponses.displayGuests = bookingTransformed.bookingFieldsResponses.guests.map(
-        (guest: string) => this.getDisplayEmail(guest)
-      );
+      bookingTransformed.bookingFieldsResponses.displayGuests =
+        bookingTransformed.bookingFieldsResponses.guests.map((guest: string) => this.getDisplayEmail(guest));
     }
 
     return bookingTransformed;
@@ -230,10 +229,10 @@ export class OutputBookingsService_2024_08_13 {
 
   async getOutputRecurringBookings(bookingsIds: number[]) {
     const databaseBookings = await this.bookingsRepository.getByIdsWithAttendeesAndUserAndEvent(bookingsIds);
-    
-    const bookingsMap = new Map(databaseBookings.map(booking => [booking.id, booking]));
-    
-    const transformed = bookingsIds.map(bookingId => {
+
+    const bookingsMap = new Map(databaseBookings.map((booking) => [booking.id, booking]));
+
+    const transformed = bookingsIds.map((bookingId) => {
       const databaseBooking = bookingsMap.get(bookingId);
       if (!databaseBooking) {
         throw new Error(`Booking with id=${bookingId} was not found in the database`);
@@ -313,9 +312,8 @@ export class OutputBookingsService_2024_08_13 {
       bookingTransformed.bookingFieldsResponses?.guests &&
       Array.isArray(bookingTransformed.bookingFieldsResponses.guests)
     ) {
-      bookingTransformed.bookingFieldsResponses.displayGuests = bookingTransformed.bookingFieldsResponses.guests.map(
-        (guest: string) => this.getDisplayEmail(guest)
-      );
+      bookingTransformed.bookingFieldsResponses.displayGuests =
+        bookingTransformed.bookingFieldsResponses.guests.map((guest: string) => this.getDisplayEmail(guest));
     }
 
     return bookingTransformed;
@@ -389,6 +387,7 @@ export class OutputBookingsService_2024_08_13 {
             absent: !!attendee.noShow,
             seatUid: attendee.bookingSeat?.referenceUid,
             bookingFieldsResponses: {},
+            createdAt: attendee.createdAt,
           };
           const attendeeParsed = plainToClass(SeatedAttendee, attendeeData, { strategy: "excludeAll" });
           attendeeParsed.bookingFieldsResponses = responses || {};
@@ -409,11 +408,12 @@ export class OutputBookingsService_2024_08_13 {
   }
 
   async getOutputRecurringSeatedBookings(bookingsIds: number[], showAttendees: boolean) {
-    const databaseBookings = await this.bookingsRepository.getByIdsWithAttendeesWithBookingSeatAndUserAndEvent(bookingsIds);
-
-    const bookingsMap = new Map(databaseBookings.map(booking => [booking.id, booking]));
-
-    const transformed = bookingsIds.map(bookingId => {
+    const databaseBookings =
+      await this.bookingsRepository.getByIdsWithAttendeesWithBookingSeatAndUserAndEvent(bookingsIds);
+
+    const bookingsMap = new Map(databaseBookings.map((booking) => [booking.id, booking]));
+
+    const transformed = bookingsIds.map((bookingId) => {
       const databaseBooking = bookingsMap.get(bookingId);
       if (!databaseBooking) {
         throw new Error(`Booking with id=${bookingId} was not found in the database`);
@@ -518,6 +518,7 @@ export class OutputBookingsService_2024_08_13 {
             absent: !!attendee.noShow,
             seatUid: attendee.bookingSeat?.referenceUid,
             bookingFieldsResponses: {},
+            createdAt: attendee.createdAt,
           };
           const attendeeParsed = plainToClass(SeatedAttendee, attendeeData, { strategy: "excludeAll" });
           attendeeParsed.bookingFieldsResponses = responses || {};

packages/features/bookings/lib/service/RegularBookingService.ts

@@ -1705,6 +1705,7 @@ async function handler(
           id: 0,
           email: bookerEmail,
           name: fullName,
+          createdAt: new Date(),
           timeZone: reqBody.timeZone,
           locale: null,
           phoneNumber: null,

packages/features/bookings/repositories/AttendeeRepository.ts

@@ -10,6 +10,7 @@ const safeSelect = {
   phoneNumber: true,
   bookingId: true,
   noShow: true,
+  createdAt: true,
 };
 
 /**
@@ -101,6 +102,7 @@ export class AttendeeRepository implements IAttendeeRepository {
       phoneNumber: string | null;
       bookingId: number | null;
       noShow: boolean | null;
+      createdAt: Date | null;
     }[]
   > {
     return this.prismaClient.attendee.findMany({

packages/features/bookings/repositories/BookingSeatRepository.ts

@@ -34,6 +34,7 @@ export class BookingSeatRepository {
             email: true,
             locale: true,
             timeZone: true,
+            createdAt: true,
           },
         },
       },

packages/features/tasker/tasks/triggerNoShow/triggerGuestNoShow.ts

@@ -19,6 +19,7 @@ type UpdatedAttendee = {
   phoneNumber: string | null;
   bookingId: number | null;
   noShow: boolean | null;
+  createdAt: Date | null;
 };
 
 const markGuestAsNoshowInBooking = async ({

packages/platform/types/bookings/2024-08-13/outputs/booking.output.ts

@@ -4,17 +4,16 @@ import {
   IsArray,
   IsBoolean,
   IsDateString,
+  IsEmail,
   IsEnum,
   IsInt,
   IsObject,
   IsOptional,
   IsString,
-  IsEmail,
   IsTimeZone,
   IsUrl,
   ValidateNested,
 } from "class-validator";
-
 import type { BookingLanguageType } from "../inputs/language";
 import { BookingLanguage } from "../inputs/language";
 
@@ -63,6 +62,16 @@ export class SeatedAttendee extends BookingAttendee {
   @Expose()
   seatUid!: string;
 
+  @ApiPropertyOptional({
+    type: String,
+    example: "2024-08-13T15:30:00Z",
+    description: "The date and time when the attendee joined the seated booking.",
+  })
+  @IsDateString()
+  @IsOptional()
+  @Expose()
+  createdAt?: string;
+
   @ApiProperty({
     type: Object,
     description:
@@ -100,7 +109,11 @@ class BookingHost {
   @Expose()
   email!: string;
 
-  @ApiProperty({ type: String, example: "jane100@example.com", description: "Clean email for display purposes" })
+  @ApiProperty({
+    type: String,
+    example: "jane100@example.com",
+    description: "Clean email for display purposes",
+  })
   @IsString()
   @Expose()
   displayEmail!: string;
@@ -406,7 +419,11 @@ class ReassignedToDto {
   @Expose()
   email!: string;
 
-  @ApiProperty({ type: String, example: "john.doe@example.com", description: "Clean email for display purposes" })
+  @ApiProperty({
+    type: String,
+    example: "john.doe@example.com",
+    description: "Clean email for display purposes",
+  })
   @IsString()
   @Expose()
   displayEmail!: string;

packages/prisma/migrations/20260209000000_add_attendee_created_at/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "Attendee" ADD COLUMN "createdAt" TIMESTAMP(3) DEFAULT CURRENT_TIMESTAMP;

packages/prisma/schema.prisma

@@ -842,6 +842,7 @@ model Attendee {
   bookingId   Int?
   bookingSeat BookingSeat?
   noShow      Boolean?     @default(false)
+  createdAt   DateTime?    @default(now())
 
   @@index([email])
   @@index([bookingId])

packages/testing/src/lib/bookingScenario/bookingScenario.ts

@@ -2307,11 +2307,12 @@ export function getMockBookingReference(
 }
 
 export function getMockBookingAttendee(
-  attendee: Omit<Attendee, "bookingId" | "phoneNumber" | "email" | "noShow"> & {
+  attendee: Omit<Attendee, "bookingId" | "phoneNumber" | "email" | "noShow" | "createdAt"> & {
     bookingSeat?: AttendeeBookingSeatInput;
     phoneNumber?: string | null;
     email: string;
     noShow?: boolean;
+    createdAt?: Date | null;
   }
 ) {
   return {
@@ -2323,6 +2324,7 @@ export function getMockBookingAttendee(
     bookingSeat: attendee.bookingSeat || null,
     phoneNumber: attendee.phoneNumber ?? undefined,
     noShow: attendee.noShow ?? false,
+    createdAt: attendee.createdAt ?? null,
   };
 }