feat(model): add virtuals option to Model.hydrate() to set virtuals

[vkarpov15]

Fix #15627

Summary

In #15627, OP was looking to hydrate documents with some virtual properties that were computed using the aggregation framework. This PR adds a virtuals: true option to Model.hydrate() which sets any virtuals that are present in the data being hydrated.

Examples

[Copilot]

Pull Request Overview

This PR adds a virtuals: true option to Model.hydrate() to allow setting virtual properties when hydrating documents from raw data, addressing issue #15627. The feature enables hydrating documents with virtual properties computed via aggregation pipelines.

Key changes:

• Adds virtuals option parameter to Model.hydrate() method
• Implements virtual property setting logic during document initialization
• Adds validation to prevent conflicting option combinations

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
lib/model.js	Adds virtuals option parameter and validation for option conflicts
lib/document.js	Implements virtual property setting logic during document initialization
lib/schema/subdocument.js	Passes options parameter to subdocument initialization
lib/schema/documentArray.js	Passes options parameter to document array element initialization
lib/schema/map.js	Spreads options parameter when casting map values
test/model.test.js	Comprehensive test coverage for virtual hydration across different schema types

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}