tixbit 0.1.0

package/dist/cli.js

@@ -0,0 +1,646 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { Command } from "commander";
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://tixbit.com";
+var DEFAULT_TIMEOUT_MS = 15e3;
+var USER_AGENT = "@tixbit/sdk";
+var TixBitClient = class {
+  baseUrl;
+  timeoutMs;
+  apiKey;
+  constructor(config = {}) {
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.apiKey = config.apiKey;
+  }
+  // ── HTTP helpers ──────────────────────────────────────────────────────────
+  async request(path, init) {
+    const url = `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    const headers = {
+      Accept: "application/json",
+      "User-Agent": USER_AGENT,
+      ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}
+    };
+    try {
+      const res = await fetch(url, {
+        ...init,
+        headers: { ...headers, ...init?.headers },
+        signal: controller.signal
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new TixBitApiError(
+          `${res.status} ${res.statusText}: ${text.slice(0, 300)}`,
+          res.status,
+          url
+        );
+      }
+      return await res.json();
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  qs(params) {
+    const entries = Object.entries(params).filter(([, v]) => v !== void 0 && v !== null && v !== "").map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
+    return entries.length ? `?${entries.join("&")}` : "";
+  }
+  // ── Search Events ─────────────────────────────────────────────────────────
+  /**
+   * Search for events by keyword, city, state, category, or date range.
+   *
+   * @example
+   * ```ts
+   * const results = await client.searchEvents({ query: "Hawks", state: "GA" });
+   * ```
+   */
+  async searchEvents(params = {}) {
+    const query = this.qs({
+      q: params.query,
+      city: params.city,
+      state: params.state,
+      category: params.category,
+      startDate: params.startDate,
+      endDate: params.endDate,
+      page: params.page,
+      size: params.size ?? 25
+    });
+    const data = await this.request(`/api/events/search${query}`);
+    return {
+      events: (data.events ?? []).map(normalizeEvent),
+      pagination: data.pagination
+    };
+  }
+  // ── Browse (Location-Aware) ───────────────────────────────────────────────
+  /**
+   * Browse upcoming events near a location (homepage-style).
+   *
+   * @example
+   * ```ts
+   * const nearby = await client.browse({ city: "Atlanta", state: "GA" });
+   * ```
+   */
+  async browse(params = {}) {
+    const query = this.qs({
+      size: params.size ?? 18,
+      context: "homepage",
+      recommendation: "upcoming",
+      nearLat: params.latitude,
+      nearLng: params.longitude,
+      preferCity: params.city,
+      preferState: params.state,
+      categoryEventType: params.categoryEventType
+    });
+    const data = await this.request(`/api/events${query}`);
+    return {
+      events: (data.events ?? []).map(normalizeEvent),
+      total: data.total
+    };
+  }
+  // ── Listings ──────────────────────────────────────────────────────────────
+  /**
+   * Get available ticket listings for an event.
+   *
+   * @example
+   * ```ts
+   * const listings = await client.getListings({ eventId: "abc123" });
+   * ```
+   */
+  async getListings(params) {
+    const query = this.qs({
+      size: params.size ?? 50,
+      page: params.page ?? 1,
+      order_by_direction: params.orderByDirection ?? "asc"
+    });
+    const data = await this.request(`/api/events/${encodeURIComponent(params.eventId)}/listings${query}`);
+    const listings = (data.data ?? []).map(normalizeListing);
+    return {
+      listings,
+      meta: {
+        total: data.meta?.total ?? listings.length,
+        page: data.meta?.page ?? params.page ?? 1,
+        size: data.meta?.size ?? params.size ?? 50,
+        cacheSource: data.meta?.cacheSource
+      }
+    };
+  }
+  // ── Checkout Link ──────────────────────────────────────────────────────────
+  /**
+   * Create a checkout link for a listing.
+   *
+   * Returns a URL to the TixBit checkout page where the user can
+   * sign in and complete their purchase (card, crypto, etc.).
+   *
+   * @example
+   * ```ts
+   * const link = client.createCheckoutLink({
+   *   listingId: "P2JO5OBX",
+   *   quantity: 2,
+   * });
+   *
+   * console.log(link.url);
+   * // → "https://tixbit.com/checkout/process?listing=P2JO5OBX&quantity=2"
+   * ```
+   */
+  createCheckoutLink(params) {
+    const quantity = Math.max(1, Math.min(8, Math.round(params.quantity)));
+    const url = `${this.baseUrl}/checkout/process?listing=${encodeURIComponent(params.listingId)}&quantity=${quantity}`;
+    return {
+      url,
+      listingId: params.listingId,
+      quantity
+    };
+  }
+  // ── Event URL helper ──────────────────────────────────────────────────────
+  /**
+   * Build the direct URL to an event page on tixbit.com.
+   */
+  eventUrl(slugOrId) {
+    return `${this.baseUrl}/events/${slugOrId}`;
+  }
+  // ── Seatmap ───────────────────────────────────────────────────────────────
+  /**
+   * Get the seating chart for an event's venue.
+   *
+   * Returns section-level data including section names, positions, and
+   * the venue background image URL. Use this to help users understand
+   * where their tickets are located.
+   *
+   * @example
+   * ```ts
+   * const seatmap = await client.getSeatmap({ eventId: "4BKJMDZ" });
+   * console.log(seatmap.venue_name); // "State Farm Arena"
+   * console.log(seatmap.section_names); // ["101", "102", ...]
+   * ```
+   */
+  async getSeatmap(params) {
+    const data = await this.request(`/api/events/${encodeURIComponent(params.eventId)}/seating-chart`);
+    let zones = [];
+    let sectionNames = [];
+    if (data.has_coordinates && data.coordinates) {
+      try {
+        zones = await this.fetchAndParseCoordinates(data.coordinates);
+        sectionNames = zones.flatMap(
+          (z) => z.sections.map((s) => s.name)
+        );
+      } catch {
+      }
+    }
+    return {
+      success: data.success,
+      event_id: data.event_id,
+      venue_id: data.venue_id,
+      venue_name: data.venue_name,
+      configuration_id: data.configuration_id,
+      configuration_name: data.configuration_name,
+      background_image: data.background_image ?? null,
+      coordinates_url: data.coordinates ?? null,
+      has_coordinates: data.has_coordinates,
+      capacity: data.capacity ?? null,
+      venue: data.venue_data,
+      zones,
+      section_names: sectionNames
+    };
+  }
+  /**
+   * Fetch the coordinates JSON and parse it into zones/sections.
+   */
+  async fetchAndParseCoordinates(coordinatesUrl) {
+    const fullUrl = coordinatesUrl.startsWith("http") ? coordinatesUrl : `${this.baseUrl}${coordinatesUrl}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const res = await fetch(fullUrl, {
+        headers: {
+          Accept: "application/json",
+          "User-Agent": USER_AGENT
+        },
+        signal: controller.signal
+      });
+      if (!res.ok) return [];
+      const coords = await res.json();
+      if (!coords.zones) return [];
+      return coords.zones.map((zone) => ({
+        id: zone.id,
+        name: zone.name,
+        sections: (zone.sections ?? []).map((section) => {
+          const label = section.labels?.[0];
+          return {
+            id: section.id,
+            name: section.name,
+            x: label?.x ?? 0,
+            y: label?.y ?? 0
+          };
+        })
+      }));
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+};
+function normalizeEvent(raw) {
+  const e = raw;
+  return {
+    id: str(e.id) ?? str(e.external_event_id) ?? "",
+    external_event_id: str(e.external_event_id) ?? str(e.externalEventId) ?? str(e.id) ?? "",
+    slug: str(e.slug) ?? str(e.external_event_id) ?? "",
+    name: str(e.name) ?? str(e.performer) ?? "",
+    date: resolveDate(e),
+    venue_name: str(e.venue_name) ?? str(e.venueName) ?? null,
+    venue_city: str(e.venue_city) ?? str(e.venueCity) ?? null,
+    venue_state: str(e.venue_state) ?? str(e.venueState) ?? null,
+    image_url: str(e.image_url) ?? str(e.imageUrl) ?? null,
+    category_name: str(e.category_name) ?? str(e.categoryName) ?? null,
+    category_event_type: str(e.category_event_type) ?? str(e.categoryEventType) ?? null,
+    has_listings: Boolean(e.has_listings),
+    inventory: normalizeInventory(e.inventory)
+  };
+}
+function normalizeInventory(raw) {
+  if (!raw || typeof raw !== "object") {
+    return { total_available: 0, min_price: 0, max_price: 0 };
+  }
+  const inv = raw;
+  return {
+    total_available: num(inv.total_available) ?? 0,
+    min_price: num(inv.min_price) ?? 0,
+    max_price: num(inv.max_price) ?? 0
+  };
+}
+function normalizeListing(raw) {
+  const outer = raw;
+  const attrs = outer.attributes ?? outer;
+  return {
+    id: str(outer.id) ?? str(attrs.id) ?? "",
+    // price_per_ticket is the fee-inclusive per-ticket price (in dollars, not cents)
+    price: num(attrs.price_per_ticket) ?? num(attrs.price) ?? 0,
+    quantity: num(attrs.quantity) ?? num(attrs.available_quantity) ?? 0,
+    quantities_list: Array.isArray(attrs.quantities_list) ? attrs.quantities_list : [],
+    section: str(attrs.section) ?? null,
+    row: str(attrs.row) ?? null,
+    seat_numbers: str(attrs.seat_numbers) ?? null,
+    listing_hash: str(attrs.listing_hash) ?? "",
+    notes: str(attrs.notes) ?? null,
+    delivery_method: str(attrs.delivery_method) ?? str(attrs.delivery_type) ?? null,
+    splits: Array.isArray(attrs.splits) ? attrs.splits : [],
+    raw: outer
+  };
+}
+function resolveDate(e) {
+  if (typeof e.date === "string") return e.date;
+  if (typeof e.date === "number") return new Date(e.date).toISOString();
+  if (e.date && typeof e.date === "object") {
+    const d = e.date;
+    if (d.month && d.day && d.year) {
+      return `${d.month} ${d.day}, ${d.year}`;
+    }
+  }
+  if (typeof e.date_ms === "number") return new Date(e.date_ms).toISOString();
+  return "";
+}
+function str(v) {
+  return typeof v === "string" && v.length > 0 ? v : null;
+}
+function num(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+var TixBitApiError = class extends Error {
+  constructor(message, status, url) {
+    super(message);
+    this.status = status;
+    this.url = url;
+    this.name = "TixBitApiError";
+  }
+};
+
+// src/cli.ts
+var client = new TixBitClient({
+  baseUrl: process.env.TIXBIT_BASE_URL,
+  apiKey: process.env.TIXBIT_API_KEY
+});
+function output(data, json) {
+  if (json) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+    return;
+  }
+  if (Array.isArray(data)) {
+    for (const item of data) {
+      process.stdout.write(formatItem(item) + "\n");
+    }
+    return;
+  }
+  process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+}
+function formatItem(item) {
+  if (!item || typeof item !== "object") return String(item);
+  const e = item;
+  if (e.name && e.external_event_id) {
+    const parts = [
+      `  ${e.name}`,
+      `  ID: ${e.external_event_id}`
+    ];
+    if (e.date) parts.push(`  Date: ${e.date}`);
+    const location = [e.venue_city, e.venue_state].filter(Boolean).join(", ");
+    if (location) parts.push(`  Location: ${location}`);
+    if (e.venue_name) parts.push(`  Venue: ${e.venue_name}`);
+    if (e.has_listings) {
+      const inv = e.inventory;
+      if (inv?.min_price) {
+        parts.push(`  From: $${inv.min_price.toFixed(2)} (${inv.total_available} available)`);
+      }
+    }
+    return parts.join("\n") + "\n";
+  }
+  if (e.listing_hash !== void 0) {
+    const parts = [
+      `  $${e.price.toFixed(2)} \xD7 ${e.quantity} ticket(s)`,
+      `  ID: ${e.id}`
+    ];
+    if (e.section) parts.push(`  Section: ${e.section}${e.row ? ` Row ${e.row}` : ""}`);
+    if (e.delivery_method) parts.push(`  Delivery: ${e.delivery_method}`);
+    if (e.quantities_list?.length > 0) {
+      parts.push(`  Qty options: ${e.quantities_list.join(", ")}`);
+    }
+    return parts.join("\n") + "\n";
+  }
+  return JSON.stringify(item, null, 2);
+}
+function handleError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  process.stderr.write(`Error: ${msg}
+`);
+  process.exit(1);
+}
+var program = new Command().name("tixbit").description("Search events, browse listings, and buy tickets on TixBit").version("0.1.0");
+program.command("search [query]").description("Search for events by keyword, city, state, or category").option("--city <city>", "Filter by city").option("--state <state>", "Filter by state (2-letter code)").option("--category <slug>", "Filter by category slug (e.g. nba-basketball)").option("--start-date <date>", "Events on or after this date (ISO)").option("--end-date <date>", "Events on or before this date (ISO)").option("--page <n>", "Page number", "1").option("--size <n>", "Results per page", "10").option("--json", "Output raw JSON (for agents)", false).action(async (query, opts) => {
+  try {
+    const params = {
+      query,
+      city: opts.city,
+      state: opts.state,
+      category: opts.category,
+      startDate: opts.startDate,
+      endDate: opts.endDate,
+      page: parseInt(opts.page, 10),
+      size: parseInt(opts.size, 10)
+    };
+    const result = await client.searchEvents(params);
+    const isJson = opts.json === true || opts.json === "true";
+    if (isJson) {
+      output(result, true);
+    } else {
+      const { pagination } = result;
+      process.stdout.write(
+        `
+Found ${pagination.total} event(s) \u2014 page ${pagination.page}/${pagination.totalPages}
+
+`
+      );
+      output(result.events, false);
+    }
+  } catch (err) {
+    handleError(err);
+  }
+});
+program.command("browse").description("Browse upcoming events near a location").option("--city <city>", "Preferred city").option("--state <state>", "Preferred state (2-letter code)").option("--lat <lat>", "Latitude").option("--lng <lng>", "Longitude").option("--category <type>", "SPORT, CONCERT, THEATER, or ALL", "ALL").option("--size <n>", "Number of results", "10").option("--json", "Output raw JSON (for agents)", false).action(async (opts) => {
+  try {
+    const params = {
+      city: opts.city,
+      state: opts.state,
+      latitude: opts.lat ? parseFloat(opts.lat) : void 0,
+      longitude: opts.lng ? parseFloat(opts.lng) : void 0,
+      categoryEventType: opts.category ?? "ALL",
+      size: parseInt(opts.size, 10)
+    };
+    const result = await client.browse(params);
+    const isJson = opts.json === true || opts.json === "true";
+    if (isJson) {
+      output(result, true);
+    } else {
+      process.stdout.write(
+        `
+${result.events.length} upcoming event(s) near ${opts.city ?? "you"}
+
+`
+      );
+      output(result.events, false);
+    }
+  } catch (err) {
+    handleError(err);
+  }
+});
+program.command("listings <eventId>").description("Get available ticket listings for an event").option("--size <n>", "Results per page", "20").option("--page <n>", "Page number", "1").option("--sort <dir>", "Price sort: asc or desc", "asc").option("--json", "Output raw JSON (for agents)", false).action(async (eventId, opts) => {
+  try {
+    const params = {
+      eventId,
+      size: parseInt(opts.size, 10),
+      page: parseInt(opts.page, 10),
+      orderByDirection: opts.sort
+    };
+    const result = await client.getListings(params);
+    const isJson = opts.json === true || opts.json === "true";
+    if (isJson) {
+      output(result, true);
+    } else {
+      process.stdout.write(
+        `
+${result.listings.length} listing(s) for event ${eventId}
+
+`
+      );
+      output(result.listings, false);
+    }
+  } catch (err) {
+    handleError(err);
+  }
+});
+program.command("checkout <listingId>").description("Get a checkout link to buy tickets for a listing").requiredOption("--quantity <n>", "Number of tickets to buy").option("--json", "Output raw JSON", false).action(async (listingId, opts) => {
+  try {
+    const quantity = parseInt(opts.quantity, 10);
+    if (!Number.isFinite(quantity) || quantity < 1) {
+      process.stderr.write("Error: --quantity must be a positive integer\n");
+      process.exit(1);
+    }
+    const isJson = opts.json === true || opts.json === "true";
+    let listingInfo;
+    try {
+      const result = await client.getListings({ eventId: listingId, size: 1 });
+      if (result.listings.length > 0) {
+        listingInfo = result.listings.find((l) => l.id === listingId);
+      }
+    } catch {
+    }
+    const link = client.createCheckoutLink({ listingId, quantity });
+    if (isJson) {
+      output({ ...link, listing: listingInfo ?? null }, true);
+      return;
+    }
+    process.stdout.write("\n\u{1F39F}  Checkout Link\n\n");
+    if (listingInfo) {
+      process.stdout.write(`   Listing: ${listingInfo.id}
+`);
+      if (listingInfo.section) {
+        process.stdout.write(
+          `   Section: ${listingInfo.section}${listingInfo.row ? ` Row ${listingInfo.row}` : ""}
+`
+        );
+      }
+      process.stdout.write(
+        `   Price: $${listingInfo.price.toFixed(2)} \xD7 ${quantity} = $${(listingInfo.price * quantity).toFixed(2)}
+`
+      );
+    }
+    process.stdout.write(`   Quantity: ${quantity}
+
+`);
+    process.stdout.write(`   ${link.url}
+
+`);
+    process.stdout.write(
+      "   Open the link above in your browser to complete checkout.\n\n"
+    );
+  } catch (err) {
+    handleError(err);
+  }
+});
+program.command("seatmap <eventId>").description("Show the seating chart / section map for an event's venue").option("--section <name>", "Highlight a specific section (case-insensitive)").option("--json", "Output raw JSON (for agents)", false).action(async (eventId, opts) => {
+  try {
+    const result = await client.getSeatmap({ eventId });
+    const isJson = opts.json === true || opts.json === "true";
+    if (isJson) {
+      output(result, true);
+      return;
+    }
+    if (!result.success) {
+      process.stderr.write("Seatmap not available for this event.\n");
+      process.exit(1);
+    }
+    process.stdout.write(`
+\u{1F3DF}  ${result.venue_name}
+`);
+    process.stdout.write(`   ${result.configuration_name}
+`);
+    if (result.venue.address) {
+      process.stdout.write(`   ${result.venue.address}, ${result.venue.city}, ${result.venue.region}
+`);
+    }
+    if (result.capacity) {
+      process.stdout.write(`   Capacity: ${result.capacity.toLocaleString()}
+`);
+    }
+    process.stdout.write("\n");
+    if (!result.has_coordinates || result.zones.length === 0) {
+      process.stdout.write("  No section-level seating data available for this venue.\n\n");
+      return;
+    }
+    const groups = categorizeSections(result.zones.flatMap((z) => z.sections));
+    const highlightSection = opts.section?.toUpperCase();
+    for (const [groupName, sections] of Object.entries(groups)) {
+      process.stdout.write(`  \u2500\u2500 ${groupName} \u2500\u2500
+`);
+      const names = sections.map((s) => s.name);
+      for (let i = 0; i < names.length; i += 8) {
+        const row = names.slice(i, i + 8);
+        const formatted = row.map((name) => {
+          if (highlightSection && name.toUpperCase() === highlightSection) {
+            return ` \u25B8${name}\u25C2 `;
+          }
+          return ` ${name} `;
+        }).join("  ");
+        process.stdout.write(`    ${formatted}
+`);
+      }
+      process.stdout.write("\n");
+    }
+    if (highlightSection) {
+      const allSections = result.zones.flatMap((z) => z.sections);
+      const match = allSections.find(
+        (s) => s.name.toUpperCase() === highlightSection
+      );
+      if (match) {
+        const pos = describePosition(match, allSections);
+        process.stdout.write(`  \u{1F4CD} Section ${match.name}: ${pos}
+
+`);
+      } else {
+        process.stdout.write(`  \u26A0  Section "${opts.section}" not found in this venue.
+`);
+        process.stdout.write(`     Available: ${result.section_names.slice(0, 20).join(", ")}${result.section_names.length > 20 ? "..." : ""}
+
+`);
+      }
+    }
+    process.stdout.write(
+      `  Total sections: ${result.section_names.length}
+
+`
+    );
+  } catch (err) {
+    handleError(err);
+  }
+});
+program.command("url <slug>").description("Print the TixBit event page URL for a slug or ID").action((slug) => {
+  process.stdout.write(client.eventUrl(slug) + "\n");
+});
+function categorizeSections(sections) {
+  const groups = {};
+  const addToGroup = (groupName, section) => {
+    if (!groups[groupName]) groups[groupName] = [];
+    groups[groupName].push(section);
+  };
+  const hasLowerLevel = sections.some((s) => /^1\d{2}/.test(s.name));
+  const hasSmallNumbers = sections.some((s) => /^\d{1,2}$/.test(s.name));
+  for (const section of sections) {
+    const name = section.name.toUpperCase();
+    if (/^FLOOR\d/.test(name) || /^FLR\d/.test(name)) {
+      addToGroup("\u{1F3C0} Floor", section);
+    } else if (/^1\d{2}/.test(name)) {
+      addToGroup("\u2B07 Lower Level (100s)", section);
+    } else if (/^2\d{2}/.test(name)) {
+      addToGroup("\u2B06 Upper Level (200s)", section);
+    } else if (/^3\d{2}/.test(name)) {
+      addToGroup("\u{1F535} 300 Level", section);
+    } else if (/^4\d{2}/.test(name)) {
+      addToGroup("\u{1F7E3} 400 Level", section);
+    } else if (/^\d{1,2}$/.test(name) && hasSmallNumbers) {
+      addToGroup(hasLowerLevel ? "\u{1F3DF}  Field Level" : "\u2B07 Lower Level", section);
+    } else if (/^L\d/.test(name)) {
+      addToGroup("\u{1FAB5} Loge", section);
+    } else if (/^S\d/.test(name)) {
+      addToGroup("\u2601 Sky", section);
+    } else if (/^T\d/.test(name)) {
+      addToGroup("\u{1F307} Terrace", section);
+    } else if (/^V\d/.test(name)) {
+      addToGroup("\u{1F440} Vista", section);
+    } else if (/^STE/.test(name)) {
+      addToGroup("\u{1F3E2} Suites", section);
+    } else if (name.includes("SUITE") || name.includes("SUITES")) {
+      addToGroup("\u{1F3E2} Suites", section);
+    } else if (name.includes("STANDING") || name === "SRO" || name === "UPPER") {
+      addToGroup("\u{1F9CD} Standing Room", section);
+    } else if (name === "DECK" || name === "ROOF" || name === "GA" || name === "HAT") {
+      addToGroup("\u{1F3AA} General / Special", section);
+    } else {
+      addToGroup("\u{1F4CD} Other", section);
+    }
+  }
+  return groups;
+}
+function describePosition(section, allSections) {
+  if (!allSections.length) return "position unknown";
+  const centerX = allSections.reduce((sum, s) => sum + s.x, 0) / allSections.length;
+  const centerY = allSections.reduce((sum, s) => sum + s.y, 0) / allSections.length;
+  const dx = section.x - centerX;
+  const dy = section.y - centerY;
+  const horizontal = Math.abs(dx) < 50 ? "center" : dx < 0 ? "left side" : "right side";
+  const vertical = Math.abs(dy) < 50 ? "center" : dy < 0 ? "near side (closer to stage/court)" : "far side";
+  if (horizontal === "center" && vertical === "center") {
+    return "center of venue";
+  }
+  return [vertical, horizontal].filter((p) => p !== "center").join(", ");
+}
+program.parse();