@ticketboothapp/booking 1.2.166 → 1.2.168

package/src/components/booking/useAdminChangeQuotePreview.ts

@@ -8,8 +8,8 @@ import {
 } from 'react';
 import {
   quoteChangeBooking,
-  quoteAdminChangeBookingV2,
   type AdminAmendmentRefundDisposition,
+  type AdminPromoApplicationScope,
   type AdminFeAuthoritativeReceipt,
   type Availability,
   type ItineraryDisplayStep,
@@ -27,7 +27,16 @@ import {
 } from './change-booking-flow-helpers';
 import type { Currency } from './CurrencySwitcher';
 import type { AdminChangeLatestQuote } from './useAdminChangeCheckoutController';
-import { buildAdminChangeQuoteRequestKey } from './admin-change-quote-request-key';
+import {
+  buildAdminChangeQuoteRequestKey,
+  canRequestAdminChangeQuote,
+  canReuseCompletedAdminChangeQuote,
+} from './admin-change-quote-request-key';
+import {
+  buildAdminChangeV2QuoteRequest,
+  quoteAdminChangeV2ForUi,
+} from './admin-change-v2-quote-request';
+import { friendlyChangeBookingError } from './change-booking-error-message';
 import type { ProviderDashboardChangeBookingPayload } from './provider-dashboard-change-booking';
 
 type AddOnSelection = { addOnId: string; variantId?: string; quantity?: number };
@@ -36,7 +45,12 @@ type AdminCustomReceiptLine = {
   amountInput: string;
   amountSign?: number;
   calculation: 'FIXED_AMOUNT' | 'PERCENTAGE';
-  scope: 'POSITIVE_AMENDMENT_VALUE' | 'CURRENT_ACTIVE_TICKETS' | 'CURRENT_ACTIVE_BOOKING';
+  scope:
+    | 'POSITIVE_AMENDMENT_VALUE'
+    | 'CURRENT_ACTIVE_TICKETS'
+    | 'CURRENT_ACTIVE_BOOKING'
+    | 'SELECTED_COMPONENTS';
+  selectedComponentIds: string[];
   taxBehavior: 'NON_TAXABLE' | 'TAXABLE' | 'PRE_TAX_DISCOUNT' | 'POST_TAX_DISCOUNT';
   reasonCode: string;
 };
@@ -60,8 +74,12 @@ export interface UseAdminChangeQuotePreviewParams {
   quantities: Record<string, number>;
   addOnSelections: AddOnSelection[];
   cancellationPolicyId: string | null;
+  appliedPromoCode: string | null;
+  promoApplicationScope: AdminPromoApplicationScope;
   adminCustomReceiptLines: AdminCustomReceiptLine[];
   adminStructuredAdjustments: NonNullable<ProviderDashboardChangeBookingPayload['structuredAdjustments']>;
+  adminReverseAdjustmentIds: string[];
+  needsAdjustmentDiscovery: boolean;
   refundDispositionsByOperationId: Record<string, AdminAmendmentRefundDisposition>;
   useAdminFeAuthoritativeQuote: boolean;
   latestChangeQuote: AdminChangeLatestQuote | null;
@@ -119,8 +137,12 @@ export function useAdminChangeQuotePreview({
   quantities,
   addOnSelections,
   cancellationPolicyId,
+  appliedPromoCode,
+  promoApplicationScope,
   adminCustomReceiptLines,
   adminStructuredAdjustments,
+  adminReverseAdjustmentIds,
+  needsAdjustmentDiscovery,
   refundDispositionsByOperationId,
   useAdminFeAuthoritativeQuote,
   latestChangeQuote,
@@ -156,10 +178,9 @@ export function useAdminChangeQuotePreview({
   onPricePreviewChange,
 }: UseAdminChangeQuotePreviewParams): UseAdminChangeQuotePreviewResult {
   const lastChangeFlowPreviewKeyRef = useRef<string | null>(null);
-
   const changeFlowNeedsServerPrice =
     isCustomerSelfServeChange &&
-    hasChangeSelection &&
+    hasEffectiveChangeSelection &&
     !!initialValues?.bookingReference?.trim() &&
     !!lastName.trim();
 
@@ -167,37 +188,85 @@ export function useAdminChangeQuotePreview({
     latestChangeQuote?.canProceed === false &&
     (latestChangeQuote.refundDecisionOperations?.length ?? 0) === 0;
   const refundDecisionRequired = (latestChangeQuote?.refundDecisionOperations?.length ?? 0) > 0;
+  const hasPublishedChangeQuote = latestChangeQuote !== null;
+  /**
+   * Existing admin adjustments must be discoverable before the operator makes a change.
+   * Initial selection hydration can briefly leave the live availability/return unset, so use
+   * the persisted booking identities for this read-only discovery quote instead of waiting for
+   * the editable target controls to become complete.
+   */
+  const quoteAvailability = useMemo<Availability | null>(() => {
+    if (selectedAvailability) return selectedAvailability;
+    if (!needsAdjustmentDiscovery || !initialValues?.dateTime?.trim()) return null;
+    const optionId = initialValues.productOptionId?.trim() || initialValues.productId?.trim();
+    if (!optionId) return null;
+    return {
+      dateTime: initialValues.dateTime.trim(),
+      availabilityId: initialValues.availabilityId?.trim() || undefined,
+      productOptionId: optionId,
+      vacancies: Math.max(totalQuantity, 1),
+      currency,
+    };
+  }, [
+    selectedAvailability,
+    needsAdjustmentDiscovery,
+    initialValues?.dateTime,
+    initialValues?.availabilityId,
+    initialValues?.productOptionId,
+    initialValues?.productId,
+    totalQuantity,
+    currency,
+  ]);
+  const quoteReturnAvailabilityId =
+    selectedReturnOption?.returnAvailabilityId ??
+    (needsAdjustmentDiscovery ? initialValues?.returnAvailabilityId?.trim() || null : null);
   const changeQuoteInputsKey = useMemo(() => buildAdminChangeQuoteRequestKey({
     bookingReference: initialValues?.bookingReference,
     lastName,
     productId: product.productId,
-    selectedAvailability,
+    selectedAvailability: quoteAvailability,
     pickupLocationId,
-    returnAvailabilityId: selectedReturnOption?.returnAvailabilityId ?? null,
+    returnAvailabilityId: quoteReturnAvailabilityId,
     quantities,
     addOnSelections,
     adminCustomReceiptLines,
     cancellationPolicyId,
+    promoCode: appliedPromoCode,
+    promoApplicationScope,
     structuredAdjustments: adminStructuredAdjustments,
+    reverseAdjustmentIds: adminReverseAdjustmentIds,
     refundDispositionsByOperationId,
     useAdminFeAuthoritativeQuote,
   }), [
     initialValues?.bookingReference,
     lastName,
     product.productId,
-    selectedAvailability,
+    quoteAvailability,
     pickupLocationId,
-    selectedReturnOption?.returnAvailabilityId,
+    quoteReturnAvailabilityId,
     quantities,
     addOnSelections,
     adminCustomReceiptLines,
     cancellationPolicyId,
+    appliedPromoCode,
+    promoApplicationScope,
     adminStructuredAdjustments,
+    adminReverseAdjustmentIds,
     refundDispositionsByOperationId,
     useAdminFeAuthoritativeQuote,
   ]);
   const destinationRequiresReturnSelection = Boolean(selectedAvailability?.returnOptions?.length);
   const missingRequiredReturnSelection = destinationRequiresReturnSelection && !selectedReturnOption;
+  const quoteMissingRequiredReturnSelection =
+    missingRequiredReturnSelection && !needsAdjustmentDiscovery;
+  const canRequestChangeQuote = canRequestAdminChangeQuote({
+    isCustomerSelfServeChange,
+    hasEffectiveChangeSelection: hasEffectiveChangeSelection || needsAdjustmentDiscovery,
+    hasSelectedAvailability: quoteAvailability != null,
+    bookingReference: initialValues?.bookingReference,
+    lastName,
+    missingRequiredReturnSelection: quoteMissingRequiredReturnSelection,
+  });
 
   const changeFlowSubmitDisabled =
     missingRequiredReturnSelection ||
@@ -208,6 +277,14 @@ export function useAdminChangeQuotePreview({
   const changeCheckoutButtonLabel = (() => {
     if (!hasEffectiveChangeSelection) return undefined;
     if (isProviderDashboardChange) {
+      if (changeQuoteLoading || (!latestChangeQuote && !changeQuoteFetchError)) {
+        const tr = t('booking.updatingPrice');
+        return tr !== 'booking.updatingPrice' ? tr : 'Updating price\u2026';
+      }
+      if (changeQuoteFetchError) {
+        const tr = t('booking.changeBookingRetry');
+        return tr !== 'booking.changeBookingRetry' ? tr : 'Change booking (retry)';
+      }
       if (isChangeQuoteBlocked) {
         const tr = t('booking.changeBookingNotAvailable');
         return tr !== 'booking.changeBookingNotAvailable' ? tr : 'Change not available';
@@ -215,8 +292,8 @@ export function useAdminChangeQuotePreview({
       // Prefer authoritative V2 signed due (charge positive / refund negative). Do not use the
       // FE cart estimate once a server quote exists — receipt total deltas can disagree with
       // floored/settlement amounts (DEFECT-PV2-018 follow-up).
-      const serverDue = latestChangeQuote?.serverPreview?.amountDue;
-      const due = Math.round((serverDue ?? changeFlowClientEstimateDue) * 100) / 100;
+      const serverDue = latestChangeQuote?.serverPreview?.amountDue ?? latestChangeQuote?.priceDiff ?? 0;
+      const due = Math.round(serverDue * 100) / 100;
       return due > 0
         ? `Change booking (${formatCurrencyAmount(due, currency, locale as 'en' | 'fr')})`
         : due < 0
@@ -255,20 +332,23 @@ export function useAdminChangeQuotePreview({
         : 'Change booking (no charge)';
   })();
 
-  const checkoutFormError =
+  const rawCheckoutFormError =
     (error || '') ||
     (missingRequiredReturnSelection ? 'Please select a return time for this product.' : '') ||
     (isChangeQuoteBlocked && !refundDecisionRequired
       ? (latestChangeQuote?.reasonIfBlocked ?? 'This change cannot be priced right now.')
       : '') ||
     (changeQuoteFetchError ?? '');
+  const checkoutFormError = friendlyChangeBookingError(rawCheckoutFormError);
 
   const changeFlowSelectionPreview = useMemo((): ChangeFlowSelectionPreview | null => {
     if (!selectedAvailability || totalQuantity <= 0) return null;
     const ticketsLine = formatTicketLineItemsForSummary(
       ticketLineItems.map((l) => ({ category: l.category, qty: l.qty }))
     );
-    const itinerary = computeItineraryDisplay();
+    const itinerary =
+      latestChangeQuote?.authoritativeItineraryDisplay ??
+      computeItineraryDisplay();
     const itinerarySteps =
       itinerary?.map((s) => ({
         time: s.time?.trim() || null,
@@ -312,6 +392,7 @@ export function useAdminChangeQuotePreview({
     latestChangeQuote?.quotedTotal,
     latestChangeQuote?.serverDisplay?.total,
     latestChangeQuote?.serverPreview?.totalNewBooking,
+    latestChangeQuote?.authoritativeItineraryDisplay,
   ]);
 
   useEffect(() => {
@@ -383,13 +464,7 @@ export function useAdminChangeQuotePreview({
       return;
     }
 
-    if (
-      !hasChangeSelection ||
-      !selectedAvailability ||
-      !initialValues?.bookingReference?.trim() ||
-      !lastName.trim() ||
-      missingRequiredReturnSelection
-    ) {
+    if (!canRequestChangeQuote || !quoteAvailability || !initialValues?.bookingReference?.trim()) {
       setLatestChangeQuote(null);
       setChangeQuoteLoading(false);
       setChangeQuoteFetchError(null);
@@ -398,16 +473,20 @@ export function useAdminChangeQuotePreview({
       return;
     }
 
-    if (
-      changeQuoteInputsKey &&
-      (inFlightQuoteInputsKeyRef.current === changeQuoteInputsKey ||
-        lastCompletedQuoteInputsKeyRef.current === changeQuoteInputsKey)
-    ) {
+    if (changeQuoteInputsKey && inFlightQuoteInputsKeyRef.current === changeQuoteInputsKey) {
+      return;
+    }
+
+    if (canReuseCompletedAdminChangeQuote(
+      changeQuoteInputsKey,
+      lastCompletedQuoteInputsKeyRef.current,
+      hasPublishedChangeQuote,
+    )) {
       setChangeQuoteLoading(false);
       return;
     }
 
-    const optionId = getAvailabilityOptionId(selectedAvailability);
+    const optionId = getAvailabilityOptionId(quoteAvailability);
     if (!optionId) {
       setLatestChangeQuote(null);
       setChangeQuoteLoading(false);
@@ -429,44 +508,49 @@ export function useAdminChangeQuotePreview({
           .filter(([, count]) => count > 0)
           .map(([category, count]) => ({ category, count }));
         try {
-          const quoteRequestBase = {
+          const quoteRequestBase = buildAdminChangeV2QuoteRequest({
             bookingReference: bookingReferenceForQuote,
-            lastName: lastName.trim(),
-            newProductId: optionId,
-            newParentProductId: product.productId,
-            newDateTime: selectedAvailability.dateTime,
-            newAvailabilityId: selectedAvailability.availabilityId || null,
-            newPickupLocationId: pickupLocationId || null,
-            newReturnAvailabilityId: selectedReturnOption?.returnAvailabilityId ?? null,
-            newPassengerCounts: bookingItems,
-            // Admin owns the complete target selection. [] intentionally clears all add-ons.
-            newAddOnSelections: addOnSelections,
-            cancellationPolicyId,
+            lastName,
+            parentProductId: product.productId,
+            optionId,
+            selectedAvailability: quoteAvailability,
+            pickupLocationId,
+            returnAvailabilityId: quoteReturnAvailabilityId,
+            bookingItems,
+            addOnSelections,
+            cancellationPolicyId: cancellationPolicyId ?? null,
+            promoCode: appliedPromoCode,
+            promoApplicationScope,
             structuredAdjustments: adminStructuredAdjustments,
-            ...(Object.keys(refundDispositionsByOperationId).length > 0
-              ? { refundDispositionsByOperationId }
-              : {}),
-            clientProposedTotal: changeFlowNewBookingTotal,
-            capacitySeatCredit: {
-              enabled: true,
-              previousPassengerCount: changeFlowInitialTicketCount,
-              previousAvailabilityId: initialValues.availabilityId ?? null,
-              previousReturnAvailabilityId: initialValues.returnAvailabilityId ?? null,
-            },
-          };
-          const quote = useAdminFeAuthoritativeQuote
-            ? await quoteAdminChangeBookingV2({
+            reverseAdjustmentIds: adminReverseAdjustmentIds,
+            includeSelectableAdjustmentComponents:
+              needsAdjustmentDiscovery || adminCustomReceiptLines.some(
+                (line) => line.scope === 'SELECTED_COMPONENTS',
+              ),
+            refundDispositionsByOperationId,
+            previousPassengerCount: changeFlowInitialTicketCount,
+            previousAvailabilityId: initialValues.availabilityId ?? null,
+            previousReturnAvailabilityId: initialValues.returnAvailabilityId ?? null,
+          });
+          const mergedQuote = useAdminFeAuthoritativeQuote
+            ? await quoteAdminChangeV2ForUi(
+                quoteRequestBase,
+                {
+                  total: changeFlowNewBookingTotal,
+                  subtotal: effectiveSubtotalForCheckout,
+                  tax: effectiveTax,
+                },
+                currency,
+              )
+            : sliceAndMergeChangeQuoteForUi(await quoteChangeBooking({
                 ...quoteRequestBase,
-                // V2 is server-authoritative. Do not bind it to the outbound-only FE estimate.
-                clientProposedTotal: undefined,
-              })
-            : await quoteChangeBooking(quoteRequestBase);
+                clientProposedTotal: changeFlowNewBookingTotal,
+              }), {
+                total: changeFlowNewBookingTotal,
+                subtotal: effectiveSubtotalForCheckout,
+                tax: effectiveTax,
+              }, currency).mergedQuote;
           if (seq !== changeQuoteRequestSeq.current) return;
-          const mergedQuote = sliceAndMergeChangeQuoteForUi(quote, {
-              total: changeFlowNewBookingTotal,
-              subtotal: effectiveSubtotalForCheckout,
-              tax: effectiveTax,
-            }, currency).mergedQuote;
           // Commit the completed identity before publishing its result. This keeps a
           // render caused by setLatestChangeQuote from being interpreted as a new request.
           lastCompletedQuoteInputsKeyRef.current = changeQuoteInputsKey;
@@ -494,9 +578,10 @@ export function useAdminChangeQuotePreview({
     // Fetching is controlled by the canonical user-input identity. Do not add quote-derived
     // totals, receipt objects, or display lines here: a response must not trigger another quote.
     isCustomerSelfServeChange,
-    hasChangeSelection,
+    canRequestChangeQuote,
     missingRequiredReturnSelection,
     changeQuoteInputsKey,
+    hasPublishedChangeQuote,
   ]);
 
   return {

package/src/components/booking/useAdminCustomReceiptLines.ts

@@ -1,4 +1,5 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import type { AdminAmendmentActiveAdjustmentSnapshot } from '../../lib/booking-api';
 
 export type AdminCustomReceiptLine = {
   id: string;
@@ -6,63 +7,223 @@ export type AdminCustomReceiptLine = {
   amountInput: string;
   amountSign: 1 | -1;
   calculation: 'FIXED_AMOUNT' | 'PERCENTAGE';
-  scope: 'POSITIVE_AMENDMENT_VALUE' | 'CURRENT_ACTIVE_TICKETS' | 'CURRENT_ACTIVE_BOOKING';
+  scope:
+    | 'POSITIVE_AMENDMENT_VALUE'
+    | 'CURRENT_ACTIVE_TICKETS'
+    | 'CURRENT_ACTIVE_BOOKING'
+    | 'SELECTED_COMPONENTS';
+  selectedComponentIds: string[];
   taxBehavior: 'NON_TAXABLE' | 'TAXABLE' | 'PRE_TAX_DISCOUNT' | 'POST_TAX_DISCOUNT';
   reasonCode: string;
+  /** Immutable ledger id. Existing lines are edited by reversing this id and adding a replacement. */
+  sourceAdjustmentId?: string;
+  replacementAdjustmentId?: string;
+  isDirty?: boolean;
 };
 
 type AdminCustomReceiptLinePatch = Partial<
   Pick<
     AdminCustomReceiptLine,
-    'label' | 'amountInput' | 'amountSign' | 'calculation' | 'scope' | 'taxBehavior' | 'reasonCode'
+    | 'label'
+    | 'amountInput'
+    | 'amountSign'
+    | 'calculation'
+    | 'scope'
+    | 'selectedComponentIds'
+    | 'taxBehavior'
+    | 'reasonCode'
   >
 >;
 
-export function useAdminCustomReceiptLines(resetKey: string | null | undefined) {
+export function lineFromActiveAdjustment(
+  adjustment: AdminAmendmentActiveAdjustmentSnapshot,
+  replacementAdjustmentId: string,
+): AdminCustomReceiptLine {
+  const percentage = adjustment.mode !== 'FIXED_AMOUNT';
+  return {
+    id: `existing:${adjustment.adjustmentId}`,
+    label:
+      adjustment.reason?.trim() ||
+      adjustment.referenceCode?.trim() ||
+      adjustment.reasonCode.replace(/_/g, ' ').toLowerCase(),
+    amountInput: percentage
+      ? String(Math.abs(adjustment.percentageBasisPoints ?? 0) / 100)
+      : (Math.abs(adjustment.amountCents) / 100).toFixed(2),
+    amountSign: adjustment.amountCents < 0 ? -1 : 1,
+    calculation: percentage ? 'PERCENTAGE' : 'FIXED_AMOUNT',
+    scope: adjustment.scope,
+    selectedComponentIds:
+      adjustment.scope === 'SELECTED_COMPONENTS' ? adjustment.affectedComponentIds : [],
+    taxBehavior: adjustment.taxBehavior,
+    reasonCode: adjustment.reasonCode,
+    sourceAdjustmentId: adjustment.adjustmentId,
+    replacementAdjustmentId,
+    isDirty: false,
+  };
+}
+
+export function reverseAdjustmentIdsForAdminCustomLines(
+  lines: AdminCustomReceiptLine[],
+  removedExistingAdjustmentIds: string[] = [],
+): string[] {
+  return Array.from(new Set([
+    ...removedExistingAdjustmentIds,
+    ...lines.flatMap((line) =>
+      line.sourceAdjustmentId && line.isDirty ? [line.sourceAdjustmentId] : [],
+    ),
+  ])).sort();
+}
+
+export function useAdminCustomReceiptLines(
+  resetKey: string | null | undefined,
+  reversibleAdjustments: AdminAmendmentActiveAdjustmentSnapshot[] | undefined,
+) {
   const [adminCustomReceiptLines, setAdminCustomReceiptLines] = useState<AdminCustomReceiptLine[]>([]);
+  const [appliedAdminCustomReceiptLines, setAppliedAdminCustomReceiptLines] = useState<
+    AdminCustomReceiptLine[]
+  >([]);
+  const [removedExistingAdjustmentIds, setRemovedExistingAdjustmentIds] = useState<string[]>([]);
+  const [appliedRemovedExistingAdjustmentIds, setAppliedRemovedExistingAdjustmentIds] = useState<
+    string[]
+  >([]);
+  const [hasHydratedExistingAdjustments, setHasHydratedExistingAdjustments] = useState(false);
   const adminCustomLineIdRef = useRef(0);
   const previousResetKeyRef = useRef(resetKey);
+  const hydratedResetKeyRef = useRef<string | null | undefined>(undefined);
+  const skipHydrationForResetKeyRef = useRef<string | null | undefined>(undefined);
 
-  const handleAddAdminCustomReceiptLine = useCallback(() => {
+  const nextDraftId = useCallback((prefix: 'admin-rcpt' | 'admin-edit') => {
     adminCustomLineIdRef.current += 1;
+    return `${prefix}-${Date.now().toString(36)}-${adminCustomLineIdRef.current}`;
+  }, []);
+
+  const handleAddAdminCustomReceiptLine = useCallback(() => {
+    const id = nextDraftId('admin-rcpt');
     setAdminCustomReceiptLines((prev) => [
       ...prev,
       {
-        id: `admin-rcpt-${adminCustomLineIdRef.current}`,
+        id,
         label: '',
         amountInput: '',
         amountSign: 1,
         calculation: 'FIXED_AMOUNT',
         scope: 'POSITIVE_AMENDMENT_VALUE',
-        taxBehavior: 'NON_TAXABLE',
+        selectedComponentIds: [],
+        taxBehavior: 'TAXABLE',
         reasonCode: 'STAFF_ADJUSTMENT',
       },
     ]);
-  }, []);
+    return id;
+  }, [nextDraftId]);
 
   const handleUpdateAdminCustomReceiptLine = useCallback(
     (id: string, patch: AdminCustomReceiptLinePatch) => {
       setAdminCustomReceiptLines((prev) =>
-        prev.map((line) => (line.id === id ? { ...line, ...patch } : line))
+        prev.map((line) =>
+          line.id === id
+            ? { ...line, ...patch, ...(line.sourceAdjustmentId ? { isDirty: true } : {}) }
+            : line,
+        )
       );
     },
     [],
   );
 
   const handleRemoveAdminCustomReceiptLine = useCallback((id: string) => {
+    const removed = adminCustomReceiptLines.find((line) => line.id === id);
+    if (removed?.sourceAdjustmentId) {
+      setRemovedExistingAdjustmentIds((current) =>
+        current.includes(removed.sourceAdjustmentId!)
+          ? current
+          : [...current, removed.sourceAdjustmentId!],
+      );
+    }
     setAdminCustomReceiptLines((prev) => prev.filter((line) => line.id !== id));
-  }, []);
+  }, [adminCustomReceiptLines]);
+
+  const handleApplyAdminCustomReceiptLines = useCallback(() => {
+    setAppliedAdminCustomReceiptLines(adminCustomReceiptLines);
+    setAppliedRemovedExistingAdjustmentIds(removedExistingAdjustmentIds);
+  }, [adminCustomReceiptLines, removedExistingAdjustmentIds]);
 
   useEffect(() => {
     if (previousResetKeyRef.current === resetKey) return;
     previousResetKeyRef.current = resetKey;
     setAdminCustomReceiptLines([]);
+    setAppliedAdminCustomReceiptLines([]);
+    setRemovedExistingAdjustmentIds([]);
+    setAppliedRemovedExistingAdjustmentIds([]);
+    setHasHydratedExistingAdjustments(false);
+    hydratedResetKeyRef.current = undefined;
+    skipHydrationForResetKeyRef.current =
+      reversibleAdjustments === undefined ? undefined : resetKey;
+    // `reversibleAdjustments` is intentionally sampled only when the reset key changes.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [resetKey]);
 
+  useEffect(() => {
+    if (reversibleAdjustments === undefined) return;
+    // A product-family reset and clearing the previous quote happen in separate effects.
+    // Never hydrate the new editor from the previous target's quote during that transition.
+    if (skipHydrationForResetKeyRef.current === resetKey) {
+      skipHydrationForResetKeyRef.current = undefined;
+      return;
+    }
+    if (hydratedResetKeyRef.current === resetKey) return;
+    hydratedResetKeyRef.current = resetKey;
+    const hydratedLines = reversibleAdjustments.map((adjustment) =>
+      lineFromActiveAdjustment(adjustment, nextDraftId('admin-edit')),
+    );
+    setAdminCustomReceiptLines(hydratedLines);
+    setAppliedAdminCustomReceiptLines(hydratedLines);
+    setRemovedExistingAdjustmentIds([]);
+    setAppliedRemovedExistingAdjustmentIds([]);
+    setHasHydratedExistingAdjustments(true);
+  }, [nextDraftId, resetKey, reversibleAdjustments]);
+
+  const adminReverseAdjustmentIds = reverseAdjustmentIdsForAdminCustomLines(
+    appliedAdminCustomReceiptLines,
+    appliedRemovedExistingAdjustmentIds,
+  );
+  const hasPendingAdminCustomReceiptLineChanges = useMemo(
+    () =>
+      JSON.stringify({
+        lines: adminCustomReceiptLines,
+        removedIds: [...removedExistingAdjustmentIds].sort(),
+      }) !==
+      JSON.stringify({
+        lines: appliedAdminCustomReceiptLines,
+        removedIds: [...appliedRemovedExistingAdjustmentIds].sort(),
+      }),
+    [
+      adminCustomReceiptLines,
+      appliedAdminCustomReceiptLines,
+      removedExistingAdjustmentIds,
+      appliedRemovedExistingAdjustmentIds,
+    ],
+  );
+  const pendingAdminCustomReceiptLineIds = useMemo(() => {
+    const appliedLinesById = new Map(
+      appliedAdminCustomReceiptLines.map((line) => [line.id, line]),
+    );
+    return adminCustomReceiptLines.flatMap((line) => {
+      const appliedLine = appliedLinesById.get(line.id);
+      return !appliedLine || JSON.stringify(line) !== JSON.stringify(appliedLine)
+        ? [line.id]
+        : [];
+    });
+  }, [adminCustomReceiptLines, appliedAdminCustomReceiptLines]);
+
   return {
     adminCustomReceiptLines,
+    appliedAdminCustomReceiptLines,
+    adminReverseAdjustmentIds,
+    hasPendingAdminCustomReceiptLineChanges,
+    pendingAdminCustomReceiptLineIds,
+    hasHydratedExistingAdjustments,
     handleAddAdminCustomReceiptLine,
     handleUpdateAdminCustomReceiptLine,
     handleRemoveAdminCustomReceiptLine,
+    handleApplyAdminCustomReceiptLines,
   };
 }