@ticketboothapp/booking 0.1.23 → 1.2.24

package/src/lib/booking/checkout-breakdown.ts

@@ -1,69 +0,0 @@
-import type { CheckoutBreakdown, CheckoutReceiptLine } from '@/lib/booking-api';
-
-/**
- * Round to 2 decimal places. Used so breakdown amounts and totals are stable
- * and pass backend validation (sum of line items ≈ totalAmount within 0.02).
- */
-export function round2(n: number): number {
-  return Math.round(n * 100) / 100;
-}
-
-export interface CheckoutLineInput {
-  label: string;
-  amount: number;
-  type: string;
-  quantity?: number;
-}
-
-/** Line types for checkout breakdown. ADDITIONAL_HOURS reserved for future private shuttle extra hours. */
-export const CheckoutLineType = {
-  TICKET: 'TICKET',
-  DEPOSIT: 'DEPOSIT',
-  FEE: 'FEE',
-  RETURN_OPTION: 'return',
-  CANCELLATION_UPGRADE: 'cancellation',
-  TAX: 'TAX',
-  PROMO_CODE: 'PROMO_CODE',
-  ROUNDING: 'ROUNDING',
-  ADDITIONAL_HOURS: 'ADDITIONAL_HOURS', // Future: private shuttle extra hours line
-} as const;
-
-export interface BuildCheckoutBreakdownParams {
-  /** Line items in display order (tickets, return, cancellation, fees, tax, promo, etc.) */
-  lines: CheckoutLineInput[];
-  /** Total amount to charge (will be rounded to 2 decimals). */
-  totalAmount: number;
-  currency: string;
-  /** Label for rounding line when added (e.g. "Rounding"). */
-  roundingLabel: string;
-}
-
-/**
- * Builds a CheckoutBreakdown from the given lines and total.
- * Rounds each line amount to 2 decimals; if the sum differs from total by more than 0.02,
- * adds a rounding line so the backend validator accepts it.
- * Reused by BookingFlow and PrivateShuttleBookingFlow so Stripe and /manage match the UI.
- */
-export function buildCheckoutBreakdown(params: BuildCheckoutBreakdownParams): CheckoutBreakdown {
-  const { lines, totalAmount, currency, roundingLabel } = params;
-  const totalRounded = round2(totalAmount);
-  const lineItems: CheckoutReceiptLine[] = lines.map((line) => ({
-    label: line.label,
-    amount: round2(line.amount),
-    type: line.type,
-    quantity: line.quantity,
-  }));
-  const sumLines = lineItems.reduce((s, l) => s + l.amount, 0);
-  if (Math.abs(sumLines - totalRounded) > 0.02) {
-    lineItems.push({
-      label: roundingLabel,
-      amount: round2(totalRounded - sumLines),
-      type: 'ROUNDING',
-    });
-  }
-  return {
-    lineItems,
-    totalAmount: totalRounded,
-    currency,
-  };
-}

package/src/lib/booking/correlation-id.ts

@@ -1,46 +0,0 @@
-/**
- * One opaque id per browser tab/session for joining client telemetry → TicketBooth Lambda logs.
- */
-
-export const BOOKING_CORRELATION_HEADER = 'X-Correlation-Id';
-
-const STORAGE_KEY = 'tb_booking_correlation_id';
-
-function newCorrelationId(): string {
-  try {
-    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
-      return crypto.randomUUID();
-    }
-  } catch {
-    /* fall through */
-  }
-  return `${Date.now()}-${Math.random().toString(36).slice(2, 12)}`;
-}
-
-/** Stable for the lifetime of this tab's sessionStorage (until the tab closes / storage cleared). */
-export function getOrCreateBookingCorrelationId(): string {
-  if (typeof window === 'undefined') return '';
-  try {
-    let id = sessionStorage.getItem(STORAGE_KEY);
-    if (!id) {
-      id = newCorrelationId();
-      sessionStorage.setItem(STORAGE_KEY, id);
-    }
-    return id;
-  } catch {
-    return newCorrelationId();
-  }
-}
-
-/** Merge correlation header into outbound API headers (browser only). */
-export function withBookingCorrelationId(
-  headers: Record<string, string>
-): Record<string, string> {
-  if (typeof window === 'undefined') return headers;
-  const id = getOrCreateBookingCorrelationId();
-  if (!id) return headers;
-  return {
-    ...headers,
-    [BOOKING_CORRELATION_HEADER]: id,
-  };
-}

package/src/lib/booking/i18n/config.ts

@@ -1,21 +0,0 @@
-/**
- * i18n Configuration
- * 
- * This file sets up the internationalization configuration.
- * Currently supports English (en) as default, ready to add more languages.
- */
-
-export const locales = ['en', 'fr'] as const;
-export type Locale = (typeof locales)[number];
-
-export const defaultLocale: Locale = 'en';
-
-// Language display names
-export const languageNames: Record<Locale, string> = {
-  en: 'English',
-  fr: 'Français',
-  // Add more languages here:
-  // es: 'Español',
-  // de: 'Deutsch',
-};
-

package/src/lib/booking/i18n/index.tsx

@@ -1,144 +0,0 @@
-'use client';
-
-/**
- * i18n Utilities
- * 
- * Simple translation utilities for client components.
- * For server components, use next-intl directly.
- */
-
-import { useState, useEffect, createContext, useContext } from 'react';
-import type { ReactNode } from 'react';
-import messagesEn from './messages/en.json';
-import messagesFr from './messages/fr.json';
-import { defaultLocale, locales, type Locale } from './config';
-
-type Messages = typeof messagesEn;
-
-const messages: Record<Locale, Messages> = {
-  en: messagesEn,
-  fr: messagesFr,
-};
-
-// Context for locale
-const LocaleContext = createContext<{
-  locale: Locale;
-  setLocale: (locale: Locale) => void;
-}>({
-  locale: defaultLocale,
-  setLocale: () => {},
-});
-
-// Provider component
-export function LocaleProvider({ children }: { children: ReactNode }) {
-  // Always start with default locale to ensure server/client match
-  const [locale, setLocaleState] = useState<Locale>(defaultLocale);
-
-  // Load from localStorage after hydration to avoid SSR mismatch
-  useEffect(() => {
-    try {
-      const saved = localStorage.getItem('booking-locale') as Locale | null;
-      // Validate that saved locale is in our supported locales array
-      if (saved && locales.includes(saved)) {
-        setLocaleState(saved);
-      }
-    } catch (error) {
-      // localStorage might be disabled or throw errors
-      console.warn('Failed to read locale from localStorage:', error);
-    }
-  }, []);
-
-  const setLocale = (newLocale: Locale) => {
-    // Validate locale before setting
-    if (!locales.includes(newLocale)) {
-      console.warn(`Invalid locale: ${newLocale}. Falling back to ${defaultLocale}`);
-      setLocaleState(defaultLocale);
-      return;
-    }
-    
-    setLocaleState(newLocale);
-    if (typeof window !== 'undefined') {
-      try {
-        localStorage.setItem('booking-locale', newLocale);
-      } catch (error) {
-        // localStorage might be disabled or full
-        console.warn('Failed to save locale to localStorage:', error);
-      }
-    }
-  };
-
-  return (
-    <LocaleContext.Provider value={{ locale, setLocale }}>
-      {children}
-    </LocaleContext.Provider>
-  );
-}
-
-// Hook to use translations
-export function useTranslations() {
-  const { locale } = useContext(LocaleContext);
-  
-  // Ensure we have a valid locale, fallback to default if invalid
-  const validLocale = locales.includes(locale) ? locale : defaultLocale;
-  const currentMessages = messages[validLocale] || messages[defaultLocale];
-
-  const t = (key: string, params?: Record<string, string | number>): string => {
-    if (!key || typeof key !== 'string') {
-      console.warn('Invalid translation key:', key);
-      return String(key || '');
-    }
-
-    const keys = key.split('.');
-    let value: unknown = currentMessages;
-
-    for (const k of keys) {
-      if (value === null || value === undefined) {
-        break;
-      }
-      // Safe property access on unknown type
-      value = (value as Record<string, unknown>)[k];
-    }
-
-    if (value === undefined || value === null) {
-      // In development, show the key to help identify missing translations
-      if (process.env.NODE_ENV === 'development') {
-        console.warn(`Translation key not found: ${key} (locale: ${validLocale})`);
-      }
-      return key;
-    }
-
-    // Ensure value is a string
-    if (typeof value !== 'string') {
-      console.warn(`Translation value is not a string for key: ${key}`);
-      return key;
-    }
-
-    // Simple parameter replacement
-    if (params) {
-      return value.replace(/\{(\w+)\}/g, (match, paramKey) => {
-        const paramValue = params[paramKey];
-        return paramValue !== undefined && paramValue !== null 
-          ? String(paramValue) 
-          : match;
-      });
-    }
-
-    return value;
-  };
-
-  return { t };
-}
-
-// Hook to use locale switching
-export function useLocale() {
-  return useContext(LocaleContext);
-}
-
-// Type-safe translation key helper
-export type TranslationKey = 
-  | `common.${keyof Messages['common']}`
-  | `booking.${keyof Messages['booking']}`
-  | `pickup.${keyof Messages['pickup']}`
-  | `calendar.${keyof Messages['calendar']}`
-  | `products.${keyof Messages['products']}`;
-

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

@@ -1,236 +0,0 @@
-{
-  "common": {
-    "back": "Back",
-    "continue": "Continue",
-    "select": "Select",
-    "change": "Change",
-    "cancel": "Cancel",
-    "close": "Close",
-    "videoPause": "Pause video",
-    "videoPlay": "Play video",
-    "videoMute": "Mute",
-    "videoUnmute": "Unmute",
-    "loading": "Loading...",
-    "error": "Error",
-    "total": "Total",
-    "email": "Email",
-    "emailPlaceholder": "your@email.com",
-    "emailForConfirmation": "Email (for confirmation)"
-  },
-  "booking": {
-    "selectDate": "Select Date",
-    "selectPickupTime": "Select Pickup Time",
-    "requestDifferentTime": "Request different time",
-    "preferredPickupTime": "Preferred pickup time",
-    "selectReturnTime": "Select Return Time",
-    "selectPhotoSessionTime": "Select session time",
-    "dapPhotoSessionAddOn": "Photo session (add-on)",
-    "dapYourCurrentItinerary": "Your current itinerary",
-    "dapRefItineraryLoading": "Looking up your booking…",
-    "dapRefItineraryEmpty": "We didn’t get shuttle times for this reference yet. Your booking may still be valid — choose a session length (if needed) and load available times.",
-    "dapRefItineraryLookupFailed": "We couldn’t find a booking with that reference, or it isn’t eligible for this add-on. Double-check the code from your confirmation.",
-    "dapItineraryFallbackFoot": "After you pay, you’ll see this add-on with your full itinerary in Manage booking.",
-    "mostPopular": "Most popular",
-    "pickupAtTourStart": "<b>Your pickup time depends on your pickup location.</b><br>Your exact pickup time will be confirmed once you have confirmed your pickup location. Pickups start in Canmore and end in Lake Louise.",
-    "pickupAtTourStartLocation": "tour start location",
-    "pickupLocationUnknown": "I don't know",
-    "arrivalTimeMessage": "You'll arrive at {destination} around <b>{time}</b>.",
-    "yourItinerary": "Your Itinerary",
-    "buildYourItinerary": "Build Your Itinerary",
-    "selectPickupTimeToSeeItinerary": "Select a pickup time below to see your schedule.",
-    "selectTourOption": "Select Tour Option",
-    "selectTourOptionToSeeItinerary": "Select a tour option below to see your itinerary.",
-    "timesToBeDetermined": "times to be determined/confirmed…",
-    "proposedStops": "Proposed stops",
-    "orderAndTimesToBeConfirmed": "(order and times to be confirmed by our team)",
-    "startingAtPerShuttle": "Starting at {price} per shuttle",
-    "hoursTour": "{hours} hr tour",
-    "hoursTourStarting": "Tour starting with {hours} hours",
-    "startingAtForHours": "Starting at {price} per shuttle for {hours}.",
-    "hoursUnit": "hours",
-    "additionalHoursAvailable": "Additional hours available for a fee.",
-    "pickupAt": "Pickup at",
-    "pickupAtPrefix": "Pickup at ",
-    "pickupAtLocation": "Pickup at {location}",
-    "arriveAt": "Arrive at",
-    "arriveAtPlace": "Arrive at {place}",
-    "departFrom": "Depart",
-    "departFromPlace": "Depart {place}",
-    "dropOffAt": "Drop off at {location}",
-    "dropOffAtPrefix": "Drop off at ",
-    "tripEnd": "Trip ends",
-    "stopAtPlaceTbd": "Stop at {place} (time TBD)",
-    "placeTheDestination": "the destination",
-    "dropOffAtPickup": "Arrive at {pickupLocation}",
-    "yourPickupLocation": "your pickup location",
-    "tickets": "Tickets",
-    "overbookingWarnDeparture": "WARN OVERBOOKING: Only {count} seats available on {time} departure.",
-    "overbookingWarnReturn": "WARN OVERBOOKING: Only {count} seats available on {time} return.",
-    "overbookingWarnBoth": "WARN OVERBOOKING: Only {count} seats available on both trip directions.",
-    "overbookingResourcesSuffix": "({count} shared resources.)",
-    "adminBookingLoadLine1": "Booking {projected} /",
-    "adminBookingLoadLine2": "{total} total",
-    "available": "available",
-    "soldOut": "Sold out",
-    "continueToPayment": "Continue to Payment",
-    "continueToSecurePayment": "Continue to secure payment",
-    "preparingCheckout": "Preparing…",
-    "creatingReservation": "Creating reservation...",
-    "securePayment": "Secure payment powered by Stripe",
-    "selectTimeAndTickets": "Please select a time and at least one ticket",
-    "selectPickupLocation": "Please select a pickup location",
-    "loadingTimes": "Loading available times...",
-    "noAvailability": "No availability found for the next 30 days. Please check back later.",
-    "seeFullTourDescription": "See full tour description",
-    "seeFullAddOnDescription": "See full experience details",
-    "communicationPreference": "How would you like to receive future communication (confirmation, reminders, etc.)?",
-    "communicationEmail": "Email",
-    "communicationEmailDesc": "Send confirmation via email",
-    "communicationWhatsApp": "WhatsApp",
-    "communicationWhatsAppDesc": "Send confirmation via WhatsApp",
-    "emailForConfirmation": "Email",
-    "phoneNumberForConfirmation": "WhatsApp Phone Number",
-    "phoneNumberPlaceholder": "(555) 123-4567",
-    "invalidEmail": "Please enter a valid email address",
-    "invalidPhoneNumber": "Please enter a valid phone number",
-    "selectCommunicationPreference": "Please select how you would like to receive your confirmation",
-    "enterEmail": "Please enter your email address",
-    "enterFirstName": "Please enter your first name",
-    "enterLastName": "Please enter your last name",
-    "enterPhoneNumber": "Please enter your phone number",
-    "firstName": "First Name",
-    "firstNamePlaceholder": "Jane",
-    "lastName": "Last Name",
-    "lastNamePlaceholder": "Smith",
-    "dapNoLastNameOnFile": "We couldn’t find a last name on this booking in our system. Please contact us, or use Manage booking with the last name from your confirmation email.",
-    "dapCancellationPolicyHeading": "Cancellation policy",
-    "dapCancellationPolicyBody": "You may cancel this add-on for a full refund up to {days} {daysUnit} before your scheduled photo session. Cancellations made after that deadline may forfeit the entire add-on cost.",
-    "dapCancellationPolicyDayUnit": "day",
-    "dapCancellationPolicyDaysUnit": "days",
-    "noActiveOption": "No active product options available",
-    "people": "people",
-    "person": "person",
-    "rounding": "Rounding",
-    "deposit": "Deposit",
-    "totalOwedForBookingChange": "Total owed for booking difference",
-    "subtotal": "Subtotal",
-    "tax": "Taxes and fees",
-    "returnOption": "Return Option",
-    "fromPrice": "From {price}",
-    "communicationPermission": "By providing your contact information, you give permission to receive booking confirmations, reminders, and updates via this method.",
-    "communicationPermissionCheckbox": "I give permission to receive communication via this method",
-    "communicationPermissionRequired": "Please select at least one communication method",
-    "emailPermissionCheckbox": "Contact me by email (we will only send you communication relevant to your booking)",
-    "whatsappPermissionCheckbox": "Contact me by WhatsApp (we will only send you communication relevant to your booking)",
-    "reviewAndPay": "Review & pay",
-    "payNow": "Pay now",
-    "paying": "Paying...",
-    "checkout": "Checkout",
-    "paymentNotConfigured": "Payment is not configured. Please use the standard checkout.",
-    "loadingPayment": "Loading payment form...",
-    "promoCode": "Promo code",
-    "optionalPromoCode": "Promo / voucher / gift card",
-    "promoCodePlaceholder": "Enter code",
-    "applyPromo": "Apply",
-    "removePromo": "Remove",
-    "promoApplied": "Applied: {{code}}",
-    "invalidPromoCode": "Invalid or expired promo code",
-    "promoCodesCannotStackWithDiscounts": "Promo codes cannot be stacked with deals",
-    "discount": "Discount",
-    "cancellationPolicy": "Cancellation policy",
-    "promoIncludesCancellationPolicy": "This promo includes {label} cancellation policy",
-    "cancellationRefundTierDays": "Cancel <b>{days} days before</b> for <b>{percent}% refund</b>",
-    "cancellationRefundTierHours": "Cancel <b>{hours} hours before</b> for <b>{percent}% refund</b>",
-    "cancellationNoRefunds": "<b>No cancellation, no refunds</b>. You can make changes to your booking up to <b>{days} days before</b>.",
-    "cancellationNoRefundsNoDays": "<b>No cancellation, no refunds</b>. You can make changes to your booking before your booking date.",
-    "cancellationStandard": "Standard cancellation",
-    "included": "Included",
-    "flexibleCancellation": "Flexible cancellation",
-    "depositPaymentNotice": "You're paying the deposit today.",
-    "balanceChargeNotice": "The remaining balance will be charged {days} days before your booking. You can also pay it earlier from your Manage Booking page.",
-    "balancePayEarlier": "You can pay the remaining balance anytime from your Manage Booking page.",
-    "remainingBalance": "Remaining Balance"
-  },
-  "pickup": {
-    "title": "Select your pickup location",
-    "yesAddNow": "I know where I want to be picked up",
-    "dontKnow": "I don't know yet",
-    "pickupLocation": "Pickup Location",
-    "enterAddress": "Enter your pickup address",
-    "searchingLocation": "Searching for location...",
-    "locationNotFound": "Could not find that location. Please try a different address.",
-    "chooseNearby": "Choose a pickup location nearby",
-    "exactMatch": "Exact match found",
-    "locationsInCity": "Pickup locations in {{city}}",
-    "selectThisLocation": "Select This Location",
-    "yourLocation": "Your Location",
-    "chooseClosest": "Choose a pickup location below to see the closest option.",
-    "useThisAddress": "Use this address",
-    "away": "away",
-    "walk": "walk",
-    "drive": "drive",
-    "switchUnits": "Switch to {unit} units",
-    "metric": "metric",
-    "imperial": "imperial",
-    "dontKnowSubtext": "We will send you reminders to select your pickup location.",
-    "yesAddNowSubtext": "You can change this later.",
-    "skipWarningTitle": "Important Notice",
-    "skipWarningMessage": "You are not guaranteed to be picked up if you do not <b>update your booking with your pickup location at least 12 hours prior</b>.",
-    "iUnderstand": "I understand",
-    "nevermindSelectLocation": "Nevermind, I'll select my location",
-    "outsideServiceArea": "This address is outside our service area. We offer pickups between Lake Louise and Kananaskis. Please choose a preset location or search for an address in that area."
-  },
-  "calendar": {
-    "previousWeeks": "Previous 2 weeks",
-    "nextWeeks": "Next 2 weeks",
-    "soldOut": "Sold out",
-    "left": "{count} left",
-    "timesAvailable": "{count} times",
-    "spotsAvailable": "{count} available",
-    "available": "Available",
-    "days": {
-      "sun": "SUN",
-      "mon": "MON",
-      "tue": "TUE",
-      "wed": "WED",
-      "thu": "THU",
-      "fri": "FRI",
-      "sat": "SAT"
-    },
-    "months": {
-      "january": "January",
-      "february": "February",
-      "march": "March",
-      "april": "April",
-      "may": "May",
-      "june": "June",
-      "july": "July",
-      "august": "August",
-      "september": "September",
-      "october": "October",
-      "november": "November",
-      "december": "December"
-    }
-  },
-  "products": {
-    "backToExperiences": "Back to experiences",
-    "from": "From",
-    "noDescription": "No description available",
-    "productGridFilters": {
-      "all": "All",
-      "moraineLake": "Moraine Lake",
-      "lakeLouise": "Lake Louise",
-      "emeraldLake": "Emerald Lake",
-      "private": "Private",
-      "sunrise": "Sunrise"
-    }
-  },
-  "terms": {
-    "title": "Terms & Conditions",
-    "viewTerms": "Terms & Conditions",
-    "acceptPrefix": "I accept the",
-    "acceptAndClose": "I've read and accept",
-    "content": "By completing this booking you agree to the following terms and conditions.\n\n1. Booking and payment\nYour reservation is confirmed once payment has been processed. You will receive a confirmation by email or the contact method you selected.\n\n2. Cancellation and changes\nCancellation and change policies depend on the option you selected at checkout. Please refer to your confirmation for the policy that applies to your booking.\n\n3. Participation\nYou are responsible for arriving at the designated time and location. Late arrival may result in forfeiting the experience without refund.\n\n4. Liability\nThe operator is not liable for loss or damage beyond what is required by applicable law. Participation is at your own risk where activities involve inherent risk.\n\n5. Contact\nFor questions or changes to your booking, use the contact details provided in your confirmation."
-  }
-}
-