vue-ssr-lite 0.2.12 → 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/SsrCliBuildOptions.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Vite 7 `resolveRollupOptions` path-resolves a string `build.ssr` entry against
+ * the project root. Virtual ids such as `virtual:vue-ssr-lite/runtime` become
+ * filesystem paths like `<root>/virtual:vue-ssr-lite/runtime`, so plugin
+ * `resolveId` never matches and Rollup reports `UNRESOLVED_ENTRY`.
+ *
+ * Pass the virtual module through `rollupOptions.input` with `build.ssr: true`
+ * instead — that path is not filesystem-resolved.
+ */
+export declare const createSsrProductionViteBuildOptions: (root: string) => {
+    root: string;
+    build: {
+        ssr: true;
+        outDir: string;
+        emptyOutDir: boolean;
+        rollupOptions: {
+            input: string;
+            output: {
+                entryFileNames: string;
+            };
+        };
+    };
+};
+//# sourceMappingURL=SsrCliBuildOptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SsrCliBuildOptions.d.ts","sourceRoot":"","sources":["../../src/cli/SsrCliBuildOptions.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,eAAO,MAAM,mCAAmC,GAAI,MAAM,MAAM;;;;;;;;;;;;;CAW9D,CAAA"}

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,98 +1,116 @@
 #!/usr/bin/env node
-import { resolve as c } from "node:path";
-import { pathToFileURL as f } from "node:url";
-import { r as w, S as u } from "./chunks/SsrHtmlRuntime-BJUxjM2F.mjs";
+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";
-const i = 1, a = 65535, b = (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;
-}, h = () => new Promise((r, e) => {
-  const t = R();
-  t.once("error", e), t.listen({ port: 0, exclusive: !0 }, () => {
-    const o = t.address();
+import { access as h } from "node:fs/promises";
+const b = (r) => ({
+  root: r,
+  build: {
+    ssr: !0,
+    outDir: d(r, "dist/server"),
+    emptyOutDir: !0,
+    rollupOptions: {
+      input: m,
+      output: { entryFileNames: "SsrRuntime.js" }
+    }
+  }
+}), 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);
     });
   });
-}), P = async (r) => b(r) ?? h(), n = (r, e) => {
-  const t = r.indexOf(e);
-  return t >= 0 ? r[t + 1] : void 0;
-}, T = 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
   };
-}, g = 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({
+}, 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(u)
+    loadRuntime: t ? () => import(v(r.serverOutput).href) : () => s.ssrLoadModule(m)
   });
-  await l.listen();
-  let d = !1;
-  const m = 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", () => {
-    m("SIGINT");
+    l("SIGINT");
   }), process.once("SIGTERM", () => {
-    m("SIGTERM");
-  });
-}, I = async (r) => {
-  const { build: e } = await import("vite");
-  await e({ root: r.root }), await e({
-    root: r.root,
-    build: {
-      ssr: u,
-      outDir: c(r.root, "dist/server"),
-      emptyOutDir: !0,
-      rollupOptions: {
-        output: { entryFileNames: "SsrRuntime.js" }
-      }
-    }
+    l("SIGTERM");
   });
-}, M = async () => {
-  const r = await T(process.argv.slice(2));
-  return r.command === "build" ? I(r) : g(r, r.command === "start");
+}, M = async (r) => {
+  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");
 };
-M().catch((r) => {
+C().catch((r) => {
   console.error("fatal error", r), process.exitCode = 1;
 });

package/dist/vite/SsrVitePlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SsrVitePlugin.d.ts","sourceRoot":"","sources":["../../src/vite/SsrVitePlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAA;AAEjD,OAAO,EAQL,KAAK,uBAAuB,EAE7B,MAAM,4BAA4B,CAAA;AAGnC,YAAY,EAAE,uBAAuB,EAAE,CAAA;AAEvC,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;CACpC;AAuBD,eAAO,MAAM,UAAU,GAAI,UAAS,oBAAyB,KAAG,MAmJ/D,CAAA"}
+{"version":3,"file":"SsrVitePlugin.d.ts","sourceRoot":"","sources":["../../src/vite/SsrVitePlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,MAAM,CAAA;AAEjD,OAAO,EAQL,KAAK,uBAAuB,EAE7B,MAAM,4BAA4B,CAAA;AAGnC,YAAY,EAAE,uBAAuB,EAAE,CAAA;AAEvC,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;CACpC;AAgCD,eAAO,MAAM,UAAU,GAAI,UAAS,oBAAyB,KAAG,MAsJ/D,CAAA"}

package/dist/vite.mjs

@@ -1,16 +1,16 @@
 import { resolve as d } from "node:path";
-import { normalizePath as S } from "vite";
-import { r as R, k as C, a as m, S as _, n as D, h as $, p as O, j as T } from "./chunks/SsrHtmlRuntime-BJUxjM2F.mjs";
+import { normalizePath as g } from "vite";
+import { r as _, k as $, a as m, S, n as D, h as C, p as O, j as T } from "./chunks/SsrHtmlRuntime-BJUxjM2F.mjs";
 const L = [
   "@vue/server-renderer",
   "vue",
   "vue-router",
   "vue-ssr-lite"
-], h = `\0${_}`, p = `\0${m}`, f = "dist/client", U = /<script\b(?=[^>]*\btype\s*=\s*["']module["'])(?=[^>]*\bsrc\s*=\s*["'][^"']+["'])[^>]*>\s*<\/script>/gi, b = (a, r) => {
-  const n = S(a);
-  return r && n === S(r) ? !0 : /\/ssr\.config\.(ts|mts|js|mjs)$/.test(n);
-}, F = (a = {}) => {
-  let r = d(a.root || process.cwd()), n = "", o = null, E = f;
+], I = `\0${S}`, p = `\0${m}`, f = "dist/client", U = (r) => r === S || r.endsWith(`/${S}`) || r.endsWith(`\\${S}`), b = /<script\b(?=[^>]*\btype\s*=\s*["']module["'])(?=[^>]*\bsrc\s*=\s*["'][^"']+["'])[^>]*>\s*<\/script>/gi, N = (r, n) => {
+  const i = g(r);
+  return n && i === g(n) ? !0 : /\/ssr\.config\.(ts|mts|js|mjs)$/.test(i);
+}, P = (r = {}) => {
+  let n = d(r.root || process.cwd()), i = "", o = null, E = f;
   const c = /* @__PURE__ */ new Map(), w = () => {
     c.clear();
     for (const t of o?.applications ?? [])
@@ -22,90 +22,93 @@ const L = [
     o = null, c.clear(), E = f;
   }, u = async () => {
     if (o) return o;
-    n = await R(r, a.config);
-    const t = await D(r, n);
-    return o = $(t), E = t.server?.clientOutDir || f, w(), o;
-  }, I = (t) => {
-    const e = t.moduleGraph.getModuleById(h);
+    i = await _(n, r.config);
+    const t = await D(n, i);
+    return o = C(t), E = t.server?.clientOutDir || f, w(), o;
+  }, R = (t) => {
+    const e = t.moduleGraph.getModuleById(I);
     e && t.moduleGraph.invalidateModule(e);
     for (const l of o?.applications ?? []) {
-      const i = `${p}${l.id}`, s = t.moduleGraph.getModuleById(i);
-      s && t.moduleGraph.invalidateModule(s);
+      const s = `${p}${l.id}`, a = t.moduleGraph.getModuleById(s);
+      a && t.moduleGraph.invalidateModule(a);
     }
   };
   return {
     name: "vue-ssr-lite",
     enforce: "pre",
+    // Keep one plugin instance across client/SSR environment config clones so
+    // virtual-module state stays consistent during production builds.
+    sharedDuringBuild: !0,
     async config(t, e) {
-      r = d(a.root || t.root || process.cwd());
-      const l = await u(), i = Object.fromEntries(
-        l.applications.map((g) => [
-          g.id,
-          d(r, g.template)
+      n = d(r.root || t.root || process.cwd());
+      const l = await u(), s = Object.fromEntries(
+        l.applications.map((h) => [
+          h.id,
+          d(n, h.template)
         ])
-      ), s = t.build?.outDir || E || f;
+      ), a = t.build?.outDir || E || f;
       return {
         resolve: {
-          dedupe: [.../* @__PURE__ */ new Set([...L, ...a.dedupe ?? []])]
+          dedupe: [.../* @__PURE__ */ new Set([...L, ...r.dedupe ?? []])]
         },
         ssr: {
           external: ["vue-ssr-lite"],
-          noExternal: [...new Set(a.ssrNoExternal ?? [])]
+          noExternal: [...new Set(r.ssrNoExternal ?? [])]
         },
         build: e.isSsrBuild ? void 0 : {
           manifest: !0,
-          outDir: s,
-          rollupOptions: { input: i }
+          outDir: a,
+          rollupOptions: { input: s }
         }
       };
     },
     configResolved(t) {
-      r = t.root;
+      n = t.root;
     },
     configureServer(t) {
       u().then(() => {
-        n && t.watcher.add(n);
+        i && t.watcher.add(i);
       });
     },
     async handleHotUpdate({ file: t, server: e }) {
-      if (b(t, n))
-        return I(e), y(), await u(), n && e.watcher.add(n), I(e), e.ws.send({ type: "full-reload" }), [];
+      if (N(t, i))
+        return R(e), y(), await u(), i && e.watcher.add(i), R(e), e.ws.send({ type: "full-reload" }), [];
     },
     resolveId(t) {
-      if (t === _) return h;
+      if (U(t)) return I;
       if (c.has(t))
         return `${p}${t.slice(m.length)}`;
     },
     async load(t) {
-      if (t === h) {
-        const i = await u(), s = n || await R(r, a.config);
-        return C(r, s, i.applications);
+      if (t === I) {
+        const s = await u(), a = i || await _(n, r.config);
+        return $(n, a, s.applications);
       }
       if (!t.startsWith(p)) return;
       const e = t.slice(p.length), l = o?.applications.find(
-        ({ id: i }) => i === e
+        ({ id: s }) => s === e
       );
       if (l)
-        return T(r, l);
+        return T(n, l);
     },
     transformIndexHtml: {
       order: "pre",
       handler(t, e) {
-        const l = S(e.filename), i = o?.applications.find(
-          (M) => l === S(d(r, M.template))
+        const l = g(e.filename), s = o?.applications.find(
+          (M) => l === g(d(n, M.template))
         );
-        if (!i) return t;
-        const s = `${m}${i.id}`, v = O(
+        if (!s) return t;
+        const a = `${m}${s.id}`, v = O(
           t,
-          i.mountSelector || "#app"
-        ).replace(U, "");
-        return v.includes(`import ${JSON.stringify(s)}`) ? v : {
+          s.mountSelector || "#app"
+        ).replace(b, "");
+        return v.includes(`import ${JSON.stringify(a)}`) ? v : {
           html: v,
           tags: [
             {
               tag: "script",
               attrs: { type: "module" },
-              children: `import ${JSON.stringify(s)}`,
+              children: `import ${JSON.stringify(a)}`,
               injectTo: "body"
             }
           ]
@@ -115,5 +118,5 @@ const L = [
   };
 };
 export {
-  F as vueSsrLite
+  P as vueSsrLite
 };

package/package.json

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