@wukong-kit/network 0.1.0

package/README.md

@@ -0,0 +1,150 @@
+# @wukong-kit/network
+
+WebSocket-based network layer for Wukong Kit.
+
+Built-in JSON protocol, request/response pattern, automatic reconnect with exponential backoff, heartbeat keepalive, and offline message queuing.
+
+## Features
+
+- **WebSocket transport** — single connection, URL token auth
+- **Request / Response** — `request(route, body) → Promise<T>` with timeout
+- **Event-driven push** — all server pushes via `WKEventBus`
+- **Auto-reconnect** — exponential backoff (1s → 2s → 4s → ... → 30s)
+- **Retry callback** — 3 automatic retries, then delegate to your handler
+- **Heartbeat** — configurable interval & timeout, auto-reconnect on timeout
+- **Offline queue** — buffer messages when disconnected, flush on reconnect
+- **Pluggable protocol** — default JSON, swap to Protobuf later via `WKProtocol`
+
+## Installation
+
+```bash
+npm install @wukong-kit/network
+```
+
+## Usage
+
+### Basic setup
+
+```ts
+import { WKNetworkManager, networkManager } from '@wukong-kit/network';
+
+networkManager.setConfig({
+  serverUrl: 'wss://game.example.com/ws',
+  authToken: 'your-auth-token',
+});
+
+networkManager.connect();
+```
+
+### Request / Response
+
+```ts
+try {
+  const data = await networkManager.request('player.login', {
+    uid: 10001,
+    password: '***',
+  });
+  console.log('Login success:', data);
+} catch (err) {
+  console.error('Login failed:', err);
+}
+```
+
+### Fire-and-forget
+
+```ts
+networkManager.send('player.move', { x: 10, y: 20 });
+```
+
+### Listen for pushes (事件模式)
+
+```ts
+import { WKEvent } from '@wukong-kit/core';
+
+// 监听具体路由
+WKEvent.on('wk:net:push:room.match', (data) => {
+  console.log('Matched!', data);
+});
+
+// 监听所有推送
+WKEvent.on('wk:net:push', (message) => {
+  console.log('Push:', message.route, message.body);
+});
+```
+
+### Connection events
+
+```ts
+WKEvent.on('wk:net:connected', () => { /* ... */ });
+WKEvent.on('wk:net:disconnected', ({ code, reason }) => { /* ... */ });
+WKEvent.on('wk:net:reconnecting', ({ attempt, delay }) => { /* ... */ });
+```
+
+### Retry handler
+
+```ts
+networkManager.setRetryHandler((attempts, retry, abort) => {
+  // 弹窗询问玩家
+  showConfirmDialog({
+    title: '连接失败',
+    message: `已重连 ${attempts} 次失败，是否继续？`,
+    onConfirm: retry,
+    onCancel: abort,
+  });
+});
+```
+
+### Custom protocol (advanced)
+
+```ts
+import { WKProtocolRegistry, WKBaseProtocol } from '@wukong-kit/network';
+
+class MyProtobufProtocol extends WKBaseProtocol {
+  encode(msg) { /* ... */ }
+  decode(data) { /* ... */ }
+}
+
+const registry = new WKProtocolRegistry();
+registry.register('protobuf', new MyProtobufProtocol());
+```
+
+## Configuration reference
+
+| Option | Default | Description |
+|---|---|---|
+| `serverUrl` | `''` | WebSocket server URL (required) |
+| `authToken` | `''` | Token appended as `?token=xxx` |
+| `defaultTimeout` | `30000` | Request timeout (ms) |
+| `heartbeatInterval` | `10000` | Ping interval (ms) |
+| `heartbeatTimeout` | `5000` | Pong wait before reconnecting (ms) |
+| `reconnectMaxAttempts` | `3` | Automatic retry count before callback |
+| `reconnectBaseDelay` | `1000` | Initial reconnect delay (ms) |
+| `reconnectMaxDelay` | `30000` | Max reconnect delay (ms) |
+
+## Message envelope
+
+```ts
+interface WKMessage {
+  route: string;       // "player.login"
+  seq: number;         // auto-increment
+  body: unknown;       // your payload
+  timestamp: number;   // ms
+  ack: boolean;        // expects response
+  ackSeq?: number;     // response to which seq
+}
+```
+
+## Event reference
+
+| Event | Payload | Description |
+|---|---|---|
+| `wk:net:connected` | `{ url }` | Connection established |
+| `wk:net:disconnected` | `{ code, reason, wasConnected }` | Connection closed |
+| `wk:net:reconnecting` | `{ attempt, delay }` | Auto-reconnect countdown |
+| `wk:net:push` | `WKMessage` | Raw server push |
+| `wk:net:push:${route}` | `body` | Route-specific push |
+| `wk:net:error` | `{ message, code? }` | Network error |
+
+## License
+
+MIT

package/dist/WKNetworkManager.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @wukong-kit/network — Network Manager
+ *
+ * 核心单例，管理 WebSocket 连接生命周期、消息收发、
+ * 自动重连、心跳保活、请求-应答匹配、离线缓冲。
+ *
+ * 使用方式：
+ * ```ts
+ * const net = WKNetworkManager.get();
+ * net.setConfig({ serverUrl: 'wss://...', authToken: 'xxx' });
+ * net.connect();
+ * const data = await net.request('player.login', { uid: 1 });
+ * ```
+ */
+import { WKSingleton } from '@wukong-kit/core';
+import { WKNetworkStatus } from './types.js';
+import type { WKNetworkConfig, WKRetryHandler } from './types.js';
+export declare class WKNetworkManager extends WKSingleton {
+    private readonly ws;
+    private readonly protocolRegistry;
+    private readonly queue;
+    private config;
+    private _connected;
+    private reconnectAttempt;
+    private reconnectTimer;
+    private heartbeatTimer;
+    private heartbeatPending;
+    private readonly pendingRequests;
+    private retryHandler;
+    private explicitDisconnect;
+    /** 当前连接状态 */
+    get status(): WKNetworkStatus;
+    /** 是否已连接 */
+    get connected(): boolean;
+    /** 离线队列当前长度 */
+    get queueLength(): number;
+    setConfig(config: WKNetworkConfig): void;
+    /** 更新单项配置 */
+    updateConfig(partial: Partial<WKNetworkConfig>): void;
+    connect(): void;
+    /**
+     * 优雅断开连接。
+     * @param code  关闭码，默认 1000
+     * @param reason 关闭原因
+     */
+    disconnect(code?: number, reason?: string): void;
+    /**
+     * 发送消息并等待响应。
+     * @param route  消息路由
+     * @param body   消息体
+     * @param timeoutMs  超时（ms），默认使用 config.defaultTimeout
+     * @returns Promise 解析为响应 body
+     */
+    request<T = unknown>(route: string, body: unknown, timeoutMs?: number): Promise<T>;
+    /**
+     * 发送消息（不等待响应）。
+     */
+    send(route: string, body: unknown): void;
+    /**
+     * 注册重试回调。
+     * 自动重连失败超过 maxAttempts 次后调用。
+     * 回调接收 (attempts, retry, abort)：
+     *   - attempts: 已失败次数
+     *   - retry:    调用则再试一次
+     *   - abort:    放弃连接
+     */
+    setRetryHandler(handler: WKRetryHandler | null): void;
+    private _doConnect;
+    private _onOpen;
+    private _onClose;
+    private _onMessage;
+    private _sendOrQueue;
+    private _sendMessage;
+    private _flushQueue;
+    private _startHeartbeat;
+    private _clearHeartbeat;
+    private _onHeartbeatTimeout;
+    private _scheduleReconnect;
+    /** 指数退避 delay 计算 */
+    private _reconnectDelay;
+    private _onReconnectExhausted;
+    private _clearReconnectTimer;
+    private _rejectAllPending;
+    dispose(): void;
+}
+/** 全局快捷引用 */
+export declare const networkManager: WKNetworkManager;
+//# sourceMappingURL=WKNetworkManager.d.ts.map

package/dist/WKNetworkManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WKNetworkManager.d.ts","sourceRoot":"","sources":["../src/WKNetworkManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAqB,MAAM,kBAAkB,CAAC;AAIlE,OAAO,EACL,eAAe,EAEhB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,eAAe,EAEf,cAAc,EAEf,MAAM,YAAY,CAAC;AA2BpB,qBAAa,gBAAiB,SAAQ,WAAW;IAE/C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAG9C,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IACrE,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,kBAAkB,CAAS;IAEnC,aAAa;IACb,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,YAAY;IACZ,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,eAAe;IACf,IAAI,WAAW,IAAI,MAAM,CAExB;IAID,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIxC,aAAa;IACb,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAMrD,OAAO,IAAI,IAAI;IAcf;;;;OAIG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAWhD;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAwBlF;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAcxC;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI;IAMrD,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,UAAU;IAkClB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,kBAAkB;IA2B1B,oBAAoB;IACpB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,iBAAiB;IAUzB,OAAO,IAAI,IAAI;CAKhB;AAED,aAAa;AACb,eAAO,MAAM,cAAc,kBAAyB,CAAC"}

package/dist/WKNetworkManager.js

@@ -0,0 +1,383 @@
+/**
+ * @wukong-kit/network — Network Manager
+ *
+ * 核心单例，管理 WebSocket 连接生命周期、消息收发、
+ * 自动重连、心跳保活、请求-应答匹配、离线缓冲。
+ *
+ * 使用方式：
+ * ```ts
+ * const net = WKNetworkManager.get();
+ * net.setConfig({ serverUrl: 'wss://...', authToken: 'xxx' });
+ * net.connect();
+ * const data = await net.request('player.login', { uid: 1 });
+ * ```
+ */
+import { WKSingleton, WKEvent, WKLogger } from '@wukong-kit/core';
+import { WKNetworkQueue } from './WKNetworkQueue.js';
+import { WKProtocolRegistry } from './WKNetworkProtocol.js';
+import { WKWebSocket } from './WKWebSocket.js';
+import { WKNetworkStatus, WKNetworkEventName, } from './types.js';
+// ─── 默认配置 ──────────────────────────────────────
+const DEFAULT_CONFIG = {
+    serverUrl: '',
+    authToken: '',
+    defaultTimeout: 30000,
+    heartbeatInterval: 10000,
+    heartbeatTimeout: 5000,
+    reconnectMaxAttempts: 3,
+    reconnectBaseDelay: 1000,
+    reconnectMaxDelay: 30000,
+};
+// ─── 内部路由 ──────────────────────────────────────
+const INTERNAL_ROUTE_PING = '@ping';
+const INTERNAL_ROUTE_PONG = '@pong';
+let _globalSeq = 0;
+function nextSeq() {
+    return ++_globalSeq;
+}
+// ─── WKNetworkManager ──────────────────────────────
+export class WKNetworkManager extends WKSingleton {
+    constructor() {
+        super(...arguments);
+        // 子系统
+        this.ws = new WKWebSocket();
+        this.protocolRegistry = new WKProtocolRegistry();
+        this.queue = new WKNetworkQueue();
+        // 状态
+        this.config = { ...DEFAULT_CONFIG };
+        this._connected = false;
+        this.reconnectAttempt = 0;
+        this.reconnectTimer = null;
+        this.heartbeatTimer = null;
+        this.heartbeatPending = false;
+        this.pendingRequests = new Map();
+        this.retryHandler = null;
+        this.explicitDisconnect = false;
+    }
+    /** 当前连接状态 */
+    get status() {
+        return this.ws.status;
+    }
+    /** 是否已连接 */
+    get connected() {
+        return this._connected;
+    }
+    /** 离线队列当前长度 */
+    get queueLength() {
+        return this.queue.length;
+    }
+    // ─── 配置 ───────────────────────────────────
+    setConfig(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /** 更新单项配置 */
+    updateConfig(partial) {
+        Object.assign(this.config, partial);
+    }
+    // ─── 连接 / 断开 ─────────────────────────────
+    connect() {
+        if (this.ws.status === WKNetworkStatus.CONNECTED) {
+            WKLogger.warn('[Network] Already connected');
+            return;
+        }
+        if (this.ws.status === WKNetworkStatus.CONNECTING) {
+            WKLogger.warn('[Network] Already connecting');
+            return;
+        }
+        this.explicitDisconnect = false;
+        this._doConnect();
+    }
+    /**
+     * 优雅断开连接。
+     * @param code  关闭码，默认 1000
+     * @param reason 关闭原因
+     */
+    disconnect(code, reason) {
+        this.explicitDisconnect = true;
+        this._clearReconnectTimer();
+        this._clearHeartbeat();
+        this._rejectAllPending(new Error('Network disconnected'));
+        this.ws.disconnect(code, reason);
+        this._connected = false;
+    }
+    // ─── 发送 ───────────────────────────────────
+    /**
+     * 发送消息并等待响应。
+     * @param route  消息路由
+     * @param body   消息体
+     * @param timeoutMs  超时（ms），默认使用 config.defaultTimeout
+     * @returns Promise 解析为响应 body
+     */
+    request(route, body, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const seq = nextSeq();
+            const timeout = timeoutMs ?? this.config.defaultTimeout;
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(seq);
+                reject(new Error(`Request timeout: ${route} (seq=${seq}, timeout=${timeout}ms)`));
+            }, timeout);
+            this.pendingRequests.set(seq, { route, resolve: resolve, reject, timer });
+            const message = {
+                route,
+                seq,
+                body,
+                timestamp: Date.now(),
+                ack: true,
+            };
+            this._sendOrQueue(message);
+        });
+    }
+    /**
+     * 发送消息（不等待响应）。
+     */
+    send(route, body) {
+        const seq = nextSeq();
+        const message = {
+            route,
+            seq,
+            body,
+            timestamp: Date.now(),
+            ack: false,
+        };
+        this._sendOrQueue(message);
+    }
+    // ─── 重试处理器 ─────────────────────────────
+    /**
+     * 注册重试回调。
+     * 自动重连失败超过 maxAttempts 次后调用。
+     * 回调接收 (attempts, retry, abort)：
+     *   - attempts: 已失败次数
+     *   - retry:    调用则再试一次
+     *   - abort:    放弃连接
+     */
+    setRetryHandler(handler) {
+        this.retryHandler = handler;
+    }
+    // ─── 内部实现 ───────────────────────────────
+    _doConnect() {
+        let url = this.config.serverUrl;
+        // 拼接 auth token
+        if (this.config.authToken) {
+            const separator = url.includes('?') ? '&' : '?';
+            url = `${url}${separator}token=${encodeURIComponent(this.config.authToken)}`;
+        }
+        this.ws.connect(url, {
+            onOpen: () => this._onOpen(),
+            onClose: (code, reason) => this._onClose(code, reason),
+            onMessage: (data) => this._onMessage(data),
+            onError: (payload) => {
+                WKLogger.error('[Network]', payload.message);
+            },
+        });
+    }
+    // ─── 事件处理 ───────────────────────────────
+    _onOpen() {
+        this._connected = true;
+        this.reconnectAttempt = 0;
+        this._clearReconnectTimer();
+        // 发送队列中的离线消息
+        this._flushQueue();
+        // 启动心跳
+        this._startHeartbeat();
+        WKLogger.info('[Network] Connected:', this.config.serverUrl);
+        WKEvent.emit(WKNetworkEventName.CONNECTED, { url: this.config.serverUrl });
+    }
+    _onClose(code, reason) {
+        const wasConnected = this._connected;
+        this._connected = false;
+        this._clearHeartbeat();
+        WKLogger.warn(`[Network] Disconnected: code=${code}, reason=${reason}`);
+        WKEvent.emit(WKNetworkEventName.DISCONNECTED, { code, reason, wasConnected });
+        // 拒绝所有挂起的请求
+        this._rejectAllPending(new Error(`Connection closed: ${reason || 'unknown'}`));
+        // 自动重连（非主动断开时）
+        if (!this.explicitDisconnect) {
+            this._scheduleReconnect();
+        }
+    }
+    _onMessage(data) {
+        try {
+            const protocol = this.protocolRegistry.get('json');
+            const message = protocol.decode(data);
+            // 内部心跳回复
+            if (message.route === INTERNAL_ROUTE_PONG) {
+                this.heartbeatPending = false;
+                return;
+            }
+            // 应答消息（匹配 pending request）
+            if (message.ack && message.ackSeq !== undefined) {
+                const pending = this.pendingRequests.get(message.ackSeq);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    this.pendingRequests.delete(message.ackSeq);
+                    pending.resolve(message.body);
+                }
+                return;
+            }
+            // 推送消息 → 事件总线
+            WKEvent.emit(WKNetworkEventName.PUSH, message);
+            // 同时发具体路由事件，方便精确监听
+            WKEvent.emit(`wk:net:push:${message.route}`, message.body);
+        }
+        catch (err) {
+            WKLogger.error('[Network] Failed to decode message:', err.message);
+        }
+    }
+    // ─── 消息发送（在线发送 / 离线入队）────────
+    _sendOrQueue(message) {
+        if (this._connected) {
+            this._sendMessage(message);
+        }
+        else {
+            // 仅缓冲需要 ACK 的消息（fire-and-forget 不缓冲）
+            if (message.ack) {
+                this.queue.push(message.route, message.body, message.seq, this.config.defaultTimeout);
+                WKLogger.debug(`[Network] Queued message (offline): ${message.route}`);
+            }
+        }
+    }
+    _sendMessage(message) {
+        const protocol = this.protocolRegistry.get('json');
+        const encoded = protocol.encode(message);
+        const sent = this.ws.send(encoded);
+        if (!sent) {
+            WKLogger.error('[Network] Failed to send message:', message.route);
+            // 发送失败也入队
+            if (message.ack) {
+                this.queue.push(message.route, message.body, message.seq, this.config.defaultTimeout);
+            }
+        }
+    }
+    _flushQueue() {
+        if (this.queue.isEmpty)
+            return;
+        const messages = this.queue.flushAll();
+        WKLogger.info(`[Network] Flushing ${messages.length} queued messages`);
+        for (const msg of messages) {
+            this._sendMessage({
+                route: msg.route,
+                seq: msg.seq,
+                body: msg.body,
+                timestamp: Date.now(),
+                ack: true,
+            });
+        }
+    }
+    // ─── 心跳 ──────────────────────────────────
+    _startHeartbeat() {
+        this._clearHeartbeat();
+        this.heartbeatPending = false;
+        this.heartbeatTimer = setInterval(() => {
+            if (!this._connected)
+                return;
+            // 上次心跳还没回复 → 超时
+            if (this.heartbeatPending) {
+                WKLogger.warn('[Network] Heartbeat timeout, reconnecting...');
+                this._onHeartbeatTimeout();
+                return;
+            }
+            this.heartbeatPending = true;
+            this._sendMessage({
+                route: INTERNAL_ROUTE_PING,
+                seq: nextSeq(),
+                body: {},
+                timestamp: Date.now(),
+                ack: false,
+            });
+            // 单次心跳超时检测
+            setTimeout(() => {
+                if (this.heartbeatPending && this._connected) {
+                    WKLogger.warn('[Network] Heartbeat timeout, reconnecting...');
+                    this._onHeartbeatTimeout();
+                }
+            }, this.config.heartbeatTimeout);
+        }, this.config.heartbeatInterval);
+    }
+    _clearHeartbeat() {
+        if (this.heartbeatTimer !== null) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        this.heartbeatPending = false;
+    }
+    _onHeartbeatTimeout() {
+        this._clearHeartbeat();
+        this._connected = false;
+        // 强制关闭当前连接
+        this.ws.disconnect(4001, 'Heartbeat timeout');
+        // 拒绝所有挂起请求
+        this._rejectAllPending(new Error('Heartbeat timeout'));
+        // 触发重连
+        this._scheduleReconnect();
+    }
+    // ─── 重连 ──────────────────────────────────
+    _scheduleReconnect() {
+        if (this.explicitDisconnect)
+            return;
+        // 清除已有重连定时器
+        this._clearReconnectTimer();
+        this.reconnectAttempt++;
+        if (this.reconnectAttempt <= this.config.reconnectMaxAttempts) {
+            // 自动重试
+            const delay = this._reconnectDelay(this.reconnectAttempt);
+            WKLogger.info(`[Network] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempt}/${this.config.reconnectMaxAttempts})`);
+            WKEvent.emit(WKNetworkEventName.RECONNECTING, {
+                attempt: this.reconnectAttempt,
+                delay,
+            });
+            this.reconnectTimer = setTimeout(() => {
+                this._doConnect();
+            }, delay);
+        }
+        else {
+            // 超过最大自动重试次数 → 调用 retry handler
+            this._onReconnectExhausted();
+        }
+    }
+    /** 指数退避 delay 计算 */
+    _reconnectDelay(attempt) {
+        const delay = this.config.reconnectBaseDelay * Math.pow(2, attempt - 1);
+        return Math.min(delay, this.config.reconnectMaxDelay);
+    }
+    _onReconnectExhausted() {
+        WKLogger.warn(`[Network] Reconnect exhausted after ${this.reconnectAttempt} attempts`);
+        if (this.retryHandler) {
+            this.retryHandler(this.reconnectAttempt, 
+            // retry — 立即再试一次
+            () => {
+                WKLogger.info('[Network] Manual retry triggered by handler');
+                this.reconnectAttempt = 0; // 不重置也行，但为了指数退避从 1 开始，这里重置
+                this._scheduleReconnect();
+            }, 
+            // abort — 放弃重连
+            () => {
+                WKLogger.info('[Network] Reconnect aborted by handler');
+                this._clearReconnectTimer();
+                this.reconnectAttempt = 0;
+            });
+        }
+    }
+    _clearReconnectTimer() {
+        if (this.reconnectTimer !== null) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+    }
+    // ─── 辅助 ──────────────────────────────────
+    _rejectAllPending(reason) {
+        for (const [seq, pending] of this.pendingRequests) {
+            clearTimeout(pending.timer);
+            pending.reject(reason);
+        }
+        this.pendingRequests.clear();
+    }
+    // ─── WKSingleton ───────────────────────────
+    dispose() {
+        this.disconnect(1001, 'App shutting down');
+        this.retryHandler = null;
+        WKNetworkManager.clear();
+    }
+}
+/** 全局快捷引用 */
+export const networkManager = WKNetworkManager.get();
+//# sourceMappingURL=WKNetworkManager.js.map

package/dist/WKNetworkManager.js.map

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

package/dist/WKNetworkProtocol.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @wukong-kit/network — Protocol abstraction & JSON implementation
+ */
+import type { WKMessage, WKProtocol } from './types.js';
+export declare abstract class WKBaseProtocol implements WKProtocol {
+    abstract encode(message: WKMessage): string | ArrayBuffer;
+    abstract decode(data: string | ArrayBuffer): WKMessage;
+}
+/**
+ * 内置 JSON 序列化协议。
+ * 消息按 JSON.stringify / JSON.parse 编解码。
+ */
+export declare class WKJsonProtocol extends WKBaseProtocol {
+    encode(message: WKMessage): string;
+    decode(data: string | ArrayBuffer): WKMessage;
+    private _bufferToString;
+}
+/**
+ * 管理多种协议实现，按名称查找。
+ * 内置注册 "json" 协议。
+ */
+export declare class WKProtocolRegistry {
+    private readonly protocols;
+    constructor();
+    /** 注册自定义协议 */
+    register(name: string, protocol: WKProtocol): void;
+    /** 获取协议 */
+    get(name: string): WKProtocol;
+    /** 是否已注册 */
+    has(name: string): boolean;
+}
+//# sourceMappingURL=WKNetworkProtocol.d.ts.map

package/dist/WKNetworkProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WKNetworkProtocol.d.ts","sourceRoot":"","sources":["../src/WKNetworkProtocol.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIxD,8BAAsB,cAAe,YAAW,UAAU;IACxD,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW;IACzD,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CACvD;AAID;;;GAGG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAChD,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM;IAIlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAY7C,OAAO,CAAC,eAAe;CAIxB;AAID;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;;IAM3D,cAAc;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI;IAOlD,WAAW;IACX,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAQ7B,YAAY;IACZ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}

package/dist/WKNetworkProtocol.js

@@ -0,0 +1,60 @@
+/**
+ * @wukong-kit/network — Protocol abstraction & JSON implementation
+ */
+// ─── 抽象基类（方便子类继承）─────────────────────
+export class WKBaseProtocol {
+}
+// ─── JSON 协议（默认实现）────────────────────────
+/**
+ * 内置 JSON 序列化协议。
+ * 消息按 JSON.stringify / JSON.parse 编解码。
+ */
+export class WKJsonProtocol extends WKBaseProtocol {
+    encode(message) {
+        return JSON.stringify(message);
+    }
+    decode(data) {
+        const text = typeof data === 'string' ? data : this._bufferToString(data);
+        const parsed = JSON.parse(text);
+        // 校验必要字段
+        if (typeof parsed.route !== 'string' || typeof parsed.seq !== 'number') {
+            throw new Error(`Invalid WKMessage: missing route or seq`);
+        }
+        return parsed;
+    }
+    _bufferToString(buf) {
+        const bytes = new Uint8Array(buf);
+        return new TextDecoder().decode(bytes);
+    }
+}
+// ─── 协议注册中心 ────────────────────────────────
+/**
+ * 管理多种协议实现，按名称查找。
+ * 内置注册 "json" 协议。
+ */
+export class WKProtocolRegistry {
+    constructor() {
+        this.protocols = new Map();
+        this.protocols.set('json', new WKJsonProtocol());
+    }
+    /** 注册自定义协议 */
+    register(name, protocol) {
+        if (this.protocols.has(name)) {
+            throw new Error(`Protocol already registered: ${name}`);
+        }
+        this.protocols.set(name, protocol);
+    }
+    /** 获取协议 */
+    get(name) {
+        const protocol = this.protocols.get(name);
+        if (!protocol) {
+            throw new Error(`Protocol not found: ${name}`);
+        }
+        return protocol;
+    }
+    /** 是否已注册 */
+    has(name) {
+        return this.protocols.has(name);
+    }
+}
+//# sourceMappingURL=WKNetworkProtocol.js.map

package/dist/WKNetworkProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WKNetworkProtocol.js","sourceRoot":"","sources":["../src/WKNetworkProtocol.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wCAAwC;AAExC,MAAM,OAAgB,cAAc;CAGnC;AAED,4CAA4C;AAE5C;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,cAAc;IAChD,MAAM,CAAC,OAAkB;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,IAA0B;QAC/B,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;QAE7C,SAAS;QACT,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,eAAe,CAAC,GAAgB;QACtC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CACF;AAED,8CAA8C;AAE9C;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAG7B;QAFiB,cAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;QAGzD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,cAAc;IACd,QAAQ,CAAC,IAAY,EAAE,QAAoB;QACzC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,WAAW;IACX,GAAG,CAAC,IAAY;QACd,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,YAAY;IACZ,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/WKNetworkQueue.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @wukong-kit/network — Offline message queue
+ *
+ * 断线时缓冲待发消息，恢复后按序重发。
+ * 每条消息可选 TTL，超过时间未发送则丢弃。
+ */
+export interface WKQueuedMessage {
+    /** 路由 */
+    route: string;
+    /** 消息体 */
+    body: unknown;
+    /** 消息序列号 */
+    seq: number;
+    /** 入队时间戳（ms） */
+    timestamp: number;
+    /** TTL（ms），超时丢弃，0 表示不过期 */
+    ttl: number;
+}
+export declare class WKNetworkQueue {
+    private queue;
+    /** 当前队列长度 */
+    get length(): number;
+    /** 是否为空 */
+    get isEmpty(): boolean;
+    push(route: string, body: unknown, seq: number, ttl?: number): void;
+    /**
+     * 取出队列中所有未过期的消息，清空队列。
+     * 过期的消息被丢弃，不计入返回结果。
+     * @returns 未过期的消息列表
+     */
+    flushAll(): WKQueuedMessage[];
+    clear(): void;
+}
+//# sourceMappingURL=WKNetworkQueue.d.ts.map

package/dist/WKNetworkQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WKNetworkQueue.d.ts","sourceRoot":"","sources":["../src/WKNetworkQueue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,SAAS;IACT,KAAK,EAAE,MAAM,CAAC;IACd,UAAU;IACV,IAAI,EAAE,OAAO,CAAC;IACd,YAAY;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAyB;IAEtC,aAAa;IACb,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,WAAW;IACX,IAAI,OAAO,IAAI,OAAO,CAErB;IAID,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,IAAI;IAY9D;;;;OAIG;IACH,QAAQ,IAAI,eAAe,EAAE;IAwB7B,KAAK,IAAI,IAAI;CAGd"}

package/dist/WKNetworkQueue.js

@@ -0,0 +1,58 @@
+/**
+ * @wukong-kit/network — Offline message queue
+ *
+ * 断线时缓冲待发消息，恢复后按序重发。
+ * 每条消息可选 TTL，超过时间未发送则丢弃。
+ */
+export class WKNetworkQueue {
+    constructor() {
+        this.queue = [];
+    }
+    /** 当前队列长度 */
+    get length() {
+        return this.queue.length;
+    }
+    /** 是否为空 */
+    get isEmpty() {
+        return this.queue.length === 0;
+    }
+    // ─── 入队 ───────────────────────────────────
+    push(route, body, seq, ttl = 0) {
+        this.queue.push({
+            route,
+            body,
+            seq,
+            timestamp: Date.now(),
+            ttl,
+        });
+    }
+    // ─── 取出全部（并清除过期消息）──────────────
+    /**
+     * 取出队列中所有未过期的消息，清空队列。
+     * 过期的消息被丢弃，不计入返回结果。
+     * @returns 未过期的消息列表
+     */
+    flushAll() {
+        const now = Date.now();
+        const valid = [];
+        const expired = [];
+        for (const msg of this.queue) {
+            if (msg.ttl > 0 && now - msg.timestamp > msg.ttl) {
+                expired.push(msg);
+            }
+            else {
+                valid.push(msg);
+            }
+        }
+        this.queue = [];
+        if (expired.length > 0) {
+            console.warn(`[WKNetworkQueue] Discarded ${expired.length} expired messages`);
+        }
+        return valid;
+    }
+    // ─── 清空 ───────────────────────────────────
+    clear() {
+        this.queue.length = 0;
+    }
+}
+//# sourceMappingURL=WKNetworkQueue.js.map

package/dist/WKNetworkQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WKNetworkQueue.js","sourceRoot":"","sources":["../src/WKNetworkQueue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,OAAO,cAAc;IAA3B;QACU,UAAK,GAAsB,EAAE,CAAC;IA0DxC,CAAC;IAxDC,aAAa;IACb,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,WAAW;IACX,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,6CAA6C;IAE7C,IAAI,CAAC,KAAa,EAAE,IAAa,EAAE,GAAW,EAAE,GAAG,GAAG,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,KAAK;YACL,IAAI;YACJ,GAAG;YACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;IAElC;;;;OAIG;IACH,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAsB,EAAE,CAAC;QACpC,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAEhB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,8BAA8B,OAAO,CAAC,MAAM,mBAAmB,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6CAA6C;IAE7C,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;CACF"}

package/dist/WKWebSocket.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @wukong-kit/network — WebSocket transport layer
+ *
+ * Thin wrapper around the native WebSocket API.
+ * Manages connection state (connected/disconnected/connecting).
+ * Does NOT handle reconnect or heartbeat — those belong in WKNetworkManager.
+ */
+import { WKNetworkStatus } from './types.js';
+import type { WKNetworkErrorPayload } from './types.js';
+export type WKWebSocketEventHandler = {
+    onOpen: () => void;
+    onClose: (code: number, reason: string) => void;
+    onMessage: (data: string | ArrayBuffer) => void;
+    onError: (payload: WKNetworkErrorPayload) => void;
+};
+export declare class WKWebSocket {
+    private ws;
+    private _status;
+    /** 当前 WebSocket URL（含 token） */
+    private _url;
+    get status(): WKNetworkStatus;
+    get url(): string;
+    connect(url: string, handlers: WKWebSocketEventHandler): void;
+    disconnect(code?: number, reason?: string): void;
+    send(data: string | ArrayBuffer): boolean;
+    private _setStatus;
+}
+//# sourceMappingURL=WKWebSocket.d.ts.map

package/dist/WKWebSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WKWebSocket.d.ts","sourceRoot":"","sources":["../src/WKWebSocket.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,KAAK,IAAI,CAAC;IAChD,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAiD;IAEhE,gCAAgC;IAChC,OAAO,CAAC,IAAI,CAAM;IAElB,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAID,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IA0C7D,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAsBhD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO;IAezC,OAAO,CAAC,UAAU;CAGnB"}

package/dist/WKWebSocket.js

@@ -0,0 +1,95 @@
+/**
+ * @wukong-kit/network — WebSocket transport layer
+ *
+ * Thin wrapper around the native WebSocket API.
+ * Manages connection state (connected/disconnected/connecting).
+ * Does NOT handle reconnect or heartbeat — those belong in WKNetworkManager.
+ */
+import { WKNetworkStatus } from './types.js';
+export class WKWebSocket {
+    constructor() {
+        this.ws = null;
+        this._status = WKNetworkStatus.DISCONNECTED;
+        /** 当前 WebSocket URL（含 token） */
+        this._url = '';
+    }
+    get status() {
+        return this._status;
+    }
+    get url() {
+        return this._url;
+    }
+    // ─── 连接 / 断开 ─────────────────────────────
+    connect(url, handlers) {
+        if (this._status === WKNetworkStatus.CONNECTING || this._status === WKNetworkStatus.CONNECTED) {
+            throw new Error(`WebSocket already ${this._status}`);
+        }
+        this._url = url;
+        this._setStatus(WKNetworkStatus.CONNECTING);
+        try {
+            this.ws = new WebSocket(url);
+        }
+        catch (err) {
+            this._setStatus(WKNetworkStatus.DISCONNECTED);
+            handlers.onError({
+                message: `Failed to create WebSocket: ${err.message}`,
+            });
+            return;
+        }
+        this.ws.binaryType = 'arraybuffer';
+        this.ws.onopen = () => {
+            this._setStatus(WKNetworkStatus.CONNECTED);
+            handlers.onOpen();
+        };
+        this.ws.onclose = (event) => {
+            this._setStatus(WKNetworkStatus.DISCONNECTED);
+            handlers.onClose(event.code, event.reason);
+        };
+        this.ws.onmessage = (event) => {
+            handlers.onMessage(event.data);
+        };
+        this.ws.onerror = () => {
+            // onerror 之后通常会触发 onclose，所以这里只抛事件、不改变状态
+            handlers.onError({
+                message: 'WebSocket error occurred',
+            });
+        };
+    }
+    disconnect(code, reason) {
+        if (!this.ws || this._status === WKNetworkStatus.DISCONNECTED)
+            return;
+        this._setStatus(WKNetworkStatus.DISCONNECTING);
+        // 移除事件监听，避免 disconnect 触发的 onclose 被外部处理
+        const ws = this.ws;
+        ws.onclose = null;
+        ws.onerror = null;
+        ws.onmessage = null;
+        ws.onopen = null;
+        try {
+            ws.close(code ?? 1000, reason ?? 'Client closed');
+        }
+        catch {
+            // ignore
+        }
+        this.ws = null;
+        this._setStatus(WKNetworkStatus.DISCONNECTED);
+    }
+    // ─── 发送 ───────────────────────────────────
+    send(data) {
+        if (this._status !== WKNetworkStatus.CONNECTED || !this.ws) {
+            return false;
+        }
+        try {
+            this.ws.send(data);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ─── 状态管理 ───────────────────────────────
+    _setStatus(status) {
+        this._status = status;
+    }
+}
+//# sourceMappingURL=WKWebSocket.js.map

package/dist/WKWebSocket.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @wukong-kit/network
+ *
+ * WebSocket-based network layer for Wukong Kit.
+ *
+ * ## 快速开始
+ *
+ * ```ts
+ * import { WKNetworkManager, networkManager } from '@wukong-kit/network';
+ * import { App } from '@wukong-kit/core';
+ *
+ * // 配置
+ * networkManager.setConfig({
+ *   serverUrl: 'wss://game.example.com/ws',
+ *   authToken: 'jwt-token-here',
+ * });
+ *
+ * // 注册重试回调（3次自动失败后弹窗询问）
+ * networkManager.setRetryHandler((attempts, retry, abort) => {
+ *   // 显示确认框，玩家点击 "重试" 调用 retry()，"取消" 调用 abort()
+ *   retry();
+ * });
+ *
+ * // 启动 App
+ * App.start({ name: 'MyGame' });
+ *
+ * // 连接服务器
+ * networkManager.connect();
+ *
+ * // 请求-应答
+ * const playerData = await networkManager.request('player.login', { uid: 1 });
+ *
+ * // 发送（不等待）
+ * networkManager.send('player.move', { x: 10, y: 20 });
+ * ```
+ */
+export { WKNetworkManager, networkManager } from './WKNetworkManager.js';
+export { WKWebSocket } from './WKWebSocket.js';
+export type { WKWebSocketEventHandler } from './WKWebSocket.js';
+export { WKNetworkQueue } from './WKNetworkQueue.js';
+export type { WKQueuedMessage } from './WKNetworkQueue.js';
+export { WKBaseProtocol, WKJsonProtocol, WKProtocolRegistry, } from './WKNetworkProtocol.js';
+export { WKNetworkStatus, WKNetworkEventName, } from './types.js';
+export type { WKNetworkConfig, WKMessage, WKProtocol, WKRetryHandler, WKNetworkConnectedPayload, WKNetworkDisconnectedPayload, WKNetworkReconnectingPayload, WKNetworkErrorPayload, } from './types.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,SAAS,EACT,UAAU,EACV,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,42 @@
+/**
+ * @wukong-kit/network
+ *
+ * WebSocket-based network layer for Wukong Kit.
+ *
+ * ## 快速开始
+ *
+ * ```ts
+ * import { WKNetworkManager, networkManager } from '@wukong-kit/network';
+ * import { App } from '@wukong-kit/core';
+ *
+ * // 配置
+ * networkManager.setConfig({
+ *   serverUrl: 'wss://game.example.com/ws',
+ *   authToken: 'jwt-token-here',
+ * });
+ *
+ * // 注册重试回调（3次自动失败后弹窗询问）
+ * networkManager.setRetryHandler((attempts, retry, abort) => {
+ *   // 显示确认框，玩家点击 "重试" 调用 retry()，"取消" 调用 abort()
+ *   retry();
+ * });
+ *
+ * // 启动 App
+ * App.start({ name: 'MyGame' });
+ *
+ * // 连接服务器
+ * networkManager.connect();
+ *
+ * // 请求-应答
+ * const playerData = await networkManager.request('player.login', { uid: 1 });
+ *
+ * // 发送（不等待）
+ * networkManager.send('player.move', { x: 10, y: 20 });
+ * ```
+ */
+export { WKNetworkManager, networkManager } from './WKNetworkManager.js';
+export { WKWebSocket } from './WKWebSocket.js';
+export { WKNetworkQueue } from './WKNetworkQueue.js';
+export { WKBaseProtocol, WKJsonProtocol, WKProtocolRegistry, } from './WKNetworkProtocol.js';
+export { WKNetworkStatus, WKNetworkEventName, } from './types.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @wukong-kit/network — Type definitions
+ */
+export declare enum WKNetworkStatus {
+    DISCONNECTED = "disconnected",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    DISCONNECTING = "disconnecting"
+}
+export interface WKMessage {
+    /** 路由，e.g. "player.login" */
+    route: string;
+    /** 递增序列号，用于请求-应答匹配 */
+    seq: number;
+    /** 业务荷载 */
+    body: unknown;
+    /** 时间戳（ms） */
+    timestamp: number;
+    /** 是否需要 ACK / 是否应答消息 */
+    ack: boolean;
+    /** [应答专用] 对应请求的 seq */
+    ackSeq?: number;
+}
+export interface WKNetworkConfig {
+    /** WebSocket 服务器地址，e.g. "wss://game.example.com/ws" */
+    serverUrl: string;
+    /** 鉴权 token，自动拼接到 serverUrl 的 query 参数 ?token=xxx */
+    authToken?: string;
+    /** 请求超时时间（ms），默认 30000 */
+    defaultTimeout?: number;
+    /** 心跳间隔（ms），默认 10000 */
+    heartbeatInterval?: number;
+    /** 心跳超时时间（ms），默认 5000 */
+    heartbeatTimeout?: number;
+    /** 最大自动重联次数，默认 3，之后触发 retryHandler */
+    reconnectMaxAttempts?: number;
+    /** 重连基础间隔（ms），默认 1000，指数退避 */
+    reconnectBaseDelay?: number;
+    /** 重连最大间隔（ms），默认 30000 */
+    reconnectMaxDelay?: number;
+}
+export interface WKProtocol {
+    /** 消息编码 → 可发送数据 */
+    encode(message: WKMessage): string | ArrayBuffer;
+    /** 接收数据解码 → 消息 */
+    decode(data: string | ArrayBuffer): WKMessage;
+}
+/**
+ * 自动重连全部失败后调用。
+ * @param attempts  已失败次数（从 3 开始计数）
+ * @param retry     调用则立即再试一次
+ * @param abort     放弃重连
+ */
+export type WKRetryHandler = (attempts: number, retry: () => void, abort: () => void) => void;
+export declare const WKNetworkEventName: {
+    /** 连接已建立 */
+    readonly CONNECTED: "wk:net:connected";
+    /** 连接已断开 */
+    readonly DISCONNECTED: "wk:net:disconnected";
+    /** 正在重连 */
+    readonly RECONNECTING: "wk:net:reconnecting";
+    /** 收到推送消息，payload: WKMessage */
+    readonly PUSH: "wk:net:push";
+    /** 网络错误 */
+    readonly ERROR: "wk:net:error";
+};
+/** 挂起的请求，用于 request/response 匹配 */
+export interface PendingRequest {
+    route: string;
+    resolve: (data: unknown) => void;
+    reject: (reason: Error) => void;
+    timer: ReturnType<typeof setTimeout>;
+}
+export interface WKNetworkConnectedPayload {
+    url: string;
+}
+export interface WKNetworkDisconnectedPayload {
+    code: number;
+    reason: string;
+    wasConnected: boolean;
+}
+export interface WKNetworkReconnectingPayload {
+    attempt: number;
+    delay: number;
+}
+export interface WKNetworkErrorPayload {
+    message: string;
+    code?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,oBAAY,eAAe;IACzB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,aAAa,kBAAkB;CAChC;AAID,MAAM,WAAW,SAAS;IACxB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,IAAI,EAAE,OAAO,CAAC;IACd,cAAc;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,8BAA8B;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0BAA0B;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,MAAM,WAAW,UAAU;IACzB,mBAAmB;IACnB,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IACjD,kBAAkB;IAClB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;CAC/C;AAID;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,IAAI,EACjB,KAAK,EAAE,MAAM,IAAI,KACd,IAAI,CAAC;AAIV,eAAO,MAAM,kBAAkB;IAC7B,YAAY;;IAEZ,YAAY;;IAEZ,WAAW;;IAEX,gCAAgC;;IAEhC,WAAW;;CAEH,CAAC;AAIX,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,MAAM,EAAE,CAAC,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CACtC;AAID,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,25 @@
+/**
+ * @wukong-kit/network — Type definitions
+ */
+// ─── 网络状态 ────────────────────────────────────────
+export var WKNetworkStatus;
+(function (WKNetworkStatus) {
+    WKNetworkStatus["DISCONNECTED"] = "disconnected";
+    WKNetworkStatus["CONNECTING"] = "connecting";
+    WKNetworkStatus["CONNECTED"] = "connected";
+    WKNetworkStatus["DISCONNECTING"] = "disconnecting";
+})(WKNetworkStatus || (WKNetworkStatus = {}));
+// ─── 网络事件名 ─────────────────────────────────────
+export const WKNetworkEventName = {
+    /** 连接已建立 */
+    CONNECTED: 'wk:net:connected',
+    /** 连接已断开 */
+    DISCONNECTED: 'wk:net:disconnected',
+    /** 正在重连 */
+    RECONNECTING: 'wk:net:reconnecting',
+    /** 收到推送消息，payload: WKMessage */
+    PUSH: 'wk:net:push',
+    /** 网络错误 */
+    ERROR: 'wk:net:error',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oDAAoD;AAEpD,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,gDAA6B,CAAA;IAC7B,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,kDAA+B,CAAA;AACjC,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AA+DD,kDAAkD;AAElD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,YAAY;IACZ,SAAS,EAAE,kBAAkB;IAC7B,YAAY;IACZ,YAAY,EAAE,qBAAqB;IACnC,WAAW;IACX,YAAY,EAAE,qBAAqB;IACnC,gCAAgC;IAChC,IAAI,EAAE,aAAa;IACnB,WAAW;IACX,KAAK,EAAE,cAAc;CACb,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@wukong-kit/network",
+  "version": "0.1.0",
+  "description": "WebSocket-based network layer for Wukong Kit with JSON protocol, auto-reconnect, and request/response pattern.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "dependencies": {
+    "@wukong-kit/core": "^0.1.0",
+    "wukongtest": "file:../.."
+  },
+  "devDependencies": {
+    "@cocos/creator-types": "^3.8.3",
+    "@types/node": "^25.8.0",
+    "typescript": "^5.0.0"
+  },
+  "license": "MIT"
+}