@ticketboothapp/booking 1.2.123 → 1.2.125

package/src/lib/booking-api.ts

@@ -317,6 +317,8 @@ function logBookingSourceDebug(
           utmSource?: string;
           utmMedium?: string;
           utmCampaign?: string;
+          gaClientId?: string;
+          gaSessionId?: string;
         };
         source_metadata?: {
           pagePath?: string;
@@ -325,12 +327,14 @@ function logBookingSourceDebug(
           utmSource?: string;
           utmMedium?: string;
           utmCampaign?: string;
+          gaClientId?: string;
+          gaSessionId?: string;
         };
       };
       const md = maybe.sourceMetadata ?? maybe.source_metadata;
       if (md) {
         console.info(
-          `${prefix} summary source=${maybe.source ?? 'n/a'} path=${md.pagePath ?? 'n/a'} partner=${md.partnerId ?? 'n/a'} utm_source=${md.utmSource ?? 'n/a'} utm_medium=${md.utmMedium ?? 'n/a'} utm_campaign=${md.utmCampaign ?? 'n/a'}`
+          `${prefix} summary source=${maybe.source ?? 'n/a'} path=${md.pagePath ?? 'n/a'} partner=${md.partnerId ?? 'n/a'} utm_source=${md.utmSource ?? 'n/a'} utm_medium=${md.utmMedium ?? 'n/a'} utm_campaign=${md.utmCampaign ?? 'n/a'} ga_client_id=${md.gaClientId ? 'present' : 'n/a'} ga_session_id=${md.gaSessionId ? 'present' : 'n/a'}`
         );
       }
     }
@@ -1186,6 +1190,8 @@ export interface CreatePaymentIntentResponse {
   clientSecret: string;
   amount: number;
   currency: string;
+  pricingQuoteId?: string | null;
+  pricingQuoteInputsHash?: string | null;
 }
 
 export interface ChangeBookingQuoteRequest {
@@ -1338,6 +1344,15 @@ export interface ChangeBookingQuoteResponse {
   newTotalCents?: number;
   amountDueCents?: number;
   expiresAt?: string;
+  pricingQuoteId?: string;
+  pricingQuoteInputsHash?: string;
+  /** Optional full Pricing V2 quote snapshot when BE prices the change through Pricing V2. */
+  pricingQuote?: PricingV2QuoteSnapshot | null;
+  quote?: PricingV2QuoteSnapshot | null;
+  paymentCreditTotal?: number;
+  balanceDelta?: number;
+  amountToCharge?: number;
+  refundCandidate?: number;
   /**
    * Optional (customer change-quote UI): per-category ticket unit prices in **major units**, display currency.
    * Uppercase keys preferred (ADULT, CHILD, …). Enables full self-serve preview without catalog math.
@@ -1442,12 +1457,18 @@ export async function cancelBookingPublic(
 
 export async function createBalancePaymentIntent(
   bookingReference: string,
-  lastName: string
+  lastName: string,
+  pricingQuote?: { pricingQuoteId?: string | null; pricingQuoteInputsHash?: string | null }
 ): Promise<CreatePaymentIntentResponse> {
   const res = await fetch(`${API_BASE}/checkout/balance-payment-intent`, {
     method: 'POST',
     headers: withBookingOutboundHeaders({ 'Content-Type': 'application/json' }),
-    body: JSON.stringify({ bookingReference, lastName }),
+    body: JSON.stringify({
+      bookingReference,
+      lastName,
+      pricingQuoteId: pricingQuote?.pricingQuoteId,
+      pricingQuoteInputsHash: pricingQuote?.pricingQuoteInputsHash,
+    }),
   });
   if (!res.ok) {
     const err = await res.json();
@@ -1457,6 +1478,31 @@ export async function createBalancePaymentIntent(
   return (data.data ?? data) as CreatePaymentIntentResponse;
 }
 
+export interface CreateBalancePaymentQuoteResponse {
+  amount: number;
+  currency: string;
+  pricingQuoteId: string;
+  pricingQuoteInputsHash: string;
+  expiresAt: string;
+}
+
+export async function createBalancePaymentQuote(
+  bookingReference: string,
+  lastName: string
+): Promise<CreateBalancePaymentQuoteResponse> {
+  const res = await fetch(`${API_BASE}/checkout/balance-payment-quote`, {
+    method: 'POST',
+    headers: withBookingOutboundHeaders({ 'Content-Type': 'application/json' }),
+    body: JSON.stringify({ bookingReference, lastName }),
+  });
+  if (!res.ok) {
+    const err = await res.json();
+    throw new Error(err.errorMessage || err.error || 'Failed to price payment');
+  }
+  const data = await res.json();
+  return (data.data ?? data) as CreateBalancePaymentQuoteResponse;
+}
+
 export async function quoteChangeBooking(
   request: ChangeBookingQuoteRequest
 ): Promise<ChangeBookingQuoteResponse> {
@@ -1629,6 +1675,7 @@ export interface ReturnOption {
 
 export interface Availability {
   dateTime: string;
+  canonicalDateTime?: string | null;
   productId?: string;
   vacancies: number;
   totalCapacity?: number;
@@ -1849,6 +1896,103 @@ export function summarizeReserveRequestForTelemetry(req: ReserveRequest): Record
  * `/1/reserve` success payload (`ReserveResponseData` on the API).
  * Hold expiry is serialized as `reservationExpiration` (not `expiresAt`).
  */
+export interface PublicNewBookingQuoteV2Request {
+  productId: string;
+  optionId: string;
+  availabilityId: string;
+  dateTime: string;
+  bookingItems: Array<{ category: string; count: number }>;
+  currency?: string | null;
+  returnAvailabilityId?: string | null;
+  promoCode?: string | null;
+  cancellationPolicyId?: string | null;
+  addOnSelections?: Array<{ addOnId: string; quantity?: number; variantId?: string }> | null;
+  additionalHoursCount?: number | null;
+  allowOverbook?: boolean | null;
+}
+
+export interface PricingV2QuoteLineSnapshot {
+  lineId?: string | null;
+  type?: string | null;
+  label?: string | null;
+  amount?: number | null;
+  quantity?: number | null;
+  unitAmount?: number | null;
+  billable?: boolean | null;
+  currency?: string | null;
+  taxBehavior?: string | null;
+  discountBehavior?: string | null;
+  source?: string | null;
+  metadata?: Record<string, string> | null;
+}
+
+export interface PricingV2QuoteSnapshot {
+  quoteId?: string | null;
+  pricingVersion?: string | null;
+  companyId?: string | null;
+  context?: string | null;
+  status?: string | null;
+  currency?: string | null;
+  grossSubtotal?: number | null;
+  discountTotal?: number | null;
+  paymentCreditTotal?: number | null;
+  netSubtotalBeforeTax?: number | null;
+  taxableSubtotal?: number | null;
+  taxAmount?: number | null;
+  payableTotal?: number | null;
+  amountPreviouslyPaid?: number | null;
+  balanceDelta?: number | null;
+  amountToCharge?: number | null;
+  refundCandidate?: number | null;
+  totalAmount?: number | null;
+  subtotal?: number | null;
+  tax?: number | null;
+  lines?: PricingV2QuoteLineSnapshot[] | null;
+  inputsHash?: string | null;
+  oldReceiptHash?: string | null;
+  expiresAt?: string | null;
+  bookingReference?: string | null;
+  reservationReference?: string | null;
+  relatedChangeIntentId?: string | null;
+  metadata?: Record<string, string> | null;
+  [key: string]: unknown;
+}
+
+export interface PublicNewBookingQuoteV2Data {
+  quote?: PricingV2QuoteSnapshot | null;
+  canBook: boolean;
+  reasonIfBlocked?: string | null;
+  unsupportedFeatures?: string[];
+  pricingV2Enabled?: boolean | null;
+  pricingV2QuoteRequired?: boolean | null;
+}
+
+export async function quotePublicNewBookingV2(
+  request: PublicNewBookingQuoteV2Request,
+  signal?: AbortSignal
+): Promise<PublicNewBookingQuoteV2Data> {
+  const endpoint = '/1/public/booking-quotes';
+  const res = await fetch(`${API_BASE}${endpoint}`, {
+    method: 'POST',
+    headers: getAuthHeaders(),
+    body: JSON.stringify(request),
+    signal,
+  });
+  const payload = await parseJsonSafely(res);
+  if (!res.ok) {
+    const message = isApiErrorPayload(payload)
+      ? payload.errorMessage || payload.error || `HTTP error ${res.status}`
+      : `HTTP error ${res.status}`;
+    throw new Error(message);
+  }
+  const outer = (payload as { data?: unknown } | null)?.data;
+  const inner = (outer as { data?: PublicNewBookingQuoteV2Data } | null)?.data ?? outer;
+  if (!inner || typeof inner !== 'object') {
+    throw new Error('Invalid response: missing Pricing V2 quote data');
+  }
+  return inner as PublicNewBookingQuoteV2Data;
+}
+
 export interface ReserveResponse {
   reservationReference: string;
   /** ISO 8601 instant when the hold expires (API field name). */
@@ -2038,6 +2182,9 @@ export interface CreatePaymentIntentRequest {
   checkoutBreakdown?: CheckoutBreakdown;
   dependentAddOnSelection?: CheckoutDependentAddOnSelection;
   itineraryDisplay?: ItineraryDisplayStep[];
+  pricingQuoteId?: string;
+  pricingQuoteInputsHash?: string;
+  idempotencyKey?: string;
   skipConfirmationCommunications?: boolean;
   disableAutoCommunications?: boolean;
   /** Private Shuttle deposit: pay deposit now, balance charged before trip */
@@ -2139,6 +2286,9 @@ export interface ConfirmFreeBookingRequest {
   dependentAddOnSelection?: CheckoutDependentAddOnSelection;
   skipConfirmationCommunications?: boolean;
   disableAutoCommunications?: boolean;
+  /** Pricing V2 checkout quote id; the backend also falls back to the quote stored on the reservation. */
+  pricingQuoteId?: string;
+  pricingQuoteInputsHash?: string;
   source?: string;
   sourceMetadata?: BookingSourceMetadata;
   source_metadata?: BookingSourceMetadata;
@@ -2224,6 +2374,8 @@ export interface ConfirmBookingWithoutPaymentRequest {
   balanceAmount: number;
   totalAmount: number;
   balanceChargeDaysBefore?: number;
+  pricingQuoteId?: string;
+  pricingQuoteInputsHash?: string;
   source?: string;
   sourceMetadata?: BookingSourceMetadata;
   source_metadata?: BookingSourceMetadata;

package/src/lib/pricing-v2-shadow.ts

@@ -0,0 +1,272 @@
+import {
+  quotePublicNewBookingV2,
+  type PublicNewBookingQuoteV2Data,
+  type PublicNewBookingQuoteV2Request,
+} from './booking-api';
+
+export const PRICING_V2_SHADOW_NEW_BOOKING_QUOTE_EVENT = 'ticketbooth:pricing-v2-shadow-new-booking-quote';
+export const PRICING_V2_SHADOW_NEW_BOOKING_QUOTE_STORAGE_KEY = 'ticketbooth:pricing-v2-shadow-new-booking-quote:last';
+
+export type PricingV2ShadowNewBookingStatus = 'running' | 'matched' | 'mismatch' | 'blocked' | 'failed' | 'timeout';
+
+export interface PricingV2ShadowNewBookingQuoteDetail {
+  status: PricingV2ShadowNewBookingStatus;
+  flow: 'standard' | 'private-shuttle';
+  productId: string;
+  optionId: string;
+  availabilityId: string;
+  dateTime: string;
+  quoteId?: string | null;
+  canBook?: boolean | null;
+  reasonIfBlocked?: string | null;
+  unsupportedFeatures?: string[];
+  clientProposedTotal?: number | null;
+  pricingV2Total?: number | null;
+  totalDelta?: number | null;
+  paymentCreditTotal?: number | null;
+  pricingV2LineCount?: number | null;
+  pricingV2Status?: string | null;
+  pricingV2Enabled?: boolean | null;
+  pricingV2QuoteRequired?: boolean | null;
+  currency?: string | null;
+  error?: string | null;
+  timestamp: string;
+}
+
+const PRICING_V2_SHADOW_NEW_BOOKING_TIMEOUT_MS = 1500;
+export const PRICING_V2_TOTAL_TOLERANCE = 0.02;
+const PRICING_V2_CHECKOUT_QUOTE_UNAVAILABLE_MESSAGE =
+  'Unable to confirm the current price. Please try again.';
+
+function roundMoney(value: number): number {
+  return Math.round(value * 100) / 100;
+}
+
+function quoteTotal(data: PublicNewBookingQuoteV2Data): number | null {
+  const value = data.quote?.amountToCharge ?? data.quote?.payableTotal ?? data.quote?.totalAmount;
+  return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+
+function quoteLineCount(data: PublicNewBookingQuoteV2Data): number | null {
+  const lines = data.quote?.lines;
+  return Array.isArray(lines) ? lines.length : null;
+}
+
+function publishPricingV2ShadowNewBookingQuote(detail: PricingV2ShadowNewBookingQuoteDetail): void {
+  if (typeof window === 'undefined') return;
+  try {
+    window.sessionStorage.setItem(PRICING_V2_SHADOW_NEW_BOOKING_QUOTE_STORAGE_KEY, JSON.stringify(detail));
+  } catch {
+    // Shadow diagnostics should never affect booking checkout.
+  }
+  window.dispatchEvent(new CustomEvent<PricingV2ShadowNewBookingQuoteDetail>(PRICING_V2_SHADOW_NEW_BOOKING_QUOTE_EVENT, { detail }));
+}
+
+function isPricingV2CheckoutQuoteEnabled(data: PublicNewBookingQuoteV2Data): boolean {
+  return data.pricingV2Enabled === true;
+}
+
+function isPricingV2CheckoutQuoteRequiredByClient(): boolean {
+  return process.env.NEXT_PUBLIC_PRICING_V2_CHECKOUT_REQUIRED?.trim().toLowerCase() === 'true';
+}
+
+function isPricingV2CheckoutQuoteRequired(data: PublicNewBookingQuoteV2Data): boolean {
+  return data.pricingV2QuoteRequired === true || isPricingV2CheckoutQuoteRequiredByClient();
+}
+
+export async function shadowQuotePublicNewBookingV2({
+  flow,
+  request,
+  clientProposedTotal,
+}: {
+  flow: PricingV2ShadowNewBookingQuoteDetail['flow'];
+  request: PublicNewBookingQuoteV2Request;
+  clientProposedTotal?: number | null;
+}): Promise<void> {
+  if (typeof window === 'undefined') return;
+  const controller = new AbortController();
+  const timeoutId = window.setTimeout(() => controller.abort(), PRICING_V2_SHADOW_NEW_BOOKING_TIMEOUT_MS);
+  const roundedClientTotal = typeof clientProposedTotal === 'number' && Number.isFinite(clientProposedTotal)
+    ? roundMoney(clientProposedTotal)
+    : null;
+
+  publishPricingV2ShadowNewBookingQuote({
+    status: 'running',
+    flow,
+    productId: request.productId,
+    optionId: request.optionId,
+    availabilityId: request.availabilityId,
+    dateTime: request.dateTime,
+    clientProposedTotal: roundedClientTotal,
+    currency: request.currency ?? null,
+    timestamp: new Date().toISOString(),
+  });
+
+  try {
+    const quote = await quotePublicNewBookingV2(request, controller.signal);
+    const pricingV2QuoteRequired = isPricingV2CheckoutQuoteRequired(quote);
+    const v2Total = quoteTotal(quote);
+    const totalDelta = v2Total != null && roundedClientTotal != null
+      ? roundMoney(v2Total - roundedClientTotal)
+      : null;
+    const status: PricingV2ShadowNewBookingStatus = !quote.canBook
+      ? 'blocked'
+      : totalDelta != null && Math.abs(totalDelta) > PRICING_V2_TOTAL_TOLERANCE
+        ? 'mismatch'
+        : 'matched';
+    const detail: PricingV2ShadowNewBookingQuoteDetail = {
+      status,
+      flow,
+      productId: request.productId,
+      optionId: request.optionId,
+      availabilityId: request.availabilityId,
+      dateTime: request.dateTime,
+      quoteId: quote.quote?.quoteId ?? null,
+      canBook: quote.canBook,
+      reasonIfBlocked: quote.reasonIfBlocked ?? null,
+      unsupportedFeatures: quote.unsupportedFeatures ?? [],
+      clientProposedTotal: roundedClientTotal,
+      pricingV2Total: v2Total,
+      totalDelta,
+      paymentCreditTotal: quote.quote?.paymentCreditTotal ?? null,
+      pricingV2LineCount: quoteLineCount(quote),
+      pricingV2Status: quote.quote?.status ?? null,
+      pricingV2Enabled: quote.pricingV2Enabled ?? null,
+      pricingV2QuoteRequired,
+      currency: quote.quote?.currency ?? request.currency ?? null,
+      timestamp: new Date().toISOString(),
+    };
+    publishPricingV2ShadowNewBookingQuote(detail);
+    if (status === 'matched') {
+      console.info('[PricingV2 shadow] new booking quote matched', detail);
+    } else {
+      console.warn('[PricingV2 shadow] new booking quote mismatch', detail);
+    }
+  } catch (error) {
+    const aborted = error instanceof Error && error.name === 'AbortError';
+    const pricingV2QuoteRequired = isPricingV2CheckoutQuoteRequiredByClient();
+    const detail: PricingV2ShadowNewBookingQuoteDetail = {
+      status: aborted ? 'timeout' : 'failed',
+      flow,
+      productId: request.productId,
+      optionId: request.optionId,
+      availabilityId: request.availabilityId,
+      dateTime: request.dateTime,
+      clientProposedTotal: roundedClientTotal,
+      pricingV2QuoteRequired,
+      currency: request.currency ?? null,
+      error: aborted ? 'Quote timed out after 1.5s' : error instanceof Error ? error.message : 'Unknown quote error',
+      timestamp: new Date().toISOString(),
+    };
+    publishPricingV2ShadowNewBookingQuote(detail);
+    console.warn('[PricingV2 shadow] new booking quote skipped', detail);
+  } finally {
+    window.clearTimeout(timeoutId);
+  }
+}
+
+
+export async function quotePublicNewBookingV2ForCheckout({
+  flow,
+  request,
+  clientProposedTotal,
+}: {
+  flow: PricingV2ShadowNewBookingQuoteDetail['flow'];
+  request: PublicNewBookingQuoteV2Request;
+  clientProposedTotal?: number | null;
+}): Promise<PublicNewBookingQuoteV2Data | null> {
+  const roundedClientTotal = typeof clientProposedTotal === 'number' && Number.isFinite(clientProposedTotal)
+    ? roundMoney(clientProposedTotal)
+    : null;
+
+  publishPricingV2ShadowNewBookingQuote({
+    status: 'running',
+    flow,
+    productId: request.productId,
+    optionId: request.optionId,
+    availabilityId: request.availabilityId,
+    dateTime: request.dateTime,
+    clientProposedTotal: roundedClientTotal,
+    currency: request.currency ?? null,
+    timestamp: new Date().toISOString(),
+  });
+
+  let quote: PublicNewBookingQuoteV2Data;
+  try {
+    quote = await quotePublicNewBookingV2(request);
+  } catch (error) {
+    const pricingV2QuoteRequired = isPricingV2CheckoutQuoteRequiredByClient();
+    const detail: PricingV2ShadowNewBookingQuoteDetail = {
+      status: pricingV2QuoteRequired ? 'blocked' : 'failed',
+      flow,
+      productId: request.productId,
+      optionId: request.optionId,
+      availabilityId: request.availabilityId,
+      dateTime: request.dateTime,
+      clientProposedTotal: roundedClientTotal,
+      pricingV2QuoteRequired,
+      currency: request.currency ?? null,
+      error: error instanceof Error ? error.message : 'Unknown quote error',
+      timestamp: new Date().toISOString(),
+    };
+    publishPricingV2ShadowNewBookingQuote(detail);
+    if (pricingV2QuoteRequired) {
+      console.warn('[PricingV2 checkout] required new booking quote unavailable', detail);
+      throw new Error(PRICING_V2_CHECKOUT_QUOTE_UNAVAILABLE_MESSAGE);
+    }
+    return null;
+  }
+
+  const v2Total = quoteTotal(quote);
+  const totalDelta = v2Total != null && roundedClientTotal != null
+    ? roundMoney(v2Total - roundedClientTotal)
+    : null;
+  const hasRequiredQuoteFields = Boolean(quote.quote?.quoteId) && v2Total != null;
+  const pricingV2QuoteRequired = isPricingV2CheckoutQuoteRequired(quote);
+  const pricingV2QuoteEnabled = isPricingV2CheckoutQuoteEnabled(quote) || pricingV2QuoteRequired;
+  const status: PricingV2ShadowNewBookingStatus = !quote.canBook || !hasRequiredQuoteFields
+    ? 'blocked'
+    : totalDelta != null && Math.abs(totalDelta) > PRICING_V2_TOTAL_TOLERANCE
+      ? 'mismatch'
+      : 'matched';
+  const detail: PricingV2ShadowNewBookingQuoteDetail = {
+    status,
+    flow,
+    productId: request.productId,
+    optionId: request.optionId,
+    availabilityId: request.availabilityId,
+    dateTime: request.dateTime,
+    quoteId: quote.quote?.quoteId ?? null,
+    canBook: quote.canBook,
+    reasonIfBlocked: quote.reasonIfBlocked ?? null,
+    unsupportedFeatures: quote.unsupportedFeatures ?? [],
+    clientProposedTotal: roundedClientTotal,
+    pricingV2Total: v2Total,
+    totalDelta,
+    paymentCreditTotal: quote.quote?.paymentCreditTotal ?? null,
+    pricingV2LineCount: quoteLineCount(quote),
+    pricingV2Status: quote.quote?.status ?? null,
+    pricingV2Enabled: quote.pricingV2Enabled ?? null,
+    pricingV2QuoteRequired,
+    currency: quote.quote?.currency ?? request.currency ?? null,
+    timestamp: new Date().toISOString(),
+  };
+  publishPricingV2ShadowNewBookingQuote(detail);
+
+  if (!pricingV2QuoteEnabled) {
+    return null;
+  }
+
+  if (status === 'blocked') {
+    if (pricingV2QuoteRequired && !hasRequiredQuoteFields) {
+      throw new Error(PRICING_V2_CHECKOUT_QUOTE_UNAVAILABLE_MESSAGE);
+    }
+    if (!pricingV2QuoteRequired) {
+      return null;
+    }
+    const reason = quote.reasonIfBlocked ?? 'quote_not_applicable';
+    throw new Error(`Pricing quote blocked: ${reason}`);
+  }
+
+  return quote;
+}