feat: search users by list of emails (users/_search) (#6983)

Co-authored-by: Stefan Benz <[email protected]>

proto/zitadel/user.proto

@@ -188,6 +188,7 @@ message SearchQuery {
         OrQuery or_query = 11;
         AndQuery and_query = 12;
         NotQuery not_query = 13;
+        InUserEmailsQuery in_user_emails_query = 14;
     }
 }
 
@@ -223,6 +224,15 @@ message InUserIDQuery {
     ];
 }
 
+message InUserEmailsQuery {
+    repeated string user_emails = 1 [        
+        (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = {            
+            description: "the emails of the users to include"
+            example: "[\"test@example.com\",\"test@example.org\"]";
+        }
+    ];
+}
+
 message UserNameQuery {
     string user_name = 1 [
         (validate.rules).string = {max_len: 200},