@getmicdrop/venue-calendar 4.0.110 → 4.0.112

package/dist/api/types.d.ts

@@ -1,483 +0,0 @@
-/**
- * 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).
- */
-
-import type { EventId, SeriesId } from '@getmicdrop/svelte-components';
-
-// ============================================================================
-// Payment & Orders
-// ============================================================================
-
-export interface PaymentIntentRequest {
-  IP?: string;
-  productQuantities: Record<string | number, number>;
-}
-
-export interface PaymentIntentResponse {
-  client_secret: string;
-  // The residual the buyer is charged via Stripe, in int cents (net of any
-  // applied gift card). This is the field the checkout Total keys off. The
-  // orders-service response has NO `amount` key — an earlier `amount` here was
-  // never populated, so Total rendered $0.00 on every paid order.
-  stripe_amount?: number;
-  amount_total: number;
-  subtotal?: number;
-  tax?: number;
-  tax_amount_exclusive?: number;
-  service_fee?: number;
-  discount?: number;
-  gift_card_amount?: number;
-  gift_card_code?: string;
-  stripe_publishable_key?: string;
-  // ISO-4217 currency (Stripe returns it lowercase). Feeds the checkout totals.
-  currency?: 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;
-  /**
-   * Fail-closed FLOOR fields. When the event is canceled/postponed between
-   * cart-creation and finalize, the backend gate refuses to capture the charge
-   * and sets one of these (alongside `success: false`). Either flag means the
-   * buyer was NOT charged; the checkout raises the charge-aware
-   * EventUnavailableModal instead of navigating to success. Optional because
-   * they are only present on the rejected-finalize path.
-   */
-  eventCanceled?: boolean;
-  eventPostponed?: boolean;
-}
-
-// ============================================================================
-// Session Management
-// ============================================================================
-
-export interface ExtendSessionRequest {
-  orderUuid: string;
-}
-
-export interface ExtendSessionResponse {
-  success: boolean;
-  newExpiryTime?: string;
-  remainingExtensions?: number;
-  error?: string;
-  /**
-   * HTTP status code from the backend on failure. Populated on non-OK
-   * responses so callers can distinguish "session already expired"
-   * (typically 410 Gone) from "max extensions reached" or generic 5xx.
-   * Undefined on network errors and on success.
-   */
-  statusCode?: number;
-}
-
-export interface SessionStatus {
-  expiresAt?: string;
-  extensionCount?: number;
-  remainingExtensions?: number;
-  canExtend?: boolean;
-  reservationCount?: number;
-  error?: string;
-  // 404 from /orders/session/{uuid}: the cart's reservations are
-  // gone (expired or never existed). Callers polling on an interval
-  // MUST treat this as terminal and stop — see CartView.svelte.
-  notFound?: boolean;
-  // Live event status piggybacked on the session heartbeat so the public
-  // checkout can flip the buy button the moment an operator cancels/postpones,
-  // without a dedicated poll or socket. One of the auth-service Event statuses
-  // (draft|live|started|ended|canceled|postponed). Absent if the lookup failed.
-  eventStatus?: string;
-}
-
-// ============================================================================
-// Promo Codes
-// ============================================================================
-
-export interface PromoValidationResponse {
-  valid: boolean;
-  revealHiddenTickets?: boolean;
-  revealTicketIds?: number[];
-  provideDiscount?: boolean;
-  discountType?: 'percentage' | 'fixed';
-  amount?: number;
-  code?: string;
-  error?: string;
-}
-
-/**
- * RAW body of GET /api/v2/public/promo-codes/validate/{eventId}/{code}.
- *
- * The live endpoint reports the discount magnitude as `discount` and the code
- * as `name` — NOT `amount`/`code`. validatePromoCode normalises this into the
- * client-facing PromoValidationResponse (amount/code) so callers read one shape.
- * The legacy `amount`/`code` keys stay optional here so an older payload (or a
- * mocked one) still maps through the same fallback. Verified 2026-07-11 against
- * two live promos (seeded GUARD20PCT + pre-existing EARLY20).
- */
-export interface RawPromoValidationBody {
-  valid?: boolean;
-  revealHiddenTickets?: boolean;
-  revealTicketIds?: number[];
-  provideDiscount?: boolean;
-  discountType?: 'percentage' | 'fixed';
-  /** Discount magnitude — real server field. */
-  discount?: number;
-  /** Legacy/mocked magnitude field — fallback only. */
-  amount?: number;
-  /** Promo code — real server field. */
-  name?: string;
-  /** Legacy/mocked code field — fallback only. */
-  code?: string;
-  appliesToAllTickets?: boolean;
-  applyToTicketIds?: number[];
-  isGlobal?: boolean;
-  ticketLimit?: number;
-  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;
-  // ── Passthrough seams (events convergence) ─────────────────────────────
-  // Carried verbatim from the wire by parseEvent so view-shape projections
-  // (utils/event-transform.js, public-calendar-flow/transform.ts) compose the
-  // canonical instead of reading wire fields directly. The object-valued
-  // fields are intentionally raw (see composition note in
-  // api/transformers/event.ts) — their consumers own the wire variance.
-  timeZone?: string;
-  eventSummary?: string;
-  password?: string;
-  hasPassword?: boolean;
-  disclaimer?: string;
-  ticketType?: number;
-  eventTicketingType?: number;
-  ageRestriction?: number;
-  displayAgeRestriction?: boolean;
-  displayStartTime?: boolean;
-  displayEndTime?: boolean;
-  displayDoorsTime?: boolean;
-  collectionId?: number;
-  ticketsRemaining?: number;
-  ticketsTotal?: number;
-  hasHiddenTickets?: boolean;
-  stage?: { name?: string } | null;
-  stageName?: string;
-  // Widget-filter dimensions on the public month feeds (saved-widget engine):
-  // stage/category/performer/collection data the embed adapts onto the SC
-  // FilterableEvent view (lib/widget-filters.js).
-  stageId?: number;
-  eventCategoryTypes?: number[] | null;
-  publicPerformers?: Array<{
-    id?: number;
-    displayName?: string;
-    image?: string;
-  }> | null;
-  collectionIds?: number[] | null;
-  venue?: Record<string, any>;
-  performers?: Record<string, any>[];
-  faqs?: Record<string, any>[];
-  showtimes?: Record<string, any>[];
-  purchasedTickets?: Record<string, any>[];
-}
-
-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;
-  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: EventId;
-  date: string;
-  startDateTime: string;
-  endDateTime?: string;
-  instanceNumber: number;
-  status: string;
-  ticketsAvailable?: number;
-  ctaState?: string;
-}
-
-export interface SeriesOccurrencesResponse {
-  seriesId: SeriesId;
-  occurrences: SeriesOccurrence[];
-}
-
-// ============================================================================
-// Series Page
-// ============================================================================
-
-export interface SeriesPageData {
-  id: number;
-  title: string;
-  description: string;
-  eventSummary?: string;
-  image?: string;
-  timeZone: string;
-  venue: {
-    id: number;
-    name: string;
-    location?: string;
-    googleLocationNameCache?: string;
-    faq?: Array<{ question: string; answer: string }> | string;
-    disclaimer?: string;
-  };
-  performers: Array<{
-    displayName: string;
-    firstName?: string;
-    lastName?: string;
-    profileImage?: string;
-  }>;
-  occurrences: Array<{
-    id: number;
-    slug: string;
-    startDateTime: string;
-    endDateTime: string;
-    ctaState: {
-      text: string;
-      disabled: boolean;
-      reason?: string;
-    };
-  }>;
-}
-
-// ============================================================================
-// Entity resolution (type-agnostic public id → concrete entity)
-// ============================================================================
-
-/**
- * Response shape of `/api/v2/public/resolve/{id}`. The embed deep-link is
- * type-agnostic (`#{id}-{slug}`), so the backend resolves which kind of entity
- * the id points at; `data` is the corresponding event / series / collection
- * payload (same shape the dedicated fetchers return for that type).
- */
-export interface ResolvedEntity {
-  type: 'event' | 'series' | 'collection';
-  id: string | number;
-  title?: string;
-  data: any;
-}
-
-// ============================================================================
-// Public Collection
-// ============================================================================
-
-export interface PublicCollectionData {
-  id: number;
-  collectionTitle: string;
-  summary?: string;
-  description?: string;
-  coverImage?: string;
-  events: Array<{
-    id: number;
-    title: string;
-    slug?: string;
-    startDateTime?: string;
-    endDateTime?: string;
-    image?: string;
-    status?: string;
-    venue?: { name: string };
-    minPrice?: number;
-  }>;
-  // Password-gate variant: a protected collection responds with a gate signal
-  // instead of the collection body (either `passwordRequired: true` or an
-  // `error.code === 'PASSWORD_REQUIRED'`). Modelled here as optional wire
-  // fields so the view can read them without an `as any` escape.
-  passwordRequired?: boolean;
-  error?: { code?: string };
-}
-
-// ============================================================================
-// API Configuration
-// ============================================================================
-
-export interface ApiConfig {
-  baseUrl?: string;
-  timeout?: number;
-  /** Number of additional attempts after the first try (default: 2 = 3 total tries). */
-  retries?: number;
-  /** Base delay before the first retry; doubles each attempt (default: 500ms). */
-  retryDelay?: number;
-  onError?: (_error: Error) => void;
-}
-
-// ============================================================================
-// Generic API Response
-// ============================================================================
-
-export interface ApiResponse<T> {
-  success: boolean;
-  data?: T;
-  error?: string;
-  statusCode?: number;
-}

package/dist/seo/HostSeoController.d.ts

@@ -1,68 +0,0 @@
-import { HostSeoControllerOptions } from './types';
-interface ListingEvent {
-    id: number | string;
-    name: string;
-    slug?: string;
-    startDateTime?: string;
-    image?: string;
-}
-interface VenueData {
-    name: string;
-    address?: string;
-    googleLocationNameCache?: string;
-    timeZone?: string;
-    timezone?: string;
-}
-export declare class HostSeoController {
-    /**
-     * Single active instance. A venue page that mounts >1 calendar embed
-     * (e.g. "upcoming shows" + "this weekend") will see the *later*
-     * controller take over `<head>` — the earlier one is destroyed.
-     *
-     * KNOWN LIMITATION: multi-embed pages cannot run two SEO controllers
-     * in parallel because they would both fight to own `<title>`/OG/etc.
-     * Pass `data-inject-seo="false"` on all but one embed to opt out.
-     */
-    static _activeInstance: HostSeoController | null;
-    private _state;
-    private _venueName;
-    private _venueAddress;
-    private _venueTimeZone;
-    private _baseUrl;
-    private _originals;
-    private _originalsSaved;
-    private _events;
-    constructor(options: HostSeoControllerOptions);
-    private _saveOriginals;
-    private _injectJsonLd;
-    private _setMeta;
-    private _setCanonical;
-    private _removeAllInjected;
-    private _restoreOriginals;
-    private _restoreMetaProperty;
-    private _restoreMetaName;
-    private _buildItemList;
-    private _buildEntityUrl;
-    /**
-     * Called when events finish loading from the API.
-     * Injects an ItemList JSON-LD for the listing. Does not modify OG/canonical/title.
-     */
-    onEventsLoaded(events: ListingEvent[], venue?: VenueData): void;
-    /**
-     * Called when the user selects an event, series, or collection.
-     * Replaces ItemList JSON-LD with entity-specific JSON-LD and updates
-     * all head tags (canonical, OG, meta description, title).
-     */
-    onEntitySelected(type: 'event' | 'series' | 'collection', data: any, venue?: VenueData): void;
-    /**
-     * Called when the user navigates back to the event listing.
-     * Restores original head elements and re-injects ItemList JSON-LD.
-     */
-    onBackToListing(): void;
-    /**
-     * Called when the widget is destroyed. Removes all injected elements
-     * and restores originals. Clears the static active instance.
-     */
-    destroy(): void;
-}
-export {};

package/dist/seo/buildCollectionJsonLd.d.ts

@@ -1,8 +0,0 @@
-import { CollectionJsonLdInput } from './types';
-export interface BuildCollectionJsonLdOptions {
-    collection: CollectionJsonLdInput;
-    baseEventUrl?: string;
-    /** Accepted for API compatibility; the summary ItemList carries no dates. */
-    defaultTimeZone?: string;
-}
-export declare function buildCollectionJsonLd(options: BuildCollectionJsonLdOptions): Record<string, unknown> | null;

package/dist/seo/buildEventJsonLd.d.ts

@@ -1,9 +0,0 @@
-import { EventJsonLdInput, VenueInput, OrganizerInput } from './types';
-export interface BuildEventJsonLdOptions {
-    event: EventJsonLdInput;
-    venue: VenueInput;
-    venueTimeZone?: string;
-    eventUrl?: string;
-    organizer?: OrganizerInput;
-}
-export declare function buildEventJsonLd(options: BuildEventJsonLdOptions): Record<string, unknown> | null;

package/dist/seo/buildSeriesJsonLd.d.ts

@@ -1,6 +0,0 @@
-import { SeriesJsonLdInput } from './types';
-export interface BuildSeriesJsonLdOptions {
-    series: SeriesJsonLdInput;
-    baseEventUrl?: string;
-}
-export declare function buildSeriesJsonLd(options: BuildSeriesJsonLdOptions): Record<string, unknown> | null;

package/dist/seo/helpers.d.ts

@@ -1,88 +0,0 @@
-import { EventTicketInput, EventPerformerInput } from './types';
-/**
- * Escape a JSON string for safe embedding inside an inline
- * <script type="application/ld+json"> element.
- *
- * JSON.stringify does NOT escape `<`, `>` or `&`, so a field value containing
- * `</script><script>...` would break out of the script element and execute
- * (stored XSS). Replacing those characters with their unicode escape sequences
- * keeps the output valid JSON (parsers decode `<` back to `<`) while making
- * it impossible to terminate the surrounding <script> tag.
- *
- * This is the standard JSON-LD-in-<script> hardening; the sibling
- * HostSeoController avoids the issue entirely by using element.textContent.
- */
-export declare function escapeJsonLdForScript(json: string): string;
-/**
- * Format datetime to ISO-8601 with timezone offset.
- * Google requires: "2025-07-21T19:00:00-05:00"
- *
- * Extracted from EventStructuredData.svelte lines 25-68.
- */
-export declare function formatDateTimeWithOffset(isoString: string | null | undefined, tz: string): string | null;
-/**
- * Parse address string into PostalAddress components.
- * Input: "7702 Santa Monica Blvd, West Hollywood, CA 90046"
- * Output: { @type, streetAddress, addressLocality, addressRegion, postalCode, addressCountry }
- *
- * Extracted from EventStructuredData.svelte lines 75-111.
- */
-export declare function parseAddressToPostal(addressStr: string | null | undefined): Record<string, string> | null;
-/**
- * Structured postal-address parts, as the public resolve/series payloads now
- * expose them: `address` is the STREET line, with city/state/postalCode/country
- * as discrete fields (PublicVenueInfo / SeriesVenueDTO).
- */
-export interface PostalAddressParts {
-    address?: string | null;
-    city?: string | null;
-    state?: string | null;
-    postalCode?: string | null;
-    country?: string | null;
-}
-/**
- * Build a schema.org PostalAddress, preferring discrete structured fields when
- * any locality signal (city / state / postalCode) is present, and otherwise
- * falling back to parsing a single comma-separated string (the street `address`
- * field if it carries a full address, else `googleLocationNameCache`).
- *
- * Discrete fields are more reliable than string-splitting — Google requires a
- * well-formed PostalAddress for Event rich-result eligibility (online-only
- * events lost eligibility June 2025).
- */
-export declare function buildPostalAddress(parts: PostalAddressParts | null | undefined, fallback?: string | null): Record<string, string> | null;
-/**
- * Map event status to schema.org EventStatusType.
- *
- * Extracted from EventStructuredData.svelte lines 116-132.
- */
-export declare function getEventStatus(rawStatus: string | null | undefined): string;
-/**
- * Map ticket availability to schema.org ItemAvailability.
- *
- * Extracted from EventStructuredData.svelte lines 137-157.
- */
-export declare function getTicketAvailability(ticket: EventTicketInput): string;
-/**
- * Build a schema.org price-range offer from a low/high price and availability.
- *
- * The shared primitive behind every JSON-LD offer block: emit an AggregateOffer
- * when the range spans two prices, or a single Offer when low === high. Any
- * caller-specific fields (a buy `url`, a `validFrom` sales-start) ride along in
- * `extra`, spread verbatim after the core fields so each caller reproduces its
- * exact prior shape — the event builder passes url/validFrom, the series builder
- * passes nothing.
- */
-export declare function buildPriceRangeOffer(lowPrice: number, highPrice: number, availability: string, extra?: Record<string, unknown>): Record<string, unknown>;
-/**
- * Build offers from available tickets.
- *
- * Extracted from EventStructuredData.svelte lines 162-208.
- */
-export declare function buildOffers(tickets: EventTicketInput[] | null | undefined, url?: string): Record<string, unknown> | null;
-/**
- * Build performer array from event performers.
- *
- * Extracted from EventStructuredData.svelte lines 213-237.
- */
-export declare function buildPerformers(performers: EventPerformerInput[] | null | undefined): Array<Record<string, string>> | null;

package/dist/seo/index.d.ts

@@ -1,10 +0,0 @@
-export { buildEventJsonLd } from './buildEventJsonLd';
-export { buildSeriesJsonLd } from './buildSeriesJsonLd';
-export { buildCollectionJsonLd } from './buildCollectionJsonLd';
-export { HostSeoController } from './HostSeoController';
-export type { BuildEventJsonLdOptions } from './buildEventJsonLd';
-export type { BuildSeriesJsonLdOptions } from './buildSeriesJsonLd';
-export type { BuildCollectionJsonLdOptions } from './buildCollectionJsonLd';
-export type { EventJsonLdInput, EventTicketInput, EventPerformerInput, VenueInput, OrganizerInput, SeriesJsonLdInput, CollectionJsonLdInput, HostSeoControllerOptions, } from './types';
-export { formatDateTimeWithOffset, parseAddressToPostal, buildPostalAddress, getEventStatus, getTicketAvailability, buildOffers, buildPerformers, escapeJsonLdForScript, } from './helpers';
-export type { PostalAddressParts } from './helpers';