@block52/poker-vm-sdk 1.2.15 → 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
@@ -61055,19 +61158,33 @@ class SigningCosmosClient extends CosmosClient {
         }
     }
     /**
-     * Leave a poker game
+     * Leave a poker game (signs AND broadcasts MsgLeaveGame directly).
+     *
+     * @param gameId the game to leave / claim from.
+     * @param finishingOrder place-1-first player addresses for an SNG that
+     *   finalized off-chain (WS-first) — lets the chain recompute payouts when
+     *   its Results are empty. Defaults to `[]` (cash games / already-finalized
+     *   SNGs, where the chain settles from its own state). Broadcast counterpart
+     *   of {@link signLeaveGame}.
      */
-    async leaveGame(gameId) {
+    async leaveGame(gameId, finishingOrder = []) {
         await this.initializeSigningClient();
         if (!this.signingClient || !this.wallet) {
             throw new Error("Signing client not initialized");
         }
         const [account] = await this.wallet.getAccounts();
         const creator = account.address;
-        // Create the message object
+        // Create the message object.
+        //
+        // finishingOrder (place-1-first player addresses) is for an SNG that
+        // finalized off-chain (WS-first): the chain's Results may be empty, so
+        // the message supplies the ORDER and the chain recomputes payouts from
+        // its own prize-pool math — never an amount. Empty for cash games and
+        // for SNGs the chain already finalized. Mirrors signLeaveGame. (pokerchain#229)
         const msgLeaveGame = {
             creator,
-            gameId
+            gameId,
+            finishingOrder
         };
         // Create the transaction message
         const msg = {
@@ -61851,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;