@roomkit/worker 1.0.0

package/dist/src/migration/migration.service.js

@@ -0,0 +1,295 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var MigrationService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MigrationService = void 0;
+const common_1 = require("@nestjs/common");
+const config_service_1 = require("../config/config.service");
+const redis_service_1 = require("../redis/redis.service");
+const room_manager_service_1 = require("../room/room-manager.service");
+const core_1 = require("@roomkit/core");
+/**
+ * 房间迁移服务
+ * 负责房间的导出、导入和迁移协调
+ */
+let MigrationService = MigrationService_1 = class MigrationService {
+    configService;
+    redisService;
+    roomManagerService;
+    logger = new common_1.Logger(MigrationService_1.name);
+    // 正在进行的迁移任务
+    activeMigrations = new Map();
+    constructor(configService, redisService, roomManagerService) {
+        this.configService = configService;
+        this.redisService = redisService;
+        this.roomManagerService = roomManagerService;
+    }
+    /**
+     * 创建房间快照（迁移出口）
+     */
+    async createSnapshot(roomId) {
+        const room = this.roomManagerService.getRoom(roomId);
+        if (!room) {
+            this.logger.warn(`Cannot create snapshot: room ${roomId} not found`);
+            return null;
+        }
+        try {
+            // 通知房间开始迁移
+            await room.onMigrationStart();
+            // 通知玩家房间正在迁移
+            await room.broadcast(core_1.MessageType.MSG_ROOM_MIGRATING, {
+                roomId,
+                message: 'Room is being migrated',
+            });
+            // 创建快照
+            const snapshot = room.createSnapshot(this.configService.workerId);
+            this.logger.log(`Created snapshot for room ${roomId}, players: ${snapshot.players.length}`);
+            return snapshot;
+        }
+        catch (error) {
+            this.logger.error(`Failed to create snapshot for room ${roomId}`, error);
+            await room.onMigrationFailed(error instanceof Error ? error.message : 'Unknown error');
+            return null;
+        }
+    }
+    /**
+     * 从快照恢复房间（迁移入口）
+     */
+    async restoreFromSnapshot(snapshot) {
+        try {
+            // 检查是否已存在同ID房间
+            if (this.roomManagerService.getRoom(snapshot.roomId)) {
+                this.logger.warn(`Room ${snapshot.roomId} already exists, cannot restore`);
+                return false;
+            }
+            // 创建新房间实例
+            const room = await this.roomManagerService.createRoomFromSnapshot(snapshot);
+            if (!room) {
+                this.logger.error(`Failed to create room from snapshot: ${snapshot.roomId}`);
+                return false;
+            }
+            // 恢复房间状态
+            room.restoreFromSnapshot(snapshot);
+            // 重建玩家连接代理
+            for (const player of snapshot.players) {
+                await this.roomManagerService.rebuildClientProxy(room, player.userId, player.gatewayId, player.connectionId, player.playerInfo);
+            }
+            // 更新 Redis 中的房间映射
+            await this.updateRoomMapping(snapshot.roomId);
+            // 通知房间迁移完成
+            await room.onMigrationComplete();
+            // 通知玩家迁移完成
+            await room.broadcast(core_1.MessageType.MSG_ROOM_MIGRATION_COMPLETE, {
+                roomId: snapshot.roomId,
+                newWorkerId: this.configService.workerId,
+            });
+            this.logger.log(`Successfully restored room ${snapshot.roomId} from snapshot`);
+            return true;
+        }
+        catch (error) {
+            this.logger.error(`Failed to restore room from snapshot`, error);
+            return false;
+        }
+    }
+    /**
+     * 清理源 Worker 上的房间（迁移完成后调用）
+     */
+    async cleanupSourceRoom(roomId) {
+        const room = this.roomManagerService.getRoom(roomId);
+        if (!room) {
+            return true; // 已经不存在
+        }
+        try {
+            // 直接销毁，不通知玩家（玩家已经被迁移）
+            room.players.clear();
+            await room.dispose();
+            this.roomManagerService.removeRoom(roomId);
+            this.logger.log(`Cleaned up source room ${roomId} after migration`);
+            return true;
+        }
+        catch (error) {
+            this.logger.error(`Failed to cleanup source room ${roomId}`, error);
+            return false;
+        }
+    }
+    /**
+     * 更新 Redis 中的房间映射
+     */
+    async updateRoomMapping(roomId) {
+        const key = `gf:room:${roomId}:worker`;
+        await this.redisService.client.set(key, this.configService.workerId);
+    }
+    /**
+     * 发起完整迁移流程
+     * 这个方法在管理端调用，协调整个迁移过程
+     */
+    async inititateMigration(request) {
+        const { roomId, sourceWorkerId, targetWorkerId } = request;
+        const startTime = Date.now();
+        this.activeMigrations.set(roomId, {
+            status: 'pending',
+            startTime,
+            request,
+        });
+        try {
+            // 1. 在源 Worker 创建快照
+            this.updateMigrationStatus(roomId, 'snapshotting');
+            const snapshot = await this.requestSnapshot(roomId, sourceWorkerId);
+            if (!snapshot) {
+                throw new Error('Failed to create snapshot on source worker');
+            }
+            // 2. 传输快照到目标 Worker
+            this.updateMigrationStatus(roomId, 'transferring');
+            // 3. 在目标 Worker 恢复
+            this.updateMigrationStatus(roomId, 'restoring');
+            const restored = await this.requestRestore(snapshot, targetWorkerId);
+            if (!restored) {
+                throw new Error('Failed to restore on target worker');
+            }
+            // 4. 验证
+            this.updateMigrationStatus(roomId, 'verifying');
+            // TODO: 可选的验证步骤
+            // 5. 清理源 Worker
+            await this.requestCleanup(roomId, sourceWorkerId);
+            // 完成
+            this.updateMigrationStatus(roomId, 'completed');
+            const migrationTime = Date.now() - startTime;
+            this.logger.log(`Migration completed for room ${roomId} in ${migrationTime}ms`);
+            return {
+                success: true,
+                roomId,
+                sourceWorkerId,
+                targetWorkerId,
+                migrationTime,
+                status: 'completed',
+            };
+        }
+        catch (error) {
+            this.updateMigrationStatus(roomId, 'failed');
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            this.logger.error(`Migration failed for room ${roomId}: ${errorMessage}`);
+            return {
+                success: false,
+                roomId,
+                sourceWorkerId,
+                targetWorkerId,
+                error: errorMessage,
+                status: 'failed',
+            };
+        }
+        finally {
+            this.activeMigrations.delete(roomId);
+        }
+    }
+    /**
+     * 更新迁移状态
+     */
+    updateMigrationStatus(roomId, status) {
+        const migration = this.activeMigrations.get(roomId);
+        if (migration) {
+            migration.status = status;
+        }
+    }
+    /**
+     * 通过 Redis 向源 Worker 请求快照
+     */
+    async requestSnapshot(roomId, workerId) {
+        // 发送创建快照命令
+        const channel = `gf:rpc:worker:${workerId}`;
+        const requestId = `snapshot:${roomId}:${Date.now()}`;
+        const message = JSON.stringify({
+            type: 'migration:snapshot',
+            requestId,
+            roomId,
+        });
+        // 等待响应
+        const responseKey = `gf:migration:response:${requestId}`;
+        await this.redisService.client.publish(channel, message);
+        // 轮询等待响应（最多等待 30 秒）
+        const timeout = 30000;
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const response = await this.redisService.client.get(responseKey);
+            if (response) {
+                await this.redisService.client.del(responseKey);
+                const parsed = JSON.parse(response);
+                return parsed.snapshot || null;
+            }
+            await this.sleep(100);
+        }
+        return null;
+    }
+    /**
+     * 通过 Redis 向目标 Worker 请求恢复
+     */
+    async requestRestore(snapshot, workerId) {
+        const channel = `gf:rpc:worker:${workerId}`;
+        const requestId = `restore:${snapshot.roomId}:${Date.now()}`;
+        const message = JSON.stringify({
+            type: 'migration:restore',
+            requestId,
+            snapshot,
+        });
+        const responseKey = `gf:migration:response:${requestId}`;
+        await this.redisService.client.publish(channel, message);
+        // 轮询等待响应
+        const timeout = 30000;
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const response = await this.redisService.client.get(responseKey);
+            if (response) {
+                await this.redisService.client.del(responseKey);
+                const parsed = JSON.parse(response);
+                return parsed.success === true;
+            }
+            await this.sleep(100);
+        }
+        return false;
+    }
+    /**
+     * 请求清理源 Worker 上的房间
+     */
+    async requestCleanup(roomId, workerId) {
+        const channel = `gf:rpc:worker:${workerId}`;
+        const message = JSON.stringify({
+            type: 'migration:cleanup',
+            roomId,
+        });
+        await this.redisService.client.publish(channel, message);
+    }
+    /**
+     * 获取当前迁移状态
+     */
+    getMigrationStatus(roomId) {
+        const migration = this.activeMigrations.get(roomId);
+        return migration?.status || null;
+    }
+    /**
+     * 获取所有活跃迁移
+     */
+    getActiveMigrations() {
+        return Array.from(this.activeMigrations.entries()).map(([roomId, data]) => ({
+            roomId,
+            ...data,
+        }));
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+};
+exports.MigrationService = MigrationService;
+exports.MigrationService = MigrationService = MigrationService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_service_1.ConfigService,
+        redis_service_1.RedisService,
+        room_manager_service_1.RoomManagerService])
+], MigrationService);
+//# sourceMappingURL=migration.service.js.map

package/dist/src/migration/migration.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.service.js","sourceRoot":"","sources":["../../../src/migration/migration.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AACpD,6DAAyD;AACzD,0DAAsD;AACtD,uEAAkE;AAClE,wCAMuB;AAEvB;;;GAGG;AAEI,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IAWR;IACA;IACA;IAZF,MAAM,GAAG,IAAI,eAAM,CAAC,kBAAgB,CAAC,IAAI,CAAC,CAAC;IAE5D,YAAY;IACJ,gBAAgB,GAAG,IAAI,GAAG,EAI9B,CAAC;IAEL,YACmB,aAA4B,EAC5B,YAA0B,EAC1B,kBAAsC;QAFtC,kBAAa,GAAb,aAAa,CAAe;QAC5B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,uBAAkB,GAAlB,kBAAkB,CAAoB;IACtD,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,MAAM,YAAY,CAAC,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,WAAW;YACX,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAE9B,aAAa;YACb,MAAM,IAAI,CAAC,SAAS,CAAC,kBAAW,CAAC,kBAAkB,EAAE;gBACnD,MAAM;gBACN,OAAO,EAAE,wBAAwB;aAClC,CAAC,CAAC;YAEH,OAAO;YACP,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAElE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,6BAA6B,MAAM,cAAc,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5F,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;YACzE,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YACvF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,QAAsB;QAC9C,IAAI,CAAC;YACH,eAAe;YACf,IAAI,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,QAAQ,CAAC,MAAM,iCAAiC,CAAC,CAAC;gBAC3E,OAAO,KAAK,CAAC;YACf,CAAC;YAED,UAAU;YACV,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;YAC5E,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7E,OAAO,KAAK,CAAC;YACf,CAAC;YAED,SAAS;YACT,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAEnC,WAAW;YACX,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtC,MAAM,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,CAC9C,IAAI,EACJ,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,UAAU,CAClB,CAAC;YACJ,CAAC;YAED,kBAAkB;YAClB,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAE9C,WAAW;YACX,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAEjC,WAAW;YACX,MAAM,IAAI,CAAC,SAAS,CAAC,kBAAW,CAAC,2BAA2B,EAAE;gBAC5D,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ;aACzC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,QAAQ,CAAC,MAAM,gBAAgB,CAAC,CAAC;YAC/E,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;YACjE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,MAAc;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,CAAC,QAAQ;QACvB,CAAC;QAED,IAAI,CAAC;YACH,sBAAsB;YACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAE3C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,0BAA0B,MAAM,kBAAkB,CAAC,CAAC;YACpE,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;YACpE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAAC,MAAc;QAC5C,MAAM,GAAG,GAAG,WAAW,MAAM,SAAS,CAAC;QACvC,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CAAC,OAA6B;QACpD,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE;YAChC,MAAM,EAAE,SAAS;YACjB,SAAS;YACT,OAAO;SACR,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,oBAAoB;YACpB,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACpE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YAED,oBAAoB;YACpB,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YAEnD,mBAAmB;YACnB,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YAED,QAAQ;YACR,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAChD,gBAAgB;YAEhB,gBAAgB;YAChB,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YAElD,KAAK;YACL,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAChD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAE7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gCAAgC,MAAM,OAAO,aAAa,IAAI,CAAC,CAAC;YAEhF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM;gBACN,cAAc;gBACd,cAAc;gBACd,aAAa;gBACb,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC7C,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAE9E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,KAAK,YAAY,EAAE,CAAC,CAAC;YAE1E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM;gBACN,cAAc;gBACd,cAAc;gBACd,KAAK,EAAE,YAAY;gBACnB,MAAM,EAAE,QAAQ;aACjB,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,MAAc,EAAE,MAAuB;QACnE,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,MAAc,EAAE,QAAgB;QAC5D,WAAW;QACX,MAAM,OAAO,GAAG,iBAAiB,QAAQ,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,YAAY,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAErD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,IAAI,EAAE,oBAAoB;YAC1B,SAAS;YACT,MAAM;SACP,CAAC,CAAC;QAEH,OAAO;QACP,MAAM,WAAW,GAAG,yBAAyB,SAAS,EAAE,CAAC;QAEzD,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEzD,oBAAoB;QACpB,MAAM,OAAO,GAAG,KAAK,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACjE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACpC,OAAO,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC;YACjC,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,QAAsB,EAAE,QAAgB;QACnE,MAAM,OAAO,GAAG,iBAAiB,QAAQ,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,WAAW,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAE7D,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,IAAI,EAAE,mBAAmB;YACzB,SAAS;YACT,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,yBAAyB,SAAS,EAAE,CAAC;QAEzD,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEzD,SAAS;QACT,MAAM,OAAO,GAAG,KAAK,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACjE,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACpC,OAAO,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;YACjC,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,QAAgB;QAC3D,MAAM,OAAO,GAAG,iBAAiB,QAAQ,EAAE,CAAC;QAE5C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7B,IAAI,EAAE,mBAAmB;YACzB,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAAc;QAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,SAAS,EAAE,MAAM,IAAI,IAAI,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,mBAAmB;QAMjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1E,MAAM;YACN,GAAG,IAAI;SACR,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;CACF,CAAA;AAnUY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;qCAYuB,8BAAa;QACd,4BAAY;QACN,yCAAkB;GAb9C,gBAAgB,CAmU5B"}

package/dist/src/migration/room-migration.service.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 房间迁移服务
+ *
+ * 功能：
+ * 1. 主动迁移：Worker 主动将房间迁移到另一个 Worker
+ * 2. 被动接管：Worker 故障时，其他 Worker 接管孤儿房间
+ * 3. 迁移协调：确保迁移过程中的数据一致性
+ * 4. 路由更新：通知 Gateway 更新房间路由
+ *
+ * 设计：
+ * - 迁移过程：暂停房间 → 保存快照 → 通知 Gateway → 新 Worker 加载 → 确认完成
+ * - 容错机制：超时重试、回滚、失败通知
+ */
+import { RedisService } from '../redis/redis.service.js';
+import { ConfigService } from '../config/config.service.js';
+import { RoomPersistenceService } from '../room/room-persistence.service.js';
+import type { RoomManagerService } from '../room/room-manager.service.js';
+export interface MigrationRequest {
+    roomId: string;
+    sourceWorkerId: string;
+    targetWorkerId: string;
+    reason: 'manual' | 'load-balance' | 'shutdown';
+    timestamp: number;
+}
+export interface MigrationResult {
+    success: boolean;
+    roomId: string;
+    sourceWorkerId: string;
+    targetWorkerId?: string;
+    error?: string;
+    duration: number;
+}
+export interface TakeoverRequest {
+    roomId: string;
+    originalWorkerId: string;
+    reason: 'worker-failed' | 'timeout';
+    timestamp: number;
+}
+export declare class RoomMigrationService {
+    private readonly redis;
+    private readonly config;
+    private readonly persistence;
+    private readonly logger;
+    private migratingRooms;
+    private readonly MIGRATION_TIMEOUT;
+    constructor(redis: RedisService, config: ConfigService, persistence: RoomPersistenceService);
+    /**
+     * 设置 RoomManager（避免循环依赖）
+     */
+    setRoomManager(roomManager: RoomManagerService): void;
+    private roomManager;
+    /**
+     * 初始化迁移服务
+     */
+    initialize(): Promise<void>;
+    /**
+     * 主动迁移房间到指定 Worker
+     */
+    migrateRoom(roomId: string, targetWorkerId: string, reason?: 'manual' | 'load-balance' | 'shutdown'): Promise<MigrationResult>;
+    /**
+     * 处理迁移请求（作为目标 Worker）
+     */
+    private handleMigrationRequest;
+    /**
+     * 处理接管请求（孤儿房间）
+     */
+    private handleTakeoverRequest;
+    /**
+     * 等待迁移确认
+     */
+    private waitForMigrationConfirmation;
+    /**
+     * 通知 Gateway 更新路由
+     */
+    private notifyGatewayRouteChange;
+    /**
+     * 请求其他 Worker 接管孤儿房间
+     */
+    requestTakeover(roomId: string, originalWorkerId: string, reason?: 'worker-failed' | 'timeout'): Promise<void>;
+    /**
+     * 获取迁移统计
+     */
+    getStats(): {
+        migratingRooms: number;
+        activeRooms: string[];
+    };
+    /**
+     * 模块销毁时清理
+     */
+    onModuleDestroy(): Promise<void>;
+}
+//# sourceMappingURL=room-migration.service.d.ts.map

package/dist/src/migration/room-migration.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-migration.service.d.ts","sourceRoot":"","sources":["../../../src/migration/room-migration.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAI7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,UAAU,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBACa,oBAAoB;IAU7B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAX9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAGhE,OAAO,CAAC,cAAc,CAAqB;IAG3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAGxB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,sBAAsB;IAGtD;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAIrD,OAAO,CAAC,WAAW,CAAmC;IAEtD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBjC;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,GAAE,QAAQ,GAAG,cAAc,GAAG,UAAqB,GACxD,OAAO,CAAC,eAAe,CAAC;IA+E3B;;OAEG;YACW,sBAAsB;IA4DpC;;OAEG;YACW,qBAAqB;IAoEnC;;OAEG;YACW,4BAA4B;IAiC1C;;OAEG;YACW,wBAAwB;IAatC;;OAEG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,MAAM,GAAE,eAAe,GAAG,SAA2B,GACpD,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACH,QAAQ,IAAI;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB;IAOD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAIvC"}