tixbit 0.1.0 → 0.1.1

package/README.md

@@ -90,6 +90,8 @@ tixbit seatmap 4BKJMDZ --section 214
 
 Every command supports `--json` for machine-readable output:
 
+> Event IDs are normalized to public external IDs (e.g. `36PB9ZN`) — internal provider prefixes are stripped from SDK/CLI results.
+
 ```sh
 tixbit search "concert" --state NY --json
 tixbit listings 4BKJMDZ --json
@@ -215,7 +217,7 @@ Returns `{ url, listingId, quantity }`.
 |---|---|---|
 | `eventId` | `string` | External event ID |
 
-Returns venue info, section list, zone groupings, and background image URL.
+Returns venue info, section list, zone groupings, absolute asset URLs (`background_image`, `coordinates_url`), and per-section `shape_path` data for overlay rendering.
 
 ### `eventUrl(slugOrId)`
 

package/dist/cli.js

@@ -7,6 +7,22 @@ import { Command } from "commander";
 var DEFAULT_BASE_URL = "https://tixbit.com";
 var DEFAULT_TIMEOUT_MS = 15e3;
 var USER_AGENT = "@tixbit/sdk";
+function normalizeExternalEventId(eventId) {
+  if (!eventId) return eventId;
+  const trimmed = eventId.trim();
+  const providerPrefixedId = trimmed.match(/^([a-z]{5,})-([A-Z0-9]{6,})$/i);
+  if (providerPrefixedId?.[2]) {
+    return providerPrefixedId[2];
+  }
+  return trimmed;
+}
+function toAbsoluteUrl(baseUrl, value) {
+  if (!value) return null;
+  if (value.startsWith("http://") || value.startsWith("https://")) {
+    return value;
+  }
+  return `${baseUrl}${value.startsWith("/") ? "" : "/"}${value}`;
+}
 var TixBitClient = class {
   baseUrl;
   timeoutMs;
@@ -116,7 +132,8 @@ var TixBitClient = class {
       page: params.page ?? 1,
       order_by_direction: params.orderByDirection ?? "asc"
     });
-    const data = await this.request(`/api/events/${encodeURIComponent(params.eventId)}/listings${query}`);
+    const normalizedEventId = normalizeExternalEventId(params.eventId);
+    const data = await this.request(`/api/events/${encodeURIComponent(normalizedEventId)}/listings${query}`);
     const listings = (data.data ?? []).map(normalizeListing);
     return {
       listings,
@@ -160,7 +177,11 @@ var TixBitClient = class {
    * Build the direct URL to an event page on tixbit.com.
    */
   eventUrl(slugOrId) {
-    return `${this.baseUrl}/events/${slugOrId}`;
+    if (slugOrId.includes("/")) {
+      return `${this.baseUrl}/events/${slugOrId}`;
+    }
+    const normalized = normalizeExternalEventId(slugOrId);
+    return `${this.baseUrl}/events/${normalized}`;
   }
   // ── Seatmap ───────────────────────────────────────────────────────────────
   /**
@@ -178,27 +199,27 @@ var TixBitClient = class {
    * ```
    */
   async getSeatmap(params) {
-    const data = await this.request(`/api/events/${encodeURIComponent(params.eventId)}/seating-chart`);
+    const normalizedEventId = normalizeExternalEventId(params.eventId);
+    const data = await this.request(`/api/events/${encodeURIComponent(normalizedEventId)}/seating-chart`);
     let zones = [];
     let sectionNames = [];
-    if (data.has_coordinates && data.coordinates) {
+    const coordinatesUrl = data.coordinates_url ?? data.coordinates ?? null;
+    if (data.has_coordinates && coordinatesUrl) {
       try {
-        zones = await this.fetchAndParseCoordinates(data.coordinates);
-        sectionNames = zones.flatMap(
-          (z) => z.sections.map((s) => s.name)
-        );
+        zones = await this.fetchAndParseCoordinates(coordinatesUrl);
+        sectionNames = zones.flatMap((z) => z.sections.map((s) => s.name));
       } catch {
       }
     }
     return {
       success: data.success,
-      event_id: data.event_id,
+      event_id: normalizeExternalEventId(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,
+      background_image: toAbsoluteUrl(this.baseUrl, data.background_image ?? null),
+      coordinates_url: toAbsoluteUrl(this.baseUrl, coordinatesUrl),
       has_coordinates: data.has_coordinates,
       capacity: data.capacity ?? null,
       venue: data.venue_data,
@@ -228,12 +249,22 @@ var TixBitClient = class {
         id: zone.id,
         name: zone.name,
         sections: (zone.sections ?? []).map((section) => {
-          const label = section.labels?.[0];
+          const labels = Array.isArray(section.labels) ? section.labels.filter((label) => label && typeof label.text === "string").map((label) => ({
+            text: label.text,
+            x: typeof label.x === "number" ? label.x : 0,
+            y: typeof label.y === "number" ? label.y : 0,
+            size: typeof label.size === "number" ? label.size : void 0,
+            angle: typeof label.angle === "number" ? label.angle : void 0
+          })) : [];
+          const primaryLabel = labels.find((label) => label.text.toUpperCase() === section.name.toUpperCase()) ?? labels[0];
+          const shapePath = section.shape && typeof section.shape.path === "string" ? section.shape.path : null;
           return {
             id: section.id,
             name: section.name,
-            x: label?.x ?? 0,
-            y: label?.y ?? 0
+            x: primaryLabel?.x ?? 0,
+            y: primaryLabel?.y ?? 0,
+            labels,
+            shape_path: shapePath
           };
         })
       }));
@@ -244,10 +275,12 @@ var TixBitClient = class {
 };
 function normalizeEvent(raw) {
   const e = raw;
+  const rawId = str(e.external_event_id) ?? str(e.externalEventId) ?? str(e.id) ?? "";
+  const externalEventId = normalizeExternalEventId(rawId);
   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) ?? "",
+    id: externalEventId,
+    external_event_id: externalEventId,
+    slug: str(e.slug) ?? externalEventId,
     name: str(e.name) ?? str(e.performer) ?? "",
     date: resolveDate(e),
     venue_name: str(e.venue_name) ?? str(e.venueName) ?? null,

package/dist/index.d.ts

@@ -133,6 +133,13 @@ interface GetSeatmapParams {
     /** External event ID (from search results). */
     eventId: string;
 }
+interface SeatmapLabel {
+    text: string;
+    x: number;
+    y: number;
+    size?: number;
+    angle?: number;
+}
 /** A single section in the venue's seating chart. */
 interface SeatmapSection {
     /** Section ID (e.g. "80841"). */
@@ -140,11 +147,18 @@ interface SeatmapSection {
     /** Human-readable section name (e.g. "101", "FLOOR3", "201"). */
     name: string;
     /**
-     * Center coordinates of the section label on the map.
-     * Useful for understanding relative position.
+     * Primary label anchor for simple renderers and relative position helpers.
      */
     x: number;
     y: number;
+    /**
+     * All labels from the seatmap payload (useful for richer rendering).
+     */
+    labels: SeatmapLabel[];
+    /**
+     * SVG path for drawing the section shape overlay.
+     */
+    shape_path: string | null;
 }
 /** A zone grouping sections (e.g. "Section", "Floor", "Suite"). */
 interface SeatmapZone {
@@ -264,4 +278,4 @@ declare class TixBitApiError extends Error {
     constructor(message: string, status: number, url: string);
 }
 
-export { type BrowseEventsParams, type BrowseEventsResult, type CheckoutLink, type CheckoutParams, type GetListingsParams, type GetListingsResult, type GetSeatmapParams, type SearchEventsParams, type SearchEventsResult, type SeatmapResult, type SeatmapSection, type SeatmapVenue, type SeatmapZone, TixBitApiError, TixBitClient, type TixBitConfig, type TixBitEvent, type TixBitListing };
+export { type BrowseEventsParams, type BrowseEventsResult, type CheckoutLink, type CheckoutParams, type GetListingsParams, type GetListingsResult, type GetSeatmapParams, type SearchEventsParams, type SearchEventsResult, type SeatmapLabel, type SeatmapResult, type SeatmapSection, type SeatmapVenue, type SeatmapZone, TixBitApiError, TixBitClient, type TixBitConfig, type TixBitEvent, type TixBitListing };

package/dist/index.js

@@ -2,6 +2,22 @@
 var DEFAULT_BASE_URL = "https://tixbit.com";
 var DEFAULT_TIMEOUT_MS = 15e3;
 var USER_AGENT = "@tixbit/sdk";
+function normalizeExternalEventId(eventId) {
+  if (!eventId) return eventId;
+  const trimmed = eventId.trim();
+  const providerPrefixedId = trimmed.match(/^([a-z]{5,})-([A-Z0-9]{6,})$/i);
+  if (providerPrefixedId?.[2]) {
+    return providerPrefixedId[2];
+  }
+  return trimmed;
+}
+function toAbsoluteUrl(baseUrl, value) {
+  if (!value) return null;
+  if (value.startsWith("http://") || value.startsWith("https://")) {
+    return value;
+  }
+  return `${baseUrl}${value.startsWith("/") ? "" : "/"}${value}`;
+}
 var TixBitClient = class {
   baseUrl;
   timeoutMs;
@@ -111,7 +127,8 @@ var TixBitClient = class {
       page: params.page ?? 1,
       order_by_direction: params.orderByDirection ?? "asc"
     });
-    const data = await this.request(`/api/events/${encodeURIComponent(params.eventId)}/listings${query}`);
+    const normalizedEventId = normalizeExternalEventId(params.eventId);
+    const data = await this.request(`/api/events/${encodeURIComponent(normalizedEventId)}/listings${query}`);
     const listings = (data.data ?? []).map(normalizeListing);
     return {
       listings,
@@ -155,7 +172,11 @@ var TixBitClient = class {
    * Build the direct URL to an event page on tixbit.com.
    */
   eventUrl(slugOrId) {
-    return `${this.baseUrl}/events/${slugOrId}`;
+    if (slugOrId.includes("/")) {
+      return `${this.baseUrl}/events/${slugOrId}`;
+    }
+    const normalized = normalizeExternalEventId(slugOrId);
+    return `${this.baseUrl}/events/${normalized}`;
   }
   // ── Seatmap ───────────────────────────────────────────────────────────────
   /**
@@ -173,27 +194,27 @@ var TixBitClient = class {
    * ```
    */
   async getSeatmap(params) {
-    const data = await this.request(`/api/events/${encodeURIComponent(params.eventId)}/seating-chart`);
+    const normalizedEventId = normalizeExternalEventId(params.eventId);
+    const data = await this.request(`/api/events/${encodeURIComponent(normalizedEventId)}/seating-chart`);
     let zones = [];
     let sectionNames = [];
-    if (data.has_coordinates && data.coordinates) {
+    const coordinatesUrl = data.coordinates_url ?? data.coordinates ?? null;
+    if (data.has_coordinates && coordinatesUrl) {
       try {
-        zones = await this.fetchAndParseCoordinates(data.coordinates);
-        sectionNames = zones.flatMap(
-          (z) => z.sections.map((s) => s.name)
-        );
+        zones = await this.fetchAndParseCoordinates(coordinatesUrl);
+        sectionNames = zones.flatMap((z) => z.sections.map((s) => s.name));
       } catch {
       }
     }
     return {
       success: data.success,
-      event_id: data.event_id,
+      event_id: normalizeExternalEventId(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,
+      background_image: toAbsoluteUrl(this.baseUrl, data.background_image ?? null),
+      coordinates_url: toAbsoluteUrl(this.baseUrl, coordinatesUrl),
       has_coordinates: data.has_coordinates,
       capacity: data.capacity ?? null,
       venue: data.venue_data,
@@ -223,12 +244,22 @@ var TixBitClient = class {
         id: zone.id,
         name: zone.name,
         sections: (zone.sections ?? []).map((section) => {
-          const label = section.labels?.[0];
+          const labels = Array.isArray(section.labels) ? section.labels.filter((label) => label && typeof label.text === "string").map((label) => ({
+            text: label.text,
+            x: typeof label.x === "number" ? label.x : 0,
+            y: typeof label.y === "number" ? label.y : 0,
+            size: typeof label.size === "number" ? label.size : void 0,
+            angle: typeof label.angle === "number" ? label.angle : void 0
+          })) : [];
+          const primaryLabel = labels.find((label) => label.text.toUpperCase() === section.name.toUpperCase()) ?? labels[0];
+          const shapePath = section.shape && typeof section.shape.path === "string" ? section.shape.path : null;
           return {
             id: section.id,
             name: section.name,
-            x: label?.x ?? 0,
-            y: label?.y ?? 0
+            x: primaryLabel?.x ?? 0,
+            y: primaryLabel?.y ?? 0,
+            labels,
+            shape_path: shapePath
           };
         })
       }));
@@ -239,10 +270,12 @@ var TixBitClient = class {
 };
 function normalizeEvent(raw) {
   const e = raw;
+  const rawId = str(e.external_event_id) ?? str(e.externalEventId) ?? str(e.id) ?? "";
+  const externalEventId = normalizeExternalEventId(rawId);
   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) ?? "",
+    id: externalEventId,
+    external_event_id: externalEventId,
+    slug: str(e.slug) ?? externalEventId,
     name: str(e.name) ?? str(e.performer) ?? "",
     date: resolveDate(e),
     venue_name: str(e.venue_name) ?? str(e.venueName) ?? null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tixbit",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Search events, view seatmaps, browse listings, and buy tickets on TixBit",
   "type": "module",
   "main": "./dist/index.js",