Skip to content

FAQ ​

Is 0.3.x 100% compatible with 0.2.x? ​

Public API: yes — same method names, overloads, and peers.
Every behavior bit-identical: no. Defaults on create, $set validation in strict, timestamps: false, and soft: true differ by design.
See Upgrade 0.2 → 0.3.

Is Mondel an ORM or ODM? ​

ODM (document-oriented). It maps schemas to MongoDB collections with types and validation. It is intentionally thinner than classic ORMs.

Do I need to learn a new query API? ​

No. Filters and update operators are standard MongoDB. Helpers are thin wrappers (findMany, create, …).

Does Mondel work with MongoDB 8? ​

Yes. See Compatibility.

Does it work on Cloudflare Workers? ​

Yes — use serverless: true. You still need network access to Atlas (or compatible). See Workers recipe.

How do I do relations / joins? ​

Use $lookup in aggregate, or multiple queries in application code. There is no automatic populate.

How do I run migrations? ​

Mondel manages indexes and optional JSON Schema validators via mondel push.
Data migrations remain your scripts or external tools.

Why is syncIndexes deprecated? ​

Creating indexes during app startup (especially serverless) causes load spikes and race conditions. Push from CI/deploy instead.

Are reads validated? ​

No. Validation runs on writes (and optional DB validators). Assume stored data matches the schema, or validate manually with zodSchema.

Can I use both Mongoose and Mondel? ​

Technically yes on the same database, but avoid dual schema sources of truth. Prefer one stack per collection.

Bundle size? ​

Mondel is a thin layer; mongodb and zod are peer dependencies and dominate size. Tree-shake with your bundler; mark peers external in libraries.

Is soft delete automatic? ​

Only when you pass { soft: true }. Default delete is hard delete. You must filter deletedAt yourself on reads.

Where is the AI / LLM doc? ​

LLM Reference and site /llms.txt.

Released under the MIT License. · llms.txt