From 9c4118187539e39ead48ef2fa7af3ff45285fde5 Mon Sep 17 00:00:00 2001
From: YHH <359807859@qq.com>
Date: Sun, 28 Dec 2025 13:47:27 +0800
Subject: [PATCH] fix(server): expose id property on ServerConnection type
 (#372)

---
 .changeset/fix-server-connection-id-type.md  | 7 +++++++
 packages/framework/server/src/types/index.ts | 6 ++++++
 2 files changed, 13 insertions(+)
 create mode 100644 .changeset/fix-server-connection-id-type.md

diff --git a/.changeset/fix-server-connection-id-type.md b/.changeset/fix-server-connection-id-type.md
new file mode 100644
index 00000000..8964bb6d
--- /dev/null
+++ b/.changeset/fix-server-connection-id-type.md
@@ -0,0 +1,7 @@
+---
+"@esengine/server": patch
+---
+
+fix: expose `id` property on ServerConnection type
+
+TypeScript was not properly resolving the inherited `id` property from the base `Connection` interface in some module resolution scenarios. This fix explicitly declares the `id` property on `ServerConnection` to ensure it's always visible to consumers.
diff --git a/packages/framework/server/src/types/index.ts b/packages/framework/server/src/types/index.ts
index 34ecfcd0..b6937f02 100644
--- a/packages/framework/server/src/types/index.ts
+++ b/packages/framework/server/src/types/index.ts
@@ -70,6 +70,12 @@ export interface ServerConfig {
  * @en Server connection (extends RPC Connection)
  */
 export 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