@block52/poker-vm-sdk 1.10.0 → 1.12.1

package/dist/index.d.ts

@@ -44960,6 +44960,14 @@ interface MsgCreateGame {
      * 0 = unscheduled: starts only when full. (poker-vm#2680)
      */
     startTime: Long;
+    /**
+     * Blind structure for a sit-and-go / tournament (field 22): JSON of the SDK's
+     * BlindStructureDTO — a preset ({"preset":"turbo"}) or an explicit double /
+     * linear / percentage / table structure. Empty = the blinds double every
+     * blind_level_duration minutes. Cash games must leave it empty.
+     * (poker-vm#1734, block52/pokerchain#434)
+     */
+    blindStructure: string;
 }
 declare const MsgCreateGame: MessageFns<MsgCreateGame>;
 /** MsgJoinGame defines the MsgJoinGame message. */
@@ -46144,6 +46152,34 @@ declare const isEmptyAddress: (address: string | null | undefined) => boolean;
  */
 declare const isValidPlayerAddress: (address: string | null | undefined) => boolean;
 
+/**
+ * Parses the text form into the typed structure. Throws on anything the
+ * engine would refuse that can be seen without expanding levels; the engine
+ * validates the result again on load.
+ */
+declare function parseBlindStructure(text: string): BlindStructureDTO;
+/**
+ * The inverse of parseBlindStructure. A preset formats as `BLINDS <preset>`;
+ * anything else as a block under `name` (default "custom").
+ */
+declare function formatBlindStructure(structure: BlindStructureDTO, name?: string): string;
+/**
+ * #1734's preset library, as the engine resolves it (pvm/go/engine
+ * tournament_blinds.go blindPresets). The engine resolves a preset on the
+ * table's first action; `resolveBlindPreset` does the same client-side so the
+ * levels can be previewed before the table exists.
+ */
+declare const BLIND_PRESET_STRUCTURES: Readonly<Record<BlindPreset, Exclude<BlindStructureDTO, BlindStructurePresetDTO>>>;
+/** Replaces a preset with its concrete structure (a deep copy); anything else is returned as is. */
+declare function resolveBlindPreset(structure: BlindStructureDTO): Exclude<BlindStructureDTO, BlindStructurePresetDTO>;
+/**
+ * Level n (0-based) of a structure, exactly as the engine expands it: the cap
+ * (`maxLevel`) freezes the blinds while the level number keeps counting; a
+ * table schedule repeats its last row once it runs out; the ante rule applies
+ * from its start level. A preset must be resolved first (`resolveBlindPreset`).
+ */
+declare function expandBlindLevel(structure: BlindStructureDTO, n: number): BlindLevelDTO;
+
 /**
  * Poker hand types in order of strength (weakest to strongest)
  */
@@ -46184,7 +46220,11 @@ declare class PokerSolver {
     /**
      * Evaluate a 5-card poker hand
      */
-    private static evaluateHand;
+    /**
+     * Evaluate exactly 5 cards (a winner's best hand, WinnerDTO.cards). Use
+     * findBestHand for 7.
+     */
+    static evaluateHand(cards: Card[]): HandEvaluation;
     /**
      * Check if cards form a straight (excluding low straight A-2-3-4-5)
      */
@@ -46454,11 +46494,47 @@ declare class PokerGameIntegration {
         hand2Evaluation: HandEvaluation;
     };
     /**
-     * Create a formatted hand description for UI display
+     * The winning hand in words, from the winner's best five cards
+     * (WinnerDTO.cards) and the board (communityCards): "Full House, Eights
+     * over Sevens", "Diamond Flush, Six high", "Set of Sevens". The board tells
+     * a set (pocket pair plus one on the board) from trips (one hole card plus a
+     * board pair, or all three on the board), which the five cards alone can't.
+     * @param cards The winner's five card mnemonics ("6D")
+     * @param board The community cards
+     * @returns The hand in words, or "" for an uncontested pot (no cards)
+     */
+    static describeWinningHand(cards: string[] | undefined, board: string[]): string;
+    /**
+     * Fill in each winner's name and description from its cards and the board.
+     * The engine no longer writes the hand's wording into chain state
+     * (poker-vm#2721), so callers run game state through this as it arrives and
+     * keep reading winner.name / winner.description as before.
+     *
+     * A winner with five cards gets "Full House, Eights over Sevens" in both
+     * fields. A winner without five cards (an uncontested pot, or an older state
+     * that recorded hole cards) is returned unchanged.
+     *
+     * Returns a new state object; the input is not modified.
+     * @param state Any game state with winners and community cards
+     */
+    static withWinnerDescriptions<T extends {
+        winners: WinnerDTO[];
+        communityCards: string[];
+    }>(state: T): T;
+    /**
+     * The hand description in words: "Full House, Eights over Sevens", "Quad
+     * Fours", "Diamond Flush, Six high", "Ace high". A flush names its suit from
+     * the best hand. The rank and suit words mirror @block52/deck's rankName /
+     * suitName.
      * @param evaluation Hand evaluation result
      * @returns Human-readable hand description
      */
     static formatHandDescription(evaluation: HandEvaluation): string;
+    private static readonly RANK_WORDS;
+    /** A high-ace rank spelled out ("Ace", "Ten"); plural gives "Aces", "Sixes". */
+    private static rankWord;
+    /** The suit word every card of a flush shares ("Diamond"), or "" when the hand is empty or mixed. */
+    private static flushSuitWord;
     /**
      * Example usage with string cards (for testing/debugging)
      * @param playerCardStrings Array of player hands as mnemonic strings
@@ -46746,6 +46822,7 @@ interface SNGConfig {
     blindLevelDuration: number;
     entryFee?: bigint;
     startTime?: number;
+    blindStructure?: BlindStructureDTO;
 }
 /**
  * Signing Cosmos Client that extends the read-only CosmosClient with transaction capabilities
@@ -47353,5 +47430,5 @@ declare const Client: typeof IgniteClient & Constructor<{
 }>;
 declare const registry: Registry;
 
-export { AllPlayerActions, BLIND_PRESETS, BLIND_PROGRESSIONS, BLOCK52_HD_PATH, BettingLimit, Board, COSMOS_CONSTANTS, Client, CosmosClient, Deck, GAME_NAME_MICRO_PER_CHAR, GameFormat, GameStatus, GameVariant, HandType, KEYS, MAX_GAME_NAME_LENGTH, MSG_CREATE_VALIDATOR_TYPE_URL, MissingWalletError, NonPlayerActionType, Params, PlayerActionType, PlayerStatus, PokerGameIntegration, PokerSolver, RPCMethods, SIT_IN_METHOD_NEXT_BB, SIT_IN_METHOD_POST_NOW, SIT_OUT_METHOD_NEXT_BB, SIT_OUT_METHOD_NEXT_HAND, SUIT, SigningCosmosClient, TexasHoldemRound, TxExecutionError, ValidatorBond, WithdrawalRequest, assertCreatableBettingLimit, assertExecuted, buildMsgCreateValidator, computeGameNameFee, createSigningClientFromMnemonic, createWalletFromMnemonic, decToAtomics, formatGameFormatDisplay, formatGameVariantDisplay, generateWallet, getActionByType, getAddressFromMnemonic, getBettingLimit, getDefaultCosmosConfig, getGameFormat, getGameFormatForCosmos, getGameFormatFromObject, getGameVariant, hasAction, holeCardsPerPlayer, isCashFormat, isEmptyAddress, isPotLimit, isSitAndGoFormat, isTournamentFormat, isValidMnemonic, isValidPlayerAddress, parseGameFormat, parseGameVariant, registry, toValoperAddress, txFailureHash, txFailurePhase };
+export { AllPlayerActions, BLIND_PRESETS, BLIND_PRESET_STRUCTURES, BLIND_PROGRESSIONS, BLOCK52_HD_PATH, BettingLimit, Board, COSMOS_CONSTANTS, Client, CosmosClient, Deck, GAME_NAME_MICRO_PER_CHAR, GameFormat, GameStatus, GameVariant, HandType, KEYS, MAX_GAME_NAME_LENGTH, MSG_CREATE_VALIDATOR_TYPE_URL, MissingWalletError, NonPlayerActionType, Params, PlayerActionType, PlayerStatus, PokerGameIntegration, PokerSolver, RPCMethods, SIT_IN_METHOD_NEXT_BB, SIT_IN_METHOD_POST_NOW, SIT_OUT_METHOD_NEXT_BB, SIT_OUT_METHOD_NEXT_HAND, SUIT, SigningCosmosClient, TexasHoldemRound, TxExecutionError, ValidatorBond, WithdrawalRequest, assertCreatableBettingLimit, assertExecuted, buildMsgCreateValidator, computeGameNameFee, createSigningClientFromMnemonic, createWalletFromMnemonic, decToAtomics, expandBlindLevel, formatBlindStructure, formatGameFormatDisplay, formatGameVariantDisplay, generateWallet, getActionByType, getAddressFromMnemonic, getBettingLimit, getDefaultCosmosConfig, getGameFormat, getGameFormatForCosmos, getGameFormatFromObject, getGameVariant, hasAction, holeCardsPerPlayer, isCashFormat, isEmptyAddress, isPotLimit, isSitAndGoFormat, isTournamentFormat, isValidMnemonic, isValidPlayerAddress, parseBlindStructure, parseGameFormat, parseGameVariant, registry, resolveBlindPreset, toValoperAddress, txFailureHash, txFailurePhase };
 export type { AccountDTO, ActionDTO, AnteRuleDTO, BlindLevelDTO, BlindPreset, BlindProgression, BlindStructureDTO, BlindStructurePresetDTO, Block, BlockDTO, BlockHeader, BlockHeaderDTO, BlockID, BlockResponse, BurnResponseDTO, Card, CreateValidatorParams, DoubleBlindStructureDTO, EquityHand, EquityRequest, EquityResponse, EquityResult, ExecutionResult, GameListItem, GameOptions, GameOptionsDTO, GameOptionsResponse, GameStateResponse, GameStateResponseDTO, HandEvaluation, ISignedResponse, LegalActionDTO, LinearBlindStructureDTO, PayoutPlaceDTO, PercentageBlindStructureDTO, PerformActionResponse, PlayerDTO, RPCRequest, RPCRequestParams, RPCResponse, RakeConfig, RakeConfigDTO, ResultDTO, SealedAwaiting, SealedDTO, SitInMethod, SitOutMethod, TableBlindStructureDTO, TexasHoldemGameState, TexasHoldemStateDTO, TransactionDTO, TransactionResponse, TxFailurePhase, WalletInfo, WinnerDTO, WithdrawResponseDTO };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAkC/C,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEV,CAAC;AAEH,QAAA,MAAM,QAAQ,UAiCZ,CAAA;AAGF,cAAc,6BAA6B,CAAA;AAG3C,cAAc,cAAc,CAAA;AAG5B,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGpG,cAAc,eAAe,CAAA;AAG7B,cAAc,eAAe,CAAA;AAG7B,cAAc,yBAAyB,CAAA;AAGvC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,sBAAsB,CAAA;AAGpC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGrE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAG/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAG7D,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACvF,OAAO,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAIpI,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAC9I,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAGvI,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGzF,OAAO,EACL,MAAM,EACN,QAAQ,EACR,kBAAkB,EACnB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAkC/C,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEV,CAAC;AAEH,QAAA,MAAM,QAAQ,UAiCZ,CAAA;AAGF,cAAc,6BAA6B,CAAA;AAG3C,cAAc,cAAc,CAAA;AAG5B,cAAc,SAAS,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGpG,cAAc,eAAe,CAAA;AAG7B,cAAc,eAAe,CAAA;AAG7B,cAAc,yBAAyB,CAAA;AAGvC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,sBAAsB,CAAA;AAGpC,cAAc,wBAAwB,CAAA;AAGtC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGrE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAG/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAG7D,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACvF,OAAO,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAIpI,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAC9I,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA;AAGvI,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAGzF,OAAO,EACL,MAAM,EACN,QAAQ,EACR,kBAAkB,EACnB,CAAA"}