feat: add index and doc to insertMany validation errors

Author: Jadu07

lib/model.js

@@ -3042,6 +3042,9 @@ Model.$__insertMany = function(arr, options, callback) {
   const results = ordered ? null : new Array(arr.length);
   const toExecute = arr.map((doc, index) =>
     callback => {
+      // Store original document for error reporting
+      const originalDoc = arr[index];
+      
       // If option `lean` is set to true bypass validation and hydration
       if (lean) {
         // we have to execute callback at the nextTick to be compatible
@@ -3076,6 +3079,9 @@ Model.$__insertMany = function(arr, options, callback) {
         () => { callback(null, doc); },
         error => {
           if (ordered === false) {
+            // Add index and doc to validation error for better debugging
+            error.index = index;
+            error.doc = doc.toObject ? doc.toObject() : originalDoc;
             validationErrors.push(error);
             validationErrorsToOriginalOrder.set(error, index);
             results[index] = error;

test/model.insertMany.test.js

@@ -429,6 +429,74 @@ describe('insertMany()', function() {
     assert.ok(!err.mongoose.validationErrors[1].errors['name']);
   });
 
+  it('insertMany() validation errors include index and doc properties with ordered false and rawResult', async function() {
+    const schema = new Schema({
+      title: { type: String, required: true },
+      requiredField: { type: String, required: true }
+    });
+    const User = db.model('User', schema);
+
+    const arr = [
+      { title: 'title1', requiredField: 'field1' },
+      { title: 'title2' }, // Missing requiredField
+      { requiredField: 'field3' }, // Missing title
+      { title: 'title4', requiredField: 'field4' }
+    ];
+    const opts = { ordered: false, rawResult: true };
+    const res = await User.insertMany(arr, opts);
+
+    assert.equal(res.insertedCount, 2);
+    assert.equal(res.mongoose.validationErrors.length, 2);
+
+    // Check first validation error (index 1)
+    const error1 = res.mongoose.validationErrors[0];
+    assert.equal(error1.index, 1);
+    assert.ok(error1.doc);
+    assert.equal(error1.doc.title, 'title2');
+    assert.ok(error1.errors['requiredField']);
+
+    // Check second validation error (index 2)
+    const error2 = res.mongoose.validationErrors[1];
+    assert.equal(error2.index, 2);
+    assert.ok(error2.doc);
+    assert.equal(error2.doc.requiredField, 'field3');
+    assert.ok(error2.errors['title']);
+  });
+
+  it('insertMany() validation errors include index and doc properties with throwOnValidationError', async function() {
+    const schema = new Schema({
+      title: { type: String, required: true },
+      requiredField: { type: String, required: true }
+    });
+    const User = db.model('User', schema);
+
+    const arr = [
+      { title: 'title1', requiredField: 'field1' },
+      { title: 'title2' }, // Missing requiredField
+      { requiredField: 'field3' }, // Missing title
+      { title: 'title4', requiredField: 'field4' }
+    ];
+    const opts = { ordered: false, rawResult: true, throwOnValidationError: true };
+    const err = await User.insertMany(arr, opts).then(() => null, err => err);
+
+    assert.ok(err);
+    assert.equal(err.validationErrors.length, 2);
+
+    // Check first validation error (index 1)
+    const error1 = err.validationErrors[0];
+    assert.equal(error1.index, 1);
+    assert.ok(error1.doc);
+    assert.equal(error1.doc.title, 'title2');
+    assert.ok(error1.errors['requiredField']);
+
+    // Check second validation error (index 2)
+    const error2 = err.validationErrors[1];
+    assert.equal(error2.index, 2);
+    assert.ok(error2.doc);
+    assert.equal(error2.doc.requiredField, 'field3');
+    assert.ok(error2.errors['title']);
+  });
+
   it('insertMany() populate option (gh-9720)', async function() {
     const schema = new Schema({
       name: { type: String, required: true }

types/error.d.ts

@@ -90,6 +90,12 @@ declare module 'mongoose' {
 
       errors: { [path: string]: ValidatorError | CastError };
       addError: (path: string, error: ValidatorError | CastError) => void;
+      
+      /** Index of the document in insertMany() that failed validation (only set for unordered insertMany) */
+      index?: number;
+      
+      /** Document that failed validation (only set for unordered insertMany) */
+      doc?: any;
 
       constructor(instance?: MongooseError);
     }