vue-ssr-lite 0.2.14 → 0.2.15

package/README.md

@@ -42,12 +42,19 @@ It includes routing, browser hydration, production builds, a managed Node server
 | `vue-ssr-lite/server` | Managed Node server, config compile, host matching, cookies |
 | `vue-ssr-lite/vite` | Vite plugin that wires HTML templates and virtual client entries |
 
-CLI binary (auto-discovers `ssr.config.ts|.mts|.js|.mjs` in the project root):
+CLI binary:
 
 ```bash
 vue-ssr-lite <dev|build|start> [--root .] [--config ssr.config.ts] [--server-output dist/server/SsrRuntime.js] [--hmr-port 31001]
 ```
 
+- `dev` / `build` auto-discover `ssr.config.ts|.mts|.js|.mjs` in the project root
+  (or take `--config`).
+- `start` loads the baked production runtime
+  (`dist/server/SsrRuntime.js` or `--server-output`) and does **not** require
+  source `ssr.config.*` in the working directory — slim Docker images only need
+  `package.json`, production `node_modules`, and `dist/`.
+
 Requires Node.js 20 or newer.
 
 Development servers use an operating-system-assigned HMR WebSocket port, so

package/dist/cli/SsrCliOptions.d.ts

@@ -0,0 +1,22 @@
+export type SsrCliCommand = 'dev' | 'build' | 'start';
+export interface SsrCliOptions {
+    command: SsrCliCommand;
+    root: string;
+    /**
+     * Absolute path to `ssr.config.*`. Present for `dev` / `build` only —
+     * production `start` loads the baked runtime and never reads source config.
+     */
+    config?: string;
+    serverOutput: string;
+    hmrPort?: string;
+}
+/**
+ * Parse CLI argv for `vue-ssr-lite <dev|build|start>`.
+ *
+ * - `dev` / `build` discover (or accept `--config`) source `ssr.config.*`.
+ * - `start` only requires the baked server bundle (`--server-output` or
+ *   `dist/server/SsrRuntime.js`) so slim production images need not COPY
+ *   source config.
+ */
+export declare const parseSsrCliArguments: (args: string[]) => Promise<SsrCliOptions>;
+//# sourceMappingURL=SsrCliOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SsrCliOptions.d.ts","sourceRoot":"","sources":["../../src/cli/SsrCliOptions.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAA;AAErD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAqBD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EAAE,KACb,OAAO,CAAC,aAAa,CAgCvB,CAAA"}

package/dist/cli.mjs

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

package/package.json

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