fix(core): vendor superjson to fix ESM/CJS compatibility

Bundle superjson and its dependency (copy-anything) during build to avoid
ERR_REQUIRE_ESM errors on Node.js versions that don't support require(ESM)
by default (< 22.12.0) and AWS Lambda which intentionally disables it.

- Add scripts/bundle-superjson.mjs to bundle superjson with esbuild
- Update build script to bundle vendor files before tshy compilation
- Move superjson from dependencies to devDependencies
- Update imports to use vendored bundles

Fixes #2937
pnpm install

Author: ericallam

.gitignore

@@ -15,6 +15,9 @@ out/
 dist
 packages/**/dist
 
+# vendored bundles (generated during build)
+packages/**/src/**/vendor
+
 # Tailwind
 apps/**/styles/tailwind.css
 packages/**/styles/tailwind.css

packages/core/package.json

@@ -157,10 +157,11 @@
   },
   "sideEffects": false,
   "scripts": {
-    "clean": "rimraf dist .tshy .tshy-build .turbo",
+    "clean": "rimraf dist .tshy .tshy-build .turbo src/v3/vendor",
     "update-version": "tsx ../../scripts/updateVersion.ts",
-    "build": "tshy && pnpm run update-version",
-    "dev": "tshy --watch",
+    "bundle-vendor": "node scripts/bundle-superjson.mjs",
+    "build": "pnpm run bundle-vendor && tshy && node scripts/bundle-superjson.mjs --copy && pnpm run update-version",
+    "dev": "pnpm run bundle-vendor && tshy --watch",
     "typecheck": "tsc --noEmit -p tsconfig.src.json",
     "test": "vitest",
     "check-exports": "attw --pack ."
@@ -193,7 +194,6 @@
     "socket.io": "4.7.4",
     "socket.io-client": "4.7.5",
     "std-env": "^3.8.1",
-    "superjson": "^2.2.1",
     "tinyexec": "^0.3.2",
     "uncrypto": "^0.1.3",
     "zod": "3.25.76",
@@ -212,6 +212,7 @@
     "defu": "^6.1.4",
     "esbuild": "^0.23.0",
     "rimraf": "^3.0.2",
+    "superjson": "^2.2.1",
     "ts-essentials": "10.0.1",
     "tshy": "^3.0.2",
     "tsx": "4.17.0"

packages/core/scripts/bundle-superjson.mjs

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+/**
+ * This script bundles superjson and its dependency (copy-anything) into
+ * vendored CJS and ESM bundles to avoid the ERR_REQUIRE_ESM error.
+ *
+ * superjson v2.x is ESM-only, which causes issues on:
+ * - Node.js versions before 22.12.0 (require(ESM) not enabled by default)
+ * - AWS Lambda (intentionally disables require(ESM))
+ *
+ * Usage:
+ *   node scripts/bundle-superjson.mjs          # Bundle to src/v3/vendor
+ *   node scripts/bundle-superjson.mjs --copy   # Also copy to dist directories
+ */
+
+import * as esbuild from "esbuild";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readFileSync, mkdirSync, copyFileSync } from "node:fs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = join(__dirname, "..");
+const vendorDir = join(packageRoot, "src", "v3", "vendor");
+
+// Get the installed superjson version for the banner
+const superjsonPkg = JSON.parse(
+  readFileSync(join(packageRoot, "node_modules", "superjson", "package.json"), "utf-8")
+);
+const banner = `/**
+ * Bundled superjson v${superjsonPkg.version}
+ *
+ * This file is auto-generated by scripts/bundle-superjson.mjs
+ * Do not edit directly - run the script to regenerate.
+ *
+ * Original package: https://github.com/flightcontrolhq/superjson
+ * License: MIT
+ */`;
+
+async function bundle() {
+  // Ensure vendor directory exists
+  mkdirSync(vendorDir, { recursive: true });
+
+  // Bundle for CommonJS
+  await esbuild.build({
+    entryPoints: [join(packageRoot, "node_modules", "superjson", "dist", "index.js")],
+    bundle: true,
+    format: "cjs",
+    platform: "node",
+    target: "node18",
+    outfile: join(vendorDir, "superjson.cjs"),
+    banner: { js: banner },
+    // Don't minify to keep it debuggable
+    minify: false,
+  });
+
+  // Bundle for ESM
+  await esbuild.build({
+    entryPoints: [join(packageRoot, "node_modules", "superjson", "dist", "index.js")],
+    bundle: true,
+    format: "esm",
+    platform: "node",
+    target: "node18",
+    outfile: join(vendorDir, "superjson.mjs"),
+    banner: { js: banner },
+    minify: false,
+  });
+
+  console.log("Bundled superjson v" + superjsonPkg.version);
+  console.log("  -> src/v3/vendor/superjson.cjs (CommonJS)");
+  console.log("  -> src/v3/vendor/superjson.mjs (ESM)");
+
+  // Copy to dist directories if --copy flag is passed
+  if (process.argv.includes("--copy")) {
+    const distCommonjsVendor = join(packageRoot, "dist", "commonjs", "v3", "vendor");
+    const distEsmVendor = join(packageRoot, "dist", "esm", "v3", "vendor");
+
+    mkdirSync(distCommonjsVendor, { recursive: true });
+    mkdirSync(distEsmVendor, { recursive: true });
+
+    copyFileSync(join(vendorDir, "superjson.cjs"), join(distCommonjsVendor, "superjson.cjs"));
+    copyFileSync(join(vendorDir, "superjson.mjs"), join(distEsmVendor, "superjson.mjs"));
+
+    console.log("Copied to dist directories");
+  }
+}
+
+bundle().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

packages/core/src/v3/imports/superjson-cjs.cts

@@ -1,8 +1,10 @@
+// Use vendored superjson bundle to avoid ESM/CJS compatibility issues
+// See: https://github.com/triggerdotdev/trigger.dev/issues/2937
 // @ts-ignore
-const { default: superjson } = require("superjson");
+const superjson = require("../vendor/superjson.cjs");
 
 // @ts-ignore
-superjson.registerCustom<Buffer, number[]>(
+superjson.default.registerCustom<Buffer, number[]>(
   {
     isApplicable: (v: unknown): v is Buffer => typeof Buffer === "function" && Buffer.isBuffer(v),
     serialize: (v: Buffer) => [...v],
@@ -12,4 +14,4 @@ superjson.registerCustom<Buffer, number[]>(
 );
 
 // @ts-ignore
-module.exports.default = superjson;
+module.exports.default = superjson.default;

packages/core/src/v3/imports/superjson.ts

@@ -1,11 +1,13 @@
+// Use vendored superjson bundle to avoid ESM/CJS compatibility issues
+// See: https://github.com/triggerdotdev/trigger.dev/issues/2937
 // @ts-ignore
-import superjson from "superjson";
+import superjson from "../vendor/superjson.mjs";
 
 superjson.registerCustom<Buffer, number[]>(
   {
-    isApplicable: (v): v is Buffer => typeof Buffer === "function" && Buffer.isBuffer(v),
-    serialize: (v) => [...v],
-    deserialize: (v) => Buffer.from(v),
+    isApplicable: (v: unknown): v is Buffer => typeof Buffer === "function" && Buffer.isBuffer(v),
+    serialize: (v: Buffer) => [...v],
+    deserialize: (v: number[]) => Buffer.from(v),
   },
   "buffer"
 );