feat: Introduce MFA recipe in plugin interface

src/main/java/io/supertokens/pluginInterface/ActiveUsersStorage.java

@@ -17,5 +17,12 @@ public interface ActiveUsersStorage extends NonAuthRecipeStorage {
     /* Count the number of users who have enabled TOTP and are active */
     int countUsersEnabledTotpAndActiveSince(AppIdentifier appIdentifier, long time) throws StorageQueryException;
 
+    /* Count the number of users who have enabled MFA */
+    int countUsersEnabledMfa(AppIdentifier appIdentifier) throws StorageQueryException;
+
+    /* Count the number of users who have enabled MFA and are active */
+    int countUsersEnabledMfaAndActiveSince(AppIdentifier appIdentifier, long time) throws StorageQueryException;
+
+    /* Delete a user from active users table */
     void deleteUserActive(AppIdentifier appIdentifier, String userId) throws StorageQueryException;
 }

src/main/java/io/supertokens/pluginInterface/RECIPE_ID.java

@@ -22,7 +22,7 @@ public enum RECIPE_ID {
     EMAIL_PASSWORD("emailpassword"), THIRD_PARTY("thirdparty"), SESSION("session"),
     EMAIL_VERIFICATION("emailverification"), JWT("jwt"), PASSWORDLESS("passwordless"), USER_METADATA("usermetadata"),
     USER_ROLES("userroles"), USER_ID_MAPPING("useridmapping"), DASHBOARD("dashboard"), TOTP("totp"),
-    MULTITENANCY("multitenancy");
+    MULTITENANCY("multitenancy"), MFA("mfa");
 
     private final String name;
 

src/main/java/io/supertokens/pluginInterface/mfa/MfaStorage.java

@@ -0,0 +1,23 @@
+package io.supertokens.pluginInterface.mfa;
+
+import io.supertokens.pluginInterface.exceptions.StorageQueryException;
+import io.supertokens.pluginInterface.multitenancy.AppIdentifier;
+import io.supertokens.pluginInterface.multitenancy.TenantIdentifier;
+import io.supertokens.pluginInterface.nonAuthRecipe.NonAuthRecipeStorage;
+
+public interface MfaStorage extends NonAuthRecipeStorage {
+    // Enable (insert) a factor for a user and return true if it actually inserted something.
+    boolean enableFactor(TenantIdentifier tenantIdentifier, String userId, String factorId) throws StorageQueryException;
+
+    // List all the factors for a user:
+    String[] listFactors(TenantIdentifier tenantIdentifier, String userId) throws StorageQueryException;
+
+    // Disable (delete) a factor for a user and return true if it actually deleted something.
+    boolean disableFactor(TenantIdentifier tenantIdentifier, String userId, String factorId) throws StorageQueryException;
+
+    // Delete a user across all tenants (with all the relevant factors)
+    boolean deleteMfaInfoForUser(AppIdentifier appIdentifier, String userId) throws StorageQueryException;
+
+    // Delete a user from a tenant (with all the relevant factors)
+    boolean deleteMfaInfoForUser(TenantIdentifier tenantIdentifier, String userId) throws StorageQueryException;
+}

src/main/java/io/supertokens/pluginInterface/multitenancy/AppIdentifierWithStorage.java

@@ -27,6 +27,7 @@
 import io.supertokens.pluginInterface.session.SessionStorage;
 import io.supertokens.pluginInterface.thirdparty.sqlStorage.ThirdPartySQLStorage;
 import io.supertokens.pluginInterface.totp.sqlStorage.TOTPSQLStorage;
+import io.supertokens.pluginInterface.mfa.MfaStorage;
 import io.supertokens.pluginInterface.useridmapping.UserIdMappingStorage;
 import io.supertokens.pluginInterface.usermetadata.sqlStorage.UserMetadataSQLStorage;
 import io.supertokens.pluginInterface.userroles.sqlStorage.UserRolesSQLStorage;
@@ -152,6 +153,14 @@ public TOTPSQLStorage getTOTPStorage() {
         return (TOTPSQLStorage) this.storage;
     }
 
+    public MfaStorage getMfaStorage() {
+        if (this.storage.getType() != STORAGE_TYPE.SQL) {
+            // we only support SQL for now
+            throw new UnsupportedOperationException("");
+        }
+        return (MfaStorage) this.storage;
+    }
+
     public ActiveUsersStorage getActiveUsersStorage() {
         if (this.storage.getType() != STORAGE_TYPE.SQL) {
             // we only support SQL for now

src/main/java/io/supertokens/pluginInterface/multitenancy/TenantIdentifierWithStorage.java

@@ -21,11 +21,11 @@
 import io.supertokens.pluginInterface.authRecipe.AuthRecipeStorage;
 import io.supertokens.pluginInterface.emailpassword.sqlStorage.EmailPasswordSQLStorage;
 import io.supertokens.pluginInterface.emailverification.sqlStorage.EmailVerificationSQLStorage;
-import io.supertokens.pluginInterface.multitenancy.exceptions.TenantOrAppNotFoundException;
 import io.supertokens.pluginInterface.passwordless.sqlStorage.PasswordlessSQLStorage;
 import io.supertokens.pluginInterface.session.SessionStorage;
 import io.supertokens.pluginInterface.thirdparty.sqlStorage.ThirdPartySQLStorage;
 import io.supertokens.pluginInterface.totp.sqlStorage.TOTPSQLStorage;
+import io.supertokens.pluginInterface.mfa.MfaStorage;
 import io.supertokens.pluginInterface.useridmapping.UserIdMappingStorage;
 import io.supertokens.pluginInterface.userroles.sqlStorage.UserRolesSQLStorage;
 
@@ -123,6 +123,14 @@ public TOTPSQLStorage getTOTPStorage() {
         }
         return (TOTPSQLStorage) this.storage;
     }
+
+    public MfaStorage getMfaStorage() {
+        if (this.storage.getType() != STORAGE_TYPE.SQL) {
+            // we only support SQL for now
+            throw new UnsupportedOperationException("");
+        }
+        return (MfaStorage) this.storage;
+    }
 
     public MultitenancyStorage getMultitenancyStorageWithTargetStorage() {
         if (this.storage.getType() != STORAGE_TYPE.SQL) {