@loompad/cli 0.1.0 → 1.1.2

package/dist/core/preview-proxy.js

@@ -0,0 +1,563 @@
+/**
+ * The preview, served through Loom so the page can talk back.
+ *
+ * A dev server is a different origin from the app, and a browser will not let
+ * one origin read another's console. So Loom stands in front of the server: a
+ * small proxy on its own port that forwards everything — including the
+ * WebSocket a framework's hot reload rides on — and injects one script into
+ * HTML responses. That script reports what the page logs, what it fetches and
+ * what it threw, by postMessage, which crosses origins by design.
+ *
+ * What it never does on its own: change the page. The injection is additive,
+ * it runs before the app's own code only so it can see the first errors, and
+ * nothing else about the response is rewritten. The one thing that does alter
+ * the page is the colour-scheme toggle, and only while you hold it: it
+ * re-points the page's own `prefers-color-scheme` rules and puts every one of
+ * them back, exactly as it found them, when you go back to Auto.
+ */
+import http from "node:http";
+import https from "node:https";
+import net from "node:net";
+import { Readable } from "node:stream";
+/** How long to wait for a dev server that accepted the connection to answer. */
+export const UPSTREAM_TIMEOUT_MS = 20_000;
+/** Marker so an injected page is obvious in view-source. */
+export const BRIDGE_MARK = "loom-preview-bridge";
+/**
+ * The script injected into previewed pages.
+ *
+ * Deliberately small, defensive and silent on failure: a preview that breaks
+ * the page it is previewing is worse than no preview. Everything it sends is
+ * one shape — {source:"loom-preview", kind, ...} — so the app has one reader.
+ */
+export function bridgeScript() {
+    return ascii(BRIDGE_SOURCE);
+}
+/**
+ * Pure ASCII, so it can be spliced into a page's bytes whatever ASCII-based
+ * charset the page is in (see injectBytes). Only comments and string literals
+ * ever held anything else, and \uXXXX means the same thing in both.
+ */
+function ascii(js) {
+    return js.replace(/[^\x00-\x7f]/g, (c) => "\\u" + c.charCodeAt(0).toString(16).padStart(4, "0"));
+}
+const BRIDGE_SOURCE = `<script data-${BRIDGE_MARK}="1">(function(){
+  if (window.__loomPreviewBridge) return;
+  window.__loomPreviewBridge = 1;
+  var send = function(kind, payload){
+    try { parent.postMessage({ source: "loom-preview", kind: kind, at: Date.now(), payload: payload }, "*"); } catch (e) {}
+  };
+  var text = function(v){
+    if (typeof v === "string") return v;
+    if (v instanceof Error) return v.message + (v.stack ? "\\n" + v.stack : "");
+    try { return JSON.stringify(v); } catch (e) { return String(v); }
+  };
+  ["log", "info", "warn", "error", "debug"].forEach(function(level){
+    var original = console[level];
+    console[level] = function(){
+      try {
+        send("console", { level: level, text: Array.prototype.map.call(arguments, text).join(" ").slice(0, 4000) });
+      } catch (e) {}
+      return original && original.apply(console, arguments);
+    };
+  });
+  window.addEventListener("error", function(e){
+    send("console", { level: "error", text: (e.message || "error") + (e.filename ? " (" + e.filename + ":" + e.lineno + ")" : ""), stack: e.error && e.error.stack });
+  });
+  window.addEventListener("unhandledrejection", function(e){
+    send("console", { level: "error", text: "unhandled rejection: " + text(e.reason) });
+  });
+  var fetchImpl = window.fetch;
+  if (fetchImpl) {
+    window.fetch = function(input, init){
+      var started = Date.now();
+      var url = typeof input === "string" ? input : (input && input.url) || String(input);
+      var method = (init && init.method) || (input && input.method) || "GET";
+      return fetchImpl.apply(this, arguments).then(function(res){
+        send("network", { method: method, url: url, status: res.status, ms: Date.now() - started });
+        return res;
+      }, function(err){
+        send("network", { method: method, url: url, status: 0, ms: Date.now() - started, error: text(err) });
+        throw err;
+      });
+    };
+  }
+  var open = XMLHttpRequest.prototype.open;
+  var xhrSend = XMLHttpRequest.prototype.send;
+  XMLHttpRequest.prototype.open = function(method, url){
+    this.__loom = { method: method, url: url };
+    return open.apply(this, arguments);
+  };
+  XMLHttpRequest.prototype.send = function(){
+    var self = this;
+    var started = Date.now();
+    self.addEventListener("loadend", function(){
+      var m = self.__loom || {};
+      send("network", { method: m.method || "GET", url: m.url || "", status: self.status, ms: Date.now() - started });
+    });
+    return xhrSend.apply(this, arguments);
+  };
+  // The picker: Loom asks, the page answers with what's under the cursor.
+  var picking = false, box = null, last = null;
+  var outline = function(el){
+    if (!box) {
+      box = document.createElement("div");
+      box.style.cssText = "position:fixed;z-index:2147483647;pointer-events:none;border:2px solid #4c8dff;background:rgba(76,141,255,.14);border-radius:2px";
+      document.documentElement.appendChild(box);
+    }
+    var r = el.getBoundingClientRect();
+    box.style.left = r.left + "px"; box.style.top = r.top + "px";
+    box.style.width = r.width + "px"; box.style.height = r.height + "px";
+  };
+  var selectorFor = function(el){
+    if (el.id) return "#" + el.id;
+    var parts = [];
+    var node = el;
+    for (var depth = 0; node && node.nodeType === 1 && depth < 5; depth++) {
+      var part = node.tagName.toLowerCase();
+      var testid = node.getAttribute && (node.getAttribute("data-testid") || node.getAttribute("data-test-id"));
+      if (testid) { parts.unshift(part + '[data-testid="' + testid + '"]'); break; }
+      if (node.classList && node.classList.length) part += "." + Array.prototype.slice.call(node.classList, 0, 2).join(".");
+      var parent = node.parentElement;
+      if (parent) {
+        var same = Array.prototype.filter.call(parent.children, function(c){ return c.tagName === node.tagName; });
+        if (same.length > 1) part += ":nth-of-type(" + (same.indexOf(node) + 1) + ")";
+      }
+      parts.unshift(part);
+      node = node.parentElement;
+      if (node === document.body) break;
+    }
+    return parts.join(" > ");
+  };
+  var STYLE_KEYS = ["display", "position", "width", "height", "margin", "padding", "gap", "font-family", "font-size", "font-weight",
+    "line-height", "letter-spacing", "color", "background-color", "background-image", "border", "border-radius", "box-shadow",
+    "opacity", "flex-direction", "justify-content", "align-items", "grid-template-columns", "text-align", "z-index"];
+  var styleOf = function(el){
+    var out = {};
+    try {
+      var cs = getComputedStyle(el);
+      for (var i = 0; i < STYLE_KEYS.length; i++) {
+        var k = STYLE_KEYS[i], v = cs.getPropertyValue(k);
+        // the defaults say nothing: keep what this element actually sets
+        if (!v || v === "none" || v === "normal" || v === "auto" || v === "0px" || v === "static" || v === "rgba(0, 0, 0, 0)") continue;
+        out[k] = String(v).slice(0, 160);
+      }
+    } catch (e) {}
+    return out;
+  };
+  var onMove = function(e){
+    if (!picking) return;
+    var el = e.target;
+    if (!el || el === box) return;
+    last = el;
+    outline(el);
+  };
+  var onClick = function(e){
+    if (!picking) return;
+    e.preventDefault(); e.stopPropagation();
+    var el = last || e.target;
+    var r = el.getBoundingClientRect();
+    send("picked", {
+      selector: selectorFor(el),
+      tag: el.tagName.toLowerCase(),
+      // innerText is undefined on SVG elements — an icon would answer with
+      // nothing at all, which is the click most likely to be about an icon.
+      text: String(el.innerText || el.textContent || "").trim().slice(0, 300),
+      html: (el.outerHTML || "").slice(0, 1200),
+      rect: { x: Math.round(r.left), y: Math.round(r.top), w: Math.round(r.width), h: Math.round(r.height) },
+      // Design Mode: what the agent needs to change how it looks, not just what it is
+      styles: styleOf(el),
+      viewport: { w: window.innerWidth, h: window.innerHeight },
+      url: location.href,
+    });
+    stopPicking();
+  };
+  var stopPicking = function(){
+    picking = false;
+    if (box) { box.remove(); box = null; }
+    document.removeEventListener("mousemove", onMove, true);
+    document.removeEventListener("click", onClick, true);
+  };
+  // ---- colour scheme -------------------------------------------------
+  // No API lets a parent document set another page's prefers-color-scheme.
+  // But Loom is not outside this page: the proxy served it AND its
+  // stylesheets, so the rules are readable and the media queries can be
+  // re-pointed. Pages theme in three ways, so forcing is three things:
+  // the UA's own colour-scheme, the @media rules in the CSS, and the
+  // matchMedia() a script asked. Reverting is exact — every rule remembers
+  // the media text it came with, so "auto" is the page as it shipped.
+  var forced = null;
+  var mqls = [];
+  var saved = [];
+  var reading = 0;
+  var unreadable = 0;
+  var mmReal = window.matchMedia && window.matchMedia.bind(window);
+  var wants = function(q){ return /dark/i.test(String(q)) ? "dark" : /light/i.test(String(q)) ? "light" : ""; };
+  var forceMql = function(mql, q){
+    var side = wants(q);
+    try {
+      if (forced === null || !side) { delete mql.matches; return; }
+      var v = side === forced;
+      Object.defineProperty(mql, "matches", { configurable: true, get: function(){ return v; } });
+    } catch (e) {}
+  };
+  var fire = function(mql){
+    try {
+      var ev;
+      try { ev = new MediaQueryListEvent("change", { matches: mql.matches, media: mql.media }); }
+      catch (e) { ev = new Event("change"); }
+      mql.dispatchEvent(ev);
+    } catch (e) {}
+  };
+  if (mmReal) {
+    window.matchMedia = function(q){
+      var mql = mmReal(q);
+      if (/prefers-color-scheme/i.test(String(q))) {
+        mqls.push({ mql: mql, q: q });
+        forceMql(mql, q);
+      }
+      return mql;
+    };
+  }
+  var walk = function(rules, depth){
+    if (!rules || depth > 4) return;
+    for (var i = 0; i < rules.length; i++) {
+      var rule = rules[i];
+      var media = rule.media && rule.media.mediaText;
+      if (media && /prefers-color-scheme/i.test(media)) {
+        saved.push({ rule: rule, text: media });
+        try { rule.media.mediaText = wants(media) === forced ? "all" : "not all"; }
+        catch (e) { unreadable++; }
+      }
+      if (rule.cssRules) walk(rule.cssRules, depth + 1);
+    }
+  };
+  var applyScheme = function(){
+    reading = 0; unreadable = 0;
+    // Always put the page back first, then force. A forced rule reads "all",
+    // which no longer mentions prefers-color-scheme — so a rule rewritten once
+    // can never be found again, and dark → light would have been a one-way
+    // door if this went straight to forcing.
+    for (var r = 0; r < saved.length; r++) {
+      try { saved[r].rule.media.mediaText = saved[r].text; } catch (e) { unreadable++; }
+    }
+    saved = [];
+    if (forced !== null) {
+      var sheets = document.styleSheets || [];
+      for (var i = 0; i < sheets.length; i++) {
+        try { walk(sheets[i].cssRules, 0); reading++; }
+        catch (e) { unreadable++; } // a stylesheet from somewhere Loom doesn't serve
+      }
+    }
+    try {
+      document.documentElement.style.colorScheme = forced || "";
+    } catch (e) {}
+    for (var m = 0; m < mqls.length; m++) { forceMql(mqls[m].mql, mqls[m].q); fire(mqls[m].mql); }
+    send("scheme", { scheme: forced, sheets: reading, unreadable: unreadable });
+  };
+  // A framework that hot-reloads adds stylesheets after we've forced them.
+  try {
+    var pending = null;
+    new MutationObserver(function(){
+      if (forced === null || pending) return;
+      pending = setTimeout(function(){ pending = null; applyScheme(); }, 120);
+    }).observe(document.documentElement, { childList: true, subtree: true });
+  } catch (e) {}
+
+  // Back and forward, asked for by the app's own buttons: the page is another
+  // origin, so its history is only reachable from in here.
+  var go = function(n){ try { history.go(n); } catch (e) {} };
+  window.addEventListener("message", function(e){
+    // Only the window that framed this page gives it orders — never a popup
+    // or a sibling frame. (A message with no source is a test harness.)
+    if (e.source && e.source !== parent) return;
+    var d = e.data || {};
+    if (d.source !== "loom-app") return;
+    if (d.kind === "pick") {
+      picking = true;
+      document.addEventListener("mousemove", onMove, true);
+      document.addEventListener("click", onClick, true);
+    } else if (d.kind === "cancel-pick") {
+      stopPicking();
+    } else if (d.kind === "scheme") {
+      forced = d.value === "dark" ? "dark" : d.value === "light" ? "light" : null;
+      applyScheme();
+    } else if (d.kind === "history") {
+      if (d.go === -1 || d.go === 1) go(d.go);
+    }
+  });
+  // Does this page update itself? A dev server with hot module reload swaps
+  // code in place, and a hard reload from Loom would throw its state away.
+  // The bridge runs before the page's own scripts, so ask once now and again
+  // when the page has loaded — the HMR client is one of those scripts.
+  var hmr = function(){
+    try {
+      if (window.__vite_plugin_react_preamble_installed__ || window.__vite_is_modern_browser) return "vite";
+      if (document.querySelector('script[src*="/@vite/client"],script[src*="@react-refresh"]')) return "vite";
+      if (window.webpackHotUpdate || window.__webpack_hmr || window.__NEXT_HMR_CB || window.__NEXT_DATA__ && window.next) return "webpack";
+      for (var k in window) { if (/^webpackHotUpdate/.test(k)) return "webpack"; }
+    } catch (e) {}
+    return "";
+  };
+  send("ready", { url: location.href, title: document.title, hmr: !!hmr() });
+  // A single-page app moves without loading a page: say where it went, so the
+  // address bar (and what Reload and Screenshot point at) follows.
+  var lastHref = location.href;
+  var moved = function(){
+    if (location.href === lastHref) return;
+    lastHref = location.href;
+    send("nav", { url: location.href, title: document.title });
+  };
+  ["pushState", "replaceState"].forEach(function(name){
+    var original = history[name];
+    if (typeof original !== "function") return;
+    history[name] = function(){
+      var out = original.apply(this, arguments);
+      try { moved(); } catch (e) {}
+      return out;
+    };
+  });
+  window.addEventListener("popstate", moved);
+  window.addEventListener("hashchange", moved);
+  var hmrLater = function(){ var h = hmr(); if (h) send("hmr", { hmr: true, kind: h }); };
+  if (document.readyState === "complete") setTimeout(hmrLater, 0);
+  else window.addEventListener("load", function(){ setTimeout(hmrLater, 300); });
+})();</script>`;
+/** Put the bridge first, so it sees what the page does on its way up. */
+export function injectBridge(html) {
+    const script = bridgeScript();
+    if (html.includes(`data-${BRIDGE_MARK}`))
+        return html;
+    const head = html.search(/<head[^>]*>/i);
+    if (head >= 0) {
+        const end = html.indexOf(">", head) + 1;
+        return html.slice(0, end) + script + html.slice(end);
+    }
+    const body = html.search(/<body[^>]*>/i);
+    if (body >= 0) {
+        const end = html.indexOf(">", body) + 1;
+        return html.slice(0, end) + script + html.slice(end);
+    }
+    // A fragment, or a page with neither: prepend rather than lose it.
+    return script + html;
+}
+/** A host that is this machine — the only kind the preview will stand in front of on its own. */
+export function isLoopbackHost(hostname) {
+    const h = hostname.replace(/^\[|\]$/g, "").toLowerCase();
+    return h === "localhost" || h.endsWith(".localhost") || h === "::1" || /^127(\.\d{1,3}){3}$/.test(h);
+}
+const portOf = (u) => u.port || (u.protocol === "https:" ? "443" : "80");
+/** Is `loc` the upstream itself (allowing localhost ≡ 127.0.0.1 on the same port)? */
+function isUpstream(loc, to) {
+    if (loc.origin === to.origin)
+        return true;
+    return loc.protocol === to.protocol && portOf(loc) === portOf(to) && isLoopbackHost(loc.hostname) && isLoopbackHost(to.hostname);
+}
+/**
+ * A redirect the dev server sent with its own absolute address would walk the
+ * frame off the proxy (and lose the bridge). Point it back through us.
+ */
+export function rewriteLocation(location, target, proxyOrigin) {
+    let loc;
+    try {
+        loc = new URL(location, target);
+    }
+    catch {
+        return location;
+    }
+    if (!/^([a-z][a-z0-9+.-]*:)?\/\//i.test(location))
+        return location; // a path: already ours
+    if (!isUpstream(loc, new URL(target)))
+        return location;
+    return proxyOrigin + loc.pathname + loc.search + loc.hash;
+}
+/**
+ * Will a browser show this page inside a frame on another origin? Read off the
+ * two headers that decide it, so a page that refuses can be said to refuse
+ * instead of leaving a white rectangle.
+ */
+export function frameability(xFrameOptions, csp) {
+    const xfo = (xFrameOptions ?? "").trim().toLowerCase();
+    if (xfo === "deny" || xfo === "sameorigin")
+        return { frameable: false, reason: `X-Frame-Options: ${xfo.toUpperCase()}` };
+    for (const policy of (csp ?? "").split(",")) {
+        const directive = policy.split(";").map((d) => d.trim()).find((d) => /^frame-ancestors(\s|$)/i.test(d));
+        if (!directive)
+            continue;
+        const sources = directive.split(/\s+/).slice(1);
+        // only a wildcard lets an unrelated app frame it; 'self', 'none' or a list of hosts don't
+        if (!sources.some((x) => x === "*" || /^https?:$/i.test(x))) {
+            return { frameable: false, reason: `Content-Security-Policy: ${directive}` };
+        }
+    }
+    return { frameable: true, reason: "" };
+}
+/** Charsets whose bytes for `<`, `h`, `e`… are ASCII's — the bridge can be spliced into them as bytes. */
+const ASCII_BASED = /^(utf-?8|us-ascii|ascii|iso-?8859-\d+|latin-?1|windows-125\d|cp125\d|koi8-[ru]|shift_jis|sjis|euc-jp|euc-kr|gbk|gb2312|gb18030|big5)$/i;
+/**
+ * The bridge, in a page given as bytes. Decoding as latin1 maps every byte to
+ * one code unit and back, so whatever the page's own encoding, every byte that
+ * isn't the script comes out exactly as it went in.
+ */
+export function injectBytes(body, contentType) {
+    const charset = /charset\s*=\s*"?([^";\s]+)/i.exec(contentType)?.[1];
+    if (charset && !ASCII_BASED.test(charset))
+        return null; // UTF-16 and friends: leave it be
+    // A byte-order mark for UTF-16/32 means the same, whatever the header said.
+    if (body.length >= 2 && ((body[0] === 0xfe && body[1] === 0xff) || (body[0] === 0xff && body[1] === 0xfe)))
+        return null;
+    return Buffer.from(injectBridge(body.toString("latin1")), "latin1");
+}
+/**
+ * Stand in front of `target` (http(s)://host:port) on a port of our own.
+ *
+ * Everything is forwarded as-is except HTML, which gets the bridge. The
+ * WebSocket upgrade is forwarded too — a framework's hot reload rides on it,
+ * and a preview that kills HMR would be a downgrade from an iframe.
+ *
+ * An https upstream is spoken to over TLS; a self-signed certificate is
+ * accepted only from this machine (a dev server's mkcert or vite's basic-ssl),
+ * never from anywhere else.
+ */
+export async function startPreviewProxy(target, host = "127.0.0.1") {
+    const to = new URL(target);
+    const secure = to.protocol === "https:";
+    if (!secure && to.protocol !== "http:")
+        throw new Error(`can't preview ${to.protocol} — only http and https`);
+    const lib = secure ? https : http;
+    const upstreamHost = to.hostname.replace(/^\[|\]$/g, "");
+    const upstreamPort = Number(portOf(to));
+    const tls = secure ? { rejectUnauthorized: !isLoopbackHost(to.hostname), servername: net.isIP(upstreamHost) ? undefined : upstreamHost } : {};
+    let ownPort = 0;
+    const proxyOrigin = (req) => `http://${req.headers.host ?? `${host}:${ownPort}`}`;
+    /** The browser's headers, as the upstream expects to see them. */
+    const forwardHeaders = (req) => {
+        const headers = { ...req.headers, host: to.host };
+        // A server checking Origin/Referer (CSRF, CORS) should see itself, not us.
+        const self = proxyOrigin(req);
+        for (const k of ["origin", "referer"]) {
+            const v = req.headers[k];
+            if (typeof v === "string" && v.startsWith(self))
+                headers[k] = to.origin + v.slice(self.length);
+        }
+        return headers;
+    };
+    const server = http.createServer((req, res) => {
+        const upstream = lib.request({
+            host: upstreamHost,
+            port: upstreamPort,
+            method: req.method,
+            path: req.url,
+            headers: { ...forwardHeaders(req), "accept-encoding": "identity" },
+            ...tls,
+        }, (up) => {
+            const status = up.statusCode ?? 200;
+            const headers = { ...up.headers };
+            if (typeof headers.location === "string")
+                headers.location = rewriteLocation(headers.location, to.href, proxyOrigin(req));
+            const type = String(headers["content-type"] ?? "");
+            const html = /text\/html/i.test(type);
+            if (html) {
+                // The page must not be embedded-blocked by its own dev server.
+                delete headers["x-frame-options"];
+                delete headers["content-security-policy"];
+            }
+            const encoded = !!headers["content-encoding"] && headers["content-encoding"] !== "identity";
+            // Nothing to put a script into: not a page, no body, or one we can't read.
+            if (!html || encoded || req.method === "HEAD" || status === 204 || status === 304 || (status >= 100 && status < 200)) {
+                res.writeHead(status, headers);
+                up.pipe(res);
+                return;
+            }
+            const chunks = [];
+            up.on("data", (c) => chunks.push(c));
+            up.on("end", () => {
+                const raw = Buffer.concat(chunks);
+                const body = injectBytes(raw, type) ?? raw;
+                // We buffered it to inject, so the framing is ours now: a chunked
+                // header kept beside a content-length is an invalid response, and
+                // the browser drops the page rather than showing it.
+                delete headers["content-length"];
+                delete headers["transfer-encoding"];
+                res.writeHead(status, { ...headers, "content-length": body.length });
+                res.end(body);
+            });
+        });
+        upstream.on("error", (err) => {
+            if (res.headersSent)
+                return void res.end();
+            res.writeHead(502, { "content-type": "text/plain" });
+            res.end(`loom preview: the server didn't answer (${err.message})`);
+        });
+        // A server that accepts the connection and then says nothing would hold
+        // the preview open for ever. Say so instead.
+        upstream.setTimeout(UPSTREAM_TIMEOUT_MS, () => {
+            upstream.destroy();
+            if (res.headersSent)
+                return void res.end();
+            res.writeHead(504, { "content-type": "text/plain" });
+            res.end("loom preview: the server accepted the connection but never answered");
+        });
+        Readable.from(req).pipe(upstream);
+    });
+    // An upgraded socket is nobody's connection once it's hijacked: server.close()
+    // waits for it for ever unless we keep the pair and end them ourselves.
+    const upgraded = new Set();
+    // HMR and anything else the page opens a socket for.
+    server.on("upgrade", (req, socket, head) => {
+        upgraded.add(socket);
+        socket.on("close", () => upgraded.delete(socket));
+        const up = lib.request({
+            host: upstreamHost,
+            port: upstreamPort,
+            method: req.method,
+            path: req.url,
+            headers: forwardHeaders(req),
+            // A pooled agent never surfaces the upgrade — the socket has to be ours.
+            agent: false,
+            ...tls,
+        });
+        up.on("upgrade", (upRes, upSocket, upHead) => {
+            socket.write(`HTTP/1.1 101 Switching Protocols\r\n${Object.entries(upRes.headers)
+                .map(([k, v]) => `${k}: ${Array.isArray(v) ? v.join(", ") : v}`)
+                .join("\r\n")}\r\n\r\n`);
+            // Whatever the server sent in the same packet as its 101 goes OUT to the
+            // client — unshifting it would feed the server's bytes back in as if the
+            // client had sent them, and the first hot-reload message would vanish.
+            if (upHead?.length)
+                socket.write(upHead);
+            upgraded.add(upSocket);
+            upSocket.on("close", () => upgraded.delete(upSocket));
+            upSocket.pipe(socket);
+            socket.pipe(upSocket);
+            upSocket.on("error", () => socket.destroy());
+            socket.on("error", () => upSocket.destroy());
+        });
+        // Refused the upgrade: hand its answer back rather than hanging up mute.
+        up.on("response", (upRes) => {
+            socket.end(`HTTP/1.1 ${upRes.statusCode ?? 502} ${upRes.statusMessage ?? ""}\r\nconnection: close\r\n\r\n`);
+            upRes.resume();
+        });
+        up.on("error", () => socket.destroy());
+        if (head?.length)
+            up.write(head);
+        up.end();
+    });
+    const port = await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, host, () => resolve(server.address().port));
+    });
+    ownPort = port;
+    return {
+        port,
+        target,
+        close: () => new Promise((resolve) => {
+            for (const s of upgraded)
+                s.destroy();
+            upgraded.clear();
+            server.closeAllConnections?.();
+            server.close(() => resolve());
+        }),
+    };
+}
+//# sourceMappingURL=preview-proxy.js.map

package/dist/core/preview-proxy.js.map

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

package/dist/core/preview-shot.d.ts

@@ -0,0 +1,46 @@
+/**
+ * A picture of the page Loom is previewing.
+ *
+ * The preview is an iframe pointing at someone else's origin, so the browser
+ * will not let the page photograph it — and a person who can see the bug on
+ * screen shouldn't have to describe it in words. The daemon takes the shot
+ * instead, with the Playwright the project already has for its specs, and the
+ * file lands where attachments live so the composer can carry it like any
+ * pasted image.
+ *
+ * A project without Playwright is told so plainly rather than handed an empty
+ * file: `npx --no-install` never installs anything behind your back.
+ */
+import { spawn } from "./process.js";
+export interface ShotRequest {
+    url: string;
+    width?: number;
+    height?: number;
+    /** What the page should think the OS is set to. */
+    colorScheme?: "light" | "dark";
+    fullPage?: boolean;
+    /** Just this element (a CSS selector from the preview's picker): its own picture, cropped. */
+    selector?: string;
+    timeoutMs?: number;
+}
+export declare const MAX_SHOT_MS = 45000;
+/** The little script Playwright runs. Kept here so what it does is readable. */
+export declare function shotScript(req: Required<Omit<ShotRequest, "timeoutMs" | "selector">> & {
+    selector?: string;
+    out: string;
+}): string;
+export interface ShotResult {
+    /** Where the PNG landed, absolute. */
+    file: string;
+    width: number;
+    height: number;
+    colorScheme: "light" | "dark";
+    fullPage: boolean;
+}
+/**
+ * Take the shot in `projectDir` (so the project's own Playwright and browsers
+ * are the ones used). Rejects with something a person can act on.
+ */
+export declare function capture(projectDir: string, req: ShotRequest, spawnImpl?: typeof spawn): Promise<ShotResult>;
+/** Playwright's failures, in words that say what to do. */
+export declare function explain(stderr: string): string;