@lovable.dev/vite-tanstack-config 2.2.0 → 2.3.0

package/dist/index.cjs

@@ -131,9 +131,28 @@ function applyWatchDebounceDefaults(config) {
   });
 }
 var SSR_CAPTURE_KEY = "__LOVABLE_TANSTACK_CAPTURE_SSR_ERROR__";
+var HANDLER_RAN_KEY = "__LOVABLE_TANSTACK_HANDLER_RAN__";
+var BUILD_ERROR_MESSAGE = /transform failed with \d+ error|failed to parse source/i;
+function isBuildError(error) {
+  if (typeof error === "string")
+    return BUILD_ERROR_MESSAGE.test(error);
+  if (!error || typeof error !== "object")
+    return false;
+  const e = error;
+  if (typeof e.plugin === "string" && (e.plugin.startsWith("vite:") || e.plugin.startsWith("esbuild:")))
+    return true;
+  if (e.frame != null && e.loc != null)
+    return true;
+  if (Array.isArray(e.errors) && e.errors.length > 0 && e.errors.every((x) => x != null && typeof x === "object" && "text" in x && "location" in x)) {
+    return true;
+  }
+  const message = typeof e.message === "string" ? e.message : "";
+  return BUILD_ERROR_MESSAGE.test(message);
+}
 function devSsrErrorLogger() {
   let lastCapture;
   const CAPTURE_TTL_MS = 5e3;
+  const handlerRanFlag = Symbol("lovableHandlerRan");
   const capture = (error) => {
     lastCapture = { error, at: Date.now() };
   };
@@ -153,6 +172,11 @@ function devSsrErrorLogger() {
     apply: "serve",
     configureServer(server) {
       globalThis[SSR_CAPTURE_KEY] = capture;
+      globalThis[HANDLER_RAN_KEY] = (event) => {
+        const res = event?.node?.res;
+        if (res)
+          res[handlerRanFlag] = true;
+      };
       const g = globalThis;
       if (typeof g.addEventListener === "function") {
         const addListener = g.addEventListener;
@@ -164,28 +188,58 @@ function devSsrErrorLogger() {
       server.httpServer?.once("close", () => {
         process.off("unhandledRejection", onUnhandledRejection);
       });
-      server.middlewares.use((_req, res, next) => {
-        const origEnd = res.end.bind(res);
-        res.end = (...args) => {
-          if (res.statusCode >= 500) {
-            const captured = consumeCapture();
-            let err;
-            if (captured instanceof Error) {
-              err = captured;
-            } else if (typeof captured === "string" && captured.length > 0) {
-              err = new Error(captured);
-            } else {
-              err = null;
-            }
+      server.middlewares.use((req, res, next) => {
+        let handled = false;
+        const handleErrorResponse = () => {
+          if (handled || res.statusCode < 500)
+            return;
+          handled = true;
+          const captured = consumeCapture();
+          const ranHandler = Boolean(res[handlerRanFlag]);
+          let source;
+          if (!ranHandler) {
+            source = "vite";
+          } else if (isBuildError(captured)) {
+            source = "build";
+          } else {
+            source = "app";
+          }
+          if (!res.headersSent) {
             try {
-              server.ws.send({
-                type: "custom",
-                event: "server-ssr-error",
-                data: err ? { name: err.name, message: err.message, stack: err.stack } : { name: "Error", message: "SSR rendering failed" }
-              });
+              res.setHeader("x-lovable-error-source", source);
             } catch {
             }
           }
+          const where = [req.method, req.url].filter(Boolean).join(" ") || "the request";
+          let data;
+          if (captured instanceof Error) {
+            data = { name: captured.name, message: captured.message, stack: captured.stack };
+          } else if (typeof captured === "string" && captured.length > 0) {
+            data = { name: "Error", message: captured };
+          } else if (ranHandler) {
+            data = {
+              message: `The app returned ${res.statusCode} while handling ${where}. The error was handled by a route or error boundary, so no stack was captured \u2014 check the failing loader/route code and the dev server output.`
+            };
+          } else {
+            data = {
+              message: `Dev server returned ${res.statusCode} for ${where} before the app handler ran. This is usually a Vite build/transform error \u2014 check the dev server output for the underlying error.`
+            };
+          }
+          try {
+            server.ws.send({ type: "custom", event: "server-ssr-error", data });
+          } catch {
+          }
+        };
+        const origWriteHead = res.writeHead.bind(res);
+        res.writeHead = (...args) => {
+          if (typeof args[0] === "number")
+            res.statusCode = args[0];
+          handleErrorResponse();
+          return origWriteHead(...args);
+        };
+        const origEnd = res.end.bind(res);
+        res.end = (...args) => {
+          handleErrorResponse();
           return origEnd(...args);
         };
         next();
@@ -203,7 +257,7 @@ function devSsrErrorLogger() {
       }
       return code.replace(
         needle,
-        `Promise.resolve(${needle}).catch((err) => { globalThis.${SSR_CAPTURE_KEY}?.(err); throw err; })`
+        `(globalThis.${HANDLER_RAN_KEY}?.(typeof h3Event === "undefined" ? undefined : h3Event), Promise.resolve(${needle}).catch((err) => { globalThis.${SSR_CAPTURE_KEY}?.(err); throw err; }))`
       );
     }
   };

package/dist/index.js

@@ -97,9 +97,28 @@ function applyWatchDebounceDefaults(config) {
   });
 }
 var SSR_CAPTURE_KEY = "__LOVABLE_TANSTACK_CAPTURE_SSR_ERROR__";
+var HANDLER_RAN_KEY = "__LOVABLE_TANSTACK_HANDLER_RAN__";
+var BUILD_ERROR_MESSAGE = /transform failed with \d+ error|failed to parse source/i;
+function isBuildError(error) {
+  if (typeof error === "string")
+    return BUILD_ERROR_MESSAGE.test(error);
+  if (!error || typeof error !== "object")
+    return false;
+  const e = error;
+  if (typeof e.plugin === "string" && (e.plugin.startsWith("vite:") || e.plugin.startsWith("esbuild:")))
+    return true;
+  if (e.frame != null && e.loc != null)
+    return true;
+  if (Array.isArray(e.errors) && e.errors.length > 0 && e.errors.every((x) => x != null && typeof x === "object" && "text" in x && "location" in x)) {
+    return true;
+  }
+  const message = typeof e.message === "string" ? e.message : "";
+  return BUILD_ERROR_MESSAGE.test(message);
+}
 function devSsrErrorLogger() {
   let lastCapture;
   const CAPTURE_TTL_MS = 5e3;
+  const handlerRanFlag = Symbol("lovableHandlerRan");
   const capture = (error) => {
     lastCapture = { error, at: Date.now() };
   };
@@ -119,6 +138,11 @@ function devSsrErrorLogger() {
     apply: "serve",
     configureServer(server) {
       globalThis[SSR_CAPTURE_KEY] = capture;
+      globalThis[HANDLER_RAN_KEY] = (event) => {
+        const res = event?.node?.res;
+        if (res)
+          res[handlerRanFlag] = true;
+      };
       const g = globalThis;
       if (typeof g.addEventListener === "function") {
         const addListener = g.addEventListener;
@@ -130,28 +154,58 @@ function devSsrErrorLogger() {
       server.httpServer?.once("close", () => {
         process.off("unhandledRejection", onUnhandledRejection);
       });
-      server.middlewares.use((_req, res, next) => {
-        const origEnd = res.end.bind(res);
-        res.end = (...args) => {
-          if (res.statusCode >= 500) {
-            const captured = consumeCapture();
-            let err;
-            if (captured instanceof Error) {
-              err = captured;
-            } else if (typeof captured === "string" && captured.length > 0) {
-              err = new Error(captured);
-            } else {
-              err = null;
-            }
+      server.middlewares.use((req, res, next) => {
+        let handled = false;
+        const handleErrorResponse = () => {
+          if (handled || res.statusCode < 500)
+            return;
+          handled = true;
+          const captured = consumeCapture();
+          const ranHandler = Boolean(res[handlerRanFlag]);
+          let source;
+          if (!ranHandler) {
+            source = "vite";
+          } else if (isBuildError(captured)) {
+            source = "build";
+          } else {
+            source = "app";
+          }
+          if (!res.headersSent) {
             try {
-              server.ws.send({
-                type: "custom",
-                event: "server-ssr-error",
-                data: err ? { name: err.name, message: err.message, stack: err.stack } : { name: "Error", message: "SSR rendering failed" }
-              });
+              res.setHeader("x-lovable-error-source", source);
             } catch {
             }
           }
+          const where = [req.method, req.url].filter(Boolean).join(" ") || "the request";
+          let data;
+          if (captured instanceof Error) {
+            data = { name: captured.name, message: captured.message, stack: captured.stack };
+          } else if (typeof captured === "string" && captured.length > 0) {
+            data = { name: "Error", message: captured };
+          } else if (ranHandler) {
+            data = {
+              message: `The app returned ${res.statusCode} while handling ${where}. The error was handled by a route or error boundary, so no stack was captured \u2014 check the failing loader/route code and the dev server output.`
+            };
+          } else {
+            data = {
+              message: `Dev server returned ${res.statusCode} for ${where} before the app handler ran. This is usually a Vite build/transform error \u2014 check the dev server output for the underlying error.`
+            };
+          }
+          try {
+            server.ws.send({ type: "custom", event: "server-ssr-error", data });
+          } catch {
+          }
+        };
+        const origWriteHead = res.writeHead.bind(res);
+        res.writeHead = (...args) => {
+          if (typeof args[0] === "number")
+            res.statusCode = args[0];
+          handleErrorResponse();
+          return origWriteHead(...args);
+        };
+        const origEnd = res.end.bind(res);
+        res.end = (...args) => {
+          handleErrorResponse();
           return origEnd(...args);
         };
         next();
@@ -169,7 +223,7 @@ function devSsrErrorLogger() {
       }
       return code.replace(
         needle,
-        `Promise.resolve(${needle}).catch((err) => { globalThis.${SSR_CAPTURE_KEY}?.(err); throw err; })`
+        `(globalThis.${HANDLER_RAN_KEY}?.(typeof h3Event === "undefined" ? undefined : h3Event), Promise.resolve(${needle}).catch((err) => { globalThis.${SSR_CAPTURE_KEY}?.(err); throw err; }))`
       );
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovable.dev/vite-tanstack-config",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Vite config wrapper for Lovable TanStack Start projects",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -9,6 +9,15 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --outDir dist",
+    "typecheck": "tsgo --noEmit",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest",
+    "prepublishOnly": "npm run clean && npm run build",
+    "clean": "rimraf dist",
+    "coverage": "vitest run --coverage"
+  },
   "keywords": [
     "vite",
     "tanstack",
@@ -40,20 +49,12 @@
     "@tanstack/react-start": "^1.162.9",
     "@vitejs/plugin-react": "^4.5.2",
     "@tailwindcss/vite": "^4.2.1",
-    "@types/node": "22.13.13",
+    "@types/node": "catalog:",
     "rimraf": "^5.0.0",
     "tsup": "^7.2.0",
-    "typescript": "^5.9.3",
+    "typescript": "catalog:",
     "vite": "^7.3.1",
     "vite-tsconfig-paths": "^6.0.2",
-    "vitest": "^4.1.5"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --outDir dist",
-    "typecheck": "tsgo --noEmit",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "test": "vitest",
-    "clean": "rimraf dist",
-    "coverage": "vitest run --coverage"
+    "vitest": "catalog:"
   }
-}
+}