@classytic/mongokit 3.16.1 → 3.16.2

package/README.md

@@ -284,6 +284,28 @@ type UserRepo = Repository<UserDoc> &
   BatchOperationsMethods;
 ```
 
+### Type your Mongoose model — never cast `as never`
+
+Declare the model with its doc type so `Model<UserDoc>` flows straight into
+`Repository<UserDoc>` and `createMongooseAdapter` with no casts:
+
+```ts
+// ✅ Typed — flows cleanly into Repository + the arc adapter
+export type UserDoc = InferSchemaType<typeof UserSchema> & { _id: Types.ObjectId };
+export const UserModel = model<UserDoc>('User', UserSchema);
+export const userRepo = new Repository<UserDoc>(UserModel, [/* plugins */]);
+
+// ❌ Untyped — the inferred doc type diverges from `UserDoc`, and
+//    `mongoose.Model<T>` is INVARIANT in T, so it won't unify. The
+//    tempting "fix" is `as never` — don't; type the model instead.
+export const UserModel = model('User', UserSchema);          // Model<inferred>
+new Repository<UserDoc>(UserModel as never, []);             // ⛔ cast smell
+```
+
+The cast isn't a mongokit typing gap — it's a symptom of an untyped model.
+One generic at the `model<Doc>(...)` call site removes it everywhere
+(`Repository`, `createMongooseAdapter`, and any `RepositoryLike<Doc>` site).
+
 Feature-detect portable behavior with:
 
 ```ts

package/dist/better-auth/index.d.mts

@@ -65,8 +65,11 @@ interface RegisterBetterAuthStubsOptions {
  * Mongoose-based resources can `.populate()` references to BA-owned
  * documents. Idempotent — safe to call multiple times.
  *
- * Schemas are `strict: false` and `_id: false` so BA's writes flow through
- * unchanged and Mongoose hydrates whatever BA wrote. Use this when you have
+ * Schemas are `strict: false` (so BA's writes flow through unchanged and
+ * Mongoose hydrates whatever BA wrote) and keep the DEFAULT ObjectId `_id`
+ * SchemaType — BA's mongo adapter stores ObjectId `_id`s, so the caster is
+ * required for `findById`, `_id` filters, and `populate`/`ref` to resolve a
+ * hex-string id (see the NOTE in the loop below). Use this when you have
  * resources that *reference* BA collections (`createdBy: { ref: 'user' }`)
  * but don't expose CRUD on the BA collection itself.
  *

package/dist/better-auth/index.mjs

@@ -7,8 +7,11 @@ import { pluralizeBetterAuthCollection, resolveBetterAuthCollections } from "@cl
 * Mongoose-based resources can `.populate()` references to BA-owned
 * documents. Idempotent — safe to call multiple times.
 *
-* Schemas are `strict: false` and `_id: false` so BA's writes flow through
-* unchanged and Mongoose hydrates whatever BA wrote. Use this when you have
+* Schemas are `strict: false` (so BA's writes flow through unchanged and
+* Mongoose hydrates whatever BA wrote) and keep the DEFAULT ObjectId `_id`
+* SchemaType — BA's mongo adapter stores ObjectId `_id`s, so the caster is
+* required for `findById`, `_id` filters, and `populate`/`ref` to resolve a
+* hex-string id (see the NOTE in the loop below). Use this when you have
 * resources that *reference* BA collections (`createdBy: { ref: 'user' }`)
 * but don't expose CRUD on the BA collection itself.
 *
@@ -26,7 +29,6 @@ function registerBetterAuthStubs(mongoose, options = {}) {
 		const schema = new mongoose.Schema({}, {
 			strict: false,
 			collection: finalName,
-			_id: false,
 			timestamps: false
 		});
 		mongoose.model(finalName, schema);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.16.1",
+  "version": "3.16.2",
   "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
   "type": "module",
   "sideEffects": false,
@@ -145,8 +145,8 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
-    "@better-auth/api-key": "^1.6.9",
-    "@better-auth/mongo-adapter": "^1.6.9",
+    "@better-auth/api-key": "^1.6.22",
+    "@better-auth/mongo-adapter": "^1.6.22",
     "@biomejs/biome": "^2.4.10",
     "@classytic/dev-tools": "^0.2.0",
     "@classytic/repo-core": "0.6.0",
@@ -154,7 +154,7 @@
     "@vitest/coverage-v8": "^4.1.4",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
-    "better-auth": "^1.6.9",
+    "better-auth": "^1.6.22",
     "dotenv": "^17.4.2",
     "knip": "^6.3.0",
     "mongodb-memory-server": "^10.4.3",
@@ -163,5 +163,9 @@
     "tsdown": "^0.21.8",
     "typescript": "^6.0.3",
     "vitest": "^4.1.4"
+  },
+  "overrides": {
+    "mongodb": "7.2.0",
+    "bson": "7.2.0"
   }
 }