@ticketboothapp/booking 1.2.120 → 1.2.122

package/package.json

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

package/src/components/booking/AdminChangeBookingFlow.tsx

@@ -4230,6 +4230,22 @@ export function AdminChangeBookingFlow({
     t,
   ]);
 
+  const providerApplyAuthoritativeReceipt = useMemo(() => {
+    if (!useAdminFeAuthoritativeQuote) return undefined;
+    return {
+      subtotalBeforeTax: adminFeAuthoritativeReceipt.subtotal,
+      taxAmount: adminFeAuthoritativeReceipt.tax,
+      totalAmount: adminFeAuthoritativeReceipt.total,
+      currency: adminFeAuthoritativeReceipt.currency ?? currency,
+      lineItems: adminFeAuthoritativeReceipt.lineItems.map((line) => ({
+        type: String(line.type || 'FEE'),
+        label: String(line.label || 'Adjustment'),
+        amount: Number(line.amount) || 0,
+        ...(line.quantity != null ? { quantity: Number(line.quantity) || 0 } : {}),
+      })),
+    };
+  }, [adminFeAuthoritativeReceipt, currency, useAdminFeAuthoritativeQuote]);
+
   const changeFlowClientEstimateDueBase = (() => {
     if (!originalReceipt) return totalPrice;
     if (unchangedReceiptAnchor) return 0;
@@ -5392,6 +5408,7 @@ export function AdminChangeBookingFlow({
                         : {}),
                     }
                   : undefined,
+              authoritativeReceipt: providerApplyAuthoritativeReceipt,
               capacitySeatCredit: {
                 enabled: true,
                 previousPassengerCount: changeFlowInitialTicketCount,
@@ -5787,6 +5804,7 @@ export function AdminChangeBookingFlow({
                     : {}),
                 }
               : undefined,
+          authoritativeReceipt: providerApplyAuthoritativeReceipt,
           capacitySeatCredit: {
             enabled: true,
             previousPassengerCount: changeFlowInitialTicketCount,

package/src/components/booking/PrivateShuttleBookingFlow.tsx

@@ -119,6 +119,27 @@ interface PrivateShuttleBookingFlowProps {
 const RESOURCE_CAPACITY = 13;
 const ADDITIONAL_HOUR_PRICE = 170;
 const DATE_ONLY_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+const MORAINE_LAKE_ROAD_ACCESS_FEE_TOOLTIP =
+  "Since 2025, Parks Canada charges a per-trip fee for License of Occupation at Moraine Lake. This fee contributes towards Parks Canada's Moraine Lake Road operations.";
+
+function isMoraineLakeRoadAccessFeeName(name: string): boolean {
+  const normalized = name.toLowerCase();
+  return (
+    normalized.includes('moraine') &&
+    (normalized.includes('access') ||
+      normalized.includes('road') ||
+      normalized.includes('license'))
+  );
+}
+
+function isMoraineLakeLocationText(value: string): boolean {
+  const normalized = value.toLowerCase().replace(/[_-]+/g, ' ');
+  return normalized.includes('moraine') && normalized.includes('lake');
+}
+
+function roundMoney(amount: number): number {
+  return Math.round(amount * 100) / 100;
+}
 
 function parseAvailabilityDateTime(value: string): Date {
   // If API omits timezone offset, treat it as UTC to prevent user-local day shifts.
@@ -352,7 +373,7 @@ export function PrivateShuttleBookingFlow({
     itineraryDisplay?: ItineraryDisplayStep[] | null;
     clientSecret: string;
     ticketLinesForModal: CheckoutModalLineItem[];
-    feeLineItems: { name: string; totalAmount: number }[];
+    feeLineItems: { name: string; totalAmount: number; description?: string }[];
     cancellationPolicyFee: number;
     cancellationPolicyLabel?: string;
     subtotal: number;
@@ -1095,6 +1116,38 @@ export function PrivateShuttleBookingFlow({
   const cancellationPolicyFee = selectedCancellationPolicy
     ? (selectedCancellationPolicy.feeByCurrency[currency] ?? 0)
     : 0;
+  const draftItineraryIncludesMoraineLake = useMemo(() => {
+    if (draftItineraryDestinations.length === 0) return false;
+    const destinationLabelsById = new Map(
+      (product.itineraryBuilder?.destinations ?? []).map((destination) => [
+        destination.id,
+        destination.label,
+      ])
+    );
+    return draftItineraryDestinations.some((destinationId) => {
+      const label = destinationLabelsById.get(destinationId);
+      return (
+        isMoraineLakeLocationText(destinationId) ||
+        (label ? isMoraineLakeLocationText(label) : false)
+      );
+    });
+  }, [draftItineraryDestinations, product.itineraryBuilder?.destinations]);
+  const perBookingFeeLineItems = useMemo(() => {
+    if (isTaxIncludedInPrice) return [];
+    const amountsByName = pricingConfig?.perBookingFeesByCurrency?.[currency];
+    if (!amountsByName) return [];
+    const feeMetadata = pricingConfig?.perBookingFees ?? {};
+    return Object.entries(amountsByName)
+      .filter(
+        ([name]) =>
+          draftItineraryIncludesMoraineLake || !isMoraineLakeRoadAccessFeeName(name)
+      )
+      .map(([name, amount]) => ({
+        name,
+        totalAmount: amount,
+        description: feeMetadata[name]?.description,
+      }));
+  }, [currency, draftItineraryIncludesMoraineLake, isTaxIncludedInPrice, pricingConfig]);
 
   const addOnTotal = useMemo(() => {
     let sum = 0;
@@ -1114,7 +1167,8 @@ export function PrivateShuttleBookingFlow({
   }, [addOnSelections, addOns]);
 
   const additionalHoursAmount = (isAdmin ? additionalHoursCount : 0) * ADDITIONAL_HOUR_PRICE;
-  const subtotal = basePrice + addOnTotal + additionalHoursAmount;
+  const perBookingFeeTotal = perBookingFeeLineItems.reduce((sum, fee) => sum + fee.totalAmount, 0);
+  const subtotal = basePrice + addOnTotal + additionalHoursAmount + perBookingFeeTotal;
   const effectivePromoDiscountAmount = promoDiscountAmount > 0 ? promoDiscountAmount : 0;
   const taxAmount = isTaxIncludedInPrice ? 0 : subtotal * taxRate;
   const effectiveTaxAmount =
@@ -1122,6 +1176,116 @@ export function PrivateShuttleBookingFlow({
       ? (isTaxIncludedInPrice ? 0 : (subtotal - effectivePromoDiscountAmount) * taxRate)
       : taxAmount;
   const totalPrice = subtotal + effectiveTaxAmount - effectivePromoDiscountAmount;
+  const providerChangeAuthoritativeReceipt = useMemo<
+    ProviderDashboardChangeBookingPayload['authoritativeReceipt']
+  >(() => {
+    const lineItems: NonNullable<
+      ProviderDashboardChangeBookingPayload['authoritativeReceipt']
+    >['lineItems'] = [
+      {
+        type: 'TICKET',
+        label: resourceCount > 1 ? 'Shuttles' : 'Shuttle',
+        amount: roundMoney(basePrice),
+        quantity: resourceCount,
+      },
+    ];
+
+    for (const sel of addOnSelections) {
+      const addOn = addOns.find((a) => a.addOnId === sel.addOnId);
+      if (!addOn) continue;
+      const hasVariant =
+        (addOn.variantType === 'single_choice' || addOn.variantType === 'multi_quantity') &&
+        sel.variantId;
+      const variant = hasVariant
+        ? addOn.variants?.find((v) => v.id === sel.variantId)
+        : null;
+      const amount = ((addOn.price ?? 0) + (variant?.priceAdjustment ?? 0)) * (sel.quantity ?? 1);
+      lineItems.push({
+        type: 'FEE',
+        label: variant?.label ? `${addOn.name} (${variant.label})` : addOn.name,
+        amount: roundMoney(amount),
+      });
+    }
+
+    if (additionalHoursAmount > 0) {
+      lineItems.push({
+        type: 'FEE',
+        label:
+          additionalHoursCount === 1
+            ? 'Additional hour'
+            : `Additional hours (${additionalHoursCount})`,
+        amount: roundMoney(additionalHoursAmount),
+      });
+    }
+
+    for (const fee of perBookingFeeLineItems) {
+      lineItems.push({
+        type: 'FEE',
+        label: fee.name,
+        amount: roundMoney(fee.totalAmount),
+      });
+    }
+
+    if (cancellationPolicyFee > 0 && selectedCancellationPolicy) {
+      lineItems.push({
+        type: 'CANCELLATION_UPGRADE',
+        label: selectedCancellationPolicy.label,
+        amount: roundMoney(cancellationPolicyFee),
+      });
+    }
+
+    if (effectiveTaxAmount > 0) {
+      lineItems.push({
+        type: 'TAX',
+        label: t('booking.tax') !== 'booking.tax' ? t('booking.tax') : 'Taxes and fees',
+        amount: roundMoney(effectiveTaxAmount),
+      });
+    }
+
+    if (effectivePromoDiscountAmount > 0) {
+      lineItems.push({
+        type: isGiftCard ? 'GIFT_CARD' : 'PROMO_CODE',
+        label: activePromoCode ? `Promo: ${activePromoCode}` : (t('booking.discount') || 'Discount'),
+        amount: roundMoney(-effectivePromoDiscountAmount),
+      });
+    }
+
+    const expectedTotal = roundMoney(totalPrice);
+    const lineTotal = roundMoney(lineItems.reduce((sum, line) => sum + line.amount, 0));
+    const roundingDelta = roundMoney(expectedTotal - lineTotal);
+    if (Math.abs(roundingDelta) >= 0.01) {
+      lineItems.push({
+        type: 'ROUNDING',
+        label: t('booking.rounding') || 'Rounding',
+        amount: roundingDelta,
+      });
+    }
+
+    return {
+      currency,
+      lineItems,
+      subtotalBeforeTax: roundMoney(expectedTotal - roundMoney(effectiveTaxAmount)),
+      taxAmount: roundMoney(effectiveTaxAmount),
+      totalAmount: expectedTotal,
+    };
+  }, [
+    activePromoCode,
+    addOnSelections,
+    addOns,
+    additionalHoursAmount,
+    additionalHoursCount,
+    basePrice,
+    cancellationPolicyFee,
+    currency,
+    effectivePromoDiscountAmount,
+    effectiveTaxAmount,
+    isGiftCard,
+    perBookingFeeLineItems,
+    resourceCount,
+    selectedCancellationPolicy,
+    t,
+    totalPrice,
+  ]);
 
   useEffect(() => {
     if (!onPricePreviewChange) return;
@@ -1645,6 +1809,7 @@ export function PrivateShuttleBookingFlow({
           promoCode: activePromoCode ?? null,
           newTotalAmount: totalPrice,
           additionalHoursCount: isAdmin ? additionalHoursCount : null,
+          authoritativeReceipt: providerChangeAuthoritativeReceipt,
         });
         setLoading(false);
         return;
@@ -1792,6 +1957,11 @@ export function PrivateShuttleBookingFlow({
               },
             ]
           : []),
+        ...perBookingFeeLineItems.map((fee) => ({
+          label: fee.name,
+          amount: fee.totalAmount,
+          type: 'FEE' as const,
+        })),
         ...(cancellationPolicyFee > 0 && selectedCancellationPolicy
           ? [
               {
@@ -1929,23 +2099,26 @@ export function PrivateShuttleBookingFlow({
               breakdown: null,
             },
           ],
-          feeLineItems: addOnSelections
-            .map((sel) => {
-              const addOn = addOns.find((a) => a.addOnId === sel.addOnId);
-              if (!addOn) return null;
-              const base = addOn.price ?? 0;
-              const hasVariant =
-                (addOn.variantType === 'single_choice' || addOn.variantType === 'multi_quantity') &&
-                sel.variantId;
-              const adj = hasVariant
-                ? (addOn.variants?.find((v) => v.id === sel.variantId)?.priceAdjustment ?? 0)
-                : 0;
-              return {
-                name: addOn.name,
-                totalAmount: (base + adj) * (sel.quantity ?? 1),
-              };
-            })
-            .filter(Boolean) as { name: string; totalAmount: number }[],
+          feeLineItems: [
+            ...addOnSelections
+              .map((sel) => {
+                const addOn = addOns.find((a) => a.addOnId === sel.addOnId);
+                if (!addOn) return null;
+                const base = addOn.price ?? 0;
+                const hasVariant =
+                  (addOn.variantType === 'single_choice' || addOn.variantType === 'multi_quantity') &&
+                  sel.variantId;
+                const adj = hasVariant
+                  ? (addOn.variants?.find((v) => v.id === sel.variantId)?.priceAdjustment ?? 0)
+                  : 0;
+                return {
+                  name: addOn.name,
+                  totalAmount: (base + adj) * (sel.quantity ?? 1),
+                };
+              })
+              .filter(Boolean) as { name: string; totalAmount: number }[],
+            ...perBookingFeeLineItems,
+          ],
           cancellationPolicyFee,
           cancellationPolicyLabel: selectedCancellationPolicy?.label,
           subtotal,
@@ -2036,7 +2209,7 @@ export function PrivateShuttleBookingFlow({
           breakdown: null,
         },
       ];
-      const feeLineItemsForModal = addOnSelections
+      const addOnFeeLineItemsForModal = addOnSelections
         .map((sel) => {
           const addOn = addOns.find((a) => a.addOnId === sel.addOnId);
           if (!addOn) return null;
@@ -2053,6 +2226,7 @@ export function PrivateShuttleBookingFlow({
           };
         })
         .filter(Boolean) as { name: string; totalAmount: number }[];
+      const feeLineItemsForModal = [...addOnFeeLineItemsForModal, ...perBookingFeeLineItems];
 
       setCheckoutClientSecret(paymentIntent.clientSecret ?? '');
       setCheckoutModalData({
@@ -2913,6 +3087,15 @@ export function PrivateShuttleBookingFlow({
                         },
                       ]
                     : []),
+                  ...perBookingFeeLineItems.map((fee) => ({
+                    kind: 'line' as const,
+                    label: fee.name,
+                    amount: fee.totalAmount,
+                    type: 'fee' as const,
+                    tooltip: isMoraineLakeRoadAccessFeeName(fee.name)
+                      ? MORAINE_LAKE_ROAD_ACCESS_FEE_TOOLTIP
+                      : undefined,
+                  })),
                   ...(cancellationPolicyFee > 0
                     ? [
                         {

package/src/components/booking/provider-dashboard-change-booking.ts

@@ -26,6 +26,17 @@ export type ProviderDashboardChangeBookingPayload = {
     /** Signed major-unit rows; may include admin custom receipt lines merged with provider inline adjustments. */
     additionalAdjustments?: Array<{ label: string; amount: number }>;
   } | null;
+  /**
+   * Admin/provider change flow: when FE-authoritative quoting is used, apply must persist
+   * the exact receipt that was quoted instead of rebuilding from catalog pricing.
+   */
+  authoritativeReceipt?: {
+    currency?: string | null;
+    lineItems: Array<{ type: string; label: string; amount: number; quantity?: number; reference?: string }>;
+    subtotalBeforeTax: number;
+    taxAmount: number;
+    totalAmount: number;
+  } | null;
   capacitySeatCredit?: {
     enabled: boolean;
     previousPassengerCount?: number | null;

package/src/lib/booking/pricing.ts

@@ -450,15 +450,26 @@ export function computeOrderSummary(
       : 0;
 
   const fees = pricingConfig.fees ?? {};
-  const byCurrency = hasFees ? pricingConfig.feesByCurrency?.[currency] : undefined;
-  const feeLineItems: OrderSummaryFeeLine[] =
-    !hasFees || totalQuantity === 0 || isTaxIncludedInPrice || byCurrency == null
+  const perBookingFees = pricingConfig.perBookingFees ?? {};
+  const perPersonByCurrency = hasFees ? pricingConfig.feesByCurrency?.[currency] : undefined;
+  const perBookingByCurrency = pricingConfig.perBookingFeesByCurrency?.[currency];
+  const perPersonFeeLineItems: OrderSummaryFeeLine[] =
+    !hasFees || totalQuantity === 0 || isTaxIncludedInPrice || perPersonByCurrency == null
       ? []
-      : Object.entries(byCurrency).map(([name, amountPerPerson]) => ({
+      : Object.entries(perPersonByCurrency).map(([name, amountPerPerson]) => ({
           name,
           totalAmount: round2(totalQuantity * amountPerPerson),
           description: fees[name]?.description,
         }));
+  const perBookingFeeLineItems: OrderSummaryFeeLine[] =
+    totalQuantity === 0 || isTaxIncludedInPrice || perBookingByCurrency == null
+      ? []
+      : Object.entries(perBookingByCurrency).map(([name, amountPerBooking]) => ({
+          name,
+          totalAmount: round2(amountPerBooking),
+          description: perBookingFees[name]?.description,
+        }));
+  const feeLineItems = [...perPersonFeeLineItems, ...perBookingFeeLineItems];
 
   const feesTotal = feeLineItems.reduce((s, f) => s + f.totalAmount, 0);
   const subtotal = round2(basePrice + returnPriceAdjustment + cancellationPolicyFee + feesTotal);

package/src/lib/booking-api.ts

@@ -850,6 +850,8 @@ export interface PricingConfig {
   currenciesWithTaxIncluded: string[];
   fees?: Record<string, { feePerPerson: number; description?: string }>;
   feesByCurrency?: Record<string, Record<string, number>>;
+  perBookingFees?: Record<string, { feePerBooking: number; description?: string }>;
+  perBookingFeesByCurrency?: Record<string, Record<string, number>>;
   exchangeRates?: Record<string, number>;
   cancellationPolicies?: CancellationPolicyOption[];
 }