@moostjs/vite 0.6.25 → 0.6.26

package/README.md

@@ -101,6 +101,8 @@ moostVite({
 })
 ```
 
+Note that the production server generated by `vite build` defaults the prefix to `'/api'` when the option is omitted — set `prefix` explicitly so dev (where all requests pass through Moost without it) and prod route the same way.
+
 ## SSR Mode
 
 Add `ssrEntry` to enable server-side rendering. The plugin handles everything automatically — SSR rendering in dev, multi-environment builds for production:
@@ -180,7 +182,7 @@ export default defineConfig({
 
 **Don't externalize:** workspace packages (`workspace:*`), anything that uses `Symbol()` as a public slot key (Moost, wooks, atscript), anything not reliably hoisted by pnpm.
 
-You can also opt out of bundle-everything by setting `ssr.noExternal` to an explicit list — the plugin honors it literally (appending only `/^@moostjs\/vite($|\/)/` so its own `define:` substitutions still land):
+You can also opt out of bundle-everything by setting `ssr.noExternal` to an explicit list — the plugin honors it, appending `/^@moostjs\/vite($|\/)/` (so its own `define:` substitutions still land) plus, unless you externalize the runtime yourself, the moost/wooks runtime patterns described below:
 
 ```ts
 ssr: {
@@ -225,12 +227,12 @@ The plugin injects a `__VITE_ID` decorator on `@Injectable` and `@Controller` cl
 | `host` | `string` | `'localhost'` | Dev server host (backend mode only) |
 | `outDir` | `string` | `'dist'` | Build output directory (backend mode only) |
 | `format` | `'cjs' \| 'esm'` | `'esm'` | Output module format (backend mode only) |
-| `sourcemap` | `boolean` | `true` | Generate source maps (backend mode only) |
+| `sourcemap` | `boolean` | `true` | Generate source maps (both modes; in middleware mode applies to the `dist/server` SSR build) |
 | `externals` | `boolean \| object` | `true` | Configure external dependencies (backend mode only) |
 | `onEject` | `function` | — | Hook to control DI instance ejection during HMR |
 | `ssrFetch` | `boolean` | `true` | Enable local fetch interception for SSR |
 | `middleware` | `boolean` | `false` | Run Moost as Connect middleware (Vite serves frontend) |
-| `prefix` | `string` | — | URL prefix filter for middleware mode (e.g. `'/api'`) |
+| `prefix` | `string` | `'/api'` (prod server) | URL prefix filter for middleware mode (e.g. `'/api'`); the production server defaults to `'/api'` when omitted |
 | `ssrEntry` | `string` | — | Vue/React SSR entry module (e.g. `'/src/entry-server.ts'`) |
 | `ssrOutlet` | `string` | `'<!--ssr-outlet-->'` | HTML placeholder for SSR-rendered content |
 | `ssrState` | `string` | `'<!--ssr-state-->'` | HTML placeholder for SSR state transfer script |

package/dist/index.cjs

@@ -379,6 +379,31 @@ function moostVite(options) {
 	* Drains any pending Moost app reload before a request is served. Assigned once
 	* the SSR module runner exists (see configureServer); a no-op until then.
 	*/ let drainReload = () => Promise.resolve();
+	/**
+	* Last Moost entry import failure. While set, the dev middleware answers matching
+	* requests with 502 instead of letting them fall through to the SPA/SSR fallback
+	* (which would serve index.html for API routes). Cleared on a successful reload;
+	* the next hot update schedules the retry.
+	*/ let bootError = null;
+	/**
+	* Looks up the Moost entry node with the verbatim `options.entry` string — the
+	* module graph keys (and memoizes) unresolved urls as-is, so the same spelling
+	* that was passed to `runner.import()` is guaranteed to return the very node
+	* that import created.
+	*/ const getEntryModule = (moduleGraph) => moduleGraph.getModuleByUrl(options.entry);
+	/**
+	* Drops the captured Moost app so the next request triggers a full reload:
+	* releases the middleware + local fetch and ejects DI instances affected by
+	* the changed modules.
+	*/ const ejectApp = (cleanupInstances) => {
+		moostMiddleware = null;
+		if (localFetchTeardown) {
+			localFetchTeardown();
+			localFetchTeardown = null;
+		}
+		moostRestartCleanup(adapters, options.onEject, cleanupInstances);
+		reloadRequired = true;
+	};
 	patchMoostHandlerLogging();
 	const pluginConfig = {
 		name: PLUGIN_NAME,
@@ -523,16 +548,27 @@ function moostVite(options) {
 			};
 		},
 		async configureServer(server) {
-			const runner = (0, vite.createServerModuleRunner)(server.environments.ssr);
+			const runner = (0, vite.createServerModuleRunner)(server.environments.ssr, { hmr: false });
 			const ssrImport = (id) => runner.import(id);
+			bootError = null;
+			reloadRequired = false;
+			reloadPromise = null;
 			const runReload = () => {
 				reloadRequired = false;
 				console.log();
 				logger.debug("🚀 Reloading Moost App...");
 				console.log();
 				return (async () => {
-					for (const adapter of adapters) if (adapter.detected) await adapter.init();
-					await ssrImport(options.entry);
+					try {
+						for (const adapter of adapters) if (adapter.detected) await adapter.init();
+						const entryModule = await getEntryModule(server.environments.ssr.moduleGraph);
+						if (entryModule?.transformResult) server.environments.ssr.moduleGraph.invalidateModule(entryModule);
+						await ssrImport(options.entry);
+						bootError = null;
+					} catch (error) {
+						bootError = error;
+						logger.error(`✖️  Failed to reload Moost App: ${error.message}`);
+					}
 					await new Promise((resolve) => setTimeout(resolve, 1));
 				})().finally(() => {
 					reloadPromise = null;
@@ -561,30 +597,29 @@ function moostVite(options) {
 					}
 					return moostMiddleware(req, res);
 				}
+				if (bootError) {
+					res.statusCode = 502;
+					res.setHeader("Content-Type", "text/plain");
+					res.end(`Moost app failed to load: ${bootError.message}`);
+					return;
+				}
 				next();
 			});
 		},
-		hotUpdate({ file }) {
-			if (file.endsWith(".ts")) {
-				const modules = this.environment.moduleGraph.getModulesByFile(file);
-				if (modules) {
-					logger.debug(`🔃 Hot update: ${file}`);
-					const cleanupInstances = /* @__PURE__ */ new Set();
-					for (const mod of modules) {
-						const allImporters = gatherAllImporters(mod);
-						for (const impModule of allImporters) if (impModule.id) cleanupInstances.add(impModule.id);
-						this.environment.moduleGraph.invalidateModule(mod);
-					}
-					moostMiddleware = null;
-					if (localFetchTeardown) {
-						localFetchTeardown();
-						localFetchTeardown = null;
-					}
-					moostRestartCleanup(adapters, options.onEject, cleanupInstances);
-					reloadRequired = true;
-				}
-				return [];
-			}
+		async hotUpdate({ file, modules }) {
+			if (this.environment.name !== "ssr" || modules.length === 0) return;
+			const { moduleGraph } = this.environment;
+			const entryModule = await getEntryModule(moduleGraph);
+			const importerSets = modules.map((mod) => gatherAllImporters(mod));
+			if (entryModule && !importerSets.some((importers) => importers.has(entryModule))) return;
+			logger.debug(`🔃 Hot update: ${file}`);
+			const cleanupInstances = /* @__PURE__ */ new Set();
+			for (const importers of importerSets) for (const impModule of importers) if (impModule.id) cleanupInstances.add(impModule.id);
+			for (const mod of modules) moduleGraph.invalidateModule(mod);
+			if (entryModule) moduleGraph.invalidateModule(entryModule);
+			else moduleGraph.invalidateAll();
+			ejectApp(cleanupInstances);
+			return [];
 		}
 	};
 	if (isProd || isTest) {
@@ -606,7 +641,7 @@ function moostVite(options) {
 					const url = req.originalUrl || req.url || "/";
 					try {
 						await drainReload();
-						let template = await fs.readFile((0, node_path.resolve)(process.cwd(), "index.html"), "utf8");
+						let template = await fs.readFile((0, node_path.resolve)(server.config.root, "index.html"), "utf8");
 						template = await server.transformIndexHtml(url, template);
 						const { render } = await server.ssrLoadModule(options.ssrEntry);
 						const { html: appHtml, state } = await render(url);

package/dist/index.mjs

@@ -348,6 +348,31 @@ function moostVite(options) {
 	* Drains any pending Moost app reload before a request is served. Assigned once
 	* the SSR module runner exists (see configureServer); a no-op until then.
 	*/ let drainReload = () => Promise.resolve();
+	/**
+	* Last Moost entry import failure. While set, the dev middleware answers matching
+	* requests with 502 instead of letting them fall through to the SPA/SSR fallback
+	* (which would serve index.html for API routes). Cleared on a successful reload;
+	* the next hot update schedules the retry.
+	*/ let bootError = null;
+	/**
+	* Looks up the Moost entry node with the verbatim `options.entry` string — the
+	* module graph keys (and memoizes) unresolved urls as-is, so the same spelling
+	* that was passed to `runner.import()` is guaranteed to return the very node
+	* that import created.
+	*/ const getEntryModule = (moduleGraph) => moduleGraph.getModuleByUrl(options.entry);
+	/**
+	* Drops the captured Moost app so the next request triggers a full reload:
+	* releases the middleware + local fetch and ejects DI instances affected by
+	* the changed modules.
+	*/ const ejectApp = (cleanupInstances) => {
+		moostMiddleware = null;
+		if (localFetchTeardown) {
+			localFetchTeardown();
+			localFetchTeardown = null;
+		}
+		moostRestartCleanup(adapters, options.onEject, cleanupInstances);
+		reloadRequired = true;
+	};
 	patchMoostHandlerLogging();
 	return [{
 		name: PLUGIN_NAME,
@@ -492,16 +517,27 @@ function moostVite(options) {
 			};
 		},
 		async configureServer(server) {
-			const runner = createServerModuleRunner(server.environments.ssr);
+			const runner = createServerModuleRunner(server.environments.ssr, { hmr: false });
 			const ssrImport = (id) => runner.import(id);
+			bootError = null;
+			reloadRequired = false;
+			reloadPromise = null;
 			const runReload = () => {
 				reloadRequired = false;
 				console.log();
 				logger.debug("🚀 Reloading Moost App...");
 				console.log();
 				return (async () => {
-					for (const adapter of adapters) if (adapter.detected) await adapter.init();
-					await ssrImport(options.entry);
+					try {
+						for (const adapter of adapters) if (adapter.detected) await adapter.init();
+						const entryModule = await getEntryModule(server.environments.ssr.moduleGraph);
+						if (entryModule?.transformResult) server.environments.ssr.moduleGraph.invalidateModule(entryModule);
+						await ssrImport(options.entry);
+						bootError = null;
+					} catch (error) {
+						bootError = error;
+						logger.error(`✖️  Failed to reload Moost App: ${error.message}`);
+					}
 					await new Promise((resolve) => setTimeout(resolve, 1));
 				})().finally(() => {
 					reloadPromise = null;
@@ -530,30 +566,29 @@ function moostVite(options) {
 					}
 					return moostMiddleware(req, res);
 				}
+				if (bootError) {
+					res.statusCode = 502;
+					res.setHeader("Content-Type", "text/plain");
+					res.end(`Moost app failed to load: ${bootError.message}`);
+					return;
+				}
 				next();
 			});
 		},
-		hotUpdate({ file }) {
-			if (file.endsWith(".ts")) {
-				const modules = this.environment.moduleGraph.getModulesByFile(file);
-				if (modules) {
-					logger.debug(`🔃 Hot update: ${file}`);
-					const cleanupInstances = /* @__PURE__ */ new Set();
-					for (const mod of modules) {
-						const allImporters = gatherAllImporters(mod);
-						for (const impModule of allImporters) if (impModule.id) cleanupInstances.add(impModule.id);
-						this.environment.moduleGraph.invalidateModule(mod);
-					}
-					moostMiddleware = null;
-					if (localFetchTeardown) {
-						localFetchTeardown();
-						localFetchTeardown = null;
-					}
-					moostRestartCleanup(adapters, options.onEject, cleanupInstances);
-					reloadRequired = true;
-				}
-				return [];
-			}
+		async hotUpdate({ file, modules }) {
+			if (this.environment.name !== "ssr" || modules.length === 0) return;
+			const { moduleGraph } = this.environment;
+			const entryModule = await getEntryModule(moduleGraph);
+			const importerSets = modules.map((mod) => gatherAllImporters(mod));
+			if (entryModule && !importerSets.some((importers) => importers.has(entryModule))) return;
+			logger.debug(`🔃 Hot update: ${file}`);
+			const cleanupInstances = /* @__PURE__ */ new Set();
+			for (const importers of importerSets) for (const impModule of importers) if (impModule.id) cleanupInstances.add(impModule.id);
+			for (const mod of modules) moduleGraph.invalidateModule(mod);
+			if (entryModule) moduleGraph.invalidateModule(entryModule);
+			else moduleGraph.invalidateAll();
+			ejectApp(cleanupInstances);
+			return [];
 		}
 	}, options.middleware && options.ssrEntry ? {
 		name: `${PLUGIN_NAME}:ssr-fallback`,
@@ -567,7 +602,7 @@ function moostVite(options) {
 					const url = req.originalUrl || req.url || "/";
 					try {
 						await drainReload();
-						let template = await fs.readFile(resolve(process.cwd(), "index.html"), "utf8");
+						let template = await fs.readFile(resolve(server.config.root, "index.html"), "utf8");
 						template = await server.transformIndexHtml(url, template);
 						const { render } = await server.ssrLoadModule(options.ssrEntry);
 						const { html: appHtml, state } = await render(url);

package/dist/prod-server.cjs

@@ -33,7 +33,7 @@ async function createSSRServer(options) {
 				if (req.method !== "GET") return next();
 				const url = req.originalUrl || req.url || "/";
 				try {
-					let template = await fs.readFile(path.resolve(process.cwd(), "index.html"), "utf8");
+					let template = await fs.readFile(path.resolve(vite.config.root, "index.html"), "utf8");
 					template = await vite.transformIndexHtml(url, template);
 					const { render } = await vite.ssrLoadModule(ssrEntry);
 					const { html: appHtml, state } = await render(url);

package/dist/prod-server.mjs

@@ -34,7 +34,7 @@ async function createSSRServer(options) {
 				if (req.method !== "GET") return next();
 				const url = req.originalUrl || req.url || "/";
 				try {
-					let template = await fs.readFile(path.resolve(process.cwd(), "index.html"), "utf8");
+					let template = await fs.readFile(path.resolve(vite.config.root, "index.html"), "utf8");
 					template = await vite.transformIndexHtml(url, template);
 					const { render } = await vite.ssrLoadModule(ssrEntry);
 					const { html: appHtml, state } = await render(url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moostjs/vite",
-  "version": "0.6.25",
+  "version": "0.6.26",
   "description": "Vite Dev plugin for moostjs",
   "keywords": [
     "composables",
@@ -58,8 +58,8 @@
   "peerDependencies": {
     "sirv": "^3.0.0",
     "vite": "^8.0.0",
-    "@moostjs/event-http": "^0.6.25",
-    "moost": "^0.6.25"
+    "@moostjs/event-http": "^0.6.26",
+    "moost": "^0.6.26"
   },
   "peerDependenciesMeta": {
     "sirv": {