Files
sgse-app/packages/backend/convex/email.ts
deyvisonwanderley 3b89c496c6 feat: enhance scheduling and management of email notifications
- Added functionality to cancel scheduled email notifications, improving user control over their email management.
- Implemented a query to list all scheduled emails for the current user, providing better visibility into upcoming notifications.
- Enhanced the email schema to support scheduling features, including a timestamp for scheduled delivery.
- Improved error handling and user feedback for email scheduling actions, ensuring a smoother user experience.
2025-11-04 00:43:13 -03:00

490 lines
13 KiB
TypeScript

import { v } from "convex/values";
import {
mutation,
query,
action,
internalMutation,
internalQuery,
} from "./_generated/server";
import { Doc, Id } from "./_generated/dataModel";
import type { QueryCtx, MutationCtx } from "./_generated/server";
import { renderizarTemplate } from "./templatesMensagens";
import { internal, api } from "./_generated/api";
// ========== HELPERS ==========
/**
* Helper function para obter usuário autenticado (Better Auth ou Sessão)
*/
async function getUsuarioAutenticado(ctx: QueryCtx | MutationCtx): Promise<Doc<"usuarios"> | null> {
// Tentar autenticação via Better Auth primeiro
const identity = await ctx.auth.getUserIdentity();
let usuarioAtual: Doc<"usuarios"> | null = null;
if (identity && identity.email) {
usuarioAtual = await ctx.db
.query("usuarios")
.withIndex("by_email", (q) => q.eq("email", identity.email!))
.first();
}
// Se não encontrou via Better Auth, tentar via sessão mais recente
if (!usuarioAtual) {
const sessaoAtiva = await ctx.db
.query("sessoes")
.filter((q) => q.eq(q.field("ativo"), true))
.order("desc")
.first();
if (sessaoAtiva) {
usuarioAtual = await ctx.db.get(sessaoAtiva.usuarioId);
}
}
return usuarioAtual;
}
/**
* Enfileirar email para envio
*/
export const enfileirarEmail = mutation({
args: {
destinatario: v.string(), // email
destinatarioId: v.optional(v.id("usuarios")),
assunto: v.string(),
corpo: v.string(),
templateId: v.optional(v.id("templatesMensagens")),
enviadoPorId: v.id("usuarios"),
agendadaPara: v.optional(v.number()), // timestamp opcional para agendamento
},
returns: v.object({
sucesso: v.boolean(),
emailId: v.optional(v.id("notificacoesEmail")),
}),
handler: async (ctx, args) => {
// Validar email
const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
if (!emailRegex.test(args.destinatario)) {
return { sucesso: false };
}
// Validar agendamento se fornecido
if (args.agendadaPara !== undefined) {
if (args.agendadaPara <= Date.now()) {
return { sucesso: false };
}
}
// Adicionar à fila
const emailId = await ctx.db.insert("notificacoesEmail", {
destinatario: args.destinatario,
destinatarioId: args.destinatarioId,
assunto: args.assunto,
corpo: args.corpo,
templateId: args.templateId,
status: "pendente",
tentativas: 0,
enviadoPor: args.enviadoPorId,
criadoEm: Date.now(),
agendadaPara: args.agendadaPara,
});
// Agendar envio
if (args.agendadaPara !== undefined) {
// Agendar para o momento especificado
const delayMs = args.agendadaPara - Date.now();
await ctx.scheduler.runAfter(delayMs, api.actions.email.enviar, {
emailId,
});
} else {
// Envio imediato
await ctx.scheduler.runAfter(0, api.actions.email.enviar, {
emailId,
});
}
return { sucesso: true, emailId };
},
});
/**
* Enviar email usando template
*/
export const enviarEmailComTemplate = mutation({
args: {
destinatario: v.string(),
destinatarioId: v.optional(v.id("usuarios")),
templateCodigo: v.string(),
variaveis: v.record(v.string(), v.string()),
enviadoPorId: v.id("usuarios"),
agendadaPara: v.optional(v.number()), // timestamp opcional para agendamento
},
returns: v.object({
sucesso: v.boolean(),
emailId: v.optional(v.id("notificacoesEmail")),
}),
handler: async (ctx, args) => {
// Buscar template
const template = await ctx.db
.query("templatesMensagens")
.withIndex("by_codigo", (q) => q.eq("codigo", args.templateCodigo))
.first();
if (!template) {
console.error("Template não encontrado:", args.templateCodigo);
return { sucesso: false };
}
// Validar agendamento se fornecido
if (args.agendadaPara !== undefined) {
if (args.agendadaPara <= Date.now()) {
return { sucesso: false };
}
}
// Renderizar template
const assunto = renderizarTemplate(template.titulo, args.variaveis);
const corpo = renderizarTemplate(template.corpo, args.variaveis);
// Enfileirar email
const emailId = await ctx.db.insert("notificacoesEmail", {
destinatario: args.destinatario,
destinatarioId: args.destinatarioId,
assunto,
corpo,
templateId: template._id,
status: "pendente",
tentativas: 0,
enviadoPor: args.enviadoPorId,
criadoEm: Date.now(),
agendadaPara: args.agendadaPara,
});
// Agendar envio
if (args.agendadaPara !== undefined) {
// Agendar para o momento especificado
const delayMs = args.agendadaPara - Date.now();
await ctx.scheduler.runAfter(delayMs, api.actions.email.enviar, {
emailId,
});
} else {
// Envio imediato
await ctx.scheduler.runAfter(0, api.actions.email.enviar, {
emailId,
});
}
return { sucesso: true, emailId };
},
});
/**
* Listar emails na fila
*/
export const listarFilaEmails = query({
args: {
status: v.optional(
v.union(
v.literal("pendente"),
v.literal("enviando"),
v.literal("enviado"),
v.literal("falha")
)
),
limite: v.optional(v.number()),
},
// Tipo inferido automaticamente pelo Convex
handler: async (ctx, args) => {
if (args.status) {
const emails = await ctx.db
.query("notificacoesEmail")
.withIndex("by_status", (q) => q.eq("status", args.status!))
.order("desc")
.take(args.limite ?? 100);
return emails;
}
const emails = await ctx.db
.query("notificacoesEmail")
.withIndex("by_criado_em")
.order("desc")
.take(args.limite ?? 100);
return emails;
},
});
/**
* Reenviar email falhado
*/
export const reenviarEmail = mutation({
args: {
emailId: v.id("notificacoesEmail"),
},
returns: v.object({ sucesso: v.boolean() }),
handler: async (ctx, args): Promise<{ sucesso: boolean }> => {
const email = await ctx.db.get(args.emailId);
if (!email) {
return { sucesso: false };
}
// Resetar status para pendente
await ctx.db.patch(args.emailId, {
status: "pendente",
tentativas: 0,
ultimaTentativa: undefined,
erroDetalhes: undefined,
});
return { sucesso: true };
},
});
/**
* Cancelar agendamento de email
*/
export const cancelarAgendamentoEmail = mutation({
args: {
emailId: v.id("notificacoesEmail"),
},
returns: v.object({ sucesso: v.boolean(), erro: v.optional(v.string()) }),
handler: async (ctx, args): Promise<{ sucesso: boolean; erro?: string }> => {
const usuarioAtual = await getUsuarioAutenticado(ctx);
if (!usuarioAtual) {
return { sucesso: false, erro: "Usuário não autenticado" };
}
const email = await ctx.db.get(args.emailId);
if (!email) {
return { sucesso: false, erro: "Email não encontrado" };
}
// Verificar se o email pertence ao usuário atual
if (email.enviadoPor !== usuarioAtual._id) {
return { sucesso: false, erro: "Você não tem permissão para cancelar este agendamento" };
}
// Verificar se o email está agendado
if (!email.agendadaPara) {
return { sucesso: false, erro: "Este email não está agendado" };
}
// Verificar se ainda não foi enviado
if (email.status === "enviado") {
return { sucesso: false, erro: "Este email já foi enviado" };
}
// Verificar se já passou a data de agendamento
if (email.agendadaPara <= Date.now()) {
return { sucesso: false, erro: "A data de agendamento já passou" };
}
// Deletar o email agendado
await ctx.db.delete(args.emailId);
return { sucesso: true };
},
});
/**
* Action para enviar email (será implementado com nodemailer)
*
* NOTA: Este é um placeholder. Implementação real requer nodemailer.
*/
export const getEmailById = internalQuery({
args: { emailId: v.id("notificacoesEmail") },
// Tipo inferido automaticamente pelo Convex
handler: async (ctx, args) => {
return await ctx.db.get(args.emailId);
},
});
/**
* Buscar emails por IDs (query pública)
*/
export const buscarEmailsPorIds = query({
args: {
emailIds: v.array(v.id("notificacoesEmail")),
},
handler: async (ctx, args): Promise<Doc<"notificacoesEmail">[]> => {
const emails: Doc<"notificacoesEmail">[] = [];
for (const emailId of args.emailIds) {
const email = await ctx.db.get(emailId);
if (email) {
emails.push(email);
}
}
return emails;
},
});
/**
* Listar agendamentos de email do usuário atual
*/
export const listarAgendamentosEmail = query({
args: {},
handler: async (ctx): Promise<Array<Doc<"notificacoesEmail"> & { destinatarioInfo: Doc<"usuarios"> | null; templateInfo: Doc<"templatesMensagens"> | null }>> => {
const usuarioAtual = await getUsuarioAutenticado(ctx);
if (!usuarioAtual) {
return [];
}
// Buscar todos os emails do usuário
const todosEmails = await ctx.db
.query("notificacoesEmail")
.withIndex("by_enviado_por", (q) => q.eq("enviadoPor", usuarioAtual._id))
.collect();
// Filtrar apenas os que têm agendamento (passados ou futuros)
const emailsAgendados = todosEmails.filter((email) => email.agendadaPara !== undefined);
// Enriquecer com informações do destinatário e template
const emailsEnriquecidos = await Promise.all(
emailsAgendados.map(async (email) => {
let destinatarioInfo: Doc<"usuarios"> | null = null;
let templateInfo: Doc<"templatesMensagens"> | null = null;
if (email.destinatarioId) {
destinatarioInfo = await ctx.db.get(email.destinatarioId);
}
if (email.templateId) {
templateInfo = await ctx.db.get(email.templateId);
}
return {
...email,
destinatarioInfo,
templateInfo,
};
})
);
// Ordenar por data de agendamento (mais próximos primeiro)
return emailsEnriquecidos.sort((a, b) => {
const dataA = a.agendadaPara ?? 0;
const dataB = b.agendadaPara ?? 0;
return dataA - dataB;
});
},
});
export const getActiveEmailConfig = internalQuery({
args: {},
// Tipo inferido automaticamente pelo Convex
handler: async (ctx) => {
return await ctx.db
.query("configuracaoEmail")
.withIndex("by_ativo", (q) => q.eq("ativo", true))
.first();
},
});
// 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(),
handler: async (ctx, args) => {
const email = await ctx.db.get(args.emailId);
if (!email) return null;
await ctx.db.patch(args.emailId, {
status: "enviando",
tentativas: (email.tentativas || 0) + 1,
ultimaTentativa: Date.now(),
});
return null;
},
});
export const markEmailEnviado = internalMutation({
args: { emailId: v.id("notificacoesEmail") },
returns: v.null(),
handler: async (ctx, args) => {
await ctx.db.patch(args.emailId, {
status: "enviado",
enviadoEm: Date.now(),
});
return null;
},
});
export const markEmailFalha = internalMutation({
args: { emailId: v.id("notificacoesEmail"), erro: v.string() },
returns: v.null(),
handler: async (ctx, args) => {
const email = await ctx.db.get(args.emailId);
if (!email) return null;
await ctx.db.patch(args.emailId, {
status: "falha",
erroDetalhes: args.erro,
tentativas: (email.tentativas || 0) + 1,
});
return null;
},
});
// Action de envio foi movida para `actions/email.ts`
/**
* Processar fila de emails (cron job - processa emails pendentes)
*/
export const processarFilaEmails = internalMutation({
args: {},
returns: v.object({ processados: v.number() }),
handler: async (ctx) => {
// Buscar emails pendentes (max 10 por execução)
const emailsPendentes = await ctx.db
.query("notificacoesEmail")
.withIndex("by_status", (q) => q.eq("status", "pendente"))
.take(10);
let processados = 0;
for (const email of emailsPendentes) {
// Verificar se não excedeu tentativas (max 3)
if ((email.tentativas || 0) >= 3) {
await ctx.db.patch(email._id, {
status: "falha",
erroDetalhes: "Número máximo de tentativas excedido",
});
continue;
}
// Agendar envio via action
await ctx.scheduler.runAfter(0, api.actions.email.enviar, {
emailId: email._id,
});
processados++;
}
console.log(
`📧 Fila de emails processada: ${processados} emails agendados para envio`
);
return { processados };
},
});