@block52/poker-vm-sdk 1.1.18 → 1.2.2

package/dist/index.d.ts

@@ -45213,6 +45213,7 @@ declare enum PlayerActionType {
 declare enum NonPlayerActionType {
     DEAD_SMALL_BLIND = "dead-small-blind",
     DEAL = "deal",
+    FORCE_CLOSE = "force-close",
     JOIN = "join",
     LEAVE = "leave",
     NEW_HAND = "new-hand",
@@ -45223,6 +45224,7 @@ declare enum NonPlayerActionType {
 declare const AllPlayerActions: {
     DEAD_SMALL_BLIND: NonPlayerActionType.DEAD_SMALL_BLIND;
     DEAL: NonPlayerActionType.DEAL;
+    FORCE_CLOSE: NonPlayerActionType.FORCE_CLOSE;
     JOIN: NonPlayerActionType.JOIN;
     LEAVE: NonPlayerActionType.LEAVE;
     NEW_HAND: NonPlayerActionType.NEW_HAND;
@@ -45388,6 +45390,7 @@ type PlayerDTO = {
     timeout: number;
     sitInMethod?: SitInMethod;
     pendingSitOut?: string;
+    pendingTopUpAmount?: string;
     signature: string;
 };
 type ResultDTO = {
@@ -46407,6 +46410,18 @@ declare class SigningCosmosClient extends CosmosClient {
      * Only the game creator can delete a game, and the game must have no active players
      */
     deleteGame(gameId: string): Promise<string>;
+    /**
+     * Force-close a poker game and refund every seated player.
+     *
+     * Only the table creator can invoke this. Distinct from `deleteGame()`:
+     * `deleteGame` requires zero players, this kicks everyone off and refunds
+     * their stacks (plus any current-hand contribution and queued top-up) to
+     * their wallet, then deletes the table.
+     *
+     * Cash format only. Chain rejects SNG/Tournament — those have separate
+     * cancellation semantics (see block52/poker-vm#2173).
+     */
+    forceCloseGame(gameId: string): Promise<string>;
     /**
      * Perform a game action (fold, call, raise, etc.)
      * The keeper calculates the action index automatically
@@ -46417,6 +46432,32 @@ declare class SigningCosmosClient extends CosmosClient {
      * @param data - Optional data string (e.g., entropy for deal action)
      */
     performAction(gameId: string, action: string, amount?: bigint, data?: string): Promise<string>;
+    /**
+     * Fast-path variant of {@link performAction}. Broadcasts in SYNC mode —
+     * returns as soon as the tx passes CheckTx (mempool admission), without
+     * waiting for block inclusion. Typical return latency is ~50–100ms vs
+     * 5+ seconds for {@link performAction}.
+     *
+     * **The tx is NOT yet executed when this returns.** The caller MUST
+     * reconcile authoritative state via the chain's WebSocket push, which
+     * fires after block commit. Pair this with optimistic UI rendering
+     * and a rollback path for the case where CheckTx succeeds but the
+     * tx fails at DeliverTx (rare — illegal action that escaped local
+     * validation, or block-time consensus surprises).
+     *
+     * Use cases:
+     *   - Frontend action submission where perceived latency matters.
+     *   - Any caller that has an independent path (WS, polling) to
+     *     learn the action's authoritative outcome.
+     *
+     * Do NOT use this for code paths that need the post-DeliverTx
+     * `events` or `rawLog` — those are only populated by the BLOCK
+     * variant. See block52/poker-vm#2104.
+     *
+     * Returns the tx hash on CheckTx success; throws if CheckTx
+     * rejects (invalid signature, malformed msg, insufficient gas).
+     */
+    performActionSync(gameId: string, action: string, amount?: bigint, data?: string): Promise<string>;
     /**
      * Top up a player's stack at a table
      * The player must be seated at the table and have sufficient wallet balance.

package/dist/index.esm.js

@@ -55860,6 +55860,7 @@ var NonPlayerActionType;
 (function (NonPlayerActionType) {
     NonPlayerActionType["DEAD_SMALL_BLIND"] = "dead-small-blind";
     NonPlayerActionType["DEAL"] = "deal";
+    NonPlayerActionType["FORCE_CLOSE"] = "force-close";
     NonPlayerActionType["JOIN"] = "join";
     NonPlayerActionType["LEAVE"] = "leave";
     NonPlayerActionType["NEW_HAND"] = "new-hand";
@@ -57947,6 +57948,45 @@ class SigningCosmosClient extends CosmosClient {
             throw error;
         }
     }
+    /**
+     * Force-close a poker game and refund every seated player.
+     *
+     * Only the table creator can invoke this. Distinct from `deleteGame()`:
+     * `deleteGame` requires zero players, this kicks everyone off and refunds
+     * their stacks (plus any current-hand contribution and queued top-up) to
+     * their wallet, then deletes the table.
+     *
+     * Cash format only. Chain rejects SNG/Tournament — those have separate
+     * cancellation semantics (see block52/poker-vm#2173).
+     */
+    async forceCloseGame(gameId) {
+        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;
+        const msgForceCloseGame = {
+            creator,
+            gameId
+        };
+        const msg = {
+            typeUrl: "/pokerchain.poker.v1.MsgForceCloseGame",
+            value: msgForceCloseGame
+        };
+        const fee = gaslessFee();
+        const memo = "Force-close poker game via SDK";
+        console.log("🛑 Force-closing game:", { gameId });
+        try {
+            const result = await this.signingClient.signAndBroadcast(creator, [msg], fee, memo);
+            console.log("✅ Force-close transaction successful:", result.transactionHash);
+            return result.transactionHash;
+        }
+        catch (error) {
+            console.error("❌ Force-close failed:", error);
+            throw error;
+        }
+    }
     /**
      * Perform a game action (fold, call, raise, etc.)
      * The keeper calculates the action index automatically
@@ -57995,6 +58035,64 @@ class SigningCosmosClient extends CosmosClient {
             throw error;
         }
     }
+    /**
+     * Fast-path variant of {@link performAction}. Broadcasts in SYNC mode —
+     * returns as soon as the tx passes CheckTx (mempool admission), without
+     * waiting for block inclusion. Typical return latency is ~50–100ms vs
+     * 5+ seconds for {@link performAction}.
+     *
+     * **The tx is NOT yet executed when this returns.** The caller MUST
+     * reconcile authoritative state via the chain's WebSocket push, which
+     * fires after block commit. Pair this with optimistic UI rendering
+     * and a rollback path for the case where CheckTx succeeds but the
+     * tx fails at DeliverTx (rare — illegal action that escaped local
+     * validation, or block-time consensus surprises).
+     *
+     * Use cases:
+     *   - Frontend action submission where perceived latency matters.
+     *   - Any caller that has an independent path (WS, polling) to
+     *     learn the action's authoritative outcome.
+     *
+     * Do NOT use this for code paths that need the post-DeliverTx
+     * `events` or `rawLog` — those are only populated by the BLOCK
+     * variant. See block52/poker-vm#2104.
+     *
+     * Returns the tx hash on CheckTx success; throws if CheckTx
+     * rejects (invalid signature, malformed msg, insufficient gas).
+     */
+    async performActionSync(gameId, action, amount = 0n, data) {
+        await this.initializeSigningClient();
+        if (!this.signingClient || !this.wallet) {
+            throw new Error("Signing client not initialized");
+        }
+        const [account] = await this.wallet.getAccounts();
+        const player = account.address;
+        // Same msg shape as performAction — only the broadcast mode differs.
+        const msgPerformAction = {
+            player,
+            gameId,
+            action,
+            amount: Long.fromString(amount.toString(), true),
+            data: data || ""
+        };
+        const msg = {
+            typeUrl: "/pokerchain.poker.v1.MsgPerformAction",
+            value: msgPerformAction
+        };
+        const fee = gaslessFee();
+        const memo = `Poker action (sync): ${action}`;
+        try {
+            // signAndBroadcastSync returns just the txhash, no DeliverTx
+            // result. The caller waits on the WS push for the
+            // authoritative outcome.
+            const txHash = await this.signingClient.signAndBroadcastSync(player, [msg], fee, memo);
+            return txHash;
+        }
+        catch (error) {
+            console.error("❌ Action (sync) failed at CheckTx:", error);
+            throw error;
+        }
+    }
     /**
      * Top up a player's stack at a table
      * The player must be seated at the table and have sufficient wallet balance.