@smoregg/sdk 0.4.1 → 0.6.0

package/README.md

@@ -0,0 +1,199 @@
+# @smoregg/sdk
+
+S'MORE Game SDK - Build party games with React for the S'MORE platform.
+
+## Installation
+
+```bash
+npm install @smoregg/sdk
+# or
+pnpm add @smoregg/sdk
+# or
+yarn add @smoregg/sdk
+```
+
+## Quick Start
+
+### Screen Game (TV/Display)
+
+```tsx
+import { SmoreScreen } from '@smoregg/sdk';
+
+function MyGame() {
+  const screen = new SmoreScreen({
+    gameId: 'my-game',
+    listeners: {
+      tap: (playerIndex, data) => {
+        console.log(`Player ${playerIndex} tapped!`);
+      }
+    }
+  });
+
+  return <div>Game UI</div>;
+}
+```
+
+### Controller App (Mobile)
+
+```tsx
+import { SmoreController } from '@smoregg/sdk';
+
+function MyController() {
+  const controller = new SmoreController({
+    gameId: 'my-game',
+    listeners: {
+      'state-update': (state) => {
+        console.log('Game state:', state);
+      }
+    }
+  });
+
+  return (
+    <button onClick={() => controller.send('tap', {})}>
+      TAP
+    </button>
+  );
+}
+```
+
+## Features
+
+- **Screen/Controller Communication**: Simple event-based messaging
+- **React Hooks**: `useGameHost`, `useGamePlayer` for React apps
+- **TypeScript Support**: Full type definitions included
+- **Testing Utilities**: Mock Screen and Controller for unit testing
+- **Multiple Formats**: ESM, CJS, and UMD builds
+- **Zero Dependencies**: Peer dependencies only (React, Socket.IO)
+
+## API Reference
+
+### SmoreScreen
+
+Screen-side game controller.
+
+```typescript
+const screen = new SmoreScreen({
+  gameId: string;
+  listeners?: Record<string, (playerIndex: number, data: any) => void>;
+});
+
+// Methods
+screen.broadcast(event: string, data: any): void
+screen.sendToPlayer(playerIndex: number, event: string, data: any): void
+screen.on(event: string, callback: Function): void
+screen.off(event: string, callback: Function): void
+```
+
+### SmoreController
+
+Controller-side app.
+
+```typescript
+const controller = new SmoreController({
+  gameId: string;
+  listeners?: Record<string, (data: any) => void>;
+});
+
+// Methods
+controller.send(event: string, data: any): void
+controller.on(event: string, callback: Function): void
+controller.off(event: string, callback: Function): void
+```
+
+### React Hooks
+
+```typescript
+import { useGameHost, useGamePlayer } from '@smoregg/sdk';
+
+// Screen
+const { room, broadcast, sendToPlayer } = useGameHost({
+  gameId: 'my-game',
+  onInput: {
+    tap: (playerIndex, data) => { /* ... */ }
+  }
+});
+
+// Controller
+const { emit, room } = useGamePlayer({
+  gameId: 'my-game',
+  listeners: {
+    'state-update': (state) => { /* ... */ }
+  }
+});
+```
+
+## Backward Compatibility
+
+The old `SmoreHost` and `SmorePlayer` names are still available as aliases:
+
+```typescript
+// These still work (deprecated)
+import { SmoreHost, SmorePlayer } from '@smoregg/sdk';
+
+// Prefer the new names
+import { SmoreScreen, SmoreController } from '@smoregg/sdk';
+```
+
+## Testing
+
+The SDK provides comprehensive testing utilities for unit testing your game logic:
+
+```typescript
+import { createMockScreen, createMockController } from '@smoregg/sdk';
+
+// Create mock screen with players
+const screen = createMockScreen<MyEvents>({
+  controllers: [
+    { playerIndex: 0, nickname: 'Player 1', connected: true },
+  ],
+});
+
+// Simulate player input
+screen.simulateEvent(0, 'tap', { x: 100, y: 200 });
+
+// Check what was broadcast
+expect(screen.getBroadcasts()).toContainEqual({
+  event: 'score-update',
+  data: { scores: { 0: 10 } },
+});
+```
+
+See [docs/testing.md](./docs/testing.md) for the full testing guide.
+
+## Types
+
+All types are exported from the main package:
+
+```typescript
+import type {
+  Player,
+  PlayerDTO,
+  CharacterAppearance,
+  GameMetadata,
+  GameState,
+  InputCallback
+} from '@smoregg/sdk';
+```
+
+## Building
+
+```bash
+# Development
+pnpm typecheck
+
+# Build all formats (ESM, CJS, UMD)
+pnpm build
+
+# Clean
+pnpm clean
+```
+
+## Publishing
+
+```bash
+pnpm publish:npm
+```
+
+## License
+
+MIT (C) S'MORE Team

package/dist/cjs/SmoreHost.cjs

@@ -0,0 +1,306 @@
+'use strict';
+
+var DirectTransport = require('./transport/DirectTransport.cjs');
+var PostMessageTransport = require('./transport/PostMessageTransport.cjs');
+var protocol = require('./transport/protocol.cjs');
+
+const SYSTEM_PREFIX = "smore:";
+const SYSTEM_EVENTS = {
+  PLAYER_JOIN: `${SYSTEM_PREFIX}player-join`,
+  PLAYER_LEAVE: `${SYSTEM_PREFIX}player-leave`,
+  GAME_OVER: `${SYSTEM_PREFIX}game-over`
+};
+const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
+function validateEventName(event) {
+  if (!EVENT_NAME_REGEX.test(event)) {
+    throw new Error(
+      `[SmoreHost] Invalid event name "${event}". Event names must:
+  - Only contain letters (a-z, A-Z), hyphens (-), and underscores (_)
+  - Start and end with a letter (no leading/trailing - or _)`
+    );
+  }
+}
+class SmoreHost {
+  transport = null;
+  config;
+  _players = [];
+  _roomCode = "";
+  _leaderIndex = -1;
+  _isReady = false;
+  _isDestroyed = false;
+  boundMessageHandler = null;
+  registeredHandlers = [];
+  constructor(config = {}) {
+    this.config = config;
+    if (config.listeners) {
+      for (const event of Object.keys(config.listeners)) {
+        validateEventName(event);
+      }
+    }
+    if (config.socket) {
+      this.initBundled(config);
+    } else {
+      this.initIframe(config);
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Initialization
+  // ---------------------------------------------------------------------------
+  initBundled(config) {
+    if (!config.socket) {
+      throw new Error("[SmoreHost] socket is required for bundled games");
+    }
+    this.transport = new DirectTransport.DirectTransport(config.socket);
+    this._roomCode = config.roomCode || "";
+    this._players = config.players || [];
+    this._leaderIndex = config.leaderIndex ?? -1;
+    this.setupEventHandlers();
+    this._isReady = true;
+    this.config.onReady?.();
+  }
+  initIframe(config) {
+    const parentOrigin = config.parentOrigin || "*";
+    window.parent.postMessage({ type: "smore:ready" }, parentOrigin);
+    this.boundMessageHandler = (e) => {
+      if (parentOrigin !== "*" && e.origin !== parentOrigin) return;
+      const msg = e.data;
+      if (!protocol.isSmoreMessage(msg)) return;
+      if (msg.type === "smore:init") {
+        const initData = msg.payload;
+        if (initData.side !== "host") {
+          console.error("[SmoreHost] Received init for wrong side:", initData.side);
+          return;
+        }
+        this.transport = new PostMessageTransport.PostMessageTransport(parentOrigin);
+        this._roomCode = initData.roomCode;
+        this._players = this.mapPlayersFromInit(initData.players);
+        this._leaderIndex = this.findLeaderIndex(initData.players, initData.leaderId);
+        this.setupEventHandlers();
+        this._isReady = true;
+        this.config.onReady?.();
+      } else if (msg.type === "smore:update") {
+        const updateData = msg.payload;
+        if (updateData.players) {
+          this._players = this.mapPlayersFromInit(updateData.players);
+        }
+        if (updateData.leaderId !== void 0) {
+          this._leaderIndex = this.findLeaderIndex(this._players, updateData.leaderId);
+        }
+      }
+    };
+    window.addEventListener("message", this.boundMessageHandler);
+  }
+  mapPlayersFromInit(players) {
+    return players.map((p, index) => ({
+      playerIndex: p.playerIndex ?? index,
+      nickname: p.nickname || `Player ${index + 1}`,
+      connected: p.connected !== false,
+      appearance: p.appearance
+    }));
+  }
+  findLeaderIndex(players, leaderId) {
+    if (!leaderId) return -1;
+    const idx = players.findIndex((p) => p.sessionId === leaderId);
+    return idx >= 0 ? idx : -1;
+  }
+  setupEventHandlers() {
+    if (!this.transport) return;
+    this.registerHandler(SYSTEM_EVENTS.PLAYER_JOIN, (data) => {
+      const playerIndex = data.player?.playerIndex;
+      if (playerIndex !== void 0) {
+        this.config.onPlayerJoin?.(playerIndex);
+      }
+    });
+    this.registerHandler(SYSTEM_EVENTS.PLAYER_LEAVE, (data) => {
+      if (data.playerIndex !== void 0) {
+        this.config.onPlayerLeave?.(data.playerIndex);
+      }
+    });
+    this.registerHandler("room:player-joined", (data) => {
+      const playerIndex = data?.player?.playerIndex ?? data?.playerIndex;
+      if (playerIndex !== void 0) {
+        this.config.onPlayerJoin?.(playerIndex);
+      }
+    });
+    this.registerHandler("room:player-left", (data) => {
+      const playerIndex = data?.playerIndex ?? data?.player?.playerIndex;
+      if (playerIndex !== void 0) {
+        this.config.onPlayerLeave?.(playerIndex);
+      }
+    });
+    if (this.config.listeners) {
+      for (const [event, handler] of Object.entries(this.config.listeners)) {
+        if (!handler) continue;
+        this.registerHandler(event, (data) => {
+          const { playerIndex, ...rest } = data;
+          if (playerIndex !== void 0) {
+            handler(playerIndex, rest);
+          }
+        });
+      }
+    }
+  }
+  registerHandler(event, handler) {
+    if (!this.transport) return;
+    this.transport.on(event, handler);
+    this.registeredHandlers.push({ event, handler });
+  }
+  // ---------------------------------------------------------------------------
+  // Public Properties
+  // ---------------------------------------------------------------------------
+  /**
+   * Get all players in the room.
+   * Returns a copy to prevent external mutation.
+   */
+  get players() {
+    return [...this._players];
+  }
+  /**
+   * Get the room code.
+   */
+  get roomCode() {
+    return this._roomCode;
+  }
+  /**
+   * Get the leader's player index (-1 if no leader).
+   */
+  get leaderIndex() {
+    return this._leaderIndex;
+  }
+  /**
+   * Check if the host is initialized and ready.
+   */
+  get isReady() {
+    return this._isReady;
+  }
+  // ---------------------------------------------------------------------------
+  // Public Methods
+  // ---------------------------------------------------------------------------
+  /**
+   * Broadcast an event to all players.
+   *
+   * @param event - Event name (no colons allowed)
+   * @param data - Optional data payload
+   *
+   * @example
+   * ```ts
+   * host.broadcast('phase-update', { phase: 'playing' });
+   * host.broadcast('timer-tick', { remaining: 30 });
+   * ```
+   */
+  broadcast(event, data) {
+    this.ensureReady("broadcast");
+    validateEventName(event);
+    this.transport.emit(event, data);
+  }
+  /**
+   * Send an event to a specific player.
+   *
+   * @param playerIndex - Target player index (0, 1, 2, ...)
+   * @param event - Event name (no colons allowed)
+   * @param data - Optional data payload
+   *
+   * @example
+   * ```ts
+   * host.sendToPlayer(0, 'your-turn', { timeLimit: 30 });
+   * host.sendToPlayer(1, 'wait', { message: 'Not your turn' });
+   * ```
+   */
+  sendToPlayer(playerIndex, event, data) {
+    this.ensureReady("sendToPlayer");
+    validateEventName(event);
+    this.transport.emit(event, {
+      targetPlayerIndex: playerIndex,
+      ...data && typeof data === "object" ? data : { data }
+    });
+  }
+  /**
+   * Signal game over with results.
+   * This will broadcast the game over event to all players.
+   *
+   * @param results - Game results (scores, winner, etc.)
+   *
+   * @example
+   * ```ts
+   * host.gameOver({
+   *   scores: { 0: 100, 1: 75, 2: 50 },
+   *   winner: 0,
+   * });
+   * ```
+   */
+  gameOver(results) {
+    this.ensureReady("gameOver");
+    this.transport.emit(SYSTEM_EVENTS.GAME_OVER, { results });
+  }
+  /**
+   * Add a listener for a specific event after construction.
+   *
+   * @param event - Event name (no colons allowed)
+   * @param handler - Handler function (playerIndex, data) => void
+   * @returns Cleanup function to remove the listener
+   *
+   * @example
+   * ```ts
+   * const cleanup = host.on('tap', (playerIndex, data) => {
+   *   console.log(`Player ${playerIndex} tapped`);
+   * });
+   *
+   * // Later
+   * cleanup();
+   * ```
+   */
+  on(event, handler) {
+    validateEventName(event);
+    const wrappedHandler = (data) => {
+      const { playerIndex, ...rest } = data;
+      if (playerIndex !== void 0) {
+        handler(playerIndex, rest);
+      }
+    };
+    if (this.transport) {
+      this.transport.on(event, wrappedHandler);
+      this.registeredHandlers.push({ event, handler: wrappedHandler });
+    }
+    return () => {
+      this.transport?.off(event, wrappedHandler);
+      this.registeredHandlers = this.registeredHandlers.filter(
+        (h) => h.event !== event || h.handler !== wrappedHandler
+      );
+    };
+  }
+  /**
+   * Clean up all resources.
+   * Call this when unmounting/destroying the game.
+   */
+  destroy() {
+    if (this._isDestroyed) return;
+    this._isDestroyed = true;
+    this._isReady = false;
+    for (const { event, handler } of this.registeredHandlers) {
+      this.transport?.off(event, handler);
+    }
+    this.registeredHandlers = [];
+    if (this.transport instanceof PostMessageTransport.PostMessageTransport) {
+      this.transport.destroy();
+    }
+    this.transport = null;
+    if (this.boundMessageHandler) {
+      window.removeEventListener("message", this.boundMessageHandler);
+      this.boundMessageHandler = null;
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Private Helpers
+  // ---------------------------------------------------------------------------
+  ensureReady(method) {
+    if (!this._isReady || !this.transport) {
+      throw new Error(`[SmoreHost] Cannot call ${method}() before host is ready. Wait for onReady callback.`);
+    }
+    if (this._isDestroyed) {
+      throw new Error(`[SmoreHost] Cannot call ${method}() after destroy()`);
+    }
+  }
+}
+
+exports.SmoreHost = SmoreHost;
+//# sourceMappingURL=SmoreHost.cjs.map

package/dist/cjs/SmoreHost.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmoreHost.cjs","sources":["../../src/SmoreHost.ts"],"sourcesContent":["/**\n * SmoreHost - Unified Host-side class for the S'MORE SDK (AirConsole style)\n *\n * Works in any environment: React, Phaser, Vanilla JS.\n * Automatically detects iframe vs bundled environment.\n *\n * @example Iframe game (auto-detection)\n * ```ts\n * const host = new SmoreHost({\n *   onPlayerJoin: (playerIndex) => console.log('Player joined:', playerIndex),\n *   listeners: {\n *     tap: (playerIndex, data) => handleTap(playerIndex, data),\n *   },\n * });\n *\n * // Later\n * host.broadcast('phase-update', { phase: 'playing' });\n * host.gameOver({ scores: { 0: 100, 1: 50 } });\n * ```\n *\n * @example Bundled game (direct socket)\n * ```ts\n * const host = new SmoreHost({\n *   socket,\n *   roomCode: 'ABCD',\n *   players: [...],\n *   leaderIndex: 0,\n *   listeners: { ... },\n * });\n * ```\n */\n\nimport type { Socket } from 'socket.io-client';\nimport type { Transport, TransportEventHandler } from './transport/types';\nimport { DirectTransport } from './transport/DirectTransport';\nimport { PostMessageTransport } from './transport/PostMessageTransport';\nimport { isSmoreMessage, type SmoreInitMessage, type SmoreUpdateMessage } from './transport/protocol';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst SYSTEM_PREFIX = 'smore:';\n\nconst SYSTEM_EVENTS = {\n  READY: `${SYSTEM_PREFIX}ready`,\n  PLAYER_JOIN: `${SYSTEM_PREFIX}player-join`,\n  PLAYER_LEAVE: `${SYSTEM_PREFIX}player-leave`,\n  GAME_OVER: `${SYSTEM_PREFIX}game-over`,\n} as const;\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\nconst EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;\n\nfunction validateEventName(event: string): void {\n  if (!EVENT_NAME_REGEX.test(event)) {\n    throw new Error(\n      `[SmoreHost] Invalid event name \"${event}\". Event names must:\\n` +\n        `  - Only contain letters (a-z, A-Z), hyphens (-), and underscores (_)\\n` +\n        `  - Start and end with a letter (no leading/trailing - or _)`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * Player information exposed to game developers.\n * Uses playerIndex (0, 1, 2, ...) instead of internal sessionId.\n */\nexport interface SmorePlayer {\n  /** Player index (0, 1, 2, ...) */\n  playerIndex: number;\n  /** Player's chosen nickname */\n  nickname: string;\n  /** Whether player is currently connected */\n  connected: boolean;\n  /** Player's character appearance (optional) */\n  appearance?: {\n    skinColor?: string;\n    hairColor?: string;\n    shirtColor?: string;\n    pantsColor?: string;\n  };\n}\n\n/**\n * Configuration for SmoreHost constructor.\n */\nexport interface SmoreHostConfig {\n  // === Callbacks ===\n\n  /** Called when the host is initialized and ready (iframe games only) */\n  onReady?: () => void;\n\n  /** Called when a player joins the room */\n  onPlayerJoin?: (playerIndex: number) => void;\n\n  /** Called when a player leaves the room */\n  onPlayerLeave?: (playerIndex: number) => void;\n\n  /**\n   * Event listeners for specific events.\n   * Keys are event names (no colons), values are handler functions.\n   * Handler receives (playerIndex, data).\n   */\n  listeners?: Record<string, (playerIndex: number, data: any) => void>;\n\n  // === Bundled game options (skip iframe detection) ===\n\n  /** Socket.IO socket instance (bundled games only) */\n  socket?: Socket;\n\n  /** Room code (bundled games only) */\n  roomCode?: string;\n\n  /** Initial players array (bundled games only) */\n  players?: SmorePlayer[];\n\n  /** Leader player index (bundled games only) */\n  leaderIndex?: number;\n\n  // === Iframe game options ===\n\n  /** Parent window origin for postMessage validation (iframe games) */\n  parentOrigin?: string;\n}\n\n// ---------------------------------------------------------------------------\n// SmoreHost Class\n// ---------------------------------------------------------------------------\n\n/**\n * SmoreHost - Main host-side class for game development.\n *\n * Automatically detects iframe vs bundled environment:\n * - Iframe: Uses PostMessageTransport, waits for smore:init from parent\n * - Bundled: Uses DirectTransport with provided socket\n */\nexport class SmoreHost {\n  private transport: Transport | null = null;\n  private config: SmoreHostConfig;\n  private _players: SmorePlayer[] = [];\n  private _roomCode: string = '';\n  private _leaderIndex: number = -1;\n  private _isReady: boolean = false;\n  private _isDestroyed: boolean = false;\n  private boundMessageHandler: ((e: MessageEvent) => void) | null = null;\n  private registeredHandlers: Array<{ event: string; handler: TransportEventHandler }> = [];\n\n  constructor(config: SmoreHostConfig = {}) {\n    this.config = config;\n\n    // Validate event names in listeners\n    if (config.listeners) {\n      for (const event of Object.keys(config.listeners)) {\n        validateEventName(event);\n      }\n    }\n\n    // Detect environment and initialize\n    if (config.socket) {\n      // Bundled game mode: use DirectTransport\n      this.initBundled(config);\n    } else {\n      // Iframe game mode: use PostMessageTransport\n      this.initIframe(config);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Initialization\n  // ---------------------------------------------------------------------------\n\n  private initBundled(config: SmoreHostConfig): void {\n    if (!config.socket) {\n      throw new Error('[SmoreHost] socket is required for bundled games');\n    }\n\n    this.transport = new DirectTransport(config.socket);\n    this._roomCode = config.roomCode || '';\n    this._players = config.players || [];\n    this._leaderIndex = config.leaderIndex ?? -1;\n\n    this.setupEventHandlers();\n\n    // Mark as ready immediately for bundled games\n    this._isReady = true;\n    this.config.onReady?.();\n  }\n\n  private initIframe(config: SmoreHostConfig): void {\n    const parentOrigin = config.parentOrigin || '*';\n\n    // Signal ready to parent\n    window.parent.postMessage({ type: 'smore:ready' }, parentOrigin);\n\n    // Listen for init message from parent\n    this.boundMessageHandler = (e: MessageEvent) => {\n      if (parentOrigin !== '*' && e.origin !== parentOrigin) return;\n\n      const msg = e.data;\n      if (!isSmoreMessage(msg)) return;\n\n      if (msg.type === 'smore:init') {\n        const initData = (msg as SmoreInitMessage).payload;\n\n        if (initData.side !== 'host') {\n          console.error('[SmoreHost] Received init for wrong side:', initData.side);\n          return;\n        }\n\n        // Initialize transport\n        this.transport = new PostMessageTransport(parentOrigin);\n        this._roomCode = initData.roomCode;\n        this._players = this.mapPlayersFromInit(initData.players);\n        this._leaderIndex = this.findLeaderIndex(initData.players, initData.leaderId);\n\n        this.setupEventHandlers();\n\n        this._isReady = true;\n        this.config.onReady?.();\n      } else if (msg.type === 'smore:update') {\n        const updateData = (msg as SmoreUpdateMessage).payload;\n\n        if (updateData.players) {\n          this._players = this.mapPlayersFromInit(updateData.players);\n        }\n        if (updateData.leaderId !== undefined) {\n          this._leaderIndex = this.findLeaderIndex(this._players as any[], updateData.leaderId);\n        }\n      }\n    };\n\n    window.addEventListener('message', this.boundMessageHandler);\n  }\n\n  private mapPlayersFromInit(players: any[]): SmorePlayer[] {\n    return players.map((p, index) => ({\n      playerIndex: p.playerIndex ?? index,\n      nickname: p.nickname || `Player ${index + 1}`,\n      connected: p.connected !== false,\n      appearance: p.appearance,\n    }));\n  }\n\n  private findLeaderIndex(players: any[], leaderId: string | null): number {\n    if (!leaderId) return -1;\n    const idx = players.findIndex((p) => p.sessionId === leaderId);\n    return idx >= 0 ? idx : -1;\n  }\n\n  private setupEventHandlers(): void {\n    if (!this.transport) return;\n\n    // System events: player join/leave\n    this.registerHandler(SYSTEM_EVENTS.PLAYER_JOIN, (data: { player: SmorePlayer }) => {\n      const playerIndex = data.player?.playerIndex;\n      if (playerIndex !== undefined) {\n        this.config.onPlayerJoin?.(playerIndex);\n      }\n    });\n\n    this.registerHandler(SYSTEM_EVENTS.PLAYER_LEAVE, (data: { playerIndex: number }) => {\n      if (data.playerIndex !== undefined) {\n        this.config.onPlayerLeave?.(data.playerIndex);\n      }\n    });\n\n    // Legacy room events (backward compatibility)\n    this.registerHandler('room:player-joined', (data: any) => {\n      const playerIndex = data?.player?.playerIndex ?? data?.playerIndex;\n      if (playerIndex !== undefined) {\n        this.config.onPlayerJoin?.(playerIndex);\n      }\n    });\n\n    this.registerHandler('room:player-left', (data: any) => {\n      const playerIndex = data?.playerIndex ?? data?.player?.playerIndex;\n      if (playerIndex !== undefined) {\n        this.config.onPlayerLeave?.(playerIndex);\n      }\n    });\n\n    // User event listeners\n    if (this.config.listeners) {\n      for (const [event, handler] of Object.entries(this.config.listeners)) {\n        if (!handler) continue;\n\n        this.registerHandler(event, (data: { playerIndex: number; [key: string]: any }) => {\n          const { playerIndex, ...rest } = data;\n          if (playerIndex !== undefined) {\n            handler(playerIndex, rest);\n          }\n        });\n      }\n    }\n  }\n\n  private registerHandler(event: string, handler: TransportEventHandler): void {\n    if (!this.transport) return;\n    this.transport.on(event, handler);\n    this.registeredHandlers.push({ event, handler });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Public Properties\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Get all players in the room.\n   * Returns a copy to prevent external mutation.\n   */\n  get players(): SmorePlayer[] {\n    return [...this._players];\n  }\n\n  /**\n   * Get the room code.\n   */\n  get roomCode(): string {\n    return this._roomCode;\n  }\n\n  /**\n   * Get the leader's player index (-1 if no leader).\n   */\n  get leaderIndex(): number {\n    return this._leaderIndex;\n  }\n\n  /**\n   * Check if the host is initialized and ready.\n   */\n  get isReady(): boolean {\n    return this._isReady;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Public Methods\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Broadcast an event to all players.\n   *\n   * @param event - Event name (no colons allowed)\n   * @param data - Optional data payload\n   *\n   * @example\n   * ```ts\n   * host.broadcast('phase-update', { phase: 'playing' });\n   * host.broadcast('timer-tick', { remaining: 30 });\n   * ```\n   */\n  broadcast(event: string, data?: any): void {\n    this.ensureReady('broadcast');\n    validateEventName(event);\n    // Emit user event directly - genericRelay handles Host → Room broadcast\n    this.transport!.emit(event, data);\n  }\n\n  /**\n   * Send an event to a specific player.\n   *\n   * @param playerIndex - Target player index (0, 1, 2, ...)\n   * @param event - Event name (no colons allowed)\n   * @param data - Optional data payload\n   *\n   * @example\n   * ```ts\n   * host.sendToPlayer(0, 'your-turn', { timeLimit: 30 });\n   * host.sendToPlayer(1, 'wait', { message: 'Not your turn' });\n   * ```\n   */\n  sendToPlayer(playerIndex: number, event: string, data?: any): void {\n    this.ensureReady('sendToPlayer');\n    validateEventName(event);\n    // Emit user event with targetPlayerIndex - genericRelay handles Host → Player\n    this.transport!.emit(event, {\n      targetPlayerIndex: playerIndex,\n      ...(data && typeof data === 'object' ? data : { data }),\n    });\n  }\n\n  /**\n   * Signal game over with results.\n   * This will broadcast the game over event to all players.\n   *\n   * @param results - Game results (scores, winner, etc.)\n   *\n   * @example\n   * ```ts\n   * host.gameOver({\n   *   scores: { 0: 100, 1: 75, 2: 50 },\n   *   winner: 0,\n   * });\n   * ```\n   */\n  gameOver(results?: any): void {\n    this.ensureReady('gameOver');\n    this.transport!.emit(SYSTEM_EVENTS.GAME_OVER, { results });\n  }\n\n  /**\n   * Add a listener for a specific event after construction.\n   *\n   * @param event - Event name (no colons allowed)\n   * @param handler - Handler function (playerIndex, data) => void\n   * @returns Cleanup function to remove the listener\n   *\n   * @example\n   * ```ts\n   * const cleanup = host.on('tap', (playerIndex, data) => {\n   *   console.log(`Player ${playerIndex} tapped`);\n   * });\n   *\n   * // Later\n   * cleanup();\n   * ```\n   */\n  on(event: string, handler: (playerIndex: number, data: any) => void): () => void {\n    validateEventName(event);\n\n    const wrappedHandler = (data: { playerIndex: number; [key: string]: any }) => {\n      const { playerIndex, ...rest } = data;\n      if (playerIndex !== undefined) {\n        handler(playerIndex, rest);\n      }\n    };\n\n    if (this.transport) {\n      this.transport.on(event, wrappedHandler);\n      this.registeredHandlers.push({ event, handler: wrappedHandler });\n    }\n\n    return () => {\n      this.transport?.off(event, wrappedHandler);\n      this.registeredHandlers = this.registeredHandlers.filter(\n        (h) => h.event !== event || h.handler !== wrappedHandler\n      );\n    };\n  }\n\n  /**\n   * Clean up all resources.\n   * Call this when unmounting/destroying the game.\n   */\n  destroy(): void {\n    if (this._isDestroyed) return;\n\n    this._isDestroyed = true;\n    this._isReady = false;\n\n    // Remove all registered handlers\n    for (const { event, handler } of this.registeredHandlers) {\n      this.transport?.off(event, handler);\n    }\n    this.registeredHandlers = [];\n\n    // Destroy transport\n    if (this.transport instanceof PostMessageTransport) {\n      (this.transport as PostMessageTransport).destroy();\n    }\n    this.transport = null;\n\n    // Remove message listener\n    if (this.boundMessageHandler) {\n      window.removeEventListener('message', this.boundMessageHandler);\n      this.boundMessageHandler = null;\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private Helpers\n  // ---------------------------------------------------------------------------\n\n  private ensureReady(method: string): void {\n    if (!this._isReady || !this.transport) {\n      throw new Error(`[SmoreHost] Cannot call ${method}() before host is ready. Wait for onReady callback.`);\n    }\n    if (this._isDestroyed) {\n      throw new Error(`[SmoreHost] Cannot call ${method}() after destroy()`);\n    }\n  }\n}\n"],"names":["DirectTransport","isSmoreMessage","PostMessageTransport"],"mappings":"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"}