@beta-gamer/react 0.1.11 → 0.1.12

package/README.md

@@ -68,7 +68,7 @@ export default function GamePage({ sessionToken }: { sessionToken: string }) {
 
 | Component | Props | Description |
 |-----------|-------|-------------|
-| `BetaGamerProvider` | `token`, `serverUrl?` | Wrap your game UI with this. Handles socket connection and theme. |
+| `BetaGamerProvider` | `token`, `serverUrl?`, `connectSocket?` | Wrap your game UI with this. Handles socket connection and theme. |
 | `PlayerCard` | `player` (`"self"` \| `"opponent"`), `className?` | Player name + active-turn indicator |
 | `Timer` | `player`, `initialSeconds?`, `className?` | Live countdown clock, syncs with server |
 
@@ -91,7 +91,19 @@ export default function GamePage({ sessionToken }: { sessionToken: string }) {
 
 > **`showAfkWarning`** (default `true`) — set to `false` to hide the built-in AFK countdown banner and implement your own using the `{game}:afk_warning` / `{game}:afk_warning_cleared` socket events.
 
-## Hooks
+> **`connectSocket`** (default `true`) — set to `false` when using only board components (`ChessBoard`, `CheckersBoard`, etc.). Board components load the game inside an iframe which manages its own socket connection. Creating a second socket with the same token causes duplicate connections and AFK/turn bugs.
+
+```tsx
+// Using only board components — disable the outer socket
+<BetaGamerProvider token={token} connectSocket={false}>
+  <ChessBoard className="board" />
+</BetaGamerProvider>
+
+// Using hooks (useSocket, useGameState) — keep socket enabled (default)
+<BetaGamerProvider token={token}>
+  <MyCustomChessUI />
+</BetaGamerProvider>
+```
 
 ```tsx
 import { useGameState, useSession, useSocket, useTheme } from '@beta-gamer/react';

package/dist/index.d.mts

@@ -51,9 +51,10 @@ interface BetaGamerProviderProps {
     token: string;
     serverUrl?: string;
     socketPath?: string;
+    connectSocket?: boolean;
     children: React.ReactNode;
 }
-declare function BetaGamerProvider({ token, serverUrl, socketPath, children }: BetaGamerProviderProps): react_jsx_runtime.JSX.Element;
+declare function BetaGamerProvider({ token, serverUrl, socketPath, connectSocket, children }: BetaGamerProviderProps): react_jsx_runtime.JSX.Element;
 declare function useBetaGamer(): BetaGamerContextValue;
 
 /** Returns the current game state (status, players, winner, etc.) */

package/dist/index.d.ts

@@ -51,9 +51,10 @@ interface BetaGamerProviderProps {
     token: string;
     serverUrl?: string;
     socketPath?: string;
+    connectSocket?: boolean;
     children: React.ReactNode;
 }
-declare function BetaGamerProvider({ token, serverUrl, socketPath, children }: BetaGamerProviderProps): react_jsx_runtime.JSX.Element;
+declare function BetaGamerProvider({ token, serverUrl, socketPath, connectSocket, children }: BetaGamerProviderProps): react_jsx_runtime.JSX.Element;
 declare function useBetaGamer(): BetaGamerContextValue;
 
 /** Returns the current game state (status, players, winner, etc.) */

package/dist/index.js

@@ -56,7 +56,7 @@ function decodeToken(token) {
   return JSON.parse(atob(parts[1].replace(/-/g, "+").replace(/_/g, "/")));
 }
 var BetaGamerContext = (0, import_react.createContext)(null);
-function BetaGamerProvider({ token, serverUrl = "https://api.beta-gamer.com", socketPath = "/socket.io", children }) {
+function BetaGamerProvider({ token, serverUrl = "https://api.beta-gamer.com", socketPath = "/socket.io", connectSocket = true, children }) {
   const session = decodeToken(token);
   const [socket, setSocket] = (0, import_react.useState)(null);
   const [gameState, setGameState] = (0, import_react.useState)({
@@ -64,6 +64,7 @@ function BetaGamerProvider({ token, serverUrl = "https://api.beta-gamer.com", so
     players: session.players
   });
   (0, import_react.useEffect)(() => {
+    if (!connectSocket) return;
     const s = (0, import_socket.io)(`${serverUrl}/${session.game}`, {
       auth: { token },
       path: socketPath,

package/dist/index.mjs

@@ -13,7 +13,7 @@ function decodeToken(token) {
   return JSON.parse(atob(parts[1].replace(/-/g, "+").replace(/_/g, "/")));
 }
 var BetaGamerContext = createContext(null);
-function BetaGamerProvider({ token, serverUrl = "https://api.beta-gamer.com", socketPath = "/socket.io", children }) {
+function BetaGamerProvider({ token, serverUrl = "https://api.beta-gamer.com", socketPath = "/socket.io", connectSocket = true, children }) {
   const session = decodeToken(token);
   const [socket, setSocket] = useState(null);
   const [gameState, setGameState] = useState({
@@ -21,6 +21,7 @@ function BetaGamerProvider({ token, serverUrl = "https://api.beta-gamer.com", so
     players: session.players
   });
   useEffect(() => {
+    if (!connectSocket) return;
     const s = io(`${serverUrl}/${session.game}`, {
       auth: { token },
       path: socketPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beta-gamer/react",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "React SDK for Beta Gamer GaaS — composable game components",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",