buildful 0.2.0

package/cli.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import http from "node:http";
+import https from "node:https";
+import open from "open";
+
+const [command, token, ...args] = process.argv.slice(2);
+const portIndex = args.indexOf("--port");
+const port = Number(portIndex >= 0 ? args[portIndex + 1] : 3000);
+const apiIndex = args.indexOf("--api");
+const api = apiIndex >= 0 ? args[apiIndex + 1] : "https://buildful.ai";
+
+if (command !== "preview" || !token || !Number.isInteger(port) || port < 1 || port > 65535) {
+  console.error("Usage: buildful preview <token> [--port 3000]");
+  process.exit(1);
+}
+
+let server;
+let stopToken;
+let shuttingDown = false;
+
+function openBrowser(url) {
+  void open(url).catch((error) => {
+    console.error(`Could not open the preview in your browser: ${error.message}`);
+  });
+}
+
+async function stopPreview() {
+  server?.close();
+  try {
+    const stopResponse = await fetch(new URL("/api/preview/stop", api), {
+      method: "POST",
+      headers: { authorization: `Bearer ${stopToken}` },
+      signal: AbortSignal.timeout(15_000),
+    });
+    if (!stopResponse.ok) throw new Error(`stop request returned ${stopResponse.status}`);
+    console.log("Preview sandbox stopped.");
+    process.exit(0);
+  } catch (error) {
+    console.error(`Could not stop preview sandbox: ${error.message}`);
+    console.error("It will stop automatically when its 45-minute timeout expires.");
+    process.exit(1);
+  }
+}
+
+function shutdown(signal) {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  console.log(`\n${signal === "SIGINT" ? "Ctrl+C received" : "Shutdown requested"}. Stopping preview sandbox…`);
+  if (stopToken) void stopPreview();
+}
+
+process.on("SIGINT", () => void shutdown("SIGINT"));
+process.on("SIGTERM", () => void shutdown("SIGTERM"));
+
+console.log("Starting a dedicated preview sandbox. This can take a few minutes…");
+const response = await fetch(new URL("/api/preview/resolve", api), {
+  method: "POST",
+  headers: { authorization: `Bearer ${token}` },
+});
+if (!response.ok) {
+  const result = await response.json().catch(() => ({}));
+  throw new Error(result.error || `Could not resolve preview (${response.status}).`);
+}
+const preview = await response.json();
+stopToken = preview.stopToken;
+if (shuttingDown) {
+  await stopPreview();
+}
+const { target, expiresAt } = preview;
+const upstream = new URL(target);
+
+server = http.createServer((request, reply) => {
+  const localOrigin = `http://localhost:${port}`;
+  const headers = {
+    ...request.headers,
+    host: upstream.host,
+    "x-forwarded-host": `localhost:${port}`,
+    "x-forwarded-proto": "http",
+  };
+  const proxy = https.request(new URL(request.url || "/", upstream), {
+    method: request.method,
+    headers,
+  }, (upstreamResponse) => {
+    const responseHeaders = { ...upstreamResponse.headers };
+    if (typeof responseHeaders.location === "string") {
+      responseHeaders.location = responseHeaders.location.replace(upstream.origin, localOrigin);
+    }
+    reply.writeHead(upstreamResponse.statusCode || 502, responseHeaders);
+    upstreamResponse.pipe(reply);
+  });
+  proxy.on("error", (error) => {
+    if (!reply.headersSent) reply.writeHead(502);
+    reply.end(`Preview unavailable: ${error.message}`);
+  });
+  request.pipe(proxy);
+});
+
+server.on("upgrade", (request, socket, head) => {
+  const proxy = https.request({
+    hostname: upstream.hostname,
+    port: 443,
+    path: request.url,
+    method: "GET",
+    headers: {
+      ...request.headers,
+      host: upstream.host,
+      "x-forwarded-host": `localhost:${port}`,
+      "x-forwarded-proto": "http",
+      connection: "Upgrade",
+      upgrade: request.headers.upgrade || "websocket",
+    },
+  });
+  proxy.on("upgrade", (response, upstreamSocket, upstreamHead) => {
+    socket.write(`HTTP/1.1 101 Switching Protocols\r\n${Object.entries(response.headers).map(([key, value]) => `${key}: ${value}`).join("\r\n")}\r\n\r\n`);
+    if (head.length) upstreamSocket.write(head);
+    if (upstreamHead.length) socket.write(upstreamHead);
+    upstreamSocket.pipe(socket).pipe(upstreamSocket);
+  });
+  proxy.on("error", () => socket.destroy());
+  proxy.end();
+});
+
+server.listen(port, "127.0.0.1", () => {
+  const url = `http://localhost:${port}`;
+  console.log(`Buildful preview: ${url}`);
+  console.log(`Available until ${new Date(expiresAt).toLocaleString()}. Press Ctrl+C to stop.`);
+  openBrowser(url);
+});

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "buildful",
+  "version": "0.2.0",
+  "description": "Connect a local port to a Buildful sandbox preview",
+  "type": "module",
+  "bin": {
+    "buildful": "cli.js"
+  },
+  "files": [
+    "cli.js"
+  ],
+  "dependencies": {
+    "open": "^10.2.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}