@voyantjs/bookings 0.6.8 → 0.7.0

package/dist/service.d.ts

@@ -1,6 +1,8 @@
+import type { EventBus } from "@voyantjs/core";
 import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
 import type { z } from "zod";
-import type { bookingListQuerySchema, cancelBookingSchema, confirmBookingSchema, convertProductSchema, expireBookingSchema, expireStaleBookingsSchema, extendBookingHoldSchema, insertBookingDocumentSchema, insertBookingFulfillmentSchema, insertBookingItemParticipantSchema, insertBookingItemSchema, insertBookingNoteSchema, insertBookingSchema, insertParticipantSchema, insertPassengerSchema, recordBookingRedemptionSchema, reserveBookingFromTransactionSchema, reserveBookingSchema, updateBookingFulfillmentSchema, updateBookingItemSchema, updateBookingSchema, updateBookingStatusSchema, updateParticipantSchema, updatePassengerSchema } from "./validation.js";
+import { bookings } from "./schema.js";
+import type { bookingListQuerySchema, cancelBookingSchema, confirmBookingSchema, convertProductSchema, expireBookingSchema, expireStaleBookingsSchema, extendBookingHoldSchema, insertBookingDocumentSchema, insertBookingFulfillmentSchema, insertBookingItemParticipantSchema, insertBookingItemSchema, insertBookingNoteSchema, insertBookingSchema, insertTravelerRecordSchema, insertTravelerSchema, recordBookingRedemptionSchema, reserveBookingFromTransactionSchema, reserveBookingSchema, updateBookingFulfillmentSchema, updateBookingItemSchema, updateBookingSchema, updateBookingStatusSchema, updateTravelerRecordSchema, updateTravelerSchema } from "./validation.js";
 type BookingListQuery = z.infer<typeof bookingListQuerySchema>;
 type ConvertProductInput = z.infer<typeof convertProductSchema>;
 type CreateBookingInput = z.infer<typeof insertBookingSchema>;
@@ -12,10 +14,10 @@ type ConfirmBookingInput = z.infer<typeof confirmBookingSchema>;
 type CancelBookingInput = z.infer<typeof cancelBookingSchema>;
 type ExpireBookingInput = z.infer<typeof expireBookingSchema>;
 type ExpireStaleBookingsInput = z.infer<typeof expireStaleBookingsSchema>;
-type CreatePassengerInput = z.infer<typeof insertPassengerSchema>;
-type UpdatePassengerInput = z.infer<typeof updatePassengerSchema>;
-type CreateParticipantInput = z.infer<typeof insertParticipantSchema>;
-type UpdateParticipantInput = z.infer<typeof updateParticipantSchema>;
+type CreateTravelerInput = z.infer<typeof insertTravelerSchema>;
+type UpdateTravelerInput = z.infer<typeof updateTravelerSchema>;
+type CreateTravelerRecordInput = z.infer<typeof insertTravelerRecordSchema>;
+type UpdateTravelerRecordInput = z.infer<typeof updateTravelerRecordSchema>;
 type CreateBookingItemInput = z.infer<typeof insertBookingItemSchema>;
 type UpdateBookingItemInput = z.infer<typeof updateBookingItemSchema>;
 type CreateBookingItemParticipantInput = z.infer<typeof insertBookingItemParticipantSchema>;
@@ -43,6 +45,18 @@ export interface ConvertProductData {
         id: string;
         name: string;
     } | null;
+    /**
+     * Availability slot the caller chose, if any. When set, the resulting booking
+     * pins its startDate/endDate to the slot so recurring/scheduled products don't
+     * land with null dates.
+     */
+    slot?: {
+        id: string;
+        dateLocal: string;
+        startsAt: Date;
+        endsAt: Date | null;
+        timezone: string;
+    } | null;
     dayServices: Array<{
         supplierServiceId: string | null;
         name: string;
@@ -59,7 +73,85 @@ export interface ConvertProductData {
         sortOrder: number;
     }>;
 }
+/**
+ * Optional runtime hooks for status-transition flows. Keeps the service
+ * decoupled from delivery concerns — bookings only has to emit, never know
+ * what listens.
+ */
+export interface BookingServiceRuntime {
+    eventBus?: EventBus;
+}
+/**
+ * Payload shape for `booking.confirmed`. Subscribers should treat unknown
+ * fields as forward-compatible additions.
+ */
+export interface BookingConfirmedEvent {
+    bookingId: string;
+    bookingNumber: string;
+    actorId: string | null;
+}
+/**
+ * Payload for `booking.cancelled`. `previousStatus` is the state the booking
+ * transitioned *out of* — useful for subscribers that care about cancelling a
+ * confirmed booking (refund flow) vs cancelling a draft/hold (no side effects).
+ */
+export interface BookingCancelledEvent {
+    bookingId: string;
+    bookingNumber: string;
+    previousStatus: "draft" | "on_hold" | "confirmed" | "in_progress";
+    actorId: string | null;
+}
+/**
+ * Payload for `booking.expired`. Fires when an on-hold booking's timer runs
+ * out. `cause` flags whether it was the explicit route call or the sweep job —
+ * subscribers that want to email the customer should probably skip
+ * sweep-originated events to avoid pager noise during backfills.
+ */
+export interface BookingExpiredEvent {
+    bookingId: string;
+    bookingNumber: string;
+    cause: "route" | "sweep";
+    actorId: string | null;
+}
+type BookingStatus = (typeof bookings.$inferSelect)["status"];
+export interface BookingAggregates {
+    /** Total bookings across all statuses in range. */
+    total: number;
+    /** One row per booking status (including zero counts for active statuses). */
+    countsByStatus: Array<{
+        status: BookingStatus;
+        count: number;
+    }>;
+    /** Booking counts bucketed by YYYY-MM (UTC), oldest first. */
+    monthlyCounts: Array<{
+        yearMonth: string;
+        count: number;
+    }>;
+    /**
+     * Sell revenue bucketed by YYYY-MM (UTC), grouped by currency. Null currency
+     * rows are dropped since a booking without a sell currency is malformed.
+     */
+    monthlyRevenue: Array<{
+        yearMonth: string;
+        currency: string;
+        sellAmountCents: number;
+    }>;
+    /** Count of active bookings with `startDate >= today`. */
+    upcomingDepartures: number;
+}
 export declare 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.
+     */
+    getBookingAggregates(db: PostgresJsDatabase, options?: {
+        from?: string;
+        to?: string;
+    }): Promise<BookingAggregates>;
     listBookings(db: PostgresJsDatabase, query: BookingListQuery): Promise<{
         data: {
             id: string;
@@ -70,6 +162,16 @@ export declare const bookingsService: {
             sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
             externalBookingRef: string | null;
             communicationLanguage: string | null;
+            contactFirstName: string | null;
+            contactLastName: string | null;
+            contactEmail: string | null;
+            contactPhone: string | null;
+            contactPreferredLanguage: string | null;
+            contactCountry: string | null;
+            contactRegion: string | null;
+            contactCity: string | null;
+            contactAddressLine1: string | null;
+            contactPostalCode: string | null;
             sellCurrency: string;
             baseCurrency: string | null;
             sellAmountCents: number | null;
@@ -100,6 +202,7 @@ export declare const bookingsService: {
         createdAt: Date;
         updatedAt: Date;
         organizationId: string | null;
+        redeemedAt: Date | null;
         startDate: string | null;
         endDate: string | null;
         bookingNumber: string;
@@ -107,6 +210,16 @@ export declare const bookingsService: {
         sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
         externalBookingRef: string | null;
         communicationLanguage: string | null;
+        contactFirstName: string | null;
+        contactLastName: string | null;
+        contactEmail: string | null;
+        contactPhone: string | null;
+        contactPreferredLanguage: string | null;
+        contactCountry: string | null;
+        contactRegion: string | null;
+        contactCity: string | null;
+        contactAddressLine1: string | null;
+        contactPostalCode: string | null;
         sellCurrency: string;
         baseCurrency: string | null;
         sellAmountCents: number | null;
@@ -121,7 +234,6 @@ export declare const bookingsService: {
         expiredAt: Date | null;
         cancelledAt: Date | null;
         completedAt: Date | null;
-        redeemedAt: Date | null;
     } | null>;
     getBookingById(db: PostgresJsDatabase, id: string): Promise<{
         id: string;
@@ -132,6 +244,16 @@ export declare const bookingsService: {
         sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
         externalBookingRef: string | null;
         communicationLanguage: string | null;
+        contactFirstName: string | null;
+        contactLastName: string | null;
+        contactEmail: string | null;
+        contactPhone: string | null;
+        contactPreferredLanguage: string | null;
+        contactCountry: string | null;
+        contactRegion: string | null;
+        contactCity: string | null;
+        contactAddressLine1: string | null;
+        contactPostalCode: string | null;
         sellCurrency: string;
         baseCurrency: string | null;
         sellAmountCents: number | null;
@@ -158,6 +280,7 @@ export declare const bookingsService: {
         createdAt: Date;
         updatedAt: Date;
         organizationId: string | null;
+        redeemedAt: Date | null;
         startDate: string | null;
         endDate: string | null;
         bookingNumber: string;
@@ -165,6 +288,16 @@ export declare const bookingsService: {
         sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
         externalBookingRef: string | null;
         communicationLanguage: string | null;
+        contactFirstName: string | null;
+        contactLastName: string | null;
+        contactEmail: string | null;
+        contactPhone: string | null;
+        contactPreferredLanguage: string | null;
+        contactCountry: string | null;
+        contactRegion: string | null;
+        contactCity: string | null;
+        contactAddressLine1: string | null;
+        contactPostalCode: string | null;
         sellCurrency: string;
         baseCurrency: string | null;
         sellAmountCents: number | null;
@@ -179,7 +312,6 @@ export declare const bookingsService: {
         expiredAt: Date | null;
         cancelledAt: Date | null;
         completedAt: Date | null;
-        redeemedAt: Date | null;
     } | null>;
     listAllocations(db: PostgresJsDatabase, bookingId: string): Omit<import("drizzle-orm/pg-core").PgSelectBase<"booking_allocations", {
         id: import("drizzle-orm/pg-core").PgColumn<{
@@ -798,6 +930,7 @@ export declare const bookingsService: {
             createdAt: Date;
             updatedAt: Date;
             organizationId: string | null;
+            redeemedAt: Date | null;
             startDate: string | null;
             endDate: string | null;
             bookingNumber: string;
@@ -805,6 +938,16 @@ export declare const bookingsService: {
             sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
             externalBookingRef: string | null;
             communicationLanguage: string | null;
+            contactFirstName: string | null;
+            contactLastName: string | null;
+            contactEmail: string | null;
+            contactPhone: string | null;
+            contactPreferredLanguage: string | null;
+            contactCountry: string | null;
+            contactRegion: string | null;
+            contactCity: string | null;
+            contactAddressLine1: string | null;
+            contactPostalCode: string | null;
             sellCurrency: string;
             baseCurrency: string | null;
             sellAmountCents: number | null;
@@ -819,7 +962,6 @@ export declare const bookingsService: {
             expiredAt: Date | null;
             cancelledAt: Date | null;
             completedAt: Date | null;
-            redeemedAt: Date | null;
         };
     } | {
         status: Exclude<string, "ok">;
@@ -830,6 +972,7 @@ export declare const bookingsService: {
         createdAt: Date;
         updatedAt: Date;
         organizationId: string | null;
+        redeemedAt: Date | null;
         startDate: string | null;
         endDate: string | null;
         bookingNumber: string;
@@ -837,6 +980,16 @@ export declare const bookingsService: {
         sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
         externalBookingRef: string | null;
         communicationLanguage: string | null;
+        contactFirstName: string | null;
+        contactLastName: string | null;
+        contactEmail: string | null;
+        contactPhone: string | null;
+        contactPreferredLanguage: string | null;
+        contactCountry: string | null;
+        contactRegion: string | null;
+        contactCity: string | null;
+        contactAddressLine1: string | null;
+        contactPostalCode: string | null;
         sellCurrency: string;
         baseCurrency: string | null;
         sellAmountCents: number | null;
@@ -851,7 +1004,6 @@ export declare const bookingsService: {
         expiredAt: Date | null;
         cancelledAt: Date | null;
         completedAt: Date | null;
-        redeemedAt: Date | null;
     } | null>;
     updateBooking(db: PostgresJsDatabase, id: string, data: UpdateBookingInput): Promise<{
         id: string;
@@ -862,6 +1014,16 @@ export declare const bookingsService: {
         sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
         externalBookingRef: string | null;
         communicationLanguage: string | null;
+        contactFirstName: string | null;
+        contactLastName: string | null;
+        contactEmail: string | null;
+        contactPhone: string | null;
+        contactPreferredLanguage: string | null;
+        contactCountry: string | null;
+        contactRegion: string | null;
+        contactCity: string | null;
+        contactAddressLine1: string | null;
+        contactPostalCode: string | null;
         sellCurrency: string;
         baseCurrency: string | null;
         sellAmountCents: number | null;
@@ -885,10 +1047,10 @@ export declare const bookingsService: {
     deleteBooking(db: PostgresJsDatabase, id: string): Promise<{
         id: string;
     } | null>;
-    updateBookingStatus(db: PostgresJsDatabase, id: string, data: UpdateBookingStatusInput, userId?: string): Promise<{
+    updateBookingStatus(db: PostgresJsDatabase, id: string, data: UpdateBookingStatusInput, userId?: string, runtime?: BookingServiceRuntime): Promise<{
         status: Exclude<string, "ok">;
     }>;
-    confirmBooking(db: PostgresJsDatabase, id: string, data: ConfirmBookingInput, userId?: string): Promise<{
+    confirmBooking(db: PostgresJsDatabase, id: string, data: ConfirmBookingInput, userId?: string, runtime?: BookingServiceRuntime): Promise<{
         status: "ok";
         booking: {
             id: string;
@@ -899,6 +1061,16 @@ export declare const bookingsService: {
             sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
             externalBookingRef: string | null;
             communicationLanguage: string | null;
+            contactFirstName: string | null;
+            contactLastName: string | null;
+            contactEmail: string | null;
+            contactPhone: string | null;
+            contactPreferredLanguage: string | null;
+            contactCountry: string | null;
+            contactRegion: string | null;
+            contactCity: string | null;
+            contactAddressLine1: string | null;
+            contactPostalCode: string | null;
             sellCurrency: string;
             baseCurrency: string | null;
             sellAmountCents: number | null;
@@ -933,6 +1105,16 @@ export declare const bookingsService: {
             sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
             externalBookingRef: string | null;
             communicationLanguage: string | null;
+            contactFirstName: string | null;
+            contactLastName: string | null;
+            contactEmail: string | null;
+            contactPhone: string | null;
+            contactPreferredLanguage: string | null;
+            contactCountry: string | null;
+            contactRegion: string | null;
+            contactCity: string | null;
+            contactAddressLine1: string | null;
+            contactPostalCode: string | null;
             sellCurrency: string;
             baseCurrency: string | null;
             sellAmountCents: number | null;
@@ -956,7 +1138,9 @@ export declare const bookingsService: {
     } | {
         status: Exclude<string, "ok">;
     }>;
-    expireBooking(db: PostgresJsDatabase, id: string, data: ExpireBookingInput, userId?: string): Promise<{
+    expireBooking(db: PostgresJsDatabase, id: string, data: ExpireBookingInput, userId?: string, runtime?: BookingServiceRuntime & {
+        cause?: "route" | "sweep";
+    }): Promise<{
         status: "ok";
         booking: {
             id: string;
@@ -967,6 +1151,16 @@ export declare const bookingsService: {
             sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
             externalBookingRef: string | null;
             communicationLanguage: string | null;
+            contactFirstName: string | null;
+            contactLastName: string | null;
+            contactEmail: string | null;
+            contactPhone: string | null;
+            contactPreferredLanguage: string | null;
+            contactCountry: string | null;
+            contactRegion: string | null;
+            contactCity: string | null;
+            contactAddressLine1: string | null;
+            contactPostalCode: string | null;
             sellCurrency: string;
             baseCurrency: string | null;
             sellAmountCents: number | null;
@@ -990,12 +1184,12 @@ export declare const bookingsService: {
     } | {
         status: Exclude<string, "ok">;
     }>;
-    expireStaleBookings(db: PostgresJsDatabase, data: ExpireStaleBookingsInput, userId?: string): Promise<{
+    expireStaleBookings(db: PostgresJsDatabase, data: ExpireStaleBookingsInput, userId?: string, runtime?: BookingServiceRuntime): Promise<{
         expiredIds: string[];
         count: number;
         cutoff: Date;
     }>;
-    cancelBooking(db: PostgresJsDatabase, id: string, data: CancelBookingInput, userId?: string): Promise<{
+    cancelBooking(db: PostgresJsDatabase, id: string, data: CancelBookingInput, userId?: string, runtime?: BookingServiceRuntime): Promise<{
         status: "ok";
         booking: {
             id: string;
@@ -1006,6 +1200,16 @@ export declare const bookingsService: {
             sourceType: "internal" | "reseller" | "direct" | "manual" | "affiliate" | "ota" | "api_partner";
             externalBookingRef: string | null;
             communicationLanguage: string | null;
+            contactFirstName: string | null;
+            contactLastName: string | null;
+            contactEmail: string | null;
+            contactPhone: string | null;
+            contactPreferredLanguage: string | null;
+            contactCountry: string | null;
+            contactRegion: string | null;
+            contactCity: string | null;
+            contactAddressLine1: string | null;
+            contactPostalCode: string | null;
             sellCurrency: string;
             baseCurrency: string | null;
             sellAmountCents: number | null;
@@ -1028,11 +1232,12 @@ export declare const bookingsService: {
         } | null;
     } | {
         status: Exclude<string, "ok">;
+        booking?: undefined;
     }>;
-    listParticipants(db: PostgresJsDatabase, bookingId: string): Omit<import("drizzle-orm/pg-core").PgSelectBase<"booking_participants", {
+    listTravelerRecords(db: PostgresJsDatabase, bookingId: string): Omit<import("drizzle-orm/pg-core").PgSelectBase<"booking_travelers", {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1049,7 +1254,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         bookingId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1066,7 +1271,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         personId: import("drizzle-orm/pg-core").PgColumn<{
             name: "person_id";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1083,24 +1288,24 @@ export declare const bookingsService: {
         }, {}, {}>;
         participantType: import("drizzle-orm/pg-core").PgColumn<{
             name: "participant_type";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "staff" | "other" | "traveler" | "booker" | "contact" | "occupant";
+            data: "other" | "traveler" | "occupant";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["traveler", "booker", "contact", "occupant", "staff", "other"];
+            enumValues: ["traveler", "occupant", "other"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
         travelerCategory: import("drizzle-orm/pg-core").PgColumn<{
             name: "traveler_category";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgEnumColumn";
             data: "other" | "adult" | "child" | "infant" | "senior";
@@ -1117,7 +1322,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         firstName: import("drizzle-orm/pg-core").PgColumn<{
             name: "first_name";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1134,7 +1339,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         lastName: import("drizzle-orm/pg-core").PgColumn<{
             name: "last_name";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1151,7 +1356,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         email: import("drizzle-orm/pg-core").PgColumn<{
             name: "email";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1168,7 +1373,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         phone: import("drizzle-orm/pg-core").PgColumn<{
             name: "phone";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1185,7 +1390,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         preferredLanguage: import("drizzle-orm/pg-core").PgColumn<{
             name: "preferred_language";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1202,7 +1407,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         accessibilityNeeds: import("drizzle-orm/pg-core").PgColumn<{
             name: "accessibility_needs";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1219,7 +1424,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         specialRequests: import("drizzle-orm/pg-core").PgColumn<{
             name: "special_requests";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1236,7 +1441,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         isPrimary: import("drizzle-orm/pg-core").PgColumn<{
             name: "is_primary";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "boolean";
             columnType: "PgBoolean";
             data: boolean;
@@ -1253,7 +1458,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         notes: import("drizzle-orm/pg-core").PgColumn<{
             name: "notes";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1270,7 +1475,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         createdAt: import("drizzle-orm/pg-core").PgColumn<{
             name: "created_at";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -1287,7 +1492,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         updatedAt: import("drizzle-orm/pg-core").PgColumn<{
             name: "updated_at";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -1302,11 +1507,11 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-    }, "single", Record<"booking_participants", "not-null">, false, "where" | "orderBy", {
+    }, "single", Record<"booking_travelers", "not-null">, false, "where" | "orderBy", {
         id: string;
         bookingId: string;
         personId: string | null;
-        participantType: "staff" | "other" | "traveler" | "booker" | "contact" | "occupant";
+        participantType: "other" | "traveler" | "occupant";
         travelerCategory: "other" | "adult" | "child" | "infant" | "senior" | null;
         firstName: string;
         lastName: string;
@@ -1322,7 +1527,7 @@ export declare const bookingsService: {
     }[], {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1339,7 +1544,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         bookingId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1356,7 +1561,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         personId: import("drizzle-orm/pg-core").PgColumn<{
             name: "person_id";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1373,24 +1578,24 @@ export declare const bookingsService: {
         }, {}, {}>;
         participantType: import("drizzle-orm/pg-core").PgColumn<{
             name: "participant_type";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "staff" | "other" | "traveler" | "booker" | "contact" | "occupant";
+            data: "other" | "traveler" | "occupant";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["traveler", "booker", "contact", "occupant", "staff", "other"];
+            enumValues: ["traveler", "occupant", "other"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
         travelerCategory: import("drizzle-orm/pg-core").PgColumn<{
             name: "traveler_category";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgEnumColumn";
             data: "other" | "adult" | "child" | "infant" | "senior";
@@ -1407,7 +1612,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         firstName: import("drizzle-orm/pg-core").PgColumn<{
             name: "first_name";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1424,7 +1629,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         lastName: import("drizzle-orm/pg-core").PgColumn<{
             name: "last_name";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1441,7 +1646,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         email: import("drizzle-orm/pg-core").PgColumn<{
             name: "email";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1458,7 +1663,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         phone: import("drizzle-orm/pg-core").PgColumn<{
             name: "phone";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1475,7 +1680,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         preferredLanguage: import("drizzle-orm/pg-core").PgColumn<{
             name: "preferred_language";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1492,7 +1697,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         accessibilityNeeds: import("drizzle-orm/pg-core").PgColumn<{
             name: "accessibility_needs";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1509,7 +1714,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         specialRequests: import("drizzle-orm/pg-core").PgColumn<{
             name: "special_requests";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1526,7 +1731,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         isPrimary: import("drizzle-orm/pg-core").PgColumn<{
             name: "is_primary";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "boolean";
             columnType: "PgBoolean";
             data: boolean;
@@ -1543,7 +1748,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         notes: import("drizzle-orm/pg-core").PgColumn<{
             name: "notes";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -1560,7 +1765,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         createdAt: import("drizzle-orm/pg-core").PgColumn<{
             name: "created_at";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -1577,7 +1782,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         updatedAt: import("drizzle-orm/pg-core").PgColumn<{
             name: "updated_at";
-            tableName: "booking_participants";
+            tableName: "booking_travelers";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -1593,11 +1798,11 @@ export declare const bookingsService: {
             generated: undefined;
         }, {}, {}>;
     }>, "where" | "orderBy">;
-    getParticipantById(db: PostgresJsDatabase, bookingId: string, participantId: string): Promise<{
+    getTravelerRecordById(db: PostgresJsDatabase, bookingId: string, travelerId: string): Promise<{
         id: string;
         bookingId: string;
         personId: string | null;
-        participantType: "staff" | "other" | "traveler" | "booker" | "contact" | "occupant";
+        participantType: "other" | "traveler" | "occupant";
         travelerCategory: "other" | "adult" | "child" | "infant" | "senior" | null;
         firstName: string;
         lastName: string;
@@ -1611,7 +1816,7 @@ export declare const bookingsService: {
         createdAt: Date;
         updatedAt: Date;
     } | null>;
-    createParticipant(db: PostgresJsDatabase, bookingId: string, data: CreateParticipantInput, userId?: string): Promise<{
+    createTravelerRecord(db: PostgresJsDatabase, bookingId: string, data: CreateTravelerRecordInput, userId?: string): Promise<{
         id: string;
         notes: string | null;
         createdAt: Date;
@@ -1621,7 +1826,7 @@ export declare const bookingsService: {
         lastName: string;
         personId: string | null;
         bookingId: string;
-        participantType: "staff" | "other" | "traveler" | "booker" | "contact" | "occupant";
+        participantType: "other" | "traveler" | "occupant";
         travelerCategory: "other" | "adult" | "child" | "infant" | "senior" | null;
         phone: string | null;
         preferredLanguage: string | null;
@@ -1629,11 +1834,11 @@ export declare const bookingsService: {
         specialRequests: string | null;
         isPrimary: boolean;
     } | null>;
-    updateParticipant(db: PostgresJsDatabase, participantId: string, data: UpdateParticipantInput): Promise<{
+    updateTravelerRecord(db: PostgresJsDatabase, travelerId: string, data: UpdateTravelerRecordInput): Promise<{
         id: string;
         bookingId: string;
         personId: string | null;
-        participantType: "staff" | "other" | "traveler" | "booker" | "contact" | "occupant";
+        participantType: "other" | "traveler" | "occupant";
         travelerCategory: "other" | "adult" | "child" | "infant" | "senior" | null;
         firstName: string;
         lastName: string;
@@ -1647,46 +1852,61 @@ export declare const bookingsService: {
         createdAt: Date;
         updatedAt: Date;
     } | null>;
-    deleteParticipant(db: PostgresJsDatabase, participantId: string): Promise<{
+    deleteTravelerRecord(db: PostgresJsDatabase, travelerId: string): Promise<{
         id: string;
     } | null>;
-    listPassengers(db: PostgresJsDatabase, bookingId: string): Promise<{
+    listTravelers(db: PostgresJsDatabase, bookingId: string): Promise<{
         id: string;
         bookingId: string;
+        participantType: "other" | "traveler" | "occupant";
+        travelerCategory: "other" | "adult" | "child" | "infant" | "senior" | null;
         firstName: string;
         lastName: string;
         email: string | null;
         phone: string | null;
+        preferredLanguage: string | null;
+        accessibilityNeeds: string | null;
         specialRequests: string | null;
-        isLeadPassenger: boolean;
+        isPrimary: boolean;
+        notes: string | null;
         createdAt: Date;
         updatedAt: Date;
     }[]>;
-    createPassenger(db: PostgresJsDatabase, bookingId: string, data: CreatePassengerInput, userId?: string): Promise<{
+    createTraveler(db: PostgresJsDatabase, bookingId: string, data: CreateTravelerInput, userId?: string): Promise<{
         id: string;
         bookingId: string;
+        participantType: "other" | "traveler" | "occupant";
+        travelerCategory: "other" | "adult" | "child" | "infant" | "senior" | null;
         firstName: string;
         lastName: string;
         email: string | null;
         phone: string | null;
+        preferredLanguage: string | null;
+        accessibilityNeeds: string | null;
         specialRequests: string | null;
-        isLeadPassenger: boolean;
+        isPrimary: boolean;
+        notes: string | null;
         createdAt: Date;
         updatedAt: Date;
     } | null>;
-    updatePassenger(db: PostgresJsDatabase, passengerId: string, data: UpdatePassengerInput): Promise<{
+    updateTraveler(db: PostgresJsDatabase, travelerId: string, data: UpdateTravelerInput): Promise<{
         id: string;
         bookingId: string;
+        participantType: "other" | "traveler" | "occupant";
+        travelerCategory: "other" | "adult" | "child" | "infant" | "senior" | null;
         firstName: string;
         lastName: string;
         email: string | null;
         phone: string | null;
+        preferredLanguage: string | null;
+        accessibilityNeeds: string | null;
         specialRequests: string | null;
-        isLeadPassenger: boolean;
+        isPrimary: boolean;
+        notes: string | null;
         createdAt: Date;
         updatedAt: Date;
     } | null>;
-    deletePassenger(db: PostgresJsDatabase, passengerId: string): Promise<{
+    deleteTraveler(db: PostgresJsDatabase, travelerId: string): Promise<{
         id: string;
     } | null>;
     listItems(db: PostgresJsDatabase, bookingId: string): Omit<import("drizzle-orm/pg-core").PgSelectBase<"booking_items", {
@@ -2666,10 +2886,10 @@ export declare const bookingsService: {
     deleteItem(db: PostgresJsDatabase, itemId: string): Promise<{
         id: string;
     } | null>;
-    listItemParticipants(db: PostgresJsDatabase, itemId: string): Omit<import("drizzle-orm/pg-core").PgSelectBase<"booking_item_participants", {
+    listItemParticipants(db: PostgresJsDatabase, itemId: string): Omit<import("drizzle-orm/pg-core").PgSelectBase<"booking_item_travelers", {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -2686,7 +2906,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         bookingItemId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -2701,9 +2921,9 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        participantId: import("drizzle-orm/pg-core").PgColumn<{
+        travelerId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -2720,24 +2940,24 @@ export declare const bookingsService: {
         }, {}, {}>;
         role: import("drizzle-orm/pg-core").PgColumn<{
             name: "role";
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "other" | "traveler" | "occupant" | "primary_contact" | "service_assignee" | "beneficiary";
+            data: "other" | "traveler" | "occupant" | "beneficiary";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["traveler", "occupant", "primary_contact", "service_assignee", "beneficiary", "other"];
+            enumValues: ["traveler", "occupant", "beneficiary", "other"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
         isPrimary: import("drizzle-orm/pg-core").PgColumn<{
             name: "is_primary";
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "boolean";
             columnType: "PgBoolean";
             data: boolean;
@@ -2754,7 +2974,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         createdAt: import("drizzle-orm/pg-core").PgColumn<{
             name: "created_at";
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -2769,17 +2989,17 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-    }, "single", Record<"booking_item_participants", "not-null">, false, "where" | "orderBy", {
+    }, "single", Record<"booking_item_travelers", "not-null">, false, "where" | "orderBy", {
         id: string;
         bookingItemId: string;
-        participantId: string;
-        role: "other" | "traveler" | "occupant" | "primary_contact" | "service_assignee" | "beneficiary";
+        travelerId: string;
+        role: "other" | "traveler" | "occupant" | "beneficiary";
         isPrimary: boolean;
         createdAt: Date;
     }[], {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -2796,7 +3016,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         bookingItemId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -2811,9 +3031,9 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        participantId: import("drizzle-orm/pg-core").PgColumn<{
+        travelerId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "string";
             columnType: "PgText";
             data: string;
@@ -2830,24 +3050,24 @@ export declare const bookingsService: {
         }, {}, {}>;
         role: import("drizzle-orm/pg-core").PgColumn<{
             name: "role";
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "string";
             columnType: "PgEnumColumn";
-            data: "other" | "traveler" | "occupant" | "primary_contact" | "service_assignee" | "beneficiary";
+            data: "other" | "traveler" | "occupant" | "beneficiary";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["traveler", "occupant", "primary_contact", "service_assignee", "beneficiary", "other"];
+            enumValues: ["traveler", "occupant", "beneficiary", "other"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
         isPrimary: import("drizzle-orm/pg-core").PgColumn<{
             name: "is_primary";
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "boolean";
             columnType: "PgBoolean";
             data: boolean;
@@ -2864,7 +3084,7 @@ export declare const bookingsService: {
         }, {}, {}>;
         createdAt: import("drizzle-orm/pg-core").PgColumn<{
             name: "created_at";
-            tableName: "booking_item_participants";
+            tableName: "booking_item_travelers";
             dataType: "date";
             columnType: "PgTimestamp";
             data: Date;
@@ -2883,9 +3103,9 @@ export declare const bookingsService: {
     addItemParticipant(db: PostgresJsDatabase, itemId: string, data: CreateBookingItemParticipantInput): Promise<{
         id: string;
         createdAt: Date;
-        role: "other" | "traveler" | "occupant" | "primary_contact" | "service_assignee" | "beneficiary";
+        role: "other" | "traveler" | "occupant" | "beneficiary";
         isPrimary: boolean;
-        participantId: string;
+        travelerId: string;
         bookingItemId: string;
     } | null | undefined>;
     removeItemParticipant(db: PostgresJsDatabase, linkId: string): Promise<{
@@ -3412,7 +3632,7 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        participantId: import("drizzle-orm/pg-core").PgColumn<{
+        travelerId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
             tableName: "booking_fulfillments";
             dataType: "string";
@@ -3588,7 +3808,7 @@ export declare const bookingsService: {
         id: string;
         bookingId: string;
         bookingItemId: string | null;
-        participantId: string | null;
+        travelerId: string | null;
         fulfillmentType: "other" | "voucher" | "ticket" | "pdf" | "qr_code" | "barcode" | "mobile";
         deliveryChannel: "email" | "other" | "download" | "api" | "wallet";
         status: "pending" | "issued" | "reissued" | "revoked" | "failed";
@@ -3650,7 +3870,7 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        participantId: import("drizzle-orm/pg-core").PgColumn<{
+        travelerId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
             tableName: "booking_fulfillments";
             dataType: "string";
@@ -3829,7 +4049,7 @@ export declare const bookingsService: {
         createdAt: Date;
         updatedAt: Date;
         bookingId: string;
-        participantId: string | null;
+        travelerId: string | null;
         bookingItemId: string | null;
         fulfillmentType: "other" | "voucher" | "ticket" | "pdf" | "qr_code" | "barcode" | "mobile";
         deliveryChannel: "email" | "other" | "download" | "api" | "wallet";
@@ -3842,7 +4062,7 @@ export declare const bookingsService: {
         id: string;
         bookingId: string;
         bookingItemId: string | null;
-        participantId: string | null;
+        travelerId: string | null;
         fulfillmentType: "other" | "voucher" | "ticket" | "pdf" | "qr_code" | "barcode" | "mobile";
         deliveryChannel: "email" | "other" | "download" | "api" | "wallet";
         status: "pending" | "issued" | "reissued" | "revoked" | "failed";
@@ -3905,7 +4125,7 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        participantId: import("drizzle-orm/pg-core").PgColumn<{
+        travelerId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
             tableName: "booking_redemption_events";
             dataType: "string";
@@ -4030,7 +4250,7 @@ export declare const bookingsService: {
         id: string;
         bookingId: string;
         bookingItemId: string | null;
-        participantId: string | null;
+        travelerId: string | null;
         redeemedAt: Date;
         redeemedBy: string | null;
         location: string | null;
@@ -4089,7 +4309,7 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        participantId: import("drizzle-orm/pg-core").PgColumn<{
+        travelerId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
             tableName: "booking_redemption_events";
             dataType: "string";
@@ -4218,7 +4438,7 @@ export declare const bookingsService: {
         method: "other" | "manual" | "api" | "scan";
         redeemedAt: Date;
         bookingId: string;
-        participantId: string | null;
+        travelerId: string | null;
         bookingItemId: string | null;
         redeemedBy: string | null;
         location: string | null;
@@ -4662,6 +4882,9 @@ export declare const bookingsService: {
         authorId: string;
         content: string;
     } | null | undefined>;
+    deleteNote(db: PostgresJsDatabase, noteId: string): Promise<{
+        id: string;
+    } | null>;
     listDocuments(db: PostgresJsDatabase, bookingId: string): Omit<import("drizzle-orm/pg-core").PgSelectBase<"booking_documents", {
         id: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
@@ -4697,7 +4920,7 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        participantId: import("drizzle-orm/pg-core").PgColumn<{
+        travelerId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
             tableName: "booking_documents";
             dataType: "string";
@@ -4819,7 +5042,7 @@ export declare const bookingsService: {
     }, "single", Record<"booking_documents", "not-null">, false, "where" | "orderBy", {
         id: string;
         bookingId: string;
-        participantId: string | null;
+        travelerId: string | null;
         type: "visa" | "other" | "insurance" | "health" | "passport_copy";
         fileName: string;
         fileUrl: string;
@@ -4861,7 +5084,7 @@ export declare const bookingsService: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
-        participantId: import("drizzle-orm/pg-core").PgColumn<{
+        travelerId: import("drizzle-orm/pg-core").PgColumn<{
             name: string;
             tableName: "booking_documents";
             dataType: "string";
@@ -4988,7 +5211,7 @@ export declare const bookingsService: {
         createdAt: Date;
         expiresAt: Date | null;
         bookingId: string;
-        participantId: string | null;
+        travelerId: string | null;
         fileName: string;
         fileUrl: string;
     } | null | undefined>;