@voyant-travel/bookings-react 0.151.5 → 0.153.0

package/dist/storefront/storefront-booking-errors.js

@@ -0,0 +1,50 @@
+const SPACE = String.fromCharCode(32);
+const PERIOD = String.fromCharCode(46);
+const SENTENCE_SEPARATOR = PERIOD + SPACE;
+export function buildStorefrontBookFailureMessage(body, requestId, fallback, requestReferenceTemplate) {
+    const message = firstString(body.error) ?? firstFieldError(body.details);
+    const reference = firstString(body.requestId) ?? requestId;
+    const withMessage = message ? appendSentence(fallback, message) : fallback;
+    return reference
+        ? appendSentence(withMessage, requestReferenceTemplate.replace("{requestId}", reference))
+        : withMessage;
+}
+function appendSentence(base, sentence) {
+    const trimmedBase = base.trim();
+    const trimmedSentence = sentence.trim();
+    if (!trimmedSentence)
+        return trimmedBase;
+    const separator = /[.!?]$/.test(trimmedBase) ? SPACE : SENTENCE_SEPARATOR;
+    const suffix = /[.!?]$/.test(trimmedSentence) ? trimmedSentence : trimmedSentence + PERIOD;
+    return `${trimmedBase}${separator}${suffix}`;
+}
+function firstFieldError(details) {
+    const record = asObject(details);
+    const fields = asObject(record?.fields) ?? record;
+    const fieldErrors = asObject(fields?.fieldErrors);
+    if (!fieldErrors)
+        return null;
+    for (const value of Object.values(fieldErrors)) {
+        const message = firstString(value);
+        if (message)
+            return message;
+    }
+    return null;
+}
+function firstString(value) {
+    if (typeof value === "string")
+        return value.trim() || null;
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const message = firstString(item);
+            if (message)
+                return message;
+        }
+    }
+    return null;
+}
+function asObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}

package/dist/storefront/storefront-booking-journey.d.ts

@@ -0,0 +1,72 @@
+import { type BookingEntitySummary, type BookingJourneyCheckoutContext, type ContractAcceptanceEvent, type Draft } from "../journey/index.js";
+import { type ContractSourceContext } from "./resolve-contract-variables.js";
+export interface StorefrontBookingJourneyMessages {
+    checkoutFailed: string;
+    requestReference: string;
+    reserveFailed: string;
+}
+export interface StorefrontBookingJourneyScope {
+    marketId?: string;
+    locale?: string;
+    currency?: string;
+}
+export type StorefrontCheckoutConfirmationKind = "bank_transfer" | "card_pending" | "hold" | "inquiry";
+export interface StorefrontBookingJourneyProps {
+    entityModule: string;
+    entityId: string;
+    /**
+     * Source provenance — optional on the storefront. When absent,
+     * the public engine route resolves it from
+     * `(entityModule, entityId)` via the catalog plane's
+     * sourced-entry lookup. Admin surfaces still pass it explicitly
+     * via the packaged `<BookingJourneyHost />`
+     * (`@voyant-travel/bookings-react/admin/booking-journey-host`).
+     */
+    sourceKind?: string;
+    sourceConnectionId?: string;
+    sourceRef?: string;
+    draftId: string;
+    /** Pre-locked configure inputs (departure / sailing / cabin /
+     *  date-range / pax) collected on the detail page. */
+    initialConfigure: Record<string, unknown>;
+    /** Pre-locked accommodation slice (room/rate for accommodations). */
+    initialAccommodation?: Record<string, unknown>;
+    /** Optional summary of the entity being booked — surfaces in the
+     *  side panel so the customer keeps context while filling out the
+     *  journey. */
+    entitySummary?: BookingEntitySummary;
+    /**
+     * Resolved source provenance for the booked entity — kind /
+     * connection / ref + supplier. The `/book` route reads it off the
+     * public content endpoint's `provenance` and passes it here so the
+     * contract preview's `booking.source` block reflects sourced
+     * inventory instead of defaulting to owned/blank (voyant#2619).
+     */
+    entitySource?: ContractSourceContext;
+    /**
+     * Per-product override for the contract template. When unset (the
+     * default), the storefront resolves the active customer-scope
+     * template via /v1/public/legal/contracts/templates/default —
+     * whichever one the operator has marked as the customer default
+     * in the legal admin. Set this when a specific product/cruise/
+     * hotel needs a non-default contract.
+     */
+    contractTemplateSlug?: string;
+    /** Optional marketing-opt-in label — when set, an extra checkbox
+     *  is rendered in the contract dialog. */
+    contractMarketingLabel?: string;
+    /** Fired after the user accepts the contract (or, when no
+     *  template is configured, when they click Confirm on Review).
+     *  The route handles the actual checkout-start dispatch + redirect
+     *  to Netopia / bank-transfer instructions. */
+    onContractAccepted?: (acceptance: ContractAcceptanceEvent | null, context: BookingJourneyCheckoutContext) => void | Promise<void>;
+    messages?: StorefrontBookingJourneyMessages;
+    scope?: StorefrontBookingJourneyScope;
+    onNavigateToShop: () => void;
+    onNavigateToConfirmation: (bookingId: string, kind?: StorefrontCheckoutConfirmationKind) => void;
+    onRedirectToPayment?: (url: string) => void;
+    className?: string;
+}
+export declare function StorefrontBookingJourney({ entityModule, entityId, sourceKind, sourceConnectionId, sourceRef, draftId, initialConfigure, initialAccommodation, entitySummary, entitySource, contractTemplateSlug, contractMarketingLabel, onContractAccepted, messages, scope, onNavigateToShop, onNavigateToConfirmation, onRedirectToPayment, className, }: StorefrontBookingJourneyProps): React.ReactElement;
+export declare function buildStorefrontCommitParty(draft: Draft): Record<string, unknown>;
+//# sourceMappingURL=storefront-booking-journey.d.ts.map

package/dist/storefront/storefront-booking-journey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-booking-journey.d.ts","sourceRoot":"","sources":["../../src/storefront/storefront-booking-journey.tsx"],"names":[],"mappings":"AAuBA,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,6BAA6B,EAElC,KAAK,uBAAuB,EAC5B,KAAK,KAAK,EACX,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,iCAAiC,CAAA;AAmBxC,MAAM,WAAW,gCAAgC;IAC/C,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,MAAM,kCAAkC,GAC1C,eAAe,GACf,cAAc,GACd,MAAM,GACN,SAAS,CAAA;AAQb,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf;0DACsD;IACtD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9C;;mBAEe;IACf,aAAa,CAAC,EAAE,oBAAoB,CAAA;IACpC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B;8CAC0C;IAC1C,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B;;;mDAG+C;IAC/C,kBAAkB,CAAC,EAAE,CACnB,UAAU,EAAE,uBAAuB,GAAG,IAAI,EAC1C,OAAO,EAAE,6BAA6B,KACnC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,QAAQ,CAAC,EAAE,gCAAgC,CAAA;IAC3C,KAAK,CAAC,EAAE,6BAA6B,CAAA;IACrC,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAC5B,wBAAwB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kCAAkC,KAAK,IAAI,CAAA;IAChG,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,wBAAwB,CAAC,EACvC,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,QAA0B,EAC1B,KAAU,EACV,gBAAgB,EAChB,wBAAwB,EACxB,mBAA0D,EAC1D,SAAS,GACV,EAAE,6BAA6B,GAAG,KAAK,CAAC,YAAY,CAkRpD;AASD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgChF"}

package/dist/storefront/storefront-booking-journey.js

@@ -0,0 +1,380 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Storefront-flavored wrapper around `<BookingJourney />` —
+ * customer-facing, no CRM picker, B2C billing default, post-commit
+ * navigation to a confirmation page.
+ *
+ * Uses `surface="public"` so the engine hits `/v1/public/catalog/*`.
+ * Per booking-journey-architecture §8.1 + §10 Phase B.
+ *
+ * Package-owned so Node starters and dedicated storefronts share the same
+ * checkout behavior while route trees remain application-owned.
+ */
+import { useQuery } from "@tanstack/react-query";
+import { computePaymentSchedule, noDepositPolicy, } from "@voyant-travel/finance/payment-policy";
+import { useVoyantReactContext } from "@voyant-travel/react";
+import { BookingJourney, } from "../journey/index.js";
+import { resolveContractVariables, } from "./resolve-contract-variables.js";
+import { buildStorefrontBookFailureMessage, } from "./storefront-booking-errors.js";
+/**
+ * Marker for checkout failures we've already turned into a localized,
+ * customer-facing message. Native errors (a `fetch` network drop, a
+ * `Response.json()` parse of an HTML 502) are NOT this type, so the outer catch
+ * can wrap them in the generic message instead of showing raw browser/parser
+ * text to the shopper (voyant#2638).
+ */
+class CheckoutError extends Error {
+}
+const defaultMessages = {
+    checkoutFailed: "We couldn't complete your booking. Please review your selection or try again.",
+    requestReference: "Reference: {requestId}",
+    reserveFailed: "This selection is no longer available. Adjust it and try again.",
+};
+export function StorefrontBookingJourney({ entityModule, entityId, sourceKind, sourceConnectionId, sourceRef, draftId, initialConfigure, initialAccommodation, entitySummary, entitySource, contractTemplateSlug, contractMarketingLabel, onContractAccepted, messages = defaultMessages, scope = {}, onNavigateToShop, onNavigateToConfirmation, onRedirectToPayment = (url) => window.location.assign(url), className, }) {
+    const { baseUrl, fetcher } = useVoyantReactContext();
+    // Carry the shopper's selected market/currency/locale (voyant#2643) into the
+    // journey's live quote so checkout prices in the same scope as browse/detail,
+    // not the default. The `(storefront)` layout provides the scope; unselected
+    // fields stay undefined and the quote falls back to the surface default.
+    // Resolve the contract template the journey will preview. The
+    // per-product override wins when set; otherwise we fetch
+    // whatever the operator marked as the active customer-scope
+    // template in `legal/contract_templates`. A 404 means no template
+    // has been seeded — the journey skips the preview dialog and
+    // commits without a contract.
+    const resolvedSlug = useResolvedContractSlug(contractTemplateSlug, baseUrl, fetcher);
+    const operatorProfile = usePublicOperatorProfile(baseUrl, fetcher);
+    const resolvedPolicy = useResolvedPaymentPolicy(entityModule, entityId, baseUrl, fetcher);
+    // Storefront-specific slot wiring. NO CRM picker — customers fill
+    // an inline contact form, which is the BookingJourney's default
+    // when `renderLeadContactPicker` is absent. Operators who later
+    // sign in could swap to the CRM picker mid-journey via an
+    // upgrade-path hook (Phase E follow-up).
+    const slots = {
+        onCommitted(result) {
+            onNavigateToConfirmation(result.bookingId);
+        },
+        onCancelled() {
+            onNavigateToShop();
+        },
+    };
+    // Default checkout-start handler — when the caller doesn't supply
+    // its own `onContractAccepted`, we run the standard storefront
+    // checkout flow:
+    //
+    //   1. POST /v1/public/catalog/book with the draft id → bookingId
+    //   2. POST /v1/public/catalog/checkout/start with the bookingId,
+    //      the payment intent, and the captured acceptance.
+    //   3. Route the customer based on the response: card → 302 to
+    //      Netopia; bank_transfer → instructions page; inquiry →
+    //      thanks page.
+    //
+    const defaultCheckoutHandler = async (acceptance, context) => {
+        try {
+            const intent = checkoutIntentFromDraft(context.draft.payment.intent);
+            const contact = context.draft.billing?.contact;
+            const payerName = [contact?.firstName, contact?.lastName].filter(Boolean).join(" ").trim();
+            const idempotencyKey = `bj-${draftId}-${acceptance?.acceptedAt ?? "noaccept"}`;
+            // Step 1 — book the entity. Send the live scoped quote id explicitly
+            // (the server prefers `quoteId` over resolving the draft's stored
+            // `currentQuoteId`), so a market/currency change made mid-journey books
+            // the price the shopper is actually looking at rather than a stale one
+            // (voyant#2643). Falls back to draft resolution when no live quote yet.
+            const bookRes = await fetcher(apiPath(baseUrl, "/v1/public/catalog/book"), {
+                method: "POST",
+                credentials: "include",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({
+                    draftId,
+                    quoteId: context.quoteId,
+                    party: buildStorefrontCommitParty(context.draft),
+                    paymentIntent: { type: "hold" },
+                    idempotencyKey,
+                }),
+            });
+            if (!bookRes.ok) {
+                const errBody = (await bookRes.json().catch(() => ({})));
+                console.error("[storefront] /book failed", errBody);
+                // Reserve failures (e.g. 502 RESERVE_FAILED with reason
+                // "rates_missing") must reach the customer — throw so the journey
+                // surfaces a visible error instead of silently dropping back to
+                // Review (voyant#2638). A missing-rate / availability reason gets the
+                // "adjust your selection" copy; everything else the generic message.
+                // The engine error serializer nests the upstream payload under
+                // `context.upstreamPayload` (ReserveFailedError), not at top level.
+                const reason = typeof errBody.context?.upstreamPayload?.reason === "string"
+                    ? errBody.context.upstreamPayload.reason
+                    : undefined;
+                throw new CheckoutError(reason === "rates_missing"
+                    ? messages.reserveFailed
+                    : buildStorefrontBookFailureMessage(errBody, bookRes.headers.get("x-request-id"), messages.checkoutFailed, messages.requestReference));
+            }
+            const bookJson = (await bookRes.json());
+            const bookingId = bookJson.bookingId;
+            if (!bookingId) {
+                console.error("[storefront] /book returned no bookingId", bookJson);
+                throw new CheckoutError(messages.checkoutFailed);
+            }
+            // Step 2 — start checkout with the payment method selected in
+            // the journey's Payment step. Card goes to the PSP; bank
+            // transfer returns IBAN/reference instructions; inquiry skips
+            // inventory/payment.
+            const startRes = await fetcher(apiPath(baseUrl, "/v1/public/catalog/checkout/start"), {
+                method: "POST",
+                credentials: "include",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({
+                    bookingId,
+                    paymentIntent: intent,
+                    ...(acceptance
+                        ? {
+                            contractAcceptance: {
+                                templateId: acceptance.templateId,
+                                templateSlug: acceptance.templateSlug,
+                                acceptedTerms: true,
+                                acceptedMarketing: acceptance.acceptedMarketing,
+                                acceptedAt: acceptance.acceptedAt,
+                                renderedHtml: acceptance.renderedHtml,
+                            },
+                        }
+                        : {}),
+                    ...(contact?.email ? { payerEmail: contact.email } : {}),
+                    ...(payerName ? { payerName } : {}),
+                    returnOrigin: window.location.origin,
+                }),
+            });
+            const json = (await startRes.json());
+            if ("error" in json) {
+                console.error("[storefront] /checkout/start error", json);
+                throw new CheckoutError(messages.checkoutFailed);
+            }
+            switch (json.kind) {
+                case "card_redirect":
+                    if (json.redirectUrl) {
+                        onRedirectToPayment(json.redirectUrl);
+                    }
+                    else {
+                        onNavigateToConfirmation(json.bookingId, "card_pending");
+                    }
+                    break;
+                case "bank_transfer_instructions":
+                    // Hand the instructions to the confirmation page so the
+                    // customer leaves with the IBAN + reference visible. Stored
+                    // in sessionStorage to keep the URL clean — refreshing the
+                    // page replays the same instructions.
+                    if (typeof sessionStorage !== "undefined") {
+                        sessionStorage.setItem(`voyant.checkout.${json.bookingId}`, JSON.stringify(json));
+                    }
+                    onNavigateToConfirmation(json.bookingId, "bank_transfer");
+                    break;
+                case "inquiry_received":
+                    onNavigateToConfirmation(json.bookingId, "inquiry");
+                    break;
+                case "hold_placed":
+                    onNavigateToConfirmation(json.bookingId, "hold");
+                    break;
+            }
+        }
+        catch (err) {
+            console.error("[storefront] checkout flow failed", err);
+            // Re-throw so <BookingJourney /> can render a visible checkout error
+            // (voyant#2638). Preserve our own localized CheckoutError messages; wrap
+            // anything else (native fetch/network error, JSON parse of an HTML 502)
+            // in the generic message so raw browser/parser text never reaches the UI.
+            throw err instanceof CheckoutError ? err : new Error(messages.checkoutFailed);
+        }
+    };
+    return (_jsx(BookingJourney, { surface: "public", scope: { market: scope.marketId, locale: scope.locale, currency: scope.currency }, entityModule: entityModule, entityId: entityId, sourceKind: sourceKind, sourceConnectionId: sourceConnectionId, sourceRef: sourceRef, draftId: draftId, defaultBuyerType: "B2C", hideConfigure: true, initialConfigure: initialConfigure, initialAccommodation: initialAccommodation, entitySummary: entitySummary, contract: resolvedSlug
+            ? {
+                templateSlug: resolvedSlug,
+                previewUrl: apiPath(baseUrl, `/v1/public/legal/contracts/templates/by-slug/${encodeURIComponent(resolvedSlug)}/preview`),
+                acceptLanguage: typeof navigator !== "undefined" ? navigator.language : undefined,
+                resolveVariables: ({ draft, pricing }) => {
+                    // Use the server-resolved cascade when the public
+                    // /v1/public/payment-policy/resolve endpoint has
+                    // come back; while the request is in flight, fall
+                    // back to the operator default so the customer sees
+                    // a sensible preview rather than an empty schedule.
+                    const policy = resolvedPolicy?.policy ??
+                        operatorProfile?.customerPaymentPolicy ??
+                        noDepositPolicy;
+                    const source = resolvedPolicy?.source ?? "operator_default";
+                    const schedule = pricing
+                        ? computePaymentSchedule({
+                            totalCents: pricing.total,
+                            currency: pricing.currency,
+                            departureDate: entitySummary?.startDate ?? null,
+                        }, policy)
+                        : [];
+                    return resolveContractVariables(draft, {
+                        entityModule,
+                        entityId,
+                        entitySummary,
+                        pricing,
+                        operatorInfo: operatorProfile,
+                        paymentSchedule: schedule,
+                        paymentPolicySource: source,
+                        source: entitySource,
+                    });
+                },
+                ...(contractMarketingLabel ? { marketingLabel: contractMarketingLabel } : {}),
+            }
+            : undefined, onContractAccepted: onContractAccepted ?? defaultCheckoutHandler, paymentCapabilities: {
+            // Storefront defaults — covers the three customer-facing
+            // payment paths a typical tour operator wants. The deployment
+            // can override per-product (e.g. high-ticket cruises that
+            // should always go through inquiry first).
+            //
+            //  - acceptsCard: real-time card via the configured PSP
+            //    (renderPaymentProviderStep supplies the widget — when
+            //    absent we fall back to a "we'll email a link" message).
+            //  - acceptsBankTransfer: lock inventory, send bank details
+            //    out of band, reconcile on receipt of funds.
+            //  - acceptsInquiry: lead-only path. No inventory hold, no
+            //    charge — operator follows up manually. Useful for
+            //    custom itineraries / availability-on-request products.
+            acceptsCard: true,
+            acceptsBankTransfer: true,
+            acceptsHold: false,
+            acceptsTicketOnCredit: false,
+            acceptsInquiry: true,
+        }, className: className, ...slots }));
+}
+function checkoutIntentFromDraft(intent) {
+    if (intent === "card" || intent === "bank_transfer" || intent === "inquiry")
+        return intent;
+    return "hold";
+}
+export function buildStorefrontCommitParty(draft) {
+    const contact = draft.billing.contact;
+    const personId = draft.billing.buyerType === "B2C" ? contact.personId : undefined;
+    const organizationId = draft.billing.buyerType === "B2B" ? draft.billing.organizationId : undefined;
+    return {
+        personId,
+        organizationId,
+        billing: {
+            personId,
+            organizationId,
+            contact: {
+                firstName: contact.firstName,
+                lastName: contact.lastName,
+                email: contact.email,
+                phone: contact.phone,
+            },
+        },
+        travelerParty: {
+            travelers: draft.travelers.map((traveler) => ({
+                personId: traveler.personId,
+                firstName: traveler.firstName,
+                lastName: traveler.lastName,
+                email: traveler.email,
+                phone: traveler.phone,
+                dateOfBirth: traveler.dateOfBirth,
+                band: traveler.band,
+                documents: traveler.documents,
+                isPrimary: traveler.isPrimary,
+            })),
+        },
+    };
+}
+/**
+ * Resolve which contract template to preview at the Review step.
+ *
+ * Order:
+ *   1. The per-product `contractTemplateSlug` override the caller
+ *      passed in (skips the network call).
+ *   2. The active customer-scope template returned by
+ *      `GET /v1/public/legal/contracts/templates/default?scope=customer`.
+ *
+ * Returns `undefined` while the request is in flight or when the
+ * deployment hasn't seeded a customer template — the journey then
+ * skips the dialog and routes Confirm straight to the
+ * checkout-start handler.
+ */
+function useResolvedContractSlug(override, baseUrl, fetcher) {
+    const language = typeof navigator !== "undefined" ? navigator.language?.split("-")[0] : undefined;
+    const { data } = useQuery({
+        queryKey: ["public-legal-default-template", "customer", language ?? "en"],
+        queryFn: async () => {
+            const params = new URLSearchParams({ scope: "customer" });
+            if (language)
+                params.set("language", language);
+            const res = await fetcher(apiPath(baseUrl, `/v1/public/legal/contracts/templates/default?${params.toString()}`), { credentials: "include" });
+            if (!res.ok)
+                return null;
+            const json = (await res.json());
+            return json.data?.slug ?? null;
+        },
+        enabled: !override,
+        staleTime: 5 * 60 * 1000,
+    });
+    if (override)
+        return override;
+    return data ?? undefined;
+}
+/**
+ * Fetch the operator profile (name / legal name / address / license /
+ * default customer payment policy) from the public settings endpoint.
+ * The result is cached for 5 minutes — operator
+ * details rarely change, and stale-while-revalidate is fine for the
+ * contract preview UI.
+ *
+ * Returns `undefined` while the request is in flight or when the
+ * operator hasn't filled in Settings -> Operator profile yet — the contract
+ * preview then renders the operator block with `-` placeholders (the
+ * template renderer's missing-value substitution kicks in).
+ */
+function usePublicOperatorProfile(baseUrl, fetcher) {
+    const { data } = useQuery({
+        queryKey: ["public-operator-profile"],
+        queryFn: async () => {
+            const res = await fetcher(apiPath(baseUrl, "/v1/public/operator-profile"), {
+                credentials: "include",
+            });
+            if (!res.ok)
+                return null;
+            const json = (await res.json());
+            return json.data ?? null;
+        },
+        staleTime: 5 * 60 * 1000,
+    });
+    return data ?? undefined;
+}
+/**
+ * Server-side cascade resolution for the storefront preview.
+ *
+ * Calls `POST /v1/public/payment-policy/resolve` with the entity
+ * coordinates and returns the resolved policy + which cascade layer
+ * supplied it (operator_default | supplier | category | listing).
+ *
+ * Resolves at entity granularity only — the journey's later
+ * sailing / cabin / rate-plan selections refine the cascade
+ * server-side at booking-confirmed time. Storefront preview shows
+ * the entity-level result, which is correct for the common case
+ * (single sailing per cruise, single rate plan picked at booking
+ * time, etc.) and gracefully degrades to a less-specific layer when
+ * the journey hasn't picked yet.
+ */
+function useResolvedPaymentPolicy(entityModule, entityId, baseUrl, fetcher) {
+    const { data } = useQuery({
+        queryKey: ["public-payment-policy", entityModule, entityId],
+        queryFn: async () => {
+            const res = await fetcher(apiPath(baseUrl, "/v1/public/payment-policy/resolve"), {
+                method: "POST",
+                credentials: "include",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ entityModule, entityId }),
+            });
+            if (!res.ok)
+                return null;
+            const json = (await res.json());
+            return json.data ?? null;
+        },
+        staleTime: 5 * 60 * 1000,
+    });
+    return data ?? undefined;
+}
+function apiPath(baseUrl, path) {
+    return `${baseUrl.replace(/\/$/, "")}${path}`;
+}

package/dist/storefront/storefront-booking-page.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { type StorefrontBookingJourneyMessages, type StorefrontBookingJourneyProps } from "./storefront-booking-journey.js";
+export declare const storefrontBookingSearchSchema: z.ZodObject<{
+    departureSlotId: z.ZodOptional<z.ZodString>;
+    cabinCategoryId: z.ZodOptional<z.ZodString>;
+    cabinNumberId: z.ZodOptional<z.ZodString>;
+    airArrangement: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        cruise_line: "cruise_line";
+        independent: "independent";
+    }>>;
+    checkIn: z.ZodOptional<z.ZodString>;
+    checkOut: z.ZodOptional<z.ZodString>;
+    roomTypeId: z.ZodOptional<z.ZodString>;
+    ratePlanId: z.ZodOptional<z.ZodString>;
+    board: z.ZodOptional<z.ZodString>;
+    adult: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    child: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    infant: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    draftId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontBookingSearch = z.infer<typeof storefrontBookingSearchSchema>;
+export interface StorefrontBookingPageMessages extends StorefrontBookingJourneyMessages {
+    marketingLabel?: string;
+}
+export type StorefrontBookingPageExtensions = Pick<StorefrontBookingJourneyProps, "className" | "contractMarketingLabel" | "contractTemplateSlug" | "onContractAccepted" | "onRedirectToPayment">;
+export interface StorefrontBookingPageProps {
+    entityModule: string;
+    entityId: string;
+    search: StorefrontBookingSearch;
+    messages: StorefrontBookingPageMessages;
+    extensions?: StorefrontBookingPageExtensions;
+}
+/** Customer booking page shared by Node applications and dedicated storefronts. */
+export declare function StorefrontBookingPage({ entityModule, entityId, search, messages, extensions, }: StorefrontBookingPageProps): React.ReactElement;
+//# sourceMappingURL=storefront-booking-page.d.ts.map

package/dist/storefront/storefront-booking-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-booking-page.d.ts","sourceRoot":"","sources":["../../src/storefront/storefront-booking-page.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAEL,KAAK,gCAAgC,EACrC,KAAK,6BAA6B,EACnC,MAAM,iCAAiC,CAAA;AAExC,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;iBAcxC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF,MAAM,WAAW,6BAA8B,SAAQ,gCAAgC;IACrF,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAChD,6BAA6B,EAC3B,WAAW,GACX,wBAAwB,GACxB,sBAAsB,GACtB,oBAAoB,GACpB,qBAAqB,CACxB,CAAA;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,uBAAuB,CAAA;IAC/B,QAAQ,EAAE,6BAA6B,CAAA;IACvC,UAAU,CAAC,EAAE,+BAA+B,CAAA;CAC7C;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,EACpC,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,UAAU,GACX,EAAE,0BAA0B,GAAG,KAAK,CAAC,YAAY,CAgCjD"}