@lovable.dev/vite-tanstack-config 2.16.0 → 2.17.1

package/dist/hmr-gate.cjs

@@ -8,6 +8,24 @@ function requestPathname(req) {
 	const queryStart = url.indexOf("?");
 	return queryStart === -1 ? url : url.slice(0, queryStart);
 }
+const nonNavigationPrefixes = [
+	"/@vite/",
+	"/@fs/",
+	"/@id/",
+	"/@react-refresh",
+	"/api/",
+	"/go-api/",
+	"/assets/",
+	"/src/",
+	"/_",
+	"/favicon"
+];
+function isHtmlNavigationRequest(req) {
+	if (req.method !== "GET") return false;
+	const url = req.url;
+	if (!url || nonNavigationPrefixes.some((prefix) => url.startsWith(prefix))) return false;
+	return (req.headers.accept ?? "").includes("text/html");
+}
 function gateStatusHeaders(req) {
 	const origin = req.headers.origin;
 	const headers = {
@@ -233,6 +251,7 @@ function hmrGatePlugin(options = {}) {
 		lastUpdateKey = "";
 	}
 	let classicFailOpenTimer = null;
+	let errorServedSinceFlush = false;
 	let transportMode = false;
 	let swallowedUpdates = 0;
 	let heldReload = false;
@@ -420,6 +439,12 @@ function hmrGatePlugin(options = {}) {
 				});
 				srv.middlewares.use((req, res, next) => {
 					if (req.method !== "POST" || requestPathname(req) !== "/__hmr_flush") return next();
+					const flushOrigin = req.headers.origin;
+					if (typeof flushOrigin === "string" && !statusCorsOriginRe.test(flushOrigin)) {
+						res.writeHead(403, { "Content-Type": "application/json" });
+						res.end(JSON.stringify({ error: "origin not allowed" }));
+						return;
+					}
 					const priorDrainUntil = drainUntil;
 					const released = releaseParked();
 					drainUntil = Date.now() + drainMs;
@@ -494,6 +519,23 @@ function hmrGatePlugin(options = {}) {
 				});
 				return;
 			}
+			srv.middlewares.use((req, res, next) => {
+				const originalEnd = res.end.bind(res);
+				res.end = ((...args) => {
+					if (res.statusCode >= 500 && isHtmlNavigationRequest(req)) {
+						errorServedSinceFlush = true;
+						if (classicFailOpenTimer === null) {
+							classicFailOpenTimer = setTimeout(() => {
+								classicFailOpenTimer = null;
+								flushPending();
+							}, maxHoldMs);
+							classicFailOpenTimer.unref?.();
+						}
+					}
+					return originalEnd(...args);
+				});
+				next();
+			});
 			const _emit = srv.watcher.emit.bind(srv.watcher);
 			originalEmit = _emit;
 			const flushPending = () => {
@@ -502,6 +544,9 @@ function hmrGatePlugin(options = {}) {
 					classicFailOpenTimer = null;
 				}
 				if (pending.size > 0) noteUpdateFlush();
+				const errorServed = errorServedSinceFlush;
+				errorServedSinceFlush = false;
+				if (errorServed) srv.moduleGraph.invalidateAll();
 				const entries = Array.from(pending.entries());
 				pending.clear();
 				for (const [f] of entries) srv.moduleGraph.onFileChange(f);
@@ -514,7 +559,11 @@ function hmrGatePlugin(options = {}) {
 					}
 					if (fullReload) srv.ws.send({ type: "full-reload" });
 				}
-				return entries;
+				if (errorServed && (entries.length === 0 || !fullReload)) srv.ws.send({ type: "full-reload" });
+				return {
+					entries,
+					errorRecovery: errorServed
+				};
 			};
 			srv.watcher.emit = ((event, ...args) => {
 				if (typeof event === "string" && gatedEvents.has(event) && !isPassthrough(args[0])) {
@@ -523,7 +572,7 @@ function hmrGatePlugin(options = {}) {
 						const hash = fileContentHash(filePath);
 						if (hash !== null && hash === lastFlushedHashes.get(filePath)) {
 							pending.delete(filePath);
-							if (pending.size === 0 && classicFailOpenTimer !== null) {
+							if (pending.size === 0 && !errorServedSinceFlush && classicFailOpenTimer !== null) {
 								clearTimeout(classicFailOpenTimer);
 								classicFailOpenTimer = null;
 							}
@@ -550,11 +599,18 @@ function hmrGatePlugin(options = {}) {
 			});
 			srv.middlewares.use((req, res, next) => {
 				if (req.method !== "POST" || requestPathname(req) !== "/__hmr_flush") return next();
-				const entries = flushPending();
+				const origin = req.headers.origin;
+				if (typeof origin === "string" && !statusCorsOriginRe.test(origin)) {
+					res.writeHead(403, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "origin not allowed" }));
+					return;
+				}
+				const { entries, errorRecovery } = flushPending();
 				const files = entries.map(([f]) => f);
 				const body = JSON.stringify({
 					flushed: files,
 					count: entries.length,
+					errorRecovery,
 					mode: fullReload ? "full-reload" : "granular"
 				});
 				res.writeHead(200, { "Content-Type": "application/json" });
@@ -567,7 +623,8 @@ function hmrGatePlugin(options = {}) {
 				const body = JSON.stringify({
 					enabled: true,
 					pending: serialized,
-					count: pending.size,
+					count: pending.size + (errorServedSinceFlush ? 1 : 0),
+					errorRecovery: errorServedSinceFlush,
 					mode: fullReload ? "full-reload" : "granular"
 				});
 				res.writeHead(200, gateStatusHeaders(req));
@@ -609,6 +666,7 @@ function hmrGatePlugin(options = {}) {
 			drainUntil = 0;
 			pending.clear();
 			lastFlushedHashes.clear();
+			errorServedSinceFlush = false;
 			server = null;
 			originalEmit = null;
 		}

package/dist/hmr-gate.js

@@ -7,6 +7,24 @@ function requestPathname(req) {
 	const queryStart = url.indexOf("?");
 	return queryStart === -1 ? url : url.slice(0, queryStart);
 }
+const nonNavigationPrefixes = [
+	"/@vite/",
+	"/@fs/",
+	"/@id/",
+	"/@react-refresh",
+	"/api/",
+	"/go-api/",
+	"/assets/",
+	"/src/",
+	"/_",
+	"/favicon"
+];
+function isHtmlNavigationRequest(req) {
+	if (req.method !== "GET") return false;
+	const url = req.url;
+	if (!url || nonNavigationPrefixes.some((prefix) => url.startsWith(prefix))) return false;
+	return (req.headers.accept ?? "").includes("text/html");
+}
 function gateStatusHeaders(req) {
 	const origin = req.headers.origin;
 	const headers = {
@@ -232,6 +250,7 @@ function hmrGatePlugin(options = {}) {
 		lastUpdateKey = "";
 	}
 	let classicFailOpenTimer = null;
+	let errorServedSinceFlush = false;
 	let transportMode = false;
 	let swallowedUpdates = 0;
 	let heldReload = false;
@@ -419,6 +438,12 @@ function hmrGatePlugin(options = {}) {
 				});
 				srv.middlewares.use((req, res, next) => {
 					if (req.method !== "POST" || requestPathname(req) !== "/__hmr_flush") return next();
+					const flushOrigin = req.headers.origin;
+					if (typeof flushOrigin === "string" && !statusCorsOriginRe.test(flushOrigin)) {
+						res.writeHead(403, { "Content-Type": "application/json" });
+						res.end(JSON.stringify({ error: "origin not allowed" }));
+						return;
+					}
 					const priorDrainUntil = drainUntil;
 					const released = releaseParked();
 					drainUntil = Date.now() + drainMs;
@@ -493,6 +518,23 @@ function hmrGatePlugin(options = {}) {
 				});
 				return;
 			}
+			srv.middlewares.use((req, res, next) => {
+				const originalEnd = res.end.bind(res);
+				res.end = ((...args) => {
+					if (res.statusCode >= 500 && isHtmlNavigationRequest(req)) {
+						errorServedSinceFlush = true;
+						if (classicFailOpenTimer === null) {
+							classicFailOpenTimer = setTimeout(() => {
+								classicFailOpenTimer = null;
+								flushPending();
+							}, maxHoldMs);
+							classicFailOpenTimer.unref?.();
+						}
+					}
+					return originalEnd(...args);
+				});
+				next();
+			});
 			const _emit = srv.watcher.emit.bind(srv.watcher);
 			originalEmit = _emit;
 			const flushPending = () => {
@@ -501,6 +543,9 @@ function hmrGatePlugin(options = {}) {
 					classicFailOpenTimer = null;
 				}
 				if (pending.size > 0) noteUpdateFlush();
+				const errorServed = errorServedSinceFlush;
+				errorServedSinceFlush = false;
+				if (errorServed) srv.moduleGraph.invalidateAll();
 				const entries = Array.from(pending.entries());
 				pending.clear();
 				for (const [f] of entries) srv.moduleGraph.onFileChange(f);
@@ -513,7 +558,11 @@ function hmrGatePlugin(options = {}) {
 					}
 					if (fullReload) srv.ws.send({ type: "full-reload" });
 				}
-				return entries;
+				if (errorServed && (entries.length === 0 || !fullReload)) srv.ws.send({ type: "full-reload" });
+				return {
+					entries,
+					errorRecovery: errorServed
+				};
 			};
 			srv.watcher.emit = ((event, ...args) => {
 				if (typeof event === "string" && gatedEvents.has(event) && !isPassthrough(args[0])) {
@@ -522,7 +571,7 @@ function hmrGatePlugin(options = {}) {
 						const hash = fileContentHash(filePath);
 						if (hash !== null && hash === lastFlushedHashes.get(filePath)) {
 							pending.delete(filePath);
-							if (pending.size === 0 && classicFailOpenTimer !== null) {
+							if (pending.size === 0 && !errorServedSinceFlush && classicFailOpenTimer !== null) {
 								clearTimeout(classicFailOpenTimer);
 								classicFailOpenTimer = null;
 							}
@@ -549,11 +598,18 @@ function hmrGatePlugin(options = {}) {
 			});
 			srv.middlewares.use((req, res, next) => {
 				if (req.method !== "POST" || requestPathname(req) !== "/__hmr_flush") return next();
-				const entries = flushPending();
+				const origin = req.headers.origin;
+				if (typeof origin === "string" && !statusCorsOriginRe.test(origin)) {
+					res.writeHead(403, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "origin not allowed" }));
+					return;
+				}
+				const { entries, errorRecovery } = flushPending();
 				const files = entries.map(([f]) => f);
 				const body = JSON.stringify({
 					flushed: files,
 					count: entries.length,
+					errorRecovery,
 					mode: fullReload ? "full-reload" : "granular"
 				});
 				res.writeHead(200, { "Content-Type": "application/json" });
@@ -566,7 +622,8 @@ function hmrGatePlugin(options = {}) {
 				const body = JSON.stringify({
 					enabled: true,
 					pending: serialized,
-					count: pending.size,
+					count: pending.size + (errorServedSinceFlush ? 1 : 0),
+					errorRecovery: errorServedSinceFlush,
 					mode: fullReload ? "full-reload" : "granular"
 				});
 				res.writeHead(200, gateStatusHeaders(req));
@@ -608,6 +665,7 @@ function hmrGatePlugin(options = {}) {
 			drainUntil = 0;
 			pending.clear();
 			lastFlushedHashes.clear();
+			errorServedSinceFlush = false;
 			server = null;
 			originalEmit = null;
 		}

package/dist/index.cjs

@@ -551,6 +551,107 @@ function stripRedundantNodejsCompatFlag() {
 		}
 	};
 }
+const NITRO_SERVER_ENTRY = "index.mjs";
+const NITRO_WRANGLER_CONFIG = "wrangler.json";
+const DEFAULT_SERVER_OUTPUT_DIR = "dist/server";
+const DEFAULT_SERVER_ENTRY_NAME = "server";
+const PRERENDER_PREVIEW_HOST = "127.0.0.1";
+const TSS_PRERENDERING_ENV = "TSS_PRERENDERING";
+const SHIM_MARKER = "// Generated by @lovable.dev/vite-tanstack-config for the prerender preview server.";
+function prerenderShimSource(vars) {
+	return `${SHIM_MARKER}
+import server from "./${NITRO_SERVER_ENTRY}";
+
+const env = ${JSON.stringify(vars)};
+const ctx = { waitUntil() {}, passThroughOnException() {}, props: {} };
+
+export default {
+  fetch(request) {
+    // srvx's NodeRequest exposes \`ip\` as a getter-only accessor and nitro's
+    // cloudflare module handler assigns to it; shadow it with a writable one.
+    Object.defineProperty(request, "ip", { value: undefined, writable: true, configurable: true });
+    return server.fetch(request, env, ctx);
+  },
+};
+`;
+}
+function prerenderPreviewShim(state) {
+	let root = process.cwd();
+	let serverOutDir = DEFAULT_SERVER_OUTPUT_DIR;
+	let serverEntryName = DEFAULT_SERVER_ENTRY_NAME;
+	return {
+		name: "lovable-prerender-preview-shim",
+		apply: "build",
+		config(userConfig) {
+			const ssrBuild = userConfig.environments?.ssr?.build;
+			if (ssrBuild?.outDir) serverOutDir = ssrBuild.outDir;
+			const input = ssrBuild?.rolldownOptions?.input ?? ssrBuild?.rollupOptions?.input;
+			if (typeof input === "string") serverEntryName = input;
+		},
+		configResolved(config) {
+			root = config.root;
+		},
+		buildApp: {
+			order: "post",
+			handler: async () => {
+				const { access, readFile, writeFile } = await import("node:fs/promises");
+				const nodePath = await import("node:path");
+				const exists = async (candidate) => {
+					try {
+						await access(candidate);
+						return true;
+					} catch {
+						return false;
+					}
+				};
+				const outDir = nodePath.resolve(root, serverOutDir);
+				if (!await exists(nodePath.join(outDir, NITRO_SERVER_ENTRY))) return;
+				const basename = nodePath.basename(serverEntryName, nodePath.extname(serverEntryName));
+				if (!basename || basename === "index") {
+					logWarning(`Cannot prerender: the server entry "${serverEntryName}" would need a shim at ${DEFAULT_SERVER_OUTPUT_DIR}/index.js, which outranks nitro's own entry when publishing. Rename the entry to anything but \`index\`.`);
+					return;
+				}
+				const target = nodePath.join(outDir, `${basename}.js`);
+				const occupant = await readFile(target, "utf8").catch(() => void 0);
+				if (occupant !== void 0 && !occupant.startsWith(SHIM_MARKER)) {
+					logWarning(`Cannot prerender: ${basename}.js already exists in ${serverOutDir} and was not written by this plugin.`);
+					return;
+				}
+				let vars = {};
+				try {
+					const candidate = JSON.parse(await readFile(nodePath.join(outDir, NITRO_WRANGLER_CONFIG), "utf8"))?.vars;
+					if (candidate && typeof candidate === "object" && !Array.isArray(candidate)) vars = candidate;
+				} catch {}
+				await writeFile(target, prerenderShimSource(vars));
+				state.file = target;
+			}
+		}
+	};
+}
+function prerenderPreviewShimCleanup(state) {
+	return {
+		name: "lovable-prerender-preview-shim-cleanup",
+		apply: "build",
+		enforce: "post",
+		buildApp: {
+			order: "post",
+			handler: async () => {
+				if (!state.file) return;
+				const { rm } = await import("node:fs/promises");
+				await rm(state.file, { force: true });
+				state.file = void 0;
+			}
+		}
+	};
+}
+function prerenderIsEnabled(startOptions) {
+	const spa = startOptions.spa;
+	if (spa && (spa.enabled ?? true)) return true;
+	const prerender = startOptions.prerender;
+	if (prerender?.enabled === false) return false;
+	const pages = Array.isArray(startOptions.pages) ? startOptions.pages : [];
+	return !!(prerender?.enabled ?? pages.some((page) => !!page?.prerender?.enabled));
+}
 function devSsrErrorLogger() {
 	let lastCapture;
 	const CAPTURE_TTL_MS = 5e3;
@@ -730,6 +831,7 @@ function defineConfig(configOrOptions = {}) {
 				specifiers: ["server-only"]
 			}
 		} }, options.tanstackStart ?? {});
+		const prerenderEnabled = prerenderIsEnabled(tanstackStartOptions);
 		if (command === "build" && isSandbox) {
 			const { startOptions, skipReporter } = pinPrerenderForLovableBuild(tanstackStartOptions);
 			internalPlugins.push(tanstackStart(startOptions), skipReporter);
@@ -782,6 +884,10 @@ function defineConfig(configOrOptions = {}) {
 					}
 				} else if (!nitroOpts.preset && !await nitroSupportsDefaultPreset()) logWarning("The installed `nitro` predates the `defaultPreset` option (3.0.260603-beta), so the Cloudflare fallback is ignored and a zero-config build may target Node instead. Upgrade nitro to >=3.0.260603-beta, or set an explicit `nitro: { preset: \"cloudflare-module\" }`.");
 				internalPlugins.push(nitro(nitroOpts));
+				if (prerenderEnabled) {
+					const shimState = {};
+					internalPlugins.push(prerenderPreviewShim(shimState), prerenderPreviewShimCleanup(shimState));
+				}
 				if (isSandbox) internalPlugins.push(stripRedundantNodejsCompatFlag());
 			}
 		}
@@ -857,6 +963,10 @@ function defineConfig(configOrOptions = {}) {
 			host: "::",
 			port: 8080
 		} }, config);
+		if (env.isPreview && prerenderEnabled && process.env[TSS_PRERENDERING_ENV] === "true") config = (0, vite.mergeConfig)({ preview: {
+			host: PRERENDER_PREVIEW_HOST,
+			port: 0
+		} }, config);
 		if (isSandbox) return config;
 		return applyWatchDebounceDefaults(config);
 	};

package/dist/index.js

@@ -527,6 +527,107 @@ function stripRedundantNodejsCompatFlag() {
 		}
 	};
 }
+const NITRO_SERVER_ENTRY = "index.mjs";
+const NITRO_WRANGLER_CONFIG = "wrangler.json";
+const DEFAULT_SERVER_OUTPUT_DIR = "dist/server";
+const DEFAULT_SERVER_ENTRY_NAME = "server";
+const PRERENDER_PREVIEW_HOST = "127.0.0.1";
+const TSS_PRERENDERING_ENV = "TSS_PRERENDERING";
+const SHIM_MARKER = "// Generated by @lovable.dev/vite-tanstack-config for the prerender preview server.";
+function prerenderShimSource(vars) {
+	return `${SHIM_MARKER}
+import server from "./${NITRO_SERVER_ENTRY}";
+
+const env = ${JSON.stringify(vars)};
+const ctx = { waitUntil() {}, passThroughOnException() {}, props: {} };
+
+export default {
+  fetch(request) {
+    // srvx's NodeRequest exposes \`ip\` as a getter-only accessor and nitro's
+    // cloudflare module handler assigns to it; shadow it with a writable one.
+    Object.defineProperty(request, "ip", { value: undefined, writable: true, configurable: true });
+    return server.fetch(request, env, ctx);
+  },
+};
+`;
+}
+function prerenderPreviewShim(state) {
+	let root = process.cwd();
+	let serverOutDir = DEFAULT_SERVER_OUTPUT_DIR;
+	let serverEntryName = DEFAULT_SERVER_ENTRY_NAME;
+	return {
+		name: "lovable-prerender-preview-shim",
+		apply: "build",
+		config(userConfig) {
+			const ssrBuild = userConfig.environments?.ssr?.build;
+			if (ssrBuild?.outDir) serverOutDir = ssrBuild.outDir;
+			const input = ssrBuild?.rolldownOptions?.input ?? ssrBuild?.rollupOptions?.input;
+			if (typeof input === "string") serverEntryName = input;
+		},
+		configResolved(config) {
+			root = config.root;
+		},
+		buildApp: {
+			order: "post",
+			handler: async () => {
+				const { access, readFile, writeFile } = await import("node:fs/promises");
+				const nodePath = await import("node:path");
+				const exists = async (candidate) => {
+					try {
+						await access(candidate);
+						return true;
+					} catch {
+						return false;
+					}
+				};
+				const outDir = nodePath.resolve(root, serverOutDir);
+				if (!await exists(nodePath.join(outDir, NITRO_SERVER_ENTRY))) return;
+				const basename = nodePath.basename(serverEntryName, nodePath.extname(serverEntryName));
+				if (!basename || basename === "index") {
+					logWarning(`Cannot prerender: the server entry "${serverEntryName}" would need a shim at ${DEFAULT_SERVER_OUTPUT_DIR}/index.js, which outranks nitro's own entry when publishing. Rename the entry to anything but \`index\`.`);
+					return;
+				}
+				const target = nodePath.join(outDir, `${basename}.js`);
+				const occupant = await readFile(target, "utf8").catch(() => void 0);
+				if (occupant !== void 0 && !occupant.startsWith(SHIM_MARKER)) {
+					logWarning(`Cannot prerender: ${basename}.js already exists in ${serverOutDir} and was not written by this plugin.`);
+					return;
+				}
+				let vars = {};
+				try {
+					const candidate = JSON.parse(await readFile(nodePath.join(outDir, NITRO_WRANGLER_CONFIG), "utf8"))?.vars;
+					if (candidate && typeof candidate === "object" && !Array.isArray(candidate)) vars = candidate;
+				} catch {}
+				await writeFile(target, prerenderShimSource(vars));
+				state.file = target;
+			}
+		}
+	};
+}
+function prerenderPreviewShimCleanup(state) {
+	return {
+		name: "lovable-prerender-preview-shim-cleanup",
+		apply: "build",
+		enforce: "post",
+		buildApp: {
+			order: "post",
+			handler: async () => {
+				if (!state.file) return;
+				const { rm } = await import("node:fs/promises");
+				await rm(state.file, { force: true });
+				state.file = void 0;
+			}
+		}
+	};
+}
+function prerenderIsEnabled(startOptions) {
+	const spa = startOptions.spa;
+	if (spa && (spa.enabled ?? true)) return true;
+	const prerender = startOptions.prerender;
+	if (prerender?.enabled === false) return false;
+	const pages = Array.isArray(startOptions.pages) ? startOptions.pages : [];
+	return !!(prerender?.enabled ?? pages.some((page) => !!page?.prerender?.enabled));
+}
 function devSsrErrorLogger() {
 	let lastCapture;
 	const CAPTURE_TTL_MS = 5e3;
@@ -706,6 +807,7 @@ function defineConfig(configOrOptions = {}) {
 				specifiers: ["server-only"]
 			}
 		} }, options.tanstackStart ?? {});
+		const prerenderEnabled = prerenderIsEnabled(tanstackStartOptions);
 		if (command === "build" && isSandbox) {
 			const { startOptions, skipReporter } = pinPrerenderForLovableBuild(tanstackStartOptions);
 			internalPlugins.push(tanstackStart(startOptions), skipReporter);
@@ -758,6 +860,10 @@ function defineConfig(configOrOptions = {}) {
 					}
 				} else if (!nitroOpts.preset && !await nitroSupportsDefaultPreset()) logWarning("The installed `nitro` predates the `defaultPreset` option (3.0.260603-beta), so the Cloudflare fallback is ignored and a zero-config build may target Node instead. Upgrade nitro to >=3.0.260603-beta, or set an explicit `nitro: { preset: \"cloudflare-module\" }`.");
 				internalPlugins.push(nitro(nitroOpts));
+				if (prerenderEnabled) {
+					const shimState = {};
+					internalPlugins.push(prerenderPreviewShim(shimState), prerenderPreviewShimCleanup(shimState));
+				}
 				if (isSandbox) internalPlugins.push(stripRedundantNodejsCompatFlag());
 			}
 		}
@@ -833,6 +939,10 @@ function defineConfig(configOrOptions = {}) {
 			host: "::",
 			port: 8080
 		} }, config);
+		if (env.isPreview && prerenderEnabled && process.env[TSS_PRERENDERING_ENV] === "true") config = mergeConfig({ preview: {
+			host: PRERENDER_PREVIEW_HOST,
+			port: 0
+		} }, config);
 		if (isSandbox) return config;
 		return applyWatchDebounceDefaults(config);
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovable.dev/vite-tanstack-config",
-  "version": "2.16.0",
+  "version": "2.17.1",
   "description": "Vite config wrapper for Lovable TanStack Start projects",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",