Sourced from mongoose's releases.

8.18.0 / 2025-08-22

• 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

8.17.2 / 2025-08-18

• 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

8.17.1 / 2025-08-07

• 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

8.17.0 / 2025-07-30

• 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

8.16.5 / 2025-07-25

• 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

8.16.4 / 2025-07-16

• 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

Sourced from mongoose's changelog.

8.18.0 / 2025-08-22

• 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

8.17.2 / 2025-08-18

• 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

8.17.1 / 2025-08-07

• 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

8.17.0 / 2025-07-30

• 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

8.16.5 / 2025-07-25

• 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

8.16.4 / 2025-07-16

• 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

• 65e9dcc chore: release 8.18.0
• 8f24953 Merge pull request #15595 from Automattic/8.18
• 8f80bc7 Merge pull request #15574 from Automattic/vkarpov15/gh-10894
• 56ac298 fix lint from copilot suggestion
• 43a72ca Update lib/schema/union.js
• fc197a4 feat(types): add support for union types
• aef5be6 Merge branch 'vkarpov15/gh-10894' of github.com:Automattic/mongoose into vkar...
• ec77420 fix lint
• 1e3bc99 Update lib/options/schemaUnionOptions.js
• 6f2ac19 Merge branch '8.18' into vkarpov15/gh-10894
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)