7.0.0 (2025-11-05)
The MongoDB Node.js team is pleased to announce version 7.0.0 of the kerberos package!
Note
There are no major versions 3.x to 6.x of the kerberos package. The major version of this package has been aligned with the major version of the mongodb package to make it clearer which versions are intended to be used together.
Release Notes
Platform and runtime updates
Minimum supported Node.js version now 20.19.0
The minimum supported Node.js version is now v20.19.0. We strive to keep our minimum supported Node.js version in sync with the runtime's release cadence to keep up with the latest security updates and modern language features.
Node-API version increased to 9
The minimum Node-API version for the kerberos package is now 9, which corresponds to the highest Node-API version supported on Node.js 20.19.0.
macOS deployment target set to macOS 11
Kerberos now targets macOS 11.
Add support for FreeBSD
FreeBSD is now an unofficially supported platform. Thank you to tagattie for the contribution.
Bump prebuild-install to ^7.1.3
This fixes an undefined Node-API target issue with 7.1.2
Breaking API changes
Callback support removed from the public API
Callback overloads have been removed from all APIs in favor of APIs that return promises. In keeping with modern JS best practices,
we recommend adopting the promise-based APIs and async-await wherever possible.
If callback support is necessary, Node.js' callbackify method can be used:
callbackify(initializeClient)(serviceName, options, (error, client) => {
// application logic
})Kerberos no longer exported from the package
The kerberos package exported an undocumented named export, Kerberos, which was used for compatibility with unsupported (<4.x) MongoDB drivers. This export has been removed.
If you are relying on this export, import it from the kerberos package directly:
// before
const initializeClient = require('kerberos').Kerberos.initializeClient;
// after
const initializeClient = require('kerberos').initializeClient;kerberos now ships with TypeScript types!
The TypeScript types are now included in the kerberos package, and usage of @types/kerberos is no longer necessary.
⚠ BREAKING CHANGES
- NODE-7213: upgrade macos deployment target to 11 (#277)
- NODE-7166: increase napi version to 9 (#275)
- NODE-7159: remove Kerberos export (#271)
- NODE-6416: drop callback support from public API (#269)
- NODE-7155: update minimum supported Node.js version to 20.19.0 (#268)
Features
- NODE-6416: drop callback support from public API (#269) (3a5a37f)
- NODE-6993: Add support for FreeBSD (#248) (d3e1a71)
- NODE-7051: Normalize casing of shlwapi.lib (#253) (1a91b69)
- NODE-7152: deprecate MongoAuthProcess class (#267) (6b022d3)
- NODE-7155: update minimum supported Node.js version to 20.19.0 (#268) (286624d)
- NODE-7159: remove Kerberos export (#271) (7170783)
- NODE-7164: add TS definition file to kerberos package (#274) (8764240)
- NODE-7166: increase napi version to 9 (#275) (cd75e37)
- NODE-7213: upgrade macos deployment target to 11 (#277) (2faa561)
Bug Fixes
- NODE-7064: bump prebuild-install (#254) (d2a887a)
- NODE-7226: build glibc prebuilds on platforms with libc 2.28 (#281) (c215be2)