@ticketboothapp/booking 1.2.167 → 1.2.168

package/src/components/booking/useAdminProviderPricingAdjustments.ts

@@ -5,17 +5,8 @@ import type {
   ProviderDashboardPricingLine,
 } from './booking-flow-ui';
 import type { ProviderDashboardChangeBookingPayload } from './provider-dashboard-change-booking';
+import type { AdminCustomReceiptLine } from './useAdminCustomReceiptLines';
 
-type AdminCustomReceiptLine = {
-  id: string;
-  label: string;
-  amountInput: string;
-  amountSign?: number;
-  calculation: 'FIXED_AMOUNT' | 'PERCENTAGE';
-  scope: 'POSITIVE_AMENDMENT_VALUE' | 'CURRENT_ACTIVE_TICKETS' | 'CURRENT_ACTIVE_BOOKING';
-  taxBehavior: 'NON_TAXABLE' | 'TAXABLE' | 'PRE_TAX_DISCOUNT' | 'POST_TAX_DISCOUNT';
-  reasonCode: string;
-};
 type AdminStructuredAdjustment = NonNullable<
   ProviderDashboardChangeBookingPayload['structuredAdjustments']
 >[number];
@@ -26,6 +17,35 @@ type ProviderAdditionalAdjustment = NonNullable<
   NonNullable<ProviderDashboardChangeBookingPayload['pricingAdjustment']>['additionalAdjustments']
 >[number];
 
+export interface EffectiveAdminChangeSelectionInput {
+  hasChangeSelection: boolean;
+  providerPricingOverrideCount: number;
+  providerHasAdditionalAdjustments: boolean;
+  isProviderDashboardChange: boolean;
+  editableSummaryPreSubtotalDelta: number;
+  adminStructuredAdjustmentCount: number;
+  adminReverseAdjustmentCount?: number;
+}
+
+export function hasEffectiveAdminChangeSelection({
+  hasChangeSelection,
+  providerPricingOverrideCount,
+  providerHasAdditionalAdjustments,
+  isProviderDashboardChange,
+  editableSummaryPreSubtotalDelta,
+  adminStructuredAdjustmentCount,
+  adminReverseAdjustmentCount = 0,
+}: EffectiveAdminChangeSelectionInput): boolean {
+  return Boolean(
+    hasChangeSelection ||
+      providerPricingOverrideCount > 0 ||
+      providerHasAdditionalAdjustments ||
+      (isProviderDashboardChange && Math.abs(editableSummaryPreSubtotalDelta) >= 0.005) ||
+      adminStructuredAdjustmentCount > 0 ||
+      adminReverseAdjustmentCount > 0,
+  );
+}
+
 export interface UseAdminProviderPricingAdjustmentsParams {
   isProviderDashboardChange: boolean;
   showProviderPricingInlineEditor: boolean;
@@ -33,8 +53,8 @@ export interface UseAdminProviderPricingAdjustmentsParams {
   providerQuotedLines: ProviderDashboardPricingLine[];
   hasChangeSelection: boolean;
   editableSummaryPreSubtotalDelta: number;
-  adminCustomAdjustmentTotal: number;
   adminCustomReceiptLines: AdminCustomReceiptLine[];
+  adminReverseAdjustmentIds: string[];
   isManualOverrideEligibleLine: (line: ProviderDashboardPricingLine) => boolean;
 }
 
@@ -51,8 +71,8 @@ export function useAdminProviderPricingAdjustments({
   providerQuotedLines,
   hasChangeSelection,
   editableSummaryPreSubtotalDelta,
-  adminCustomAdjustmentTotal,
   adminCustomReceiptLines,
+  adminReverseAdjustmentIds,
   isManualOverrideEligibleLine,
 }: UseAdminProviderPricingAdjustmentsParams) {
   const [adjustmentIdNamespace] = useState(() =>
@@ -127,6 +147,7 @@ export function useAdminProviderPricingAdjustments({
   const adminCustomLinesAsAdditionalAdjustments = useMemo(
     (): ProviderAdditionalAdjustment[] =>
       adminCustomReceiptLines.flatMap((line) => {
+        if (line.sourceAdjustmentId) return [];
         const raw = line.amountInput.trim();
         if (raw === '' || raw === '+' || raw === '-') return [];
         const n = Number(raw);
@@ -142,20 +163,26 @@ export function useAdminProviderPricingAdjustments({
   const adminStructuredAdjustments = useMemo(
     (): AdminStructuredAdjustment[] => {
       const customAdjustments = adminCustomReceiptLines.flatMap((line) => {
+        if (line.sourceAdjustmentId && !line.isDirty) return [];
         const value = Number(line.amountInput.trim());
         if (!Number.isFinite(value) || value <= 0) return [];
+        if (line.scope === 'SELECTED_COMPONENTS' && line.selectedComponentIds.length === 0) {
+          return [];
+        }
         const discount = (line.amountSign ?? 1) < 0;
         const percentage = line.calculation === 'PERCENTAGE';
         const mode: AdminStructuredAdjustment['mode'] = percentage
           ? discount ? 'PERCENTAGE_DISCOUNT' : 'PERCENTAGE_SURCHARGE'
           : 'FIXED_AMOUNT';
         return [{
-          adjustmentId: line.id,
+          adjustmentId: line.replacementAdjustmentId ?? line.id,
           mode,
           ...(percentage
             ? { percentageBasisPoints: Math.round(value * 100) }
             : { fixedAmount: roundMoney((discount ? -1 : 1) * value) }),
           scope: line.scope,
+          selectedComponentIds:
+            line.scope === 'SELECTED_COMPONENTS' ? line.selectedComponentIds : [],
           taxBehavior: line.taxBehavior,
           reasonCode: line.reasonCode.trim() || 'STAFF_ADJUSTMENT',
           reason: line.label.trim() || null,
@@ -209,12 +236,15 @@ export function useAdminProviderPricingAdjustments({
     [providerAdditionalAdjustments],
   );
 
-  const hasEffectiveChangeSelection =
-    hasChangeSelection ||
-    providerPricingOverrides.length > 0 ||
-    providerHasAdditionalAdjustments ||
-    (isProviderDashboardChange && Math.abs(editableSummaryPreSubtotalDelta) >= 0.005) ||
-    Math.abs(adminCustomAdjustmentTotal) >= 0.005;
+  const hasEffectiveChangeSelection = hasEffectiveAdminChangeSelection({
+    hasChangeSelection,
+    providerPricingOverrideCount: providerPricingOverrides.length,
+    providerHasAdditionalAdjustments,
+    isProviderDashboardChange,
+    editableSummaryPreSubtotalDelta,
+    adminStructuredAdjustmentCount: adminStructuredAdjustments.length,
+    adminReverseAdjustmentCount: adminReverseAdjustmentIds.length,
+  });
 
   return {
     providerTotalsPreview,
@@ -223,5 +253,6 @@ export function useAdminProviderPricingAdjustments({
     adminCustomLinesAsAdditionalAdjustments,
     mergedProviderAdditionalAdjustments,
     adminStructuredAdjustments,
+    adminReverseAdjustmentIds,
   };
 }

package/src/components/booking/useBookingAvailabilityAddOns.ts

@@ -16,6 +16,7 @@ export interface UseBookingAvailabilityAddOnsResult {
   addOns: AddOn[];
   setAddOns: Dispatch<SetStateAction<AddOn[]>>;
   availabilityProductOptionId: string | null;
+  loadedProductOptionId: string | null;
 }
 
 export function useBookingAvailabilityAddOns({
@@ -24,6 +25,7 @@ export function useBookingAvailabilityAddOns({
   onProductOptionChange,
 }: UseBookingAvailabilityAddOnsParams): UseBookingAvailabilityAddOnsResult {
   const [addOns, setAddOns] = useState<AddOn[]>([]);
+  const [loadedProductOptionId, setLoadedProductOptionId] = useState<string | null>(null);
   const previousAvailabilityProductOptionIdRef = useRef<string | null>(null);
   const availabilityProductOptionId = useMemo(
     () => (selectedAvailability ? getAvailabilityOptionId(selectedAvailability) || null : null),
@@ -32,8 +34,10 @@ export function useBookingAvailabilityAddOns({
   const availabilityDateTime = selectedAvailability?.dateTime?.trim() || null;
 
   useEffect(() => {
+    let cancelled = false;
     if (!availabilityProductOptionId || !companyId) {
       setAddOns([]);
+      setLoadedProductOptionId(null);
       onProductOptionChange?.();
       return;
     }
@@ -42,18 +46,31 @@ export function useBookingAvailabilityAddOns({
       onProductOptionChange?.();
       previousAvailabilityProductOptionIdRef.current = availabilityProductOptionId;
     }
+    setLoadedProductOptionId(null);
     getAddOns(companyId, {
       productOptionId: availabilityProductOptionId,
       preCheckout: true,
       dateTime: availabilityDateTime ?? undefined,
     })
-      .then(setAddOns)
-      .catch(() => setAddOns([]));
+      .then((rows) => {
+        if (cancelled) return;
+        setAddOns(rows);
+        setLoadedProductOptionId(availabilityProductOptionId);
+      })
+      .catch(() => {
+        if (cancelled) return;
+        setAddOns([]);
+        setLoadedProductOptionId(availabilityProductOptionId);
+      });
+    return () => {
+      cancelled = true;
+    };
   }, [availabilityProductOptionId, availabilityDateTime, companyId, onProductOptionChange]);
 
   return {
     addOns,
     setAddOns,
     availabilityProductOptionId,
+    loadedProductOptionId,
   };
 }

package/src/components/booking/useChangeBookingAddOnFloorController.ts

@@ -13,7 +13,7 @@ interface UseChangeBookingAddOnFloorControllerOptions {
   initialValues?: ChangeBookingFlowProps['initialValues'];
   originalReceiptLineItems?: NonNullable<ChangeBookingFlowProps['originalReceipt']>['lineItems'];
   addOns: AddOn[];
-  isCustomerSelfServeChange: boolean;
+  lockExistingAddOnQuantities: boolean;
   setAddOnSelections: Dispatch<SetStateAction<AddOnSelection[]>>;
 }
 
@@ -21,9 +21,10 @@ export function useChangeBookingAddOnFloorController({
   initialValues,
   originalReceiptLineItems,
   addOns,
-  isCustomerSelfServeChange,
+  lockExistingAddOnQuantities,
   setAddOnSelections,
 }: UseChangeBookingAddOnFloorControllerOptions): {
+  initialAddOnQtyByKey: Map<string, number>;
   initialAddOnMinQtyByKey: Map<string, number>;
   initialAddOnMinTotalByAddOnId: Map<string, number>;
   updateAddOnSelections: (updater: AddOnSelectionsUpdater) => void;
@@ -39,29 +40,33 @@ export function useChangeBookingAddOnFloorController({
     return [] as AddOnSelection[];
   }, [initialValues?.addOnSelections, originalReceiptLineItems, addOns]);
 
-  const initialAddOnMinQtyByKey = useMemo(() => {
+  const initialAddOnQtyByKey = useMemo(() => {
     const map = new Map<string, number>();
-    if (!isCustomerSelfServeChange) return map;
     for (const sel of initialAddOnBaselineSelections) {
       const key = `${sel.addOnId.trim()}::${sel.variantId?.trim() || ''}`;
       map.set(key, (map.get(key) ?? 0) + Math.max(1, Number(sel.quantity) || 1));
     }
     return map;
-  }, [isCustomerSelfServeChange, initialAddOnBaselineSelections]);
+  }, [initialAddOnBaselineSelections]);
+
+  const initialAddOnMinQtyByKey = useMemo(
+    () => (lockExistingAddOnQuantities ? initialAddOnQtyByKey : new Map<string, number>()),
+    [lockExistingAddOnQuantities, initialAddOnQtyByKey]
+  );
 
   const initialAddOnMinTotalByAddOnId = useMemo(() => {
     const map = new Map<string, number>();
-    if (!isCustomerSelfServeChange) return map;
+    if (!lockExistingAddOnQuantities) return map;
     for (const sel of initialAddOnBaselineSelections) {
       const addOnId = sel.addOnId.trim();
       map.set(addOnId, (map.get(addOnId) ?? 0) + Math.max(1, Number(sel.quantity) || 1));
     }
     return map;
-  }, [isCustomerSelfServeChange, initialAddOnBaselineSelections]);
+  }, [lockExistingAddOnQuantities, initialAddOnBaselineSelections]);
 
   const applyChangeFlowAddOnFloor = useCallback(
     (nextSelections: AddOnSelection[]) => {
-      if (!isCustomerSelfServeChange || initialAddOnMinQtyByKey.size === 0) return nextSelections;
+      if (!lockExistingAddOnQuantities || initialAddOnMinQtyByKey.size === 0) return nextSelections;
       const qtyByKey = new Map<string, number>();
       for (const sel of nextSelections) {
         const key = `${sel.addOnId.trim()}::${sel.variantId?.trim() || ''}`;
@@ -88,7 +93,7 @@ export function useChangeBookingAddOnFloorController({
         return { addOnId, variantId, quantity: qty };
       });
     },
-    [isCustomerSelfServeChange, initialAddOnMinQtyByKey, initialAddOnMinTotalByAddOnId]
+    [lockExistingAddOnQuantities, initialAddOnMinQtyByKey, initialAddOnMinTotalByAddOnId]
   );
 
   const updateAddOnSelections = useCallback(
@@ -102,6 +107,7 @@ export function useChangeBookingAddOnFloorController({
   );
 
   return {
+    initialAddOnQtyByKey,
     initialAddOnMinQtyByKey,
     initialAddOnMinTotalByAddOnId,
     updateAddOnSelections,

package/src/components/booking/useChangeBookingInitialHydration.ts

@@ -6,6 +6,7 @@ import type { AddOn, Availability, PrecomputedPricesByCategory } from '../../lib
 import type { Currency } from './CurrencySwitcher';
 import type { ChangeBookingFlowProps } from './booking-flow-types';
 import {
+  deriveCompatibleInitialBookingQuantities,
   deriveAddOnSelectionsFromReceiptLines,
   normalizeAddOnSelections,
   parseAvailabilityDateTime,
@@ -23,6 +24,7 @@ export interface UseChangeBookingInitialHydrationOptions {
   timesForSelectedDate: Availability[];
   companyTimezone: string;
   changeFlowResolvedInitialProductOptionId: string | null;
+  mostPopularProductOptionId: string | null;
   precomputedPricesByOption: Record<string, PrecomputedPricesByCategory> | null | undefined;
   currency: Currency;
   originalReceiptSubtotal?: number | null;
@@ -53,6 +55,7 @@ export function useChangeBookingInitialHydration({
   timesForSelectedDate,
   companyTimezone,
   changeFlowResolvedInitialProductOptionId,
+  mostPopularProductOptionId,
   precomputedPricesByOption,
   currency,
   originalReceiptSubtotal,
@@ -130,6 +133,7 @@ export function useChangeBookingInitialHydration({
       precomputedPricesByOption,
       currency,
       originalReceiptSubtotal ?? undefined,
+      mostPopularProductOptionId,
     );
     if (defer) return;
     if (selection) {
@@ -142,6 +146,7 @@ export function useChangeBookingInitialHydration({
     initialValues?.productOptionId,
     initialValues?.bookingItems,
     changeFlowResolvedInitialProductOptionId,
+    mostPopularProductOptionId,
     selectedAvailability,
     selectedDate,
     timesForSelectedDate,
@@ -163,15 +168,13 @@ export function useChangeBookingInitialHydration({
     ) {
       return;
     }
-    const next: Record<string, number> = {};
-    for (const item of initialValues.bookingItems) {
-      const key = item.category?.trim();
-      if (!key) continue;
-      next[key] = Math.max(0, Number(item.count) || 0);
-    }
+    const next = deriveCompatibleInitialBookingQuantities(
+      initialValues.bookingItems,
+      selectedAvailability,
+    );
+    hasAppliedInitialQuantitiesRef.current = true;
     if (Object.keys(next).length > 0) {
       setQuantities((prev) => ({ ...prev, ...next }));
-      hasAppliedInitialQuantitiesRef.current = true;
     }
   }, [initialValues, selectedAvailability, setQuantities]);
 

package/src/components/booking/useChangeBookingQuotePreview.ts

@@ -24,6 +24,7 @@ import {
   formatTicketLineItemsForSummary,
   getAvailabilityOptionId,
 } from './change-booking-flow-helpers';
+import { friendlyChangeBookingError } from './change-booking-error-message';
 import type { Currency } from './CurrencySwitcher';
 
 type AddOnSelection = { addOnId: string; variantId?: string; quantity?: number };
@@ -197,11 +198,12 @@ export function useChangeBookingQuotePreview({
       : 'Change booking (no charge)';
   })();
 
-  const checkoutFormError =
+  const rawCheckoutFormError =
     (error || '') ||
     (missingRequiredReturnSelection ? 'Removing return option in self-serve is not available. Please contact support.' : '') ||
     (isChangeQuoteBlocked ? (latestChangeQuote?.reasonIfBlocked ?? '') : '') ||
     (changeQuoteFetchError ?? '');
+  const checkoutFormError = friendlyChangeBookingError(rawCheckoutFormError);
 
   const changeFlowSelectionPreview = useMemo((): ChangeFlowSelectionPreview | null => {
     if (!selectedAvailability || totalQuantity <= 0) return null;

package/src/components/booking/useChangeBookingSelectionDetails.ts

@@ -30,7 +30,7 @@ export interface UseChangeBookingSelectionDetailsParams {
   pickupLocationId: string | null;
   quantities: Record<string, number>;
   addOnSelections: AddOnSelection[];
-  initialAddOnMinQtyByKey: Map<string, number>;
+  initialAddOnQtyByKey: Map<string, number>;
   changeFlowResolvedInitialProductOptionId: string | null;
   productChanged?: boolean;
 }
@@ -65,6 +65,25 @@ function normalizeCounts(items: Array<{ category: string; count: number }> | nul
   return map;
 }
 
+export function haveAddOnSelectionsChanged(
+  initialAddOnQtyByKey: Map<string, number>,
+  addOnSelections: AddOnSelection[],
+): boolean {
+  const currentAddOnQtyByKey = new Map<string, number>();
+  for (const sel of addOnSelections) {
+    const key = `${sel.addOnId.trim()}::${sel.variantId?.trim() || ''}`;
+    currentAddOnQtyByKey.set(key, (currentAddOnQtyByKey.get(key) ?? 0) + Math.max(1, Number(sel.quantity) || 1));
+  }
+
+  const allAddOnKeys = new Set([...initialAddOnQtyByKey.keys(), ...currentAddOnQtyByKey.keys()]);
+  for (const key of allAddOnKeys) {
+    if ((initialAddOnQtyByKey.get(key) ?? 0) !== (currentAddOnQtyByKey.get(key) ?? 0)) {
+      return true;
+    }
+  }
+  return false;
+}
+
 export function useChangeBookingSelectionDetails({
   initialValues,
   selectedAvailability,
@@ -73,7 +92,7 @@ export function useChangeBookingSelectionDetails({
   pickupLocationId,
   quantities,
   addOnSelections,
-  initialAddOnMinQtyByKey,
+  initialAddOnQtyByKey,
   changeFlowResolvedInitialProductOptionId,
   productChanged = false,
 }: UseChangeBookingSelectionDetailsParams): ChangeBookingSelectionDetails {
@@ -115,20 +134,7 @@ export function useChangeBookingSelectionDetails({
       }
     }
 
-    const currentAddOnQtyByKey = new Map<string, number>();
-    for (const sel of addOnSelections) {
-      const key = `${sel.addOnId.trim()}::${sel.variantId?.trim() || ''}`;
-      currentAddOnQtyByKey.set(key, (currentAddOnQtyByKey.get(key) ?? 0) + Math.max(1, Number(sel.quantity) || 1));
-    }
-
-    const allAddOnKeys = new Set([...initialAddOnMinQtyByKey.keys(), ...currentAddOnQtyByKey.keys()]);
-    let addOnsChanged = false;
-    for (const key of allAddOnKeys) {
-      if ((initialAddOnMinQtyByKey.get(key) ?? 0) !== (currentAddOnQtyByKey.get(key) ?? 0)) {
-        addOnsChanged = true;
-        break;
-      }
-    }
+    const addOnsChanged = haveAddOnSelectionsChanged(initialAddOnQtyByKey, addOnSelections);
 
     const hasReturnOptions = (selectedAvailability?.returnOptions?.length ?? 0) > 0;
     const initialReturnId = initialValues.returnAvailabilityId?.trim() || null;
@@ -193,7 +199,7 @@ export function useChangeBookingSelectionDetails({
     pickupLocationId,
     quantities,
     addOnSelections,
-    initialAddOnMinQtyByKey,
+    initialAddOnQtyByKey,
     changeFlowResolvedInitialProductOptionId,
     productChanged,
   ]);

package/src/lib/booking/change-booking-server-preview.ts

@@ -27,6 +27,8 @@ export interface ChangeBookingServerPreview {
   completeness: ChangeBookingPreviewCompleteness;
   /** Rows for {@link PriceSummary} / checkout — from quote receipt line items + BE extensions. */
   priceSummaryLines: PriceSummaryLine[];
+  /** Full resulting receipt rows, when the amendment quote supplies them. */
+  resultingReceiptLines?: PriceSummaryLine[];
   /** From quote — per-category unit prices (major units) for ticket picker when BE sends them. */
   ticketUnitPriceByCategory?: Record<string, number>;
   cancellationPolicyFeeByPolicyId?: Record<string, number>;
@@ -260,28 +262,36 @@ export function labelAdminAmendmentPriceSummaryLines(
   operations: readonly AdminAmendmentOperationSnapshot[],
   originalLines: readonly PriceSummaryLine[] = [],
 ): PriceSummaryLine[] {
-  const movedServiceOperationIds = new Set(
+  const movedServiceOperations = new Map(
     operations
       .filter((operation) => operation.type.trim().toUpperCase() === 'MOVE_SERVICE')
-      .map((operation) => operation.operationId),
+      .map((operation) => [operation.operationId, operation] as const),
   );
-  if (movedServiceOperationIds.size === 0) return lines;
+  if (movedServiceOperations.size === 0) return lines;
 
   const normalizedTicketCategory = (category: string) => category
     .replace(/^refund\s*[·:-]\s*/i, '')
-    .replace(/\s*[—-]\s*new date price difference\s*$/i, '')
+    .replace(/\s*[—-]\s*(?:new date|tour) price difference\s*$/i, '')
     .trim()
     .toUpperCase();
 
   return lines.map((line) => {
+    const moveOperation = line.kind === 'ticket' && line.operationId
+      ? movedServiceOperations.get(line.operationId)
+      : undefined;
     if (
       line.kind !== 'ticket' ||
-      !line.operationId ||
-      !movedServiceOperationIds.has(line.operationId) ||
-      line.category.toLowerCase().includes('new date price difference')
+      !moveOperation ||
+      /(?:new date|tour) price difference/i.test(line.category)
     ) {
       return line;
     }
+    const changesTour = moveOperation.changedFields?.some(
+      (field) => field.trim().toLowerCase() === 'productid',
+    ) ?? false;
+    const priceDifferenceLabel = changesTour
+      ? 'tour price difference'
+      : 'new date price difference';
     const originalLine = originalLines.find(
       (candidate) => candidate.kind === 'ticket' &&
         normalizedTicketCategory(candidate.category) === normalizedTicketCategory(line.category),
@@ -295,12 +305,14 @@ export function labelAdminAmendmentPriceSummaryLines(
     const ticketLabel = normalizedTicketCategory(line.category).toLowerCase();
     return {
       ...line,
-      category: `${line.category} — new date price difference`,
+      category: `${line.category} — ${priceDifferenceLabel}`,
       ...(previousUnitAmount != null && differenceUnitAmount != null
         ? {
             unitPriceComparison: {
               previousLabel: `Existing ${ticketLabel} price`,
-              updatedLabel: `New-date ${ticketLabel} price`,
+              updatedLabel: changesTour
+                ? `New-tour ${ticketLabel} price`
+                : `New-date ${ticketLabel} price`,
               differenceLabel: `Difference per ${ticketLabel}`,
               previousUnitAmount,
               updatedUnitAmount: roundMoney(previousUnitAmount + differenceUnitAmount),
@@ -354,6 +366,10 @@ export function buildChangeBookingServerPreview(
     ),
     paymentCreditTotal,
   );
+  const resultingReceiptLines = pricingQuote?.amendment?.updatedReceipt?.lineItems;
+  const resultingReceiptPriceSummaryLines = resultingReceiptLines?.length
+    ? mapQuoteLineItemsToPriceSummaryLines(resultingReceiptLines)
+    : undefined;
 
   const completeness: ChangeBookingPreviewCompleteness = priceSummaryLines.length > 0 ? 'full' : 'totals_only';
 
@@ -365,6 +381,7 @@ export function buildChangeBookingServerPreview(
     totalNewBooking: totals.total,
     completeness,
     priceSummaryLines,
+    resultingReceiptLines: resultingReceiptPriceSummaryLines,
     ticketUnitPriceByCategory: quote.ticketUnitPriceByCategory,
     cancellationPolicyFeeByPolicyId: quote.cancellationPolicyFeeByPolicyId,
     returnOptionPriceByReturnAvailabilityId: quote.returnOptionPriceByReturnAvailabilityId,

package/src/lib/booking/change-flow-pricing.ts

@@ -255,6 +255,12 @@ export interface ChangeQuoteUiSlice {
   quoteExpiresAt?: string;
   pricingVersion?: string;
   quotedTotal?: number;
+  /** Settled cash after completed refunds, calculated by the backend from payment records. */
+  amountPreviouslyPaid?: number;
+  /** Non-cash value allocated before and after this amendment. */
+  currentPaymentCreditTotal?: number;
+  projectedPaymentCreditTotal?: number;
+  refundCandidate?: number;
   paymentCreditTotal?: number;
   refundDecisionOperations?: ChangeBookingQuoteResponse['refundDecisionOperations'];
   returnPriceTreatmentOperations?: ChangeBookingQuoteResponse['returnPriceTreatmentOperations'];
@@ -296,6 +302,12 @@ export function sliceChangeQuoteForUi(
     quoteExpiresAt: pricingQuote?.expiresAt ?? quote.expiresAt,
     pricingVersion: pricingQuote?.pricingVersion ?? undefined,
     quotedTotal: pricingQuote?.payableTotal ?? pricingQuote?.totalAmount ?? quote.proposed?.total ?? quote.newReceipt?.total,
+    amountPreviouslyPaid:
+      pricingQuote?.amountPreviouslyPaid ?? quote.amountPreviouslyPaid ?? undefined,
+    currentPaymentCreditTotal: quote.originalReceipt?.paymentCreditTotal ?? 0,
+    projectedPaymentCreditTotal:
+      pricingQuote?.paymentCreditTotal ?? quote.paymentCreditTotal ?? 0,
+    refundCandidate: quote.refundCandidate ?? pricingQuote?.refundCandidate ?? 0,
     paymentCreditTotal: pricingQuote?.paymentCreditTotal ?? quote.paymentCreditTotal,
     refundDecisionOperations: quote.refundDecisionOperations,
     returnPriceTreatmentOperations: quote.returnPriceTreatmentOperations,

package/src/lib/booking/i18n/messages/en.json

@@ -119,6 +119,7 @@
     "rounding": "Rounding",
     "deposit": "Deposit",
     "totalOwedForBookingChange": "Total owed for booking difference",
+    "changeToBookingTotal": "Change to booking total",
     "subtotal": "Subtotal",
     "tax": "Taxes and fees",
     "returnOption": "Return Option",

package/src/lib/booking/i18n/messages/fr.json

@@ -119,6 +119,7 @@
     "rounding": "Arrondi",
     "deposit": "Acompte",
     "totalOwedForBookingChange": "Montant dû pour le changement de réservation",
+    "changeToBookingTotal": "Modification du total de la réservation",
     "subtotal": "Sous-total",
     "tax": "Taxes et frais",
     "returnOption": "Option de retour",