Model

Models expose the collection-level API you use most often. Transaction-scoped models created through ctx.use(Model) keep the same surface, but inject a session automatically.

import { M, model } from "mongster";

const taskSchema = M.schema({
  title: M.string(),
  completed: M.boolean().default(false),
}).withTimestamps();

const Task = model("tasks", taskSchema);

await Task.createOne({ title: "Write docs" });
await Task.find({ completed: false }).limit(5);
await Task.updateOne({ title: "Write docs" }, { $set: { completed: true } });
await Task.deleteMany({ completed: true });

const stats = await Task.aggregate().match({ completed: true }).count("done").exec();

Read surface

• find
• findOne
• findById
• count
• estimatedCount
• distinct

Write surface

• insertOne, insertMany
• createOne, createMany
• updateOne, updateMany, findOneAndUpdate
• replaceOne, findOneAndReplace, upsertOne
• deleteOne, deleteMany, findOneAndDelete
• bulkWrite

Extra helpers

• populate
• aggregate
• aggregateRaw
• syncIndexes
• getCollection
• getCollectionName
• pre and post

Transaction models

ctx.use(Model) returns a transaction model with the same CRUD and query helpers. The difference is that the session is already wired into every operation.