From afa4b2034c4f0923a6e20eb478a1acf57e56bf62 Mon Sep 17 00:00:00 2001
From: intech
Date: Sat, 6 Jun 2026 18:34:19 +0400
Subject: [PATCH] chore: raise minimum Node.js to 22.13.0 in examples
Node.js 20 reached end-of-life on 2026-04-30. Align examples with the framework
baseline of Node.js 22.13.0. Examples already pinned to 25.2.0 (native .ts
execution) are left unchanged.
- engines.node -> ">=22.13.0" for examples below the baseline (basic-service-node,
basic-service-tsx, cross-runtime-test, performance-test-server,
with-custom-interceptor, o11y-coroot/service)
- README requirements and node badge updated to Node.js 22+
Co-Authored-By: Claude Opus 4.8 (1M context)
---
README.md | 6 +++---
basic-service-bun/README.md | 2 +-
basic-service-node/README.md | 4 ++--
basic-service-node/package.json | 2 +-
basic-service-tsx/README.md | 10 +++++-----
basic-service-tsx/package.json | 2 +-
cross-runtime-test/package.json | 2 +-
o11y-coroot/service/package.json | 2 +-
performance-test-server/package.json | 2 +-
with-custom-interceptor/package.json | 2 +-
10 files changed, 17 insertions(+), 17 deletions(-)
diff --git a/README.md b/README.md
index 2ddd6a8..1fbf419 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@
-
+
@@ -34,7 +34,7 @@ Ready-to-run examples demonstrating Connectum features — from a minimal greete
|---------|-------------|------------|--------|
| [basic-service-node](basic-service-node/) | Basic service — Node.js | Direct execution, `@connectum/*` packages ship compiled JS | Ready |
| [basic-service-bun](basic-service-bun/) | Basic service — Bun | Zero-config TypeScript, no loader needed | Ready |
-| [basic-service-tsx](basic-service-tsx/) | Basic service — tsx | Universal TS runner, works on any Node.js 18+ | Ready |
+| [basic-service-tsx](basic-service-tsx/) | Basic service — tsx | Universal TS runner, works on any Node.js 22+ | Ready |
| [performance-test-server](performance-test-server/) | k6 benchmarking server | 5 parallel servers, interceptor overhead measurement, ports 8080-8084 | Ready |
| [extensions/redact](extensions/redact/) | Sensitive data redaction | Proto custom field options, `createRedactInterceptor()` | Ready |
| [interceptors/jwt](interceptors/jwt/) | Client-side JWT interceptor | Bearer token injection, `createAddTokenInterceptor()` | Ready |
@@ -53,7 +53,7 @@ Ready-to-run examples demonstrating Connectum features — from a minimal greete
## Prerequisites
-- [Node.js](https://nodejs.org/) >= 18.0.0, or [Bun](https://bun.sh/) >= 1.3.6, or [tsx](https://tsx.is/) >= 4.21 (for TypeScript source in your project)
+- [Node.js](https://nodejs.org/) >= 22.13.0, or [Bun](https://bun.sh/) >= 1.3.6, or [tsx](https://tsx.is/) >= 4.21 (for TypeScript source in your project)
- [pnpm](https://pnpm.io/) >= 10
## Quick Start
diff --git a/basic-service-bun/README.md b/basic-service-bun/README.md
index 2b2170e..2780da0 100644
--- a/basic-service-bun/README.md
+++ b/basic-service-bun/README.md
@@ -119,7 +119,7 @@ curl \
The same Connectum service can run on different runtimes:
-- **[basic-service-node](../basic-service-node/)** — Node.js 18+ (direct execution, no loader needed)
+- **[basic-service-node](../basic-service-node/)** — Node.js 22+ (direct execution, no loader needed)
- **[basic-service-tsx](../basic-service-tsx/)** — Any Node.js via tsx (universal, no version constraint)
## License
diff --git a/basic-service-node/README.md b/basic-service-node/README.md
index ee4ef0a..9a8ef74 100644
--- a/basic-service-node/README.md
+++ b/basic-service-node/README.md
@@ -1,6 +1,6 @@
# Basic Service — Node.js
-A minimal gRPC/ConnectRPC service built with [Connectum](https://github.com/Connectum-Framework/connectum), running on **Node.js 18+**. `@connectum/*` packages ship compiled JavaScript and type declarations, so no special loader or build step is needed.
+A minimal gRPC/ConnectRPC service built with [Connectum](https://github.com/Connectum-Framework/connectum), running on **Node.js 22+**. `@connectum/*` packages ship compiled JavaScript and type declarations, so no special loader or build step is needed.
Demonstrates:
@@ -13,7 +13,7 @@ Demonstrates:
## Prerequisites
-- **Node.js** >= 18.0.0
+- **Node.js** >= 22.13.0
- **pnpm** >= 10
## Quick Start
diff --git a/basic-service-node/package.json b/basic-service-node/package.json
index 340ece5..09e21f0 100644
--- a/basic-service-node/package.json
+++ b/basic-service-node/package.json
@@ -27,7 +27,7 @@
"author": "Highload.Zone",
"license": "Apache-2.0",
"engines": {
- "node": ">=18.0.0"
+ "node": ">=22.13.0"
},
"dependencies": {
"@bufbuild/protobuf": "^2.11.0",
diff --git a/basic-service-tsx/README.md b/basic-service-tsx/README.md
index 46b07ca..eaf965d 100644
--- a/basic-service-tsx/README.md
+++ b/basic-service-tsx/README.md
@@ -1,6 +1,6 @@
# Basic Service — tsx
-A minimal gRPC/ConnectRPC service built with [Connectum](https://github.com/Connectum-Framework/connectum), running on **any Node.js 18+** via [tsx](https://tsx.is/) — fast TypeScript execution powered by esbuild.
+A minimal gRPC/ConnectRPC service built with [Connectum](https://github.com/Connectum-Framework/connectum), running on **any Node.js 22+** via [tsx](https://tsx.is/) — fast TypeScript execution powered by esbuild.
Demonstrates:
@@ -13,7 +13,7 @@ Demonstrates:
## Prerequisites
-- **Node.js** >= 18.0.0
+- **Node.js** >= 22.13.0
- **pnpm** >= 10
## Quick Start
@@ -36,7 +36,7 @@ The server starts on `http://localhost:5000`.
## Why tsx?
-`@connectum/*` packages ship compiled JavaScript and type declarations, so they work on any Node.js 18+ without a loader. **tsx** adds value by handling your own `.ts` source files via [esbuild](https://esbuild.github.io/):
+`@connectum/*` packages ship compiled JavaScript and type declarations, so they work on any Node.js 22+ without a loader. **tsx** adds value by handling your own `.ts` source files via [esbuild](https://esbuild.github.io/):
- **No build step for your code** — tsx transforms your `.ts` files on the fly
- **Fast startup** — esbuild is one of the fastest TS transformers
@@ -124,13 +124,13 @@ curl \
| Node.js native | >= 22.6.0 | Yes (type stripping) | None |
| Bun | >= 1.3.6 | Yes (built-in) | Bun runtime |
-Choose tsx when you want **zero-config TypeScript execution** for your own source files on any Node.js 18+.
+Choose tsx when you want **zero-config TypeScript execution** for your own source files on any Node.js 22+.
## Alternative Runtimes
The same Connectum service can run on different runtimes:
-- **[basic-service-node](../basic-service-node/)** — Node.js 18+ (direct execution, no loader needed)
+- **[basic-service-node](../basic-service-node/)** — Node.js 22+ (direct execution, no loader needed)
- **[basic-service-bun](../basic-service-bun/)** — Bun runtime (built-in TS support, no loader needed)
## License
diff --git a/basic-service-tsx/package.json b/basic-service-tsx/package.json
index 47c84e7..9486540 100644
--- a/basic-service-tsx/package.json
+++ b/basic-service-tsx/package.json
@@ -27,7 +27,7 @@
"author": "Highload.Zone",
"license": "Apache-2.0",
"engines": {
- "node": ">=18.0.0"
+ "node": ">=22.13.0"
},
"dependencies": {
"@bufbuild/protobuf": "^2.11.0",
diff --git a/cross-runtime-test/package.json b/cross-runtime-test/package.json
index 7dd7c2e..70b07df 100644
--- a/cross-runtime-test/package.json
+++ b/cross-runtime-test/package.json
@@ -42,6 +42,6 @@
"typescript": "^5.9.3"
},
"engines": {
- "node": ">=18.0.0"
+ "node": ">=22.13.0"
}
}
diff --git a/o11y-coroot/service/package.json b/o11y-coroot/service/package.json
index e277b35..cd32031 100644
--- a/o11y-coroot/service/package.json
+++ b/o11y-coroot/service/package.json
@@ -19,7 +19,7 @@
"author": "Highload.Zone",
"license": "Apache-2.0",
"engines": {
- "node": ">=22.0.0"
+ "node": ">=22.13.0"
},
"dependencies": {
"@bufbuild/protobuf": "^2.11.0",
diff --git a/performance-test-server/package.json b/performance-test-server/package.json
index f4b1a8a..997b7f6 100644
--- a/performance-test-server/package.json
+++ b/performance-test-server/package.json
@@ -25,7 +25,7 @@
"author": "Highload.Zone",
"license": "Apache-2.0",
"engines": {
- "node": ">=18.0.0"
+ "node": ">=22.13.0"
},
"dependencies": {
"@bufbuild/protobuf": "^2.11.0",
diff --git a/with-custom-interceptor/package.json b/with-custom-interceptor/package.json
index 8149ab6..9ca33b7 100644
--- a/with-custom-interceptor/package.json
+++ b/with-custom-interceptor/package.json
@@ -27,7 +27,7 @@
"author": "Highload.Zone",
"license": "Apache-2.0",
"engines": {
- "node": ">=18.0.0"
+ "node": ">=22.13.0"
},
"dependencies": {
"@bufbuild/protobuf": "^2.11.0",