@seatlayer/js 0.1.3 → 0.1.4

package/dist/index.cjs

@@ -123,7 +123,9 @@ var SeatingChart = class {
       onSelectionChange: (seats) => this.opts.onSelectionChange?.(seats),
       onHold: (h) => this.opts.onHold?.({ holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats }),
       onError: (err) => this.opts.onError?.(err),
-      onDeckTap: (floorId) => this.opts.onDeckTap?.(floorId)
+      onDeckTap: (floorId) => this.opts.onDeckTap?.(floorId),
+      onHint: (message) => this.opts.onHint?.(message),
+      colorblindSafe: options.colorblindSafe
     });
   }
   /** Fetch the chart, mount the renderer, seed statuses and go live. Idempotent. */
@@ -177,6 +179,26 @@ var SeatingChart = class {
   setSeatTier(seatId, tierId) {
     this.controller.setSeatTier(seatId, tierId);
   }
+  /**
+   * Floors of a multi-floor chart — `[{ id, name }]` (single-floor charts
+   * return one entry; empty before render()). Pair with setFloor() to build a
+   * host-side floor switcher.
+   */
+  getFloors() {
+    return this.controller.getFloors();
+  }
+  /** Switch the shown floor (2D). Warns + no-ops on single-floor charts. */
+  setFloor(floorId) {
+    if (this.controller.getFloors().length <= 1) {
+      console.warn("seatmap: setFloor() ignored \u2014 this chart has a single floor");
+      return;
+    }
+    this.controller.setFloor(floorId);
+  }
+  /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
+  setColorblindSafe(on) {
+    this.controller.setColorblindSafe(on);
+  }
   /** Release the current hold (if any). No-op when nothing is held. */
   async release() {
     await this.controller.release();

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/SeatingChart.ts","../src/api.ts"],"sourcesContent":["/**\n * @seatlayer/js — the framework-agnostic SeatLayer embed SDK.\n *\n * Works in any JS environment (plain HTML, React, Vue, Svelte, Angular, …).\n * Framework wrappers (@seatlayer/react, …) build on top of this.\n */\nexport { SeatingChart } from './SeatingChart';\nexport type { SeatingChartOptions, SelectedSeat } from './SeatingChart';\nexport { ApiError } from './api';\nexport type { HoldResult, HoldConflict, BestAvailableResult } from './api';\n","/**\n * SeatingChart — the embeddable buyer picker.\n *\n * A thin wrapper over the shared PickerController (src/picker/PickerController):\n * it owns the mount <div> + the public embed contract (hold-only — the SDK hands\n * the holdId to the host page for a server-side book) and delegates all transport\n * + booking to the controller, so the SDK inherits every fix made for the live\n * buyer page and the demo picker.\n */\nimport { PickerController, loadLocale, setStringOverrides, type PickerSeat } from '@seatlayer/core';\nimport { PubApi, type BestAvailableResult, type HoldResult } from './api';\n\nconst DEFAULT_API_BASE = 'https://api.seatlayer.io';\nconst DEFAULT_MAX_SELECTION = 10;\n\n/** A seat as surfaced to the host page (prices resolved from the chart's categories). */\nexport type SelectedSeat = PickerSeat;\n\nexport interface SeatingChartOptions {\n  /** CSS selector or an HTMLElement to render into. */\n  container: string | HTMLElement;\n  /** Event key, e.g. `ev_xxx`. */\n  event: string;\n  /** API origin. Defaults to https://api.seatlayer.io. */\n  apiBase?: string;\n  /** Reserved for future authenticated rendering — accepted + stored, not yet sent. */\n  publicKey?: string;\n  /** Max seats selectable at once (default 10). */\n  maxSelection?: number;\n  /**\n   * BCP 47 language for the widget UI — `'de'`, `'es-MX'`, etc. Falls back to\n   * the browser language, then English. Built-in: en, es, de, fr. The German\n   * bundle (etc.) is fetched on demand so unused languages cost nothing.\n   */\n  locale?: string;\n  /**\n   * Per-key string overrides layered over the active locale — white-label copy\n   * without shipping a whole bundle, e.g. `{ 'map.fromPrice': 'ab {price}' }`.\n   */\n  messages?: Record<string, string>;\n  /** ISO 4217 currency for on-map prices (default USD). */\n  currency?: string;\n  onSelectionChange?: (seats: SelectedSeat[]) => void;\n  onHold?: (result: HoldResult) => void;\n  onError?: (err: unknown) => void;\n  /**\n   * Multi-floor charts only: fires when the buyer taps a deck in the stacked\n   * 3D view, after the picker switches to that floor — lets the host page sync\n   * its own floor UI (tabs, labels) with the map.\n   */\n  onDeckTap?: (floorId: string) => void;\n}\n\nfunction resolveContainer(container: string | HTMLElement): HTMLElement {\n  if (typeof container === 'string') {\n    const el = document.querySelector(container);\n    if (!el) throw new Error(`seatmap: container \"${container}\" not found`);\n    return el as HTMLElement;\n  }\n  if (!(container instanceof HTMLElement)) {\n    throw new Error('seatmap: container must be a CSS selector or an HTMLElement');\n  }\n  return container;\n}\n\nexport class SeatingChart {\n  private readonly opts: SeatingChartOptions;\n  private readonly controller: PickerController;\n  /** Reserved for future authenticated rendering — stored, not yet sent on any request. */\n  readonly publicKey?: string;\n\n  private mount: HTMLElement | null = null;\n  private hostEl: HTMLDivElement | null = null;\n  private rendered = false;\n\n  constructor(options: SeatingChartOptions) {\n    if (!options || typeof options !== 'object') throw new Error('seatmap: options object is required');\n    if (!options.container) throw new Error('seatmap: `container` is required');\n    if (!options.event || typeof options.event !== 'string') throw new Error('seatmap: `event` key is required');\n\n    this.opts = options;\n    this.publicKey = options.publicKey;\n    const api = new PubApi((options.apiBase ?? DEFAULT_API_BASE).replace(/\\/+$/, ''));\n    this.controller = new PickerController({\n      transport: api,\n      eventKey: options.event,\n      maxSelection: options.maxSelection ?? DEFAULT_MAX_SELECTION,\n      currency: options.currency,\n      onSelectionChange: (seats) => this.opts.onSelectionChange?.(seats),\n      onHold: (h) => this.opts.onHold?.({ holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats }),\n      onError: (err) => this.opts.onError?.(err),\n      onDeckTap: (floorId) => this.opts.onDeckTap?.(floorId),\n    });\n  }\n\n  /** Fetch the chart, mount the renderer, seed statuses and go live. Idempotent. */\n  async render(): Promise<this> {\n    if (this.rendered) return this;\n    this.rendered = true;\n\n    // Resolve + load the UI language before the first paint so on-map labels\n    // (\"N LEFT\", \"FROM …\", the map aria-label) render translated. English and\n    // already-loaded locales resolve synchronously; others fetch one small chunk.\n    await loadLocale(this.opts.locale);\n    if (this.opts.messages) setStringOverrides(this.opts.messages);\n\n    // Mount an owned <div> inside the caller's container so we never fight their\n    // layout and can cleanly remove it on destroy().\n    this.mount = resolveContainer(this.opts.container);\n    const host = document.createElement('div');\n    host.style.width = '100%';\n    host.style.height = '100%';\n    host.style.position = 'relative';\n    this.mount.appendChild(host);\n    this.hostEl = host;\n\n    const ok = await this.controller.render(host);\n    if (!ok) this.rendered = false; // render() already emitted the error\n    return this;\n  }\n\n  /** Current selection with prices resolved from the chart categories. */\n  getSelection(): SelectedSeat[] {\n    return this.controller.getSelection();\n  }\n\n  /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */\n  async hold(): Promise<HoldResult | null> {\n    try {\n      const h = await this.controller.hold();\n      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats } : null;\n    } catch (err) {\n      this.opts.onError?.(err);\n      return null;\n    }\n  }\n\n  /** Ask the server for the `qty` best free seats and hold them atomically. */\n  async bestAvailable(qty: number, categoryKey?: string): Promise<BestAvailableResult | null> {\n    try {\n      const h = await this.controller.bestAvailable(qty, categoryKey);\n      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, labels: h.labels, seats: h.seats } : null;\n    } catch (err) {\n      this.opts.onError?.(err);\n      return null;\n    }\n  }\n\n  /**\n   * Choose a ticket tier for a selected seat (e.g. Adult → Child). The seat's\n   * available `tiers` are on each `SelectedSeat` from `getSelection()` /\n   * `onSelectionChange`. Re-emits the selection with the new tier + price, and\n   * the tier rides along in the next `hold()` / `onHold` per seat. `tierId=null`\n   * reverts to the default tier.\n   */\n  setSeatTier(seatId: string, tierId: string | null): void {\n    this.controller.setSeatTier(seatId, tierId);\n  }\n\n  /** Release the current hold (if any). No-op when nothing is held. */\n  async release(): Promise<void> {\n    await this.controller.release();\n  }\n\n  /** Tear everything down: close the socket, stop timers, drop the canvas. */\n  destroy(): void {\n    this.controller.destroy();\n    if (this.hostEl && this.hostEl.parentNode) this.hostEl.parentNode.removeChild(this.hostEl);\n    this.hostEl = null;\n    this.mount = null;\n    this.rendered = false;\n  }\n}\n","/**\n * Minimal client for the public embed surface of workers/api (the `/pub/*`\n * routes). Deliberately self-contained — it does NOT reuse src/lib/api.ts,\n * which bakes in a build-time API base and dashboard session credentials. The\n * SDK runs cross-origin on a third-party ticketing page, so:\n *   - apiBase is per-instance (constructor option), not a build constant;\n *   - credentials are omitted (no cookie to send, avoids CORS-credential setup);\n *   - no custom headers on mutating calls (keeps the CORS preflight trivial).\n */\nimport type { ChartDoc, PickerSeat as SelectedSeat } from '@seatlayer/core';\n\nexport interface HoldConflict {\n  label: string;\n  reason: string;\n}\n\nexport class ApiError extends Error {\n  status: number;\n  code?: string;\n  /** Present when a hold 409s because seats were just taken/held. */\n  conflicts?: HoldConflict[];\n  /** Present when best-available 409s ('not_enough_together' | 'sold_out'). */\n  reason?: string;\n\n  constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string) {\n    super(message);\n    this.name = 'ApiError';\n    this.status = status;\n    this.code = code;\n    this.conflicts = conflicts;\n    this.reason = reason;\n  }\n}\n\nexport interface PubChartResult {\n  event: { key: string; name: string };\n  doc: ChartDoc;\n}\n\nexport interface PubObjectsResult {\n  /** Every non-free seat's status, keyed by seat label. */\n  seats: Record<string, string>;\n  updatedAt: number;\n}\n\nexport interface HoldResult {\n  holdId: string;\n  expiresAt: number;\n  /** The held seats with the buyer's chosen ticket tier per seat (present on hold). */\n  seats?: SelectedSeat[];\n}\n\n/** Best-available response — the server-picked seats plus the hold they landed in. */\nexport interface BestAvailableResult {\n  holdId: string;\n  expiresAt: number;\n  labels: string[];\n  seats?: SelectedSeat[];\n}\n\nasync function request<T>(\n  base: string,\n  path: string,\n  init: { method?: 'GET' | 'POST'; body?: unknown } = {},\n): Promise<T> {\n  const method = init.method ?? 'GET';\n  const headers: Record<string, string> = {};\n  let body: string | undefined;\n  if (init.body !== undefined) {\n    headers['Content-Type'] = 'application/json';\n    body = JSON.stringify(init.body);\n  }\n\n  const res = await fetch(`${base}${path}`, { method, headers, body, credentials: 'omit' });\n\n  const isJson = (res.headers.get('content-type') ?? '').includes('application/json');\n  const data = isJson ? await res.json().catch(() => null) : null;\n\n  if (!res.ok) {\n    const err = data as\n      | { error?: string; code?: string; conflicts?: HoldConflict[]; reason?: string }\n      | null;\n    throw new ApiError(res.status, err?.error ?? `request_failed_${res.status}`, err?.code, err?.conflicts, err?.reason);\n  }\n  return data as T;\n}\n\n/** Public-surface client bound to one apiBase (e.g. https://api.seatlayer.io). */\nexport class PubApi {\n  constructor(private readonly base: string) {}\n\n  chart(key: string): Promise<PubChartResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/chart`);\n  }\n\n  objects(key: string): Promise<PubObjectsResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/objects`);\n  }\n\n  hold(key: string, labels: string[]): Promise<HoldResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/hold`, {\n      method: 'POST',\n      body: { labels },\n    });\n  }\n\n  bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/best-available`, {\n      method: 'POST',\n      body: { qty, ...(categoryKey ? { categoryKey } : {}) },\n    });\n  }\n\n  release(key: string, labels: string[], holdId: string): Promise<{ ok: true }> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/release`, {\n      method: 'POST',\n      body: { labels, holdId },\n    });\n  }\n\n  socketUrl(key: string): string {\n    const wsBase = this.base.replace(/^http/, 'ws');\n    return `${wsBase}/pub/events/${encodeURIComponent(key)}/subscribe`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACSA,kBAAkF;;;ACO3E,IAAM,WAAN,cAAuB,MAAM;AAAA,EAQlC,YAAY,QAAgB,SAAiB,MAAe,WAA4B,QAAiB;AACvG,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,OAAO;AACZ,SAAK,YAAY;AACjB,SAAK,SAAS;AAAA,EAChB;AACF;AA4BA,eAAe,QACb,MACA,MACA,OAAoD,CAAC,GACzC;AACZ,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,UAAkC,CAAC;AACzC,MAAI;AACJ,MAAI,KAAK,SAAS,QAAW;AAC3B,YAAQ,cAAc,IAAI;AAC1B,WAAO,KAAK,UAAU,KAAK,IAAI;AAAA,EACjC;AAEA,QAAM,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,IAAI,EAAE,QAAQ,SAAS,MAAM,aAAa,OAAO,CAAC;AAExF,QAAM,UAAU,IAAI,QAAQ,IAAI,cAAc,KAAK,IAAI,SAAS,kBAAkB;AAClF,QAAM,OAAO,SAAS,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,IAAI;AAE3D,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,MAAM;AAGZ,UAAM,IAAI,SAAS,IAAI,QAAQ,KAAK,SAAS,kBAAkB,IAAI,MAAM,IAAI,KAAK,MAAM,KAAK,WAAW,KAAK,MAAM;AAAA,EACrH;AACA,SAAO;AACT;AAGO,IAAM,SAAN,MAAa;AAAA,EAClB,YAA6B,MAAc;AAAd;AAAA,EAAe;AAAA,EAE5C,MAAM,KAAsC;AAC1C,WAAO,QAAQ,KAAK,MAAM,eAAe,mBAAmB,GAAG,CAAC,QAAQ;AAAA,EAC1E;AAAA,EAEA,QAAQ,KAAwC;AAC9C,WAAO,QAAQ,KAAK,MAAM,eAAe,mBAAmB,GAAG,CAAC,UAAU;AAAA,EAC5E;AAAA,EAEA,KAAK,KAAa,QAAuC;AACvD,WAAO,QAAQ,KAAK,MAAM,eAAe,mBAAmB,GAAG,CAAC,SAAS;AAAA,MACvE,QAAQ;AAAA,MACR,MAAM,EAAE,OAAO;AAAA,IACjB,CAAC;AAAA,EACH;AAAA,EAEA,cAAc,KAAa,KAAa,aAAoD;AAC1F,WAAO,QAAQ,KAAK,MAAM,eAAe,mBAAmB,GAAG,CAAC,mBAAmB;AAAA,MACjF,QAAQ;AAAA,MACR,MAAM,EAAE,KAAK,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC,EAAG;AAAA,IACvD,CAAC;AAAA,EACH;AAAA,EAEA,QAAQ,KAAa,QAAkB,QAAuC;AAC5E,WAAO,QAAQ,KAAK,MAAM,eAAe,mBAAmB,GAAG,CAAC,YAAY;AAAA,MAC1E,QAAQ;AAAA,MACR,MAAM,EAAE,QAAQ,OAAO;AAAA,IACzB,CAAC;AAAA,EACH;AAAA,EAEA,UAAU,KAAqB;AAC7B,UAAM,SAAS,KAAK,KAAK,QAAQ,SAAS,IAAI;AAC9C,WAAO,GAAG,MAAM,eAAe,mBAAmB,GAAG,CAAC;AAAA,EACxD;AACF;;;ADhHA,IAAM,mBAAmB;AACzB,IAAM,wBAAwB;AAwC9B,SAAS,iBAAiB,WAA8C;AACtE,MAAI,OAAO,cAAc,UAAU;AACjC,UAAM,KAAK,SAAS,cAAc,SAAS;AAC3C,QAAI,CAAC,GAAI,OAAM,IAAI,MAAM,uBAAuB,SAAS,aAAa;AACtE,WAAO;AAAA,EACT;AACA,MAAI,EAAE,qBAAqB,cAAc;AACvC,UAAM,IAAI,MAAM,6DAA6D;AAAA,EAC/E;AACA,SAAO;AACT;AAEO,IAAM,eAAN,MAAmB;AAAA,EAUxB,YAAY,SAA8B;AAJ1C,SAAQ,QAA4B;AACpC,SAAQ,SAAgC;AACxC,SAAQ,WAAW;AAGjB,QAAI,CAAC,WAAW,OAAO,YAAY,SAAU,OAAM,IAAI,MAAM,qCAAqC;AAClG,QAAI,CAAC,QAAQ,UAAW,OAAM,IAAI,MAAM,kCAAkC;AAC1E,QAAI,CAAC,QAAQ,SAAS,OAAO,QAAQ,UAAU,SAAU,OAAM,IAAI,MAAM,kCAAkC;AAE3G,SAAK,OAAO;AACZ,SAAK,YAAY,QAAQ;AACzB,UAAM,MAAM,IAAI,QAAQ,QAAQ,WAAW,kBAAkB,QAAQ,QAAQ,EAAE,CAAC;AAChF,SAAK,aAAa,IAAI,6BAAiB;AAAA,MACrC,WAAW;AAAA,MACX,UAAU,QAAQ;AAAA,MAClB,cAAc,QAAQ,gBAAgB;AAAA,MACtC,UAAU,QAAQ;AAAA,MAClB,mBAAmB,CAAC,UAAU,KAAK,KAAK,oBAAoB,KAAK;AAAA,MACjE,QAAQ,CAAC,MAAM,KAAK,KAAK,SAAS,EAAE,QAAQ,EAAE,QAAQ,WAAW,EAAE,WAAW,OAAO,EAAE,MAAM,CAAC;AAAA,MAC9F,SAAS,CAAC,QAAQ,KAAK,KAAK,UAAU,GAAG;AAAA,MACzC,WAAW,CAAC,YAAY,KAAK,KAAK,YAAY,OAAO;AAAA,IACvD,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,SAAwB;AAC5B,QAAI,KAAK,SAAU,QAAO;AAC1B,SAAK,WAAW;AAKhB,cAAM,wBAAW,KAAK,KAAK,MAAM;AACjC,QAAI,KAAK,KAAK,SAAU,qCAAmB,KAAK,KAAK,QAAQ;AAI7D,SAAK,QAAQ,iBAAiB,KAAK,KAAK,SAAS;AACjD,UAAM,OAAO,SAAS,cAAc,KAAK;AACzC,SAAK,MAAM,QAAQ;AACnB,SAAK,MAAM,SAAS;AACpB,SAAK,MAAM,WAAW;AACtB,SAAK,MAAM,YAAY,IAAI;AAC3B,SAAK,SAAS;AAEd,UAAM,KAAK,MAAM,KAAK,WAAW,OAAO,IAAI;AAC5C,QAAI,CAAC,GAAI,MAAK,WAAW;AACzB,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,eAA+B;AAC7B,WAAO,KAAK,WAAW,aAAa;AAAA,EACtC;AAAA;AAAA,EAGA,MAAM,OAAmC;AACvC,QAAI;AACF,YAAM,IAAI,MAAM,KAAK,WAAW,KAAK;AACrC,aAAO,IAAI,EAAE,QAAQ,EAAE,QAAQ,WAAW,EAAE,WAAW,OAAO,EAAE,MAAM,IAAI;AAAA,IAC5E,SAAS,KAAK;AACZ,WAAK,KAAK,UAAU,GAAG;AACvB,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,cAAc,KAAa,aAA2D;AAC1F,QAAI;AACF,YAAM,IAAI,MAAM,KAAK,WAAW,cAAc,KAAK,WAAW;AAC9D,aAAO,IAAI,EAAE,QAAQ,EAAE,QAAQ,WAAW,EAAE,WAAW,QAAQ,EAAE,QAAQ,OAAO,EAAE,MAAM,IAAI;AAAA,IAC9F,SAAS,KAAK;AACZ,WAAK,KAAK,UAAU,GAAG;AACvB,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAY,QAAgB,QAA6B;AACvD,SAAK,WAAW,YAAY,QAAQ,MAAM;AAAA,EAC5C;AAAA;AAAA,EAGA,MAAM,UAAyB;AAC7B,UAAM,KAAK,WAAW,QAAQ;AAAA,EAChC;AAAA;AAAA,EAGA,UAAgB;AACd,SAAK,WAAW,QAAQ;AACxB,QAAI,KAAK,UAAU,KAAK,OAAO,WAAY,MAAK,OAAO,WAAW,YAAY,KAAK,MAAM;AACzF,SAAK,SAAS;AACd,SAAK,QAAQ;AACb,SAAK,WAAW;AAAA,EAClB;AACF;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/SeatingChart.ts","../src/api.ts"],"sourcesContent":["/**\n * @seatlayer/js — the framework-agnostic SeatLayer embed SDK.\n *\n * Works in any JS environment (plain HTML, React, Vue, Svelte, Angular, …).\n * Framework wrappers (@seatlayer/react, …) build on top of this.\n */\nexport { SeatingChart } from './SeatingChart';\nexport type { SeatingChartOptions, SelectedSeat } from './SeatingChart';\nexport { ApiError } from './api';\nexport type { HoldResult, HoldConflict, BestAvailableResult } from './api';\n","/**\n * SeatingChart — the embeddable buyer picker.\n *\n * A thin wrapper over the shared PickerController (src/picker/PickerController):\n * it owns the mount <div> + the public embed contract (hold-only — the SDK hands\n * the holdId to the host page for a server-side book) and delegates all transport\n * + booking to the controller, so the SDK inherits every fix made for the live\n * buyer page and the demo picker.\n */\nimport { PickerController, loadLocale, setStringOverrides, type PickerSeat } from '@seatlayer/core';\nimport { PubApi, type BestAvailableResult, type HoldResult } from './api';\n\nconst DEFAULT_API_BASE = 'https://api.seatlayer.io';\nconst DEFAULT_MAX_SELECTION = 10;\n\n/** A seat as surfaced to the host page (prices resolved from the chart's categories). */\nexport type SelectedSeat = PickerSeat;\n\nexport interface SeatingChartOptions {\n  /** CSS selector or an HTMLElement to render into. */\n  container: string | HTMLElement;\n  /** Event key, e.g. `ev_xxx`. */\n  event: string;\n  /** API origin. Defaults to https://api.seatlayer.io. */\n  apiBase?: string;\n  /** Reserved for future authenticated rendering — accepted + stored, not yet sent. */\n  publicKey?: string;\n  /** Max seats selectable at once (default 10). */\n  maxSelection?: number;\n  /**\n   * BCP 47 language for the widget UI — `'de'`, `'es-MX'`, etc. Falls back to\n   * the browser language, then English. Built-in: en, es, de, fr. The German\n   * bundle (etc.) is fetched on demand so unused languages cost nothing.\n   */\n  locale?: string;\n  /**\n   * Per-key string overrides layered over the active locale — white-label copy\n   * without shipping a whole bundle, e.g. `{ 'map.fromPrice': 'ab {price}' }`.\n   */\n  messages?: Record<string, string>;\n  /** ISO 4217 currency for on-map prices (default USD). */\n  currency?: string;\n  /**\n   * Colorblind-safe rendering: category hues switch to an Okabe-Ito palette\n   * and booked seats render hollow, so state never relies on hue alone.\n   * Toggleable later with setColorblindSafe().\n   */\n  colorblindSafe?: boolean;\n  onSelectionChange?: (seats: SelectedSeat[]) => void;\n  onHold?: (result: HoldResult) => void;\n  onError?: (err: unknown) => void;\n  /**\n   * Multi-floor charts only: fires when the buyer taps a deck in the stacked\n   * 3D view, after the picker switches to that floor — lets the host page sync\n   * its own floor UI (tabs, labels) with the map.\n   */\n  onDeckTap?: (floorId: string) => void;\n  /**\n   * Non-blocking, localized selection advice — currently the orphan-seat hint\n   * (the selection would strand a single free seat between taken neighbors).\n   * `null` clears it. Purely informational; nothing is ever prevented.\n   */\n  onHint?: (message: string | null) => void;\n}\n\nfunction resolveContainer(container: string | HTMLElement): HTMLElement {\n  if (typeof container === 'string') {\n    const el = document.querySelector(container);\n    if (!el) throw new Error(`seatmap: container \"${container}\" not found`);\n    return el as HTMLElement;\n  }\n  if (!(container instanceof HTMLElement)) {\n    throw new Error('seatmap: container must be a CSS selector or an HTMLElement');\n  }\n  return container;\n}\n\nexport class SeatingChart {\n  private readonly opts: SeatingChartOptions;\n  private readonly controller: PickerController;\n  /** Reserved for future authenticated rendering — stored, not yet sent on any request. */\n  readonly publicKey?: string;\n\n  private mount: HTMLElement | null = null;\n  private hostEl: HTMLDivElement | null = null;\n  private rendered = false;\n\n  constructor(options: SeatingChartOptions) {\n    if (!options || typeof options !== 'object') throw new Error('seatmap: options object is required');\n    if (!options.container) throw new Error('seatmap: `container` is required');\n    if (!options.event || typeof options.event !== 'string') throw new Error('seatmap: `event` key is required');\n\n    this.opts = options;\n    this.publicKey = options.publicKey;\n    const api = new PubApi((options.apiBase ?? DEFAULT_API_BASE).replace(/\\/+$/, ''));\n    this.controller = new PickerController({\n      transport: api,\n      eventKey: options.event,\n      maxSelection: options.maxSelection ?? DEFAULT_MAX_SELECTION,\n      currency: options.currency,\n      onSelectionChange: (seats) => this.opts.onSelectionChange?.(seats),\n      onHold: (h) => this.opts.onHold?.({ holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats }),\n      onError: (err) => this.opts.onError?.(err),\n      onDeckTap: (floorId) => this.opts.onDeckTap?.(floorId),\n      onHint: (message) => this.opts.onHint?.(message),\n      colorblindSafe: options.colorblindSafe,\n    });\n  }\n\n  /** Fetch the chart, mount the renderer, seed statuses and go live. Idempotent. */\n  async render(): Promise<this> {\n    if (this.rendered) return this;\n    this.rendered = true;\n\n    // Resolve + load the UI language before the first paint so on-map labels\n    // (\"N LEFT\", \"FROM …\", the map aria-label) render translated. English and\n    // already-loaded locales resolve synchronously; others fetch one small chunk.\n    await loadLocale(this.opts.locale);\n    if (this.opts.messages) setStringOverrides(this.opts.messages);\n\n    // Mount an owned <div> inside the caller's container so we never fight their\n    // layout and can cleanly remove it on destroy().\n    this.mount = resolveContainer(this.opts.container);\n    const host = document.createElement('div');\n    host.style.width = '100%';\n    host.style.height = '100%';\n    host.style.position = 'relative';\n    this.mount.appendChild(host);\n    this.hostEl = host;\n\n    const ok = await this.controller.render(host);\n    if (!ok) this.rendered = false; // render() already emitted the error\n    return this;\n  }\n\n  /** Current selection with prices resolved from the chart categories. */\n  getSelection(): SelectedSeat[] {\n    return this.controller.getSelection();\n  }\n\n  /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */\n  async hold(): Promise<HoldResult | null> {\n    try {\n      const h = await this.controller.hold();\n      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats } : null;\n    } catch (err) {\n      this.opts.onError?.(err);\n      return null;\n    }\n  }\n\n  /** Ask the server for the `qty` best free seats and hold them atomically. */\n  async bestAvailable(qty: number, categoryKey?: string): Promise<BestAvailableResult | null> {\n    try {\n      const h = await this.controller.bestAvailable(qty, categoryKey);\n      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, labels: h.labels, seats: h.seats } : null;\n    } catch (err) {\n      this.opts.onError?.(err);\n      return null;\n    }\n  }\n\n  /**\n   * Choose a ticket tier for a selected seat (e.g. Adult → Child). The seat's\n   * available `tiers` are on each `SelectedSeat` from `getSelection()` /\n   * `onSelectionChange`. Re-emits the selection with the new tier + price, and\n   * the tier rides along in the next `hold()` / `onHold` per seat. `tierId=null`\n   * reverts to the default tier.\n   */\n  setSeatTier(seatId: string, tierId: string | null): void {\n    this.controller.setSeatTier(seatId, tierId);\n  }\n\n  /**\n   * Floors of a multi-floor chart — `[{ id, name }]` (single-floor charts\n   * return one entry; empty before render()). Pair with setFloor() to build a\n   * host-side floor switcher.\n   */\n  getFloors(): { id: string; name: string }[] {\n    return this.controller.getFloors();\n  }\n\n  /** Switch the shown floor (2D). Warns + no-ops on single-floor charts. */\n  setFloor(floorId: string): void {\n    if (this.controller.getFloors().length <= 1) {\n      console.warn('seatmap: setFloor() ignored — this chart has a single floor');\n      return;\n    }\n    this.controller.setFloor(floorId);\n  }\n\n  /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */\n  setColorblindSafe(on: boolean): void {\n    this.controller.setColorblindSafe(on);\n  }\n\n  /** Release the current hold (if any). No-op when nothing is held. */\n  async release(): Promise<void> {\n    await this.controller.release();\n  }\n\n  /** Tear everything down: close the socket, stop timers, drop the canvas. */\n  destroy(): void {\n    this.controller.destroy();\n    if (this.hostEl && this.hostEl.parentNode) this.hostEl.parentNode.removeChild(this.hostEl);\n    this.hostEl = null;\n    this.mount = null;\n    this.rendered = false;\n  }\n}\n","/**\n * Minimal client for the public embed surface of workers/api (the `/pub/*`\n * routes). Deliberately self-contained — it does NOT reuse src/lib/api.ts,\n * which bakes in a build-time API base and dashboard session credentials. The\n * SDK runs cross-origin on a third-party ticketing page, so:\n *   - apiBase is per-instance (constructor option), not a build constant;\n *   - credentials are omitted (no cookie to send, avoids CORS-credential setup);\n *   - no custom headers on mutating calls (keeps the CORS preflight trivial).\n */\nimport type { ChartDoc, PickerSeat as SelectedSeat } from '@seatlayer/core';\n\nexport interface HoldConflict {\n  label: string;\n  reason: string;\n}\n\nexport class ApiError extends Error {\n  status: number;\n  code?: string;\n  /** Present when a hold 409s because seats were just taken/held. */\n  conflicts?: HoldConflict[];\n  /** Present when best-available 409s ('not_enough_together' | 'sold_out'). */\n  reason?: string;\n\n  constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string) {\n    super(message);\n    this.name = 'ApiError';\n    this.status = status;\n    this.code = code;\n    this.conflicts = conflicts;\n    this.reason = reason;\n  }\n}\n\nexport interface PubChartResult {\n  event: { key: string; name: string };\n  doc: ChartDoc;\n}\n\nexport interface PubObjectsResult {\n  /** Every non-free seat's status, keyed by seat label. */\n  seats: Record<string, string>;\n  updatedAt: number;\n}\n\nexport interface HoldResult {\n  holdId: string;\n  expiresAt: number;\n  /** The held seats with the buyer's chosen ticket tier per seat (present on hold). */\n  seats?: SelectedSeat[];\n}\n\n/** Best-available response — the server-picked seats plus the hold they landed in. */\nexport interface BestAvailableResult {\n  holdId: string;\n  expiresAt: number;\n  labels: string[];\n  seats?: SelectedSeat[];\n}\n\nasync function request<T>(\n  base: string,\n  path: string,\n  init: { method?: 'GET' | 'POST'; body?: unknown } = {},\n): Promise<T> {\n  const method = init.method ?? 'GET';\n  const headers: Record<string, string> = {};\n  let body: string | undefined;\n  if (init.body !== undefined) {\n    headers['Content-Type'] = 'application/json';\n    body = JSON.stringify(init.body);\n  }\n\n  const res = await fetch(`${base}${path}`, { method, headers, body, credentials: 'omit' });\n\n  const isJson = (res.headers.get('content-type') ?? '').includes('application/json');\n  const data = isJson ? await res.json().catch(() => null) : null;\n\n  if (!res.ok) {\n    const err = data as\n      | { error?: string; code?: string; conflicts?: HoldConflict[]; reason?: string }\n      | null;\n    throw new ApiError(res.status, err?.error ?? `request_failed_${res.status}`, err?.code, err?.conflicts, err?.reason);\n  }\n  return data as T;\n}\n\n/** Public-surface client bound to one apiBase (e.g. https://api.seatlayer.io). */\nexport class PubApi {\n  constructor(private readonly base: string) {}\n\n  chart(key: string): Promise<PubChartResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/chart`);\n  }\n\n  objects(key: string): Promise<PubObjectsResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/objects`);\n  }\n\n  hold(key: string, labels: string[]): Promise<HoldResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/hold`, {\n      method: 'POST',\n      body: { labels },\n    });\n  }\n\n  bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/best-available`, {\n      method: 'POST',\n      body: { qty, ...(categoryKey ? { categoryKey } : {}) },\n    });\n  }\n\n  release(key: string, labels: string[], holdId: string): Promise<{ ok: true }> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/release`, {\n      method: 'POST',\n      body: { labels, holdId },\n    });\n  }\n\n  socketUrl(key: string): string {\n    const wsBase = this.base.replace(/^http/, 'ws');\n    return `${wsBase}/pub/events/${encodeURIComponent(key)}/subscribe`;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -73,6 +73,12 @@ interface SeatingChartOptions {
     messages?: Record<string, string>;
     /** ISO 4217 currency for on-map prices (default USD). */
     currency?: string;
+    /**
+     * Colorblind-safe rendering: category hues switch to an Okabe-Ito palette
+     * and booked seats render hollow, so state never relies on hue alone.
+     * Toggleable later with setColorblindSafe().
+     */
+    colorblindSafe?: boolean;
     onSelectionChange?: (seats: SelectedSeat[]) => void;
     onHold?: (result: HoldResult) => void;
     onError?: (err: unknown) => void;
@@ -82,6 +88,12 @@ interface SeatingChartOptions {
      * its own floor UI (tabs, labels) with the map.
      */
     onDeckTap?: (floorId: string) => void;
+    /**
+     * Non-blocking, localized selection advice — currently the orphan-seat hint
+     * (the selection would strand a single free seat between taken neighbors).
+     * `null` clears it. Purely informational; nothing is ever prevented.
+     */
+    onHint?: (message: string | null) => void;
 }
 declare class SeatingChart {
     private readonly opts;
@@ -108,6 +120,19 @@ declare class SeatingChart {
      * reverts to the default tier.
      */
     setSeatTier(seatId: string, tierId: string | null): void;
+    /**
+     * Floors of a multi-floor chart — `[{ id, name }]` (single-floor charts
+     * return one entry; empty before render()). Pair with setFloor() to build a
+     * host-side floor switcher.
+     */
+    getFloors(): {
+        id: string;
+        name: string;
+    }[];
+    /** Switch the shown floor (2D). Warns + no-ops on single-floor charts. */
+    setFloor(floorId: string): void;
+    /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
+    setColorblindSafe(on: boolean): void;
     /** Release the current hold (if any). No-op when nothing is held. */
     release(): Promise<void>;
     /** Tear everything down: close the socket, stop timers, drop the canvas. */

package/dist/index.d.ts

@@ -73,6 +73,12 @@ interface SeatingChartOptions {
     messages?: Record<string, string>;
     /** ISO 4217 currency for on-map prices (default USD). */
     currency?: string;
+    /**
+     * Colorblind-safe rendering: category hues switch to an Okabe-Ito palette
+     * and booked seats render hollow, so state never relies on hue alone.
+     * Toggleable later with setColorblindSafe().
+     */
+    colorblindSafe?: boolean;
     onSelectionChange?: (seats: SelectedSeat[]) => void;
     onHold?: (result: HoldResult) => void;
     onError?: (err: unknown) => void;
@@ -82,6 +88,12 @@ interface SeatingChartOptions {
      * its own floor UI (tabs, labels) with the map.
      */
     onDeckTap?: (floorId: string) => void;
+    /**
+     * Non-blocking, localized selection advice — currently the orphan-seat hint
+     * (the selection would strand a single free seat between taken neighbors).
+     * `null` clears it. Purely informational; nothing is ever prevented.
+     */
+    onHint?: (message: string | null) => void;
 }
 declare class SeatingChart {
     private readonly opts;
@@ -108,6 +120,19 @@ declare class SeatingChart {
      * reverts to the default tier.
      */
     setSeatTier(seatId: string, tierId: string | null): void;
+    /**
+     * Floors of a multi-floor chart — `[{ id, name }]` (single-floor charts
+     * return one entry; empty before render()). Pair with setFloor() to build a
+     * host-side floor switcher.
+     */
+    getFloors(): {
+        id: string;
+        name: string;
+    }[];
+    /** Switch the shown floor (2D). Warns + no-ops on single-floor charts. */
+    setFloor(floorId: string): void;
+    /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
+    setColorblindSafe(on: boolean): void;
     /** Release the current hold (if any). No-op when nothing is held. */
     release(): Promise<void>;
     /** Tear everything down: close the socket, stop timers, drop the canvas. */

package/dist/index.js

@@ -96,7 +96,9 @@ var SeatingChart = class {
       onSelectionChange: (seats) => this.opts.onSelectionChange?.(seats),
       onHold: (h) => this.opts.onHold?.({ holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats }),
       onError: (err) => this.opts.onError?.(err),
-      onDeckTap: (floorId) => this.opts.onDeckTap?.(floorId)
+      onDeckTap: (floorId) => this.opts.onDeckTap?.(floorId),
+      onHint: (message) => this.opts.onHint?.(message),
+      colorblindSafe: options.colorblindSafe
     });
   }
   /** Fetch the chart, mount the renderer, seed statuses and go live. Idempotent. */
@@ -150,6 +152,26 @@ var SeatingChart = class {
   setSeatTier(seatId, tierId) {
     this.controller.setSeatTier(seatId, tierId);
   }
+  /**
+   * Floors of a multi-floor chart — `[{ id, name }]` (single-floor charts
+   * return one entry; empty before render()). Pair with setFloor() to build a
+   * host-side floor switcher.
+   */
+  getFloors() {
+    return this.controller.getFloors();
+  }
+  /** Switch the shown floor (2D). Warns + no-ops on single-floor charts. */
+  setFloor(floorId) {
+    if (this.controller.getFloors().length <= 1) {
+      console.warn("seatmap: setFloor() ignored \u2014 this chart has a single floor");
+      return;
+    }
+    this.controller.setFloor(floorId);
+  }
+  /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
+  setColorblindSafe(on) {
+    this.controller.setColorblindSafe(on);
+  }
   /** Release the current hold (if any). No-op when nothing is held. */
   async release() {
     await this.controller.release();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/SeatingChart.ts","../src/api.ts"],"sourcesContent":["/**\n * SeatingChart — the embeddable buyer picker.\n *\n * A thin wrapper over the shared PickerController (src/picker/PickerController):\n * it owns the mount <div> + the public embed contract (hold-only — the SDK hands\n * the holdId to the host page for a server-side book) and delegates all transport\n * + booking to the controller, so the SDK inherits every fix made for the live\n * buyer page and the demo picker.\n */\nimport { PickerController, loadLocale, setStringOverrides, type PickerSeat } from '@seatlayer/core';\nimport { PubApi, type BestAvailableResult, type HoldResult } from './api';\n\nconst DEFAULT_API_BASE = 'https://api.seatlayer.io';\nconst DEFAULT_MAX_SELECTION = 10;\n\n/** A seat as surfaced to the host page (prices resolved from the chart's categories). */\nexport type SelectedSeat = PickerSeat;\n\nexport interface SeatingChartOptions {\n  /** CSS selector or an HTMLElement to render into. */\n  container: string | HTMLElement;\n  /** Event key, e.g. `ev_xxx`. */\n  event: string;\n  /** API origin. Defaults to https://api.seatlayer.io. */\n  apiBase?: string;\n  /** Reserved for future authenticated rendering — accepted + stored, not yet sent. */\n  publicKey?: string;\n  /** Max seats selectable at once (default 10). */\n  maxSelection?: number;\n  /**\n   * BCP 47 language for the widget UI — `'de'`, `'es-MX'`, etc. Falls back to\n   * the browser language, then English. Built-in: en, es, de, fr. The German\n   * bundle (etc.) is fetched on demand so unused languages cost nothing.\n   */\n  locale?: string;\n  /**\n   * Per-key string overrides layered over the active locale — white-label copy\n   * without shipping a whole bundle, e.g. `{ 'map.fromPrice': 'ab {price}' }`.\n   */\n  messages?: Record<string, string>;\n  /** ISO 4217 currency for on-map prices (default USD). */\n  currency?: string;\n  onSelectionChange?: (seats: SelectedSeat[]) => void;\n  onHold?: (result: HoldResult) => void;\n  onError?: (err: unknown) => void;\n  /**\n   * Multi-floor charts only: fires when the buyer taps a deck in the stacked\n   * 3D view, after the picker switches to that floor — lets the host page sync\n   * its own floor UI (tabs, labels) with the map.\n   */\n  onDeckTap?: (floorId: string) => void;\n}\n\nfunction resolveContainer(container: string | HTMLElement): HTMLElement {\n  if (typeof container === 'string') {\n    const el = document.querySelector(container);\n    if (!el) throw new Error(`seatmap: container \"${container}\" not found`);\n    return el as HTMLElement;\n  }\n  if (!(container instanceof HTMLElement)) {\n    throw new Error('seatmap: container must be a CSS selector or an HTMLElement');\n  }\n  return container;\n}\n\nexport class SeatingChart {\n  private readonly opts: SeatingChartOptions;\n  private readonly controller: PickerController;\n  /** Reserved for future authenticated rendering — stored, not yet sent on any request. */\n  readonly publicKey?: string;\n\n  private mount: HTMLElement | null = null;\n  private hostEl: HTMLDivElement | null = null;\n  private rendered = false;\n\n  constructor(options: SeatingChartOptions) {\n    if (!options || typeof options !== 'object') throw new Error('seatmap: options object is required');\n    if (!options.container) throw new Error('seatmap: `container` is required');\n    if (!options.event || typeof options.event !== 'string') throw new Error('seatmap: `event` key is required');\n\n    this.opts = options;\n    this.publicKey = options.publicKey;\n    const api = new PubApi((options.apiBase ?? DEFAULT_API_BASE).replace(/\\/+$/, ''));\n    this.controller = new PickerController({\n      transport: api,\n      eventKey: options.event,\n      maxSelection: options.maxSelection ?? DEFAULT_MAX_SELECTION,\n      currency: options.currency,\n      onSelectionChange: (seats) => this.opts.onSelectionChange?.(seats),\n      onHold: (h) => this.opts.onHold?.({ holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats }),\n      onError: (err) => this.opts.onError?.(err),\n      onDeckTap: (floorId) => this.opts.onDeckTap?.(floorId),\n    });\n  }\n\n  /** Fetch the chart, mount the renderer, seed statuses and go live. Idempotent. */\n  async render(): Promise<this> {\n    if (this.rendered) return this;\n    this.rendered = true;\n\n    // Resolve + load the UI language before the first paint so on-map labels\n    // (\"N LEFT\", \"FROM …\", the map aria-label) render translated. English and\n    // already-loaded locales resolve synchronously; others fetch one small chunk.\n    await loadLocale(this.opts.locale);\n    if (this.opts.messages) setStringOverrides(this.opts.messages);\n\n    // Mount an owned <div> inside the caller's container so we never fight their\n    // layout and can cleanly remove it on destroy().\n    this.mount = resolveContainer(this.opts.container);\n    const host = document.createElement('div');\n    host.style.width = '100%';\n    host.style.height = '100%';\n    host.style.position = 'relative';\n    this.mount.appendChild(host);\n    this.hostEl = host;\n\n    const ok = await this.controller.render(host);\n    if (!ok) this.rendered = false; // render() already emitted the error\n    return this;\n  }\n\n  /** Current selection with prices resolved from the chart categories. */\n  getSelection(): SelectedSeat[] {\n    return this.controller.getSelection();\n  }\n\n  /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */\n  async hold(): Promise<HoldResult | null> {\n    try {\n      const h = await this.controller.hold();\n      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats } : null;\n    } catch (err) {\n      this.opts.onError?.(err);\n      return null;\n    }\n  }\n\n  /** Ask the server for the `qty` best free seats and hold them atomically. */\n  async bestAvailable(qty: number, categoryKey?: string): Promise<BestAvailableResult | null> {\n    try {\n      const h = await this.controller.bestAvailable(qty, categoryKey);\n      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, labels: h.labels, seats: h.seats } : null;\n    } catch (err) {\n      this.opts.onError?.(err);\n      return null;\n    }\n  }\n\n  /**\n   * Choose a ticket tier for a selected seat (e.g. Adult → Child). The seat's\n   * available `tiers` are on each `SelectedSeat` from `getSelection()` /\n   * `onSelectionChange`. Re-emits the selection with the new tier + price, and\n   * the tier rides along in the next `hold()` / `onHold` per seat. `tierId=null`\n   * reverts to the default tier.\n   */\n  setSeatTier(seatId: string, tierId: string | null): void {\n    this.controller.setSeatTier(seatId, tierId);\n  }\n\n  /** Release the current hold (if any). No-op when nothing is held. */\n  async release(): Promise<void> {\n    await this.controller.release();\n  }\n\n  /** Tear everything down: close the socket, stop timers, drop the canvas. */\n  destroy(): void {\n    this.controller.destroy();\n    if (this.hostEl && this.hostEl.parentNode) this.hostEl.parentNode.removeChild(this.hostEl);\n    this.hostEl = null;\n    this.mount = null;\n    this.rendered = false;\n  }\n}\n","/**\n * Minimal client for the public embed surface of workers/api (the `/pub/*`\n * routes). Deliberately self-contained — it does NOT reuse src/lib/api.ts,\n * which bakes in a build-time API base and dashboard session credentials. The\n * SDK runs cross-origin on a third-party ticketing page, so:\n *   - apiBase is per-instance (constructor option), not a build constant;\n *   - credentials are omitted (no cookie to send, avoids CORS-credential setup);\n *   - no custom headers on mutating calls (keeps the CORS preflight trivial).\n */\nimport type { ChartDoc, PickerSeat as SelectedSeat } from '@seatlayer/core';\n\nexport interface HoldConflict {\n  label: string;\n  reason: string;\n}\n\nexport class ApiError extends Error {\n  status: number;\n  code?: string;\n  /** Present when a hold 409s because seats were just taken/held. */\n  conflicts?: HoldConflict[];\n  /** Present when best-available 409s ('not_enough_together' | 'sold_out'). */\n  reason?: string;\n\n  constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string) {\n    super(message);\n    this.name = 'ApiError';\n    this.status = status;\n    this.code = code;\n    this.conflicts = conflicts;\n    this.reason = reason;\n  }\n}\n\nexport interface PubChartResult {\n  event: { key: string; name: string };\n  doc: ChartDoc;\n}\n\nexport interface PubObjectsResult {\n  /** Every non-free seat's status, keyed by seat label. */\n  seats: Record<string, string>;\n  updatedAt: number;\n}\n\nexport interface HoldResult {\n  holdId: string;\n  expiresAt: number;\n  /** The held seats with the buyer's chosen ticket tier per seat (present on hold). */\n  seats?: SelectedSeat[];\n}\n\n/** Best-available response — the server-picked seats plus the hold they landed in. */\nexport interface BestAvailableResult {\n  holdId: string;\n  expiresAt: number;\n  labels: string[];\n  seats?: SelectedSeat[];\n}\n\nasync function request<T>(\n  base: string,\n  path: string,\n  init: { method?: 'GET' | 'POST'; body?: unknown } = {},\n): Promise<T> {\n  const method = init.method ?? 'GET';\n  const headers: Record<string, string> = {};\n  let body: string | undefined;\n  if (init.body !== undefined) {\n    headers['Content-Type'] = 'application/json';\n    body = JSON.stringify(init.body);\n  }\n\n  const res = await fetch(`${base}${path}`, { method, headers, body, credentials: 'omit' });\n\n  const isJson = (res.headers.get('content-type') ?? '').includes('application/json');\n  const data = isJson ? await res.json().catch(() => null) : null;\n\n  if (!res.ok) {\n    const err = data as\n      | { error?: string; code?: string; conflicts?: HoldConflict[]; reason?: string }\n      | null;\n    throw new ApiError(res.status, err?.error ?? `request_failed_${res.status}`, err?.code, err?.conflicts, err?.reason);\n  }\n  return data as T;\n}\n\n/** Public-surface client bound to one apiBase (e.g. https://api.seatlayer.io). */\nexport class PubApi {\n  constructor(private readonly base: string) {}\n\n  chart(key: string): Promise<PubChartResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/chart`);\n  }\n\n  objects(key: string): Promise<PubObjectsResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/objects`);\n  }\n\n  hold(key: string, labels: string[]): Promise<HoldResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/hold`, {\n      method: 'POST',\n      body: { labels },\n    });\n  }\n\n  bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/best-available`, {\n      method: 'POST',\n      body: { qty, ...(categoryKey ? { categoryKey } : {}) },\n    });\n  }\n\n  release(key: string, labels: string[], holdId: string): Promise<{ ok: true }> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/release`, {\n      method: 'POST',\n      body: { labels, holdId },\n    });\n  }\n\n  socketUrl(key: string): string {\n    const wsBase = this.base.replace(/^http/, 'ws');\n    return `${wsBase}/pub/events/${encodeURIComponent(key)}/subscribe`;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/SeatingChart.ts","../src/api.ts"],"sourcesContent":["/**\n * SeatingChart — the embeddable buyer picker.\n *\n * A thin wrapper over the shared PickerController (src/picker/PickerController):\n * it owns the mount <div> + the public embed contract (hold-only — the SDK hands\n * the holdId to the host page for a server-side book) and delegates all transport\n * + booking to the controller, so the SDK inherits every fix made for the live\n * buyer page and the demo picker.\n */\nimport { PickerController, loadLocale, setStringOverrides, type PickerSeat } from '@seatlayer/core';\nimport { PubApi, type BestAvailableResult, type HoldResult } from './api';\n\nconst DEFAULT_API_BASE = 'https://api.seatlayer.io';\nconst DEFAULT_MAX_SELECTION = 10;\n\n/** A seat as surfaced to the host page (prices resolved from the chart's categories). */\nexport type SelectedSeat = PickerSeat;\n\nexport interface SeatingChartOptions {\n  /** CSS selector or an HTMLElement to render into. */\n  container: string | HTMLElement;\n  /** Event key, e.g. `ev_xxx`. */\n  event: string;\n  /** API origin. Defaults to https://api.seatlayer.io. */\n  apiBase?: string;\n  /** Reserved for future authenticated rendering — accepted + stored, not yet sent. */\n  publicKey?: string;\n  /** Max seats selectable at once (default 10). */\n  maxSelection?: number;\n  /**\n   * BCP 47 language for the widget UI — `'de'`, `'es-MX'`, etc. Falls back to\n   * the browser language, then English. Built-in: en, es, de, fr. The German\n   * bundle (etc.) is fetched on demand so unused languages cost nothing.\n   */\n  locale?: string;\n  /**\n   * Per-key string overrides layered over the active locale — white-label copy\n   * without shipping a whole bundle, e.g. `{ 'map.fromPrice': 'ab {price}' }`.\n   */\n  messages?: Record<string, string>;\n  /** ISO 4217 currency for on-map prices (default USD). */\n  currency?: string;\n  /**\n   * Colorblind-safe rendering: category hues switch to an Okabe-Ito palette\n   * and booked seats render hollow, so state never relies on hue alone.\n   * Toggleable later with setColorblindSafe().\n   */\n  colorblindSafe?: boolean;\n  onSelectionChange?: (seats: SelectedSeat[]) => void;\n  onHold?: (result: HoldResult) => void;\n  onError?: (err: unknown) => void;\n  /**\n   * Multi-floor charts only: fires when the buyer taps a deck in the stacked\n   * 3D view, after the picker switches to that floor — lets the host page sync\n   * its own floor UI (tabs, labels) with the map.\n   */\n  onDeckTap?: (floorId: string) => void;\n  /**\n   * Non-blocking, localized selection advice — currently the orphan-seat hint\n   * (the selection would strand a single free seat between taken neighbors).\n   * `null` clears it. Purely informational; nothing is ever prevented.\n   */\n  onHint?: (message: string | null) => void;\n}\n\nfunction resolveContainer(container: string | HTMLElement): HTMLElement {\n  if (typeof container === 'string') {\n    const el = document.querySelector(container);\n    if (!el) throw new Error(`seatmap: container \"${container}\" not found`);\n    return el as HTMLElement;\n  }\n  if (!(container instanceof HTMLElement)) {\n    throw new Error('seatmap: container must be a CSS selector or an HTMLElement');\n  }\n  return container;\n}\n\nexport class SeatingChart {\n  private readonly opts: SeatingChartOptions;\n  private readonly controller: PickerController;\n  /** Reserved for future authenticated rendering — stored, not yet sent on any request. */\n  readonly publicKey?: string;\n\n  private mount: HTMLElement | null = null;\n  private hostEl: HTMLDivElement | null = null;\n  private rendered = false;\n\n  constructor(options: SeatingChartOptions) {\n    if (!options || typeof options !== 'object') throw new Error('seatmap: options object is required');\n    if (!options.container) throw new Error('seatmap: `container` is required');\n    if (!options.event || typeof options.event !== 'string') throw new Error('seatmap: `event` key is required');\n\n    this.opts = options;\n    this.publicKey = options.publicKey;\n    const api = new PubApi((options.apiBase ?? DEFAULT_API_BASE).replace(/\\/+$/, ''));\n    this.controller = new PickerController({\n      transport: api,\n      eventKey: options.event,\n      maxSelection: options.maxSelection ?? DEFAULT_MAX_SELECTION,\n      currency: options.currency,\n      onSelectionChange: (seats) => this.opts.onSelectionChange?.(seats),\n      onHold: (h) => this.opts.onHold?.({ holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats }),\n      onError: (err) => this.opts.onError?.(err),\n      onDeckTap: (floorId) => this.opts.onDeckTap?.(floorId),\n      onHint: (message) => this.opts.onHint?.(message),\n      colorblindSafe: options.colorblindSafe,\n    });\n  }\n\n  /** Fetch the chart, mount the renderer, seed statuses and go live. Idempotent. */\n  async render(): Promise<this> {\n    if (this.rendered) return this;\n    this.rendered = true;\n\n    // Resolve + load the UI language before the first paint so on-map labels\n    // (\"N LEFT\", \"FROM …\", the map aria-label) render translated. English and\n    // already-loaded locales resolve synchronously; others fetch one small chunk.\n    await loadLocale(this.opts.locale);\n    if (this.opts.messages) setStringOverrides(this.opts.messages);\n\n    // Mount an owned <div> inside the caller's container so we never fight their\n    // layout and can cleanly remove it on destroy().\n    this.mount = resolveContainer(this.opts.container);\n    const host = document.createElement('div');\n    host.style.width = '100%';\n    host.style.height = '100%';\n    host.style.position = 'relative';\n    this.mount.appendChild(host);\n    this.hostEl = host;\n\n    const ok = await this.controller.render(host);\n    if (!ok) this.rendered = false; // render() already emitted the error\n    return this;\n  }\n\n  /** Current selection with prices resolved from the chart categories. */\n  getSelection(): SelectedSeat[] {\n    return this.controller.getSelection();\n  }\n\n  /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */\n  async hold(): Promise<HoldResult | null> {\n    try {\n      const h = await this.controller.hold();\n      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats } : null;\n    } catch (err) {\n      this.opts.onError?.(err);\n      return null;\n    }\n  }\n\n  /** Ask the server for the `qty` best free seats and hold them atomically. */\n  async bestAvailable(qty: number, categoryKey?: string): Promise<BestAvailableResult | null> {\n    try {\n      const h = await this.controller.bestAvailable(qty, categoryKey);\n      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, labels: h.labels, seats: h.seats } : null;\n    } catch (err) {\n      this.opts.onError?.(err);\n      return null;\n    }\n  }\n\n  /**\n   * Choose a ticket tier for a selected seat (e.g. Adult → Child). The seat's\n   * available `tiers` are on each `SelectedSeat` from `getSelection()` /\n   * `onSelectionChange`. Re-emits the selection with the new tier + price, and\n   * the tier rides along in the next `hold()` / `onHold` per seat. `tierId=null`\n   * reverts to the default tier.\n   */\n  setSeatTier(seatId: string, tierId: string | null): void {\n    this.controller.setSeatTier(seatId, tierId);\n  }\n\n  /**\n   * Floors of a multi-floor chart — `[{ id, name }]` (single-floor charts\n   * return one entry; empty before render()). Pair with setFloor() to build a\n   * host-side floor switcher.\n   */\n  getFloors(): { id: string; name: string }[] {\n    return this.controller.getFloors();\n  }\n\n  /** Switch the shown floor (2D). Warns + no-ops on single-floor charts. */\n  setFloor(floorId: string): void {\n    if (this.controller.getFloors().length <= 1) {\n      console.warn('seatmap: setFloor() ignored — this chart has a single floor');\n      return;\n    }\n    this.controller.setFloor(floorId);\n  }\n\n  /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */\n  setColorblindSafe(on: boolean): void {\n    this.controller.setColorblindSafe(on);\n  }\n\n  /** Release the current hold (if any). No-op when nothing is held. */\n  async release(): Promise<void> {\n    await this.controller.release();\n  }\n\n  /** Tear everything down: close the socket, stop timers, drop the canvas. */\n  destroy(): void {\n    this.controller.destroy();\n    if (this.hostEl && this.hostEl.parentNode) this.hostEl.parentNode.removeChild(this.hostEl);\n    this.hostEl = null;\n    this.mount = null;\n    this.rendered = false;\n  }\n}\n","/**\n * Minimal client for the public embed surface of workers/api (the `/pub/*`\n * routes). Deliberately self-contained — it does NOT reuse src/lib/api.ts,\n * which bakes in a build-time API base and dashboard session credentials. The\n * SDK runs cross-origin on a third-party ticketing page, so:\n *   - apiBase is per-instance (constructor option), not a build constant;\n *   - credentials are omitted (no cookie to send, avoids CORS-credential setup);\n *   - no custom headers on mutating calls (keeps the CORS preflight trivial).\n */\nimport type { ChartDoc, PickerSeat as SelectedSeat } from '@seatlayer/core';\n\nexport interface HoldConflict {\n  label: string;\n  reason: string;\n}\n\nexport class ApiError extends Error {\n  status: number;\n  code?: string;\n  /** Present when a hold 409s because seats were just taken/held. */\n  conflicts?: HoldConflict[];\n  /** Present when best-available 409s ('not_enough_together' | 'sold_out'). */\n  reason?: string;\n\n  constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string) {\n    super(message);\n    this.name = 'ApiError';\n    this.status = status;\n    this.code = code;\n    this.conflicts = conflicts;\n    this.reason = reason;\n  }\n}\n\nexport interface PubChartResult {\n  event: { key: string; name: string };\n  doc: ChartDoc;\n}\n\nexport interface PubObjectsResult {\n  /** Every non-free seat's status, keyed by seat label. */\n  seats: Record<string, string>;\n  updatedAt: number;\n}\n\nexport interface HoldResult {\n  holdId: string;\n  expiresAt: number;\n  /** The held seats with the buyer's chosen ticket tier per seat (present on hold). */\n  seats?: SelectedSeat[];\n}\n\n/** Best-available response — the server-picked seats plus the hold they landed in. */\nexport interface BestAvailableResult {\n  holdId: string;\n  expiresAt: number;\n  labels: string[];\n  seats?: SelectedSeat[];\n}\n\nasync function request<T>(\n  base: string,\n  path: string,\n  init: { method?: 'GET' | 'POST'; body?: unknown } = {},\n): Promise<T> {\n  const method = init.method ?? 'GET';\n  const headers: Record<string, string> = {};\n  let body: string | undefined;\n  if (init.body !== undefined) {\n    headers['Content-Type'] = 'application/json';\n    body = JSON.stringify(init.body);\n  }\n\n  const res = await fetch(`${base}${path}`, { method, headers, body, credentials: 'omit' });\n\n  const isJson = (res.headers.get('content-type') ?? '').includes('application/json');\n  const data = isJson ? await res.json().catch(() => null) : null;\n\n  if (!res.ok) {\n    const err = data as\n      | { error?: string; code?: string; conflicts?: HoldConflict[]; reason?: string }\n      | null;\n    throw new ApiError(res.status, err?.error ?? `request_failed_${res.status}`, err?.code, err?.conflicts, err?.reason);\n  }\n  return data as T;\n}\n\n/** Public-surface client bound to one apiBase (e.g. https://api.seatlayer.io). */\nexport class PubApi {\n  constructor(private readonly base: string) {}\n\n  chart(key: string): Promise<PubChartResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/chart`);\n  }\n\n  objects(key: string): Promise<PubObjectsResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/objects`);\n  }\n\n  hold(key: string, labels: string[]): Promise<HoldResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/hold`, {\n      method: 'POST',\n      body: { labels },\n    });\n  }\n\n  bestAvailable(key: string, qty: number, categoryKey?: string): Promise<BestAvailableResult> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/best-available`, {\n      method: 'POST',\n      body: { qty, ...(categoryKey ? { categoryKey } : {}) },\n    });\n  }\n\n  release(key: string, labels: string[], holdId: string): Promise<{ ok: true }> {\n    return request(this.base, `/pub/events/${encodeURIComponent(key)}/release`, {\n      method: 'POST',\n      body: { labels, holdId },\n    });\n  }\n\n  socketUrl(key: string): string {\n    const wsBase = this.base.replace(/^http/, 'ws');\n    return `${wsBase}/pub/events/${encodeURIComponent(key)}/subscribe`;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seatlayer/js",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "The SeatLayer embed SDK — render an interactive seat picker and hold seats from the browser. Works in any JS framework.",
   "license": "MIT",
   "homepage": "https://docs.seatlayer.io",
@@ -35,7 +35,7 @@
     "reserved-seating"
   ],
   "dependencies": {
-    "@seatlayer/core": "^0.1.3"
+    "@seatlayer/core": "^0.1.4"
   },
   "devDependencies": {
     "tsup": "^8.5.1",