0006 @types/node on the lowest supported Node¶
Context and Problem Statement¶
pivotkit supports Node 22 and later (engines: ">=22"). @types/node describes which Node APIs the
code may use. Dependabot proposes each new major of @types/node. Which major should the
repository use?
Considered Options¶
- The newest
@types/node, as Dependabot proposes. - The
@types/nodeof the lowest supported Node major.
Decision Outcome¶
Chosen option: the lowest supported Node major.
@types/nodestays on 22.x while Node 22 is the floor.- Dependabot ignores its major updates. Minor and patch updates of 22.x still come.
- The floor and the types rise together, in one change.
The reason recorded in #520: types of a newer Node would let code use APIs that Node 22 lacks. Only users on Node 22 would notice.
Consequences¶
- Good: the type check catches a Node API that the floor does not have.
- Bad: newer Node APIs wait until the floor rises.
- Raising the floor is a break under the versioning policy.