@superblocksteam/sdk 2.0.130-next.1 → 2.0.130-next.3

package/dist/vite-plugin-sdk-api-entry-point.mjs

@@ -1,4 +1,5 @@
 import path from "node:path";
+const SERVER_APIS_DIR = "server/apis";
 /**
  * Build a sourcemap `mappings` string for a simple prepend operation.
  *
@@ -18,24 +19,84 @@ function buildPrependMappings(prependLineCount, originalLineCount) {
         .join(";");
     return empty + original;
 }
+function qualifyAnchoredServerApisRelative(relative) {
+    if (relative === `${SERVER_APIS_DIR}/index.ts`) {
+        return null;
+    }
+    const baseName = path.posix.basename(relative);
+    if (baseName === "index.ts") {
+        return null;
+    }
+    if (!relative.endsWith(".ts") && !relative.endsWith(".tsx")) {
+        return null;
+    }
+    return relative;
+}
+function qualifySegmentFallbackRelative(relative) {
+    if (!relative.startsWith(`${SERVER_APIS_DIR}/`)) {
+        return null;
+    }
+    // Reject false positives when appRootDir sits under a server/apis/ path.
+    if (relative.includes("/client/")) {
+        return null;
+    }
+    const baseName = path.posix.basename(relative);
+    if (baseName !== "api.ts" && baseName !== "api.tsx") {
+        return null;
+    }
+    return relative;
+}
+/**
+ * Resolve the app-root-relative entry point path for a Vite module id.
+ *
+ * Fullstack apps keep `server/apis/` at the app root while `vite.config.ts`
+ * often sets `root: "./client"`. Dev server and build already pass the true
+ * app root into the plugin; failures are intermittent and depend on how Vite
+ * resolves module ids for files outside the client subtree (for example
+ * `../server/apis/...` relatives or `/@fs/...` absolute ids). Plain absolute
+ * paths under `<appRoot>/server/apis/` already matched before this helper.
+ */
+export function resolveSdkApiEntryPointRelativePath(appRootDir, moduleId) {
+    const normalizedId = path.normalize(moduleId);
+    const normalizedRoot = path.normalize(appRootDir);
+    const relative = path
+        .relative(normalizedRoot, normalizedId)
+        .replace(/\\/g, "/");
+    if (relative.startsWith(`${SERVER_APIS_DIR}/`)) {
+        return qualifyAnchoredServerApisRelative(relative);
+    }
+    // Plugin base is client/ or Vite passes a ../server/apis/... module id.
+    if (relative.startsWith(`../${SERVER_APIS_DIR}/`)) {
+        return qualifyAnchoredServerApisRelative(relative.slice("../".length));
+    }
+    // Fallback for module ids not matched above: /@fs/ prefixed ids, standard
+    // absolute paths when appRootDir is 2+ levels above server/apis/, etc.
+    // NOTE: unanchored to appRootDir — matches any id containing /server/apis/
+    // with an api.ts/api.tsx basename. lastIndexOf picks the deepest segment.
+    const posixId = normalizedId.replace(/\\/g, "/");
+    const segment = `/${SERVER_APIS_DIR}/`;
+    const segmentIndex = posixId.lastIndexOf(segment);
+    if (segmentIndex !== -1) {
+        return qualifySegmentFallbackRelative(posixId.slice(segmentIndex + 1));
+    }
+    return null;
+}
 /**
  * Vite plugin that prepends `__setEntryPoint(relativePath)` to SDK API files
  * so that `api()` can stamp the authoritative source file
  * path onto the compiled API object.
  *
+ * @param appRootDir - App root (parent of `client/` and `server/`).
+ *
  * Runs in both dev and build. The user's source code is never modified on disk.
  */
-export function sdkApiEntryPointPlugin(root) {
+export function sdkApiEntryPointPlugin(appRootDir) {
     return {
         name: "sb-sdk-api-entry-point",
         enforce: "pre",
         transform(code, id) {
-            const relative = path.relative(root, id).replace(/\\/g, "/");
-            if (!relative.startsWith("server/apis/") ||
-                relative === "server/apis/index.ts") {
-                return null;
-            }
-            if (!relative.endsWith(".ts") && !relative.endsWith(".tsx")) {
+            const relative = resolveSdkApiEntryPointRelativePath(appRootDir, id);
+            if (!relative) {
                 return null;
             }
             const prependLines = [

package/dist/vite-plugin-sdk-api-entry-point.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin-sdk-api-entry-point.mjs","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.mts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAC3B,gBAAwB,EACxB,iBAAyB;IAEzB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3C,IAAI,iBAAiB,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC;SACtB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAC9D,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,KAAK,GAAG,QAAQ,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,KAAK;QAEd,SAAS,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC7D,IACE,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC;gBACpC,QAAQ,KAAK,sBAAsB,EACnC,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5D,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,YAAY,GAAG;gBACnB,4EAA4E;gBAC5E,eAAe,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI;gBAC3C,EAAE;aACH,CAAC;YACF,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAElD,MAAM,mBAAmB,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;YAEpD,OAAO;gBACL,IAAI,EAAE,OAAO,GAAG,IAAI;gBACpB,GAAG,EAAE;oBACH,OAAO,EAAE,CAAC;oBACV,IAAI,EAAE,EAAE;oBACR,OAAO,EAAE,CAAC,EAAE,CAAC;oBACb,cAAc,EAAE,CAAC,IAAI,CAAC;oBACtB,KAAK,EAAE,EAAE;oBACT,QAAQ,EAAE,oBAAoB,CAC5B,mBAAmB,EACnB,iBAAiB,CAClB;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"vite-plugin-sdk-api-entry-point.mjs","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.mts"],"names":[],"mappings":"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"}

package/dist/vite-plugin-sdk-api-entry-point.test.mjs

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { describe, it, expect } from "vitest";
-import { sdkApiEntryPointPlugin } from "./vite-plugin-sdk-api-entry-point.mjs";
+import { resolveSdkApiEntryPointRelativePath, sdkApiEntryPointPlugin, } from "./vite-plugin-sdk-api-entry-point.mjs";
 function createPlugin(root) {
     const plugin = sdkApiEntryPointPlugin(root);
     const transform = plugin.transform;
@@ -60,6 +60,38 @@ function expectValidSourcemap(result, originalCode) {
         expect(sourceLine).toBe(i);
     });
 }
+describe("resolveSdkApiEntryPointRelativePath", () => {
+    it("resolves server API paths from the true app root", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/app", "/app/server/apis/GetUsers/api.ts")).toBe("server/apis/GetUsers/api.ts");
+    });
+    it("resolves server API paths when the base dir is vite client/", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/app/client", "/app/server/apis/GetPastAnalyses/api.ts")).toBe("server/apis/GetPastAnalyses/api.ts");
+    });
+    it("resolves server API paths from absolute /@fs module ids", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/app", "/@fs/Users/me/app/server/apis/GetFeedback/api.ts")).toBe("server/apis/GetFeedback/api.ts");
+    });
+    it("returns null for the registry barrel file", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/app", "/app/server/apis/index.ts")).toBeNull();
+    });
+    it("returns null when app root contains server/apis and module is a client file", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/home/server/apis/myapp", "/home/server/apis/myapp/client/components/Button.tsx")).toBeNull();
+    });
+    it("uses the deepest server/apis segment in /@fs fallback", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/app", "/@fs/home/server/apis/decoy/server/apis/GetReal/api.ts")).toBe("server/apis/GetReal/api.ts");
+    });
+    it("resolves server API paths for api.tsx entry points", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/app", "/app/server/apis/Render/api.tsx")).toBe("server/apis/Render/api.tsx");
+    });
+    it("resolves Clark-style API entry points that are not named api.ts", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/app", "/app/server/apis/issues/list-issues.ts")).toBe("server/apis/issues/list-issues.ts");
+    });
+    it("resolves helper modules under server/apis/ on anchored paths", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/app", "/app/server/apis/GetFoo/helper.ts")).toBe("server/apis/GetFoo/helper.ts");
+    });
+    it("returns null for index.ts under an API directory", () => {
+        expect(resolveSdkApiEntryPointRelativePath("/app", "/app/server/apis/GetFoo/index.ts")).toBeNull();
+    });
+});
 describe("sdkApiEntryPointPlugin", () => {
     const root = "/app";
     it("has the correct plugin name and enforce order", () => {
@@ -68,6 +100,12 @@ describe("sdkApiEntryPointPlugin", () => {
         expect(plugin.enforce).toBe("pre");
     });
     describe("transform", () => {
+        it("prepends __setEntryPoint for Clark-style list-issues.ts entry points", () => {
+            const { transform } = createPlugin(root);
+            const result = transform('export default api({ name: "ListIssues" });', path.join(root, "server/apis/issues/list-issues.ts"));
+            expect(result).not.toBeNull();
+            expect(result.code).toContain('__sb_set_ep("server/apis/issues/list-issues.ts");');
+        });
         it("prepends __setEntryPoint for a standard API file", () => {
             const { transform } = createPlugin(root);
             const result = transform('export default api({ name: "GetUsers" });', path.join(root, "server/apis/GetUsers/api.ts"));
@@ -103,6 +141,20 @@ describe("sdkApiEntryPointPlugin", () => {
             expect(result).not.toBeNull();
             expect(result.code).toContain('__sb_set_ep("server/apis/v2/GetUsers/api.ts");');
         });
+        it("prepends __setEntryPoint when plugin root is vite client/ subdir (fullstack)", () => {
+            const appRoot = "/app";
+            const viteRoot = path.join(appRoot, "client");
+            const { transform } = createPlugin(viteRoot);
+            const result = transform('export default api({ name: "GetPastAnalyses" });', path.join(appRoot, "server/apis/GetPastAnalyses/api.ts"));
+            expect(result).not.toBeNull();
+            expect(result.code).toContain('__sb_set_ep("server/apis/GetPastAnalyses/api.ts");');
+        });
+        it("prepends __setEntryPoint for /@fs/ module ids", () => {
+            const { transform } = createPlugin(root);
+            const result = transform('export default api({ name: "GetFeedback" });', "/@fs/Users/me/app/server/apis/GetFeedback/api.ts");
+            expect(result).not.toBeNull();
+            expect(result.code).toContain('__sb_set_ep("server/apis/GetFeedback/api.ts");');
+        });
         it("preserves original code after the prepend", () => {
             const { transform } = createPlugin(root);
             const originalCode = [

package/dist/vite-plugin-sdk-api-entry-point.test.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin-sdk-api-entry-point.test.mjs","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.test.mts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vite-plugin-sdk-api-entry-point.test.mjs","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.test.mts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EACL,mCAAmC,EACnC,sBAAsB,GACvB,MAAM,uCAAuC,CAAC;AAc/C,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,SAGL,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,SAAS,GACb,kEAAkE,CAAC;AAErE,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC;QAC/B,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;YACf,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACpD,KAAK,GAAG,CAAC,CAAC;YACV,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACvB,iBAAiB,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/B,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAC3B,MAAoC,EACpC,YAAoB;IAEpB,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE9C,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,iBAAiB,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAE5E,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACpD,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CACJ,mCAAmC,CACjC,MAAM,EACN,kCAAkC,CACnC,CACF,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CACJ,mCAAmC,CACjC,aAAa,EACb,yCAAyC,CAC1C,CACF,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CACJ,mCAAmC,CACjC,MAAM,EACN,kDAAkD,CACnD,CACF,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CACJ,mCAAmC,CAAC,MAAM,EAAE,2BAA2B,CAAC,CACzE,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,MAAM,CACJ,mCAAmC,CACjC,yBAAyB,EACzB,sDAAsD,CACvD,CACF,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CACJ,mCAAmC,CACjC,MAAM,EACN,wDAAwD,CACzD,CACF,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CACJ,mCAAmC,CACjC,MAAM,EACN,iCAAiC,CAClC,CACF,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CACJ,mCAAmC,CACjC,MAAM,EACN,wCAAwC,CACzC,CACF,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CACJ,mCAAmC,CACjC,MAAM,EACN,mCAAmC,CACpC,CACF,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CACJ,mCAAmC,CACjC,MAAM,EACN,kCAAkC,CACnC,CACF,CAAC,QAAQ,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC;IAEpB,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;YAC9E,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,6CAA6C,EAC7C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mCAAmC,CAAC,CACrD,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,mDAAmD,CACpD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,2CAA2C,EAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAC/C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,4EAA4E,CAC7E,CAAC;YACF,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,6CAA6C,CAC9C,CAAC;YACF,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,yCAAyC,EACzC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAC9C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,4CAA4C,CAC7C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,oBAAoB,EACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,sBAAsB,CAAC,CACxC,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,oBAAoB,EACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,CACzC,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,IAAI,EACJ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kCAAkC,CAAC,CACpD,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,yBAAyB,EACzB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAClD,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,gDAAgD,CACjD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;YACtF,MAAM,OAAO,GAAG,MAAM,CAAC;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC9C,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,SAAS,CACtB,kDAAkD,EAClD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,oCAAoC,CAAC,CACzD,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,oDAAoD,CACrD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,8CAA8C,EAC9C,kDAAkD,CACnD,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,gDAAgD,CACjD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG;gBACnB,oDAAoD;gBACpD,sBAAsB;gBACtB,qBAAqB;gBACrB,wBAAwB;gBACxB,qDAAqD;gBACrD,0CAA0C;gBAC1C,KAAK;aACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAC/C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC;YAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;YAExD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,sCAAsC,CAAC;YAC5D,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAC1C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;YAChE,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAC3C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,oBAAoB,CAAC,MAAO,EAAE,YAAY,CAAC,CAAC;YAE5C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,yBAAyB,CAAC;YAC/C,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAC1C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,oBAAoB,CAAC,MAAO,EAAE,YAAY,CAAC,CAAC;YAE5C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CACvB,iEAAiE,EACjE,CAAC,SAAS,EAAE,EAAE;YACZ,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAC7B,EAAE,MAAM,EAAE,SAAS,EAAE,EACrB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAC5C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,oBAAoB,CAAC,MAAO,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superblocksteam/sdk",
-  "version": "2.0.130-next.1",
+  "version": "2.0.130-next.3",
   "description": "Superblocks JS SDK",
   "homepage": "https://www.superblocks.com",
   "license": "Superblocks Community Software License",
@@ -17,14 +17,14 @@
     "@babel/plugin-proposal-decorators": "^7.28.0",
     "@babel/plugin-transform-typescript": "7.28.0",
     "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/api-logs": "^0.214.0",
+    "@opentelemetry/api-logs": "^0.217.0",
     "@opentelemetry/context-async-hooks": "^2.6.1",
-    "@opentelemetry/exporter-logs-otlp-http": "^0.214.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.214.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.217.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.217.0",
     "@opentelemetry/instrumentation-express": "^0.62.0",
-    "@opentelemetry/instrumentation-http": "^0.214.0",
+    "@opentelemetry/instrumentation-http": "^0.217.0",
     "@opentelemetry/resources": "^2.6.1",
-    "@opentelemetry/sdk-node": "^0.214.0",
+    "@opentelemetry/sdk-node": "^0.217.0",
     "@opentelemetry/semantic-conventions": "^1.36.0",
     "@superblocksteam/bucketeer-sdk": "1.1.0",
     "@vitejs/plugin-react": "4.3.4",
@@ -48,11 +48,11 @@
     "vite-tsconfig-paths": "^6.0.4",
     "winston": "^3.17.0",
     "yaml": "^2.7.1",
-    "@superblocksteam/library-shared": "2.0.130-next.1",
-    "@superblocksteam/shared": "0.9591.1",
-    "@superblocksteam/telemetry": "2.0.130-next.1",
-    "@superblocksteam/util": "2.0.130-next.1",
-    "@superblocksteam/vite-plugin-file-sync": "2.0.130-next.1"
+    "@superblocksteam/library-shared": "2.0.130-next.3",
+    "@superblocksteam/shared": "0.9591.3",
+    "@superblocksteam/telemetry": "2.0.130-next.3",
+    "@superblocksteam/util": "2.0.130-next.3",
+    "@superblocksteam/vite-plugin-file-sync": "2.0.130-next.3"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",

package/src/dev-utils/dev-server.mts

@@ -65,6 +65,7 @@ import {
   type DevServerFailureType,
   devServerMetrics,
 } from "./dev-server-metrics.mjs";
+import { buildFatalExitLog, parseIsWarm } from "./fatal-exit.mjs";
 import {
   formatViteDevServerStartedLog,
   logViteBuildError,
@@ -1101,6 +1102,18 @@ export async function createDevServer({
     }
   });
 
+  // Read once at startup. The pod's warm-or-cold launch mode is set when the pod
+  // starts and never changes, so this flag stays correct in the fatal-exit log
+  // even if the pod is activated later.
+  const isWarm = parseIsWarm(process.env.SUPERBLOCKS_WARM_STANDBY);
+
+  // Only the first fatal event writes a fatal-exit line and starts shutdown.
+  // Without this, one crash could write several lines: an unhandled rejection
+  // fires once per rejected promise, so a burst of failures (say a dead DB pool
+  // rejecting every in-flight query) would each write a line and each start
+  // shutdown, making one crash look like many in the logs and the crash count.
+  let fatalExitHandled = false;
+
   // Signal handlers attach `.catch` so a synchronous throw in
   // `runGracefulShutdown` (e.g. logger init or lockService shutdown throwing
   // before the first `await`) is logged rather than surfacing as an
@@ -1139,13 +1152,25 @@ export async function createDevServer({
     );
   });
 
-  // `uncaughtException` always force-exits in `.finally`, even when the
-  // underlying shutdown promise was already resolved by a prior signal. With
-  // the dedupe in place, awaiting the cached resolved promise short-circuits
-  // through `.then` without firing `.catch`; without the `.finally` the
-  // process would linger in event-loop limbo until the OS killed it.
+  // The `.finally` always ends the process once shutdown settles. If an earlier
+  // signal already ran shutdown, this handler still needs to exit; without the
+  // final `process.exit` the process could hang instead of stopping.
   process.on("uncaughtException", (error) => {
-    logger.error(`Uncaught exception: ${error.message}`, getErrorMeta(error));
+    if (fatalExitHandled) {
+      return;
+    }
+    fatalExitHandled = true;
+    // Write the fatal-exit line first, and synchronously, so the reason reaches
+    // the logs before anything else runs. Shutdown below may finish first and
+    // call `process.exit(0)`, so the container's real exit code can be 0 even
+    // though this was a crash. That is why `exit_code=1` here is the code this
+    // handler means to use, not a promise of what the container reports: for the
+    // JS-handler lines, trust that the line exists (and the `signal` field) over
+    // its `exit_code` when comparing against the pod's exit status.
+    logger.error(
+      buildFatalExitLog({ handler: "uncaughtException", exitCode: 1, isWarm }),
+      getErrorMeta(error),
+    );
     gracefulShutdown({
       logger,
       serverInitiated: false,
@@ -1154,7 +1179,34 @@ export async function createDevServer({
       .catch((shutdownError) => {
         logger.error(
           "Error during shutdown after uncaught exception:",
-          shutdownError,
+          getErrorMeta(shutdownError),
+        );
+      })
+      .finally(() => process.exit(1));
+  });
+
+  // Without its own listener, Node turns an unhandled promise rejection into an
+  // uncaught exception, which would log it under the wrong cause. Handle it here
+  // so a rejection is labelled as a rejection, then exit through the same
+  // shutdown path as an uncaught exception.
+  process.on("unhandledRejection", (reason) => {
+    if (fatalExitHandled) {
+      return;
+    }
+    fatalExitHandled = true;
+    logger.error(
+      buildFatalExitLog({ handler: "unhandledRejection", exitCode: 1, isWarm }),
+      getErrorMeta(reason),
+    );
+    gracefulShutdown({
+      logger,
+      serverInitiated: false,
+      source: "unhandledRejection",
+    })
+      .catch((shutdownError) => {
+        logger.error(
+          "Error during shutdown after unhandled rejection:",
+          getErrorMeta(shutdownError),
         );
       })
       .finally(() => process.exit(1));

package/src/dev-utils/fatal-exit.mts

@@ -0,0 +1,113 @@
+/**
+ * Structured fatal-exit logging for the dev server.
+ *
+ * The most common cause of live-edit pod deaths is a bare Node exit code 1 with
+ * no reason attached: the supervisor only sees the container exit code from
+ * Kubernetes, and the gVisor runtime reports no CPU/memory/event-loop metrics,
+ * so there is no way to tell why the process stopped. These helpers build one
+ * log line, easy to search for, that says why the process is exiting. It is
+ * written right before the process exits so the reason still lands in the pod
+ * logs even when the batched telemetry export never gets flushed.
+ *
+ * The fields go in the message body as `key=value` markers instead of as
+ * telemetry attributes, on purpose: at exit time the synchronous stdout write is
+ * the only sink we can rely on, while the batched OTel log exporter is usually
+ * dropped by `process.exit`. The existing warm-standby failure path in
+ * dev-server.mts already puts its markers in the body for the same reason. And
+ * for the same reason there is deliberately no OTel counter for fatal exits (a
+ * counter increment would be dropped at exit); `FATAL_EXIT_EVENT` below is the
+ * log token to query and alert on.
+ *
+ * Counting note for alerting: one crash can produce up to two of these lines.
+ * When a JS handler runs and its own `process.exit(1)` runs before shutdown can
+ * exit, the child emits a `handler=uncaughtException`/`unhandledRejection` line
+ * AND the supervisor (CLI parent, or the warm entrypoint shell) emits a
+ * `handler=containerExit` line for the same exit. A signal kill / OOM emits only
+ * the `containerExit` line (no JS handler ran); a JS crash where shutdown exits
+ * first with code 0 emits only the JS-handler line (the supervisor sees a clean
+ * exit). So a raw `count(event=dev_server_fatal_exit)` over-counts the double
+ * case: deduplicate by pod within a short time window for a true unique-crash
+ * count.
+ *
+ * Signal-kill field note: for a signal kill the cold parent emits
+ * `exit_code=null signal=SIGKILL` (Node's `child.on("exit")` gives a null code +
+ * the signal), while the warm entrypoint shell emits `exit_code=128+N
+ * signal=SIGKILL` (its `wait` returns the raw 128+N status). Both are correct
+ * for their context; query on the `signal` field, not `exit_code`, for
+ * signal-kill alerts.
+ */
+
+/**
+ * Where the fatal exit came from, so each kind can be told apart in the logs.
+ *
+ *   uncaughtException / unhandledRejection  A JS handler ran and knows the error
+ *                                           name/message/stack.
+ *   containerExit                           No JS handler ran (signal kill / OOM,
+ *                                           or the graceful-shutdown exit race);
+ *                                           the supervisor only knows the code +
+ *                                           signal. The CLI parent (dev-parent.mts)
+ *                                           and the warm entrypoint shell emit this
+ *                                           value. They cannot import this module,
+ *                                           so they repeat the same string.
+ */
+export type FatalExitHandler =
+  | "uncaughtException"
+  | "unhandledRejection"
+  | "containerExit";
+
+/** Fixed token so a log-based metric or a log search can pick out these lines. */
+export const FATAL_EXIT_EVENT = "dev_server_fatal_exit";
+
+export interface FatalExitFields {
+  /** Where the fatal exit came from. */
+  handler: FatalExitHandler;
+  /**
+   * Exit code the process is about to use (JS handler path) or the code the
+   * supervisor saw (container-exit path). `null` when the child was killed by a
+   * signal and has no exit code.
+   */
+  exitCode: number | null;
+  /** Signal that killed the process; absent for a JS-level exit. */
+  signal?: string | null;
+  /** Whether this pod was started as a warm-standby pod (entrypoint `--warm`). */
+  isWarm: boolean;
+}
+
+/**
+ * Parse the entrypoint's warm-standby env var the same way
+ * `scripts/dev-server-entrypoint.sh` does, so `is_warm` in the log matches the
+ * pod's launch mode whether or not it was activated later.
+ */
+export function parseIsWarm(value: string | undefined): boolean {
+  switch ((value ?? "").trim().toLowerCase()) {
+    case "true":
+    case "1":
+    case "yes":
+    case "on":
+      return true;
+    default:
+      return false;
+  }
+}
+
+/**
+ * Build the fatal-exit log message body. Every value is a simple primitive
+ * (enum / number / boolean), so the line is safe to write as-is even on the CSB
+ * log path.
+ *
+ * SYNC: this format is reproduced in two places that cannot import this module —
+ * `buildFatalExitLog` in `packages/cli/packages/cli/src/commands/dev-parent.mts`
+ * (the parent stays on `node:` builtins) and the `echo` line in
+ * `scripts/dev-server-entrypoint.sh` (bash). A field added here must be added in
+ * both, or `event=dev_server_fatal_exit` queries will miss one emitter.
+ */
+export function buildFatalExitLog(fields: FatalExitFields): string {
+  return [
+    "Dev server fatal exit",
+    `event=${FATAL_EXIT_EVENT}`,
+    `handler=${fields.handler}`,
+    `exit_code=${fields.exitCode ?? "null"}`,
+    `signal=${fields.signal ?? "none"}`,
+    `is_warm=${fields.isWarm}`,
+  ].join(" ");
+}

package/src/dev-utils/fatal-exit.test.mts

@@ -0,0 +1,81 @@
+import { describe, expect, it } from "vitest";
+
+import {
+  buildFatalExitLog,
+  FATAL_EXIT_EVENT,
+  parseIsWarm,
+} from "./fatal-exit.mjs";
+
+describe("parseIsWarm", () => {
+  it("treats the same truthy spellings as the entrypoint shell", () => {
+    for (const value of ["true", "1", "yes", "on", "TRUE", "Yes", " on "]) {
+      expect(parseIsWarm(value)).toBe(true);
+    }
+  });
+
+  it("treats anything else (including undefined) as not warm", () => {
+    for (const value of ["false", "0", "no", "off", "", "cold", undefined]) {
+      expect(parseIsWarm(value)).toBe(false);
+    }
+  });
+});
+
+describe("buildFatalExitLog", () => {
+  it("carries the stable event marker so a log-based metric can isolate the line", () => {
+    const line = buildFatalExitLog({
+      handler: "uncaughtException",
+      exitCode: 1,
+      isWarm: true,
+    });
+    expect(line).toContain(`event=${FATAL_EXIT_EVENT}`);
+  });
+
+  it("encodes the handler, exit code, signal, and warm flag as snake_case markers", () => {
+    const line = buildFatalExitLog({
+      handler: "uncaughtException",
+      exitCode: 1,
+      signal: "SIGABRT",
+      isWarm: true,
+    });
+    expect(line).toContain("handler=uncaughtException");
+    expect(line).toContain("exit_code=1");
+    expect(line).toContain("signal=SIGABRT");
+    expect(line).toContain("is_warm=true");
+  });
+
+  it("defaults the signal to none for a JS-level exit and renders a null code", () => {
+    const line = buildFatalExitLog({
+      handler: "containerExit",
+      exitCode: null,
+      isWarm: false,
+    });
+    expect(line).toContain("signal=none");
+    expect(line).toContain("exit_code=null");
+    expect(line).toContain("is_warm=false");
+  });
+
+  it("renders an explicit null signal as none (interface allows null and undefined)", () => {
+    const line = buildFatalExitLog({
+      handler: "uncaughtException",
+      exitCode: 1,
+      signal: null,
+      isWarm: false,
+    });
+    expect(line).toContain("signal=none");
+  });
+
+  it("produces the exact format-contract string (field names, order, separators)", () => {
+    // The full line is the log-query/alerting contract shared across the three
+    // emitters. A reordered field, changed separator, or added prefix would slip
+    // past the per-field toContain checks but break queries; this locks it.
+    const line = buildFatalExitLog({
+      handler: "uncaughtException",
+      exitCode: 1,
+      signal: null,
+      isWarm: false,
+    });
+    expect(line).toBe(
+      "Dev server fatal exit event=dev_server_fatal_exit handler=uncaughtException exit_code=1 signal=none is_warm=false",
+    );
+  });
+});