@molecule/app-e2e-preview 1.0.0

package/dist/server.js

@@ -0,0 +1,239 @@
+/**
+ * The hub: a WebSocket endpoint attached to the dev server's HTTP server.
+ * Preview pages connect as `role=page` (from the browser, same origin through
+ * whatever proxy serves the preview); the test runner connects as
+ * `role=driver` (loopback only, with the hub's token). The hub forwards each
+ * driver command to a page and the page's reply back, and broadcasts page
+ * events (hello, navigated, console, pageerror, dialog, closed) to drivers.
+ *
+ * @module
+ */
+import { randomUUID } from 'node:crypto';
+import { unlinkSync, writeFileSync } from 'node:fs';
+import process from 'node:process';
+import { WebSocketServer } from 'ws';
+import { E2E_WS_PATH, tokenFilePath } from './types.js';
+const LOOPBACK = new Set(['127.0.0.1', '::1', '::ffff:127.0.0.1']);
+const isLoopback = (address) => !!address && LOOPBACK.has(address);
+/**
+ * Attach the hub to an HTTP server (Vite's `server.httpServer`). Safe next to
+ * Vite's own HMR upgrade listener: each ignores the other's path.
+ */
+export const attachE2EHub = (httpServer, options = {}) => {
+    const path = options.path ?? E2E_WS_PATH;
+    const token = options.token ?? process.env['MOL_E2E_TOKEN'] ?? randomUUID();
+    const wss = new WebSocketServer({ noServer: true });
+    const pages = new Map();
+    const drivers = new Set();
+    const pending = new Map();
+    let tokenFile = null;
+    const sendTo = (ws, obj) => {
+        if (ws.readyState === ws.OPEN)
+            ws.send(JSON.stringify(obj));
+    };
+    const broadcast = (obj) => {
+        for (const d of drivers)
+            sendTo(d, obj);
+    };
+    const failPending = (pageId) => {
+        for (const [id, p] of pending) {
+            if (p.pageId !== pageId)
+                continue;
+            pending.delete(id);
+            sendTo(p.driver, {
+                id,
+                ok: false,
+                error: 'the page navigated away or closed before it replied',
+                pageClosed: true,
+                pageId,
+            });
+        }
+    };
+    const pickPage = (pageId) => {
+        if (pageId)
+            return pages.get(pageId);
+        const all = Array.from(pages.values());
+        const visible = all.filter((p) => !p.peer.hidden);
+        const pool = visible.length ? visible : all;
+        return pool.sort((a, b) => b.peer.lastSeen - a.peer.lastSeen)[0];
+    };
+    const onPage = (ws, id) => {
+        // A page counts as connected once it has said hello (href, title, visibility);
+        // until then a driver's `list` does not see it and no command can target it.
+        const peer = {
+            id,
+            href: '',
+            title: '',
+            hidden: false,
+            framed: false,
+            connectedAt: Date.now(),
+            lastSeen: Date.now(),
+        };
+        let announced = false;
+        const keepalive = setInterval(() => {
+            try {
+                ws.ping();
+            }
+            catch (_error) {
+                /* closing */
+            }
+        }, 25_000);
+        ws.on('message', (data) => {
+            let msg;
+            try {
+                msg = JSON.parse(String(data));
+            }
+            catch (_error) {
+                return;
+            }
+            peer.lastSeen = Date.now();
+            if (typeof msg.href === 'string')
+                peer.href = msg.href;
+            if (msg.hello) {
+                peer.title = String(msg.title ?? '');
+                peer.hidden = Boolean(msg.hidden);
+                peer.framed = Boolean(msg.framed);
+                pages.set(id, { peer, ws });
+                announced = true;
+                broadcast({
+                    event: 'page-hello',
+                    pageId: id,
+                    ...peer,
+                    readyState: msg.readyState,
+                    innerWidth: msg.innerWidth,
+                    innerHeight: msg.innerHeight,
+                });
+                return;
+            }
+            if (typeof msg.id === 'string' && pending.has(msg.id)) {
+                const p = pending.get(msg.id);
+                pending.delete(msg.id);
+                sendTo(p.driver, { ...msg, pageId: id });
+                return;
+            }
+            if (typeof msg.event === 'string') {
+                if (msg.event === 'visibility')
+                    peer.hidden = Boolean(msg.hidden);
+                if (msg.event === 'navigated' && typeof msg.title === 'string')
+                    peer.title = msg.title;
+                broadcast({ ...msg, pageId: id });
+            }
+        });
+        ws.on('close', () => {
+            clearInterval(keepalive);
+            if (!announced)
+                return;
+            pages.delete(id);
+            failPending(id);
+            broadcast({ event: 'page-closed', pageId: id });
+        });
+        ws.on('error', () => {
+            /* close follows */
+        });
+    };
+    const onDriver = (ws) => {
+        drivers.add(ws);
+        ws.on('message', (data) => {
+            let msg;
+            try {
+                msg = JSON.parse(String(data));
+            }
+            catch (_error) {
+                return;
+            }
+            const id = typeof msg.id === 'string' ? msg.id : randomUUID();
+            if (msg.op === 'list') {
+                sendTo(ws, { id, ok: true, value: Array.from(pages.values()).map((p) => p.peer) });
+                return;
+            }
+            if (msg.op === 'cmd') {
+                const target = pickPage(typeof msg.pageId === 'string' ? msg.pageId : undefined);
+                if (!target) {
+                    sendTo(ws, { id, ok: false, error: 'no-page', noPage: true });
+                    return;
+                }
+                pending.set(id, { driver: ws, pageId: target.peer.id });
+                sendTo(target.ws, { ...msg.cmd, id });
+                return;
+            }
+            sendTo(ws, { id, ok: false, error: 'unknown driver op: ' + String(msg.op) });
+        });
+        ws.on('close', () => {
+            drivers.delete(ws);
+            for (const [id, p] of pending)
+                if (p.driver === ws)
+                    pending.delete(id);
+        });
+        ws.on('error', () => {
+            /* close follows */
+        });
+    };
+    const onUpgrade = (req, socket, head) => {
+        const url = new URL(req.url ?? '/', 'http://localhost');
+        if (url.pathname !== path)
+            return;
+        const role = url.searchParams.get('role');
+        if (role === 'driver') {
+            const remote = req.socket.remoteAddress;
+            if (!isLoopback(remote) || url.searchParams.get('token') !== token) {
+                socket.write('HTTP/1.1 403 Forbidden\r\nConnection: close\r\n\r\n');
+                socket.destroy();
+                return;
+            }
+            wss.handleUpgrade(req, socket, head, (ws) => onDriver(ws));
+            return;
+        }
+        if (role === 'page') {
+            const id = url.searchParams.get('id') || randomUUID();
+            wss.handleUpgrade(req, socket, head, (ws) => onPage(ws, id));
+            return;
+        }
+        socket.destroy();
+    };
+    httpServer.on('upgrade', onUpgrade);
+    const writeToken = () => {
+        const address = httpServer.address();
+        const port = address && typeof address === 'object' ? address.port : null;
+        if (!port)
+            return;
+        tokenFile = tokenFilePath(port);
+        try {
+            writeFileSync(tokenFile, JSON.stringify({ token, port, path, pid: process.pid }), {
+                mode: 0o600,
+            });
+        }
+        catch (_error) {
+            /* a read-only tmpdir: the driver can still use MOL_E2E_TOKEN */
+        }
+    };
+    const removeToken = () => {
+        if (!tokenFile)
+            return;
+        try {
+            unlinkSync(tokenFile);
+        }
+        catch (_error) {
+            /* already gone */
+        }
+        tokenFile = null;
+    };
+    if (httpServer.listening)
+        writeToken();
+    else
+        httpServer.once('listening', writeToken);
+    httpServer.once('close', removeToken);
+    return {
+        token,
+        pages: () => Array.from(pages.values()).map((p) => p.peer),
+        close: () => {
+            httpServer.off('upgrade', onUpgrade);
+            for (const p of pages.values())
+                p.ws.close();
+            for (const d of drivers)
+                d.close();
+            wss.close();
+            removeToken();
+        },
+    };
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAGnD,OAAO,OAAO,MAAM,cAAc,CAAA;AAGlC,OAAO,EAAkB,eAAe,EAAE,MAAM,IAAI,CAAA;AAEpD,OAAO,EAAE,WAAW,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAA;AAiCtE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAClE,MAAM,UAAU,GAAG,CAAC,OAA2B,EAAW,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAE/F;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,UAAgC,EAChC,UAA6C,EAAE,EACvC,EAAE;IACV,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAA;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,UAAU,EAAE,CAAA;IAC3E,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAa,CAAA;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiD,CAAA;IACxE,IAAI,SAAS,GAAkB,IAAI,CAAA;IAEnC,MAAM,MAAM,GAAG,CAAC,EAAa,EAAE,GAAS,EAAQ,EAAE;QAChD,IAAI,EAAE,CAAC,UAAU,KAAK,EAAE,CAAC,IAAI;YAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;IAC7D,CAAC,CAAA;IACD,MAAM,SAAS,GAAG,CAAC,GAAS,EAAQ,EAAE;QACpC,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACzC,CAAC,CAAA;IACD,MAAM,WAAW,GAAG,CAAC,MAAc,EAAQ,EAAE;QAC3C,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;YAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM;gBAAE,SAAQ;YACjC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAClB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE;gBACf,EAAE;gBACF,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,qDAAqD;gBAC5D,UAAU,EAAE,IAAI;gBAChB,MAAM;aACP,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAA;IACD,MAAM,QAAQ,GAAG,CAAC,MAAe,EAAwB,EAAE;QACzD,IAAI,MAAM;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QACtC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACjD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IAClE,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,CAAC,EAAa,EAAE,EAAU,EAAQ,EAAE;QACjD,+EAA+E;QAC/E,6EAA6E;QAC7E,MAAM,IAAI,GAAa;YACrB,EAAE;YACF,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;YACvB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;SACrB,CAAA;QACD,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC;gBACH,EAAE,CAAC,IAAI,EAAE,CAAA;YACX,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,aAAa;YACf,CAAC;QACH,CAAC,EAAE,MAAM,CAAC,CAAA;QACV,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,GAAS,CAAA;YACb,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAS,CAAA;YACxC,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,OAAM;YACR,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC1B,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAA;YACtD,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;gBACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;gBACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;gBACjC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;gBAC3B,SAAS,GAAG,IAAI,CAAA;gBAChB,SAAS,CAAC;oBACR,KAAK,EAAE,YAAY;oBACnB,MAAM,EAAE,EAAE;oBACV,GAAG,IAAI;oBACP,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,UAAU,EAAE,GAAG,CAAC,UAAU;oBAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;iBAC7B,CAAC,CAAA;gBACF,OAAM;YACR,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtD,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAE,CAAA;gBAC9B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;gBACtB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;gBACxC,OAAM;YACR,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAClC,IAAI,GAAG,CAAC,KAAK,KAAK,YAAY;oBAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;gBACjE,IAAI,GAAG,CAAC,KAAK,KAAK,WAAW,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;oBAAE,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAA;gBACtF,SAAS,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;YACnC,CAAC;QACH,CAAC,CAAC,CAAA;QACF,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,aAAa,CAAC,SAAS,CAAC,CAAA;YACxB,IAAI,CAAC,SAAS;gBAAE,OAAM;YACtB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAChB,WAAW,CAAC,EAAE,CAAC,CAAA;YACf,SAAS,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;QACjD,CAAC,CAAC,CAAA;QACF,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,mBAAmB;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,EAAa,EAAQ,EAAE;QACvC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACf,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,GAAS,CAAA;YACb,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAS,CAAA;YACxC,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,OAAM;YACR,CAAC;YACD,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAA;YAC7D,IAAI,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBAClF,OAAM;YACR,CAAC;YACD,IAAI,GAAG,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;gBACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;gBAChF,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;oBAC7D,OAAM;gBACR,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;gBACvD,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAI,GAAG,CAAC,GAAY,EAAE,EAAE,EAAE,CAAC,CAAA;gBAC/C,OAAM;YACR,CAAC;YACD,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC9E,CAAC,CAAC,CAAA;QACF,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAClB,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO;gBAAE,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE;oBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACxE,CAAC,CAAC,CAAA;QACF,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,mBAAmB;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,MAAM,SAAS,GAAG,CAAC,GAAoB,EAAE,MAAc,EAAE,IAAY,EAAQ,EAAE;QAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAA;QACvD,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAM;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACzC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,MAAM,GAAI,GAAG,CAAC,MAAqC,CAAC,aAAa,CAAA;YACvE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC;gBACnE,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAA;gBACnE,MAAM,CAAC,OAAO,EAAE,CAAA;gBAChB,OAAM;YACR,CAAC;YACD,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;YAC1D,OAAM;QACR,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,UAAU,EAAE,CAAA;YACrD,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,CAAA;IAClB,CAAC,CAAA;IACD,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAEnC,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,CAAA;QACpC,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;QACzE,IAAI,CAAC,IAAI;YAAE,OAAM;QACjB,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAC/B,IAAI,CAAC;YACH,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE;gBAChF,IAAI,EAAE,KAAK;aACZ,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,gEAAgE;QAClE,CAAC;IACH,CAAC,CAAA;IACD,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,IAAI,CAAC,SAAS;YAAE,OAAM;QACtB,IAAI,CAAC;YACH,UAAU,CAAC,SAAS,CAAC,CAAA;QACvB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,kBAAkB;QACpB,CAAC;QACD,SAAS,GAAG,IAAI,CAAA;IAClB,CAAC,CAAA;IACD,IAAI,UAAU,CAAC,SAAS;QAAE,UAAU,EAAE,CAAA;;QACjC,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;IAC7C,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IAErC,OAAO;QACL,KAAK;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,KAAK,EAAE,GAAG,EAAE;YACV,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;YACpC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE;gBAAE,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAA;YAC5C,KAAK,MAAM,CAAC,IAAI,OAAO;gBAAE,CAAC,CAAC,KAAK,EAAE,CAAA;YAClC,GAAG,CAAC,KAAK,EAAE,CAAA;YACX,WAAW,EAAE,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shapes shared by the three halves of the preview bond: the page client, the
+ * dev-server WebSocket hub, and the sandbox-side driver.
+ *
+ * @module
+ */
+import type { E2EConnectOptions } from '@molecule/app-e2e';
+/** WebSocket path the hub listens on (same origin as the previewed page). */
+export declare const E2E_WS_PATH = "/__mol/e2e";
+/** Path the page client script is served from (dev and `vite preview`). */
+export declare const E2E_CLIENT_PATH = "/__mol/e2e-client.js";
+/** The hub writes its driver token here so a runner on the same machine can find it. */
+export declare const tokenFilePath: (port: number) => string;
+/** Options for `provider.connect()` beyond the core's. */
+export interface PreviewConnectOptions extends E2EConnectOptions {
+    /** Full hub URL (`ws://127.0.0.1:5173/__mol/e2e`); overrides port discovery. */
+    url?: string;
+    /** Dev-server port to try first (the sandbox serves the preview on 5173). */
+    port?: number;
+    /** Driver token; defaults to `MOL_E2E_TOKEN` or the hub's token file. */
+    token?: string;
+    /** Drive one specific page (an id from `listPages()`); defaults to the most recently seen visible page. */
+    pageId?: string;
+    /** How long to wait for a preview page to be connected before failing, ms. */
+    connectTimeout?: number;
+}
+/** A page currently connected to the hub. */
+export interface PagePeer {
+    id: string;
+    href: string;
+    title: string;
+    hidden: boolean;
+    framed: boolean;
+    connectedAt: number;
+    lastSeen: number;
+}
+/** Hub → driver event envelope. */
+export interface HubEvent {
+    event: string;
+    pageId?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,6EAA6E;AAC7E,eAAO,MAAM,WAAW,eAAe,CAAA;AAEvC,2EAA2E;AAC3E,eAAO,MAAM,eAAe,yBAAyB,CAAA;AAErD,wFAAwF;AACxF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAgD,CAAA;AAE7F,0DAA0D;AAC1D,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2GAA2G;IAC3G,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,6CAA6C;AAC7C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,mCAAmC;AACnC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB"}

package/dist/types.js

@@ -0,0 +1,15 @@
+/**
+ * Shapes shared by the three halves of the preview bond: the page client, the
+ * dev-server WebSocket hub, and the sandbox-side driver.
+ *
+ * @module
+ */
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+/** WebSocket path the hub listens on (same origin as the previewed page). */
+export const E2E_WS_PATH = '/__mol/e2e';
+/** Path the page client script is served from (dev and `vite preview`). */
+export const E2E_CLIENT_PATH = '/__mol/e2e-client.js';
+/** The hub writes its driver token here so a runner on the same machine can find it. */
+export const tokenFilePath = (port) => join(tmpdir(), `mol-e2e-${port}.json`);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAA;AAEvC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAA;AAErD,wFAAwF;AACxF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,IAAI,OAAO,CAAC,CAAA"}

package/dist/vite.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The Vite plugin: serves the page client, injects it into every dev and
+ * `vite preview` document, and attaches the hub to the server. Inert in
+ * `vite build` — production HTML never carries the client.
+ *
+ * @module
+ */
+import type { Plugin } from 'vite';
+/** Options for {@link molE2EPreviewPlugin}. */
+export interface MolE2EPreviewPluginOptions {
+    /** Turn the plugin off (also `MOL_E2E_PREVIEW_PLUGIN=0`). Default on. */
+    enabled?: boolean;
+}
+/** Put the client tag at the top of `<head>` unless it is already there. */
+export declare const injectE2EClientTag: (html: string) => string;
+/**
+ * The Vite plugin every scaffolded app carries (through its scaffold-owned
+ * preview plugin file). Dev and preview servers get the hub and the client;
+ * builds are untouched.
+ */
+export declare function molE2EPreviewPlugin(options?: MolE2EPreviewPluginOptions): Plugin;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAMlC,+CAA+C;AAC/C,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAOD,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MAIjD,CAAA;AA6DD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,MAAM,CAgCpF"}

package/dist/vite.js

@@ -0,0 +1,131 @@
+/**
+ * The Vite plugin: serves the page client, injects it into every dev and
+ * `vite preview` document, and attaches the hub to the server. Inert in
+ * `vite build` — production HTML never carries the client.
+ *
+ * @module
+ */
+import process from 'node:process';
+import { E2E_PREVIEW_CLIENT_SCRIPT } from './client.js';
+import { attachE2EHub } from './server.js';
+import { E2E_CLIENT_PATH } from './types.js';
+const TAG = `<script src="${E2E_CLIENT_PATH}" data-mol-e2e></script>`;
+/** Put the client tag at the top of `<head>` unless it is already there. */
+export const injectE2EClientTag = (html) => {
+    if (html.includes('data-mol-e2e'))
+        return html;
+    if (/<head[^>]*>/i.test(html))
+        return html.replace(/<head[^>]*>/i, (m) => m + TAG);
+    return TAG + html;
+};
+const serveClient = (req, res, next) => {
+    if ((req.url ?? '').split('?')[0] !== E2E_CLIENT_PATH)
+        return next();
+    res.setHeader('content-type', 'text/javascript; charset=utf-8');
+    res.setHeader('cache-control', 'no-store');
+    res.end(E2E_PREVIEW_CLIENT_SCRIPT);
+};
+/**
+ * `vite preview` serves built files as-is, so the client is spliced into HTML
+ * responses on the way out (navigations only — requests that accept HTML).
+ */
+const injectIntoPreviewHtml = (req, res, next) => {
+    if (req.method !== 'GET' && req.method !== 'HEAD')
+        return next();
+    if (!String(req.headers.accept ?? '').includes('text/html'))
+        return next();
+    const chunks = [];
+    let isHtml = false;
+    const check = () => {
+        isHtml = String(res.getHeader('content-type') ?? '').includes('text/html');
+    };
+    const origSetHeader = res.setHeader.bind(res);
+    const origWriteHead = res.writeHead.bind(res);
+    const origWrite = res.write.bind(res);
+    const origEnd = res.end.bind(res);
+    res.setHeader = ((name, value) => {
+        origSetHeader(name, value);
+        if (name.toLowerCase() === 'content-type')
+            check();
+        return res;
+    });
+    res.writeHead = ((status, ...rest) => {
+        const headers = rest.find((r) => r && typeof r === 'object' && !Array.isArray(r));
+        if (headers)
+            for (const [k, v] of Object.entries(headers))
+                origSetHeader(k, v);
+        check();
+        if (isHtml)
+            res.removeHeader('content-length');
+        const message = typeof rest[0] === 'string' ? rest[0] : undefined;
+        return message ? origWriteHead(status, message) : origWriteHead(status);
+    });
+    res.write = ((chunk, ...args) => {
+        check();
+        if (!isHtml)
+            return origWrite(chunk, ...args);
+        chunks.push(Buffer.from(chunk));
+        const cb = args.find((a) => typeof a === 'function');
+        if (cb)
+            cb();
+        return true;
+    });
+    res.end = ((chunk, ...args) => {
+        check();
+        if (!isHtml)
+            return origEnd(chunk, ...args);
+        if (chunk && typeof chunk !== 'function')
+            chunks.push(Buffer.from(chunk));
+        const html = injectE2EClientTag(Buffer.concat(chunks).toString('utf8'));
+        if (!res.headersSent) {
+            res.removeHeader('content-length');
+            origSetHeader('content-length', Buffer.byteLength(html));
+        }
+        return origEnd(html);
+    });
+    next();
+};
+/**
+ * The Vite plugin every scaffolded app carries (through its scaffold-owned
+ * preview plugin file). Dev and preview servers get the hub and the client;
+ * builds are untouched.
+ */
+export function molE2EPreviewPlugin(options = {}) {
+    const enabled = options.enabled ?? process.env['MOL_E2E_PREVIEW_PLUGIN'] !== '0';
+    return {
+        name: 'molecule:e2e-preview',
+        configureServer(server) {
+            if (!enabled)
+                return;
+            if (server.httpServer)
+                attachE2EHub(server.httpServer);
+            server.middlewares.use(serveClient);
+        },
+        configurePreviewServer(server) {
+            if (!enabled)
+                return;
+            if (server.httpServer)
+                attachE2EHub(server.httpServer);
+            server.middlewares.use(serveClient);
+            server.middlewares.use(injectIntoPreviewHtml);
+        },
+        transformIndexHtml: {
+            order: 'pre',
+            handler(html, ctx) {
+                if (!enabled || !ctx.server)
+                    return html;
+                return {
+                    html,
+                    tags: [
+                        {
+                            tag: 'script',
+                            attrs: { src: E2E_CLIENT_PATH, 'data-mol-e2e': '' },
+                            injectTo: 'head-prepend',
+                        },
+                    ],
+                };
+            },
+        },
+    };
+}
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,OAAO,MAAM,cAAc,CAAA;AAIlC,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAW5C,MAAM,GAAG,GAAG,gBAAgB,eAAe,0BAA0B,CAAA;AAErE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE;IACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAA;IAC9C,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;IAClF,OAAO,GAAG,GAAG,IAAI,CAAA;AACnB,CAAC,CAAA;AAED,MAAM,WAAW,GAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;IACjD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,eAAe;QAAE,OAAO,IAAI,EAAE,CAAA;IACpE,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,gCAAgC,CAAC,CAAA;IAC/D,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAA;IAC1C,GAAG,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;AACpC,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,qBAAqB,GAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;IAC3D,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,EAAE,CAAA;IAChE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,EAAE,CAAA;IAC1E,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IAC5E,CAAC,CAAA;IACD,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC7C,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,IAAY,EAAE,KAA0C,EAAE,EAAE;QAC5E,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC1B,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,cAAc;YAAE,KAAK,EAAE,CAAA;QAClD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAyB,CAAA;IAC1B,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,MAAc,EAAE,GAAG,IAAe,EAAE,EAAE;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACf,CAAA;QACjE,IAAI,OAAO;YAAE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC9E,KAAK,EAAE,CAAA;QACP,IAAI,MAAM;YAAE,GAAG,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAA;QAC9C,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACjE,OAAO,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IACzE,CAAC,CAAyB,CAAA;IAC1B,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,KAAc,EAAE,GAAG,IAAe,EAAE,EAAE;QAClD,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM;YAAE,OAAQ,SAA0C,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAA;QAC/E,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAA4B,CAAC,CAAC,CAAA;QACtD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,UAAU,CAA6B,CAAA;QAChF,IAAI,EAAE;YAAE,EAAE,EAAE,CAAA;QACZ,OAAO,IAAI,CAAA;IACb,CAAC,CAAqB,CAAA;IACtB,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,KAAe,EAAE,GAAG,IAAe,EAAE,EAAE;QACjD,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,MAAM;YAAE,OAAQ,OAA+C,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAA;QACpF,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,UAAU;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAA4B,CAAC,CAAC,CAAA;QAChG,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QACvE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACrB,GAAG,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAA;YAClC,aAAa,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QAC1D,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC,CAAmB,CAAA;IACpB,IAAI,EAAE,CAAA;AACR,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAsC,EAAE;IAC1E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,KAAK,GAAG,CAAA;IAChF,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,eAAe,CAAC,MAAM;YACpB,IAAI,CAAC,OAAO;gBAAE,OAAM;YACpB,IAAI,MAAM,CAAC,UAAU;gBAAE,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;YACtD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACrC,CAAC;QACD,sBAAsB,CAAC,MAAM;YAC3B,IAAI,CAAC,OAAO;gBAAE,OAAM;YACpB,IAAI,MAAM,CAAC,UAAU;gBAAE,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;YACtD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YACnC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;QAC/C,CAAC;QACD,kBAAkB,EAAE;YAClB,KAAK,EAAE,KAAK;YACZ,OAAO,CAAC,IAAI,EAAE,GAAG;gBACf,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM;oBAAE,OAAO,IAAI,CAAA;gBACxC,OAAO;oBACL,IAAI;oBACJ,IAAI,EAAE;wBACJ;4BACE,GAAG,EAAE,QAAQ;4BACb,KAAK,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,cAAc,EAAE,EAAE,EAAE;4BACnD,QAAQ,EAAE,cAAc;yBACzB;qBACF;iBACF,CAAA;YACH,CAAC;SACF;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@molecule/app-e2e-preview",
+  "version": "1.0.0",
+  "description": "E2E bond that drives the LIVE IDE preview as a Playwright-shaped page — the page the person is already looking at, in their own browser — over a same-origin WebSocket through the dev server. No browser binary in the sandbox.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "molecule",
+    "e2e",
+    "preview",
+    "playwright",
+    "vite-plugin"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/app/bonds/e2e/preview"
+  },
+  "homepage": "https://molecule.dev",
+  "bugs": {
+    "url": "https://github.com/molecule-dev/molecule/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ws": "8.21.1"
+  },
+  "peerDependencies": {
+    "@molecule/app-bond": "^1.0.1",
+    "@molecule/app-e2e": "^1.0.0",
+    "@molecule/app-e2e-fixtures-default": "^1.0.1",
+    "@playwright/test": "^1.40.0",
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@molecule/app-bond": "1.0.1",
+    "@molecule/app-e2e": "1.0.0",
+    "@molecule/app-e2e-fixtures-default": "1.0.1",
+    "@playwright/test": "1.62.0",
+    "@types/node": "26.1.2",
+    "@types/ws": "8.18.1",
+    "typescript": "6.0.3",
+    "vite": "8.1.5",
+    "vitest": "4.1.11"
+  }
+}