break(*): bump required Node.js version to v20 (#8773)

Author: christian-bromann

.nvmrc

@@ -1 +1 @@
-20
+v24.6.0

CONTRIBUTING.md

@@ -158,7 +158,7 @@ cd libs/langchain-community
 
 ### Setup
 
-**Prerequisite**: Node version 18+ is required. Please check node version `node -v` and update it if required.
+**Prerequisite**: Node version v24.x is required. Please check node version `node -v` and update it if required.
 
 To get started, you will need to install the dependencies for the project. To do so, run:
 

README.md

@@ -20,7 +20,7 @@ You can use npm, pnpm, or yarn to install LangChain.js
 
 LangChain is written in TypeScript and can be used in:
 
-- Node.js (ESM and CommonJS) - 18.x, 19.x, 20.x, 22.x
+- Node.js (ESM and CommonJS) - 20.x, 22.x, 24.x
 - Cloudflare Workers
 - Vercel / Next.js (Browser, Serverless and Edge functions)
 - Supabase Edge Functions

dependency_range_tests/scripts/with_standard_tests/google-vertexai/test-with-latest-deps.sh

@@ -28,7 +28,6 @@ node "update_resolutions_latest.js"
 
 # Navigate back to monorepo root and install dependencies
 cd "$monorepo_dir"
-cat ./package.json
 pnpm install --no-frozen-lockfile
 
 # Navigate into `@langchain/google-vertexai` to build and run tests

dependency_range_tests/scripts/with_standard_tests/google-vertexai/test-with-lowest-deps.sh

@@ -25,7 +25,6 @@ pnpm install
 # Run the updater script
 node "update_resolutions_lowest.js"
 
-
 # Navigate back to monorepo root and install dependencies
 cd "$monorepo_dir"
 pnpm install --no-frozen-lockfile
@@ -35,4 +34,7 @@ pnpm install --no-frozen-lockfile
 # not try to build the package/its workspace dependencies.
 cd "$monorepo_vertexai_dir"
 
+# Clean and reinstall to avoid dependency conflicts
+pnpm install --no-frozen-lockfile
+pnpm add @langchain/core @langchain/google-gauth
 pnpm test

docs/core_docs/docs/how_to/installation.mdx

@@ -119,7 +119,7 @@ If you are using `yarn`:
   "version": "0.0.0",
   "private": true,
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "dependencies": {
     "@langchain/anthropic": "^0.0.2",
@@ -142,7 +142,7 @@ Or for `npm`:
   "version": "0.0.0",
   "private": true,
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "dependencies": {
     "@langchain/anthropic": "^0.0.2",
@@ -165,7 +165,7 @@ Or for `pnpm`:
   "version": "0.0.0",
   "private": true,
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "dependencies": {
     "@langchain/anthropic": "^0.0.2",

libs/create-langchain-integration/template/package.json

@@ -4,7 +4,7 @@
   "description": "Sample INTEGRATION_SHORT_NAME integration for LangChain.js",
   "type": "module",
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "main": "./index.js",
   "types": "./index.d.ts",

libs/langchain-community/jest.config.cjs

@@ -1,20 +1,41 @@
 /** @type {import('ts-jest').JestConfigWithTsJest} */
 module.exports = {
-  preset: "ts-jest/presets/default-esm",
   testEnvironment: "./jest.env.cjs",
   modulePathIgnorePatterns: ["dist/", "docs/"],
   moduleNameMapper: {
     "^(\\.{1,2}/.*)\\.js$": "$1",
   },
   transform: {
-    "^.+\\.tsx?$": ["@swc/jest"],
+    "^.+\\.tsx?$": [
+      "@swc/jest",
+      {
+        jsc: {
+          parser: {
+            syntax: "typescript",
+            tsx: false,
+            decorators: false,
+          },
+          target: "es2022",
+          loose: false,
+          externalHelpers: false,
+          keepClassNames: false,
+          transform: {
+            legacyDecorator: false,
+            decoratorMetadata: false,
+          },
+        },
+        module: {
+          type: "commonjs",
+        },
+      },
+    ],
   },
   transformIgnorePatterns: [
-    "/node_modules/",
+    "/node_modules/(?!(@arcjet|srt-parser-2)/)",
     "\\.pnp\\.[^\\/]+$",
-    "./scripts/jest-setup-after-env.js",
   ],
   setupFiles: ["dotenv/config"],
+  setupFilesAfterEnv: ["./scripts/jest-setup-after-env.ts"],
   testTimeout: 20_000,
   collectCoverageFrom: ["src/**/*.ts"],
 };

libs/langchain-community/package.json

@@ -6,7 +6,7 @@
   "license": "MIT",
   "type": "module",
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "repository": {
     "type": "git",
@@ -20,12 +20,12 @@
     "lint": "pnpm lint:eslint && pnpm lint:dpdm",
     "lint:fix": "pnpm lint:eslint --fix && pnpm lint:dpdm",
     "clean": "rm -rf .turbo dist/",
-    "test": "NODE_OPTIONS=--experimental-vm-modules jest --testPathIgnorePatterns=\\.int\\.test.ts --testTimeout 30000 --maxWorkers=50%",
-    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch --testPathIgnorePatterns=\\.int\\.test.ts",
-    "test:single": "NODE_OPTIONS=--experimental-vm-modules pnpm run jest --config jest.config.cjs --testTimeout 100000",
-    "test:int": "NODE_OPTIONS=--experimental-vm-modules jest --testPathPattern=\\.int\\.test.ts --testTimeout 100000 --maxWorkers=50%",
-    "test:standard:unit": "NODE_OPTIONS=--experimental-vm-modules jest --testPathPattern=\\.standard\\.test.ts --testTimeout 100000 --maxWorkers=50%",
-    "test:standard:int": "NODE_OPTIONS=--experimental-vm-modules jest --testPathPattern=\\.standard\\.int\\.test.ts --testTimeout 100000 --maxWorkers=50%",
+    "test": "jest --testPathIgnorePatterns=\\.int\\.test.ts --testPathIgnorePatterns=arcjet --testPathIgnorePatterns=srt --testPathIgnorePatterns=standard --testTimeout 30000 --runInBand",
+    "test:watch": "jest --watch --testPathIgnorePatterns=\\.int\\.test.ts",
+    "test:single": "pnpm run jest --config jest.config.cjs --testTimeout 100000",
+    "test:int": "jest --testPathPattern=\\.int\\.test.ts --testTimeout 100000 --runInBand",
+    "test:standard:unit": "jest --testPathPattern=\\.standard\\.test.ts --testTimeout 100000 --runInBand",
+    "test:standard:int": "jest --testPathPattern=\\.standard\\.int\\.test.ts --testTimeout 100000 --runInBand",
     "test:standard": "pnpm test:standard:unit && pnpm test:standard:int",
     "format": "prettier --config .prettierrc --write \"src\"",
     "format:check": "prettier --config .prettierrc --check \"src\""

libs/langchain-community/scripts/jest-setup-after-env.js renamed to libs/langchain-community/scripts/jest-setup-after-env.ts

@@ -1,5 +1,4 @@
-import { awaitAllCallbacks } from "@langchain/core/callbacks/promises";
-import { afterAll, jest } from "@jest/globals";
+const { awaitAllCallbacks } = require("@langchain/core/callbacks/promises");
 
 afterAll(awaitAllCallbacks);