Formal support and verification matrix

The current matrix is based on the combinations that have actually been run by the public verification chain; unverified versions are not included in the official support range. Node.js needs to distinguish between two layers: Public CI baseline and Default server matrix.

Public CI Baseline

dimensionscurrent scopeevidence
Node.js18.x / 20.x / 22.x.github/workflows/test.yml + npm test (smoke + compatibility + unit + integration) + npm run verify:fast
ModuleCJS / ESMtest/smoke/root-cjs.test.ts / root-esm.test.ts compiled test product

Default server matrix

DimensionsFormal supportEvidence
Node.js20.x / 22.xtest/compatibility/matrix.json + npm run test:server-matrix
MongoDB Driver6.x / 7.xnpm run test:server-matrix
MongoDB Server7.x / 8.xstrict mongodb-memory-server 7.0.37 / 8.0.26 single + replica set matrix

Default verification method

  • Default gate: npm test
  • Fast: npm run verify:fast
  • Full functional gate: npm run verify:full
  • Coverage governance: npm run test:coverage (independent command and mandatory release-preflight stage)
  • Matrix: npm run test:server-matrix
  • Package self-check: npm run release:preflight
  • Private real env: npm run test:real-env:private

Public verification and private verification boundaries

  • verify:fast / verify:full / test:server-matrix / release:preflight are all publicly reproducible verification commands; test:coverage is an independent coverage command.
  • npm test now covers smoke / compatibility / unit / integration by default; migrated TypeScript tests are first compiled to .generated/test-dist/test/** and then executed, and independent migration runners are no longer retained.
  • test:real-env:private and verify:release belong to explicit opt-in private real environment verification, which requires the operator to inject SSH/Mongo environment variables by themselves.
  • GitHub Actions only runs public access by default and does not assume any private SSH/Mongo resources exist.
  • probe:server-matrix and test:server-matrix do not downgrade required versions, topologies, drivers, or test combinations to a skip; unavailable and failed states exit nonzero and block release.

Not included in official support yet

ProjectCurrent Status
Node 18.x server matrixHas entered the public CI baseline, but is not included in the current Driver / Server official matrix
MongoDB Driver 4.x / 5.xOnly historical compatibility reference is retained and is not included in the current official matrix
MongoDB Server 6.xEOL; retained only in historical evidence and feature minimum-version notes, not in the v3 release matrix
legacy lib/** compat sub-pathOnly explicit regressions during the migration period are retained, and are not included in the default access control and formal support matrix
Non-MongoDB databasesRoadmap stage, not currently supported