@lovable.dev/vite-tanstack-config 2.20.0 → 2.22.0

package/README.md

@@ -12,3 +12,7 @@ Vite config wrapper for Lovable TanStack Start projects.
 ## Customization
 
 Apps can pass through Vite options and adjust the React, TanStack Start, Nitro, HMR gate, and error-logging behavior when they need to.
+
+## Build exit watchdog
+
+Inside a Lovable build with prerender enabled, the build process is forced to exit if it is still alive 60 seconds after the last build hook has returned, and a `[lovable-build-exit-report]` block naming the open handle types is written to stderr. Adjust it with `defineConfig({ buildExitWatchdog: { graceMs, enabled } })`; the grace is clamped to 5 s–10 min. The `LOVABLE_PRERENDER_EXIT_GRACE_MS` and `LOVABLE_PRERENDER_EXIT_WATCHDOG=off` environment variables override the config.

package/dist/index.cjs

@@ -153,7 +153,7 @@ function bundledDevCssUrlShim() {
 //#endregion
 //#region package.json
 var name = "@lovable.dev/vite-tanstack-config";
-var version = "2.20.0";
+var version = "2.22.0";
 //#endregion
 //#region src/logging.ts
 const PACKAGE_NAME = "@lovable.dev/vite-tanstack-config";
@@ -950,6 +950,86 @@ function prerenderPreviewShimCleanup(state) {
 		}
 	};
 }
+const BUILD_EXIT_REPORT_MARKER_OPEN = "[lovable-build-exit-report]";
+const BUILD_EXIT_REPORT_MARKER_CLOSE = "[/lovable-build-exit-report]";
+const EXIT_WATCHDOG_ENV_VAR = "LOVABLE_PRERENDER_EXIT_WATCHDOG";
+const EXIT_GRACE_ENV_VAR = "LOVABLE_PRERENDER_EXIT_GRACE_MS";
+const DEFAULT_EXIT_GRACE_MS = 6e4;
+const MIN_EXIT_GRACE_MS = 5e3;
+const MAX_EXIT_GRACE_MS = 6e5;
+const MAX_REPORTED_HANDLE_TYPES = 20;
+const MAX_REPORTED_HANDLE_TYPE_BYTES = 64;
+const IGNORED_HANDLE_TYPES = /* @__PURE__ */ new Set(["PipeWrap"]);
+function clampGraceMs(value) {
+	return Math.min(MAX_EXIT_GRACE_MS, Math.max(MIN_EXIT_GRACE_MS, Math.floor(value)));
+}
+function resolveExitWatchdog(config) {
+	const enabled = process.env[EXIT_WATCHDOG_ENV_VAR] === "off" ? false : config?.enabled !== false;
+	let graceMs = DEFAULT_EXIT_GRACE_MS;
+	if (config?.graceMs !== void 0) if (typeof config.graceMs === "number" && Number.isFinite(config.graceMs) && config.graceMs > 0) graceMs = clampGraceMs(config.graceMs);
+	else logWarning(`Ignoring buildExitWatchdog.graceMs=${String(config.graceMs)}: expected a positive number of ms.`);
+	const envGrace = process.env[EXIT_GRACE_ENV_VAR];
+	if (envGrace) if (/^\d+$/.test(envGrace) && Number(envGrace) > 0) graceMs = clampGraceMs(Number(envGrace));
+	else logWarning(`Ignoring ${EXIT_GRACE_ENV_VAR}=${envGrace}: expected a positive integer of ms.`);
+	return {
+		enabled,
+		graceMs
+	};
+}
+function cutUtf8(value, maxBytes) {
+	let out = "";
+	let bytes = 0;
+	for (const char of value) {
+		bytes += Buffer.byteLength(char);
+		if (bytes > maxBytes) break;
+		out += char;
+	}
+	return out;
+}
+function collectOpenHandles() {
+	const counts = /* @__PURE__ */ new Map();
+	let resources = [];
+	try {
+		resources = process.getActiveResourcesInfo();
+	} catch {}
+	for (const resource of resources) {
+		if (IGNORED_HANDLE_TYPES.has(resource)) continue;
+		const type = cutUtf8(resource, MAX_REPORTED_HANDLE_TYPE_BYTES);
+		counts.set(type, (counts.get(type) ?? 0) + 1);
+	}
+	const ranked = [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, MAX_REPORTED_HANDLE_TYPES);
+	return Object.fromEntries(ranked);
+}
+function emitBuildExitReport(graceMs, exitCode, openHandles) {
+	const payload = JSON.stringify({
+		grace_ms: graceMs,
+		exit_code: exitCode,
+		open_handles: openHandles
+	});
+	try {
+		process.stderr.write(`\n${BUILD_EXIT_REPORT_MARKER_OPEN}\n${payload}\n${BUILD_EXIT_REPORT_MARKER_CLOSE}\n`);
+	} catch {}
+}
+function prerenderExitWatchdog(graceMs) {
+	return {
+		name: "lovable-prerender-exit-watchdog",
+		apply: "build",
+		enforce: "post",
+		buildApp: {
+			order: "post",
+			handler: async () => {
+				setTimeout(() => {
+					const exitCode = Number(process.exitCode ?? 0) || 0;
+					const openHandles = collectOpenHandles();
+					emitBuildExitReport(graceMs, exitCode, openHandles);
+					const types = Object.entries(openHandles).map(([type, count]) => `${type} x${count}`);
+					logWarning(`Build output is complete but the process was still alive ${graceMs}ms after prerender (open handles: ${types.length > 0 ? types.join(", ") : "none reported"}); exiting with code ${exitCode}. Usual causes: TanStack Query gcTime timers armed during SSR, or module-scope timers and connection pools in server code.`);
+					process.exit(exitCode);
+				}, graceMs).unref();
+			}
+		}
+	};
+}
 function prerenderIsEnabled(startOptions) {
 	const spa = startOptions.spa;
 	if (spa && (spa.enabled ?? true)) return true;
@@ -1108,9 +1188,10 @@ function defineConfig(configOrOptions = {}) {
 				optionObject.nitro = false;
 				logWarning("`cloudflare: false` is deprecated in v2 — migrated to `nitro: false`. Update your config to drop the warning.");
 			} else logWarning("The `cloudflare` option was removed in v2. Use `nitro: false` to disable the deploy plugin, or `nitro: { preset: '...' }` to configure it. The `cloudflare` setting is being ignored.");
-			options = "vite" in optionObject || "serverFnErrorLogger" in optionObject || "ssrErrorLogger" in optionObject || "nitro" in optionObject || "tanstackStart" in optionObject || "react" in optionObject || "envDefine" in optionObject || "hmrGate" in optionObject ? optionObject : { vite: optionObject };
+			options = "vite" in optionObject || "serverFnErrorLogger" in optionObject || "ssrErrorLogger" in optionObject || "nitro" in optionObject || "tanstackStart" in optionObject || "react" in optionObject || "envDefine" in optionObject || "hmrGate" in optionObject || "buildExitWatchdog" in optionObject ? optionObject : { vite: optionObject };
 		}
 		const internalPlugins = [];
+		let exitWatchdog;
 		if (mode === "development") {
 			const { devtools } = await import("@tanstack/devtools-vite");
 			internalPlugins.push(devtools({
@@ -1195,6 +1276,10 @@ function defineConfig(configOrOptions = {}) {
 					const shimState = {};
 					internalPlugins.push(prerenderPreviewShim(shimState, nitroDirs), prerenderPreviewShimCleanup(shimState));
 				}
+				if (isSandbox && prerenderEnabled) {
+					const watchdog = resolveExitWatchdog(options.buildExitWatchdog);
+					if (watchdog.enabled) exitWatchdog = prerenderExitWatchdog(watchdog.graceMs);
+				}
 				if (isSandbox) internalPlugins.push(stripRedundantNodejsCompatFlag(nitroDirs));
 			}
 		}
@@ -1274,6 +1359,7 @@ function defineConfig(configOrOptions = {}) {
 			host: PRERENDER_PREVIEW_HOST,
 			port: 0
 		} }, config);
+		if (exitWatchdog) config = (0, vite.mergeConfig)(config, { plugins: [exitWatchdog] });
 		if (isSandbox) return config;
 		return applyWatchDebounceDefaults(config);
 	};

package/dist/index.d.cts

@@ -30,6 +30,12 @@ type PrerenderShimDirs = {
   /** Filled by nitro's `compiled` hook, which fires inside its own post-order `buildApp`. */
   nitroOutput: NitroOutput;
 };
+interface BuildExitWatchdogOptions {
+  /** Grace after the post-build hooks before the process is forced to exit. Clamped to 5s-10min. Default 60_000. */
+  graceMs?: number;
+  /** Set to false to let a build that keeps handles open run until the publish limit. Default true. */
+  enabled?: boolean;
+}
 interface LovableViteTanstackOptions {
   plugins?: PluginOption[];
   vite?: UserConfig;
@@ -77,6 +83,8 @@ interface LovableViteTanstackOptions {
   envDefine?: boolean;
   /** hmrGatePlugin() options. Default on in sandbox (false disables); true or an options object enables elsewhere. */
   hmrGate?: boolean | Record<string, unknown>;
+  /** Forced exit after a Lovable prerender build when the server bundle keeps handles open. Sandbox builds only. */
+  buildExitWatchdog?: BuildExitWatchdogOptions;
 }
 declare function defineConfig(config: UserConfig): (env: ConfigEnv) => Promise<UserConfig>;
 declare function defineConfig(config: Promise<UserConfig>): (env: ConfigEnv) => Promise<UserConfig>;
@@ -85,4 +93,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, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };
+export { BuildExitWatchdogOptions, LovableViteTanstackOptions, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };

package/dist/index.d.ts

@@ -30,6 +30,12 @@ type PrerenderShimDirs = {
   /** Filled by nitro's `compiled` hook, which fires inside its own post-order `buildApp`. */
   nitroOutput: NitroOutput;
 };
+interface BuildExitWatchdogOptions {
+  /** Grace after the post-build hooks before the process is forced to exit. Clamped to 5s-10min. Default 60_000. */
+  graceMs?: number;
+  /** Set to false to let a build that keeps handles open run until the publish limit. Default true. */
+  enabled?: boolean;
+}
 interface LovableViteTanstackOptions {
   plugins?: PluginOption[];
   vite?: UserConfig;
@@ -77,6 +83,8 @@ interface LovableViteTanstackOptions {
   envDefine?: boolean;
   /** hmrGatePlugin() options. Default on in sandbox (false disables); true or an options object enables elsewhere. */
   hmrGate?: boolean | Record<string, unknown>;
+  /** Forced exit after a Lovable prerender build when the server bundle keeps handles open. Sandbox builds only. */
+  buildExitWatchdog?: BuildExitWatchdogOptions;
 }
 declare function defineConfig(config: UserConfig): (env: ConfigEnv) => Promise<UserConfig>;
 declare function defineConfig(config: Promise<UserConfig>): (env: ConfigEnv) => Promise<UserConfig>;
@@ -85,4 +93,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, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };
+export { BuildExitWatchdogOptions, LovableViteTanstackOptions, type PrerenderPage, defineConfig, lovableAssetsProxyPlugin, stripRedundantNodejsCompatFlag };

package/dist/index.js

@@ -129,7 +129,7 @@ function bundledDevCssUrlShim() {
 //#endregion
 //#region package.json
 var name = "@lovable.dev/vite-tanstack-config";
-var version = "2.20.0";
+var version = "2.22.0";
 //#endregion
 //#region src/logging.ts
 const PACKAGE_NAME = "@lovable.dev/vite-tanstack-config";
@@ -926,6 +926,86 @@ function prerenderPreviewShimCleanup(state) {
 		}
 	};
 }
+const BUILD_EXIT_REPORT_MARKER_OPEN = "[lovable-build-exit-report]";
+const BUILD_EXIT_REPORT_MARKER_CLOSE = "[/lovable-build-exit-report]";
+const EXIT_WATCHDOG_ENV_VAR = "LOVABLE_PRERENDER_EXIT_WATCHDOG";
+const EXIT_GRACE_ENV_VAR = "LOVABLE_PRERENDER_EXIT_GRACE_MS";
+const DEFAULT_EXIT_GRACE_MS = 6e4;
+const MIN_EXIT_GRACE_MS = 5e3;
+const MAX_EXIT_GRACE_MS = 6e5;
+const MAX_REPORTED_HANDLE_TYPES = 20;
+const MAX_REPORTED_HANDLE_TYPE_BYTES = 64;
+const IGNORED_HANDLE_TYPES = /* @__PURE__ */ new Set(["PipeWrap"]);
+function clampGraceMs(value) {
+	return Math.min(MAX_EXIT_GRACE_MS, Math.max(MIN_EXIT_GRACE_MS, Math.floor(value)));
+}
+function resolveExitWatchdog(config) {
+	const enabled = process.env[EXIT_WATCHDOG_ENV_VAR] === "off" ? false : config?.enabled !== false;
+	let graceMs = DEFAULT_EXIT_GRACE_MS;
+	if (config?.graceMs !== void 0) if (typeof config.graceMs === "number" && Number.isFinite(config.graceMs) && config.graceMs > 0) graceMs = clampGraceMs(config.graceMs);
+	else logWarning(`Ignoring buildExitWatchdog.graceMs=${String(config.graceMs)}: expected a positive number of ms.`);
+	const envGrace = process.env[EXIT_GRACE_ENV_VAR];
+	if (envGrace) if (/^\d+$/.test(envGrace) && Number(envGrace) > 0) graceMs = clampGraceMs(Number(envGrace));
+	else logWarning(`Ignoring ${EXIT_GRACE_ENV_VAR}=${envGrace}: expected a positive integer of ms.`);
+	return {
+		enabled,
+		graceMs
+	};
+}
+function cutUtf8(value, maxBytes) {
+	let out = "";
+	let bytes = 0;
+	for (const char of value) {
+		bytes += Buffer.byteLength(char);
+		if (bytes > maxBytes) break;
+		out += char;
+	}
+	return out;
+}
+function collectOpenHandles() {
+	const counts = /* @__PURE__ */ new Map();
+	let resources = [];
+	try {
+		resources = process.getActiveResourcesInfo();
+	} catch {}
+	for (const resource of resources) {
+		if (IGNORED_HANDLE_TYPES.has(resource)) continue;
+		const type = cutUtf8(resource, MAX_REPORTED_HANDLE_TYPE_BYTES);
+		counts.set(type, (counts.get(type) ?? 0) + 1);
+	}
+	const ranked = [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, MAX_REPORTED_HANDLE_TYPES);
+	return Object.fromEntries(ranked);
+}
+function emitBuildExitReport(graceMs, exitCode, openHandles) {
+	const payload = JSON.stringify({
+		grace_ms: graceMs,
+		exit_code: exitCode,
+		open_handles: openHandles
+	});
+	try {
+		process.stderr.write(`\n${BUILD_EXIT_REPORT_MARKER_OPEN}\n${payload}\n${BUILD_EXIT_REPORT_MARKER_CLOSE}\n`);
+	} catch {}
+}
+function prerenderExitWatchdog(graceMs) {
+	return {
+		name: "lovable-prerender-exit-watchdog",
+		apply: "build",
+		enforce: "post",
+		buildApp: {
+			order: "post",
+			handler: async () => {
+				setTimeout(() => {
+					const exitCode = Number(process.exitCode ?? 0) || 0;
+					const openHandles = collectOpenHandles();
+					emitBuildExitReport(graceMs, exitCode, openHandles);
+					const types = Object.entries(openHandles).map(([type, count]) => `${type} x${count}`);
+					logWarning(`Build output is complete but the process was still alive ${graceMs}ms after prerender (open handles: ${types.length > 0 ? types.join(", ") : "none reported"}); exiting with code ${exitCode}. Usual causes: TanStack Query gcTime timers armed during SSR, or module-scope timers and connection pools in server code.`);
+					process.exit(exitCode);
+				}, graceMs).unref();
+			}
+		}
+	};
+}
 function prerenderIsEnabled(startOptions) {
 	const spa = startOptions.spa;
 	if (spa && (spa.enabled ?? true)) return true;
@@ -1084,9 +1164,10 @@ function defineConfig(configOrOptions = {}) {
 				optionObject.nitro = false;
 				logWarning("`cloudflare: false` is deprecated in v2 — migrated to `nitro: false`. Update your config to drop the warning.");
 			} else logWarning("The `cloudflare` option was removed in v2. Use `nitro: false` to disable the deploy plugin, or `nitro: { preset: '...' }` to configure it. The `cloudflare` setting is being ignored.");
-			options = "vite" in optionObject || "serverFnErrorLogger" in optionObject || "ssrErrorLogger" in optionObject || "nitro" in optionObject || "tanstackStart" in optionObject || "react" in optionObject || "envDefine" in optionObject || "hmrGate" in optionObject ? optionObject : { vite: optionObject };
+			options = "vite" in optionObject || "serverFnErrorLogger" in optionObject || "ssrErrorLogger" in optionObject || "nitro" in optionObject || "tanstackStart" in optionObject || "react" in optionObject || "envDefine" in optionObject || "hmrGate" in optionObject || "buildExitWatchdog" in optionObject ? optionObject : { vite: optionObject };
 		}
 		const internalPlugins = [];
+		let exitWatchdog;
 		if (mode === "development") {
 			const { devtools } = await import("@tanstack/devtools-vite");
 			internalPlugins.push(devtools({
@@ -1171,6 +1252,10 @@ function defineConfig(configOrOptions = {}) {
 					const shimState = {};
 					internalPlugins.push(prerenderPreviewShim(shimState, nitroDirs), prerenderPreviewShimCleanup(shimState));
 				}
+				if (isSandbox && prerenderEnabled) {
+					const watchdog = resolveExitWatchdog(options.buildExitWatchdog);
+					if (watchdog.enabled) exitWatchdog = prerenderExitWatchdog(watchdog.graceMs);
+				}
 				if (isSandbox) internalPlugins.push(stripRedundantNodejsCompatFlag(nitroDirs));
 			}
 		}
@@ -1250,6 +1335,7 @@ function defineConfig(configOrOptions = {}) {
 			host: PRERENDER_PREVIEW_HOST,
 			port: 0
 		} }, config);
+		if (exitWatchdog) config = mergeConfig(config, { plugins: [exitWatchdog] });
 		if (isSandbox) return config;
 		return applyWatchDebounceDefaults(config);
 	};

package/package.json

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