@molecule/app-e2e-preview 1.0.0

package/dist/provider.js

@@ -0,0 +1,405 @@
+/**
+ * The driver: connects to the hub from inside the sandbox (or any machine
+ * running the dev server), picks a connected preview page, and exposes it as
+ * an `E2ETransport` for the core's `createEvaluatePage()`.
+ *
+ * @module
+ */
+import { randomUUID } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import process from 'node:process';
+import WebSocket from 'ws';
+import { E2ETimeoutError, } from '@molecule/app-e2e';
+import { createEvaluatePage } from '@molecule/app-e2e-fixtures-default';
+import { E2E_WS_PATH, tokenFilePath, } from './types.js';
+const BOND_NAME = 'the preview bond (@molecule/app-e2e-preview)';
+const DEFAULT_CONNECT_TIMEOUT = 30_000;
+const noPageMessage = (url) => `No preview page is connected to the dev server at ${url}. ${BOND_NAME} drives the page a browser is showing: ` +
+    `open this project's preview in the molecule.dev IDE (or the preview URL in any browser tab) and keep that tab open, then run again. ` +
+    `If the tab is asleep, wake it — the IDE keeps the screen awake while a build runs.`;
+const candidatePorts = (options) => {
+    const raw = [
+        options.port,
+        Number(process.env['MOL_E2E_PREVIEW_PORT']),
+        5173,
+        Number(process.env['VITE_PORT']),
+        3000,
+    ];
+    const out = [];
+    for (const p of raw)
+        if (p && Number.isFinite(p) && !out.includes(p))
+            out.push(p);
+    return out;
+};
+const readToken = (port, options) => {
+    if (options.token)
+        return options.token;
+    const fromEnv = process.env['MOL_E2E_TOKEN'];
+    if (fromEnv)
+        return fromEnv;
+    try {
+        const file = tokenFilePath(port);
+        if (!existsSync(file))
+            return null;
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        return parsed.token ?? null;
+    }
+    catch (_error) {
+        return null;
+    }
+};
+/** A driver connection to one hub. */
+class HubClient {
+    url;
+    ws;
+    pages = new Map();
+    current = null;
+    lastHref = '';
+    pending = new Map();
+    listeners = new Map();
+    closed = false;
+    constructor(url, ws) {
+        this.url = url;
+        this.ws = ws;
+        ws.on('message', (data) => this.onMessage(String(data)));
+        ws.on('close', () => {
+            this.closed = true;
+            for (const [id, p] of this.pending) {
+                this.pending.delete(id);
+                clearTimeout(p.timer);
+                p.reject(new Error(`the connection to the preview hub at ${url} closed (did the dev server restart?)`));
+            }
+            this.emit({ event: 'hub-closed' });
+        });
+        ws.on('error', () => {
+            /* close follows */
+        });
+    }
+    /** Connect to a hub as a driver and learn the pages already connected. */
+    static open(url, token, timeout) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(`${url}?role=driver&token=${encodeURIComponent(token)}`);
+            const timer = setTimeout(() => {
+                ws.terminate();
+                reject(new Error(`timed out connecting to the preview hub at ${url}`));
+            }, timeout);
+            ws.once('open', () => {
+                clearTimeout(timer);
+                const client = new HubClient(url, ws);
+                client.seed().then(() => resolve(client), reject);
+            });
+            ws.once('error', (error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+            ws.once('unexpected-response', (_req, res) => {
+                clearTimeout(timer);
+                reject(new Error(`the preview hub at ${url} refused the driver connection (HTTP ${res.statusCode}) — wrong token, or not connecting from the machine that runs the dev server`));
+            });
+        });
+    }
+    /** Whether the socket has closed. */
+    get isClosed() {
+        return this.closed;
+    }
+    /** Subscribe to hub events (`page-hello`, `page-closed`, `navigated`, `console`, `pageerror`, `hub-closed`, or `*`); returns an unsubscribe function. */
+    on(event, fn) {
+        if (!this.listeners.has(event))
+            this.listeners.set(event, new Set());
+        this.listeners.get(event).add(fn);
+        return () => this.listeners.get(event)?.delete(fn);
+    }
+    /** Fan an event out to its listeners and to the wildcard listeners. */
+    emit(event) {
+        for (const fn of this.listeners.get(event.event) ?? [])
+            fn(event);
+        for (const fn of this.listeners.get('*') ?? [])
+            fn(event);
+    }
+    /** Route a hub frame: a reply to a pending request, or a page event that updates the bookkeeping. */
+    onMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch (_error) {
+            return;
+        }
+        if (typeof msg.id === 'string' && this.pending.has(msg.id)) {
+            const p = this.pending.get(msg.id);
+            this.pending.delete(msg.id);
+            clearTimeout(p.timer);
+            if (typeof msg.href === 'string' && msg.pageId === this.current)
+                this.lastHref = msg.href;
+            p.resolve(msg);
+            return;
+        }
+        if (typeof msg.event !== 'string')
+            return;
+        const pageId = typeof msg.pageId === 'string' ? msg.pageId : undefined;
+        if (msg.event === 'page-hello' && pageId) {
+            this.pages.set(pageId, {
+                id: pageId,
+                href: String(msg.href ?? ''),
+                title: String(msg.title ?? ''),
+                hidden: Boolean(msg.hidden),
+                framed: Boolean(msg.framed),
+                connectedAt: Number(msg.connectedAt ?? Date.now()),
+                lastSeen: Date.now(),
+            });
+        }
+        else if (msg.event === 'page-closed' && pageId) {
+            this.pages.delete(pageId);
+            if (this.current === pageId)
+                this.current = null;
+        }
+        else if (pageId && this.pages.has(pageId)) {
+            const peer = this.pages.get(pageId);
+            peer.lastSeen = Date.now();
+            if (msg.event === 'navigated' && typeof msg.href === 'string') {
+                peer.href = msg.href;
+                if (pageId === this.current)
+                    this.lastHref = msg.href;
+            }
+            if (msg.event === 'visibility')
+                peer.hidden = Boolean(msg.hidden);
+        }
+        this.emit(msg);
+    }
+    /** Learn about pages that connected BEFORE this driver did (the hub only broadcasts new hellos). */
+    async seed() {
+        const reply = await this.request('list', {}, 5_000);
+        for (const peer of reply.value ?? []) {
+            if (!this.pages.has(peer.id))
+                this.pages.set(peer.id, { ...peer, lastSeen: peer.lastSeen || Date.now() });
+        }
+    }
+    /** Send one driver request and await its reply within `timeout`. */
+    request(op, payload, timeout) {
+        if (this.closed)
+            return Promise.reject(new Error(`the connection to the preview hub at ${this.url} is closed`));
+        const id = randomUUID();
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new E2ETimeoutError(`the preview page did not answer within ${timeout}ms (${op}). Is the preview tab open and awake?`));
+            }, timeout);
+            this.pending.set(id, { resolve, reject, timer });
+            this.ws.send(JSON.stringify({ id, op, ...payload }));
+        });
+    }
+    /** Wait for a page to be connected; resolves with its id. */
+    waitForPage(options) {
+        const pick = () => {
+            if (options.preferred && this.pages.has(options.preferred))
+                return options.preferred;
+            const all = Array.from(this.pages.values()).filter((p) => p.id !== options.exclude);
+            const visible = all.filter((p) => !p.hidden);
+            const pool = visible.length ? visible : all;
+            pool.sort((a, b) => b.lastSeen - a.lastSeen);
+            return pool[0]?.id ?? null;
+        };
+        const now = pick();
+        if (now)
+            return Promise.resolve(now);
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                off();
+                reject(new E2ETimeoutError(noPageMessage(this.url)));
+            }, options.timeout);
+            const off = this.on('page-hello', () => {
+                const id = pick();
+                if (!id)
+                    return;
+                clearTimeout(timer);
+                off();
+                resolve(id);
+            });
+        });
+    }
+    /** Close the driver socket. */
+    close() {
+        this.closed = true;
+        this.ws.close();
+    }
+}
+const openHub = async (options) => {
+    const timeout = options.connectTimeout ?? DEFAULT_CONNECT_TIMEOUT;
+    const tried = [];
+    if (options.url) {
+        const port = Number(new URL(options.url).port) || 80;
+        const token = readToken(port, options);
+        if (!token)
+            throw new Error(`no driver token for the preview hub at ${options.url}: set MOL_E2E_TOKEN or start the dev server with the preview plugin (it writes ${tokenFilePath(port)})`);
+        return HubClient.open(options.url, token, timeout);
+    }
+    for (const port of candidatePorts(options)) {
+        const url = `ws://127.0.0.1:${port}${E2E_WS_PATH}`;
+        const token = readToken(port, options);
+        if (!token) {
+            tried.push(`${url} (no token file — is the dev server on :${port} running with the preview plugin?)`);
+            continue;
+        }
+        try {
+            return await HubClient.open(url, token, Math.min(timeout, 5_000));
+        }
+        catch (error) {
+            tried.push(`${url} (${String(error.message ?? error)})`);
+        }
+    }
+    throw new Error(`could not reach a preview hub. Tried:\n  ${tried.join('\n  ')}\nStart the app's dev server (it carries the preview plugin) and open its preview in the IDE.`);
+};
+/** Open a transport over the hub: one connected preview page, navigations followed across documents. */
+const openTransport = async (options) => {
+    const hub = await openHub(options);
+    const connectTimeout = options.connectTimeout ?? DEFAULT_CONNECT_TIMEOUT;
+    const navigationTimeout = options.navigationTimeout ?? 15_000;
+    hub.current = await hub.waitForPage({ timeout: connectTimeout, preferred: options.pageId });
+    hub.lastHref = hub.pages.get(hub.current)?.href ?? '';
+    const listeners = new Map();
+    const emit = (event, payload) => {
+        for (const fn of listeners.get(event) ?? [])
+            fn(payload);
+    };
+    hub.on('console', (e) => {
+        if (e.pageId === hub.current)
+            emit('console', { type: String(e.type ?? 'log'), text: String(e.text ?? '') });
+    });
+    hub.on('pageerror', (e) => {
+        if (e.pageId === hub.current)
+            emit('pageerror', {
+                message: String(e.message ?? 'Error'),
+                stack: typeof e.stack === 'string' ? e.stack : undefined,
+            });
+    });
+    hub.on('hub-closed', () => emit('close', undefined));
+    const ensurePage = async () => {
+        if (hub.current && hub.pages.has(hub.current))
+            return hub.current;
+        hub.current = await hub.waitForPage({ timeout: connectTimeout });
+        hub.lastHref = hub.pages.get(hub.current)?.href ?? hub.lastHref;
+        return hub.current;
+    };
+    const cmd = async (command, timeout) => {
+        const pageId = await ensurePage();
+        const reply = await hub.request('cmd', { pageId, cmd: command }, timeout);
+        if (reply.noPage) {
+            hub.current = null;
+            const next = await ensurePage();
+            return hub.request('cmd', { pageId: next, cmd: command }, timeout);
+        }
+        return reply;
+    };
+    const settle = async (timeout) => {
+        const deadline = Date.now() + timeout;
+        for (;;) {
+            const reply = await cmd({ op: 'evaluate', source: '() => document.readyState' }, Math.max(1_000, deadline - Date.now()));
+            if (reply.ok && reply.value === 'complete')
+                return;
+            if (Date.now() > deadline)
+                return;
+            await new Promise((r) => setTimeout(r, 100));
+        }
+    };
+    /** Resolve when the current page is replaced by a new document (or changed its URL in place). */
+    const awaitNavigation = (previous, timeout, graceForNoop) => new Promise((resolve, reject) => {
+        let done = false;
+        const finish = (fn) => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            if (grace)
+                clearTimeout(grace);
+            offHello();
+            offNav();
+            fn();
+        };
+        const timer = setTimeout(() => finish(() => reject(new E2ETimeoutError(`navigation did not complete within ${timeout}ms (the previous page ${previous} never handed over to a new document)`))), timeout);
+        const grace = graceForNoop === null ? null : setTimeout(() => finish(resolve), graceForNoop);
+        const offHello = hub.on('page-hello', (e) => {
+            if (e.pageId === previous)
+                return;
+            hub.current = String(e.pageId);
+            hub.lastHref = String(e.href ?? '');
+            finish(resolve);
+        });
+        const offNav = hub.on('navigated', (e) => {
+            if (e.pageId !== previous)
+                return;
+            hub.lastHref = String(e.href ?? hub.lastHref);
+            finish(resolve);
+        });
+    });
+    const transport = {
+        async evaluate(source, arg, opts) {
+            const timeout = opts?.timeout ?? 12_000;
+            const reply = await cmd({ op: 'evaluate', source, arg }, timeout);
+            if (reply.pageClosed) {
+                // The action navigated the page away before it could answer (a link click, a form submit).
+                await awaitNavigation(String(reply.pageId ?? hub.current ?? ''), navigationTimeout, null).catch(() => undefined);
+                return { ok: true, navigated: true };
+            }
+            if (reply.ok === false)
+                throw new Error(String(reply.error ?? 'evaluate failed'));
+            return reply.value;
+        },
+        async navigate(kind, url, opts) {
+            const timeout = opts?.timeout ?? navigationTimeout;
+            const previous = await ensurePage();
+            const command = kind === 'goto'
+                ? { op: 'goto', url }
+                : kind === 'reload'
+                    ? { op: 'reload' }
+                    : { op: 'history', delta: kind === 'back' ? -1 : 1 };
+            const pending = awaitNavigation(previous, timeout, kind === 'back' || kind === 'forward' ? 1_500 : null);
+            const reply = await cmd(command, Math.min(timeout, 5_000)).catch((error) => ({ ok: false, error: error.message }));
+            if (reply.ok === false && !reply.pageClosed) {
+                await pending.catch(() => undefined);
+                throw new Error(`page.${kind === 'goto' ? 'goto' : kind}(): ${String(reply.error)}`);
+            }
+            await pending;
+            await settle(timeout);
+        },
+        async viewport(width, height) {
+            const reply = await cmd({ op: 'viewport', width, height }, 5_000);
+            if (reply.ok === false)
+                throw new Error(String(reply.error ?? 'viewport failed'));
+            const v = reply.value;
+            return { width: v.width, height: v.height };
+        },
+        url: () => hub.lastHref,
+        on(event, listener) {
+            if (!listeners.has(event))
+                listeners.set(event, new Set());
+            listeners.get(event).add(listener);
+            return () => listeners.get(event)?.delete(listener);
+        },
+        async close() {
+            hub.close();
+        },
+    };
+    return transport;
+};
+/** The bond: `setProvider(provider)` in your `e2e/bonds.ts`. */
+export const provider = {
+    name: 'preview',
+    async connect(options = {}) {
+        const transport = await openTransport(options);
+        return createEvaluatePage(transport, { ...options, bondName: BOND_NAME });
+    },
+};
+/** Open the live preview as a Playwright-shaped page from any script (`node scripts/check.mjs`). */
+export const connectPreview = (options = {}) => provider.connect(options);
+/** The preview pages currently connected to the hub. */
+export const listPreviewPages = async (options = {}) => {
+    const hub = await openHub(options);
+    try {
+        const reply = await hub.request('list', {}, 5_000);
+        return reply.value ?? [];
+    }
+    finally {
+        hub.close();
+    }
+};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 type { IncomingMessage } from 'node:http';
+import type { AddressInfo } from 'node:net';
+import type { Duplex } from 'node:stream';
+import { type PagePeer } from './types.js';
+type UpgradeListener = (req: IncomingMessage, socket: Duplex, head: Buffer) => void;
+/**
+ * The slice of `http.Server` / `http2.Http2SecureServer` the hub uses — Vite
+ * hands over either, and both emit `upgrade` with the same arguments.
+ */
+export interface UpgradeCapableServer {
+    on(event: 'upgrade', listener: UpgradeListener): unknown;
+    off(event: 'upgrade', listener: UpgradeListener): unknown;
+    once(event: 'listening' | 'close', listener: () => void): unknown;
+    address(): AddressInfo | string | null;
+    readonly listening: boolean;
+}
+/** A running hub. */
+export interface E2EHub {
+    /** The driver token (also written to the token file once the server listens). */
+    readonly token: string;
+    /** Pages currently connected. */
+    pages(): PagePeer[];
+    /** Detach from the server and close every socket. */
+    close(): void;
+}
+/**
+ * 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 declare const attachE2EHub: (httpServer: UpgradeCapableServer, options?: {
+    token?: string;
+    path?: string;
+}) => E2EHub;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIzC,OAAO,EAAe,KAAK,QAAQ,EAAiB,MAAM,YAAY,CAAA;AAItE,KAAK,eAAe,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAEnF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAA;IACxD,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAA;IACzD,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAA;IACjE,OAAO,IAAI,WAAW,GAAG,MAAM,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAOD,qBAAqB;AACrB,MAAM,WAAW,MAAM;IACrB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iCAAiC;IACjC,KAAK,IAAI,QAAQ,EAAE,CAAA;IACnB,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAAA;CACd;AAKD;;;GAGG;AACH,eAAO,MAAM,YAAY,GACvB,YAAY,oBAAoB,EAChC,UAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,KAC9C,MAwMF,CAAA"}