@esengine/network 1.0.0 → 2.1.1

package/dist/services/NetworkService.d.ts

@@ -1,62 +1,148 @@
-import { type MsgSync, type MsgSpawn, type MsgDespawn, type IPlayerInput } from '@esengine/network-protocols';
 /**
- * 连接状态
- * Connection state
+ * @zh 网络服务模块
+ * @en Network Service Module
  */
-export declare const enum ENetworkState {
+import { RpcClient, type ProtocolDef, type ApiNames, type MsgNames, type ApiInput, type ApiOutput, type MsgData, type RpcClientOptions } from '@esengine/rpc/client';
+import { type GameProtocol, type PlayerInput } from '../protocol';
+/**
+ * @zh 连接状态
+ * @en Connection state
+ */
+export declare const enum NetworkState {
     Disconnected = 0,
     Connecting = 1,
     Connected = 2
 }
 /**
- * 网络事件回调
- * Network event callbacks
+ * @zh 网络服务配置
+ * @en Network service options
  */
-export interface INetworkCallbacks {
-    onConnected?: (clientId: number, roomId: string) => void;
-    onDisconnected?: () => void;
-    onSync?: (msg: MsgSync) => void;
-    onSpawn?: (msg: MsgSpawn) => void;
-    onDespawn?: (msg: MsgDespawn) => void;
-    onError?: (error: Error) => void;
+export interface NetworkServiceOptions extends RpcClientOptions {
+    /**
+     * @zh 服务器地址
+     * @en Server URL
+     */
+    url: string;
 }
 /**
- * 网络服务
- * Network service
+ * @zh RPC 服务基类
+ * @en RPC Service base class
+ *
+ * @zh 纯粹的 RPC 客户端封装，不包含任何游戏特定逻辑
+ * @en Pure RPC client wrapper without any game-specific logic
  *
- * 基于 TSRPC 的网络服务封装，提供类型安全的网络通信。
- * TSRPC-based network service wrapper with type-safe communication.
+ * @typeParam P - @zh 协议定义类型 @en Protocol definition type
  */
-export declare class NetworkService {
-    private _client;
-    private _state;
-    private _clientId;
-    private _roomId;
-    private _callbacks;
-    get state(): ENetworkState;
-    get clientId(): number;
-    get roomId(): string;
+export declare class RpcService<P extends ProtocolDef> {
+    protected readonly _protocol: P;
+    protected _client: RpcClient<P> | null;
+    protected _state: NetworkState;
+    constructor(_protocol: P);
+    /**
+     * @zh 获取连接状态
+     * @en Get connection state
+     */
+    get state(): NetworkState;
+    /**
+     * @zh 是否已连接
+     * @en Whether connected
+     */
     get isConnected(): boolean;
     /**
-     * 设置回调
-     * Set callbacks
+     * @zh 获取底层 RPC 客户端
+     * @en Get underlying RPC client
+     */
+    get client(): RpcClient<P> | null;
+    /**
+     * @zh 连接到服务器
+     * @en Connect to server
+     */
+    connect(options: NetworkServiceOptions): Promise<void>;
+    /**
+     * @zh 断开连接
+     * @en Disconnect
+     */
+    disconnect(): void;
+    /**
+     * @zh 调用 API
+     * @en Call API
+     */
+    call<K extends ApiNames<P>>(name: K, input: ApiInput<P['api'][K]>): Promise<ApiOutput<P['api'][K]>>;
+    /**
+     * @zh 发送消息
+     * @en Send message
+     */
+    send<K extends MsgNames<P>>(name: K, data: MsgData<P['msg'][K]>): void;
+    /**
+     * @zh 监听消息
+     * @en Listen to message
+     */
+    on<K extends MsgNames<P>>(name: K, handler: (data: MsgData<P['msg'][K]>) => void): this;
+    /**
+     * @zh 取消监听消息
+     * @en Remove message listener
+     */
+    off<K extends MsgNames<P>>(name: K, handler?: (data: MsgData<P['msg'][K]>) => void): this;
+    /**
+     * @zh 监听消息（只触发一次）
+     * @en Listen to message (once)
+     */
+    once<K extends MsgNames<P>>(name: K, handler: (data: MsgData<P['msg'][K]>) => void): this;
+}
+/**
+ * @zh 游戏网络服务
+ * @en Game network service
+ *
+ * @zh 基于默认游戏协议的网络服务，提供游戏特定的便捷方法
+ * @en Network service based on default game protocol with game-specific convenience methods
+ *
+ * @example
+ * ```typescript
+ * const network = new GameNetworkService()
+ * await network.connect({ url: 'ws://localhost:3000' })
+ *
+ * // 游戏特定的便捷方法
+ * network.sendInput({ frame: 1, moveDir: { x: 1, y: 0 } })
+ *
+ * network.onSync((data) => {
+ *     for (const entity of data.entities) {
+ *         // 更新实体状态
+ *     }
+ * })
+ * ```
+ */
+export declare class GameNetworkService extends RpcService<GameProtocol> {
+    constructor();
+    /**
+     * @zh 发送玩家输入
+     * @en Send player input
      */
-    setCallbacks(callbacks: INetworkCallbacks): void;
+    sendInput(input: PlayerInput): void;
     /**
-     * 连接到服务器
-     * Connect to server
+     * @zh 监听状态同步
+     * @en Listen to state sync
      */
-    connect(serverUrl: string, playerName: string, roomId?: string): Promise<boolean>;
+    onSync(handler: (data: MsgData<GameProtocol['msg']['sync']>) => void): this;
     /**
-     * 断开连接
-     * Disconnect
+     * @zh 监听实体生成
+     * @en Listen to entity spawn
      */
-    disconnect(): Promise<void>;
+    onSpawn(handler: (data: MsgData<GameProtocol['msg']['spawn']>) => void): this;
     /**
-     * 发送输入
-     * Send input
+     * @zh 监听实体销毁
+     * @en Listen to entity despawn
      */
-    sendInput(input: IPlayerInput): void;
-    private _setupListeners;
+    onDespawn(handler: (data: MsgData<GameProtocol['msg']['despawn']>) => void): this;
 }
+/**
+ * @zh 网络服务（GameNetworkService 的别名）
+ * @en Network service (alias for GameNetworkService)
+ */
+export { GameNetworkService as NetworkService };
+/**
+ * @zh 创建网络服务
+ * @en Create network service
+ */
+export declare function createNetworkService(): GameNetworkService;
+export declare function createNetworkService<P extends ProtocolDef>(protocol: P): RpcService<P>;
 //# sourceMappingURL=NetworkService.d.ts.map

package/dist/services/NetworkService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkService.d.ts","sourceRoot":"","sources":["../../src/services/NetworkService.ts"],"names":[],"mappings":"AACA,OAAO,EAGH,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACpB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,0BAAkB,aAAa;IAC3B,YAAY,IAAI;IAChB,UAAU,IAAI;IACd,SAAS,IAAI;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpC;AAcD;;;;;;GAMG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,UAAU,CAAyB;IAE3C,IAAI,KAAK,IAAI,aAAa,CAEzB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAIhD;;;OAGG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwCvF;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAKpC,OAAO,CAAC,eAAe;CAqB1B"}
+{"version":3,"file":"NetworkService.d.ts","sourceRoot":"","sources":["../../src/services/NetworkService.ts"],"names":[],"mappings":"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"}

package/dist/systems/NetworkInputSystem.d.ts

@@ -1,11 +1,15 @@
+/**
+ * @zh 网络输入系统
+ * @en Network Input System
+ */
 import { EntitySystem } from '@esengine/ecs-framework';
 import type { NetworkService } from '../services/NetworkService';
 /**
- * 网络输入系统
- * Network input system
+ * @zh 网络输入系统
+ * @en Network input system
  *
- * 收集本地玩家输入并发送到服务器。
- * Collects local player input and sends to server.
+ * @zh 收集本地玩家输入并发送到服务器
+ * @en Collects local player input and sends to server
  */
 export declare class NetworkInputSystem extends EntitySystem {
     private _networkService;
@@ -13,18 +17,18 @@ export declare class NetworkInputSystem extends EntitySystem {
     private _inputQueue;
     constructor(networkService: NetworkService);
     /**
-     * 处理输入队列
-     * Process input queue
+     * @zh 处理输入队列
+     * @en Process input queue
      */
     protected process(): void;
     /**
-     * 添加移动输入
-     * Add move input
+     * @zh 添加移动输入
+     * @en Add move input
      */
     addMoveInput(x: number, y: number): void;
     /**
-     * 添加动作输入
-     * Add action input
+     * @zh 添加动作输入
+     * @en Add action input
      */
     addActionInput(action: string): void;
     protected onDestroy(): void;

package/dist/systems/NetworkInputSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkInputSystem.d.ts","sourceRoot":"","sources":["../../src/systems/NetworkInputSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAW,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAChD,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,WAAW,CAAsB;gBAE7B,cAAc,EAAE,cAAc;IAO1C;;;OAGG;cACgB,OAAO,IAAI,IAAI;IAclC;;;OAGG;IACI,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAO/C;;;OAGG;IACI,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;cAaxB,SAAS,IAAI,IAAI;CAGvC"}
+{"version":3,"file":"NetworkInputSystem.d.ts","sourceRoot":"","sources":["../../src/systems/NetworkInputSystem.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAW,MAAM,yBAAyB,CAAA;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAEhE;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAChD,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAoB;gBAE3B,cAAc,EAAE,cAAc;IAK1C;;;OAGG;cACgB,OAAO,IAAI,IAAI;IAYlC;;;OAGG;IACI,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAO/C;;;OAGG;IACI,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;cAaxB,SAAS,IAAI,IAAI;CAGvC"}

package/dist/systems/NetworkSpawnSystem.d.ts

@@ -1,37 +1,68 @@
 import { EntitySystem, Entity, type Scene } from '@esengine/ecs-framework';
-import type { MsgSpawn } from '@esengine/network-protocols';
-import type { NetworkService } from '../services/NetworkService';
 import type { NetworkSyncSystem } from './NetworkSyncSystem';
 /**
- * 预制体工厂函数类型
- * Prefab factory function type
+ * @zh 生成消息接口
+ * @en Spawn message interface
  */
-export type PrefabFactory = (scene: Scene, spawn: MsgSpawn) => Entity;
+export interface SpawnMessage {
+    netId: number;
+    ownerId: number;
+    prefab: string;
+    pos: {
+        x: number;
+        y: number;
+    };
+    rot?: number;
+}
+/**
+ * @zh 销毁消息接口
+ * @en Despawn message interface
+ */
+export interface DespawnMessage {
+    netId: number;
+}
+/**
+ * @zh 预制体工厂函数类型
+ * @en Prefab factory function type
+ */
+export type PrefabFactory = (scene: Scene, spawn: SpawnMessage) => Entity;
 /**
- * 网络生成系统
- * Network spawn system
+ * @zh 网络生成系统
+ * @en Network spawn system
  *
- * 处理网络实体的生成和销毁。
- * Handles spawning and despawning of networked entities.
+ * @zh 处理网络实体的生成和销毁
+ * @en Handles spawning and despawning of networked entities
  */
 export declare class NetworkSpawnSystem extends EntitySystem {
-    private _networkService;
     private _syncSystem;
     private _prefabFactories;
-    constructor(networkService: NetworkService, syncSystem: NetworkSyncSystem);
-    protected onInitialize(): void;
+    private _localPlayerId;
+    constructor(syncSystem: NetworkSyncSystem);
+    /**
+     * @zh 设置本地玩家 ID
+     * @en Set local player ID
+     */
+    setLocalPlayerId(id: number): void;
+    /**
+     * @zh 处理生成消息
+     * @en Handle spawn message
+     */
+    handleSpawn(msg: SpawnMessage): Entity | null;
+    /**
+     * @zh 处理销毁消息
+     * @en Handle despawn message
+     */
+    handleDespawn(msg: DespawnMessage): void;
     /**
-     * 注册预制体工厂
-     * Register prefab factory
+     * @zh 注册预制体工厂
+     * @en Register prefab factory
      */
     registerPrefab(prefabType: string, factory: PrefabFactory): void;
     /**
-     * 注销预制体工厂
-     * Unregister prefab factory
+     * @zh 注销预制体工厂
+     * @en Unregister prefab factory
      */
     unregisterPrefab(prefabType: string): void;
-    private _handleSpawn;
-    private _handleDespawn;
     protected onDestroy(): void;
 }
 //# sourceMappingURL=NetworkSpawnSystem.d.ts.map

package/dist/systems/NetworkSpawnSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkSpawnSystem.d.ts","sourceRoot":"","sources":["../../src/systems/NetworkSpawnSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,KAAK,EAAW,MAAM,yBAAyB,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,6BAA6B,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,KAAK,MAAM,CAAC;AAEtE;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAChD,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,gBAAgB,CAAyC;gBAErD,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB;cAQtD,YAAY,IAAI,IAAI;IAOvC;;;OAGG;IACI,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIvE;;;OAGG;IACI,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIjD,OAAO,CAAC,YAAY;IA6BpB,OAAO,CAAC,cAAc;cAYH,SAAS,IAAI,IAAI;CAGvC"}
+{"version":3,"file":"NetworkSpawnSystem.d.ts","sourceRoot":"","sources":["../../src/systems/NetworkSpawnSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,KAAK,EAAW,MAAM,yBAAyB,CAAA;AAGnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,KAAK,MAAM,CAAA;AAEzE;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAChD,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,cAAc,CAAY;gBAEtB,UAAU,EAAE,iBAAiB;IAKzC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIlC;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IA2B7C;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAYxC;;;OAGG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIhE;;;OAGG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;cAIvB,SAAS,IAAI,IAAI;CAGvC"}

package/dist/systems/NetworkSyncSystem.d.ts

@@ -1,38 +1,49 @@
 import { EntitySystem, type Entity } from '@esengine/ecs-framework';
-import type { NetworkService } from '../services/NetworkService';
 /**
- * 网络同步系统
- * Network sync system
+ * @zh 同步消息接口
+ * @en Sync message interface
+ */
+export interface SyncMessage {
+    entities: Array<{
+        netId: number;
+        pos?: {
+            x: number;
+            y: number;
+        };
+        rot?: number;
+    }>;
+}
+/**
+ * @zh 网络同步系统
+ * @en Network sync system
  *
- * 处理网络实体的状态同步和插值。
- * Handles state synchronization and interpolation for networked entities.
+ * @zh 处理网络实体的状态同步和插值
+ * @en Handles state synchronization and interpolation for networked entities
  */
 export declare class NetworkSyncSystem extends EntitySystem {
-    private _networkService;
     private _netIdToEntity;
-    constructor(networkService: NetworkService);
-    protected onInitialize(): void;
+    constructor();
     /**
-     * 处理实体列表
-     * Process entities
+     * @zh 处理同步消息
+     * @en Handle sync message
      */
+    handleSync(msg: SyncMessage): void;
     protected process(entities: readonly Entity[]): void;
     /**
-     * 注册网络实体
-     * Register network entity
+     * @zh 注册网络实体
+     * @en Register network entity
      */
     registerEntity(netId: number, entityId: number): void;
     /**
-     * 注销网络实体
-     * Unregister network entity
+     * @zh 注销网络实体
+     * @en Unregister network entity
      */
     unregisterEntity(netId: number): void;
     /**
-     * 根据网络 ID 获取实体 ID
-     * Get entity ID by network ID
+     * @zh 根据网络 ID 获取实体 ID
+     * @en Get entity ID by network ID
      */
     getEntityId(netId: number): number | undefined;
-    private _handleSync;
     private _interpolate;
     protected onDestroy(): void;
 }

package/dist/systems/NetworkSyncSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkSyncSystem.d.ts","sourceRoot":"","sources":["../../src/systems/NetworkSyncSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAInF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC/C,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAkC;gBAE5C,cAAc,EAAE,cAAc;cAKvB,YAAY,IAAI,IAAI;IAMvC;;;OAGG;cACgB,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAe7D;;;OAGG;IACI,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI5D;;;OAGG;IACI,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5C;;;OAGG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIrD,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,YAAY;cAcD,SAAS,IAAI,IAAI;CAGvC"}
+{"version":3,"file":"NetworkSyncSystem.d.ts","sourceRoot":"","sources":["../../src/systems/NetworkSyncSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAIlF;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,GAAG,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;CACL;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC/C,OAAO,CAAC,cAAc,CAAiC;;IAMvD;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;cAef,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAa7D;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIrD;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C,OAAO,CAAC,YAAY;cAYD,SAAS,IAAI,IAAI;CAGvC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@esengine/network",
-  "version": "1.0.0",
-  "description": "Network synchronization for multiplayer games based on TSRPC",
+  "version": "2.1.1",
+  "description": "Network synchronization for multiplayer games",
   "esengine": {
     "plugin": true,
     "pluginExport": "NetworkPlugin",
@@ -22,15 +22,14 @@
     "dist"
   ],
   "dependencies": {
-    "tsrpc-browser": "^3.4.16",
-    "@esengine/network-protocols": "1.0.0"
+    "@esengine/rpc": "1.1.1"
   },
   "devDependencies": {
     "rimraf": "^5.0.5",
     "tsup": "^8.0.0",
     "typescript": "^5.3.3",
-    "@esengine/blueprint": "1.0.0",
-    "@esengine/ecs-framework": "2.4.2",
+    "@esengine/blueprint": "1.0.2",
+    "@esengine/ecs-framework": "2.4.4",
     "@esengine/build-config": "1.0.0"
   },
   "keywords": [
@@ -43,7 +42,7 @@
   "author": "yhh",
   "license": "MIT",
   "scripts": {
-    "build": "tsup && tsc --project tsconfig.build.json --declaration --emitDeclarationOnly --outDir dist",
+    "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly",
     "build:watch": "tsup --watch",
     "type-check": "tsc --noEmit",
     "clean": "rimraf dist"