@smoregg/sdk 0.4.1 → 0.5.0

package/dist/esm/SmorePlayer.js

@@ -0,0 +1,227 @@
+import { DirectTransport } from './transport/DirectTransport.js';
+import { PostMessageTransport } from './transport/PostMessageTransport.js';
+import { isSmoreMessage } from './transport/protocol.js';
+
+const SYSTEM_PREFIX = "smore:";
+const SYSTEM_EVENTS = {
+  PLAYER_JOIN: `${SYSTEM_PREFIX}player-join`,
+  PLAYER_LEAVE: `${SYSTEM_PREFIX}player-leave`
+};
+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(
+      `[SmorePlayer] 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 SmorePlayer {
+  transport = null;
+  config;
+  _roomCode = "";
+  _myIndex = -1;
+  _isLeader = false;
+  _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("[SmorePlayer] socket is required for bundled games");
+    }
+    this.transport = new DirectTransport(config.socket);
+    this._roomCode = config.roomCode || "";
+    this._myIndex = config.myIndex ?? -1;
+    this._isLeader = config.isLeader ?? false;
+    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 (!isSmoreMessage(msg)) return;
+      if (msg.type === "smore:init") {
+        const initData = msg.payload;
+        if (initData.side !== "player") {
+          console.error("[SmorePlayer] Received init for wrong side:", initData.side);
+          return;
+        }
+        if (initData.myIndex === void 0) {
+          console.error("[SmorePlayer] Missing myIndex in init payload");
+          return;
+        }
+        this.transport = new PostMessageTransport(parentOrigin);
+        this._roomCode = initData.roomCode;
+        this._myIndex = initData.myIndex;
+        this._isLeader = initData.isLeader ?? false;
+        this.setupEventHandlers();
+        this._isReady = true;
+        this.config.onReady?.();
+      } else if (msg.type === "smore:update") {
+        const updateData = msg.payload;
+        if (updateData.leaderId !== void 0) ;
+      }
+    };
+    window.addEventListener("message", this.boundMessageHandler);
+  }
+  setupEventHandlers() {
+    if (!this.transport) return;
+    this.registerHandler(SYSTEM_EVENTS.PLAYER_JOIN, (data) => {
+      const playerIndex = data.player?.playerIndex ?? data.playerIndex;
+      if (playerIndex !== void 0) {
+        this.config.onPlayerJoin?.(playerIndex);
+      }
+    });
+    this.registerHandler(SYSTEM_EVENTS.PLAYER_LEAVE, (data) => {
+      const playerIndex = data.player?.playerIndex ?? data.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, handler);
+      }
+    }
+  }
+  registerHandler(event, handler) {
+    if (!this.transport) return;
+    this.transport.on(event, handler);
+    this.registeredHandlers.push({ event, handler });
+  }
+  // ---------------------------------------------------------------------------
+  // Public Properties
+  // ---------------------------------------------------------------------------
+  /**
+   * Get my player index (0, 1, 2, ...).
+   */
+  get myIndex() {
+    return this._myIndex;
+  }
+  /**
+   * Check if I am the room leader.
+   */
+  get isLeader() {
+    return this._isLeader;
+  }
+  /**
+   * Get the room code.
+   */
+  get roomCode() {
+    return this._roomCode;
+  }
+  /**
+   * Check if the player is initialized and ready.
+   */
+  get isReady() {
+    return this._isReady;
+  }
+  // ---------------------------------------------------------------------------
+  // Public Methods
+  // ---------------------------------------------------------------------------
+  /**
+   * Send an event to the host.
+   *
+   * @param event - Event name (no colons allowed)
+   * @param data - Optional data payload
+   *
+   * @example
+   * ```ts
+   * player.send('tap', { timestamp: Date.now() });
+   * player.send('answer', { choice: 2 });
+   * ```
+   */
+  send(event, data) {
+    this.ensureReady("send");
+    validateEventName(event);
+    this.transport.emit(event, data);
+  }
+  /**
+   * Add a listener for a specific event after construction.
+   *
+   * @param event - Event name (no colons allowed)
+   * @param handler - Handler function (data) => void
+   * @returns Cleanup function to remove the listener
+   *
+   * @example
+   * ```ts
+   * const cleanup = player.on('phase-update', (data) => {
+   *   console.log('New phase:', data.phase);
+   * });
+   *
+   * // Later
+   * cleanup();
+   * ```
+   */
+  on(event, handler) {
+    validateEventName(event);
+    if (this.transport) {
+      this.transport.on(event, handler);
+      this.registeredHandlers.push({ event, handler });
+    }
+    return () => {
+      this.transport?.off(event, handler);
+      this.registeredHandlers = this.registeredHandlers.filter(
+        (h) => h.event !== event || h.handler !== handler
+      );
+    };
+  }
+  /**
+   * 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) {
+      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(`[SmorePlayer] Cannot call ${method}() before player is ready. Wait for onReady callback.`);
+    }
+    if (this._isDestroyed) {
+      throw new Error(`[SmorePlayer] Cannot call ${method}() after destroy()`);
+    }
+  }
+}
+
+export { SmorePlayer };
+//# sourceMappingURL=SmorePlayer.js.map

package/dist/esm/SmorePlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmorePlayer.js","sources":["../../src/SmorePlayer.ts"],"sourcesContent":["/**\n * SmorePlayer - Unified Player-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 player = new SmorePlayer({\n *   onReady: () => console.log('Ready! My index:', player.myIndex),\n *   listeners: {\n *     'phase-update': (data) => handlePhaseUpdate(data),\n *   },\n * });\n *\n * // Later\n * player.send('tap', { timestamp: Date.now() });\n * ```\n *\n * @example Bundled game (direct socket)\n * ```ts\n * const player = new SmorePlayer({\n *   socket,\n *   roomCode: 'ABCD',\n *   myIndex: 0,\n *   isLeader: true,\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} 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      `[SmorePlayer] 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.\n */\nexport interface SmorePlayerInfo {\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}\n\n/**\n * Configuration for SmorePlayer constructor.\n */\nexport interface SmorePlayerConfig {\n  // === Callbacks ===\n\n  /** Called when the player is ready and initialized (iframe games only) */\n  onReady?: () => void;\n\n  /** Called when another player joins the room */\n  onPlayerJoin?: (playerIndex: number) => void;\n\n  /** Called when another 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 (data) only - player side doesn't need playerIndex.\n   */\n  listeners?: Record<string, (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  /** My player index (bundled games only) */\n  myIndex?: number;\n\n  /** Am I the leader? (bundled games only) */\n  isLeader?: boolean;\n\n  // === Iframe game options ===\n\n  /** Parent window origin for postMessage validation (iframe games) */\n  parentOrigin?: string;\n}\n\n// ---------------------------------------------------------------------------\n// SmorePlayer Class\n// ---------------------------------------------------------------------------\n\n/**\n * SmorePlayer - Main player-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 SmorePlayer {\n  private transport: Transport | null = null;\n  private config: SmorePlayerConfig;\n  private _roomCode: string = '';\n  private _myIndex: number = -1;\n  private _isLeader: boolean = false;\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: SmorePlayerConfig = {}) {\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: SmorePlayerConfig): void {\n    if (!config.socket) {\n      throw new Error('[SmorePlayer] socket is required for bundled games');\n    }\n\n    this.transport = new DirectTransport(config.socket);\n    this._roomCode = config.roomCode || '';\n    this._myIndex = config.myIndex ?? -1;\n    this._isLeader = config.isLeader ?? false;\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: SmorePlayerConfig): 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 !== 'player') {\n          console.error('[SmorePlayer] Received init for wrong side:', initData.side);\n          return;\n        }\n\n        if (initData.myIndex === undefined) {\n          console.error('[SmorePlayer] Missing myIndex in init payload');\n          return;\n        }\n\n        // Initialize transport\n        this.transport = new PostMessageTransport(parentOrigin);\n        this._roomCode = initData.roomCode;\n        this._myIndex = initData.myIndex;\n        this._isLeader = initData.isLeader ?? false;\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        // Update leader status if changed\n        if (updateData.leaderId !== undefined) {\n          // Note: Without players array, we can't determine isLeader change\n          // This would require the parent to send myIndex in update\n        }\n      }\n    };\n\n    window.addEventListener('message', this.boundMessageHandler);\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?: SmorePlayerInfo; playerIndex?: number }) => {\n      const playerIndex = data.player?.playerIndex ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        this.config.onPlayerJoin?.(playerIndex);\n      }\n    });\n\n    this.registerHandler(SYSTEM_EVENTS.PLAYER_LEAVE, (data: { player?: { playerIndex?: number }; playerIndex?: number }) => {\n      const playerIndex = data.player?.playerIndex ?? data.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        // Player side receives data directly (no playerIndex unwrapping)\n        this.registerHandler(event, handler);\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 my player index (0, 1, 2, ...).\n   */\n  get myIndex(): number {\n    return this._myIndex;\n  }\n\n  /**\n   * Check if I am the room leader.\n   */\n  get isLeader(): boolean {\n    return this._isLeader;\n  }\n\n  /**\n   * Get the room code.\n   */\n  get roomCode(): string {\n    return this._roomCode;\n  }\n\n  /**\n   * Check if the player is initialized and ready.\n   */\n  get isReady(): boolean {\n    return this._isReady;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Public Methods\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Send an event to the host.\n   *\n   * @param event - Event name (no colons allowed)\n   * @param data - Optional data payload\n   *\n   * @example\n   * ```ts\n   * player.send('tap', { timestamp: Date.now() });\n   * player.send('answer', { choice: 2 });\n   * ```\n   */\n  send(event: string, data?: any): void {\n    this.ensureReady('send');\n    validateEventName(event);\n    this.transport!.emit(event, data);\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 (data) => void\n   * @returns Cleanup function to remove the listener\n   *\n   * @example\n   * ```ts\n   * const cleanup = player.on('phase-update', (data) => {\n   *   console.log('New phase:', data.phase);\n   * });\n   *\n   * // Later\n   * cleanup();\n   * ```\n   */\n  on(event: string, handler: (data: any) => void): () => void {\n    validateEventName(event);\n\n    if (this.transport) {\n      this.transport.on(event, handler);\n      this.registeredHandlers.push({ event, handler });\n    }\n\n    return () => {\n      this.transport?.off(event, handler);\n      this.registeredHandlers = this.registeredHandlers.filter(\n        (h) => h.event !== event || h.handler !== handler\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(`[SmorePlayer] Cannot call ${method}() before player is ready. Wait for onReady callback.`);\n    }\n    if (this._isDestroyed) {\n      throw new Error(`[SmorePlayer] Cannot call ${method}() after destroy()`);\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/components/IframeGameBridge.js

@@ -0,0 +1,113 @@
+import { jsx } from 'react/jsx-runtime';
+import { useRef, useCallback, useEffect } from 'react';
+import { isSmoreMessage } from '../transport/protocol.js';
+
+const IframeGameBridge = ({
+  gameId,
+  url,
+  socket,
+  side,
+  roomCode,
+  players,
+  leaderId,
+  myIndex,
+  isLeader,
+  onReady,
+  onLoaded,
+  onGameOver,
+  style,
+  className
+}) => {
+  const iframeRef = useRef(null);
+  const readyRef = useRef(false);
+  const loadedRef = useRef(false);
+  const postToIframe = useCallback((msg) => {
+    iframeRef.current?.contentWindow?.postMessage(msg, "*");
+  }, []);
+  useEffect(() => {
+    const handler = (e) => {
+      if (e.source !== iframeRef.current?.contentWindow) return;
+      const msg = e.data;
+      if (!isSmoreMessage(msg)) return;
+      if (msg.type === "smore:ready" && !readyRef.current) {
+        readyRef.current = true;
+        postToIframe({
+          type: "smore:init",
+          payload: {
+            side,
+            roomCode,
+            players,
+            leaderId,
+            myIndex,
+            isLeader
+          }
+        });
+        onReady?.();
+        setTimeout(() => {
+          if (!loadedRef.current) {
+            console.warn("[IframeGameBridge] Game did not send smore:loaded, auto-triggering");
+            loadedRef.current = true;
+            onLoaded?.();
+          }
+        }, 2e3);
+      }
+      if (msg.type === "smore:loaded" && !loadedRef.current) {
+        loadedRef.current = true;
+        onLoaded?.();
+      }
+      if (msg.type === "smore:emit") {
+        const { event, data, ackId } = msg.payload;
+        if (event === "room:game-over") {
+          onGameOver?.(data?.results);
+        }
+        if (ackId) {
+          socket.emit(event, data, (response) => {
+            postToIframe({ type: "smore:ack", payload: { ackId, data: response } });
+          });
+        } else {
+          socket.emit(event, data);
+        }
+      }
+    };
+    window.addEventListener("message", handler);
+    return () => window.removeEventListener("message", handler);
+  }, [socket, side, roomCode, players, leaderId, myIndex, isLeader, onReady, onLoaded, onGameOver, postToIframe]);
+  useEffect(() => {
+    if (!readyRef.current) return;
+    postToIframe({
+      type: "smore:update",
+      payload: { players, leaderId }
+    });
+  }, [players, leaderId, postToIframe]);
+  useEffect(() => {
+    if (!socket) return;
+    const handler = (event, ...args) => {
+      postToIframe({
+        type: "smore:event",
+        payload: { event, data: args[0] }
+      });
+    };
+    socket.onAny(handler);
+    return () => {
+      socket.offAny(handler);
+    };
+  }, [socket, postToIframe]);
+  return /* @__PURE__ */ jsx(
+    "iframe",
+    {
+      ref: iframeRef,
+      src: url,
+      sandbox: "allow-scripts allow-same-origin",
+      style: {
+        border: "none",
+        width: "100%",
+        height: "100%",
+        ...style
+      },
+      className
+    }
+  );
+};
+
+export { IframeGameBridge };
+//# sourceMappingURL=IframeGameBridge.js.map

package/dist/esm/components/IframeGameBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IframeGameBridge.js","sources":["../../../src/components/IframeGameBridge.tsx"],"sourcesContent":["/**\n * IframeGameBridge - Parent-side bridge between iframe and Socket.IO.\n *\n * Renders an iframe loading the external game URL.\n * Bridges postMessage ↔ Socket.IO:\n * - iframe sends `smore:emit` → bridge relays to `socket.emit()` as-is\n * - socket receives events → bridge relays to iframe via `smore:event` as-is\n *\n * No event translation is performed; events are passed through unchanged.\n *\n * Used by GameOverlay (host) and GameView (player) when the game type is 'external'.\n */\n\nimport React, { useEffect, useRef, useCallback } from 'react';\nimport type { Socket } from 'socket.io-client';\nimport { isSmoreMessage } from '../transport/protocol';\nimport type { SmoreEmitMessage } from '../transport/protocol';\n\ninterface Player {\n  playerIndex: number;\n  name: string;\n  connected?: boolean;\n}\n\nexport interface IframeGameBridgeProps {\n  gameId: string;\n  url: string;\n  socket: Socket;\n  side: 'host' | 'player';\n  roomCode: string;\n  players: Player[];\n  leaderId: string | null;\n  myIndex?: number;\n  isLeader?: boolean;\n  onReady?: () => void;\n  onLoaded?: () => void;\n  onGameOver?: (results: any) => void;\n  style?: React.CSSProperties;\n  className?: string;\n}\n\nexport const IframeGameBridge: React.FC<IframeGameBridgeProps> = ({\n  gameId,\n  url,\n  socket,\n  side,\n  roomCode,\n  players,\n  leaderId,\n  myIndex,\n  isLeader,\n  onReady,\n  onLoaded,\n  onGameOver,\n  style,\n  className,\n}) => {\n  const iframeRef = useRef<HTMLIFrameElement>(null);\n  const readyRef = useRef(false);\n  const loadedRef = useRef(false);\n\n  // Send message to iframe\n  const postToIframe = useCallback((msg: object) => {\n    iframeRef.current?.contentWindow?.postMessage(msg, '*');\n  }, []);\n\n  // Handle messages from iframe (smore:ready, smore:emit)\n  useEffect(() => {\n    const handler = (e: MessageEvent) => {\n      if (e.source !== iframeRef.current?.contentWindow) return;\n\n      const msg = e.data;\n      if (!isSmoreMessage(msg)) return;\n\n      if (msg.type === 'smore:ready' && !readyRef.current) {\n        readyRef.current = true;\n\n        postToIframe({\n          type: 'smore:init',\n          payload: {\n            side,\n            roomCode,\n            players,\n            leaderId,\n            myIndex,\n            isLeader,\n          },\n        });\n\n        onReady?.();\n\n        // Fallback: if game doesn't send smore:loaded within 2s, auto-trigger\n        setTimeout(() => {\n          if (!loadedRef.current) {\n            console.warn('[IframeGameBridge] Game did not send smore:loaded, auto-triggering');\n            loadedRef.current = true;\n            onLoaded?.();\n          }\n        }, 2000);\n      }\n\n      if (msg.type === 'smore:loaded' && !loadedRef.current) {\n        loadedRef.current = true;\n        onLoaded?.();\n      }\n\n      if (msg.type === 'smore:emit') {\n        const { event, data, ackId } = (msg as SmoreEmitMessage).payload;\n\n        // Intercept game-over\n        if (event === 'room:game-over') {\n          onGameOver?.(data?.results);\n        }\n\n        if (ackId) {\n          socket.emit(event, data, (response: any) => {\n            postToIframe({ type: 'smore:ack', payload: { ackId, data: response } });\n          });\n        } else {\n          socket.emit(event, data);\n        }\n      }\n    };\n\n    window.addEventListener('message', handler);\n    return () => window.removeEventListener('message', handler);\n  }, [socket, side, roomCode, players, leaderId, myIndex, isLeader, onReady, onLoaded, onGameOver, postToIframe]);\n\n  // Push player/leader updates to iframe after init\n  useEffect(() => {\n    if (!readyRef.current) return;\n    postToIframe({\n      type: 'smore:update',\n      payload: { players, leaderId },\n    });\n  }, [players, leaderId, postToIframe]);\n\n  // Bridge socket events to iframe\n  useEffect(() => {\n    if (!socket) return;\n\n    const handler = (event: string, ...args: any[]) => {\n      postToIframe({\n        type: 'smore:event',\n        payload: { event, data: args[0] },\n      });\n    };\n\n    socket.onAny(handler);\n    return () => {\n      socket.offAny(handler);\n    };\n  }, [socket, postToIframe]);\n\n  return (\n    <iframe\n      ref={iframeRef}\n      src={url}\n      sandbox=\"allow-scripts allow-same-origin\"\n      style={{\n        border: 'none',\n        width: '100%',\n        height: '100%',\n        ...style,\n      }}\n      className={className}\n    />\n  );\n};\n"],"names":[],"mappings":"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"}

package/dist/esm/context/RoomProvider.js

@@ -45,7 +45,7 @@ const PlayerRoomProvider = ({
   roomCode,
   players,
   leaderId,
-  mySessionId,
+  myIndex,
   isLeader,
   socket,
   isConnected,
@@ -61,12 +61,12 @@ const PlayerRoomProvider = ({
       players,
       connectedPlayers,
       leaderId,
-      mySessionId,
+      myIndex,
       isLeader,
       socket,
       isConnected
     }),
-    [roomCode, players, connectedPlayers, leaderId, mySessionId, isLeader, socket, isConnected]
+    [roomCode, players, connectedPlayers, leaderId, myIndex, isLeader, socket, isConnected]
   );
   const value = useMemo(
     () => ({

package/dist/esm/context/RoomProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"RoomProvider.js","sources":["../../../src/context/RoomProvider.tsx"],"sourcesContent":["/**\n * RoomProvider - SDK Room Context\n *\n * Foundation context that all other SDK hooks depend on.\n * Provides room state (players, roomCode, leaderId) for both host and player sides.\n *\n * Also provides a Transport abstraction via TransportContext.\n * - HostRoomProvider / PlayerRoomProvider create a DirectTransport from the socket.\n * - IframeRoomProvider (external) provides a PostMessageTransport.\n *\n * Usage:\n * - Host: <HostRoomProvider roomCode={...} players={...} leaderId={...} socket={...}>\n * - Player: <PlayerRoomProvider roomCode={...} players={...} leaderId={...} mySessionId={...} isLeader={...} socket={...} isConnected={...}>\n */\n\nimport React, { createContext, useContext, useMemo } from 'react';\nimport type { Player } from '@smoregg/shared';\nimport type { Socket } from 'socket.io-client';\nimport type { Transport } from '../transport/types';\nimport { DirectTransport } from '../transport/DirectTransport';\n\n// ===== Transport Context =====\n\nconst TransportContext = createContext<Transport | null>(null);\n\nexport function useTransport(): Transport {\n  const transport = useContext(TransportContext);\n  if (!transport) {\n    throw new Error('useTransport must be used within a RoomProvider that supplies a Transport');\n  }\n  return transport;\n}\n\nexport { TransportContext };\n\n// ===== State Types =====\n\nexport interface RoomState {\n  roomCode: string;\n  players: Player[];\n  connectedPlayers: Player[];\n  leaderId: string | null;\n}\n\nexport interface HostRoomState extends RoomState {\n  socket: Socket;\n}\n\nexport interface PlayerRoomState extends RoomState {\n  mySessionId: string;\n  isLeader: boolean;\n  socket: Socket;\n  isConnected: boolean;\n}\n\nexport interface RoomContextValue {\n  roomCode: string;\n  players: Player[];\n  connectedPlayers: Player[];\n  leaderId: string | null;\n  side: 'host' | 'player';\n  host: HostRoomState | null;\n  player: PlayerRoomState | null;\n}\n\n// ===== Context =====\n\nexport const RoomContext = createContext<RoomContextValue | null>(null);\n\n// ===== Host Provider =====\n\ninterface HostRoomProviderProps {\n  roomCode: string;\n  players: Player[];\n  leaderId: string | null;\n  socket: Socket;\n  children: React.ReactNode;\n}\n\nexport const HostRoomProvider: React.FC<HostRoomProviderProps> = ({\n  roomCode,\n  players,\n  leaderId,\n  socket,\n  children,\n}) => {\n  const connectedPlayers = useMemo(\n    () => players.filter((p) => p.connected !== false),\n    [players]\n  );\n\n  const hostState: HostRoomState = useMemo(\n    () => ({ roomCode, players, connectedPlayers, leaderId, socket }),\n    [roomCode, players, connectedPlayers, leaderId, socket]\n  );\n\n  const value: RoomContextValue = useMemo(\n    () => ({\n      roomCode,\n      players,\n      connectedPlayers,\n      leaderId,\n      side: 'host' as const,\n      host: hostState,\n      player: null,\n    }),\n    [roomCode, players, connectedPlayers, leaderId, hostState]\n  );\n\n  const transport = useMemo(() => new DirectTransport(socket), [socket]);\n\n  return (\n    <TransportContext.Provider value={transport}>\n      <RoomContext.Provider value={value}>{children}</RoomContext.Provider>\n    </TransportContext.Provider>\n  );\n};\n\n// ===== Player Provider =====\n\ninterface PlayerRoomProviderProps {\n  roomCode: string;\n  players: Player[];\n  leaderId: string | null;\n  mySessionId: string;\n  isLeader: boolean;\n  socket: Socket;\n  isConnected: boolean;\n  children: React.ReactNode;\n}\n\nexport const PlayerRoomProvider: React.FC<PlayerRoomProviderProps> = ({\n  roomCode,\n  players,\n  leaderId,\n  mySessionId,\n  isLeader,\n  socket,\n  isConnected,\n  children,\n}) => {\n  const connectedPlayers = useMemo(\n    () => players.filter((p) => p.connected !== false),\n    [players]\n  );\n\n  const playerState: PlayerRoomState = useMemo(\n    () => ({\n      roomCode,\n      players,\n      connectedPlayers,\n      leaderId,\n      mySessionId,\n      isLeader,\n      socket,\n      isConnected,\n    }),\n    [roomCode, players, connectedPlayers, leaderId, mySessionId, isLeader, socket, isConnected]\n  );\n\n  const value: RoomContextValue = useMemo(\n    () => ({\n      roomCode,\n      players,\n      connectedPlayers,\n      leaderId,\n      side: 'player' as const,\n      host: null,\n      player: playerState,\n    }),\n    [roomCode, players, connectedPlayers, leaderId, playerState]\n  );\n\n  const transport = useMemo(() => new DirectTransport(socket), [socket]);\n\n  return (\n    <TransportContext.Provider value={transport}>\n      <RoomContext.Provider value={value}>{children}</RoomContext.Provider>\n    </TransportContext.Provider>\n  );\n};\n\n// ===== Hooks =====\n\nexport function useRoom(): RoomContextValue {\n  const context = useContext(RoomContext);\n  if (!context) {\n    throw new Error('useRoom must be used within HostRoomProvider or PlayerRoomProvider');\n  }\n  return context;\n}\n\nexport function useHostRoom(): HostRoomState {\n  const context = useRoom();\n  if (context.side !== 'host' || !context.host) {\n    throw new Error('useHostRoom must be used within HostRoomProvider');\n  }\n  return context.host;\n}\n\nexport function usePlayerRoom(): PlayerRoomState {\n  const context = useRoom();\n  if (context.side !== 'player' || !context.player) {\n    throw new Error('usePlayerRoom must be used within PlayerRoomProvider');\n  }\n  return context.player;\n}\n"],"names":[],"mappings":";;;;AAuBA,MAAM,gBAAA,GAAmB,cAAgC,IAAI;AAEtD,SAAS,YAAA,GAA0B;AACxC,EAAA,MAAM,SAAA,GAAY,WAAW,gBAAgB,CAAA;AAC7C,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,MAAM,IAAI,MAAM,2EAA2E,CAAA;AAAA,EAC7F;AACA,EAAA,OAAO,SAAA;AACT;AAoCO,MAAM,WAAA,GAAc,cAAuC,IAAI;AAY/D,MAAM,mBAAoD,CAAC;AAAA,EAChE,QAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,KAAM;AACJ,EAAA,MAAM,gBAAA,GAAmB,OAAA;AAAA,IACvB,MAAM,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,cAAc,KAAK,CAAA;AAAA,IACjD,CAAC,OAAO;AAAA,GACV;AAEA,EAAA,MAAM,SAAA,GAA2B,OAAA;AAAA,IAC/B,OAAO,EAAE,QAAA,EAAU,OAAA,EAAS,gBAAA,EAAkB,UAAU,MAAA,EAAO,CAAA;AAAA,IAC/D,CAAC,QAAA,EAAU,OAAA,EAAS,gBAAA,EAAkB,UAAU,MAAM;AAAA,GACxD;AAEA,EAAA,MAAM,KAAA,GAA0B,OAAA;AAAA,IAC9B,OAAO;AAAA,MACL,QAAA;AAAA,MACA,OAAA;AAAA,MACA,gBAAA;AAAA,MACA,QAAA;AAAA,MACA,IAAA,EAAM,MAAA;AAAA,MACN,IAAA,EAAM,SAAA;AAAA,MACN,MAAA,EAAQ;AAAA,KACV,CAAA;AAAA,IACA,CAAC,QAAA,EAAU,OAAA,EAAS,gBAAA,EAAkB,UAAU,SAAS;AAAA,GAC3D;AAEA,EAAA,MAAM,SAAA,GAAY,QAAQ,MAAM,IAAI,gBAAgB,MAAM,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAErE,EAAA,uBACE,GAAA,CAAC,gBAAA,CAAiB,QAAA,EAAjB,EAA0B,KAAA,EAAO,SAAA,EAChC,QAAA,kBAAA,GAAA,CAAC,WAAA,CAAY,QAAA,EAAZ,EAAqB,KAAA,EAAe,QAAA,EAAS,CAAA,EAChD,CAAA;AAEJ;AAeO,MAAM,qBAAwD,CAAC;AAAA,EACpE,QAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA,WAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,WAAA;AAAA,EACA;AACF,CAAA,KAAM;AACJ,EAAA,MAAM,gBAAA,GAAmB,OAAA;AAAA,IACvB,MAAM,OAAA,CAAQ,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,cAAc,KAAK,CAAA;AAAA,IACjD,CAAC,OAAO;AAAA,GACV;AAEA,EAAA,MAAM,WAAA,GAA+B,OAAA;AAAA,IACnC,OAAO;AAAA,MACL,QAAA;AAAA,MACA,OAAA;AAAA,MACA,gBAAA;AAAA,MACA,QAAA;AAAA,MACA,WAAA;AAAA,MACA,QAAA;AAAA,MACA,MAAA;AAAA,MACA;AAAA,KACF,CAAA;AAAA,IACA,CAAC,UAAU,OAAA,EAAS,gBAAA,EAAkB,UAAU,WAAA,EAAa,QAAA,EAAU,QAAQ,WAAW;AAAA,GAC5F;AAEA,EAAA,MAAM,KAAA,GAA0B,OAAA;AAAA,IAC9B,OAAO;AAAA,MACL,QAAA;AAAA,MACA,OAAA;AAAA,MACA,gBAAA;AAAA,MACA,QAAA;AAAA,MACA,IAAA,EAAM,QAAA;AAAA,MACN,IAAA,EAAM,IAAA;AAAA,MACN,MAAA,EAAQ;AAAA,KACV,CAAA;AAAA,IACA,CAAC,QAAA,EAAU,OAAA,EAAS,gBAAA,EAAkB,UAAU,WAAW;AAAA,GAC7D;AAEA,EAAA,MAAM,SAAA,GAAY,QAAQ,MAAM,IAAI,gBAAgB,MAAM,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAErE,EAAA,uBACE,GAAA,CAAC,gBAAA,CAAiB,QAAA,EAAjB,EAA0B,KAAA,EAAO,SAAA,EAChC,QAAA,kBAAA,GAAA,CAAC,WAAA,CAAY,QAAA,EAAZ,EAAqB,KAAA,EAAe,QAAA,EAAS,CAAA,EAChD,CAAA;AAEJ;AAIO,SAAS,OAAA,GAA4B;AAC1C,EAAA,MAAM,OAAA,GAAU,WAAW,WAAW,CAAA;AACtC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,MAAM,oEAAoE,CAAA;AAAA,EACtF;AACA,EAAA,OAAO,OAAA;AACT;AAEO,SAAS,WAAA,GAA6B;AAC3C,EAAA,MAAM,UAAU,OAAA,EAAQ;AACxB,EAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,MAAA,IAAU,CAAC,QAAQ,IAAA,EAAM;AAC5C,IAAA,MAAM,IAAI,MAAM,kDAAkD,CAAA;AAAA,EACpE;AACA,EAAA,OAAO,OAAA,CAAQ,IAAA;AACjB;AAEO,SAAS,aAAA,GAAiC;AAC/C,EAAA,MAAM,UAAU,OAAA,EAAQ;AACxB,EAAA,IAAI,OAAA,CAAQ,IAAA,KAAS,QAAA,IAAY,CAAC,QAAQ,MAAA,EAAQ;AAChD,IAAA,MAAM,IAAI,MAAM,sDAAsD,CAAA;AAAA,EACxE;AACA,EAAA,OAAO,OAAA,CAAQ,MAAA;AACjB;;;;"}
+{"version":3,"file":"RoomProvider.js","sources":["../../../src/context/RoomProvider.tsx"],"sourcesContent":["/**\n * RoomProvider - SDK Room Context\n *\n * Foundation context that all other SDK hooks depend on.\n * Provides room state (players, roomCode, leaderId) for both host and player sides.\n *\n * Also provides a Transport abstraction via TransportContext.\n * - HostRoomProvider / PlayerRoomProvider create a DirectTransport from the socket.\n * - IframeRoomProvider (external) provides a PostMessageTransport.\n *\n * Usage:\n * - Host: <HostRoomProvider roomCode={...} players={...} leaderId={...} socket={...}>\n * - Player: <PlayerRoomProvider roomCode={...} players={...} leaderId={...} myIndex={...} isLeader={...} socket={...} isConnected={...}>\n */\n\nimport React, { createContext, useContext, useMemo } from 'react';\nimport type { Player } from '@smoregg/shared';\nimport type { Socket } from 'socket.io-client';\nimport type { Transport } from '../transport/types';\nimport { DirectTransport } from '../transport/DirectTransport';\n\n// ===== Transport Context =====\n\nconst TransportContext = createContext<Transport | null>(null);\n\nexport function useTransport(): Transport {\n  const transport = useContext(TransportContext);\n  if (!transport) {\n    throw new Error('useTransport must be used within a RoomProvider that supplies a Transport');\n  }\n  return transport;\n}\n\nexport { TransportContext };\n\n// ===== State Types =====\n\nexport interface RoomState {\n  roomCode: string;\n  players: Player[];\n  connectedPlayers: Player[];\n  leaderId: string | null;\n}\n\nexport interface HostRoomState extends RoomState {\n  socket: Socket;\n}\n\nexport interface PlayerRoomState extends RoomState {\n  myIndex: number;\n  isLeader: boolean;\n  socket: Socket;\n  isConnected: boolean;\n}\n\nexport interface RoomContextValue {\n  roomCode: string;\n  players: Player[];\n  connectedPlayers: Player[];\n  leaderId: string | null;\n  side: 'host' | 'player';\n  host: HostRoomState | null;\n  player: PlayerRoomState | null;\n}\n\n// ===== Context =====\n\nexport const RoomContext = createContext<RoomContextValue | null>(null);\n\n// ===== Host Provider =====\n\ninterface HostRoomProviderProps {\n  roomCode: string;\n  players: Player[];\n  leaderId: string | null;\n  socket: Socket;\n  children: React.ReactNode;\n}\n\nexport const HostRoomProvider: React.FC<HostRoomProviderProps> = ({\n  roomCode,\n  players,\n  leaderId,\n  socket,\n  children,\n}) => {\n  const connectedPlayers = useMemo(\n    () => players.filter((p) => p.connected !== false),\n    [players]\n  );\n\n  const hostState: HostRoomState = useMemo(\n    () => ({ roomCode, players, connectedPlayers, leaderId, socket }),\n    [roomCode, players, connectedPlayers, leaderId, socket]\n  );\n\n  const value: RoomContextValue = useMemo(\n    () => ({\n      roomCode,\n      players,\n      connectedPlayers,\n      leaderId,\n      side: 'host' as const,\n      host: hostState,\n      player: null,\n    }),\n    [roomCode, players, connectedPlayers, leaderId, hostState]\n  );\n\n  const transport = useMemo(() => new DirectTransport(socket), [socket]);\n\n  return (\n    <TransportContext.Provider value={transport}>\n      <RoomContext.Provider value={value}>{children}</RoomContext.Provider>\n    </TransportContext.Provider>\n  );\n};\n\n// ===== Player Provider =====\n\ninterface PlayerRoomProviderProps {\n  roomCode: string;\n  players: Player[];\n  leaderId: string | null;\n  myIndex: number;\n  isLeader: boolean;\n  socket: Socket;\n  isConnected: boolean;\n  children: React.ReactNode;\n}\n\nexport const PlayerRoomProvider: React.FC<PlayerRoomProviderProps> = ({\n  roomCode,\n  players,\n  leaderId,\n  myIndex,\n  isLeader,\n  socket,\n  isConnected,\n  children,\n}) => {\n  const connectedPlayers = useMemo(\n    () => players.filter((p) => p.connected !== false),\n    [players]\n  );\n\n  const playerState: PlayerRoomState = useMemo(\n    () => ({\n      roomCode,\n      players,\n      connectedPlayers,\n      leaderId,\n      myIndex,\n      isLeader,\n      socket,\n      isConnected,\n    }),\n    [roomCode, players, connectedPlayers, leaderId, myIndex, isLeader, socket, isConnected]\n  );\n\n  const value: RoomContextValue = useMemo(\n    () => ({\n      roomCode,\n      players,\n      connectedPlayers,\n      leaderId,\n      side: 'player' as const,\n      host: null,\n      player: playerState,\n    }),\n    [roomCode, players, connectedPlayers, leaderId, playerState]\n  );\n\n  const transport = useMemo(() => new DirectTransport(socket), [socket]);\n\n  return (\n    <TransportContext.Provider value={transport}>\n      <RoomContext.Provider value={value}>{children}</RoomContext.Provider>\n    </TransportContext.Provider>\n  );\n};\n\n// ===== Hooks =====\n\nexport function useRoom(): RoomContextValue {\n  const context = useContext(RoomContext);\n  if (!context) {\n    throw new Error('useRoom must be used within HostRoomProvider or PlayerRoomProvider');\n  }\n  return context;\n}\n\nexport function useHostRoom(): HostRoomState {\n  const context = useRoom();\n  if (context.side !== 'host' || !context.host) {\n    throw new Error('useHostRoom must be used within HostRoomProvider');\n  }\n  return context.host;\n}\n\nexport function usePlayerRoom(): PlayerRoomState {\n  const context = useRoom();\n  if (context.side !== 'player' || !context.player) {\n    throw new Error('usePlayerRoom must be used within PlayerRoomProvider');\n  }\n  return context.player;\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/hooks/useGameHost.js

@@ -1,5 +1,6 @@
-import { useRef, useEffect, useCallback } from 'react';
+import { useState, useRef, useEffect, useCallback, useMemo } from 'react';
 import { useHostRoom, useTransport } from '../context/RoomProvider.js';
+import { createConnectionMonitor } from '../utils/connectionMonitor.js';
 
 const SYSTEM_PREFIX = "smore:";
 const SYSTEM_EVENTS = {
@@ -9,7 +10,8 @@ const SYSTEM_EVENTS = {
   GAME_OVER: `${SYSTEM_PREFIX}game-over`,
   RETURN_TO_LOBBY: `${SYSTEM_PREFIX}return-to-lobby`,
   SEND_TO_PLAYER: `${SYSTEM_PREFIX}send-to-player`,
-  BROADCAST: `${SYSTEM_PREFIX}broadcast`
+  BROADCAST: `${SYSTEM_PREFIX}broadcast`,
+  CUSTOM_STATE_CHANGE: `${SYSTEM_PREFIX}custom-state-change`
 };
 const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
 function validateEventName(event) {
@@ -22,13 +24,17 @@ function validateEventName(event) {
   }
 }
 function useGameHost(config = {}) {
-  const { onReady, onPlayerJoin, onPlayerLeave, listeners } = config;
+  const { onReady, onPlayerJoin, onPlayerLeave, listeners, connectionMonitor, onCustomStateChange } = config;
   const hostRoom = useHostRoom();
   const transport = useTransport();
+  const [isPaused, setIsPaused] = useState(false);
+  const [latency, setLatency] = useState(0);
+  const monitorRef = useRef(null);
   const onReadyRef = useRef(onReady);
   const onPlayerJoinRef = useRef(onPlayerJoin);
   const onPlayerLeaveRef = useRef(onPlayerLeave);
   const listenersRef = useRef(listeners);
+  const onCustomStateChangeRef = useRef(onCustomStateChange);
   useEffect(() => {
     onReadyRef.current = onReady;
   }, [onReady]);
@@ -41,32 +47,82 @@ function useGameHost(config = {}) {
   useEffect(() => {
     listenersRef.current = listeners;
   }, [listeners]);
+  useEffect(() => {
+    onCustomStateChangeRef.current = onCustomStateChange;
+  }, [onCustomStateChange]);
+  useEffect(() => {
+    if (!connectionMonitor?.enabled || !transport) return;
+    const socket = transport.socket;
+    if (!socket) {
+      console.warn("[useGameHost] Connection monitor requires Socket.IO transport");
+      return;
+    }
+    const monitor = createConnectionMonitor(socket, {
+      onPause: () => {
+        setIsPaused(true);
+        connectionMonitor.onPause();
+      },
+      onResume: () => {
+        setIsPaused(false);
+        connectionMonitor.onResume();
+      },
+      onCountdown: connectionMonitor.onCountdown,
+      latencyThreshold: connectionMonitor.latencyThreshold,
+      resumeCountdown: connectionMonitor.resumeCountdown
+    });
+    monitorRef.current = monitor;
+    const latencyInterval = setInterval(() => {
+      setLatency(monitor.getLatency());
+    }, 1e3);
+    return () => {
+      monitor.destroy();
+      clearInterval(latencyInterval);
+      monitorRef.current = null;
+    };
+  }, [connectionMonitor, transport]);
   useEffect(() => {
     if (!transport) return;
     const handleReady = () => {
       onReadyRef.current?.();
     };
     const handlePlayerJoin = (data) => {
-      onPlayerJoinRef.current?.(data.player);
+      const playerIndex = data.player?.playerIndex;
+      if (playerIndex !== void 0) {
+        onPlayerJoinRef.current?.(playerIndex);
+      }
     };
     const handlePlayerLeave = (data) => {
-      onPlayerLeaveRef.current?.(data.sessionId);
+      const playerIndex = data.playerIndex;
+      if (playerIndex !== void 0) {
+        onPlayerLeaveRef.current?.(playerIndex);
+      }
+    };
+    const handleCustomStateChange = (data) => {
+      if (data.playerIndex !== void 0) {
+        onCustomStateChangeRef.current?.(data.playerIndex, data.state);
+      }
     };
     transport.on(SYSTEM_EVENTS.READY, handleReady);
     transport.on(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);
     transport.on(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);
+    transport.on(SYSTEM_EVENTS.CUSTOM_STATE_CHANGE, handleCustomStateChange);
     transport.on("room:player-left", (data) => {
-      onPlayerLeaveRef.current?.(data?.sessionId ?? data?.playerId);
+      const playerIndex = data?.playerIndex ?? data?.player?.playerIndex;
+      if (playerIndex !== void 0) {
+        onPlayerLeaveRef.current?.(playerIndex);
+      }
     });
     transport.on("room:player-joined", (data) => {
-      if (data?.player) {
-        onPlayerJoinRef.current?.(data.player);
+      const playerIndex = data?.player?.playerIndex;
+      if (playerIndex !== void 0) {
+        onPlayerJoinRef.current?.(playerIndex);
       }
     });
     return () => {
       transport.off(SYSTEM_EVENTS.READY, handleReady);
       transport.off(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);
       transport.off(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);
+      transport.off(SYSTEM_EVENTS.CUSTOM_STATE_CHANGE, handleCustomStateChange);
       transport.off("room:player-left");
       transport.off("room:player-joined");
     };
@@ -79,8 +135,10 @@ function useGameHost(config = {}) {
       if (!handler) continue;
       validateEventName(event);
       const wrappedHandler = (data) => {
-        const { sessionId, ...rest } = data;
-        handler(sessionId, rest);
+        const { playerIndex, ...rest } = data;
+        if (playerIndex !== void 0) {
+          handler(playerIndex, rest);
+        }
       };
       transport.on(event, wrappedHandler);
       cleanups.push(() => transport.off(event, wrappedHandler));
@@ -97,10 +155,10 @@ function useGameHost(config = {}) {
     [transport]
   );
   const sendToPlayer = useCallback(
-    (sessionId, event, data) => {
+    (playerIndex, event, data) => {
       validateEventName(event);
       transport?.emit(SYSTEM_EVENTS.SEND_TO_PLAYER, {
-        targetSessionId: sessionId,
+        targetPlayerIndex: playerIndex,
         event,
         data
       });
@@ -116,14 +174,29 @@ function useGameHost(config = {}) {
   const returnToLobby = useCallback(() => {
     transport?.emit(SYSTEM_EVENTS.RETURN_TO_LOBBY, {});
   }, [transport]);
+  const setCustomState = useCallback(
+    (state) => {
+      transport?.emit(SYSTEM_EVENTS.CUSTOM_STATE_CHANGE, { state });
+    },
+    [transport]
+  );
+  const leaderIndex = useMemo(() => {
+    if ("leaderIndex" in hostRoom && typeof hostRoom.leaderIndex === "number") {
+      return hostRoom.leaderIndex;
+    }
+    return -1;
+  }, [hostRoom]);
   return {
     players: hostRoom.players,
-    leaderId: hostRoom.leaderId,
+    leaderIndex,
     roomCode: hostRoom.roomCode,
     emit,
     sendToPlayer,
     gameOver,
-    returnToLobby
+    returnToLobby,
+    setCustomState,
+    isPaused,
+    latency
   };
 }