@voyant-travel/bookings-react 0.151.5 → 0.152.0

package/dist/storefront/resolve-contract-variables.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Default mapping from a `BookingDraftV1` (+ live quote pricing +
+ * resolved entity summary + operator / acceptance context) to the
+ * variable bag the operator's contract templates render against.
+ *
+ * The variable surface is designed around Voyant's domain model:
+ *
+ *   - sell vs cost money split (`sellAmountCents`, `sellCurrency`,
+ *     `costAmountCents`, `costCurrency`, `baseCurrency`)
+ *   - vertical-aware schedule blocks — `departureSlot` for products,
+ *     `sailing` for cruises, `stay` for accommodations
+ *   - pax-bands as a record (Voyant doesn't lock you into adult /
+ *     child / infant — descriptors can declare any band code)
+ *   - sourced vs owned booking arms (`booking.source.kind`,
+ *     `booking.source.supplier`)
+ *   - CRM customer + lead traveler split, kept distinct because the
+ *     buyer + the lead passenger are often different people
+ *
+ * Naming is camelCase by default. A handful of snake_case aliases
+ * are emitted for keys the seeded `customer-sales-agreement`
+ * template references (`contract.date`, `booking.startDate`,
+ * `travelers[].participantType` …) so authored templates render
+ * out-of-the-box.
+ *
+ * Notes on what is + isn't filled at preview time:
+ *
+ *   - The booking row has not been created yet — `booking.bookingId`,
+ *     `booking.bookingNumber`, the persisted status, and
+ *     `contract.contractNumber` / `contract.signedAt` are empty. The
+ *     server-side auto-generate-contract subscriber re-renders the
+ *     same template on `booking.confirmed` with the persisted values
+ *     filled in.
+ *   - `acceptance.ipAddress` / `userAgent` are captured server-side
+ *     at `/checkout/start` from request headers. Empty during preview.
+ *   - `operator.*` reads from the `operatorInfo` block injected by the
+ *     storefront wrapper (fetched from `/v1/public/operator-profile`).
+ *     Anything not configured renders as the empty string.
+ *   - Vertical-specific blocks (`sailing`, `stay`, `departureSlot`)
+ *     are populated only when `entitySummary` carries enough context.
+ */
+import type { BookingDraftV1, PricingBreakdownV1 } from "@voyant-travel/catalog/booking-engine";
+import type { ComputedScheduleEntry, PaymentPolicySource } from "@voyant-travel/finance/payment-policy";
+import type { BookingEntitySummary } from "../journey/index.js";
+export interface OperatorInfoVariables {
+    /** Trading name shown to customers. */
+    name?: string;
+    /** Legal company name when different from `name`. */
+    legalName?: string;
+    /** Tax / VAT id. */
+    vatId?: string;
+    /** Trade register number (RO: J-number; UK: company number; …). */
+    registrationNumber?: string;
+    /** Postal address — single string or markdown for the contract block. */
+    address?: string;
+    phone?: string;
+    email?: string;
+    website?: string;
+    iban?: string;
+    bank?: string;
+    /** License number — tour-operator license, hotel rating registry,
+     *  cruise flag-state number, depending on what the operator is. */
+    license?: string;
+    /** Issuing authority for the license. */
+    licenseAuthority?: string;
+    /** Human whose name appears on the operator-side signature line. */
+    signatoryName?: string;
+    /** Their role / title (e.g. "Managing Director"). */
+    signatoryRole?: string;
+}
+interface AcceptanceContextVariables {
+    ipAddress?: string;
+    userAgent?: string;
+    acceptedAt?: string;
+    marketingConsent?: boolean;
+    templateSlug?: string;
+    templateId?: string;
+}
+/**
+ * Source provenance for the booked entity, resolved from the catalog
+ * plane (the public content endpoint returns it as `provenance` +
+ * `product.supplier`). Threaded into the contract preview so the
+ * `booking.source` block reflects the real sourced/owned arm instead
+ * of defaulting to `owned` with a blank supplier (voyant#2619).
+ *
+ * When absent (or `kind` is empty / `"owned"`), the contract renders
+ * the owned arm — blank connection/ref/supplier — exactly as before.
+ */
+export interface ContractSourceContext {
+    /** Provenance kind — `"owned"` for owned inventory, otherwise the
+     *  upstream source kind (e.g. `marketplace:demo`). */
+    kind?: string;
+    /** Source connection that produced the row (sourced only). */
+    connectionId?: string;
+    /** Stable upstream object id (sourced only). */
+    ref?: string;
+    /** Supplier disclosed to the customer in the contract. */
+    supplier?: {
+        id?: string;
+        name?: string;
+    };
+}
+export interface ResolveContractVariablesContext {
+    entityModule: string;
+    entityId: string;
+    entitySummary?: BookingEntitySummary;
+    pricing?: PricingBreakdownV1 | null;
+    /** Operator profile — fetched from `/v1/public/operator-profile` by
+     *  the storefront wrapper. Anything missing renders as empty. */
+    operatorInfo?: OperatorInfoVariables;
+    /** Acceptance fingerprint — populated only on server-side renders
+     *  (post-confirm contract auto-generation). At preview time the
+     *  storefront leaves this undefined and the variables render
+     *  empty. */
+    acceptance?: AcceptanceContextVariables;
+    /** Pre-computed schedule from `computePaymentSchedule()`. The
+     *  storefront wrapper computes this in real time as the customer
+     *  picks their date so the contract preview shows live deposit
+     *  / balance numbers. */
+    paymentSchedule?: ComputedScheduleEntry[] | null;
+    /** Which layer of the cascade the active policy came from. Used
+     *  for traceability in contract templates. */
+    paymentPolicySource?: PaymentPolicySource;
+    /** Resolved source provenance for the booked entity. Populated by
+     *  the storefront wrapper from the public content endpoint's
+     *  `provenance` + supplier. When omitted the booking renders as the
+     *  owned arm (voyant#2619). */
+    source?: ContractSourceContext;
+}
+export declare function resolveContractVariables(draft: BookingDraftV1, ctx: ResolveContractVariablesContext): Record<string, unknown>;
+export {};
+//# sourceMappingURL=resolve-contract-variables.d.ts.map

package/dist/storefront/resolve-contract-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-contract-variables.d.ts","sourceRoot":"","sources":["../../src/storefront/resolve-contract-variables.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC/F,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,uCAAuC,CAAA;AAE9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE/D,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;uEACmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,0BAA0B;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC;0DACsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,QAAQ,CAAC,EAAE;QACT,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,MAAM,WAAW,+BAA+B;IAC9C,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,oBAAoB,CAAA;IACpC,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;IACnC;qEACiE;IACjE,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC;;;iBAGa;IACb,UAAU,CAAC,EAAE,0BAA0B,CAAA;IACvC;;;6BAGyB;IACzB,eAAe,CAAC,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAA;IAChD;kDAC8C;IAC9C,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;IACzC;;;mCAG+B;IAC/B,MAAM,CAAC,EAAE,qBAAqB,CAAA;CAC/B;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,+BAA+B,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqVzB"}

package/dist/storefront/resolve-contract-variables.js

@@ -0,0 +1,492 @@
+// agent-quality: file-size exception -- owner: bookings-react; contract variables stay centralized and behavior-tested.
+/**
+ * Default mapping from a `BookingDraftV1` (+ live quote pricing +
+ * resolved entity summary + operator / acceptance context) to the
+ * variable bag the operator's contract templates render against.
+ *
+ * The variable surface is designed around Voyant's domain model:
+ *
+ *   - sell vs cost money split (`sellAmountCents`, `sellCurrency`,
+ *     `costAmountCents`, `costCurrency`, `baseCurrency`)
+ *   - vertical-aware schedule blocks — `departureSlot` for products,
+ *     `sailing` for cruises, `stay` for accommodations
+ *   - pax-bands as a record (Voyant doesn't lock you into adult /
+ *     child / infant — descriptors can declare any band code)
+ *   - sourced vs owned booking arms (`booking.source.kind`,
+ *     `booking.source.supplier`)
+ *   - CRM customer + lead traveler split, kept distinct because the
+ *     buyer + the lead passenger are often different people
+ *
+ * Naming is camelCase by default. A handful of snake_case aliases
+ * are emitted for keys the seeded `customer-sales-agreement`
+ * template references (`contract.date`, `booking.startDate`,
+ * `travelers[].participantType` …) so authored templates render
+ * out-of-the-box.
+ *
+ * Notes on what is + isn't filled at preview time:
+ *
+ *   - The booking row has not been created yet — `booking.bookingId`,
+ *     `booking.bookingNumber`, the persisted status, and
+ *     `contract.contractNumber` / `contract.signedAt` are empty. The
+ *     server-side auto-generate-contract subscriber re-renders the
+ *     same template on `booking.confirmed` with the persisted values
+ *     filled in.
+ *   - `acceptance.ipAddress` / `userAgent` are captured server-side
+ *     at `/checkout/start` from request headers. Empty during preview.
+ *   - `operator.*` reads from the `operatorInfo` block injected by the
+ *     storefront wrapper (fetched from `/v1/public/operator-profile`).
+ *     Anything not configured renders as the empty string.
+ *   - Vertical-specific blocks (`sailing`, `stay`, `departureSlot`)
+ *     are populated only when `entitySummary` carries enough context.
+ */
+export function resolveContractVariables(draft, ctx) {
+    const billing = draft.billing;
+    const contact = billing.contact;
+    const address = billing.address;
+    const summary = ctx.entitySummary;
+    const pricing = ctx.pricing ?? null;
+    const operatorInfo = ctx.operatorInfo ?? {};
+    const acceptance = ctx.acceptance ?? {};
+    const travelers = draft.travelers.map((t, i) => {
+        const fullName = [t.firstName, t.lastName].filter(Boolean).join(" ").trim();
+        const docs = t.documents ?? {};
+        return {
+            index: i + 1,
+            band: t.band,
+            // The seeded template branches on `participantType != "traveler"`.
+            // We map adult → traveler, everything else passes through.
+            participantType: t.band === "adult" ? "traveler" : t.band,
+            isLead: i === 0,
+            firstName: t.firstName,
+            lastName: t.lastName,
+            fullName,
+            email: t.email ?? "",
+            phone: t.phone ?? "",
+            dateOfBirth: t.dateOfBirth ?? "",
+            document: {
+                type: stringFromDoc(docs, "documentType"),
+                number: stringFromDoc(docs, "documentNumber"),
+                country: stringFromDoc(docs, "documentCountry"),
+                issuingAuthority: stringFromDoc(docs, "issuingAuthority"),
+                issueDate: stringFromDoc(docs, "issueDate"),
+                expiryDate: stringFromDoc(docs, "documentExpiry"),
+            },
+        };
+    });
+    const paxBands = draft.configure?.pax ?? {};
+    const paxTotal = Object.values(paxBands).reduce((acc, count) => acc + (count ?? 0), 0);
+    // Prefer raw ISO from entitySummary (set by the detail page from
+    // departures[].starts_at / sailings[].start_date / search.checkIn)
+    // over the slot id we keep in the draft.
+    const startDate = summary?.startDate ??
+        draft.configure?.dateRange?.checkIn ??
+        draft.configure?.departureDate ??
+        "";
+    const endDate = summary?.endDate ?? draft.configure?.dateRange?.checkOut ?? draft.configure?.departureDate ?? "";
+    const durationNights = computeNights(startDate, endDate);
+    const customerFullName = [contact.firstName, contact.lastName].filter(Boolean).join(" ").trim();
+    const leadTraveler = contact.firstName || contact.lastName
+        ? {
+            firstName: contact.firstName,
+            lastName: contact.lastName,
+            fullName: customerFullName,
+            email: contact.email ?? "",
+            phone: contact.phone ?? "",
+        }
+        : null;
+    // Quote line items map to the contract's `items[]` collection.
+    const items = (pricing?.lines ?? []).map((line, idx) => ({
+        index: idx + 1,
+        kind: line.kind,
+        description: line.label ?? line.kind ?? "",
+        quantity: line.quantity ?? 1,
+        unitAmountCents: line.unitAmount,
+        totalAmountCents: line.totalAmount,
+        taxIncluded: line.taxIncluded ?? false,
+        currency: pricing?.currency ?? "",
+    }));
+    const addons = items.filter((i) => i.kind === "addon" || i.kind === "supplement");
+    const totalCents = pricing?.total ?? 0;
+    const subtotalCents = pricing?.subtotal ?? 0;
+    const taxTotalCents = pricing?.taxTotal ?? 0;
+    const sellCurrency = pricing?.currency ?? "";
+    const accommodationRooms = (draft.accommodation?.rooms ?? []).map((r) => ({
+        optionUnitId: r.optionUnitId,
+        quantity: r.quantity,
+        ratePlanId: r.ratePlanId ?? "",
+    }));
+    const vertical = summary?.vertical ?? ctx.entityModule;
+    const vehiclesAndStay = buildVerticalBlocks({
+        vertical,
+        summary,
+        draft,
+        accommodationRooms,
+        durationNights,
+        startDate,
+        endDate,
+    });
+    const today = new Date();
+    const todayIso = today.toISOString().slice(0, 10);
+    const todayIsoDateTime = today.toISOString();
+    const todayTime = today.toISOString().slice(11, 19);
+    // Map the precomputed schedule into the deposit / balance / full
+    // shapes contract templates read. `"full"` collapses to the
+    // balance-row slot (it's the single payment due in that scenario).
+    const schedule = ctx.paymentSchedule ?? [];
+    const depositRow = schedule.find((r) => r.scheduleType === "deposit");
+    const balanceRow = schedule.find((r) => r.scheduleType === "balance") ??
+        schedule.find((r) => r.scheduleType === "full");
+    return {
+        // ───────── Top-level clocks ─────────
+        today: todayIso,
+        currentDate: todayIso,
+        currentDateTime: todayIsoDateTime,
+        currentTime: todayTime,
+        // ───────── Contract metadata ─────────
+        contract: {
+            contractNumber: "",
+            number: "",
+            contractDate: todayIso,
+            // snake-cased alias used by the seeded customer-sales-agreement
+            // template (`{{ contract.date | format_date: "long" }}`)
+            date: todayIso,
+            signedAt: acceptance.acceptedAt ?? "",
+            isManual: false,
+            series: "",
+            channel: "storefront",
+            source: "self_service",
+        },
+        // ───────── Booking ─────────
+        booking: {
+            // Identity (filled in once the booking row exists; empty at preview)
+            bookingId: "",
+            bookingNumber: "",
+            // alias used by templates that read `{{ booking.number }}`
+            number: "",
+            status: "draft",
+            // Entity context
+            entityModule: ctx.entityModule,
+            entityId: ctx.entityId,
+            vertical,
+            productName: summary?.name ?? ctx.entityId,
+            productSubtitle: summary?.subtitle ?? "",
+            destination: summary?.destination ?? summary?.locationLabel ?? "",
+            whenLabel: summary?.whenLabel ?? "",
+            locationLabel: summary?.locationLabel ?? "",
+            // Pax — bands map keeps Voyant's flexible band model intact
+            pax: paxTotal,
+            paxTotal,
+            paxBands,
+            paxAdult: paxBands.adult ?? 0,
+            paxChild: paxBands.child ?? 0,
+            paxInfant: paxBands.infant ?? 0,
+            // Configure (raw inputs for verticals that need slot ids)
+            departureSlotId: draft.configure?.departureSlotId ?? "",
+            cabinCategoryId: draft.configure?.cabinCategoryId ?? "",
+            cabinNumberId: draft.configure?.cabinNumberId ?? "",
+            airArrangement: draft.configure?.airArrangement ?? "",
+            // Trip dates (vertical-agnostic) — primary names + the
+            // snake_case aliases the seeded template references
+            travelDates: {
+                start: startDate,
+                end: endDate,
+                durationNights,
+            },
+            startDate,
+            endDate,
+            checkIn: draft.configure?.dateRange?.checkIn ?? "",
+            checkOut: draft.configure?.dateRange?.checkOut ?? "",
+            departureDate: draft.configure?.departureDate ?? "",
+            // Money (Voyant's sell vs cost split)
+            sellCurrency,
+            sellAmountCents: totalCents,
+            sellSubtotalCents: subtotalCents,
+            sellTaxAmountCents: taxTotalCents,
+            sellDiscountAmountCents: 0,
+            // Cost-side fields are operator-private and only emitted by
+            // server-side renders that pass them in via context. Empty
+            // during the customer-facing preview by design.
+            costCurrency: "",
+            costAmountCents: 0,
+            baseCurrency: "",
+            // Common alias shapes used by templates we ship with the
+            // operator starter
+            currency: sellCurrency,
+            totalAmountCents: totalCents,
+            subtotalAmountCents: subtotalCents,
+            taxAmountCents: taxTotalCents,
+            discountAmountCents: 0,
+            // Settlement state — empty at preview, post-confirm renders
+            // can fill these from the booking + payments table
+            paidAmountCents: 0,
+            balanceDueCents: totalCents,
+            // Payment-schedule-derived deposit / balance. The storefront
+            // wrapper runs `computePaymentSchedule()` against the
+            // operator's policy + the draft's pricing/dates and passes
+            // the result via `paymentSchedule`, so the contract preview
+            // shows the same numbers the post-confirm schedule will
+            // generate (modulo per-layer overrides applied later).
+            depositAmountCents: depositRow?.amountCents ?? 0,
+            depositDueDate: depositRow?.dueDate ?? "",
+            balanceAmountCents: balanceRow?.amountCents ?? 0,
+            balanceDueDate: balanceRow?.dueDate ?? "",
+            paymentPolicy: {
+                source: ctx.paymentPolicySource ?? "operator_default",
+            },
+            // Best-effort accommodation summary. Server-side resolver
+            // overrides with the persisted booking_items rows.
+            roomsSummary: buildRoomsSummary(draft),
+            // Source provenance — resolved from the catalog plane via the
+            // public content endpoint's `provenance` + supplier and threaded
+            // in by the storefront wrapper. Falls back to the owned arm
+            // (blank connection/ref/supplier) when unresolved (voyant#2619).
+            source: buildBookingSource(ctx.source),
+            // Notes
+            internalNotes: draft.internalNotes ?? "",
+            customerNotes: draft.customerNotes ?? "",
+        },
+        // ───────── Customer / Buyer ─────────
+        customer: {
+            type: billing.buyerType,
+            firstName: contact.firstName,
+            lastName: contact.lastName,
+            fullName: customerFullName,
+            email: contact.email ?? "",
+            phone: contact.phone ?? "",
+            dateOfBirth: travelers[0]?.dateOfBirth ?? "",
+            companyName: billing.company?.name ?? "",
+            vatId: billing.company?.vatId ?? "",
+            registrationNumber: billing.company?.registrationNumber ?? "",
+            address: {
+                line1: address.line1 ?? "",
+                line2: address.line2 ?? "",
+                city: address.city ?? "",
+                postal: address.postal ?? "",
+                country: address.country ?? "",
+            },
+            // Lead traveler's identity document, used as the buyer's
+            // identity doc for B2C flows
+            document: travelers[0]?.document ?? {
+                type: "",
+                number: "",
+                country: "",
+                issuingAuthority: "",
+                issueDate: "",
+                expiryDate: "",
+            },
+        },
+        // ───────── Lead traveler ─────────
+        leadTraveler,
+        // ───────── Travelers ─────────
+        travelers,
+        // `passengers` is a common alias used by templates ported from
+        // other systems
+        passengers: travelers,
+        // ───────── Pricing line items ─────────
+        items,
+        addons,
+        // ───────── Product (subject of the booking) ─────────
+        product: {
+            title: summary?.name ?? "",
+            subtitle: summary?.subtitle ?? "",
+            destination: summary?.destination ?? summary?.locationLabel ?? "",
+            module: ctx.entityModule,
+            id: ctx.entityId,
+            vertical,
+            heroImageUrl: summary?.heroImageUrl ?? "",
+        },
+        // ───────── Vertical-specific schedule blocks ─────────
+        ...vehiclesAndStay,
+        // ───────── Payment ─────────
+        payment: {
+            intent: draft.payment.intent,
+            method: paymentMethodLabel(draft.payment.intent),
+            amountCents: totalCents,
+            currency: sellCurrency,
+            schedule: schedule.map((row, idx) => ({
+                index: idx + 1,
+                type: row.scheduleType,
+                amountCents: row.amountCents,
+                currency: row.currency,
+                dueDate: row.dueDate,
+                status: "pending",
+            })),
+            capturedAt: "",
+            // Alias used by templates that prefer `payment.created_at`-style naming.
+            createdAt: "",
+        },
+        // ───────── Operator ─────────
+        operator: {
+            name: operatorInfo.name ?? "",
+            legalName: operatorInfo.legalName ?? operatorInfo.name ?? "",
+            vatId: operatorInfo.vatId ?? "",
+            registrationNumber: operatorInfo.registrationNumber ?? "",
+            address: operatorInfo.address ?? "",
+            phone: operatorInfo.phone ?? "",
+            email: operatorInfo.email ?? "",
+            website: operatorInfo.website ?? "",
+            iban: operatorInfo.iban ?? "",
+            bank: operatorInfo.bank ?? "",
+            license: operatorInfo.license ?? "",
+            licenseAuthority: operatorInfo.licenseAuthority ?? "",
+            signatoryName: operatorInfo.signatoryName ?? "",
+            signatoryRole: operatorInfo.signatoryRole ?? "",
+        },
+        // ───────── Acceptance fingerprint ─────────
+        acceptance: {
+            ipAddress: acceptance.ipAddress ?? "",
+            userAgent: acceptance.userAgent ?? "",
+            acceptedAt: acceptance.acceptedAt ?? "",
+            marketingConsent: acceptance.marketingConsent ?? false,
+            templateSlug: acceptance.templateSlug ?? "",
+            templateId: acceptance.templateId ?? "",
+        },
+    };
+}
+/**
+ * Map resolved provenance into the contract's `booking.source` block.
+ *
+ * A missing context, or an explicit `"owned"` / empty `kind`, renders
+ * the owned arm with blank connection/ref/supplier — preserving the
+ * pre-fix behavior for genuinely owned inventory. Sourced inventory
+ * carries its real `kind`, `connectionId`, `ref`, and supplier so the
+ * customer contract can disclose the correct supplier/operator split
+ * (voyant#2619).
+ */
+function buildBookingSource(source) {
+    const kind = source?.kind?.trim() ? source.kind : "owned";
+    const isOwned = kind === "owned";
+    return {
+        kind,
+        connectionId: source?.connectionId ?? "",
+        ref: source?.ref ?? "",
+        supplier: {
+            // Owned inventory has no upstream supplier — keep it blank so the
+            // owned arm is unchanged from before the fix.
+            id: isOwned ? "" : (source?.supplier?.id ?? ""),
+            name: isOwned ? "" : (source?.supplier?.name ?? ""),
+        },
+    };
+}
+function stringFromDoc(documents, key) {
+    const value = documents?.[key];
+    return typeof value === "string" ? value : "";
+}
+// These labels are emitted into contract PDFs as template variable values,
+// not rendered in the operator UI. Contract localization is driven by the
+// contract's `language` field on render and lives in the template body —
+// not the operator's UI locale — so these stay in English at this layer.
+function paymentMethodLabel(intent) {
+    switch (intent) {
+        case "card":
+            // i18n-literal-ok
+            return "Card payment";
+        case "bank_transfer":
+            // i18n-literal-ok
+            return "Bank transfer";
+        case "inquiry":
+            // i18n-literal-ok
+            return "Inquiry / Hold";
+        case "hold":
+            // i18n-literal-ok
+            return "Hold";
+        case "ticket_on_credit":
+            // i18n-literal-ok
+            return "Ticket on credit";
+        default:
+            return "";
+    }
+}
+/**
+ * Build a "1× DBL (BB)"-style summary from the draft's accommodation
+ * rooms. Server-side renders override this with a richer summary
+ * derived from the persisted booking_items.
+ */
+function buildRoomsSummary(draft) {
+    const rooms = draft.accommodation?.rooms ?? [];
+    if (rooms.length === 0)
+        return "";
+    return rooms
+        .map((r) => `${r.quantity}× ${r.optionUnitId}${r.ratePlanId ? ` (${r.ratePlanId})` : ""}`)
+        .join(", ");
+}
+function computeNights(startDate, endDate) {
+    if (!startDate || !endDate)
+        return 0;
+    try {
+        const start = new Date(startDate);
+        const end = new Date(endDate);
+        if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime()))
+            return 0;
+        const ms = end.getTime() - start.getTime();
+        return Math.max(0, Math.round(ms / (1000 * 60 * 60 * 24)));
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Build vertical-specific top-level blocks. Verticals that don't
+ * apply emit empty objects so `{{ sailing.ship }}` renders blank
+ * rather than throwing in a strict templating engine.
+ */
+function buildVerticalBlocks(ctx) {
+    const { vertical, summary, draft, accommodationRooms, durationNights, startDate, endDate } = ctx;
+    const blocks = {
+        departureSlot: {
+            slotId: draft.configure?.departureSlotId ?? "",
+            startAt: startDate,
+            endAt: endDate,
+            durationDays: durationNights,
+        },
+        sailing: {
+            sailingId: "",
+            ship: "",
+            embarkationPort: "",
+            disembarkationPort: "",
+            airArrangement: draft.configure?.airArrangement ?? "",
+            startDate: "",
+            endDate: "",
+        },
+        stay: {
+            checkIn: draft.configure?.dateRange?.checkIn ?? "",
+            checkOut: draft.configure?.dateRange?.checkOut ?? "",
+            nights: durationNights,
+            rooms: accommodationRooms,
+        },
+    };
+    if (vertical === "products") {
+        blocks.departureSlot = {
+            slotId: draft.configure?.departureSlotId ?? "",
+            startAt: startDate,
+            endAt: endDate,
+            durationDays: durationNights,
+            departureCity: summary?.locationLabel ?? "",
+        };
+    }
+    else if (vertical === "cruises") {
+        const route = summary?.locationLabel ?? "";
+        const [embarkation, disembarkation] = route.split("→").map((s) => s.trim());
+        blocks.sailing = {
+            sailingId: draft.configure?.departureSlotId ?? "",
+            ship: summary?.subtitle ?? "",
+            embarkationPort: embarkation ?? "",
+            disembarkationPort: disembarkation ?? embarkation ?? "",
+            airArrangement: draft.configure?.airArrangement ?? "",
+            startDate,
+            endDate,
+            cabinCategoryId: draft.configure?.cabinCategoryId ?? "",
+            cabinNumberId: draft.configure?.cabinNumberId ?? "",
+        };
+    }
+    else if (vertical === "accommodations") {
+        blocks.stay = {
+            checkIn: draft.configure?.dateRange?.checkIn ?? "",
+            checkOut: draft.configure?.dateRange?.checkOut ?? "",
+            nights: durationNights,
+            rooms: accommodationRooms,
+            destination: summary?.locationLabel ?? "",
+        };
+    }
+    return blocks;
+}

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

@@ -0,0 +1,13 @@
+export interface StorefrontBookErrorBody {
+    error?: unknown;
+    code?: unknown;
+    requestId?: unknown;
+    details?: unknown;
+    context?: {
+        upstreamPayload?: {
+            reason?: unknown;
+        };
+    };
+}
+export declare function buildStorefrontBookFailureMessage(body: StorefrontBookErrorBody, requestId: string | null, fallback: string, requestReferenceTemplate: string): string;
+//# sourceMappingURL=storefront-booking-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-booking-errors.d.ts","sourceRoot":"","sources":["../../src/storefront/storefront-booking-errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAA;CACrD;AAMD,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,uBAAuB,EAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,EAChB,wBAAwB,EAAE,MAAM,GAC/B,MAAM,CAOR"}