@ticketboothapp/booking 0.1.11 → 0.1.12

package/src/lib/manage-booking-post-checkout.ts

@@ -0,0 +1,68 @@
+/**
+ * Manage-booking post-checkout helpers.
+ *
+ * Next.js `router.replace` remounts the page; React state for a success banner is lost.
+ * We stash a one-time marker in sessionStorage immediately before cleaning the URL
+ * (only paid *change booking* Stripe returns). New bookings use `reservationRef` → `ref`
+ * and never set this flag.
+ *
+ * We intentionally do not poll the booking API here: one landing fetch + optional remount
+ * fetch after `replace` is enough; avoid timers/retry loops that feel like “random” refreshes.
+ */
+const STORAGE_KEY = 'viavia:manage-booking:flash:v1';
+
+export const MANAGE_BOOKING_QUERY_FROM = 'from';
+/** Only paid *change booking* Stripe returns add this; new bookings must not use it. */
+export const MANAGE_BOOKING_FROM_CHANGE_PAYMENT = 'change_payment';
+
+/** Success copy for any self-serve booking change (no-pay, paid-after-Stripe, etc.). */
+export function manageBookingChangeSuccessMessage(
+  preview: {
+    dateChanged?: boolean;
+    ticketsChanged?: boolean;
+  } | null,
+): string {
+  const updates: string[] = [];
+  if (preview?.dateChanged) updates.push('date/time');
+  if (preview?.ticketsChanged) updates.push('ticket selection');
+  const suffix =
+    updates.length > 0 ? ` Updated ${updates.join(' and ')}.` : '';
+  return `Your booking was updated successfully.${suffix}`;
+}
+
+export type ManageBookingFlashPayload = {
+  v: 1;
+  kind: 'change_payment_success';
+  t: number;
+};
+
+export function setManageBookingFlashChangePaymentSuccess(): void {
+  if (typeof window === 'undefined') return;
+  try {
+    const payload: ManageBookingFlashPayload = {
+      v: 1,
+      kind: 'change_payment_success',
+      t: Date.now(),
+    };
+    sessionStorage.setItem(STORAGE_KEY, JSON.stringify(payload));
+  } catch {
+    /* private mode / quota */
+  }
+}
+
+/** Read and clear. Returns user-facing message or null. */
+export function consumeManageBookingFlash(): string | null {
+  if (typeof window === 'undefined') return null;
+  try {
+    const raw = sessionStorage.getItem(STORAGE_KEY);
+    if (!raw) return null;
+    sessionStorage.removeItem(STORAGE_KEY);
+    const j = JSON.parse(raw) as ManageBookingFlashPayload;
+    if (j?.v === 1 && j.kind === 'change_payment_success') {
+      return manageBookingChangeSuccessMessage(null);
+    }
+  } catch {
+    /* ignore */
+  }
+  return null;
+}

package/src/lib/photo-dap-config.ts

@@ -0,0 +1,228 @@
+/**
+ * Maps photo-sessions packages to TicketBooth dependent add-on product (and optional option) IDs.
+ * Set NEXT_PUBLIC_DAP_* in .env.local to override seed defaults (e.g. other envs or 60/90 min options).
+ */
+
+import { IMAGES } from '@/constants/images';
+
+/**
+ * Default full-refund cancellation window (days before the scheduled photo session).
+ * Override per catalog entry in `getPhotoDapCatalog` when a DAP product differs.
+ */
+export const DEFAULT_PHOTO_DAP_CANCELLATION_DAYS_BEFORE_SESSION = 30;
+
+/** Seeded test DAP: Friends, Family, & Couples (`dependent-add-on-products.json`) */
+const COUPLES_SESSION_DEFAULT_PRODUCT_ID = 'dap_sM8pSzbFfU7P';
+const ELOPEMENTS_SESSION_DEFAULT_PRODUCT_ID = 'dap_6tITweGzVyg8';
+const PROPOSALS_SESSION_DEFAULT_PRODUCT_ID = 'dap_Xy3OCPIKQ7vr';
+
+/** Session lengths for couples / families card — matches `dependent-add-on-products.json` options */
+const COUPLES_SESSION_PRODUCT_OPTIONS = [
+  {
+    dependentAddOnProductOptionId: 'dapo_Ey0v4O7BjFaD',
+    label: '30 minutes',
+    photosLabel: '25 photos',
+    startingAtLabel: 'Starting at $499',
+  },
+  {
+    dependentAddOnProductOptionId: 'dapo_caJh25HsTwKx',
+    label: '60 minutes',
+    photosLabel: '50 photos',
+    startingAtLabel: 'Starting at $799',
+  },
+  {
+    dependentAddOnProductOptionId: 'dapo_6Km5njalQBp1',
+    label: '90 minutes',
+    photosLabel: '75 photos',
+    startingAtLabel: 'Starting at $799',
+  },
+] as const;
+
+const ELOPEMENTS_SESSION_PRODUCT_OPTIONS = [
+  {
+    dependentAddOnProductOptionId: 'dapo_XTeJt09NyNfX',
+    label: '30 minutes',
+    photosLabel: '25 photos',
+    startingAtLabel: 'Starting at $799',
+  },
+  {
+    dependentAddOnProductOptionId: 'dapo_Y8AxYt6Tjaam',
+    label: '60 minutes',
+    photosLabel: '50 photos',
+    startingAtLabel: 'Starting at $999',
+  },
+  {
+    dependentAddOnProductOptionId: 'dapo_YdmxIiQPxEJg',
+    label: '90 minutes',
+    photosLabel: '75 photos',
+    startingAtLabel: 'Starting at $1199',
+  },
+] as const;
+
+const PROPOSALS_SESSION_PRODUCT_OPTIONS = [
+  {
+    dependentAddOnProductOptionId: 'dapo_SMRxjfDpIvwU',
+    label: '30 minutes',
+    photosLabel: '25 photos',
+    startingAtLabel: 'Starting at $799',
+  },
+  {
+    dependentAddOnProductOptionId: 'dapo_FyMbFgrBU4L8',
+    label: '60 minutes',
+    photosLabel: '50 photos',
+    startingAtLabel: 'Starting at $999',
+  },
+  {
+    dependentAddOnProductOptionId: 'dapo_EOohfF0g2i1D',
+    label: '90 minutes',
+    photosLabel: '75 photos',
+    startingAtLabel: 'Starting at $1199',
+  },
+] as const;
+
+export const PHOTO_DAP_SLUGS = [
+  'session-couples-families-friends',
+  'session-elopements',
+  'session-proposals',
+] as const;
+
+export type PhotoDapSlug = (typeof PHOTO_DAP_SLUGS)[number];
+
+export type PhotoDapProductOption = {
+  dependentAddOnProductOptionId: string;
+  /** First line on the tile (e.g. duration). */
+  label: string;
+  /** Second line (e.g. edited photo count). */
+  photosLabel?: string;
+  /** Third line (e.g. "Starting at $399"). */
+  startingAtLabel?: string;
+};
+
+export type PhotoDapCatalog = {
+  dependentAddOnProductId: string;
+  /** When set, that option is fixed (no picker). Env `NEXT_PUBLIC_DAP_PHOTO_SESSION_COUPLES_OPTION_ID` forces this for couples. */
+  dependentAddOnProductOptionId?: string;
+  /** When multiple entries and no fixed option id, the dialog shows a session-length control */
+  productOptions?: PhotoDapProductOption[];
+  /** Bunny CDN IDs for DapFlowCollage (hero + four-tile grid) */
+  collageImageIds: string[];
+  /**
+   * Days before the scheduled photo session that a full refund still applies for this DAP product.
+   * Should match TicketBooth dependent add-on product config; availability API may override when present.
+   */
+  cancellationDaysBeforeSession: number;
+};
+
+/** Image sets for the dependent add-on dialog collage (photos only; no video). */
+export function photoDapCollageImageIds(slug: PhotoDapSlug): string[] {
+  switch (slug) {
+    case 'session-couples-families-friends':
+      return [
+        IMAGES.FAMILY_MORIANE_LAKE_ROCKPILE.id,
+        IMAGES.PRIVATE_TOUR_FAMILY_MORAINE_LAKE.id,
+        IMAGES.GIRLS_DAY_RAINY_LAKE_LOUISE.id,
+        IMAGES.MORAINE_LAKE_COUPLE_AT_WATER.id,
+        IMAGES.MORAINE_LAKE_SUNRISE_GIRL_FRIENDS.id,
+      ];
+    case 'session-elopements':
+      return [
+        IMAGES.MORAINE_LAKE_SUNRISE_ELOPEMENT.id,
+        IMAGES.SENTINEL_PASS_ELOPEMENT_SNOW.id,
+        IMAGES.MORAINE_LAKE_ELOPEMENT.id,
+        IMAGES.SENTINEL_PASS_ELOPEMENT_SNOW_HORIZONTAL.id,
+        IMAGES.MORAINE_LAKE_ELOPEMENT_LAKESHORE.id,
+      ];
+    case 'session-proposals':
+      return [
+        IMAGES.LAKE_LOUISE_KISS.id,
+        IMAGES.MORAINE_LAKE_PROPOSE_CRY.id,
+        IMAGES.MORAINE_LAKE_OVERCAST_PROPOSE.id,
+        IMAGES.MORAINE_LAKE_PROPOSAL.id,
+        IMAGES.MORAINE_LAKE_PROPOSE.id,
+      ];
+  }
+}
+
+function trimEnv(value: string | undefined): string {
+  return (value ?? '').trim();
+}
+
+/**
+ * Returns catalog when product id is known (env or built-in default for couples session).
+ * Otherwise null (card falls back to #book-now).
+ */
+export function getPhotoDapCatalog(slug: PhotoDapSlug): PhotoDapCatalog | null {
+  if (slug === 'session-couples-families-friends') {
+    const productId =
+      trimEnv(process.env.NEXT_PUBLIC_DAP_PHOTO_SESSION_COUPLES_PRODUCT_ID) ||
+      COUPLES_SESSION_DEFAULT_PRODUCT_ID;
+    const forcedOptionId = trimEnv(
+      process.env.NEXT_PUBLIC_DAP_PHOTO_SESSION_COUPLES_OPTION_ID
+    );
+    const collageImageIds = photoDapCollageImageIds('session-couples-families-friends');
+    if (forcedOptionId) {
+      return {
+        dependentAddOnProductId: productId,
+        dependentAddOnProductOptionId: forcedOptionId,
+        collageImageIds,
+        cancellationDaysBeforeSession: DEFAULT_PHOTO_DAP_CANCELLATION_DAYS_BEFORE_SESSION,
+      };
+    }
+    return {
+      dependentAddOnProductId: productId,
+      productOptions: [...COUPLES_SESSION_PRODUCT_OPTIONS],
+      collageImageIds,
+      cancellationDaysBeforeSession: DEFAULT_PHOTO_DAP_CANCELLATION_DAYS_BEFORE_SESSION,
+    };
+  }
+
+  if (slug === 'session-elopements') {
+    const productId =
+      trimEnv(process.env.NEXT_PUBLIC_DAP_PHOTO_SESSION_ELOPEMENTS_PRODUCT_ID) ||
+      ELOPEMENTS_SESSION_DEFAULT_PRODUCT_ID;
+    const forcedOptionId = trimEnv(
+      process.env.NEXT_PUBLIC_DAP_PHOTO_SESSION_ELOPEMENTS_OPTION_ID
+    );
+    const collageImageIds = photoDapCollageImageIds('session-elopements');
+    if (forcedOptionId) {
+      return {
+        dependentAddOnProductId: productId,
+        dependentAddOnProductOptionId: forcedOptionId,
+        collageImageIds,
+        cancellationDaysBeforeSession: DEFAULT_PHOTO_DAP_CANCELLATION_DAYS_BEFORE_SESSION,
+      };
+    }
+    return {
+      dependentAddOnProductId: productId,
+      productOptions: [...ELOPEMENTS_SESSION_PRODUCT_OPTIONS],
+      collageImageIds,
+      cancellationDaysBeforeSession: DEFAULT_PHOTO_DAP_CANCELLATION_DAYS_BEFORE_SESSION,
+    };
+  }
+
+  if (slug === 'session-proposals') {
+    const productId =
+      trimEnv(process.env.NEXT_PUBLIC_DAP_PHOTO_SESSION_PROPOSALS_PRODUCT_ID) ||
+      PROPOSALS_SESSION_DEFAULT_PRODUCT_ID;
+    const forcedOptionId = trimEnv(
+      process.env.NEXT_PUBLIC_DAP_PHOTO_SESSION_PROPOSALS_OPTION_ID
+    );
+    const collageImageIds = photoDapCollageImageIds('session-proposals');
+    if (forcedOptionId) {
+      return {
+        dependentAddOnProductId: productId,
+        dependentAddOnProductOptionId: forcedOptionId,
+        collageImageIds,
+        cancellationDaysBeforeSession: DEFAULT_PHOTO_DAP_CANCELLATION_DAYS_BEFORE_SESSION,
+      };
+    }
+    return {
+      dependentAddOnProductId: productId,
+      productOptions: [...PROPOSALS_SESSION_PRODUCT_OPTIONS],
+      collageImageIds,
+      cancellationDaysBeforeSession: DEFAULT_PHOTO_DAP_CANCELLATION_DAYS_BEFORE_SESSION,
+    };
+  }
+
+  return null;
+}

package/src/lib/pickup/map-utils.ts

@@ -0,0 +1,56 @@
+/**
+ * Google Maps utilities for pickup location picker
+ */
+
+export interface MapCenter {
+  lat: number;
+  lng: number;
+}
+
+export interface PickupLocationWithCoords {
+  id: string;
+  name: string;
+  address: string;
+  coordinates?: { lat: number; lng: number };
+}
+
+const DEFAULT_CENTER: MapCenter = { lat: 51.1784, lng: -115.5708 };
+
+export function calculateMapCenter(pickupLocations: PickupLocationWithCoords[]): MapCenter {
+  const withCoords = pickupLocations.filter((l) => l.coordinates);
+  if (withCoords.length > 0 && withCoords[0].coordinates) {
+    return withCoords[0].coordinates;
+  }
+  return DEFAULT_CENTER;
+}
+
+export function getMapOptions(): google.maps.MapOptions {
+  return {
+    disableDefaultUI: false,
+    clickableIcons: false,
+    scrollwheel: true,
+    zoomControl: true,
+    streetViewControl: false,
+    mapTypeControl: false,
+    fullscreenControl: true,
+    gestureHandling: 'cooperative',
+  } as google.maps.MapOptions;
+}
+
+export function calculateMapBounds(
+  pickupLocations: PickupLocationWithCoords[]
+): google.maps.LatLngBounds | null {
+  if (typeof google === 'undefined' || !google.maps) return null;
+  try {
+    const bounds = new google.maps.LatLngBounds();
+    pickupLocations.forEach((loc) => {
+      if (loc.coordinates) bounds.extend(loc.coordinates);
+    });
+    return bounds.getNorthEast().lat() !== bounds.getSouthWest().lat() ||
+      bounds.getNorthEast().lng() !== bounds.getSouthWest().lng()
+      ? bounds
+      : null;
+  } catch {
+    return null;
+  }
+}

package/src/lib/pickup/marker-icons.ts

@@ -0,0 +1,19 @@
+/**
+ * Marker icon generation for pickup location pins
+ */
+
+function validateColor(color: string): string {
+  const hexColorRegex = /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/;
+  return hexColorRegex.test(color) ? color : '#dc2626';
+}
+
+export function createPinMarkerIcon(color: string): string {
+  const safeColor = validateColor(color);
+  return `data:image/svg+xml;charset=UTF-8,${encodeURIComponent(`
+    <svg width="32" height="40" viewBox="0 0 32 40" fill="none" xmlns="http://www.w3.org/2000/svg">
+      <path d="M16 0C7.163 0 0 7.163 0 16C0 24.837 16 40 16 40C16 40 32 24.837 32 16C32 7.163 24.837 0 16 0Z" fill="#ffffff"/>
+      <path d="M16 2C8.268 2 2 8.268 2 16C2 22.177 16 38 16 38C16 38 30 22.177 30 16C30 8.268 23.732 2 16 2Z" fill="${safeColor}"/>
+      <circle cx="16" cy="16" r="6" fill="#ffffff"/>
+    </svg>
+  `)}`;
+}

package/src/lib/product-descriptions.ts

@@ -0,0 +1,66 @@
+/**
+ * Product description content loader.
+ * Loads full tour descriptions from src/data/product-descriptions/{slug}.{locale}.json
+ */
+
+export interface ProductDescriptionReview {
+  text: string;
+  name: string;
+}
+
+/** Section content: string for HTML, string[] for bullet list OR joined HTML (array of lines for readability) */
+export type SectionContent = string | string[];
+
+export interface ProductDescriptionResult {
+  shortDescription?: string;
+  paragraphs: string[];
+  review?: ProductDescriptionReview;
+  sections: { title: string; content: SectionContent }[];
+}
+
+interface ProductDescriptionData {
+  shortDescription?: string;
+  paragraphs: string[];
+  review?: ProductDescriptionReview;
+  sections: { title: string; content: SectionContent }[];
+}
+
+// Static imports - add new locales here when available
+import moraineLakeSunriseLakeLouiseGoldenHourEn from '@/data/product-descriptions/moraine-lake-sunrise-lake-louise-golden-hour.en.json';
+import moraineLakeSunriseEn from '@/data/product-descriptions/moraine-lake-sunrise.en.json';
+import twoLakesComboEn from '@/data/product-descriptions/two-lakes-combo.en.json';
+import moraineLakeAdventureEn from '@/data/product-descriptions/moraine-lake-adventure.en.json';
+import lakeLouiseAdventureEn from '@/data/product-descriptions/lake-louise-adventure.en.json';
+import emeraldLakeEscapeEn from '@/data/product-descriptions/emerald-lake-escape.en.json';
+import afternoonDelightEn from '@/data/product-descriptions/afternoon-delight.en.json';
+import privateTourEn from '@/data/product-descriptions/private-tour.en.json';
+
+const DESCRIPTIONS: Record<string, Record<string, ProductDescriptionData>> = {
+  en: {
+    'moraine-lake-sunrise-lake-louise-golden-hour': moraineLakeSunriseLakeLouiseGoldenHourEn as ProductDescriptionData,
+    'moraine-lake-sunrise': moraineLakeSunriseEn as ProductDescriptionData,
+    'two-lakes-combo': twoLakesComboEn as ProductDescriptionData,
+    'moraine-lake-adventure': moraineLakeAdventureEn as ProductDescriptionData,
+    'lake-louise-adventure': lakeLouiseAdventureEn as ProductDescriptionData,
+    'emerald-lake-escape': emeraldLakeEscapeEn as ProductDescriptionData,
+    'afternoon-delight': afternoonDelightEn as ProductDescriptionData,
+    'private-tour': privateTourEn as ProductDescriptionData,
+  },
+  // Add fr, es etc. when files exist:
+  // fr: { ... },
+};
+
+export function getProductDescription(
+  slug: string,
+  locale: string
+): ProductDescriptionResult | null {
+  const localeData = DESCRIPTIONS[locale] ?? DESCRIPTIONS.en;
+  const data = localeData?.[slug];
+  if (!data) return null;
+  return {
+    shortDescription: data.shortDescription,
+    paragraphs: data.paragraphs ?? [],
+    review: data.review,
+    sections: data.sections ?? [],
+  };
+}

package/src/lib/products-config.ts

@@ -0,0 +1,73 @@
+/**
+ * Load products config from JSON (build-time / static).
+ * Later: can be swapped for API fetch or generated by TicketBooth script.
+ */
+
+import type { ProductsConfig, ProductConfig } from './booking-types';
+import type { Product, ProductOption } from '@/lib/booking-api';
+import { getImageUrl } from '@/constants/images';
+
+// Import JSON - Next.js supports this; ensure tsconfig has "resolveJsonModule": true
+import productsConfigJson from '@/data/products-config.json';
+
+const config = productsConfigJson as ProductsConfig;
+
+export function getProductsConfig(): ProductsConfig {
+  return config;
+}
+
+export function getProductsForBooking(): ProductConfig[] {
+  return config.products;
+}
+
+export function getProductBySlug(slug: string): ProductConfig | null {
+  return config.products.find((p) => p.display.slug === slug) ?? null;
+}
+
+export function getProductByOptionId(optionId: string): ProductConfig | null {
+  return (
+    config.products.find((p) => p.optionIds.includes(optionId)) ?? null
+  );
+}
+
+/** Find product by productId, optionId, or slug */
+export function getProductByIdOrSlug(idOrSlug: string): ProductConfig | null {
+  const bySlug = getProductBySlug(idOrSlug);
+  if (bySlug) return bySlug;
+  const byOption = getProductByOptionId(idOrSlug);
+  if (byOption) return byOption;
+  return config.products.find((p) => p.productId === idOrSlug) ?? null;
+}
+
+/**
+ * Build a minimal Product from config for immediate availability fetch.
+ * Use when API product is still loading - allows get-availabilities to run in parallel with /products.
+ */
+export function buildMinimalProductFromConfig(
+  config: ProductConfig,
+  companyId: string
+): Product {
+  const options: ProductOption[] = config.optionIds.map((optionId) => ({
+    optionId,
+    name: '',
+    description: null,
+    pricing: {},
+    status: 'ACTIVE',
+  }));
+  return {
+    productId: config.productId,
+    companyId,
+    name: config.display.shortName,
+    description: null,
+    status: 'ACTIVE',
+    productType: config.productType ?? 'STANDARD',
+    options,
+  };
+}
+
+/** Get image URL for a product (first image from config) */
+export function getProductImageUrl(product: ProductConfig): string {
+  const imageId = product.display.imageIds[0];
+  if (!imageId) return '';
+  return getImageUrl(imageId);
+}