@esengine/server 1.1.4 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/Room-BnKpl5Sj.d.ts +237 -0
- package/dist/auth/index.d.ts +711 -0
- package/dist/auth/index.js +707 -0
- package/dist/auth/index.js.map +1 -0
- package/dist/auth/testing/index.d.ts +153 -0
- package/dist/auth/testing/index.js +165 -0
- package/dist/auth/testing/index.js.map +1 -0
- package/dist/chunk-7C6JZO4O.js +744 -0
- package/dist/chunk-7C6JZO4O.js.map +1 -0
- package/dist/chunk-T626JPC7.js +8 -0
- package/dist/chunk-T626JPC7.js.map +1 -0
- package/dist/index-DgaJIm6-.d.ts +170 -0
- package/dist/index.d.ts +4 -403
- package/dist/index.js +3 -745
- package/dist/index.js.map +1 -1
- package/dist/ratelimit/index.d.ts +787 -0
- package/dist/ratelimit/index.js +818 -0
- package/dist/ratelimit/index.js.map +1 -0
- package/dist/testing/index.d.ts +386 -0
- package/dist/testing/index.js +629 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/types-BmO5ykKp.d.ts +311 -0
- package/package.json +30 -3
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/testing/TestClient.ts","../../src/testing/TestServer.ts","../../src/testing/MockRoom.ts"],"names":["PacketType","ApiRequest","ApiResponse","ApiError","Message","TestClient","port","options","_port","_codec","_timeout","_connectTimeout","_ws","_callIdCounter","_connected","_currentRoomId","_currentPlayerId","_pendingCalls","Map","_msgHandlers","_receivedMessages","codec","json","timeout","connectTimeout","isConnected","roomId","playerId","receivedMessages","connect","Promise","resolve","reject","url","WebSocket","setTimeout","close","Error","on","clearTimeout","_rejectAllPending","err","data","_handleMessage","disconnect","readyState","CLOSED","once","joinRoom","roomType","result","call","joinRoomById","leaveRoom","sendToRoom","type","send","name","input","id","timer","delete","set","packet","encode","handler","handlers","get","Set","add","off","waitForMessage","timeoutMs","waitForRoomMessage","msg","hasReceivedMessage","some","m","getMessagesOfType","filter","map","getLastMessage","i","length","undefined","clearMessages","getMessageCount","raw","decode","_handleApiResponse","_handleApiError","_handleMsg","console","error","pending","code","message","push","timestamp","Date","now","reason","clear","getRandomPort","net","server","createServer","listen","address","createTestServer","silent","originalLog","log","tickRate","apiDir","msgDir","start","cleanup","stop","createTestEnv","serverCleanup","clients","createClient","clientOptions","client","createClients","count","newClients","all","c","catch","MockRoom","Room","state","messages","joinCount","leaveCount","onCreate","onJoin","player","broadcast","onLeave","handleAnyMessage","from","handleEcho","handleBroadcast","_player","handlePing","_data","EchoRoom","BroadcastRoom"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @zh 测试客户端\n * @en Test client for server testing\n */\n\nimport WebSocket from 'ws'\nimport { json } from '@esengine/rpc/codec'\nimport type { Codec } from '@esengine/rpc/codec'\n\n// ============================================================================\n// Types | 类型定义\n// ============================================================================\n\n/**\n * @zh 测试客户端配置\n * @en Test client options\n */\nexport interface TestClientOptions {\n /**\n * @zh 编解码器\n * @en Codec\n * @defaultValue json()\n */\n codec?: Codec\n\n /**\n * @zh API 调用超时(毫秒)\n * @en API call timeout in milliseconds\n * @defaultValue 5000\n */\n timeout?: number\n\n /**\n * @zh 连接超时(毫秒)\n * @en Connection timeout in milliseconds\n * @defaultValue 5000\n */\n connectTimeout?: number\n}\n\n/**\n * @zh 房间加入结果\n * @en Room join result\n */\nexport interface JoinRoomResult {\n roomId: string\n playerId: string\n}\n\n/**\n * @zh 收到的消息记录\n * @en Received message record\n */\nexport interface ReceivedMessage {\n type: string\n data: unknown\n timestamp: number\n}\n\n// ============================================================================\n// Constants | 常量\n// ============================================================================\n\nconst PacketType = {\n ApiRequest: 0,\n ApiResponse: 1,\n ApiError: 2,\n Message: 3,\n} as const\n\n// ============================================================================\n// TestClient Class | 测试客户端类\n// ============================================================================\n\ninterface PendingCall {\n resolve: (value: unknown) => void\n reject: (error: Error) => void\n timer: ReturnType<typeof setTimeout>\n}\n\n/**\n * @zh 测试客户端\n * @en Test client for server integration testing\n *\n * @zh 专为测试设计的客户端,提供便捷的断言方法和消息记录功能\n * @en Client designed for testing, with convenient assertion methods and message recording\n *\n * @example\n * ```typescript\n * const client = new TestClient(3000)\n * await client.connect()\n *\n * // 加入房间\n * const { roomId } = await client.joinRoom('game')\n *\n * // 发送消息\n * client.sendToRoom('Move', { x: 10, y: 20 })\n *\n * // 等待收到特定消息\n * const msg = await client.waitForMessage('PlayerMoved')\n *\n * // 断言收到消息\n * expect(client.hasReceivedMessage('PlayerMoved')).toBe(true)\n *\n * await client.disconnect()\n * ```\n */\nexport class TestClient {\n private readonly _port: number\n private readonly _codec: Codec\n private readonly _timeout: number\n private readonly _connectTimeout: number\n\n private _ws: WebSocket | null = null\n private _callIdCounter = 0\n private _connected = false\n private _currentRoomId: string | null = null\n private _currentPlayerId: string | null = null\n\n private readonly _pendingCalls = new Map<number, PendingCall>()\n private readonly _msgHandlers = new Map<string, Set<(data: unknown) => void>>()\n private readonly _receivedMessages: ReceivedMessage[] = []\n\n constructor(port: number, options: TestClientOptions = {}) {\n this._port = port\n this._codec = options.codec ?? json()\n this._timeout = options.timeout ?? 5000\n this._connectTimeout = options.connectTimeout ?? 5000\n }\n\n // ========================================================================\n // Properties | 属性\n // ========================================================================\n\n /**\n * @zh 是否已连接\n * @en Whether connected\n */\n get isConnected(): boolean {\n return this._connected\n }\n\n /**\n * @zh 当前房间 ID\n * @en Current room ID\n */\n get roomId(): string | null {\n return this._currentRoomId\n }\n\n /**\n * @zh 当前玩家 ID\n * @en Current player ID\n */\n get playerId(): string | null {\n return this._currentPlayerId\n }\n\n /**\n * @zh 收到的所有消息\n * @en All received messages\n */\n get receivedMessages(): ReadonlyArray<ReceivedMessage> {\n return this._receivedMessages\n }\n\n // ========================================================================\n // Connection | 连接管理\n // ========================================================================\n\n /**\n * @zh 连接到服务器\n * @en Connect to server\n */\n connect(): Promise<this> {\n return new Promise((resolve, reject) => {\n const url = `ws://localhost:${this._port}`\n this._ws = new WebSocket(url)\n\n const timeout = setTimeout(() => {\n this._ws?.close()\n reject(new Error(`Connection timeout after ${this._connectTimeout}ms`))\n }, this._connectTimeout)\n\n this._ws.on('open', () => {\n clearTimeout(timeout)\n this._connected = true\n resolve(this)\n })\n\n this._ws.on('close', () => {\n this._connected = false\n this._rejectAllPending('Connection closed')\n })\n\n this._ws.on('error', (err) => {\n clearTimeout(timeout)\n if (!this._connected) {\n reject(err)\n }\n })\n\n this._ws.on('message', (data: Buffer) => {\n this._handleMessage(data)\n })\n })\n }\n\n /**\n * @zh 断开连接\n * @en Disconnect from server\n */\n async disconnect(): Promise<void> {\n return new Promise((resolve) => {\n if (!this._ws || this._ws.readyState === WebSocket.CLOSED) {\n resolve()\n return\n }\n\n this._ws.once('close', () => {\n this._connected = false\n this._ws = null\n resolve()\n })\n\n this._ws.close()\n })\n }\n\n // ========================================================================\n // Room Operations | 房间操作\n // ========================================================================\n\n /**\n * @zh 加入房间\n * @en Join a room\n */\n async joinRoom(roomType: string, options?: Record<string, unknown>): Promise<JoinRoomResult> {\n const result = await this.call<JoinRoomResult>('JoinRoom', { roomType, options })\n this._currentRoomId = result.roomId\n this._currentPlayerId = result.playerId\n return result\n }\n\n /**\n * @zh 通过 ID 加入房间\n * @en Join a room by ID\n */\n async joinRoomById(roomId: string): Promise<JoinRoomResult> {\n const result = await this.call<JoinRoomResult>('JoinRoom', { roomId })\n this._currentRoomId = result.roomId\n this._currentPlayerId = result.playerId\n return result\n }\n\n /**\n * @zh 离开房间\n * @en Leave room\n */\n async leaveRoom(): Promise<void> {\n await this.call('LeaveRoom', {})\n this._currentRoomId = null\n this._currentPlayerId = null\n }\n\n /**\n * @zh 发送消息到房间\n * @en Send message to room\n */\n sendToRoom(type: string, data: unknown): void {\n this.send('RoomMessage', { type, data })\n }\n\n // ========================================================================\n // API Calls | API 调用\n // ========================================================================\n\n /**\n * @zh 调用 API\n * @en Call API\n */\n call<T = unknown>(name: string, input: unknown): Promise<T> {\n return new Promise((resolve, reject) => {\n if (!this._connected || !this._ws) {\n reject(new Error('Not connected'))\n return\n }\n\n const id = ++this._callIdCounter\n const timer = setTimeout(() => {\n this._pendingCalls.delete(id)\n reject(new Error(`API call '${name}' timeout after ${this._timeout}ms`))\n }, this._timeout)\n\n this._pendingCalls.set(id, {\n resolve: resolve as (v: unknown) => void,\n reject,\n timer,\n })\n\n const packet = [PacketType.ApiRequest, id, name, input]\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n this._ws.send(this._codec.encode(packet as any) as Buffer)\n })\n }\n\n /**\n * @zh 发送消息\n * @en Send message\n */\n send(name: string, data: unknown): void {\n if (!this._connected || !this._ws) return\n const packet = [PacketType.Message, name, data]\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n this._ws.send(this._codec.encode(packet as any) as Buffer)\n }\n\n // ========================================================================\n // Message Handling | 消息处理\n // ========================================================================\n\n /**\n * @zh 监听消息\n * @en Listen for message\n */\n on(name: string, handler: (data: unknown) => void): this {\n let handlers = this._msgHandlers.get(name)\n if (!handlers) {\n handlers = new Set()\n this._msgHandlers.set(name, handlers)\n }\n handlers.add(handler)\n return this\n }\n\n /**\n * @zh 取消监听消息\n * @en Remove message listener\n */\n off(name: string, handler?: (data: unknown) => void): this {\n if (handler) {\n this._msgHandlers.get(name)?.delete(handler)\n } else {\n this._msgHandlers.delete(name)\n }\n return this\n }\n\n /**\n * @zh 等待收到指定消息\n * @en Wait for a specific message\n */\n waitForMessage<T = unknown>(type: string, timeout?: number): Promise<T> {\n return new Promise((resolve, reject) => {\n const timeoutMs = timeout ?? this._timeout\n\n const timer = setTimeout(() => {\n this.off(type, handler)\n reject(new Error(`Timeout waiting for message '${type}' after ${timeoutMs}ms`))\n }, timeoutMs)\n\n const handler = (data: unknown) => {\n clearTimeout(timer)\n this.off(type, handler)\n resolve(data as T)\n }\n\n this.on(type, handler)\n })\n }\n\n /**\n * @zh 等待收到指定房间消息\n * @en Wait for a specific room message\n */\n waitForRoomMessage<T = unknown>(type: string, timeout?: number): Promise<T> {\n return new Promise((resolve, reject) => {\n const timeoutMs = timeout ?? this._timeout\n\n const timer = setTimeout(() => {\n this.off('RoomMessage', handler)\n reject(new Error(`Timeout waiting for room message '${type}' after ${timeoutMs}ms`))\n }, timeoutMs)\n\n const handler = (data: unknown) => {\n const msg = data as { type: string; data: unknown }\n if (msg.type === type) {\n clearTimeout(timer)\n this.off('RoomMessage', handler)\n resolve(msg.data as T)\n }\n }\n\n this.on('RoomMessage', handler)\n })\n }\n\n // ========================================================================\n // Assertions | 断言辅助\n // ========================================================================\n\n /**\n * @zh 是否收到过指定消息\n * @en Whether received a specific message\n */\n hasReceivedMessage(type: string): boolean {\n return this._receivedMessages.some((m) => m.type === type)\n }\n\n /**\n * @zh 获取指定类型的所有消息\n * @en Get all messages of a specific type\n */\n getMessagesOfType<T = unknown>(type: string): T[] {\n return this._receivedMessages\n .filter((m) => m.type === type)\n .map((m) => m.data as T)\n }\n\n /**\n * @zh 获取最后收到的指定类型消息\n * @en Get the last received message of a specific type\n */\n getLastMessage<T = unknown>(type: string): T | undefined {\n for (let i = this._receivedMessages.length - 1; i >= 0; i--) {\n if (this._receivedMessages[i].type === type) {\n return this._receivedMessages[i].data as T\n }\n }\n return undefined\n }\n\n /**\n * @zh 清空消息记录\n * @en Clear message records\n */\n clearMessages(): void {\n this._receivedMessages.length = 0\n }\n\n /**\n * @zh 获取收到的消息数量\n * @en Get received message count\n */\n getMessageCount(type?: string): number {\n if (type) {\n return this._receivedMessages.filter((m) => m.type === type).length\n }\n return this._receivedMessages.length\n }\n\n // ========================================================================\n // Private Methods | 私有方法\n // ========================================================================\n\n private _handleMessage(raw: Buffer): void {\n try {\n const packet = this._codec.decode(raw) as unknown[]\n const type = packet[0] as number\n\n switch (type) {\n case PacketType.ApiResponse:\n this._handleApiResponse([packet[0], packet[1], packet[2]] as [number, number, unknown])\n break\n case PacketType.ApiError:\n this._handleApiError([packet[0], packet[1], packet[2], packet[3]] as [number, number, string, string])\n break\n case PacketType.Message:\n this._handleMsg([packet[0], packet[1], packet[2]] as [number, string, unknown])\n break\n }\n } catch (err) {\n console.error('[TestClient] Failed to handle message:', err)\n }\n }\n\n private _handleApiResponse([, id, result]: [number, number, unknown]): void {\n const pending = this._pendingCalls.get(id)\n if (pending) {\n clearTimeout(pending.timer)\n this._pendingCalls.delete(id)\n pending.resolve(result)\n }\n }\n\n private _handleApiError([, id, code, message]: [number, number, string, string]): void {\n const pending = this._pendingCalls.get(id)\n if (pending) {\n clearTimeout(pending.timer)\n this._pendingCalls.delete(id)\n pending.reject(new Error(`[${code}] ${message}`))\n }\n }\n\n private _handleMsg([, name, data]: [number, string, unknown]): void {\n // 记录消息\n this._receivedMessages.push({\n type: name,\n data,\n timestamp: Date.now(),\n })\n\n // 触发处理器\n const handlers = this._msgHandlers.get(name)\n if (handlers) {\n for (const handler of handlers) {\n try {\n handler(data)\n } catch (err) {\n console.error('[TestClient] Handler error:', err)\n }\n }\n }\n }\n\n private _rejectAllPending(reason: string): void {\n for (const [, pending] of this._pendingCalls) {\n clearTimeout(pending.timer)\n pending.reject(new Error(reason))\n }\n this._pendingCalls.clear()\n }\n}\n","/**\n * @zh 测试服务器工具\n * @en Test server utilities\n */\n\nimport { createServer } from '../core/server.js'\nimport type { GameServer } from '../types/index.js'\nimport { TestClient, type TestClientOptions } from './TestClient.js'\n\n// ============================================================================\n// Types | 类型定义\n// ============================================================================\n\n/**\n * @zh 测试服务器配置\n * @en Test server options\n */\nexport interface TestServerOptions {\n /**\n * @zh 端口号,0 表示随机端口\n * @en Port number, 0 for random port\n * @defaultValue 0\n */\n port?: number\n\n /**\n * @zh Tick 速率\n * @en Tick rate\n * @defaultValue 0\n */\n tickRate?: number\n\n /**\n * @zh 是否禁用控制台日志\n * @en Whether to suppress console logs\n * @defaultValue true\n */\n silent?: boolean\n}\n\n/**\n * @zh 测试环境\n * @en Test environment\n */\nexport interface TestEnvironment {\n /**\n * @zh 服务器实例\n * @en Server instance\n */\n server: GameServer\n\n /**\n * @zh 服务器端口\n * @en Server port\n */\n port: number\n\n /**\n * @zh 创建测试客户端\n * @en Create test client\n */\n createClient(options?: TestClientOptions): Promise<TestClient>\n\n /**\n * @zh 创建多个测试客户端\n * @en Create multiple test clients\n */\n createClients(count: number, options?: TestClientOptions): Promise<TestClient[]>\n\n /**\n * @zh 清理测试环境\n * @en Cleanup test environment\n */\n cleanup(): Promise<void>\n\n /**\n * @zh 所有已创建的客户端\n * @en All created clients\n */\n readonly clients: ReadonlyArray<TestClient>\n}\n\n// ============================================================================\n// Helper Functions | 辅助函数\n// ============================================================================\n\n/**\n * @zh 获取随机可用端口\n * @en Get a random available port\n */\nasync function getRandomPort(): Promise<number> {\n const net = await import('node:net')\n return new Promise((resolve, reject) => {\n const server = net.createServer()\n server.listen(0, () => {\n const address = server.address()\n if (address && typeof address === 'object') {\n const port = address.port\n server.close(() => resolve(port))\n } else {\n server.close(() => reject(new Error('Failed to get port')))\n }\n })\n server.on('error', reject)\n })\n}\n\n/**\n * @zh 等待指定毫秒\n * @en Wait for specified milliseconds\n */\nexport function wait(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\n// ============================================================================\n// Factory Functions | 工厂函数\n// ============================================================================\n\n/**\n * @zh 创建测试服务器\n * @en Create test server\n *\n * @example\n * ```typescript\n * const { server, port, cleanup } = await createTestServer()\n * server.define('game', GameRoom)\n *\n * const client = new TestClient(port)\n * await client.connect()\n *\n * // ... run tests ...\n *\n * await cleanup()\n * ```\n */\nexport async function createTestServer(\n options: TestServerOptions = {}\n): Promise<{ server: GameServer; port: number; cleanup: () => Promise<void> }> {\n const port = options.port || (await getRandomPort())\n const silent = options.silent ?? true\n\n // 临时禁用 console.log\n const originalLog = console.log\n if (silent) {\n console.log = () => {}\n }\n\n const server = await createServer({\n port,\n tickRate: options.tickRate ?? 0,\n apiDir: '__non_existent_api__',\n msgDir: '__non_existent_msg__',\n })\n\n await server.start()\n\n // 恢复 console.log\n if (silent) {\n console.log = originalLog\n }\n\n return {\n server,\n port,\n cleanup: async () => {\n await server.stop()\n },\n }\n}\n\n/**\n * @zh 创建完整测试环境\n * @en Create complete test environment\n *\n * @zh 包含服务器、客户端创建和清理功能的完整测试环境\n * @en Complete test environment with server, client creation and cleanup\n *\n * @example\n * ```typescript\n * describe('GameRoom', () => {\n * let env: TestEnvironment\n *\n * beforeEach(async () => {\n * env = await createTestEnv()\n * env.server.define('game', GameRoom)\n * })\n *\n * afterEach(async () => {\n * await env.cleanup()\n * })\n *\n * it('should handle player join', async () => {\n * const client = await env.createClient()\n * const result = await client.joinRoom('game')\n * expect(result.roomId).toBeDefined()\n * })\n *\n * it('should broadcast to all players', async () => {\n * const [client1, client2] = await env.createClients(2)\n *\n * await client1.joinRoom('game')\n * const joinPromise = client1.waitForRoomMessage('PlayerJoined')\n *\n * await client2.joinRoom('game')\n * const msg = await joinPromise\n *\n * expect(msg).toBeDefined()\n * })\n * })\n * ```\n */\nexport async function createTestEnv(options: TestServerOptions = {}): Promise<TestEnvironment> {\n const { server, port, cleanup: serverCleanup } = await createTestServer(options)\n const clients: TestClient[] = []\n\n return {\n server,\n port,\n clients,\n\n async createClient(clientOptions?: TestClientOptions): Promise<TestClient> {\n const client = new TestClient(port, clientOptions)\n await client.connect()\n clients.push(client)\n return client\n },\n\n async createClients(count: number, clientOptions?: TestClientOptions): Promise<TestClient[]> {\n const newClients: TestClient[] = []\n for (let i = 0; i < count; i++) {\n const client = new TestClient(port, clientOptions)\n await client.connect()\n clients.push(client)\n newClients.push(client)\n }\n return newClients\n },\n\n async cleanup(): Promise<void> {\n // 断开所有客户端\n await Promise.all(clients.map((c) => c.disconnect().catch(() => {})))\n clients.length = 0\n\n // 停止服务器\n await serverCleanup()\n },\n }\n}\n","/**\n * @zh 模拟房间\n * @en Mock room for testing\n */\n\nimport { Room, onMessage, type Player } from '../room/index.js'\n\n/**\n * @zh 模拟房间状态\n * @en Mock room state\n */\nexport interface MockRoomState {\n messages: Array<{ type: string; data: unknown; playerId: string }>\n joinCount: number\n leaveCount: number\n}\n\n/**\n * @zh 模拟房间\n * @en Mock room for testing\n *\n * @zh 记录所有事件和消息,用于测试断言\n * @en Records all events and messages for test assertions\n *\n * @example\n * ```typescript\n * const env = await createTestEnv()\n * env.server.define('mock', MockRoom)\n *\n * const client = await env.createClient()\n * await client.joinRoom('mock')\n *\n * client.sendToRoom('Test', { value: 123 })\n * await wait(50)\n *\n * // MockRoom 会广播收到的消息\n * const msg = client.getLastMessage('RoomMessage')\n * ```\n */\nexport class MockRoom extends Room<MockRoomState> {\n state: MockRoomState = {\n messages: [],\n joinCount: 0,\n leaveCount: 0,\n }\n\n onCreate(): void {\n // 房间创建\n }\n\n onJoin(player: Player): void {\n this.state.joinCount++\n this.broadcast('PlayerJoined', {\n playerId: player.id,\n joinCount: this.state.joinCount,\n })\n }\n\n onLeave(player: Player): void {\n this.state.leaveCount++\n this.broadcast('PlayerLeft', {\n playerId: player.id,\n leaveCount: this.state.leaveCount,\n })\n }\n\n @onMessage('*')\n handleAnyMessage(data: unknown, player: Player, type: string): void {\n this.state.messages.push({\n type,\n data,\n playerId: player.id,\n })\n\n // 回显消息给所有玩家\n this.broadcast('MessageReceived', {\n type,\n data,\n from: player.id,\n })\n }\n\n @onMessage('Echo')\n handleEcho(data: unknown, player: Player): void {\n // 只回复给发送者\n player.send('EchoReply', data)\n }\n\n @onMessage('Broadcast')\n handleBroadcast(data: unknown, _player: Player): void {\n this.broadcast('BroadcastMessage', data)\n }\n\n @onMessage('Ping')\n handlePing(_data: unknown, player: Player): void {\n player.send('Pong', { timestamp: Date.now() })\n }\n}\n\n/**\n * @zh 简单回显房间\n * @en Simple echo room\n *\n * @zh 将收到的任何消息回显给发送者\n * @en Echoes any received message back to sender\n */\nexport class EchoRoom extends Room {\n @onMessage('*')\n handleAnyMessage(data: unknown, player: Player, type: string): void {\n player.send(type, data)\n }\n}\n\n/**\n * @zh 广播房间\n * @en Broadcast room\n *\n * @zh 将收到的任何消息广播给所有玩家\n * @en Broadcasts any received message to all players\n */\nexport class BroadcastRoom extends Room {\n onJoin(player: Player): void {\n this.broadcast('PlayerJoined', { id: player.id })\n }\n\n onLeave(player: Player): void {\n this.broadcast('PlayerLeft', { id: player.id })\n }\n\n @onMessage('*')\n handleAnyMessage(data: unknown, player: Player, type: string): void {\n this.broadcast(type, { from: player.id, data })\n }\n}\n"]}
|
|
@@ -0,0 +1,311 @@
|
|
|
1
|
+
import { a as ServerConnection, b as ApiContext, c as MsgContext, G as GameServer } from './index-DgaJIm6-.js';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* @zh 认证系统类型定义
|
|
5
|
+
* @en Authentication system type definitions
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* @zh 认证错误代码
|
|
10
|
+
* @en Authentication error codes
|
|
11
|
+
*/
|
|
12
|
+
type AuthErrorCode = 'INVALID_CREDENTIALS' | 'EXPIRED_TOKEN' | 'INVALID_TOKEN' | 'USER_NOT_FOUND' | 'ACCOUNT_DISABLED' | 'RATE_LIMITED' | 'INSUFFICIENT_PERMISSIONS';
|
|
13
|
+
/**
|
|
14
|
+
* @zh 认证结果
|
|
15
|
+
* @en Authentication result
|
|
16
|
+
*/
|
|
17
|
+
interface AuthResult<TUser = unknown> {
|
|
18
|
+
/**
|
|
19
|
+
* @zh 是否成功
|
|
20
|
+
* @en Whether succeeded
|
|
21
|
+
*/
|
|
22
|
+
success: boolean;
|
|
23
|
+
/**
|
|
24
|
+
* @zh 用户信息
|
|
25
|
+
* @en User information
|
|
26
|
+
*/
|
|
27
|
+
user?: TUser;
|
|
28
|
+
/**
|
|
29
|
+
* @zh 错误信息
|
|
30
|
+
* @en Error message
|
|
31
|
+
*/
|
|
32
|
+
error?: string;
|
|
33
|
+
/**
|
|
34
|
+
* @zh 错误代码
|
|
35
|
+
* @en Error code
|
|
36
|
+
*/
|
|
37
|
+
errorCode?: AuthErrorCode;
|
|
38
|
+
/**
|
|
39
|
+
* @zh 令牌
|
|
40
|
+
* @en Token
|
|
41
|
+
*/
|
|
42
|
+
token?: string;
|
|
43
|
+
/**
|
|
44
|
+
* @zh 令牌过期时间(时间戳)
|
|
45
|
+
* @en Token expiration time (timestamp)
|
|
46
|
+
*/
|
|
47
|
+
expiresAt?: number;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* @zh 认证提供者接口
|
|
51
|
+
* @en Authentication provider interface
|
|
52
|
+
*/
|
|
53
|
+
interface IAuthProvider<TUser = unknown, TCredentials = unknown> {
|
|
54
|
+
/**
|
|
55
|
+
* @zh 提供者名称
|
|
56
|
+
* @en Provider name
|
|
57
|
+
*/
|
|
58
|
+
readonly name: string;
|
|
59
|
+
/**
|
|
60
|
+
* @zh 验证凭证
|
|
61
|
+
* @en Verify credentials
|
|
62
|
+
*
|
|
63
|
+
* @param credentials - @zh 凭证数据 @en Credential data
|
|
64
|
+
* @returns @zh 验证结果 @en Verification result
|
|
65
|
+
*/
|
|
66
|
+
verify(credentials: TCredentials): Promise<AuthResult<TUser>>;
|
|
67
|
+
/**
|
|
68
|
+
* @zh 刷新令牌(可选)
|
|
69
|
+
* @en Refresh token (optional)
|
|
70
|
+
*/
|
|
71
|
+
refresh?(token: string): Promise<AuthResult<TUser>>;
|
|
72
|
+
/**
|
|
73
|
+
* @zh 撤销令牌(可选)
|
|
74
|
+
* @en Revoke token (optional)
|
|
75
|
+
*/
|
|
76
|
+
revoke?(token: string): Promise<boolean>;
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* @zh 认证上下文接口
|
|
80
|
+
* @en Authentication context interface
|
|
81
|
+
*/
|
|
82
|
+
interface IAuthContext<TUser = unknown> {
|
|
83
|
+
/**
|
|
84
|
+
* @zh 是否已认证
|
|
85
|
+
* @en Whether authenticated
|
|
86
|
+
*/
|
|
87
|
+
readonly isAuthenticated: boolean;
|
|
88
|
+
/**
|
|
89
|
+
* @zh 用户信息
|
|
90
|
+
* @en User information
|
|
91
|
+
*/
|
|
92
|
+
readonly user: TUser | null;
|
|
93
|
+
/**
|
|
94
|
+
* @zh 用户 ID
|
|
95
|
+
* @en User ID
|
|
96
|
+
*/
|
|
97
|
+
readonly userId: string | null;
|
|
98
|
+
/**
|
|
99
|
+
* @zh 用户角色
|
|
100
|
+
* @en User roles
|
|
101
|
+
*/
|
|
102
|
+
readonly roles: ReadonlyArray<string>;
|
|
103
|
+
/**
|
|
104
|
+
* @zh 认证时间
|
|
105
|
+
* @en Authentication timestamp
|
|
106
|
+
*/
|
|
107
|
+
readonly authenticatedAt: number | null;
|
|
108
|
+
/**
|
|
109
|
+
* @zh 令牌过期时间
|
|
110
|
+
* @en Token expiration time
|
|
111
|
+
*/
|
|
112
|
+
readonly expiresAt: number | null;
|
|
113
|
+
/**
|
|
114
|
+
* @zh 检查是否有指定角色
|
|
115
|
+
* @en Check if has specified role
|
|
116
|
+
*/
|
|
117
|
+
hasRole(role: string): boolean;
|
|
118
|
+
/**
|
|
119
|
+
* @zh 检查是否有任一指定角色
|
|
120
|
+
* @en Check if has any of specified roles
|
|
121
|
+
*/
|
|
122
|
+
hasAnyRole(roles: string[]): boolean;
|
|
123
|
+
/**
|
|
124
|
+
* @zh 检查是否有所有指定角色
|
|
125
|
+
* @en Check if has all specified roles
|
|
126
|
+
*/
|
|
127
|
+
hasAllRoles(roles: string[]): boolean;
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* @zh 认证连接数据
|
|
131
|
+
* @en Authentication connection data
|
|
132
|
+
*/
|
|
133
|
+
interface AuthConnectionData<TUser = unknown> {
|
|
134
|
+
/**
|
|
135
|
+
* @zh 认证上下文
|
|
136
|
+
* @en Authentication context
|
|
137
|
+
*/
|
|
138
|
+
auth: IAuthContext<TUser>;
|
|
139
|
+
}
|
|
140
|
+
/**
|
|
141
|
+
* @zh 带认证的连接
|
|
142
|
+
* @en Connection with authentication
|
|
143
|
+
*/
|
|
144
|
+
interface AuthConnection<TUser = unknown, TData extends AuthConnectionData<TUser> = AuthConnectionData<TUser>> extends ServerConnection<TData> {
|
|
145
|
+
/**
|
|
146
|
+
* @zh 认证上下文(快捷访问)
|
|
147
|
+
* @en Authentication context (shortcut)
|
|
148
|
+
*/
|
|
149
|
+
readonly auth: IAuthContext<TUser>;
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* @zh 带认证的 API 上下文
|
|
153
|
+
* @en API context with authentication
|
|
154
|
+
*/
|
|
155
|
+
interface AuthApiContext<TUser = unknown, TData extends AuthConnectionData<TUser> = AuthConnectionData<TUser>> extends ApiContext<TData> {
|
|
156
|
+
/**
|
|
157
|
+
* @zh 当前连接(带认证)
|
|
158
|
+
* @en Current connection (with auth)
|
|
159
|
+
*/
|
|
160
|
+
conn: AuthConnection<TUser, TData>;
|
|
161
|
+
}
|
|
162
|
+
/**
|
|
163
|
+
* @zh 带认证的消息上下文
|
|
164
|
+
* @en Message context with authentication
|
|
165
|
+
*/
|
|
166
|
+
interface AuthMsgContext<TUser = unknown, TData extends AuthConnectionData<TUser> = AuthConnectionData<TUser>> extends MsgContext<TData> {
|
|
167
|
+
/**
|
|
168
|
+
* @zh 当前连接(带认证)
|
|
169
|
+
* @en Current connection (with auth)
|
|
170
|
+
*/
|
|
171
|
+
conn: AuthConnection<TUser, TData>;
|
|
172
|
+
}
|
|
173
|
+
/**
|
|
174
|
+
* @zh 连接请求信息
|
|
175
|
+
* @en Connection request info
|
|
176
|
+
*/
|
|
177
|
+
interface ConnectionRequest {
|
|
178
|
+
/**
|
|
179
|
+
* @zh 请求 URL
|
|
180
|
+
* @en Request URL
|
|
181
|
+
*/
|
|
182
|
+
url: string;
|
|
183
|
+
/**
|
|
184
|
+
* @zh 请求头
|
|
185
|
+
* @en Request headers
|
|
186
|
+
*/
|
|
187
|
+
headers: Record<string, string | string[] | undefined>;
|
|
188
|
+
/**
|
|
189
|
+
* @zh 客户端 IP
|
|
190
|
+
* @en Client IP
|
|
191
|
+
*/
|
|
192
|
+
ip: string;
|
|
193
|
+
}
|
|
194
|
+
/**
|
|
195
|
+
* @zh 认证服务器配置
|
|
196
|
+
* @en Authentication server configuration
|
|
197
|
+
*/
|
|
198
|
+
interface AuthServerConfig<TUser = unknown> {
|
|
199
|
+
/**
|
|
200
|
+
* @zh 认证提供者
|
|
201
|
+
* @en Authentication provider
|
|
202
|
+
*/
|
|
203
|
+
provider: IAuthProvider<TUser>;
|
|
204
|
+
/**
|
|
205
|
+
* @zh 从连接请求提取凭证
|
|
206
|
+
* @en Extract credentials from connection request
|
|
207
|
+
*/
|
|
208
|
+
extractCredentials?: (req: ConnectionRequest) => unknown | Promise<unknown>;
|
|
209
|
+
/**
|
|
210
|
+
* @zh 连接时自动认证
|
|
211
|
+
* @en Auto authenticate on connection
|
|
212
|
+
* @defaultValue true
|
|
213
|
+
*/
|
|
214
|
+
autoAuthOnConnect?: boolean;
|
|
215
|
+
/**
|
|
216
|
+
* @zh 未认证连接的宽限期(毫秒)
|
|
217
|
+
* @en Grace period for unauthenticated connections (ms)
|
|
218
|
+
* @defaultValue 30000
|
|
219
|
+
*/
|
|
220
|
+
authGracePeriod?: number;
|
|
221
|
+
/**
|
|
222
|
+
* @zh 认证失败是否断开连接
|
|
223
|
+
* @en Disconnect on auth failure
|
|
224
|
+
* @defaultValue false
|
|
225
|
+
*/
|
|
226
|
+
disconnectOnAuthFailure?: boolean;
|
|
227
|
+
/**
|
|
228
|
+
* @zh 认证成功回调
|
|
229
|
+
* @en Authentication success callback
|
|
230
|
+
*/
|
|
231
|
+
onAuthSuccess?: (conn: ServerConnection, user: TUser) => void | Promise<void>;
|
|
232
|
+
/**
|
|
233
|
+
* @zh 认证失败回调
|
|
234
|
+
* @en Authentication failure callback
|
|
235
|
+
*/
|
|
236
|
+
onAuthFailure?: (conn: ServerConnection, error: AuthResult<TUser>) => void | Promise<void>;
|
|
237
|
+
}
|
|
238
|
+
/**
|
|
239
|
+
* @zh 带认证的游戏服务器
|
|
240
|
+
* @en Game server with authentication
|
|
241
|
+
*/
|
|
242
|
+
interface AuthGameServer<TUser = unknown> extends GameServer {
|
|
243
|
+
/**
|
|
244
|
+
* @zh 认证提供者
|
|
245
|
+
* @en Authentication provider
|
|
246
|
+
*/
|
|
247
|
+
readonly authProvider: IAuthProvider<TUser>;
|
|
248
|
+
/**
|
|
249
|
+
* @zh 手动认证连接
|
|
250
|
+
* @en Manually authenticate connection
|
|
251
|
+
*/
|
|
252
|
+
authenticate(conn: ServerConnection, credentials: unknown): Promise<AuthResult<TUser>>;
|
|
253
|
+
/**
|
|
254
|
+
* @zh 获取连接的认证上下文
|
|
255
|
+
* @en Get auth context for connection
|
|
256
|
+
*/
|
|
257
|
+
getAuthContext(conn: ServerConnection): IAuthContext<TUser> | null;
|
|
258
|
+
}
|
|
259
|
+
/**
|
|
260
|
+
* @zh 带认证的房间配置
|
|
261
|
+
* @en Auth room configuration
|
|
262
|
+
*/
|
|
263
|
+
interface AuthRoomConfig {
|
|
264
|
+
/**
|
|
265
|
+
* @zh 是否要求认证才能加入
|
|
266
|
+
* @en Require authentication to join
|
|
267
|
+
* @defaultValue true
|
|
268
|
+
*/
|
|
269
|
+
requireAuth?: boolean;
|
|
270
|
+
/**
|
|
271
|
+
* @zh 允许的角色(空数组表示任意角色)
|
|
272
|
+
* @en Allowed roles (empty array means any role)
|
|
273
|
+
*/
|
|
274
|
+
allowedRoles?: string[];
|
|
275
|
+
/**
|
|
276
|
+
* @zh 角色检查模式
|
|
277
|
+
* @en Role check mode
|
|
278
|
+
* @defaultValue 'any'
|
|
279
|
+
*/
|
|
280
|
+
roleCheckMode?: 'any' | 'all';
|
|
281
|
+
}
|
|
282
|
+
/**
|
|
283
|
+
* @zh requireAuth 装饰器选项
|
|
284
|
+
* @en requireAuth decorator options
|
|
285
|
+
*/
|
|
286
|
+
interface RequireAuthOptions {
|
|
287
|
+
/**
|
|
288
|
+
* @zh 认证失败时的错误消息
|
|
289
|
+
* @en Error message on auth failure
|
|
290
|
+
*/
|
|
291
|
+
errorMessage?: string;
|
|
292
|
+
/**
|
|
293
|
+
* @zh 是否允许访客
|
|
294
|
+
* @en Allow guest access
|
|
295
|
+
*/
|
|
296
|
+
allowGuest?: boolean;
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* @zh requireRole 装饰器选项
|
|
300
|
+
* @en requireRole decorator options
|
|
301
|
+
*/
|
|
302
|
+
interface RequireRoleOptions extends RequireAuthOptions {
|
|
303
|
+
/**
|
|
304
|
+
* @zh 角色检查模式
|
|
305
|
+
* @en Role check mode
|
|
306
|
+
* @defaultValue 'any'
|
|
307
|
+
*/
|
|
308
|
+
mode?: 'any' | 'all';
|
|
309
|
+
}
|
|
310
|
+
|
|
311
|
+
export type { AuthResult as A, ConnectionRequest as C, IAuthContext as I, RequireAuthOptions as R, IAuthProvider as a, AuthServerConfig as b, AuthGameServer as c, AuthRoomConfig as d, RequireRoleOptions as e, AuthErrorCode as f, AuthConnectionData as g, AuthConnection as h, AuthApiContext as i, AuthMsgContext as j };
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@esengine/server",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"description": "Game server framework for ESEngine with file-based routing",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -10,6 +10,22 @@
|
|
|
10
10
|
".": {
|
|
11
11
|
"import": "./dist/index.js",
|
|
12
12
|
"types": "./dist/index.d.ts"
|
|
13
|
+
},
|
|
14
|
+
"./auth": {
|
|
15
|
+
"import": "./dist/auth/index.js",
|
|
16
|
+
"types": "./dist/auth/index.d.ts"
|
|
17
|
+
},
|
|
18
|
+
"./auth/testing": {
|
|
19
|
+
"import": "./dist/auth/testing/index.js",
|
|
20
|
+
"types": "./dist/auth/testing/index.d.ts"
|
|
21
|
+
},
|
|
22
|
+
"./ratelimit": {
|
|
23
|
+
"import": "./dist/ratelimit/index.js",
|
|
24
|
+
"types": "./dist/ratelimit/index.d.ts"
|
|
25
|
+
},
|
|
26
|
+
"./testing": {
|
|
27
|
+
"import": "./dist/testing/index.js",
|
|
28
|
+
"types": "./dist/testing/index.d.ts"
|
|
13
29
|
}
|
|
14
30
|
},
|
|
15
31
|
"files": [
|
|
@@ -20,14 +36,23 @@
|
|
|
20
36
|
"@esengine/rpc": "1.1.1"
|
|
21
37
|
},
|
|
22
38
|
"peerDependencies": {
|
|
23
|
-
"ws": ">=8.0.0"
|
|
39
|
+
"ws": ">=8.0.0",
|
|
40
|
+
"jsonwebtoken": ">=9.0.0"
|
|
41
|
+
},
|
|
42
|
+
"peerDependenciesMeta": {
|
|
43
|
+
"jsonwebtoken": {
|
|
44
|
+
"optional": true
|
|
45
|
+
}
|
|
24
46
|
},
|
|
25
47
|
"devDependencies": {
|
|
48
|
+
"@types/jsonwebtoken": "^9.0.0",
|
|
26
49
|
"@types/node": "^20.0.0",
|
|
27
50
|
"@types/ws": "^8.5.13",
|
|
51
|
+
"jsonwebtoken": "^9.0.0",
|
|
28
52
|
"rimraf": "^5.0.0",
|
|
29
53
|
"tsup": "^8.0.0",
|
|
30
54
|
"typescript": "^5.7.0",
|
|
55
|
+
"vitest": "^2.0.0",
|
|
31
56
|
"ws": "^8.18.0"
|
|
32
57
|
},
|
|
33
58
|
"publishConfig": {
|
|
@@ -45,6 +70,8 @@
|
|
|
45
70
|
"build:watch": "tsup --watch",
|
|
46
71
|
"dev": "tsup --watch",
|
|
47
72
|
"type-check": "tsc --noEmit",
|
|
48
|
-
"clean": "rimraf dist"
|
|
73
|
+
"clean": "rimraf dist",
|
|
74
|
+
"test": "vitest run",
|
|
75
|
+
"test:watch": "vitest"
|
|
49
76
|
}
|
|
50
77
|
}
|