texas-poker-core 1.4.21 → 1.4.23

package/README.md

@@ -591,4 +591,12 @@ fix: 修复结算金额分配异常
 修复 player reset 字段遗漏
 
 ## 1.4.21
-引入领域事件&增加回放功能
+
+引入领域事件&增加回放功能
+
+## 1.4.22
+
+增加外部设置玩家手牌&结算信息的方法
+
+## 1.4.23
+bugfix

package/dist/Controller/HandSettlement.js

@@ -52,6 +52,11 @@ var HandSettlement = exports.HandSettlement = /*#__PURE__*/function () {
     value: function getPlayerEval(userId) {
       return _classPrivateFieldGet(_evalByUserId, this).get(userId);
     }
+  }, {
+    key: "setPlayerEval",
+    value: function setPlayerEval(userId, evalData) {
+      _classPrivateFieldGet(_evalByUserId, this).set(userId, evalData);
+    }
   }, {
     key: "reset",
     value: function reset() {

package/dist/Controller/index.js

@@ -166,6 +166,11 @@ var Controller = /*#__PURE__*/function () {
     value: function getShowdownEvalForPlayer(player) {
       return _classPrivateFieldGet(_hand, this).settlement.getPlayerEval(player.id);
     }
+  }, {
+    key: "setShowdownEvalForPlayer",
+    value: function setShowdownEvalForPlayer(player, evalData) {
+      _classPrivateFieldGet(_hand, this).settlement.setPlayerEval(player.id, evalData);
+    }
   }, {
     key: "activePlayer",
     get: function get() {

package/dist/Dealer/DealerService.js

@@ -110,6 +110,17 @@ var DealerService = exports.DealerService = /*#__PURE__*/function () {
       }, _classPrivateFieldGet(_table, this).button.getNextPlayer());
       return hole;
     }
+  }, {
+    key: "setHoleCardsForPlayer",
+    value: function setHoleCardsForPlayer(player, pokes) {
+      if (!_classPrivateFieldGet(_table, this).button) return;
+      var seatIndex = -1;
+      _classPrivateFieldGet(_table, this).loop(function (p, i) {
+        if (p === player) seatIndex = i;
+      }, _classPrivateFieldGet(_table, this).button.getNextPlayer());
+      if (seatIndex < 0) return;
+      _classPrivateFieldGet(_dealtBoard, this).setHoleCardsAt(seatIndex, pokes);
+    }
   }, {
     key: "addAction",
     value: function addAction(player) {

package/dist/Dealer/index.js

@@ -103,6 +103,11 @@ var Dealer = /*#__PURE__*/function () {
     value: function getHoleCardsForPlayer(player) {
       return _classPrivateFieldGet(_service, this).getHoleCardsForPlayer(player);
     }
+  }, {
+    key: "setHoleCardsForPlayer",
+    value: function setHoleCardsForPlayer(player, pokes) {
+      _classPrivateFieldGet(_service, this).setHoleCardsForPlayer(player, pokes);
+    }
   }, {
     key: "players",
     get: function get() {

package/dist/Deck/DealtBoard.js

@@ -5,6 +5,12 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.DealtBoard = void 0;
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
 function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
 function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
@@ -46,5 +52,12 @@ var DealtBoard = exports.DealtBoard = /*#__PURE__*/function () {
         commonPokes: _classPrivateFieldGet(_commonPokes, this)
       };
     }
+  }, {
+    key: "setHoleCardsAt",
+    value: function setHoleCardsAt(index, pokes) {
+      if (!Number.isInteger(index) || index < 0) return;
+      while (_classPrivateFieldGet(_handPokes, this).length <= index) _classPrivateFieldGet(_handPokes, this).push([]);
+      _classPrivateFieldGet(_handPokes, this)[index] = _toConsumableArray(pokes);
+    }
   }]);
 }();

package/dist/Player/index.js

@@ -494,6 +494,16 @@ var Player = exports.Player = /*#__PURE__*/function () {
     value: function getHandPokes() {
       return _toConsumableArray(_classPrivateFieldGet(_dealerRing, this).getHoleCardsForPlayer(this));
     }
+  }, {
+    key: "setHandPokes",
+    value: function setHandPokes(pokes) {
+      _classPrivateFieldGet(_dealerRing, this).setHoleCardsForPlayer(this, pokes);
+    }
+  }, {
+    key: "setShowdownEval",
+    value: function setShowdownEval(evalData) {
+      _classPrivateFieldGet(_handSession, this).setShowdownEvalForPlayer(this, evalData);
+    }
   }, {
     key: "earn",
     value: function earn(money) {

package/dist/Room/index.js

@@ -44,7 +44,7 @@ var _idToPlayerMap = /*#__PURE__*/new WeakMap();
 var _Room_brand = /*#__PURE__*/new WeakSet();
 // 房间
 var Room = /*#__PURE__*/function () {
-  function Room(options) {
+  function Room(_options) {
     _classCallCheck(this, Room);
     /** 仅当 `seats_open` 时通过；否则抛出给定错误码（设角色与座位结构变更复用同一谓词） */
     _classPrivateMethodInitSpec(this, _Room_brand);
@@ -65,12 +65,12 @@ var Room = /*#__PURE__*/function () {
     _defineProperty(this, "fail", function (error) {
       throw error;
     });
-    var dealer = options.dealer,
-      owner = options.owner,
-      initialChips = options.initialChips,
-      _options$maximumCount = options.maximumCountOfPlayers,
+    var dealer = _options.dealer,
+      owner = _options.owner,
+      initialChips = _options.initialChips,
+      _options$maximumCount = _options.maximumCountOfPlayers,
       maximumCountOfPlayers = _options$maximumCount === void 0 ? 10 : _options$maximumCount,
-      fail = options.fail;
+      fail = _options.fail;
     _classPrivateFieldSet(_owner, this, owner);
     _classPrivateFieldSet(_dealer, this, dealer);
     _classPrivateFieldSet(_initialChips, this, initialChips);
@@ -307,34 +307,16 @@ var Room = /*#__PURE__*/function () {
       var player = _classPrivateFieldGet(_idToPlayerMap, this).get(userId);
       this.watch(player);
     }
-
+  }, {
+    key: "remove",
+    value:
     /**
      * @description 玩家退出房间。仅 **已入座**（`on-set`、在环上）时在 `seats_locked` 下会拦截；
      * 仅观战（`hang`）可随时离房，不触发锁座校验。
      * @param player
      */
-  }, {
-    key: "remove",
-    value: function remove(player) {
-      if (!player || !_classPrivateGetter(_Room_brand, this, _get_players).has(player)) return this.fail(new _TexasError.default(_TexasError.TexasCoreErrorCode.ROOM_LEAVE_NOT_MEMBER));
-      var seatedAtRing = _classPrivateFieldGet(_playersOnSet, this).has(player);
-      if (seatedAtRing) {
-        _assertClassBrand(_Room_brand, this, _assertSeatsOpen).call(this, _TexasError.TexasCoreErrorCode.ROOM_SEATS_LOCKED_FOR_MUTATION);
-      }
-      var isOwner = player === _classPrivateFieldGet(_owner, this);
-      _classPrivateFieldGet(_idToPlayerMap, this).delete(player.getUserInfo().id);
-      if (seatedAtRing) {
-        _classPrivateFieldGet(_dealer, this).remove(player);
-        _classPrivateFieldGet(_playersOnSet, this).delete(player);
-      } else {
-        _classPrivateFieldGet(_playersHang, this).delete(player);
-      }
-      // owner 仅是房间治理语义：不阻塞牌桌退出；若 owner 退出则在当前成员中挑一位兜底。
-      if (isOwner && this.totalPlayersCount > 0) {
-        var fallbackOwner = this.getAllPlayers()[0];
-        if (fallbackOwner) _classPrivateFieldSet(_owner, this, fallbackOwner);
-      }
-      return null;
+    function remove(player) {
+      return _assertClassBrand(_Room_brand, this, _removeInternal).call(this, player);
     }
   }, {
     key: "removeById",
@@ -342,6 +324,19 @@ var Room = /*#__PURE__*/function () {
       var player = _classPrivateFieldGet(_idToPlayerMap, this).get(userId);
       return this.remove(player);
     }
+
+    /**
+     * 系统级强制移除：即使 seats_locked 也允许摘掉在座玩家。
+     * 仅用于 onLock 清退/风控踢人等服务端策略场景。
+     */
+  }, {
+    key: "removeByIdForce",
+    value: function removeByIdForce(userId) {
+      var player = _classPrivateFieldGet(_idToPlayerMap, this).get(userId);
+      return _assertClassBrand(_Room_brand, this, _removeInternal).call(this, player, {
+        ignoreSeatLockForSeated: true
+      });
+    }
   }, {
     key: "status",
     get: function get() {
@@ -385,4 +380,25 @@ function _beforeSetRoles() {
 function _get_players(_this) {
   return new Set([].concat(_toConsumableArray(_classPrivateFieldGet(_playersOnSet, _this)), _toConsumableArray(_classPrivateFieldGet(_playersHang, _this))));
 }
+function _removeInternal(player, options) {
+  if (!player || !_classPrivateGetter(_Room_brand, this, _get_players).has(player)) return this.fail(new _TexasError.default(_TexasError.TexasCoreErrorCode.ROOM_LEAVE_NOT_MEMBER));
+  var seatedAtRing = _classPrivateFieldGet(_playersOnSet, this).has(player);
+  if (seatedAtRing && !(options !== null && options !== void 0 && options.ignoreSeatLockForSeated)) {
+    _assertClassBrand(_Room_brand, this, _assertSeatsOpen).call(this, _TexasError.TexasCoreErrorCode.ROOM_SEATS_LOCKED_FOR_MUTATION);
+  }
+  var isOwner = player === _classPrivateFieldGet(_owner, this);
+  _classPrivateFieldGet(_idToPlayerMap, this).delete(player.getUserInfo().id);
+  if (seatedAtRing) {
+    _classPrivateFieldGet(_dealer, this).remove(player);
+    _classPrivateFieldGet(_playersOnSet, this).delete(player);
+  } else {
+    _classPrivateFieldGet(_playersHang, this).delete(player);
+  }
+  // owner 仅是房间治理语义：不阻塞牌桌退出；若 owner 退出则在当前成员中挑一位兜底。
+  if (isOwner && this.totalPlayersCount > 0) {
+    var fallbackOwner = this.getAllPlayers()[0];
+    if (fallbackOwner) _classPrivateFieldSet(_owner, this, fallbackOwner);
+  }
+  return null;
+}
 var _default = exports.default = Room;

package/dist/Texas/index.js

@@ -226,6 +226,13 @@ var Texas = /*#__PURE__*/function () {
       this.room.unlockSeats();
     }
 
+    /** 系统级移除（可绕过 seats_locked）；用于 onLock 清退/风控踢人等服务端策略。 */
+  }, {
+    key: "removePlayerByIdAsSystem",
+    value: function removePlayerByIdAsSystem(userId) {
+      this.room.removeByIdForce(userId);
+    }
+
     /**
      * 开始本手：`HandStarted` / 盲注等事件进入缓冲，且队列入队首人 `turn_handoff`。
      * 须随后 drain 并消费队列，首条 `TurnOffered` 才会出现。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "texas-poker-core",
-  "version": "1.4.21",
+  "version": "1.4.23",
   "description": "德州扑克核心功能",
   "main": "dist/index.js",
   "types": "types/index.d.ts",

package/types/Controller/HandSettlement.d.ts

@@ -20,6 +20,7 @@ export declare class HandSettlement {
     #private;
     get snapshot(): RankSettlementSnapshot;
     getPlayerEval(userId: number): ShowdownPlayerEval | undefined;
+    setPlayerEval(userId: number, evalData: ShowdownPlayerEval): void;
     reset(): void;
     settleFromCommonBoard(allSeatedPlayers: Player[], playersStillInShowdown: Player[], commonPokes: Poke[]): void;
 }

package/types/Controller/index.d.ts

@@ -55,6 +55,7 @@ declare class Controller implements GameComponent, PlayerHandSession<Player> {
     }[];
     get stage(): StageEnum;
     getShowdownEvalForPlayer(player: Player): ShowdownPlayerEval | undefined;
+    setShowdownEvalForPlayer(player: Player, evalData: ShowdownPlayerEval): void;
     get activePlayer(): Player | null;
     recordPlayerAction(player: Player, options: {
         emitPot: boolean;

package/types/Dealer/DealerService.d.ts

@@ -24,6 +24,7 @@ export declare class DealerService implements GameComponent {
      * 手牌唯一数据源为 {@link DealtBoard}；下标与发牌顺序一致（从庄家下家起绕桌一圈）。
      */
     getHoleCardsForPlayer(player: Player): Poke[];
+    setHoleCardsForPlayer(player: Player, pokes: readonly Poke[]): void;
     addAction(player: Player): void;
     initialRoles(buttonPlayer?: Player): undefined;
     reArrangeRoles(): undefined;

package/types/Dealer/index.d.ts

@@ -1,3 +1,4 @@
+import type { Poke } from '../Deck/constant';
 import type { PlayerDealerRing } from '../playerSessionPorts';
 import type { GameComponent, TexasErrorCallback } from '../gameContracts';
 import Deck from '../Deck';
@@ -29,6 +30,7 @@ declare class Dealer implements GameComponent, PlayerDealerRing<Player> {
     getPokes(): import("..").DealSnapshot;
     /** 该玩家在 {@link DealtBoard} 中对应座位的手牌（Player 不再私有缓存） */
     getHoleCardsForPlayer(player: Player): ("hj" | "h2" | "h3" | "h4" | "h5" | "h6" | "h7" | "h8" | "h9" | "ht" | "hq" | "hk" | "ha" | "s2" | "s3" | "s4" | "s5" | "s6" | "s7" | "s8" | "s9" | "st" | "sj" | "sq" | "sk" | "sa" | "d2" | "d3" | "d4" | "d5" | "d6" | "d7" | "d8" | "d9" | "dt" | "dj" | "dq" | "dk" | "da" | "c2" | "c3" | "c4" | "c5" | "c6" | "c7" | "c8" | "c9" | "ct" | "cj" | "cq" | "ck" | "ca")[];
+    setHoleCardsForPlayer(player: Player, pokes: readonly Poke[]): void;
     get players(): Player[];
     get stakes(): TableStakes;
     /** 大盲注额；与 `stakes.bigBlind` 同义 */

package/types/Deck/DealtBoard.d.ts

@@ -11,4 +11,5 @@ export declare class DealtBoard {
     capture(snapshot: DealSnapshot): void;
     reset(): void;
     getPokes(): DealSnapshot;
+    setHoleCardsAt(index: number, pokes: readonly Poke[]): void;
 }

package/types/Player/index.d.ts

@@ -132,6 +132,13 @@ export declare class Player implements GameComponent {
     log(prefix?: string): void;
     /** 手牌唯一存于荷官侧快照，经 {@link Dealer.getHoleCardsForPlayer} 按座位解析 */
     getHandPokes(): Poke[];
+    setHandPokes(pokes: readonly Poke[]): void;
+    setShowdownEval(evalData: {
+        bestFiveCards: Poke[];
+        rankSignature: RankSignature;
+        rankStrength: number;
+        rankCategory: RankCategory;
+    }): void;
     earn(money: number): void;
     resetCurrentStageTotalAmount(): void;
     /**

package/types/Room/index.d.ts

@@ -94,6 +94,11 @@ declare class Room implements GameComponent {
      */
     remove(player?: Player): number | null;
     removeById(userId: number): number | null;
+    /**
+     * 系统级强制移除：即使 seats_locked 也允许摘掉在座玩家。
+     * 仅用于 onLock 清退/风控踢人等服务端策略场景。
+     */
+    removeByIdForce(userId: number): number | null;
     get status(): RoomStatus;
     has(userId: number): boolean;
     setStatus(status: RoomStatus): void;

package/types/Texas/index.d.ts

@@ -66,6 +66,8 @@ declare class Texas {
     dealCards(): TexasDomainEvent[];
     lockSeats(): void;
     unlockSeats(): void;
+    /** 系统级移除（可绕过 seats_locked）；用于 onLock 清退/风控踢人等服务端策略。 */
+    removePlayerByIdAsSystem(userId: number): void;
     /**
      * 开始本手：`HandStarted` / 盲注等事件进入缓冲，且队列入队首人 `turn_handoff`。
      * 须随后 drain 并消费队列，首条 `TurnOffered` 才会出现。

package/types/playerSessionPorts.d.ts

@@ -14,6 +14,7 @@ export interface PlayerDealerRing<TPlayer = unknown> {
     map<R>(callback: (player: TPlayer, index: number) => R): R[];
     filter(callback: (player: TPlayer, index: number) => boolean): TPlayer[];
     getHoleCardsForPlayer(player: TPlayer): Poke[];
+    setHoleCardsForPlayer(player: TPlayer, pokes: readonly Poke[]): void;
 }
 /**
  * `Player` 需要的「本手阶段机」视图，避免依赖整个 {@link Controller}。
@@ -27,6 +28,7 @@ export interface PlayerHandSession<TPlayer = unknown> {
     /** 当前轮到行动的玩家；翻前贴盲完成前可能为 `null` */
     readonly activePlayer: TPlayer | null;
     getShowdownEvalForPlayer(player: TPlayer): ShowdownPlayerEval | undefined;
+    setShowdownEvalForPlayer(player: TPlayer, evalData: ShowdownPlayerEval): void;
     tryToEndGame(): boolean;
     /** 下注轮已结束且尚未到河牌时，可推迟进街并由业务调用 `applyPendingStageAdvance` */
     canDeferBettingRoundStageAdvance(): boolean;