what-devtools-mcp 0.13.0 → 0.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "what-devtools-mcp",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "MCP server bridging AI agents to live What Framework app state via WebSocket",
   "type": "module",
   "bin": {
@@ -8,9 +8,18 @@
   },
   "exports": {
     ".": "./src/index.js",
-    "./client": "./src/client.js",
-    "./vite": "./src/vite-plugin.js",
-    "./vite-plugin": "./src/vite-plugin.js"
+    "./client": {
+      "types": "./src/client.d.ts",
+      "default": "./src/client.js"
+    },
+    "./vite": {
+      "types": "./src/vite-plugin.d.ts",
+      "default": "./src/vite-plugin.js"
+    },
+    "./vite-plugin": {
+      "types": "./src/vite-plugin.d.ts",
+      "default": "./src/vite-plugin.js"
+    }
   },
   "files": [
     "src"

package/src/client.d.ts

@@ -0,0 +1,31 @@
+// Types for `what-devtools-mcp/client`.
+
+export interface DevToolsMCPConnection {
+  /** Stop probing and close the socket. Safe to call more than once. */
+  disconnect(): void;
+  /** Force an immediate reconnect attempt, resetting the probe back-off. */
+  reconnect(): void;
+  readonly isConnected: boolean;
+  /** Events forwarded to the bridge since the connection opened. */
+  readonly eventCount: number;
+}
+
+export interface ConnectDevToolsMCPOptions {
+  /** Bridge port. Default 9229. */
+  port?: number;
+  /** Shared secret the bridge requires. */
+  token?: string;
+  /** Override the discovery endpoint instead of deriving it from `port`. */
+  discoveryUrl?: string;
+}
+
+/**
+ * Connect the running app to the devtools MCP bridge.
+ *
+ * Returns an inert connection in production (`NODE_ENV === 'production'` or
+ * `import.meta.env.PROD`) rather than throwing, so it is safe to call
+ * unconditionally.
+ */
+export function connectDevToolsMCP(
+  options?: ConnectDevToolsMCPOptions,
+): DevToolsMCPConnection;

package/src/vite-plugin.d.ts

@@ -0,0 +1,31 @@
+// Types for `what-devtools-mcp/vite`. This is the export TypeScript users hit
+// first, because it goes in `vite.config.ts`.
+
+/** Path the dev server answers bridge-discovery probes on. */
+export const DISCOVERY_PATH: string;
+
+export interface WhatDevToolsMCPOptions {
+  /** Bridge port. Default 9229. */
+  port?: number;
+  /** Shared secret required by the bridge. */
+  token?: string;
+}
+
+// Structural Vite plugin shape — assignable to Vite's `PluginOption` without a
+// hard type dependency on `vite`. Same convention as `what-compiler/vite`.
+export interface WhatDevToolsMCPPlugin {
+  name: string;
+  apply?: 'serve' | 'build';
+  [hook: string]: unknown;
+}
+
+/**
+ * Vite plugin that injects the devtools MCP client into the dev server.
+ *
+ * `apply: 'serve'` only: it resolves, loads and injects nothing under
+ * `vite build`. `what-devtools` is an optional peer; if it is not installed the
+ * plugin degrades to a single log line instead of failing the dev transform.
+ */
+export default function whatDevToolsMCP(
+  options?: WhatDevToolsMCPOptions,
+): WhatDevToolsMCPPlugin;