@voyant-travel/cruises 0.118.2

package/dist/service-booking-types.d.ts

@@ -0,0 +1,101 @@
+import type { CruiseAdapter, ExternalBookingTerms, ExternalFareVariant, ExternalPassengerComposition, SourceRef } from "./adapters/index.js";
+import type { BookingCruiseDetail, BookingGroupCruiseDetail } from "./booking-extension.js";
+import type { Quote } from "./service-pricing.js";
+export type CruiseBookingPassenger = {
+    firstName: string;
+    lastName: string;
+    email?: string | null;
+    phone?: string | null;
+    travelerCategory?: "adult" | "child" | "infant" | "senior" | "other" | null;
+    preferredLanguage?: string | null;
+    specialRequests?: string | null;
+    personId?: string | null;
+    isPrimary?: boolean;
+    notes?: string | null;
+};
+export type CruiseBookingContact = {
+    firstName: string;
+    lastName: string;
+    email?: string | null;
+    phone?: string | null;
+    language?: string | null;
+    country?: string | null;
+    region?: string | null;
+    city?: string | null;
+    address?: string | null;
+    postalCode?: string | null;
+};
+export type CruiseBookingMode = "inquiry" | "reserve";
+export type CreateCruiseBookingInput = {
+    sailingId: string;
+    cabinCategoryId: string;
+    cabinId?: string | null;
+    occupancy: number;
+    fareCode?: string | null;
+    fareVariant?: ExternalFareVariant | null;
+    mode?: CruiseBookingMode;
+    personId?: string | null;
+    organizationId?: string | null;
+    contact: CruiseBookingContact;
+    passengers: CruiseBookingPassenger[];
+    notes?: string | null;
+    /**
+     * Air-arrangement intent for this cruise. The cruise booking
+     * itself only carries the cabin line; the actual flight booking
+     * lives in the flights vertical (or with the customer when
+     * "independent"). Per booking-journey-architecture §7.
+     */
+    airArrangement?: "cruise_line" | "independent" | "none" | null;
+    /** Optional pointer to a linked flight booking when the composer
+     *  ties cabin + flight lines together. */
+    linkedFlightBookingId?: string | null;
+};
+export type CreateCruiseBookingResult = {
+    bookingId: string;
+    bookingNumber: string;
+    cruiseDetails: BookingCruiseDetail;
+    quote: Quote;
+};
+export type CruisePartyCabinEntry = {
+    cabinCategoryId: string;
+    cabinId?: string | null;
+    occupancy: number;
+    fareCode?: string | null;
+    fareVariant?: ExternalFareVariant | null;
+    passengers: CruiseBookingPassenger[];
+    notes?: string | null;
+};
+export type CreateCruisePartyBookingInput = {
+    sailingId: string;
+    cabins: CruisePartyCabinEntry[];
+    leadPersonId?: string | null;
+    organizationId?: string | null;
+    contact: CruiseBookingContact;
+    mode?: CruiseBookingMode;
+    label?: string;
+    notes?: string | null;
+};
+export type CreateCruisePartyBookingResult = {
+    groupId: string;
+    primaryBookingId: string | null;
+    groupDetails: BookingGroupCruiseDetail;
+    cabins: CreateCruiseBookingResult[];
+};
+export type CreateExternalCruiseBookingInput = {
+    adapter: CruiseAdapter;
+    sailingRef: SourceRef;
+    cabinCategoryRef: SourceRef;
+    cabinId?: string | null;
+    occupancy: number;
+    passengerComposition?: ExternalPassengerComposition | null;
+    fareCode?: string | null;
+    fareVariant?: ExternalFareVariant | null;
+    mode?: CruiseBookingMode;
+    personId?: string | null;
+    organizationId?: string | null;
+    contact: CruiseBookingContact;
+    passengers: CruiseBookingPassenger[];
+    bookingTerms?: ExternalBookingTerms | null;
+    notes?: string | null;
+};
+//# sourceMappingURL=service-booking-types.d.ts.map

package/dist/service-booking-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-booking-types.d.ts","sourceRoot":"","sources":["../src/service-booking-types.ts"],"names":[],"mappings":"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"}

package/dist/service-booking-types.js

@@ -0,0 +1 @@
+export {};

package/dist/service-bookings.d.ts

@@ -0,0 +1,46 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { SourceRef } from "./adapters/index.js";
+import type { CreateCruiseBookingInput, CreateCruiseBookingResult, CreateCruisePartyBookingInput, CreateCruisePartyBookingResult, CreateExternalCruiseBookingInput } from "./service-booking-types.js";
+export type { CreateCruiseBookingInput, CreateCruiseBookingResult, CreateCruisePartyBookingInput, CreateCruisePartyBookingResult, CreateExternalCruiseBookingInput, CruiseBookingContact, CruiseBookingMode, CruiseBookingPassenger, CruisePartyCabinEntry, } from "./service-booking-types.js";
+export declare const cruisesBookingService: {
+    /**
+     * Create a single-cabin cruise booking.
+     *
+     * Atomic: assembles the quote, creates the booking via bookingsService,
+     * inserts travelers, snapshots the quote into booking_cruise_details — all
+     * in one transaction. If any step fails the transaction is rolled back.
+     *
+     * Self-managed (local) sailings only in v1. External sailings flow through
+     * the adapter contract in §10 of the design doc; that branch lands in phase 3.
+     */
+    createCruiseBooking(db: PostgresJsDatabase, input: CreateCruiseBookingInput, userId?: string): Promise<CreateCruiseBookingResult>;
+    /**
+     * Create a multi-cabin cruise booking — one booking_group of kind 'cruise_party'
+     * containing N child cabin bookings on the same sailing.
+     *
+     * Same atomicity guarantees as createCruiseBooking. The group is the unit of
+     * shared confirmation / atomic cancellation / single deposit.
+     */
+    createCruisePartyBooking(db: PostgresJsDatabase, input: CreateCruisePartyBookingInput, userId?: string): Promise<CreateCruisePartyBookingResult>;
+    /**
+     * Create a single-cabin booking against an external (adapter-sourced) sailing.
+     *
+     * 1. Fetch sailing pricing from the adapter and pick the matching row.
+     * 2. composeQuote locally — pricing math is identical to local sailings.
+     * 3. Call adapter.createBooking to commit upstream — receives the carrier's
+     *    confirmation reference.
+     * 4. Create the local booking row + travelers + booking_cruise_details with
+     *    source='external' and the upstream connectorBookingRef snapshotted.
+     *
+     * If the upstream commit succeeds but the local insert fails, the upstream
+     * booking exists with no local trace — operators see it through the adapter's
+     * own UI but can't manage it via Voyant. v2 will introduce a reconciliation
+     * sweep; v1 surfaces the upstream ref in the error so the operator can manually
+     * cancel if needed.
+     */
+    createExternalCruiseBooking(db: PostgresJsDatabase, input: CreateExternalCruiseBookingInput, userId?: string): Promise<CreateCruiseBookingResult & {
+        sourceProvider: string;
+        sourceRef: SourceRef;
+    }>;
+};
+//# sourceMappingURL=service-bookings.d.ts.map

package/dist/service-bookings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-bookings.d.ts","sourceRoot":"","sources":["../src/service-bookings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAapD,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,gCAAgC,EAEjC,MAAM,4BAA4B,CAAA;AAGnC,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,gCAAgC,EAChC,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,4BAA4B,CAAA;AAEnC,eAAO,MAAM,qBAAqB;IAChC;;;;;;;;;OASG;4BAEG,kBAAkB,SACf,wBAAwB,WACtB,MAAM,GACd,OAAO,CAAC,yBAAyB,CAAC;IAwGrC;;;;;;OAMG;iCAEG,kBAAkB,SACf,6BAA6B,WAC3B,MAAM,GACd,OAAO,CAAC,8BAA8B,CAAC;IA+K1C;;;;;;;;;;;;;;;OAeG;oCAEG,kBAAkB,SACf,gCAAgC,WAC9B,MAAM,GACd,OAAO,CAAC,yBAAyB,GAAG;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE,CAAC;CA2KzF,CAAA"}

package/dist/service-bookings.js

@@ -0,0 +1,420 @@
+import { bookingGroupsService, bookingsService } from "@voyant-travel/bookings";
+import { bookingCruiseDetailsService, bookingGroupCruiseDetailsService, } from "./booking-extension.js";
+import { assertPassengerCompositionMatchesPassengers, generateCruiseBookingNumber, passengerCompositionCount, passengerCompositionMatches, priceCentsFromString, sourceRefMatches, } from "./service-booking-helpers.js";
+import { composeQuote, pricingService } from "./service-pricing.js";
+export const cruisesBookingService = {
+    /**
+     * Create a single-cabin cruise booking.
+     *
+     * Atomic: assembles the quote, creates the booking via bookingsService,
+     * inserts travelers, snapshots the quote into booking_cruise_details — all
+     * in one transaction. If any step fails the transaction is rolled back.
+     *
+     * Self-managed (local) sailings only in v1. External sailings flow through
+     * the adapter contract in §10 of the design doc; that branch lands in phase 3.
+     */
+    async createCruiseBooking(db, input, userId) {
+        const guestCount = input.passengers.length;
+        if (guestCount < 1)
+            throw new Error("At least one passenger is required");
+        if (guestCount > input.occupancy) {
+            throw new Error(`passengers.length (${guestCount}) cannot exceed occupancy (${input.occupancy})`);
+        }
+        return db.transaction(async (tx) => {
+            // 1. Resolve quote (reads pricing for self-managed sailings).
+            const quote = await pricingService.assembleQuote(tx, {
+                sailingId: input.sailingId,
+                cabinCategoryId: input.cabinCategoryId,
+                occupancy: input.occupancy,
+                guestCount,
+                fareCode: input.fareCode ?? null,
+                fareVariant: input.fareVariant ?? null,
+            });
+            // 2. Create the booking row.
+            const bookingNumber = generateCruiseBookingNumber();
+            const totalCents = priceCentsFromString(quote.totalForCabin);
+            const booking = await bookingsService.createBooking(tx, {
+                bookingNumber,
+                sellCurrency: quote.currency,
+                status: "draft",
+                sourceType: "manual",
+                personId: input.personId ?? null,
+                organizationId: input.organizationId ?? null,
+                contactFirstName: input.contact.firstName,
+                contactLastName: input.contact.lastName,
+                contactEmail: input.contact.email ?? null,
+                contactPhone: input.contact.phone ?? null,
+                contactPreferredLanguage: input.contact.language ?? null,
+                contactCountry: input.contact.country ?? null,
+                contactRegion: input.contact.region ?? null,
+                contactCity: input.contact.city ?? null,
+                contactAddressLine1: input.contact.address ?? null,
+                contactPostalCode: input.contact.postalCode ?? null,
+                sellAmountCents: totalCents,
+                pax: guestCount,
+                internalNotes: input.notes ?? null,
+            }, userId);
+            if (!booking)
+                throw new Error("bookingsService.createBooking returned null");
+            // 3. Insert travelers.
+            for (const passenger of input.passengers) {
+                await bookingsService.createTraveler(tx, booking.id, {
+                    firstName: passenger.firstName,
+                    lastName: passenger.lastName,
+                    email: passenger.email ?? null,
+                    phone: passenger.phone ?? null,
+                    travelerCategory: passenger.travelerCategory ?? null,
+                    preferredLanguage: passenger.preferredLanguage ?? null,
+                    specialRequests: passenger.specialRequests ?? null,
+                    isPrimary: passenger.isPrimary ?? false,
+                    notes: passenger.notes ?? null,
+                }, userId);
+            }
+            // 4. Snapshot the quote into booking_cruise_details.
+            const cruiseDetails = await bookingCruiseDetailsService.upsert(tx, booking.id, {
+                source: "local",
+                sourceProvider: null,
+                sourceRef: null,
+                sailingId: input.sailingId,
+                cabinCategoryId: input.cabinCategoryId,
+                cabinId: input.cabinId ?? null,
+                sailingDisplayName: null,
+                cabinDisplayName: null,
+                occupancy: input.occupancy,
+                fareCode: input.fareCode ?? null,
+                fareVariant: quote.fareVariant,
+                mode: input.mode ?? "inquiry",
+                quotedPricePerPerson: quote.totalPerPerson,
+                quotedTotalForCabin: quote.totalForCabin,
+                quotedCurrency: quote.currency,
+                quotedComponentsJson: quote.components,
+                connectorBookingRef: null,
+                connectorStatus: null,
+                airArrangement: input.airArrangement ?? null,
+                linkedFlightBookingId: input.linkedFlightBookingId ?? null,
+                notes: input.notes ?? null,
+            });
+            return {
+                bookingId: booking.id,
+                bookingNumber: booking.bookingNumber,
+                cruiseDetails,
+                quote,
+            };
+        });
+    },
+    /**
+     * Create a multi-cabin cruise booking — one booking_group of kind 'cruise_party'
+     * containing N child cabin bookings on the same sailing.
+     *
+     * Same atomicity guarantees as createCruiseBooking. The group is the unit of
+     * shared confirmation / atomic cancellation / single deposit.
+     */
+    async createCruisePartyBooking(db, input, userId) {
+        if (input.cabins.length < 2) {
+            throw new Error("createCruisePartyBooking requires at least 2 cabins; use createCruiseBooking for a single cabin");
+        }
+        if (input.cabins.length > 20) {
+            throw new Error("createCruisePartyBooking supports at most 20 cabins per group");
+        }
+        return db.transaction(async (tx) => {
+            // 1. Quote each cabin independently and validate currency consistency.
+            const quotes = [];
+            for (const cabin of input.cabins) {
+                const guestCount = cabin.passengers.length;
+                if (guestCount < 1)
+                    throw new Error("Each cabin in a party booking must have at least one passenger");
+                if (guestCount > cabin.occupancy)
+                    throw new Error(`Cabin passengers.length (${guestCount}) cannot exceed occupancy (${cabin.occupancy})`);
+                const quote = await pricingService.assembleQuote(tx, {
+                    sailingId: input.sailingId,
+                    cabinCategoryId: cabin.cabinCategoryId,
+                    occupancy: cabin.occupancy,
+                    guestCount,
+                    fareCode: cabin.fareCode ?? null,
+                    fareVariant: cabin.fareVariant ?? null,
+                });
+                quotes.push({ quote, cabin });
+            }
+            const firstCurrency = quotes[0]?.quote.currency;
+            if (!firstCurrency)
+                throw new Error("No quotes assembled");
+            for (const q of quotes) {
+                if (q.quote.currency !== firstCurrency) {
+                    throw new Error(`All cabins in a party booking must share a currency; got ${q.quote.currency} after ${firstCurrency}`);
+                }
+            }
+            // 2. Create the booking group up front so we have a primaryBookingId target.
+            const group = await bookingGroupsService.createBookingGroup(tx, {
+                kind: "cruise_party",
+                label: input.label ?? `Party booking on sailing ${input.sailingId}`,
+                primaryBookingId: null,
+                productId: null,
+                optionUnitId: null,
+                metadata: { sailingId: input.sailingId, cabinCount: input.cabins.length },
+            });
+            // 3. Create each cabin booking and add it to the group.
+            const cabinResults = [];
+            let primaryBookingId = null;
+            for (let i = 0; i < quotes.length; i++) {
+                const { cabin, quote } = quotes[i];
+                const isPrimary = i === 0;
+                const bookingNumber = generateCruiseBookingNumber(i + 1);
+                const totalCents = priceCentsFromString(quote.totalForCabin);
+                const booking = await bookingsService.createBooking(tx, {
+                    bookingNumber,
+                    sellCurrency: quote.currency,
+                    status: "draft",
+                    sourceType: "manual",
+                    personId: input.leadPersonId ?? null,
+                    organizationId: input.organizationId ?? null,
+                    contactFirstName: input.contact.firstName,
+                    contactLastName: input.contact.lastName,
+                    contactEmail: input.contact.email ?? null,
+                    contactPhone: input.contact.phone ?? null,
+                    contactPreferredLanguage: input.contact.language ?? null,
+                    contactCountry: input.contact.country ?? null,
+                    contactRegion: input.contact.region ?? null,
+                    contactCity: input.contact.city ?? null,
+                    contactAddressLine1: input.contact.address ?? null,
+                    contactPostalCode: input.contact.postalCode ?? null,
+                    sellAmountCents: totalCents,
+                    pax: cabin.passengers.length,
+                    internalNotes: cabin.notes ?? null,
+                }, userId);
+                if (!booking)
+                    throw new Error("bookingsService.createBooking returned null");
+                for (const passenger of cabin.passengers) {
+                    await bookingsService.createTraveler(tx, booking.id, {
+                        firstName: passenger.firstName,
+                        lastName: passenger.lastName,
+                        email: passenger.email ?? null,
+                        phone: passenger.phone ?? null,
+                        travelerCategory: passenger.travelerCategory ?? null,
+                        preferredLanguage: passenger.preferredLanguage ?? null,
+                        specialRequests: passenger.specialRequests ?? null,
+                        isPrimary: passenger.isPrimary ?? false,
+                        notes: passenger.notes ?? null,
+                    }, userId);
+                }
+                const cruiseDetails = await bookingCruiseDetailsService.upsert(tx, booking.id, {
+                    source: "local",
+                    sourceProvider: null,
+                    sourceRef: null,
+                    sailingId: input.sailingId,
+                    cabinCategoryId: cabin.cabinCategoryId,
+                    cabinId: cabin.cabinId ?? null,
+                    sailingDisplayName: null,
+                    cabinDisplayName: null,
+                    occupancy: cabin.occupancy,
+                    fareCode: cabin.fareCode ?? null,
+                    fareVariant: quote.fareVariant,
+                    mode: input.mode ?? "inquiry",
+                    quotedPricePerPerson: quote.totalPerPerson,
+                    quotedTotalForCabin: quote.totalForCabin,
+                    quotedCurrency: quote.currency,
+                    quotedComponentsJson: quote.components,
+                    connectorBookingRef: null,
+                    connectorStatus: null,
+                    notes: cabin.notes ?? null,
+                });
+                const memberResult = await bookingGroupsService.addGroupMember(tx, group.id, {
+                    bookingId: booking.id,
+                    role: isPrimary ? "primary" : "shared",
+                });
+                if (memberResult.status !== "ok") {
+                    throw new Error(`Failed to add booking ${booking.id} to group ${group.id}: ${memberResult.status}`);
+                }
+                if (isPrimary)
+                    primaryBookingId = booking.id;
+                cabinResults.push({
+                    bookingId: booking.id,
+                    bookingNumber: booking.bookingNumber,
+                    cruiseDetails,
+                    quote,
+                });
+            }
+            // 4. Sum the per-cabin totals for the group snapshot.
+            let totalCents = 0;
+            for (const r of cabinResults) {
+                totalCents += priceCentsFromString(r.quote.totalForCabin);
+            }
+            const totalString = `${Math.trunc(totalCents / 100)}.${(Math.abs(totalCents) % 100).toString().padStart(2, "0")}`;
+            const groupDetails = await bookingGroupCruiseDetailsService.upsert(tx, group.id, {
+                source: "local",
+                sourceProvider: null,
+                sourceRef: null,
+                sailingId: input.sailingId,
+                sailingDisplayName: null,
+                cabinCount: input.cabins.length,
+                totalQuotedAmount: totalString,
+                quotedCurrency: firstCurrency,
+                connectorBookingRef: null,
+                notes: input.notes ?? null,
+            });
+            return {
+                groupId: group.id,
+                primaryBookingId,
+                groupDetails,
+                cabins: cabinResults,
+            };
+        });
+    },
+    /**
+     * Create a single-cabin booking against an external (adapter-sourced) sailing.
+     *
+     * 1. Fetch sailing pricing from the adapter and pick the matching row.
+     * 2. composeQuote locally — pricing math is identical to local sailings.
+     * 3. Call adapter.createBooking to commit upstream — receives the carrier's
+     *    confirmation reference.
+     * 4. Create the local booking row + travelers + booking_cruise_details with
+     *    source='external' and the upstream connectorBookingRef snapshotted.
+     *
+     * If the upstream commit succeeds but the local insert fails, the upstream
+     * booking exists with no local trace — operators see it through the adapter's
+     * own UI but can't manage it via Voyant. v2 will introduce a reconciliation
+     * sweep; v1 surfaces the upstream ref in the error so the operator can manually
+     * cancel if needed.
+     */
+    async createExternalCruiseBooking(db, input, userId) {
+        const passengerComposition = assertPassengerCompositionMatchesPassengers(input.passengerComposition, input.passengers);
+        const guestCount = passengerCompositionCount(passengerComposition);
+        if (guestCount < 1)
+            throw new Error("At least one passenger is required");
+        if (guestCount > input.occupancy) {
+            throw new Error(`passengers.length (${guestCount}) cannot exceed occupancy (${input.occupancy})`);
+        }
+        // 1. Fetch upstream pricing + locate the matching row.
+        const prices = await input.adapter.fetchSailingPricing(input.sailingRef);
+        const matching = prices.find((p) => sourceRefMatches(p.cabinCategoryRef, input.cabinCategoryRef) &&
+            p.occupancy === input.occupancy &&
+            passengerCompositionMatches(p.passengerComposition, passengerComposition) &&
+            (!input.fareCode || p.fareCode === input.fareCode) &&
+            (!input.fareVariant || p.fareVariant === input.fareVariant));
+        if (!matching) {
+            throw new Error(`Adapter '${input.adapter.name}' has no matching price for sailing=${input.sailingRef.externalId} category=${input.cabinCategoryRef.externalId} occupancy=${input.occupancy}`);
+        }
+        // 2. Compose the quote locally for snapshot purposes.
+        const quote = composeQuote({
+            price: {
+                pricePerPerson: matching.pricePerPerson,
+                originalPricePerPerson: matching.originalPricePerPerson ?? null,
+                secondGuestPricePerPerson: matching.secondGuestPricePerPerson ?? null,
+                singlePricePerPerson: matching.singlePricePerPerson ?? null,
+                singleSupplementPercent: matching.singleSupplementPercent ?? null,
+                currency: matching.currency,
+                fareCode: matching.fareCode ?? null,
+                fareCodeName: matching.fareCodeName ?? null,
+                fareVariant: matching.fareVariant ?? "cruise_only",
+                earlyBookingDeadline: matching.earlyBookingDeadline ?? null,
+                earlyBookingBonusDescription: matching.earlyBookingBonusDescription ?? null,
+            },
+            components: (matching.components ?? []).map((c) => ({
+                kind: c.kind,
+                label: c.label ?? null,
+                amount: c.amount,
+                currency: c.currency,
+                direction: c.direction,
+                perPerson: c.perPerson,
+            })),
+            occupancy: input.occupancy,
+            guestCount,
+            bookingTerms: input.bookingTerms ?? matching.bookingTerms ?? null,
+        });
+        // 3. Commit upstream BEFORE writing local rows so we can fail loudly if the
+        //    cruise line rejects the booking.
+        const upstream = await input.adapter.createBooking({
+            sailingRef: input.sailingRef,
+            cabinCategoryRef: input.cabinCategoryRef,
+            occupancy: input.occupancy,
+            passengerComposition,
+            fareCode: input.fareCode ?? null,
+            fareVariant: input.fareVariant ?? null,
+            passengers: input.passengers,
+            contact: input.contact,
+            bookingTerms: input.bookingTerms ?? matching.bookingTerms ?? null,
+            notes: input.notes ?? null,
+        });
+        // The adapter may return a refined quote (e.g. last-minute promo expired).
+        // Prefer the upstream-resolved quote when present.
+        const finalQuote = upstream.finalQuote ?? quote;
+        const finalComponents = upstream.finalComponents ?? quote.components;
+        const finalBookingTerms = upstream.finalBookingTerms ??
+            finalQuote.bookingTerms ??
+            input.bookingTerms ??
+            matching.bookingTerms ??
+            null;
+        // 4. Local persistence (now that upstream confirmation is in hand).
+        return db.transaction(async (tx) => {
+            const bookingNumber = generateCruiseBookingNumber();
+            const totalCents = priceCentsFromString(finalQuote.totalForCabin);
+            const booking = await bookingsService.createBooking(tx, {
+                bookingNumber,
+                sellCurrency: finalQuote.currency,
+                status: "draft",
+                sourceType: "manual",
+                personId: input.personId ?? null,
+                organizationId: input.organizationId ?? null,
+                contactFirstName: input.contact.firstName,
+                contactLastName: input.contact.lastName,
+                contactEmail: input.contact.email ?? null,
+                contactPhone: input.contact.phone ?? null,
+                contactPreferredLanguage: input.contact.language ?? null,
+                contactCountry: input.contact.country ?? null,
+                contactRegion: input.contact.region ?? null,
+                contactCity: input.contact.city ?? null,
+                contactAddressLine1: input.contact.address ?? null,
+                contactPostalCode: input.contact.postalCode ?? null,
+                sellAmountCents: totalCents,
+                pax: guestCount,
+                internalNotes: input.notes ?? null,
+            }, userId);
+            if (!booking) {
+                throw new Error(`Upstream booking ${upstream.connectorBookingRef} succeeded but local createBooking returned null. Operator must reconcile manually.`);
+            }
+            for (const passenger of input.passengers) {
+                await bookingsService.createTraveler(tx, booking.id, {
+                    firstName: passenger.firstName,
+                    lastName: passenger.lastName,
+                    email: passenger.email ?? null,
+                    phone: passenger.phone ?? null,
+                    travelerCategory: passenger.travelerCategory ?? null,
+                    preferredLanguage: passenger.preferredLanguage ?? null,
+                    specialRequests: passenger.specialRequests ?? null,
+                    isPrimary: passenger.isPrimary ?? false,
+                    notes: null,
+                }, userId);
+            }
+            const cruiseDetails = await bookingCruiseDetailsService.upsert(tx, booking.id, {
+                source: "external",
+                sourceProvider: input.adapter.name,
+                sourceRef: input.sailingRef,
+                sailingId: null,
+                cabinCategoryId: null,
+                cabinId: null,
+                sailingDisplayName: null,
+                cabinDisplayName: null,
+                occupancy: input.occupancy,
+                fareCode: input.fareCode ?? null,
+                fareVariant: finalQuote.fareVariant,
+                mode: input.mode ?? "inquiry",
+                quotedPricePerPerson: finalQuote.totalPerPerson,
+                quotedTotalForCabin: finalQuote.totalForCabin,
+                quotedCurrency: finalQuote.currency,
+                quotedComponentsJson: finalComponents,
+                bookingTermsSnapshotJson: finalBookingTerms,
+                passengerCompositionSnapshotJson: passengerComposition,
+                connectorBookingRef: upstream.connectorBookingRef,
+                connectorStatus: upstream.connectorStatus ?? null,
+                notes: input.notes ?? null,
+            });
+            return {
+                bookingId: booking.id,
+                bookingNumber: booking.bookingNumber,
+                cruiseDetails,
+                quote: finalQuote,
+                sourceProvider: input.adapter.name,
+                sourceRef: input.sailingRef,
+            };
+        });
+    },
+};

package/dist/service-catalog-plane-cabins.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cruise cabin/deck projection extension.
+ *
+ * Joins a cruise's default ship to cabin categories, specific cabins, and
+ * decks, then denormalizes machine-filterable cabin/deck facets onto the
+ * cruise search document.
+ */
+import type { CruiseProjectionExtension } from "./service-catalog-plane.js";
+export interface CruiseCabinFacetJoinRow {
+    cabinCategoryId: string;
+    cabinCategoryCode: string;
+    roomType: string;
+    featureCodes: string[] | null;
+    bedConfigurations: string[] | null;
+    accessibilityFeatures: string[] | null;
+    viewType: string | null;
+    gradeCodes: string[] | null;
+    deckId: string | null;
+    deckName: string | null;
+    deckLevel: number | null;
+}
+export declare function projectCruiseCabinFacetRows(rows: ReadonlyArray<CruiseCabinFacetJoinRow>): ReadonlyMap<string, unknown>;
+export declare function createCruiseCabinFacetProjectionExtension(): CruiseProjectionExtension;
+//# sourceMappingURL=service-catalog-plane-cabins.d.ts.map

package/dist/service-catalog-plane-cabins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-catalog-plane-cabins.d.ts","sourceRoot":"","sources":["../src/service-catalog-plane-cabins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AAE3E,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC7B,iBAAiB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAClC,qBAAqB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,aAAa,CAAC,uBAAuB,CAAC,GAC3C,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CA0C9B;AAED,wBAAgB,yCAAyC,IAAI,yBAAyB,CA4BrF"}