fix(runtime): gate new Node runtimes behind experimental aliases

Author: carderne

.changeset/experimental-node-runtimes.md

@@ -3,4 +3,4 @@
 "trigger.dev": patch
 ---
 
-Add experimental Node.js 24 and 26 task runtimes. Set `runtime` to `experimental-node-24` or `experimental-node-26` in `trigger.config.ts`; the forward-compatible `node-24` and `node-26` keys are also accepted.
+Add experimental Node.js 24 and 26 task runtimes. Set `runtime` to `experimental-node-24` or `experimental-node-26` in `trigger.config.ts`.

packages/cli-v3/src/config.test.ts

@@ -35,8 +35,6 @@ describe("loadConfig runtime", () => {
   it.each([
     ["experimental-node-24", "node-24"],
     ["experimental-node-26", "node-26"],
-    ["node-24", "node-24"],
-    ["node-26", "node-26"],
   ] as const)("normalizes %s before returning the resolved config", async (runtime, expected) => {
     const cwd = await createProject(runtime);
 
@@ -49,11 +47,14 @@ describe("loadConfig runtime", () => {
     await expect(loadConfig({ cwd, warn: false })).resolves.toMatchObject({ runtime: "node" });
   });
 
-  it("rejects unsupported runtimes while loading config", async () => {
-    const cwd = await createProject("node-23");
+  it.each(["node-24", "node-26", "node-23"])(
+    "rejects unsupported public runtime %s while loading config",
+    async (runtime) => {
+      const cwd = await createProject(runtime);
 
-    await expect(loadConfig({ cwd, warn: false })).rejects.toThrowError(
-      /Unsupported runtime "node-23" in trigger\.config/
-    );
-  });
+      await expect(loadConfig({ cwd, warn: false })).rejects.toThrowError(
+        new RegExp(`Unsupported runtime "${runtime}" in trigger\\.config`)
+      );
+    }
+  );
 });

packages/core/src/v3/build/runtime.test.ts

@@ -3,30 +3,32 @@ import { BuildManifest, BuildRuntime, ConfigRuntime, WorkerManifest } from "../s
 import { isExperimentalConfigRuntime, resolveBuildRuntime } from "./runtime.js";
 
 describe("runtime configuration", () => {
-  it.each([
-    "node",
-    "node-22",
-    "node-24",
-    "node-26",
-    "experimental-node-24",
-    "experimental-node-26",
-    "bun",
-  ] as const)("accepts %s as a public config runtime", (runtime) => {
-    expect(ConfigRuntime.parse(runtime)).toBe(runtime);
-  });
+  it.each(["node", "node-22", "experimental-node-24", "experimental-node-26", "bun"] as const)(
+    "accepts %s as a public config runtime",
+    (runtime) => {
+      expect(ConfigRuntime.parse(runtime)).toBe(runtime);
+    }
+  );
 
   it.each([
     ["experimental-node-24", "node-24"],
     ["experimental-node-26", "node-26"],
-    ["node-24", "node-24"],
-    ["node-26", "node-26"],
     ["node", "node"],
     ["node-22", "node-22"],
     ["bun", "bun"],
   ] as const)("normalizes %s to %s", (runtime, expected) => {
     expect(resolveBuildRuntime(runtime)).toBe(expected);
   });
 
+  it.each(["node-24", "node-26"] as const)(
+    "keeps internal runtime %s out of the public config schema",
+    (runtime) => {
+      expect(ConfigRuntime.safeParse(runtime).success).toBe(false);
+      expect(BuildRuntime.safeParse(runtime).success).toBe(true);
+      expect(() => resolveBuildRuntime(runtime)).toThrowError(/Unsupported runtime/);
+    }
+  );
+
   it("rejects unsupported config runtimes with a clear error", () => {
     expect(() => resolveBuildRuntime("node-23")).toThrowError(
       /Unsupported runtime "node-23" in trigger\.config\. Supported runtimes:/

packages/core/src/v3/schemas/build.ts

@@ -16,8 +16,6 @@ export type BuildTarget = z.infer<typeof BuildTarget>;
 export const ConfigRuntime = z.enum([
   "node",
   "node-22",
-  "node-24",
-  "node-26",
   "experimental-node-24",
   "experimental-node-26",
   "bun",