From f140536d8d1cf1c5a52a57fbca9b1fd2f06c7853 Mon Sep 17 00:00:00 2001
From: Abhijeet Prasad <abhijeet@braintrustdata.com>
Date: Thu, 28 May 2026 14:51:34 -0400
Subject: [PATCH] chore: declare node engine requirements

---
 .changeset/green-nodes-serve.md              | 12 ++++++++++++
 integrations/browser-js/package.json         |  3 +++
 integrations/langchain-js/package.json       |  3 +++
 integrations/openai-agents-js/package.json   |  3 +++
 integrations/otel-js/package.json            |  3 +++
 integrations/templates-nunjucks/package.json |  3 +++
 integrations/temporal-js/package.json        |  3 +++
 integrations/vercel-ai-sdk/package.json      |  3 +++
 js/package.json                              |  3 +++
 9 files changed, 36 insertions(+)
 create mode 100644 .changeset/green-nodes-serve.md

diff --git a/.changeset/green-nodes-serve.md b/.changeset/green-nodes-serve.md
new file mode 100644
index 000000000..4fadda19a
--- /dev/null
+++ b/.changeset/green-nodes-serve.md
@@ -0,0 +1,12 @@
+---
+"braintrust": patch
+"@braintrust/browser": patch
+"@braintrust/langchain-js": patch
+"@braintrust/openai-agents": patch
+"@braintrust/otel": patch
+"@braintrust/templates-nunjucks-js": patch
+"@braintrust/temporal": patch
+"@braintrust/vercel-ai-sdk": patch
+---
+
+Declare the existing Node.js 20+ runtime requirement in package metadata.
diff --git a/integrations/browser-js/package.json b/integrations/browser-js/package.json
index 3b612682f..d4b5b7a12 100644
--- a/integrations/browser-js/package.json
+++ b/integrations/browser-js/package.json
@@ -2,6 +2,9 @@
   "name": "@braintrust/browser",
   "version": "0.0.3",
   "description": "Braintrust SDK for browser environments with AsyncLocalStorage polyfill",
+  "engines": {
+    "node": ">=20"
+  },
   "type": "module",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
diff --git a/integrations/langchain-js/package.json b/integrations/langchain-js/package.json
index 895a9e3ff..0764c2124 100644
--- a/integrations/langchain-js/package.json
+++ b/integrations/langchain-js/package.json
@@ -2,6 +2,9 @@
   "name": "@braintrust/langchain-js",
   "version": "0.2.4",
   "description": "SDK for integrating Braintrust with LangChain.js",
+  "engines": {
+    "node": ">=20"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
diff --git a/integrations/openai-agents-js/package.json b/integrations/openai-agents-js/package.json
index 5a7252132..982af6908 100644
--- a/integrations/openai-agents-js/package.json
+++ b/integrations/openai-agents-js/package.json
@@ -2,6 +2,9 @@
   "name": "@braintrust/openai-agents",
   "version": "0.1.5",
   "description": "SDK for integrating Braintrust with OpenAI Agents",
+  "engines": {
+    "node": ">=20"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
diff --git a/integrations/otel-js/package.json b/integrations/otel-js/package.json
index 15c1502d8..0d11c81ba 100644
--- a/integrations/otel-js/package.json
+++ b/integrations/otel-js/package.json
@@ -2,6 +2,9 @@
   "name": "@braintrust/otel",
   "version": "0.2.0",
   "description": "SDK for integrating Braintrust with OpenTelemetry",
+  "engines": {
+    "node": ">=20"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
diff --git a/integrations/templates-nunjucks/package.json b/integrations/templates-nunjucks/package.json
index 94e2cd530..9457df308 100644
--- a/integrations/templates-nunjucks/package.json
+++ b/integrations/templates-nunjucks/package.json
@@ -2,6 +2,9 @@
   "name": "@braintrust/templates-nunjucks-js",
   "version": "0.0.1",
   "description": "Nunjucks templating support for the Braintrust JS SDK",
+  "engines": {
+    "node": ">=20"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
diff --git a/integrations/temporal-js/package.json b/integrations/temporal-js/package.json
index fc2e9dbef..eb11f5197 100644
--- a/integrations/temporal-js/package.json
+++ b/integrations/temporal-js/package.json
@@ -2,6 +2,9 @@
   "name": "@braintrust/temporal",
   "version": "0.1.1",
   "description": "SDK for integrating Braintrust with Temporal",
+  "engines": {
+    "node": ">=20"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
diff --git a/integrations/vercel-ai-sdk/package.json b/integrations/vercel-ai-sdk/package.json
index c8e5e3af3..46fb71da8 100644
--- a/integrations/vercel-ai-sdk/package.json
+++ b/integrations/vercel-ai-sdk/package.json
@@ -2,6 +2,9 @@
   "name": "@braintrust/vercel-ai-sdk",
   "version": "0.0.6",
   "description": "SDK for integrating Braintrust with Vercel AI SDK",
+  "engines": {
+    "node": ">=20"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
diff --git a/js/package.json b/js/package.json
index f0d6ca8e8..beb04c4b7 100644
--- a/js/package.json
+++ b/js/package.json
@@ -2,6 +2,9 @@
   "name": "braintrust",
   "version": "3.13.0",
   "description": "SDK for integrating Braintrust",
+  "engines": {
+    "node": ">=20"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/braintrustdata/braintrust-sdk-javascript.git",