@esengine/server 1.2.0 → 2.0.0

package/dist/{chunk-7C6JZO4O.js → chunk-QWEIP5QH.js}

@@ -5,338 +5,6 @@ import { rpc } from '@esengine/rpc';
 import * as fs from 'fs';
 import { pathToFileURL } from 'url';
 
-// src/room/Player.ts
-var _Player = class _Player {
-  constructor(options) {
-    __publicField(this, "id");
-    __publicField(this, "roomId");
-    __publicField(this, "data");
-    __publicField(this, "_conn");
-    __publicField(this, "_sendFn");
-    __publicField(this, "_leaveFn");
-    this.id = options.id;
-    this.roomId = options.roomId;
-    this._conn = options.conn;
-    this._sendFn = options.sendFn;
-    this._leaveFn = options.leaveFn;
-    this.data = options.initialData ?? {};
-  }
-  /**
-   * @zh 获取底层连接
-   * @en Get underlying connection
-   */
-  get connection() {
-    return this._conn;
-  }
-  /**
-   * @zh 发送消息给玩家
-   * @en Send message to player
-   */
-  send(type, data) {
-    this._sendFn(this._conn, type, data);
-  }
-  /**
-   * @zh 让玩家离开房间
-   * @en Make player leave the room
-   */
-  leave(reason) {
-    this._leaveFn(this, reason);
-  }
-};
-__name(_Player, "Player");
-var Player = _Player;
-
-// src/room/Room.ts
-var MESSAGE_HANDLERS = /* @__PURE__ */ Symbol("messageHandlers");
-var _Room = class _Room {
-  constructor() {
-    // ========================================================================
-    // 配置 | Configuration
-    // ========================================================================
-    /**
-     * @zh 最大玩家数
-     * @en Maximum players
-     */
-    __publicField(this, "maxPlayers", 16);
-    /**
-     * @zh Tick 速率（每秒），0 = 不自动 tick
-     * @en Tick rate (per second), 0 = no auto tick
-     */
-    __publicField(this, "tickRate", 0);
-    /**
-     * @zh 空房间自动销毁
-     * @en Auto dispose when empty
-     */
-    __publicField(this, "autoDispose", true);
-    // ========================================================================
-    // 状态 | State
-    // ========================================================================
-    /**
-     * @zh 房间状态
-     * @en Room state
-     */
-    __publicField(this, "state", {});
-    // ========================================================================
-    // 内部属性 | Internal properties
-    // ========================================================================
-    __publicField(this, "_id", "");
-    __publicField(this, "_players", /* @__PURE__ */ new Map());
-    __publicField(this, "_locked", false);
-    __publicField(this, "_disposed", false);
-    __publicField(this, "_tickInterval", null);
-    __publicField(this, "_lastTickTime", 0);
-    __publicField(this, "_broadcastFn", null);
-    __publicField(this, "_sendFn", null);
-    __publicField(this, "_disposeFn", null);
-  }
-  // ========================================================================
-  // 只读属性 | Readonly properties
-  // ========================================================================
-  /**
-   * @zh 房间 ID
-   * @en Room ID
-   */
-  get id() {
-    return this._id;
-  }
-  /**
-   * @zh 所有玩家
-   * @en All players
-   */
-  get players() {
-    return Array.from(this._players.values());
-  }
-  /**
-   * @zh 玩家数量
-   * @en Player count
-   */
-  get playerCount() {
-    return this._players.size;
-  }
-  /**
-   * @zh 是否已满
-   * @en Is full
-   */
-  get isFull() {
-    return this._players.size >= this.maxPlayers;
-  }
-  /**
-   * @zh 是否已锁定
-   * @en Is locked
-   */
-  get isLocked() {
-    return this._locked;
-  }
-  /**
-   * @zh 是否已销毁
-   * @en Is disposed
-   */
-  get isDisposed() {
-    return this._disposed;
-  }
-  // ========================================================================
-  // 生命周期 | Lifecycle
-  // ========================================================================
-  /**
-   * @zh 房间创建时调用
-   * @en Called when room is created
-   */
-  onCreate(options) {
-  }
-  /**
-   * @zh 玩家加入时调用
-   * @en Called when player joins
-   */
-  onJoin(player) {
-  }
-  /**
-   * @zh 玩家离开时调用
-   * @en Called when player leaves
-   */
-  onLeave(player, reason) {
-  }
-  /**
-   * @zh 游戏循环
-   * @en Game tick
-   */
-  onTick(dt) {
-  }
-  /**
-   * @zh 房间销毁时调用
-   * @en Called when room is disposed
-   */
-  onDispose() {
-  }
-  // ========================================================================
-  // 公共方法 | Public methods
-  // ========================================================================
-  /**
-   * @zh 广播消息给所有玩家
-   * @en Broadcast message to all players
-   */
-  broadcast(type, data) {
-    for (const player of this._players.values()) {
-      player.send(type, data);
-    }
-  }
-  /**
-   * @zh 广播消息给除指定玩家外的所有玩家
-   * @en Broadcast message to all players except one
-   */
-  broadcastExcept(except, type, data) {
-    for (const player of this._players.values()) {
-      if (player.id !== except.id) {
-        player.send(type, data);
-      }
-    }
-  }
-  /**
-   * @zh 获取玩家
-   * @en Get player by id
-   */
-  getPlayer(id) {
-    return this._players.get(id);
-  }
-  /**
-   * @zh 踢出玩家
-   * @en Kick player
-   */
-  kick(player, reason) {
-    player.leave(reason ?? "kicked");
-  }
-  /**
-   * @zh 锁定房间
-   * @en Lock room
-   */
-  lock() {
-    this._locked = true;
-  }
-  /**
-   * @zh 解锁房间
-   * @en Unlock room
-   */
-  unlock() {
-    this._locked = false;
-  }
-  /**
-   * @zh 手动销毁房间
-   * @en Manually dispose room
-   */
-  dispose() {
-    if (this._disposed) return;
-    this._disposed = true;
-    this._stopTick();
-    for (const player of this._players.values()) {
-      player.leave("room_disposed");
-    }
-    this._players.clear();
-    this.onDispose();
-    this._disposeFn?.();
-  }
-  // ========================================================================
-  // 内部方法 | Internal methods
-  // ========================================================================
-  /**
-   * @internal
-   */
-  _init(options) {
-    this._id = options.id;
-    this._sendFn = options.sendFn;
-    this._broadcastFn = options.broadcastFn;
-    this._disposeFn = options.disposeFn;
-  }
-  /**
-   * @internal
-   */
-  async _create(options) {
-    await this.onCreate(options);
-    this._startTick();
-  }
-  /**
-   * @internal
-   */
-  async _addPlayer(id, conn) {
-    if (this._locked || this.isFull || this._disposed) {
-      return null;
-    }
-    const player = new Player({
-      id,
-      roomId: this._id,
-      conn,
-      sendFn: this._sendFn,
-      leaveFn: /* @__PURE__ */ __name((p, reason) => this._removePlayer(p.id, reason), "leaveFn")
-    });
-    this._players.set(id, player);
-    await this.onJoin(player);
-    return player;
-  }
-  /**
-   * @internal
-   */
-  async _removePlayer(id, reason) {
-    const player = this._players.get(id);
-    if (!player) return;
-    this._players.delete(id);
-    await this.onLeave(player, reason);
-    if (this.autoDispose && this._players.size === 0) {
-      this.dispose();
-    }
-  }
-  /**
-   * @internal
-   */
-  _handleMessage(type, data, playerId) {
-    const player = this._players.get(playerId);
-    if (!player) return;
-    const handlers = this.constructor[MESSAGE_HANDLERS];
-    if (handlers) {
-      for (const handler of handlers) {
-        if (handler.type === type) {
-          const method = this[handler.method];
-          if (typeof method === "function") {
-            method.call(this, data, player);
-          }
-        }
-      }
-    }
-  }
-  _startTick() {
-    if (this.tickRate <= 0) return;
-    this._lastTickTime = performance.now();
-    this._tickInterval = setInterval(() => {
-      const now = performance.now();
-      const dt = (now - this._lastTickTime) / 1e3;
-      this._lastTickTime = now;
-      this.onTick(dt);
-    }, 1e3 / this.tickRate);
-  }
-  _stopTick() {
-    if (this._tickInterval) {
-      clearInterval(this._tickInterval);
-      this._tickInterval = null;
-    }
-  }
-};
-__name(_Room, "Room");
-var Room = _Room;
-function registerMessageHandler(target, type, method) {
-  if (!target[MESSAGE_HANDLERS]) {
-    target[MESSAGE_HANDLERS] = [];
-  }
-  target[MESSAGE_HANDLERS].push({
-    type,
-    method
-  });
-}
-__name(registerMessageHandler, "registerMessageHandler");
-
-// src/room/decorators.ts
-function onMessage(type) {
-  return function(target, propertyKey, _descriptor) {
-    registerMessageHandler(target.constructor, type, propertyKey);
-  };
-}
-__name(onMessage, "onMessage");
 function fileNameToHandlerName(fileName) {
   const baseName = fileName.replace(/\.(ts|js|mts|mjs)$/, "");
   return baseName.split(/[-_]/).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
@@ -739,6 +407,6 @@ async function createServer(config = {}) {
 }
 __name(createServer, "createServer");
 
-export { Player, Room, createServer, onMessage };
-//# sourceMappingURL=chunk-7C6JZO4O.js.map
-//# sourceMappingURL=chunk-7C6JZO4O.js.map
+export { createServer };
+//# sourceMappingURL=chunk-QWEIP5QH.js.map
+//# sourceMappingURL=chunk-QWEIP5QH.js.map

package/dist/chunk-QWEIP5QH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/router/loader.ts","../src/room/RoomManager.ts","../src/core/server.ts"],"names":["fileNameToHandlerName","fileName","baseName","replace","split","map","part","charAt","toUpperCase","slice","join","scanDirectory","dir","existsSync","files","entries","readdirSync","withFileTypes","entry","isFile","test","name","startsWith","push","loadApiHandlers","apiDir","handlers","filePath","fileUrl","pathToFileURL","href","module","definition","default","handler","basename","path","err","console","warn","loadMsgHandlers","msgDir","RoomManager","sendFn","_definitions","Map","_rooms","_playerToRoom","_nextRoomId","_sendFn","define","roomClass","set","create","options","def","get","roomId","_generateRoomId","room","_init","id","broadcastFn","type","data","player","players","send","disposeFn","delete","_create","log","joinOrCreate","playerId","conn","_findAvailableRoom","_addPlayer","joinById","leave","reason","_removePlayer","handleMessage","_handleMessage","getRoom","getPlayerRoom","undefined","getRooms","Array","from","values","getRoomsByType","filter","isFull","isLocked","isDisposed","DEFAULT_CONFIG","port","tickRate","createServer","config","opts","cwd","process","apiHandlers","resolve","msgHandlers","length","apiDefs","JoinRoom","rpc","api","LeaveRoom","msgDefs","RoomMessage","msg","protocol","currentTick","tickInterval","rpcServer","roomManager","apiMap","msgMap","gameServer","connections","tick","rooms","start","apiHandlersObj","input","roomType","result","Error","_input","success","Object","ctx","server","msgHandlersObj","payload","serve","createConnData","onStart","p","onConnect","onDisconnect","setInterval","stop","clearInterval","broadcast"],"mappings":"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","file":"chunk-QWEIP5QH.js","sourcesContent":["/**\n * @zh 文件路由加载器\n * @en File-based router loader\n */\n\nimport * as fs from 'node:fs'\nimport * as path from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport type { ApiDefinition, MsgDefinition, LoadedApiHandler, LoadedMsgHandler } from '../types/index.js'\n\n/**\n * @zh 将文件名转换为 API/消息名称\n * @en Convert filename to API/message name\n *\n * @example\n * 'join.ts' -> 'Join'\n * 'spawn-agent.ts' -> 'SpawnAgent'\n * 'save_blueprint.ts' -> 'SaveBlueprint'\n */\nfunction fileNameToHandlerName(fileName: string): string {\n    const baseName = fileName.replace(/\\.(ts|js|mts|mjs)$/, '')\n\n    return baseName\n        .split(/[-_]/)\n        .map(part => part.charAt(0).toUpperCase() + part.slice(1))\n        .join('')\n}\n\n/**\n * @zh 扫描目录获取所有处理器文件\n * @en Scan directory for all handler files\n */\nfunction scanDirectory(dir: string): string[] {\n    if (!fs.existsSync(dir)) {\n        return []\n    }\n\n    const files: string[] = []\n    const entries = fs.readdirSync(dir, { withFileTypes: true })\n\n    for (const entry of entries) {\n        if (entry.isFile() && /\\.(ts|js|mts|mjs)$/.test(entry.name)) {\n            // 跳过 index 和下划线开头的文件\n            if (entry.name.startsWith('_') || entry.name.startsWith('index.')) {\n                continue\n            }\n            files.push(path.join(dir, entry.name))\n        }\n    }\n\n    return files\n}\n\n/**\n * @zh 加载 API 处理器\n * @en Load API handlers\n */\nexport async function loadApiHandlers(apiDir: string): Promise<LoadedApiHandler[]> {\n    const files = scanDirectory(apiDir)\n    const handlers: LoadedApiHandler[] = []\n\n    for (const filePath of files) {\n        try {\n            const fileUrl = pathToFileURL(filePath).href\n            const module = await import(fileUrl)\n            const definition = module.default as ApiDefinition<unknown, unknown, unknown>\n\n            if (definition && typeof definition.handler === 'function') {\n                const name = fileNameToHandlerName(path.basename(filePath))\n                handlers.push({\n                    name,\n                    path: filePath,\n                    definition,\n                })\n            }\n        } catch (err) {\n            console.warn(`[Server] Failed to load API handler: ${filePath}`, err)\n        }\n    }\n\n    return handlers\n}\n\n/**\n * @zh 加载消息处理器\n * @en Load message handlers\n */\nexport async function loadMsgHandlers(msgDir: string): Promise<LoadedMsgHandler[]> {\n    const files = scanDirectory(msgDir)\n    const handlers: LoadedMsgHandler[] = []\n\n    for (const filePath of files) {\n        try {\n            const fileUrl = pathToFileURL(filePath).href\n            const module = await import(fileUrl)\n            const definition = module.default as MsgDefinition<unknown, unknown>\n\n            if (definition && typeof definition.handler === 'function') {\n                const name = fileNameToHandlerName(path.basename(filePath))\n                handlers.push({\n                    name,\n                    path: filePath,\n                    definition,\n                })\n            }\n        } catch (err) {\n            console.warn(`[Server] Failed to load msg handler: ${filePath}`, err)\n        }\n    }\n\n    return handlers\n}\n","/**\n * @zh 房间管理器\n * @en Room manager\n */\n\nimport { Room, type RoomOptions } from './Room.js'\nimport type { Player } from './Player.js'\n\n/**\n * @zh 房间类型\n * @en Room class type\n */\nexport type RoomClass<T extends Room = Room> = new () => T\n\n/**\n * @zh 房间定义\n * @en Room definition\n */\ninterface RoomDefinition {\n    roomClass: RoomClass\n}\n\n/**\n * @zh 房间管理器\n * @en Room manager\n */\nexport class RoomManager {\n    private _definitions: Map<string, RoomDefinition> = new Map()\n    private _rooms: Map<string, Room> = new Map()\n    private _playerToRoom: Map<string, string> = new Map()\n    private _nextRoomId = 1\n\n    private _sendFn: (conn: any, type: string, data: unknown) => void\n\n    constructor(sendFn: (conn: any, type: string, data: unknown) => void) {\n        this._sendFn = sendFn\n    }\n\n    /**\n     * @zh 注册房间类型\n     * @en Define room type\n     */\n    define<T extends Room>(name: string, roomClass: RoomClass<T>): void {\n        this._definitions.set(name, { roomClass })\n    }\n\n    /**\n     * @zh 创建房间\n     * @en Create room\n     */\n    async create(name: string, options?: RoomOptions): Promise<Room | null> {\n        const def = this._definitions.get(name)\n        if (!def) {\n            console.warn(`[RoomManager] Room type not found: ${name}`)\n            return null\n        }\n\n        const roomId = this._generateRoomId()\n        const room = new def.roomClass()\n\n        room._init({\n            id: roomId,\n            sendFn: this._sendFn,\n            broadcastFn: (type, data) => {\n                for (const player of room.players) {\n                    player.send(type, data)\n                }\n            },\n            disposeFn: () => {\n                this._rooms.delete(roomId)\n            },\n        })\n\n        this._rooms.set(roomId, room)\n        await room._create(options)\n\n        console.log(`[Room] Created: ${name} (${roomId})`)\n        return room\n    }\n\n    /**\n     * @zh 加入或创建房间\n     * @en Join or create room\n     */\n    async joinOrCreate(\n        name: string,\n        playerId: string,\n        conn: any,\n        options?: RoomOptions\n    ): Promise<{ room: Room; player: Player } | null> {\n        // 查找可加入的房间\n        let room = this._findAvailableRoom(name)\n\n        // 没有则创建\n        if (!room) {\n            room = await this.create(name, options)\n            if (!room) return null\n        }\n\n        // 加入房间\n        const player = await room._addPlayer(playerId, conn)\n        if (!player) return null\n\n        this._playerToRoom.set(playerId, room.id)\n\n        console.log(`[Room] Player ${playerId} joined ${room.id}`)\n        return { room, player }\n    }\n\n    /**\n     * @zh 加入指定房间\n     * @en Join specific room\n     */\n    async joinById(\n        roomId: string,\n        playerId: string,\n        conn: any\n    ): Promise<{ room: Room; player: Player } | null> {\n        const room = this._rooms.get(roomId)\n        if (!room) return null\n\n        const player = await room._addPlayer(playerId, conn)\n        if (!player) return null\n\n        this._playerToRoom.set(playerId, room.id)\n\n        console.log(`[Room] Player ${playerId} joined ${room.id}`)\n        return { room, player }\n    }\n\n    /**\n     * @zh 玩家离开\n     * @en Player leave\n     */\n    async leave(playerId: string, reason?: string): Promise<void> {\n        const roomId = this._playerToRoom.get(playerId)\n        if (!roomId) return\n\n        const room = this._rooms.get(roomId)\n        if (room) {\n            await room._removePlayer(playerId, reason)\n        }\n\n        this._playerToRoom.delete(playerId)\n        console.log(`[Room] Player ${playerId} left ${roomId}`)\n    }\n\n    /**\n     * @zh 处理消息\n     * @en Handle message\n     */\n    handleMessage(playerId: string, type: string, data: unknown): void {\n        const roomId = this._playerToRoom.get(playerId)\n        if (!roomId) return\n\n        const room = this._rooms.get(roomId)\n        if (room) {\n            room._handleMessage(type, data, playerId)\n        }\n    }\n\n    /**\n     * @zh 获取房间\n     * @en Get room\n     */\n    getRoom(roomId: string): Room | undefined {\n        return this._rooms.get(roomId)\n    }\n\n    /**\n     * @zh 获取玩家所在房间\n     * @en Get player's room\n     */\n    getPlayerRoom(playerId: string): Room | undefined {\n        const roomId = this._playerToRoom.get(playerId)\n        return roomId ? this._rooms.get(roomId) : undefined\n    }\n\n    /**\n     * @zh 获取所有房间\n     * @en Get all rooms\n     */\n    getRooms(): ReadonlyArray<Room> {\n        return Array.from(this._rooms.values())\n    }\n\n    /**\n     * @zh 获取指定类型的所有房间\n     * @en Get all rooms of a type\n     */\n    getRoomsByType(name: string): Room[] {\n        const def = this._definitions.get(name)\n        if (!def) return []\n\n        return Array.from(this._rooms.values()).filter(\n            room => room instanceof def.roomClass\n        )\n    }\n\n    private _findAvailableRoom(name: string): Room | null {\n        const def = this._definitions.get(name)\n        if (!def) return null\n\n        for (const room of this._rooms.values()) {\n            if (\n                room instanceof def.roomClass &&\n                !room.isFull &&\n                !room.isLocked &&\n                !room.isDisposed\n            ) {\n                return room\n            }\n        }\n\n        return null\n    }\n\n    private _generateRoomId(): string {\n        return `room_${this._nextRoomId++}`\n    }\n}\n","/**\n * @zh 游戏服务器核心\n * @en Game server core\n */\n\nimport * as path from 'node:path'\nimport { serve, type RpcServer } from '@esengine/rpc/server'\nimport { rpc } from '@esengine/rpc'\nimport type {\n    ServerConfig,\n    ServerConnection,\n    GameServer,\n    ApiContext,\n    MsgContext,\n    LoadedApiHandler,\n    LoadedMsgHandler,\n} from '../types/index.js'\nimport { loadApiHandlers, loadMsgHandlers } from '../router/loader.js'\nimport { RoomManager, type RoomClass, type Room } from '../room/index.js'\n\n/**\n * @zh 默认配置\n * @en Default configuration\n */\nconst DEFAULT_CONFIG: Required<Omit<ServerConfig, 'onStart' | 'onConnect' | 'onDisconnect'>> = {\n    port: 3000,\n    apiDir: 'src/api',\n    msgDir: 'src/msg',\n    tickRate: 20,\n}\n\n/**\n * @zh 创建游戏服务器\n * @en Create game server\n *\n * @example\n * ```typescript\n * import { createServer, Room, onMessage } from '@esengine/server'\n *\n * class GameRoom extends Room {\n *     onJoin(player) {\n *         this.broadcast('Joined', { id: player.id })\n *     }\n * }\n *\n * const server = await createServer({ port: 3000 })\n * server.define('game', GameRoom)\n * await server.start()\n * ```\n */\nexport async function createServer(config: ServerConfig = {}): Promise<GameServer> {\n    const opts = { ...DEFAULT_CONFIG, ...config }\n    const cwd = process.cwd()\n\n    // 加载文件路由处理器\n    const apiHandlers = await loadApiHandlers(path.resolve(cwd, opts.apiDir))\n    const msgHandlers = await loadMsgHandlers(path.resolve(cwd, opts.msgDir))\n\n    if (apiHandlers.length > 0) {\n        console.log(`[Server] Loaded ${apiHandlers.length} API handlers`)\n    }\n    if (msgHandlers.length > 0) {\n        console.log(`[Server] Loaded ${msgHandlers.length} message handlers`)\n    }\n\n    // 动态构建协议\n    const apiDefs: Record<string, ReturnType<typeof rpc.api>> = {\n        // 内置 API\n        JoinRoom: rpc.api(),\n        LeaveRoom: rpc.api(),\n    }\n    const msgDefs: Record<string, ReturnType<typeof rpc.msg>> = {\n        // 内置消息（房间消息透传）\n        RoomMessage: rpc.msg(),\n    }\n\n    for (const handler of apiHandlers) {\n        apiDefs[handler.name] = rpc.api()\n    }\n    for (const handler of msgHandlers) {\n        msgDefs[handler.name] = rpc.msg()\n    }\n\n    const protocol = rpc.define({\n        api: apiDefs,\n        msg: msgDefs,\n    })\n\n    // 服务器状态\n    let currentTick = 0\n    let tickInterval: ReturnType<typeof setInterval> | null = null\n    let rpcServer: RpcServer<typeof protocol, Record<string, unknown>> | null = null\n\n    // 房间管理器（立即初始化，以便 define() 可在 start() 前调用）\n    const roomManager = new RoomManager((conn, type, data) => {\n        rpcServer?.send(conn, 'RoomMessage' as any, { type, data } as any)\n    })\n\n    // 构建 API 处理器映射\n    const apiMap: Record<string, LoadedApiHandler> = {}\n    for (const handler of apiHandlers) {\n        apiMap[handler.name] = handler\n    }\n\n    // 构建消息处理器映射\n    const msgMap: Record<string, LoadedMsgHandler> = {}\n    for (const handler of msgHandlers) {\n        msgMap[handler.name] = handler\n    }\n\n    // 游戏服务器实例\n    const gameServer: GameServer & {\n        rooms: RoomManager\n    } = {\n        get connections() {\n            return (rpcServer?.connections ?? []) as ReadonlyArray<ServerConnection>\n        },\n\n        get tick() {\n            return currentTick\n        },\n\n        get rooms() {\n            return roomManager\n        },\n\n        /**\n         * @zh 注册房间类型\n         * @en Define room type\n         */\n        define(name: string, roomClass: new () => unknown): void {\n            roomManager.define(name, roomClass as RoomClass)\n        },\n\n        async start() {\n            // 构建 API handlers\n            const apiHandlersObj: Record<string, (input: unknown, conn: any) => Promise<unknown>> = {}\n\n            // 内置 JoinRoom API\n            apiHandlersObj['JoinRoom'] = async (input: any, conn) => {\n                const { roomType, roomId, options } = input as {\n                    roomType?: string\n                    roomId?: string\n                    options?: Record<string, unknown>\n                }\n\n                if (roomId) {\n                    const result = await roomManager.joinById(roomId, conn.id, conn)\n                    if (!result) {\n                        throw new Error('Failed to join room')\n                    }\n                    return { roomId: result.room.id, playerId: result.player.id }\n                }\n\n                if (roomType) {\n                    const result = await roomManager.joinOrCreate(roomType, conn.id, conn, options)\n                    if (!result) {\n                        throw new Error('Failed to join or create room')\n                    }\n                    return { roomId: result.room.id, playerId: result.player.id }\n                }\n\n                throw new Error('roomType or roomId required')\n            }\n\n            // 内置 LeaveRoom API\n            apiHandlersObj['LeaveRoom'] = async (_input, conn) => {\n                await roomManager.leave(conn.id)\n                return { success: true }\n            }\n\n            // 文件路由 API\n            for (const [name, handler] of Object.entries(apiMap)) {\n                apiHandlersObj[name] = async (input, conn) => {\n                    const ctx: ApiContext = {\n                        conn: conn as ServerConnection,\n                        server: gameServer,\n                    }\n                    return handler.definition.handler(input, ctx)\n                }\n            }\n\n            // 构建消息 handlers\n            const msgHandlersObj: Record<string, (data: unknown, conn: any) => void | Promise<void>> = {}\n\n            // 内置 RoomMessage 处理\n            msgHandlersObj['RoomMessage'] = async (data: any, conn) => {\n                const { type, data: payload } = data as { type: string; data: unknown }\n                roomManager.handleMessage(conn.id, type, payload)\n            }\n\n            // 文件路由消息\n            for (const [name, handler] of Object.entries(msgMap)) {\n                msgHandlersObj[name] = async (data, conn) => {\n                    const ctx: MsgContext = {\n                        conn: conn as ServerConnection,\n                        server: gameServer,\n                    }\n                    await handler.definition.handler(data, ctx)\n                }\n            }\n\n            rpcServer = serve(protocol, {\n                port: opts.port,\n                createConnData: () => ({}),\n                onStart: (p) => {\n                    console.log(`[Server] Started on ws://localhost:${p}`)\n                    opts.onStart?.(p)\n                },\n                onConnect: async (conn) => {\n                    await config.onConnect?.(conn as ServerConnection)\n                },\n                onDisconnect: async (conn) => {\n                    // 玩家断线时自动离开房间\n                    await roomManager?.leave(conn.id, 'disconnected')\n                    await config.onDisconnect?.(conn as ServerConnection)\n                },\n                api: apiHandlersObj as any,\n                msg: msgHandlersObj as any,\n            })\n\n            await rpcServer.start()\n\n            // 启动 tick 循环\n            if (opts.tickRate > 0) {\n                tickInterval = setInterval(() => {\n                    currentTick++\n                }, 1000 / opts.tickRate)\n            }\n        },\n\n        async stop() {\n            if (tickInterval) {\n                clearInterval(tickInterval)\n                tickInterval = null\n            }\n            if (rpcServer) {\n                await rpcServer.stop()\n                rpcServer = null\n            }\n        },\n\n        broadcast(name, data) {\n            rpcServer?.broadcast(name as any, data as any)\n        },\n\n        send(conn, name, data) {\n            rpcServer?.send(conn as any, name as any, data as any)\n        },\n    }\n\n    return gameServer as GameServer\n}\n"]}

package/dist/decorators-DY8nZ8Nh.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @zh 房间装饰器
+ * @en Room decorators
+ */
+/**
+ * @zh 消息处理器装饰器
+ * @en Message handler decorator
+ *
+ * @example
+ * ```typescript
+ * class GameRoom extends Room {
+ *     @onMessage('Move')
+ *     handleMove(data: { x: number, y: number }, player: Player) {
+ *         // handle move
+ *     }
+ *
+ *     @onMessage('Chat')
+ *     handleChat(data: { text: string }, player: Player) {
+ *         this.broadcast('Chat', { from: player.id, text: data.text })
+ *     }
+ * }
+ * ```
+ */
+declare function onMessage(type: string): MethodDecorator;
+
+export { onMessage as o };

package/dist/ecs/index.d.ts

@@ -0,0 +1,159 @@
+import { World, Scene, EntitySystem, Entity } from '@esengine/ecs-framework';
+export { Component, Entity, EntitySystem, Scene, SyncFieldMetadata, SyncMetadata, SyncOperation, SyncType, World, clearChanges, getSyncMetadata, hasChanges, hasSyncFields, initChangeTracker, sync } from '@esengine/ecs-framework';
+import { R as Room, P as Player } from '../Room-BnKpl5Sj.js';
+export { o as onMessage } from '../decorators-DY8nZ8Nh.js';
+import '@esengine/rpc';
+
+/**
+ * @zh ECS 房间基类
+ * @en ECS Room base class
+ */
+
+/**
+ * @zh ECS 房间配置
+ * @en ECS room configuration
+ */
+interface ECSRoomConfig {
+    /**
+     * @zh 状态同步间隔（毫秒）
+     * @en State sync interval in milliseconds
+     */
+    syncInterval: number;
+    /**
+     * @zh 是否启用增量同步
+     * @en Whether to enable delta sync
+     */
+    enableDeltaSync: boolean;
+}
+/**
+ * @zh ECS 房间基类，带有 ECS World 支持和自动状态同步
+ * @en ECS Room base class with ECS World support and automatic state synchronization
+ *
+ * @example
+ * ```typescript
+ * // 服务端启动
+ * Core.create();
+ * setInterval(() => Core.update(1/60), 16);
+ *
+ * // 定义房间
+ * class GameRoom extends ECSRoom {
+ *     onCreate() {
+ *         this.addSystem(new PhysicsSystem());
+ *     }
+ *
+ *     onJoin(player: Player) {
+ *         const entity = this.createPlayerEntity(player.id);
+ *         entity.addComponent(new PlayerComponent());
+ *     }
+ * }
+ * ```
+ */
+declare abstract class ECSRoom<TState = any, TPlayerData = Record<string, unknown>> extends Room<TState, TPlayerData> {
+    /**
+     * @zh ECS World（由 Core.worldManager 管理）
+     * @en ECS World (managed by Core.worldManager)
+     */
+    protected readonly world: World;
+    /**
+     * @zh World 在 WorldManager 中的 ID
+     * @en World ID in WorldManager
+     */
+    protected readonly worldId: string;
+    /**
+     * @zh 房间的主场景
+     * @en Room's main scene
+     */
+    protected readonly scene: Scene;
+    /**
+     * @zh ECS 配置
+     * @en ECS configuration
+     */
+    protected readonly ecsConfig: ECSRoomConfig;
+    /**
+     * @zh 玩家 ID 到实体的映射
+     * @en Player ID to Entity mapping
+     */
+    private readonly _playerEntities;
+    /**
+     * @zh 上次同步时间
+     * @en Last sync time
+     */
+    private _lastSyncTime;
+    constructor(ecsConfig?: Partial<ECSRoomConfig>);
+    /**
+     * @zh 添加系统到场景
+     * @en Add system to scene
+     */
+    protected addSystem(system: EntitySystem): void;
+    /**
+     * @zh 创建实体
+     * @en Create entity
+     */
+    protected createEntity(name?: string): Entity;
+    /**
+     * @zh 为玩家创建实体
+     * @en Create entity for player
+     *
+     * @param playerId - @zh 玩家 ID @en Player ID
+     * @param name - @zh 实体名称 @en Entity name
+     * @returns @zh 创建的实体 @en Created entity
+     */
+    protected createPlayerEntity(playerId: string, name?: string): Entity;
+    /**
+     * @zh 获取玩家的实体
+     * @en Get player's entity
+     */
+    protected getPlayerEntity(playerId: string): Entity | undefined;
+    /**
+     * @zh 销毁玩家的实体
+     * @en Destroy player's entity
+     */
+    protected destroyPlayerEntity(playerId: string): void;
+    /**
+     * @zh 广播二进制数据
+     * @en Broadcast binary data
+     */
+    protected broadcastBinary(data: Uint8Array): void;
+    /**
+     * @zh 发送二进制数据给指定玩家
+     * @en Send binary data to specific player
+     */
+    protected sendBinary(player: Player<TPlayerData>, data: Uint8Array): void;
+    /**
+     * @zh 发送完整状态给玩家（用于玩家刚加入时）
+     * @en Send full state to player (for when player just joined)
+     */
+    protected sendFullState(player: Player<TPlayerData>): void;
+    /**
+     * @zh 广播实体生成
+     * @en Broadcast entity spawn
+     */
+    protected broadcastSpawn(entity: Entity, prefabType?: string): void;
+    /**
+     * @zh 广播增量状态更新
+     * @en Broadcast delta state update
+     */
+    protected broadcastDelta(): void;
+    /**
+     * @zh 游戏循环，处理状态同步
+     * @en Game tick, handles state sync
+     */
+    onTick(_dt: number): void;
+    /**
+     * @zh 玩家离开时自动销毁其实体
+     * @en Auto destroy player entity when leaving
+     */
+    onLeave(player: Player<TPlayerData>, reason?: string): Promise<void>;
+    /**
+     * @zh 房间销毁时从 WorldManager 移除 World
+     * @en Remove World from WorldManager when room is disposed
+     */
+    onDispose(): void;
+    private _getSyncEntities;
+    private _hasSyncComponents;
+    private _hasChanges;
+    private _initComponentTrackers;
+    private _clearChangeTrackers;
+}
+
+export { ECSRoom, type ECSRoomConfig };