@block52/poker-vm-sdk 1.2.16 → 1.2.17

package/dist/index.js

@@ -57319,6 +57319,109 @@ Deck.SUIT_MAP = {
     [exports.SUIT.SPADES]: "S"
 };
 
+/**
+ * The community board for a Texas Hold'em hand.
+ *
+ * Encapsulates the two community-card arrays the engine currently keeps — the
+ * cards dealt street-by-street (`street`, persisted to the DTO) and the five
+ * pre-dealt up front at `deal()` (`preDealt`) — behind one type. This is a pure
+ * refactor: every accessor returns exactly what the inline engine logic did, so
+ * behaviour is unchanged. Collapsing the two arrays into a single canonical
+ * board is a separate, consensus-affecting change (issue #2299).
+ */
+class Board {
+    constructor() {
+        // Dealt one street at a time via dealCommunityCards() (was `_communityCards`).
+        // This is the board persisted to the game DTO and rehydrated from JSON.
+        this.street = [];
+        // All five dealt up front at deal() (was `_communityCards2`).
+        this.preDealt = [];
+    }
+    /**
+     * Append cards dealt for the current street (was `_communityCards.push`).
+     */
+    addStreet(cards) {
+        this.street.push(...cards);
+    }
+    /**
+     * Record the five cards pre-dealt at deal() (was `_communityCards2.push`).
+     */
+    setPreDealt(cards) {
+        this.preDealt.push(...cards);
+    }
+    /**
+     * Number of street-dealt cards (was `_communityCards.length`).
+     */
+    get streetLength() {
+        return this.street.length;
+    }
+    /**
+     * Number of pre-dealt cards (was `_communityCards2.length`).
+     */
+    get preDealtLength() {
+        return this.preDealt.length;
+    }
+    /**
+     * The street-dealt community cards (was `[...this._communityCards]`).
+     */
+    get cards() {
+        return [...this.street];
+    }
+    /**
+     * The community cards visible at a given round, taken from the pre-dealt
+     * board — matching the previous `getCommunityCards()` exactly:
+     *   FLOP -> preDealt[0..3], TURN -> preDealt[0..4], RIVER -> preDealt[0..5].
+     */
+    forRound(round) {
+        const cards = [];
+        if (round === exports.TexasHoldemRound.FLOP) {
+            cards.push(...this.preDealt.slice(0, 3));
+        }
+        if (round === exports.TexasHoldemRound.TURN) {
+            cards.push(...this.preDealt.slice(0, 4));
+        }
+        if (round === exports.TexasHoldemRound.RIVER) {
+            cards.push(...this.preDealt.slice(0, 5));
+        }
+        return cards;
+    }
+    /**
+     * The board `findWinners` falls back to when `forRound` is short: the
+     * pre-dealt board for live games, else the street board rehydrated from JSON.
+     * Preserves the previous inline selection verbatim.
+     */
+    forEvaluation(count) {
+        return this.preDealt.length >= count
+            ? this.preDealt.slice(0, count)
+            : this.street.slice(0, count);
+    }
+    /**
+     * The board `calculateWinner` falls back to at an early showdown: the fully
+     * dealt street board if available, else the pre-dealt board. Preserves the
+     * previous inline selection verbatim.
+     */
+    forShowdown() {
+        return this.street.length >= Board.MAX_COMMUNITY_CARDS
+            ? this.street.slice(0, Board.MAX_COMMUNITY_CARDS)
+            : this.preDealt.slice(0, Board.MAX_COMMUNITY_CARDS);
+    }
+    /**
+     * Clear both boards for a new hand (was two `.length = 0` assignments).
+     */
+    clear() {
+        this.street.length = 0;
+        this.preDealt.length = 0;
+    }
+    /**
+     * Serialize the street board to mnemonics, matching
+     * `TexasHoldemStateDTO.communityCards` (was `_communityCards.map(...)`).
+     */
+    toJson() {
+        return this.street.map(card => card.mnemonic);
+    }
+}
+Board.MAX_COMMUNITY_CARDS = 5;
+
 /**
  * Example integration of custom poker solver with game engine
  * Demonstrates how to replace pokersolver with our custom implementation
@@ -61865,6 +61968,7 @@ const registry = new protoSigning.Registry([
 
 exports.AllPlayerActions = AllPlayerActions;
 exports.BLOCK52_HD_PATH = BLOCK52_HD_PATH;
+exports.Board = Board;
 exports.COSMOS_CONSTANTS = COSMOS_CONSTANTS;
 exports.Client = Client;
 exports.CosmosClient = CosmosClient;