Skip to content

chore: update Node.js version requirements#2527

Merged
sjinks merged 2 commits intotrunkfrom
fix/node-requirement
Aug 29, 2025
Merged

chore: update Node.js version requirements#2527
sjinks merged 2 commits intotrunkfrom
fix/node-requirement

Conversation

@sjinks
Copy link
Copy Markdown
Member

@sjinks sjinks commented Aug 29, 2025

Description

Purpose and Context

This change updates the supported Node.js runtime versions to modern, actively maintained releases. It updates the engines.node field in package.json so the project requires ^20.19.0 || ^22.12.0 || >=23.0.0. The change ensures compatibility with recent dependencies, improving security and long-term maintenance for contributors and CI environments.

Key Changes

  • Update engines.node in package.json to require ^20.19.0 || ^22.12.0 || >=23.0.0.
  • Ensure runtime checks continue to read the engines value from package.json

Impact and Considerations

This change raises the minimum supported Node.js version and may therefore break installations or runtime on systems running older Node versions. Developers and CI that use older Node releases must upgrade before installing or running the CLI. Deployments that pin older Node versions must be updated to a supported runtime to avoid incompatibility. The package.json engines field is authoritative for install-time checks and helper scripts that validate environment versions.

Security Considerations

Requiring modern Node.js releases improves the security posture by adopting versions with current security patches and updated SSL stacks. This change reduces exposure to vulnerabilities present in older Node releases and aligns the codebase with supported, actively patched runtimes.

Performance Considerations

Newer Node.js versions include runtime and JIT improvements that typically reduce startup time and improve throughput for CPU-bound workloads. Users may see modest performance and memory efficiency improvements when running the CLI and tests on the newer Node releases. This change introduces no code-level performance regressions.

Testing and Validation

The change relies on existing CI and local test suites to validate compatibility with the new Node range.

BREAKING CHANGE: This release raises the minimum supported Node.js version to ^20.19.0 || ^22.12.0 || >=23.0.0. Users and CI systems running Node versions older than this range must upgrade before installing or running the project.

Related: PLTFRM-1573

Changelog Description

Changed

  • Set Node.js version requirements in package.json to ^20.19.0 || ^22.12.0 || >=23.0.0

Pull request checklist

New release checklist

Steps to Test

TBD.

* Update Node.js version requirements in `package.json`
  to `^20.19.0 || ^22.12.0 || >=23.0.0`
* Update `.nvmrc` to use `lts/*`
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Aug 29, 2025

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

@sonarqubecloud
Copy link
Copy Markdown

@sjinks sjinks self-assigned this Aug 29, 2025
@sjinks sjinks marked this pull request as ready for review August 29, 2025 16:19
@sjinks sjinks merged commit 6c2b98e into trunk Aug 29, 2025
21 of 22 checks passed
@sjinks sjinks deleted the fix/node-requirement branch August 29, 2025 16:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants