@ticketboothapp/booking 1.2.123 → 1.2.125

package/src/components/booking/admin-change-payment-choice-runner.ts

@@ -0,0 +1,172 @@
+import {
+  confirmBookingWithoutPayment,
+  type CheckoutBreakdown,
+  type ItineraryDisplayStep,
+} from '../../lib/booking-api';
+import type { OrderSummary } from '../../lib/booking/pricing';
+import {
+  buildBookingSourceContext,
+  inferClientBookingSourceFromProductIds,
+  type BookingSourceMetadata,
+} from '../../lib/booking/source-metadata';
+import { formatBookingRefForDisplay } from '../../lib/booking-ref';
+import type { CheckoutModalLineItem } from './CheckoutModal';
+import type { Currency } from './CurrencySwitcher';
+import type { ChangeBookingPaidCheckoutModalData } from './change-booking-payment-modal-builders';
+
+export type AdminChangeCheckoutModalData = ChangeBookingPaidCheckoutModalData;
+
+export interface AdminChangePaymentChoiceData {
+  reservationReference: string;
+  reservationExpiration?: string;
+  checkoutBreakdown: CheckoutBreakdown;
+  totalAmount: number;
+  datePart: string;
+  timePart: string;
+  availabilityProductOptionId: string;
+  itineraryDisplay?: ItineraryDisplayStep[] | null;
+  clientSecret: string;
+  ticketLinesForModal: CheckoutModalLineItem[];
+  feeLineItems: OrderSummary['feeLineItems'];
+  returnPriceAdjustment: number;
+  cancellationPolicyFee: number;
+  cancellationPolicyLabel?: string;
+  subtotal: number;
+  tax: number;
+  totalQuantity: number;
+  isTaxIncludedInPrice: boolean;
+  taxRate: number;
+  promoDiscountAmount: number;
+  discountLabel?: string | null;
+}
+
+export interface BuildAdminChangePaymentChoiceDataParams {
+  reservationReference: string;
+  checkoutBreakdown: CheckoutBreakdown;
+  totalAmount: number;
+  datePart: string;
+  timePart: string;
+  availabilityProductOptionId: string;
+  itineraryDisplay?: ItineraryDisplayStep[] | null;
+  clientSecret: string;
+  ticketLinesForModal: CheckoutModalLineItem[];
+  feeLineItems: OrderSummary['feeLineItems'];
+  returnPriceAdjustment: number;
+  cancellationPolicyFee: number;
+  cancellationPolicyLabel?: string;
+  subtotal: number;
+  tax: number;
+  totalQuantity: number;
+  isTaxIncludedInPrice: boolean;
+  taxRate: number;
+  promoDiscountAmount: number;
+  discountLabel?: string | null;
+}
+
+export function buildAdminChangePaymentChoiceData(
+  params: BuildAdminChangePaymentChoiceDataParams
+): AdminChangePaymentChoiceData {
+  return {
+    reservationExpiration: undefined,
+    ...params,
+  };
+}
+
+export function buildAdminChangePayNowCheckoutModalData(
+  adminChoiceData: AdminChangePaymentChoiceData,
+  lastName: string
+): AdminChangeCheckoutModalData {
+  return {
+    reservationReference: adminChoiceData.reservationReference,
+    reservationExpiration: adminChoiceData.reservationExpiration,
+    customerLastName: lastName.trim(),
+    ticketLines: adminChoiceData.ticketLinesForModal,
+    feeLineItems: adminChoiceData.feeLineItems,
+    returnPriceAdjustment: adminChoiceData.returnPriceAdjustment,
+    cancellationPolicyFee: adminChoiceData.cancellationPolicyFee,
+    cancellationPolicyLabel: adminChoiceData.cancellationPolicyLabel,
+    subtotal: adminChoiceData.subtotal,
+    tax: adminChoiceData.tax,
+    total: adminChoiceData.totalAmount,
+    totalQuantity: adminChoiceData.totalQuantity,
+    isTaxIncludedInPrice: adminChoiceData.isTaxIncludedInPrice,
+    taxRate: adminChoiceData.taxRate,
+    promoDiscountAmount: adminChoiceData.promoDiscountAmount,
+    discountLabel: adminChoiceData.discountLabel,
+  };
+}
+
+export interface ConfirmAdminChangeBookingWithoutPaymentParams {
+  adminChoiceData: AdminChangePaymentChoiceData;
+  bookingSourceAttribution: Partial<BookingSourceMetadata>;
+  partnerPortalBooking: boolean;
+  forceDashboardSource: boolean;
+  productId: string;
+  email: string;
+  firstName: string;
+  lastName: string;
+  currency: Currency;
+  travelerHotel?: string;
+  pickupLocationId?: string;
+  termsAcceptedAt?: string | null;
+  skipConfirmationCommunications: boolean;
+  disableAutoCommunications: boolean;
+}
+
+export async function confirmAdminChangeBookingWithoutPayment({
+  adminChoiceData,
+  bookingSourceAttribution,
+  partnerPortalBooking,
+  forceDashboardSource,
+  productId,
+  email,
+  firstName,
+  lastName,
+  currency,
+  travelerHotel,
+  pickupLocationId,
+  termsAcceptedAt,
+  skipConfirmationCommunications,
+  disableAutoCommunications,
+}: ConfirmAdminChangeBookingWithoutPaymentParams): Promise<{
+  bookingReference: string;
+  displayReference: string;
+  lastName: string;
+}> {
+  const bookingSourceContext = buildBookingSourceContext(bookingSourceAttribution, {
+    clientChannelSource: inferClientBookingSourceFromProductIds(
+      productId,
+      adminChoiceData.availabilityProductOptionId,
+    ),
+    forcePartnerPortalChannel: partnerPortalBooking,
+    forceDashboardSource,
+  });
+  const result = await confirmBookingWithoutPayment({
+    reservationReference: adminChoiceData.reservationReference,
+    productId,
+    optionId: adminChoiceData.availabilityProductOptionId,
+    date: adminChoiceData.datePart,
+    time: adminChoiceData.timePart,
+    customerEmail: email || undefined,
+    customerFirstName: firstName.trim() || undefined,
+    customerLastName: lastName.trim() || undefined,
+    currency,
+    travelerHotel,
+    pickupLocationId,
+    itineraryDisplay: adminChoiceData.itineraryDisplay ?? undefined,
+    termsAcceptedAt: termsAcceptedAt ?? undefined,
+    skipConfirmationCommunications: skipConfirmationCommunications ? true : undefined,
+    disableAutoCommunications: disableAutoCommunications ? true : undefined,
+    checkoutBreakdown: adminChoiceData.checkoutBreakdown,
+    depositAmount: 0,
+    balanceAmount: adminChoiceData.totalAmount,
+    totalAmount: adminChoiceData.totalAmount,
+    ...bookingSourceContext,
+  });
+
+  return {
+    bookingReference: result.bookingReference,
+    displayReference: formatBookingRefForDisplay(result.bookingReference),
+    lastName: lastName.trim(),
+  };
+}

package/src/components/booking/admin-change-provider-payload.ts

@@ -0,0 +1,101 @@
+import type { Availability, Product, ReturnOption } from '../../lib/booking-api';
+import type { ProviderDashboardChangeBookingPayload } from './provider-dashboard-change-booking';
+
+export type AdminChangeBookingItem = { category: string; count: number };
+export type AdminChangeAddOnSelection = { addOnId: string; variantId?: string; quantity?: number };
+export type AdminChangeProviderLineOverride = NonNullable<
+  NonNullable<ProviderDashboardChangeBookingPayload['pricingAdjustment']>['lineOverrides']
+>[number];
+export type AdminChangeProviderAdditionalAdjustment = NonNullable<
+  NonNullable<ProviderDashboardChangeBookingPayload['pricingAdjustment']>['additionalAdjustments']
+>[number];
+
+export function bookingItemsFromQuantities(
+  quantities: Record<string, number>
+): AdminChangeBookingItem[] {
+  return Object.entries(quantities)
+    .filter(([, count]) => count > 0)
+    .map(([category, count]) => ({ category, count }));
+}
+
+export interface BuildAdminChangeProviderPayloadParams {
+  selectedAvailability: Availability | null;
+  availabilityProductOptionId: string;
+  bookingItems: AdminChangeBookingItem[];
+  product: Product;
+  pickupLocationId: string | null;
+  selectedReturnOption: ReturnOption | null;
+  addOnSelections: AdminChangeAddOnSelection[];
+  cancellationPolicyId: string | null;
+  initialCancellationPolicyId?: string | null;
+  appliedPromoCode: string | null;
+  newTotalAmount: number;
+  providerPricingOverrides: AdminChangeProviderLineOverride[];
+  mergedProviderAdditionalAdjustments: AdminChangeProviderAdditionalAdjustment[];
+  providerApplyAuthoritativeReceipt?: ProviderDashboardChangeBookingPayload['authoritativeReceipt'];
+  previousPassengerCount: number;
+  previousAvailabilityId?: string | null;
+  previousReturnAvailabilityId?: string | null;
+}
+
+export function buildAdminChangeProviderPayload({
+  selectedAvailability,
+  availabilityProductOptionId,
+  bookingItems,
+  product,
+  pickupLocationId,
+  selectedReturnOption,
+  addOnSelections,
+  cancellationPolicyId,
+  initialCancellationPolicyId,
+  appliedPromoCode,
+  newTotalAmount,
+  providerPricingOverrides,
+  mergedProviderAdditionalAdjustments,
+  providerApplyAuthoritativeReceipt,
+  previousPassengerCount,
+  previousAvailabilityId,
+  previousReturnAvailabilityId,
+}: BuildAdminChangeProviderPayloadParams): ProviderDashboardChangeBookingPayload | null {
+  if (!selectedAvailability) return null;
+  const pickupForChange = pickupLocationId
+    ? product.pickupLocations?.find((loc) => loc.id === pickupLocationId)
+    : null;
+
+  return {
+    productId: availabilityProductOptionId,
+    parentProductId: product.productId,
+    dateTime: selectedAvailability.dateTime,
+    bookingItems,
+    returnAvailabilityId: selectedReturnOption?.returnAvailabilityId ?? null,
+    pickupLocationId: pickupLocationId ?? null,
+    travelerHotel: pickupForChange?.name ?? null,
+    startTime: selectedAvailability.dateTime ?? null,
+    passengerCount: null,
+    childSafetySeatsCount: null,
+    foodRestrictions: null,
+    addOnSelections: addOnSelections.length > 0 ? addOnSelections : null,
+    cancellationPolicyId: cancellationPolicyId ?? initialCancellationPolicyId ?? null,
+    promoCode: appliedPromoCode ?? null,
+    newTotalAmount,
+    additionalHoursCount: null,
+    pricingAdjustment:
+      providerPricingOverrides.length > 0 || mergedProviderAdditionalAdjustments.length > 0
+        ? {
+            mode: 'MANUAL_LINES',
+            ...(providerPricingOverrides.length > 0 ? { lineOverrides: providerPricingOverrides } : {}),
+            ...(mergedProviderAdditionalAdjustments.length > 0
+              ? { additionalAdjustments: mergedProviderAdditionalAdjustments }
+              : {}),
+          }
+        : undefined,
+    authoritativeReceipt: providerApplyAuthoritativeReceipt,
+    capacitySeatCredit: {
+      enabled: true,
+      previousPassengerCount,
+      previousAvailabilityId: previousAvailabilityId ?? null,
+      previousReturnAvailabilityId: previousReturnAvailabilityId ?? null,
+    },
+    deferPaymentToBalance: true,
+  };
+}

package/src/components/booking/change-booking-checkout-builders.ts

@@ -0,0 +1,185 @@
+import type { AddOn, CheckoutBreakdown } from '../../lib/booking-api';
+import type { CheckoutLineInput } from '../../lib/booking/checkout-breakdown';
+import { buildCheckoutBreakdown } from '../../lib/booking/checkout-breakdown';
+import type { OrderSummaryFeeLine, OrderSummaryTicketLine } from '../../lib/booking/pricing';
+
+export type ChangeBookingAddOnSelection = {
+  addOnId: string;
+  variantId?: string;
+  quantity?: number;
+};
+
+export type ChangeBookingCustomReceiptLineInput = {
+  label: string;
+  amountInput: string;
+  amountSign?: number;
+};
+
+export interface BuildChangeBookingCheckoutBreakdownParams {
+  ticketLineItems: OrderSummaryTicketLine[];
+  totalQuantity: number;
+  checkoutReturnLineAmount: number;
+  returnOptionLabel: string;
+  personLabel: string;
+  peopleLabel: string;
+  cancellationPolicyFee: number;
+  cancellationPolicyLabel: string;
+  addOnSelections: ChangeBookingAddOnSelection[];
+  addOns: AddOn[];
+  feeLineItems: OrderSummaryFeeLine[];
+  customReceiptLines?: ChangeBookingCustomReceiptLineInput[];
+  isTaxIncludedInPrice: boolean;
+  taxForBreakdown: number;
+  taxLabel: string;
+  effectivePromoDiscountAmount: number;
+  appliedPromoCode?: string | null;
+  discountLabel: string;
+  promoLineType: string;
+  amountDueForCheckout: number;
+  currency: string;
+  roundingLabel: string;
+}
+
+function buildChangeBookingAddOnCheckoutLines(
+  addOnSelections: ChangeBookingAddOnSelection[],
+  addOns: AddOn[]
+): CheckoutLineInput[] {
+  const lines: CheckoutLineInput[] = [];
+
+  for (const selection of addOnSelections) {
+    const addOn = addOns.find((candidate) => candidate.addOnId === selection.addOnId);
+    if (!addOn) continue;
+
+    const hasVariant =
+      (addOn.variantType === 'single_choice' || addOn.variantType === 'multi_quantity') &&
+      selection.variantId;
+    const variant = hasVariant
+      ? addOn.variants?.find((candidate) => candidate.id === selection.variantId)
+      : null;
+    const quantity = selection.quantity ?? 1;
+    const amount = ((addOn.price ?? 0) + (variant?.priceAdjustment ?? 0)) * quantity;
+    const label = variant?.label
+      ? `${addOn.name} (${variant.label})${quantity > 1 ? ` \u00d7 ${quantity}` : ''}`
+      : addOn.name;
+
+    lines.push({
+      label,
+      amount,
+      type: 'FEE',
+      quantity,
+    });
+  }
+
+  return lines;
+}
+
+function buildCustomReceiptCheckoutLines(
+  customReceiptLines: ChangeBookingCustomReceiptLineInput[] | undefined
+): CheckoutLineInput[] {
+  return (
+    customReceiptLines?.flatMap((line) => {
+      const raw = line.amountInput.trim();
+      if (raw === '' || raw === '+' || raw === '-') return [];
+      const amountInput = Number(raw);
+      if (!Number.isFinite(amountInput) || Math.abs(amountInput) < 0.0005) return [];
+      const sign = line.amountSign ?? 1;
+      return [
+        {
+          label: line.label.trim() || 'Adjustment',
+          amount: sign * Math.abs(amountInput),
+          type: 'FEE',
+        },
+      ];
+    }) ?? []
+  );
+}
+
+export function buildChangeBookingCheckoutBreakdown(
+  params: BuildChangeBookingCheckoutBreakdownParams
+): CheckoutBreakdown {
+  const {
+    ticketLineItems,
+    totalQuantity,
+    checkoutReturnLineAmount,
+    returnOptionLabel,
+    personLabel,
+    peopleLabel,
+    cancellationPolicyFee,
+    cancellationPolicyLabel,
+    addOnSelections,
+    addOns,
+    feeLineItems,
+    customReceiptLines,
+    isTaxIncludedInPrice,
+    taxForBreakdown,
+    taxLabel,
+    effectivePromoDiscountAmount,
+    appliedPromoCode,
+    discountLabel,
+    promoLineType,
+    amountDueForCheckout,
+    currency,
+    roundingLabel,
+  } = params;
+  const personCountLabel = totalQuantity === 1 ? personLabel : peopleLabel;
+  const lines: CheckoutLineInput[] = [
+    ...ticketLineItems.map((line) => ({
+      label: line.category,
+      amount: line.itemTotal,
+      type: 'TICKET',
+      quantity: line.qty,
+    })),
+    ...(checkoutReturnLineAmount !== 0
+      ? [
+          {
+            label: `${returnOptionLabel} (${totalQuantity} ${personCountLabel})`,
+            amount: checkoutReturnLineAmount,
+            type: 'RETURN_OPTION',
+            quantity: totalQuantity,
+          },
+        ]
+      : []),
+    ...(cancellationPolicyFee > 0
+      ? [
+          {
+            label: cancellationPolicyLabel,
+            amount: cancellationPolicyFee,
+            type: 'CANCELLATION_UPGRADE',
+          },
+        ]
+      : []),
+    ...buildChangeBookingAddOnCheckoutLines(addOnSelections, addOns),
+    ...feeLineItems.map((fee) => ({
+      label: `${fee.name} (${totalQuantity} ${personCountLabel})`,
+      amount: fee.totalAmount,
+      type: 'FEE',
+      quantity: totalQuantity,
+    })),
+    ...buildCustomReceiptCheckoutLines(customReceiptLines),
+    ...(!isTaxIncludedInPrice && taxForBreakdown > 0
+      ? [
+          {
+            label: taxLabel,
+            amount: taxForBreakdown,
+            type: 'TAX',
+          },
+        ]
+      : []),
+    ...(effectivePromoDiscountAmount > 0
+      ? [
+          {
+            label: appliedPromoCode ? `Promo: ${appliedPromoCode}` : discountLabel,
+            amount: -effectivePromoDiscountAmount,
+            type: promoLineType,
+          },
+        ]
+      : []),
+  ];
+
+  return buildCheckoutBreakdown({
+    lines,
+    totalAmount: amountDueForCheckout,
+    currency,
+    roundingLabel,
+  });
+}

package/src/components/booking/change-booking-checkout-quote-runner.ts

@@ -0,0 +1,207 @@
+import {
+  quoteChangeBooking,
+  quoteChangeBookingAdminFeReceipt,
+  type AdminFeAuthoritativeReceipt,
+  type ChangeBookingQuoteRequest,
+} from '../../lib/booking-api';
+import type { Currency } from './CurrencySwitcher';
+import {
+  evaluateChangeBookingQuoteForCheckout,
+  type ChangeBookingCheckoutQuoteDecision,
+} from './change-booking-quote-guards';
+import {
+  resolveConfirmedChangeNewTotalForCheckout,
+  sliceAndMergeChangeQuoteForUi,
+  type ChangeBookingMergedQuoteState,
+} from './change-booking-quote-state';
+
+type FallbackCart = { total: number; subtotal: number; tax: number };
+type PassengerCounts = NonNullable<ChangeBookingQuoteRequest['newPassengerCounts']>;
+type AddOnSelections = NonNullable<ChangeBookingQuoteRequest['newAddOnSelections']>;
+type ManualLineAdjustments = NonNullable<ChangeBookingQuoteRequest['manualLineAdjustments']>;
+type CapacitySeatCredit = NonNullable<ChangeBookingQuoteRequest['capacitySeatCredit']>;
+
+export interface ChangeCheckoutQuoteResult {
+  bookingReference: string;
+  decision: ChangeBookingCheckoutQuoteDecision;
+  mergedQuote: ChangeBookingMergedQuoteState;
+  confirmedNewTotalForCheckout: number;
+}
+
+export interface QuoteCustomerChangeForCheckoutParams {
+  bookingReference?: string | null;
+  lastName: string;
+  availabilityProductOptionId: string;
+  dateTime: string;
+  availabilityId?: string | null;
+  pickupLocationId?: string | null;
+  returnAvailabilityId?: string | null;
+  bookingItems: PassengerCounts;
+  addOnSelections?: AddOnSelections;
+  clientProposedTotal: number;
+  fallbackCart: FallbackCart;
+  currency: Currency;
+  originalReceiptTotal: number;
+}
+
+export async function quoteCustomerChangeForCheckout({
+  bookingReference,
+  lastName,
+  availabilityProductOptionId,
+  dateTime,
+  availabilityId,
+  pickupLocationId,
+  returnAvailabilityId,
+  bookingItems,
+  addOnSelections,
+  clientProposedTotal,
+  fallbackCart,
+  currency,
+  originalReceiptTotal,
+}: QuoteCustomerChangeForCheckoutParams): Promise<ChangeCheckoutQuoteResult> {
+  const changeBookingReference = bookingReference?.trim();
+  const changeLastName = lastName.trim();
+  if (!changeBookingReference || !changeLastName) {
+    throw new Error('Missing booking reference or last name for change quote');
+  }
+
+  const quote = await quoteChangeBooking({
+    bookingReference: changeBookingReference,
+    lastName: changeLastName,
+    newProductId: availabilityProductOptionId,
+    newDateTime: dateTime,
+    newAvailabilityId: availabilityId || null,
+    newPickupLocationId: pickupLocationId || null,
+    newReturnAvailabilityId: returnAvailabilityId ?? null,
+    newPassengerCounts: bookingItems,
+    ...(addOnSelections && addOnSelections.length > 0
+      ? { newAddOnSelections: addOnSelections }
+      : {}),
+    clientProposedTotal,
+  });
+  const { quoteSlice, mergedQuote } = sliceAndMergeChangeQuoteForUi(
+    quote,
+    fallbackCart,
+    currency
+  );
+  const decision = evaluateChangeBookingQuoteForCheckout({
+    quote,
+    quoteSlice,
+    fallbackNewBookingTotal: fallbackCart.total,
+    originalReceiptTotal,
+    audience: 'customer',
+  });
+
+  return {
+    bookingReference: changeBookingReference,
+    decision,
+    mergedQuote,
+    confirmedNewTotalForCheckout: resolveConfirmedChangeNewTotalForCheckout({
+      quote,
+      quoteSlice,
+      fallbackNewBookingTotal: fallbackCart.total,
+    }),
+  };
+}
+
+export interface QuoteAdminChangeForCheckoutParams {
+  bookingReference?: string | null;
+  lastName: string;
+  parentProductId: string;
+  availabilityProductOptionId: string;
+  dateTime: string;
+  availabilityId?: string | null;
+  pickupLocationId?: string | null;
+  returnAvailabilityId?: string | null;
+  bookingItems: PassengerCounts;
+  addOnSelections?: AddOnSelections;
+  manualLineAdjustments?: ManualLineAdjustments;
+  clientProposedTotal: number;
+  capacitySeatCredit?: CapacitySeatCredit;
+  fallbackCart: FallbackCart;
+  currency: Currency;
+  originalReceiptTotal: number;
+  useAdminFeAuthoritativeQuote: boolean;
+  adminFeAuthoritativeReceipt: AdminFeAuthoritativeReceipt;
+  adminFeAmountDueMajorUnits: number;
+}
+
+export async function quoteAdminChangeForCheckout({
+  bookingReference,
+  lastName,
+  parentProductId,
+  availabilityProductOptionId,
+  dateTime,
+  availabilityId,
+  pickupLocationId,
+  returnAvailabilityId,
+  bookingItems,
+  addOnSelections,
+  manualLineAdjustments,
+  clientProposedTotal,
+  capacitySeatCredit,
+  fallbackCart,
+  currency,
+  originalReceiptTotal,
+  useAdminFeAuthoritativeQuote,
+  adminFeAuthoritativeReceipt,
+  adminFeAmountDueMajorUnits,
+}: QuoteAdminChangeForCheckoutParams): Promise<ChangeCheckoutQuoteResult> {
+  const changeBookingReference = bookingReference?.trim();
+  const changeLastName = lastName.trim();
+  if (!changeBookingReference || !changeLastName) {
+    throw new Error('Missing booking reference or last name for change quote');
+  }
+
+  const quoteRequestBase: ChangeBookingQuoteRequest = {
+    bookingReference: changeBookingReference,
+    lastName: changeLastName,
+    newProductId: availabilityProductOptionId,
+    newParentProductId: parentProductId,
+    newDateTime: dateTime,
+    newAvailabilityId: availabilityId || null,
+    newPickupLocationId: pickupLocationId || null,
+    newReturnAvailabilityId: returnAvailabilityId ?? null,
+    newPassengerCounts: bookingItems,
+    ...(addOnSelections && addOnSelections.length > 0
+      ? { newAddOnSelections: addOnSelections }
+      : {}),
+    ...(manualLineAdjustments && manualLineAdjustments.length > 0
+      ? { manualLineAdjustments }
+      : {}),
+    clientProposedTotal,
+    ...(capacitySeatCredit ? { capacitySeatCredit } : {}),
+  };
+  const quote = useAdminFeAuthoritativeQuote
+    ? await quoteChangeBookingAdminFeReceipt({
+        ...quoteRequestBase,
+        feReceipt: adminFeAuthoritativeReceipt,
+        feAmountDueMajorUnits: adminFeAmountDueMajorUnits,
+      })
+    : await quoteChangeBooking(quoteRequestBase);
+  const { quoteSlice, mergedQuote } = sliceAndMergeChangeQuoteForUi(
+    quote,
+    fallbackCart,
+    currency
+  );
+  const decision = evaluateChangeBookingQuoteForCheckout({
+    quote,
+    quoteSlice,
+    fallbackNewBookingTotal: fallbackCart.total,
+    originalReceiptTotal,
+    audience: 'admin',
+    useAdminFeAuthoritativeQuote,
+    adminFeAmountDueMajorUnits,
+  });
+
+  return {
+    bookingReference: changeBookingReference,
+    decision,
+    mergedQuote,
+    confirmedNewTotalForCheckout: resolveConfirmedChangeNewTotalForCheckout({
+      quote,
+      quoteSlice,
+      fallbackNewBookingTotal: fallbackCart.total,
+    }),
+  };
+}