@voyant-travel/bookings-react 0.119.3

package/dist/journey/components/step-header.js

@@ -0,0 +1,12 @@
+"use client";
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Button } from "@voyant-travel/ui/components/button";
+import { useBookingsUiMessagesOrDefault } from "../../i18n/index.js";
+export function StepHeader({ current, visited, steps, onJumpTo, }) {
+    const messages = useBookingsUiMessagesOrDefault();
+    return (_jsx("ol", { className: "flex flex-wrap gap-2", children: steps.map((step, idx) => {
+            const isCurrent = step === current;
+            const isVisited = visited.includes(step);
+            return (_jsx("li", { children: _jsxs(Button, { type: "button", variant: isCurrent ? "default" : isVisited ? "outline" : "ghost", size: "sm", disabled: !isVisited && !isCurrent, onClick: () => onJumpTo(step), children: [_jsxs("span", { className: "mr-1 font-mono text-xs", children: [idx + 1, "."] }), messages.bookingJourney.steps[step]] }) }, step));
+        }) }));
+}

package/dist/journey/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@voyant-travel/bookings-react/journey` — the unified booking journey shell.
+ *
+ * Per `docs/architecture/booking-journey-architecture.md`.
+ *
+ * Single shell, slot-injected. Operator and storefront consume the
+ * same `<BookingJourney />` and inject surface-specific behavior
+ * (CRM picker, payment provider widget, B2B vs B2C defaults, post-
+ * commit handoff) via render-prop slots.
+ */
+export { BookingJourney } from "./components/booking-journey.js";
+export { type ContractAcceptance, ContractPreviewDialog, type ContractPreviewDialogProps, } from "./components/contract-preview-dialog.js";
+export { AccommodationStep, AddonsStep, BillingStep, DepartureStep, OptionsStep, PaymentStep, ReviewStep, TravelersStep, } from "./components/journey-steps.js";
+export { PriceSidePanel } from "./components/side-panel.js";
+export { StepHeader } from "./components/step-header.js";
+export { type Draft, emptyDraft, patchBilling, patchConfigure, patchPaxCount, setAccommodation, setAddons, setPayment, setTravelers, totalPax, } from "./lib/draft-state.js";
+export { type BillingExtrasContext, type BookingEntitySummary, type BookingJourneyCheckoutContext, type BookingJourneyProps, type BookingJourneyTransitionGuard, type BookingJourneyTransitionGuardContext, type BookingJourneyTransitionGuardResult, type ContractAcceptanceEvent, type DeparturePickerProps, JOURNEY_STEP_ORDER, type JourneyHeaderState, type JourneyOptionSelection, type JourneyStep, type JourneySurface, type LeadContactPickerProps, type PaymentProviderCapabilities, type PaymentProviderStepRenderProps, type SidePanelState, type TravelerContactPickerProps, type UnitsPickerProps, type VoucherPickerProps, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/journey/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/journey/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAChE,OAAO,EACL,KAAK,kBAAkB,EACvB,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAA;AAChD,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EACL,KAAK,KAAK,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,GACT,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,EACxC,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAA"}

package/dist/journey/index.js

@@ -0,0 +1,17 @@
+/**
+ * `@voyant-travel/bookings-react/journey` — the unified booking journey shell.
+ *
+ * Per `docs/architecture/booking-journey-architecture.md`.
+ *
+ * Single shell, slot-injected. Operator and storefront consume the
+ * same `<BookingJourney />` and inject surface-specific behavior
+ * (CRM picker, payment provider widget, B2B vs B2C defaults, post-
+ * commit handoff) via render-prop slots.
+ */
+export { BookingJourney } from "./components/booking-journey.js";
+export { ContractPreviewDialog, } from "./components/contract-preview-dialog.js";
+export { AccommodationStep, AddonsStep, BillingStep, DepartureStep, OptionsStep, PaymentStep, ReviewStep, TravelersStep, } from "./components/journey-steps.js";
+export { PriceSidePanel } from "./components/side-panel.js";
+export { StepHeader } from "./components/step-header.js";
+export { emptyDraft, patchBilling, patchConfigure, patchPaxCount, setAccommodation, setAddons, setPayment, setTravelers, totalPax, } from "./lib/draft-state.js";
+export { JOURNEY_STEP_ORDER, } from "./types.js";

package/dist/journey/lib/draft-state.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Local draft-state reducers + initialization helpers.
+ *
+ * The journey holds the draft as a single useState at the root and
+ * passes immutable views down to step components, which call the
+ * supplied setter to apply patches. Per
+ * booking-journey-architecture §4.
+ */
+import type { BookingDraftV1 } from "@voyant-travel/catalog-contracts/booking-engine/contracts";
+export type Draft = BookingDraftV1;
+export interface DraftEntityIdentity {
+    module: string;
+    id: string;
+    /**
+     * Source kind. Empty string on the storefront before the engine's
+     * server-side resolver fills it in; operator-side wiring sets
+     * the real kind upfront.
+     */
+    sourceKind: string;
+    sourceConnectionId?: string;
+    sourceRef?: string;
+}
+export declare function emptyDraft(entity: DraftEntityIdentity, defaults?: {
+    buyerType?: "B2C" | "B2B";
+}): Draft;
+export declare function patchConfigure(draft: Draft, patch: Partial<Draft["configure"]>): Draft;
+export declare function patchBilling(draft: Draft, patch: Partial<Draft["billing"]>): Draft;
+export declare function canCopyBillingContactToTraveler(contact: Draft["billing"]["contact"]): boolean;
+export declare function patchPaxCount(draft: Draft, band: string, count: number): Draft;
+export declare function setTravelers(draft: Draft, travelers: Draft["travelers"]): Draft;
+export declare function setAccommodation(draft: Draft, accommodation: Draft["accommodation"]): Draft;
+export declare function setAddons(draft: Draft, addons: Draft["addons"]): Draft;
+export declare function setPayment(draft: Draft, payment: Draft["payment"]): Draft;
+export declare function totalPax(draft: Draft): number;
+//# sourceMappingURL=draft-state.d.ts.map

package/dist/journey/lib/draft-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft-state.d.ts","sourceRoot":"","sources":["../../../src/journey/lib/draft-state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2DAA2D,CAAA;AAE/F,MAAM,MAAM,KAAK,GAAG,cAAc,CAAA;AAElC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,GAAE;IAAE,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;CAAO,GAC3C,KAAK,CAaP;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,KAAK,CAEtF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAElF;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,CAE7F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAK9E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG,KAAK,CAE/E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,KAAK,CAE3F;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAEtE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAEzE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAM7C"}

package/dist/journey/lib/draft-state.js

@@ -0,0 +1,57 @@
+/**
+ * Local draft-state reducers + initialization helpers.
+ *
+ * The journey holds the draft as a single useState at the root and
+ * passes immutable views down to step components, which call the
+ * supplied setter to apply patches. Per
+ * booking-journey-architecture §4.
+ */
+export function emptyDraft(entity, defaults = {}) {
+    return {
+        entity,
+        configure: { pax: {} },
+        billing: {
+            buyerType: defaults.buyerType ?? "B2C",
+            contact: { firstName: "", lastName: "", email: "" },
+            address: {},
+        },
+        travelers: [],
+        addons: [],
+        payment: { intent: "hold" },
+    };
+}
+export function patchConfigure(draft, patch) {
+    return { ...draft, configure: { ...draft.configure, ...patch } };
+}
+export function patchBilling(draft, patch) {
+    return { ...draft, billing: { ...draft.billing, ...patch } };
+}
+export function canCopyBillingContactToTraveler(contact) {
+    return Boolean(contact.firstName || contact.lastName || contact.email || contact.phone);
+}
+export function patchPaxCount(draft, band, count) {
+    const safeCount = Number.isFinite(count) && count >= 0 ? Math.floor(count) : 0;
+    return patchConfigure(draft, {
+        pax: { ...draft.configure.pax, [band]: safeCount },
+    });
+}
+export function setTravelers(draft, travelers) {
+    return { ...draft, travelers };
+}
+export function setAccommodation(draft, accommodation) {
+    return { ...draft, accommodation };
+}
+export function setAddons(draft, addons) {
+    return { ...draft, addons };
+}
+export function setPayment(draft, payment) {
+    return { ...draft, payment };
+}
+export function totalPax(draft) {
+    let total = 0;
+    for (const v of Object.values(draft.configure.pax ?? {})) {
+        if (typeof v === "number")
+            total += v;
+    }
+    return total;
+}

package/dist/journey/lib/pax-band-dependencies.d.ts

@@ -0,0 +1,27 @@
+import type { PaxBandDependency } from "@voyant-travel/catalog-contracts/booking-engine/draft-shape";
+/**
+ * A pax-band occupancy rule that the picked traveler counts violate.
+ * Carries resolved band labels + the rule kind so the UI can render a
+ * localized message without re-resolving codes.
+ */
+export interface PaxBandDependencyViolation {
+    type: PaxBandDependency["type"];
+    dependentCode: string;
+    masterCode: string;
+    dependentLabel: string;
+    masterLabel: string;
+    /** The numeric limit for `limits_per_master` / `limits_sum`. */
+    limit?: number;
+}
+/**
+ * Evaluate the product's cross-band occupancy rules against the picked
+ * pax counts. Returns one violation per broken rule (empty when valid).
+ *
+ * Rules only fire when at least one dependent is picked — an empty
+ * booking never violates "Child requires Adult".
+ */
+export declare function evaluatePaxBandDependencies(pax: Record<string, number> | undefined, dependencies: ReadonlyArray<PaxBandDependency> | undefined, bands: ReadonlyArray<{
+    code: string;
+    label: string;
+}>): PaxBandDependencyViolation[];
+//# sourceMappingURL=pax-band-dependencies.d.ts.map

package/dist/journey/lib/pax-band-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pax-band-dependencies.d.ts","sourceRoot":"","sources":["../../../src/journey/lib/pax-band-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6DAA6D,CAAA;AAEpG;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACvC,YAAY,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,SAAS,EAC1D,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,0BAA0B,EAAE,CAwC9B"}

package/dist/journey/lib/pax-band-dependencies.js

@@ -0,0 +1,50 @@
+/**
+ * Evaluate the product's cross-band occupancy rules against the picked
+ * pax counts. Returns one violation per broken rule (empty when valid).
+ *
+ * Rules only fire when at least one dependent is picked — an empty
+ * booking never violates "Child requires Adult".
+ */
+export function evaluatePaxBandDependencies(pax, dependencies, bands) {
+    if (!dependencies || dependencies.length === 0)
+        return [];
+    const counts = pax ?? {};
+    const labelByCode = new Map(bands.map((b) => [b.code, b.label]));
+    const label = (code) => labelByCode.get(code) ?? code;
+    const violations = [];
+    for (const dep of dependencies) {
+        const dependent = counts[dep.dependentCode] ?? 0;
+        const master = counts[dep.masterCode] ?? 0;
+        // No dependents picked → nothing to enforce.
+        if (dependent <= 0)
+            continue;
+        const base = {
+            type: dep.type,
+            dependentCode: dep.dependentCode,
+            masterCode: dep.masterCode,
+            dependentLabel: label(dep.dependentCode),
+            masterLabel: label(dep.masterCode),
+        };
+        switch (dep.type) {
+            case "requires":
+                if (master <= 0)
+                    violations.push(base);
+                break;
+            case "excludes":
+                if (master > 0)
+                    violations.push(base);
+                break;
+            case "limits_per_master":
+                if (dep.maxPerMaster != null && dependent > master * dep.maxPerMaster) {
+                    violations.push({ ...base, limit: dep.maxPerMaster });
+                }
+                break;
+            case "limits_sum":
+                if (dep.maxDependentSum != null && dependent > dep.maxDependentSum) {
+                    violations.push({ ...base, limit: dep.maxDependentSum });
+                }
+                break;
+        }
+    }
+    return violations;
+}

package/dist/journey/lib/payment-schedule.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Convert between the `PaymentScheduleSection` editor value
+ * (`{ mode, installments }`) and the booking draft's `paymentSchedules` rows.
+ *
+ * The row shape is derived from `Draft` so it always matches the engine
+ * contract. Paid-installment metadata (date / method / reference) is encoded
+ * as JSON in the row `notes` — the SAME format the owned create-sheet uses —
+ * so a schedule round-trips losslessly through the draft (and both flows write
+ * an identical wire shape).
+ */
+import { type PaymentScheduleValue } from "../../components/payment-schedule-section.js";
+import type { Draft } from "./draft-state.js";
+type PaymentScheduleRow = NonNullable<Draft["paymentSchedules"]>[number];
+/** Editor value → draft rows. Returns `[]` when nothing is schedulable yet. */
+export declare function paymentScheduleValueToRows(value: PaymentScheduleValue, currency: string, totalAmountCents: number | null): PaymentScheduleRow[];
+/** Draft rows → editor value (re-init on step remount; preserves paid metadata). */
+export declare function rowsToPaymentScheduleValue(rows: PaymentScheduleRow[] | undefined, departureDate: string | null): PaymentScheduleValue;
+export {};
+//# sourceMappingURL=payment-schedule.d.ts.map

package/dist/journey/lib/payment-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-schedule.d.ts","sourceRoot":"","sources":["../../../src/journey/lib/payment-schedule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,8CAA8C,CAAA;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAE7C,KAAK,kBAAkB,GAAG,WAAW,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAmBxE,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,kBAAkB,EAAE,CA8BtB;AAED,oFAAoF;AACpF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,kBAAkB,EAAE,GAAG,SAAS,EACtC,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,oBAAoB,CA8BtB"}

package/dist/journey/lib/payment-schedule.js

@@ -0,0 +1,90 @@
+/**
+ * Convert between the `PaymentScheduleSection` editor value
+ * (`{ mode, installments }`) and the booking draft's `paymentSchedules` rows.
+ *
+ * The row shape is derived from `Draft` so it always matches the engine
+ * contract. Paid-installment metadata (date / method / reference) is encoded
+ * as JSON in the row `notes` — the SAME format the owned create-sheet uses —
+ * so a schedule round-trips losslessly through the draft (and both flows write
+ * an identical wire shape).
+ */
+import { createInstallment, createPaymentScheduleValue, } from "../../components/payment-schedule-section.js";
+function paidNotes(installment) {
+    if (!installment.alreadyPaid)
+        return null;
+    return JSON.stringify({
+        alreadyPaid: true,
+        paymentDate: installment.paymentDate,
+        paymentMethod: installment.paymentMethod,
+        paymentReference: installment.paymentReference.trim() || null,
+    });
+}
+/** Editor value → draft rows. Returns `[]` when nothing is schedulable yet. */
+export function paymentScheduleValueToRows(value, currency, totalAmountCents) {
+    if (!currency)
+        return [];
+    if (value.mode === "full") {
+        const inst = value.installments[0];
+        if (!inst?.dueDate || totalAmountCents === null)
+            return [];
+        return [
+            {
+                scheduleType: "balance",
+                status: inst.alreadyPaid ? "paid" : "due",
+                dueDate: inst.dueDate,
+                currency,
+                amountCents: totalAmountCents,
+                notes: paidNotes(inst),
+            },
+        ];
+    }
+    // split — N installments; first defaults to `due`, the rest to `pending`.
+    const rows = [];
+    for (const [idx, inst] of value.installments.entries()) {
+        if (!inst.dueDate || inst.amountCents == null)
+            continue;
+        rows.push({
+            scheduleType: "installment",
+            status: inst.alreadyPaid ? "paid" : idx === 0 ? "due" : "pending",
+            dueDate: inst.dueDate,
+            currency,
+            amountCents: inst.amountCents,
+            notes: paidNotes(inst),
+        });
+    }
+    return rows;
+}
+/** Draft rows → editor value (re-init on step remount; preserves paid metadata). */
+export function rowsToPaymentScheduleValue(rows, departureDate) {
+    if (!rows || rows.length === 0)
+        return createPaymentScheduleValue(departureDate);
+    const installments = rows.map((row) => {
+        let alreadyPaid = row.status === "paid";
+        let paymentDate = null;
+        let paymentMethod = "bank_transfer";
+        let paymentReference = "";
+        if (row.notes) {
+            try {
+                const meta = JSON.parse(row.notes);
+                if (meta.alreadyPaid) {
+                    alreadyPaid = true;
+                    paymentDate = meta.paymentDate ?? null;
+                    paymentMethod = meta.paymentMethod ?? "bank_transfer";
+                    paymentReference = meta.paymentReference ?? "";
+                }
+            }
+            catch {
+                // `notes` wasn't our JSON payload (e.g. a free-text note) — ignore.
+            }
+        }
+        return createInstallment({
+            amountCents: row.amountCents,
+            dueDate: row.dueDate,
+            alreadyPaid,
+            paymentDate,
+            paymentMethod,
+            paymentReference,
+        });
+    });
+    return { mode: rows.length > 1 ? "split" : "full", installments };
+}