chore: release 9.0.0

Author: vkarpov15

.github/workflows/publish.yml

@@ -25,6 +25,6 @@ jobs:
         run: npm install
 
       - name: Dry run publish with provenance
-        run: npm publish --provenance --access public --tag next
+        run: npm publish --provenance --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

CHANGELOG.md

@@ -1,3 +1,26 @@
+9.0.0 / 2025-11-21
+==================
+ * BREAKING CHANGE: drop support for callback-based pre middleware, e.g. `next()` in `pre()` hooks
+ * BREAKING CHANGE: update to MongoDB Node driver v7
+ * BREAKING CHANGE: make UUID schema type return bson UUIDs #15378
+ * BREAKING CHANGE: make findOne(null), find(null), etc. throw an error instead of returning first doc #15019 #14948
+ * BREAKING CHANGE: disallow update pipelines by default, require updatePipeline option #15586 #14424
+ * BREAKING CHANGE: call virtual ref function with subdoc, not top-level doc #14652 #12440 #12363
+ * BREAKING CHANGE(types): make create() and insertOne() params more strict, remove generics to prevent type inference #15587 #15355
+ * BREAKING CHANGE(types): make FilterQuery properties no longer resolve to any in TypeScript #15422
+ * BREAKING CHANGE(types): change `this` to HydratedDocument for default() and required(), HydratedDocument | Query for validate() #15020 #14696
+ * BREAKING CHANGE(types): make id a virtual in TypeScript rather than a property on Document base class #15572 #13079
+ * BREAKING CHANGE(types): consolidate RootQuerySelector, Condition, etc. types with MongoDB driver's #15593
+ * BREAKING CHANGE: asyncify update validators, SchemaType.prototype.doValidate(), save hooks for improved stack traces #15312
+ * BREAKING CHANGE: remove bson as direct dependency, use mongodb/lib/bson instead #15576 #15154
+ * BREAKING CHANGE: remove _executionStack, make validate() async function and call Kareem hooks directly vs through wrappers #15298 #14906
+ * BREAKING CHANGE: remove browser build, move to @mongoosejs/browser instead #15385 #15296
+ * BREAKING CHANGE: remove schematype caster and casterConstructor properties in favor of embeddedSchemaType and Constructor #15513 #15179
+ * BREAKING CHANGE: adding missing pluralizations, fixing pluralization: virus -> viruses #14247 [ItsBradyDavis](https://github.com/ItsBradyDavis)
+ * BREAKING CHANGE: remove connection noListener option #15641 #15640
+ * feat(types): add Schema.create() for TypeScript type inference #15482 #14954
+ * chore: remove examples directory #15597
+
 8.20.1 / 2025-11-20
 ===================
  * types: correct Model.schema type and fix unknown check for this param type in schema.methods #15750 #15693

README.md

@@ -13,7 +13,7 @@ Mongoose is a [MongoDB](https://www.mongodb.org/) object modeling tool designed
 
 The official documentation website is [mongoosejs.com](http://mongoosejs.com/).
 
-Mongoose 8.0.0 was released on October 31, 2023. You can find more details on [backwards breaking changes in 8.0.0 on our docs site](https://mongoosejs.com/docs/migrating_to_8.html).
+Mongoose 9.0.0 was released on November 21, 2025. You can find more details on [backwards breaking changes in 9.0.0 on our docs site](https://mongoosejs.com/docs/migrating_to_9.html).
 
 ## Support
 

docs/guides.md

@@ -51,8 +51,7 @@ integrating Mongoose with external tools and frameworks.
 
 ## Migration Guides
 
+* [Mongoose 7.x to 8.x](migrating_to_9.html)
 * [Mongoose 7.x to 8.x](migrating_to_8.html)
 * [Mongoose 6.x to 7.x](migrating_to_7.html)
 * [Mongoose 5.x to 6.x](migrating_to_6.html)
-* [Mongoose 4.x to 5.x](migrating_to_5.html)
-* [Mongoose 3.x to 4.x](migration.html)

docs/source/index.js

@@ -66,6 +66,7 @@ docs['docs/migrating_to_5.md'] = { guide: true, title: 'Migrating to Mongoose 5'
 docs['docs/migrating_to_6.md'] = { guide: true, title: 'Migrating to Mongoose 6', markdown: true };
 docs['docs/migrating_to_7.md'] = { guide: true, title: 'Migrating to Mongoose 7', markdown: true };
 docs['docs/migrating_to_8.md'] = { guide: true, title: 'Migrating to Mongoose 8', markdown: true };
+docs['docs/migrating_to_9.md'] = { guide: true, title: 'Migrating to Mongoose 9', markdown: true };
 docs['docs/connections.md'] = { guide: true, title: 'Connecting to MongoDB', markdown: true };
 docs['docs/lambda.md'] = { guide: true, title: 'Using Mongoose With AWS Lambda', markdown: true };
 docs['docs/geojson.md'] = { guide: true, title: 'Using GeoJSON', acquit: true, markdown: true };

package.json

@@ -1,7 +1,7 @@
 {
   "name": "mongoose",
   "description": "Mongoose MongoDB ODM",
-  "version": "9.0.0-rc1",
+  "version": "9.0.0",
   "author": "Guillermo Rauch <guillermo@learnboost.com>",
   "keywords": [
     "mongodb",