@dimcool/sdk 0.1.30 → 0.1.31

package/README.md

@@ -2971,6 +2971,59 @@ const sdk = new SDK({
 These stores are updated by the `WsRouter` and are the single source of truth for
 realtime UI. Room membership is ref-counted and mapped to backend join/leave emits.
 
+### `gameActionsStore` Selectors
+
+Pure functions that extract derived state from `GameActionsStoreState` without any React dependency. Pass them to `useSdkSelector` in React or call them directly in Node.
+
+#### `selectGameLifecycleState(gameState)`
+
+Extracts the common lifecycle fields from any `GameStateResponse`. Accepts the state directly so it can be called after a stable `useSdkSelector` call — the selector itself returns the existing store reference, then you project outside it. This avoids creating a new object inside `getSnapshot`, which would break `useSyncExternalStore`'s referential-equality contract.
+
+```ts
+import { selectGameLifecycleState } from '@dimcool/sdk';
+
+// Correct: selector returns stable store ref, projection happens outside
+const rawState = useSdkSelector(store, (s) => s.statesByGameId[gameId] ?? null);
+const lifecycle = selectGameLifecycleState(rawState);
+// { status, winnerId, betAmount, wonAmount, totalPotMinor, currentPlayerId }
+```
+
+#### `getCountdownDigit(gameId, nowMs)`
+
+Returns the current pre-game countdown digit (`3 | 2 | 1`) or `null` when the buffer has elapsed. Works for all game types (turn-based: reads `bufferEndsAt`; RPS: reads `roundState.selectionEndsAt` during the `starting` phase).
+
+```ts
+const digit = sdk.gameActionsStore.getCountdownDigit(gameId, Date.now());
+```
+
+#### `getChessClockTimes(gameId, nowMs)` / `getTicTacToeClockTimes` / `getConnect4ClockTimes`
+
+Returns live per-color clock values deducting elapsed time from the current player's budget.
+
+```ts
+const clocks = sdk.gameActionsStore.getChessClockTimes(gameId, Date.now());
+// { whiteTimeMs, blackTimeMs }
+
+const tttClocks = sdk.gameActionsStore.getTicTacToeClockTimes(
+  gameId,
+  Date.now(),
+);
+// { xTimeMs, oTimeMs }
+
+const c4Clocks = sdk.gameActionsStore.getConnect4ClockTimes(gameId, Date.now());
+// { redTimeMs, yellowTimeMs }
+```
+
+#### `getChessCapturedPieces(gameId)`
+
+Derives captured pieces from the FEN placement string — no external chess library needed.
+
+```ts
+const pieces = sdk.gameActionsStore.getChessCapturedPieces(gameId);
+// { capturedByWhite: string[], capturedByBlack: string[] }
+// e.g. capturedByWhite: ['bp', 'bp', 'br'] means white captured 2 black pawns + 1 rook
+```
+
 ### Event Bus (low-level)
 
 If you need raw event streams, use `sdk.events.subscribe(eventName, handler)`.

package/dist/index.cjs

@@ -242,6 +242,7 @@ __export(index_exports, {
   formatMoneyMinor: () => import_utils.formatMoneyMinor,
   isRetryableError: () => isRetryableError,
   logger: () => logger,
+  selectGameLifecycleState: () => selectGameLifecycleState,
   toMajor: () => import_utils.toMajor,
   withRetry: () => withRetry
 });
@@ -796,6 +797,9 @@ var Admin = class {
     this.http = http;
     this.logger = logger2;
   }
+  async getInternalBots() {
+    return this.http.get("/admin/internal-bots");
+  }
   async getUserById(id) {
     return this.http.get(`/admin/users/${id}`);
   }
@@ -3463,6 +3467,19 @@ function createGameStore(transport) {
 }
 
 // src/stores/game-actions-store.ts
+function selectGameLifecycleState(gameState) {
+  const s = gameState;
+  if (!s) return null;
+  const raw = s;
+  return {
+    status: raw.status,
+    winnerId: raw.winnerId ?? null,
+    betAmount: raw.betAmount ?? 0,
+    wonAmount: raw.wonAmount ?? null,
+    totalPotMinor: raw.totalPotMinor,
+    currentPlayerId: raw.currentPlayerId ?? null
+  };
+}
 var isRpsCompletionPayload = (payload) => payload.gameType === "rock-paper-scissors";
 function createGameActionsStore(transport) {
   const store = createSdkStore({
@@ -3484,8 +3501,21 @@ function createGameActionsStore(transport) {
     });
   };
   const isNonRpsState = (state) => Boolean(state && !isRpsState(state));
+  const pendingEvents = /* @__PURE__ */ new Map();
+  function enqueue(gameId, event) {
+    const q = pendingEvents.get(gameId) ?? [];
+    q.push(event);
+    pendingEvents.set(gameId, q);
+  }
+  function drainQueue(gameId) {
+    const q = pendingEvents.get(gameId);
+    if (!q?.length) return;
+    pendingEvents.delete(gameId);
+    for (const ev of q) applyWsEvent(ev);
+  }
   const setBaseState = (gameId, state) => {
     updateState(gameId, state);
+    drainQueue(gameId);
   };
   const clearState = (gameId) => {
     store.updateState((state) => {
@@ -3495,6 +3525,7 @@ function createGameActionsStore(transport) {
       const { [gameId]: _, ...rest } = state.statesByGameId;
       return { ...state, statesByGameId: rest };
     });
+    pendingEvents.delete(gameId);
   };
   const applyWsEvent = (event) => {
     switch (event.event) {
@@ -3513,7 +3544,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:starting": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const betAmount = typeof event.payload.betAmount === "number" ? event.payload.betAmount : void 0;
         const startedAt = typeof event.payload.startedAt === "string" ? event.payload.startedAt : current.roundState.startedAt;
         const bufferEndsAt = typeof event.payload.bufferEndsAt === "string" ? event.payload.bufferEndsAt : current.roundState.selectionEndsAt;
@@ -3534,7 +3568,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:round:started": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const actions = {};
         const baseUsers = /* @__PURE__ */ new Set();
         Object.keys(current.roundState.actions).forEach(
@@ -3568,7 +3605,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:action:received": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           roundState: {
@@ -3587,7 +3627,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:timer:cutoff": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           roundState: {
@@ -3601,7 +3644,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:round:reveal": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const actions = {};
         const payloadActions = event.payload.actions;
         Object.keys(payloadActions || {}).forEach((userId) => {
@@ -3625,7 +3671,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:round:completed": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const roundHistory = [
           ...current.roundHistory || [],
           {
@@ -3650,7 +3699,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:timeout": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const timedOutUser = event.payload.playerId;
         const action = event.payload.action;
         const updated = {
@@ -3675,7 +3727,10 @@ function createGameActionsStore(transport) {
         const payload = event.payload;
         const { gameId } = payload;
         const current = store.getState().statesByGameId[gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(gameId, event);
+          return;
+        }
         const updated = isRpsCompletionPayload(payload) && isRpsState(current) ? {
           ...current,
           status: "completed",
@@ -3724,11 +3779,15 @@ function createGameActionsStore(transport) {
         const current = store.getState().statesByGameId[gameId];
         const updated = current ? { ...current, ...incoming } : incoming;
         updateState(gameId, updated);
+        drainQueue(gameId);
         break;
       }
       case "game:rematch:requested": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const requestedBy = event.payload.requestedBy;
         const userId = event.payload.userId;
         const requested = new Set(
@@ -3744,7 +3803,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rematch:cancelled": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const requestedBy = event.payload.requestedBy ?? [];
         const updated = {
           ...current,
@@ -3755,7 +3817,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rematch:started": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           rematchRequestedBy: event.payload.playerIds ?? []
@@ -3766,7 +3831,10 @@ function createGameActionsStore(transport) {
       case "game:pot:updated": {
         const { gameId, totalPotMinor } = event.payload;
         const current = store.getState().statesByGameId[gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           totalPotMinor
@@ -3779,12 +3847,123 @@ function createGameActionsStore(transport) {
     }
   };
   const joinGame = (gameId) => transport.joinRoom(`game:${gameId}`);
+  const getCountdownDigit = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state) return null;
+    if (isRpsState(state)) {
+      if (state.roundState.phase !== "starting") return null;
+      const remaining = new Date(state.roundState.selectionEndsAt).getTime() - nowMs;
+      if (remaining <= 0) return null;
+      return Math.ceil(remaining / 1e3);
+    }
+    const bufferEndsAt = state.bufferEndsAt;
+    if (bufferEndsAt) {
+      const remaining = new Date(bufferEndsAt).getTime() - nowMs;
+      if (remaining <= 0) return null;
+      return Math.ceil(remaining / 1e3);
+    }
+    return null;
+  };
+  const getChessClockTimes = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "chess") return null;
+    const s = state;
+    let whiteMs = s.whiteTimeMs ?? 0;
+    let blackMs = s.blackTimeMs ?? 0;
+    if (s.status === "active" && s.currentPlayerId) {
+      const startedAt = Date.parse(s.turnStartedAt);
+      if (!Number.isNaN(startedAt)) {
+        const elapsed = Math.max(0, nowMs - startedAt);
+        if (s.currentPlayerId === s.whitePlayerId) {
+          whiteMs = Math.max(0, whiteMs - elapsed);
+        } else if (s.currentPlayerId === s.blackPlayerId) {
+          blackMs = Math.max(0, blackMs - elapsed);
+        }
+      }
+    }
+    return { whiteTimeMs: whiteMs, blackTimeMs: blackMs };
+  };
+  const getChessCapturedPieces = (gameId) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "chess") return null;
+    const fen = state.fen;
+    if (!fen) return { capturedByWhite: [], capturedByBlack: [] };
+    const placement = fen.split(" ")[0];
+    const white = {};
+    const black = {};
+    for (const char of placement) {
+      if (char === "/" || char >= "1" && char <= "8") continue;
+      const lower = char.toLowerCase();
+      if (char === lower) {
+        black[lower] = (black[lower] ?? 0) + 1;
+      } else {
+        white[lower] = (white[lower] ?? 0) + 1;
+      }
+    }
+    const INITIAL = {
+      p: 8,
+      r: 2,
+      n: 2,
+      b: 2,
+      q: 1,
+      k: 1
+    };
+    const capturedByWhite = [];
+    const capturedByBlack = [];
+    for (const [type, initial] of Object.entries(INITIAL)) {
+      const missingBlack = initial - (black[type] ?? 0);
+      for (let i = 0; i < missingBlack; i++) capturedByWhite.push(`b${type}`);
+      const missingWhite = initial - (white[type] ?? 0);
+      for (let i = 0; i < missingWhite; i++) capturedByBlack.push(`w${type}`);
+    }
+    return { capturedByWhite, capturedByBlack };
+  };
+  const getTicTacToeClockTimes = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "tic-tac-toe") return null;
+    const s = state;
+    let xMs = s.xTimeMs ?? 0;
+    let oMs = s.oTimeMs ?? 0;
+    if (s.status === "active" && s.currentPlayerId) {
+      const currentMark = s.playerMarks[s.currentPlayerId];
+      const startedAt = Date.parse(s.turnStartedAt);
+      if (!Number.isNaN(startedAt)) {
+        const elapsed = Math.max(0, nowMs - startedAt);
+        if (currentMark === "X") xMs = Math.max(0, xMs - elapsed);
+        else if (currentMark === "O") oMs = Math.max(0, oMs - elapsed);
+      }
+    }
+    return { xTimeMs: xMs, oTimeMs: oMs };
+  };
+  const getConnect4ClockTimes = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "connect-four") return null;
+    const s = state;
+    let redMs = s.redTimeMs ?? 0;
+    let yellowMs = s.yellowTimeMs ?? 0;
+    if (s.status === "active" && s.currentPlayerId) {
+      const currentColor = s.playerColors[s.currentPlayerId];
+      const startedAt = Date.parse(s.turnStartedAt);
+      if (!Number.isNaN(startedAt)) {
+        const elapsed = Math.max(0, nowMs - startedAt);
+        if (currentColor === "RED") redMs = Math.max(0, redMs - elapsed);
+        else if (currentColor === "YELLOW")
+          yellowMs = Math.max(0, yellowMs - elapsed);
+      }
+    }
+    return { redTimeMs: redMs, yellowTimeMs: yellowMs };
+  };
   return {
     store,
     setBaseState,
     clearState,
     applyWsEvent,
-    joinGame
+    joinGame,
+    getCountdownDigit,
+    getChessClockTimes,
+    getChessCapturedPieces,
+    getTicTacToeClockTimes,
+    getConnect4ClockTimes
   };
 }
 function isRpsState(state) {
@@ -4454,12 +4633,14 @@ var WsRouter = class {
       }
       const decoded = decodeWsEvent(eventName, payload);
       if (!decoded) return;
-      this.deps.lobbyStore.applyWsEvent(decoded);
-      this.deps.gameStore.applyWsEvent(decoded);
-      this.deps.gameActionsStore.applyWsEvent(decoded);
-      this.deps.chatStore.applyWsEvent(decoded);
-      this.deps.dmThreadsStore.applyWsEvent(decoded);
-      this.deps.notificationsStore.applyWsEvent(decoded);
+      const serverTs = payload !== null && typeof payload === "object" ? payload._serverTs : void 0;
+      const event = serverTs !== void 0 ? { ...decoded, _serverTs: serverTs } : decoded;
+      this.deps.lobbyStore.applyWsEvent(event);
+      this.deps.gameStore.applyWsEvent(event);
+      this.deps.gameActionsStore.applyWsEvent(event);
+      this.deps.chatStore.applyWsEvent(event);
+      this.deps.dmThreadsStore.applyWsEvent(event);
+      this.deps.notificationsStore.applyWsEvent(event);
     });
   }
   stop() {
@@ -4471,12 +4652,14 @@ var WsRouter = class {
       this.transport.subscribeEvent(eventName, (payload) => {
         const decoded = decodeWsEvent(eventName, payload);
         if (!decoded) return;
-        this.deps.lobbyStore.applyWsEvent(decoded);
-        this.deps.gameStore.applyWsEvent(decoded);
-        this.deps.gameActionsStore.applyWsEvent(decoded);
-        this.deps.chatStore.applyWsEvent(decoded);
-        this.deps.dmThreadsStore.applyWsEvent(decoded);
-        this.deps.notificationsStore.applyWsEvent(decoded);
+        const serverTs = payload !== null && typeof payload === "object" ? payload._serverTs : void 0;
+        const event = serverTs !== void 0 ? { ...decoded, _serverTs: serverTs } : decoded;
+        this.deps.lobbyStore.applyWsEvent(event);
+        this.deps.gameStore.applyWsEvent(event);
+        this.deps.gameActionsStore.applyWsEvent(event);
+        this.deps.chatStore.applyWsEvent(event);
+        this.deps.dmThreadsStore.applyWsEvent(event);
+        this.deps.notificationsStore.applyWsEvent(event);
       });
     }
   }
@@ -4877,6 +5060,7 @@ var import_utils = __toESM(require_dist(), 1);
   formatMoneyMinor,
   isRetryableError,
   logger,
+  selectGameLifecycleState,
   toMajor,
   withRetry
 });

package/dist/index.d.cts

@@ -1121,6 +1121,11 @@ declare class Admin {
     private http;
     private logger?;
     constructor(http: IHttpClient, logger?: ILogger | undefined);
+    getInternalBots(): Promise<(User & {
+        sol: number;
+        usdc: number;
+        publicKey: string;
+    })[]>;
     getUserById(id: string): Promise<User>;
     getUserBalance(userId: string): Promise<{
         sol: number;
@@ -1434,12 +1439,55 @@ declare function createGameStore(transport: WsTransport): GameStore;
 type GameActionsStoreState = {
     statesByGameId: Record<string, GameStateResponse>;
 };
+interface ChessClockTimes {
+    whiteTimeMs: number;
+    blackTimeMs: number;
+}
+interface ChessCapturedPieces {
+    capturedByWhite: string[];
+    capturedByBlack: string[];
+}
+interface TicTacToeClockTimes {
+    xTimeMs: number;
+    oTimeMs: number;
+}
+interface Connect4ClockTimes {
+    redTimeMs: number;
+    yellowTimeMs: number;
+}
+/**
+ * Common lifecycle fields extracted from any game state.
+ * Used by useGameLifecycle to avoid casting the raw union type.
+ */
+interface GameLifecycleState {
+    status: string;
+    winnerId: string | null;
+    betAmount: number;
+    wonAmount: number | null;
+    totalPotMinor: number | undefined;
+    currentPlayerId: string | null;
+}
+/**
+ * Pure selector — extracts lifecycle fields from any game state variant.
+ * Accepts a single GameStateResponse so callers can use it after selecting
+ * the stable store entry via useSdkSelector, avoiding new-object-per-call issues.
+ */
+declare function selectGameLifecycleState(gameState: GameStateResponse | null | undefined): GameLifecycleState | null;
 type GameActionsStore = {
     store: SdkStore<GameActionsStoreState>;
     setBaseState: (gameId: string, state: GameStateResponse) => void;
     clearState: (gameId: string) => void;
     applyWsEvent: (event: WsEvent) => void;
     joinGame: (gameId: string) => () => void;
+    getCountdownDigit: (gameId: string, nowMs: number) => number | null;
+    /** Live chess clock — deducts elapsed time since turnStartedAt. */
+    getChessClockTimes: (gameId: string, nowMs: number) => ChessClockTimes | null;
+    /** Captured pieces derived from the current FEN position. */
+    getChessCapturedPieces: (gameId: string) => ChessCapturedPieces | null;
+    /** Live TTT clock — deducts elapsed from the current player's mark (X or O). */
+    getTicTacToeClockTimes: (gameId: string, nowMs: number) => TicTacToeClockTimes | null;
+    /** Live Connect Four clock — deducts elapsed from the current player's color. */
+    getConnect4ClockTimes: (gameId: string, nowMs: number) => Connect4ClockTimes | null;
 };
 declare function createGameActionsStore(transport: WsTransport): GameActionsStore;
 
@@ -1743,7 +1791,7 @@ type LobbyDepositUpdatedPayload = {
     status: 'confirmed' | 'failed' | 'refunded' | 'refund_failed';
     allConfirmed: boolean;
 };
-type WsEvent = {
+type WsEventBase = {
     event: 'lobby:created';
     payload: Lobby;
 } | {
@@ -1941,6 +1989,9 @@ type WsEvent = {
     event: 'notification';
     payload: unknown;
 };
+type WsEvent = WsEventBase & {
+    _serverTs?: number;
+};
 
 type LobbyMatchedEvent = {
     gameId: string;
@@ -3006,4 +3057,4 @@ declare class HttpClient implements IHttpClient {
     private payChallenge;
 }
 
-export { type AcceptChallengeResponse, type Achievement, Activity, type ActivityFeedItem, type ActivityFeedItemType, type ActivityFeedResponse, type ActivityFeedUser, Admin, type AdminDailyStats, type AdminDailyStatsItem, type AdminFeatureFlag, type AdminGameHistory, type AdminGameHistoryFeeBreakdown, type AdminGameHistoryFeePlayer, type AdminGameHistoryPlayer, type AdminMarketDailyStats, type AdminMarketDailyStatsItem, type AdminMarketDetail, type AdminMarketStats, type AdminStats, type AdminWalletActivityItem, type AdminWalletActivityResponse, type AnalyticsUserData, type ApiError, type AppNotification, type AppNotificationType, type ApplyReferralCodeResponse, type BalanceResponse, type BetOption, type BroadcastTipRequest, BrowserLocalStorage, Challenges, Chat, type ChatContext, type ChatContextType, type ChatMessage, type ChatMessageReply, type ChatMessageType, type ChatReaction, type ChatReadBy, type ChatState, type ChatStore, type ChatStoreState, type ClaimReferralRewardsResponse, type CreateChallengeRequest, type CreateChallengeResponse, type CreateLobbyRequest, type CreateTicketData, type CriticalIncident, type CriticalIncidentCategory, type CriticalIncidentImpactType, type CriticalIncidentSeverity, type CriticalIncidentStatus, type CriticalIncidentSummary, type CurrentGame, Daily, type DailyParticipant, type DailyRoom, type DailyToken, type DepositForLobbyResponse, type DepositStatus, type DepositStatusResponse, type DmThread, type DmThreadsStore, type DmThreadsStoreState, type DonateToGameResponse, ESTIMATED_SOL_FEE_LAMPORTS, Escrow, type EscrowSweepPreview, type EscrowSweepRecord, type FaucetResponse, type FeatureFlag, type FriendRequestItem, type FriendsStore, type FriendsStoreState, type FriendshipStatus, type Game, type GameActionsStore, type GameActionsStoreState, type GameHistoryItem, type GameMetrics, type GamePlayer, type GameStateResponse, type GameStore, type GameStoreState, type GameType, Games, type GenerateHandshakeResponse, type GetTicketsOptions, HttpClient, type IAnalyticsClient, type IHttpClient, type ILogger, type IStorage, type ImageUploadPayload, type InviteFriendRequest, type LeaderboardEntry, type LeaderboardQuery, type LeaderboardRange, type LeaderboardResponse, Leaderboards, type LivePlayer, type LivePlayersPage, Lobbies, type Lobby, type LobbyDepositUpdatedPayload, type LobbyMatchedEvent, type LobbyPlayer, type LobbyStore, type LobbyStoreState, type LogLevel, type LoginResponse, MIN_SOL_TRANSFER_AMOUNT, MIN_TRANSFER_AMOUNT, type MarketBuyResult, type MarketPosition, type MarketSellResult, type MarketState, Markets, type MoneyMinor, NodeStorage, NoopAnalyticsClient, type NotificationEvent, type NotificationsStore, type NotificationsStoreState, type PaginatedCriticalIncidents, type PaginatedFriendRequests, type PaginatedFriends, type PaginatedNotificationsResponse, type PaginatedPlatformFees, type PaginatedReports, type PaginatedSearchUsers, type PaginatedSessions, type PaginatedSupportTickets, type PaginatedTransactionJobs, type PaginatedUsers, type PaymentRequiredChallenge, type PlatformFeeItem, type PrepareDepositResponse, type PrepareTipRequest, type PrepareTipResponse, type PrepareTransferRequest, type PrepareTransferResponse, type PublicUser, type QueueStats, type RedeemResult, type ReferralRewardItem, type ReferralRewardStatus, type ReferralRewardsResponse, type ReferralSummary, type ReferralTreeItem, type ReferralTreeResponse, Referrals, type Report, type ReportCount, type ReportStatus, type ReportUser, Reports, type RetryOptions, SDK, type SDKConfig, SDK_VERSION, SOL_DECIMALS, SOL_MINT, type SdkStore, type SdkUpgradeInfo, type SearchUser, type SendMessageRequest, type SendTipResponse, type SendTransferResponse, type Session, type SessionStats, SharedWorkerTransport, Spectate, type SpectatorMetrics, type SpectatorMetricsByUser, StandaloneWsTransport, type SubmitDepositResponse, type SubmitTransferRequest, type SubmitTransferResponse, Support, type SupportMessage, type SupportMessageSenderRole, type SupportTicket, type SupportTicketCategory, type SupportTicketPriority, type SupportTicketStatus, type SupportTicketUser, type SystemMessageType, TOKEN_KEY, TRANSFER_FEE_MINOR, Tips, type TransactionJob, type TransactionJobStatus, type TransactionJobType, type TransactionQueueStats, type TransferToken, type TypingUser, type UpdateTicketData, type User, type UserAchievement, type UserActivity, type UserActivityStatus, type UserStats, type UsernameAvailabilityResponse, Users, type ValidAction, Wallet, type WalletActivityCounterpartyType, type WalletActivityDirection, type WalletActivityItem, type WalletActivityKind, type WalletActivityResponse, type WalletActivityStatus, type WalletClaimAction, type WalletMeta, type WalletResponse, type WalletSigner, type WsEvent, WsEventBus, type WsEventName, type WsTransport, type ConnectionState as WsTransportState, createChatStore, createDmThreadsStore, createFriendsStore, createGameActionsStore, createGameStore, createLobbyStore, createLogger, createNotificationsStore, createSdkStore, isRetryableError, logger, withRetry };
+export { type AcceptChallengeResponse, type Achievement, Activity, type ActivityFeedItem, type ActivityFeedItemType, type ActivityFeedResponse, type ActivityFeedUser, Admin, type AdminDailyStats, type AdminDailyStatsItem, type AdminFeatureFlag, type AdminGameHistory, type AdminGameHistoryFeeBreakdown, type AdminGameHistoryFeePlayer, type AdminGameHistoryPlayer, type AdminMarketDailyStats, type AdminMarketDailyStatsItem, type AdminMarketDetail, type AdminMarketStats, type AdminStats, type AdminWalletActivityItem, type AdminWalletActivityResponse, type AnalyticsUserData, type ApiError, type AppNotification, type AppNotificationType, type ApplyReferralCodeResponse, type BalanceResponse, type BetOption, type BroadcastTipRequest, BrowserLocalStorage, Challenges, Chat, type ChatContext, type ChatContextType, type ChatMessage, type ChatMessageReply, type ChatMessageType, type ChatReaction, type ChatReadBy, type ChatState, type ChatStore, type ChatStoreState, type ChessCapturedPieces, type ChessClockTimes, type ClaimReferralRewardsResponse, type Connect4ClockTimes, type CreateChallengeRequest, type CreateChallengeResponse, type CreateLobbyRequest, type CreateTicketData, type CriticalIncident, type CriticalIncidentCategory, type CriticalIncidentImpactType, type CriticalIncidentSeverity, type CriticalIncidentStatus, type CriticalIncidentSummary, type CurrentGame, Daily, type DailyParticipant, type DailyRoom, type DailyToken, type DepositForLobbyResponse, type DepositStatus, type DepositStatusResponse, type DmThread, type DmThreadsStore, type DmThreadsStoreState, type DonateToGameResponse, ESTIMATED_SOL_FEE_LAMPORTS, Escrow, type EscrowSweepPreview, type EscrowSweepRecord, type FaucetResponse, type FeatureFlag, type FriendRequestItem, type FriendsStore, type FriendsStoreState, type FriendshipStatus, type Game, type GameActionsStore, type GameActionsStoreState, type GameHistoryItem, type GameLifecycleState, type GameMetrics, type GamePlayer, type GameStateResponse, type GameStore, type GameStoreState, type GameType, Games, type GenerateHandshakeResponse, type GetTicketsOptions, HttpClient, type IAnalyticsClient, type IHttpClient, type ILogger, type IStorage, type ImageUploadPayload, type InviteFriendRequest, type LeaderboardEntry, type LeaderboardQuery, type LeaderboardRange, type LeaderboardResponse, Leaderboards, type LivePlayer, type LivePlayersPage, Lobbies, type Lobby, type LobbyDepositUpdatedPayload, type LobbyMatchedEvent, type LobbyPlayer, type LobbyStore, type LobbyStoreState, type LogLevel, type LoginResponse, MIN_SOL_TRANSFER_AMOUNT, MIN_TRANSFER_AMOUNT, type MarketBuyResult, type MarketPosition, type MarketSellResult, type MarketState, Markets, type MoneyMinor, NodeStorage, NoopAnalyticsClient, type NotificationEvent, type NotificationsStore, type NotificationsStoreState, type PaginatedCriticalIncidents, type PaginatedFriendRequests, type PaginatedFriends, type PaginatedNotificationsResponse, type PaginatedPlatformFees, type PaginatedReports, type PaginatedSearchUsers, type PaginatedSessions, type PaginatedSupportTickets, type PaginatedTransactionJobs, type PaginatedUsers, type PaymentRequiredChallenge, type PlatformFeeItem, type PrepareDepositResponse, type PrepareTipRequest, type PrepareTipResponse, type PrepareTransferRequest, type PrepareTransferResponse, type PublicUser, type QueueStats, type RedeemResult, type ReferralRewardItem, type ReferralRewardStatus, type ReferralRewardsResponse, type ReferralSummary, type ReferralTreeItem, type ReferralTreeResponse, Referrals, type Report, type ReportCount, type ReportStatus, type ReportUser, Reports, type RetryOptions, SDK, type SDKConfig, SDK_VERSION, SOL_DECIMALS, SOL_MINT, type SdkStore, type SdkUpgradeInfo, type SearchUser, type SendMessageRequest, type SendTipResponse, type SendTransferResponse, type Session, type SessionStats, SharedWorkerTransport, Spectate, type SpectatorMetrics, type SpectatorMetricsByUser, StandaloneWsTransport, type SubmitDepositResponse, type SubmitTransferRequest, type SubmitTransferResponse, Support, type SupportMessage, type SupportMessageSenderRole, type SupportTicket, type SupportTicketCategory, type SupportTicketPriority, type SupportTicketStatus, type SupportTicketUser, type SystemMessageType, TOKEN_KEY, TRANSFER_FEE_MINOR, type TicTacToeClockTimes, Tips, type TransactionJob, type TransactionJobStatus, type TransactionJobType, type TransactionQueueStats, type TransferToken, type TypingUser, type UpdateTicketData, type User, type UserAchievement, type UserActivity, type UserActivityStatus, type UserStats, type UsernameAvailabilityResponse, Users, type ValidAction, Wallet, type WalletActivityCounterpartyType, type WalletActivityDirection, type WalletActivityItem, type WalletActivityKind, type WalletActivityResponse, type WalletActivityStatus, type WalletClaimAction, type WalletMeta, type WalletResponse, type WalletSigner, type WsEvent, WsEventBus, type WsEventName, type WsTransport, type ConnectionState as WsTransportState, createChatStore, createDmThreadsStore, createFriendsStore, createGameActionsStore, createGameStore, createLobbyStore, createLogger, createNotificationsStore, createSdkStore, isRetryableError, logger, selectGameLifecycleState, withRetry };

package/dist/index.d.ts

@@ -1121,6 +1121,11 @@ declare class Admin {
     private http;
     private logger?;
     constructor(http: IHttpClient, logger?: ILogger | undefined);
+    getInternalBots(): Promise<(User & {
+        sol: number;
+        usdc: number;
+        publicKey: string;
+    })[]>;
     getUserById(id: string): Promise<User>;
     getUserBalance(userId: string): Promise<{
         sol: number;
@@ -1434,12 +1439,55 @@ declare function createGameStore(transport: WsTransport): GameStore;
 type GameActionsStoreState = {
     statesByGameId: Record<string, GameStateResponse>;
 };
+interface ChessClockTimes {
+    whiteTimeMs: number;
+    blackTimeMs: number;
+}
+interface ChessCapturedPieces {
+    capturedByWhite: string[];
+    capturedByBlack: string[];
+}
+interface TicTacToeClockTimes {
+    xTimeMs: number;
+    oTimeMs: number;
+}
+interface Connect4ClockTimes {
+    redTimeMs: number;
+    yellowTimeMs: number;
+}
+/**
+ * Common lifecycle fields extracted from any game state.
+ * Used by useGameLifecycle to avoid casting the raw union type.
+ */
+interface GameLifecycleState {
+    status: string;
+    winnerId: string | null;
+    betAmount: number;
+    wonAmount: number | null;
+    totalPotMinor: number | undefined;
+    currentPlayerId: string | null;
+}
+/**
+ * Pure selector — extracts lifecycle fields from any game state variant.
+ * Accepts a single GameStateResponse so callers can use it after selecting
+ * the stable store entry via useSdkSelector, avoiding new-object-per-call issues.
+ */
+declare function selectGameLifecycleState(gameState: GameStateResponse | null | undefined): GameLifecycleState | null;
 type GameActionsStore = {
     store: SdkStore<GameActionsStoreState>;
     setBaseState: (gameId: string, state: GameStateResponse) => void;
     clearState: (gameId: string) => void;
     applyWsEvent: (event: WsEvent) => void;
     joinGame: (gameId: string) => () => void;
+    getCountdownDigit: (gameId: string, nowMs: number) => number | null;
+    /** Live chess clock — deducts elapsed time since turnStartedAt. */
+    getChessClockTimes: (gameId: string, nowMs: number) => ChessClockTimes | null;
+    /** Captured pieces derived from the current FEN position. */
+    getChessCapturedPieces: (gameId: string) => ChessCapturedPieces | null;
+    /** Live TTT clock — deducts elapsed from the current player's mark (X or O). */
+    getTicTacToeClockTimes: (gameId: string, nowMs: number) => TicTacToeClockTimes | null;
+    /** Live Connect Four clock — deducts elapsed from the current player's color. */
+    getConnect4ClockTimes: (gameId: string, nowMs: number) => Connect4ClockTimes | null;
 };
 declare function createGameActionsStore(transport: WsTransport): GameActionsStore;
 
@@ -1743,7 +1791,7 @@ type LobbyDepositUpdatedPayload = {
     status: 'confirmed' | 'failed' | 'refunded' | 'refund_failed';
     allConfirmed: boolean;
 };
-type WsEvent = {
+type WsEventBase = {
     event: 'lobby:created';
     payload: Lobby;
 } | {
@@ -1941,6 +1989,9 @@ type WsEvent = {
     event: 'notification';
     payload: unknown;
 };
+type WsEvent = WsEventBase & {
+    _serverTs?: number;
+};
 
 type LobbyMatchedEvent = {
     gameId: string;
@@ -3006,4 +3057,4 @@ declare class HttpClient implements IHttpClient {
     private payChallenge;
 }
 
-export { type AcceptChallengeResponse, type Achievement, Activity, type ActivityFeedItem, type ActivityFeedItemType, type ActivityFeedResponse, type ActivityFeedUser, Admin, type AdminDailyStats, type AdminDailyStatsItem, type AdminFeatureFlag, type AdminGameHistory, type AdminGameHistoryFeeBreakdown, type AdminGameHistoryFeePlayer, type AdminGameHistoryPlayer, type AdminMarketDailyStats, type AdminMarketDailyStatsItem, type AdminMarketDetail, type AdminMarketStats, type AdminStats, type AdminWalletActivityItem, type AdminWalletActivityResponse, type AnalyticsUserData, type ApiError, type AppNotification, type AppNotificationType, type ApplyReferralCodeResponse, type BalanceResponse, type BetOption, type BroadcastTipRequest, BrowserLocalStorage, Challenges, Chat, type ChatContext, type ChatContextType, type ChatMessage, type ChatMessageReply, type ChatMessageType, type ChatReaction, type ChatReadBy, type ChatState, type ChatStore, type ChatStoreState, type ClaimReferralRewardsResponse, type CreateChallengeRequest, type CreateChallengeResponse, type CreateLobbyRequest, type CreateTicketData, type CriticalIncident, type CriticalIncidentCategory, type CriticalIncidentImpactType, type CriticalIncidentSeverity, type CriticalIncidentStatus, type CriticalIncidentSummary, type CurrentGame, Daily, type DailyParticipant, type DailyRoom, type DailyToken, type DepositForLobbyResponse, type DepositStatus, type DepositStatusResponse, type DmThread, type DmThreadsStore, type DmThreadsStoreState, type DonateToGameResponse, ESTIMATED_SOL_FEE_LAMPORTS, Escrow, type EscrowSweepPreview, type EscrowSweepRecord, type FaucetResponse, type FeatureFlag, type FriendRequestItem, type FriendsStore, type FriendsStoreState, type FriendshipStatus, type Game, type GameActionsStore, type GameActionsStoreState, type GameHistoryItem, type GameMetrics, type GamePlayer, type GameStateResponse, type GameStore, type GameStoreState, type GameType, Games, type GenerateHandshakeResponse, type GetTicketsOptions, HttpClient, type IAnalyticsClient, type IHttpClient, type ILogger, type IStorage, type ImageUploadPayload, type InviteFriendRequest, type LeaderboardEntry, type LeaderboardQuery, type LeaderboardRange, type LeaderboardResponse, Leaderboards, type LivePlayer, type LivePlayersPage, Lobbies, type Lobby, type LobbyDepositUpdatedPayload, type LobbyMatchedEvent, type LobbyPlayer, type LobbyStore, type LobbyStoreState, type LogLevel, type LoginResponse, MIN_SOL_TRANSFER_AMOUNT, MIN_TRANSFER_AMOUNT, type MarketBuyResult, type MarketPosition, type MarketSellResult, type MarketState, Markets, type MoneyMinor, NodeStorage, NoopAnalyticsClient, type NotificationEvent, type NotificationsStore, type NotificationsStoreState, type PaginatedCriticalIncidents, type PaginatedFriendRequests, type PaginatedFriends, type PaginatedNotificationsResponse, type PaginatedPlatformFees, type PaginatedReports, type PaginatedSearchUsers, type PaginatedSessions, type PaginatedSupportTickets, type PaginatedTransactionJobs, type PaginatedUsers, type PaymentRequiredChallenge, type PlatformFeeItem, type PrepareDepositResponse, type PrepareTipRequest, type PrepareTipResponse, type PrepareTransferRequest, type PrepareTransferResponse, type PublicUser, type QueueStats, type RedeemResult, type ReferralRewardItem, type ReferralRewardStatus, type ReferralRewardsResponse, type ReferralSummary, type ReferralTreeItem, type ReferralTreeResponse, Referrals, type Report, type ReportCount, type ReportStatus, type ReportUser, Reports, type RetryOptions, SDK, type SDKConfig, SDK_VERSION, SOL_DECIMALS, SOL_MINT, type SdkStore, type SdkUpgradeInfo, type SearchUser, type SendMessageRequest, type SendTipResponse, type SendTransferResponse, type Session, type SessionStats, SharedWorkerTransport, Spectate, type SpectatorMetrics, type SpectatorMetricsByUser, StandaloneWsTransport, type SubmitDepositResponse, type SubmitTransferRequest, type SubmitTransferResponse, Support, type SupportMessage, type SupportMessageSenderRole, type SupportTicket, type SupportTicketCategory, type SupportTicketPriority, type SupportTicketStatus, type SupportTicketUser, type SystemMessageType, TOKEN_KEY, TRANSFER_FEE_MINOR, Tips, type TransactionJob, type TransactionJobStatus, type TransactionJobType, type TransactionQueueStats, type TransferToken, type TypingUser, type UpdateTicketData, type User, type UserAchievement, type UserActivity, type UserActivityStatus, type UserStats, type UsernameAvailabilityResponse, Users, type ValidAction, Wallet, type WalletActivityCounterpartyType, type WalletActivityDirection, type WalletActivityItem, type WalletActivityKind, type WalletActivityResponse, type WalletActivityStatus, type WalletClaimAction, type WalletMeta, type WalletResponse, type WalletSigner, type WsEvent, WsEventBus, type WsEventName, type WsTransport, type ConnectionState as WsTransportState, createChatStore, createDmThreadsStore, createFriendsStore, createGameActionsStore, createGameStore, createLobbyStore, createLogger, createNotificationsStore, createSdkStore, isRetryableError, logger, withRetry };
+export { type AcceptChallengeResponse, type Achievement, Activity, type ActivityFeedItem, type ActivityFeedItemType, type ActivityFeedResponse, type ActivityFeedUser, Admin, type AdminDailyStats, type AdminDailyStatsItem, type AdminFeatureFlag, type AdminGameHistory, type AdminGameHistoryFeeBreakdown, type AdminGameHistoryFeePlayer, type AdminGameHistoryPlayer, type AdminMarketDailyStats, type AdminMarketDailyStatsItem, type AdminMarketDetail, type AdminMarketStats, type AdminStats, type AdminWalletActivityItem, type AdminWalletActivityResponse, type AnalyticsUserData, type ApiError, type AppNotification, type AppNotificationType, type ApplyReferralCodeResponse, type BalanceResponse, type BetOption, type BroadcastTipRequest, BrowserLocalStorage, Challenges, Chat, type ChatContext, type ChatContextType, type ChatMessage, type ChatMessageReply, type ChatMessageType, type ChatReaction, type ChatReadBy, type ChatState, type ChatStore, type ChatStoreState, type ChessCapturedPieces, type ChessClockTimes, type ClaimReferralRewardsResponse, type Connect4ClockTimes, type CreateChallengeRequest, type CreateChallengeResponse, type CreateLobbyRequest, type CreateTicketData, type CriticalIncident, type CriticalIncidentCategory, type CriticalIncidentImpactType, type CriticalIncidentSeverity, type CriticalIncidentStatus, type CriticalIncidentSummary, type CurrentGame, Daily, type DailyParticipant, type DailyRoom, type DailyToken, type DepositForLobbyResponse, type DepositStatus, type DepositStatusResponse, type DmThread, type DmThreadsStore, type DmThreadsStoreState, type DonateToGameResponse, ESTIMATED_SOL_FEE_LAMPORTS, Escrow, type EscrowSweepPreview, type EscrowSweepRecord, type FaucetResponse, type FeatureFlag, type FriendRequestItem, type FriendsStore, type FriendsStoreState, type FriendshipStatus, type Game, type GameActionsStore, type GameActionsStoreState, type GameHistoryItem, type GameLifecycleState, type GameMetrics, type GamePlayer, type GameStateResponse, type GameStore, type GameStoreState, type GameType, Games, type GenerateHandshakeResponse, type GetTicketsOptions, HttpClient, type IAnalyticsClient, type IHttpClient, type ILogger, type IStorage, type ImageUploadPayload, type InviteFriendRequest, type LeaderboardEntry, type LeaderboardQuery, type LeaderboardRange, type LeaderboardResponse, Leaderboards, type LivePlayer, type LivePlayersPage, Lobbies, type Lobby, type LobbyDepositUpdatedPayload, type LobbyMatchedEvent, type LobbyPlayer, type LobbyStore, type LobbyStoreState, type LogLevel, type LoginResponse, MIN_SOL_TRANSFER_AMOUNT, MIN_TRANSFER_AMOUNT, type MarketBuyResult, type MarketPosition, type MarketSellResult, type MarketState, Markets, type MoneyMinor, NodeStorage, NoopAnalyticsClient, type NotificationEvent, type NotificationsStore, type NotificationsStoreState, type PaginatedCriticalIncidents, type PaginatedFriendRequests, type PaginatedFriends, type PaginatedNotificationsResponse, type PaginatedPlatformFees, type PaginatedReports, type PaginatedSearchUsers, type PaginatedSessions, type PaginatedSupportTickets, type PaginatedTransactionJobs, type PaginatedUsers, type PaymentRequiredChallenge, type PlatformFeeItem, type PrepareDepositResponse, type PrepareTipRequest, type PrepareTipResponse, type PrepareTransferRequest, type PrepareTransferResponse, type PublicUser, type QueueStats, type RedeemResult, type ReferralRewardItem, type ReferralRewardStatus, type ReferralRewardsResponse, type ReferralSummary, type ReferralTreeItem, type ReferralTreeResponse, Referrals, type Report, type ReportCount, type ReportStatus, type ReportUser, Reports, type RetryOptions, SDK, type SDKConfig, SDK_VERSION, SOL_DECIMALS, SOL_MINT, type SdkStore, type SdkUpgradeInfo, type SearchUser, type SendMessageRequest, type SendTipResponse, type SendTransferResponse, type Session, type SessionStats, SharedWorkerTransport, Spectate, type SpectatorMetrics, type SpectatorMetricsByUser, StandaloneWsTransport, type SubmitDepositResponse, type SubmitTransferRequest, type SubmitTransferResponse, Support, type SupportMessage, type SupportMessageSenderRole, type SupportTicket, type SupportTicketCategory, type SupportTicketPriority, type SupportTicketStatus, type SupportTicketUser, type SystemMessageType, TOKEN_KEY, TRANSFER_FEE_MINOR, type TicTacToeClockTimes, Tips, type TransactionJob, type TransactionJobStatus, type TransactionJobType, type TransactionQueueStats, type TransferToken, type TypingUser, type UpdateTicketData, type User, type UserAchievement, type UserActivity, type UserActivityStatus, type UserStats, type UsernameAvailabilityResponse, Users, type ValidAction, Wallet, type WalletActivityCounterpartyType, type WalletActivityDirection, type WalletActivityItem, type WalletActivityKind, type WalletActivityResponse, type WalletActivityStatus, type WalletClaimAction, type WalletMeta, type WalletResponse, type WalletSigner, type WsEvent, WsEventBus, type WsEventName, type WsTransport, type ConnectionState as WsTransportState, createChatStore, createDmThreadsStore, createFriendsStore, createGameActionsStore, createGameStore, createLobbyStore, createLogger, createNotificationsStore, createSdkStore, isRetryableError, logger, selectGameLifecycleState, withRetry };

package/dist/index.js

@@ -743,6 +743,9 @@ var Admin = class {
     this.http = http;
     this.logger = logger2;
   }
+  async getInternalBots() {
+    return this.http.get("/admin/internal-bots");
+  }
   async getUserById(id) {
     return this.http.get(`/admin/users/${id}`);
   }
@@ -3410,6 +3413,19 @@ function createGameStore(transport) {
 }
 
 // src/stores/game-actions-store.ts
+function selectGameLifecycleState(gameState) {
+  const s = gameState;
+  if (!s) return null;
+  const raw = s;
+  return {
+    status: raw.status,
+    winnerId: raw.winnerId ?? null,
+    betAmount: raw.betAmount ?? 0,
+    wonAmount: raw.wonAmount ?? null,
+    totalPotMinor: raw.totalPotMinor,
+    currentPlayerId: raw.currentPlayerId ?? null
+  };
+}
 var isRpsCompletionPayload = (payload) => payload.gameType === "rock-paper-scissors";
 function createGameActionsStore(transport) {
   const store = createSdkStore({
@@ -3431,8 +3447,21 @@ function createGameActionsStore(transport) {
     });
   };
   const isNonRpsState = (state) => Boolean(state && !isRpsState(state));
+  const pendingEvents = /* @__PURE__ */ new Map();
+  function enqueue(gameId, event) {
+    const q = pendingEvents.get(gameId) ?? [];
+    q.push(event);
+    pendingEvents.set(gameId, q);
+  }
+  function drainQueue(gameId) {
+    const q = pendingEvents.get(gameId);
+    if (!q?.length) return;
+    pendingEvents.delete(gameId);
+    for (const ev of q) applyWsEvent(ev);
+  }
   const setBaseState = (gameId, state) => {
     updateState(gameId, state);
+    drainQueue(gameId);
   };
   const clearState = (gameId) => {
     store.updateState((state) => {
@@ -3442,6 +3471,7 @@ function createGameActionsStore(transport) {
       const { [gameId]: _, ...rest } = state.statesByGameId;
       return { ...state, statesByGameId: rest };
     });
+    pendingEvents.delete(gameId);
   };
   const applyWsEvent = (event) => {
     switch (event.event) {
@@ -3460,7 +3490,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:starting": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const betAmount = typeof event.payload.betAmount === "number" ? event.payload.betAmount : void 0;
         const startedAt = typeof event.payload.startedAt === "string" ? event.payload.startedAt : current.roundState.startedAt;
         const bufferEndsAt = typeof event.payload.bufferEndsAt === "string" ? event.payload.bufferEndsAt : current.roundState.selectionEndsAt;
@@ -3481,7 +3514,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:round:started": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const actions = {};
         const baseUsers = /* @__PURE__ */ new Set();
         Object.keys(current.roundState.actions).forEach(
@@ -3515,7 +3551,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:action:received": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           roundState: {
@@ -3534,7 +3573,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:timer:cutoff": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           roundState: {
@@ -3548,7 +3590,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:round:reveal": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const actions = {};
         const payloadActions = event.payload.actions;
         Object.keys(payloadActions || {}).forEach((userId) => {
@@ -3572,7 +3617,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:round:completed": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const roundHistory = [
           ...current.roundHistory || [],
           {
@@ -3597,7 +3645,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rps:timeout": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current || !isRpsState(current)) return;
+        if (!current || !isRpsState(current)) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const timedOutUser = event.payload.playerId;
         const action = event.payload.action;
         const updated = {
@@ -3622,7 +3673,10 @@ function createGameActionsStore(transport) {
         const payload = event.payload;
         const { gameId } = payload;
         const current = store.getState().statesByGameId[gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(gameId, event);
+          return;
+        }
         const updated = isRpsCompletionPayload(payload) && isRpsState(current) ? {
           ...current,
           status: "completed",
@@ -3671,11 +3725,15 @@ function createGameActionsStore(transport) {
         const current = store.getState().statesByGameId[gameId];
         const updated = current ? { ...current, ...incoming } : incoming;
         updateState(gameId, updated);
+        drainQueue(gameId);
         break;
       }
       case "game:rematch:requested": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const requestedBy = event.payload.requestedBy;
         const userId = event.payload.userId;
         const requested = new Set(
@@ -3691,7 +3749,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rematch:cancelled": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const requestedBy = event.payload.requestedBy ?? [];
         const updated = {
           ...current,
@@ -3702,7 +3763,10 @@ function createGameActionsStore(transport) {
       }
       case "game:rematch:started": {
         const current = store.getState().statesByGameId[event.payload.gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(event.payload.gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           rematchRequestedBy: event.payload.playerIds ?? []
@@ -3713,7 +3777,10 @@ function createGameActionsStore(transport) {
       case "game:pot:updated": {
         const { gameId, totalPotMinor } = event.payload;
         const current = store.getState().statesByGameId[gameId];
-        if (!current) return;
+        if (!current) {
+          enqueue(gameId, event);
+          return;
+        }
         const updated = {
           ...current,
           totalPotMinor
@@ -3726,12 +3793,123 @@ function createGameActionsStore(transport) {
     }
   };
   const joinGame = (gameId) => transport.joinRoom(`game:${gameId}`);
+  const getCountdownDigit = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state) return null;
+    if (isRpsState(state)) {
+      if (state.roundState.phase !== "starting") return null;
+      const remaining = new Date(state.roundState.selectionEndsAt).getTime() - nowMs;
+      if (remaining <= 0) return null;
+      return Math.ceil(remaining / 1e3);
+    }
+    const bufferEndsAt = state.bufferEndsAt;
+    if (bufferEndsAt) {
+      const remaining = new Date(bufferEndsAt).getTime() - nowMs;
+      if (remaining <= 0) return null;
+      return Math.ceil(remaining / 1e3);
+    }
+    return null;
+  };
+  const getChessClockTimes = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "chess") return null;
+    const s = state;
+    let whiteMs = s.whiteTimeMs ?? 0;
+    let blackMs = s.blackTimeMs ?? 0;
+    if (s.status === "active" && s.currentPlayerId) {
+      const startedAt = Date.parse(s.turnStartedAt);
+      if (!Number.isNaN(startedAt)) {
+        const elapsed = Math.max(0, nowMs - startedAt);
+        if (s.currentPlayerId === s.whitePlayerId) {
+          whiteMs = Math.max(0, whiteMs - elapsed);
+        } else if (s.currentPlayerId === s.blackPlayerId) {
+          blackMs = Math.max(0, blackMs - elapsed);
+        }
+      }
+    }
+    return { whiteTimeMs: whiteMs, blackTimeMs: blackMs };
+  };
+  const getChessCapturedPieces = (gameId) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "chess") return null;
+    const fen = state.fen;
+    if (!fen) return { capturedByWhite: [], capturedByBlack: [] };
+    const placement = fen.split(" ")[0];
+    const white = {};
+    const black = {};
+    for (const char of placement) {
+      if (char === "/" || char >= "1" && char <= "8") continue;
+      const lower = char.toLowerCase();
+      if (char === lower) {
+        black[lower] = (black[lower] ?? 0) + 1;
+      } else {
+        white[lower] = (white[lower] ?? 0) + 1;
+      }
+    }
+    const INITIAL = {
+      p: 8,
+      r: 2,
+      n: 2,
+      b: 2,
+      q: 1,
+      k: 1
+    };
+    const capturedByWhite = [];
+    const capturedByBlack = [];
+    for (const [type, initial] of Object.entries(INITIAL)) {
+      const missingBlack = initial - (black[type] ?? 0);
+      for (let i = 0; i < missingBlack; i++) capturedByWhite.push(`b${type}`);
+      const missingWhite = initial - (white[type] ?? 0);
+      for (let i = 0; i < missingWhite; i++) capturedByBlack.push(`w${type}`);
+    }
+    return { capturedByWhite, capturedByBlack };
+  };
+  const getTicTacToeClockTimes = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "tic-tac-toe") return null;
+    const s = state;
+    let xMs = s.xTimeMs ?? 0;
+    let oMs = s.oTimeMs ?? 0;
+    if (s.status === "active" && s.currentPlayerId) {
+      const currentMark = s.playerMarks[s.currentPlayerId];
+      const startedAt = Date.parse(s.turnStartedAt);
+      if (!Number.isNaN(startedAt)) {
+        const elapsed = Math.max(0, nowMs - startedAt);
+        if (currentMark === "X") xMs = Math.max(0, xMs - elapsed);
+        else if (currentMark === "O") oMs = Math.max(0, oMs - elapsed);
+      }
+    }
+    return { xTimeMs: xMs, oTimeMs: oMs };
+  };
+  const getConnect4ClockTimes = (gameId, nowMs) => {
+    const state = store.getState().statesByGameId[gameId];
+    if (!state || state.gameType !== "connect-four") return null;
+    const s = state;
+    let redMs = s.redTimeMs ?? 0;
+    let yellowMs = s.yellowTimeMs ?? 0;
+    if (s.status === "active" && s.currentPlayerId) {
+      const currentColor = s.playerColors[s.currentPlayerId];
+      const startedAt = Date.parse(s.turnStartedAt);
+      if (!Number.isNaN(startedAt)) {
+        const elapsed = Math.max(0, nowMs - startedAt);
+        if (currentColor === "RED") redMs = Math.max(0, redMs - elapsed);
+        else if (currentColor === "YELLOW")
+          yellowMs = Math.max(0, yellowMs - elapsed);
+      }
+    }
+    return { redTimeMs: redMs, yellowTimeMs: yellowMs };
+  };
   return {
     store,
     setBaseState,
     clearState,
     applyWsEvent,
-    joinGame
+    joinGame,
+    getCountdownDigit,
+    getChessClockTimes,
+    getChessCapturedPieces,
+    getTicTacToeClockTimes,
+    getConnect4ClockTimes
   };
 }
 function isRpsState(state) {
@@ -4401,12 +4579,14 @@ var WsRouter = class {
       }
       const decoded = decodeWsEvent(eventName, payload);
       if (!decoded) return;
-      this.deps.lobbyStore.applyWsEvent(decoded);
-      this.deps.gameStore.applyWsEvent(decoded);
-      this.deps.gameActionsStore.applyWsEvent(decoded);
-      this.deps.chatStore.applyWsEvent(decoded);
-      this.deps.dmThreadsStore.applyWsEvent(decoded);
-      this.deps.notificationsStore.applyWsEvent(decoded);
+      const serverTs = payload !== null && typeof payload === "object" ? payload._serverTs : void 0;
+      const event = serverTs !== void 0 ? { ...decoded, _serverTs: serverTs } : decoded;
+      this.deps.lobbyStore.applyWsEvent(event);
+      this.deps.gameStore.applyWsEvent(event);
+      this.deps.gameActionsStore.applyWsEvent(event);
+      this.deps.chatStore.applyWsEvent(event);
+      this.deps.dmThreadsStore.applyWsEvent(event);
+      this.deps.notificationsStore.applyWsEvent(event);
     });
   }
   stop() {
@@ -4418,12 +4598,14 @@ var WsRouter = class {
       this.transport.subscribeEvent(eventName, (payload) => {
         const decoded = decodeWsEvent(eventName, payload);
         if (!decoded) return;
-        this.deps.lobbyStore.applyWsEvent(decoded);
-        this.deps.gameStore.applyWsEvent(decoded);
-        this.deps.gameActionsStore.applyWsEvent(decoded);
-        this.deps.chatStore.applyWsEvent(decoded);
-        this.deps.dmThreadsStore.applyWsEvent(decoded);
-        this.deps.notificationsStore.applyWsEvent(decoded);
+        const serverTs = payload !== null && typeof payload === "object" ? payload._serverTs : void 0;
+        const event = serverTs !== void 0 ? { ...decoded, _serverTs: serverTs } : decoded;
+        this.deps.lobbyStore.applyWsEvent(event);
+        this.deps.gameStore.applyWsEvent(event);
+        this.deps.gameActionsStore.applyWsEvent(event);
+        this.deps.chatStore.applyWsEvent(event);
+        this.deps.dmThreadsStore.applyWsEvent(event);
+        this.deps.notificationsStore.applyWsEvent(event);
       });
     }
   }
@@ -4826,6 +5008,7 @@ export {
   export_formatMoneyMinor as formatMoneyMinor,
   isRetryableError,
   logger,
+  selectGameLifecycleState,
   export_toMajor as toMajor,
   withRetry
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimcool/sdk",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",