chore: upgrade to TypeScript 7 (#4318)

carderne · devin-ai-integration[bot] · web-flow · commit 85f5b37c68d6 · 2026-08-05T15:49:44.000+01:00
## Summary

Upgrade the monorepo to TypeScript 7.0.2 and update package build
tooling for compatibility with the native compiler.

## Design

Package builds now use `tshy` 4, while the packages still using `tsup`
move to `tsdown`. The few scripts that depend on the legacy TypeScript
compiler API use an explicit TypeScript 6 alias; declaration portability
coverage invokes the TypeScript 7 CLI directly.

Turbo is updated so workspace tasks can read the regenerated pnpm
lockfile.

---------

Co-authored-by: devin-ai-integration[bot] &lt;158243242+devin-ai-integration[bot]@users.noreply.github.com&gt;
diff --git a/.changeset/typescript-seven-builds.md b/.changeset/typescript-seven-builds.md
@@ -0,0 +1,13 @@
+---
+"trigger.dev": patch
+"@trigger.dev/build": patch
+"@trigger.dev/core": patch
+"@trigger.dev/python": patch
+"@trigger.dev/react-hooks": patch
+"@trigger.dev/redis-worker": patch
+"@trigger.dev/rsc": patch
+"@trigger.dev/schema-to-json": patch
+"@trigger.dev/sdk": patch
+---
+
+Refresh package builds for TypeScript 7 compatibility while preserving existing runtime entry points. TypeScript remains an optional peer for the decorator metadata build extension, so installing the Trigger.dev CLI does not install an additional compiler.
diff --git a/apps/webapp/app/utils/searchParams.ts b/apps/webapp/app/utils/searchParams.ts
@@ -104,7 +104,7 @@ export function createSearchParams<TParams extends ParamType>(
   return { success: true, params: new SearchParams<TParams>(parsed.params as TParams, schema) };
 }
 
-function parseSearchParams<TParams extends ParamType>(params: TParams, schema: ZodType<TParams>) {
+function parseSearchParams<TParams>(params: unknown, schema: ZodType<TParams>) {
   const parsedParams = schema.safeParse(params);
 
   if (!parsedParams.success) {
diff --git a/apps/webapp/package.json b/apps/webapp/package.json
@@ -269,6 +269,8 @@
     "tailwindcss": "^4.3.1",
     "tsconfig-paths": "^3.14.1",
     "tsx": "^4.20.6",
+    "typescript": "catalog:",
+    "typescript-legacy-api": "npm:typescript@6.0.3",
     "vite-tsconfig-paths": "^5.1.4",
     "vite": "^6.4.2"
   },
diff --git a/apps/webapp/scripts/runOpsLegacyGuard.ts b/apps/webapp/scripts/runOpsLegacyGuard.ts
@@ -12,7 +12,7 @@
  *   pnpm --filter webapp run guard:runops-legacy            # regenerate baseline
  *   pnpm --filter webapp run guard:runops-legacy -- --check # CI gate
  */
-import ts from "typescript";
+import ts from "typescript-legacy-api";
 import * as fs from "node:fs";
 import * as path from "node:path";
 
diff --git a/internal-packages/observability-map/package.json b/internal-packages/observability-map/package.json
@@ -6,12 +6,13 @@
   "main": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
   "dependencies": {
-    "typescript": "catalog:"
+    "@typescript/typescript6": "6.0.2"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",
     "rimraf": "6.0.1",
     "tsx": "^4.19.2",
+    "typescript": "catalog:",
     "vitest": "4.1.7"
   },
   "scripts": {
diff --git a/internal-packages/observability-map/src/docstringReferences.test.ts b/internal-packages/observability-map/src/docstringReferences.test.ts
@@ -1,4 +1,4 @@
-import ts from "typescript";
+import ts from "@typescript/typescript6";
 import { readFileSync, readdirSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { CHECKS } from "./checks/index.js";
diff --git a/internal-packages/observability-map/src/mutations.ts b/internal-packages/observability-map/src/mutations.ts
@@ -1,4 +1,4 @@
-import ts from "typescript";
+import ts from "@typescript/typescript6";
 
 /**
  * Source-to-source mutations for the tree-scale corpus in `mutationCorpus.test.ts`. Why they are text
diff --git a/internal-packages/observability-map/src/scan.ts b/internal-packages/observability-map/src/scan.ts
@@ -1,4 +1,4 @@
-import ts from "typescript";
+import ts from "@typescript/typescript6";
 import { readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import type { CatchEvidence, EntryPoint, LogCall } from "./types.js";
diff --git a/internal-packages/observability-map/src/suppression.ts b/internal-packages/observability-map/src/suppression.ts
@@ -1,4 +1,4 @@
-import ts from "typescript";
+import ts from "@typescript/typescript6";
 import { CHECKS } from "./checks/index.js";
 
 const KNOWN_CHECK_IDS = new Set(CHECKS.map((c) => c.id));
diff --git a/internal-packages/observability-map/src/webappSymbols.test.ts b/internal-packages/observability-map/src/webappSymbols.test.ts
@@ -1,4 +1,4 @@
-import ts from "typescript";
+import ts from "@typescript/typescript6";
 import { readdirSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { AUDIT_SYMBOLS } from "./checks/auditTrail.js";
diff --git a/package.json b/package.json
@@ -68,7 +68,7 @@
     "pkg-pr-new": "0.0.75",
     "pkg-types": "1.1.3",
     "tsx": "^3.7.1",
-    "turbo": "^1.10.3",
+    "turbo": "^1.13.4",
     "typescript": "catalog:",
     "vite-tsconfig-paths": "^4.0.5",
     "vitest": "4.1.7"
@@ -91,12 +91,10 @@
       "antlr4ts@0.5.0-alpha.4": "patches/antlr4ts@0.5.0-alpha.4.patch",
       "@window-splitter/state@1.1.3": "patches/@window-splitter__state@1.1.3.patch",
       "streamdown@2.5.0": "patches/streamdown@2.5.0.patch",
-      "tsup@8.4.0": "patches/tsup@8.4.0.patch",
       "@remix-run/router@1.23.3": "patches/@remix-run__router@1.23.3.patch",
       "@clickhouse/client-common@1.12.1": "patches/@clickhouse__client-common@1.12.1.patch"
     },
     "overrides": {
-      "typescript": "catalog:",
       "@types/node": "24.13.3",
       "react@^18": "18.3.1",
       "react-dom@^18": "18.3.1",
diff --git a/packages/build/package.json b/packages/build/package.json
@@ -91,8 +91,17 @@
     "@types/resolve": "^1.20.6",
     "esbuild": "^0.23.0",
     "rimraf": "6.0.1",
-    "tshy": "^3.0.2",
-    "tsx": "4.17.0"
+    "tshy": "^4.1.3",
+    "tsx": "4.17.0",
+    "typescript": "6.0.3"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
   },
   "engines": {
     "node": ">=18.20.0"
diff --git a/packages/cli-v3/package.json b/packages/cli-v3/package.json
@@ -67,7 +67,7 @@
     "find-up": "^7.0.0",
     "rimraf": "^6.0.1",
     "ts-essentials": "10.0.1",
-    "tshy": "^3.0.2",
+    "tshy": "^4.1.3",
     "tsx": "4.17.0"
   },
   "scripts": {
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -244,7 +244,7 @@
     "rimraf": "^6.0.1",
     "superjson": "^2.2.1",
     "ts-essentials": "10.0.1",
-    "tshy": "^3.0.2",
+    "tshy": "^4.1.3",
     "tsx": "4.17.0"
   },
   "engines": {
diff --git a/packages/plugins/package.json b/packages/plugins/package.json
@@ -19,14 +19,14 @@
   },
   "scripts": {
     "clean": "rimraf dist .turbo",
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",
     "rimraf": "6.0.1",
-    "tsup": "^8.4.0",
+    "tsdown": "0.22.10",
     "typescript": "catalog:"
   },
   "engines": {
diff --git a/packages/plugins/tsdown.config.ts b/packages/plugins/tsdown.config.ts
@@ -1,10 +1,10 @@
-import { defineConfig } from "tsup";
+import { defineConfig } from "tsdown";
 
 export default defineConfig({
   entry: ["src/index.ts"],
   format: ["cjs", "esm"],
+  fixedExtension: false,
   dts: true,
-  splitting: false,
   sourcemap: true,
   clean: true,
   treeshake: true,
diff --git a/packages/python/package.json b/packages/python/package.json
@@ -51,7 +51,7 @@
   "devDependencies": {
     "@types/node": "^24.13.3",
     "rimraf": "6.0.1",
-    "tshy": "^3.0.2",
+    "tshy": "^4.1.3",
     "typescript": "catalog:",
     "tsx": "4.17.0",
     "esbuild": "^0.23.0",
diff --git a/packages/react-hooks/package.json b/packages/react-hooks/package.json
@@ -45,7 +45,7 @@
     "@types/react": "*",
     "@types/react-dom": "*",
     "rimraf": "^6.0.1",
-    "tshy": "^3.0.2",
+    "tshy": "^4.1.3",
     "tsx": "4.17.0"
   },
   "peerDependencies": {
diff --git a/packages/redis-worker/package.json b/packages/redis-worker/package.json
@@ -17,8 +17,8 @@
   ],
   "scripts": {
     "clean": "rimraf dist .turbo",
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
     "typecheck": "tsc --noEmit -p tsconfig.src.json",
     "test": "vitest --sequence.concurrent=false --no-file-parallelism"
   },
@@ -37,8 +37,9 @@
     "@internal/tracing": "workspace:*",
     "@types/lodash.omit": "^4.5.7",
     "@types/seedrandom": "^3.0.8",
+    "esbuild": "^0.23.0",
     "rimraf": "6.0.1",
-    "tsup": "^8.4.0",
+    "tsdown": "0.22.10",
     "tsx": "4.17.0"
   },
   "engines": {
diff --git a/packages/redis-worker/src/worker.ts b/packages/redis-worker/src/worker.ts
@@ -19,7 +19,7 @@ import { nanoid } from "nanoid";
 import pLimit from "p-limit";
 import { z } from "zod";
 import { type AnyQueueItem, SimpleQueue } from "./queue.js";
-import { parseExpression } from "cron-parser";
+import cronParser from "cron-parser";
 
 export const CronSchema = z.object({
   cron: z.string(),
@@ -1130,9 +1130,10 @@ class Worker<TCatalog extends WorkerCatalog> {
   }
 
   private calculateNextScheduledAt(cron: string, lastTimestamp?: Date): Date {
-    const scheduledAt = parseExpression(cron, {
-      currentDate: lastTimestamp,
-    })
+    const scheduledAt = cronParser
+      .parseExpression(cron, {
+        currentDate: lastTimestamp,
+      })
       .next()
       .toDate();
 
diff --git a/packages/redis-worker/test/build-output.test.ts b/packages/redis-worker/test/build-output.test.ts
@@ -0,0 +1,44 @@
+import { build } from "esbuild";
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+import { afterAll, expect, test } from "vitest";
+
+const packageDir = fileURLToPath(new URL("../", import.meta.url));
+const tempDir = mkdtempSync(join(tmpdir(), "redis-worker-build-output-"));
+
+const require = createRequire(import.meta.url);
+
+afterAll(() => {
+  rmSync(tempDir, { recursive: true, force: true });
+});
+
+test("the ESM output can be rebundled and loaded as CommonJS", async () => {
+  const buildResult = spawnSync("pnpm", ["exec", "tsdown"], {
+    cwd: packageDir,
+    encoding: "utf8",
+  });
+  const buildOutput = [buildResult.stdout, buildResult.stderr].filter(Boolean).join("\n");
+
+  expect(buildResult.error, buildOutput).toBeUndefined();
+  expect(buildResult.status, buildOutput).toBe(0);
+
+  const esmPath = join(packageDir, "dist/index.js");
+  const esmOutput = readFileSync(esmPath, "utf8");
+  expect(esmOutput).not.toMatch(/\b[\w$]*createRequire[\w$]*\s*\(\s*import\.meta\.url\s*\)/);
+
+  const cjsPath = join(tempDir, "index.cjs");
+  await build({
+    entryPoints: [esmPath],
+    outfile: cjsPath,
+    bundle: true,
+    format: "cjs",
+    platform: "node",
+    logLevel: "silent",
+  });
+
+  expect(() => require(cjsPath)).not.toThrow();
+}, 30_000);
diff --git a/packages/redis-worker/tsdown.config.ts b/packages/redis-worker/tsdown.config.ts
@@ -0,0 +1,87 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["cjs", "esm"],
+  fixedExtension: false,
+  tsconfig: "tsconfig.src.json",
+  dts: {
+    sourcemap: false,
+  },
+  sourcemap: true,
+  // The CJS declarations are emitted in a separate pass, so their output can
+  // disable source maps without affecting the runtime bundle.
+  outputOptions(options, _format, { cjsDts }) {
+    if (!cjsDts) return;
+
+    return {
+      ...options,
+      sourcemap: false,
+    };
+  },
+  clean: true,
+  treeshake: true,
+  minify: false,
+  deps: {
+    onlyBundle: false,
+    alwaysBundle: [
+      // Always bundle internal packages
+      /^@internal/,
+      // Always bundle ESM-only packages
+      "nanoid",
+      "p-limit",
+    ],
+    dts: {
+      // The TypeScript 7 declaration emitter consumes referenced package declarations.
+      neverBundle: [/^@internal/],
+    },
+  },
+  // rolldown injects its own `__require` helper in the ESM output as
+  // `createRequire(import.meta.url)` with no fallback. When this ESM bundle is
+  // re-bundled into a CJS consumer (e.g. the webapp server), esbuild replaces
+  // `import.meta.url` with `undefined`, so `createRequire(undefined)` throws at
+  // startup. Patch the helper to fall back to a valid path, matching the
+  // fallback the previous tsup banner provided.
+  plugins: [
+    // The ESM declarations share an output pass with the runtime bundle.
+    // Remove their dangling map comment while retaining runtime source maps.
+    {
+      name: "strip-declaration-sourcemap-comments",
+      generateBundle(_options, bundle) {
+        for (const output of Object.values(bundle)) {
+          if (output.type !== "chunk" || !/\.d\.(?:c|m)?ts$/.test(output.fileName)) {
+            continue;
+          }
+
+          output.code = output.code.replace(/\n?\/\/# sourceMappingURL=.*$/m, "");
+        }
+      },
+    },
+    {
+      name: "resilient-create-require",
+      renderChunk(code: string) {
+        const unsafeCreateRequire = /(\b[\w$]*createRequire[\w$]*\s*\()\s*import\.meta\.url\s*\)/g;
+        const patched = code.replace(
+          unsafeCreateRequire,
+          "$1import.meta.url || process.cwd() + '/index.js')"
+        );
+
+        if (patched === code) return null;
+
+        return {
+          code: patched,
+          map: null,
+        };
+      },
+      generateBundle(_options, bundle) {
+        const unsafeCreateRequire = /\b[\w$]*createRequire[\w$]*\s*\(\s*import\.meta\.url\s*\)/;
+
+        for (const output of Object.values(bundle)) {
+          if (output.type === "chunk" && unsafeCreateRequire.test(output.code)) {
+            throw new Error(`Unsafe createRequire helper remained in ${output.fileName}`);
+          }
+        }
+      },
+    },
+  ],
+});
diff --git a/packages/redis-worker/tsup.config.ts b/packages/redis-worker/tsup.config.ts
diff --git a/packages/rsc/package.json b/packages/rsc/package.json
diff --git a/packages/schema-to-json/package.json b/packages/schema-to-json/package.json
diff --git a/packages/trigger-sdk/package.json b/packages/trigger-sdk/package.json
diff --git a/packages/trigger-sdk/test/declaration-emit.test.ts b/packages/trigger-sdk/test/declaration-emit.test.ts
diff --git a/patches/tsup@8.4.0.patch b/patches/tsup@8.4.0.patch
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml

Original file line number	Diff line number	Diff line change
`@@ -104,7 +104,7 @@ export function createSearchParams<TParams extends ParamType>(`
`104`	`104`	`return { success: true, params: new SearchParams<TParams>(parsed.params as TParams, schema) };`
`105`	`105`	`}`
`106`	`106`
`107`		`-function parseSearchParams<TParams extends ParamType>(params: TParams, schema: ZodType<TParams>) {`
	`107`	`+function parseSearchParams<TParams>(params: unknown, schema: ZodType<TParams>) {`
`108`	`108`	`const parsedParams = schema.safeParse(params);`
`109`	`109`
`110`	`110`	`if (!parsedParams.success) {`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-import ts from "typescript";`
	`1`	`+import ts from "@typescript/typescript6";`
`2`	`2`	`import { readFileSync, readdirSync } from "node:fs";`
`3`	`3`	`import { join, resolve } from "node:path";`
`4`	`4`	`import { CHECKS } from "./checks/index.js";`