@mt0926/node-network-devtools 0.1.0

package/dist/types/cdp/cdp-bridge.d.ts

@@ -0,0 +1,86 @@
+/**
+ * CDP 桥接模块
+ *
+ * 将请求数据转换为 CDP Network 事件并发送到 Chrome DevTools
+ *
+ * 注意：Network 事件广播功能需要：
+ * 1. Node.js 20.18.0+ 版本
+ * 2. --experimental-network-inspection 标志
+ * 3. Chrome DevTools 目前还不支持显示这些事件（功能请求待实现）
+ *
+ * 当前实现会将事件发送到控制台作为备选方案
+ */
+import type { RequestData, ResponseData, ErrorData, TimingData } from '../store/ring-buffer.js';
+/**
+ * CDP 堆栈帧
+ */
+export interface CDPCallFrame {
+    functionName: string;
+    scriptId: string;
+    url: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+/**
+ * CDP 堆栈追踪
+ */
+export interface CDPStackTrace {
+    callFrames: CDPCallFrame[];
+}
+/**
+ * CDP 请求对象
+ */
+export interface CDPRequest {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    postData?: string;
+    hasPostData?: boolean;
+}
+/**
+ * CDP 响应对象
+ */
+export interface CDPResponse {
+    url: string;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    mimeType: string;
+    connectionReused: boolean;
+    connectionId: number;
+    encodedDataLength: number;
+    securityState: string;
+}
+/**
+ * CDP Bridge 接口
+ */
+export interface ICDPBridge {
+    connect(): Promise<void>;
+    disconnect(): void;
+    isConnected(): boolean;
+    emitRequestWillBeSent(request: RequestData): void;
+    emitResponseReceived(requestId: string, request: RequestData, response: ResponseData): void;
+    emitLoadingFinished(requestId: string, timing?: TimingData): void;
+    emitLoadingFailed(requestId: string, error: ErrorData): void;
+}
+/**
+ * 获取全局 CDP Bridge 实例
+ */
+export declare function getCDPBridge(): ICDPBridge;
+/**
+ * 重置全局 CDP Bridge（用于测试）
+ */
+export declare function resetCDPBridge(): void;
+/**
+ * 创建新的 CDP Bridge 实例（用于测试）
+ */
+export declare function createCDPBridge(): ICDPBridge;
+/**
+ * 检查 Inspector 是否已启用
+ */
+export declare function isInspectorEnabled(): boolean;
+/**
+ * 获取 Inspector URL
+ */
+export declare function getInspectorUrl(): string | undefined;
+//# sourceMappingURL=cdp-bridge.d.ts.map

package/dist/types/cdp/cdp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-bridge.d.ts","sourceRoot":"","sources":["../../../src/cdp/cdp-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKhG;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,IAAI,CAAC;IACnB,WAAW,IAAI,OAAO,CAAC;IACvB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAClD,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5F,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAClE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9D;AAgRD;;GAEG;AACH,wBAAgB,YAAY,IAAI,UAAU,CAKzC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAM5C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAMpD"}

package/dist/types/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * CLI 入口
+ *
+ * 使用方式：npx node-network-devtools your-script.js [args...]
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/types/config.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 配置管理模块
+ *
+ * 支持通过环境变量和编程方式配置工具行为
+ */
+/**
+ * 工具配置接口
+ */
+export interface Config {
+    /** 最大存储请求数量，默认 1000 */
+    maxRequests: number;
+    /** 最大 body 大小（字节），默认 1MB */
+    maxBodySize: number;
+    /** 是否拦截 http/https 模块，默认 true */
+    interceptHttp: boolean;
+    /** 是否拦截 undici/fetch，默认 true */
+    interceptUndici: boolean;
+    /** 忽略的 URL 模式 */
+    ignoreUrls: RegExp[];
+    /** 要脱敏的请求头，默认 ['authorization', 'cookie'] */
+    redactHeaders: string[];
+    /** 是否禁用 body 捕获，默认 false */
+    disableBodyCapture: boolean;
+    /** 是否自动连接 inspector，默认 true */
+    autoConnect: boolean;
+    /** 指定 inspector 端口 */
+    inspectorPort?: number;
+    /** 是否启用 GUI 服务器，默认 true */
+    guiEnabled: boolean;
+    /** GUI 服务器端口，'auto' 表示自动获取可用端口 */
+    guiPort: number | 'auto';
+    /** WebSocket 端口，'auto' 表示自动获取可用端口 */
+    wsPort: number | 'auto';
+    /** GUI 服务器监听地址，默认 '127.0.0.1' */
+    guiHost: string;
+    /** 是否自动打开浏览器，默认 true */
+    autoOpen: boolean;
+    /** 是否使用 Puppeteer 打开浏览器，默认 false */
+    usePuppeteer: boolean;
+}
+/**
+ * 获取当前配置
+ */
+export declare function getConfig(): Readonly<Config>;
+/**
+ * 设置配置（合并到当前配置）
+ */
+export declare function setConfig(config: Partial<Config>): void;
+/**
+ * 重置配置为默认值
+ */
+export declare function resetConfig(): void;
+/**
+ * 获取默认配置（用于测试）
+ */
+export declare function getDefaultConfig(): Readonly<Config>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IAErB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IAGpB,iCAAiC;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,gCAAgC;IAChC,eAAe,EAAE,OAAO,CAAC;IAGzB,iBAAiB;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IAGrB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,4BAA4B;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAG5B,+BAA+B;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,2BAA2B;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,qCAAqC;IACrC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,YAAY,EAAE,OAAO,CAAC;CACvB;AA4GD;;GAEG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC,CAE5C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAKvD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAAC,MAAM,CAAC,CAEnD"}

package/dist/types/context/context-manager.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 上下文管理器
+ *
+ * 使用 AsyncLocalStorage 实现请求追踪上下文
+ * 支持跨异步边界传递 TraceID
+ */
+/**
+ * 追踪上下文接口
+ */
+export interface TraceContext {
+    /** 追踪 ID */
+    traceId: string;
+    /** 父追踪 ID（用于嵌套追踪） */
+    parentTraceId?: string;
+    /** 上下文创建时间 */
+    startTime: number;
+    /** 自定义元数据 */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 生成唯一的 TraceID
+ */
+export declare function generateTraceId(): string;
+/**
+ * 获取当前追踪上下文
+ */
+export declare function getCurrentContext(): TraceContext | undefined;
+/**
+ * 获取当前 TraceID
+ */
+export declare function getCurrentTraceId(): string | undefined;
+/**
+ * 开始新的追踪
+ *
+ * @param traceId 可选的 TraceID，不提供则自动生成
+ * @param metadata 可选的元数据
+ * @returns 新的追踪上下文
+ */
+export declare function startTrace(traceId?: string, metadata?: Record<string, unknown>): TraceContext;
+/**
+ * 在追踪上下文中运行函数
+ *
+ * @param context 追踪上下文
+ * @param fn 要运行的函数
+ * @returns 函数的返回值
+ */
+export declare function runWithContext<T>(context: TraceContext, fn: () => T): T;
+/**
+ * 在新的追踪上下文中运行函数
+ *
+ * @param fn 要运行的函数
+ * @param traceId 可选的 TraceID
+ * @param metadata 可选的元数据
+ * @returns 函数的返回值
+ */
+export declare function runWithTrace<T>(fn: () => T, traceId?: string, metadata?: Record<string, unknown>): T;
+/**
+ * 在新的追踪上下文中运行异步函数
+ *
+ * @param fn 要运行的异步函数
+ * @param traceId 可选的 TraceID
+ * @param metadata 可选的元数据
+ * @returns Promise
+ */
+export declare function runWithTraceAsync<T>(fn: () => Promise<T>, traceId?: string, metadata?: Record<string, unknown>): Promise<T>;
+/**
+ * 更新当前上下文的元数据
+ *
+ * @param metadata 要合并的元数据
+ */
+export declare function updateContextMetadata(metadata: Record<string, unknown>): void;
+/**
+ * 获取追踪持续时间（毫秒）
+ */
+export declare function getTraceDuration(): number | undefined;
+/**
+ * 创建获取当前 TraceID 的回调函数
+ * 用于传递给拦截器
+ */
+export declare function createTraceIdGetter(): () => string | undefined;
+/**
+ * ContextManager 对象
+ */
+export declare const ContextManager: {
+    generateTraceId: typeof generateTraceId;
+    getCurrentContext: typeof getCurrentContext;
+    getCurrentTraceId: typeof getCurrentTraceId;
+    startTrace: typeof startTrace;
+    runWithContext: typeof runWithContext;
+    runWithTrace: typeof runWithTrace;
+    runWithTraceAsync: typeof runWithTraceAsync;
+    updateContextMetadata: typeof updateContextMetadata;
+    getTraceDuration: typeof getTraceDuration;
+    createTraceIdGetter: typeof createTraceIdGetter;
+};
+//# sourceMappingURL=context-manager.d.ts.map

package/dist/types/context/context-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-manager.d.ts","sourceRoot":"","sources":["../../../src/context/context-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,GAAG,SAAS,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAW7F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,MAAM,CAAC,EACX,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,CAAC,CAGH;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQ7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAMrD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,MAAM,GAAG,SAAS,CAE9D;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;CAW1B,CAAC"}

package/dist/types/gui/browser-launcher.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 浏览器启动器模块
+ *
+ * 支持使用系统默认浏览器或 Puppeteer 打开 GUI
+ */
+/**
+ * 浏览器启动器配置
+ */
+export interface BrowserLauncherConfig {
+    useDefaultBrowser: boolean;
+    usePuppeteer: boolean;
+}
+/**
+ * 浏览器启动器接口
+ */
+export interface IBrowserLauncher {
+    open(url: string): Promise<void>;
+    close(): Promise<void>;
+    isOpen(): boolean;
+}
+/**
+ * 获取全局浏览器启动器实例
+ */
+export declare function getBrowserLauncher(): IBrowserLauncher;
+/**
+ * 重置全局浏览器启动器（用于测试）
+ */
+export declare function resetBrowserLauncher(): Promise<void>;
+/**
+ * 创建新的浏览器启动器实例（用于测试）
+ */
+export declare function createBrowserLauncher(): IBrowserLauncher;
+/**
+ * 构建带 WebSocket 端口参数的 GUI URL
+ */
+export declare function buildGUIUrl(host: string, guiPort: number, wsPort: number): string;
+/**
+ * 浏览器启动选项
+ */
+export interface BrowserLauncherOptions {
+    /** 是否使用 Puppeteer */
+    usePuppeteer?: boolean;
+}
+/**
+ * 打开浏览器（便捷函数）
+ */
+export declare function openBrowser(url: string, options?: BrowserLauncherOptions): Promise<void>;
+/**
+ * 关闭浏览器（便捷函数）
+ */
+export declare function closeBrowser(): Promise<void>;
+//# sourceMappingURL=browser-launcher.d.ts.map

package/dist/types/gui/browser-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-launcher.d.ts","sourceRoot":"","sources":["../../../src/gui/browser-launcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC;CACnB;AA8GD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,gBAAgB,CAKrD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CAExD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB9F;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAGlD"}

package/dist/types/gui/event-bridge.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Event Bridge 模块
+ *
+ * 连接请求拦截器和 WebSocket Hub，实现事件转发
+ * 支持暂停/恢复和清空功能
+ */
+import type { RequestData, ResponseData, ErrorData } from '../store/ring-buffer.js';
+import { type IWebSocketHub } from './websocket-hub.js';
+/**
+ * Event Bridge 接口
+ */
+export interface IEventBridge {
+    emitRequestStart(request: RequestData): void;
+    emitRequestComplete(requestId: string, response: ResponseData): void;
+    emitRequestError(requestId: string, error: ErrorData): void;
+    pause(): void;
+    resume(): void;
+    isPaused(): boolean;
+    clear(): void;
+    start(): void;
+    stop(): void;
+    isRunning(): boolean;
+}
+/**
+ * 获取全局 Event Bridge 实例
+ */
+export declare function getEventBridge(): IEventBridge;
+/**
+ * 重置全局 Event Bridge（用于测试）
+ */
+export declare function resetEventBridge(): void;
+/**
+ * 创建新的 Event Bridge 实例（用于测试）
+ */
+export declare function createEventBridge(wsHub?: IWebSocketHub): IEventBridge;
+//# sourceMappingURL=event-bridge.d.ts.map

package/dist/types/gui/event-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bridge.d.ts","sourceRoot":"","sources":["../../../src/gui/event-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,EAOL,KAAK,aAAa,EAEnB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,YAAY;IAE3B,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7C,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IACrE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAG5D,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,IAAI,OAAO,CAAC;IACpB,KAAK,IAAI,IAAI,CAAC;IAGd,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,SAAS,IAAI,OAAO,CAAC;CACtB;AAsLD;;GAEG;AACH,wBAAgB,cAAc,IAAI,YAAY,CAK7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,YAAY,CAErE"}

package/dist/types/gui/port-utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 端口工具模块
+ *
+ * 提供获取可用端口的功能
+ */
+/**
+ * 检查端口是否可用
+ */
+export declare function isPortAvailable(port: number, host?: string): Promise<boolean>;
+/**
+ * 获取可用端口
+ *
+ * @param preferredPort 首选端口，如果为 'auto' 则自动获取
+ * @param host 监听地址
+ * @param maxAttempts 最大尝试次数
+ * @returns 可用端口号
+ */
+export declare function getAvailablePort(preferredPort?: number | 'auto', host?: string, maxAttempts?: number): Promise<number>;
+/**
+ * 获取随机可用端口
+ *
+ * 通过让系统分配端口来获取可用端口
+ */
+export declare function getRandomAvailablePort(host?: string): Promise<number>;
+//# sourceMappingURL=port-utils.d.ts.map

package/dist/types/gui/port-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-utils.d.ts","sourceRoot":"","sources":["../../../src/gui/port-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB1F;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,GAAE,MAAM,GAAG,MAAe,EACvC,IAAI,GAAE,MAAoB,EAC1B,WAAW,GAAE,MAAW,GACvB,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,MAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlF"}

package/dist/types/gui/server.d.ts

@@ -0,0 +1,50 @@
+/**
+ * GUI Server 模块
+ *
+ * 提供 HTTP 静态文件服务和 WebSocket 实时通信
+ */
+import { type IWebSocketHub } from './websocket-hub.js';
+import { type IEventBridge } from './event-bridge.js';
+/**
+ * GUI 服务器配置
+ */
+export interface GUIServerConfig {
+    guiPort: number | 'auto';
+    wsPort: number | 'auto';
+    host: string;
+    enabled: boolean;
+    autoOpen: boolean;
+    usePuppeteer: boolean;
+}
+/**
+ * GUI 服务器接口
+ */
+export interface IGUIServer {
+    start(options?: {
+        guiPort?: number | 'auto';
+        wsPort?: number | 'auto';
+        host?: string;
+    }): Promise<{
+        guiPort: number;
+        wsPort: number;
+        url: string;
+    }>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    getUrl(): string | null;
+    getGuiPort(): number | null;
+    getWsPort(): number | null;
+}
+/**
+ * 获取全局 GUI Server 实例
+ */
+export declare function getGUIServer(): IGUIServer;
+/**
+ * 重置全局 GUI Server（用于测试）
+ */
+export declare function resetGUIServer(): Promise<void>;
+/**
+ * 创建新的 GUI Server 实例（用于测试）
+ */
+export declare function createGUIServer(wsHub?: IWebSocketHub, eventBridge?: IEventBridge, host?: string): IGUIServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/types/gui/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/gui/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,OAAO,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,IAAI,OAAO,CAAC;IACrB,MAAM,IAAI,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,IAAI,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;CAC5B;AAkOD;;GAEG;AACH,wBAAgB,YAAY,IAAI,UAAU,CAKzC;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAKpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,CAAC,EAAE,aAAa,EACrB,WAAW,CAAC,EAAE,YAAY,EAC1B,IAAI,CAAC,EAAE,MAAM,GACZ,UAAU,CAEZ"}

package/dist/types/gui/websocket-hub.d.ts

@@ -0,0 +1,67 @@
+/**
+ * WebSocket Hub 模块
+ *
+ * 管理 WebSocket 客户端连接，广播消息到所有连接的客户端
+ */
+import type { RequestData, ResponseData, ErrorData } from '../store/ring-buffer.js';
+/**
+ * WebSocket 消息类型
+ */
+export type WSMessageType = 'request:start' | 'request:complete' | 'request:error' | 'requests:initial' | 'requests:clear' | 'control:pause' | 'control:resume';
+/**
+ * WebSocket 消息
+ */
+export interface WSMessage {
+    type: WSMessageType;
+    payload: unknown;
+    timestamp: number;
+}
+/**
+ * WebSocket Hub 接口
+ */
+export interface IWebSocketHub {
+    start(port: number, host?: string): Promise<number>;
+    stop(): Promise<void>;
+    broadcast(message: WSMessage): void;
+    send(clientId: string, message: WSMessage): void;
+    getClientCount(): number;
+    getClientIds(): string[];
+    isRunning(): boolean;
+    getPort(): number | null;
+    onClientConnect(callback: (clientId: string) => void): void;
+    onClientDisconnect(callback: (clientId: string) => void): void;
+    onClientMessage(callback: (clientId: string, message: WSMessage) => void): void;
+}
+/**
+ * 获取全局 WebSocket Hub 实例
+ */
+export declare function getWebSocketHub(): IWebSocketHub;
+/**
+ * 重置全局 WebSocket Hub（用于测试）
+ */
+export declare function resetWebSocketHub(): Promise<void>;
+/**
+ * 创建新的 WebSocket Hub 实例（用于测试）
+ */
+export declare function createWebSocketHub(): IWebSocketHub;
+/**
+ * 创建请求开始消息
+ */
+export declare function createRequestStartMessage(request: RequestData): WSMessage;
+/**
+ * 创建请求完成消息
+ */
+export declare function createRequestCompleteMessage(requestId: string, response: ResponseData): WSMessage;
+/**
+ * 创建请求错误消息
+ */
+export declare function createRequestErrorMessage(requestId: string, error: ErrorData): WSMessage;
+/**
+ * 创建初始数据消息
+ */
+export declare function createInitialDataMessage(requests: RequestData[]): WSMessage;
+/**
+ * 创建清空请求消息
+ */
+export declare function createClearMessage(): WSMessage;
+//# sourceMappingURL=websocket-hub.d.ts.map

package/dist/types/gui/websocket-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-hub.d.ts","sourceRoot":"","sources":["../../../src/gui/websocket-hub.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,SAAS,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IACjD,cAAc,IAAI,MAAM,CAAC;IACzB,YAAY,IAAI,MAAM,EAAE,CAAC;IACzB,SAAS,IAAI,OAAO,CAAC;IACrB,OAAO,IAAI,MAAM,GAAG,IAAI,CAAC;IAGzB,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/D,eAAe,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI,CAAC;CACjF;AAgOD;;GAEG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAK/C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAKvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,CAElD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,CAezE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,SAAS,CAajG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,CAUxF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,CAwB3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,CAM9C"}

package/dist/types/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Node Network DevTools
+ *
+ * Node.js 网络请求监听工具，桥接到 Chrome DevTools Network 面板
+ */
+export { getConfig, setConfig, resetConfig, type Config } from './config.js';
+export { getRequestStore, resetRequestStore, createRequestStore, type IRequestStore, type RequestData, type ResponseData, type ErrorData, type TimingData, type QueryFilter, } from './store/ring-buffer.js';
+export { generateTraceId, getCurrentTraceId, getCurrentContext, startTrace, runWithContext, runWithTrace, runWithTraceAsync, updateContextMetadata, getTraceDuration, createTraceIdGetter, ContextManager, type TraceContext, } from './context/context-manager.js';
+export { HttpPatcher } from './interceptors/http-patcher.js';
+export { UndiciPatcher } from './interceptors/undici-patcher.js';
+export { getCDPBridge, resetCDPBridge, createCDPBridge, isInspectorEnabled, getInspectorUrl, type ICDPBridge, type CDPCallFrame, type CDPStackTrace, type CDPRequest, type CDPResponse, } from './cdp/cdp-bridge.js';
+export { NextJsAdapter, isNextJsEnvironment, getCurrentRoute, runWithRoute, runWithRouteAsync, extractNextJsOptions, extractNextJsMetadata, createInstrumentationConfig, type NextJsMetadata, type NextJsFetchOptions, } from './adapters/nextjs.js';
+export { getGUIServer, resetGUIServer, createGUIServer, type IGUIServer, type GUIServerConfig, } from './gui/server.js';
+export { getWebSocketHub, resetWebSocketHub, createWebSocketHub, createRequestStartMessage, createRequestCompleteMessage, createRequestErrorMessage, createInitialDataMessage, createClearMessage, type IWebSocketHub, type WSMessage, type WSMessageType, } from './gui/websocket-hub.js';
+export { getEventBridge, resetEventBridge, createEventBridge, type IEventBridge, } from './gui/event-bridge.js';
+export { openBrowser, closeBrowser, type BrowserLauncherOptions, } from './gui/browser-launcher.js';
+export { getAvailablePort, isPortAvailable, } from './gui/port-utils.js';
+/**
+ * 快速初始化函数
+ *
+ * 一键安装所有拦截器并连接 CDP Bridge
+ */
+export declare function install(): Promise<void>;
+/**
+ * 启动 GUI 服务器
+ *
+ * @param options - GUI 服务器配置
+ * @returns GUI 服务器信息
+ */
+export declare function startGUI(options?: {
+    guiPort?: number | 'auto';
+    wsPort?: number | 'auto';
+    host?: string;
+    autoOpen?: boolean;
+}): Promise<{
+    url: string;
+    guiPort: number;
+    wsPort: number;
+}>;
+/**
+ * 停止 GUI 服务器
+ */
+export declare function stopGUI(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,KAAK,YAAY,GAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAG7D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGjE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,eAAe,EACf,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,YAAY,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,sBAAsB,GAC5B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB7C;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,CAAC,EAAE;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB5D;AAED;;GAEG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAY7C"}

package/dist/types/interceptors/http-patcher.d.ts

@@ -0,0 +1,32 @@
+/**
+ * HTTP 模块拦截器
+ *
+ * 使用 @mswjs/interceptors 库拦截 HTTP 请求
+ * 这是一个专门为此设计的库，支持 ESM 和 CJS
+ */
+/**
+ * 设置获取 TraceID 的回调
+ */
+export declare function setTraceIdGetter(getter: () => string | undefined): void;
+/**
+ * 安装 HTTP 拦截器
+ */
+export declare function install(): void;
+/**
+ * 卸载 HTTP 拦截器
+ */
+export declare function uninstall(): void;
+/**
+ * 检查是否已安装
+ */
+export declare function isInstalled(): boolean;
+/**
+ * HttpPatcher 类（用于导出）
+ */
+export declare const HttpPatcher: {
+    install: typeof install;
+    uninstall: typeof uninstall;
+    isInstalled: typeof isInstalled;
+    setTraceIdGetter: typeof setTraceIdGetter;
+};
+//# sourceMappingURL=http-patcher.d.ts.map

package/dist/types/interceptors/http-patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-patcher.d.ts","sourceRoot":"","sources":["../../../src/interceptors/http-patcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAEvE;AAkDD;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAwH9B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAOhC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;CAKvB,CAAC"}

package/dist/types/interceptors/undici-patcher.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Undici/Fetch 拦截器
+ *
+ * 拦截 Node.js 原生 fetch API（基于 undici）
+ * 使用 Agent.compose() 方法添加拦截器
+ */
+/**
+ * 设置获取 TraceID 的回调
+ */
+export declare function setTraceIdGetter(getter: () => string | undefined): void;
+/**
+ * 安装 Undici/Fetch 拦截器
+ */
+export declare function install(): void;
+/**
+ * 卸载 Undici/Fetch 拦截器
+ */
+export declare function uninstall(): void;
+/**
+ * 检查是否已安装
+ */
+export declare function isInstalled(): boolean;
+/**
+ * 检查 undici 是否可用
+ */
+export declare function isUndiciAvailable(): boolean;
+/**
+ * UndiciPatcher 对象
+ */
+export declare const UndiciPatcher: {
+    install: typeof install;
+    uninstall: typeof uninstall;
+    isInstalled: typeof isInstalled;
+    isUndiciAvailable: typeof isUndiciAvailable;
+    setTraceIdGetter: typeof setTraceIdGetter;
+};
+//# sourceMappingURL=undici-patcher.d.ts.map

package/dist/types/interceptors/undici-patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undici-patcher.d.ts","sourceRoot":"","sources":["../../../src/interceptors/undici-patcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAEvE;AA8QD;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CA8B9B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAQhC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAK3C;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;CAMzB,CAAC"}