@lovable.dev/vite-tanstack-config 2.15.1 → 2.17.0

package/dist/index.cjs

@@ -189,6 +189,76 @@ async function nitroSupportsDefaultPreset() {
 	}
 }
 const LOVABLE_NITRO_PRESETS = ["cloudflare-module", "lovable-fetch-bundle"];
+const ROOT_PRERENDER_PINS = {
+	crawlLinks: false,
+	failOnError: false,
+	maxRedirects: 0,
+	autoSubfolderIndex: true
+};
+const PAGE_PRERENDER_PINS = {
+	crawlLinks: ROOT_PRERENDER_PINS.crawlLinks,
+	autoSubfolderIndex: ROOT_PRERENDER_PINS.autoSubfolderIndex
+};
+function pinPrerenderOptions(source, pins, label) {
+	const result = { ...source };
+	for (const [key, value] of Object.entries(pins)) {
+		if (key in result && result[key] !== value) logWarning(`Ignoring ${label}.${key} inside the Lovable build environment; forcing ${JSON.stringify(value)}.`);
+		result[key] = value;
+	}
+	if ("outputPath" in result) {
+		logWarning(`Ignoring ${label}.outputPath inside the Lovable build environment; prerendered routes are always written to <route>/index.html.`);
+		delete result.outputPath;
+	}
+	return result;
+}
+function pinPrerenderForLovableBuild(userOptions) {
+	const attempted = /* @__PURE__ */ new Set();
+	const rendered = /* @__PURE__ */ new Set();
+	const userPrerender = userOptions.prerender;
+	const prerender = pinPrerenderOptions(userPrerender, ROOT_PRERENDER_PINS, "prerender");
+	const userFilter = userPrerender?.filter;
+	prerender.filter = (page) => {
+		const keep = typeof userFilter === "function" ? userFilter(page) : true;
+		if (keep) attempted.add(page.path);
+		return keep;
+	};
+	const withRenderTracking = (userOnSuccess) => (ctx) => {
+		rendered.add(ctx.page.path);
+		return typeof userOnSuccess === "function" ? userOnSuccess(ctx) : void 0;
+	};
+	prerender.onSuccess = withRenderTracking(userPrerender?.onSuccess);
+	const startOptions = {
+		...userOptions,
+		prerender
+	};
+	if (Array.isArray(userOptions.pages)) startOptions.pages = userOptions.pages.map((page) => {
+		if (!page || typeof page !== "object") return page;
+		const entry = page;
+		if (!entry.prerender) return entry;
+		const pinned = pinPrerenderOptions(entry.prerender, PAGE_PRERENDER_PINS, `pages["${entry.path}"].prerender`);
+		if ("onSuccess" in pinned) pinned.onSuccess = withRenderTracking(pinned.onSuccess);
+		return {
+			...entry,
+			prerender: pinned
+		};
+	});
+	return {
+		startOptions,
+		skipReporter: {
+			name: "lovable:prerender-skip-report",
+			apply: "build",
+			enforce: "post",
+			buildApp: {
+				order: "post",
+				async handler() {
+					const skipped = [...attempted].filter((route) => !rendered.has(route));
+					if (skipped.length === 0) return;
+					logWarning(`Prerender skipped ${skipped.length} route(s) that failed to render; they fall back to SSR: ${skipped.join(", ")}`);
+				}
+			}
+		}
+	};
+}
 function lovableFetchBundlePreset() {
 	return {
 		entry: (0, node_url.fileURLToPath)(new URL("../runtime/fetch-entry.mjs", require("url").pathToFileURL(__filename).href)),
@@ -481,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;
@@ -660,7 +831,11 @@ function defineConfig(configOrOptions = {}) {
 				specifiers: ["server-only"]
 			}
 		} }, options.tanstackStart ?? {});
-		internalPlugins.push(tanstackStart(tanstackStartOptions));
+		const prerenderEnabled = prerenderIsEnabled(tanstackStartOptions);
+		if (command === "build" && isSandbox) {
+			const { startOptions, skipReporter } = pinPrerenderForLovableBuild(tanstackStartOptions);
+			internalPlugins.push(tanstackStart(startOptions), skipReporter);
+		} else internalPlugins.push(tanstackStart(tanstackStartOptions));
 		const explicitNitro = options.nitro === true || typeof options.nitro === "object" && options.nitro !== null;
 		if (options.nitro !== false && command === "build") {
 			let nitroMod;
@@ -709,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());
 			}
 		}
@@ -784,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.d.cts

@@ -12,6 +12,10 @@ import { ConfigEnv, Plugin, PluginOption, UserConfig, UserConfigFn, UserConfigFn
 declare function lovableAssetsProxyPlugin(): Plugin;
 //#endregion
 //#region src/index.d.ts
+type PrerenderPage = {
+  path: string;
+  prerender?: Record<string, unknown>;
+};
 declare function stripRedundantNodejsCompatFlag(): Plugin;
 interface LovableViteTanstackOptions {
   plugins?: PluginOption[];
@@ -52,7 +56,7 @@ interface LovableViteTanstackOptions {
       deployConfig?: boolean;
     };
   } | false;
-  /** Options forwarded to tanstackStart(). */
+  /** Options forwarded to tanstackStart(). Inside a Lovable build the prerender output shape is pinned. */
   tanstackStart?: Record<string, unknown>;
   /** Options forwarded to viteReact(). */
   react?: Record<string, unknown>;
@@ -68,4 +72,4 @@ declare function defineConfig(config: UserConfigFnPromise): (env: ConfigEnv) =>
 declare function defineConfig(config: UserConfigFn): (env: ConfigEnv) => Promise<UserConfig>;
 declare function defineConfig(options?: LovableViteTanstackOptions): (env: ConfigEnv) => Promise<UserConfig>;
 //#endregion
-export { LovableViteTanstackOptions, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };
+export { LovableViteTanstackOptions, PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };

package/dist/index.d.ts

@@ -12,6 +12,10 @@ import { ConfigEnv, Plugin, PluginOption, UserConfig, UserConfigFn, UserConfigFn
 declare function lovableAssetsProxyPlugin(): Plugin;
 //#endregion
 //#region src/index.d.ts
+type PrerenderPage = {
+  path: string;
+  prerender?: Record<string, unknown>;
+};
 declare function stripRedundantNodejsCompatFlag(): Plugin;
 interface LovableViteTanstackOptions {
   plugins?: PluginOption[];
@@ -52,7 +56,7 @@ interface LovableViteTanstackOptions {
       deployConfig?: boolean;
     };
   } | false;
-  /** Options forwarded to tanstackStart(). */
+  /** Options forwarded to tanstackStart(). Inside a Lovable build the prerender output shape is pinned. */
   tanstackStart?: Record<string, unknown>;
   /** Options forwarded to viteReact(). */
   react?: Record<string, unknown>;
@@ -68,4 +72,4 @@ declare function defineConfig(config: UserConfigFnPromise): (env: ConfigEnv) =>
 declare function defineConfig(config: UserConfigFn): (env: ConfigEnv) => Promise<UserConfig>;
 declare function defineConfig(options?: LovableViteTanstackOptions): (env: ConfigEnv) => Promise<UserConfig>;
 //#endregion
-export { LovableViteTanstackOptions, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };
+export { LovableViteTanstackOptions, PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };

package/dist/index.js

@@ -165,6 +165,76 @@ async function nitroSupportsDefaultPreset() {
 	}
 }
 const LOVABLE_NITRO_PRESETS = ["cloudflare-module", "lovable-fetch-bundle"];
+const ROOT_PRERENDER_PINS = {
+	crawlLinks: false,
+	failOnError: false,
+	maxRedirects: 0,
+	autoSubfolderIndex: true
+};
+const PAGE_PRERENDER_PINS = {
+	crawlLinks: ROOT_PRERENDER_PINS.crawlLinks,
+	autoSubfolderIndex: ROOT_PRERENDER_PINS.autoSubfolderIndex
+};
+function pinPrerenderOptions(source, pins, label) {
+	const result = { ...source };
+	for (const [key, value] of Object.entries(pins)) {
+		if (key in result && result[key] !== value) logWarning(`Ignoring ${label}.${key} inside the Lovable build environment; forcing ${JSON.stringify(value)}.`);
+		result[key] = value;
+	}
+	if ("outputPath" in result) {
+		logWarning(`Ignoring ${label}.outputPath inside the Lovable build environment; prerendered routes are always written to <route>/index.html.`);
+		delete result.outputPath;
+	}
+	return result;
+}
+function pinPrerenderForLovableBuild(userOptions) {
+	const attempted = /* @__PURE__ */ new Set();
+	const rendered = /* @__PURE__ */ new Set();
+	const userPrerender = userOptions.prerender;
+	const prerender = pinPrerenderOptions(userPrerender, ROOT_PRERENDER_PINS, "prerender");
+	const userFilter = userPrerender?.filter;
+	prerender.filter = (page) => {
+		const keep = typeof userFilter === "function" ? userFilter(page) : true;
+		if (keep) attempted.add(page.path);
+		return keep;
+	};
+	const withRenderTracking = (userOnSuccess) => (ctx) => {
+		rendered.add(ctx.page.path);
+		return typeof userOnSuccess === "function" ? userOnSuccess(ctx) : void 0;
+	};
+	prerender.onSuccess = withRenderTracking(userPrerender?.onSuccess);
+	const startOptions = {
+		...userOptions,
+		prerender
+	};
+	if (Array.isArray(userOptions.pages)) startOptions.pages = userOptions.pages.map((page) => {
+		if (!page || typeof page !== "object") return page;
+		const entry = page;
+		if (!entry.prerender) return entry;
+		const pinned = pinPrerenderOptions(entry.prerender, PAGE_PRERENDER_PINS, `pages["${entry.path}"].prerender`);
+		if ("onSuccess" in pinned) pinned.onSuccess = withRenderTracking(pinned.onSuccess);
+		return {
+			...entry,
+			prerender: pinned
+		};
+	});
+	return {
+		startOptions,
+		skipReporter: {
+			name: "lovable:prerender-skip-report",
+			apply: "build",
+			enforce: "post",
+			buildApp: {
+				order: "post",
+				async handler() {
+					const skipped = [...attempted].filter((route) => !rendered.has(route));
+					if (skipped.length === 0) return;
+					logWarning(`Prerender skipped ${skipped.length} route(s) that failed to render; they fall back to SSR: ${skipped.join(", ")}`);
+				}
+			}
+		}
+	};
+}
 function lovableFetchBundlePreset() {
 	return {
 		entry: fileURLToPath(new URL("../runtime/fetch-entry.mjs", import.meta.url)),
@@ -457,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;
@@ -636,7 +807,11 @@ function defineConfig(configOrOptions = {}) {
 				specifiers: ["server-only"]
 			}
 		} }, options.tanstackStart ?? {});
-		internalPlugins.push(tanstackStart(tanstackStartOptions));
+		const prerenderEnabled = prerenderIsEnabled(tanstackStartOptions);
+		if (command === "build" && isSandbox) {
+			const { startOptions, skipReporter } = pinPrerenderForLovableBuild(tanstackStartOptions);
+			internalPlugins.push(tanstackStart(startOptions), skipReporter);
+		} else internalPlugins.push(tanstackStart(tanstackStartOptions));
 		const explicitNitro = options.nitro === true || typeof options.nitro === "object" && options.nitro !== null;
 		if (options.nitro !== false && command === "build") {
 			let nitroMod;
@@ -685,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());
 			}
 		}
@@ -760,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.15.1",
+  "version": "2.17.0",
   "description": "Vite config wrapper for Lovable TanStack Start projects",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",