@roomkit/worker 1.0.0

package/dist/src/room/game-room.js

@@ -0,0 +1,434 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameRoom = exports.ServerError = void 0;
+const core_1 = require("@roomkit/core");
+const DEFAULT_ENCODING_OPTIONS = {
+    useBinaryEncoding: true,
+    compressLargeState: true,
+    compressionThreshold: 4 * 1024, // 4KB
+};
+// 导出认证相关类型供子类使用
+var core_2 = require("@roomkit/core");
+Object.defineProperty(exports, "ServerError", { enumerable: true, get: function () { return core_2.ServerError; } });
+/**
+ * 游戏房间抽象基类
+ * 类似 Colyseus 的 Room 设计
+ * 支持 @roomkit/state 状态同步
+ */
+class GameRoom {
+    roomId;
+    gameType;
+    maxPlayers;
+    config;
+    status = 'creating';
+    players = new Map();
+    playerInfos = new Map();
+    createdAt;
+    autoDispose = true;
+    autoDisposeTimeout = 60000; // 1分钟
+    disposeTimer = null;
+    // 迁移相关
+    isMigrating = false;
+    sourceWorkerId; // 如果是从迁移恢复的，记录源 Worker
+    // 状态同步相关
+    state = null;
+    stateSyncInterval = null;
+    stateSyncRate = 50; // 默认50ms
+    // 状态编码配置（参考 Colyseus 设计）
+    stateEncodingOptions = { ...DEFAULT_ENCODING_OPTIONS };
+    // 持久化相关
+    stateVersion = 0; // 状态版本号
+    persistenceCallback; // 持久化事件回调
+    constructor(roomId, gameType, maxPlayers, config = {}) {
+        this.roomId = roomId;
+        this.gameType = gameType;
+        this.maxPlayers = maxPlayers;
+        this.config = config;
+        this.createdAt = Date.now();
+    }
+    // ============ 静态鉴权（Colyseus 风格，推荐） ============
+    /**
+     * 静态认证方法（推荐）
+     *
+     * 在创建房间实例前验证用户身份，适合需要在加入前验证 token 的场景。
+     *
+     * @param token - 客户端传入的认证 token
+     * @param options - 加入房间的选项
+     * @param context - 认证上下文，包含 IP、headers 等信息
+     * @returns 返回用户数据（truthy）允许加入，返回 falsy 或抛出错误拒绝加入
+     *
+     * @example
+     * ```typescript
+     * static async onAuth(token: string, options: any, context: AuthContext) {
+     *   // 验证 JWT
+     *   const user = await JWT.verify(token);
+     *   if (!user) throw new ServerError('INVALID_TOKEN', 'Token 无效');
+     *
+     *   // 验证房间密码
+     *   if (options.password !== 'secret') {
+     *     throw new ServerError('WRONG_PASSWORD', '密码错误');
+     *   }
+     *
+     *   // 返回用户数据，会附加到 client.auth
+     *   return { userId: user.id, username: user.name };
+     * }
+     * ```
+     */
+    static async onAuth(token, options, context) {
+        // 默认实现：信任 Gateway 层的认证
+        return true;
+    }
+    /**
+     * 实例鉴权方法（需要访问房间状态时使用）
+     *
+     * 如果同时定义了 static onAuth 和实例 onAuth，两者都会被调用。
+     * static onAuth 先执行，通过后再执行实例 onAuth。
+     *
+     * @param client - 客户端代理，包含 userId、auth 等信息
+     * @param options - 加入房间的选项
+     * @param context - 认证上下文
+     * @returns true 允许加入，false 或抛出错误拒绝加入
+     *
+     * @example
+     * ```typescript
+     * async onAuth(client, options, context) {
+     *   // 检查是否在黑名单
+     *   if (this.blacklist.has(client.userId)) {
+     *     await client.send(MessageType.ERROR, {
+     *       code: 'BANNED',
+     *       message: '你已被封禁'
+     *     });
+     *     return false;
+     *   }
+     *
+     *   // 检查房间密码
+     *   if (this.config.password && options.password !== this.config.password) {
+     *     throw new ServerError('WRONG_PASSWORD', '密码错误');
+     *   }
+     *
+     *   return true;
+     * }
+     * ```
+     */
+    async onAuth(client, options, context) {
+        return true;
+    }
+    // ============ 公共方法 ============
+    /**
+     * 添加玩家
+     */
+    addPlayer(client, playerInfo) {
+        this.players.set(client.userId, client);
+        this.playerInfos.set(client.userId, playerInfo);
+        client.roomId = this.roomId;
+        // 取消自动销毁计时器
+        if (this.disposeTimer) {
+            clearTimeout(this.disposeTimer);
+            this.disposeTimer = null;
+        }
+    }
+    /**
+     * 移除玩家
+     */
+    removePlayer(userId) {
+        this.players.delete(userId);
+        this.playerInfos.delete(userId);
+        // 如果房间为空且开启自动销毁
+        if (this.players.size === 0 && this.autoDispose) {
+            this.scheduleDispose();
+        }
+    }
+    /**
+     * 获取玩家数量
+     */
+    get playerCount() {
+        return this.players.size;
+    }
+    /**
+     * 获取所有玩家信息
+     */
+    getPlayerInfos() {
+        return Array.from(this.playerInfos.values());
+    }
+    /**
+     * 检查玩家是否在房间
+     */
+    hasPlayer(userId) {
+        return this.players.has(userId);
+    }
+    /**
+     * 获取玩家
+     */
+    getPlayer(userId) {
+        return this.players.get(userId);
+    }
+    /**
+     * 广播给所有玩家
+     */
+    async broadcast(msgType, payload, excludeUserId) {
+        for (const [userId, client] of this.players) {
+            if (excludeUserId && userId === excludeUserId)
+                continue;
+            await client.send(msgType, payload);
+        }
+    }
+    /**
+     * 发送消息给特定玩家
+     */
+    async send(userId, msgType, payload) {
+        const client = this.players.get(userId);
+        if (client) {
+            await client.send(msgType, payload);
+        }
+    }
+    /**
+     * 设置状态同步间隔
+     * @param intervalMs 间隔毫秒数，0 表示禁用自动同步
+     */
+    setStateSyncInterval(intervalMs) {
+        // 清除旧的定时器
+        if (this.stateSyncInterval) {
+            clearInterval(this.stateSyncInterval);
+            this.stateSyncInterval = null;
+        }
+        this.stateSyncRate = intervalMs;
+        // 设置新的定时器
+        if (intervalMs > 0) {
+            this.stateSyncInterval = setInterval(() => {
+                this.syncState();
+            }, intervalMs);
+        }
+    }
+    /**
+     * 同步状态（增量更新）
+     */
+    async syncState() {
+        if (!this.state)
+            return;
+        // 检查状态是否是 State 实例且有变化
+        const stateObj = this.state;
+        if (typeof stateObj.hasChanges === 'function' && typeof stateObj.getPatches === 'function') {
+            if (!stateObj.hasChanges())
+                return;
+            const patches = stateObj.getPatches();
+            if (patches.length === 0)
+                return;
+            // 广播增量更新
+            await this.broadcast(core_1.MessageType.MSG_STATE_DELTA, {
+                patches,
+            });
+            // 清除已发送的变化
+            if (typeof stateObj.clearChanges === 'function') {
+                stateObj.clearChanges();
+            }
+        }
+    }
+    /**
+     * 设置状态编码配置
+     */
+    setStateEncodingOptions(options) {
+        this.stateEncodingOptions = { ...this.stateEncodingOptions, ...options };
+    }
+    /**
+     * 发送完整状态给特定玩家
+     *
+     * 参考 Colyseus 设计：
+     * 1. 优先使用二进制编码（@roomkit/state 的 encode 方法）
+     * 2. 如果状态实现了 encode(true)，使用二进制格式
+     * 3. 否则回退到 JSON 格式
+     */
+    async sendFullState(userId) {
+        if (!this.state)
+            return;
+        const client = this.players.get(userId);
+        if (!client)
+            return;
+        const stateObj = this.state;
+        // 优先使用二进制编码（如果状态支持）
+        if (this.stateEncodingOptions.useBinaryEncoding && typeof stateObj.encode === 'function') {
+            try {
+                // 使用 @roomkit/state 的 encode(true) 获取二进制完整状态
+                const encoded = stateObj.encode(true, {
+                    compressionOptions: {
+                        forceCompress: this.stateEncodingOptions.compressLargeState,
+                        compressionThreshold: this.stateEncodingOptions.compressionThreshold,
+                    }
+                });
+                // 发送二进制编码的状态
+                await client.send(core_1.MessageType.MSG_STATE_FULL, {
+                    binary: true,
+                    data: Array.from(encoded.data), // Uint8Array 转为普通数组以便序列化
+                    compressed: encoded.compressed,
+                    originalSize: encoded.originalSize,
+                });
+                return;
+            }
+            catch (e) {
+                // 二进制编码失败，回退到 JSON
+                console.warn(`[GameRoom] Binary encoding failed, falling back to JSON:`, e);
+            }
+        }
+        // 回退：使用 JSON 格式
+        let stateData;
+        if (typeof stateObj.toJSON === 'function') {
+            stateData = stateObj.toJSON();
+        }
+        else {
+            stateData = this.state;
+        }
+        await client.send(core_1.MessageType.MSG_STATE_FULL, {
+            binary: false,
+            state: stateData,
+        });
+    }
+    /**
+     * 广播完整状态给所有玩家
+     */
+    async broadcastFullState() {
+        if (!this.state)
+            return;
+        for (const userId of this.players.keys()) {
+            await this.sendFullState(userId);
+        }
+    }
+    /**
+     * 获取客户端列表（兼容性方法）
+     */
+    get clients() {
+        return this.players;
+    }
+    /**
+     * 计划销毁房间
+     */
+    scheduleDispose() {
+        this.disposeTimer = setTimeout(() => {
+            if (this.players.size === 0) {
+                this.dispose();
+            }
+        }, this.autoDisposeTimeout);
+    }
+    /**
+     * 销毁房间
+     * 需要子类或RoomManager调用
+     */
+    async dispose() {
+        if (this.status === 'disposed')
+            return;
+        this.status = 'disposed';
+        if (this.disposeTimer) {
+            clearTimeout(this.disposeTimer);
+        }
+        if (this.stateSyncInterval) {
+            clearInterval(this.stateSyncInterval);
+        }
+        await this.onDispose();
+    }
+    // ============ 迁移相关方法 ============
+    /**
+     * 创建房间快照用于迁移
+     * 子类可以覆盖 getGameState() 来序列化游戏特定状态
+     */
+    createSnapshot(workerId) {
+        const players = [];
+        for (const [userId, client] of this.players) {
+            const playerInfo = this.playerInfos.get(userId);
+            if (playerInfo) {
+                players.push({
+                    userId,
+                    gatewayId: client.gatewayId,
+                    connectionId: client.connectionId,
+                    playerInfo,
+                });
+            }
+        }
+        return {
+            roomId: this.roomId,
+            gameType: this.gameType,
+            maxPlayers: this.maxPlayers,
+            config: { ...this.config },
+            status: this.status,
+            createdAt: this.createdAt,
+            players,
+            gameState: this.getGameState(),
+            snapshotVersion: 1,
+            snapshotTime: Date.now(),
+            sourceWorkerId: workerId,
+        };
+    }
+    /**
+     * 从快照恢复房间状态
+     * 子类可以覆盖 restoreGameState() 来恢复游戏特定状态
+     */
+    restoreFromSnapshot(snapshot) {
+        this.status = snapshot.status;
+        this.sourceWorkerId = snapshot.sourceWorkerId;
+        // 恢复玩家信息（ClientProxy 需要在 RoomManager 中重建）
+        for (const player of snapshot.players) {
+            this.playerInfos.set(player.userId, player.playerInfo);
+        }
+        // 恢复游戏状态
+        this.restoreGameState(snapshot.gameState);
+    }
+    /**
+     * 获取游戏特定状态（子类需要覆盖）
+     * 返回可 JSON 序列化的对象
+     */
+    getGameState() {
+        return null;
+    }
+    /**
+     * 恢复游戏特定状态（子类需要覆盖）
+     */
+    restoreGameState(state) {
+        // 默认不做任何事情
+    }
+    /**
+     * 迁移前的准备工作（可选覆盖）
+     * 例如：暂停游戏逻辑、保存关键状态
+     */
+    async onMigrationStart() {
+        this.isMigrating = true;
+    }
+    /**
+     * 迁移完成后的回调（可选覆盖）
+     * 在新 Worker 上调用
+     */
+    async onMigrationComplete() {
+        this.isMigrating = false;
+    }
+    /**
+     * 迁移失败时的回调（可选覆盖）
+     */
+    async onMigrationFailed(error) {
+        this.isMigrating = false;
+    }
+    // ============ 持久化辅助方法 ============
+    /**
+     * 获取当前状态（供持久化使用）
+     */
+    getState() {
+        return {
+            version: this.stateVersion,
+            status: this.status,
+            playerCount: this.playerCount,
+            state: this.state,
+            createdAt: this.createdAt,
+        };
+    }
+    /**
+     * 记录状态变更事件（供子类使用）
+     */
+    recordStateChange(type, data) {
+        this.stateVersion++;
+        if (this.persistenceCallback) {
+            this.persistenceCallback({
+                type,
+                version: this.stateVersion,
+                data,
+                timestamp: Date.now(),
+            });
+        }
+    }
+}
+exports.GameRoom = GameRoom;
+//# sourceMappingURL=game-room.js.map

package/dist/src/room/game-room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-room.js","sourceRoot":"","sources":["../../../src/room/game-room.ts"],"names":[],"mappings":"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"}

package/dist/src/room/message-handler.service.d.ts

@@ -0,0 +1,70 @@
+import { OnModuleInit } from '@nestjs/common';
+import { RedisService } from '../redis/redis.service';
+import { ConfigService } from '../config/config.service';
+import { RoomManagerService } from './room-manager.service';
+import { AuthService } from '../auth/auth.service';
+import { CircuitBreakerService } from '../circuit-breaker/circuit-breaker.service';
+export declare class MessageHandlerService implements OnModuleInit {
+    private readonly redis;
+    private readonly config;
+    private readonly roomManager;
+    private readonly authService;
+    private readonly circuitBreaker;
+    private readonly logger;
+    private readonly workerId;
+    constructor(redis: RedisService, config: ConfigService, roomManager: RoomManagerService, authService: AuthService, circuitBreaker: CircuitBreakerService);
+    onModuleInit(): Promise<void>;
+    private handleMessage;
+    /**
+     * 发送错误响应（熔断时使用）
+     */
+    private sendErrorResponse;
+    private handleAuthRequest;
+    private handleClientMessage;
+    private handleCreateRoom;
+    /**
+     * 构建认证上下文
+     */
+    private buildAuthContext;
+    private handleJoinRoom;
+    /**
+     * 处理 joinOrCreate 请求（Colyseus 风格的 concurrentJoinOrCreateRoomLock）
+     *
+     * requestCount = 0: 房间已存在，直接加入
+     * requestCount = 1: 第一个请求，负责创建房间
+     * requestCount > 1: 并发请求，等待房间创建完成后加入
+     */
+    private handleJoinOrCreate;
+    /**
+     * 创建并加入房间（第一个请求）
+     */
+    private createAndJoinRoom;
+    /**
+     * 等待房间创建完成后加入（并发请求）
+     */
+    private waitAndJoinRoom;
+    /**
+     * 加入已存在的房间
+     */
+    private joinExistingRoom;
+    /**
+     * 通知等待的 joinOrCreate 请求
+     */
+    private notifyRoomCreated;
+    private handleLeaveRoom;
+    private handleRoomMessage;
+    private handleClientDisconnect;
+    /**
+     * 处理房间重连请求
+     *
+     * Gateway 通知 Worker 更新房间成员的连接信息
+     *
+     * 重连场景（客户端断连或 Gateway 重启）：
+     * - 只更新 Redis 中的连接信息（Gateway ID + Connection ID）
+     * - 默认不发送状态（客户端已有状态，避免不必要的网络开销）
+     * - Worker 内存中的 Room 对象和玩家数据都还在，无需重建
+     */
+    private handleReconnectRoom;
+    private sendToGateway;
+}
+//# sourceMappingURL=message-handler.service.d.ts.map

package/dist/src/room/message-handler.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handler.service.d.ts","sourceRoot":"","sources":["../../../src/room/message-handler.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAU,MAAM,gBAAgB,CAAC;AASlE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAGnF,qBACa,qBAAsB,YAAW,YAAY;IAKtD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IARjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGf,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,kBAAkB,EAC/B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,qBAAqB;IAKlD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAMrB,aAAa;IA+C3B;;OAEG;YACW,iBAAiB;YAYjB,iBAAiB;YAkBjB,mBAAmB;YAmCnB,gBAAgB;IAiD9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;YAUV,cAAc;IAkD5B;;;;;;OAMG;YACW,kBAAkB;IAuChC;;OAEG;YACW,iBAAiB;IA4D/B;;OAEG;YACW,eAAe;IA0D7B;;OAEG;YACW,gBAAgB;IAkD9B;;OAEG;YACW,iBAAiB;YASjB,eAAe;YAkCf,iBAAiB;YA0BjB,sBAAsB;IAWpC;;;;;;;;;OASG;YACW,mBAAmB;YAgEnB,aAAa;CAQ5B"}