0.26.2 protected

Ivan “CLOVIS” Canet

@clovis-ai

bcc0d89f · merge: Use KotlinX.Serialization in the :bson-official tests · Feb 14, 2026

Release: 0.26.2 • KotlinX.Serialization uniformisation

Unverified

KotlinX.Serialization unity

### BSON (Official)

The MongoDB official driver has two main serialization modes: `:bson-kotlin` (based on reflection) and `:bson-kotlinx` (based on KotlinX.Serialization). These two systems serialize objects slightly differently.

Most notably, the newly-added types `kotlin.time.Instant` and `kotlin.uuid.Uuid` are both serialized by `:bson-kotlinx` as strings, but are serialized to the corresponding BSON type by `:bson-kotlin`.
This release introduces the serializers `InstantAsBsonDatetimeSerializer` and `UuidAsBsonBinarySerializer` which use the BSON type no matter what serialization library is used, but also support JSON serialization as strings.
Users have to enable them explicitly (see their documentation to learn how).

In this version, we also ensured that the KtMongo types (`ObjectId` and `Timestamp`) are serialized correctly using both serialization strategies.