v0.4.0 — Node 22 is now required (and the npm gotcha on Node 20)

[alexanderbering]

Since v0.4.0, all packages require Node.js 22 or newer. This is the project's first breaking change, so here is the full picture in one place.

What changed

• engines.node is now >=22 across @zensation/algorithms, @zensation/core and both adapters
• @zensation/adapter-sqlite moved to better-sqlite3 13 (the driver that forced the floor)
• CI tests on Node 22, 24 and 26

The gotcha to know about

On Node 20 or older, npm install @zensation/algorithms does not fail. npm silently resolves to the last compatible release — @zensation/algorithms@0.3.4 / @zensation/core@0.2.2. It looks like the package is outdated or broken; it is a platform mismatch.

Check what you actually got:

node -v
npm ls @zensation/algorithms

If you are stuck on Node 20 for now: 0.3.4 remains on npm and keeps working — you miss the 0.4.0 changes (CHANGELOG).

Questions about migrating? Ask below.