feat: user v3 contact email and phone (#8644)

# Which Problems Are Solved

Endpoints to maintain email and phone contact on user v3 are not
implemented.

# How the Problems Are Solved

Add 3 endpoints with SetContactEmail, VerifyContactEmail and
ResendContactEmailCode.
Add 3 endpoints with SetContactPhone, VerifyContactPhone and
ResendContactPhoneCode.
Refactor the logic how contact is managed in the user creation and
update.

# Additional Changes

None

# Additional Context

- part of https://github.com/zitadel/zitadel/issues/6433

---------

Co-authored-by: Livio Spring <livio.a@gmail.com>

internal/api/grpc/resources/user/v3alpha/email.go

@@ -0,0 +1,83 @@
+package user
+
+import (
+	"context"
+
+	resource_object "github.com/zitadel/zitadel/internal/api/grpc/resources/object/v3alpha"
+	"github.com/zitadel/zitadel/internal/command"
+	"github.com/zitadel/zitadel/internal/domain"
+	object "github.com/zitadel/zitadel/pkg/grpc/object/v3alpha"
+	user "github.com/zitadel/zitadel/pkg/grpc/resources/user/v3alpha"
+)
+
+func (s *Server) SetContactEmail(ctx context.Context, req *user.SetContactEmailRequest) (_ *user.SetContactEmailResponse, err error) {
+	if err := checkUserSchemaEnabled(ctx); err != nil {
+		return nil, err
+	}
+	schemauser := setContactEmailRequestToChangeSchemaUserEmail(req)
+	details, err := s.command.ChangeSchemaUserEmail(ctx, schemauser)
+	if err != nil {
+		return nil, err
+	}
+	return &user.SetContactEmailResponse{
+		Details:          resource_object.DomainToDetailsPb(details, object.OwnerType_OWNER_TYPE_ORG, details.ResourceOwner),
+		VerificationCode: schemauser.ReturnCode,
+	}, nil
+}
+
+func setContactEmailRequestToChangeSchemaUserEmail(req *user.SetContactEmailRequest) *command.ChangeSchemaUserEmail {
+	return &command.ChangeSchemaUserEmail{
+		ResourceOwner: organizationToUpdateResourceOwner(req.Organization),
+		ID:            req.GetId(),
+		Email:         setEmailToEmail(req.Email),
+	}
+}
+
+func setEmailToEmail(setEmail *user.SetEmail) *command.Email {
+	if setEmail == nil {
+		return nil
+	}
+	return &command.Email{
+		Address:     domain.EmailAddress(setEmail.Address),
+		ReturnCode:  setEmail.GetReturnCode() != nil,
+		Verified:    setEmail.GetIsVerified(),
+		URLTemplate: setEmail.GetSendCode().GetUrlTemplate(),
+	}
+}
+
+func (s *Server) VerifyContactEmail(ctx context.Context, req *user.VerifyContactEmailRequest) (_ *user.VerifyContactEmailResponse, err error) {
+	if err := checkUserSchemaEnabled(ctx); err != nil {
+		return nil, err
+	}
+	details, err := s.command.VerifySchemaUserEmail(ctx, organizationToUpdateResourceOwner(req.Organization), req.GetId(), req.GetVerificationCode())
+	if err != nil {
+		return nil, err
+	}
+	return &user.VerifyContactEmailResponse{
+		Details: resource_object.DomainToDetailsPb(details, object.OwnerType_OWNER_TYPE_ORG, details.ResourceOwner),
+	}, nil
+}
+
+func (s *Server) ResendContactEmailCode(ctx context.Context, req *user.ResendContactEmailCodeRequest) (_ *user.ResendContactEmailCodeResponse, err error) {
+	if err := checkUserSchemaEnabled(ctx); err != nil {
+		return nil, err
+	}
+	schemauser := resendContactEmailCodeRequestToResendSchemaUserEmailCode(req)
+	details, err := s.command.ResendSchemaUserEmailCode(ctx, schemauser)
+	if err != nil {
+		return nil, err
+	}
+	return &user.ResendContactEmailCodeResponse{
+		Details:          resource_object.DomainToDetailsPb(details, object.OwnerType_OWNER_TYPE_ORG, details.ResourceOwner),
+		VerificationCode: schemauser.PlainCode,
+	}, nil
+}
+
+func resendContactEmailCodeRequestToResendSchemaUserEmailCode(req *user.ResendContactEmailCodeRequest) *command.ResendSchemaUserEmailCode {
+	return &command.ResendSchemaUserEmailCode{
+		ResourceOwner: organizationToUpdateResourceOwner(req.Organization),
+		ID:            req.GetId(),
+		URLTemplate:   req.GetSendCode().GetUrlTemplate(),
+		ReturnCode:    req.GetReturnCode() != nil,
+	}
+}