Merge branch 'main' into NODE-7043-error-wrapper

Author: dariakp

.evergreen/install-mongodb-client-encryption.sh

@@ -12,6 +12,9 @@ rm -rf mongodb-client-encryption
 git clone https://github.com/mongodb-js/mongodb-client-encryption.git
 pushd mongodb-client-encryption
 
+# TODO(NODE-7218): test against latest mongodb-client-encryption
+git checkout aa61a35f5e174cd1c1e247e036093e18c88268c6
+
 node --version
 npm --version
 

.github/dependabot.yml

@@ -27,9 +27,6 @@ updates:
       # chai-subset requires @types/chai 4.x.
       - dependency-name: "@types/chai"
         versions: [">=4.0.0"]
-      # nyc is Node18+ only starting on [email protected].
-      - dependency-name: "nyc"
-        versions: [">=16.0.0"]
       # mocha-plugin-eslint breaks our lint configuration
       - dependency-name: "mocha-plugin-eslint"
         versions: [">=10.0.0"]

etc/notes/releasing.md

@@ -1,7 +1,19 @@
 # Releasing MongoDB Node.js Packages
 
+- [Releasing MongoDB Node.js Packages](#releasing-mongodb-nodejs-packages)
+  - [Pre-requisites](#pre-requisites)
+  - [Branching and backport strategy](#branching-and-backport-strategy)
+    - [Backports](#backports)
+  - [`release-please`](#release-please)
+  - [Release Notes](#release-notes)
+  - [Release Instructions](#release-instructions)
+    - [Authentication](#authentication)
+    - [Prebuilds](#prebuilds)
+  - [Alphas / Prereleases](#alphas--prereleases)
+  - [Packages](#packages)
+
 > [!NOTE]
-> _Last updated: Thu Jun 6_
+> _Last updated: Oct 1, 2025_
 
 ## Pre-requisites
 
@@ -95,6 +107,52 @@ prebuild uploads archives of the native dependency to the github release.
 Uploading binaries should happen automatically after the git tag/github release has been made.
 It may take some time for the building and uploading to finish, but no more than a few hours at most.
 
+## Alphas / Prereleases
+
+> [!NOTE]
+> This documentation uses `alpha` as the prerelease tag, but if you wish to use a different tag, just 
+> replace `alpha` with the desired tag.
+
+To configure a repo for a prerelease:
+
+1. Update the release Github action's `npm publish` step to publish an alpha by specifying `--tag alpha`:
+
+```yaml
+      - run: npm publish --provenance --tag alpha
+        if: ${{ needs.release_please.outputs.release_created }}
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+2. Update the release please configuration file with the following parameters:
+   1. Specify `prerelease-type: alpha`.  This tells release-please that we want to use alpha as the pre-release tag.
+   2. Specify `prerelease: true`.  This tells release-please to create the Github release as a pre-release.
+   3. Specify `versioning: prerelease`.  This tells release-please that we wish to release a pre-release.
+
+```json
+{
+  "pull-request-header": "Please run the release_notes action before releasing to generate release highlights",
+  "packages": {
+    ".": {
+      "include-component-in-tag": false,
+      "changelog-path": "HISTORY.md",
+      "release-type": "node",
+      "bump-minor-pre-major": false,
+      "bump-patch-for-minor-pre-major": false,
+      "draft": false,
+      "prerelease-type": "alpha",
+      "prerelease": true,
+      "versioning": "prerelease"
+    }
+  }
+}
+```
+
+After merging the a PR with the above changes, release-please should re-create the release PR as a PR to release 
+an alpha.
+
+Example PR: https://github.com/mongodb-js/mongodb-client-encryption/pull/104
+
 ## Packages
 
 The following is a list of packages the Node.js team is responsible for and these release instructions apply to.

src/client-side-encryption/auto_encrypter.ts

@@ -64,7 +64,7 @@ export interface AutoEncryptionOptions {
     /** If true, autoEncryption will not attempt to spawn a mongocryptd before connecting  */
     mongocryptdBypassSpawn?: boolean;
     /** The path to the mongocryptd executable on the system */
-    mongocryptdSpawnPath?: string;
+    mongocryptdSpawnPath?: `${string}mongocryptd${'.exe' | ''}`;
     /** Command line arguments to use when auto-spawning a mongocryptd */
     mongocryptdSpawnArgs?: string[];
     /**
@@ -90,7 +90,7 @@ export interface AutoEncryptionOptions {
      *
      * Requires the MongoDB Crypt shared library, available in MongoDB 6.0 or higher.
      */
-    cryptSharedLibPath?: string;
+    cryptSharedLibPath?: `${string}mongo_crypt_v${number}.${'so' | 'dll' | 'dylib'}`;
     /**
      * If specified, never use mongocryptd and instead fail when the MongoDB Crypt
      * shared library could not be loaded.

src/cmap/connection.ts

@@ -22,7 +22,6 @@ import {
 import {
   MongoCompatibilityError,
   MONGODB_ERROR_CODES,
-  MongoMissingDependencyError,
   MongoNetworkError,
   MongoNetworkTimeoutError,
   MongoOperationTimeoutError,
@@ -868,11 +867,7 @@ export class CryptoConnection extends Connection {
   ): Promise<Document> {
     const { autoEncrypter } = this;
     if (!autoEncrypter) {
-      // TODO(NODE-6065): throw a MongoRuntimeError in Node V7
-      // @ts-expect-error No cause provided because there is no underlying error.
-      throw new MongoMissingDependencyError('No AutoEncrypter available for encryption', {
-        dependencyName: 'n/a'
-      });
+      throw new MongoRuntimeError('No AutoEncrypter available for encryption');
     }
 
     const serverWireVersion = maxWireVersion(this);

src/cmap/errors.ts

@@ -56,7 +56,7 @@ export class PoolClearedError extends MongoNetworkError {
     super(errorMessage, pool.serverError ? { cause: pool.serverError } : undefined);
     this.address = pool.address;
 
-    this.addErrorLabel(MongoErrorLabel.PoolRequstedRetry);
+    this.addErrorLabel(MongoErrorLabel.PoolRequestedRetry);
   }
 
   override get name(): string {

src/error.ts

@@ -97,7 +97,7 @@ export const MongoErrorLabel = Object.freeze({
   ResumableChangeStreamError: 'ResumableChangeStreamError',
   HandshakeError: 'HandshakeError',
   ResetPool: 'ResetPool',
-  PoolRequstedRetry: 'PoolRequstedRetry',
+  PoolRequestedRetry: 'PoolRequestedRetry',
   InterruptInUseConnections: 'InterruptInUseConnections',
   NoWritesPerformed: 'NoWritesPerformed'
 } as const);
@@ -1444,7 +1444,7 @@ export function needsRetryableWriteLabel(
 export function isRetryableWriteError(error: MongoError): boolean {
   return (
     error.hasErrorLabel(MongoErrorLabel.RetryableWriteError) ||
-    error.hasErrorLabel(MongoErrorLabel.PoolRequstedRetry)
+    error.hasErrorLabel(MongoErrorLabel.PoolRequestedRetry)
   );
 }