@mt0926/node-network-devtools 0.1.0

package/dist/esm/gui/server.js

@@ -0,0 +1,227 @@
+/**
+ * GUI Server 模块
+ *
+ * 提供 HTTP 静态文件服务和 WebSocket 实时通信
+ */
+import { createServer } from 'node:http';
+import { readFile, stat } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+import { getConfig } from '../config.js';
+import { getAvailablePort } from './port-utils.js';
+import { getWebSocketHub } from './websocket-hub.js';
+import { getEventBridge } from './event-bridge.js';
+// 获取当前模块目录
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * MIME 类型映射
+ */
+const MIME_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.eot': 'application/vnd.ms-fontobject',
+};
+/**
+ * GUI Server 实现
+ */
+class GUIServerImpl {
+    server = null;
+    wsHub;
+    eventBridge;
+    guiPort = null;
+    wsPort = null;
+    host;
+    staticDir;
+    constructor(wsHub, eventBridge, host = '127.0.0.1') {
+        this.wsHub = wsHub ?? getWebSocketHub();
+        this.eventBridge = eventBridge ?? getEventBridge();
+        this.host = host;
+        // 静态文件目录：dist/gui（构建后的前端文件）
+        // __dirname 在 ESM 中指向 dist/esm/gui，所以需要 ../../gui
+        this.staticDir = join(__dirname, '../../gui');
+    }
+    /**
+     * 启动 GUI 服务器
+     */
+    async start(options) {
+        if (this.server) {
+            throw new Error('GUI Server 已经在运行');
+        }
+        const config = getConfig();
+        // 使用传入的选项或配置中的值
+        const guiPortConfig = options?.guiPort ?? config.guiPort;
+        const wsPortConfig = options?.wsPort ?? config.wsPort;
+        const hostConfig = options?.host ?? config.guiHost;
+        // 更新 host
+        this.host = hostConfig;
+        // 获取可用端口
+        this.guiPort = await getAvailablePort(guiPortConfig, this.host);
+        this.wsPort = await getAvailablePort(wsPortConfig, this.host);
+        // 启动 WebSocket Hub
+        await this.wsHub.start(this.wsPort, this.host);
+        // 启动 Event Bridge
+        this.eventBridge.start();
+        // 创建 HTTP 服务器
+        this.server = createServer((req, res) => {
+            this.handleRequest(req, res);
+        });
+        // 启动 HTTP 服务器
+        await new Promise((resolve, reject) => {
+            this.server.once('error', reject);
+            this.server.listen(this.guiPort, this.host, () => {
+                resolve();
+            });
+        });
+        const url = this.getUrl();
+        console.log(`[node-network-devtools] GUI 服务器已启动: ${url}`);
+        return {
+            guiPort: this.guiPort,
+            wsPort: this.wsPort,
+            url,
+        };
+    }
+    /**
+     * 处理 HTTP 请求
+     */
+    async handleRequest(req, res) {
+        const url = new URL(req.url || '/', `http://${this.host}:${this.guiPort}`);
+        let pathname = url.pathname;
+        console.log(`[GUI Server] 请求: ${pathname}, 静态目录: ${this.staticDir}`);
+        // 默认路径指向 index.html
+        if (pathname === '/') {
+            pathname = '/index.html';
+        }
+        // 构建文件路径
+        const filePath = join(this.staticDir, pathname);
+        console.log(`[GUI Server] 文件路径: ${filePath}`);
+        try {
+            // 检查文件是否存在
+            const fileStat = await stat(filePath);
+            if (!fileStat.isFile()) {
+                // 如果不是文件，尝试返回 index.html（SPA 路由支持）
+                await this.serveFile(join(this.staticDir, 'index.html'), res);
+                return;
+            }
+            await this.serveFile(filePath, res);
+        }
+        catch (err) {
+            console.log(`[GUI Server] 文件不存在: ${filePath}, 错误:`, err);
+            // 文件不存在，尝试返回 index.html（SPA 路由支持）
+            try {
+                await this.serveFile(join(this.staticDir, 'index.html'), res);
+            }
+            catch (indexErr) {
+                console.log(`[GUI Server] index.html 也不存在:`, indexErr);
+                this.sendError(res, 404, 'Not Found');
+            }
+        }
+    }
+    /**
+     * 提供静态文件
+     */
+    async serveFile(filePath, res) {
+        const ext = extname(filePath).toLowerCase();
+        const contentType = MIME_TYPES[ext] || 'application/octet-stream';
+        const content = await readFile(filePath);
+        res.writeHead(200, {
+            'Content-Type': contentType,
+            'Content-Length': content.length,
+            'Cache-Control': 'no-cache',
+        });
+        res.end(content);
+    }
+    /**
+     * 发送错误响应
+     */
+    sendError(res, statusCode, message) {
+        res.writeHead(statusCode, { 'Content-Type': 'text/plain; charset=utf-8' });
+        res.end(message);
+    }
+    /**
+     * 停止 GUI 服务器
+     */
+    async stop() {
+        // 停止 Event Bridge
+        this.eventBridge.stop();
+        // 停止 WebSocket Hub
+        await this.wsHub.stop();
+        // 停止 HTTP 服务器
+        if (this.server) {
+            await new Promise((resolve) => {
+                this.server.close(() => {
+                    resolve();
+                });
+            });
+            this.server = null;
+        }
+        this.guiPort = null;
+        this.wsPort = null;
+    }
+    /**
+     * 检查是否正在运行
+     */
+    isRunning() {
+        return this.server !== null;
+    }
+    /**
+     * 获取 GUI URL
+     */
+    getUrl() {
+        if (!this.guiPort || !this.wsPort)
+            return null;
+        return `http://${this.host}:${this.guiPort}?wsPort=${this.wsPort}`;
+    }
+    /**
+     * 获取 GUI 端口
+     */
+    getGuiPort() {
+        return this.guiPort;
+    }
+    /**
+     * 获取 WebSocket 端口
+     */
+    getWsPort() {
+        return this.wsPort;
+    }
+}
+// 全局单例
+let globalServer = null;
+/**
+ * 获取全局 GUI Server 实例
+ */
+export function getGUIServer() {
+    if (!globalServer) {
+        globalServer = new GUIServerImpl();
+    }
+    return globalServer;
+}
+/**
+ * 重置全局 GUI Server（用于测试）
+ */
+export async function resetGUIServer() {
+    if (globalServer) {
+        await globalServer.stop();
+    }
+    globalServer = null;
+}
+/**
+ * 创建新的 GUI Server 实例（用于测试）
+ */
+export function createGUIServer(wsHub, eventBridge, host) {
+    return new GUIServerImpl(wsHub, eventBridge, host);
+}
+//# sourceMappingURL=server.js.map

package/dist/esm/gui/server.js.map

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

package/dist/esm/gui/websocket-hub.js

@@ -0,0 +1,326 @@
+/**
+ * WebSocket Hub 模块
+ *
+ * 管理 WebSocket 客户端连接，广播消息到所有连接的客户端
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+import { nanoid } from 'nanoid';
+/**
+ * WebSocket Hub 实现
+ */
+class WebSocketHubImpl {
+    wss = null;
+    clients = new Map();
+    port = null;
+    // 事件回调
+    connectCallbacks = [];
+    disconnectCallbacks = [];
+    messageCallbacks = [];
+    /**
+     * 启动 WebSocket 服务器
+     */
+    async start(port, host = '127.0.0.1') {
+        if (this.wss) {
+            throw new Error('WebSocket Hub 已经在运行');
+        }
+        return new Promise((resolve, reject) => {
+            this.wss = new WebSocketServer({ port, host });
+            this.wss.on('listening', () => {
+                const address = this.wss?.address();
+                if (address && typeof address === 'object') {
+                    this.port = address.port;
+                    resolve(this.port);
+                }
+                else {
+                    reject(new Error('无法获取 WebSocket 端口'));
+                }
+            });
+            this.wss.on('error', (err) => {
+                reject(err);
+            });
+            this.wss.on('connection', (ws) => {
+                this.handleConnection(ws);
+            });
+        });
+    }
+    /**
+     * 处理新连接
+     */
+    handleConnection(ws) {
+        const clientId = nanoid();
+        const clientInfo = {
+            id: clientId,
+            ws,
+            connectedAt: Date.now(),
+        };
+        this.clients.set(clientId, clientInfo);
+        // 触发连接回调
+        for (const callback of this.connectCallbacks) {
+            try {
+                callback(clientId);
+            }
+            catch {
+                // 忽略回调错误
+            }
+        }
+        // 处理消息
+        ws.on('message', (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                for (const callback of this.messageCallbacks) {
+                    try {
+                        callback(clientId, message);
+                    }
+                    catch {
+                        // 忽略回调错误
+                    }
+                }
+            }
+            catch {
+                // 忽略解析错误
+            }
+        });
+        // 处理断开连接
+        ws.on('close', () => {
+            this.clients.delete(clientId);
+            for (const callback of this.disconnectCallbacks) {
+                try {
+                    callback(clientId);
+                }
+                catch {
+                    // 忽略回调错误
+                }
+            }
+        });
+        // 处理错误
+        ws.on('error', () => {
+            // 错误时也移除客户端
+            if (this.clients.has(clientId)) {
+                this.clients.delete(clientId);
+                for (const callback of this.disconnectCallbacks) {
+                    try {
+                        callback(clientId);
+                    }
+                    catch {
+                        // 忽略回调错误
+                    }
+                }
+            }
+        });
+    }
+    /**
+     * 停止 WebSocket 服务器
+     */
+    async stop() {
+        if (!this.wss)
+            return;
+        return new Promise((resolve) => {
+            // 关闭所有客户端连接
+            for (const client of this.clients.values()) {
+                try {
+                    client.ws.close();
+                }
+                catch {
+                    // 忽略关闭错误
+                }
+            }
+            this.clients.clear();
+            // 关闭服务器
+            this.wss?.close(() => {
+                this.wss = null;
+                this.port = null;
+                resolve();
+            });
+        });
+    }
+    /**
+     * 广播消息到所有客户端
+     */
+    broadcast(message) {
+        const data = JSON.stringify(message);
+        for (const client of this.clients.values()) {
+            if (client.ws.readyState === WebSocket.OPEN) {
+                try {
+                    client.ws.send(data);
+                }
+                catch {
+                    // 忽略发送错误
+                }
+            }
+        }
+    }
+    /**
+     * 发送消息到指定客户端
+     */
+    send(clientId, message) {
+        const client = this.clients.get(clientId);
+        if (!client)
+            return;
+        if (client.ws.readyState === WebSocket.OPEN) {
+            const data = JSON.stringify(message);
+            try {
+                client.ws.send(data);
+            }
+            catch {
+                // 忽略发送错误
+            }
+        }
+    }
+    /**
+     * 获取连接的客户端数量
+     */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /**
+     * 获取所有客户端 ID
+     */
+    getClientIds() {
+        return Array.from(this.clients.keys());
+    }
+    /**
+     * 检查是否正在运行
+     */
+    isRunning() {
+        return this.wss !== null;
+    }
+    /**
+     * 获取端口号
+     */
+    getPort() {
+        return this.port;
+    }
+    /**
+     * 注册客户端连接回调
+     */
+    onClientConnect(callback) {
+        this.connectCallbacks.push(callback);
+    }
+    /**
+     * 注册客户端断开回调
+     */
+    onClientDisconnect(callback) {
+        this.disconnectCallbacks.push(callback);
+    }
+    /**
+     * 注册客户端消息回调
+     */
+    onClientMessage(callback) {
+        this.messageCallbacks.push(callback);
+    }
+}
+// 全局单例
+let globalHub = null;
+/**
+ * 获取全局 WebSocket Hub 实例
+ */
+export function getWebSocketHub() {
+    if (!globalHub) {
+        globalHub = new WebSocketHubImpl();
+    }
+    return globalHub;
+}
+/**
+ * 重置全局 WebSocket Hub（用于测试）
+ */
+export async function resetWebSocketHub() {
+    if (globalHub) {
+        await globalHub.stop();
+    }
+    globalHub = null;
+}
+/**
+ * 创建新的 WebSocket Hub 实例（用于测试）
+ */
+export function createWebSocketHub() {
+    return new WebSocketHubImpl();
+}
+/**
+ * 创建请求开始消息
+ */
+export function createRequestStartMessage(request) {
+    return {
+        type: 'request:start',
+        payload: {
+            id: request.id,
+            url: request.url,
+            method: request.method,
+            headers: request.headers,
+            body: request.body ? (Buffer.isBuffer(request.body) ? request.body.toString('utf-8') : request.body) : undefined,
+            timestamp: request.timestamp,
+            traceId: request.traceId,
+            stackTrace: request.stackTrace,
+        },
+        timestamp: Date.now(),
+    };
+}
+/**
+ * 创建请求完成消息
+ */
+export function createRequestCompleteMessage(requestId, response) {
+    return {
+        type: 'request:complete',
+        payload: {
+            id: requestId,
+            statusCode: response.statusCode,
+            statusMessage: response.statusMessage,
+            headers: response.headers,
+            body: response.body ? (Buffer.isBuffer(response.body) ? response.body.toString('utf-8') : response.body) : undefined,
+            bodyTruncated: response.bodyTruncated,
+        },
+        timestamp: Date.now(),
+    };
+}
+/**
+ * 创建请求错误消息
+ */
+export function createRequestErrorMessage(requestId, error) {
+    return {
+        type: 'request:error',
+        payload: {
+            id: requestId,
+            code: error.code,
+            message: error.message,
+        },
+        timestamp: Date.now(),
+    };
+}
+/**
+ * 创建初始数据消息
+ */
+export function createInitialDataMessage(requests) {
+    return {
+        type: 'requests:initial',
+        payload: requests.map(req => ({
+            id: req.id,
+            url: req.url,
+            method: req.method,
+            headers: req.headers,
+            body: req.body ? (Buffer.isBuffer(req.body) ? req.body.toString('utf-8') : req.body) : undefined,
+            timestamp: req.timestamp,
+            traceId: req.traceId,
+            stackTrace: req.stackTrace,
+            response: req.response ? {
+                statusCode: req.response.statusCode,
+                statusMessage: req.response.statusMessage,
+                headers: req.response.headers,
+                body: req.response.body ? (Buffer.isBuffer(req.response.body) ? req.response.body.toString('utf-8') : req.response.body) : undefined,
+                bodyTruncated: req.response.bodyTruncated,
+            } : undefined,
+            error: req.error,
+            timing: req.timing,
+        })),
+        timestamp: Date.now(),
+    };
+}
+/**
+ * 创建清空请求消息
+ */
+export function createClearMessage() {
+    return {
+        type: 'requests:clear',
+        payload: null,
+        timestamp: Date.now(),
+    };
+}
+//# sourceMappingURL=websocket-hub.js.map

package/dist/esm/gui/websocket-hub.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,90 @@
+/**
+ * Node Network DevTools
+ *
+ * Node.js 网络请求监听工具，桥接到 Chrome DevTools Network 面板
+ */
+// 配置模块
+export { getConfig, setConfig, resetConfig } from './config.js';
+// 请求存储
+export { getRequestStore, resetRequestStore, createRequestStore, } from './store/ring-buffer.js';
+// 上下文管理
+export { generateTraceId, getCurrentTraceId, getCurrentContext, startTrace, runWithContext, runWithTrace, runWithTraceAsync, updateContextMetadata, getTraceDuration, createTraceIdGetter, ContextManager, } from './context/context-manager.js';
+// HTTP 拦截器
+export { HttpPatcher } from './interceptors/http-patcher.js';
+// Undici/Fetch 拦截器
+export { UndiciPatcher } from './interceptors/undici-patcher.js';
+// CDP 桥接
+export { getCDPBridge, resetCDPBridge, createCDPBridge, isInspectorEnabled, getInspectorUrl, } from './cdp/cdp-bridge.js';
+// Next.js 适配器
+export { NextJsAdapter, isNextJsEnvironment, getCurrentRoute, runWithRoute, runWithRouteAsync, extractNextJsOptions, extractNextJsMetadata, createInstrumentationConfig, } from './adapters/nextjs.js';
+// GUI 服务器
+export { getGUIServer, resetGUIServer, createGUIServer, } from './gui/server.js';
+// WebSocket Hub
+export { getWebSocketHub, resetWebSocketHub, createWebSocketHub, createRequestStartMessage, createRequestCompleteMessage, createRequestErrorMessage, createInitialDataMessage, createClearMessage, } from './gui/websocket-hub.js';
+// Event Bridge
+export { getEventBridge, resetEventBridge, createEventBridge, } from './gui/event-bridge.js';
+// 浏览器启动器
+export { openBrowser, closeBrowser, } from './gui/browser-launcher.js';
+// 端口工具
+export { getAvailablePort, isPortAvailable, } from './gui/port-utils.js';
+/**
+ * 快速初始化函数
+ *
+ * 一键安装所有拦截器并连接 CDP Bridge
+ */
+export async function install() {
+    const { getConfig } = await import('./config.js');
+    const { HttpPatcher } = await import('./interceptors/http-patcher.js');
+    const { UndiciPatcher } = await import('./interceptors/undici-patcher.js');
+    const { getCDPBridge } = await import('./cdp/cdp-bridge.js');
+    const config = getConfig();
+    if (config.interceptHttp) {
+        HttpPatcher.install();
+    }
+    if (config.interceptUndici) {
+        UndiciPatcher.install();
+    }
+    if (config.autoConnect) {
+        const bridge = getCDPBridge();
+        await bridge.connect();
+    }
+}
+/**
+ * 启动 GUI 服务器
+ *
+ * @param options - GUI 服务器配置
+ * @returns GUI 服务器信息
+ */
+export async function startGUI(options) {
+    const { getGUIServer } = await import('./gui/server.js');
+    const { getEventBridge } = await import('./gui/event-bridge.js');
+    const { openBrowser } = await import('./gui/browser-launcher.js');
+    const guiServer = getGUIServer();
+    const result = await guiServer.start({
+        guiPort: options?.guiPort ?? 'auto',
+        wsPort: options?.wsPort ?? 'auto',
+        host: options?.host ?? '127.0.0.1',
+    });
+    // 启动 Event Bridge
+    const eventBridge = getEventBridge();
+    eventBridge.start();
+    // 自动打开浏览器
+    if (options?.autoOpen !== false) {
+        await openBrowser(result.url);
+    }
+    return result;
+}
+/**
+ * 停止 GUI 服务器
+ */
+export async function stopGUI() {
+    const { getGUIServer } = await import('./gui/server.js');
+    const { getEventBridge } = await import('./gui/event-bridge.js');
+    const { closeBrowser } = await import('./gui/browser-launcher.js');
+    const eventBridge = getEventBridge();
+    eventBridge.stop();
+    const guiServer = getGUIServer();
+    await guiServer.stop();
+    await closeBrowser();
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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