fix(populate): handle virtual populate on array of UUIDs

[vkarpov15]

Fix #15315

Summary

A bit of a hack to unblock #15315 and allow virtual populate on array of UUIDs. String() on a Binary value returns a unicode string that isn't properly indexable when doing doc = resultDocs[sid];.

Future improvement: make Mongoose UUID types use BSON UUID class

Examples

[Copilot]

Pull Request Overview

A pull request to fix the virtual populate functionality for an array of UUIDs by adding a test case and implementing a workaround in converting BSON Binary UUID values.

• Added a test case in test/model.populate.test.js that verifies UUID field population
• Introduced a conditional handling in assignRawDocsToIdStructure.js to convert Binary UUIDs using id.toUUID()

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
test/model.populate.test.js	Adds a test case to verify virtual populate functionality for UUID fields
lib/helpers/populate/assignRawDocsToIdStructure.js	Implements a workaround to handle Binary UUIDs by converting them to a string via id.toUUID()

Comments suppressed due to low confidence (1)

lib/helpers/populate/assignRawDocsToIdStructure.js:81

• Consider confirming that id.toUUID() reliably returns a string. If it already does, the String() wrapping on line 83 might be unnecessary. Also, adding a clarifying comment on why this conversion is needed could help future maintainers.

if (id?.constructor?.name === 'Binary' && id.sub_type === 4 && typeof id.toUUID === 'function') {