GPT-5 finding
@types/node version targets Node 25 while engines declare Node >=20
mediummaintainabilitymedium
- package.json:8
- package.json:20
Types for Node 25 may expose newer APIs not available in Node 20. This can allow code to type-check while using APIs that are missing at runtime on Node 20, leading to runtime failures that the type system won’t catch.
Recommendation
Align @types/node with the minimum supported runtime in engines. If targeting Node 20+, use a compatible major like "@types/node": "^20.x"; if you truly require Node 25 APIs, raise the engines.node constraint accordingly and document it.