chore: Add Node.js compatibility note

js/README.md

@@ -119,3 +119,7 @@ See the [Migrate from v1.x to v2.x guide](https://www.braintrust.dev/docs/refere
 ### Upgrading from 0.x to 1.x
 
 See the [Migrate from v1.x to v2.x guide](https://www.braintrust.dev/docs/reference/sdks/typescript/migrations/v0-to-v1).
+
+## Compatibility
+
+The `braintrust` package is compatible with Node.js versions 20.12.0, 22.13.0, for the respective major Node.js release lines and above.

js/eslint.config.ts

@@ -1,8 +1,12 @@
 import tseslint from "@typescript-eslint/eslint-plugin";
 import tsparser from "@typescript-eslint/parser";
+import esX from "eslint-plugin-es-x";
+import n from "eslint-plugin-n";
 import nodeImport from "eslint-plugin-node-import";
 import tsupConfigImport from "./tsup.config";
 
+const supportedNodeVersionRange = "^20.12.0 || ^21.7.0 || ^22.13.0 || >=23.5.0";
+
 // Handle both ESM and CJS module formats
 const tsupConfig = Array.isArray(tsupConfigImport)
   ? tsupConfigImport
@@ -51,11 +55,14 @@ export default [
     },
     plugins: {
       "@typescript-eslint": tseslint,
+      "es-x": esX,
+      n,
       "node-import": nodeImport,
     },
     rules: {
       // Base TypeScript rules
       ...tseslint.configs.recommended.rules,
+      ...esX.configs["flat/restrict-to-es2022"].rules,
       // TODO: Fix violations and re-enable as "error"
       "@typescript-eslint/no-explicit-any": "warn",
       "@typescript-eslint/no-unused-vars": [
@@ -130,6 +137,21 @@ export default [
             "AsyncLocalStorage.enterWith() is not supported in Cloudflare Workers. Use AsyncLocalStorage.run() to scope context instead.",
         },
       ],
+      "n/no-unsupported-features/node-builtins": [
+        "error",
+        {
+          version: supportedNodeVersionRange,
+          allowExperimental: true,
+        },
+      ],
+      "n/no-unsupported-features/es-builtins": [
+        "error",
+        { version: supportedNodeVersionRange },
+      ],
+      "n/no-unsupported-features/es-syntax": [
+        "error",
+        { version: supportedNodeVersionRange },
+      ],
       // Require node: protocol for Node.js built-in imports (for Deno compatibility)
       // This plugin automatically detects ALL Node.js built-ins - no manual list needed!
       "node-import/prefer-node-protocol": "error",

js/package.json

@@ -192,11 +192,14 @@
     "ai": "^6.0.0",
     "async": "^3.2.5",
     "cross-env": "^7.0.3",
+    "eslint-plugin-es-x": "9.7.0",
+    "eslint-plugin-n": "^18.2.1",
     "eslint-plugin-node-import": "^1.0.5",
     "openai": "6.25.0",
     "rollup": "^4.60.3",
     "tar": "^7.5.16",
     "tinybench": "^4.0.1",
+    "ts-declaration-location": "^1.0.7",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typedoc": "^0.25.13",