@junejs/server 0.0.4 → 0.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junejs/server",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "June host adapters + dev server. Host-coupled; depends on the pure @junejs/core contract layer.",
   "type": "module",
   "license": "MIT",
@@ -29,7 +29,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@junejs/core": "0.0.4",
+    "@junejs/core": "0.0.5",
     "marked": "^18.0.5"
   },
   "peerDependencies": {

package/src/dev.ts

@@ -4,6 +4,8 @@
 // work), load june.config.ts from the app root (the config the PoC forgot to
 // read), build the app, and serve through the detected JuneHost.
 
+import { createServer as createNetServer } from "node:net";
+
 import { loadJuneConfig } from "./config-loader";
 import { installAsyncContext } from "./instrumentation";
 import { createApp } from "./app";
@@ -18,6 +20,21 @@ export type DevServerOptions = {
 
 export type DevServer = ServeHandle & { url: string };
 
+// A taken default port must not be a dead end in dev — walk forward until a
+// port binds (the Vite convention). Probed with node:net, which both hosts
+// implement, so the host interface stays untouched.
+async function findFreePort(start: number, tries = 20): Promise<number> {
+  for (let p = start; p < start + tries; p++) {
+    const free = await new Promise<boolean>((resolve) => {
+      const probe = createNetServer();
+      probe.once("error", () => resolve(false));
+      probe.listen(p, () => probe.close(() => resolve(true)));
+    });
+    if (free) return p;
+  }
+  throw new Error(`june dev: no free port between ${start} and ${start + tries - 1}`);
+}
+
 export async function startDevServer({
   appDir,
   port = 3000,
@@ -28,6 +45,10 @@ export async function startDevServer({
   const app = createApp({ appDir, config });
   await app.warmup();
 
+  const freePort = await findFreePort(port);
+  if (freePort !== port) console.log(`[june] port ${port} is taken → using ${freePort}`);
+  port = freePort;
+
   // Live reload wraps the DEV SERVER only — the pipeline (and therefore
   // dev/built parity) never sees it. See dev-reload.ts.
   const handle = host.serve(withLiveReload((req) => app.fetch(req)), {