fix(deps): update dependency mongoose to v8.19.0

[renovate]

Note

Mend has cancelled the proposed renaming of the Renovate GitHub app being renamed to mend[bot].

This notice will be removed on 2025-10-07.

---

This PR contains the following updates:

Package	Change	Age	Confidence
mongoose (source)	8.8.1 -> 8.19.0

---

Release Notes

Automattic/mongoose (mongoose)

v8.19.0

Compare Source

===================

• feat: upgrade mongodb driver to 6.20.0 #​15651 #​15656
• feat(model): add virtuals option to Model.hydrate() to set virtuals #​15638 #​15627
• fix(schema): handle casting array filters underneath maps of Mixed #​15655 #​15653
• types: optimize InferRawDocType #​15588 ssalbdivad
• types(schema): add lean schema option to TypeScript types #​15646 #​15583 #​10090

v8.18.3

Compare Source

===================

• fix(update): avoid throwing error if update has a top-level $addToSet with no path #​15648 #​15642
• types(query): allow passing arbitrary options #​15644 #​15643
• docs(connection+mongoose): correct mongodb option name user -> username #​15650 #​15647
• test: add tests covering vector search and text search using Atlas CLI #​15649 #​15645

v8.18.2

Compare Source

===================

• fix(document): prevent $clone() from converting mongoose arrays into vanilla arrays #​15633 #​15625
• fix(connection): use correct collection name for model when using useConnection() #​15637
• fix(connection): propagate changes to _lastHeartbeatAt to useDb() child connections #​15640 #​15635
• types: fix schema property type definition in SchemaType #​15631

v8.18.1

Compare Source

===================

• types: correct type inference for maps of maps #​15602
• types(model): copy base model statics onto discriminator model #​15623 #​15600
• types: fix types for a string of enums #​15605 ruiaraujo
• types(SchemaOptions): disallow versionKey: true, which fails at runtime #​15606
• docs(typescript): add example explaining how to use query helper overrides for handling lean() #​15622 #​15601
• docs(transactions): add note about nested transactions #​15624

v8.18.0

Compare Source

===================

• feat(schema): support for union types #​15574 #​10894
• fix: trim long strings in minLength and maxLength error messages and display the string length #​15571 #​15550
• types(connection+collection): make BaseCollection and BaseConnection usable as values #​15575 #​15548
• types: remove logic that omits timestamps when virtuals, methods, etc. options set #​15577 #​12807

v8.17.2

Compare Source

===================

• fix: avoid Model.validate() hanging when all paths fail casting #​15580 #​15579 piotracalski
• types(document): better support for flattenObjectIds and versionKey options for toObject() and toJSON() #​15582 #​15578
• docs: fix docs jsdoc tags and add UUID to be listed #​15585
• docs(document): fix code sample that errors with "Cannot set properties of undefined" #​15589

v8.17.1

Compare Source

===================

• fix(query): propagate read preference and read concern to populate if read() called after populate() #​15567 #​15553
• fix(model): call correct function in autoSearchIndex #​15569 #​15565
• fix(model): allow setting statics option on discriminator schema #​15568 #​15556
• fix(model): remove unnecessary conversion of undefined -> null in findById #​15566 #​15551
• types: allow passing in projections without as const #​15564 #​15557
• types: support maxLength and minLength in SchemaTypeOptions #​15570 #​4720

v8.17.0

Compare Source

===================

• feat: upgrade mongodb -> 6.18.0 #​15552
• feat(mongoose): export base Connection and Collection classes #​15548
• feat: make Schema.prototype.$conditionalHandlers public #​15497
• types: automatically infer discriminator type #​15547 #​15535
• types: make versionKey: false disable __v from hydrated document #​15524 #​15511
• types: indicate support for mongodb abort #​15549 GalacticHypernova
• types: add options property to schemas #​15524
• types(schematype): make defaultOptions static and add schemaOptions to DocumentArray #​15529 #​15524

v8.16.5

Compare Source

===================

• fix(map): avoid throwing required error if saving map of primitives with required: true #​15542
• types(model): export MongooseBulkWriteResult type #​15546
• types(connection): add base to connection type #​15544

v8.16.4

Compare Source

===================

• fix(connection): avoid calling connection.close() internally with force: Object #​15534 #​15531
• types(schema): handle required: string in schema definitions #​15538 #​15536
• types(document): allow calling $isDefault() with no args #​15528 #​15522
• types: infer Typescript string enums #​15530 ruiaraujo
• types: pass TModelType down to schema statics #​15537

v8.16.3

Compare Source

===================

• fix(document): clean modified subpaths if unsetting map #​15520 #​15519
• fix: make DocumentArray SchemaType pass all options to embedded SchemaType #​15523
• types: support readonly array in query.select #​15527 omermizr

v8.16.2

Compare Source

===================

• fix(cursor): populate after hydrating in queryCursor so populated docs get parent() #​15498 #​15494
• fix(schema): support toJSONSchema() on mixed types and improve error message about unsupported types #​15492 #​15489
• types: add _id and __v to toObject/toJSON transform type #​15501 #​15479
• types(schema): use user-provided THydratedDocumentType as context for virtual get() and set() #​15517 #​15516
• types: improve typing for transform option to toJSON and toObject #​15485
• docs: link to custom setter docs from lowercase, etc. options and note that setters run on query filters #​15493 #​15491
• docs(jest): add note about resetModules #​15515

v8.16.1

Compare Source

===================

• fix(document): avoid setting _skipMarkModified when setting nested path with merge option #​15484 #​11913
• fix(model): make sure post save error handler gets doc as param on VersionError #​15483 #​15480
• fix: consistent $conditionalHandlers setup between schematypes #​15490
• docs(compatibility): note that mongodb 4.0 is not supported anymore since 8.16.0 #​15487 hasezoey
• docs: remove unnecessary --save flag from npm install instruction #​15486 Thahirgeek

v8.16.0

Compare Source

===================

• feat(model): add Model.createSearchIndexes() #​15470 #​15465
• feat: upgrade MongoDB driver -> 6.17.0 #​15468 gmstavros

v8.15.2

Compare Source

===================

• fix(document+schema): improve handling for setting paths underneath maps, including maps of maps #​15477 #​15461
• fix: report default paths in VersionError message because they can can cause VersionError #​15464
• fix(updateValidators): ensure update validators only call validators underneath single nested paths once #​15446 #​15436
• fix: fix validation for deeply nested maps of subdocuments #​15469 #​15447 AbdelrahmanHafez
• fix(DocumentArray): correctly set parent if instantiated with schema from another Mongoose instance #​15471 #​15466
• types(model): use ProjectionType for Model.hydrate() #​15447 #​15443

v8.15.1

Compare Source

===================

• types: correct handling of _id in ProjectionType #​15432 #​15418
• types: fix definition of VectorSearch.$vectorSearch #​15429 chriskrycho
• docs: add Document#save to list of function with callbacks removed #​15433 SethFalco

v8.15.0

Compare Source

===================

• feat: CSFLE support #​15390 baileympearson
• feat: add strictFilter option to findOneAndUpdate (#​14913) #​15402 #​14913 muazahmed-dev
• feat(error): set cause to MongoDB error reason on ServerSelection errors #​15420 #​15416
• fix(model): make bulkSave() rely on document.validateSync() to validate docs and skip bulkWrite casting #​15415 #​15410
• types: stricter projection typing with 1-level deep nesting #​15418 #​15327 #​13840 pshaddel
• docs: emphasize automatic type inference in TypeScript intro and statics/methods, remove duplicated statics.md #​15421

v8.14.3

Compare Source

===================

• types(schema): allow post('init') #​15413 #​15412 #​15333
• types: fix signature of DocumentArray.id #​15414 Sainan
• docs: fix typo - change 'prodecure' to 'procedure' #​15419 0xEbrahim

v8.14.2

Compare Source

===================

• fix(query): handle casting array filter paths underneath array filter paths with embedded discriminators #​15388 #​15386
• docs(typescript): correct schema and model generic params in TS virtuals docs #​15391
• docs+types(schema): add alternative optimisticConcurrency syntaxes to docs + types #​15405 #​10591
• chore: add Node 24 to CI matrix #​15408 stscoundrel

v8.14.1

Compare Source

===================

• fix: correct change tracking with maps of arrays of primitives and maps of maps #​15374 #​15350
• fix(populate): consistently convert Buffer representation of UUID to hex string to avoid confusing populate assignment #​15383 #​15382
• docs: add TypeScript Query guide with info on lean() + transform() #​15377 #​15311

v8.14.0

Compare Source

===================

• feat: upgrade MongoDB driver -> 6.16 #​15371
• feat: implement Query findById methods #​15337 sderrow
• feat(subdocument): support schematype-level minimize option to disable minimizing empty subdocuments #​15336 #​15313
• feat: add skipOriginalStackTraces option to avoid stack trace performance overhead #​15345 #​15194
• fix(model): disallow Model.findOneAndUpdate(update) and fix TypeScript types re: findOneAndUpdate #​15365 #​15363
• types: correctly recurse in InferRawDocType #​15357 #​14954 JavaScriptBach
• types: include virtuals in toJSON and toObject output if virtuals: true set #​15346 #​15316
• types: make init hooks types accurately reflect runtime behavior #​15331 #​15301

v8.13.3

Compare Source

===================

• fix: export MongooseBulkSaveIncompleteError #​15370 #​15369
• fix: clone POJOs and arrays when casting query filter to avoid mutating objects #​15367 #​15364
• types(connection): add Connection.prototype.bulkWrite() to types #​15368 #​15359
• docs: add version requirements to v7 migration docs #​15361 SethFalco
• docs: update links in deleteOne & deleteMany API def #​15360 Elliot67
• docs: adds Model#count to list of fns callback removed from #​15349 SethFalco

v8.13.2

Compare Source

===================

• fix: avoid double calling validators on paths in document arrays underneath subdocuments #​15338 #​15335

v8.13.1

Compare Source

===================

• fix(populate): handle virtual populate on array of UUIDs #​15329 #​15315
• types: allow default function returning undefined with DocType override #​15328

v8.13.0

Compare Source

===================

• feat: bump mongodb driver -> 6.15.0
• feat: support custom types exported from driver #​15321

v8.12.2

Compare Source

===================

• fix(document): avoid stripping out fields in discriminator schema after select: false field #​15322 #​15308
• fix(AggregationCursor): make next() error if schema pre('aggregate') middleware throws error #​15293 #​15279
• fix(populate): correctly get schematypes when deep populating under a map #​15302 #​9359
• fix(model): avoid returning null from bulkSave() if error doesn't have writeErrors property #​15323
• types: add WithTimestamps utility type #​15318 baruchiro
• docs: update references to the ms module in date schema documentation #​15319 baruchiro
• docs: fix typo in schematypes.md #​15305 skyran1278

v8.12.1

Compare Source

===================

• fix: match bson version with mongodb's bson version #​15297 hasezoey

v8.12.0

Compare Source

===================

• feat: bump mongodb driver to 6.14
• feat: expose "SchemaTypeOptions" in browser #​15277 hasezoey
• docs: update field-level-encryption.md #​15272 dphrag

v8.11.0

Compare Source

===================

• feat(model): make bulkWrite results include MongoDB bulk write errors as well as validation errors #​15271 #​15265
• feat(document): add schemaFieldsOnly option to toObject() and toJSON() #​15259 #​15218
• feat: introduce populate ordered option for populating in series rather than in parallel for transactions #​15239 #​15231 #​15210
• fix(bigint): throw error when casting BigInt that's outside of the bounds of what MongoDB can safely store #​15230 #​15200

v8.10.2

Compare Source

===================

• fix(model+connection): return MongoDB BulkWriteResult instance even if no valid ops #​15266 #​15265
• fix(debug): avoid printing trusted symbol in debug output #​15267 #​15263
• types: make type inference logic resilient to no Buffer type due to missing @​types/node #​15261

v8.10.1

Compare Source

===================

• perf(document): only call undoReset() 1x/document #​15257 #​15255
• perf(schema): clear childSchemas when overwriting existing path to avoid performance degradations #​15256 #​15253
• perf: some more micro optimizations for find() and findOne() #​14906 #​15250
• fix(model): avoid adding timeout on Model.init() buffering to avoid unintentional dangling open handles #​15251 #​15241
• fix: avoid connection buffering on init if autoCreate: false #​15247 #​15241
• fix: infer discriminator key if set in $set with overwriteDiscriminatorKey #​15243 #​15218
• types(middleware): make this in document middleware the hydrated doc type, not raw doc type #​15246 #​15242
• types(schema): support options parameter to Schema.prototype.discriminator() #​15249 #​15244
• types(schema): allow calling Schema.prototype.number() with no message arg #​15237 #​15236
• docs(typescript): recommend using HydratedSingleSubdocument over Types.Subdocument #​15240 #​15211

v8.10.0

Compare Source

===================

• feat(schema+schematype): add toJSONSchema() method to convert schemas and schematypes to JSON schema #​15184 #​11162
• feat(connection): make connection helpers respect bufferTimeoutMS #​15229 #​15201
• feat(document): support schematype-level transform option #​15163 #​15084
• feat(model): add insertOne() function to insert a single doc #​15162 #​14843
• feat(connection): support Connection.prototype.aggregate() for db-level aggregations #​15153
• feat(model): make syncIndexes() not call createIndex() on indexes that already exist #​15175 #​12250
• feat(model): useConnection(connection) function #​14802
• fix(model): disallow updateMany(update) and fix TypeScript types re: updateMany() #​15199 #​15190
• fix(collection): avoid buffering if creating a collection during a connection interruption #​15187 #​14971
• fix(model): throw error if calling create() with multiple docs in a transaction unless ordered: true #​15100
• fix(model): skip createCollection() in syncIndexes() if autoCreate: false #​15155
• fix(model): make hydrate() handle hydrating deeply nested populated docs with hydratedPopulatedDocs #​15130
• types(document): make sure toObject() and toJSON() apply versionKey __v #​15097
• ci(NODE-6505): CI Setup for Encryption Support #​15139 aditi-khare-mongoDB

v8.9.7

Compare Source

==================

• fix: avoid applying defaults on map embedded paths #​15217 #​15196
• types: add missing $median operator to aggregation types #​15233 #​15209
• docs(document): clarify that toObject() returns a POJO that may contain non-POJO values #​15232 #​15208

v8.9.6

Compare Source

==================

• fix(document): allow setting values to undefined with set(obj) syntax with strict: false #​15207 #​15192
• fix(schema): improve reason for UUID cast error, currently a TypeError #​15215 #​15202
• fix(aggregate): improve error when calling near() with invalid coordinates #​15206 #​15188

v8.9.5

Compare Source

==================

• fix: disallow nested $where in populate match CVE-2025-23061
• fix(schema): handle bitwise operators on Int32 #​15176 #​15170

v8.9.4

Compare Source

==================

• fix(document): fix document not applying manual populate when using a function in schema.options.ref #​15138 IchirokuXVI
• fix(model): make Model.validate() static correctly cast document arrays #​15169 #​15164
• fix(model): allow passing validateBeforeSave option to bulkSave() to skip validation #​15161 #​15156
• fix(schema): allow multiple self-referencing discriminator schemas using Schema.prototype.discriminator #​15142 #​15120
• types: avoid BufferToBinary<> wiping lean types when passed to generic functions #​15160 #​15158
• docs: fix <code> in header ids #​15159
• docs: fix header in field-level-encryption.md #​15137 damieng

v8.9.3

Compare Source

==================

• fix(schema): make duplicate index error a warning for now to prevent blocking upgrading #​15135 #​15112 #​15109
• fix(model): handle document array paths set to non-array values in Model.castObject() #​15124 #​15075
• fix(document): avoid using childSchemas.path for compatibility with pre-Mongoose-8.8 schemas #​15131 #​15071
• fix(model): avoid throwing unnecessary error if updateOne() returns null in save() #​15126
• perf(cursor): clear the stack every time if using populate with batchSize to avoid stack overflows with large docs #​15136 #​10449
• types: make BufferToBinary avoid Document instances #​15123 #​15122
• types(model+query): avoid stripping out virtuals when calling populate with paths generic #​15132 #​15111
• types(schema): add missing removeIndex #​15134
• types: add cleanIndexes() to IndexManager interface #​15127
• docs: move search endpoint to netlify #​15119

v8.9.2

Compare Source

==================

• fix(schema): avoid throwing duplicate index error if index spec keys have different order or index has a custom name #​15112 #​15109
• fix(map): clean modified subpaths when overwriting values in map of subdocs #​15114 #​15108
• fix(aggregate): pull session from transaction local storage for aggregation cursors #​15094 IchirokuXVI
• types: correctly handle union types in BufferToBinary and related helpers #​15103 #​15102 #​15057
• types: add UUID to RefType #​15115 #​15101
• docs: remove link to Mongoose 5.x docs from dropdown #​15116
• docs(connection+document+model): remove remaining references to remove(), clarify that deleteOne() does not execute until then() or exec() #​15113 #​15107

v8.9.1

Compare Source

==================

• fix(connection): remove heartbeat check in load balanced mode #​15089 #​15042 #​14812
• fix(discriminator): gather childSchemas when creating discriminator to ensure $getAllSubdocs() can properly get all subdocs #​15099 #​15088 #​15092
• fix(model): handle discriminators in castObject() #​15096 #​15075
• fix(schema): throw error if duplicate index definition using unique in schema path and subsequent .index() call #​15093 #​15056
• fix: mark documents that are populated using hydratedPopulatedDocs option as populated in top-level doc #​15080 #​15048
• fix(document+schema): improve error message for get() on invalid path #​15098 #​15071
• docs: remove more callback doc references & some small other changes #​15095

v8.9.0

Compare Source

==================

• feat: upgrade mongodb -> 6.12
• feat: add int32 schematype #​15054 aditi-khare-mongoDB
• feat: add double schematype #​15061 aditi-khare-mongoDB
• feat: allow specifying error message override for duplicate key errors unique: true #​15059 #​12844
• feat(connection): add support for Connection.prototype.bulkWrite() with MongoDB server 8.0 #​15058 #​15028
• feat: add forceRepopulate option for populate() to allow avoiding repopulating already populated docs #​15044 #​14979
• fix(connection): remove heartbeat check in load balanced mode #​15089 #​15042
• fix(query): clone PopulateOptions when setting _localModel to avoid state leaking between subpopulate instances #​15082 #​15026
• types: add splice() to DocumentArray to allow adding partial objects with splice() #​15085 #​15041
• types(aggregate): add $firstN, $lastN, $bottom, $bottomN, $minN and $maxN operators #​15087 mlomnicki
• docs: Remove merge conflict markers #​15090 sponrad

v8.8.4

Compare Source

==================

• fix: cast using overwritten embedded discriminator key when set #​15076 #​15051
• fix: avoid throwing error if saveOptions undefined when invalidating subdoc cache #​15062

v8.8.3

Compare Source

==================

• fix: disallow using $where in match
• perf: cache results from getAllSubdocs() on saveOptions, only loop through known subdoc properties #​15055 #​15029
• fix(model+query): support overwriteDiscriminatorKey for bulkWrite updateOne and updateMany, allow inferring discriminator key from update #​15046 #​15040

v8.8.2

Compare Source

==================

• fix(model): handle array filters when casting bulkWrite #​15036 #​14978
• fix(model): make diffIndexes() avoid trying to drop default timeseries collection index #​15035 #​14984
• fix: save execution stack in query as string #​15039 durran
• types(cursor): correct asyncIterator and asyncDispose for TypeScript with lib: 'esnext' #​15038
• docs(migrating_to_8): add note about removing findByIdAndRemove #​15024 dragontaek-lee

---

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.