@smoregg/sdk 0.1.0

package/dist/esm/context/RoomProvider.js

@@ -0,0 +1,109 @@
+import { jsx } from 'react/jsx-runtime';
+import { createContext, useMemo, useContext } from 'react';
+import { DirectTransport } from '../transport/DirectTransport.js';
+
+const TransportContext = createContext(null);
+function useTransport() {
+  const transport = useContext(TransportContext);
+  if (!transport) {
+    throw new Error("useTransport must be used within a RoomProvider that supplies a Transport");
+  }
+  return transport;
+}
+const RoomContext = createContext(null);
+const HostRoomProvider = ({
+  roomCode,
+  players,
+  leaderId,
+  socket,
+  children
+}) => {
+  const connectedPlayers = useMemo(
+    () => players.filter((p) => p.connected !== false),
+    [players]
+  );
+  const hostState = useMemo(
+    () => ({ roomCode, players, connectedPlayers, leaderId, socket }),
+    [roomCode, players, connectedPlayers, leaderId, socket]
+  );
+  const value = useMemo(
+    () => ({
+      roomCode,
+      players,
+      connectedPlayers,
+      leaderId,
+      side: "host",
+      host: hostState,
+      player: null
+    }),
+    [roomCode, players, connectedPlayers, leaderId, hostState]
+  );
+  const transport = useMemo(() => new DirectTransport(socket), [socket]);
+  return /* @__PURE__ */ jsx(TransportContext.Provider, { value: transport, children: /* @__PURE__ */ jsx(RoomContext.Provider, { value, children }) });
+};
+const PlayerRoomProvider = ({
+  roomCode,
+  players,
+  leaderId,
+  mySessionId,
+  isLeader,
+  socket,
+  isConnected,
+  children
+}) => {
+  const connectedPlayers = useMemo(
+    () => players.filter((p) => p.connected !== false),
+    [players]
+  );
+  const playerState = useMemo(
+    () => ({
+      roomCode,
+      players,
+      connectedPlayers,
+      leaderId,
+      mySessionId,
+      isLeader,
+      socket,
+      isConnected
+    }),
+    [roomCode, players, connectedPlayers, leaderId, mySessionId, isLeader, socket, isConnected]
+  );
+  const value = useMemo(
+    () => ({
+      roomCode,
+      players,
+      connectedPlayers,
+      leaderId,
+      side: "player",
+      host: null,
+      player: playerState
+    }),
+    [roomCode, players, connectedPlayers, leaderId, playerState]
+  );
+  const transport = useMemo(() => new DirectTransport(socket), [socket]);
+  return /* @__PURE__ */ jsx(TransportContext.Provider, { value: transport, children: /* @__PURE__ */ jsx(RoomContext.Provider, { value, children }) });
+};
+function useRoom() {
+  const context = useContext(RoomContext);
+  if (!context) {
+    throw new Error("useRoom must be used within HostRoomProvider or PlayerRoomProvider");
+  }
+  return context;
+}
+function useHostRoom() {
+  const context = useRoom();
+  if (context.side !== "host" || !context.host) {
+    throw new Error("useHostRoom must be used within HostRoomProvider");
+  }
+  return context.host;
+}
+function usePlayerRoom() {
+  const context = useRoom();
+  if (context.side !== "player" || !context.player) {
+    throw new Error("usePlayerRoom must be used within PlayerRoomProvider");
+  }
+  return context.player;
+}
+
+export { HostRoomProvider, PlayerRoomProvider, RoomContext, TransportContext, useHostRoom, usePlayerRoom, useRoom, useTransport };
+//# sourceMappingURL=RoomProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RoomProvider.js","sources":["../../../src/context/RoomProvider.tsx"],"sourcesContent":["/**\n * RoomProvider - SDK Room Context\n *\n * Foundation context that all other SDK hooks depend on.\n * Provides room state (players, roomCode, leaderId) for both host and player sides.\n *\n * Also provides a Transport abstraction via TransportContext.\n * - HostRoomProvider / PlayerRoomProvider create a DirectTransport from the socket.\n * - IframeRoomProvider (external) provides a PostMessageTransport.\n *\n * Usage:\n * - Host: <HostRoomProvider roomCode={...} players={...} leaderId={...} socket={...}>\n * - Player: <PlayerRoomProvider roomCode={...} players={...} leaderId={...} mySessionId={...} isLeader={...} socket={...} isConnected={...}>\n */\n\nimport React, { createContext, useContext, useMemo } from 'react';\nimport type { Player } from '@smore/shared';\nimport type { Socket } from 'socket.io-client';\nimport type { Transport } from '../transport/types';\nimport { DirectTransport } from '../transport/DirectTransport';\n\n// ===== Transport Context =====\n\nconst TransportContext = createContext<Transport | null>(null);\n\nexport function useTransport(): Transport {\n  const transport = useContext(TransportContext);\n  if (!transport) {\n    throw new Error('useTransport must be used within a RoomProvider that supplies a Transport');\n  }\n  return transport;\n}\n\nexport { TransportContext };\n\n// ===== State Types =====\n\nexport interface RoomState {\n  roomCode: string;\n  players: Player[];\n  connectedPlayers: Player[];\n  leaderId: string | null;\n}\n\nexport interface HostRoomState extends RoomState {\n  socket: Socket;\n}\n\nexport interface PlayerRoomState extends RoomState {\n  mySessionId: string;\n  isLeader: boolean;\n  socket: Socket;\n  isConnected: boolean;\n}\n\nexport interface RoomContextValue {\n  roomCode: string;\n  players: Player[];\n  connectedPlayers: Player[];\n  leaderId: string | null;\n  side: 'host' | 'player';\n  host: HostRoomState | null;\n  player: PlayerRoomState | null;\n}\n\n// ===== Context =====\n\nexport const RoomContext = createContext<RoomContextValue | null>(null);\n\n// ===== Host Provider =====\n\ninterface HostRoomProviderProps {\n  roomCode: string;\n  players: Player[];\n  leaderId: string | null;\n  socket: Socket;\n  children: React.ReactNode;\n}\n\nexport const HostRoomProvider: React.FC<HostRoomProviderProps> = ({\n  roomCode,\n  players,\n  leaderId,\n  socket,\n  children,\n}) => {\n  const connectedPlayers = useMemo(\n    () => players.filter((p) => p.connected !== false),\n    [players]\n  );\n\n  const hostState: HostRoomState = useMemo(\n    () => ({ roomCode, players, connectedPlayers, leaderId, socket }),\n    [roomCode, players, connectedPlayers, leaderId, socket]\n  );\n\n  const value: RoomContextValue = useMemo(\n    () => ({\n      roomCode,\n      players,\n      connectedPlayers,\n      leaderId,\n      side: 'host' as const,\n      host: hostState,\n      player: null,\n    }),\n    [roomCode, players, connectedPlayers, leaderId, hostState]\n  );\n\n  const transport = useMemo(() => new DirectTransport(socket), [socket]);\n\n  return (\n    <TransportContext.Provider value={transport}>\n      <RoomContext.Provider value={value}>{children}</RoomContext.Provider>\n    </TransportContext.Provider>\n  );\n};\n\n// ===== Player Provider =====\n\ninterface PlayerRoomProviderProps {\n  roomCode: string;\n  players: Player[];\n  leaderId: string | null;\n  mySessionId: string;\n  isLeader: boolean;\n  socket: Socket;\n  isConnected: boolean;\n  children: React.ReactNode;\n}\n\nexport const PlayerRoomProvider: React.FC<PlayerRoomProviderProps> = ({\n  roomCode,\n  players,\n  leaderId,\n  mySessionId,\n  isLeader,\n  socket,\n  isConnected,\n  children,\n}) => {\n  const connectedPlayers = useMemo(\n    () => players.filter((p) => p.connected !== false),\n    [players]\n  );\n\n  const playerState: PlayerRoomState = useMemo(\n    () => ({\n      roomCode,\n      players,\n      connectedPlayers,\n      leaderId,\n      mySessionId,\n      isLeader,\n      socket,\n      isConnected,\n    }),\n    [roomCode, players, connectedPlayers, leaderId, mySessionId, isLeader, socket, isConnected]\n  );\n\n  const value: RoomContextValue = useMemo(\n    () => ({\n      roomCode,\n      players,\n      connectedPlayers,\n      leaderId,\n      side: 'player' as const,\n      host: null,\n      player: playerState,\n    }),\n    [roomCode, players, connectedPlayers, leaderId, playerState]\n  );\n\n  const transport = useMemo(() => new DirectTransport(socket), [socket]);\n\n  return (\n    <TransportContext.Provider value={transport}>\n      <RoomContext.Provider value={value}>{children}</RoomContext.Provider>\n    </TransportContext.Provider>\n  );\n};\n\n// ===== Hooks =====\n\nexport function useRoom(): RoomContextValue {\n  const context = useContext(RoomContext);\n  if (!context) {\n    throw new Error('useRoom must be used within HostRoomProvider or PlayerRoomProvider');\n  }\n  return context;\n}\n\nexport function useHostRoom(): HostRoomState {\n  const context = useRoom();\n  if (context.side !== 'host' || !context.host) {\n    throw new Error('useHostRoom must be used within HostRoomProvider');\n  }\n  return context.host;\n}\n\nexport function usePlayerRoom(): PlayerRoomState {\n  const context = useRoom();\n  if (context.side !== 'player' || !context.player) {\n    throw new Error('usePlayerRoom must be used within PlayerRoomProvider');\n  }\n  return context.player;\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/hooks/useExternalGames.js

@@ -0,0 +1,47 @@
+import { useState, useEffect } from 'react';
+
+function useExternalGames(config) {
+  const { serverUrl, enabled = true } = config;
+  const [games, setGames] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [refreshKey, setRefreshKey] = useState(0);
+  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 };
+}
+
+export { useExternalGames };
+//# sourceMappingURL=useExternalGames.js.map

package/dist/esm/hooks/useExternalGames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useExternalGames.js","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":[],"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,GAAI,QAAA,CAAiC,EAAE,CAAA;AAC7D,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAAS,KAAK,CAAA;AAC5C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAwB,IAAI,CAAA;AACtD,EAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAI,SAAS,CAAC,CAAA;AAE9C,EAAA,SAAA,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/esm/hooks/useGameHost.js

@@ -0,0 +1,133 @@
+import { useRef, useEffect, useCallback } from 'react';
+import { useHostRoom, useTransport } from '../context/RoomProvider.js';
+
+function useGameHost(config) {
+  const { gameId, onInput, onStateRequest, onPlayerLeave, onPlayerDisconnect, onPlayerReconnect, listeners } = config;
+  const hostRoom = useHostRoom();
+  const transport = useTransport();
+  const onInputRef = useRef(onInput);
+  const onStateRequestRef = useRef(onStateRequest);
+  const onPlayerLeaveRef = useRef(onPlayerLeave);
+  const onPlayerDisconnectRef = useRef(onPlayerDisconnect);
+  const onPlayerReconnectRef = useRef(onPlayerReconnect);
+  useEffect(() => {
+    onInputRef.current = onInput;
+  }, [onInput]);
+  useEffect(() => {
+    onStateRequestRef.current = onStateRequest;
+  }, [onStateRequest]);
+  useEffect(() => {
+    onPlayerLeaveRef.current = onPlayerLeave;
+  }, [onPlayerLeave]);
+  useEffect(() => {
+    onPlayerDisconnectRef.current = onPlayerDisconnect;
+  }, [onPlayerDisconnect]);
+  useEffect(() => {
+    onPlayerReconnectRef.current = onPlayerReconnect;
+  }, [onPlayerReconnect]);
+  useEffect(() => {
+    if (!transport || !onInputRef.current) return;
+    const registeredEvents = [];
+    const inputMap = onInputRef.current;
+    for (const key of Object.keys(inputMap)) {
+      const eventName = `${gameId}:${key}`;
+      const handler = (data) => {
+        const currentHandler = onInputRef.current?.[key];
+        if (currentHandler) {
+          currentHandler(data?.sessionId ?? data?.playerId, data);
+        }
+      };
+      transport.on(eventName, handler);
+      registeredEvents.push({ event: eventName, handler });
+    }
+    return () => {
+      for (const { event, handler } of registeredEvents) {
+        transport.off(event, handler);
+      }
+    };
+  }, [gameId, transport]);
+  useEffect(() => {
+    if (!transport) return;
+    const handler = (data) => {
+      const stateFn = onStateRequestRef.current;
+      if (!stateFn) return;
+      const gameState = stateFn(data.requesterId);
+      transport.emit("game:state-response", {
+        targetSessionId: data.requesterId,
+        gameState: {
+          gameId,
+          ...gameState
+        }
+      });
+    };
+    transport.on("game:state-request", handler);
+    return () => {
+      transport.off("game:state-request", handler);
+    };
+  }, [transport, gameId]);
+  useEffect(() => {
+    if (!transport) return;
+    const onLeft = (data) => {
+      onPlayerLeaveRef.current?.(data?.sessionId ?? data?.playerId);
+    };
+    const onDisconnected = (data) => {
+      onPlayerDisconnectRef.current?.(data?.sessionId ?? data?.playerId);
+    };
+    const onReconnected = (data) => {
+      onPlayerReconnectRef.current?.(data?.sessionId ?? data?.playerId);
+    };
+    transport.on("room:player-left", onLeft);
+    transport.on("room:player-disconnected", onDisconnected);
+    transport.on("room:player-reconnected", onReconnected);
+    return () => {
+      transport.off("room:player-left", onLeft);
+      transport.off("room:player-disconnected", onDisconnected);
+      transport.off("room:player-reconnected", onReconnected);
+    };
+  }, [transport]);
+  const listenersRef = useRef(listeners);
+  listenersRef.current = listeners;
+  useEffect(() => {
+    if (!transport || !listenersRef.current) return;
+    const entries = Object.entries(listenersRef.current);
+    const handlers = entries.map(([event, handler]) => {
+      transport.on(event, handler);
+      return () => {
+        transport.off(event, handler);
+      };
+    });
+    return () => handlers.forEach((fn) => fn());
+  }, [transport, listeners]);
+  const broadcast = useCallback(
+    (event, data) => {
+      transport?.emit(event, data);
+    },
+    [transport]
+  );
+  const sendToPlayer = useCallback(
+    (sessionId, event, data) => {
+      transport?.emit("game:state-to-player", {
+        targetSessionId: sessionId,
+        gameId,
+        event,
+        state: data
+      });
+    },
+    [transport, gameId]
+  );
+  const emitGameOver = useCallback(
+    (results) => {
+      transport?.emit("room:game-over", { gameId, results });
+    },
+    [transport, gameId]
+  );
+  return {
+    room: hostRoom,
+    broadcast,
+    sendToPlayer,
+    emitGameOver
+  };
+}
+
+export { useGameHost };
+//# sourceMappingURL=useGameHost.js.map

package/dist/esm/hooks/useGameHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameHost.js","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 * - Automatic room state access (via useHostRoom context)\n * - Input listening (dedicated socket events)\n * - Broadcasting to all/specific players\n * - Game over emission\n * - Player lifecycle callbacks\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 } from '../context/RoomProvider';\nimport { useTransport } from '../context/RoomProvider';\nimport type { HostRoomState } from '../context/RoomProvider';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype InputHandler = (playerId: string, data?: any) => void;\n\nexport interface UseGameHostConfig {\n  /** Unique game identifier (e.g. 'fibbage', 'wasd') */\n  gameId: string;\n\n  /**\n   * Map of action names to handler functions.\n   * Listens directly on socket for `{gameId}:{key}` events.\n   */\n  onInput?: Record<string, InputHandler>;\n\n  /**\n   * Called when a player requests game state (e.g. after returning from background).\n   * Return the current game state object to send back to that player.\n   */\n  onStateRequest?: (playerId: string) => Record<string, any>;\n\n  /** Called when a player leaves the room. */\n  onPlayerLeave?: (playerId: string) => void;\n\n  /** Called when a player disconnects (may reconnect). */\n  onPlayerDisconnect?: (playerId: string) => void;\n\n  /** Called when a previously disconnected player reconnects. */\n  onPlayerReconnect?: (playerId: string) => void;\n\n  /**\n   * Generic socket event listeners (for server broadcasts the host needs to receive).\n   * Keys are full event names, values are handler functions.\n   */\n  listeners?: Record<string, (data: any) => void>;\n}\n\nexport interface UseGameHostReturn {\n  /** Current room state from HostRoomProvider context. */\n  room: HostRoomState;\n\n  /** Broadcast an event to all players via the host socket. */\n  broadcast: (event: string, data: any) => void;\n\n  /** Send state/event to a specific player by sessionId. */\n  sendToPlayer: (sessionId: string, event: string, data: any) => void;\n\n  /** Emit game-over with optional results payload. */\n  emitGameOver: (results?: any) => void;\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useGameHost(config: UseGameHostConfig): UseGameHostReturn {\n  const { gameId, onInput, onStateRequest, onPlayerLeave, onPlayerDisconnect, onPlayerReconnect, listeners } = config;\n\n  const hostRoom = useHostRoom();\n  const transport = useTransport();\n\n  // Stable refs to avoid stale closures in listeners\n  const onInputRef = useRef(onInput);\n  const onStateRequestRef = useRef(onStateRequest);\n  const onPlayerLeaveRef = useRef(onPlayerLeave);\n  const onPlayerDisconnectRef = useRef(onPlayerDisconnect);\n  const onPlayerReconnectRef = useRef(onPlayerReconnect);\n\n  useEffect(() => { onInputRef.current = onInput; }, [onInput]);\n  useEffect(() => { onStateRequestRef.current = onStateRequest; }, [onStateRequest]);\n  useEffect(() => { onPlayerLeaveRef.current = onPlayerLeave; }, [onPlayerLeave]);\n  useEffect(() => { onPlayerDisconnectRef.current = onPlayerDisconnect; }, [onPlayerDisconnect]);\n  useEffect(() => { onPlayerReconnectRef.current = onPlayerReconnect; }, [onPlayerReconnect]);\n\n  // -------------------------------------------------------------------------\n  // Dedicated input listeners (transport events)\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport || !onInputRef.current) return;\n\n    const registeredEvents: Array<{ event: string; handler: (...args: any[]) => void }> = [];\n\n    // For each handler key, listen on transport for \"{gameId}:{key}\"\n    const inputMap = onInputRef.current;\n    for (const key of Object.keys(inputMap)) {\n      const eventName = `${gameId}:${key}`;\n      const handler = (data: any) => {\n        const currentHandler = onInputRef.current?.[key];\n        if (currentHandler) {\n          currentHandler(data?.sessionId ?? data?.playerId, data);\n        }\n      };\n      transport.on(eventName, handler);\n      registeredEvents.push({ event: eventName, handler });\n    }\n\n    return () => {\n      for (const { event, handler } of registeredEvents) {\n        transport.off(event, handler);\n      }\n    };\n  }, [gameId, transport]);\n\n  // -------------------------------------------------------------------------\n  // State request handler\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport) return;\n\n    const handler = (data: { requesterId: string }) => {\n      const stateFn = onStateRequestRef.current;\n      if (!stateFn) return;\n\n      const gameState = stateFn(data.requesterId);\n      transport.emit('game:state-response', {\n        targetSessionId: data.requesterId,\n        gameState: {\n          gameId,\n          ...gameState,\n        },\n      });\n    };\n\n    transport.on('game:state-request', handler);\n    return () => {\n      transport.off('game:state-request', handler);\n    };\n  }, [transport, gameId]);\n\n  // -------------------------------------------------------------------------\n  // Player lifecycle listeners\n  // -------------------------------------------------------------------------\n  useEffect(() => {\n    if (!transport) return;\n\n    const onLeft = (data: any) => {\n      onPlayerLeaveRef.current?.(data?.sessionId ?? data?.playerId);\n    };\n    const onDisconnected = (data: any) => {\n      onPlayerDisconnectRef.current?.(data?.sessionId ?? data?.playerId);\n    };\n    const onReconnected = (data: any) => {\n      onPlayerReconnectRef.current?.(data?.sessionId ?? data?.playerId);\n    };\n\n    transport.on('room:player-left', onLeft);\n    transport.on('room:player-disconnected', onDisconnected);\n    transport.on('room:player-reconnected', onReconnected);\n\n    return () => {\n      transport.off('room:player-left', onLeft);\n      transport.off('room:player-disconnected', onDisconnected);\n      transport.off('room:player-reconnected', onReconnected);\n    };\n  }, [transport]);\n\n  // -------------------------------------------------------------------------\n  // Generic listeners\n  // -------------------------------------------------------------------------\n  const listenersRef = useRef(listeners);\n  listenersRef.current = listeners;\n\n  useEffect(() => {\n    if (!transport || !listenersRef.current) return;\n    const entries = Object.entries(listenersRef.current);\n    const handlers = entries.map(([event, handler]) => {\n      transport.on(event, handler);\n      return () => { transport.off(event, handler); };\n    });\n    return () => handlers.forEach(fn => fn());\n  }, [transport, listeners]);\n\n  // -------------------------------------------------------------------------\n  // Actions\n  // -------------------------------------------------------------------------\n\n  const broadcast = useCallback(\n    (event: string, data: any) => {\n      transport?.emit(event, data);\n    },\n    [transport],\n  );\n\n  const sendToPlayer = useCallback(\n    (sessionId: string, event: string, data: any) => {\n      transport?.emit('game:state-to-player', {\n        targetSessionId: sessionId,\n        gameId,\n        event,\n        state: data,\n      });\n    },\n    [transport, gameId],\n  );\n\n  const emitGameOver = useCallback(\n    (results?: any) => {\n      transport?.emit('room:game-over', { gameId, results });\n    },\n    [transport, gameId],\n  );\n\n  return {\n    room: hostRoom,\n    broadcast,\n    sendToPlayer,\n    emitGameOver,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/hooks/useGamePlayer.js

@@ -0,0 +1,73 @@
+import { useState, useRef, useEffect, useCallback } from 'react';
+import { usePlayerRoom, useTransport } from '../context/RoomProvider.js';
+
+function useGamePlayer(config) {
+  const room = usePlayerRoom();
+  const transport = useTransport();
+  const { isConnected } = room;
+  const { gameId, listeners } = config;
+  const [gameState, setGameState] = useState(null);
+  const listenersRef = useRef(listeners);
+  listenersRef.current = listeners;
+  useEffect(() => {
+    if (!transport || !listenersRef.current) return;
+    const cleanups = [];
+    Object.entries(listenersRef.current).forEach(([event, handler]) => {
+      transport.on(event, handler);
+      cleanups.push(() => transport.off(event, handler));
+    });
+    return () => cleanups.forEach((fn) => fn());
+  }, [transport, listeners]);
+  useEffect(() => {
+    if (!transport) return;
+    const handler = (state) => {
+      if (state.gameId !== gameId) return;
+      setGameState(state);
+    };
+    transport.on("game:state-response", handler);
+    return () => {
+      transport.off("game:state-response", handler);
+    };
+  }, [transport, gameId]);
+  useEffect(() => {
+    if (!transport) return;
+    const handler = (data) => {
+      if (data.gameId !== gameId) return;
+      setGameState(data.state);
+    };
+    transport.on("game:state-to-player", handler);
+    return () => {
+      transport.off("game:state-to-player", handler);
+    };
+  }, [transport, gameId]);
+  useEffect(() => {
+    if (!transport) return;
+    const handler = () => {
+      if (!document.hidden) {
+        transport.emit("game:request-state", { gameId });
+      }
+    };
+    document.addEventListener("visibilitychange", handler);
+    return () => document.removeEventListener("visibilitychange", handler);
+  }, [transport, gameId]);
+  const emit = useCallback((event, data, callback) => {
+    if (!transport) return;
+    if (callback) {
+      transport.emit(event, data, callback);
+    } else {
+      transport.emit(event, data);
+    }
+  }, [transport]);
+  const sendTapInput = useCallback((action) => {
+    if (!transport) return;
+    transport.emit(`${gameId}:${action}`);
+  }, [transport, gameId]);
+  const sendHoldInput = useCallback((action, type) => {
+    if (!transport) return;
+    transport.emit(`${gameId}:${action}:${type}`);
+  }, [transport, gameId]);
+  return { room, emit, sendTapInput, sendHoldInput, isConnected, gameState };
+}
+
+export { useGamePlayer };
+//# sourceMappingURL=useGamePlayer.js.map

package/dist/esm/hooks/useGamePlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGamePlayer.js","sources":["../../../src/hooks/useGamePlayer.ts"],"sourcesContent":["import { useEffect, useCallback, useState, useRef } from 'react';\nimport { usePlayerRoom } from '../context/RoomProvider';\nimport { useTransport } from '../context/RoomProvider';\nimport type { PlayerRoomState } from '../context/RoomProvider';\n\nexport interface UseGamePlayerConfig {\n  gameId: string;\n  listeners?: Record<string, (data: any) => void>;\n}\n\nexport interface UseGamePlayerReturn {\n  room: PlayerRoomState;\n  emit: (event: string, data?: any, callback?: (response: any) => void) => void;\n  /** Emit a tap input: sends `{gameId}:{action}` event */\n  sendTapInput: (action: string) => void;\n  /** Emit a hold input: sends `{gameId}:{action}:{type}` event */\n  sendHoldInput: (action: string, type: 'START' | 'END') => void;\n  isConnected: boolean;\n  gameState: Record<string, any> | null;\n}\n\nexport function useGamePlayer(config: UseGamePlayerConfig): UseGamePlayerReturn {\n  const room = usePlayerRoom();\n  const transport = useTransport();\n  const { isConnected } = room;\n  const { gameId, listeners } = config;\n  const [gameState, setGameState] = useState<Record<string, any> | null>(null);\n  const listenersRef = useRef(listeners);\n  listenersRef.current = listeners;\n\n  // Transport listeners\n  useEffect(() => {\n    if (!transport || !listenersRef.current) return;\n    const cleanups: (() => void)[] = [];\n    Object.entries(listenersRef.current).forEach(([event, handler]) => {\n      transport.on(event, handler);\n      cleanups.push(() => transport.off(event, handler));\n    });\n    return () => cleanups.forEach(fn => fn());\n  }, [transport, listeners]);\n\n  // Reconnection: game:state-response\n  useEffect(() => {\n    if (!transport) return;\n    const handler = (state: any) => {\n      if (state.gameId !== gameId) return;\n      setGameState(state);\n    };\n    transport.on('game:state-response', handler);\n    return () => { transport.off('game:state-response', handler); };\n  }, [transport, gameId]);\n\n  // game:state-to-player (Host push)\n  useEffect(() => {\n    if (!transport) return;\n    const handler = (data: { gameId: string; state: any }) => {\n      if (data.gameId !== gameId) return;\n      setGameState(data.state);\n    };\n    transport.on('game:state-to-player', handler);\n    return () => { transport.off('game:state-to-player', handler); };\n  }, [transport, gameId]);\n\n  // Visibility change\n  useEffect(() => {\n    if (!transport) return;\n    const handler = () => {\n      if (!document.hidden) {\n        transport.emit('game:request-state', { gameId });\n      }\n    };\n    document.addEventListener('visibilitychange', handler);\n    return () => document.removeEventListener('visibilitychange', handler);\n  }, [transport, gameId]);\n\n  // API\n  const emit = useCallback((event: string, data?: any, callback?: (response: any) => void) => {\n    if (!transport) return;\n    if (callback) {\n      transport.emit(event, data, callback);\n    } else {\n      transport.emit(event, data);\n    }\n  }, [transport]);\n\n  const sendTapInput = useCallback((action: string) => {\n    if (!transport) return;\n    transport.emit(`${gameId}:${action}`);\n  }, [transport, gameId]);\n\n  const sendHoldInput = useCallback((action: string, type: 'START' | 'END') => {\n    if (!transport) return;\n    transport.emit(`${gameId}:${action}:${type}`);\n  }, [transport, gameId]);\n\n  return { room, emit, sendTapInput, sendHoldInput, isConnected, gameState };\n}\n"],"names":[],"mappings":"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"}