mongodb

The mongodb skill is a best-practices reference for working with MongoDB and Mongoose in TypeScript/Node.js. It solves the problem of writing correct, secure, and performant document-database code by consolidating connection setup, schema design, queries, aggregation, and optimization patterns into a single guide with runnable code examples. It triggers on tasks involving MongoDB, Mongoose, NoSQL, aggregation pipelines, document databases, and MongoDB Atlas.

The guide covers native driver and Mongoose connection setup (with connection pooling, timeouts, connection-event handling, and graceful SIGINT shutdown), schema design (validation, indexes including text indexes, embedded documents versus references and when to use each, populate and nested populate, and virtuals for computed and reverse-reference fields), and a broad set of query operations (filters, the query builder, comparison/logical/element/array operators, text search, regex, and lean queries for speed). It demonstrates update operations and operators such as $set, $unset, $inc, and $mul. Security-conscious defaults appear throughout, for example marking password fields as select:false so they are never returned by default and stripping password and version fields in the toJSON transform.

It targets backend and full-stack JavaScript/TypeScript developers designing schemas, writing queries, building aggregation pipelines, or tuning performance. The connection string is read from an environment variable (process.env.MONGODB_URI), following standard credential practice, and all examples are ordinary application code with no destructive or exfiltrating behavior.