what-devtools-mcp 0.6.4 → 0.6.6

package/client.d.ts

@@ -0,0 +1,14 @@
+export interface DevToolsMCPConnection {
+  disconnect(): void;
+  readonly isConnected: boolean;
+  readonly eventCount: number;
+}
+
+export interface ConnectDevToolsMCPOptions {
+  port?: number;
+  token?: string;
+  /** Hostname used by the browser client for token discovery and the bridge WebSocket. Defaults to 127.0.0.1. */
+  host?: string;
+}
+
+export function connectDevToolsMCP(options?: ConnectDevToolsMCPOptions): DevToolsMCPConnection;

package/index.d.ts

@@ -0,0 +1,3 @@
+// CLI entrypoint package. Import browser/client helpers from `what-devtools-mcp/client`
+// and Vite integration from `what-devtools-mcp/vite-plugin`.
+export {};

package/package.json

@@ -1,18 +1,30 @@
 {
   "name": "what-devtools-mcp",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "MCP server bridging AI agents to live What Framework app state via WebSocket",
   "type": "module",
   "bin": {
     "what-devtools-mcp": "src/index.js"
   },
   "exports": {
-    ".": "./src/index.js",
-    "./client": "./src/client.js",
-    "./vite-plugin": "./src/vite-plugin.js"
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./src/index.js"
+    },
+    "./client": {
+      "types": "./client.d.ts",
+      "import": "./src/client.js"
+    },
+    "./vite-plugin": {
+      "types": "./vite-plugin.d.ts",
+      "import": "./src/vite-plugin.js"
+    }
   },
   "files": [
-    "src"
+    "src",
+    "index.d.ts",
+    "client.d.ts",
+    "vite-plugin.d.ts"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
@@ -20,7 +32,7 @@
     "zod": "^3.25.0"
   },
   "peerDependencies": {
-    "what-devtools": "^0.6.3"
+    "what-devtools": "^0.6.5"
   },
   "keywords": [
     "what-framework",
@@ -29,5 +41,14 @@
     "model-context-protocol",
     "ai-debugging"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "types": "index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CelsianJs/what-framework.git"
+  },
+  "homepage": "https://whatfw.com",
+  "bugs": {
+    "url": "https://github.com/CelsianJs/what-framework/issues"
+  }
 }

package/src/client.js

@@ -21,7 +21,7 @@ function logGrouped(badge, badgeStyle, title, data) {
   console.groupEnd();
 }
 
-export function connectDevToolsMCP({ port = 9229, token = '' } = {}) {
+export function connectDevToolsMCP({ port = 9229, token = '', host = '127.0.0.1' } = {}) {
   // Never connect in production
   if (typeof process !== 'undefined' && process.env?.NODE_ENV === 'production') {
     return { disconnect() {}, isConnected: false, eventCount: 0 };
@@ -61,7 +61,7 @@ export function connectDevToolsMCP({ port = 9229, token = '' } = {}) {
 
     const discoveryPort = port + 1;
     try {
-      const res = await fetch(`http://localhost:${discoveryPort}/__what_mcp_token`);
+      const res = await fetch(`http://${host}:${discoveryPort}/__what_mcp_token`);
       if (res.ok) {
         const data = await res.json();
         discoveredToken = data.token;
@@ -75,13 +75,13 @@ export function connectDevToolsMCP({ port = 9229, token = '' } = {}) {
     return false;
   }
 
-  log('MCP', BADGE, `Connecting to bridge on ws://localhost:${port}`);
+  log('MCP', BADGE, `Connecting to bridge on ws://${host}:${port}`);
 
   function connect() {
     reconnectAttempts++;
     try {
       const tokenParam = discoveredToken ? `?token=${encodeURIComponent(discoveredToken)}` : '';
-      ws = new WebSocket(`ws://localhost:${discoveredPort}${tokenParam}`);
+      ws = new WebSocket(`ws://${host}:${discoveredPort}${tokenParam}`);
     } catch {
       if (reconnectAttempts <= 1) {
         log('MCP', BADGE_WARN, 'Bridge not available — retrying silently in background');

package/src/vite-plugin.js

@@ -32,7 +32,7 @@ function resolveToken(explicitToken) {
   return '';
 }
 
-export default function whatDevToolsMCP({ port = 9229, token = '' } = {}) {
+export default function whatDevToolsMCP({ port = 9229, token = '', host = '127.0.0.1' } = {}) {
   return {
     name: 'what-devtools-mcp',
     apply: 'serve',
@@ -47,7 +47,7 @@ Promise.all([
   import('what-devtools-mcp/client'),
 ]).then(([core, devtools, mcp]) => {
   devtools.installDevTools(core);
-  mcp.connectDevToolsMCP({ port: ${port}, token: ${JSON.stringify(tokenValue)} });
+  mcp.connectDevToolsMCP({ port: ${port}, token: ${JSON.stringify(tokenValue)}, host: ${JSON.stringify(host)} });
 }).catch((error) => {
   console.warn(
     '[what-devtools-mcp] DevTools injection failed. Install what-core, what-devtools, and what-devtools-mcp, then verify Vite aliases/package exports.',

package/vite-plugin.d.ts

@@ -0,0 +1,8 @@
+export interface WhatDevToolsMCPOptions {
+  port?: number;
+  token?: string;
+  /** Hostname injected into connectDevToolsMCP(). Defaults to 127.0.0.1. */
+  host?: string;
+}
+
+export default function whatDevToolsMCP(options?: WhatDevToolsMCPOptions): any;