@ticketboothapp/booking 1.2.24 → 1.2.25-rc.0

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

@@ -0,0 +1,226 @@
+export {
+  KnownBookingSource,
+  DEFAULT_BOOKING_SOURCE,
+  PARTNER_PORTAL_BOOKING_SOURCE,
+  inferClientBookingSourceFromProductIds,
+  mergedMetadataImpliesPartnerPortal,
+} from '@/lib/booking/booking-source';
+
+import { KnownBookingSource, mergedMetadataImpliesPartnerPortal } from '@/lib/booking/booking-source';
+
+export interface BookingSourceMetadata {
+  pageUrl?: string;
+  pagePath?: string;
+  pageQuery?: string;
+  referrerUrl?: string;
+  utmSource?: string;
+  utmMedium?: string;
+  utmCampaign?: string;
+  utmTerm?: string;
+  utmContent?: string;
+  gclid?: string;
+  fbclid?: string;
+  msclkid?: string;
+  partnerId?: string;
+  partnerSlug?: string;
+  agentId?: string;
+  agentName?: string;
+}
+
+function withDefinedValues<T extends object>(obj: T): Partial<T> {
+  return Object.fromEntries(
+    Object.entries(obj).filter(([, value]) => value !== undefined && value !== null && value !== ''),
+  ) as Partial<T>;
+}
+
+/**
+ * Public marketing embed routes on the main site (`/partner/{slug}`). Used to decide when
+ * `partnerId` in the query string is intentional vs noisy on generic tour/product URLs.
+ */
+export function isPublicPartnerMarketingPath(pathname: string): boolean {
+  return /^\/partner\/[^/]+/i.test(pathname.trim());
+}
+
+/** Partner booking SPA (`booking.*` prod/staging) — `?partnerId=` is intentional on `/` or any path. */
+export function isDedicatedPartnerBookingPortalHost(hostname: string): boolean {
+  const h = hostname.trim().toLowerCase();
+  return h === 'booking.viaviamorainelake.com' || h === 'staging.booking.viaviamorainelake.com';
+}
+
+/**
+ * Reads the **current browser URL** (and referrer) into attribution fields. Supplements
+ * `mergeBookingSourceMetadata` with `canonicalAttribution` from the route so identity does
+ * not depend on the visible URL alone.
+ *
+ * **`partnerId` from `?partnerId=`** is included when:
+ * - the path is **`/partner/:slug`** on the **main marketing site**, or
+ * - the host is the **dedicated partner booking app** (`booking.*` prod/staging).
+ *
+ * On other generic marketing pages we still capture UTMs and full `pageUrl`, but omit loose
+ * `partnerId` query params so promo + backend rules aren’t overshadowed by “explicit” metadata.
+ */
+export function buildBookingSourceMetadataFromLocation(): Partial<BookingSourceMetadata> {
+  if (typeof window === 'undefined') {
+    return {};
+  }
+
+  const currentUrl = new URL(window.location.href);
+  const params = currentUrl.searchParams;
+  const partnerMatch = currentUrl.pathname.match(/^\/partner\/([^/]+)/i);
+  const onPartnerEmbedPath = isPublicPartnerMarketingPath(currentUrl.pathname);
+  const onPortalHost = isDedicatedPartnerBookingPortalHost(currentUrl.hostname);
+  const partnerFromQuery =
+    onPartnerEmbedPath || onPortalHost ? params.get('partnerId') || undefined : undefined;
+  const partnerSlugFromPath = partnerMatch?.[1];
+  const agentIdFromQuery = params.get('agentId') || undefined;
+  const agentNameFromQuery = params.get('agentName') || undefined;
+
+  return withDefinedValues<BookingSourceMetadata>({
+    pageUrl: currentUrl.href,
+    pagePath: currentUrl.pathname,
+    pageQuery: currentUrl.search || undefined,
+    referrerUrl: document.referrer || undefined,
+    utmSource: params.get('utm_source') || undefined,
+    utmMedium: params.get('utm_medium') || undefined,
+    utmCampaign: params.get('utm_campaign') || undefined,
+    utmTerm: params.get('utm_term') || undefined,
+    utmContent: params.get('utm_content') || undefined,
+    gclid: params.get('gclid') || undefined,
+    fbclid: params.get('fbclid') || undefined,
+    msclkid: params.get('msclkid') || undefined,
+    partnerId: partnerFromQuery,
+    partnerSlug: partnerSlugFromPath,
+    agentId: agentIdFromQuery,
+    agentName: agentNameFromQuery,
+  });
+}
+
+/** Later layers override earlier ones (undefined / null / empty string in a layer are omitted). */
+export function mergeBookingSourceMetadata(
+  ...layers: Array<Partial<BookingSourceMetadata> | null | undefined>
+): Partial<BookingSourceMetadata> {
+  let acc: Partial<BookingSourceMetadata> = {};
+  for (const layer of layers) {
+    if (!layer) continue;
+    acc = { ...acc, ...withDefinedValues(layer as BookingSourceMetadata) };
+  }
+  return acc;
+}
+
+function hostnameForSourceDecision(merged: Partial<BookingSourceMetadata>): string {
+  if (typeof window !== 'undefined') {
+    try {
+      return new URL(window.location.href).hostname.toLowerCase();
+    } catch {
+      return '';
+    }
+  }
+  const pu = merged.pageUrl?.trim();
+  if (!pu) return '';
+  try {
+    return new URL(pu).hostname.toLowerCase();
+  } catch {
+    return '';
+  }
+}
+
+export type BuildBookingSourceContextOptions = {
+  /**
+   * When metadata does not imply partner portal, use this channel (GYG/VIATOR/WEBSITE from product ids).
+   * AFFILIATE/DASHBOARD are normally set server-side from request headers.
+   */
+  clientChannelSource?: KnownBookingSource;
+  /** Dedicated partner booking app (`booking.*`): persist `source` as PARTNER_PORTAL (not PUBLIC_PARTNER_WEBSITE). */
+  forcePartnerPortalChannel?: boolean;
+  /** TicketBooth provider dashboard embed (`BookingAppProvider` mode `provider-dashboard`): persist `source` as DASHBOARD. */
+  forceDashboardSource?: boolean;
+};
+
+/**
+ * Builds reserve/checkout `source` + `sourceMetadata` from composed metadata. Partner portal is
+ * inferred from `par_` org id or a valid marketing `partnerSlug` (including route-level canonical),
+ * not from hostname alone. Optional `clientChannelSource` supplies GYG/VIATOR/WEBSITE otherwise.
+ */
+export function buildBookingSourceContext(
+  mergedMetadata: Partial<BookingSourceMetadata>,
+  options?: BuildBookingSourceContextOptions,
+): {
+  source: KnownBookingSource;
+  sourceMetadata?: BookingSourceMetadata;
+  source_metadata?: BookingSourceMetadata;
+} {
+  const merged = withDefinedValues(mergedMetadata as BookingSourceMetadata);
+  const channel = options?.clientChannelSource ?? KnownBookingSource.WEBSITE;
+
+  if (options?.forceDashboardSource === true) {
+    const hasMeta = Object.keys(merged).length > 0;
+    const context: {
+      source: KnownBookingSource;
+      sourceMetadata?: BookingSourceMetadata;
+      source_metadata?: BookingSourceMetadata;
+    } = {
+      source: KnownBookingSource.DASHBOARD,
+      ...(hasMeta
+        ? {
+            sourceMetadata: merged as BookingSourceMetadata,
+            source_metadata: merged as BookingSourceMetadata,
+          }
+        : {}),
+    };
+    try {
+      const md = context.sourceMetadata ?? context.source_metadata;
+      console.info(
+        `[booking-source-debug] built-context summary source=${context.source} path=${md?.pagePath ?? 'n/a'} partner=${md?.partnerId ?? 'n/a'} partner_slug=${md?.partnerSlug ?? 'n/a'} utm_source=${md?.utmSource ?? 'n/a'} utm_medium=${md?.utmMedium ?? 'n/a'} utm_campaign=${md?.utmCampaign ?? 'n/a'}`,
+      );
+      console.info(`[booking-source-debug] built-context payload\n${JSON.stringify(context, null, 2)}`);
+    } catch {
+      console.info('[booking-source-debug] built-context', context);
+    }
+    return context;
+  }
+
+  if (Object.keys(merged).length === 0) {
+    return { source: channel };
+  }
+
+  const host = hostnameForSourceDecision(merged);
+  const dedicatedPartnerBookingHost =
+    host === 'booking.viaviamorainelake.com' ||
+    host === 'staging.booking.viaviamorainelake.com';
+  const pid = typeof merged.partnerId === 'string' ? merged.partnerId.trim() : '';
+  const pslug = typeof merged.partnerSlug === 'string' ? merged.partnerSlug.trim() : '';
+
+  const forceDedicatedPortal =
+    options?.forcePartnerPortalChannel === true ||
+    (dedicatedPartnerBookingHost && (pid.length > 0 || pslug.length > 0));
+  const mainSitePartnerEmbed =
+    !forceDedicatedPortal && mergedMetadataImpliesPartnerPortal(merged);
+
+  const source = forceDedicatedPortal
+    ? KnownBookingSource.PARTNER_PORTAL
+    : mainSitePartnerEmbed
+      ? KnownBookingSource.PUBLIC_PARTNER_WEBSITE
+      : channel;
+
+  const context: {
+    source: KnownBookingSource;
+    sourceMetadata?: BookingSourceMetadata;
+    source_metadata?: BookingSourceMetadata;
+  } = {
+    source,
+    sourceMetadata: merged as BookingSourceMetadata,
+    source_metadata: merged as BookingSourceMetadata,
+  };
+
+  try {
+    const md = context.sourceMetadata ?? context.source_metadata;
+    console.info(
+      `[booking-source-debug] built-context summary source=${context.source} path=${md?.pagePath ?? 'n/a'} partner=${md?.partnerId ?? 'n/a'} partner_slug=${md?.partnerSlug ?? 'n/a'} utm_source=${md?.utmSource ?? 'n/a'} utm_medium=${md?.utmMedium ?? 'n/a'} utm_campaign=${md?.utmCampaign ?? 'n/a'}`,
+    );
+    console.info(`[booking-source-debug] built-context payload\n${JSON.stringify(context, null, 2)}`);
+  } catch {
+    console.info('[booking-source-debug] built-context', context);
+  }
+
+  return context;
+}

package/src/lib/booking/sunday-week.ts

@@ -0,0 +1,14 @@
+import { addDays, parseISO } from 'date-fns';
+import { formatInTimeZone, fromZonedTime } from 'date-fns-tz';
+
+/**
+ * Sunday (week start) of the week containing `dateStr` (yyyy-MM-dd), in `timezone`.
+ * Matches the booking calendar grid so fetch windows align with the visible week.
+ */
+export function getSundayOfWeek(dateStr: string, timezone: string): string {
+  const noonInTz = fromZonedTime(parseISO(`${dateStr}T12:00:00`), timezone);
+  const isoDay = parseInt(formatInTimeZone(noonInTz, timezone, 'i'), 10); // 1=Mon, 7=Sun
+  const daysToSubtract = isoDay === 7 ? 0 : isoDay;
+  const sundayDate = addDays(noonInTz, -daysToSubtract);
+  return formatInTimeZone(sundayDate, timezone, 'yyyy-MM-dd');
+}

package/src/lib/booking/theme.ts

@@ -0,0 +1,83 @@
+/**
+ * Booking UI theme: host can override these to get a different skin (fonts, colours, etc.)
+ * while keeping the same bones. All values are applied as CSS variables (--booking-*) on the
+ * booking root so components use var(--booking-*) and pick up host overrides.
+ */
+export interface BookingTheme {
+  /** Primary brand colour (buttons, links, accents). */
+  primary: string;
+  /** Primary hover/dark state. */
+  primaryHover: string;
+  /** Page background (gradient start). */
+  bg: string;
+  /** Page background gradient end. */
+  bgEnd: string;
+  /** Card/surface background. */
+  surface: string;
+  /** Header/footer dark background. */
+  headerBg: string;
+  /** Header text (usually white on headerBg). */
+  headerText: string;
+  /** Body text. */
+  text: string;
+  /** Muted/secondary text. */
+  textMuted: string;
+  /** Border colour. */
+  border: string;
+  /** Border for inputs etc. */
+  borderInput: string;
+  /** Font family (sans). */
+  fontSans: string;
+  /** Border radius (e.g. 8px, 0.5rem). */
+  radius: string;
+  /** Error/destructive background. */
+  errorBg: string;
+  /** Error border. */
+  errorBorder: string;
+  /** Error text. */
+  errorText: string;
+}
+
+export const DEFAULT_BOOKING_THEME: BookingTheme = {
+  primary: '#059669',
+  primaryHover: '#047857',
+  bg: '#f5f5f4',
+  bgEnd: '#e7e5e4',
+  surface: '#ffffff',
+  headerBg: '#1c1917',
+  headerText: '#ffffff',
+  text: '#1c1917',
+  textMuted: '#78716c',
+  border: '#e7e5e4',
+  borderInput: '#d6d3d1',
+  fontSans: 'ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"',
+  radius: '1rem',
+  errorBg: '#fef2f2',
+  errorBorder: '#fecaca',
+  errorText: '#b91c1c',
+};
+
+const THEME_VAR_KEYS: (keyof BookingTheme)[] = [
+  'primary', 'primaryHover', 'bg', 'bgEnd', 'surface', 'headerBg', 'headerText',
+  'text', 'textMuted', 'border', 'borderInput', 'fontSans', 'radius',
+  'errorBg', 'errorBorder', 'errorText',
+];
+
+/** Convert theme to React style object for CSS variables (--booking-*). */
+export function themeToCssVars(theme: BookingTheme): Record<string, string> {
+  const style: Record<string, string> = {};
+  for (const key of THEME_VAR_KEYS) {
+    const value = theme[key];
+    if (value != null) {
+      const varName = '--booking-' + key.replace(/([A-Z])/g, (m) => '-' + m.toLowerCase());
+      style[varName] = value;
+    }
+  }
+  return style;
+}
+
+/** Merge partial theme with defaults. */
+export function mergeTheme(partial?: Partial<BookingTheme>): BookingTheme {
+  if (!partial) return DEFAULT_BOOKING_THEME;
+  return { ...DEFAULT_BOOKING_THEME, ...partial };
+}

package/src/lib/booking/trace-context.ts

@@ -0,0 +1,62 @@
+/**
+ * W3C Trace Context for TicketBooth: stable trace id per tab + new span per outbound request/retry.
+ * Keep storage keys in sync with `packages/viavia-booking/src/trace-context.ts`.
+ */
+
+import {
+  BOOKING_CORRELATION_HEADER,
+  getOrCreateBookingCorrelationId,
+} from './correlation-id';
+
+export const BOOKING_TRACEPARENT_HEADER = 'traceparent';
+
+const STORAGE_W3C_TRACE_ID = 'tb_booking_w3c_trace_id';
+
+function randomHex(byteLength: number): string {
+  const buf = new Uint8Array(byteLength);
+  crypto.getRandomValues(buf);
+  return Array.from(buf, (b) => b.toString(16).padStart(2, '0')).join('');
+}
+
+function getOrCreateW3CTraceId(): string {
+  if (typeof window === 'undefined') {
+    return randomHex(16);
+  }
+  try {
+    let tid = sessionStorage.getItem(STORAGE_W3C_TRACE_ID);
+    if (!tid || !/^[0-9a-f]{32}$/i.test(tid)) {
+      tid = randomHex(16);
+      sessionStorage.setItem(STORAGE_W3C_TRACE_ID, tid);
+    }
+    return tid.toLowerCase();
+  } catch {
+    return randomHex(16);
+  }
+}
+
+/** New span per call (each retry should invoke this again via `withBookingOutboundHeaders`). */
+export function buildTraceparent(): string {
+  const traceId = getOrCreateW3CTraceId();
+  const spanId = randomHex(8);
+  return `00-${traceId}-${spanId}-01`;
+}
+
+export function traceIdFromTraceparent(traceparent: string): string | undefined {
+  const parts = traceparent.trim().split('-');
+  if (parts.length < 4) return undefined;
+  const tid = parts[1];
+  if (tid.length !== 32 || !/^[0-9a-fA-F]+$/.test(tid)) return undefined;
+  return tid.toLowerCase();
+}
+
+/** Adds `X-Correlation-Id` and W3C `traceparent` (fresh span each call). */
+export function withBookingOutboundHeaders(
+  headers: Record<string, string>,
+): Record<string, string> {
+  if (typeof window === 'undefined') return headers;
+  const cid = getOrCreateBookingCorrelationId();
+  const next = { ...headers };
+  if (cid) next[BOOKING_CORRELATION_HEADER] = cid;
+  next[BOOKING_TRACEPARENT_HEADER] = buildTraceparent();
+  return next;
+}

package/src/lib/booking/utils.ts

@@ -0,0 +1,9 @@
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+/**
+ * Utility function to merge Tailwind CSS classes with clsx
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}