compound index

Author: mtrezza

8.0.0.md

@@ -29,12 +29,12 @@ Related pull requests:
 
 ## Database Indexes
 
-As part of the email verification and password reset improvements in Parse Server 8, the queries used for these operations have changed to use tokens instead of username/email fields. To ensure optimal query performance, Parse Server now automatically creates indexes on the following fields during server initialization:
+As part of the email verification and password reset improvements in Parse Server 8, the queries used for these operations have changed to use tokens instead of username/email fields. To ensure optimal query performance, Parse Server now automatically creates compound indexes on the following fields during server initialization:
 
-- `_User._email_verify_token`: used for email verification queries
-- `_User._perishable_token`: used for password reset queries
+- `(_email_verify_token, emailVerified, _email_verify_token_expires_at)` - Used for email verification queries
+- `(_perishable_token, _perishable_token_expires_at)` - Used for password reset queries
 
-These indexes are created automatically when Parse Server starts, similar to how indexes for `username` and `email` fields are created. No manual intervention is required.
+These sparse, compound indexes are created automatically when Parse Server starts. No manual intervention is required.
 
 > [!WARNING]
-> If you have a large existing user base, the index creation may take some time during the first server startup after upgrading to Parse Server 8. The server logs will indicate when index creation is complete or if any errors occur. If you have any concerns regarding a potential database performance impact during index creation, you could create these indexes manually in a controlled procedure before upgrading Parse Server.
+> If you have a large existing user base, the index creation may take some time during the first server startup after upgrading to Parse Server 8. If you have any concerns regarding a potential database performance impact during index creation, you may create these indexes manually in a controlled manner before upgrading Parse Server.

spec/DatabaseController.spec.js

@@ -413,8 +413,12 @@ describe('DatabaseController', function () {
           case_insensitive_username: { username: 1 },
           case_insensitive_email: { email: 1 },
           email_1: { email: 1 },
-          _email_verify_token: { _email_verify_token: 1 },
-          _perishable_token: { _perishable_token: 1 },
+          _email_verify_token: {
+            _email_verify_token: 1,
+            emailVerified: 1,
+            _email_verify_token_expires_at: 1,
+          },
+          _perishable_token: { _perishable_token: 1, _perishable_token_expires_at: 1 },
         });
       }
     );
@@ -439,8 +443,12 @@ describe('DatabaseController', function () {
           _id_: { _id: 1 },
           username_1: { username: 1 },
           email_1: { email: 1 },
-          _email_verify_token: { _email_verify_token: 1 },
-          _perishable_token: { _perishable_token: 1 },
+          _email_verify_token: {
+            _email_verify_token: 1,
+            emailVerified: 1,
+            _email_verify_token_expires_at: 1,
+          },
+          _perishable_token: { _perishable_token: 1, _perishable_token_expires_at: 1 },
         });
       }
     );

src/Controllers/DatabaseController.js

@@ -1765,14 +1765,26 @@ class DatabaseController {
     });
 
     await this.adapter
-      .ensureIndex('_User', requiredUserFields, ['_email_verify_token'], '_email_verify_token', false)
+      .ensureIndex(
+        '_User',
+        requiredUserFields,
+        ['_email_verify_token', 'emailVerified', '_email_verify_token_expires_at'],
+        '_email_verify_token',
+        false
+      )
       .catch(error => {
         logger.warn('Unable to create index for email verification token: ', error);
         throw error;
       });
 
     await this.adapter
-      .ensureIndex('_User', requiredUserFields, ['_perishable_token'], '_perishable_token', false)
+      .ensureIndex(
+        '_User',
+        requiredUserFields,
+        ['_perishable_token', '_perishable_token_expires_at'],
+        '_perishable_token',
+        false
+      )
       .catch(error => {
         logger.warn('Unable to create index for password reset token: ', error);
         throw error;