@@ -19,6 +19,7 @@ What's New
1919
2020Learn what's new in:
2121
22+ * :ref:`Version 6.8 <version-6.8>`
2223* :ref:`Version 6.7 <version-6.7>`
2324* :ref:`Version 6.6 <version-6.6>`
2425* :ref:`Version 6.5 <version-6.5>`
@@ -58,6 +59,69 @@ Learn what's new in:
5859* :ref:`Version 3.7 <version-3.7>`
5960* :ref:`Version 3.6 <version-3.6>`
6061
62+ .. _version-6.8:
63+
64+ What's New in 6.8
65+ -----------------
66+
67+ The {+driver-short+} v6.8 release includes the following features:
68+
69+ - Fixes a bug where a local KMS provider accepted a ``BSON Binary`` instance at
70+ runtime, but the TypeScript compiler allowed only values of type ``Buffer`` and
71+ ``string``.
72+
73+ - The ``ReadConcernMajorityNotAvailableYet`` error is now a retryable read error.
74+
75+ - You can now associate a name with, and provide multiple keys for, KMS providers.
76+ This feature requires ``mongodb-client-encryption`` v6.0.1 or later.
77+ You can't use named KMS providers if your application uses the automatic
78+ KMS provider refresh capability.
79+
80+ The following code example shows how to configure a ``ClientEncryption`` object with
81+ multiple AWS keys:
82+
83+ .. code-block:: javascript
84+ :copyable: true
85+
86+ const clientEncryption = new ClientEncryption(keyVaultClient, {
87+ 'aws:key1': {
88+ accessKeyId: ...,
89+ secretAccessKey: ...
90+ },
91+ 'aws:key2': {
92+ accessKeyId: ...,
93+ secretAccessKey: ...
94+ },
95+
96+ clientEncryption.createDataKey('aws:key-1', { ... });
97+
98+ - When you create a KMIP data key, you can now specify the ``delegated`` option. If this
99+ option is set to ``true``, the KMIP provider performs encryption and decryption of
100+ the data key locally, ensuring that the encryption key never leaves the KMIP server.
101+ This feature requires ``mongodb-client-encryption`` v6.0.1 or later.
102+
103+ The following code example shows how to specify this option:
104+
105+ .. code-block:: javascript
106+ :copyable: true
107+
108+ clientEncryption.createDataKey('kmip', { masterKey: { delegated: true } } );
109+
110+ - The driver now decodes BSON responses as the cursor iterates over them,
111+ rather than decoding the entire BSON response when it is received.
112+
113+ - The Github release for the ``mongodb`` package now contains a detached signature file,
114+ ``mongodb-X.Y.Z.tgz.sig``, for the NPM package. This change applies to every major
115+ and patch release for versions 5.x and 6.x of the driver. To verify the package signature,
116+ follow the instructions in the Release Integrity section of the
117+ `README.md <https://github.com/mongodb/node-mongodb-native/blob/v6.8.0/README.md#release-integrity>`__
118+ file in the driver's GitHub repository.
119+
120+ To learn more about this release, see the
121+ `v6.8.0 Release Notes
122+ <https://github.com/mongodb/node-mongodb-native/releases/tag/v6.8.0>`__ on
123+ GitHub.
124+
61125.. _version-6.7:
62126
63127What's New in 6.7
0 commit comments