@roomkit/worker 1.0.0

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

@@ -0,0 +1,132 @@
+import { Type, OnModuleInit } from '@nestjs/common';
+import { PlayerInfo, RoomSnapshot, AuthContext } from '@roomkit/core';
+import { ConfigService } from '../config/config.service';
+import { RedisService } from '../redis/redis.service';
+import { GameRoom } from './game-room';
+import { ClientProxy } from './client-proxy';
+import { RoomPersistenceService } from './room-persistence.service';
+import type { RoomMigrationService } from '../migration/room-migration.service.js';
+/**
+ * 房间管理器
+ */
+export declare class RoomManagerService implements OnModuleInit {
+    private readonly configService;
+    private readonly redisService;
+    private readonly persistenceService;
+    private readonly logger;
+    private rooms;
+    private roomTypes;
+    constructor(configService: ConfigService, redisService: RedisService, persistenceService: RoomPersistenceService);
+    private migrationService?;
+    /**
+     * 设置 MigrationService（从 MigrationModule 调用）
+     */
+    setMigrationService(migrationService: RoomMigrationService): void;
+    /**
+     * 模块初始化，清理孤儿房间数据
+     */
+    onModuleInit(): Promise<void>;
+    /**
+     * 注册房间类型
+     */
+    registerRoomType(gameType: string, roomClass: Type<GameRoom>): void;
+    /**
+     * 获取所有已注册的房间类型
+     */
+    getRegisteredGameTypes(): string[];
+    /**
+     * 创建房间
+     */
+    createRoom(roomId: string, gameType: string, maxPlayers: number, config: Record<string, unknown>, creatorClient: ClientProxy): Promise<GameRoom | null>;
+    /**
+     * 获取房间
+     */
+    getRoom(roomId: string): GameRoom | undefined;
+    /**
+     * 玩家加入房间
+     *
+     * 认证流程（Colyseus 风格）：
+     * 1. 如果房间类定义了 static onAuth，先调用静态认证
+     * 2. 调用实例的 onAuth 方法
+     * 3. 两者都通过后才允许加入
+     *
+     * @param room 目标房间
+     * @param client 客户端代理
+     * @param options 加入选项
+     * @param context 认证上下文（可选）
+     */
+    joinRoom(room: GameRoom, client: ClientProxy, options?: Record<string, unknown>, context?: AuthContext): Promise<boolean>;
+    /**
+     * 玩家离开房间
+     */
+    leaveRoom(room: GameRoom, userId: string, reason: string): Promise<void>;
+    /**
+     * 销毁房间
+     */
+    disposeRoom(roomId: string): Promise<void>;
+    /**
+     * 处理客户端断开
+     */
+    handleDisconnect(roomId: string, userId: string): Promise<void>;
+    /**
+     * 更新Redis中的房间信息
+     */
+    private updateRoomInRedis;
+    /**
+     * 清理Redis中的房间数据
+     */
+    private cleanupRoomInRedis;
+    /**
+     * 通知Gateway用户加入房间
+     */
+    private notifyUserJoinedRoom;
+    /**
+     * 通知Gateway用户离开房间
+     */
+    private notifyUserLeftRoom;
+    /**
+     * 更新Worker统计信息
+     */
+    private updateStats;
+    /**
+     * 获取所有房间
+     */
+    getAllRooms(): Map<string, GameRoom>;
+    /**
+     * 获取房间数量
+     */
+    getRoomCount(): number;
+    /**
+     * 从快照创建房间（用于迁移恢复）
+     */
+    createRoomFromSnapshot(snapshot: RoomSnapshot): Promise<GameRoom | null>;
+    /**
+     * 重建客户端代理（用于迁移恢复）
+     */
+    rebuildClientProxy(room: GameRoom, userId: string, gatewayId: string, connectionId: string, playerInfo: PlayerInfo): Promise<void>;
+    /**
+     * 移除房间（不通知玩家，用于迁移清理）
+     */
+    removeRoomSilently(roomId: string): void;
+    /**
+     * 清理孤儿房间数据
+     * 检查Redis中的房间数据，如果对应的Worker不是当前Worker或房间实例不存在，则清理
+     */
+    private cleanOrphanRooms;
+    /**
+     * 清理指定房间的所有Redis数据
+     */
+    cleanRoomData(roomId: string): Promise<void>;
+    /**
+     */
+    removeRoom(roomId: string): void;
+    /**
+     * 获取总玩家数
+     */
+    getTotalPlayerCount(): number;
+    /**
+     * 从快照恢复房间（用于迁移）
+     */
+    restoreRoom(snapshot: any): Promise<GameRoom | null>;
+}
+//# sourceMappingURL=room-manager.service.d.ts.map

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

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