@getmicdrop/venue-calendar 3.1.0 → 3.2.0

package/src/lib/api/events.ts

@@ -0,0 +1,358 @@
+/**
+ * Events API
+ *
+ * Functions for fetching event data, tickets, and performers
+ * in the public checkout flow.
+ */
+
+import { logger } from '../utils/logger.js';
+import { getPublicBaseUrl, simpleFetch } from './client.js';
+import type {
+  Event,
+  AvailableTicket,
+  EventPerformersResponse,
+  SeriesOccurrencesResponse,
+} from './types.js';
+
+/**
+ * Fetch event details
+ *
+ * Gets full event information including venue and ticket data.
+ *
+ * @param eventId - The event ID
+ * @param customFetch - Optional custom fetch function (for SSR)
+ * @returns Event details or null on error
+ */
+export async function fetchEventDetails(
+  eventId: string | number,
+  customFetch: typeof fetch = fetch
+): Promise<Event | null> {
+  try {
+    const response = await customFetch(`${getPublicBaseUrl()}/events/${eventId}`);
+
+    if (!response.ok) {
+      throw new Error(`Failed to fetch event details: ${response.status}`);
+    }
+
+    return response.json();
+  } catch (error) {
+    logger.error('Error fetching event details:', error);
+    return null;
+  }
+}
+
+/**
+ * Fetch available tickets for an event
+ *
+ * Returns all ticket types that are currently available for sale.
+ *
+ * @param eventId - The event ID
+ * @returns Array of available tickets
+ */
+export async function fetchEventTickets(
+  eventId: string | number
+): Promise<AvailableTicket[]> {
+  try {
+    const response = await fetch(
+      `${getPublicBaseUrl()}/tickets/event/${eventId}`
+    );
+
+    if (!response.ok) {
+      throw new Error(`Failed to fetch tickets: ${response.status}`);
+    }
+
+    const tickets = await response.json();
+    return Array.isArray(tickets) ? tickets : [];
+  } catch (error) {
+    logger.error('Error fetching tickets:', error);
+    return [];
+  }
+}
+
+/**
+ * Fetch performers for an event
+ *
+ * Returns the lineup with pre-resolved avatar URLs.
+ *
+ * @param eventId - The event ID
+ * @returns Performers list and visibility flag
+ */
+export async function fetchEventPerformers(
+  eventId: string | number
+): Promise<EventPerformersResponse> {
+  try {
+    if (!eventId) {
+      logger.warn('fetchEventPerformers called without eventId');
+      return { performers: [], showPerformers: false };
+    }
+
+    const response = await fetch(
+      `${getPublicBaseUrl()}/events/${eventId}/performers`
+    );
+
+    if (!response.ok) {
+      logger.error(
+        `Failed to fetch performers: ${response.status} ${response.statusText}`
+      );
+      return { performers: [], showPerformers: false };
+    }
+
+    const data = await response.json();
+    return {
+      performers: Array.isArray(data.performers) ? data.performers : [],
+      showPerformers: data.showPerformers === true,
+    };
+  } catch (error) {
+    logger.error('Error fetching event performers:', error);
+    return { performers: [], showPerformers: false };
+  }
+}
+
+/**
+ * Fetch all venues for an organization
+ *
+ * @param orgId - The organization ID
+ * @returns Array of venues
+ */
+export async function fetchAllVenues(orgId: string | number): Promise<any[]> {
+  try {
+    if (!orgId) {
+      logger.warn('fetchAllVenues called without orgId');
+      return [];
+    }
+
+    const response = await fetch(
+      `${getPublicBaseUrl()}/venues/organization/${orgId}`
+    );
+
+    if (!response.ok) {
+      logger.error(
+        `Failed to fetch venues: ${response.status} ${response.statusText}`
+      );
+      return [];
+    }
+
+    const venues = await response.json();
+    return Array.isArray(venues) ? venues : [];
+  } catch (error) {
+    logger.error('Error fetching venues:', error);
+    return [];
+  }
+}
+
+/**
+ * Fetch events for a venue
+ *
+ * @param venueId - The venue ID
+ * @returns Array of events
+ */
+export async function fetchVenueEvents(venueId: string | number): Promise<Event[]> {
+  try {
+    if (!venueId) {
+      logger.warn('fetchVenueEvents called without venueId');
+      return [];
+    }
+
+    const response = await fetch(
+      `${getPublicBaseUrl()}/events/venue/${venueId}`
+    );
+
+    if (!response.ok) {
+      logger.error(
+        `Failed to fetch venue events: ${response.status} ${response.statusText}`
+      );
+      return [];
+    }
+
+    const events = await response.json();
+    return Array.isArray(events) ? events : [];
+  } catch (error) {
+    logger.error('Error fetching venue events:', error);
+    return [];
+  }
+}
+
+/**
+ * Get events for a specific month
+ *
+ * Used for calendar views to efficiently load events.
+ *
+ * @param venueId - The venue ID
+ * @param year - The year (e.g., 2024)
+ * @param month - The month (1-12)
+ * @returns Array of events for the month
+ */
+export async function getMonthEvents(
+  venueId: string | number,
+  year: number,
+  month: number
+): Promise<Event[]> {
+  try {
+    const response = await fetch(
+      `${getPublicBaseUrl()}/events/venue/${venueId}/month/${year}/${month}`
+    );
+
+    if (!response.ok) {
+      logger.error(`Failed to fetch month events: ${response.status}`);
+      return [];
+    }
+
+    const data = await response.json();
+    return Array.isArray(data.events) ? data.events : Array.isArray(data) ? data : [];
+  } catch (error) {
+    logger.error('Error fetching month events:', error);
+    return [];
+  }
+}
+
+/**
+ * Get events for an organization for a specific month
+ *
+ * @param orgId - The organization ID
+ * @param year - The year (e.g., 2024)
+ * @param month - The month (1-12)
+ * @returns Array of events for the month
+ */
+export async function getOrgMonthEvents(
+  orgId: string | number,
+  year: number,
+  month: number
+): Promise<Event[]> {
+  try {
+    const response = await fetch(
+      `${getPublicBaseUrl()}/events/organization/${orgId}/month/${year}/${month}`
+    );
+
+    if (!response.ok) {
+      logger.error(`Failed to fetch org month events: ${response.status}`);
+      return [];
+    }
+
+    const data = await response.json();
+    return Array.isArray(data.events) ? data.events : Array.isArray(data) ? data : [];
+  } catch (error) {
+    logger.error('Error fetching org month events:', error);
+    return [];
+  }
+}
+
+/**
+ * Get series occurrences for date selector
+ *
+ * Returns all instances of a recurring event series.
+ *
+ * @param eventSeriesId - The series ID
+ * @returns Series occurrences
+ */
+export async function getSeriesOccurrences(
+  eventSeriesId: number
+): Promise<SeriesOccurrencesResponse | null> {
+  try {
+    const response = await fetch(
+      `${getPublicBaseUrl()}/series/${eventSeriesId}/occurrences`
+    );
+
+    if (!response.ok) {
+      logger.error(`Failed to fetch series occurrences: ${response.status}`);
+      return null;
+    }
+
+    return response.json();
+  } catch (error) {
+    logger.error('Error fetching series occurrences:', error);
+    return null;
+  }
+}
+
+/**
+ * Fetch series occurrences with CTA state
+ *
+ * Returns full series data including availability status.
+ *
+ * @param eventSeriesId - The series ID
+ * @param venueId - The venue ID
+ * @returns Series occurrences with CTA state
+ */
+export async function fetchSeriesOccurrences(
+  eventSeriesId: number,
+  venueId: string | number
+): Promise<SeriesOccurrencesResponse | null> {
+  try {
+    const response = await fetch(
+      `${getPublicBaseUrl()}/series/${eventSeriesId}/occurrences?venueId=${venueId}`
+    );
+
+    if (!response.ok) {
+      logger.error(`Failed to fetch series with CTA: ${response.status}`);
+      return null;
+    }
+
+    return response.json();
+  } catch (error) {
+    logger.error('Error fetching series occurrences:', error);
+    return null;
+  }
+}
+
+/**
+ * Check event password
+ *
+ * Validates password for password-protected events.
+ *
+ * @param eventId - The event ID
+ * @param password - The password to check
+ * @returns Whether the password is valid
+ */
+export async function checkEventPassword(
+  eventId: string | number,
+  password: string
+): Promise<boolean> {
+  try {
+    const encodedPassword = encodeURIComponent(password);
+    const response = await fetch(
+      `${getPublicBaseUrl()}/events/${eventId}/check-password/${encodedPassword}`
+    );
+
+    if (!response.ok) {
+      return false;
+    }
+
+    const result = await response.json();
+    return result.valid === true;
+  } catch (error) {
+    logger.error('Error checking event password:', error);
+    return false;
+  }
+}
+
+/**
+ * Test network connection
+ *
+ * Health check endpoint for connectivity testing.
+ *
+ * @param orgId - Optional org ID
+ * @param venueId - Optional venue ID
+ * @returns Whether the connection is working
+ */
+export async function testNetworkConnection(
+  orgId?: string | number,
+  venueId?: string | number
+): Promise<boolean> {
+  try {
+    // Use a simple endpoint to test connectivity
+    const url = venueId
+      ? `${getPublicBaseUrl()}/events/venue/${venueId}`
+      : orgId
+      ? `${getPublicBaseUrl()}/venues/organization/${orgId}`
+      : `${getPublicBaseUrl()}/health`;
+
+    const response = await fetch(url, {
+      method: 'HEAD',
+    });
+
+    return response.ok;
+  } catch (error) {
+    logger.error('Network connection test failed:', error);
+    return false;
+  }
+}

package/src/lib/api/index.ts

@@ -0,0 +1,182 @@
+/**
+ * MicDrop Public Checkout API
+ *
+ * This module provides a complete API layer for the public checkout flow:
+ * - Order creation and management
+ * - Payment processing with Stripe
+ * - Promo code validation
+ * - Event and venue data fetching
+ * - Session management
+ *
+ * All endpoints are public (no authentication required) and use
+ * the /api/v2/public base path.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createPaymentIntent,
+ *   validatePromoCode,
+ *   transformOrder,
+ * } from '@getmicdrop/venue-calendar/api';
+ *
+ * // Create payment intent
+ * const intent = await createPaymentIntent(cartId, { 123: 2 });
+ *
+ * // Validate promo code
+ * const promo = await validatePromoCode(eventId, 'DISCOUNT10');
+ *
+ * // Transform order for display
+ * const order = transformOrder(apiResponse);
+ * ```
+ */
+
+// ============================================================================
+// Client Configuration
+// ============================================================================
+
+export {
+  configureApi,
+  getApiConfig,
+  getPublicBaseUrl,
+  getLegacyPublicUrl,
+  getOrdersPublicUrl,
+  getClientIP,
+  apiGet,
+  apiPost,
+  apiPut,
+  apiDelete,
+} from './client.js';
+
+// ============================================================================
+// Orders API
+// ============================================================================
+
+export {
+  // Payment
+  createPaymentIntent,
+  validatePaymentIntent,
+
+  // Order lifecycle
+  createOrder,
+  getOrder,
+  completeReservation,
+  cancelReservation,
+
+  // Session management
+  extendCheckoutSession,
+  getSessionStatus,
+
+  // Legacy aliases (for micdrop-frontend compatibility)
+  initiateOrder,
+  trackUTMSource,
+} from './orders.js';
+
+// ============================================================================
+// Promo Codes API
+// ============================================================================
+
+export {
+  validatePromoCode,
+  hasPromoCodes,
+  applyPromoCode,
+  removePromoCode,
+} from './promo.js';
+
+// ============================================================================
+// Events API
+// ============================================================================
+
+export {
+  fetchEventDetails,
+  fetchEventTickets,
+  fetchEventPerformers,
+  fetchAllVenues,
+  fetchVenueEvents,
+  getMonthEvents,
+  getOrgMonthEvents,
+  getSeriesOccurrences,
+  fetchSeriesOccurrences,
+  checkEventPassword,
+  testNetworkConnection,
+} from './events.js';
+
+// ============================================================================
+// Venues API
+// ============================================================================
+
+export {
+  getVenue,
+  getVenueFees,
+  getVenueBySlug,
+} from './venues.js';
+
+// ============================================================================
+// Transformers
+// ============================================================================
+
+export {
+  // Order
+  transformOrder,
+  transformTicket,
+  transformOrderForDisplay,
+
+  // Event
+  transformEvent,
+  transformEventData,
+  transformAvailableTicket,
+  getCDNImageUrl,
+  getEventImageUrl,
+  calculateCtaState,
+
+  // Venue
+  transformVenue,
+  extractVenueFees,
+  formatVenueAddress,
+} from './transformers/index.js';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type {
+  // API Configuration
+  ApiConfig,
+  ApiResponse,
+
+  // Orders & Payment
+  PaymentIntentRequest,
+  PaymentIntentResponse,
+  CompleteReservationResponse,
+  CancelReservationResponse,
+  CreateOrderRequest,
+  CreateOrderResponse,
+  ValidatePaymentRequest,
+  ValidatePaymentResponse,
+  AttendeeInfo,
+
+  // Session
+  ExtendSessionRequest,
+  ExtendSessionResponse,
+  SessionStatus,
+
+  // Promo
+  PromoValidationResponse,
+  HasPromoCodesResponse,
+
+  // Orders
+  Order,
+  PurchasedTicket,
+
+  // Events
+  Event,
+  AvailableTicket,
+  EventPerformersResponse,
+  Performer,
+
+  // Venues
+  Venue,
+
+  // Series
+  SeriesOccurrence,
+  SeriesOccurrencesResponse,
+} from './types.js';