@voyantjs/bookings 0.6.8 → 0.7.0

package/dist/service.js

@@ -1,9 +1,9 @@
-import { and, asc, desc, eq, ilike, inArray, lte, ne, or, sql } from "drizzle-orm";
+import { and, asc, desc, eq, exists, ilike, inArray, lte, ne, or, sql } from "drizzle-orm";
 import { availabilitySlotsRef } from "./availability-ref.js";
-import { bookingItemProductDetailsRef, bookingProductDetailsRef, optionUnitsRef, productDayServicesRef, productDaysRef, productOptionsRef, productsRef, productTicketSettingsRef, } from "./products-ref.js";
-import { bookingActivityLog, bookingAllocations, bookingDocuments, bookingFulfillments, bookingItemParticipants, bookingItems, bookingNotes, bookingParticipants, bookingRedemptionEvents, bookingSupplierStatuses, bookings, } from "./schema.js";
+import { bookingItemProductDetailsRef, bookingProductDetailsRef, optionUnitsRef, productDayServicesRef, productDaysRef, productItinerariesRef, productOptionsRef, productsRef, productTicketSettingsRef, } from "./products-ref.js";
+import { bookingActivityLog, bookingAllocations, bookingDocuments, bookingFulfillments, bookingItems, bookingItemTravelers, bookingNotes, bookingRedemptionEvents, bookingStaffAssignments, bookingSupplierStatuses, bookings, bookingTravelers, } from "./schema.js";
 import { cleanupGroupOnBookingCancelled } from "./service-groups.js";
-import { bookingTransactionDetailsRef, offerItemParticipantsRef, offerItemsRef, offerParticipantsRef, offersRef, orderItemParticipantsRef, orderItemsRef, orderParticipantsRef, ordersRef, } from "./transactions-ref.js";
+import { bookingTransactionDetailsRef, offerItemParticipantsRef, offerItemsRef, offerParticipantsRef, offerStaffAssignmentsRef, offersRef, orderItemParticipantsRef, orderItemsRef, orderParticipantsRef, orderStaffAssignmentsRef, ordersRef, } from "./transactions-ref.js";
 const travelerParticipantTypes = ["traveler", "occupant"];
 class BookingServiceError extends Error {
     code;
@@ -24,47 +24,31 @@ function toDateValueOrNull(value) {
         return null;
     return value instanceof Date ? value : new Date(value);
 }
-function toPassengerResponse(participant) {
+function toTravelerResponse(participant) {
     return {
         id: participant.id,
         bookingId: participant.bookingId,
+        participantType: participant.participantType,
+        travelerCategory: participant.travelerCategory,
         firstName: participant.firstName,
         lastName: participant.lastName,
         email: participant.email,
         phone: participant.phone,
+        preferredLanguage: participant.preferredLanguage,
+        accessibilityNeeds: participant.accessibilityNeeds,
         specialRequests: participant.specialRequests,
-        isLeadPassenger: participant.isPrimary,
+        isPrimary: participant.isPrimary,
+        notes: participant.notes,
         createdAt: participant.createdAt,
         updatedAt: participant.updatedAt,
     };
 }
-function toCreateParticipantFromPassenger(data) {
-    return {
-        participantType: "traveler",
-        firstName: data.firstName,
-        lastName: data.lastName,
-        email: data.email ?? null,
-        phone: data.phone ?? null,
-        specialRequests: data.specialRequests ?? null,
-        isPrimary: data.isLeadPassenger ?? false,
-    };
-}
-function toUpdateParticipantFromPassenger(data) {
-    return {
-        firstName: data.firstName,
-        lastName: data.lastName,
-        email: data.email ?? null,
-        phone: data.phone ?? null,
-        specialRequests: data.specialRequests ?? null,
-        isPrimary: data.isLeadPassenger ?? undefined,
-    };
-}
-async function ensureParticipantFlags(db, bookingId, participantId, data) {
+async function ensureParticipantFlags(db, bookingId, travelerId, data) {
     if (data.isPrimary) {
         await db
-            .update(bookingParticipants)
+            .update(bookingTravelers)
             .set({ isPrimary: false, updatedAt: new Date() })
-            .where(and(eq(bookingParticipants.bookingId, bookingId), ne(bookingParticipants.id, participantId)));
+            .where(and(eq(bookingTravelers.bookingId, bookingId), ne(bookingTravelers.id, travelerId)));
     }
 }
 async function ensureBookingScopedLinks(db, bookingId, data) {
@@ -78,18 +62,24 @@ async function ensureBookingScopedLinks(db, bookingId, data) {
             return { ok: false, reason: "booking_item_not_found" };
         }
     }
-    if (data.participantId) {
-        const [participant] = await db
-            .select({ id: bookingParticipants.id })
-            .from(bookingParticipants)
-            .where(and(eq(bookingParticipants.id, data.participantId), eq(bookingParticipants.bookingId, bookingId)))
+    if (data.travelerId) {
+        const [traveler] = await db
+            .select({ id: bookingTravelers.id })
+            .from(bookingTravelers)
+            .where(and(eq(bookingTravelers.id, data.travelerId), eq(bookingTravelers.bookingId, bookingId)))
             .limit(1);
-        if (!participant) {
-            return { ok: false, reason: "participant_not_found" };
+        if (!traveler) {
+            return { ok: false, reason: "traveler_not_found" };
         }
     }
     return { ok: true };
 }
+function isStaffParticipantType(participantType) {
+    return participantType === "staff";
+}
+function toStaffAssignmentRole(role) {
+    return role === "service_assignee" ? "service_assignee" : "other";
+}
 function deriveBookingDateRange(items) {
     const dates = items
         .flatMap((item) => [item.serviceDate, item.startsAt?.toISOString().slice(0, 10) ?? null])
@@ -112,6 +102,23 @@ function deriveBookingPax(participants, items) {
 function getTransactionItemParticipantItemId(link) {
     return "offerItemId" in link ? link.offerItemId : link.orderItemId;
 }
+function toStaffReservationParticipant(assignment, suffix) {
+    return {
+        id: `staff:${suffix}:${assignment.id}`,
+        personId: assignment.personId,
+        participantType: "staff",
+        travelerCategory: null,
+        firstName: assignment.firstName,
+        lastName: assignment.lastName,
+        email: assignment.email,
+        phone: assignment.phone,
+        preferredLanguage: assignment.preferredLanguage,
+        isPrimary: assignment.isPrimary,
+        notes: assignment.notes,
+        createdAt: new Date(),
+        updatedAt: new Date(),
+    };
+}
 function mapDeliveryFormatToFulfillment(format) {
     switch (format) {
         case "pdf":
@@ -160,10 +167,15 @@ async function getConvertProductData(db, data) {
             .limit(1);
         option = defaultOption ?? null;
     }
+    // product_days is keyed by itinerary_id (products re-parented days onto
+    // product_itineraries); getConvertProductData joins through the itinerary
+    // ref so the per-product day lookup still works for converts that want to
+    // seed booking supplier statuses from the product's day services.
     const days = await db
-        .select()
+        .select({ id: productDaysRef.id, dayNumber: productDaysRef.dayNumber })
         .from(productDaysRef)
-        .where(eq(productDaysRef.productId, product.id))
+        .innerJoin(productItinerariesRef, eq(productDaysRef.itineraryId, productItinerariesRef.id))
+        .where(eq(productItinerariesRef.productId, product.id))
         .orderBy(asc(productDaysRef.dayNumber));
     const dayServices = days.length
         ? await db
@@ -177,7 +189,9 @@ async function getConvertProductData(db, data) {
             .where(sql `${productDayServicesRef.dayId} IN (
             SELECT ${productDaysRef.id}
             FROM ${productDaysRef}
-            WHERE ${productDaysRef.productId} = ${product.id}
+            INNER JOIN ${productItinerariesRef}
+              ON ${productDaysRef.itineraryId} = ${productItinerariesRef.id}
+            WHERE ${productItinerariesRef.productId} = ${product.id}
           )`)
             .orderBy(asc(productDayServicesRef.sortOrder), asc(productDayServicesRef.id))
         : [];
@@ -188,6 +202,27 @@ async function getConvertProductData(db, data) {
             .from(optionUnitsRef)
             .where(eq(optionUnitsRef.optionId, option.id))
             .orderBy(asc(optionUnitsRef.sortOrder), asc(optionUnitsRef.createdAt));
+    let slot = null;
+    if (data.slotId) {
+        const [selectedSlot] = await db
+            .select()
+            .from(availabilitySlotsRef)
+            .where(and(eq(availabilitySlotsRef.id, data.slotId), eq(availabilitySlotsRef.productId, product.id)))
+            .limit(1);
+        if (!selectedSlot) {
+            return null;
+        }
+        if (option && selectedSlot.optionId && selectedSlot.optionId !== option.id) {
+            return null;
+        }
+        slot = {
+            id: selectedSlot.id,
+            dateLocal: selectedSlot.dateLocal,
+            startsAt: selectedSlot.startsAt,
+            endsAt: selectedSlot.endsAt,
+            timezone: selectedSlot.timezone,
+        };
+    }
     return {
         product: {
             id: product.id,
@@ -202,6 +237,7 @@ async function getConvertProductData(db, data) {
             pax: product.pax,
         },
         option: option ? { id: option.id, name: option.name } : null,
+        slot,
         dayServices,
         units: units.map((unit) => ({
             id: unit.id,
@@ -318,6 +354,16 @@ async function reserveBookingFromTransactionSource(db, source, data, userId) {
                 personId: source.personId,
                 organizationId: source.organizationId,
                 sourceType: data.sourceType,
+                contactFirstName: data.contactFirstName ?? source.contactFirstName,
+                contactLastName: data.contactLastName ?? source.contactLastName,
+                contactEmail: data.contactEmail ?? source.contactEmail,
+                contactPhone: data.contactPhone ?? source.contactPhone,
+                contactPreferredLanguage: data.contactPreferredLanguage ?? source.contactPreferredLanguage,
+                contactCountry: data.contactCountry ?? source.contactCountry,
+                contactRegion: data.contactRegion ?? source.contactRegion,
+                contactCity: data.contactCity ?? source.contactCity,
+                contactAddressLine1: data.contactAddressLine1 ?? source.contactAddressLine1,
+                contactPostalCode: data.contactPostalCode ?? source.contactPostalCode,
                 sellCurrency: source.currency,
                 baseCurrency: source.baseCurrency,
                 sellAmountCents: source.totalAmountCents,
@@ -333,10 +379,15 @@ async function reserveBookingFromTransactionSource(db, source, data, userId) {
                 throw new BookingServiceError("booking_create_failed");
             }
             const participantMap = new Map();
+            const staffParticipantMap = new Map();
             if (data.includeParticipants) {
                 for (const participant of source.participants) {
+                    if (isStaffParticipantType(participant.participantType)) {
+                        staffParticipantMap.set(participant.id, participant);
+                        continue;
+                    }
                     const [createdParticipant] = await tx
-                        .insert(bookingParticipants)
+                        .insert(bookingTravelers)
                         .values({
                         bookingId: booking.id,
                         personId: participant.personId ?? null,
@@ -437,17 +488,78 @@ async function reserveBookingFromTransactionSource(db, source, data, userId) {
                     continue;
                 }
                 const bookingItemId = bookingItemMap.get(sourceItemId);
-                const participantId = participantMap.get(link.participantId);
-                if (!bookingItemId || !participantId) {
+                const travelerId = participantMap.get(link.travelerId);
+                if (!bookingItemId || !travelerId) {
                     continue;
                 }
-                await tx.insert(bookingItemParticipants).values({
+                await tx.insert(bookingItemTravelers).values({
                     bookingItemId,
-                    participantId,
+                    travelerId,
                     role: link.role,
                     isPrimary: link.isPrimary,
                 });
             }
+            if (staffParticipantMap.size > 0) {
+                const linkedStaffAssignments = [];
+                const linkedStaffParticipantIds = new Set();
+                for (const link of source.itemParticipants) {
+                    const staffParticipant = staffParticipantMap.get(link.travelerId);
+                    if (!staffParticipant) {
+                        continue;
+                    }
+                    const sourceItemId = getTransactionItemParticipantItemId(link);
+                    if (!sourceItemId) {
+                        continue;
+                    }
+                    const bookingItemId = bookingItemMap.get(sourceItemId);
+                    if (!bookingItemId) {
+                        continue;
+                    }
+                    linkedStaffParticipantIds.add(staffParticipant.id);
+                    linkedStaffAssignments.push({
+                        bookingId: booking.id,
+                        bookingItemId,
+                        personId: staffParticipant.personId ?? null,
+                        role: toStaffAssignmentRole(link.role),
+                        firstName: staffParticipant.firstName,
+                        lastName: staffParticipant.lastName,
+                        email: staffParticipant.email ?? null,
+                        phone: staffParticipant.phone ?? null,
+                        preferredLanguage: staffParticipant.preferredLanguage ?? null,
+                        isPrimary: link.isPrimary || staffParticipant.isPrimary,
+                        notes: staffParticipant.notes ?? null,
+                        metadata: {
+                            sourceParticipantId: staffParticipant.id,
+                            sourceItemId,
+                            sourceRole: link.role,
+                        },
+                    });
+                }
+                for (const staffParticipant of staffParticipantMap.values()) {
+                    if (linkedStaffParticipantIds.has(staffParticipant.id)) {
+                        continue;
+                    }
+                    linkedStaffAssignments.push({
+                        bookingId: booking.id,
+                        bookingItemId: null,
+                        personId: staffParticipant.personId ?? null,
+                        role: "service_assignee",
+                        firstName: staffParticipant.firstName,
+                        lastName: staffParticipant.lastName,
+                        email: staffParticipant.email ?? null,
+                        phone: staffParticipant.phone ?? null,
+                        preferredLanguage: staffParticipant.preferredLanguage ?? null,
+                        isPrimary: staffParticipant.isPrimary,
+                        notes: staffParticipant.notes ?? null,
+                        metadata: {
+                            sourceParticipantId: staffParticipant.id,
+                        },
+                    });
+                }
+                if (linkedStaffAssignments.length > 0) {
+                    await tx.insert(bookingStaffAssignments).values(linkedStaffAssignments);
+                }
+            }
             await tx
                 .insert(bookingTransactionDetailsRef)
                 .values({
@@ -616,13 +728,13 @@ async function autoIssueFulfillmentsForBooking(db, bookingId, userId) {
     const settingsByProductId = new Map(settings.map((setting) => [setting.productId, setting]));
     const travelerParticipants = await db
         .select()
-        .from(bookingParticipants)
-        .where(and(eq(bookingParticipants.bookingId, bookingId), or(eq(bookingParticipants.participantType, "traveler"), eq(bookingParticipants.participantType, "occupant"))))
-        .orderBy(desc(bookingParticipants.isPrimary), asc(bookingParticipants.createdAt));
+        .from(bookingTravelers)
+        .where(and(eq(bookingTravelers.bookingId, bookingId), or(eq(bookingTravelers.participantType, "traveler"), eq(bookingTravelers.participantType, "occupant"))))
+        .orderBy(desc(bookingTravelers.isPrimary), asc(bookingTravelers.createdAt));
     const participantLinks = await db
         .select()
-        .from(bookingItemParticipants)
-        .where(sql `${bookingItemParticipants.bookingItemId} IN (
+        .from(bookingItemTravelers)
+        .where(sql `${bookingItemTravelers.bookingItemId} IN (
         SELECT ${bookingItems.id}
         FROM ${bookingItems}
         WHERE ${bookingItems.bookingId} = ${bookingId}
@@ -660,7 +772,7 @@ async function autoIssueFulfillmentsForBooking(db, bookingId, userId) {
             fulfillmentsToInsert.push({
                 bookingId,
                 bookingItemId: item.id,
-                participantId: null,
+                travelerId: null,
                 fulfillmentType: delivery.fulfillmentType,
                 deliveryChannel: delivery.deliveryChannel,
                 status: "issued",
@@ -673,7 +785,7 @@ async function autoIssueFulfillmentsForBooking(db, bookingId, userId) {
             fulfillmentsToInsert.push({
                 bookingId,
                 bookingItemId: item.id,
-                participantId: null,
+                travelerId: null,
                 fulfillmentType: delivery.fulfillmentType,
                 deliveryChannel: delivery.deliveryChannel,
                 status: "issued",
@@ -684,20 +796,20 @@ async function autoIssueFulfillmentsForBooking(db, bookingId, userId) {
         }
         const linkedParticipants = participantLinksByItemId
             .get(item.id)
-            ?.map((link) => travelerParticipants.find((participant) => participant.id === link.participantId))
+            ?.map((link) => travelerParticipants.find((participant) => participant.id === link.travelerId))
             .filter((participant) => Boolean(participant)) ?? [];
         const participantsForItem = linkedParticipants.length > 0 ? linkedParticipants : travelerParticipants;
         for (const participant of participantsForItem) {
             fulfillmentsToInsert.push({
                 bookingId,
                 bookingItemId: item.id,
-                participantId: participant.id,
+                travelerId: participant.id,
                 fulfillmentType: delivery.fulfillmentType,
                 deliveryChannel: delivery.deliveryChannel,
                 status: "issued",
                 payload: {
                     ...payloadBase,
-                    participantId: participant.id,
+                    travelerId: participant.id,
                     scope: "participant",
                 },
                 issuedAt: now,
@@ -716,7 +828,92 @@ async function autoIssueFulfillmentsForBooking(db, bookingId, userId) {
         metadata: { count: fulfillmentsToInsert.length },
     });
 }
+/**
+ * Booking statuses that count as "active" for aggregate purposes (matches the
+ * slot-unit-availability counting rules — cancelled and expired drop out).
+ */
+const AGGREGATE_ACTIVE_STATUSES = [
+    "draft",
+    "on_hold",
+    "confirmed",
+    "in_progress",
+    "completed",
+];
 export const bookingsService = {
+    /**
+     * Pre-aggregated dashboard numbers for the admin bookings surface. Replaces
+     * the pattern of fetching a large `listBookings` page and deriving KPIs
+     * client-side — which broke past the page limit and disagreed across apps
+     * on which statuses count.
+     *
+     * All ranges are UTC-based.
+     */
+    async getBookingAggregates(db, options = {}) {
+        const fromDate = options.from ? new Date(options.from) : undefined;
+        const toDate = options.to ? new Date(options.to) : undefined;
+        const rangeConditions = [];
+        if (fromDate)
+            rangeConditions.push(sql `${bookings.createdAt} >= ${fromDate}`);
+        if (toDate)
+            rangeConditions.push(sql `${bookings.createdAt} < ${toDate}`);
+        const rangeWhere = rangeConditions.length ? and(...rangeConditions) : undefined;
+        const [totalRow] = await db
+            .select({ count: sql `count(*)::int` })
+            .from(bookings)
+            .where(rangeWhere);
+        const statusRows = await db
+            .select({
+            status: bookings.status,
+            count: sql `count(*)::int`,
+        })
+            .from(bookings)
+            .where(rangeWhere)
+            .groupBy(bookings.status);
+        const countsByStatusMap = new Map(statusRows.map((row) => [row.status, row.count]));
+        const monthlyCountsRows = await db
+            .select({
+            yearMonth: sql `to_char(${bookings.createdAt} at time zone 'UTC', 'YYYY-MM')`,
+            count: sql `count(*)::int`,
+        })
+            .from(bookings)
+            .where(rangeWhere)
+            .groupBy(sql `to_char(${bookings.createdAt} at time zone 'UTC', 'YYYY-MM')`)
+            .orderBy(sql `to_char(${bookings.createdAt} at time zone 'UTC', 'YYYY-MM')`);
+        const monthlyRevenueRows = await db
+            .select({
+            yearMonth: sql `to_char(${bookings.createdAt} at time zone 'UTC', 'YYYY-MM')`,
+            currency: bookings.sellCurrency,
+            sellAmountCents: sql `coalesce(sum(${bookings.sellAmountCents}), 0)::bigint`,
+        })
+            .from(bookings)
+            .where(and(...(rangeConditions.length ? rangeConditions : []), sql `${bookings.sellAmountCents} IS NOT NULL`, inArray(bookings.status, [...AGGREGATE_ACTIVE_STATUSES])))
+            .groupBy(sql `to_char(${bookings.createdAt} at time zone 'UTC', 'YYYY-MM')`, bookings.sellCurrency)
+            .orderBy(sql `to_char(${bookings.createdAt} at time zone 'UTC', 'YYYY-MM')`, bookings.sellCurrency);
+        const todayUtc = new Date();
+        todayUtc.setUTCHours(0, 0, 0, 0);
+        const todayDateString = todayUtc.toISOString().slice(0, 10);
+        const [upcomingRow] = await db
+            .select({ count: sql `count(*)::int` })
+            .from(bookings)
+            .where(and(inArray(bookings.status, [...AGGREGATE_ACTIVE_STATUSES]), sql `${bookings.startDate} >= ${todayDateString}`));
+        return {
+            total: totalRow?.count ?? 0,
+            countsByStatus: AGGREGATE_ACTIVE_STATUSES.concat(["expired", "cancelled"]).map((status) => ({
+                status,
+                count: countsByStatusMap.get(status) ?? 0,
+            })),
+            monthlyCounts: monthlyCountsRows.map((row) => ({
+                yearMonth: row.yearMonth,
+                count: row.count,
+            })),
+            monthlyRevenue: monthlyRevenueRows.map((row) => ({
+                yearMonth: row.yearMonth,
+                currency: row.currency,
+                sellAmountCents: Number(row.sellAmountCents),
+            })),
+            upcomingDepartures: upcomingRow?.count ?? 0,
+        };
+    },
     async listBookings(db, query) {
         const conditions = [];
         if (query.status) {
@@ -726,6 +923,25 @@ export const bookingsService = {
             const term = `%${query.search}%`;
             conditions.push(or(ilike(bookings.bookingNumber, term), ilike(bookings.internalNotes, term)));
         }
+        if (query.personId) {
+            conditions.push(eq(bookings.personId, query.personId));
+        }
+        if (query.organizationId) {
+            conditions.push(eq(bookings.organizationId, query.organizationId));
+        }
+        if (query.productId || query.optionId) {
+            const itemConditions = [eq(bookingItems.bookingId, bookings.id)];
+            if (query.productId) {
+                itemConditions.push(eq(bookingItems.productId, query.productId));
+            }
+            if (query.optionId) {
+                itemConditions.push(eq(bookingItems.optionId, query.optionId));
+            }
+            conditions.push(exists(db
+                .select({ one: sql `1` })
+                .from(bookingItems)
+                .where(and(...itemConditions))));
+        }
         const where = conditions.length > 0 ? and(...conditions) : undefined;
         const [rows, countResult] = await Promise.all([
             db
@@ -745,7 +961,16 @@ export const bookingsService = {
         };
     },
     async convertProductToBooking(db, data, productData, userId) {
-        const { product, option, dayServices, units } = productData;
+        const { product, option, slot, dayServices, units } = productData;
+        // Slot dates win over product dates so scheduled/recurring products don't
+        // land with null dates. endsAt is a timestamp; fall back to the slot's
+        // dateLocal when the slot has no explicit end timestamp.
+        const startDate = slot?.dateLocal ?? product.startDate;
+        const endDate = slot
+            ? slot.endsAt
+                ? slot.endsAt.toISOString().slice(0, 10)
+                : slot.dateLocal
+            : product.endDate;
         const [booking] = await db
             .insert(bookings)
             .values({
@@ -757,8 +982,8 @@ export const bookingsService = {
             sellAmountCents: product.sellAmountCents,
             costAmountCents: product.costAmountCents,
             marginPercent: product.marginPercent,
-            startDate: product.startDate,
-            endDate: product.endDate,
+            startDate,
+            endDate,
             pax: product.pax,
             internalNotes: data.internalNotes ?? null,
         })
@@ -782,6 +1007,14 @@ export const bookingsService = {
             : selectedUnits.length === 1
                 ? selectedUnits
                 : [];
+        const slotFields = slot
+            ? {
+                serviceDate: slot.dateLocal,
+                startsAt: slot.startsAt,
+                endsAt: slot.endsAt,
+                metadata: { availabilitySlotId: slot.id },
+            }
+            : { metadata: null };
         const itemRows = unitsToSeed.length > 0
             ? unitsToSeed.map((unit, index) => {
                 const quantity = unit.unitType === "person" && product.pax
@@ -814,6 +1047,7 @@ export const bookingsService = {
                     productId: product.id,
                     optionId: option?.id ?? null,
                     optionUnitId: unit.id,
+                    ...slotFields,
                 };
             })
             : [
@@ -833,6 +1067,7 @@ export const bookingsService = {
                     productId: product.id,
                     optionId: option?.id ?? null,
                     optionUnitId: null,
+                    ...slotFields,
                 },
             ];
         const insertedItems = await db.insert(bookingItems).values(itemRows).returning();
@@ -865,7 +1100,12 @@ export const bookingsService = {
             actorId: userId ?? "system",
             activityType: "booking_converted",
             description: `Booking converted from product "${product.name}"`,
-            metadata: { productId: product.id, productName: product.name, optionId: option?.id ?? null },
+            metadata: {
+                productId: product.id,
+                productName: product.name,
+                optionId: option?.id ?? null,
+                slotId: slot?.id ?? null,
+            },
         });
         return booking;
     },
@@ -892,7 +1132,7 @@ export const bookingsService = {
         if (!offer) {
             return { status: "not_found" };
         }
-        const [participants, items, itemParticipants] = await Promise.all([
+        const [participants, items, itemParticipants, staffAssignments] = await Promise.all([
             db
                 .select()
                 .from(offerParticipantsRef)
@@ -912,7 +1152,31 @@ export const bookingsService = {
             WHERE ${offerItemsRef.offerId} = ${offerId}
           )`)
                 .orderBy(asc(offerItemParticipantsRef.createdAt)),
+            db
+                .select()
+                .from(offerStaffAssignmentsRef)
+                .where(eq(offerStaffAssignmentsRef.offerId, offerId))
+                .orderBy(asc(offerStaffAssignmentsRef.createdAt)),
         ]);
+        const reservationParticipants = [...participants];
+        const reservationItemParticipants = itemParticipants.map((link) => ({
+            travelerId: link.travelerId,
+            role: link.role,
+            isPrimary: link.isPrimary,
+            offerItemId: link.offerItemId,
+        }));
+        for (const assignment of staffAssignments) {
+            const participant = toStaffReservationParticipant(assignment, "offer");
+            reservationParticipants.push(participant);
+            if (assignment.offerItemId) {
+                reservationItemParticipants.push({
+                    travelerId: participant.id,
+                    role: assignment.role,
+                    isPrimary: assignment.isPrimary,
+                    offerItemId: assignment.offerItemId,
+                });
+            }
+        }
         return reserveBookingFromTransactionSource(db, {
             kind: "offer",
             sourceId: offerId,
@@ -920,14 +1184,24 @@ export const bookingsService = {
             orderId: null,
             personId: offer.personId ?? null,
             organizationId: offer.organizationId ?? null,
+            contactFirstName: offer.contactFirstName ?? null,
+            contactLastName: offer.contactLastName ?? null,
+            contactEmail: offer.contactEmail ?? null,
+            contactPhone: offer.contactPhone ?? null,
+            contactPreferredLanguage: offer.contactPreferredLanguage ?? null,
+            contactCountry: offer.contactCountry ?? null,
+            contactRegion: offer.contactRegion ?? null,
+            contactCity: offer.contactCity ?? null,
+            contactAddressLine1: offer.contactAddressLine1 ?? null,
+            contactPostalCode: offer.contactPostalCode ?? null,
             currency: offer.currency,
             baseCurrency: offer.baseCurrency ?? null,
             totalAmountCents: offer.totalAmountCents ?? null,
             costAmountCents: offer.costAmountCents ?? null,
             notes: offer.notes ?? null,
-            participants,
+            participants: reservationParticipants,
             items,
-            itemParticipants,
+            itemParticipants: reservationItemParticipants,
         }, data, userId);
     },
     async reserveBookingFromOrder(db, orderId, data, userId) {
@@ -935,7 +1209,7 @@ export const bookingsService = {
         if (!order) {
             return { status: "not_found" };
         }
-        const [participants, items, itemParticipants] = await Promise.all([
+        const [participants, items, itemParticipants, staffAssignments] = await Promise.all([
             db
                 .select()
                 .from(orderParticipantsRef)
@@ -955,7 +1229,31 @@ export const bookingsService = {
             WHERE ${orderItemsRef.orderId} = ${orderId}
           )`)
                 .orderBy(asc(orderItemParticipantsRef.createdAt)),
+            db
+                .select()
+                .from(orderStaffAssignmentsRef)
+                .where(eq(orderStaffAssignmentsRef.orderId, orderId))
+                .orderBy(asc(orderStaffAssignmentsRef.createdAt)),
         ]);
+        const reservationParticipants = [...participants];
+        const reservationItemParticipants = itemParticipants.map((link) => ({
+            travelerId: link.travelerId,
+            role: link.role,
+            isPrimary: link.isPrimary,
+            orderItemId: link.orderItemId,
+        }));
+        for (const assignment of staffAssignments) {
+            const participant = toStaffReservationParticipant(assignment, "order");
+            reservationParticipants.push(participant);
+            if (assignment.orderItemId) {
+                reservationItemParticipants.push({
+                    travelerId: participant.id,
+                    role: assignment.role,
+                    isPrimary: assignment.isPrimary,
+                    orderItemId: assignment.orderItemId,
+                });
+            }
+        }
         return reserveBookingFromTransactionSource(db, {
             kind: "order",
             sourceId: orderId,
@@ -963,14 +1261,24 @@ export const bookingsService = {
             orderId: order.id,
             personId: order.personId ?? null,
             organizationId: order.organizationId ?? null,
+            contactFirstName: order.contactFirstName ?? null,
+            contactLastName: order.contactLastName ?? null,
+            contactEmail: order.contactEmail ?? null,
+            contactPhone: order.contactPhone ?? null,
+            contactPreferredLanguage: order.contactPreferredLanguage ?? null,
+            contactCountry: order.contactCountry ?? null,
+            contactRegion: order.contactRegion ?? null,
+            contactCity: order.contactCity ?? null,
+            contactAddressLine1: order.contactAddressLine1 ?? null,
+            contactPostalCode: order.contactPostalCode ?? null,
             currency: order.currency,
             baseCurrency: order.baseCurrency ?? null,
             totalAmountCents: order.totalAmountCents ?? null,
             costAmountCents: order.costAmountCents ?? null,
             notes: order.notes ?? null,
-            participants,
+            participants: reservationParticipants,
             items,
-            itemParticipants,
+            itemParticipants: reservationItemParticipants,
         }, data, userId);
     },
     async reserveBooking(db, data, userId) {
@@ -987,6 +1295,16 @@ export const bookingsService = {
                     sourceType: data.sourceType,
                     externalBookingRef: data.externalBookingRef ?? null,
                     communicationLanguage: data.communicationLanguage ?? null,
+                    contactFirstName: data.contactFirstName ?? null,
+                    contactLastName: data.contactLastName ?? null,
+                    contactEmail: data.contactEmail ?? null,
+                    contactPhone: data.contactPhone ?? null,
+                    contactPreferredLanguage: data.contactPreferredLanguage ?? null,
+                    contactCountry: data.contactCountry ?? null,
+                    contactRegion: data.contactRegion ?? null,
+                    contactCity: data.contactCity ?? null,
+                    contactAddressLine1: data.contactAddressLine1 ?? null,
+                    contactPostalCode: data.contactPostalCode ?? null,
                     sellCurrency: data.sellCurrency,
                     baseCurrency: data.baseCurrency ?? null,
                     sellAmountCents: data.sellAmountCents ?? null,
@@ -1097,6 +1415,16 @@ export const bookingsService = {
                 .insert(bookings)
                 .values({
                 ...data,
+                contactFirstName: data.contactFirstName ?? null,
+                contactLastName: data.contactLastName ?? null,
+                contactEmail: data.contactEmail ?? null,
+                contactPhone: data.contactPhone ?? null,
+                contactPreferredLanguage: data.contactPreferredLanguage ?? null,
+                contactCountry: data.contactCountry ?? null,
+                contactRegion: data.contactRegion ?? null,
+                contactCity: data.contactCity ?? null,
+                contactAddressLine1: data.contactAddressLine1 ?? null,
+                contactPostalCode: data.contactPostalCode ?? null,
                 holdExpiresAt: toTimestamp(data.holdExpiresAt),
                 confirmedAt: toTimestamp(data.confirmedAt),
                 expiredAt: toTimestamp(data.expiredAt),
@@ -1122,6 +1450,18 @@ export const bookingsService = {
             .update(bookings)
             .set({
             ...data,
+            contactFirstName: data.contactFirstName === undefined ? undefined : (data.contactFirstName ?? null),
+            contactLastName: data.contactLastName === undefined ? undefined : (data.contactLastName ?? null),
+            contactEmail: data.contactEmail === undefined ? undefined : (data.contactEmail ?? null),
+            contactPhone: data.contactPhone === undefined ? undefined : (data.contactPhone ?? null),
+            contactPreferredLanguage: data.contactPreferredLanguage === undefined
+                ? undefined
+                : (data.contactPreferredLanguage ?? null),
+            contactCountry: data.contactCountry === undefined ? undefined : (data.contactCountry ?? null),
+            contactRegion: data.contactRegion === undefined ? undefined : (data.contactRegion ?? null),
+            contactCity: data.contactCity === undefined ? undefined : (data.contactCity ?? null),
+            contactAddressLine1: data.contactAddressLine1 === undefined ? undefined : (data.contactAddressLine1 ?? null),
+            contactPostalCode: data.contactPostalCode === undefined ? undefined : (data.contactPostalCode ?? null),
             holdExpiresAt: data.holdExpiresAt === undefined ? undefined : toTimestamp(data.holdExpiresAt),
             confirmedAt: data.confirmedAt === undefined ? undefined : toTimestamp(data.confirmedAt),
             expiredAt: data.expiredAt === undefined ? undefined : toTimestamp(data.expiredAt),
@@ -1141,7 +1481,7 @@ export const bookingsService = {
             .returning({ id: bookings.id });
         return row ?? null;
     },
-    async updateBookingStatus(db, id, data, userId) {
+    async updateBookingStatus(db, id, data, userId, runtime = {}) {
         const [current] = await db
             .select({ id: bookings.id, status: bookings.status })
             .from(bookings)
@@ -1151,13 +1491,13 @@ export const bookingsService = {
             return { status: "not_found" };
         }
         if (current.status === "on_hold" && data.status === "confirmed") {
-            return bookingsService.confirmBooking(db, id, { note: data.note }, userId);
+            return bookingsService.confirmBooking(db, id, { note: data.note }, userId, runtime);
         }
         if (current.status === "on_hold" && data.status === "expired") {
-            return bookingsService.expireBooking(db, id, { note: data.note }, userId);
+            return bookingsService.expireBooking(db, id, { note: data.note }, userId, runtime);
         }
         if (data.status === "cancelled") {
-            return bookingsService.cancelBooking(db, id, { note: data.note }, userId);
+            return bookingsService.cancelBooking(db, id, { note: data.note }, userId, runtime);
         }
         if (data.status === "on_hold") {
             return { status: "invalid_transition" };
@@ -1193,9 +1533,9 @@ export const bookingsService = {
         }
         return { status: "ok", booking: row ?? null };
     },
-    async confirmBooking(db, id, data, userId) {
+    async confirmBooking(db, id, data, userId, runtime = {}) {
         try {
-            return await db.transaction(async (tx) => {
+            const result = await db.transaction(async (tx) => {
                 const rows = await tx.execute(sql `SELECT id, booking_number, status, hold_expires_at
               FROM ${bookings}
               WHERE ${bookings.id} = ${id}
@@ -1249,6 +1589,17 @@ export const bookingsService = {
                 }
                 return { status: "ok", booking: row ?? null };
             });
+            // Emit AFTER the transaction commits so subscribers can't observe a
+            // confirmed state that might still roll back. `emit` is fire-and-forget
+            // per the EventBus contract — subscriber errors are logged, not rethrown.
+            if (result.status === "ok" && result.booking) {
+                await runtime.eventBus?.emit("booking.confirmed", {
+                    bookingId: result.booking.id,
+                    bookingNumber: result.booking.bookingNumber,
+                    actorId: userId ?? null,
+                }, { category: "domain", source: "service" });
+            }
+            return result;
         }
         catch (error) {
             if (error instanceof BookingServiceError) {
@@ -1307,9 +1658,9 @@ export const bookingsService = {
             throw error;
         }
     },
-    async expireBooking(db, id, data, userId) {
+    async expireBooking(db, id, data, userId, runtime = {}) {
         try {
-            return await db.transaction(async (tx) => {
+            const result = await db.transaction(async (tx) => {
                 const rows = await tx.execute(sql `SELECT id, status, hold_expires_at
               FROM ${bookings}
               WHERE ${bookings.id} = ${id}
@@ -1366,6 +1717,15 @@ export const bookingsService = {
                 }
                 return { status: "ok", booking: row ?? null };
             });
+            if (result.status === "ok" && result.booking) {
+                await runtime.eventBus?.emit("booking.expired", {
+                    bookingId: result.booking.id,
+                    bookingNumber: result.booking.bookingNumber,
+                    cause: runtime.cause ?? "route",
+                    actorId: userId ?? null,
+                }, { category: "domain", source: "service" });
+            }
+            return result;
         }
         catch (error) {
             if (error instanceof BookingServiceError) {
@@ -1374,7 +1734,7 @@ export const bookingsService = {
             throw error;
         }
     },
-    async expireStaleBookings(db, data, userId) {
+    async expireStaleBookings(db, data, userId, runtime = {}) {
         const cutoff = data.before ? new Date(data.before) : new Date();
         const staleBookings = await db
             .select({ id: bookings.id })
@@ -1383,7 +1743,7 @@ export const bookingsService = {
             .orderBy(asc(bookings.holdExpiresAt), asc(bookings.createdAt));
         const expiredIds = [];
         for (const booking of staleBookings) {
-            const result = await this.expireBooking(db, booking.id, { note: data.note ?? "Hold expired by sweep" }, userId);
+            const result = await this.expireBooking(db, booking.id, { note: data.note ?? "Hold expired by sweep" }, userId, { ...runtime, cause: "sweep" });
             if ("booking" in result && result.booking) {
                 expiredIds.push(result.booking.id);
             }
@@ -1394,9 +1754,9 @@ export const bookingsService = {
             cutoff,
         };
     },
-    async cancelBooking(db, id, data, userId) {
+    async cancelBooking(db, id, data, userId, runtime = {}) {
         try {
-            return await db.transaction(async (tx) => {
+            const result = await db.transaction(async (tx) => {
                 const rows = await tx.execute(sql `SELECT id, status
               FROM ${bookings}
               WHERE ${bookings.id} = ${id}
@@ -1408,6 +1768,7 @@ export const bookingsService = {
                 if (!["draft", "on_hold", "confirmed", "in_progress"].includes(booking.status)) {
                     throw new BookingServiceError("invalid_transition");
                 }
+                const previousStatus = booking.status;
                 const allocations = await tx
                     .select()
                     .from(bookingAllocations)
@@ -1457,8 +1818,17 @@ export const bookingsService = {
                 }
                 // Clean up any booking-group membership (dissolve if ≤1 active members remain).
                 await cleanupGroupOnBookingCancelled(tx, id);
-                return { status: "ok", booking: row ?? null };
+                return { status: "ok", booking: row ?? null, previousStatus };
             });
+            if (result.status === "ok" && result.booking) {
+                await runtime.eventBus?.emit("booking.cancelled", {
+                    bookingId: result.booking.id,
+                    bookingNumber: result.booking.bookingNumber,
+                    previousStatus: result.previousStatus,
+                    actorId: userId ?? null,
+                }, { category: "domain", source: "service" });
+            }
+            return { status: result.status, booking: result.booking };
         }
         catch (error) {
             if (error instanceof BookingServiceError) {
@@ -1467,22 +1837,22 @@ export const bookingsService = {
             throw error;
         }
     },
-    listParticipants(db, bookingId) {
+    listTravelerRecords(db, bookingId) {
         return db
             .select()
-            .from(bookingParticipants)
-            .where(eq(bookingParticipants.bookingId, bookingId))
-            .orderBy(desc(bookingParticipants.isPrimary), asc(bookingParticipants.createdAt));
+            .from(bookingTravelers)
+            .where(eq(bookingTravelers.bookingId, bookingId))
+            .orderBy(desc(bookingTravelers.isPrimary), asc(bookingTravelers.createdAt));
     },
-    async getParticipantById(db, bookingId, participantId) {
+    async getTravelerRecordById(db, bookingId, travelerId) {
         const [row] = await db
             .select()
-            .from(bookingParticipants)
-            .where(and(eq(bookingParticipants.id, participantId), eq(bookingParticipants.bookingId, bookingId)))
+            .from(bookingTravelers)
+            .where(and(eq(bookingTravelers.id, travelerId), eq(bookingTravelers.bookingId, bookingId)))
             .limit(1);
         return row ?? null;
     },
-    async createParticipant(db, bookingId, data, userId) {
+    async createTravelerRecord(db, bookingId, data, userId) {
         const [booking] = await db
             .select({ id: bookings.id })
             .from(bookings)
@@ -1492,7 +1862,7 @@ export const bookingsService = {
             return null;
         }
         const [row] = await db
-            .insert(bookingParticipants)
+            .insert(bookingTravelers)
             .values({
             bookingId,
             personId: data.personId ?? null,
@@ -1518,15 +1888,15 @@ export const bookingsService = {
             actorId: userId ?? "system",
             activityType: "passenger_update",
             description: `Participant ${data.firstName} ${data.lastName} added`,
-            metadata: { participantId: row.id, participantType: data.participantType },
+            metadata: { travelerId: row.id, participantType: data.participantType },
         });
         return row;
     },
-    async updateParticipant(db, participantId, data) {
+    async updateTravelerRecord(db, travelerId, data) {
         const [row] = await db
-            .update(bookingParticipants)
+            .update(bookingTravelers)
             .set({ ...data, updatedAt: new Date() })
-            .where(eq(bookingParticipants.id, participantId))
+            .where(eq(bookingTravelers.id, travelerId))
             .returning();
         if (!row) {
             return null;
@@ -1534,31 +1904,54 @@ export const bookingsService = {
         await ensureParticipantFlags(db, row.bookingId, row.id, data);
         return row;
     },
-    async deleteParticipant(db, participantId) {
+    async deleteTravelerRecord(db, travelerId) {
         const [row] = await db
-            .delete(bookingParticipants)
-            .where(eq(bookingParticipants.id, participantId))
-            .returning({ id: bookingParticipants.id });
+            .delete(bookingTravelers)
+            .where(eq(bookingTravelers.id, travelerId))
+            .returning({ id: bookingTravelers.id });
         return row ?? null;
     },
-    listPassengers(db, bookingId) {
+    listTravelers(db, bookingId) {
         return db
             .select()
-            .from(bookingParticipants)
-            .where(and(eq(bookingParticipants.bookingId, bookingId), or(...travelerParticipantTypes.map((type) => eq(bookingParticipants.participantType, type)))))
-            .orderBy(asc(bookingParticipants.createdAt))
-            .then((rows) => rows.map(toPassengerResponse));
+            .from(bookingTravelers)
+            .where(and(eq(bookingTravelers.bookingId, bookingId), or(...travelerParticipantTypes.map((type) => eq(bookingTravelers.participantType, type)))))
+            .orderBy(asc(bookingTravelers.createdAt))
+            .then((rows) => rows.map(toTravelerResponse));
     },
-    async createPassenger(db, bookingId, data, userId) {
-        const row = await this.createParticipant(db, bookingId, toCreateParticipantFromPassenger(data), userId);
-        return row ? toPassengerResponse(row) : null;
+    async createTraveler(db, bookingId, data, userId) {
+        const row = await this.createTravelerRecord(db, bookingId, {
+            participantType: "traveler",
+            travelerCategory: data.travelerCategory ?? null,
+            firstName: data.firstName,
+            lastName: data.lastName,
+            email: data.email ?? null,
+            phone: data.phone ?? null,
+            preferredLanguage: data.preferredLanguage ?? null,
+            accessibilityNeeds: data.accessibilityNeeds ?? null,
+            specialRequests: data.specialRequests ?? null,
+            isPrimary: data.isPrimary ?? false,
+            notes: data.notes ?? null,
+        }, userId);
+        return row ? toTravelerResponse(row) : null;
     },
-    async updatePassenger(db, passengerId, data) {
-        const row = await this.updateParticipant(db, passengerId, toUpdateParticipantFromPassenger(data));
-        return row ? toPassengerResponse(row) : null;
+    async updateTraveler(db, travelerId, data) {
+        const row = await this.updateTravelerRecord(db, travelerId, {
+            firstName: data.firstName,
+            lastName: data.lastName,
+            email: data.email ?? null,
+            phone: data.phone ?? null,
+            preferredLanguage: data.preferredLanguage ?? null,
+            accessibilityNeeds: data.accessibilityNeeds ?? null,
+            specialRequests: data.specialRequests ?? null,
+            travelerCategory: data.travelerCategory ?? null,
+            isPrimary: data.isPrimary ?? undefined,
+            notes: data.notes ?? null,
+        });
+        return row ? toTravelerResponse(row) : null;
     },
-    async deletePassenger(db, passengerId) {
-        return this.deleteParticipant(db, passengerId);
+    async deleteTraveler(db, travelerId) {
+        return this.deleteTravelerRecord(db, travelerId);
     },
     listItems(db, bookingId) {
         return db
@@ -1639,9 +2032,9 @@ export const bookingsService = {
     listItemParticipants(db, itemId) {
         return db
             .select()
-            .from(bookingItemParticipants)
-            .where(eq(bookingItemParticipants.bookingItemId, itemId))
-            .orderBy(desc(bookingItemParticipants.isPrimary), asc(bookingItemParticipants.createdAt));
+            .from(bookingItemTravelers)
+            .where(eq(bookingItemTravelers.bookingItemId, itemId))
+            .orderBy(desc(bookingItemTravelers.isPrimary), asc(bookingItemTravelers.createdAt));
     },
     async addItemParticipant(db, itemId, data) {
         const [item] = await db
@@ -1652,25 +2045,25 @@ export const bookingsService = {
         if (!item) {
             return null;
         }
-        const [participant] = await db
-            .select({ id: bookingParticipants.id })
-            .from(bookingParticipants)
-            .where(eq(bookingParticipants.id, data.participantId))
+        const [traveler] = await db
+            .select({ id: bookingTravelers.id })
+            .from(bookingTravelers)
+            .where(eq(bookingTravelers.id, data.travelerId))
             .limit(1);
-        if (!participant) {
+        if (!traveler) {
             return null;
         }
         if (data.isPrimary) {
             await db
-                .update(bookingItemParticipants)
+                .update(bookingItemTravelers)
                 .set({ isPrimary: false })
-                .where(eq(bookingItemParticipants.bookingItemId, itemId));
+                .where(eq(bookingItemTravelers.bookingItemId, itemId));
         }
         const [row] = await db
-            .insert(bookingItemParticipants)
+            .insert(bookingItemTravelers)
             .values({
             bookingItemId: itemId,
-            participantId: data.participantId,
+            travelerId: data.travelerId,
             role: data.role,
             isPrimary: data.isPrimary ?? false,
         })
@@ -1679,9 +2072,9 @@ export const bookingsService = {
     },
     async removeItemParticipant(db, linkId) {
         const [row] = await db
-            .delete(bookingItemParticipants)
-            .where(eq(bookingItemParticipants.id, linkId))
-            .returning({ id: bookingItemParticipants.id });
+            .delete(bookingItemTravelers)
+            .where(eq(bookingItemTravelers.id, linkId))
+            .returning({ id: bookingItemTravelers.id });
         return row ?? null;
     },
     listSupplierStatuses(db, bookingId) {
@@ -1789,7 +2182,7 @@ export const bookingsService = {
             .values({
             bookingId,
             bookingItemId: data.bookingItemId ?? null,
-            participantId: data.participantId ?? null,
+            travelerId: data.travelerId ?? null,
             fulfillmentType: data.fulfillmentType,
             deliveryChannel: data.deliveryChannel,
             status,
@@ -1807,7 +2200,7 @@ export const bookingsService = {
             metadata: {
                 fulfillmentId: row?.id ?? null,
                 bookingItemId: data.bookingItemId ?? null,
-                participantId: data.participantId ?? null,
+                travelerId: data.travelerId ?? null,
                 status,
             },
         });
@@ -1831,7 +2224,7 @@ export const bookingsService = {
             .update(bookingFulfillments)
             .set({
             bookingItemId: data.bookingItemId === undefined ? undefined : (data.bookingItemId ?? null),
-            participantId: data.participantId === undefined ? undefined : (data.participantId ?? null),
+            travelerId: data.travelerId === undefined ? undefined : (data.travelerId ?? null),
             fulfillmentType: data.fulfillmentType,
             deliveryChannel: data.deliveryChannel,
             status: nextStatus,
@@ -1860,7 +2253,7 @@ export const bookingsService = {
                 metadata: {
                     fulfillmentId,
                     bookingItemId: row.bookingItemId,
-                    participantId: row.participantId,
+                    travelerId: row.travelerId,
                     status: row.status,
                 },
             });
@@ -1897,7 +2290,7 @@ export const bookingsService = {
                 .values({
                 bookingId,
                 bookingItemId: data.bookingItemId ?? null,
-                participantId: data.participantId ?? null,
+                travelerId: data.travelerId ?? null,
                 redeemedAt,
                 redeemedBy: data.redeemedBy ?? userId ?? null,
                 location: data.location ?? null,
@@ -1938,7 +2331,7 @@ export const bookingsService = {
                 metadata: {
                     redemptionEventId: event?.id ?? null,
                     bookingItemId: data.bookingItemId ?? null,
-                    participantId: data.participantId ?? null,
+                    travelerId: data.travelerId ?? null,
                     redeemedAt: redeemedAt.toISOString(),
                     method: data.method,
                 },
@@ -1986,6 +2379,13 @@ export const bookingsService = {
         });
         return row;
     },
+    async deleteNote(db, noteId) {
+        const [row] = await db
+            .delete(bookingNotes)
+            .where(eq(bookingNotes.id, noteId))
+            .returning({ id: bookingNotes.id });
+        return row ?? null;
+    },
     listDocuments(db, bookingId) {
         return db
             .select()
@@ -2006,7 +2406,7 @@ export const bookingsService = {
             .insert(bookingDocuments)
             .values({
             bookingId,
-            participantId: data.participantId ?? data.passengerId ?? null,
+            travelerId: data.travelerId ?? null,
             type: data.type,
             fileName: data.fileName,
             fileUrl: data.fileUrl,