@roomkit/core 1.0.0

package/dist/redis/keys.js

@@ -0,0 +1,60 @@
+/**
+ * Redis Key 模式定义
+ * 所有Key使用 gw: 前缀
+ */
+export const RedisKeys = {
+    // 用户会话（用于断线重连）
+    userSession: (userId) => `gw:user:${userId}:session`,
+    // 会话令牌到用户ID的映射（用于快速查找）
+    sessionToken: (token) => `gw:session:token:${token}`,
+    // 用户会话（旧版，保留兼容性）
+    session: (userId) => `gw:session:${userId}`,
+    // 用户当前房间
+    userRoom: (userId) => `gw:user:${userId}:room`,
+    // Worker注册信息
+    worker: (workerId) => `gw:worker:${workerId}`,
+    // 所有Worker列表
+    workersAll: () => `gw:workers:all`,
+    // 按游戏类型的Worker列表
+    workersByType: (gameType) => `gw:workers:${gameType}`,
+    // Gateway注册信息
+    gateway: (gatewayId) => `gw:gateway:${gatewayId}`,
+    // 所有Gateway列表
+    gatewaysAll: () => `gw:gateways:all`,
+    // 房间到Worker的映射
+    roomWorker: (roomId) => `gw:room:${roomId}:worker`,
+    // 房间成员列表
+    roomMembers: (roomId) => `gw:room:${roomId}:members`,
+    // 房间状态
+    roomState: (roomId) => `gw:room:${roomId}:state`,
+    // 所有房间列表
+    roomsAll: () => `gw:rooms:all`,
+    // 按游戏类型的房间列表
+    roomsByType: (gameType) => `gw:rooms:${gameType}`,
+    // joinOrCreate 锁（记录正在创建房间的请求数）
+    roomCreatingLock: (roomId) => `gw:room:${roomId}:creating`,
+};
+/**
+ * Redis Channel 模式定义
+ */
+export const RedisChannels = {
+    // Gateway -> Worker 请求通道
+    rpcWorker: (workerId) => `gw:rpc:worker:${workerId}`,
+    // Worker -> Gateway 响应通道
+    rpcGateway: (gatewayId) => `gw:rpc:gateway:${gatewayId}`,
+    // 广播通道（所有Gateway订阅）
+    broadcast: () => `gw:broadcast`,
+    // Admin -> Worker 管理通道
+    adminWorker: (workerId) => `gw:admin:worker:${workerId}`,
+    // 房间创建完成通知通道（用于 joinOrCreate 等待机制）
+    roomCreated: (roomId) => `gw:room:${roomId}:created`,
+    // 房间迁移请求通道
+    migrationRequest: (targetWorkerId) => `gw:migration:request:${targetWorkerId}`,
+    // 房间迁移确认通道
+    migrationConfirm: (roomId) => `gw:migration:confirm:${roomId}`,
+    // 房间接管请求通道（广播）
+    takeoverRequest: () => `gw:takeover:request`,
+    // 路由更新通道（广播到所有 Gateway）
+    routeUpdate: () => `gw:route:update`,
+};
+//# sourceMappingURL=keys.js.map

package/dist/redis/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/redis/keys.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,eAAe;IACf,WAAW,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,MAAM,UAAU;IAE5D,uBAAuB;IACvB,YAAY,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,oBAAoB,KAAK,EAAE;IAE5D,iBAAiB;IACjB,OAAO,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,cAAc,MAAM,EAAE;IAEnD,SAAS;IACT,QAAQ,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,MAAM,OAAO;IAEtD,aAAa;IACb,MAAM,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,aAAa,QAAQ,EAAE;IAErD,aAAa;IACb,UAAU,EAAE,GAAG,EAAE,CAAC,gBAAgB;IAElC,iBAAiB;IACjB,aAAa,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,cAAc,QAAQ,EAAE;IAE7D,cAAc;IACd,OAAO,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,cAAc,SAAS,EAAE;IAEzD,cAAc;IACd,WAAW,EAAE,GAAG,EAAE,CAAC,iBAAiB;IAEpC,eAAe;IACf,UAAU,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,MAAM,SAAS;IAE1D,SAAS;IACT,WAAW,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,MAAM,UAAU;IAE5D,OAAO;IACP,SAAS,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,MAAM,QAAQ;IAExD,SAAS;IACT,QAAQ,EAAE,GAAG,EAAE,CAAC,cAAc;IAE9B,aAAa;IACb,WAAW,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,YAAY,QAAQ,EAAE;IAEzD,+BAA+B;IAC/B,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,MAAM,WAAW;CAC1D,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,yBAAyB;IACzB,SAAS,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,iBAAiB,QAAQ,EAAE;IAE5D,yBAAyB;IACzB,UAAU,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,kBAAkB,SAAS,EAAE;IAEhE,oBAAoB;IACpB,SAAS,EAAE,GAAG,EAAE,CAAC,cAAc;IAE/B,uBAAuB;IACvB,WAAW,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,mBAAmB,QAAQ,EAAE;IAEhE,mCAAmC;IACnC,WAAW,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,MAAM,UAAU;IAE5D,WAAW;IACX,gBAAgB,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC,wBAAwB,cAAc,EAAE;IAEtF,WAAW;IACX,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,wBAAwB,MAAM,EAAE;IAEtE,eAAe;IACf,eAAe,EAAE,GAAG,EAAE,CAAC,qBAAqB;IAE5C,wBAAwB;IACxB,WAAW,EAAE,GAAG,EAAE,CAAC,iBAAiB;CAC5B,CAAC"}

package/dist/redis/lua-scripts.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Lua脚本：原子地读取旧session并写入新session
+ * 返回旧的gatewayId和connectionId（如果存在）
+ */
+export declare const LUA_SET_SESSION = "\nlocal old_gateway = redis.call(\"HGET\", KEYS[1], \"gatewayId\")\nlocal old_conn = redis.call(\"HGET\", KEYS[1], \"connectionId\")\nredis.call(\"HMSET\", KEYS[1], \n    \"gatewayId\", ARGV[1],\n    \"connectionId\", ARGV[2],\n    \"connectedAt\", ARGV[3])\nredis.call(\"EXPIRE\", KEYS[1], 7200)\nif old_gateway then\n    return {old_gateway, old_conn}\nend\nreturn nil\n";
+/**
+ * Lua脚本：原子地添加房间成员
+ * 如果用户已在房间，返回现有信息
+ */
+export declare const LUA_ADD_ROOM_MEMBER = "\nlocal existing = redis.call(\"HGET\", KEYS[1], ARGV[1])\nif existing then\n    return existing\nend\nredis.call(\"HSET\", KEYS[1], ARGV[1], ARGV[2])\nreturn nil\n";
+/**
+ * Lua脚本：原子地移除房间成员并检查是否为空
+ * 返回剩余成员数
+ */
+export declare const LUA_REMOVE_ROOM_MEMBER = "\nredis.call(\"HDEL\", KEYS[1], ARGV[1])\nreturn redis.call(\"HLEN\", KEYS[1])\n";
+//# sourceMappingURL=lua-scripts.d.ts.map

package/dist/redis/lua-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lua-scripts.d.ts","sourceRoot":"","sources":["../../src/redis/lua-scripts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,yXAY3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,yKAO/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,qFAGlC,CAAC"}

package/dist/redis/lua-scripts.js

@@ -0,0 +1,38 @@
+/**
+ * Lua脚本：原子地读取旧session并写入新session
+ * 返回旧的gatewayId和connectionId（如果存在）
+ */
+export const LUA_SET_SESSION = `
+local old_gateway = redis.call("HGET", KEYS[1], "gatewayId")
+local old_conn = redis.call("HGET", KEYS[1], "connectionId")
+redis.call("HMSET", KEYS[1], 
+    "gatewayId", ARGV[1],
+    "connectionId", ARGV[2],
+    "connectedAt", ARGV[3])
+redis.call("EXPIRE", KEYS[1], 7200)
+if old_gateway then
+    return {old_gateway, old_conn}
+end
+return nil
+`;
+/**
+ * Lua脚本：原子地添加房间成员
+ * 如果用户已在房间，返回现有信息
+ */
+export const LUA_ADD_ROOM_MEMBER = `
+local existing = redis.call("HGET", KEYS[1], ARGV[1])
+if existing then
+    return existing
+end
+redis.call("HSET", KEYS[1], ARGV[1], ARGV[2])
+return nil
+`;
+/**
+ * Lua脚本：原子地移除房间成员并检查是否为空
+ * 返回剩余成员数
+ */
+export const LUA_REMOVE_ROOM_MEMBER = `
+redis.call("HDEL", KEYS[1], ARGV[1])
+return redis.call("HLEN", KEYS[1])
+`;
+//# sourceMappingURL=lua-scripts.js.map

package/dist/redis/lua-scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lua-scripts.js","sourceRoot":"","sources":["../../src/redis/lua-scripts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;CAY9B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;CAOlC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;CAGrC,CAAC"}

package/dist/types/auth.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 认证上下文
+ *
+ * 提供给 Room.onAuth 方法的上下文信息
+ * 参考 Colyseus 设计
+ */
+export interface AuthContext {
+    /** 客户端传入的认证 token */
+    token?: string;
+    /** 客户端 IP 地址 */
+    ip?: string;
+    /** 请求头（部分关键头信息） */
+    headers?: Record<string, string>;
+    /** 连接 ID */
+    connectionId: string;
+    /** Gateway ID */
+    gatewayId: string;
+    /** 用户代理 */
+    userAgent?: string;
+    /** 时间戳 */
+    timestamp: number;
+}
+/**
+ * 认证结果
+ *
+ * Worker AuthService 返回的认证结果
+ */
+export interface AuthResult {
+    /** 是否验证通过 */
+    valid: boolean;
+    /** 用户ID（验证成功时） */
+    userId?: string;
+    /** 错误信息（验证失败时） */
+    error?: string;
+    /** 额外的用户数据（可选） */
+    userData?: Record<string, unknown>;
+}
+/**
+ * 房间鉴权结果
+ *
+ * Room.onAuth 可以返回的类型：
+ * - true: 允许加入
+ * - RoomAuthData (object): 允许加入，数据附加到 client.auth
+ * - false/falsy: 拒绝加入
+ * - throw ServerError: 拒绝加入，错误信息会发送给客户端
+ *
+ * ⚠️ 重要：Room.onAuth 不能设置或修改 userId！
+ * userId 必须在连接层（gw:auth）确定，这确保了：
+ * 1. 单连接单用户身份
+ * 2. Session 正确性
+ * 3. 多房间场景下的一致性
+ *
+ * 返回对象时，会附加到 client.auth（排除 userId 字段）
+ */
+export type RoomAuthResult = boolean | RoomAuthData | Promise<boolean | RoomAuthData>;
+/**
+ * 房间认证数据
+ *
+ * 当 Room.onAuth 返回对象时的结构
+ * 这些数据会附加到 client.auth，供后续使用
+ */
+export interface RoomAuthData {
+    /** 其他认证数据（会附加到 client.auth） */
+    [key: string]: unknown;
+}
+/**
+ * 服务端错误
+ *
+ * 在 onAuth/onJoin 中可以抛出的错误类型
+ * 错误信息会发送给客户端
+ */
+export declare class ServerError extends Error {
+    readonly code: number | string;
+    constructor(code: number | string, message: string);
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gBAAgB;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IAErB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,WAAW;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,UAAU;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa;IACb,KAAK,EAAE,OAAO,CAAC;IAEf,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAElB,IAAI,EAAE,MAAM,GAAG,MAAM;gBAArB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrC,OAAO,EAAE,MAAM;CAKlB"}

package/dist/types/auth.js

@@ -0,0 +1,15 @@
+/**
+ * 服务端错误
+ *
+ * 在 onAuth/onJoin 中可以抛出的错误类型
+ * 错误信息会发送给客户端
+ */
+export class ServerError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ServerError';
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/types/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AA8EA;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAElB;IADlB,YACkB,IAAqB,EACrC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAiB;QAIrC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/types/index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 连接状态
+ */
+export type ConnectionStatus = 'connected' | 'authenticating' | 'identified' | 'in-room' | 'disconnected';
+export * from './session.js';
+/**
+ * Gateway端连接结构
+ *
+ * 支持单连接多房间：一个用户可以同时在多个房间中
+ * 典型场景：用户在大厅(lobby)的同时进入游戏房间
+ */
+export interface Connection {
+    id: string;
+    userId?: string;
+    /** @deprecated 使用 rooms 代替 */
+    currentRoom?: string;
+    /** 当前所在的所有房间 */
+    rooms: Set<string>;
+    status: ConnectionStatus;
+    lastActivity: number;
+    createdAt: number;
+    /** 认证完成时间（用于空闲超时检查） */
+    identifiedAt?: number;
+}
+/**
+ * 房间状态
+ */
+export type RoomStatus = 'creating' | 'waiting' | 'active' | 'paused' | 'ending' | 'disposed';
+/**
+ * 房间成员信息（存储在Redis）
+ */
+export interface RoomMember {
+    gatewayId: string;
+    connectionId: string;
+    joinedAt: number;
+}
+/**
+ * Worker注册信息
+ */
+export interface WorkerInfo {
+    workerId: string;
+    gameTypes: string[];
+    status: 'online' | 'draining' | 'offline';
+    roomCount: number;
+    playerCount: number;
+    lastHeartbeat: number;
+    startedAt: number;
+}
+/**
+ * 房间信息
+ */
+export interface RoomInfo {
+    roomId: string;
+    gameType: string;
+    playerCount: number;
+    maxPlayers: number;
+    status: RoomStatus;
+    workerId: string;
+    createdAt: number;
+}
+/**
+ * 玩家信息
+ */
+export interface PlayerInfo {
+    userId: string;
+    nickname?: string;
+    avatar?: string;
+    joinedAt: number;
+}
+/**
+ * 房间迁移状态
+ */
+export type MigrationStatus = 'pending' | 'snapshotting' | 'transferring' | 'restoring' | 'verifying' | 'completed' | 'failed';
+/**
+ * 房间快照 - 用于迁移
+ */
+export interface RoomSnapshot {
+    roomId: string;
+    gameType: string;
+    maxPlayers: number;
+    config: Record<string, unknown>;
+    status: RoomStatus;
+    createdAt: number;
+    players: Array<{
+        userId: string;
+        gatewayId: string;
+        connectionId: string;
+        playerInfo: PlayerInfo;
+    }>;
+    gameState: unknown;
+    snapshotVersion: number;
+    snapshotTime: number;
+    sourceWorkerId: string;
+}
+/**
+ * 房间迁移请求
+ */
+export interface RoomMigrationRequest {
+    roomId: string;
+    sourceWorkerId: string;
+    targetWorkerId: string;
+    reason?: string;
+    priority?: 'low' | 'normal' | 'high';
+}
+/**
+ * 房间迁移结果
+ */
+export interface RoomMigrationResult {
+    success: boolean;
+    roomId: string;
+    sourceWorkerId: string;
+    targetWorkerId: string;
+    migrationTime?: number;
+    error?: string;
+    status: MigrationStatus;
+}
+export * from './auth.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,5 @@
+// 会话相关类型
+export * from './session.js';
+// 导出认证相关类型
+export * from './auth.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAUA,SAAS;AACT,cAAc,cAAc,CAAC;AA8I7B,WAAW;AACX,cAAc,WAAW,CAAC"}

package/dist/types/session.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 用户会话信息
+ *
+ * 保存在 Redis 中，用于断线重连
+ * 使用 TTL 自动过期（默认5分钟）
+ */
+export interface UserSession {
+    /** 用户ID */
+    userId: string;
+    /** 会话令牌（用于重连验证） */
+    sessionToken: string;
+    /** 当前连接的 Gateway ID */
+    gatewayId?: string;
+    /** 当前连接的 Connection ID */
+    connectionId?: string;
+    /** 用户所在的房间信息（包含类型，避免查询 roomState） */
+    rooms: Array<{
+        roomId: string;
+        gameType: string;
+    }>;
+    /** 最后活动时间 */
+    lastActivity: number;
+    /** 创建时间 */
+    createdAt: number;
+}
+/**
+ * 重连请求 Payload
+ */
+export interface ReconnectRequest {
+    /** 会话令牌 */
+    sessionToken: string;
+}
+/**
+ * 重连成功响应 Payload
+ */
+export interface ReconnectResponse {
+    /** 用户ID */
+    userId: string;
+    /** 恢复的房间列表 */
+    rooms: Array<{
+        roomId: string;
+        gameType: string;
+    }>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/types/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IAEf,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IAErB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,qCAAqC;IACrC,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IAEH,aAAa;IACb,YAAY,EAAE,MAAM,CAAC;IAErB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IAEf,cAAc;IACd,KAAK,EAAE,KAAK,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ"}

package/dist/types/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@roomkit/core",
+  "version": "1.0.0",
+  "description": "Core types and protocols for Gateway-Worker framework",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol/index.d.ts",
+      "import": "./dist/protocol/index.js",
+      "default": "./dist/protocol/index.js"
+    },
+    "./redis": {
+      "types": "./dist/redis/index.d.ts",
+      "import": "./dist/redis/index.js",
+      "default": "./dist/redis/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist"
+  },
+  "peerDependencies": {
+    "ioredis": "^5.0.0"
+  },
+  "devDependencies": {
+    "ioredis": "^5.3.2",
+    "typescript": "^5.3.0",
+    "rimraf": "^5.0.5"
+  },
+  "keywords": [
+    "gateway",
+    "worker",
+    "game-server",
+    "websocket",
+    "multiplayer"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/daxing/gateway-worker.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/daxing/gateway-worker/issues"
+  },
+  "homepage": "https://github.com/daxing/gateway-worker#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}