@ticketboothapp/booking 1.2.99 → 1.2.101

package/src/lib/booking-api.ts

@@ -355,26 +355,186 @@ function getAuthHeaders(): Record<string, string> {
 
 /** Idempotent GET retries: transient network errors and 502/503/504 (new trace span each attempt). */
 const BOOKING_GET_MAX_RETRIES = 2;
+const BOOKING_ATTEMPT_HEADER = 'X-Booking-Attempt-Id';
+const SLOW_REQUEST_THRESHOLD_MS = 2500;
+const SUCCESS_TIMING_SAMPLE_RATE = 0.02;
 
 function sleep(ms: number): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+function newBookingAttemptId(): string {
+  try {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+      return crypto.randomUUID();
+    }
+  } catch {
+    /* fall through */
+  }
+  return `${Date.now()}-${Math.random().toString(36).slice(2, 12)}`;
+}
+
+function getEndpointFromUrl(url: string): string {
+  try {
+    const parsed = new URL(url, typeof window !== 'undefined' ? window.location.href : API_BASE);
+    return parsed.pathname;
+  } catch {
+    return '';
+  }
+}
+
+function isBookingCriticalEndpoint(endpoint: string): boolean {
+  return (
+    endpoint === '/1/get-availabilities' ||
+    endpoint === '/1/products' ||
+    endpoint === '/1/reserve' ||
+    endpoint.startsWith('/1/companies/')
+  );
+}
+
+function getConnectionDiagnostics(): Record<string, number | string | boolean> | null {
+  if (typeof navigator === 'undefined') return null;
+  const connection = (
+    navigator as Navigator & {
+      connection?: {
+        effectiveType?: string;
+        rtt?: number;
+        downlink?: number;
+        saveData?: boolean;
+      };
+    }
+  ).connection;
+  if (!connection) return null;
+  return {
+    effectiveType: connection.effectiveType ?? 'unknown',
+    rtt: typeof connection.rtt === 'number' ? connection.rtt : -1,
+    downlink: typeof connection.downlink === 'number' ? connection.downlink : -1,
+    saveData: Boolean(connection.saveData),
+  };
+}
+
+function getAvailabilityQueryShape(url: string): Record<string, string | boolean | string[]> | null {
+  try {
+    const parsed = new URL(url, typeof window !== 'undefined' ? window.location.href : API_BASE);
+    if (parsed.pathname !== '/1/get-availabilities') return null;
+    const params = parsed.searchParams;
+    return {
+      queryKeys: Array.from(params.keys()).sort(),
+      productId: params.get('productId') ?? '',
+      productOptionId: params.get('productOptionId') ?? '',
+      startDate: params.get('startDate') ?? '',
+      endDate: params.get('endDate') ?? '',
+      fromDateTime: params.get('fromDateTime') ?? '',
+      toDateTime: params.get('toDateTime') ?? '',
+      allOptions: params.get('allOptions') === 'true',
+      summary: params.get('summary') === 'true',
+    };
+  } catch {
+    return null;
+  }
+}
+
+function latestResourceTiming(url: string): Record<string, number | string | boolean> | null {
+  if (typeof performance === 'undefined') return null;
+  const entry = performance
+    .getEntriesByName(url)
+    .filter((item): item is PerformanceResourceTiming => item.entryType === 'resource')
+    .at(-1);
+  if (!entry) return null;
+  return {
+    name: entry.name,
+    durationMs: Math.round(entry.duration),
+    startTimeMs: Math.round(entry.startTime),
+    fetchStartMs: Math.round(entry.fetchStart),
+    domainLookupStartMs: Math.round(entry.domainLookupStart),
+    domainLookupEndMs: Math.round(entry.domainLookupEnd),
+    connectStartMs: Math.round(entry.connectStart),
+    connectEndMs: Math.round(entry.connectEnd),
+    secureConnectionStartMs: Math.round(entry.secureConnectionStart),
+    requestStartMs: Math.round(entry.requestStart),
+    responseStartMs: Math.round(entry.responseStart),
+    responseEndMs: Math.round(entry.responseEnd),
+    transferSize: entry.transferSize,
+    encodedBodySize: entry.encodedBodySize,
+    decodedBodySize: entry.decodedBodySize,
+    timingRestricted: entry.responseStart === 0 && entry.responseEnd === 0,
+  };
+}
+
+function bookingRequestTelemetryContext(
+  url: string,
+  endpoint: string,
+  headers: Record<string, string>,
+  requestAttemptId: string,
+  attemptNumber: number,
+  elapsedMs?: number,
+): Record<string, unknown> {
+  const traceparent = headers.traceparent;
+  const traceId = traceparent ? traceIdFromTraceparent(traceparent) : undefined;
+  return {
+    endpoint,
+    method: 'GET',
+    correlationId: headers[BOOKING_CORRELATION_HEADER],
+    traceparent,
+    ...(traceId ? { traceId } : {}),
+    requestAttemptId,
+    attemptNumber,
+    maxRetries: BOOKING_GET_MAX_RETRIES,
+    requestUrlPath: endpoint,
+    requestUrlSearchLength: (() => {
+      try {
+        return new URL(url, window.location.href).search.length;
+      } catch {
+        return 0;
+      }
+    })(),
+    availabilityQueryShape: getAvailabilityQueryShape(url),
+    visibilityState: typeof document !== 'undefined' ? document.visibilityState : undefined,
+    pageAgeMs: typeof performance !== 'undefined' ? Math.round(performance.now()) : undefined,
+    connection: getConnectionDiagnostics(),
+    ...(elapsedMs != null ? { elapsedMs } : {}),
+  };
+}
+
 async function fetchBookingGetWithRetry(
   url: string,
   extra?: Pick<RequestInit, 'cache' | 'signal'>,
 ): Promise<Response> {
   let lastErr: unknown;
+  const endpoint = getEndpointFromUrl(url);
   for (let attempt = 0; attempt <= BOOKING_GET_MAX_RETRIES; attempt++) {
     if (attempt > 0) {
       await sleep(250 * attempt);
     }
+    const requestAttemptId = newBookingAttemptId();
+    const headers = {
+      ...getAuthHeaders(),
+      [BOOKING_ATTEMPT_HEADER]: requestAttemptId,
+    };
+    const startedAt = typeof performance !== 'undefined' ? performance.now() : Date.now();
+    if (isBookingCriticalEndpoint(endpoint)) {
+      reportBookingClientTelemetryEvent('BOOKING_DIALOG_REQUEST_STARTED', {
+        ...bookingRequestTelemetryContext(url, endpoint, headers, requestAttemptId, attempt + 1),
+      });
+    }
     try {
       const res = await fetch(url, {
         ...extra,
         method: 'GET',
-        headers: getAuthHeaders(),
+        headers,
       });
+      const elapsedMs = Math.round((typeof performance !== 'undefined' ? performance.now() : Date.now()) - startedAt);
+      if (
+        elapsedMs >= SLOW_REQUEST_THRESHOLD_MS ||
+        (isBookingCriticalEndpoint(endpoint) && Math.random() < SUCCESS_TIMING_SAMPLE_RATE)
+      ) {
+        reportBookingClientTelemetryEvent('BOOKING_DIALOG_REQUEST_TIMING', {
+          ...bookingRequestTelemetryContext(url, endpoint, headers, requestAttemptId, attempt + 1, elapsedMs),
+          httpStatus: res.status,
+          ok: res.ok,
+          resourceTiming: latestResourceTiming(url),
+        });
+      }
       if (res.ok) {
         return res;
       }
@@ -388,8 +548,28 @@ async function fetchBookingGetWithRetry(
     } catch (e) {
       lastErr = e;
       if (attempt < BOOKING_GET_MAX_RETRIES) {
+        const elapsedMs = Math.round((typeof performance !== 'undefined' ? performance.now() : Date.now()) - startedAt);
+        reportBookingClientTelemetryEvent('BOOKING_DIALOG_REQUEST_RETRYING', {
+          ...bookingRequestTelemetryContext(url, endpoint, headers, requestAttemptId, attempt + 1, elapsedMs),
+          errorName: e instanceof Error ? e.name : undefined,
+          errorMessage: e instanceof Error ? e.message : String(e),
+          requestSignalAborted: Boolean(extra?.signal?.aborted),
+        });
         continue;
       }
+      const elapsedMs = Math.round((typeof performance !== 'undefined' ? performance.now() : Date.now()) - startedAt);
+      reportBookingClientTelemetryEvent('BOOKING_DIALOG_NETWORK_DIAGNOSTIC', {
+        ...bookingRequestTelemetryContext(url, endpoint, headers, requestAttemptId, attempt + 1, elapsedMs),
+        errorName: e instanceof Error ? e.name : undefined,
+        errorMessage: e instanceof Error ? e.message : String(e),
+        errorCause: e instanceof Error && e.cause ? String(e.cause) : undefined,
+        requestSignalAborted: Boolean(extra?.signal?.aborted),
+        abortReason:
+          extra?.signal && 'reason' in extra.signal
+            ? String(extra.signal.reason ?? '')
+            : undefined,
+        resourceTiming: latestResourceTiming(url),
+      });
       throw e;
     }
   }
@@ -1298,6 +1478,7 @@ export interface Availability {
   pricesByCategory?: {
     retailPrices: Array<{ category: string; price: number }>;
   };
+  isSummary?: boolean;
 }
 
 export type PrecomputedPricesByCategory = Record<string, Record<string, number>>;
@@ -1306,13 +1487,16 @@ export interface GetAvailabilitiesResponse {
   availabilities: Availability[];
   pricingConfig?: PricingConfig;
   precomputedPrices?: PrecomputedPricesByCategory;
+  precomputedPricesByOption?: Record<string, PrecomputedPricesByCategory>;
   resourcePriceByCurrency?: Record<string, number>;
   resourcePriceByOption?: Record<string, Record<string, number>>;
+  responseMode?: 'summary' | string;
 }
 
 export interface GetAvailabilitiesOptions {
   promoCode?: string | null;
   allOptions?: boolean;
+  summary?: boolean;
   /**
    * When set, TicketBooth should return rates/precomputed prices for this partner pricing profile.
    * Must match the profile linked on the partner (e.g. capabilities.pricingProfileId).
@@ -1359,6 +1543,7 @@ export async function getAvailabilities(
   });
   if (options?.promoCode?.trim()) params.set('promoCode', options.promoCode.trim());
   if (options?.allOptions === true) params.set('allOptions', 'true');
+  if (options?.summary === true) params.set('summary', 'true');
   const pricingProfileId = options?.pricingProfileId?.trim();
   if (pricingProfileId) params.set('pricingProfileId', pricingProfileId);
   const cancellationPolicyProfileId = options?.cancellationPolicyProfileId?.trim();
@@ -1407,12 +1592,17 @@ export async function getAvailabilities(
   }
 
   const bookingData = (data as { data?: GetAvailabilitiesResponse } | null)?.data;
+  const isSummary = options?.summary === true || bookingData?.responseMode === 'summary';
   return {
-    availabilities: bookingData?.availabilities ?? [],
+    availabilities: (bookingData?.availabilities ?? []).map((availability) =>
+      isSummary ? { ...availability, isSummary: true } : availability
+    ),
     pricingConfig: bookingData?.pricingConfig,
     precomputedPrices: bookingData?.precomputedPrices,
+    precomputedPricesByOption: bookingData?.precomputedPricesByOption,
     resourcePriceByCurrency: bookingData?.resourcePriceByCurrency,
     resourcePriceByOption: bookingData?.resourcePriceByOption,
+    responseMode: bookingData?.responseMode,
   };
 }
 
@@ -1649,6 +1839,16 @@ export interface CheckoutBreakdown {
   currency: string;
 }
 
+export interface CheckoutDependentAddOnSelection {
+  dependentAddOnProductId: string;
+  dependentAddOnProductOptionId?: string;
+  offeringId: string;
+  slotStart: string;
+  slotEnd: string;
+  quantity: number;
+  checkoutAnswers?: Record<string, string>;
+}
+
 export interface CreatePaymentIntentRequest {
   productId: string;
   optionId: string;
@@ -1667,6 +1867,7 @@ export interface CreatePaymentIntentRequest {
   cancellationPolicyId?: string;
   termsAcceptedAt?: string;
   checkoutBreakdown?: CheckoutBreakdown;
+  dependentAddOnSelection?: CheckoutDependentAddOnSelection;
   itineraryDisplay?: ItineraryDisplayStep[];
   skipConfirmationCommunications?: boolean;
   disableAutoCommunications?: boolean;
@@ -1765,6 +1966,7 @@ export interface ConfirmFreeBookingRequest {
   pickupLocationId?: string;
   termsAcceptedAt?: string;
   itineraryDisplay?: ItineraryDisplayStep[];
+  dependentAddOnSelection?: CheckoutDependentAddOnSelection;
   skipConfirmationCommunications?: boolean;
   disableAutoCommunications?: boolean;
   source?: string;
@@ -1846,6 +2048,7 @@ export interface ConfirmBookingWithoutPaymentRequest {
   skipConfirmationCommunications?: boolean;
   disableAutoCommunications?: boolean;
   checkoutBreakdown: CheckoutBreakdown;
+  dependentAddOnSelection?: CheckoutDependentAddOnSelection;
   depositAmount: number;
   balanceAmount: number;
   totalAmount: number;

package/src/runtime/types.ts

@@ -74,6 +74,8 @@ export interface BookingRuntimeCatalog {
   getProductDescription: (...args: any[]) => any;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   buildMinimalProductFromConfig?: (...args: any[]) => any;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  getStaticProductByIdOrSlug?: (...args: any[]) => any;
   /** Image URL helper from the host catalog (e.g. Via Via `constants/images`). */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   getImageUrl?: (...args: any[]) => any;