@lensmcp/vite-plugin 1.1.0 → 1.2.0

package/index.d.ts

@@ -1,4 +1,4 @@
 export { lensmcpVitePlugin, handleClientEnvelope } from './lib/plugin.js';
 export type { LensmcpViteOptions, LensmcpViteRuntime, ClientEnvelope } from './lib/types.js';
-export { envelopeToEvent } from './lib/event-mappers.js';
+export { envelopeToEvent } from '@lensmcp/bridge';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG7F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/index.js

@@ -1,2 +1,4 @@
 export { lensmcpVitePlugin, handleClientEnvelope } from './lib/plugin.js';
-export { envelopeToEvent } from './lib/event-mappers.js';
+// `envelopeToEvent` moved to @lensmcp/bridge when the bridge was decoupled
+// from Vite; re-exported here for backwards compatibility.
+export { envelopeToEvent } from '@lensmcp/bridge';

package/lib/plugin.d.ts

@@ -14,8 +14,9 @@ interface BoundDeps {
 }
 /**
  * Vite plugin that:
- *   1. Stands up a tiny WebSocket so the injected @lensmcp/client-runtime
- *      can post browser events back into the LensMCP event bus.
+ *   1. Stands up the LensMCP browser-event bridge (`@lensmcp/bridge`) on an
+ *      ephemeral WebSocket port so the injected @lensmcp/client-runtime can
+ *      post browser events back into the LensMCP event bus.
  *   2. Injects a `<script type="module" src="/@lensmcp/client-runtime">`
  *      into served HTML.
  *   3. Resolves that virtual module to the bundled client runtime
@@ -23,12 +24,17 @@ interface BoundDeps {
  *      package import lands in Phase 2/3).
  *   4. Emits HMR + module-graph events for the build reducer.
  *
+ * Since the bridge was decoupled, this plugin is just ONE host adapter for
+ * it — webpack / Next.js / no-build hosts run the same bridge as a
+ * standalone sidecar (`lensmcp bridge`) on a fixed port instead.
+ *
  * The plugin is *passive*: it never mutates app state or behaviour.
  */
 export declare function lensmcpVitePlugin(options?: LensmcpViteOptions, deps?: BoundDeps): Plugin & LensmcpViteRuntime;
 /**
  * Parse one raw WebSocket message from the injected client runtime and
- * publish the resulting event. Exported so it can be exercised over a
+ * publish the resulting event. Kept as a public export for backwards
+ * compatibility — it now delegates to `@lensmcp/bridge`. Exercised over a
  * real WebSocket without booting Vite (see the react-bridge smoke).
  */
 export declare function handleClientEnvelope(raw: string, deps: BoundDeps): void;

package/lib/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/lib/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAMlD,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAkB,MAAM,YAAY,CAAC;AAMzF,UAAU,SAAS;IACjB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,kBAAuB,EAChC,IAAI,GAAE,SAAc,GACnB,MAAM,GAAG,kBAAkB,CA+K7B;AAqCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CASvE"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/lib/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAC;AAElD,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAKzE,UAAU,SAAS;IACjB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,kBAAuB,EAChC,IAAI,GAAE,SAAc,GACnB,MAAM,GAAG,kBAAkB,CAmL7B;AAqCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAEvE"}

package/lib/plugin.js

@@ -1,15 +1,12 @@
-import { createServer as createNetServer, connect } from 'node:net';
-import { createSocket } from 'node:dgram';
-import { appendFileSync } from 'node:fs';
-import { WebSocketServer } from 'ws';
 import { fingerprint, ulid } from '@lensmcp/core';
-import { envelopeToEvent } from './event-mappers.js';
+import { createBridgeServer, makePublisher, handleClientEnvelope as forwardClientEnvelope, } from '@lensmcp/bridge';
 const CLIENT_VIRTUAL_ID = '/@lensmcp/client-runtime';
 const RESOLVED_CLIENT_VIRTUAL_ID = '\0lensmcp-client-runtime';
 /**
  * Vite plugin that:
- *   1. Stands up a tiny WebSocket so the injected @lensmcp/client-runtime
- *      can post browser events back into the LensMCP event bus.
+ *   1. Stands up the LensMCP browser-event bridge (`@lensmcp/bridge`) on an
+ *      ephemeral WebSocket port so the injected @lensmcp/client-runtime can
+ *      post browser events back into the LensMCP event bus.
  *   2. Injects a `<script type="module" src="/@lensmcp/client-runtime">`
  *      into served HTML.
  *   3. Resolves that virtual module to the bundled client runtime
@@ -17,6 +14,10 @@ const RESOLVED_CLIENT_VIRTUAL_ID = '\0lensmcp-client-runtime';
  *      package import lands in Phase 2/3).
  *   4. Emits HMR + module-graph events for the build reducer.
  *
+ * Since the bridge was decoupled, this plugin is just ONE host adapter for
+ * it — webpack / Next.js / no-build hosts run the same bridge as a
+ * standalone sidecar (`lensmcp bridge`) on a fixed port instead.
+ *
  * The plugin is *passive*: it never mutates app state or behaviour.
  */
 export function lensmcpVitePlugin(options = {}, deps = {}) {
@@ -24,7 +25,9 @@ export function lensmcpVitePlugin(options = {}, deps = {}) {
     const wsHost = options.wsHost ?? '127.0.0.1';
     const injectClient = options.injectClient ?? true;
     let wssPort;
-    let wss;
+    let bridge;
+    // Bus → env-sink → console publisher, shared by every hook below.
+    const publishEvent = makePublisher(deps);
     const aliasValtio = options.aliasValtio ?? true;
     const transformSource = options.transformSource ?? true;
     return {
@@ -53,17 +56,19 @@ export function lensmcpVitePlugin(options = {}, deps = {}) {
         async configureServer(server) {
             if (!enabled)
                 return;
-            const port = options.wsPort ?? (await findFreePort());
-            wssPort = port;
-            wss = new WebSocketServer({ host: wsHost, port });
-            wss.on('connection', (socket) => {
-                socket.on('message', (raw) => {
-                    handleClientEnvelope(raw.toString(), deps);
-                });
+            // The bridge owns the WebSocket + envelope→event mapping; we just
+            // host it on an ephemeral port (or `options.wsPort` if pinned) and
+            // bake that port into the injected runtime at `load()` time.
+            bridge = await createBridgeServer({
+                host: wsHost,
+                port: options.wsPort ?? 0,
+                bus: deps.bus,
+                sessionId: deps.sessionId,
             });
+            wssPort = bridge.port;
             // Vite native error stream → our bus.
             server.ws.on('vite:error', (data) => {
-                publish(deps, viteErrorToEvent(data, deps.sessionId));
+                publishEvent(viteErrorToEvent(data, deps.sessionId));
             });
         },
         resolveId(id) {
@@ -117,7 +122,7 @@ export function lensmcpVitePlugin(options = {}, deps = {}) {
             const affected = ctx.modules
                 .map((m) => m.file ?? m.id ?? null)
                 .filter((f) => !!f);
-            publish(deps, {
+            publishEvent({
                 id: ulid(),
                 sessionId: deps.sessionId ?? 'pending',
                 timestamp: Date.now(),
@@ -162,7 +167,7 @@ export function lensmcpVitePlugin(options = {}, deps = {}) {
                 chunks.push({ name, sizeBytes, modules });
             }
             const report = { timestamp: Date.now(), totalBytes, chunks };
-            publish(deps, {
+            publishEvent({
                 id: ulid(),
                 sessionId: deps.sessionId ?? 'pending',
                 timestamp: Date.now(),
@@ -176,8 +181,9 @@ export function lensmcpVitePlugin(options = {}, deps = {}) {
             });
         },
         async closeBundle() {
-            if (wss) {
-                await new Promise((res) => wss?.close(() => res()));
+            if (bridge) {
+                await bridge.close();
+                bridge = undefined;
             }
         },
     };
@@ -214,143 +220,12 @@ async function runLensmcpBabel(code, filename) {
 }
 /**
  * Parse one raw WebSocket message from the injected client runtime and
- * publish the resulting event. Exported so it can be exercised over a
+ * publish the resulting event. Kept as a public export for backwards
+ * compatibility — it now delegates to `@lensmcp/bridge`. Exercised over a
  * real WebSocket without booting Vite (see the react-bridge smoke).
  */
 export function handleClientEnvelope(raw, deps) {
-    let env;
-    try {
-        env = JSON.parse(raw);
-    }
-    catch {
-        return; // ignore malformed
-    }
-    if (!env || typeof env !== 'object' || !('kind' in env))
-        return;
-    publish(deps, envelopeToEvent(env, deps.sessionId));
-}
-function publish(deps, event) {
-    if (deps.bus) {
-        deps.bus.publish(event);
-        return;
-    }
-    // Cross-process: the MCP server runs in a separate process during
-    // `agent-dev`, so when no in-process bus is bound we forward events
-    // over the same transport the NestJS sink uses (resolved from env).
-    // The server's `startEventIngest` republishes them onto its bus.
-    const sink = resolveEnvSink();
-    if (sink) {
-        sink(event);
-        return;
-    }
-    if (event.severity === 'error' || event.severity === 'fatal') {
-        // Standalone fallback so the plugin is debuggable without a bus.
-        console.debug(`[lensmcp-vite] ${event.severity}: ${event.title}`);
-    }
-}
-let cachedEnvSink;
-/**
- * Resolve a cross-process event sink from env, mirroring
- * `@lensmcp/nest-instrumentation`'s `defaultEventSink`:
- *   1. `LENSMCP_EVENT_FILE` — append one JSON line per event.
- *   2. `LENSMCP_UDS` — Unix domain socket, framed NDJSON, reconnecting.
- *   3. `LENSMCP_IPC_SOCKET` (`host:port`) — one UDP datagram per event.
- * Cached after first resolution; returns null when none is set.
- */
-function resolveEnvSink() {
-    if (cachedEnvSink !== undefined)
-        return cachedEnvSink;
-    const filePath = process.env['LENSMCP_EVENT_FILE'];
-    if (filePath) {
-        cachedEnvSink = (event) => {
-            try {
-                appendFileSync(filePath, JSON.stringify(event) + '\n');
-            }
-            catch {
-                /* swallow */
-            }
-        };
-        return cachedEnvSink;
-    }
-    const udsPath = process.env['LENSMCP_UDS'];
-    if (udsPath) {
-        cachedEnvSink = udsEnvSink(udsPath);
-        return cachedEnvSink;
-    }
-    const socketPath = process.env['LENSMCP_IPC_SOCKET'];
-    if (socketPath) {
-        const [host, portStr] = socketPath.split(':');
-        const port = Number(portStr);
-        if (host && Number.isFinite(port)) {
-            const sock = createSocket('udp4');
-            sock.unref();
-            cachedEnvSink = (event) => {
-                try {
-                    const buf = Buffer.from(JSON.stringify(event));
-                    sock.send(buf, port, host, () => undefined);
-                }
-                catch {
-                    /* swallow */
-                }
-            };
-            return cachedEnvSink;
-        }
-    }
-    cachedEnvSink = null;
-    return null;
-}
-/** Reconnecting NDJSON client over a Unix domain socket (see session/uds.ts). */
-function udsEnvSink(path) {
-    const queue = [];
-    let sock = null;
-    let connecting = false;
-    const flush = () => {
-        if (!sock || !sock.writable)
-            return;
-        while (queue.length > 0)
-            sock.write(queue.shift());
-    };
-    const open = () => {
-        if (connecting || sock)
-            return;
-        connecting = true;
-        const s = connect(path);
-        s.on('connect', () => {
-            connecting = false;
-            sock = s;
-            flush();
-        });
-        s.on('drain', flush);
-        s.on('error', () => {
-            connecting = false;
-            sock = null;
-        });
-        s.on('close', () => {
-            sock = null;
-        });
-        s.unref();
-    };
-    open();
-    return (event) => {
-        queue.push(JSON.stringify(event) + '\n');
-        while (queue.length > 10000)
-            queue.shift();
-        if (sock && sock.writable) {
-            flush();
-            return;
-        }
-        // Dead socket (server restart) — drop it so open() reconnects.
-        if (sock) {
-            try {
-                sock.destroy();
-            }
-            catch {
-                /* ignore */
-            }
-            sock = null;
-        }
-        open();
-    };
+    forwardClientEnvelope(raw, makePublisher(deps), deps.sessionId);
 }
 function viteErrorToEvent(data, sessionId) {
     const message = data.err?.message ?? 'Vite error';
@@ -368,23 +243,6 @@ function viteErrorToEvent(data, sessionId) {
         message: stack,
     };
 }
-function findFreePort() {
-    return new Promise((resolve, reject) => {
-        const s = createNetServer();
-        s.unref();
-        s.on('error', reject);
-        s.listen(0, () => {
-            const addr = s.address();
-            if (!addr) {
-                s.close();
-                reject(new Error('Could not allocate free port'));
-                return;
-            }
-            const port = addr.port;
-            s.close(() => resolve(port));
-        });
-    });
-}
 /**
  * Minimal browser-side runtime that mirrors what `@lensmcp/client-runtime`
  * will eventually own. Inlined here so Phase 1 has no cross-build

package/lib/types.d.ts

@@ -1,59 +1,10 @@
 /**
  * The wire format used between the injected `@lensmcp/client-runtime`
- * and the Vite plugin's WebSocket. Kept intentionally narrow — the
- * client runtime *only* emits these envelopes, never anything else.
+ * and the bridge's WebSocket. Now owned by `@lensmcp/bridge` (it became
+ * build-agnostic when the bridge was decoupled from Vite); re-exported
+ * here so existing `@lensmcp/vite-plugin` importers keep working.
  */
-export type ClientEnvelope = ({
-    kind: 'error';
-    at: number;
-    message: string;
-    stack?: string;
-    source?: string;
-    lineno?: number;
-    colno?: number;
-} | {
-    kind: 'unhandledrejection';
-    at: number;
-    reason: string;
-} | {
-    kind: 'console';
-    at: number;
-    level: 'log' | 'info' | 'warn' | 'error' | 'debug';
-    args: unknown[];
-} | {
-    kind: 'fetch';
-    at: number;
-    method: string;
-    url: string;
-    status?: number;
-    durationMs?: number;
-    ok?: boolean;
-    error?: string;
-} | {
-    kind: 'route';
-    at: number;
-    url: string;
-    from?: string;
-} | {
-    kind: 'ready';
-    at: number;
-    userAgent: string;
-    url: string;
-} | {
-    kind: 'publish';
-    at: number;
-    source: string;
-    category: string;
-    severity?: string;
-    title: string;
-    message?: string;
-    fingerprint?: string;
-    context?: Record<string, unknown>;
-    raw?: unknown;
-}) & {
-    /** Per-tab identity stamped by the client runtime (sessionStorage is per-tab) — keys `browser://tabs`. */
-    tabId?: string;
-};
+export type { ClientEnvelope } from '@lensmcp/bridge';
 export interface LensmcpViteOptions {
     /** Whether the plugin should attach anything. Production: false. */
     enabled?: boolean;

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAChH;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,GACpG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9H;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAK7D;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CACJ,GAAG;IACF,0GAA0G;IAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oFAAoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,MAAM,IAAI,MAAM,GAAG,SAAS,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oFAAoF;IACpF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,MAAM,IAAI,MAAM,GAAG,SAAS,CAAC;CAC9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/vite-plugin",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",
@@ -15,12 +15,12 @@
   },
   "dependencies": {
     "@babel/core": "^7.0.0",
-    "@lensmcp/core": "1.1.0",
-    "@lensmcp/protocol-types": "1.1.0",
-    "@lensmcp/react-instrumentation": "1.1.0",
-    "@lensmcp/valtio-instrumentation": "1.1.0",
-    "tslib": "^2.3.0",
-    "ws": "^8.21.0"
+    "@lensmcp/bridge": "1.1.0",
+    "@lensmcp/core": "1.2.0",
+    "@lensmcp/protocol-types": "1.2.0",
+    "@lensmcp/react-instrumentation": "1.2.0",
+    "@lensmcp/valtio-instrumentation": "1.2.0",
+    "tslib": "^2.3.0"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"