@ticketboothapp/booking 1.2.167 → 1.2.168

package/src/lib/booking-api.ts

@@ -1265,6 +1265,27 @@ export interface AdminAmendmentOperationSnapshot {
   metadata?: Record<string, string>;
 }
 
+export interface AdminAmendmentActiveAdjustmentSnapshot {
+  adjustmentId: string;
+  operationId: string;
+  mode: 'FIXED_AMOUNT' | 'PERCENTAGE_DISCOUNT' | 'PERCENTAGE_SURCHARGE';
+  scope:
+    | 'POSITIVE_AMENDMENT_VALUE'
+    | 'CURRENT_ACTIVE_TICKETS'
+    | 'CURRENT_ACTIVE_BOOKING'
+    | 'SELECTED_COMPONENTS';
+  basisCents: number;
+  percentageBasisPoints?: number | null;
+  amountCents: number;
+  taxDeltaCents: number;
+  affectedComponentIds: string[];
+  taxBehavior: 'NON_TAXABLE' | 'TAXABLE' | 'PRE_TAX_DISCOUNT' | 'POST_TAX_DISCOUNT';
+  reasonCode: string;
+  referenceCode?: string | null;
+  reason?: string | null;
+  createdAt: string;
+}
+
 export interface ChangeBookingQuoteRequest {
   bookingReference: string;
   lastName: string;
@@ -1299,6 +1320,25 @@ export interface ChangeBookingQuoteRequest {
   } | null;
   /** Explicit admin treatment for server-classified removed paid value. Never defaulted by the client. */
   refundDispositionsByOperationId?: Record<string, AdminAmendmentRefundDisposition>;
+  /** Server-resolved admin adjustments to append to the immutable amendment ledger. */
+  structuredAdjustments?: Array<{
+    adjustmentId: string;
+    mode: 'FIXED_AMOUNT' | 'PERCENTAGE_DISCOUNT' | 'PERCENTAGE_SURCHARGE';
+    fixedAmount?: number | null;
+    percentageBasisPoints?: number | null;
+    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;
+    referenceCode?: string | null;
+    reason?: string | null;
+  }>;
+  /** Existing immutable adjustment ids to reverse as part of this amendment. */
+  reverseAdjustmentIds?: string[];
 }
 
 /** FE-authored receipt payload for admin quote path (major units, booking currency). */
@@ -1329,6 +1369,7 @@ export interface AdminChangeBookingQuoteV2Data {
   oldReceipt: {
     currency?: string | null;
     grossSubtotal?: number | null;
+    paymentCreditTotal?: number | null;
     taxAmount?: number | null;
     payableTotal?: number | null;
     lines?: PricingV2QuoteLineSnapshot[] | null;
@@ -1348,6 +1389,7 @@ export interface AdminChangeBookingQuoteV2Data {
   returnPriceTreatmentOperations?: AdminAmendmentOperationSnapshot[];
   allowedRefundDispositionsByOperationId?: Record<string, AdminAmendmentRefundDisposition[]>;
   removedValueByOperationId?: Record<string, number>;
+  reversibleAdjustments?: AdminAmendmentActiveAdjustmentSnapshot[];
 }
 
 export interface ChangeBookingQuoteReceipt {
@@ -1355,11 +1397,17 @@ export interface ChangeBookingQuoteReceipt {
   tax?: number;
   total: number;
   currency?: string;
+  /** Non-cash value currently allocated to the booking, such as gift-card credit. */
+  paymentCreditTotal?: number;
   lineItems?: Array<{
     label?: string;
     amount?: number;
     type?: string;
     quantity?: number;
+    reference?: string | null;
+    identity?: {
+      componentId?: string | null;
+    } | null;
     priceBasis?: PriceBasisSnapshot | null;
   }>;
 }
@@ -1453,6 +1501,7 @@ export interface ChangeBookingQuoteResponse {
   quote?: PricingV2QuoteSnapshot | null;
   paymentCreditTotal?: number;
   balanceDelta?: number;
+  amountPreviouslyPaid?: number;
   amountToCharge?: number;
   refundCandidate?: number;
   /**
@@ -1496,6 +1545,8 @@ export interface ChangeBookingQuoteResponse {
   allowedRefundDispositionsByOperationId?: Record<string, AdminAmendmentRefundDisposition[]>;
   /** Original paid basis plus allocated refundable tax for each removal operation. */
   removedValueByOperationId?: Record<string, number>;
+  /** Active immutable adjustments that an admin may edit (reverse + replace) or remove. */
+  reversibleAdjustments?: AdminAmendmentActiveAdjustmentSnapshot[];
   /** When price check fails / disagrees: optional breakdown for UI line-vs-line comparison. */
   pricingDriftDetail?: ChangeBookingQuotePricingDriftDetail;
   /** Optional BE debug: receipt-floor vs catalog ticket math (same-parent Rule A/B). */
@@ -1690,6 +1741,7 @@ export function mapAdminChangeBookingQuoteV2Data(
     pricingQuote: newQuote,
     quote: newQuote,
     balanceDelta: data.balanceDelta ?? newQuote?.balanceDelta ?? undefined,
+    amountPreviouslyPaid: newQuote?.amountPreviouslyPaid ?? undefined,
     amountToCharge: data.amountToCharge ?? newQuote?.amountToCharge ?? undefined,
     refundCandidate: data.refundCandidate ?? newQuote?.refundCandidate ?? undefined,
     priceDiff: data.balanceDelta ?? newQuote?.balanceDelta ?? 0,
@@ -1701,11 +1753,13 @@ export function mapAdminChangeBookingQuoteV2Data(
     allowedRefundDispositionsByOperationId:
       data.allowedRefundDispositionsByOperationId ?? {},
     removedValueByOperationId: data.removedValueByOperationId ?? {},
+    reversibleAdjustments: data.reversibleAdjustments ?? [],
     originalReceipt: {
       subtotal: oldReceipt.grossSubtotal ?? undefined,
       tax: oldReceipt.taxAmount ?? undefined,
       total: oldReceipt.payableTotal ?? 0,
       currency: oldReceipt.currency ?? undefined,
+      paymentCreditTotal: oldReceipt.paymentCreditTotal ?? 0,
       lineItems: oldReceipt.lines?.map((line) => ({
         label: line.label ?? undefined,
         amount: line.amount ?? undefined,
@@ -2249,6 +2303,16 @@ export interface PricingV2QuoteSnapshot {
   relatedChangeIntentId?: string | null;
   amendment?: {
     operations?: AdminAmendmentOperationSnapshot[] | null;
+    updatedReceipt?: ChangeBookingQuoteReceipt | null;
+    targetState?: {
+      nonPriceState?: {
+        /**
+         * The amendment service stores the canonical itinerary as JSON in non-price state.
+         * Accept an array as well so clients remain compatible if the API stops stringifying it.
+         */
+        itinerary?: string | ItineraryDisplayStep[] | null;
+      } | null;
+    } | null;
   } | null;
   metadata?: Record<string, string> | null;
   [key: string]: unknown;