@esengine/server 1.1.4 → 1.3.0

package/dist/index.d.ts

@@ -1,173 +1,8 @@
-import { Connection } from '@esengine/rpc';
+import { S as ServerConfig, G as GameServer, A as ApiDefinition, M as MsgDefinition } from './index-DgaJIm6-.js';
+export { b as ApiContext, c as MsgContext, a as ServerConnection } from './index-DgaJIm6-.js';
+export { I as IPlayer, P as Player, R as Room, a as RoomOptions } from './Room-BnKpl5Sj.js';
 export { ErrorCode, RpcError } from '@esengine/rpc';
 
-/**
- * @zh ESEngine Server 类型定义
- * @en ESEngine Server type definitions
- */
-
-/**
- * @zh 服务器配置
- * @en Server configuration
- */
-interface ServerConfig {
-    /**
-     * @zh 监听端口
-     * @en Listen port
-     * @default 3000
-     */
-    port?: number;
-    /**
-     * @zh API 目录路径
-     * @en API directory path
-     * @default 'src/api'
-     */
-    apiDir?: string;
-    /**
-     * @zh 消息处理器目录路径
-     * @en Message handlers directory path
-     * @default 'src/msg'
-     */
-    msgDir?: string;
-    /**
-     * @zh 游戏 Tick 速率 (每秒)
-     * @en Game tick rate (per second)
-     * @default 20
-     */
-    tickRate?: number;
-    /**
-     * @zh 服务器启动回调
-     * @en Server start callback
-     */
-    onStart?: (port: number) => void;
-    /**
-     * @zh 连接建立回调
-     * @en Connection established callback
-     */
-    onConnect?: (conn: ServerConnection) => void | Promise<void>;
-    /**
-     * @zh 连接断开回调
-     * @en Connection closed callback
-     */
-    onDisconnect?: (conn: ServerConnection) => void | Promise<void>;
-}
-/**
- * @zh 服务器连接（扩展 RPC Connection）
- * @en Server connection (extends RPC Connection)
- */
-interface ServerConnection<TData = Record<string, unknown>> extends Connection<TData> {
-    /**
-     * @zh 连接唯一标识（继承自 Connection）
-     * @en Connection unique identifier (inherited from Connection)
-     */
-    readonly id: string;
-    /**
-     * @zh 用户自定义数据
-     * @en User-defined data
-     */
-    data: TData;
-}
-/**
- * @zh API 处理器上下文
- * @en API handler context
- */
-interface ApiContext<TData = Record<string, unknown>> {
-    /**
-     * @zh 当前连接
-     * @en Current connection
-     */
-    conn: ServerConnection<TData>;
-    /**
-     * @zh 服务器实例
-     * @en Server instance
-     */
-    server: GameServer;
-}
-/**
- * @zh API 定义选项
- * @en API definition options
- */
-interface ApiDefinition<TReq = unknown, TRes = unknown, TData = Record<string, unknown>> {
-    /**
-     * @zh API 处理函数
-     * @en API handler function
-     */
-    handler: (req: TReq, ctx: ApiContext<TData>) => TRes | Promise<TRes>;
-    /**
-     * @zh 请求验证函数（可选）
-     * @en Request validation function (optional)
-     */
-    validate?: (req: unknown) => req is TReq;
-}
-/**
- * @zh 消息处理器上下文
- * @en Message handler context
- */
-interface MsgContext<TData = Record<string, unknown>> {
-    /**
-     * @zh 当前连接
-     * @en Current connection
-     */
-    conn: ServerConnection<TData>;
-    /**
-     * @zh 服务器实例
-     * @en Server instance
-     */
-    server: GameServer;
-}
-/**
- * @zh 消息定义选项
- * @en Message definition options
- */
-interface MsgDefinition<TMsg = unknown, TData = Record<string, unknown>> {
-    /**
-     * @zh 消息处理函数
-     * @en Message handler function
-     */
-    handler: (msg: TMsg, ctx: MsgContext<TData>) => void | Promise<void>;
-}
-/**
- * @zh 游戏服务器接口
- * @en Game server interface
- */
-interface GameServer {
-    /**
-     * @zh 启动服务器
-     * @en Start server
-     */
-    start(): Promise<void>;
-    /**
-     * @zh 停止服务器
-     * @en Stop server
-     */
-    stop(): Promise<void>;
-    /**
-     * @zh 广播消息
-     * @en Broadcast message
-     */
-    broadcast<T>(name: string, data: T): void;
-    /**
-     * @zh 发送消息给指定连接
-     * @en Send message to specific connection
-     */
-    send<T>(conn: ServerConnection, name: string, data: T): void;
-    /**
-     * @zh 获取所有连接
-     * @en Get all connections
-     */
-    readonly connections: ReadonlyArray<ServerConnection>;
-    /**
-     * @zh 当前 Tick
-     * @en Current tick
-     */
-    readonly tick: number;
-    /**
-     * @zh 注册房间类型
-     * @en Define room type
-     */
-    define(name: string, roomClass: new () => unknown): void;
-}
-
 /**
  * @zh 游戏服务器核心
  * @en Game server core
@@ -235,240 +70,6 @@ declare function defineApi<TReq, TRes, TData = Record<string, unknown>>(definiti
  */
 declare function defineMsg<TMsg, TData = Record<string, unknown>>(definition: MsgDefinition<TMsg, TData>): MsgDefinition<TMsg, TData>;
 
-/**
- * @zh 玩家类
- * @en Player class
- */
-
-/**
- * @zh 玩家接口
- * @en Player interface
- */
-interface IPlayer<TData = Record<string, unknown>> {
-    readonly id: string;
-    readonly roomId: string;
-    data: TData;
-    send<T>(type: string, data: T): void;
-    leave(reason?: string): void;
-}
-/**
- * @zh 玩家实现
- * @en Player implementation
- */
-declare class Player<TData = Record<string, unknown>> implements IPlayer<TData> {
-    readonly id: string;
-    readonly roomId: string;
-    data: TData;
-    private _conn;
-    private _sendFn;
-    private _leaveFn;
-    constructor(options: {
-        id: string;
-        roomId: string;
-        conn: Connection<any>;
-        sendFn: (conn: Connection<any>, type: string, data: unknown) => void;
-        leaveFn: (player: Player<TData>, reason?: string) => void;
-        initialData?: TData;
-    });
-    /**
-     * @zh 获取底层连接
-     * @en Get underlying connection
-     */
-    get connection(): Connection<any>;
-    /**
-     * @zh 发送消息给玩家
-     * @en Send message to player
-     */
-    send<T>(type: string, data: T): void;
-    /**
-     * @zh 让玩家离开房间
-     * @en Make player leave the room
-     */
-    leave(reason?: string): void;
-}
-
-/**
- * @zh 房间基类
- * @en Room base class
- */
-
-/**
- * @zh 房间配置
- * @en Room options
- */
-interface RoomOptions {
-    [key: string]: unknown;
-}
-/**
- * @zh 房间基类
- * @en Room base class
- *
- * @example
- * ```typescript
- * class GameRoom extends Room {
- *     maxPlayers = 4
- *     tickRate = 20
- *
- *     onJoin(player: Player) {
- *         this.broadcast('Joined', { id: player.id })
- *     }
- *
- *     @onMessage('Move')
- *     handleMove(data: { x: number, y: number }, player: Player) {
- *         // handle move
- *     }
- * }
- * ```
- */
-declare abstract class Room<TState = any, TPlayerData = Record<string, unknown>> {
-    /**
-     * @zh 最大玩家数
-     * @en Maximum players
-     */
-    maxPlayers: number;
-    /**
-     * @zh Tick 速率（每秒），0 = 不自动 tick
-     * @en Tick rate (per second), 0 = no auto tick
-     */
-    tickRate: number;
-    /**
-     * @zh 空房间自动销毁
-     * @en Auto dispose when empty
-     */
-    autoDispose: boolean;
-    /**
-     * @zh 房间状态
-     * @en Room state
-     */
-    state: TState;
-    private _id;
-    private _players;
-    private _locked;
-    private _disposed;
-    private _tickInterval;
-    private _lastTickTime;
-    private _broadcastFn;
-    private _sendFn;
-    private _disposeFn;
-    /**
-     * @zh 房间 ID
-     * @en Room ID
-     */
-    get id(): string;
-    /**
-     * @zh 所有玩家
-     * @en All players
-     */
-    get players(): ReadonlyArray<Player<TPlayerData>>;
-    /**
-     * @zh 玩家数量
-     * @en Player count
-     */
-    get playerCount(): number;
-    /**
-     * @zh 是否已满
-     * @en Is full
-     */
-    get isFull(): boolean;
-    /**
-     * @zh 是否已锁定
-     * @en Is locked
-     */
-    get isLocked(): boolean;
-    /**
-     * @zh 是否已销毁
-     * @en Is disposed
-     */
-    get isDisposed(): boolean;
-    /**
-     * @zh 房间创建时调用
-     * @en Called when room is created
-     */
-    onCreate(options?: RoomOptions): void | Promise<void>;
-    /**
-     * @zh 玩家加入时调用
-     * @en Called when player joins
-     */
-    onJoin(player: Player<TPlayerData>): void | Promise<void>;
-    /**
-     * @zh 玩家离开时调用
-     * @en Called when player leaves
-     */
-    onLeave(player: Player<TPlayerData>, reason?: string): void | Promise<void>;
-    /**
-     * @zh 游戏循环
-     * @en Game tick
-     */
-    onTick(dt: number): void;
-    /**
-     * @zh 房间销毁时调用
-     * @en Called when room is disposed
-     */
-    onDispose(): void | Promise<void>;
-    /**
-     * @zh 广播消息给所有玩家
-     * @en Broadcast message to all players
-     */
-    broadcast<T>(type: string, data: T): void;
-    /**
-     * @zh 广播消息给除指定玩家外的所有玩家
-     * @en Broadcast message to all players except one
-     */
-    broadcastExcept<T>(except: Player<TPlayerData>, type: string, data: T): void;
-    /**
-     * @zh 获取玩家
-     * @en Get player by id
-     */
-    getPlayer(id: string): Player<TPlayerData> | undefined;
-    /**
-     * @zh 踢出玩家
-     * @en Kick player
-     */
-    kick(player: Player<TPlayerData>, reason?: string): void;
-    /**
-     * @zh 锁定房间
-     * @en Lock room
-     */
-    lock(): void;
-    /**
-     * @zh 解锁房间
-     * @en Unlock room
-     */
-    unlock(): void;
-    /**
-     * @zh 手动销毁房间
-     * @en Manually dispose room
-     */
-    dispose(): void;
-    /**
-     * @internal
-     */
-    _init(options: {
-        id: string;
-        sendFn: (conn: any, type: string, data: unknown) => void;
-        broadcastFn: (type: string, data: unknown) => void;
-        disposeFn: () => void;
-    }): void;
-    /**
-     * @internal
-     */
-    _create(options?: RoomOptions): Promise<void>;
-    /**
-     * @internal
-     */
-    _addPlayer(id: string, conn: any): Promise<Player<TPlayerData> | null>;
-    /**
-     * @internal
-     */
-    _removePlayer(id: string, reason?: string): Promise<void>;
-    /**
-     * @internal
-     */
-    _handleMessage(type: string, data: unknown, playerId: string): void;
-    private _startTick;
-    private _stopTick;
-}
-
 /**
  * @zh 房间装饰器
  * @en Room decorators
@@ -494,4 +95,4 @@ declare abstract class Room<TState = any, TPlayerData = Record<string, unknown>>
  */
 declare function onMessage(type: string): MethodDecorator;
 
-export { type ApiContext, type ApiDefinition, type GameServer, type IPlayer, type MsgContext, type MsgDefinition, Player, Room, type RoomOptions, type ServerConfig, type ServerConnection, createServer, defineApi, defineMsg, onMessage };
+export { ApiDefinition, GameServer, MsgDefinition, ServerConfig, createServer, defineApi, defineMsg, onMessage };