Merge pull request #5 from instructa/feat/network-ws-logs

feat: add opt-in network logging with fetch, XHR, and WebSocket capture

Author: regenrek

CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2025-09-XX
+
+### Added
+- **Network Logs (opt-in)**: Capture fetch, XMLHttpRequest, and WebSocket as `[network]` entries alongside console logs. Disabled by default; enable via `networkLogs.enabled: true` (Vite/Next/Nuxt/Core).
+- **Tag Filtering**: `get_logs({ tag })` and diagnostics `GET /__client-logs?tag=...` to filter by stream tag (`[browser]`, `[network]`, `[worker]`).
+- **Worker Runtime (internal)**: Dev-only worker console capture runtime available in core (not exported publicly by default).
+- **MCP File Logging (opt-in)**: Enable ingest-side file logging with `BROWSER_ECHO_FILE_LOG=true` and optional split via `BROWSER_ECHO_SPLIT_LOGS=true`.
+
+### Changed
+- Removed protocol from network log text. Format now: `[NETWORK] [METHOD] [URL] [STATUS] [DURATION ms]` and WS events `[WS OPEN/CLOSE/ERROR]`.
+- Next/Nuxt handlers now suppress terminal only when `BROWSER_ECHO_MCP_URL` is set.
+
 ## [1.0.2] - 2025-09-XX
 
 ### Fixed

README.md

@@ -51,6 +51,7 @@ Stream browser `console.*` logs to your dev terminal and optional file logging.
 - Colorized terminal output
 - Optional file logging (Vite provider only)
 - Works great with AI assistants reading your terminal
+ - Optional network capture (opt‑in): fetch, XMLHttpRequest, WebSocket
 
 ## Production
 

example/next-app/package.json

@@ -14,8 +14,8 @@
     "react-dom": "19.1.1"
   },
   "devDependencies": {
-    "@browser-echo/mcp": "workspace:*",
-    "@browser-echo/next": "workspace:*",
+    "@browser-echo/mcp": "1.0.2",
+    "@browser-echo/next": "1.0.2",
     "@eslint/eslintrc": "^3",
     "@tailwindcss/postcss": "^4.1.12",
     "@types/node": "^24.3.0",

example/nuxt-app/package.json

@@ -16,6 +16,6 @@
   },
   "packageManager": "pnpm@10.12.1+sha512.f0dda8580f0ee9481c5c79a1d927b9164f2c478e90992ad268bbb2465a736984391d6333d2c327913578b2804af33474ca554ba29c04a8b13060a717675ae3ac",
   "devDependencies": {
-    "@browser-echo/nuxt": "workspace:*"
+    "@browser-echo/nuxt": "1.0.2"
   }
 }

example/react-vite-app/package.json

@@ -14,7 +14,7 @@
     "react-dom": "^19.1.1"
   },
   "devDependencies": {
-    "@browser-echo/vite": "workspace:*",
+    "@browser-echo/vite": "1.0.2",
     "@eslint/js": "^9.17.0",
     "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.7",

example/tanstack-app/package.json

@@ -18,7 +18,7 @@
     "zod": "^4.0.17"
   },
   "devDependencies": {
-    "@browser-echo/vite": "workspace:*",
+    "@browser-echo/vite": "1.0.2",
     "@types/node": "^24.3.0",
     "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.7",

example/vue-vite-app/package.json

@@ -12,7 +12,7 @@
     "vue": "^3.5.18"
   },
   "devDependencies": {
-    "@browser-echo/vite": "workspace:*",
+    "@browser-echo/vite": "1.0.2",
     "@vitejs/plugin-vue": "^6.0.1",
     "typescript": "~5.9.2",
     "vite": "^7.1.3",

packages/core/README.md

@@ -18,6 +18,7 @@ This package provides the `initBrowserEcho` function that patches `console.*` me
 - Configurable log levels and batching
 - Circular reference handling in logged objects
 - No production impact (meant for development only)
+ - Optional network capture (opt-in): fetch, XMLHttpRequest, WebSocket
 
 ## Installation
 
@@ -42,7 +43,19 @@ initBrowserEcho({
   preserveConsole: true,
   tag: '[browser]',
   batch: { size: 20, interval: 300 },
-  stackMode: 'condensed'
+  stackMode: 'condensed',
+  // Opt-in network logging
+  networkLogs: {
+    enabled: true,
+    captureFull: false,
+    bodies: {
+      request: true,
+      response: true,
+      maxBytes: 2048,
+      allowContentTypes: ['application/json', 'text/', 'application/x-www-form-urlencoded'],
+      prettyJson: true
+    }
+  }
 });
 ```
 
@@ -67,6 +80,18 @@ interface BrowserEchoOptions {
   // server-side
   truncate?: number;                 // default: 10_000 chars (Vite)
   fileLog?: { enabled?: boolean; dir?: string }; // Vite-only
+  // network capture (opt-in)
+  networkLogs?: {
+    enabled?: boolean;
+    captureFull?: boolean;
+    bodies?: {
+      request?: boolean;
+      response?: boolean;
+      maxBytes?: number;                       // default 2048 bytes
+      allowContentTypes?: string[];            // default ['application/json','text/','application/x-www-form-urlencoded']
+      prettyJson?: boolean;                    // default true
+    };
+  }; // default disabled
 }
 ```
 

packages/core/build.config.ts

@@ -4,7 +4,8 @@ export default defineBuildConfig({
   entries: [
     './src/index',
     './src/client',
-    './src/types'
+    './src/types',
+    './src/worker'
   ],
   clean: true,
   declaration: true,

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browser-echo/core",
-  "version": "1.0.1",
+  "version": "1.1.0-alpha.1",
   "type": "module",
   "sideEffects": false,
   "repository": {