@roomkit/core 1.0.0

package/README.md

@@ -0,0 +1,75 @@
+# @roomkit/core
+
+Core types, protocols, and utilities for the RoomKit framework.
+
+## Installation
+
+```bash
+npm install @roomkit/core
+```
+
+## Features
+
+- 🔌 **Protocol Definitions** - Message IDs, types, and payloads
+- 🔑 **Redis Keys** - Standardized Redis key patterns
+- 📝 **TypeScript Types** - Complete type definitions for all protocols
+- 🛠️ **Utilities** - Common utilities for Gateway and Worker
+
+## Exports
+
+### Protocol
+
+```typescript
+import { MessageId, MessageType } from '@roomkit/core';
+
+// Message IDs
+MessageId.AUTH
+MessageId.CREATE_ROOM
+MessageId.JOIN_ROOM
+// ... etc
+
+// Message Types
+MessageType.REQUEST
+MessageType.RESPONSE
+MessageType.NOTIFICATION
+```
+
+### Redis Keys
+
+```typescript
+import { RedisKeys, RedisChannels } from '@roomkit/core/redis';
+
+// Keys
+RedisKeys.session(sessionId)
+RedisKeys.room(roomId)
+RedisKeys.gateway(gatewayId)
+RedisKeys.worker(workerId)
+
+// Channels
+RedisChannels.rpcGateway(gatewayId)
+RedisChannels.rpcWorker(workerId)
+RedisChannels.broadcast()
+```
+
+### Types
+
+```typescript
+import type { 
+  WsMessage,
+  AuthPayload,
+  CreateRoomPayload,
+  JoinRoomPayload 
+} from '@roomkit/core';
+```
+
+## Usage
+
+This package is primarily used internally by `@roomkit/gateway` and `@roomkit/worker`, but can also be used by:
+
+- Custom room implementations
+- Testing utilities
+- Protocol-compatible clients
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @roomkit/core - Gateway-Worker Framework Core
+ *
+ * Core types, protocols and utilities for building scalable game servers.
+ */
+export * from './protocol/index.js';
+export * from './redis/index.js';
+export * from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @roomkit/core - Gateway-Worker Framework Core
+ *
+ * Core types, protocols and utilities for building scalable game servers.
+ */
+// Protocol definitions
+export * from './protocol/index.js';
+// Redis utilities
+export * from './redis/index.js';
+// Core types
+export * from './types/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uBAAuB;AACvB,cAAc,qBAAqB,CAAC;AAEpC,kBAAkB;AAClB,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,cAAc,kBAAkB,CAAC"}

package/dist/protocol/index.d.ts

@@ -0,0 +1,5 @@
+export * from './message-id.js';
+export * from './message-type.js';
+export * from './messages.js';
+export * from './payloads.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/protocol/index.js

@@ -0,0 +1,5 @@
+export * from './message-id.js';
+export * from './message-type.js';
+export * from './messages.js';
+export * from './payloads.js';
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/protocol/message-id.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 消息ID定义
+ *
+ * 保留范围:
+ * - 1000-1999: 系统消息 (框架保留)
+ * - 2000-2999: 房间管理 (框架保留)
+ * - 3000-3999: 游戏逻辑 (用户自定义)
+ * - 4000-4999: 状态同步 (框架保留)
+ * - 5000-5999: 错误消息 (框架保留)
+ */
+export declare enum MessageId {
+    AUTH_REQ = 1001,
+    AUTH_RES = 1002,
+    HEARTBEAT = 1003,
+    HEARTBEAT_ACK = 1004,
+    KICK_NOTIFY = 1005,
+    CREATE_ROOM_REQ = 2001,
+    CREATE_ROOM_RES = 2002,
+    JOIN_ROOM_REQ = 2003,
+    JOIN_ROOM_RES = 2004,
+    LEAVE_ROOM_REQ = 2005,
+    LEAVE_ROOM_RES = 2006,
+    ROOM_LIST_REQ = 2007,
+    ROOM_LIST_RES = 2008,
+    JOIN_OR_CREATE_REQ = 2009,
+    JOIN_OR_CREATE_RES = 2010,
+    /** 用户自定义消息起始ID */
+    USER_MESSAGE_START = 3000,
+    PLAYER_ACTION = 3001,
+    ACTION_RESULT = 3002,
+    CHAT_MESSAGE = 3003,
+    CHAT_BROADCAST = 3004,
+    STATE_FULL = 4001,
+    STATE_DELTA = 4002,
+    PLAYER_JOINED = 4003,
+    PLAYER_LEFT = 4004,
+    ROOM_CLOSING = 4005,
+    SYSTEM_MESSAGE = 4099,// 系统消息（如提示、警告等）
+    STATE_CHUNK = 4010,// 状态分片
+    STATE_CHUNK_ACK = 4011,// 分片确认
+    ROOM_MIGRATING = 4500,
+    ROOM_MIGRATION_COMPLETE = 4501,
+    ERROR = 5000
+}
+/**
+ * 判断消息类别
+ */
+export declare function isSystemMessage(msgId: number): boolean;
+export declare function isRoomManagementMessage(msgId: number): boolean;
+export declare function isGameLogicMessage(msgId: number): boolean;
+export declare function isStateSyncMessage(msgId: number): boolean;
+export declare function isErrorMessage(msgId: number): boolean;
+//# sourceMappingURL=message-id.d.ts.map

package/dist/protocol/message-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-id.d.ts","sourceRoot":"","sources":["../../src/protocol/message-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,oBAAY,SAAS;IAEnB,QAAQ,OAAO;IACf,QAAQ,OAAO;IACf,SAAS,OAAO;IAChB,aAAa,OAAO;IACpB,WAAW,OAAO;IAGlB,eAAe,OAAO;IACtB,eAAe,OAAO;IACtB,aAAa,OAAO;IACpB,aAAa,OAAO;IACpB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,aAAa,OAAO;IACpB,aAAa,OAAO;IACpB,kBAAkB,OAAO;IACzB,kBAAkB,OAAO;IAGzB,kBAAkB;IAClB,kBAAkB,OAAO;IAGzB,aAAa,OAAO;IACpB,aAAa,OAAO;IACpB,YAAY,OAAO;IACnB,cAAc,OAAO;IAGrB,UAAU,OAAO;IACjB,WAAW,OAAO;IAClB,aAAa,OAAO;IACpB,WAAW,OAAO;IAClB,YAAY,OAAO;IACnB,cAAc,OAAO,CAAE,gBAAgB;IAGvC,WAAW,OAAO,CAAO,OAAO;IAChC,eAAe,OAAO,CAAG,OAAO;IAGhC,cAAc,OAAO;IACrB,uBAAuB,OAAO;IAG9B,KAAK,OAAO;CACb;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/protocol/message-id.js

@@ -0,0 +1,72 @@
+/**
+ * 消息ID定义
+ *
+ * 保留范围:
+ * - 1000-1999: 系统消息 (框架保留)
+ * - 2000-2999: 房间管理 (框架保留)
+ * - 3000-3999: 游戏逻辑 (用户自定义)
+ * - 4000-4999: 状态同步 (框架保留)
+ * - 5000-5999: 错误消息 (框架保留)
+ */
+export var MessageId;
+(function (MessageId) {
+    // ============ 系统消息 1000-1999 ============
+    MessageId[MessageId["AUTH_REQ"] = 1001] = "AUTH_REQ";
+    MessageId[MessageId["AUTH_RES"] = 1002] = "AUTH_RES";
+    MessageId[MessageId["HEARTBEAT"] = 1003] = "HEARTBEAT";
+    MessageId[MessageId["HEARTBEAT_ACK"] = 1004] = "HEARTBEAT_ACK";
+    MessageId[MessageId["KICK_NOTIFY"] = 1005] = "KICK_NOTIFY";
+    // ============ 房间管理 2000-2999 ============
+    MessageId[MessageId["CREATE_ROOM_REQ"] = 2001] = "CREATE_ROOM_REQ";
+    MessageId[MessageId["CREATE_ROOM_RES"] = 2002] = "CREATE_ROOM_RES";
+    MessageId[MessageId["JOIN_ROOM_REQ"] = 2003] = "JOIN_ROOM_REQ";
+    MessageId[MessageId["JOIN_ROOM_RES"] = 2004] = "JOIN_ROOM_RES";
+    MessageId[MessageId["LEAVE_ROOM_REQ"] = 2005] = "LEAVE_ROOM_REQ";
+    MessageId[MessageId["LEAVE_ROOM_RES"] = 2006] = "LEAVE_ROOM_RES";
+    MessageId[MessageId["ROOM_LIST_REQ"] = 2007] = "ROOM_LIST_REQ";
+    MessageId[MessageId["ROOM_LIST_RES"] = 2008] = "ROOM_LIST_RES";
+    MessageId[MessageId["JOIN_OR_CREATE_REQ"] = 2009] = "JOIN_OR_CREATE_REQ";
+    MessageId[MessageId["JOIN_OR_CREATE_RES"] = 2010] = "JOIN_OR_CREATE_RES";
+    // ============ 游戏逻辑 3000-3999 (用户自定义起始点) ============
+    /** 用户自定义消息起始ID */
+    MessageId[MessageId["USER_MESSAGE_START"] = 3000] = "USER_MESSAGE_START";
+    // 通用游戏消息
+    MessageId[MessageId["PLAYER_ACTION"] = 3001] = "PLAYER_ACTION";
+    MessageId[MessageId["ACTION_RESULT"] = 3002] = "ACTION_RESULT";
+    MessageId[MessageId["CHAT_MESSAGE"] = 3003] = "CHAT_MESSAGE";
+    MessageId[MessageId["CHAT_BROADCAST"] = 3004] = "CHAT_BROADCAST";
+    // ============ 状态同步 4000-4999 ============
+    MessageId[MessageId["STATE_FULL"] = 4001] = "STATE_FULL";
+    MessageId[MessageId["STATE_DELTA"] = 4002] = "STATE_DELTA";
+    MessageId[MessageId["PLAYER_JOINED"] = 4003] = "PLAYER_JOINED";
+    MessageId[MessageId["PLAYER_LEFT"] = 4004] = "PLAYER_LEFT";
+    MessageId[MessageId["ROOM_CLOSING"] = 4005] = "ROOM_CLOSING";
+    MessageId[MessageId["SYSTEM_MESSAGE"] = 4099] = "SYSTEM_MESSAGE";
+    // 分片状态传输
+    MessageId[MessageId["STATE_CHUNK"] = 4010] = "STATE_CHUNK";
+    MessageId[MessageId["STATE_CHUNK_ACK"] = 4011] = "STATE_CHUNK_ACK";
+    // ============ 房间迁移 4500-4599 ============
+    MessageId[MessageId["ROOM_MIGRATING"] = 4500] = "ROOM_MIGRATING";
+    MessageId[MessageId["ROOM_MIGRATION_COMPLETE"] = 4501] = "ROOM_MIGRATION_COMPLETE";
+    // ============ 错误 5000-5999 ============
+    MessageId[MessageId["ERROR"] = 5000] = "ERROR";
+})(MessageId || (MessageId = {}));
+/**
+ * 判断消息类别
+ */
+export function isSystemMessage(msgId) {
+    return msgId >= 1000 && msgId < 2000;
+}
+export function isRoomManagementMessage(msgId) {
+    return msgId >= 2000 && msgId < 3000;
+}
+export function isGameLogicMessage(msgId) {
+    return msgId >= 3000 && msgId < 4000;
+}
+export function isStateSyncMessage(msgId) {
+    return msgId >= 4000 && msgId < 5000;
+}
+export function isErrorMessage(msgId) {
+    return msgId >= 5000 && msgId < 6000;
+}
+//# sourceMappingURL=message-id.js.map

package/dist/protocol/message-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-id.js","sourceRoot":"","sources":["../../src/protocol/message-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,SAgDX;AAhDD,WAAY,SAAS;IACnB,2CAA2C;IAC3C,oDAAe,CAAA;IACf,oDAAe,CAAA;IACf,sDAAgB,CAAA;IAChB,8DAAoB,CAAA;IACpB,0DAAkB,CAAA;IAElB,2CAA2C;IAC3C,kEAAsB,CAAA;IACtB,kEAAsB,CAAA;IACtB,8DAAoB,CAAA;IACpB,8DAAoB,CAAA;IACpB,gEAAqB,CAAA;IACrB,gEAAqB,CAAA;IACrB,8DAAoB,CAAA;IACpB,8DAAoB,CAAA;IACpB,wEAAyB,CAAA;IACzB,wEAAyB,CAAA;IAEzB,sDAAsD;IACtD,kBAAkB;IAClB,wEAAyB,CAAA;IAEzB,SAAS;IACT,8DAAoB,CAAA;IACpB,8DAAoB,CAAA;IACpB,4DAAmB,CAAA;IACnB,gEAAqB,CAAA;IAErB,2CAA2C;IAC3C,wDAAiB,CAAA;IACjB,0DAAkB,CAAA;IAClB,8DAAoB,CAAA;IACpB,0DAAkB,CAAA;IAClB,4DAAmB,CAAA;IACnB,gEAAqB,CAAA;IAErB,SAAS;IACT,0DAAkB,CAAA;IAClB,kEAAsB,CAAA;IAEtB,2CAA2C;IAC3C,gEAAqB,CAAA;IACrB,kFAA8B,CAAA;IAE9B,yCAAyC;IACzC,8CAAY,CAAA;AACd,CAAC,EAhDW,SAAS,KAAT,SAAS,QAgDpB;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC;AACvC,CAAC"}

package/dist/protocol/message-type.d.ts

@@ -0,0 +1,173 @@
+/**
+ * 消息类型定义
+ *
+ * 框架内置消息使用 'gw:' 前缀
+ * 用户自定义消息可以使用任意字符串
+ */
+/** 连接成功通知（服务端→客户端） */
+export declare const MSG_CONNECT = "gw:connect";
+/** 认证请求（客户端→服务端） */
+export declare const MSG_AUTH = "gw:auth";
+/** 认证成功（服务端→客户端） */
+export declare const MSG_AUTH_OK = "gw:auth:ok";
+/** 认证失败（服务端→客户端） */
+export declare const MSG_AUTH_FAIL = "gw:auth:fail";
+/** 心跳请求 */
+export declare const MSG_HEARTBEAT = "gw:heartbeat";
+/** 心跳响应 */
+export declare const MSG_HEARTBEAT_ACK = "gw:heartbeat:ack";
+/** 踢出连接（服务端→客户端） */
+export declare const MSG_KICK = "gw:kick";
+/** 加入房间请求（客户端→服务端） */
+export declare const MSG_ROOM_JOIN = "gw:room:join";
+/** 加入或创建房间请求（客户端→服务端） */
+export declare const MSG_ROOM_JOIN_OR_CREATE = "gw:room:join-or-create";
+/** 加入成功（服务端→客户端） */
+export declare const MSG_ROOM_JOIN_OK = "gw:room:join:ok";
+/** 加入失败（服务端→客户端） */
+export declare const MSG_ROOM_JOIN_FAIL = "gw:room:join:fail";
+/** 离开房间请求（客户端→服务端） */
+export declare const MSG_ROOM_LEAVE = "gw:room:leave";
+/** 离开成功（服务端→客户端） */
+export declare const MSG_ROOM_LEAVE_OK = "gw:room:leave:ok";
+/** 创建房间请求（客户端→服务端） */
+export declare const MSG_ROOM_CREATE = "gw:room:create";
+/** 创建成功（服务端→客户端） */
+export declare const MSG_ROOM_CREATE_OK = "gw:room:create:ok";
+/** 创建失败（服务端→客户端） */
+export declare const MSG_ROOM_CREATE_FAIL = "gw:room:create:fail";
+/** 获取房间列表请求（客户端→服务端） */
+export declare const MSG_ROOM_LIST = "gw:room:list";
+/** 房间列表响应（服务端→客户端） */
+export declare const MSG_ROOM_LIST_OK = "gw:room:list:ok";
+/** 重连请求（客户端→服务端） */
+export declare const MSG_RECONNECT = "gw:reconnect";
+/** 重连成功（服务端→客户端） */
+export declare const MSG_RECONNECT_OK = "gw:reconnect:ok";
+/** 重连失败（服务端→客户端） */
+export declare const MSG_RECONNECT_FAIL = "gw:reconnect:fail";
+/** 完整状态（服务端→客户端） */
+export declare const MSG_STATE_FULL = "gw:state:full";
+/** 增量更新（服务端→客户端） */
+export declare const MSG_STATE_DELTA = "gw:state:delta";
+/** 玩家加入通知（服务端→客户端） */
+export declare const MSG_PLAYER_JOIN = "gw:player:join";
+/** 玩家离开通知（服务端→客户端） */
+export declare const MSG_PLAYER_LEAVE = "gw:player:leave";
+/** 房间正在关闭通知（服务端→客户端） */
+export declare const MSG_ROOM_CLOSING = "gw:room:closing";
+/** 系统消息/公告（服务端→客户端） */
+export declare const MSG_SYSTEM = "gw:system";
+/** 错误消息（服务端→客户端） */
+export declare const MSG_ERROR = "gw:error";
+/** 房间迁移中通知（服务端→客户端） */
+export declare const MSG_ROOM_MIGRATING = "gw:room:migrating";
+/** 房间迁移完成通知（服务端→客户端） */
+export declare const MSG_ROOM_MIGRATION_COMPLETE = "gw:room:migration:complete";
+/**
+ * 所有内置消息类型的集合（用于类型检查）
+ *
+ * 提供两种访问方式：
+ * 1. MessageType.AUTH - 短名称
+ * 2. MessageType.MSG_AUTH - 完整名称（与导出常量一致）
+ */
+export declare const MessageType: {
+    readonly CONNECT: "gw:connect";
+    readonly MSG_CONNECT: "gw:connect";
+    readonly AUTH: "gw:auth";
+    readonly MSG_AUTH: "gw:auth";
+    readonly AUTH_OK: "gw:auth:ok";
+    readonly MSG_AUTH_OK: "gw:auth:ok";
+    readonly AUTH_FAIL: "gw:auth:fail";
+    readonly MSG_AUTH_FAIL: "gw:auth:fail";
+    readonly HEARTBEAT: "gw:heartbeat";
+    readonly MSG_HEARTBEAT: "gw:heartbeat";
+    readonly HEARTBEAT_ACK: "gw:heartbeat:ack";
+    readonly MSG_HEARTBEAT_ACK: "gw:heartbeat:ack";
+    readonly KICK: "gw:kick";
+    readonly MSG_KICK: "gw:kick";
+    readonly KICK_NOTIFY: "gw:kick";
+    readonly MSG_KICK_NOTIFY: "gw:kick";
+    readonly ROOM_JOIN: "gw:room:join";
+    readonly MSG_ROOM_JOIN: "gw:room:join";
+    readonly ROOM_JOIN_OK: "gw:room:join:ok";
+    readonly MSG_ROOM_JOIN_OK: "gw:room:join:ok";
+    readonly ROOM_JOIN_FAIL: "gw:room:join:fail";
+    readonly MSG_ROOM_JOIN_FAIL: "gw:room:join:fail";
+    readonly ROOM_LEAVE: "gw:room:leave";
+    readonly MSG_ROOM_LEAVE: "gw:room:leave";
+    readonly ROOM_LEAVE_OK: "gw:room:leave:ok";
+    readonly MSG_ROOM_LEAVE_OK: "gw:room:leave:ok";
+    readonly ROOM_CREATE: "gw:room:create";
+    readonly MSG_ROOM_CREATE: "gw:room:create";
+    readonly ROOM_CREATE_OK: "gw:room:create:ok";
+    readonly MSG_ROOM_CREATE_OK: "gw:room:create:ok";
+    readonly ROOM_CREATE_FAIL: "gw:room:create:fail";
+    readonly MSG_ROOM_CREATE_FAIL: "gw:room:create:fail";
+    readonly ROOM_JOIN_OR_CREATE: "gw:room:join-or-create";
+    readonly MSG_ROOM_JOIN_OR_CREATE: "gw:room:join-or-create";
+    readonly ROOM_LIST: "gw:room:list";
+    readonly MSG_ROOM_LIST: "gw:room:list";
+    readonly ROOM_LIST_OK: "gw:room:list:ok";
+    readonly MSG_ROOM_LIST_OK: "gw:room:list:ok";
+    readonly ROOM_CLOSING: "gw:room:closing";
+    readonly MSG_ROOM_CLOSING: "gw:room:closing";
+    readonly RECONNECT: "gw:reconnect";
+    readonly MSG_RECONNECT: "gw:reconnect";
+    readonly RECONNECT_OK: "gw:reconnect:ok";
+    readonly MSG_RECONNECT_OK: "gw:reconnect:ok";
+    readonly RECONNECT_FAIL: "gw:reconnect:fail";
+    readonly MSG_RECONNECT_FAIL: "gw:reconnect:fail";
+    readonly STATE_FULL: "gw:state:full";
+    readonly MSG_STATE_FULL: "gw:state:full";
+    readonly STATE_DELTA: "gw:state:delta";
+    readonly MSG_STATE_DELTA: "gw:state:delta";
+    readonly PLAYER_JOIN: "gw:player:join";
+    readonly MSG_PLAYER_JOIN: "gw:player:join";
+    readonly PLAYER_JOINED: "gw:player:join";
+    readonly MSG_PLAYER_JOINED: "gw:player:join";
+    readonly PLAYER_LEAVE: "gw:player:leave";
+    readonly MSG_PLAYER_LEAVE: "gw:player:leave";
+    readonly PLAYER_LEFT: "gw:player:leave";
+    readonly MSG_PLAYER_LEFT: "gw:player:leave";
+    readonly SYSTEM: "gw:system";
+    readonly MSG_SYSTEM: "gw:system";
+    readonly ERROR: "gw:error";
+    readonly MSG_ERROR: "gw:error";
+    readonly ROOM_MIGRATING: "gw:room:migrating";
+    readonly MSG_ROOM_MIGRATING: "gw:room:migrating";
+    readonly ROOM_MIGRATION_COMPLETE: "gw:room:migration:complete";
+    readonly MSG_ROOM_MIGRATION_COMPLETE: "gw:room:migration:complete";
+};
+/**
+ * 消息类型的类型定义
+ */
+export type MessageTypeValue = typeof MessageType[keyof typeof MessageType];
+/**
+ * 判断是否为框架内置消息（字符串类型）
+ * 内置消息以 'gw:' 开头
+ */
+export declare function isBuiltinMessageType(type: string): boolean;
+/**
+ * 判断是否为房间管理消息（字符串类型）
+ */
+export declare function isRoomManagementMessageType(type: string): boolean;
+/**
+ * 判断是否为状态同步消息（字符串类型）
+ */
+export declare function isStateSyncMessageType(type: string): boolean;
+/**
+ * 判断是否为连接层消息（字符串类型）
+ */
+export declare function isConnectionMessageType(type: string): boolean;
+/**
+ * 旧消息ID到新消息类型的映射
+ * @deprecated 用于过渡期兼容
+ */
+export declare const MessageIdToType: Record<number, string>;
+/**
+ * 新消息类型到旧消息ID的映射
+ * @deprecated 用于过渡期兼容
+ */
+export declare const MessageTypeToId: Record<string, number>;
+//# sourceMappingURL=message-type.d.ts.map

package/dist/protocol/message-type.d.ts.map

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