@smoregg/sdk 1.2.0 → 2.0.0

package/dist/cjs/hooks/useExternalGames.cjs

@@ -1,49 +0,0 @@
-'use strict';
-
-var react = require('react');
-
-function useExternalGames(config) {
-  const { serverUrl, enabled = true } = config;
-  const [games, setGames] = react.useState([]);
-  const [loading, setLoading] = react.useState(false);
-  const [error, setError] = react.useState(null);
-  const [refreshKey, setRefreshKey] = react.useState(0);
-  react.useEffect(() => {
-    if (!enabled) return;
-    let cancelled = false;
-    setLoading(true);
-    fetch(`${serverUrl}/api/games`).then((res) => res.json()).then((data) => {
-      if (cancelled) return;
-      const external = (data.games || []).map((g) => ({
-        id: g.id,
-        title: g.title,
-        description: g.description || "",
-        minPlayers: g.minPlayers || 2,
-        maxPlayers: g.maxPlayers || 8,
-        thumbnail: g.thumbnail || "/thumbnails/g8.jpeg",
-        categories: g.categories || ["party"],
-        type: "external",
-        hostUrl: g.hostUrl,
-        playerUrl: g.playerUrl,
-        available: !!(g.hostUrl && g.playerUrl),
-        rating: 4,
-        heroRequired: false
-      }));
-      setGames(external);
-      setError(null);
-    }).catch((err) => {
-      if (cancelled) return;
-      setError(err.message);
-    }).finally(() => {
-      if (!cancelled) setLoading(false);
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [serverUrl, enabled, refreshKey]);
-  const refresh = () => setRefreshKey((k) => k + 1);
-  return { games, loading, error, refresh };
-}
-
-exports.useExternalGames = useExternalGames;
-//# sourceMappingURL=useExternalGames.cjs.map

package/dist/cjs/hooks/useExternalGames.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"useExternalGames.cjs","sources":["../../../src/hooks/useExternalGames.ts"],"sourcesContent":["/**\n * useExternalGames - Fetches external games from the server API.\n *\n * Returns a list of GameMetadata-compatible objects for external (iframe) games.\n * Consumers merge this with their local GAMES array.\n */\n\nimport { useState, useEffect } from 'react';\n\nexport interface ExternalGameMetadata {\n  id: string;\n  title: string;\n  description: string;\n  minPlayers: number;\n  maxPlayers: number;\n  thumbnail: string;\n  categories: string[];\n  type: 'external';\n  hostUrl: string | null;\n  playerUrl: string | null;\n  available: boolean;\n  rating: number;\n  heroRequired: boolean;\n}\n\nexport interface UseExternalGamesConfig {\n  serverUrl: string;\n  enabled?: boolean;\n}\n\nexport function useExternalGames(config: UseExternalGamesConfig): {\n  games: ExternalGameMetadata[];\n  loading: boolean;\n  error: string | null;\n  refresh: () => void;\n} {\n  const { serverUrl, enabled = true } = config;\n  const [games, setGames] = useState<ExternalGameMetadata[]>([]);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const [refreshKey, setRefreshKey] = useState(0);\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    let cancelled = false;\n    setLoading(true);\n\n    fetch(`${serverUrl}/api/games`)\n      .then((res) => res.json())\n      .then((data) => {\n        if (cancelled) return;\n        const external: ExternalGameMetadata[] = (data.games || []).map((g: any) => ({\n          id: g.id,\n          title: g.title,\n          description: g.description || '',\n          minPlayers: g.minPlayers || 2,\n          maxPlayers: g.maxPlayers || 8,\n          thumbnail: g.thumbnail || '/thumbnails/g8.jpeg',\n          categories: g.categories || ['party'],\n          type: 'external' as const,\n          hostUrl: g.hostUrl,\n          playerUrl: g.playerUrl,\n          available: !!(g.hostUrl && g.playerUrl),\n          rating: 4.0,\n          heroRequired: false,\n        }));\n        setGames(external);\n        setError(null);\n      })\n      .catch((err) => {\n        if (cancelled) return;\n        setError(err.message);\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n\n    return () => { cancelled = true; };\n  }, [serverUrl, enabled, refreshKey]);\n\n  const refresh = () => setRefreshKey((k) => k + 1);\n\n  return { games, loading, error, refresh };\n}\n"],"names":["useState","useEffect"],"mappings":";;;;AA8BO,SAAS,iBAAiB,MAAA,EAK/B;AACA,EAAA,MAAM,EAAE,SAAA,EAAW,OAAA,GAAU,IAAA,EAAK,GAAI,MAAA;AACtC,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,cAAA,CAAiC,EAAE,CAAA;AAC7D,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,eAAS,KAAK,CAAA;AAC5C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,eAAwB,IAAI,CAAA;AACtD,EAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAIA,eAAS,CAAC,CAAA;AAE9C,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AAEd,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,UAAA,CAAW,IAAI,CAAA;AAEf,IAAA,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,UAAA,CAAY,CAAA,CAC3B,IAAA,CAAK,CAAC,GAAA,KAAQ,GAAA,CAAI,IAAA,EAAM,CAAA,CACxB,IAAA,CAAK,CAAC,IAAA,KAAS;AACd,MAAA,IAAI,SAAA,EAAW;AACf,MAAA,MAAM,YAAoC,IAAA,CAAK,KAAA,IAAS,EAAC,EAAG,GAAA,CAAI,CAAC,CAAA,MAAY;AAAA,QAC3E,IAAI,CAAA,CAAE,EAAA;AAAA,QACN,OAAO,CAAA,CAAE,KAAA;AAAA,QACT,WAAA,EAAa,EAAE,WAAA,IAAe,EAAA;AAAA,QAC9B,UAAA,EAAY,EAAE,UAAA,IAAc,CAAA;AAAA,QAC5B,UAAA,EAAY,EAAE,UAAA,IAAc,CAAA;AAAA,QAC5B,SAAA,EAAW,EAAE,SAAA,IAAa,qBAAA;AAAA,QAC1B,UAAA,EAAY,CAAA,CAAE,UAAA,IAAc,CAAC,OAAO,CAAA;AAAA,QACpC,IAAA,EAAM,UAAA;AAAA,QACN,SAAS,CAAA,CAAE,OAAA;AAAA,QACX,WAAW,CAAA,CAAE,SAAA;AAAA,QACb,SAAA,EAAW,CAAC,EAAE,CAAA,CAAE,WAAW,CAAA,CAAE,SAAA,CAAA;AAAA,QAC7B,MAAA,EAAQ,CAAA;AAAA,QACR,YAAA,EAAc;AAAA,OAChB,CAAE,CAAA;AACF,MAAA,QAAA,CAAS,QAAQ,CAAA;AACjB,MAAA,QAAA,CAAS,IAAI,CAAA;AAAA,IACf,CAAC,CAAA,CACA,KAAA,CAAM,CAAC,GAAA,KAAQ;AACd,MAAA,IAAI,SAAA,EAAW;AACf,MAAA,QAAA,CAAS,IAAI,OAAO,CAAA;AAAA,IACtB,CAAC,CAAA,CACA,OAAA,CAAQ,MAAM;AACb,MAAA,IAAI,CAAC,SAAA,EAAW,UAAA,CAAW,KAAK,CAAA;AAAA,IAClC,CAAC,CAAA;AAEH,IAAA,OAAO,MAAM;AAAE,MAAA,SAAA,GAAY,IAAA;AAAA,IAAM,CAAA;AAAA,EACnC,CAAA,EAAG,CAAC,SAAA,EAAW,OAAA,EAAS,UAAU,CAAC,CAAA;AAEnC,EAAA,MAAM,UAAU,MAAM,aAAA,CAAc,CAAC,CAAA,KAAM,IAAI,CAAC,CAAA;AAEhD,EAAA,OAAO,EAAE,KAAA,EAAO,OAAA,EAAS,KAAA,EAAO,OAAA,EAAQ;AAC1C;;;;"}

package/dist/cjs/hooks/useGameHost.cjs

@@ -1,206 +0,0 @@
-'use strict';
-
-var react = require('react');
-var RoomProvider = require('../context/RoomProvider.cjs');
-var connectionMonitor = require('../utils/connectionMonitor.cjs');
-
-const SYSTEM_PREFIX = "smore:";
-const SYSTEM_EVENTS = {
-  READY: `${SYSTEM_PREFIX}ready`,
-  PLAYER_JOIN: `${SYSTEM_PREFIX}player-join`,
-  PLAYER_LEAVE: `${SYSTEM_PREFIX}player-leave`,
-  GAME_OVER: `${SYSTEM_PREFIX}game-over`,
-  RETURN_TO_LOBBY: `${SYSTEM_PREFIX}return-to-lobby`,
-  SEND_TO_PLAYER: `${SYSTEM_PREFIX}send-to-player`,
-  BROADCAST: `${SYSTEM_PREFIX}broadcast`,
-  CUSTOM_STATE_CHANGE: `${SYSTEM_PREFIX}custom-state-change`
-};
-const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
-function validateEventName(event) {
-  if (!EVENT_NAME_REGEX.test(event)) {
-    throw new Error(
-      `[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 _)`
-    );
-  }
-}
-function useGameHost(config = {}) {
-  const { onReady, onPlayerJoin, onPlayerLeave, listeners, connectionMonitor: connectionMonitor$1, onCustomStateChange } = config;
-  const hostRoom = RoomProvider.useHostRoom();
-  const transport = RoomProvider.useTransport();
-  const [isPaused, setIsPaused] = react.useState(false);
-  const [latency, setLatency] = react.useState(0);
-  const monitorRef = react.useRef(null);
-  const onReadyRef = react.useRef(onReady);
-  const onPlayerJoinRef = react.useRef(onPlayerJoin);
-  const onPlayerLeaveRef = react.useRef(onPlayerLeave);
-  const listenersRef = react.useRef(listeners);
-  const onCustomStateChangeRef = react.useRef(onCustomStateChange);
-  react.useEffect(() => {
-    onReadyRef.current = onReady;
-  }, [onReady]);
-  react.useEffect(() => {
-    onPlayerJoinRef.current = onPlayerJoin;
-  }, [onPlayerJoin]);
-  react.useEffect(() => {
-    onPlayerLeaveRef.current = onPlayerLeave;
-  }, [onPlayerLeave]);
-  react.useEffect(() => {
-    listenersRef.current = listeners;
-  }, [listeners]);
-  react.useEffect(() => {
-    onCustomStateChangeRef.current = onCustomStateChange;
-  }, [onCustomStateChange]);
-  react.useEffect(() => {
-    if (!connectionMonitor$1?.enabled || !transport) return;
-    const socket = transport.socket;
-    if (!socket) {
-      console.warn("[useGameHost] Connection monitor requires Socket.IO transport");
-      return;
-    }
-    const monitor = connectionMonitor.createConnectionMonitor(socket, {
-      onPause: () => {
-        setIsPaused(true);
-        connectionMonitor$1.onPause();
-      },
-      onResume: () => {
-        setIsPaused(false);
-        connectionMonitor$1.onResume();
-      },
-      onCountdown: connectionMonitor$1.onCountdown,
-      latencyThreshold: connectionMonitor$1.latencyThreshold,
-      resumeCountdown: connectionMonitor$1.resumeCountdown
-    });
-    monitorRef.current = monitor;
-    const latencyInterval = setInterval(() => {
-      setLatency(monitor.getLatency());
-    }, 1e3);
-    return () => {
-      monitor.destroy();
-      clearInterval(latencyInterval);
-      monitorRef.current = null;
-    };
-  }, [connectionMonitor$1, transport]);
-  react.useEffect(() => {
-    if (!transport) return;
-    const handleReady = () => {
-      onReadyRef.current?.();
-    };
-    const handlePlayerJoin = (data) => {
-      const playerIndex = data.player?.playerIndex;
-      if (playerIndex !== void 0) {
-        onPlayerJoinRef.current?.(playerIndex);
-      }
-    };
-    const handlePlayerLeave = (data) => {
-      const playerIndex = data.playerIndex;
-      if (playerIndex !== void 0) {
-        onPlayerLeaveRef.current?.(playerIndex);
-      }
-    };
-    const handleCustomStateChange = (data) => {
-      if (data.playerIndex !== void 0) {
-        onCustomStateChangeRef.current?.(data.playerIndex, data.state);
-      }
-    };
-    transport.on(SYSTEM_EVENTS.READY, handleReady);
-    transport.on(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);
-    transport.on(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);
-    transport.on(SYSTEM_EVENTS.CUSTOM_STATE_CHANGE, handleCustomStateChange);
-    transport.on("room:player-left", (data) => {
-      const playerIndex = data?.playerIndex ?? data?.player?.playerIndex;
-      if (playerIndex !== void 0) {
-        onPlayerLeaveRef.current?.(playerIndex);
-      }
-    });
-    transport.on("room:player-joined", (data) => {
-      const playerIndex = data?.player?.playerIndex;
-      if (playerIndex !== void 0) {
-        onPlayerJoinRef.current?.(playerIndex);
-      }
-    });
-    return () => {
-      transport.off(SYSTEM_EVENTS.READY, handleReady);
-      transport.off(SYSTEM_EVENTS.PLAYER_JOIN, handlePlayerJoin);
-      transport.off(SYSTEM_EVENTS.PLAYER_LEAVE, handlePlayerLeave);
-      transport.off(SYSTEM_EVENTS.CUSTOM_STATE_CHANGE, handleCustomStateChange);
-      transport.off("room:player-left");
-      transport.off("room:player-joined");
-    };
-  }, [transport]);
-  react.useEffect(() => {
-    if (!transport || !listeners) return;
-    const entries = Object.entries(listeners);
-    const cleanups = [];
-    for (const [event, handler] of entries) {
-      if (!handler) continue;
-      validateEventName(event);
-      const wrappedHandler = (data) => {
-        const { playerIndex, ...rest } = data;
-        if (playerIndex !== void 0) {
-          handler(playerIndex, rest);
-        }
-      };
-      transport.on(event, wrappedHandler);
-      cleanups.push(() => transport.off(event, wrappedHandler));
-    }
-    return () => {
-      cleanups.forEach((cleanup) => cleanup());
-    };
-  }, [transport, listeners]);
-  const emit = react.useCallback(
-    (event, data) => {
-      validateEventName(event);
-      transport?.emit(SYSTEM_EVENTS.BROADCAST, { event, data });
-    },
-    [transport]
-  );
-  const sendToPlayer = react.useCallback(
-    (playerIndex, event, data) => {
-      validateEventName(event);
-      transport?.emit(SYSTEM_EVENTS.SEND_TO_PLAYER, {
-        targetPlayerIndex: playerIndex,
-        event,
-        data
-      });
-    },
-    [transport]
-  );
-  const gameOver = react.useCallback(
-    (results) => {
-      transport?.emit(SYSTEM_EVENTS.GAME_OVER, { results });
-    },
-    [transport]
-  );
-  const returnToLobby = react.useCallback(() => {
-    transport?.emit(SYSTEM_EVENTS.RETURN_TO_LOBBY, {});
-  }, [transport]);
-  const setCustomState = react.useCallback(
-    (state) => {
-      transport?.emit(SYSTEM_EVENTS.CUSTOM_STATE_CHANGE, { state });
-    },
-    [transport]
-  );
-  const leaderIndex = react.useMemo(() => {
-    if ("leaderIndex" in hostRoom && typeof hostRoom.leaderIndex === "number") {
-      return hostRoom.leaderIndex;
-    }
-    return -1;
-  }, [hostRoom]);
-  return {
-    players: hostRoom.players,
-    leaderIndex,
-    roomCode: hostRoom.roomCode,
-    emit,
-    sendToPlayer,
-    gameOver,
-    returnToLobby,
-    setCustomState,
-    isPaused,
-    latency
-  };
-}
-
-exports.useGameHost = useGameHost;
-//# sourceMappingURL=useGameHost.cjs.map

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

@@ -1 +0,0 @@
-{"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, leaderIndex, roomCode)\n * - Event listeners for player inputs (using playerIndex)\n * - Broadcasting to all/specific players (by playerIndex)\n * - Game lifecycle management\n * - Optional connection monitoring (pause/resume on network issues)\n *\n * All callbacks receive playerIndex (number) instead of sessionId (string).\n * This aligns with the SDK's external API which never exposes sessionId.\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, useState, useMemo } from 'react';\nimport { useHostRoom, useTransport } from '../context/RoomProvider';\nimport type { Player } from '../types';\nimport type { Socket } from 'socket.io-client';\nimport { createConnectionMonitor } from '../utils/connectionMonitor';\nimport type { ConnectionMonitorOptions } from '../utils/connectionMonitor';\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  CUSTOM_STATE_CHANGE: `${SYSTEM_PREFIX}custom-state-change`,\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?: (playerIndex: number) => void;\n\n  /** Called when a player leaves the room. */\n  onPlayerLeave?: (playerIndex: number) => void;\n\n  /**\n   * Event listeners for player inputs.\n   * Keys are event names (without prefix), values are handler functions.\n   * Handler receives (playerIndex, data) where playerIndex identifies the player (0, 1, 2, ...).\n   */\n  listeners?: { [K in keyof T]?: (playerIndex: number, data: T[K]) => void };\n\n  /**\n   * Optional connection monitoring (AirConsole pattern).\n   * When enabled, automatically pauses/resumes game on connection issues.\n   */\n  connectionMonitor?: {\n    /** Enable connection monitoring */\n    enabled: boolean;\n    /** Called when connection becomes unstable */\n    onPause: () => void;\n    /** Called after connection restores and countdown completes */\n    onResume: () => void;\n    /** Called during resume countdown with seconds remaining */\n    onCountdown?: (secondsLeft: number) => void;\n    /** Latency threshold to trigger pause (ms), default 2000 */\n    latencyThreshold?: number;\n    /** Resume countdown duration (ms), default 3000 */\n    resumeCountdown?: number;\n  };\n\n  /** Called when any device's custom state changes (AirConsole pattern) */\n  onCustomStateChange?: (playerIndex: number, state: Record<string, any>) => void;\n}\n\nexport interface UseGameHostReturn {\n  /** List of all players in the room. */\n  players: Player[];\n\n  /** The player index of the room leader (-1 if no leader). */\n  leaderIndex: number;\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: (playerIndex: number, 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  /** Set custom device state (AirConsole pattern) - merges with existing state */\n  setCustomState: (state: Record<string, any>) => void;\n\n  /** Whether game is currently paused due to connection issues (only if connectionMonitor enabled) */\n  isPaused: boolean;\n\n  /** Current network latency in ms (only if connectionMonitor enabled) */\n  latency: number;\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, connectionMonitor, onCustomStateChange } = config;\n\n  const hostRoom = useHostRoom();\n  const transport = useTransport();\n\n  // Connection monitor state\n  const [isPaused, setIsPaused] = useState(false);\n  const [latency, setLatency] = useState(0);\n  const monitorRef = useRef<ReturnType<typeof createConnectionMonitor> | null>(null);\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  const onCustomStateChangeRef = useRef(onCustomStateChange);\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  useEffect(() => {\n    onCustomStateChangeRef.current = onCustomStateChange;\n  }, [onCustomStateChange]);\n\n  // -------------------------------------------------------------------------\n  // Connection Monitor\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!connectionMonitor?.enabled || !transport) return;\n\n    // Check if transport has socket property (Socket.IO)\n    const socket = (transport as any).socket as Socket | undefined;\n    if (!socket) {\n      console.warn('[useGameHost] Connection monitor requires Socket.IO transport');\n      return;\n    }\n\n    const monitor = createConnectionMonitor(socket, {\n      onPause: () => {\n        setIsPaused(true);\n        connectionMonitor.onPause();\n      },\n      onResume: () => {\n        setIsPaused(false);\n        connectionMonitor.onResume();\n      },\n      onCountdown: connectionMonitor.onCountdown,\n      latencyThreshold: connectionMonitor.latencyThreshold,\n      resumeCountdown: connectionMonitor.resumeCountdown,\n    });\n\n    monitorRef.current = monitor;\n\n    // Periodically update latency state\n    const latencyInterval = setInterval(() => {\n      setLatency(monitor.getLatency());\n    }, 1000);\n\n    return () => {\n      monitor.destroy();\n      clearInterval(latencyInterval);\n      monitorRef.current = null;\n    };\n  }, [connectionMonitor, transport]);\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      const playerIndex = data.player?.playerIndex;\n      if (playerIndex !== undefined) {\n        onPlayerJoinRef.current?.(playerIndex);\n      }\n    };\n\n    const handlePlayerLeave = (data: { playerIndex: number }) => {\n      const playerIndex = data.playerIndex;\n      if (playerIndex !== undefined) {\n        onPlayerLeaveRef.current?.(playerIndex);\n      }\n    };\n\n    const handleCustomStateChange = (data: { playerIndex: number; state: Record<string, any> }) => {\n      if (data.playerIndex !== undefined) {\n        onCustomStateChangeRef.current?.(data.playerIndex, data.state);\n      }\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    transport.on(SYSTEM_EVENTS.CUSTOM_STATE_CHANGE, handleCustomStateChange);\n\n    // Also listen to legacy room events for backward compatibility\n    transport.on('room:player-left', (data: any) => {\n      const playerIndex = data?.playerIndex ?? data?.player?.playerIndex;\n      if (playerIndex !== undefined) {\n        onPlayerLeaveRef.current?.(playerIndex);\n      }\n    });\n    transport.on('room:player-joined', (data: any) => {\n      const playerIndex = data?.player?.playerIndex;\n      if (playerIndex !== undefined) {\n        onPlayerJoinRef.current?.(playerIndex);\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(SYSTEM_EVENTS.CUSTOM_STATE_CHANGE, handleCustomStateChange);\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: { playerIndex, ...playerData }\n      const wrappedHandler = (data: { playerIndex: number; [key: string]: any }) => {\n        const { playerIndex, ...rest } = data;\n        if (playerIndex !== undefined) {\n          (handler as (playerIndex: number, data: any) => void)(playerIndex, rest);\n        }\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    (playerIndex: number, 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        targetPlayerIndex: playerIndex,\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  const setCustomState = useCallback(\n    (state: Record<string, any>) => {\n      transport?.emit(SYSTEM_EVENTS.CUSTOM_STATE_CHANGE, { state });\n    },\n    [transport]\n  );\n\n  // Compute leaderIndex from leaderId by finding the matching player\n  // If leaderId exists, find the player with that sessionId (legacy) or just use the first player as leader\n  // Since we're transitioning away from sessionId, we look for leaderIndex in the room state\n  // For now, we compute it from leaderId by finding the player at index 0 (leader is typically first joiner)\n  // or return -1 if no leader\n  const leaderIndex = useMemo(() => {\n    // If hostRoom has leaderIndex directly, use it\n    if ('leaderIndex' in hostRoom && typeof (hostRoom as any).leaderIndex === 'number') {\n      return (hostRoom as any).leaderIndex;\n    }\n    // Fallback: if leaderId exists, we can't map it without sessionId, so return -1\n    // This is a transitional state - the server should send leaderIndex instead\n    return -1;\n  }, [hostRoom]);\n\n  return {\n    players: hostRoom.players,\n    leaderIndex,\n    roomCode: hostRoom.roomCode,\n    emit,\n    sendToPlayer,\n    gameOver,\n    returnToLobby,\n    setCustomState,\n    isPaused,\n    latency,\n  };\n}\n"],"names":["connectionMonitor","useHostRoom","useTransport","useState","useRef","useEffect","createConnectionMonitor","useCallback","useMemo"],"mappings":"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"}

package/dist/cjs/hooks/useGamePlayer.cjs

@@ -1,134 +0,0 @@
-'use strict';
-
-var react = require('react');
-var RoomProvider = require('../context/RoomProvider.cjs');
-var connectionMonitor = require('../utils/connectionMonitor.cjs');
-
-const EVENT_NAME_REGEX = /^[a-zA-Z]([a-zA-Z_-]*[a-zA-Z])?$/;
-function validateEventName(event) {
-  if (!EVENT_NAME_REGEX.test(event)) {
-    throw new Error(
-      `[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 _)`
-    );
-  }
-}
-function useGamePlayer(config = {}) {
-  const room = RoomProvider.usePlayerRoom();
-  const transport = RoomProvider.useTransport();
-  const { onReady, onPlayerJoin, onPlayerLeave, listeners, onCustomStateChange, connectionMonitor: connectionMonitor$1 } = config;
-  const [isPaused, setIsPaused] = react.useState(false);
-  const [latency, setLatency] = react.useState(0);
-  const monitorRef = react.useRef(null);
-  const onReadyRef = react.useRef(onReady);
-  const onPlayerJoinRef = react.useRef(onPlayerJoin);
-  const onPlayerLeaveRef = react.useRef(onPlayerLeave);
-  const listenersRef = react.useRef(listeners);
-  const onCustomStateChangeRef = react.useRef(onCustomStateChange);
-  onReadyRef.current = onReady;
-  onPlayerJoinRef.current = onPlayerJoin;
-  onPlayerLeaveRef.current = onPlayerLeave;
-  listenersRef.current = listeners;
-  onCustomStateChangeRef.current = onCustomStateChange;
-  react.useEffect(() => {
-    if (!connectionMonitor$1?.enabled || !transport) return;
-    const socket = transport.socket;
-    if (!socket) {
-      console.warn("[useGamePlayer] Connection monitor requires Socket.IO transport");
-      return;
-    }
-    const monitor = connectionMonitor.createConnectionMonitor(socket, {
-      onPause: () => {
-        setIsPaused(true);
-        connectionMonitor$1.onPause();
-      },
-      onResume: () => {
-        setIsPaused(false);
-        connectionMonitor$1.onResume();
-      },
-      onCountdown: connectionMonitor$1.onCountdown,
-      latencyThreshold: connectionMonitor$1.latencyThreshold,
-      resumeCountdown: connectionMonitor$1.resumeCountdown
-    });
-    monitorRef.current = monitor;
-    const latencyInterval = setInterval(() => {
-      setLatency(monitor.getLatency());
-    }, 1e3);
-    return () => {
-      monitor.destroy();
-      clearInterval(latencyInterval);
-      monitorRef.current = null;
-    };
-  }, [connectionMonitor$1, transport]);
-  react.useEffect(() => {
-    if (!transport) return;
-    const handleReady = () => {
-      onReadyRef.current?.();
-    };
-    const handlePlayerJoin = (player) => {
-      onPlayerJoinRef.current?.(player);
-    };
-    const handlePlayerLeave = (data) => {
-      const playerIndex = data.player?.playerIndex ?? data.playerIndex;
-      if (playerIndex !== void 0) {
-        onPlayerLeaveRef.current?.(playerIndex);
-      }
-    };
-    const handleCustomStateChange = (data) => {
-      if (data.playerIndex !== void 0) {
-        onCustomStateChangeRef.current?.(data.playerIndex, data.state);
-      }
-    };
-    transport.on("smore:ready", handleReady);
-    transport.on("smore:player-join", handlePlayerJoin);
-    transport.on("smore:player-leave", handlePlayerLeave);
-    transport.on("smore:custom-state-change", handleCustomStateChange);
-    return () => {
-      transport.off("smore:ready", handleReady);
-      transport.off("smore:player-join", handlePlayerJoin);
-      transport.off("smore:player-leave", handlePlayerLeave);
-      transport.off("smore:custom-state-change", handleCustomStateChange);
-    };
-  }, [transport]);
-  react.useEffect(() => {
-    if (!transport || !listenersRef.current) return;
-    const cleanups = [];
-    Object.entries(listenersRef.current).forEach(([event, handler]) => {
-      if (handler) {
-        transport.on(event, handler);
-        cleanups.push(() => transport.off(event, handler));
-      }
-    });
-    return () => cleanups.forEach((fn) => fn());
-  }, [transport, listeners]);
-  const emit = react.useCallback(
-    (event, data) => {
-      if (!transport) return;
-      validateEventName(event);
-      transport.emit(event, data);
-    },
-    [transport]
-  );
-  const setCustomState = react.useCallback(
-    (state) => {
-      if (!transport) return;
-      transport.emit("smore:custom-state-change", { state });
-    },
-    [transport]
-  );
-  return {
-    players: room.players,
-    leaderId: room.leaderId,
-    roomCode: room.roomCode,
-    myIndex: room.myIndex,
-    isLeader: room.isLeader,
-    emit,
-    setCustomState,
-    isPaused,
-    latency
-  };
-}
-
-exports.useGamePlayer = useGamePlayer;
-//# sourceMappingURL=useGamePlayer.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useGamePlayer.cjs","sources":["../../../src/hooks/useGamePlayer.ts"],"sourcesContent":["import { useEffect, useCallback, useRef, useState } from 'react';\nimport { usePlayerRoom } from '../context/RoomProvider';\nimport { useTransport } from '../context/RoomProvider';\nimport type { Player } from '@smoregg/shared';\nimport type { Socket } from 'socket.io-client';\nimport { createConnectionMonitor } from '../utils/connectionMonitor';\nimport type { ConnectionMonitorOptions } from '../utils/connectionMonitor';\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?: (playerIndex: number) => void;\n  /** Custom event listeners (event name -> handler) */\n  listeners?: { [K in keyof T]?: (data: T[K]) => void };\n  /** Called when any device's custom state changes (AirConsole pattern) */\n  onCustomStateChange?: (playerIndex: number, state: Record<string, any>) => void;\n  /**\n   * Optional connection monitoring (AirConsole pattern).\n   * When enabled, automatically pauses/resumes game on connection issues.\n   */\n  connectionMonitor?: {\n    /** Enable connection monitoring */\n    enabled: boolean;\n    /** Called when connection becomes unstable */\n    onPause: () => void;\n    /** Called after connection restores and countdown completes */\n    onResume: () => void;\n    /** Called during resume countdown with seconds remaining */\n    onCountdown?: (secondsLeft: number) => void;\n    /** Latency threshold to trigger pause (ms), default 2000 */\n    latencyThreshold?: number;\n    /** Resume countdown duration (ms), default 3000 */\n    resumeCountdown?: number;\n  };\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 player index (0, 1, 2, ...) */\n  myIndex: number;\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  /** Set custom device state (AirConsole pattern) - merges with existing state */\n  setCustomState: (state: Record<string, any>) => void;\n  /** Whether game is currently paused due to connection issues (only if connectionMonitor enabled) */\n  isPaused: boolean;\n  /** Current network latency in ms (only if connectionMonitor enabled) */\n  latency: number;\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, onCustomStateChange, connectionMonitor } = config;\n\n  // Connection monitor state\n  const [isPaused, setIsPaused] = useState(false);\n  const [latency, setLatency] = useState(0);\n  const monitorRef = useRef<ReturnType<typeof createConnectionMonitor> | null>(null);\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  const onCustomStateChangeRef = useRef(onCustomStateChange);\n\n  onReadyRef.current = onReady;\n  onPlayerJoinRef.current = onPlayerJoin;\n  onPlayerLeaveRef.current = onPlayerLeave;\n  listenersRef.current = listeners;\n  onCustomStateChangeRef.current = onCustomStateChange;\n\n  // Connection Monitor\n  useEffect(() => {\n    if (!connectionMonitor?.enabled || !transport) return;\n\n    // Check if transport has socket property (Socket.IO)\n    const socket = (transport as any).socket as Socket | undefined;\n    if (!socket) {\n      console.warn('[useGamePlayer] Connection monitor requires Socket.IO transport');\n      return;\n    }\n\n    const monitor = createConnectionMonitor(socket, {\n      onPause: () => {\n        setIsPaused(true);\n        connectionMonitor.onPause();\n      },\n      onResume: () => {\n        setIsPaused(false);\n        connectionMonitor.onResume();\n      },\n      onCountdown: connectionMonitor.onCountdown,\n      latencyThreshold: connectionMonitor.latencyThreshold,\n      resumeCountdown: connectionMonitor.resumeCountdown,\n    });\n\n    monitorRef.current = monitor;\n\n    // Periodically update latency state\n    const latencyInterval = setInterval(() => {\n      setLatency(monitor.getLatency());\n    }, 1000);\n\n    return () => {\n      monitor.destroy();\n      clearInterval(latencyInterval);\n      monitorRef.current = null;\n    };\n  }, [connectionMonitor, transport]);\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: { player?: { playerIndex?: number }; playerIndex?: number }) => {\n      const playerIndex = data.player?.playerIndex ?? data.playerIndex;\n      if (playerIndex !== undefined) {\n        onPlayerLeaveRef.current?.(playerIndex);\n      }\n    };\n\n    const handleCustomStateChange = (data: { playerIndex?: number; state: Record<string, any> }) => {\n      if (data.playerIndex !== undefined) {\n        onCustomStateChangeRef.current?.(data.playerIndex, data.state);\n      }\n    };\n\n    transport.on('smore:ready', handleReady);\n    transport.on('smore:player-join', handlePlayerJoin);\n    transport.on('smore:player-leave', handlePlayerLeave);\n    transport.on('smore:custom-state-change', handleCustomStateChange);\n\n    return () => {\n      transport.off('smore:ready', handleReady);\n      transport.off('smore:player-join', handlePlayerJoin);\n      transport.off('smore:player-leave', handlePlayerLeave);\n      transport.off('smore:custom-state-change', handleCustomStateChange);\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  // Set custom device state (AirConsole pattern)\n  const setCustomState = useCallback(\n    (state: Record<string, any>) => {\n      if (!transport) return;\n      transport.emit('smore:custom-state-change', { state });\n    },\n    [transport]\n  );\n\n  return {\n    players: room.players,\n    leaderId: room.leaderId,\n    roomCode: room.roomCode,\n    myIndex: room.myIndex,\n    isLeader: room.isLeader,\n    emit,\n    setCustomState,\n    isPaused,\n    latency,\n  };\n}\n"],"names":["usePlayerRoom","useTransport","connectionMonitor","useState","useRef","useEffect","createConnectionMonitor","useCallback"],"mappings":"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"}