@voyant-travel/cruises 0.118.2

package/dist/booking-engine/handler.js

@@ -0,0 +1,225 @@
+/**
+ * Owned-arm booking handler for the `cruises` vertical (Phase F
+ * skeleton).
+ *
+ * Per `docs/architecture/booking-journey-architecture.md` §6 +
+ * §7 (cruise example) + §10 Phase F.
+ *
+ * computeQuote scope:
+ *   - Reads cruise content via the caller-supplied loader
+ *     (`getCruiseContent`).
+ *   - Projects to a `BookingDraftShape` with cabin-category +
+ *     occupancy sub-steps via `buildCruiseDraftShape`.
+ *   - When a sailing + cabin category + occupancy are picked,
+ *     looks up the per-occupancy `cruise_prices` row and returns
+ *     pricing as `pricePerPerson × paxCount`.
+ *
+ * commit scope:
+ *   - Returns `failed:not_yet_implemented`. Cruises need a
+ *     vertical-specific commit primitive (cabin allocation +
+ *     supplier hold + air-add-on routing) that doesn't exist
+ *     today. The shell renders the descriptor cleanly; commit
+ *     lands separately.
+ */
+import { buildCruiseDraftShape } from "../draft-shape.js";
+export function createCruiseBookingHandler(options) {
+    return {
+        entityModule: "cruises",
+        // Cruise lines commonly hold cabin capacity for 24h after a
+        // journey times out (the "I'll be right back" pattern). Per
+        // booking-journey-architecture §12.9. Templates can override
+        // by replacing the handler at boot.
+        holdReleaseGraceMs: 24 * 60 * 60 * 1000,
+        async computeQuote(ctx, request) {
+            const content = await options.loadContent(ctx, request.entityId);
+            if (!content) {
+                return { available: false, invalidReason: "cruise_not_found" };
+            }
+            const shape = buildCruiseDraftShape(content, {
+                forceCabinNumberSubStep: options.forceCabinNumberSubStep,
+                includeInsurance: options.includeInsurance,
+            });
+            const draft = (request.draft ?? {});
+            const sailingId = draft.configure?.departureSlotId;
+            const cabinCategoryId = draft.configure?.cabinCategoryId;
+            const paxCount = sumPax(draft.configure?.pax);
+            // Pricing requires (sailing, category, occupancy). Until the
+            // user picks all three, return shape only — the wizard
+            // renders the steps and waits.
+            if (!sailingId || !cabinCategoryId || paxCount <= 0) {
+                return { available: true, shape };
+            }
+            const price = await options.loadPrice(ctx, {
+                entityId: request.entityId,
+                sailingId,
+                cabinCategoryId,
+                occupancy: paxCount,
+            });
+            if (!price) {
+                return {
+                    available: false,
+                    invalidReason: "no_price_for_occupancy",
+                    shape,
+                };
+            }
+            const perPaxCents = priceStringToCents(price.pricePerPerson);
+            const totalCents = perPaxCents * paxCount;
+            return {
+                available: true,
+                shape,
+                pricing: {
+                    base_amount: totalCents,
+                    taxes: 0,
+                    fees: 0,
+                    surcharges: 0,
+                    currency: price.currency,
+                    breakdown: {
+                        lines: [
+                            {
+                                kind: "base",
+                                label: cabinCategoryLabel(content, cabinCategoryId, price.fareCode ?? null),
+                                quantity: paxCount,
+                                unitAmount: perPaxCents,
+                                totalAmount: totalCents,
+                            },
+                        ],
+                        subtotal: totalCents,
+                        taxTotal: 0,
+                        total: totalCents,
+                        paxCount,
+                        occupancy: paxCount,
+                        sailingId,
+                        cabinCategoryId,
+                        fareCode: price.fareCode ?? null,
+                    },
+                },
+            };
+        },
+        async commit(_ctx, request) {
+            if (!options.commitBridge) {
+                return {
+                    status: "failed",
+                    orderRef: "",
+                    upstreamPayload: { reason: "cruise_commit_bridge_not_wired" },
+                };
+            }
+            const draft = (request.draft ?? {});
+            const sailingId = draft.configure?.departureSlotId;
+            const cabinCategoryId = draft.configure?.cabinCategoryId;
+            const cabinId = draft.configure?.cabinNumberId;
+            const occupancy = sumPax(draft.configure?.pax);
+            if (!sailingId || !cabinCategoryId || occupancy <= 0) {
+                return {
+                    status: "failed",
+                    orderRef: "",
+                    upstreamPayload: {
+                        reason: "cruise_commit_missing_inputs",
+                        need: ["sailingId", "cabinCategoryId", "occupancy"],
+                    },
+                };
+            }
+            const contact = {
+                firstName: draft.billing?.contact?.firstName ?? "",
+                lastName: draft.billing?.contact?.lastName ?? "",
+                email: draft.billing?.contact?.email ?? null,
+                phone: draft.billing?.contact?.phone ?? null,
+            };
+            const passengers = (draft.travelers ?? []).map((t) => ({
+                firstName: t.firstName,
+                lastName: t.lastName,
+                dateOfBirth: t.dateOfBirth ?? null,
+                travelerCategory: t.band === "child" || t.band === "infant"
+                    ? t.band
+                    : "adult",
+            }));
+            // The cruise commit primitive demands at least one passenger;
+            // if the journey didn't collect them, fall back to the lead
+            // contact as a single passenger so the commit doesn't reject
+            // outright. Operators using the journey for inquiry-style
+            // bookings can fill traveler details from the booking detail
+            // page later.
+            if (passengers.length === 0) {
+                passengers.push({
+                    firstName: contact.firstName,
+                    lastName: contact.lastName,
+                    dateOfBirth: null,
+                    travelerCategory: "adult",
+                });
+            }
+            const bridge = await options.commitBridge({
+                sailingId,
+                cabinCategoryId,
+                cabinId: cabinId ?? null,
+                occupancy,
+                fareCode: draft.configure?.variantId ?? null,
+                personId: extractPersonId(request.party),
+                organizationId: extractOrganizationId(request.party),
+                contact,
+                passengers,
+                airArrangement: draft.configure?.airArrangement ?? null,
+                notes: draft.internalNotes ?? null,
+            });
+            if (bridge.status !== "ok" || !bridge.bookingId) {
+                return {
+                    status: "failed",
+                    orderRef: "",
+                    upstreamPayload: { reason: bridge.reason ?? "cruise_commit_failed" },
+                };
+            }
+            return {
+                status: "held",
+                orderRef: bridge.bookingNumber ?? bridge.bookingId,
+                pricing: request.pricing,
+                upstreamPayload: { bridgeBookingId: bridge.bookingId },
+            };
+        },
+        async placeHold(_ctx, request) {
+            const token = request.draftId ?? `cruise_${Date.now().toString(36)}`;
+            return {
+                holdToken: token,
+                expiresAt: new Date(Date.now() + request.ttlMs),
+            };
+        },
+        async releaseHold(_ctx, _holdToken) {
+            // No-op until supplier-side hold APIs are wired.
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────
+function sumPax(pax) {
+    if (!pax)
+        return 0;
+    let total = 0;
+    for (const v of Object.values(pax)) {
+        if (typeof v === "number" && Number.isFinite(v) && v > 0)
+            total += v;
+    }
+    return total;
+}
+function extractPersonId(party) {
+    if (!party)
+        return undefined;
+    const v = party.personId;
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function extractOrganizationId(party) {
+    if (!party)
+        return undefined;
+    const v = party.organizationId;
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+function priceStringToCents(price) {
+    // cruise_prices.pricePerPerson is numeric(precision, scale). The
+    // major-unit string parses straight; round to integer cents.
+    const major = Number.parseFloat(price);
+    if (!Number.isFinite(major))
+        return 0;
+    return Math.round(major * 100);
+}
+function cabinCategoryLabel(content, categoryId, fareCode) {
+    const category = content.cabin_categories.find((c) => c.id === categoryId);
+    const base = category?.name ?? "Cabin";
+    return fareCode ? `${base} (${fareCode})` : base;
+}

package/dist/booking-engine/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `@voyant-travel/cruises/booking-engine` — owned-arm booking handler
+ * for the cruises vertical (Phase F skeleton).
+ *
+ * Per `docs/architecture/booking-journey-architecture.md` §6 + §10
+ * Phase F.
+ */
+export { type CreateCruiseBookingHandlerOptions, type CruiseCommitBridge, type CruiseCommitBridgeInput, type CruiseCommitBridgeResult, type CruiseHandlerLoaders, createCruiseBookingHandler, type ResolvedCruisePrice, } from "./handler.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/booking-engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/booking-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,iCAAiC,EACtC,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAA"}

package/dist/booking-engine/index.js

@@ -0,0 +1,8 @@
+/**
+ * `@voyant-travel/cruises/booking-engine` — owned-arm booking handler
+ * for the cruises vertical (Phase F skeleton).
+ *
+ * Per `docs/architecture/booking-journey-architecture.md` §6 + §10
+ * Phase F.
+ */
+export { createCruiseBookingHandler, } from "./handler.js";