@smoregg/sdk 0.4.0 → 0.4.1

package/dist/cjs/hooks/useGameHost.cjs

@@ -13,10 +13,13 @@ const SYSTEM_EVENTS = {
   SEND_TO_PLAYER: `${SYSTEM_PREFIX}send-to-player`,
   BROADCAST: `${SYSTEM_PREFIX}broadcast`
 };
+const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
 function validateEventName(event) {
-  if (event.includes(":")) {
+  if (!EVENT_NAME_REGEX.test(event)) {
     throw new Error(
-      `[SDK] Invalid event name "${event}". Event names must not contain colons (:). Use underscores (_) or hyphens (-) instead.`
+      `[SDK] 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 _)`
     );
   }
 }
@@ -49,7 +52,7 @@ function useGameHost(config = {}) {
       onPlayerJoinRef.current?.(data.player);
     };
     const handlePlayerLeave = (data) => {
-      onPlayerLeaveRef.current?.(data.playerId);
+      onPlayerLeaveRef.current?.(data.sessionId);
     };
     transport.on(SYSTEM_EVENTS.READY, handleReady);
     transport.on(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);
@@ -78,7 +81,8 @@ function useGameHost(config = {}) {
       if (!handler) continue;
       validateEventName(event);
       const wrappedHandler = (data) => {
-        handler(data.playerId, data.payload);
+        const { sessionId, ...rest } = data;
+        handler(sessionId, rest);
       };
       transport.on(event, wrappedHandler);
       cleanups.push(() => transport.off(event, wrappedHandler));
@@ -95,10 +99,10 @@ function useGameHost(config = {}) {
     [transport]
   );
   const sendToPlayer = react.useCallback(
-    (playerId, event, data) => {
+    (sessionId, event, data) => {
       validateEventName(event);
       transport?.emit(SYSTEM_EVENTS.SEND_TO_PLAYER, {
-        targetPlayerId: playerId,
+        targetSessionId: sessionId,
         event,
         data
       });

package/dist/cjs/hooks/useGameHost.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useGameHost.cjs","sources":["../../../src/hooks/useGameHost.ts"],"sourcesContent":["/**\n * useGameHost - Host-side game hook for the S'MORE SDK\n *\n * Provides host game developers with:\n * - Room state access (players, leaderId, roomCode)\n * - Event listeners for player inputs\n * - Broadcasting to all/specific players\n * - Game lifecycle management\n *\n * Internally uses Transport abstraction so the same API works over\n * Socket.IO (bundled games) or postMessage (iframe games).\n */\nimport { useEffect, useCallback, useRef } from 'react';\nimport { useHostRoom, useTransport } from '../context/RoomProvider';\nimport type { Player } from '../types';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst SYSTEM_PREFIX = 'smore:';\n\n// System events (internal use only)\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  RETURN_TO_LOBBY: `${SYSTEM_PREFIX}return-to-lobby`,\n  SEND_TO_PLAYER: `${SYSTEM_PREFIX}send-to-player`,\n  BROADCAST: `${SYSTEM_PREFIX}broadcast`,\n} as const;\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\n/**\n * Validates that an event name doesn't contain colons.\n * Colons are reserved for system prefix separation.\n * Underscores and hyphens are allowed.\n */\nfunction validateEventName(event: string): void {\n  if (event.includes(':')) {\n    throw new Error(\n      `[SDK] Invalid event name \"${event}\". Event names must not contain colons (:). ` +\n      `Use underscores (_) or hyphens (-) instead.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface UseGameHostConfig<T extends Record<string, any> = Record<string, any>> {\n  /** Called when the host is ready and connected. */\n  onReady?: () => void;\n\n  /** Called when a player joins the room. */\n  onPlayerJoin?: (player: Player) => void;\n\n  /** Called when a player leaves the room. */\n  onPlayerLeave?: (playerId: string) => void;\n\n  /**\n   * Event listeners for player inputs.\n   * Keys are event names (without prefix), values are handler functions.\n   * Handler receives (playerId, data) where data is the payload from player.\n   */\n  listeners?: { [K in keyof T]?: (playerId: string, data: T[K]) => void };\n}\n\nexport interface UseGameHostReturn {\n  /** List of all players in the room. */\n  players: Player[];\n\n  /** The session ID of the room leader (host). */\n  leaderId: string | null;\n\n  /** The room code. */\n  roomCode: string;\n\n  /**\n   * Emit an event to all players.\n   * Event name must not contain colons.\n   */\n  emit: (event: string, data?: any) => void;\n\n  /**\n   * Send an event to a specific player.\n   * Event name must not contain colons.\n   */\n  sendToPlayer: (playerId: string, event: string, data?: any) => void;\n\n  /** Signal game over with optional results. */\n  gameOver: (results?: any) => void;\n\n  /** Return all players to lobby. */\n  returnToLobby: () => void;\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useGameHost<T extends Record<string, any> = Record<string, any>>(\n  config: UseGameHostConfig<T> = {}\n): UseGameHostReturn {\n  const { onReady, onPlayerJoin, onPlayerLeave, listeners } = config;\n\n  const hostRoom = useHostRoom();\n  const transport = useTransport();\n\n  // Stable refs to avoid stale closures in listeners\n  const onReadyRef = useRef(onReady);\n  const onPlayerJoinRef = useRef(onPlayerJoin);\n  const onPlayerLeaveRef = useRef(onPlayerLeave);\n  const listenersRef = useRef(listeners);\n\n  useEffect(() => {\n    onReadyRef.current = onReady;\n  }, [onReady]);\n  useEffect(() => {\n    onPlayerJoinRef.current = onPlayerJoin;\n  }, [onPlayerJoin]);\n  useEffect(() => {\n    onPlayerLeaveRef.current = onPlayerLeave;\n  }, [onPlayerLeave]);\n  useEffect(() => {\n    listenersRef.current = listeners;\n  }, [listeners]);\n\n  // -------------------------------------------------------------------------\n  // System event listeners (player lifecycle)\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport) return;\n\n    const handleReady = () => {\n      onReadyRef.current?.();\n    };\n\n    const handlePlayerJoin = (data: { player: Player }) => {\n      onPlayerJoinRef.current?.(data.player);\n    };\n\n    const handlePlayerLeave = (data: { playerId: string }) => {\n      onPlayerLeaveRef.current?.(data.playerId);\n    };\n\n    transport.on(SYSTEM_EVENTS.READY, handleReady);\n    transport.on(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);\n    transport.on(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);\n\n    // Also listen to legacy room events for backward compatibility\n    transport.on('room:player-left', (data: any) => {\n      onPlayerLeaveRef.current?.(data?.sessionId ?? data?.playerId);\n    });\n    transport.on('room:player-joined', (data: any) => {\n      if (data?.player) {\n        onPlayerJoinRef.current?.(data.player);\n      }\n    });\n\n    return () => {\n      transport.off(SYSTEM_EVENTS.READY, handleReady);\n      transport.off(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);\n      transport.off(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);\n      transport.off('room:player-left');\n      transport.off('room:player-joined');\n    };\n  }, [transport]);\n\n  // -------------------------------------------------------------------------\n  // User event listeners\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport || !listeners) return;\n\n    const entries = Object.entries(listeners);\n    const cleanups: (() => void)[] = [];\n\n    for (const [event, handler] of entries) {\n      if (!handler) continue;\n\n      // Validate event name (no colons allowed)\n      validateEventName(event);\n\n      // Listen for the event directly (no wrapping)\n      const wrappedHandler = (data: { playerId: string; payload: any }) => {\n        (handler as (playerId: string, data: any) => void)(data.playerId, data.payload);\n      };\n\n      transport.on(event, wrappedHandler);\n      cleanups.push(() => transport.off(event, wrappedHandler));\n    }\n\n    return () => {\n      cleanups.forEach((cleanup) => cleanup());\n    };\n  }, [transport, listeners]);\n\n  // -------------------------------------------------------------------------\n  // Actions\n  // -------------------------------------------------------------------------\n\n  const emit = useCallback(\n    (event: string, data?: any) => {\n      validateEventName(event);\n      // Broadcast to all players via system event\n      transport?.emit(SYSTEM_EVENTS.BROADCAST, { event, data });\n    },\n    [transport]\n  );\n\n  const sendToPlayer = useCallback(\n    (playerId: string, event: string, data?: any) => {\n      validateEventName(event);\n      // Send to specific player via system event\n      // The server will unwrap and send the inner event directly to the player\n      transport?.emit(SYSTEM_EVENTS.SEND_TO_PLAYER, {\n        targetPlayerId: playerId,\n        event,\n        data,\n      });\n    },\n    [transport]\n  );\n\n  const gameOver = useCallback(\n    (results?: any) => {\n      transport?.emit(SYSTEM_EVENTS.GAME_OVER, { results });\n    },\n    [transport]\n  );\n\n  const returnToLobby = useCallback(() => {\n    transport?.emit(SYSTEM_EVENTS.RETURN_TO_LOBBY, {});\n  }, [transport]);\n\n  return {\n    players: hostRoom.players,\n    leaderId: hostRoom.leaderId,\n    roomCode: hostRoom.roomCode,\n    emit,\n    sendToPlayer,\n    gameOver,\n    returnToLobby,\n  };\n}\n"],"names":["useHostRoom","useTransport","useRef","useEffect","useCallback"],"mappings":"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"}
+{"version":3,"file":"useGameHost.cjs","sources":["../../../src/hooks/useGameHost.ts"],"sourcesContent":["/**\n * useGameHost - Host-side game hook for the S'MORE SDK\n *\n * Provides host game developers with:\n * - Room state access (players, leaderId, roomCode)\n * - Event listeners for player inputs\n * - Broadcasting to all/specific players\n * - Game lifecycle management\n *\n * Internally uses Transport abstraction so the same API works over\n * Socket.IO (bundled games) or postMessage (iframe games).\n */\nimport { useEffect, useCallback, useRef } from 'react';\nimport { useHostRoom, useTransport } from '../context/RoomProvider';\nimport type { Player } from '../types';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst SYSTEM_PREFIX = 'smore:';\n\n// System events (internal use only)\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  RETURN_TO_LOBBY: `${SYSTEM_PREFIX}return-to-lobby`,\n  SEND_TO_PLAYER: `${SYSTEM_PREFIX}send-to-player`,\n  BROADCAST: `${SYSTEM_PREFIX}broadcast`,\n} as const;\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\n/**\n * Validates event name format.\n * Rules:\n * - Only English letters (a-z, A-Z), hyphens (-), and underscores (_) allowed\n * - Must start and end with a letter (no leading/trailing - or _)\n * - Colons are reserved for system prefix\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      `[SDK] 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\nexport interface UseGameHostConfig<T extends Record<string, any> = Record<string, any>> {\n  /** Called when the host is ready and connected. */\n  onReady?: () => void;\n\n  /** Called when a player joins the room. */\n  onPlayerJoin?: (player: Player) => void;\n\n  /** Called when a player leaves the room. */\n  onPlayerLeave?: (sessionId: string) => void;\n\n  /**\n   * Event listeners for player inputs.\n   * Keys are event names (without prefix), values are handler functions.\n   * Handler receives (sessionId, data) where sessionId identifies the player.\n   */\n  listeners?: { [K in keyof T]?: (sessionId: string, data: T[K]) => void };\n}\n\nexport interface UseGameHostReturn {\n  /** List of all players in the room. */\n  players: Player[];\n\n  /** The session ID of the room leader (host). */\n  leaderId: string | null;\n\n  /** The room code. */\n  roomCode: string;\n\n  /**\n   * Emit an event to all players.\n   * Event name must not contain colons.\n   */\n  emit: (event: string, data?: any) => void;\n\n  /**\n   * Send an event to a specific player.\n   * Event name must not contain colons.\n   */\n  sendToPlayer: (sessionId: string, event: string, data?: any) => void;\n\n  /** Signal game over with optional results. */\n  gameOver: (results?: any) => void;\n\n  /** Return all players to lobby. */\n  returnToLobby: () => void;\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useGameHost<T extends Record<string, any> = Record<string, any>>(\n  config: UseGameHostConfig<T> = {}\n): UseGameHostReturn {\n  const { onReady, onPlayerJoin, onPlayerLeave, listeners } = config;\n\n  const hostRoom = useHostRoom();\n  const transport = useTransport();\n\n  // Stable refs to avoid stale closures in listeners\n  const onReadyRef = useRef(onReady);\n  const onPlayerJoinRef = useRef(onPlayerJoin);\n  const onPlayerLeaveRef = useRef(onPlayerLeave);\n  const listenersRef = useRef(listeners);\n\n  useEffect(() => {\n    onReadyRef.current = onReady;\n  }, [onReady]);\n  useEffect(() => {\n    onPlayerJoinRef.current = onPlayerJoin;\n  }, [onPlayerJoin]);\n  useEffect(() => {\n    onPlayerLeaveRef.current = onPlayerLeave;\n  }, [onPlayerLeave]);\n  useEffect(() => {\n    listenersRef.current = listeners;\n  }, [listeners]);\n\n  // -------------------------------------------------------------------------\n  // System event listeners (player lifecycle)\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport) return;\n\n    const handleReady = () => {\n      onReadyRef.current?.();\n    };\n\n    const handlePlayerJoin = (data: { player: Player }) => {\n      onPlayerJoinRef.current?.(data.player);\n    };\n\n    const handlePlayerLeave = (data: { sessionId: string }) => {\n      onPlayerLeaveRef.current?.(data.sessionId);\n    };\n\n    transport.on(SYSTEM_EVENTS.READY, handleReady);\n    transport.on(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);\n    transport.on(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);\n\n    // Also listen to legacy room events for backward compatibility\n    transport.on('room:player-left', (data: any) => {\n      onPlayerLeaveRef.current?.(data?.sessionId ?? data?.playerId);\n    });\n    transport.on('room:player-joined', (data: any) => {\n      if (data?.player) {\n        onPlayerJoinRef.current?.(data.player);\n      }\n    });\n\n    return () => {\n      transport.off(SYSTEM_EVENTS.READY, handleReady);\n      transport.off(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);\n      transport.off(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);\n      transport.off('room:player-left');\n      transport.off('room:player-joined');\n    };\n  }, [transport]);\n\n  // -------------------------------------------------------------------------\n  // User event listeners\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport || !listeners) return;\n\n    const entries = Object.entries(listeners);\n    const cleanups: (() => void)[] = [];\n\n    for (const [event, handler] of entries) {\n      if (!handler) continue;\n\n      // Validate event name (no colons allowed)\n      validateEventName(event);\n\n      // Listen for the event directly\n      // Server sends: { sessionId, ...playerData }\n      const wrappedHandler = (data: { sessionId: string; [key: string]: any }) => {\n        const { sessionId, ...rest } = data;\n        (handler as (sessionId: string, data: any) => void)(sessionId, rest);\n      };\n\n      transport.on(event, wrappedHandler);\n      cleanups.push(() => transport.off(event, wrappedHandler));\n    }\n\n    return () => {\n      cleanups.forEach((cleanup) => cleanup());\n    };\n  }, [transport, listeners]);\n\n  // -------------------------------------------------------------------------\n  // Actions\n  // -------------------------------------------------------------------------\n\n  const emit = useCallback(\n    (event: string, data?: any) => {\n      validateEventName(event);\n      // Broadcast to all players via system event\n      transport?.emit(SYSTEM_EVENTS.BROADCAST, { event, data });\n    },\n    [transport]\n  );\n\n  const sendToPlayer = useCallback(\n    (sessionId: string, event: string, data?: any) => {\n      validateEventName(event);\n      // Send to specific player via system event\n      // The server will unwrap and send the inner event directly to the player\n      transport?.emit(SYSTEM_EVENTS.SEND_TO_PLAYER, {\n        targetSessionId: sessionId,\n        event,\n        data,\n      });\n    },\n    [transport]\n  );\n\n  const gameOver = useCallback(\n    (results?: any) => {\n      transport?.emit(SYSTEM_EVENTS.GAME_OVER, { results });\n    },\n    [transport]\n  );\n\n  const returnToLobby = useCallback(() => {\n    transport?.emit(SYSTEM_EVENTS.RETURN_TO_LOBBY, {});\n  }, [transport]);\n\n  return {\n    players: hostRoom.players,\n    leaderId: hostRoom.leaderId,\n    roomCode: hostRoom.roomCode,\n    emit,\n    sendToPlayer,\n    gameOver,\n    returnToLobby,\n  };\n}\n"],"names":["useHostRoom","useTransport","useRef","useEffect","useCallback"],"mappings":"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"}

package/dist/cjs/hooks/useGamePlayer.cjs

@@ -3,10 +3,13 @@
 var react = require('react');
 var RoomProvider = require('../context/RoomProvider.cjs');
 
+const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
 function validateEventName(event) {
-  if (event.includes(":")) {
+  if (!EVENT_NAME_REGEX.test(event)) {
     throw new Error(
-      `[SDK] Invalid event name "${event}". Event names must not contain ':' (reserved for system prefixes). Use '_' or '-' instead.`
+      `[SDK] 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 _)`
     );
   }
 }
@@ -31,7 +34,7 @@ function useGamePlayer(config = {}) {
       onPlayerJoinRef.current?.(player);
     };
     const handlePlayerLeave = (data) => {
-      onPlayerLeaveRef.current?.(data.playerId);
+      onPlayerLeaveRef.current?.(data.sessionId);
     };
     transport.on("smore:ready", handleReady);
     transport.on("smore:player-join", handlePlayerJoin);
@@ -65,7 +68,7 @@ function useGamePlayer(config = {}) {
     players: room.players,
     leaderId: room.leaderId,
     roomCode: room.roomCode,
-    myPlayerId: room.mySessionId,
+    mySessionId: room.mySessionId,
     isLeader: room.isLeader,
     emit
   };

package/dist/cjs/hooks/useGamePlayer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useGamePlayer.cjs","sources":["../../../src/hooks/useGamePlayer.ts"],"sourcesContent":["import { useEffect, useCallback, useRef } from 'react';\nimport { usePlayerRoom } from '../context/RoomProvider';\nimport { useTransport } from '../context/RoomProvider';\nimport type { Player } from '@smoregg/shared';\n\n/**\n * Validate event name for emit\n * - Must NOT contain `:` (colon is reserved for system prefixes)\n * - `_` and `-` are allowed\n */\nfunction validateEventName(event: string): void {\n  if (event.includes(':')) {\n    throw new Error(\n      `[SDK] Invalid event name \"${event}\". Event names must not contain ':' (reserved for system prefixes). Use '_' or '-' instead.`\n    );\n  }\n}\n\n// ===== Types =====\n\nexport interface UseGamePlayerConfig<T = Record<string, any>> {\n  /** Called when smore:ready is received */\n  onReady?: () => void;\n  /** Called when a player joins */\n  onPlayerJoin?: (player: Player) => void;\n  /** Called when a player leaves */\n  onPlayerLeave?: (playerId: string) => void;\n  /** Custom event listeners (event name -> handler) */\n  listeners?: { [K in keyof T]?: (data: T[K]) => void };\n}\n\nexport interface UseGamePlayerReturn {\n  /** All players in the room */\n  players: Player[];\n  /** Leader player's session ID */\n  leaderId: string | null;\n  /** Room code */\n  roomCode: string;\n  /** My session ID */\n  myPlayerId: string;\n  /** Am I the leader? */\n  isLeader: boolean;\n  /** Emit event to host (event name must not contain ':') */\n  emit: (event: string, data?: any) => void;\n}\n\n// ===== Hook =====\n\nexport function useGamePlayer<T = Record<string, any>>(\n  config: UseGamePlayerConfig<T> = {}\n): UseGamePlayerReturn {\n  const room = usePlayerRoom();\n  const transport = useTransport();\n  const { onReady, onPlayerJoin, onPlayerLeave, listeners } = config;\n\n  // Use refs to avoid re-subscribing on every render\n  const onReadyRef = useRef(onReady);\n  const onPlayerJoinRef = useRef(onPlayerJoin);\n  const onPlayerLeaveRef = useRef(onPlayerLeave);\n  const listenersRef = useRef(listeners);\n\n  onReadyRef.current = onReady;\n  onPlayerJoinRef.current = onPlayerJoin;\n  onPlayerLeaveRef.current = onPlayerLeave;\n  listenersRef.current = listeners;\n\n  // System event listeners (smore: prefix)\n  useEffect(() => {\n    if (!transport) return;\n\n    const handleReady = () => {\n      onReadyRef.current?.();\n    };\n\n    const handlePlayerJoin = (player: Player) => {\n      onPlayerJoinRef.current?.(player);\n    };\n\n    const handlePlayerLeave = (data: { playerId: string }) => {\n      onPlayerLeaveRef.current?.(data.playerId);\n    };\n\n    transport.on('smore:ready', handleReady);\n    transport.on('smore:player-join', handlePlayerJoin);\n    transport.on('smore:player-leave', handlePlayerLeave);\n\n    return () => {\n      transport.off('smore:ready', handleReady);\n      transport.off('smore:player-join', handlePlayerJoin);\n      transport.off('smore:player-leave', handlePlayerLeave);\n    };\n  }, [transport]);\n\n  // User event listeners (passed through directly, no wrapping)\n  useEffect(() => {\n    if (!transport || !listenersRef.current) return;\n\n    const cleanups: (() => void)[] = [];\n\n    Object.entries(listenersRef.current).forEach(([event, handler]) => {\n      if (handler) {\n        transport.on(event, handler as (data: any) => void);\n        cleanups.push(() => transport.off(event, handler as (data: any) => void));\n      }\n    });\n\n    return () => cleanups.forEach((fn) => fn());\n  }, [transport, listeners]);\n\n  // Emit function with validation\n  const emit = useCallback(\n    (event: string, data?: any) => {\n      if (!transport) return;\n      validateEventName(event);\n      transport.emit(event, data);\n    },\n    [transport]\n  );\n\n  return {\n    players: room.players,\n    leaderId: room.leaderId,\n    roomCode: room.roomCode,\n    myPlayerId: room.mySessionId,\n    isLeader: room.isLeader,\n    emit,\n  };\n}\n"],"names":["usePlayerRoom","useTransport","useRef","useEffect","useCallback"],"mappings":"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"}
+{"version":3,"file":"useGamePlayer.cjs","sources":["../../../src/hooks/useGamePlayer.ts"],"sourcesContent":["import { useEffect, useCallback, useRef } from 'react';\nimport { usePlayerRoom } from '../context/RoomProvider';\nimport { useTransport } from '../context/RoomProvider';\nimport type { Player } from '@smoregg/shared';\n\n/**\n * Validates event name format.\n * Rules:\n * - Only English letters (a-z, A-Z), hyphens (-), and underscores (_) allowed\n * - Must start and end with a letter (no leading/trailing - or _)\n * - Colons are reserved for system prefix\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      `[SDK] 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// ===== Types =====\n\nexport interface UseGamePlayerConfig<T = Record<string, any>> {\n  /** Called when smore:ready is received */\n  onReady?: () => void;\n  /** Called when a player joins */\n  onPlayerJoin?: (player: Player) => void;\n  /** Called when a player leaves */\n  onPlayerLeave?: (sessionId: string) => void;\n  /** Custom event listeners (event name -> handler) */\n  listeners?: { [K in keyof T]?: (data: T[K]) => void };\n}\n\nexport interface UseGamePlayerReturn {\n  /** All players in the room */\n  players: Player[];\n  /** Leader player's session ID */\n  leaderId: string | null;\n  /** Room code */\n  roomCode: string;\n  /** My session ID */\n  mySessionId: string;\n  /** Am I the leader? */\n  isLeader: boolean;\n  /** Emit event to host (event name must not contain ':') */\n  emit: (event: string, data?: any) => void;\n}\n\n// ===== Hook =====\n\nexport function useGamePlayer<T = Record<string, any>>(\n  config: UseGamePlayerConfig<T> = {}\n): UseGamePlayerReturn {\n  const room = usePlayerRoom();\n  const transport = useTransport();\n  const { onReady, onPlayerJoin, onPlayerLeave, listeners } = config;\n\n  // Use refs to avoid re-subscribing on every render\n  const onReadyRef = useRef(onReady);\n  const onPlayerJoinRef = useRef(onPlayerJoin);\n  const onPlayerLeaveRef = useRef(onPlayerLeave);\n  const listenersRef = useRef(listeners);\n\n  onReadyRef.current = onReady;\n  onPlayerJoinRef.current = onPlayerJoin;\n  onPlayerLeaveRef.current = onPlayerLeave;\n  listenersRef.current = listeners;\n\n  // System event listeners (smore: prefix)\n  useEffect(() => {\n    if (!transport) return;\n\n    const handleReady = () => {\n      onReadyRef.current?.();\n    };\n\n    const handlePlayerJoin = (player: Player) => {\n      onPlayerJoinRef.current?.(player);\n    };\n\n    const handlePlayerLeave = (data: { sessionId: string }) => {\n      onPlayerLeaveRef.current?.(data.sessionId);\n    };\n\n    transport.on('smore:ready', handleReady);\n    transport.on('smore:player-join', handlePlayerJoin);\n    transport.on('smore:player-leave', handlePlayerLeave);\n\n    return () => {\n      transport.off('smore:ready', handleReady);\n      transport.off('smore:player-join', handlePlayerJoin);\n      transport.off('smore:player-leave', handlePlayerLeave);\n    };\n  }, [transport]);\n\n  // User event listeners (passed through directly, no wrapping)\n  useEffect(() => {\n    if (!transport || !listenersRef.current) return;\n\n    const cleanups: (() => void)[] = [];\n\n    Object.entries(listenersRef.current).forEach(([event, handler]) => {\n      if (handler) {\n        transport.on(event, handler as (data: any) => void);\n        cleanups.push(() => transport.off(event, handler as (data: any) => void));\n      }\n    });\n\n    return () => cleanups.forEach((fn) => fn());\n  }, [transport, listeners]);\n\n  // Emit function with validation\n  const emit = useCallback(\n    (event: string, data?: any) => {\n      if (!transport) return;\n      validateEventName(event);\n      transport.emit(event, data);\n    },\n    [transport]\n  );\n\n  return {\n    players: room.players,\n    leaderId: room.leaderId,\n    roomCode: room.roomCode,\n    mySessionId: room.mySessionId,\n    isLeader: room.isLeader,\n    emit,\n  };\n}\n"],"names":["usePlayerRoom","useTransport","useRef","useEffect","useCallback"],"mappings":";;;;;AAYA,MAAM,gBAAA,GAAmB,kCAAA;AAEzB,SAAS,kBAAkB,KAAA,EAAqB;AAC9C,EAAA,IAAI,CAAC,gBAAA,CAAiB,IAAA,CAAK,KAAK,CAAA,EAAG;AACjC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,6BAA6B,KAAK,CAAA;AAAA;AAAA,4DAAA;AAAA,KAGpC;AAAA,EACF;AACF;AAgCO,SAAS,aAAA,CACd,MAAA,GAAiC,EAAC,EACb;AACrB,EAAA,MAAM,OAAOA,0BAAA,EAAc;AAC3B,EAAA,MAAM,YAAYC,yBAAA,EAAa;AAC/B,EAAA,MAAM,EAAE,OAAA,EAAS,YAAA,EAAc,aAAA,EAAe,WAAU,GAAI,MAAA;AAG5D,EAAA,MAAM,UAAA,GAAaC,aAAO,OAAO,CAAA;AACjC,EAAA,MAAM,eAAA,GAAkBA,aAAO,YAAY,CAAA;AAC3C,EAAA,MAAM,gBAAA,GAAmBA,aAAO,aAAa,CAAA;AAC7C,EAAA,MAAM,YAAA,GAAeA,aAAO,SAAS,CAAA;AAErC,EAAA,UAAA,CAAW,OAAA,GAAU,OAAA;AACrB,EAAA,eAAA,CAAgB,OAAA,GAAU,YAAA;AAC1B,EAAA,gBAAA,CAAiB,OAAA,GAAU,aAAA;AAC3B,EAAA,YAAA,CAAa,OAAA,GAAU,SAAA;AAGvB,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,SAAA,EAAW;AAEhB,IAAA,MAAM,cAAc,MAAM;AACxB,MAAA,UAAA,CAAW,OAAA,IAAU;AAAA,IACvB,CAAA;AAEA,IAAA,MAAM,gBAAA,GAAmB,CAAC,MAAA,KAAmB;AAC3C,MAAA,eAAA,CAAgB,UAAU,MAAM,CAAA;AAAA,IAClC,CAAA;AAEA,IAAA,MAAM,iBAAA,GAAoB,CAAC,IAAA,KAAgC;AACzD,MAAA,gBAAA,CAAiB,OAAA,GAAU,KAAK,SAAS,CAAA;AAAA,IAC3C,CAAA;AAEA,IAAA,SAAA,CAAU,EAAA,CAAG,eAAe,WAAW,CAAA;AACvC,IAAA,SAAA,CAAU,EAAA,CAAG,qBAAqB,gBAAgB,CAAA;AAClD,IAAA,SAAA,CAAU,EAAA,CAAG,sBAAsB,iBAAiB,CAAA;AAEpD,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,CAAU,GAAA,CAAI,eAAe,WAAW,CAAA;AACxC,MAAA,SAAA,CAAU,GAAA,CAAI,qBAAqB,gBAAgB,CAAA;AACnD,MAAA,SAAA,CAAU,GAAA,CAAI,sBAAsB,iBAAiB,CAAA;AAAA,IACvD,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,SAAS,CAAC,CAAA;AAGd,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,SAAA,IAAa,CAAC,YAAA,CAAa,OAAA,EAAS;AAEzC,IAAA,MAAM,WAA2B,EAAC;AAElC,IAAA,MAAA,CAAO,OAAA,CAAQ,aAAa,OAAO,CAAA,CAAE,QAAQ,CAAC,CAAC,KAAA,EAAO,OAAO,CAAA,KAAM;AACjE,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,SAAA,CAAU,EAAA,CAAG,OAAO,OAA8B,CAAA;AAClD,QAAA,QAAA,CAAS,KAAK,MAAM,SAAA,CAAU,GAAA,CAAI,KAAA,EAAO,OAA8B,CAAC,CAAA;AAAA,MAC1E;AAAA,IACF,CAAC,CAAA;AAED,IAAA,OAAO,MAAM,QAAA,CAAS,OAAA,CAAQ,CAAC,EAAA,KAAO,IAAI,CAAA;AAAA,EAC5C,CAAA,EAAG,CAAC,SAAA,EAAW,SAAS,CAAC,CAAA;AAGzB,EAAA,MAAM,IAAA,GAAOC,iBAAA;AAAA,IACX,CAAC,OAAe,IAAA,KAAe;AAC7B,MAAA,IAAI,CAAC,SAAA,EAAW;AAChB,MAAA,iBAAA,CAAkB,KAAK,CAAA;AACvB,MAAA,SAAA,CAAU,IAAA,CAAK,OAAO,IAAI,CAAA;AAAA,IAC5B,CAAA;AAAA,IACA,CAAC,SAAS;AAAA,GACZ;AAEA,EAAA,OAAO;AAAA,IACL,SAAS,IAAA,CAAK,OAAA;AAAA,IACd,UAAU,IAAA,CAAK,QAAA;AAAA,IACf,UAAU,IAAA,CAAK,QAAA;AAAA,IACf,aAAa,IAAA,CAAK,WAAA;AAAA,IAClB,UAAU,IAAA,CAAK,QAAA;AAAA,IACf;AAAA,GACF;AACF;;;;"}

package/dist/cjs/iframe/index.cjs

@@ -187,10 +187,13 @@ const SYSTEM_EVENTS = {
   SEND_TO_PLAYER: `${SYSTEM_PREFIX}send-to-player`,
   BROADCAST: `${SYSTEM_PREFIX}broadcast`
 };
+const EVENT_NAME_REGEX$2 = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
 function validateEventName$2(event) {
-  if (event.includes(":")) {
+  if (!EVENT_NAME_REGEX$2.test(event)) {
     throw new Error(
-      `[SDK] Invalid event name "${event}". Event names must not contain colons (:). Use underscores (_) or hyphens (-) instead.`
+      `[SDK] 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 _)`
     );
   }
 }
@@ -223,7 +226,7 @@ function useGameHost(config = {}) {
       onPlayerJoinRef.current?.(data.player);
     };
     const handlePlayerLeave = (data) => {
-      onPlayerLeaveRef.current?.(data.playerId);
+      onPlayerLeaveRef.current?.(data.sessionId);
     };
     transport.on(SYSTEM_EVENTS.READY, handleReady);
     transport.on(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);
@@ -252,7 +255,8 @@ function useGameHost(config = {}) {
       if (!handler) continue;
       validateEventName$2(event);
       const wrappedHandler = (data) => {
-        handler(data.playerId, data.payload);
+        const { sessionId, ...rest } = data;
+        handler(sessionId, rest);
       };
       transport.on(event, wrappedHandler);
       cleanups.push(() => transport.off(event, wrappedHandler));
@@ -269,10 +273,10 @@ function useGameHost(config = {}) {
     [transport]
   );
   const sendToPlayer = react.useCallback(
-    (playerId, event, data) => {
+    (sessionId, event, data) => {
       validateEventName$2(event);
       transport?.emit(SYSTEM_EVENTS.SEND_TO_PLAYER, {
-        targetPlayerId: playerId,
+        targetSessionId: sessionId,
         event,
         data
       });
@@ -299,10 +303,13 @@ function useGameHost(config = {}) {
   };
 }
 
+const EVENT_NAME_REGEX$1 = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
 function validateEventName$1(event) {
-  if (event.includes(":")) {
+  if (!EVENT_NAME_REGEX$1.test(event)) {
     throw new Error(
-      `[SDK] Invalid event name "${event}". Event names must not contain ':' (reserved for system prefixes). Use '_' or '-' instead.`
+      `[SDK] 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 _)`
     );
   }
 }
@@ -327,7 +334,7 @@ function useGamePlayer(config = {}) {
       onPlayerJoinRef.current?.(player);
     };
     const handlePlayerLeave = (data) => {
-      onPlayerLeaveRef.current?.(data.playerId);
+      onPlayerLeaveRef.current?.(data.sessionId);
     };
     transport.on("smore:ready", handleReady);
     transport.on("smore:player-join", handlePlayerJoin);
@@ -361,19 +368,21 @@ function useGamePlayer(config = {}) {
     players: room.players,
     leaderId: room.leaderId,
     roomCode: room.roomCode,
-    myPlayerId: room.mySessionId,
+    mySessionId: room.mySessionId,
     isLeader: room.isLeader,
     emit
   };
 }
 
-const RESERVED_PREFIXES = ["room:", "game:"];
+const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
 function validateEventName(event) {
-  for (const prefix of RESERVED_PREFIXES) {
-    if (event.startsWith(prefix)) {
-      console.error(`[SDK] Event name "${event}" uses reserved prefix "${prefix}". Game events must not use system prefixes.`);
-      return false;
-    }
+  if (!EVENT_NAME_REGEX.test(event)) {
+    console.error(
+      `[SDK] 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 _)`
+    );
+    return false;
   }
   return true;
 }

package/dist/cjs/iframe/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../../src/transport/protocol.ts","../../../src/transport/PostMessageTransport.ts","../../../src/context/RoomProvider.tsx","../../../src/iframe/IframeRoomProvider.tsx","../../../src/hooks/useGameHost.ts","../../../src/hooks/useGamePlayer.ts","../../../src/iframe/vanilla.ts"],"sourcesContent":["/**\n * postMessage protocol types for iframe ↔ parent communication.\n */\n\nexport const SMORE_MSG_PREFIX = 'smore:' as const;\n\nexport interface SmoreReadyMessage {\n  type: 'smore:ready';\n}\n\nexport interface SmoreInitMessage {\n  type: 'smore:init';\n  payload: {\n    side: 'host' | 'player';\n    roomCode: string;\n    players: any[];\n    leaderId: string | null;\n    mySessionId?: string;\n    isLeader?: boolean;\n  };\n}\n\nexport interface SmoreEmitMessage {\n  type: 'smore:emit';\n  payload: {\n    event: string;\n    data?: any;\n    ackId?: string;\n  };\n}\n\nexport interface SmoreEventMessage {\n  type: 'smore:event';\n  payload: {\n    event: string;\n    data?: any;\n  };\n}\n\nexport interface SmoreAckMessage {\n  type: 'smore:ack';\n  payload: {\n    ackId: string;\n    data?: any;\n  };\n}\n\nexport interface SmoreUpdateMessage {\n  type: 'smore:update';\n  payload: {\n    players?: any[];\n    leaderId?: string | null;\n  };\n}\n\nexport interface SmoreLoadedMessage {\n  type: 'smore:loaded';\n}\n\nexport type SmoreMessage =\n  | SmoreReadyMessage\n  | SmoreInitMessage\n  | SmoreEmitMessage\n  | SmoreEventMessage\n  | SmoreAckMessage\n  | SmoreUpdateMessage\n  | SmoreLoadedMessage;\n\nexport function isSmoreMessage(data: any): data is SmoreMessage {\n  return data && typeof data === 'object' && typeof data.type === 'string' && data.type.startsWith(SMORE_MSG_PREFIX);\n}\n","/**\n * PostMessageTransport - Transport over window.postMessage for iframe-hosted games.\n *\n * Used inside an iframe. Sends `smore:emit` to parent and listens for `smore:event` from parent.\n */\n\nimport type { Transport, TransportEventHandler } from './types';\nimport type { SmoreEventMessage, SmoreAckMessage } from './protocol';\nimport { isSmoreMessage } from './protocol';\n\nexport class PostMessageTransport implements Transport {\n  private handlers = new Map<string, Set<TransportEventHandler>>();\n  private ackCallbacks = new Map<string, (...args: any[]) => void>();\n  private ackCounter = 0;\n  private parentOrigin: string;\n  private boundMessageHandler: (e: MessageEvent) => void;\n\n  constructor(parentOrigin: string = '*') {\n    this.parentOrigin = parentOrigin;\n    this.boundMessageHandler = this.handleMessage.bind(this);\n    window.addEventListener('message', this.boundMessageHandler);\n  }\n\n  emit(event: string, ...args: any[]): void {\n    // Detect if last arg is a callback (ack pattern)\n    let data: any = args[0];\n    let ackId: string | undefined;\n\n    if (args.length >= 2 && typeof args[args.length - 1] === 'function') {\n      data = args.length === 2 ? args[0] : args[0];\n      const callback = args[args.length - 1];\n      ackId = `ack_${++this.ackCounter}`;\n      this.ackCallbacks.set(ackId, callback);\n    }\n\n    window.parent.postMessage(\n      { type: 'smore:emit', payload: { event, data, ackId } },\n      this.parentOrigin,\n    );\n  }\n\n  on(event: string, handler: TransportEventHandler): void {\n    let set = this.handlers.get(event);\n    if (!set) {\n      set = new Set();\n      this.handlers.set(event, set);\n    }\n    set.add(handler);\n  }\n\n  off(event: string, handler?: TransportEventHandler): void {\n    if (!handler) {\n      this.handlers.delete(event);\n      return;\n    }\n    this.handlers.get(event)?.delete(handler);\n  }\n\n  destroy(): void {\n    window.removeEventListener('message', this.boundMessageHandler);\n    this.handlers.clear();\n    this.ackCallbacks.clear();\n  }\n\n  private handleMessage(e: MessageEvent): void {\n    // Origin validation: only accept messages from the expected parent\n    if (this.parentOrigin !== '*' && e.origin !== this.parentOrigin) return;\n\n    const msg = e.data;\n    if (!isSmoreMessage(msg)) return;\n\n    if (msg.type === 'smore:event') {\n      const { event, data } = (msg as SmoreEventMessage).payload;\n      const set = this.handlers.get(event);\n      if (set) {\n        set.forEach((handler) => handler(data));\n      }\n    } else if (msg.type === 'smore:ack') {\n      const { ackId, data } = (msg as SmoreAckMessage).payload;\n      const cb = this.ackCallbacks.get(ackId);\n      if (cb) {\n        this.ackCallbacks.delete(ackId);\n        cb(data);\n      }\n    }\n  }\n}\n","/**\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","/**\n * IframeRoomProvider - Entry point for external (iframe-hosted) games.\n *\n * Usage inside an external game's iframe:\n * ```tsx\n * import { IframeRoomProvider } from '@smoregg/sdk/iframe';\n * import { useGameHost } from '@smoregg/sdk/iframe';\n *\n * function App() {\n *   return (\n *     <IframeRoomProvider>\n *       <MyGame />\n *     </IframeRoomProvider>\n *   );\n * }\n * ```\n *\n * Lifecycle:\n * 1. Mount → sends `smore:ready` to parent\n * 2. Receives `smore:init` from parent with room state\n * 3. Creates PostMessageTransport\n * 4. Renders children with RoomContext + TransportContext\n */\n\nimport React, { useEffect, useMemo, useState } from 'react';\nimport { PostMessageTransport } from '../transport/PostMessageTransport';\nimport { isSmoreMessage } from '../transport/protocol';\nimport type { SmoreInitMessage } from '../transport/protocol';\nimport { TransportContext, RoomContext } from '../context/RoomProvider';\nimport type { RoomContextValue, HostRoomState, PlayerRoomState } from '../context/RoomProvider';\n\n// ===== Provider =====\n\ninterface IframeRoomProviderProps {\n  children: React.ReactNode;\n  parentOrigin?: string;\n}\n\nexport const IframeRoomProvider: React.FC<IframeRoomProviderProps> = ({ children, parentOrigin = '*' }) => {\n  const [initData, setInitData] = useState<SmoreInitMessage['payload'] | null>(null);\n  const [transport, setTransport] = useState<PostMessageTransport | null>(null);\n\n  // Step 1: Send ready, listen for init\n  useEffect(() => {\n    const handler = (e: MessageEvent) => {\n      const msg = e.data;\n      if (!isSmoreMessage(msg)) return;\n      if (msg.type === 'smore:init') {\n        setInitData(msg.payload);\n      }\n    };\n\n    window.addEventListener('message', handler);\n\n    // Signal readiness\n    window.parent.postMessage({ type: 'smore:ready' }, parentOrigin);\n\n    return () => window.removeEventListener('message', handler);\n  }, [parentOrigin]);\n\n  // Step 2: Create transport once init arrives\n  useEffect(() => {\n    if (!initData) return;\n    const t = new PostMessageTransport(parentOrigin);\n    setTransport(t);\n    return () => t.destroy();\n  }, [initData, parentOrigin]);\n\n  // Build room context value (uses the SAME RoomContext from RoomProvider)\n  const roomContextValue = useMemo<RoomContextValue | null>(() => {\n    if (!initData) return null;\n\n    const { side, roomCode, players, leaderId, mySessionId, isLeader } = initData;\n    const connectedPlayers = players.filter((p: any) => p.connected !== false);\n\n    if (side === 'host') {\n      const hostState: HostRoomState = {\n        roomCode,\n        players,\n        connectedPlayers,\n        leaderId,\n        socket: null as any, // Not available in iframe — use transport\n      };\n      return {\n        roomCode, players, connectedPlayers, leaderId,\n        side: 'host',\n        host: hostState,\n        player: null,\n      };\n    } else {\n      const playerState: PlayerRoomState = {\n        roomCode,\n        players,\n        connectedPlayers,\n        leaderId,\n        mySessionId: mySessionId || '',\n        isLeader: isLeader || false,\n        socket: null as any, // Not available in iframe — use transport\n        isConnected: true,\n      };\n      return {\n        roomCode, players, connectedPlayers, leaderId,\n        side: 'player',\n        host: null,\n        player: playerState,\n      };\n    }\n  }, [initData]);\n\n  if (!initData || !transport || !roomContextValue) {\n    return null; // Waiting for parent init\n  }\n\n  return (\n    <TransportContext.Provider value={transport}>\n      <RoomContext.Provider value={roomContextValue}>\n        {children}\n      </RoomContext.Provider>\n    </TransportContext.Provider>\n  );\n};\n","/**\n * useGameHost - Host-side game hook for the S'MORE SDK\n *\n * Provides host game developers with:\n * - Room state access (players, leaderId, roomCode)\n * - Event listeners for player inputs\n * - Broadcasting to all/specific players\n * - Game lifecycle management\n *\n * Internally uses Transport abstraction so the same API works over\n * Socket.IO (bundled games) or postMessage (iframe games).\n */\nimport { useEffect, useCallback, useRef } from 'react';\nimport { useHostRoom, useTransport } from '../context/RoomProvider';\nimport type { Player } from '../types';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst SYSTEM_PREFIX = 'smore:';\n\n// System events (internal use only)\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  RETURN_TO_LOBBY: `${SYSTEM_PREFIX}return-to-lobby`,\n  SEND_TO_PLAYER: `${SYSTEM_PREFIX}send-to-player`,\n  BROADCAST: `${SYSTEM_PREFIX}broadcast`,\n} as const;\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\n/**\n * Validates that an event name doesn't contain colons.\n * Colons are reserved for system prefix separation.\n * Underscores and hyphens are allowed.\n */\nfunction validateEventName(event: string): void {\n  if (event.includes(':')) {\n    throw new Error(\n      `[SDK] Invalid event name \"${event}\". Event names must not contain colons (:). ` +\n      `Use underscores (_) or hyphens (-) instead.`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface UseGameHostConfig<T extends Record<string, any> = Record<string, any>> {\n  /** Called when the host is ready and connected. */\n  onReady?: () => void;\n\n  /** Called when a player joins the room. */\n  onPlayerJoin?: (player: Player) => void;\n\n  /** Called when a player leaves the room. */\n  onPlayerLeave?: (playerId: string) => void;\n\n  /**\n   * Event listeners for player inputs.\n   * Keys are event names (without prefix), values are handler functions.\n   * Handler receives (playerId, data) where data is the payload from player.\n   */\n  listeners?: { [K in keyof T]?: (playerId: string, data: T[K]) => void };\n}\n\nexport interface UseGameHostReturn {\n  /** List of all players in the room. */\n  players: Player[];\n\n  /** The session ID of the room leader (host). */\n  leaderId: string | null;\n\n  /** The room code. */\n  roomCode: string;\n\n  /**\n   * Emit an event to all players.\n   * Event name must not contain colons.\n   */\n  emit: (event: string, data?: any) => void;\n\n  /**\n   * Send an event to a specific player.\n   * Event name must not contain colons.\n   */\n  sendToPlayer: (playerId: string, event: string, data?: any) => void;\n\n  /** Signal game over with optional results. */\n  gameOver: (results?: any) => void;\n\n  /** Return all players to lobby. */\n  returnToLobby: () => void;\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useGameHost<T extends Record<string, any> = Record<string, any>>(\n  config: UseGameHostConfig<T> = {}\n): UseGameHostReturn {\n  const { onReady, onPlayerJoin, onPlayerLeave, listeners } = config;\n\n  const hostRoom = useHostRoom();\n  const transport = useTransport();\n\n  // Stable refs to avoid stale closures in listeners\n  const onReadyRef = useRef(onReady);\n  const onPlayerJoinRef = useRef(onPlayerJoin);\n  const onPlayerLeaveRef = useRef(onPlayerLeave);\n  const listenersRef = useRef(listeners);\n\n  useEffect(() => {\n    onReadyRef.current = onReady;\n  }, [onReady]);\n  useEffect(() => {\n    onPlayerJoinRef.current = onPlayerJoin;\n  }, [onPlayerJoin]);\n  useEffect(() => {\n    onPlayerLeaveRef.current = onPlayerLeave;\n  }, [onPlayerLeave]);\n  useEffect(() => {\n    listenersRef.current = listeners;\n  }, [listeners]);\n\n  // -------------------------------------------------------------------------\n  // System event listeners (player lifecycle)\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport) return;\n\n    const handleReady = () => {\n      onReadyRef.current?.();\n    };\n\n    const handlePlayerJoin = (data: { player: Player }) => {\n      onPlayerJoinRef.current?.(data.player);\n    };\n\n    const handlePlayerLeave = (data: { playerId: string }) => {\n      onPlayerLeaveRef.current?.(data.playerId);\n    };\n\n    transport.on(SYSTEM_EVENTS.READY, handleReady);\n    transport.on(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);\n    transport.on(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);\n\n    // Also listen to legacy room events for backward compatibility\n    transport.on('room:player-left', (data: any) => {\n      onPlayerLeaveRef.current?.(data?.sessionId ?? data?.playerId);\n    });\n    transport.on('room:player-joined', (data: any) => {\n      if (data?.player) {\n        onPlayerJoinRef.current?.(data.player);\n      }\n    });\n\n    return () => {\n      transport.off(SYSTEM_EVENTS.READY, handleReady);\n      transport.off(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);\n      transport.off(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);\n      transport.off('room:player-left');\n      transport.off('room:player-joined');\n    };\n  }, [transport]);\n\n  // -------------------------------------------------------------------------\n  // User event listeners\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport || !listeners) return;\n\n    const entries = Object.entries(listeners);\n    const cleanups: (() => void)[] = [];\n\n    for (const [event, handler] of entries) {\n      if (!handler) continue;\n\n      // Validate event name (no colons allowed)\n      validateEventName(event);\n\n      // Listen for the event directly (no wrapping)\n      const wrappedHandler = (data: { playerId: string; payload: any }) => {\n        (handler as (playerId: string, data: any) => void)(data.playerId, data.payload);\n      };\n\n      transport.on(event, wrappedHandler);\n      cleanups.push(() => transport.off(event, wrappedHandler));\n    }\n\n    return () => {\n      cleanups.forEach((cleanup) => cleanup());\n    };\n  }, [transport, listeners]);\n\n  // -------------------------------------------------------------------------\n  // Actions\n  // -------------------------------------------------------------------------\n\n  const emit = useCallback(\n    (event: string, data?: any) => {\n      validateEventName(event);\n      // Broadcast to all players via system event\n      transport?.emit(SYSTEM_EVENTS.BROADCAST, { event, data });\n    },\n    [transport]\n  );\n\n  const sendToPlayer = useCallback(\n    (playerId: string, event: string, data?: any) => {\n      validateEventName(event);\n      // Send to specific player via system event\n      // The server will unwrap and send the inner event directly to the player\n      transport?.emit(SYSTEM_EVENTS.SEND_TO_PLAYER, {\n        targetPlayerId: playerId,\n        event,\n        data,\n      });\n    },\n    [transport]\n  );\n\n  const gameOver = useCallback(\n    (results?: any) => {\n      transport?.emit(SYSTEM_EVENTS.GAME_OVER, { results });\n    },\n    [transport]\n  );\n\n  const returnToLobby = useCallback(() => {\n    transport?.emit(SYSTEM_EVENTS.RETURN_TO_LOBBY, {});\n  }, [transport]);\n\n  return {\n    players: hostRoom.players,\n    leaderId: hostRoom.leaderId,\n    roomCode: hostRoom.roomCode,\n    emit,\n    sendToPlayer,\n    gameOver,\n    returnToLobby,\n  };\n}\n","import { useEffect, useCallback, useRef } from 'react';\nimport { usePlayerRoom } from '../context/RoomProvider';\nimport { useTransport } from '../context/RoomProvider';\nimport type { Player } from '@smoregg/shared';\n\n/**\n * Validate event name for emit\n * - Must NOT contain `:` (colon is reserved for system prefixes)\n * - `_` and `-` are allowed\n */\nfunction validateEventName(event: string): void {\n  if (event.includes(':')) {\n    throw new Error(\n      `[SDK] Invalid event name \"${event}\". Event names must not contain ':' (reserved for system prefixes). Use '_' or '-' instead.`\n    );\n  }\n}\n\n// ===== Types =====\n\nexport interface UseGamePlayerConfig<T = Record<string, any>> {\n  /** Called when smore:ready is received */\n  onReady?: () => void;\n  /** Called when a player joins */\n  onPlayerJoin?: (player: Player) => void;\n  /** Called when a player leaves */\n  onPlayerLeave?: (playerId: string) => void;\n  /** Custom event listeners (event name -> handler) */\n  listeners?: { [K in keyof T]?: (data: T[K]) => void };\n}\n\nexport interface UseGamePlayerReturn {\n  /** All players in the room */\n  players: Player[];\n  /** Leader player's session ID */\n  leaderId: string | null;\n  /** Room code */\n  roomCode: string;\n  /** My session ID */\n  myPlayerId: string;\n  /** Am I the leader? */\n  isLeader: boolean;\n  /** Emit event to host (event name must not contain ':') */\n  emit: (event: string, data?: any) => void;\n}\n\n// ===== Hook =====\n\nexport function useGamePlayer<T = Record<string, any>>(\n  config: UseGamePlayerConfig<T> = {}\n): UseGamePlayerReturn {\n  const room = usePlayerRoom();\n  const transport = useTransport();\n  const { onReady, onPlayerJoin, onPlayerLeave, listeners } = config;\n\n  // Use refs to avoid re-subscribing on every render\n  const onReadyRef = useRef(onReady);\n  const onPlayerJoinRef = useRef(onPlayerJoin);\n  const onPlayerLeaveRef = useRef(onPlayerLeave);\n  const listenersRef = useRef(listeners);\n\n  onReadyRef.current = onReady;\n  onPlayerJoinRef.current = onPlayerJoin;\n  onPlayerLeaveRef.current = onPlayerLeave;\n  listenersRef.current = listeners;\n\n  // System event listeners (smore: prefix)\n  useEffect(() => {\n    if (!transport) return;\n\n    const handleReady = () => {\n      onReadyRef.current?.();\n    };\n\n    const handlePlayerJoin = (player: Player) => {\n      onPlayerJoinRef.current?.(player);\n    };\n\n    const handlePlayerLeave = (data: { playerId: string }) => {\n      onPlayerLeaveRef.current?.(data.playerId);\n    };\n\n    transport.on('smore:ready', handleReady);\n    transport.on('smore:player-join', handlePlayerJoin);\n    transport.on('smore:player-leave', handlePlayerLeave);\n\n    return () => {\n      transport.off('smore:ready', handleReady);\n      transport.off('smore:player-join', handlePlayerJoin);\n      transport.off('smore:player-leave', handlePlayerLeave);\n    };\n  }, [transport]);\n\n  // User event listeners (passed through directly, no wrapping)\n  useEffect(() => {\n    if (!transport || !listenersRef.current) return;\n\n    const cleanups: (() => void)[] = [];\n\n    Object.entries(listenersRef.current).forEach(([event, handler]) => {\n      if (handler) {\n        transport.on(event, handler as (data: any) => void);\n        cleanups.push(() => transport.off(event, handler as (data: any) => void));\n      }\n    });\n\n    return () => cleanups.forEach((fn) => fn());\n  }, [transport, listeners]);\n\n  // Emit function with validation\n  const emit = useCallback(\n    (event: string, data?: any) => {\n      if (!transport) return;\n      validateEventName(event);\n      transport.emit(event, data);\n    },\n    [transport]\n  );\n\n  return {\n    players: room.players,\n    leaderId: room.leaderId,\n    roomCode: room.roomCode,\n    myPlayerId: room.mySessionId,\n    isLeader: room.isLeader,\n    emit,\n  };\n}\n","/**\n * Vanilla JS bridge API for iframe-hosted games.\n * No React - pure JavaScript with PostMessage transport.\n */\n\nimport { PostMessageTransport } from '../transport/PostMessageTransport';\nimport { isSmoreMessage, type SmoreInitMessage } from '../transport/protocol';\n\nconst RESERVED_PREFIXES = ['room:', 'game:'];\n\nfunction validateEventName(event: string): boolean {\n  for (const prefix of RESERVED_PREFIXES) {\n    if (event.startsWith(prefix)) {\n      console.error(`[SDK] Event name \"${event}\" uses reserved prefix \"${prefix}\". Game events must not use system prefixes.`);\n      return false;\n    }\n  }\n  return true;\n}\n\nexport interface HostBridgeOptions {\n  parentOrigin?: string;\n  gameId: string;\n  listeners?: Record<string, (data: any) => void>;\n  onPlayerJoin?: (playerId: string) => void;\n  onPlayerLeave?: (playerId: string) => void;\n  onReady?: (room: { roomCode: string; players: any[]; leaderId: string | null }) => void;\n}\n\nexport interface HostBridge {\n  broadcast: (event: string, data?: any) => void;\n  sendToPlayer: (playerId: string, event: string, data?: any) => void;\n  emitGameOver: (results: any) => void;\n  setLoaded: () => void;\n  destroy: () => void;\n}\n\nexport interface PlayerBridgeOptions {\n  parentOrigin?: string;\n  gameId: string;\n  listeners?: Record<string, (data: any) => void>;\n  onReady?: (room: { roomCode: string; isLeader: boolean; mySessionId: string }) => void;\n}\n\nexport interface PlayerBridge {\n  emit: (event: string, data?: any) => void;\n  onEvent: (event: string, handler: (data: any) => void) => () => void;\n  destroy: () => void;\n}\n\nexport function createHostBridge(options: HostBridgeOptions): HostBridge {\n  const { parentOrigin = '*', gameId, listeners, onPlayerJoin, onPlayerLeave, onReady } = options;\n\n  let transport: PostMessageTransport | null = null;\n  let isInitialized = false;\n\n  // Immediately signal ready to parent\n  window.parent.postMessage({ type: 'smore:ready' }, parentOrigin);\n\n  const messageHandler = (e: MessageEvent) => {\n    if (parentOrigin !== '*' && e.origin !== parentOrigin) return;\n    const msg = e.data;\n    if (!isSmoreMessage(msg)) return;\n\n    if (msg.type === 'smore:init') {\n      const { side, roomCode, players, leaderId } = (msg as SmoreInitMessage).payload;\n\n      if (side !== 'host') {\n        console.error('[HostBridge] Received init for wrong side:', side);\n        return;\n      }\n\n      // Create transport and wire up event handlers\n      transport = new PostMessageTransport(parentOrigin);\n\n      // Handle input events\n      if (listeners) {\n        Object.keys(listeners).forEach((event) => {\n          validateEventName(event);\n          const handler = listeners[event];\n          transport!.on(event, handler);\n        });\n      }\n\n      // Handle player join/leave events\n      if (onPlayerJoin) {\n        transport.on('player:joined', (payload: any) => {\n          onPlayerJoin(payload.sessionId);\n        });\n      }\n      if (onPlayerLeave) {\n        transport.on('player:left', (payload: any) => {\n          onPlayerLeave(payload.sessionId);\n        });\n      }\n\n      isInitialized = true;\n\n      // Call onReady callback\n      if (onReady) {\n        onReady({ roomCode, players, leaderId });\n      }\n    }\n  };\n\n  window.addEventListener('message', messageHandler);\n\n  return {\n    broadcast: (event: string, data?: any) => {\n      if (!transport) {\n        console.warn('[HostBridge] Cannot broadcast before init');\n        return;\n      }\n      validateEventName(event);\n      transport.emit(event, data);\n    },\n\n    sendToPlayer: (playerId: string, event: string, data?: any) => {\n      if (!transport) {\n        console.warn('[HostBridge] Cannot sendToPlayer before init');\n        return;\n      }\n      transport.emit(event, { targetSessionId: playerId, ...data });\n    },\n\n    emitGameOver: (results: any) => {\n      if (!transport) {\n        console.warn('[HostBridge] Cannot emitGameOver before init');\n        return;\n      }\n      transport.emit('game-over', results);\n    },\n\n    setLoaded: () => {\n      window.parent.postMessage({ type: 'smore:loaded' }, parentOrigin);\n    },\n\n    destroy: () => {\n      window.removeEventListener('message', messageHandler);\n      transport?.destroy();\n      transport = null;\n      isInitialized = false;\n    },\n  };\n}\n\nexport function createPlayerBridge(options: PlayerBridgeOptions): PlayerBridge {\n  const { parentOrigin = '*', gameId, listeners, onReady } = options;\n\n  let transport: PostMessageTransport | null = null;\n  let isInitialized = false;\n\n  // Immediately signal ready to parent\n  window.parent.postMessage({ type: 'smore:ready' }, parentOrigin);\n\n  const messageHandler = (e: MessageEvent) => {\n    if (parentOrigin !== '*' && e.origin !== parentOrigin) return;\n    const msg = e.data;\n    if (!isSmoreMessage(msg)) return;\n\n    if (msg.type === 'smore:init') {\n      const { side, roomCode, mySessionId, isLeader } = (msg as SmoreInitMessage).payload;\n\n      if (side !== 'player') {\n        console.error('[PlayerBridge] Received init for wrong side:', side);\n        return;\n      }\n\n      if (!mySessionId) {\n        console.error('[PlayerBridge] Missing mySessionId in init payload');\n        return;\n      }\n\n      // Create transport and wire up listeners\n      transport = new PostMessageTransport(parentOrigin);\n\n      // Wire up game-specific event listeners\n      if (listeners) {\n        Object.keys(listeners).forEach((event) => {\n          validateEventName(event);\n          const handler = listeners[event];\n          transport!.on(event, handler);\n        });\n      }\n\n      isInitialized = true;\n\n      // Call onReady callback\n      if (onReady) {\n        onReady({ roomCode, isLeader: !!isLeader, mySessionId });\n      }\n    }\n  };\n\n  window.addEventListener('message', messageHandler);\n\n  return {\n    emit: (event: string, data?: any) => {\n      if (!transport) {\n        console.warn('[PlayerBridge] Cannot emit before init');\n        return;\n      }\n      validateEventName(event);\n      transport.emit(event, data);\n    },\n\n    onEvent: (event: string, handler: (data: any) => void) => {\n      if (!transport) {\n        console.warn('[PlayerBridge] Cannot onEvent before init');\n        return () => {};\n      }\n      validateEventName(event);\n      transport.on(event, handler);\n      return () => {\n        transport?.off(event, handler);\n      };\n    },\n\n    destroy: () => {\n      window.removeEventListener('message', messageHandler);\n      transport?.destroy();\n      transport = null;\n      isInitialized = false;\n    },\n  };\n}\n"],"names":["createContext","useContext","useState","useEffect","useMemo","jsx","validateEventName","useRef","useCallback"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../../src/transport/protocol.ts","../../../src/transport/PostMessageTransport.ts","../../../src/context/RoomProvider.tsx","../../../src/iframe/IframeRoomProvider.tsx","../../../src/hooks/useGameHost.ts","../../../src/hooks/useGamePlayer.ts","../../../src/iframe/vanilla.ts"],"sourcesContent":["/**\n * postMessage protocol types for iframe ↔ parent communication.\n */\n\nexport const SMORE_MSG_PREFIX = 'smore:' as const;\n\nexport interface SmoreReadyMessage {\n  type: 'smore:ready';\n}\n\nexport interface SmoreInitMessage {\n  type: 'smore:init';\n  payload: {\n    side: 'host' | 'player';\n    roomCode: string;\n    players: any[];\n    leaderId: string | null;\n    mySessionId?: string;\n    isLeader?: boolean;\n  };\n}\n\nexport interface SmoreEmitMessage {\n  type: 'smore:emit';\n  payload: {\n    event: string;\n    data?: any;\n    ackId?: string;\n  };\n}\n\nexport interface SmoreEventMessage {\n  type: 'smore:event';\n  payload: {\n    event: string;\n    data?: any;\n  };\n}\n\nexport interface SmoreAckMessage {\n  type: 'smore:ack';\n  payload: {\n    ackId: string;\n    data?: any;\n  };\n}\n\nexport interface SmoreUpdateMessage {\n  type: 'smore:update';\n  payload: {\n    players?: any[];\n    leaderId?: string | null;\n  };\n}\n\nexport interface SmoreLoadedMessage {\n  type: 'smore:loaded';\n}\n\nexport type SmoreMessage =\n  | SmoreReadyMessage\n  | SmoreInitMessage\n  | SmoreEmitMessage\n  | SmoreEventMessage\n  | SmoreAckMessage\n  | SmoreUpdateMessage\n  | SmoreLoadedMessage;\n\nexport function isSmoreMessage(data: any): data is SmoreMessage {\n  return data && typeof data === 'object' && typeof data.type === 'string' && data.type.startsWith(SMORE_MSG_PREFIX);\n}\n","/**\n * PostMessageTransport - Transport over window.postMessage for iframe-hosted games.\n *\n * Used inside an iframe. Sends `smore:emit` to parent and listens for `smore:event` from parent.\n */\n\nimport type { Transport, TransportEventHandler } from './types';\nimport type { SmoreEventMessage, SmoreAckMessage } from './protocol';\nimport { isSmoreMessage } from './protocol';\n\nexport class PostMessageTransport implements Transport {\n  private handlers = new Map<string, Set<TransportEventHandler>>();\n  private ackCallbacks = new Map<string, (...args: any[]) => void>();\n  private ackCounter = 0;\n  private parentOrigin: string;\n  private boundMessageHandler: (e: MessageEvent) => void;\n\n  constructor(parentOrigin: string = '*') {\n    this.parentOrigin = parentOrigin;\n    this.boundMessageHandler = this.handleMessage.bind(this);\n    window.addEventListener('message', this.boundMessageHandler);\n  }\n\n  emit(event: string, ...args: any[]): void {\n    // Detect if last arg is a callback (ack pattern)\n    let data: any = args[0];\n    let ackId: string | undefined;\n\n    if (args.length >= 2 && typeof args[args.length - 1] === 'function') {\n      data = args.length === 2 ? args[0] : args[0];\n      const callback = args[args.length - 1];\n      ackId = `ack_${++this.ackCounter}`;\n      this.ackCallbacks.set(ackId, callback);\n    }\n\n    window.parent.postMessage(\n      { type: 'smore:emit', payload: { event, data, ackId } },\n      this.parentOrigin,\n    );\n  }\n\n  on(event: string, handler: TransportEventHandler): void {\n    let set = this.handlers.get(event);\n    if (!set) {\n      set = new Set();\n      this.handlers.set(event, set);\n    }\n    set.add(handler);\n  }\n\n  off(event: string, handler?: TransportEventHandler): void {\n    if (!handler) {\n      this.handlers.delete(event);\n      return;\n    }\n    this.handlers.get(event)?.delete(handler);\n  }\n\n  destroy(): void {\n    window.removeEventListener('message', this.boundMessageHandler);\n    this.handlers.clear();\n    this.ackCallbacks.clear();\n  }\n\n  private handleMessage(e: MessageEvent): void {\n    // Origin validation: only accept messages from the expected parent\n    if (this.parentOrigin !== '*' && e.origin !== this.parentOrigin) return;\n\n    const msg = e.data;\n    if (!isSmoreMessage(msg)) return;\n\n    if (msg.type === 'smore:event') {\n      const { event, data } = (msg as SmoreEventMessage).payload;\n      const set = this.handlers.get(event);\n      if (set) {\n        set.forEach((handler) => handler(data));\n      }\n    } else if (msg.type === 'smore:ack') {\n      const { ackId, data } = (msg as SmoreAckMessage).payload;\n      const cb = this.ackCallbacks.get(ackId);\n      if (cb) {\n        this.ackCallbacks.delete(ackId);\n        cb(data);\n      }\n    }\n  }\n}\n","/**\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","/**\n * IframeRoomProvider - Entry point for external (iframe-hosted) games.\n *\n * Usage inside an external game's iframe:\n * ```tsx\n * import { IframeRoomProvider } from '@smoregg/sdk/iframe';\n * import { useGameHost } from '@smoregg/sdk/iframe';\n *\n * function App() {\n *   return (\n *     <IframeRoomProvider>\n *       <MyGame />\n *     </IframeRoomProvider>\n *   );\n * }\n * ```\n *\n * Lifecycle:\n * 1. Mount → sends `smore:ready` to parent\n * 2. Receives `smore:init` from parent with room state\n * 3. Creates PostMessageTransport\n * 4. Renders children with RoomContext + TransportContext\n */\n\nimport React, { useEffect, useMemo, useState } from 'react';\nimport { PostMessageTransport } from '../transport/PostMessageTransport';\nimport { isSmoreMessage } from '../transport/protocol';\nimport type { SmoreInitMessage } from '../transport/protocol';\nimport { TransportContext, RoomContext } from '../context/RoomProvider';\nimport type { RoomContextValue, HostRoomState, PlayerRoomState } from '../context/RoomProvider';\n\n// ===== Provider =====\n\ninterface IframeRoomProviderProps {\n  children: React.ReactNode;\n  parentOrigin?: string;\n}\n\nexport const IframeRoomProvider: React.FC<IframeRoomProviderProps> = ({ children, parentOrigin = '*' }) => {\n  const [initData, setInitData] = useState<SmoreInitMessage['payload'] | null>(null);\n  const [transport, setTransport] = useState<PostMessageTransport | null>(null);\n\n  // Step 1: Send ready, listen for init\n  useEffect(() => {\n    const handler = (e: MessageEvent) => {\n      const msg = e.data;\n      if (!isSmoreMessage(msg)) return;\n      if (msg.type === 'smore:init') {\n        setInitData(msg.payload);\n      }\n    };\n\n    window.addEventListener('message', handler);\n\n    // Signal readiness\n    window.parent.postMessage({ type: 'smore:ready' }, parentOrigin);\n\n    return () => window.removeEventListener('message', handler);\n  }, [parentOrigin]);\n\n  // Step 2: Create transport once init arrives\n  useEffect(() => {\n    if (!initData) return;\n    const t = new PostMessageTransport(parentOrigin);\n    setTransport(t);\n    return () => t.destroy();\n  }, [initData, parentOrigin]);\n\n  // Build room context value (uses the SAME RoomContext from RoomProvider)\n  const roomContextValue = useMemo<RoomContextValue | null>(() => {\n    if (!initData) return null;\n\n    const { side, roomCode, players, leaderId, mySessionId, isLeader } = initData;\n    const connectedPlayers = players.filter((p: any) => p.connected !== false);\n\n    if (side === 'host') {\n      const hostState: HostRoomState = {\n        roomCode,\n        players,\n        connectedPlayers,\n        leaderId,\n        socket: null as any, // Not available in iframe — use transport\n      };\n      return {\n        roomCode, players, connectedPlayers, leaderId,\n        side: 'host',\n        host: hostState,\n        player: null,\n      };\n    } else {\n      const playerState: PlayerRoomState = {\n        roomCode,\n        players,\n        connectedPlayers,\n        leaderId,\n        mySessionId: mySessionId || '',\n        isLeader: isLeader || false,\n        socket: null as any, // Not available in iframe — use transport\n        isConnected: true,\n      };\n      return {\n        roomCode, players, connectedPlayers, leaderId,\n        side: 'player',\n        host: null,\n        player: playerState,\n      };\n    }\n  }, [initData]);\n\n  if (!initData || !transport || !roomContextValue) {\n    return null; // Waiting for parent init\n  }\n\n  return (\n    <TransportContext.Provider value={transport}>\n      <RoomContext.Provider value={roomContextValue}>\n        {children}\n      </RoomContext.Provider>\n    </TransportContext.Provider>\n  );\n};\n","/**\n * useGameHost - Host-side game hook for the S'MORE SDK\n *\n * Provides host game developers with:\n * - Room state access (players, leaderId, roomCode)\n * - Event listeners for player inputs\n * - Broadcasting to all/specific players\n * - Game lifecycle management\n *\n * Internally uses Transport abstraction so the same API works over\n * Socket.IO (bundled games) or postMessage (iframe games).\n */\nimport { useEffect, useCallback, useRef } from 'react';\nimport { useHostRoom, useTransport } from '../context/RoomProvider';\nimport type { Player } from '../types';\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst SYSTEM_PREFIX = 'smore:';\n\n// System events (internal use only)\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  RETURN_TO_LOBBY: `${SYSTEM_PREFIX}return-to-lobby`,\n  SEND_TO_PLAYER: `${SYSTEM_PREFIX}send-to-player`,\n  BROADCAST: `${SYSTEM_PREFIX}broadcast`,\n} as const;\n\n// ---------------------------------------------------------------------------\n// Validation\n// ---------------------------------------------------------------------------\n\n/**\n * Validates event name format.\n * Rules:\n * - Only English letters (a-z, A-Z), hyphens (-), and underscores (_) allowed\n * - Must start and end with a letter (no leading/trailing - or _)\n * - Colons are reserved for system prefix\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      `[SDK] 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\nexport interface UseGameHostConfig<T extends Record<string, any> = Record<string, any>> {\n  /** Called when the host is ready and connected. */\n  onReady?: () => void;\n\n  /** Called when a player joins the room. */\n  onPlayerJoin?: (player: Player) => void;\n\n  /** Called when a player leaves the room. */\n  onPlayerLeave?: (sessionId: string) => void;\n\n  /**\n   * Event listeners for player inputs.\n   * Keys are event names (without prefix), values are handler functions.\n   * Handler receives (sessionId, data) where sessionId identifies the player.\n   */\n  listeners?: { [K in keyof T]?: (sessionId: string, data: T[K]) => void };\n}\n\nexport interface UseGameHostReturn {\n  /** List of all players in the room. */\n  players: Player[];\n\n  /** The session ID of the room leader (host). */\n  leaderId: string | null;\n\n  /** The room code. */\n  roomCode: string;\n\n  /**\n   * Emit an event to all players.\n   * Event name must not contain colons.\n   */\n  emit: (event: string, data?: any) => void;\n\n  /**\n   * Send an event to a specific player.\n   * Event name must not contain colons.\n   */\n  sendToPlayer: (sessionId: string, event: string, data?: any) => void;\n\n  /** Signal game over with optional results. */\n  gameOver: (results?: any) => void;\n\n  /** Return all players to lobby. */\n  returnToLobby: () => void;\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useGameHost<T extends Record<string, any> = Record<string, any>>(\n  config: UseGameHostConfig<T> = {}\n): UseGameHostReturn {\n  const { onReady, onPlayerJoin, onPlayerLeave, listeners } = config;\n\n  const hostRoom = useHostRoom();\n  const transport = useTransport();\n\n  // Stable refs to avoid stale closures in listeners\n  const onReadyRef = useRef(onReady);\n  const onPlayerJoinRef = useRef(onPlayerJoin);\n  const onPlayerLeaveRef = useRef(onPlayerLeave);\n  const listenersRef = useRef(listeners);\n\n  useEffect(() => {\n    onReadyRef.current = onReady;\n  }, [onReady]);\n  useEffect(() => {\n    onPlayerJoinRef.current = onPlayerJoin;\n  }, [onPlayerJoin]);\n  useEffect(() => {\n    onPlayerLeaveRef.current = onPlayerLeave;\n  }, [onPlayerLeave]);\n  useEffect(() => {\n    listenersRef.current = listeners;\n  }, [listeners]);\n\n  // -------------------------------------------------------------------------\n  // System event listeners (player lifecycle)\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport) return;\n\n    const handleReady = () => {\n      onReadyRef.current?.();\n    };\n\n    const handlePlayerJoin = (data: { player: Player }) => {\n      onPlayerJoinRef.current?.(data.player);\n    };\n\n    const handlePlayerLeave = (data: { sessionId: string }) => {\n      onPlayerLeaveRef.current?.(data.sessionId);\n    };\n\n    transport.on(SYSTEM_EVENTS.READY, handleReady);\n    transport.on(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);\n    transport.on(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);\n\n    // Also listen to legacy room events for backward compatibility\n    transport.on('room:player-left', (data: any) => {\n      onPlayerLeaveRef.current?.(data?.sessionId ?? data?.playerId);\n    });\n    transport.on('room:player-joined', (data: any) => {\n      if (data?.player) {\n        onPlayerJoinRef.current?.(data.player);\n      }\n    });\n\n    return () => {\n      transport.off(SYSTEM_EVENTS.READY, handleReady);\n      transport.off(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);\n      transport.off(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);\n      transport.off('room:player-left');\n      transport.off('room:player-joined');\n    };\n  }, [transport]);\n\n  // -------------------------------------------------------------------------\n  // User event listeners\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport || !listeners) return;\n\n    const entries = Object.entries(listeners);\n    const cleanups: (() => void)[] = [];\n\n    for (const [event, handler] of entries) {\n      if (!handler) continue;\n\n      // Validate event name (no colons allowed)\n      validateEventName(event);\n\n      // Listen for the event directly\n      // Server sends: { sessionId, ...playerData }\n      const wrappedHandler = (data: { sessionId: string; [key: string]: any }) => {\n        const { sessionId, ...rest } = data;\n        (handler as (sessionId: string, data: any) => void)(sessionId, rest);\n      };\n\n      transport.on(event, wrappedHandler);\n      cleanups.push(() => transport.off(event, wrappedHandler));\n    }\n\n    return () => {\n      cleanups.forEach((cleanup) => cleanup());\n    };\n  }, [transport, listeners]);\n\n  // -------------------------------------------------------------------------\n  // Actions\n  // -------------------------------------------------------------------------\n\n  const emit = useCallback(\n    (event: string, data?: any) => {\n      validateEventName(event);\n      // Broadcast to all players via system event\n      transport?.emit(SYSTEM_EVENTS.BROADCAST, { event, data });\n    },\n    [transport]\n  );\n\n  const sendToPlayer = useCallback(\n    (sessionId: string, event: string, data?: any) => {\n      validateEventName(event);\n      // Send to specific player via system event\n      // The server will unwrap and send the inner event directly to the player\n      transport?.emit(SYSTEM_EVENTS.SEND_TO_PLAYER, {\n        targetSessionId: sessionId,\n        event,\n        data,\n      });\n    },\n    [transport]\n  );\n\n  const gameOver = useCallback(\n    (results?: any) => {\n      transport?.emit(SYSTEM_EVENTS.GAME_OVER, { results });\n    },\n    [transport]\n  );\n\n  const returnToLobby = useCallback(() => {\n    transport?.emit(SYSTEM_EVENTS.RETURN_TO_LOBBY, {});\n  }, [transport]);\n\n  return {\n    players: hostRoom.players,\n    leaderId: hostRoom.leaderId,\n    roomCode: hostRoom.roomCode,\n    emit,\n    sendToPlayer,\n    gameOver,\n    returnToLobby,\n  };\n}\n","import { useEffect, useCallback, useRef } from 'react';\nimport { usePlayerRoom } from '../context/RoomProvider';\nimport { useTransport } from '../context/RoomProvider';\nimport type { Player } from '@smoregg/shared';\n\n/**\n * Validates event name format.\n * Rules:\n * - Only English letters (a-z, A-Z), hyphens (-), and underscores (_) allowed\n * - Must start and end with a letter (no leading/trailing - or _)\n * - Colons are reserved for system prefix\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      `[SDK] 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// ===== Types =====\n\nexport interface UseGamePlayerConfig<T = Record<string, any>> {\n  /** Called when smore:ready is received */\n  onReady?: () => void;\n  /** Called when a player joins */\n  onPlayerJoin?: (player: Player) => void;\n  /** Called when a player leaves */\n  onPlayerLeave?: (sessionId: string) => void;\n  /** Custom event listeners (event name -> handler) */\n  listeners?: { [K in keyof T]?: (data: T[K]) => void };\n}\n\nexport interface UseGamePlayerReturn {\n  /** All players in the room */\n  players: Player[];\n  /** Leader player's session ID */\n  leaderId: string | null;\n  /** Room code */\n  roomCode: string;\n  /** My session ID */\n  mySessionId: string;\n  /** Am I the leader? */\n  isLeader: boolean;\n  /** Emit event to host (event name must not contain ':') */\n  emit: (event: string, data?: any) => void;\n}\n\n// ===== Hook =====\n\nexport function useGamePlayer<T = Record<string, any>>(\n  config: UseGamePlayerConfig<T> = {}\n): UseGamePlayerReturn {\n  const room = usePlayerRoom();\n  const transport = useTransport();\n  const { onReady, onPlayerJoin, onPlayerLeave, listeners } = config;\n\n  // Use refs to avoid re-subscribing on every render\n  const onReadyRef = useRef(onReady);\n  const onPlayerJoinRef = useRef(onPlayerJoin);\n  const onPlayerLeaveRef = useRef(onPlayerLeave);\n  const listenersRef = useRef(listeners);\n\n  onReadyRef.current = onReady;\n  onPlayerJoinRef.current = onPlayerJoin;\n  onPlayerLeaveRef.current = onPlayerLeave;\n  listenersRef.current = listeners;\n\n  // System event listeners (smore: prefix)\n  useEffect(() => {\n    if (!transport) return;\n\n    const handleReady = () => {\n      onReadyRef.current?.();\n    };\n\n    const handlePlayerJoin = (player: Player) => {\n      onPlayerJoinRef.current?.(player);\n    };\n\n    const handlePlayerLeave = (data: { sessionId: string }) => {\n      onPlayerLeaveRef.current?.(data.sessionId);\n    };\n\n    transport.on('smore:ready', handleReady);\n    transport.on('smore:player-join', handlePlayerJoin);\n    transport.on('smore:player-leave', handlePlayerLeave);\n\n    return () => {\n      transport.off('smore:ready', handleReady);\n      transport.off('smore:player-join', handlePlayerJoin);\n      transport.off('smore:player-leave', handlePlayerLeave);\n    };\n  }, [transport]);\n\n  // User event listeners (passed through directly, no wrapping)\n  useEffect(() => {\n    if (!transport || !listenersRef.current) return;\n\n    const cleanups: (() => void)[] = [];\n\n    Object.entries(listenersRef.current).forEach(([event, handler]) => {\n      if (handler) {\n        transport.on(event, handler as (data: any) => void);\n        cleanups.push(() => transport.off(event, handler as (data: any) => void));\n      }\n    });\n\n    return () => cleanups.forEach((fn) => fn());\n  }, [transport, listeners]);\n\n  // Emit function with validation\n  const emit = useCallback(\n    (event: string, data?: any) => {\n      if (!transport) return;\n      validateEventName(event);\n      transport.emit(event, data);\n    },\n    [transport]\n  );\n\n  return {\n    players: room.players,\n    leaderId: room.leaderId,\n    roomCode: room.roomCode,\n    mySessionId: room.mySessionId,\n    isLeader: room.isLeader,\n    emit,\n  };\n}\n","/**\n * Vanilla JS bridge API for iframe-hosted games.\n * No React - pure JavaScript with PostMessage transport.\n */\n\nimport { PostMessageTransport } from '../transport/PostMessageTransport';\nimport { isSmoreMessage, type SmoreInitMessage } from '../transport/protocol';\n\n/**\n * Validates event name format.\n * Rules:\n * - Only English letters (a-z, A-Z), hyphens (-), and underscores (_) allowed\n * - Must start and end with a letter (no leading/trailing - or _)\n * - Colons are reserved for system prefix\n */\nconst EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;\n\nfunction validateEventName(event: string): boolean {\n  if (!EVENT_NAME_REGEX.test(event)) {\n    console.error(\n      `[SDK] 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    return false;\n  }\n  return true;\n}\n\nexport interface HostBridgeOptions {\n  parentOrigin?: string;\n  gameId: string;\n  listeners?: Record<string, (data: any) => void>;\n  onPlayerJoin?: (playerId: string) => void;\n  onPlayerLeave?: (playerId: string) => void;\n  onReady?: (room: { roomCode: string; players: any[]; leaderId: string | null }) => void;\n}\n\nexport interface HostBridge {\n  broadcast: (event: string, data?: any) => void;\n  sendToPlayer: (playerId: string, event: string, data?: any) => void;\n  emitGameOver: (results: any) => void;\n  setLoaded: () => void;\n  destroy: () => void;\n}\n\nexport interface PlayerBridgeOptions {\n  parentOrigin?: string;\n  gameId: string;\n  listeners?: Record<string, (data: any) => void>;\n  onReady?: (room: { roomCode: string; isLeader: boolean; mySessionId: string }) => void;\n}\n\nexport interface PlayerBridge {\n  emit: (event: string, data?: any) => void;\n  onEvent: (event: string, handler: (data: any) => void) => () => void;\n  destroy: () => void;\n}\n\nexport function createHostBridge(options: HostBridgeOptions): HostBridge {\n  const { parentOrigin = '*', gameId, listeners, onPlayerJoin, onPlayerLeave, onReady } = options;\n\n  let transport: PostMessageTransport | null = null;\n  let isInitialized = false;\n\n  // Immediately signal ready to parent\n  window.parent.postMessage({ type: 'smore:ready' }, parentOrigin);\n\n  const messageHandler = (e: MessageEvent) => {\n    if (parentOrigin !== '*' && e.origin !== parentOrigin) return;\n    const msg = e.data;\n    if (!isSmoreMessage(msg)) return;\n\n    if (msg.type === 'smore:init') {\n      const { side, roomCode, players, leaderId } = (msg as SmoreInitMessage).payload;\n\n      if (side !== 'host') {\n        console.error('[HostBridge] Received init for wrong side:', side);\n        return;\n      }\n\n      // Create transport and wire up event handlers\n      transport = new PostMessageTransport(parentOrigin);\n\n      // Handle input events\n      if (listeners) {\n        Object.keys(listeners).forEach((event) => {\n          validateEventName(event);\n          const handler = listeners[event];\n          transport!.on(event, handler);\n        });\n      }\n\n      // Handle player join/leave events\n      if (onPlayerJoin) {\n        transport.on('player:joined', (payload: any) => {\n          onPlayerJoin(payload.sessionId);\n        });\n      }\n      if (onPlayerLeave) {\n        transport.on('player:left', (payload: any) => {\n          onPlayerLeave(payload.sessionId);\n        });\n      }\n\n      isInitialized = true;\n\n      // Call onReady callback\n      if (onReady) {\n        onReady({ roomCode, players, leaderId });\n      }\n    }\n  };\n\n  window.addEventListener('message', messageHandler);\n\n  return {\n    broadcast: (event: string, data?: any) => {\n      if (!transport) {\n        console.warn('[HostBridge] Cannot broadcast before init');\n        return;\n      }\n      validateEventName(event);\n      transport.emit(event, data);\n    },\n\n    sendToPlayer: (playerId: string, event: string, data?: any) => {\n      if (!transport) {\n        console.warn('[HostBridge] Cannot sendToPlayer before init');\n        return;\n      }\n      transport.emit(event, { targetSessionId: playerId, ...data });\n    },\n\n    emitGameOver: (results: any) => {\n      if (!transport) {\n        console.warn('[HostBridge] Cannot emitGameOver before init');\n        return;\n      }\n      transport.emit('game-over', results);\n    },\n\n    setLoaded: () => {\n      window.parent.postMessage({ type: 'smore:loaded' }, parentOrigin);\n    },\n\n    destroy: () => {\n      window.removeEventListener('message', messageHandler);\n      transport?.destroy();\n      transport = null;\n      isInitialized = false;\n    },\n  };\n}\n\nexport function createPlayerBridge(options: PlayerBridgeOptions): PlayerBridge {\n  const { parentOrigin = '*', gameId, listeners, onReady } = options;\n\n  let transport: PostMessageTransport | null = null;\n  let isInitialized = false;\n\n  // Immediately signal ready to parent\n  window.parent.postMessage({ type: 'smore:ready' }, parentOrigin);\n\n  const messageHandler = (e: MessageEvent) => {\n    if (parentOrigin !== '*' && e.origin !== parentOrigin) return;\n    const msg = e.data;\n    if (!isSmoreMessage(msg)) return;\n\n    if (msg.type === 'smore:init') {\n      const { side, roomCode, mySessionId, isLeader } = (msg as SmoreInitMessage).payload;\n\n      if (side !== 'player') {\n        console.error('[PlayerBridge] Received init for wrong side:', side);\n        return;\n      }\n\n      if (!mySessionId) {\n        console.error('[PlayerBridge] Missing mySessionId in init payload');\n        return;\n      }\n\n      // Create transport and wire up listeners\n      transport = new PostMessageTransport(parentOrigin);\n\n      // Wire up game-specific event listeners\n      if (listeners) {\n        Object.keys(listeners).forEach((event) => {\n          validateEventName(event);\n          const handler = listeners[event];\n          transport!.on(event, handler);\n        });\n      }\n\n      isInitialized = true;\n\n      // Call onReady callback\n      if (onReady) {\n        onReady({ roomCode, isLeader: !!isLeader, mySessionId });\n      }\n    }\n  };\n\n  window.addEventListener('message', messageHandler);\n\n  return {\n    emit: (event: string, data?: any) => {\n      if (!transport) {\n        console.warn('[PlayerBridge] Cannot emit before init');\n        return;\n      }\n      validateEventName(event);\n      transport.emit(event, data);\n    },\n\n    onEvent: (event: string, handler: (data: any) => void) => {\n      if (!transport) {\n        console.warn('[PlayerBridge] Cannot onEvent before init');\n        return () => {};\n      }\n      validateEventName(event);\n      transport.on(event, handler);\n      return () => {\n        transport?.off(event, handler);\n      };\n    },\n\n    destroy: () => {\n      window.removeEventListener('message', messageHandler);\n      transport?.destroy();\n      transport = null;\n      isInitialized = false;\n    },\n  };\n}\n"],"names":["createContext","useContext","useState","useEffect","useMemo","jsx","EVENT_NAME_REGEX","validateEventName","useRef","useCallback"],"mappings":"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"}

package/dist/esm/hooks/useGameHost.js

@@ -11,10 +11,13 @@ const SYSTEM_EVENTS = {
   SEND_TO_PLAYER: `${SYSTEM_PREFIX}send-to-player`,
   BROADCAST: `${SYSTEM_PREFIX}broadcast`
 };
+const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
 function validateEventName(event) {
-  if (event.includes(":")) {
+  if (!EVENT_NAME_REGEX.test(event)) {
     throw new Error(
-      `[SDK] Invalid event name "${event}". Event names must not contain colons (:). Use underscores (_) or hyphens (-) instead.`
+      `[SDK] 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 _)`
     );
   }
 }
@@ -47,7 +50,7 @@ function useGameHost(config = {}) {
       onPlayerJoinRef.current?.(data.player);
     };
     const handlePlayerLeave = (data) => {
-      onPlayerLeaveRef.current?.(data.playerId);
+      onPlayerLeaveRef.current?.(data.sessionId);
     };
     transport.on(SYSTEM_EVENTS.READY, handleReady);
     transport.on(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);
@@ -76,7 +79,8 @@ function useGameHost(config = {}) {
       if (!handler) continue;
       validateEventName(event);
       const wrappedHandler = (data) => {
-        handler(data.playerId, data.payload);
+        const { sessionId, ...rest } = data;
+        handler(sessionId, rest);
       };
       transport.on(event, wrappedHandler);
       cleanups.push(() => transport.off(event, wrappedHandler));
@@ -93,10 +97,10 @@ function useGameHost(config = {}) {
     [transport]
   );
   const sendToPlayer = useCallback(
-    (playerId, event, data) => {
+    (sessionId, event, data) => {
       validateEventName(event);
       transport?.emit(SYSTEM_EVENTS.SEND_TO_PLAYER, {
-        targetPlayerId: playerId,
+        targetSessionId: sessionId,
         event,
         data
       });