@fluid-app/fluid-cli-theme-dev 0.1.35 → 0.1.37

package/dist/index.mjs

@@ -6,6 +6,7 @@ import { createHash } from "node:crypto";
 import http from "node:http";
 import https from "node:https";
 import chokidar from "chokidar";
+import net from "node:net";
 import chalk from "chalk";
 import prompts from "prompts";
 import ora from "ora";
@@ -1621,6 +1622,46 @@ var Syncer = class {
 	}
 };
 //#endregion
+//#region src/theme/dev-server/port-preflight.ts
+/**
+* The dev command does real work before it ever binds a port: it resolves
+* (or creates) a server-side dev theme and runs a full initial sync, which
+* can take minutes on a large theme. If the requested port is already taken
+* — most commonly by another `fluid theme dev` or the Mist Desktop preview,
+* which both default to 9292 — all of that work is wasted and the process
+* used to die with a raw `EADDRINUSE` stack trace. Call this before any of
+* that work starts so we fail fast with a clear message instead.
+*/
+var PortInUseError = class extends Error {
+	constructor(host, port) {
+		super(formatPortConflictMessage(host, port));
+		this.host = host;
+		this.port = port;
+		this.name = "PortInUseError";
+	}
+};
+function formatPortConflictMessage(host, port) {
+	return `Port ${port} on ${host} is already in use — likely another \`fluid theme dev\` or the Mist Desktop preview. Stop the other server or pass --port <number>.`;
+}
+/**
+* Attempt to bind `host:port`, then immediately release it. Resolves if the
+* port is free; rejects with `PortInUseError` on `EADDRINUSE`/`EACCES`, or
+* the raw error for anything else unexpected.
+*/
+function checkPortAvailable(host, port) {
+	return new Promise((resolve, reject) => {
+		const server = net.createServer();
+		server.once("error", (err) => {
+			if (err.code === "EADDRINUSE" || err.code === "EACCES") reject(new PortInUseError(host, port));
+			else reject(err);
+		});
+		server.once("listening", () => {
+			server.close(() => resolve());
+		});
+		server.listen(port, host);
+	});
+}
+//#endregion
 //#region src/theme/dev-server/index.ts
 async function startDevServer(api, theme, themeRoot, opts, onReady) {
 	const sse = new SSEStream();
@@ -1689,8 +1730,14 @@ async function startDevServer(api, theme, themeRoot, opts, onReady) {
 		}
 	});
 	await new Promise((resolve, reject) => {
+		server.once("error", (err) => {
+			if (err.code === "EADDRINUSE" || err.code === "EACCES") {
+				console.error(formatPortConflictMessage(opts.host, opts.port));
+				process.exit(1);
+			}
+			reject(err);
+		});
 		server.listen(opts.port, opts.host, () => resolve());
-		server.on("error", reject);
 	});
 	const address = `http://${opts.host}:${opts.port}`;
 	onReady?.(address);
@@ -1905,6 +1952,13 @@ function createDevCommand() {
 			console.error(`Invalid port: '${opts.port}'. Must be an integer between 1 and 65535.`);
 			process.exit(1);
 		}
+		try {
+			await checkPortAvailable(opts.host, port);
+		} catch (e) {
+			if (e instanceof PortInUseError) console.error(e.message);
+			else console.error(`Failed to check port availability: ${e}`);
+			process.exit(1);
+		}
 		const reloadMode = opts.liveReload === "off" ? "off" : "full-page";
 		const api = createApiClient();
 		const config = readThemeConfig(themeRoot.root);