@ticketboothapp/booking 1.2.76 → 1.2.77

package/CHANGE_BOOKING_BE_HANDOFF.md

@@ -100,3 +100,39 @@ Pickers show **catalog** prices by default (same booking **currency** as the ori
 - **Provider change API:** When `pricingAdjustment.additionalAdjustments` includes the same rows, persist them on the new receipt and charge the **same** total as `newTotalAmount` (within your rounding rules).
 
 If the server ignores `manualLineAdjustments` or `additionalAdjustments`, the customer will see the FE total but pay a different amount.
+
+---
+
+## Admin FE-authoritative quote path (new)
+
+For provider dashboard / admin tooling, we need a dedicated quote route where the **frontend is authoritative** for
+the full receipt preview (totals + line items), and BE does not re-price those values.
+
+### Endpoint
+
+- **`POST /1/admin/bookings/:bookingReference/change/quote?lastName=...`**
+
+Keep the public self-serve endpoint unchanged.
+
+### Request contract (admin)
+
+Same selection fields as `ChangeBookingQuoteRequest`, plus:
+
+- `feReceipt`:
+  - `subtotal` (major units)
+  - `tax` (major units)
+  - `total` (major units)
+  - `currency?`
+  - `lineItems: Array<{ label?: string; amount?: number; type?: string; quantity?: number }>`
+- `feAmountDueMajorUnits?` (optional signed delta the FE displays; `newTotal - previousTotal`)
+
+### Backend expectations
+
+- Validate admin auth + booking/availability eligibility only.
+- Persist `feReceipt` on the change intent as the quote source-of-truth.
+- Return a `ChangeBookingQuoteResponse`-compatible payload using the stored FE receipt:
+  - `newReceipt` / `proposed` line items from `feReceipt.lineItems`
+  - `newReceipt.subtotal/tax/total` from `feReceipt`
+  - `amountDueCents` / `balanceDeltaMajorUnits` / `priceDiff` coherent with stored totals
+  - `changeIntentId`, `canProceed`, `reasonIfBlocked`
+- Payment intent + apply/confirm for this change intent must use persisted FE totals/lines (no repricing).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ticketboothapp/booking",
-  "version": "1.2.76",
+  "version": "1.2.77",
   "private": false,
   "sideEffects": [
     "**/*.css",

package/src/components/booking/AdminChangeBookingFlow.tsx

@@ -9,6 +9,7 @@ import {
   cancelReservationBestEffort,
   createPaymentIntent,
   quoteChangeBooking,
+  quoteChangeBookingAdminFeReceipt,
   confirmFreeChangeBooking,
   createChangeBookingPaymentIntent,
   confirmBookingWithoutPayment,
@@ -25,6 +26,7 @@ import {
   isInsufficientCapacityReserveError,
   describeStandardTourCapacityConflictMessage,
   reportReserveCapacityConflictClientContext,
+  type AdminFeAuthoritativeReceipt,
 } from '../../lib/booking-api';
 import {
   EARLIEST_AVAILABILITY_DATE,
@@ -148,6 +150,26 @@ function omitZeroAmountPromoDiscountSummaryLines(lines: PriceSummaryLine[]): Pri
   });
 }
 
+function mapSummaryLinesToFeReceiptLineItems(lines: PriceSummaryLine[]): NonNullable<AdminFeAuthoritativeReceipt['lineItems']> {
+  return lines.map((line) => {
+    if (line.kind === 'ticket') {
+      return {
+        label: line.category,
+        amount: roundMoney(line.itemTotal),
+        type: 'TICKET',
+        quantity: line.qty,
+      };
+    }
+    const normalizedType = String(line.type ?? '').trim().toUpperCase();
+    return {
+      label: line.label,
+      amount: roundMoney(line.amount),
+      type: normalizedType || undefined,
+      quantity: line.quantity ?? undefined,
+    };
+  });
+}
+
 function formatTicketLineItemsForSummary(lines: Array<{ category: string; qty: number }>): string {
   const labels: Record<string, string> = {
     ADULT: 'adult',
@@ -733,6 +755,8 @@ export function AdminChangeBookingFlow({
   const [adminCustomReceiptLines, setAdminCustomReceiptLines] = useState<
     Array<{ id: string; label: string; amountInput: string; amountSign: 1 | -1 }>
   >([]);
+  const [editableSummaryLineAmountInputs, setEditableSummaryLineAmountInputs] = useState<Record<string, string>>({});
+  const [editableSummaryLineLabelInputs, setEditableSummaryLineLabelInputs] = useState<Record<string, string>>({});
   const adminCustomLineIdRef = useRef(0);
 
   // Auto-apply promo code when parent page passes one (e.g. partner pages).
@@ -831,6 +855,10 @@ export function AdminChangeBookingFlow({
     }
   }, [initialValues?.dateTime, companyTimezone]);
   const isProviderDashboardChange = Boolean(onChangeBooking);
+  const useAdminFeAuthoritativeQuote =
+    isAdmin &&
+    isProviderDashboardChange &&
+    Boolean(flowUi?.adminFeAuthoritativeQuoteEnabled);
   /** Any change from an existing booking (public or provider). */
   const isChangeBookingContext = Boolean(initialValues?.bookingReference?.trim());
   /**
@@ -3120,6 +3148,140 @@ export function AdminChangeBookingFlow({
       ),
     [checkoutPriceSummaryLinesForCheckout],
   );
+  const getEditableSummaryLineKey = useCallback((line: PriceSummaryLine, index: number): string => {
+    if (line.lineKey) return line.lineKey;
+    return line.kind === 'ticket'
+      ? `change-ticket-${line.category}-${index}`
+      : `change-line-${line.label}-${line.type ?? 'line'}-${index}`;
+  }, []);
+  const editableCheckoutPriceSummaryLines = useMemo((): PriceSummaryLine[] => {
+    const firstTaxLineIndex = checkoutPriceSummaryLinesForCheckout.findIndex(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX'
+    );
+    return checkoutPriceSummaryLinesForCheckout.map((line, index) => {
+      const isBeforeSubtotal = firstTaxLineIndex < 0 || index < firstTaxLineIndex;
+      const lineKey = getEditableSummaryLineKey(line, index);
+      if (line.kind === 'ticket') {
+        const amountInput = editableSummaryLineAmountInputs[lineKey];
+        const parsedAmount = amountInput == null || amountInput.trim() === '' ? line.itemTotal : Number(amountInput);
+        return {
+          ...line,
+          lineKey,
+          editable: isBeforeSubtotal,
+          category: editableSummaryLineLabelInputs[lineKey] ?? line.category,
+          itemTotal: Number.isFinite(parsedAmount) ? roundMoney(parsedAmount) : line.itemTotal,
+        };
+      }
+      const amountInput = editableSummaryLineAmountInputs[lineKey];
+      const parsedAmount = amountInput == null || amountInput.trim() === '' ? line.amount : Number(amountInput);
+      return {
+        ...line,
+        lineKey,
+        editable: isBeforeSubtotal,
+        label: editableSummaryLineLabelInputs[lineKey] ?? line.label,
+        amount: Number.isFinite(parsedAmount) ? roundMoney(parsedAmount) : line.amount,
+      };
+    });
+  }, [
+    checkoutPriceSummaryLinesForCheckout,
+    editableSummaryLineAmountInputs,
+    editableSummaryLineLabelInputs,
+    getEditableSummaryLineKey,
+  ]);
+  useEffect(() => {
+    setEditableSummaryLineAmountInputs((prev) => {
+      const next: Record<string, string> = {};
+      for (let i = 0; i < editableCheckoutPriceSummaryLines.length; i += 1) {
+        const line = editableCheckoutPriceSummaryLines[i];
+        const key = line.lineKey;
+        if (!key) continue;
+        if (prev[key] != null) {
+          next[key] = prev[key];
+          continue;
+        }
+        next[key] = line.kind === 'ticket' ? String(line.itemTotal) : String(line.amount);
+      }
+      const prevKeys = Object.keys(prev);
+      const nextKeys = Object.keys(next);
+      if (
+        prevKeys.length === nextKeys.length &&
+        nextKeys.every((key) => prev[key] === next[key])
+      ) {
+        return prev;
+      }
+      return next;
+    });
+    setEditableSummaryLineLabelInputs((prev) => {
+      const next: Record<string, string> = {};
+      for (let i = 0; i < editableCheckoutPriceSummaryLines.length; i += 1) {
+        const line = editableCheckoutPriceSummaryLines[i];
+        const key = line.lineKey;
+        if (!key) continue;
+        if (prev[key] != null) {
+          next[key] = prev[key];
+          continue;
+        }
+        next[key] = line.kind === 'ticket' ? line.category : line.label;
+      }
+      const prevKeys = Object.keys(prev);
+      const nextKeys = Object.keys(next);
+      if (
+        prevKeys.length === nextKeys.length &&
+        nextKeys.every((key) => prev[key] === next[key])
+      ) {
+        return prev;
+      }
+      return next;
+    });
+  }, [editableCheckoutPriceSummaryLines]);
+  const editableSummaryPreSubtotalDelta = useMemo(() => {
+    const firstTaxLineIndex = checkoutPriceSummaryLinesForCheckout.findIndex(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX'
+    );
+    let delta = 0;
+    for (let i = 0; i < checkoutPriceSummaryLinesForCheckout.length; i += 1) {
+      if (firstTaxLineIndex >= 0 && i >= firstTaxLineIndex) break;
+      const line = checkoutPriceSummaryLinesForCheckout[i];
+      const lineKey = getEditableSummaryLineKey(line, i);
+      const baselineAmount = line.kind === 'ticket' ? line.itemTotal : line.amount;
+      const raw = editableSummaryLineAmountInputs[lineKey];
+      const parsed = raw == null || raw.trim() === '' ? baselineAmount : Number(raw);
+      const editedAmount = Number.isFinite(parsed) ? roundMoney(parsed) : baselineAmount;
+      delta += editedAmount - baselineAmount;
+    }
+    return roundMoney(delta);
+  }, [
+    checkoutPriceSummaryLinesForCheckout,
+    editableSummaryLineAmountInputs,
+    getEditableSummaryLineKey,
+  ]);
+  const editableSummaryPreSubtotalDebugRows = useMemo(() => {
+    const firstTaxLineIndex = checkoutPriceSummaryLinesForCheckout.findIndex(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX'
+    );
+    const rows: Array<{ label: string; baseline: number; edited: number; delta: number }> = [];
+    for (let i = 0; i < checkoutPriceSummaryLinesForCheckout.length; i += 1) {
+      if (firstTaxLineIndex >= 0 && i >= firstTaxLineIndex) break;
+      const line = checkoutPriceSummaryLinesForCheckout[i];
+      const lineKey = getEditableSummaryLineKey(line, i);
+      const baselineAmount = line.kind === 'ticket' ? line.itemTotal : line.amount;
+      const raw = editableSummaryLineAmountInputs[lineKey];
+      const parsed = raw == null || raw.trim() === '' ? baselineAmount : Number(raw);
+      const editedAmount = Number.isFinite(parsed) ? roundMoney(parsed) : baselineAmount;
+      const delta = roundMoney(editedAmount - baselineAmount);
+      rows.push({
+        label: line.kind === 'ticket' ? line.category : line.label,
+        baseline: roundMoney(baselineAmount),
+        edited: editedAmount,
+        delta,
+      });
+    }
+    return rows;
+  }, [
+    checkoutPriceSummaryLinesForCheckout,
+    editableSummaryLineAmountInputs,
+    getEditableSummaryLineKey,
+  ]);
 
   // Promo discount from backend (order-level only; rates are pre-promo)
   const [promoDiscountAmount, setPromoDiscountAmount] = useState(0);
@@ -3741,8 +3903,46 @@ export function AdminChangeBookingFlow({
       ? displayedChangeAmountsRaw.total + adminCustomAdjustmentTotal + adminTaxDeltaForExternalDisplay
       : displayedChangeAmountsRaw.total
   );
+  const displayChangeFlowProposedTotalWithEditableLines = roundMoney(
+    displayChangeFlowProposedTotal + editableSummaryPreSubtotalDelta
+  );
+  const adminFeAuthoritativeReceipt = useMemo((): AdminFeAuthoritativeReceipt => {
+    const hasTaxLine = editableCheckoutPriceSummaryLines.some(
+      (line) => line.kind === 'line' && String(line.type ?? '').toUpperCase() === 'TAX'
+    );
+    const lineItems = mapSummaryLinesToFeReceiptLineItems(editableCheckoutPriceSummaryLines);
+    if (!hasTaxLine && Math.abs(displayChangeFlowTax) >= 0.0005) {
+      lineItems.push({
+        label: t('booking.tax') !== 'booking.tax' ? t('booking.tax') : 'Taxes and fees',
+        amount: roundMoney(displayChangeFlowTax),
+        type: 'TAX',
+      });
+    }
+    let subtotal = roundMoney(displayChangeFlowSubtotal + editableSummaryPreSubtotalDelta);
+    const tax = roundMoney(displayChangeFlowTax);
+    const expectedTotal = roundMoney(displayChangeFlowProposedTotalWithEditableLines);
+    const recomputed = roundMoney(subtotal + tax);
+    if (Math.abs(recomputed - expectedTotal) >= 0.005) {
+      subtotal = roundMoney(expectedTotal - tax);
+    }
+    return {
+      subtotal,
+      tax,
+      total: expectedTotal,
+      currency,
+      lineItems,
+    };
+  }, [
+    editableCheckoutPriceSummaryLines,
+    displayChangeFlowTax,
+    displayChangeFlowSubtotal,
+    editableSummaryPreSubtotalDelta,
+    displayChangeFlowProposedTotalWithEditableLines,
+    currency,
+    t,
+  ]);
 
-  const changeFlowClientEstimateDue = (() => {
+  const changeFlowClientEstimateDueBase = (() => {
     if (!originalReceipt) return totalPrice;
     // Self-serve quote: match BE receipt / intent: (newTotalCents − previousTotalCents) / 100.
     if (isCustomerSelfServeChange && latestChangeQuote != null && !changeQuoteFetchError) {
@@ -3764,6 +3964,9 @@ export function AdminChangeBookingFlow({
       audience: 'admin',
     });
   })();
+  const changeFlowClientEstimateDue = normalizeNearZeroOwed(
+    roundMoney(changeFlowClientEstimateDueBase + editableSummaryPreSubtotalDelta)
+  );
 
   const changeFlowAmountDueRaw = changeFlowClientEstimateDue;
   const changeFlowAmountDue = normalizeNearZeroOwed(changeFlowAmountDueRaw);
@@ -3797,18 +4000,33 @@ export function AdminChangeBookingFlow({
         <pre className="mt-2 max-h-64 overflow-auto whitespace-pre-wrap break-words font-mono text-[11px] leading-relaxed text-stone-800">
           {[
             `Amount-due path: ${path}`,
+            `adminFeAuthoritativeQuoteEnabled: ${String(useAdminFeAuthoritativeQuote)}`,
             `displayLayerUsesExternalPricing: ${String(displayLayerUsesExternalPricing)} (server/provider totals omit FE admin lines until overlaid)`,
             `selfServePricingConfirmed: ${String(selfServePricingConfirmed)} · changeQuoteLoading: ${String(changeQuoteLoading)}`,
             `Cart subtotal (excl. admin custom lines): ${fmt(effectiveSubtotal)}`,
             `Admin custom lines (sum): ${fmt(adminCustomAdjustmentTotal)}`,
+            `Pre-subtotal line overrides:`,
+            ...editableSummaryPreSubtotalDebugRows.map(
+              (row, idx) =>
+                `  ${idx + 1}. ${row.label} | baseline ${fmt(row.baseline)} -> edited ${fmt(row.edited)} (delta ${fmt(row.delta)})`
+            ),
             `Checkout subtotal (incl. admin lines): ${fmt(effectiveSubtotalForCheckout)}`,
             `effectiveTax · promo discount: ${fmt(effectiveTax)} · ${fmt(effectivePromoDiscountAmount)}`,
             `totalPrice (subtotal + tax − promo): ${fmt(totalPrice)}`,
             `changeFlowNewBookingTotal (after cent reconcile vs receipt): ${fmt(changeFlowNewBookingTotal)}`,
             `Displayed layer subtotal / tax / total: ${fmt(displayedChangeAmountsRaw.subtotal)} / ${fmt(displayedChangeAmountsRaw.tax)} / ${fmt(displayedChangeAmountsRaw.total)}`,
-            `displayChangeFlowProposedTotal (summary / preview footer): ${fmt(displayChangeFlowProposedTotal)}`,
+            `Pre-subtotal editable lines delta: ${fmt(editableSummaryPreSubtotalDelta)}`,
+            `displayChangeFlowProposedTotal (base): ${fmt(displayChangeFlowProposedTotal)}`,
+            `displayChangeFlowProposedTotal (with editable lines): ${fmt(displayChangeFlowProposedTotalWithEditableLines)}`,
+            `feReceipt sent subtotal/tax/total: ${fmt(adminFeAuthoritativeReceipt.subtotal)} / ${fmt(adminFeAuthoritativeReceipt.tax)} / ${fmt(adminFeAuthoritativeReceipt.total)}`,
+            `feReceipt sent lineItems count: ${String(adminFeAuthoritativeReceipt.lineItems.length)}`,
             originalReceipt ? `originalReceipt.total: ${fmt(originalReceipt.total)}` : 'originalReceipt: —',
             `Quote serverDisplay.total (if any): ${quoteTotalPreview}`,
+            `Quote serverDisplay subtotal/tax/total: ${
+              latestChangeQuote?.serverDisplay
+                ? `${fmt(latestChangeQuote.serverDisplay.subtotal)} / ${fmt(latestChangeQuote.serverDisplay.tax)} / ${fmt(latestChangeQuote.serverDisplay.total)}`
+                : '—'
+            }`,
             `changeFlowClientEstimateDue (before near-zero): ${fmt(changeFlowClientEstimateDue)}`,
             `changeFlowAmountDue (PriceSummary total row): ${fmt(changeFlowAmountDue)}`,
           ].join('\n')}
@@ -3819,6 +4037,7 @@ export function AdminChangeBookingFlow({
     isAdmin,
     selectedAvailability,
     totalQuantity,
+    useAdminFeAuthoritativeQuote,
     currency,
     locale,
     originalReceipt,
@@ -3830,6 +4049,7 @@ export function AdminChangeBookingFlow({
     changeQuoteLoading,
     effectiveSubtotal,
     adminCustomAdjustmentTotal,
+    editableSummaryPreSubtotalDebugRows,
     effectiveSubtotalForCheckout,
     effectiveTax,
     effectivePromoDiscountAmount,
@@ -3838,7 +4058,10 @@ export function AdminChangeBookingFlow({
     displayedChangeAmountsRaw.subtotal,
     displayedChangeAmountsRaw.tax,
     displayedChangeAmountsRaw.total,
+    editableSummaryPreSubtotalDelta,
     displayChangeFlowProposedTotal,
+    displayChangeFlowProposedTotalWithEditableLines,
+    adminFeAuthoritativeReceipt,
     changeFlowClientEstimateDue,
     changeFlowAmountDue,
   ]);
@@ -3966,7 +4189,7 @@ export function AdminChangeBookingFlow({
         originalReceipt
           ? suppressSelfServeCurrencyUi && !selfServePricingConfirmed
             ? null
-            : displayChangeFlowProposedTotal
+            : displayChangeFlowProposedTotalWithEditableLines
           : totalPrice,
       selectionCurrency: currency,
     };
@@ -3980,7 +4203,7 @@ export function AdminChangeBookingFlow({
     totalPrice,
     currency,
     originalReceipt,
-    displayChangeFlowProposedTotal,
+    displayChangeFlowProposedTotalWithEditableLines,
     suppressSelfServeCurrencyUi,
     selfServePricingConfirmed,
   ]);
@@ -4025,7 +4248,7 @@ export function AdminChangeBookingFlow({
             ? displayChangeFlowTax
             : effectiveTax
           : 0,
-      total: originalReceipt ? displayChangeFlowProposedTotal : totalPrice,
+      total: originalReceipt ? displayChangeFlowProposedTotalWithEditableLines : totalPrice,
       currency,
     });
   }, [
@@ -4034,7 +4257,7 @@ export function AdminChangeBookingFlow({
     totalQuantity,
     effectiveSubtotalForCheckout,
     effectiveTax,
-    displayChangeFlowProposedTotal,
+    displayChangeFlowProposedTotalWithEditableLines,
     displayChangeFlowSubtotal,
     displayChangeFlowTax,
     currency,
@@ -4086,7 +4309,7 @@ export function AdminChangeBookingFlow({
           .filter(([, count]) => count > 0)
           .map(([category, count]) => ({ category, count }));
         try {
-          const quote = await quoteChangeBooking({
+          const quoteRequestBase = {
             bookingReference: bookingReferenceForQuote,
             lastName: lastName.trim(),
             newProductId: optionId,
@@ -4107,7 +4330,14 @@ export function AdminChangeBookingFlow({
               previousAvailabilityId: initialValues.availabilityId ?? null,
               previousReturnAvailabilityId: initialValues.returnAvailabilityId ?? null,
             },
-          });
+          };
+          const quote = useAdminFeAuthoritativeQuote
+            ? await quoteChangeBookingAdminFeReceipt({
+                ...quoteRequestBase,
+                feReceipt: adminFeAuthoritativeReceipt,
+                feAmountDueMajorUnits: roundMoney(changeFlowClientEstimateDue),
+              })
+            : await quoteChangeBooking(quoteRequestBase);
           if (seq !== changeQuoteRequestSeq.current) return;
           const slice = sliceChangeQuoteForUi(
             quote,
@@ -4155,6 +4385,7 @@ export function AdminChangeBookingFlow({
     addOnSelections,
     changeFlowInitialTicketCount,
     changeFlowNewBookingTotal,
+    changeFlowClientEstimateDue,
     effectiveSubtotalForCheckout,
     effectiveTax,
     totalPrice,
@@ -4163,6 +4394,8 @@ export function AdminChangeBookingFlow({
     initialValues?.availabilityId,
     initialValues?.returnAvailabilityId,
     adminCustomLinesAsAdditionalAdjustments,
+    adminFeAuthoritativeReceipt,
+    useAdminFeAuthoritativeQuote,
   ]);
 
   // Auto-select product option when date is selected: most popular if set, otherwise first available.
@@ -4683,7 +4916,7 @@ export function AdminChangeBookingFlow({
         if (!changeBookingReference || !changeLastName) {
           throw new Error('Missing booking reference or last name for change quote');
         }
-        const quote = await quoteChangeBooking({
+        const quoteRequestBase = {
           bookingReference: changeBookingReference,
           lastName: changeLastName,
           newProductId: availabilityProductOptionId,
@@ -4698,7 +4931,14 @@ export function AdminChangeBookingFlow({
             : {}),
           clientProposedTotal:
             latestChangeQuote?.serverDisplay?.total ?? changeFlowNewBookingTotal,
-        });
+        };
+        const quote = useAdminFeAuthoritativeQuote
+          ? await quoteChangeBookingAdminFeReceipt({
+              ...quoteRequestBase,
+              feReceipt: adminFeAuthoritativeReceipt,
+              feAmountDueMajorUnits: roundMoney(changeFlowClientEstimateDue),
+            })
+          : await quoteChangeBooking(quoteRequestBase);
         const quoteSlice = sliceChangeQuoteForUi(
           quote,
           {
@@ -5052,7 +5292,7 @@ export function AdminChangeBookingFlow({
           isCustomerSelfServeChange && originalReceipt
             ? {
                 previousTotal: originalReceipt.total,
-                newTotal: displayChangeFlowProposedTotal,
+                newTotal: displayChangeFlowProposedTotalWithEditableLines,
                 differenceTotal: amountDueForCheckout,
               }
             : undefined,
@@ -5158,7 +5398,7 @@ export function AdminChangeBookingFlow({
           addOnSelections: addOnSelections.length > 0 ? addOnSelections : null,
           cancellationPolicyId: cancellationPolicyId ?? initialValues?.cancellationPolicyId ?? null,
           promoCode: appliedPromoCode ?? null,
-          newTotalAmount: displayChangeFlowProposedTotal,
+          newTotalAmount: displayChangeFlowProposedTotalWithEditableLines,
           additionalHoursCount: null,
           pricingAdjustment:
             providerPricingOverrides.length > 0 || mergedProviderAdditionalAdjustments.length > 0
@@ -5531,7 +5771,7 @@ export function AdminChangeBookingFlow({
           {selectedAvailability && (
             <>
             <CheckoutForm
-                priceSummaryLines={checkoutPriceSummaryLinesForCheckout}
+                priceSummaryLines={editableCheckoutPriceSummaryLines}
                 replacePriceSummary={selfServeCheckoutPlaceholder}
                 totalPrice={changeFlowAmountDue}
                 totalSummaryLabel={
@@ -5820,16 +6060,49 @@ export function AdminChangeBookingFlow({
                 attributionConfirmLabel={flowUi?.partnerAttributionConfirmLabel}
                 attributionConfirmed={partnerAttributionConfirmed}
                 onAttributionConfirmedChange={setPartnerAttributionConfirmed}
-                lineAmountInputs={showProviderPricingInlineEditor ? providerPricingUi?.lineAmountInputs : undefined}
-                onLineAmountInputChange={
-                  showProviderPricingInlineEditor ? providerPricingUi?.onLineAmountInputChange : undefined
-                }
-                onLineAmountInputBlur={
-                  showProviderPricingInlineEditor ? providerPricingUi?.onLineAmountInputBlur : undefined
-                }
-                onLineAmountReset={
-                  showProviderPricingInlineEditor ? providerPricingUi?.onLineAmountReset : undefined
-                }
+                lineAmountInputs={editableSummaryLineAmountInputs}
+                onLineAmountInputChange={(lineKey, value) => {
+                  const sanitized = value.replace(/[^0-9.-]/g, '');
+                  setEditableSummaryLineAmountInputs((prev) => ({ ...prev, [lineKey]: sanitized }));
+                  if (showProviderPricingInlineEditor) {
+                    providerPricingUi?.onLineAmountInputChange?.(lineKey, sanitized);
+                  }
+                }}
+                onLineAmountInputBlur={(lineKey) => {
+                  setEditableSummaryLineAmountInputs((prev) => {
+                    const raw = prev[lineKey] ?? '';
+                    if (raw.trim() === '' || raw === '-' || raw === '.'
+                      || raw === '-.') {
+                      return prev;
+                    }
+                    const parsed = Number(raw);
+                    if (!Number.isFinite(parsed)) return prev;
+                    const normalized = roundMoney(parsed).toFixed(2);
+                    if (normalized === raw) return prev;
+                    return { ...prev, [lineKey]: normalized };
+                  });
+                  if (showProviderPricingInlineEditor) {
+                    providerPricingUi?.onLineAmountInputBlur?.(lineKey);
+                  }
+                }}
+                onLineAmountReset={(lineKey) => {
+                  const original = checkoutPriceSummaryLinesForCheckout.find(
+                    (line, index) => getEditableSummaryLineKey(line, index) === lineKey
+                  );
+                  if (!original) return;
+                  const nextValue =
+                    original.kind === 'ticket'
+                      ? String(roundMoney(original.itemTotal))
+                      : String(roundMoney(original.amount));
+                  setEditableSummaryLineAmountInputs((prev) => ({ ...prev, [lineKey]: nextValue }));
+                  if (showProviderPricingInlineEditor) {
+                    providerPricingUi?.onLineAmountReset?.(lineKey);
+                  }
+                }}
+                lineLabelInputs={editableSummaryLineLabelInputs}
+                onLineLabelInputChange={(lineKey, value) => {
+                  setEditableSummaryLineLabelInputs((prev) => ({ ...prev, [lineKey]: value }));
+                }}
               />
             </>
           )}

package/src/components/booking/CheckoutForm.tsx

@@ -32,6 +32,9 @@ interface CheckoutFormProps {
   onLineAmountInputChange?: (lineKey: string, value: string) => void;
   onLineAmountInputBlur?: (lineKey: string) => void;
   onLineAmountReset?: (lineKey: string) => void;
+  /** Optional map + handler for inline editable labels in PriceSummary. */
+  lineLabelInputs?: Record<string, string>;
+  onLineLabelInputChange?: (lineKey: string, value: string) => void;
   extraBeforeSubtotal?: ReactNode;
   // Promo (passed as extraBetweenTaxAndTotal content - we'll keep it in parent for now)
   // Contact info
@@ -95,6 +98,8 @@ export function CheckoutForm({
   onLineAmountInputChange,
   onLineAmountInputBlur,
   onLineAmountReset,
+  lineLabelInputs,
+  onLineLabelInputChange,
   extraBeforeSubtotal,
   firstName,
   lastName,
@@ -168,6 +173,8 @@ export function CheckoutForm({
             onLineAmountInputChange={onLineAmountInputChange}
             onLineAmountInputBlur={onLineAmountInputBlur}
             onLineAmountReset={onLineAmountReset}
+            lineLabelInputs={lineLabelInputs}
+            onLineLabelInputChange={onLineLabelInputChange}
             extraBeforeSubtotal={extraBeforeSubtotal}
           />
         )}

package/src/components/booking/PriceBreakdown.tsx

@@ -20,6 +20,8 @@ export interface PriceBreakdownProps {
   onEditableChange?: (value: string) => void;
   onEditableBlur?: () => void;
   onEditableReset?: () => void;
+  editableLabelValue?: string;
+  onEditableLabelChange?: (value: string) => void;
 }
 
 /**
@@ -65,6 +67,8 @@ export function PriceBreakdown({
   onEditableChange,
   onEditableBlur,
   onEditableReset,
+  editableLabelValue,
+  onEditableLabelChange,
 }: PriceBreakdownProps) {
   const [showTooltip, setShowTooltip] = useState(false);
   const { t } = useTranslations();
@@ -81,9 +85,19 @@ export function PriceBreakdown({
   if (!breakdown) {
     return (
       <div className="flex items-center justify-between">
-        <span className="text-sm text-stone-600">
-          {category} {qty > 1 ? `× ${qty}` : ''}
-        </span>
+        {editable && onEditableLabelChange ? (
+          <input
+            type="text"
+            className="h-7 min-w-[10rem] max-w-[16rem] rounded border border-stone-300 bg-white px-2 text-sm text-stone-700"
+            value={editableLabelValue ?? category}
+            onChange={(e) => onEditableLabelChange(e.target.value)}
+            aria-label={`Edit ${category} label`}
+          />
+        ) : (
+          <span className="text-sm text-stone-600">
+            {category} {qty > 1 ? `× ${qty}` : ''}
+          </span>
+        )}
         {editable && onEditableChange ? (
           <div className="flex items-center gap-1">
             {onEditableReset ? (
@@ -118,9 +132,19 @@ export function PriceBreakdown({
 
   return (
     <div className="flex items-center justify-between gap-3 min-w-0">
-      <span className="text-sm text-stone-600 min-w-0 truncate">
-        {category} {qty > 1 ? `× ${qty}` : ''}
-      </span>
+      {editable && onEditableLabelChange ? (
+        <input
+          type="text"
+          className="h-7 min-w-[10rem] max-w-[16rem] rounded border border-stone-300 bg-white px-2 text-sm text-stone-700"
+          value={editableLabelValue ?? category}
+          onChange={(e) => onEditableLabelChange(e.target.value)}
+          aria-label={`Edit ${category} label`}
+        />
+      ) : (
+        <span className="text-sm text-stone-600 min-w-0 truncate">
+          {category} {qty > 1 ? `× ${qty}` : ''}
+        </span>
+      )}
       <div className="relative flex-shrink-0 whitespace-nowrap">
         {editable && onEditableChange ? (
           <div className="flex items-center gap-1">

package/src/components/booking/PriceSummary.tsx

@@ -73,8 +73,12 @@ export interface PriceSummaryProps {
   extraAfterTotal?: ReactNode;
   /** Optional map of editable line input values by line key. */
   lineAmountInputs?: Record<string, string>;
+  /** Optional map of editable line label values by line key. */
+  lineLabelInputs?: Record<string, string>;
   /** Optional change handler for inline editable line amounts. */
   onLineAmountInputChange?: (lineKey: string, value: string) => void;
+  /** Optional change handler for inline editable line labels. */
+  onLineLabelInputChange?: (lineKey: string, value: string) => void;
   /** Optional blur handler for enforcing display format (e.g. 2 decimals). */
   onLineAmountInputBlur?: (lineKey: string) => void;
   /** Optional reset handler for inline editable line amounts. */
@@ -134,7 +138,9 @@ export function PriceSummary({
   totalLabel,
   extraAfterTotal,
   lineAmountInputs,
+  lineLabelInputs,
   onLineAmountInputChange,
+  onLineLabelInputChange,
   onLineAmountInputBlur,
   onLineAmountReset,
 }: PriceSummaryProps) {
@@ -161,6 +167,7 @@ export function PriceSummary({
   return (
     <div className={`space-y-2 min-w-0 ${className}`}>
       {lines.map((row, index) => {
+        const isBeforeSubtotalBoundary = firstTaxLineIndex < 0 || index < firstTaxLineIndex;
         if (row.kind === 'ticket') {
           return (
             <PriceBreakdown
@@ -171,23 +178,29 @@ export function PriceSummary({
               breakdown={row.breakdown ?? null}
               currency={currency}
               locale={locale}
-              editable={row.editable}
+              editable={Boolean(row.editable && isBeforeSubtotalBoundary)}
               editableValue={row.lineKey ? lineAmountInputs?.[row.lineKey] : undefined}
               onEditableChange={
-                row.editable && row.lineKey && onLineAmountInputChange
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineAmountInputChange
                   ? (value) => onLineAmountInputChange(row.lineKey!, value)
                   : undefined
               }
               onEditableBlur={
-                row.editable && row.lineKey && onLineAmountInputBlur
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineAmountInputBlur
                   ? () => onLineAmountInputBlur(row.lineKey!)
                   : undefined
               }
               onEditableReset={
-                row.editable && row.lineKey && onLineAmountReset
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineAmountReset
                   ? () => onLineAmountReset(row.lineKey!)
                   : undefined
               }
+              editableLabelValue={row.lineKey ? lineLabelInputs?.[row.lineKey] : undefined}
+              onEditableLabelChange={
+                row.editable && isBeforeSubtotalBoundary && row.lineKey && onLineLabelInputChange
+                  ? (value) => onLineLabelInputChange(row.lineKey!, value)
+                  : undefined
+              }
             />
           );
         }
@@ -209,10 +222,20 @@ export function PriceSummary({
             )}
             <div className={`flex justify-between gap-3 min-w-0 ${textSize}`}>
               <span className="text-stone-600 min-w-0 flex items-center gap-1">
-                <span className="min-w-0 truncate">
-                  {label}
-                  {type === 'TICKET' && quantity != null && quantity > 1 ? ` (x${quantity})` : ''}
-                </span>
+                {editable && isBeforeSubtotalBoundary && lineKey && onLineLabelInputChange ? (
+                  <input
+                    type="text"
+                    className="h-7 min-w-[10rem] max-w-[16rem] rounded border border-stone-300 bg-white px-2 text-sm text-stone-700"
+                    value={lineLabelInputs?.[lineKey] ?? label}
+                    onChange={(e) => onLineLabelInputChange(lineKey, e.target.value)}
+                    aria-label={`Edit ${label} label`}
+                  />
+                ) : (
+                  <span className="min-w-0 truncate">
+                    {label}
+                    {type === 'TICKET' && quantity != null && quantity > 1 ? ` (x${quantity})` : ''}
+                  </span>
+                )}
                 {tooltip && <InfoTooltip text={tooltip} />}
               </span>
               {editable && lineKey && onLineAmountInputChange ? (

package/src/components/booking/booking-flow-ui.ts

@@ -65,6 +65,11 @@ export interface BookingFlowUiOptions {
   itineraryStickyTopOffsetPx?: number;
   /** Provider dashboard change flow: quote/override panel shown immediately before confirm CTA. */
   providerDashboardChangePricingUi?: ProviderDashboardChangePricingUi;
+  /**
+   * Admin/provider-dashboard change flow: when true, use the admin FE-authoritative quote API.
+   * This is a rollout flag; public self-serve must stay on the existing public quote endpoint.
+   */
+  adminFeAuthoritativeQuoteEnabled?: boolean;
 }
 
 /**

package/src/lib/booking-api.ts

@@ -870,6 +870,30 @@ export interface ChangeBookingQuoteRequest {
   } | null;
 }
 
+/** FE-authored receipt payload for admin quote path (major units, booking currency). */
+export interface AdminFeAuthoritativeReceipt {
+  subtotal: number;
+  tax: number;
+  total: number;
+  currency?: string;
+  lineItems: Array<{
+    label?: string;
+    amount?: number;
+    type?: string;
+    quantity?: number;
+  }>;
+}
+
+/**
+ * Admin quote path where FE is authoritative for receipt lines/totals.
+ * Mirrors {@link ChangeBookingQuoteRequest} selection fields and adds a full receipt payload.
+ */
+export interface AdminChangeBookingQuoteRequest extends ChangeBookingQuoteRequest {
+  feReceipt: AdminFeAuthoritativeReceipt;
+  /** Optional explicit signed delta shown by FE (new total − original total), major units. */
+  feAmountDueMajorUnits?: number;
+}
+
 export interface ChangeBookingQuoteReceipt {
   subtotal?: number;
   tax?: number;
@@ -1108,6 +1132,31 @@ export async function quoteChangeBooking(
     data) as ChangeBookingQuoteResponse;
 }
 
+/** Admin-only quote endpoint: FE-authored receipt totals + line items are authoritative. */
+export async function quoteChangeBookingAdminFeReceipt(
+  request: AdminChangeBookingQuoteRequest
+): Promise<ChangeBookingQuoteResponse> {
+  const { bookingReference, lastName, ...payload } = request;
+  const res = await fetch(
+    `${API_BASE}/1/admin/bookings/${encodeURIComponent(bookingReference)}/change/quote?lastName=${encodeURIComponent(lastName)}`,
+    {
+      method: 'POST',
+      headers: getAuthHeaders(),
+      body: JSON.stringify(payload),
+    }
+  );
+  if (!res.ok) {
+    const err = await parseJsonSafely(res);
+    const message = isApiErrorPayload(err)
+      ? err.errorMessage || err.error || 'Failed to quote admin booking change'
+      : 'Failed to quote admin booking change';
+    throw new Error(message);
+  }
+  const data = await parseJsonSafely(res);
+  return ((data as { data?: ChangeBookingQuoteResponse } | null)?.data ??
+    data) as ChangeBookingQuoteResponse;
+}
+
 export async function createChangeBookingPaymentIntent(
   changeIntentId: string
 ): Promise<CreateChangePaymentIntentResponse> {