@getmicdrop/venue-calendar 3.3.0 → 3.3.2

package/{src/lib/api/types.ts → dist/api/types.d.ts}

@@ -1,289 +1,289 @@
-/**
- * API Types for MicDrop Public Checkout API
- *
- * These types define the shape of API requests and responses
- * for the public checkout flow (no authentication required).
- */
-
-// ============================================================================
-// Payment & Orders
-// ============================================================================
-
-export interface PaymentIntentRequest {
-  IP?: string;
-  productQuantities: Record<string | number, number>;
-}
-
-export interface PaymentIntentResponse {
-  client_secret: string;
-  amount: number;
-  amount_total: number;
-  tax_amount_exclusive?: number;
-  service_fee?: number;
-  discount?: number;
-  gift_card_amount?: number;
-  gift_card_code?: string;
-  stripe_publishable_key?: string;
-}
-
-export interface CompleteReservationResponse {
-  success: boolean;
-  message?: string;
-  error?: string;
-}
-
-export interface CancelReservationResponse {
-  success: boolean;
-  message?: string;
-  error?: string;
-}
-
-export interface CreateOrderRequest {
-  eventId: string | number;
-  promoCode?: string;
-}
-
-export interface CreateOrderResponse {
-  uuid: string;
-}
-
-export interface ValidatePaymentRequest {
-  id: string;
-  paymentIntentId: string;
-  tickets: Record<string | number, number>;
-  firstName: string;
-  lastName: string;
-  email: string;
-  paymentMethod: string;
-  mailingList?: boolean;
-  saleType?: string;
-  attendees?: AttendeeInfo[];
-}
-
-export interface AttendeeInfo {
-  ticketId: string | number;
-  firstName: string;
-  lastName: string;
-  email: string;
-}
-
-export interface ValidatePaymentResponse {
-  success: boolean;
-  status: string;
-  orderUUID?: string;
-  error?: string;
-}
-
-// ============================================================================
-// Session Management
-// ============================================================================
-
-export interface ExtendSessionRequest {
-  orderUuid: string;
-}
-
-export interface ExtendSessionResponse {
-  success: boolean;
-  newExpiryTime?: string;
-  remainingExtensions?: number;
-  error?: string;
-}
-
-export interface SessionStatus {
-  expiresAt?: string;
-  extensionCount?: number;
-  remainingExtensions?: number;
-  canExtend?: boolean;
-  reservationCount?: number;
-  error?: string;
-}
-
-// ============================================================================
-// Promo Codes
-// ============================================================================
-
-export interface PromoValidationResponse {
-  valid: boolean;
-  revealHiddenTickets?: boolean;
-  revealTicketIds?: number[];
-  provideDiscount?: boolean;
-  discountType?: 'percentage' | 'fixed';
-  amount?: number;
-  code?: string;
-  error?: string;
-}
-
-export interface HasPromoCodesResponse {
-  hasPromoCodes: boolean;
-}
-
-// ============================================================================
-// Orders
-// ============================================================================
-
-export interface Order {
-  uuid: string;
-  id?: number;
-  customerEmail: string;
-  customerFirstName?: string;
-  customerLastName?: string;
-  status: string;
-  totalAmount: number;
-  subtotal?: number;
-  serviceFeesAmount: number;
-  taxAmount: number;
-  discount?: number;
-  paymentIntentId?: string;
-  paymentMethod?: string;
-  purchasedTickets: PurchasedTicket[];
-  createdAt?: string;
-  updatedAt?: string;
-}
-
-export interface PurchasedTicket {
-  uuid: string;
-  id?: number;
-  ticketNumber?: string;
-  orderId?: string | number;
-  attendeeFirstName?: string;
-  attendeeLastName?: string;
-  attendeeEmail?: string;
-  ticketName: string;
-  ticketTypeId?: number;
-  purchasePrice: number;
-  status?: string;
-  checkedIn?: boolean;
-  checkedInAt?: string;
-}
-
-// ============================================================================
-// Events
-// ============================================================================
-
-export interface Event {
-  eventID: number;
-  id?: number;
-  name: string;
-  title?: string;
-  slug?: string;
-  description?: string;
-  date: string;
-  startDateTime?: string;
-  endDateTime?: string;
-  doorsOpenTime?: string;
-  timezone?: string;
-  venueId?: number;
-  venueName?: string;
-  venueAddress?: string;
-  location?: string;
-  imageUrl?: string;
-  imageURL?: string;
-  status?: string;
-  isPublished?: boolean;
-  isCancelled?: boolean;
-  availableTickets?: AvailableTicket[];
-  ticketsAvailable?: number;
-  ticketsSold?: number;
-  minPrice?: number;
-  maxPrice?: number;
-  ctaText?: string;
-  ctaState?: 'available' | 'sold_out' | 'coming_soon' | 'ended';
-  showPerformers?: boolean;
-  eventSeriesId?: number;
-  seriesInstanceNumber?: number;
-}
-
-export interface AvailableTicket {
-  id: number;
-  name: string;
-  description?: string;
-  price: number;
-  quantity: number;
-  quantitySold?: number;
-  quantityAvailable?: number;
-  minPerOrder?: number;
-  maxPerOrder?: number;
-  saleStartDate?: string;
-  saleEndDate?: string;
-  isHidden?: boolean;
-  revealWithPromoCode?: boolean;
-  ticketType?: number; // 0 = GA, 1 = assigned
-  sectionId?: number;
-  sortOrder?: number;
-}
-
-export interface EventPerformersResponse {
-  performers: Performer[];
-  showPerformers: boolean;
-}
-
-export interface Performer {
-  id: number;
-  stageName: string;
-  displayName?: string;
-  avatar?: string;
-  order?: number;
-}
-
-// ============================================================================
-// Venues
-// ============================================================================
-
-export interface Venue {
-  id: number;
-  name: string;
-  slug?: string;
-  address?: string;
-  googleLocationNameCache?: string;
-  city?: string;
-  state?: string;
-  zipCode?: string;
-  country?: string;
-  timezone?: string;
-  logoUrl?: string;
-  serviceFeePercentage?: number;
-  serviceFeeCents?: number;
-  taxPercentage?: number;
-  organizationId?: number;
-}
-
-// ============================================================================
-// Series
-// ============================================================================
-
-export interface SeriesOccurrence {
-  eventId: number;
-  date: string;
-  startDateTime: string;
-  endDateTime?: string;
-  instanceNumber: number;
-  status: string;
-  ticketsAvailable?: number;
-  ctaState?: string;
-}
-
-export interface SeriesOccurrencesResponse {
-  seriesId: number;
-  occurrences: SeriesOccurrence[];
-}
-
-// ============================================================================
-// API Configuration
-// ============================================================================
-
-export interface ApiConfig {
-  baseUrl?: string;
-  timeout?: number;
-  onError?: (error: Error) => void;
-}
-
-// ============================================================================
-// Generic API Response
-// ============================================================================
-
-export interface ApiResponse<T> {
-  success: boolean;
-  data?: T;
-  error?: string;
-  statusCode?: number;
-}
+/**
+ * API Types for MicDrop Public Checkout API
+ *
+ * These types define the shape of API requests and responses
+ * for the public checkout flow (no authentication required).
+ */
+
+// ============================================================================
+// Payment & Orders
+// ============================================================================
+
+export interface PaymentIntentRequest {
+  IP?: string;
+  productQuantities: Record<string | number, number>;
+}
+
+export interface PaymentIntentResponse {
+  client_secret: string;
+  amount: number;
+  amount_total: number;
+  tax_amount_exclusive?: number;
+  service_fee?: number;
+  discount?: number;
+  gift_card_amount?: number;
+  gift_card_code?: string;
+  stripe_publishable_key?: string;
+}
+
+export interface CompleteReservationResponse {
+  success: boolean;
+  message?: string;
+  error?: string;
+}
+
+export interface CancelReservationResponse {
+  success: boolean;
+  message?: string;
+  error?: string;
+}
+
+export interface CreateOrderRequest {
+  eventId: string | number;
+  promoCode?: string;
+}
+
+export interface CreateOrderResponse {
+  uuid: string;
+}
+
+export interface ValidatePaymentRequest {
+  id: string;
+  paymentIntentId: string;
+  tickets: Record<string | number, number>;
+  firstName: string;
+  lastName: string;
+  email: string;
+  paymentMethod: string;
+  mailingList?: boolean;
+  saleType?: string;
+  attendees?: AttendeeInfo[];
+}
+
+export interface AttendeeInfo {
+  ticketId: string | number;
+  firstName: string;
+  lastName: string;
+  email: string;
+}
+
+export interface ValidatePaymentResponse {
+  success: boolean;
+  status: string;
+  orderUUID?: string;
+  error?: string;
+}
+
+// ============================================================================
+// Session Management
+// ============================================================================
+
+export interface ExtendSessionRequest {
+  orderUuid: string;
+}
+
+export interface ExtendSessionResponse {
+  success: boolean;
+  newExpiryTime?: string;
+  remainingExtensions?: number;
+  error?: string;
+}
+
+export interface SessionStatus {
+  expiresAt?: string;
+  extensionCount?: number;
+  remainingExtensions?: number;
+  canExtend?: boolean;
+  reservationCount?: number;
+  error?: string;
+}
+
+// ============================================================================
+// Promo Codes
+// ============================================================================
+
+export interface PromoValidationResponse {
+  valid: boolean;
+  revealHiddenTickets?: boolean;
+  revealTicketIds?: number[];
+  provideDiscount?: boolean;
+  discountType?: 'percentage' | 'fixed';
+  amount?: number;
+  code?: string;
+  error?: string;
+}
+
+export interface HasPromoCodesResponse {
+  hasPromoCodes: boolean;
+}
+
+// ============================================================================
+// Orders
+// ============================================================================
+
+export interface Order {
+  uuid: string;
+  id?: number;
+  customerEmail: string;
+  customerFirstName?: string;
+  customerLastName?: string;
+  status: string;
+  totalAmount: number;
+  subtotal?: number;
+  serviceFeesAmount: number;
+  taxAmount: number;
+  discount?: number;
+  paymentIntentId?: string;
+  paymentMethod?: string;
+  purchasedTickets: PurchasedTicket[];
+  createdAt?: string;
+  updatedAt?: string;
+}
+
+export interface PurchasedTicket {
+  uuid: string;
+  id?: number;
+  ticketNumber?: string;
+  orderId?: string | number;
+  attendeeFirstName?: string;
+  attendeeLastName?: string;
+  attendeeEmail?: string;
+  ticketName: string;
+  ticketTypeId?: number;
+  purchasePrice: number;
+  status?: string;
+  checkedIn?: boolean;
+  checkedInAt?: string;
+}
+
+// ============================================================================
+// Events
+// ============================================================================
+
+export interface Event {
+  eventID: number;
+  id?: number;
+  name: string;
+  title?: string;
+  slug?: string;
+  description?: string;
+  date: string;
+  startDateTime?: string;
+  endDateTime?: string;
+  doorsOpenTime?: string;
+  timezone?: string;
+  venueId?: number;
+  venueName?: string;
+  venueAddress?: string;
+  location?: string;
+  imageUrl?: string;
+  imageURL?: string;
+  status?: string;
+  isPublished?: boolean;
+  isCancelled?: boolean;
+  availableTickets?: AvailableTicket[];
+  ticketsAvailable?: number;
+  ticketsSold?: number;
+  minPrice?: number;
+  maxPrice?: number;
+  ctaText?: string;
+  ctaState?: 'available' | 'sold_out' | 'coming_soon' | 'ended';
+  showPerformers?: boolean;
+  eventSeriesId?: number;
+  seriesInstanceNumber?: number;
+}
+
+export interface AvailableTicket {
+  id: number;
+  name: string;
+  description?: string;
+  price: number;
+  quantity: number;
+  quantitySold?: number;
+  quantityAvailable?: number;
+  minPerOrder?: number;
+  maxPerOrder?: number;
+  saleStartDate?: string;
+  saleEndDate?: string;
+  isHidden?: boolean;
+  revealWithPromoCode?: boolean;
+  ticketType?: number; // 0 = GA, 1 = assigned
+  sectionId?: number;
+  sortOrder?: number;
+}
+
+export interface EventPerformersResponse {
+  performers: Performer[];
+  showPerformers: boolean;
+}
+
+export interface Performer {
+  id: number;
+  stageName: string;
+  displayName?: string;
+  avatar?: string;
+  order?: number;
+}
+
+// ============================================================================
+// Venues
+// ============================================================================
+
+export interface Venue {
+  id: number;
+  name: string;
+  slug?: string;
+  address?: string;
+  googleLocationNameCache?: string;
+  city?: string;
+  state?: string;
+  zipCode?: string;
+  country?: string;
+  timezone?: string;
+  logoUrl?: string;
+  serviceFeePercentage?: number;
+  serviceFeeCents?: number;
+  taxPercentage?: number;
+  organizationId?: number;
+}
+
+// ============================================================================
+// Series
+// ============================================================================
+
+export interface SeriesOccurrence {
+  eventId: number;
+  date: string;
+  startDateTime: string;
+  endDateTime?: string;
+  instanceNumber: number;
+  status: string;
+  ticketsAvailable?: number;
+  ctaState?: string;
+}
+
+export interface SeriesOccurrencesResponse {
+  seriesId: number;
+  occurrences: SeriesOccurrence[];
+}
+
+// ============================================================================
+// API Configuration
+// ============================================================================
+
+export interface ApiConfig {
+  baseUrl?: string;
+  timeout?: number;
+  onError?: (error: Error) => void;
+}
+
+// ============================================================================
+// Generic API Response
+// ============================================================================
+
+export interface ApiResponse<T> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  statusCode?: number;
+}

package/dist/api/venues.d.ts

@@ -0,0 +1,33 @@
+import { Venue } from './types.js';
+/**
+ * Get venue details (public, no auth required)
+ *
+ * Fetches venue information including service fees and taxes
+ * needed for checkout calculations.
+ *
+ * @param venueId - The venue ID
+ * @returns Venue details or null on error
+ */
+export declare function getVenue(venueId: string | number): Promise<Venue | null>;
+/**
+ * Get venue service fee configuration
+ *
+ * Returns just the fee-related fields for checkout calculations.
+ *
+ * @param venueId - The venue ID
+ * @returns Fee configuration or null on error
+ */
+export declare function getVenueFees(venueId: string | number): Promise<{
+    serviceFeePercentage: number;
+    serviceFeeCents: number;
+    taxPercentage: number;
+} | null>;
+/**
+ * Get venue by slug
+ *
+ * Fetches venue using its URL-friendly slug.
+ *
+ * @param slug - The venue slug
+ * @returns Venue details or null on error
+ */
+export declare function getVenueBySlug(slug: string): Promise<Venue | null>;