@luckystack/server 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.1] - 2026-07-18
+
+### Fixed
+
+- **A failed dev-tooling init no longer fails silently.** When `initializeAll()`
+  throws at boot, `createLuckyStackServer` cleared `devApis`/`devSyncs` but kept
+  serving — with only a `warn` — so every `/api` and `/sync` route died with no
+  explanation (it once read as a per-route type-validation bug across restarts).
+  The init failure is now logged at `error` level with the full cause + recovery
+  step (hot reload is off, restart after fixing), and recorded so the API/sync
+  HTTP routes answer with a `503` naming the real cause instead of a misleading
+  `404` on an empty registry. New internal `devToolsStatus` module.
+- **Dev port auto-increment now explains the zombie-process consequence.** When a
+  restart hops off a busy port, the warning spells out that a previous/zombie dev
+  server is still holding the old port and that any client pinned there (an old
+  browser tab, the Vite proxy's cached target) keeps talking to the OLD process,
+  not the restart.
+
 ## [0.7.0] - 2026-07-16
 
 ### Fixed

package/dist/index.js

@@ -963,6 +963,13 @@ var resolveRequesterIp = (req) => {
   return rawRemoteAddress || trustProxy && (req.headers["x-forwarded-for"] || req.headers["x-real-ip"]) ? resolveClientIp3({ rawAddress: rawRemoteAddress, headers: req.headers, trustProxy, trustedProxyHopCount }) : void 0;
 };
 
+// src/devToolsStatus.ts
+var devToolsInitError = null;
+var markDevToolsInitFailed = (error) => {
+  devToolsInitError = error;
+};
+var getDevToolsInitError = () => devToolsInitError;
+
 // src/httpRoutes/apiRoute.ts
 var handleApiRoute = async ({
   req,
@@ -1006,6 +1013,20 @@ var handleApiRoute = async ({
       res.end(JSON.stringify(response));
       return true;
     }
+    const devToolsError = getDevToolsInitError();
+    if (devToolsError) {
+      const response = {
+        status: "error",
+        httpStatus: 503,
+        message: "api.devToolsUnavailable",
+        errorCode: "api.devToolsUnavailable",
+        detail: `Dev tooling failed to initialize, so NO API routes are loaded. Fix the cause and RESTART the dev server (hot reload is off). Cause: ${devToolsError.message}`
+      };
+      res.setHeader("Content-Type", "application/json");
+      res.writeHead(503);
+      res.end(JSON.stringify(response));
+      return true;
+    }
     const apiData = typeof params === "object" ? { ...params } : {};
     delete apiData.stream;
     const requesterIp = resolveRequesterIp(req);
@@ -1140,6 +1161,19 @@ var handleSyncRoute = async ({
       res.end(JSON.stringify(response));
       return true;
     }
+    const devToolsError = getDevToolsInitError();
+    if (devToolsError) {
+      const response = {
+        status: "error",
+        message: "sync.devToolsUnavailable",
+        errorCode: "sync.devToolsUnavailable",
+        detail: `Dev tooling failed to initialize, so NO sync routes are loaded. Fix the cause and RESTART the dev server (hot reload is off). Cause: ${devToolsError.message}`
+      };
+      res.setHeader("Content-Type", "application/json");
+      res.writeHead(503);
+      res.end(JSON.stringify(response));
+      return true;
+    }
     const syncParams = normalizeHttpSyncParams(params);
     const requesterIp = resolveRequesterIp(req);
     const result = await sync.handleHttpSyncRequest({
@@ -2296,7 +2330,11 @@ var initDevTools = async () => {
     devkit.setupWatchers();
   });
   if (devkitError) {
-    getLogger13().warn("dev tooling failed to initialize \u2014 continuing without hot reload.", { error: devkitError.message });
+    markDevToolsInitFailed(devkitError);
+    getLogger13().error(
+      `dev tooling FAILED to initialize \u2014 the server is running but EVERY /api and /sync route will fail until this is fixed. Hot reload is OFF (the file watchers never started), so fix the cause below and RESTART the server. Cause: ${devkitError.message}`,
+      devkitError
+    );
   }
 };
 var listenLuckyStackServer = (httpServer, ip, port, callback) => new Promise((resolve, reject) => {
@@ -2314,7 +2352,7 @@ var listenLuckyStackServer = (httpServer, ip, port, callback) => new Promise((re
       }
       if (autoIncrement) {
         getLogger13().warn(
-          `Port ${String(attemptPort)} is in use \u2014 trying ${String(attemptPort + 1)} (auto-increment; set SERVER_PORT_AUTO_INCREMENT=0 to disable)`
+          `Port ${String(attemptPort)} is in use \u2014 trying ${String(attemptPort + 1)} (auto-increment; set SERVER_PORT_AUTO_INCREMENT=0 to disable). A previous/zombie dev server is still holding :${String(attemptPort)}: anything pinned to that port (an old browser tab, the Vite proxy's cached target, a manual client) will keep talking to the OLD process, NOT this restart. If this restart was meant to replace it, stop the process on :${String(attemptPort)} first.`
         );
         tryListen(attemptPort + 1);
         return;