⬆️ Update dependency mongoose to v8.23.1

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
mongoose (source)	8.16.0 → 8.23.1

---

Release Notes

Automattic/mongoose (mongoose)

v8.23.1

Compare Source

8.23.1 / 2026-04-23

• fix(model): support sort option in Model.bulkWrite() updateOne and replaceOne operations #​16091 #​16079
• fix(setDefaultsOnInsert): check child filter paths before applying defaults (backport #​16031 to 8.x) #​16219 marklai1998
• fix(schema): always pass raw string value to error validators, only trim to 30 chars for maxlength validator #​16238 #​16236 #​15550 #​15571

v8.23.0

Compare Source

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

• feat(document): add flattenUUIDs option to toObject() and toJSON() (backport #​15021 to 8.x)

v8.22.1

Compare Source

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

• fix: handle other top-level query operators in sanitizeFilter
• fix(document): when cloning a doc with subdocs, make sure the subdocs parent is the cloned doc #​15904 #​15901
• types(models): support Mongoose query casting in AnyBulkWriteOperation filter property #​15910
• types: add toBSON() to documents #​15927

v8.22.0

Compare Source

8.22.0 / 2026-01-27

• feat(model): allow passing strict option to hydrate() #​15944 #​15940

v8.21.1

Compare Source

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

• fix(clone): fix parent doc for map subdocuments and array subdocuments #​15958 AbdelrahmanHafez
• fix(document): when cloning a doc with subdocs, make sure the subdocs parent is the cloned doc #​15904 #​15901
• fix: respect currentTime schema option in bulkWrite updates #​15976 sderrow
• types(models): support Mongoose query casting in AnyBulkWriteOperation filter property #​15910
• types: add toBSON() to documents #​15927

v8.21.0

Compare Source

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

• feat(document+model): pass options to pre('deleteOne') and update+options to pre('updateOne') hooks #​15908 #​15870
• feat(document): add support for getAtomics() to allow custom container types to utilize atomics #​15817
• fix: add support for typescript style enums #​15914 #​15913 mjfwebb

v8.20.4

Compare Source

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

• fix(model): ensure $isDeleted is set after calling doc.deleteOne() successfully #​15898
• fix(document): use bitwise OR to accumulate version mode flags #​15893 #​15888 AbdelrahmanHafez

v8.20.3

Compare Source

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

• perf: use Object.hasOwn instead of Object#hasOwnProperty #​15875 AbdelrahmanHafez
• fix: improve error when calling Document.prototype.init() with null/undefined #​15812 Vegapunk-debug
• types(schema): avoid treating paths with default: null as required #​15889
• types(schema): allow partial statics to schema.statics() #​15780

v8.20.2

Compare Source

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

• fix(model): bump version if necessary after successful bulkSave() #​15809 #​15800
• fix(bulkWrite): pass overwriteImmutable option to castUpdate fixes #​15789 #​15782 #​15781
• types(schema): allow calling schema.static() with as TStatics #​15794 #​15780

v8.20.1

Compare Source

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

• types: correct Model.schema type and fix unknown check for this param type in schema.methods #​15750 #​15693
• docs: add detailed loadClass() TypeScript usage guide #​15731 #​12813 Necro-Rohan
• docs: update version support documentation for Mongoose #​15761 ManmathX
• docs: add copy-to-clipboard feature for code blocks in docs #​15759 vedansha07

v8.20.0

Compare Source

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

• feat: cast id parameter based on schema _id type in DocumentArray.id() #​15733 #​15725 #​15724 Lex-Ashu
• fix: pass parent schema to SchemaType constructors in interpretAsType to make implementing custom container types easier #​15700
• types(models): default _id type to ObjectId for Document #​15688 Catwallon
• docs: add FAQ entry about DivergentArrayError #​15743 Mario5T
• docs: update browser.md with Mongoose limitations #​15744 YashSharma64
• chore: add benchmark for large nested array documents (related to #​9588) #​15742 Kundan-CR7

v8.19.4

Compare Source

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

• fix(schema): avoid throwing error on array of unions #​15720 #​15718
• fix: store original index on insertMany validation errors #​15735 Jadu07
• types: correct return type of discriminator to Model #​15726 twentytwo777
• docs: improve Next.js integration guide with comprehensive examples #​15730 adarsh-priydarshi-5646
• docs: add documentation for Union Schema Type #​15721 TechGenie-awake
• docs: removed the outdated callback and replaced them with async/await pattern #​15723 hk2166
• docs: fix lingering remove() call in statics docs #​15737 Gautam-Bharadwaj
• docs: fix inline doc typo in schematypes.d.ts #​15738 hagid786

v8.19.3

Compare Source

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

• fix(model+plugins): correctly apply shard key on deleteOne() #​15705 #​15701
• fix(schema): correctly cache text indexes as 'text' not 1 #​15695
• types: make inferRawDocType correctly infer empty array type [] as any[] #​15704 #​15699

v8.19.2

Compare Source

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

• perf(setDefaultsOnInsert): avoid computing all modified paths when running setDefaultsOnInsert and update validators, only calculate if there are defaults to set #​15691 #​15672
• fix: correct handling of relative vs absolute paths with maps and subdocuments #​15682 #​15678 #​15350
• ci: add publish script with provenance #​15684 #​15680

v8.19.1

Compare Source

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

• perf: avoid getting all modified paths in update when checking if versionKey needs to be set #​15677 #​15672
• perf: Avoid needless path translation #​15679 orgads
• fix(query): throw error if using update operator with modifier and no path #​15670 #​15642
• types: avoid making FilterQuery a conditional type because of how typescript handles distributed conditional unions #​15676 #​15671
• docs: update installation instructions #​15675 aalok-y

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

---

Configuration

📅 Schedule: (in timezone Europe/Zurich)

• 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.