@ticketboothapp/booking 1.2.48 → 1.2.50

package/src/contexts/AvailabilitiesCacheContext.tsx

@@ -0,0 +1,125 @@
+'use client';
+
+import {
+  createContext,
+  useContext,
+  useRef,
+  useCallback,
+  type ReactNode,
+} from 'react';
+import type { Availability, PricingConfig, PrecomputedPricesByCategory } from '../lib/booking-api';
+
+/** Cache TTL in milliseconds (5 minutes). Entries older than this are considered stale. */
+export const AVAILABILITIES_CACHE_TTL_MS = 5 * 60 * 1000;
+
+export interface CachedAvailabilitiesData {
+  fetchedRanges: Array<{ start: Date; end: Date }>;
+  availabilities: Availability[];
+  pricingConfig: PricingConfig | null;
+  precomputedPricesByOption: Record<string, PrecomputedPricesByCategory> | null;
+  /** Private Shuttle: shared precomputed prices (category -> currency -> price). */
+  precomputedPrices?: PrecomputedPricesByCategory | null;
+  /** Private Shuttle: resource price by currency. */
+  resourcePriceByCurrency?: Record<string, number> | null;
+  /** Private Shuttle: resource price by option (optionId -> currency -> price). */
+  resourcePriceByOption?: Record<string, Record<string, number>> | null;
+  /** Timestamp when this entry was cached (for TTL / stale-while-revalidate). */
+  cachedAt: number;
+}
+
+interface AvailabilitiesCacheContextValue {
+  /** Get cached data for a product+options+promo. Returns undefined if not cached. */
+  get: (cacheKey: string) => CachedAvailabilitiesData | undefined;
+  /** Check if cached entry is stale (older than TTL). Use for stale-while-revalidate. */
+  isStale: (cached: CachedAvailabilitiesData) => boolean;
+  /** Replace or set cache entry. */
+  set: (cacheKey: string, data: CachedAvailabilitiesData) => void;
+  /** Merge new availabilities into existing cache (or create new entry). */
+  merge: (
+    cacheKey: string,
+    update: {
+      fetchedRanges?: Array<{ start: Date; end: Date }>;
+      availabilities?: Availability[];
+      pricingConfig?: PricingConfig | null;
+      precomputedPricesByOption?: Record<string, PrecomputedPricesByCategory> | null;
+      precomputedPrices?: PrecomputedPricesByCategory | null;
+      resourcePriceByCurrency?: Record<string, number> | null;
+      resourcePriceByOption?: Record<string, Record<string, number>> | null;
+    }
+  ) => void;
+}
+
+const AvailabilitiesCacheContext = createContext<AvailabilitiesCacheContextValue | null>(null);
+
+export function useAvailabilitiesCache() {
+  const ctx = useContext(AvailabilitiesCacheContext);
+  return ctx; // May be null if not wrapped
+}
+
+/** Build cache key from product + options + promo + optional partner pricing profile. */
+export function buildAvailabilitiesCacheKey(
+  productId: string,
+  optionIdsKey: string,
+  promoCode: string | null,
+  pricingProfileId?: string | null
+): string {
+  const pp = (pricingProfileId ?? '').trim();
+  return `${productId}|${optionIdsKey}|${promoCode ?? ''}|pp:${pp}`;
+}
+
+export function AvailabilitiesCacheProvider({ children }: { children: ReactNode }) {
+  const cacheRef = useRef<Map<string, CachedAvailabilitiesData>>(new Map());
+
+  const get = useCallback((cacheKey: string) => {
+    return cacheRef.current.get(cacheKey);
+  }, []);
+
+  const isStale = useCallback((cached: CachedAvailabilitiesData) => {
+    const age = Date.now() - (cached.cachedAt ?? 0);
+    return age > AVAILABILITIES_CACHE_TTL_MS;
+  }, []);
+
+  const set = useCallback((cacheKey: string, data: CachedAvailabilitiesData) => {
+    cacheRef.current.set(cacheKey, data);
+  }, []);
+
+  const merge = useCallback(
+    (
+      cacheKey: string,
+      update: {
+        fetchedRanges?: Array<{ start: Date; end: Date }>;
+        availabilities?: Availability[];
+        pricingConfig?: PricingConfig | null;
+        precomputedPricesByOption?: Record<string, PrecomputedPricesByCategory> | null;
+        precomputedPrices?: PrecomputedPricesByCategory | null;
+        resourcePriceByCurrency?: Record<string, number> | null;
+        resourcePriceByOption?: Record<string, Record<string, number>> | null;
+      }
+    ) => {
+      const existing = cacheRef.current.get(cacheKey);
+      const next: CachedAvailabilitiesData = {
+        fetchedRanges: update.fetchedRanges ?? existing?.fetchedRanges ?? [],
+        availabilities: update.availabilities ?? existing?.availabilities ?? [],
+        pricingConfig: update.pricingConfig !== undefined ? update.pricingConfig : existing?.pricingConfig ?? null,
+        precomputedPricesByOption:
+          update.precomputedPricesByOption !== undefined
+            ? update.precomputedPricesByOption
+            : existing?.precomputedPricesByOption ?? null,
+        precomputedPrices: update.precomputedPrices !== undefined ? update.precomputedPrices : existing?.precomputedPrices ?? null,
+        resourcePriceByCurrency: update.resourcePriceByCurrency !== undefined ? update.resourcePriceByCurrency : existing?.resourcePriceByCurrency ?? null,
+        resourcePriceByOption: update.resourcePriceByOption !== undefined ? update.resourcePriceByOption : existing?.resourcePriceByOption ?? null,
+        cachedAt: Date.now(),
+      };
+      cacheRef.current.set(cacheKey, next);
+    },
+    []
+  );
+
+  const value: AvailabilitiesCacheContextValue = { get, set, merge, isStale };
+
+  return (
+    <AvailabilitiesCacheContext.Provider value={value}>
+      {children}
+    </AvailabilitiesCacheContext.Provider>
+  );
+}

package/src/contexts/CompanyContext.tsx

@@ -0,0 +1,70 @@
+'use client';
+
+import { createContext, useContext, useState, useEffect, ReactNode } from 'react';
+import { getCompany, type Company } from '../lib/booking-api';
+import { ENV } from '../lib/env';
+
+interface CompanyContextType {
+  company: Company | null;
+  loading: boolean;
+  error: string | null;
+}
+
+const CompanyContext = createContext<CompanyContextType | undefined>(undefined);
+
+interface CompanyProviderProps {
+  children: ReactNode;
+}
+
+/**
+ * Provider component that fetches company data once and makes it available via context
+ */
+export function CompanyProvider({ children }: CompanyProviderProps) {
+  const [company, setCompany] = useState<Company | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    async function fetchCompany() {
+      try {
+        const companyData = await getCompany(ENV.COMPANY_ID);
+        setCompany(companyData);
+        setError(null);
+      } catch (err) {
+        console.warn('Failed to fetch company data, using defaults:', err);
+        setError(err instanceof Error ? err.message : 'Failed to fetch company');
+        // Don't set company to null - let components use defaults
+      } finally {
+        setLoading(false);
+      }
+    }
+
+    fetchCompany();
+  }, []);
+
+  return (
+    <CompanyContext.Provider value={{ company, loading, error }}>
+      {children}
+    </CompanyContext.Provider>
+  );
+}
+
+/**
+ * Hook to access company context
+ * Returns company data, loading state, and error
+ */
+export function useCompany() {
+  const context = useContext(CompanyContext);
+  if (context === undefined) {
+    throw new Error('useCompany must be used within a CompanyProvider');
+  }
+  return context;
+}
+
+/**
+ * Hook to get company timezone with fallback
+ */
+export function useCompanyTimezone(): string {
+  const { company } = useCompany();
+  return company?.settings?.timezone || 'America/Edmonton';
+}

package/src/data/dap-descriptions/session-couples-families-friends.en.json

@@ -0,0 +1,61 @@
+{
+  "paragraphs": [
+    "Looking to create memories with your loved ones in one of the most breathtaking places on earth? Let us help you turn it into an unforgettable experience.",
+    "Whether it's a joyful family gathering, a meaningful moment with friends, or a romantic couples shoot, we know how to blend into the moment while capturing it beautifully - candid, natural, and full of connection."
+  ],
+  "sections": [
+    {
+      "title": "What's included",
+      "content": [
+        {
+          "title": "30-minute session",
+          "items": [
+            "📸 20 to 25 minutes of photography time",
+            "📍 2 Locations within walking distance",
+            "🖼️ 25 professionally edited photos delivered in a personalized online gallery"
+          ]
+        },
+        {
+          "title": "60-minute session",
+          "items": [
+            "📸 50 to 55 minutes of photography time",
+            "📍 2-3 Locations within walking distance",
+            "🖼️ 50 professionally edited photos delivered in a personalized online gallery"
+          ]
+        },
+        {
+          "title": "90-minute session",
+          "items": [
+            "📸 80-90 mins of Photography Time",
+            "📍 5 Locations within walking distance",
+            "🖼️ 75 professionally edited photos delivered in a personalized online gallery"
+          ]
+        },
+        {
+          "title": "Other details",
+          "items": [
+            "🖥️ Editing: Basic exposure and lighting adjustments + colour corrections",
+            "👭🏽 10 People Max per session"
+          ]
+        }
+      ]
+    },
+    {
+      "title": "Available add ons",
+      "content": [
+        "🏃‍♀️ Express Service - 7 Day turnaround on images - $300",
+        "🏃‍♀️💨 Super Express Service - 48-hour turnaround on images - $900",
+        "🔬 Additional Editing: Object Removal / Skin Retouching - $199/item",
+        "➕ Additional Images: 15 Additional Images - $99",
+        "♾️ The Works - Get ALL additional images taken on the day - $199"
+      ]
+    },
+    {
+      "title": "Exclusions",
+      "content": [
+        "💵 Tips or Gratuities",
+        "🅿️ Parking Fees"
+      ]
+    }
+  ]
+}

package/src/data/dap-descriptions/session-elopements.en.json

@@ -0,0 +1,60 @@
+{
+  "paragraphs": [
+    "Planning to elope in one of the most breathtaking places on earth? Let us help you make it truly unforgettable. We know how to blend into the moment while capturing the joy of an intimate celebration beautifully."
+  ],
+  "sections": [
+    {
+      "title": "What's included",
+      "content": [
+        {
+          "title": "30-minute session",
+          "items": [
+            "📸 20 to 25 minutes of photography time",
+            "📍 2 Locations within walking distance",
+            "🖼️ 25 professionally edited photos delivered in a personalized online gallery"
+          ]
+        },
+        {
+          "title": "60-minute session",
+          "items": [
+            "📸 50 to 55 minutes of photography time",
+            "📍 2-3 Locations within walking distance",
+            "🖼️ 50 professionally edited photos delivered in a personalized online gallery"
+          ]
+        },
+        {
+          "title": "90-minute session",
+          "items": [
+            "📸 80-90 mins of Photography Time",
+            "📍 5 Locations within walking distance",
+            "🖼️ 75 professionally edited photos delivered in a personalized online gallery"
+          ]
+        },
+        {
+          "title": "Other details",
+          "items": [
+            "🖥️ Editing: Basic exposure and lighting adjustments + colour corrections",
+            "👭🏽 2 People Max per session"
+          ]
+        }
+      ]
+    },
+    {
+      "title": "Available add ons",
+      "content": [
+        "🏃‍♀️ Express Service - 7 Day turnaround on images - $300",
+        "🏃‍♀️💨 Super Express Service - 48-hour turnaround on images - $900",
+        "🔬 Additional Editing: Object Removal / Skin Retouching - $199/item",
+        "➕ Additional Images: 15 Additional Images - $99",
+        "♾️ The Works - Get ALL additional images taken on the day - $199"
+      ]
+    },
+    {
+      "title": "Exclusions",
+      "content": [
+        "💵 Tips or Gratuities",
+        "🅿️ Parking Fees"
+      ]
+    }
+  ]
+}

package/src/data/dap-descriptions/session-proposals.en.json

@@ -0,0 +1,60 @@
+{
+  "paragraphs": [
+    "Planning to propose in one of the most breathtaking places on earth? Let us help you make it truly unforgettable. We know how to blend into the moment while capturing the joy of an intimate celebration beautifully."
+  ],
+  "sections": [
+    {
+      "title": "What's included",
+      "content": [
+        {
+          "title": "30-minute session",
+          "items": [
+            "📸 20 to 25 minutes of photography time",
+            "📍 2 Locations within walking distance",
+            "🖼️ 25 professionally edited photos delivered in a personalized online gallery"
+          ]
+        },
+        {
+          "title": "60-minute session",
+          "items": [
+            "📸 50 to 55 minutes of photography time",
+            "📍 2-3 Locations within walking distance",
+            "🖼️ 50 professionally edited photos delivered in a personalized online gallery"
+          ]
+        },
+        {
+          "title": "90-minute session",
+          "items": [
+            "📸 80-90 mins of Photography Time",
+            "📍 5 Locations within walking distance",
+            "🖼️ 75 professionally edited photos delivered in a personalized online gallery"
+          ]
+        },
+        {
+          "title": "Other details",
+          "items": [
+            "🖥️ Editing: Basic exposure and lighting adjustments + colour corrections",
+            "👭🏽 2 People Max per session"
+          ]
+        }
+      ]
+    },
+    {
+      "title": "Available add ons",
+      "content": [
+        "🏃‍♀️ Express Service - 7 Day turnaround on images - $300",
+        "🏃‍♀️💨 Super Express Service - 48-hour turnaround on images - $900",
+        "🔬 Additional Editing: Object Removal / Skin Retouching - $199/item",
+        "➕ Additional Images: 15 Additional Images - $99",
+        "♾️ The Works - Get ALL additional images taken on the day - $199"
+      ]
+    },
+    {
+      "title": "Exclusions",
+      "content": [
+        "💵 Tips or Gratuities",
+        "🅿️ Parking Fees"
+      ]
+    }
+  ]
+}

package/src/hooks/useBookingSourceMetadataFromLocation.ts

@@ -5,7 +5,7 @@ import { usePathname } from 'next/navigation';
 import {
   buildBookingSourceMetadataFromLocation,
   type BookingSourceMetadata,
-} from '../../../../src/lib/booking/source-metadata';
+} from '../lib/booking/source-metadata';
 
 /**
  * Re-reads URL-derived booking attribution when the **path** changes. Query-only updates on the

package/src/hooks/useIsBookingLaunchLive.ts

@@ -1,7 +1,7 @@
 'use client';
 
 import { useState, useEffect } from 'react';
-import { BOOKING_LAUNCH_AT } from '../../../../src/lib/booking-constants';
+import { BOOKING_LAUNCH_AT } from '../lib/booking-constants';
 
 /**
  * Returns whether the full booking flow is live (past launch time).

package/src/lib/booking/booking-source.ts

@@ -0,0 +1,51 @@
+/**
+ * Channel values the API persists on reservations/bookings (aligned with ticketbooth-be
+ * `BookingMarketingSource` + `SourceTrackingService` auto-detect: WEBSITE, AFFILIATE, DASHBOARD,
+ * GYG, VIATOR, plus dynamic uppercase `utm_source` strings when no fixed bucket applies).
+ */
+export enum KnownBookingSource {
+  WEBSITE = 'WEBSITE',
+  /** Main-site partner embed (e.g. `/partner/{slug}`); not the dedicated `booking.*` portal app. */
+  PUBLIC_PARTNER_WEBSITE = 'PUBLIC_PARTNER_WEBSITE',
+  PARTNER_PORTAL = 'PARTNER_PORTAL',
+  AFFILIATE = 'AFFILIATE',
+  DASHBOARD = 'DASHBOARD',
+  GYG = 'GYG',
+  VIATOR = 'VIATOR',
+}
+
+/** Default reserve/checkout `source` when the client does not send a more specific channel. */
+export const DEFAULT_BOOKING_SOURCE = KnownBookingSource.WEBSITE;
+
+/** Client `source` when booking through the signed-in partner org / marketing partner flows. */
+export const PARTNER_PORTAL_BOOKING_SOURCE = KnownBookingSource.PARTNER_PORTAL;
+
+const PUBLIC_BOOKING_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+
+/**
+ * True when metadata carries a partner org id or a normalized public marketing slug (same shape
+ * as backend `publicBookingSlug`), independent of hostname or URL path — use with route-level
+ * `canonicalAttribution.partnerSlug` so localhost and stripped URLs still attribute.
+ */
+export function mergedMetadataImpliesPartnerPortal(
+  merged: Partial<{ partnerId?: string; partnerSlug?: string }>,
+): boolean {
+  const pid = typeof merged.partnerId === 'string' ? merged.partnerId.trim() : '';
+  if (pid.startsWith('par_')) return true;
+  const slug = typeof merged.partnerSlug === 'string' ? merged.partnerSlug.trim().toLowerCase() : '';
+  return slug.length > 0 && PUBLIC_BOOKING_SLUG_RE.test(slug);
+}
+
+/**
+ * Fixed client channel from product / option identifiers (GYG / Viator embeds). Everything else
+ * is treated as main-site {@link KnownBookingSource.WEBSITE}; AFFILIATE/DASHBOARD are set server-side.
+ */
+export function inferClientBookingSourceFromProductIds(
+  productId: string,
+  productOptionId?: string | null,
+): KnownBookingSource {
+  const haystack = `${productId} ${productOptionId ?? ''}`.toLowerCase();
+  if (haystack.includes('gyg_')) return KnownBookingSource.GYG;
+  if (haystack.includes('viator_')) return KnownBookingSource.VIATOR;
+  return KnownBookingSource.WEBSITE;
+}

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

@@ -0,0 +1,69 @@
+import type { CheckoutBreakdown, CheckoutReceiptLine } from '../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

@@ -0,0 +1,46 @@
+/**
+ * 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

@@ -0,0 +1,21 @@
+/**
+ * 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',
+};
+