feat: enhance email configuration and validation features

- Implemented mutual exclusivity for SSL and TLS options in the email configuration.
- Added comprehensive validation for required fields, port range, email format, and password requirements.
- Updated the backend to support reversible encryption for SMTP passwords, ensuring secure handling of sensitive data.
- Introduced loading states and improved user feedback in the email configuration UI for better user experience.

packages/backend/convex/actions/email.ts

@@ -23,8 +23,8 @@ export const enviar = action({
         return { sucesso: false, erro: "Email não encontrado" };
       }
 
-      // Buscar configuração SMTP ativa
-      const config = await ctx.runQuery(internal.email.getActiveEmailConfig, {});
+      // Buscar configuração SMTP ativa com senha descriptografada
+      const config = await ctx.runQuery(internal.email.getActiveEmailConfigWithPassword, {});
 
       if (!config) {
         return {
@@ -52,8 +52,7 @@ export const enviar = action({
         secure: config.usarSSL,
         auth: {
           user: config.usuario,
-          // Em produção deve ser armazenado com criptografia reversível
-          pass: config.senhaHash,
+          pass: config.senha, // Senha já descriptografada
         },
         tls: {
           // Permitir certificados autoassinados

packages/backend/convex/auth/utils.ts

@@ -130,3 +130,106 @@ export function validarSenha(senha: string): boolean {
   return regex.test(senha);
 }
 
+/**
+ * Criptografia reversível para senhas SMTP usando AES-GCM
+ * NOTA: Esta função é usada apenas para senhas SMTP que precisam ser descriptografadas.
+ * Para senhas de usuários, use hashPassword() que é unidirecional.
+ */
+
+// Chave de criptografia derivada (em produção, deve vir de variável de ambiente)
+// Para desenvolvimento, usando uma chave fixa. Em produção, deve ser configurada via env var.
+const getEncryptionKey = async (): Promise<CryptoKey> => {
+  // Chave base - em produção, isso deve vir de process.env.ENCRYPTION_KEY
+  // Por enquanto, usando uma chave derivada de um valor fixo
+  const keyMaterial = new TextEncoder().encode("SGSE-EMAIL-ENCRYPTION-KEY-2024");
+  
+  // Deriva uma chave de 256 bits usando PBKDF2
+  const key = await crypto.subtle.importKey(
+    "raw",
+    keyMaterial,
+    { name: "PBKDF2" },
+    false,
+    ["deriveBits", "deriveKey"]
+  );
+
+  return await crypto.subtle.deriveKey(
+    {
+      name: "PBKDF2",
+      salt: new TextEncoder().encode("SGSE-SALT"),
+      iterations: 100000,
+      hash: "SHA-256",
+    },
+    key,
+    { name: "AES-GCM", length: 256 },
+    false,
+    ["encrypt", "decrypt"]
+  );
+};
+
+/**
+ * Criptografa uma senha SMTP usando AES-GCM
+ */
+export async function encryptSMTPPassword(password: string): Promise<string> {
+  try {
+    const key = await getEncryptionKey();
+    const encoder = new TextEncoder();
+    const data = encoder.encode(password);
+
+    // Gerar IV (Initialization Vector) aleatório
+    const iv = crypto.getRandomValues(new Uint8Array(12));
+
+    // Criptografar
+    const encrypted = await crypto.subtle.encrypt(
+      {
+        name: "AES-GCM",
+        iv: iv,
+      },
+      key,
+      data
+    );
+
+    // Combinar IV + dados criptografados e converter para base64
+    const combined = new Uint8Array(iv.length + encrypted.byteLength);
+    combined.set(iv);
+    combined.set(new Uint8Array(encrypted), iv.length);
+
+    return btoa(String.fromCharCode(...combined));
+  } catch (error) {
+    console.error("Erro ao criptografar senha SMTP:", error);
+    throw new Error("Falha ao criptografar senha SMTP");
+  }
+}
+
+/**
+ * Descriptografa uma senha SMTP usando AES-GCM
+ */
+export async function decryptSMTPPassword(encryptedPassword: string): Promise<string> {
+  try {
+    const key = await getEncryptionKey();
+    
+    // Decodificar base64
+    const combined = Uint8Array.from(atob(encryptedPassword), (c) => c.charCodeAt(0));
+
+    // Extrair IV e dados criptografados
+    const iv = combined.slice(0, 12);
+    const encrypted = combined.slice(12);
+
+    // Descriptografar
+    const decrypted = await crypto.subtle.decrypt(
+      {
+        name: "AES-GCM",
+        iv: iv,
+      },
+      key,
+      encrypted
+    );
+
+    // Converter para string
+    const decoder = new TextDecoder();
+    return decoder.decode(decrypted);
+  } catch (error) {
+    console.error("Erro ao descriptografar senha SMTP:", error);
+    throw new Error("Falha ao descriptografar senha SMTP");
+  }
+}
+

packages/backend/convex/configuracaoEmail.ts

@@ -1,7 +1,8 @@
 import { v } from "convex/values";
-import { mutation, query, action } from "./_generated/server";
-import { hashPassword } from "./auth/utils";
+import { mutation, query } from "./_generated/server";
+import { encryptSMTPPassword } from "./auth/utils";
 import { registrarAtividade } from "./logsAtividades";
+import { api } from "./_generated/api";
 
 /**
  * Obter configuração de email ativa (senha mascarada)
@@ -62,8 +63,29 @@ export const salvarConfigEmail = mutation({
       return { sucesso: false as const, erro: "Email remetente inválido" };
     }
 
-    // Criptografar senha
-    const senhaHash = await hashPassword(args.senha);
+    // Validar porta
+    if (args.porta < 1 || args.porta > 65535) {
+      return { sucesso: false as const, erro: "Porta deve ser um número entre 1 e 65535" };
+    }
+
+    // Buscar config ativa anterior para manter senha se não fornecida
+    const configAtiva = await ctx.db
+      .query("configuracaoEmail")
+      .withIndex("by_ativo", (q) => q.eq("ativo", true))
+      .first();
+
+    // Determinar senhaHash: usar nova senha se fornecida, senão manter a atual
+    let senhaHash: string;
+    if (args.senha && args.senha.trim().length > 0) {
+      // Nova senha fornecida, criptografar usando criptografia reversível (AES)
+      senhaHash = await encryptSMTPPassword(args.senha);
+    } else if (configAtiva) {
+      // Senha não fornecida, manter a atual (já criptografada)
+      senhaHash = configAtiva.senhaHash;
+    } else {
+      // Sem senha e sem config existente - erro
+      return { sucesso: false as const, erro: "Senha é obrigatória para nova configuração" };
+    }
 
     // Desativar config anterior
     const configsAntigas = await ctx.db
@@ -105,10 +127,7 @@ export const salvarConfigEmail = mutation({
 });
 
 /**
- * Testar conexão SMTP (action - precisa de Node.js)
- *
- * NOTA: Esta action será implementada quando instalarmos nodemailer.
- * Por enquanto, retorna sucesso simulado para não bloquear o desenvolvimento.
+ * Testar conexão SMTP (mutation que chama action real)
  */
 export const testarConexaoSMTP = mutation({
   args: {
@@ -119,10 +138,65 @@ export const testarConexaoSMTP = mutation({
     usarSSL: v.boolean(),
     usarTLS: v.boolean(),
   },
+  returns: v.union(
+    v.object({ sucesso: v.literal(true) }),
+    v.object({ sucesso: v.literal(false), erro: v.string() })
+  ),
   handler: async (ctx, args) => {
-    // Delegar para a action de Node em arquivo separado
+    // Validações básicas
+    if (!args.servidor || args.servidor.trim().length === 0) {
+      return { sucesso: false as const, erro: "Servidor SMTP não pode estar vazio" };
+    }
 
-    return { sucesso: true };
+    if (!args.porta || args.porta < 1 || args.porta > 65535) {
+      return { sucesso: false as const, erro: "Porta inválida. Deve ser entre 1 e 65535" };
+    }
+
+    if (!args.usuario || args.usuario.trim().length === 0) {
+      return { sucesso: false as const, erro: "Usuário não pode estar vazio" };
+    }
+
+    if (!args.senha || args.senha.trim().length === 0) {
+      return { sucesso: false as const, erro: "Senha não pode estar vazia" };
+    }
+
+    // Validação de SSL/TLS mutuamente exclusivos
+    if (args.usarSSL && args.usarTLS) {
+      return { sucesso: false as const, erro: "SSL e TLS não podem estar habilitados simultaneamente" };
+    }
+
+    // Chamar action de teste real (que usa nodemailer)
+    try {
+      const resultado = await ctx.scheduler.runAfter(0, api.actions.smtp.testarConexao, {
+        servidor: args.servidor,
+        porta: args.porta,
+        usuario: args.usuario,
+        senha: args.senha,
+        usarSSL: args.usarSSL,
+        usarTLS: args.usarTLS,
+      });
+
+      // Se o teste foi bem-sucedido e há uma config ativa, atualizar testadoEm
+      if (resultado.sucesso) {
+        const configAtiva = await ctx.db
+          .query("configuracaoEmail")
+          .withIndex("by_ativo", (q) => q.eq("ativo", true))
+          .first();
+
+        if (configAtiva) {
+          await ctx.db.patch(configAtiva._id, {
+            testadoEm: Date.now(),
+          });
+        }
+      }
+
+      return resultado;
+    } catch (error: any) {
+      return { 
+        sucesso: false as const, 
+        erro: error.message || "Erro ao conectar com o servidor SMTP" 
+      };
+    }
   },
 });
 

packages/backend/convex/email.ts

@@ -229,6 +229,30 @@ export const getActiveEmailConfig = internalQuery({
   },
 });
 
+// Query interna para obter configuração com senha descriptografada
+export const getActiveEmailConfigWithPassword = internalQuery({
+  args: {},
+  handler: async (ctx) => {
+    const { decryptSMTPPassword } = await import("./auth/utils");
+    const config = await ctx.db
+      .query("configuracaoEmail")
+      .withIndex("by_ativo", (q) => q.eq("ativo", true))
+      .first();
+
+    if (!config) {
+      return null;
+    }
+
+    // Descriptografar senha
+    const senhaDescriptografada = await decryptSMTPPassword(config.senhaHash);
+
+    return {
+      ...config,
+      senha: senhaDescriptografada,
+    };
+  },
+});
+
 export const markEmailEnviando = internalMutation({
   args: { emailId: v.id("notificacoesEmail") },
   returns: v.null(),

packages/backend/convex/schema.ts

@@ -471,7 +471,7 @@ export default defineSchema({
     servidor: v.string(), // smtp.gmail.com
     porta: v.number(), // 587, 465, etc.
     usuario: v.string(),
-    senhaHash: v.string(), // senha criptografada
+    senhaHash: v.string(), // senha criptografada reversível (AES-GCM) - necessário para descriptografar e usar no SMTP
     emailRemetente: v.string(),
     nomeRemetente: v.string(),
     usarSSL: v.boolean(),