vue-ssr-lite 0.1.8 → 0.1.9

package/README.md

@@ -45,11 +45,15 @@ It includes routing, browser hydration, production builds, a managed Node server
 CLI binary:
 
 ```bash
-vue-ssr-lite <dev|build|start> [--root .] [--runtime src/SsrRuntime.ts] [--server-output dist/server/SsrRuntime.js]
+vue-ssr-lite <dev|build|start> [--root .] [--runtime src/SsrRuntime.ts] [--server-output dist/server/SsrRuntime.js] [--hmr-port 31001]
 ```
 
 Requires Node.js 20 or newer.
 
+Development servers use an operating-system-assigned HMR WebSocket port, so
+multiple `vue-ssr-lite dev` processes can run concurrently. Use `--hmr-port`
+or `VUE_SSR_LITE_HMR_PORT` when a proxy or container requires a fixed port.
+
 ## Installation
 
 ```bash

package/dist/cli/SsrCliHmrPort.d.ts

@@ -0,0 +1,4 @@
+export declare const parseSsrCliHmrPort: (value?: string) => number | undefined;
+export declare const findAvailableSsrCliHmrPort: () => Promise<number>;
+export declare const resolveSsrCliHmrPort: (value?: string) => Promise<number>;
+//# sourceMappingURL=SsrCliHmrPort.d.ts.map

package/dist/cli/SsrCliHmrPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SsrCliHmrPort.d.ts","sourceRoot":"","sources":["../../src/cli/SsrCliHmrPort.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAY5D,CAAA;AAED,eAAO,MAAM,0BAA0B,uBAerC,CAAA;AAEF,eAAO,MAAM,oBAAoB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,CACf,CAAA"}

package/dist/cli.mjs

@@ -1,71 +1,97 @@
 #!/usr/bin/env node
-import { resolve as o, relative as m } from "node:path";
-import { pathToFileURL as v } from "node:url";
-import { c as p } from "./chunks/SsrServerRuntime-ChrpJneS.mjs";
-const s = (e, r) => {
-  const t = e.indexOf(r);
-  return t >= 0 ? e[t + 1] : void 0;
-}, f = (e) => {
-  const r = e[0];
-  if (!["dev", "build", "start"].includes(r))
+import { resolve as i, relative as w } from "node:path";
+import { pathToFileURL as f } from "node:url";
+import { c as S } from "./chunks/SsrServerRuntime-ChrpJneS.mjs";
+import { createServer as b } from "node:net";
+const a = 1, c = 65535, R = (r) => {
+  const e = r?.trim();
+  if (!e) return;
+  if (!/^\d+$/.test(e))
+    throw new Error(`HMR port must be an integer between ${a} and ${c}.`);
+  const t = Number(e);
+  if (!Number.isInteger(t) || t < a || t > c)
+    throw new Error(`HMR port must be an integer between ${a} and ${c}.`);
+  return t;
+}, h = () => new Promise((r, e) => {
+  const t = b();
+  t.once("error", e), t.listen({ port: 0, exclusive: !0 }, () => {
+    const o = t.address();
+    if (!o || typeof o == "string") {
+      t.close(), e(new Error("Unable to allocate an HMR WebSocket port."));
+      return;
+    }
+    t.close((s) => {
+      s ? e(s) : r(o.port);
+    });
+  });
+}), P = async (r) => R(r) ?? h(), n = (r, e) => {
+  const t = r.indexOf(e);
+  return t >= 0 ? r[t + 1] : void 0;
+}, T = (r) => {
+  const e = r[0];
+  if (!["dev", "build", "start"].includes(e))
     throw new Error(
-      "Usage: vue-ssr-lite <dev|build|start> [--root .] [--runtime src/SsrRuntime.ts]"
+      "Usage: vue-ssr-lite <dev|build|start> [--root .] [--runtime src/SsrRuntime.ts] [--hmr-port 31001]"
     );
-  const t = o(s(e, "--root") || process.cwd());
+  const t = i(n(r, "--root") || process.cwd());
   return {
-    command: r,
+    command: e,
     root: t,
-    runtime: o(t, s(e, "--runtime") || "src/SsrRuntime.ts"),
-    serverOutput: o(
+    runtime: i(t, n(r, "--runtime") || "src/SsrRuntime.ts"),
+    serverOutput: i(
       t,
-      s(e, "--server-output") || "dist/server/SsrRuntime.js"
-    )
+      n(r, "--server-output") || "dist/server/SsrRuntime.js"
+    ),
+    hmrPort: n(r, "--hmr-port") || process.env.VUE_SSR_LITE_HMR_PORT
   };
-}, w = async (e, r) => {
-  const t = r ? void 0 : (await import("vite")).createServer, i = r ? void 0 : await t({
-    root: e.root,
-    server: { middlewareMode: !0 },
+}, M = async (r, e) => {
+  const t = e ? void 0 : await P(r.hmrPort), o = e ? void 0 : (await import("vite")).createServer, s = e ? void 0 : await o({
+    root: r.root,
+    server: {
+      middlewareMode: !0,
+      hmr: { port: t, clientPort: t }
+    },
     appType: "custom"
-  }), u = `/${m(e.root, e.runtime).replaceAll("\\", "/")}`, a = await p({
-    production: r,
-    root: e.root,
-    vite: i,
-    loadRuntime: r ? () => import(v(e.serverOutput).href) : () => i.ssrLoadModule(u)
+  }), d = `/${w(r.root, r.runtime).replaceAll("\\", "/")}`, l = await S({
+    production: e,
+    root: r.root,
+    vite: s,
+    loadRuntime: e ? () => import(f(r.serverOutput).href) : () => s.ssrLoadModule(d)
   });
-  await a.listen();
-  let n = !1;
-  const c = async (d) => {
-    if (!n) {
-      n = !0;
+  await l.listen();
+  let u = !1;
+  const m = async (p) => {
+    if (!u) {
+      u = !0;
       try {
-        await a.close(), console.log(`stopped after ${d}`), process.exitCode = 0;
-      } catch (l) {
-        console.error("graceful shutdown failed", l), process.exitCode = 1;
+        await l.close(), console.log(`stopped after ${p}`), process.exitCode = 0;
+      } catch (v) {
+        console.error("graceful shutdown failed", v), process.exitCode = 1;
       }
     }
   };
   process.once("SIGINT", () => {
-    c("SIGINT");
+    m("SIGINT");
   }), process.once("SIGTERM", () => {
-    c("SIGTERM");
+    m("SIGTERM");
   });
-}, S = async (e) => {
-  const { build: r } = await import("vite");
-  await r({ root: e.root }), await r({
-    root: e.root,
+}, y = async (r) => {
+  const { build: e } = await import("vite");
+  await e({ root: r.root }), await e({
+    root: r.root,
     build: {
-      ssr: e.runtime,
-      outDir: o(e.root, "dist/server"),
+      ssr: r.runtime,
+      outDir: i(r.root, "dist/server"),
       emptyOutDir: !0,
       rollupOptions: {
         output: { entryFileNames: "SsrRuntime.js" }
       }
     }
   });
-}, y = async () => {
-  const e = f(process.argv.slice(2));
-  return e.command === "build" ? S(e) : w(e, e.command === "start");
+}, I = async () => {
+  const r = T(process.argv.slice(2));
+  return r.command === "build" ? y(r) : M(r, r.command === "start");
 };
-y().catch((e) => {
-  console.error("fatal error", e), process.exitCode = 1;
+I().catch((r) => {
+  console.error("fatal error", r), process.exitCode = 1;
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vue-ssr-lite",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Vue 3 SSR runtime with routing, generic plugin hydration, Vite, and Node server lifecycle.",
   "license": "MIT",
   "type": "module",