feat: add queue for sending emails

packages/email/mailer.ts

@@ -1,3 +1,4 @@
+import type { SendMailOptions } from 'nodemailer';
 import { createTransport } from 'nodemailer';
 
 import { ResendTransport } from '@documenso/nodemailer-resend';
@@ -54,3 +55,4 @@ const getTransport = () => {
 };
 
 export const mailer = getTransport();
+export type MailOptions = SendMailOptions;

packages/lib/server-only/document/delete-document.ts

@@ -2,7 +2,6 @@
 
 import { createElement } from 'react';
 
-import { mailer } from '@documenso/email/mailer';
 import { render } from '@documenso/email/render';
 import DocumentCancelTemplate from '@documenso/email/templates/document-cancel';
 import { prisma } from '@documenso/prisma';
@@ -92,7 +91,9 @@ export const deleteDocument = async ({
           assetBaseUrl,
         });
 
-        await mailer.sendMail({
+        await queueJob({
+          job: 'send-mail',
+          args: {
             to: {
               address: recipient.email,
               name: recipient.name,
@@ -104,6 +105,7 @@ export const deleteDocument = async ({
             subject: 'Document Cancelled',
             html: render(template),
             text: render(template, { plainText: true }),
+          },
         });
       }),
     );

packages/lib/server-only/document/resend-document.tsx

@@ -1,6 +1,5 @@
 import { createElement } from 'react';
 
-import { mailer } from '@documenso/email/mailer';
 import { render } from '@documenso/email/render';
 import { DocumentInviteEmailTemplate } from '@documenso/email/templates/document-invite';
 import { FROM_ADDRESS, FROM_NAME } from '@documenso/lib/constants/email';
@@ -110,9 +109,9 @@ export const resendDocument = async ({
 
       const { actionVerb } = RECIPIENT_ROLES_DESCRIPTION[recipient.role];
 
-      await prisma.$transaction(
-        async (tx) => {
-          await mailer.sendMail({
+      await queueJob({
+        job: 'send-mail',
+        args: {
           to: {
             address: email,
             name,
@@ -126,6 +125,7 @@ export const resendDocument = async ({
             : `Please ${actionVerb.toLowerCase()} this document`,
           html: render(template),
           text: render(template, { plainText: true }),
+        },
       });
 
       await queueJob({
@@ -145,10 +145,6 @@ export const resendDocument = async ({
           },
         },
       });
-        },
-        // Hopefully the queue makes this redundant
-        { timeout: 30_000 },
-      );
     }),
   );
 };

packages/lib/server-only/document/super-delete-document.ts

@@ -2,7 +2,6 @@
 
 import { createElement } from 'react';
 
-import { mailer } from '@documenso/email/mailer';
 import { render } from '@documenso/email/render';
 import DocumentCancelTemplate from '@documenso/email/templates/document-cancel';
 import { prisma } from '@documenso/prisma';
@@ -49,7 +48,9 @@ export const superDeleteDocument = async ({ id, requestMetadata }: SuperDeleteDo
           assetBaseUrl,
         });
 
-        await mailer.sendMail({
+        await queueJob({
+          job: 'send-mail',
+          args: {
             to: {
               address: recipient.email,
               name: recipient.name,
@@ -61,6 +62,7 @@ export const superDeleteDocument = async ({ id, requestMetadata }: SuperDeleteDo
             subject: 'Document Cancelled',
             html: render(template),
             text: render(template, { plainText: true }),
+          },
         });
       }),
     );

packages/lib/server-only/queue/job.ts

@@ -1,5 +1,7 @@
 import type { WorkHandler } from 'pg-boss';
 
+import type { MailOptions } from '@documenso/email/mailer';
+import { mailer } from '@documenso/email/mailer';
 import { prisma } from '@documenso/prisma';
 
 import { initQueue } from '.';
@@ -12,6 +14,7 @@ import {
 import { type SendPendingEmailOptions, sendPendingEmail } from '../document/send-pending-email';
 
 type JobOptions = {
+  'send-mail': MailOptions;
   'send-completed-email': SendCompletedDocumentOptions;
   'send-pending-email': SendPendingEmailOptions;
   'create-document-audit-log': CreateDocumentAuditLogDataOptions;
@@ -20,25 +23,42 @@ type JobOptions = {
 export const jobHandlers: {
   [K in keyof JobOptions]: WorkHandler<JobOptions[K]>;
 } = {
-  'send-completed-email': async ({ data: { documentId, requestMetadata } }) => {
+  'send-completed-email': async ({ id, name, data: { documentId, requestMetadata } }) => {
+    console.log('Running Queue: ', name, ' ', id);
+
     await sendCompletedEmail({
       documentId,
       requestMetadata,
     });
   },
-  'send-pending-email': async ({ data: { documentId, recipientId } }) => {
+  'send-pending-email': async ({ id, name, data: { documentId, recipientId } }) => {
+    console.log('Running Queue: ', name, ' ', id);
+
     await sendPendingEmail({
       documentId,
       recipientId,
     });
   },
+  'send-mail': async ({ id, name, data: { attachments, to, from, subject, html, text } }) => {
+    console.log('Running Queue: ', name, ' ', id);
+
+    await mailer.sendMail({
+      to,
+      from,
+      subject,
+      html,
+      text,
+      attachments,
+    });
+  },
 
   // Audit Logs Queue
   'create-document-audit-log': async ({
+    name,
     data: { documentId, type, requestMetadata, user, data },
     id,
   }) => {
-    console.log('Running Queue ID', id);
+    console.log('Running Queue: ', name, ' ', id);
 
     await prisma.documentAuditLog.create({
       data: createDocumentAuditLogData({

packages/lib/server-only/team/create-team-email-verification.ts

@@ -2,7 +2,6 @@ import { createElement } from 'react';
 
 import { z } from 'zod';
 
-import { mailer } from '@documenso/email/mailer';
 import { render } from '@documenso/email/render';
 import { ConfirmTeamEmailTemplate } from '@documenso/email/templates/confirm-team-email';
 import { WEBAPP_BASE_URL } from '@documenso/lib/constants/app';
@@ -13,6 +12,8 @@ import { createTokenVerification } from '@documenso/lib/utils/token-verification
 import { prisma } from '@documenso/prisma';
 import { Prisma } from '@documenso/prisma/client';
 
+import { queueJob } from '../queue/job';
+
 export type CreateTeamEmailVerificationOptions = {
   userId: number;
   teamId: number;
@@ -122,7 +123,9 @@ export const sendTeamEmailVerificationEmail = async (
     token,
   });
 
-  await mailer.sendMail({
+  await queueJob({
+    job: 'send-mail',
+    args: {
       to: email,
       from: {
         name: FROM_NAME,
@@ -131,5 +134,6 @@ export const sendTeamEmailVerificationEmail = async (
       subject: `A request to use your email has been initiated by ${teamName} on Documenso`,
       html: render(template),
       text: render(template, { plainText: true }),
+    },
   });
 };

packages/lib/server-only/team/create-team-member-invites.ts

@@ -2,7 +2,6 @@ import { createElement } from 'react';
 
 import { nanoid } from 'nanoid';
 
-import { mailer } from '@documenso/email/mailer';
 import { render } from '@documenso/email/render';
 import type { TeamInviteEmailProps } from '@documenso/email/templates/team-invite';
 import { TeamInviteEmailTemplate } from '@documenso/email/templates/team-invite';
@@ -15,6 +14,8 @@ import { prisma } from '@documenso/prisma';
 import { TeamMemberInviteStatus } from '@documenso/prisma/client';
 import type { TCreateTeamMemberInvitesMutationSchema } from '@documenso/trpc/server/team-router/schema';
 
+import { queueJob } from '../queue/job';
+
 export type CreateTeamMemberInvitesOptions = {
   userId: number;
   userName: string;
@@ -148,7 +149,9 @@ export const sendTeamMemberInviteEmail = async ({
     ...emailTemplateOptions,
   });
 
-  await mailer.sendMail({
+  await queueJob({
+    job: 'send-mail',
+    args: {
       to: email,
       from: {
         name: FROM_NAME,
@@ -157,5 +160,6 @@ export const sendTeamMemberInviteEmail = async ({
       subject: `You have been invited to join ${emailTemplateOptions.teamName} on Documenso`,
       html: render(template),
       text: render(template, { plainText: true }),
+    },
   });
 };

packages/lib/server-only/team/delete-team-email.ts

@@ -1,6 +1,5 @@
 import { createElement } from 'react';
 
-import { mailer } from '@documenso/email/mailer';
 import { render } from '@documenso/email/render';
 import { TeamEmailRemovedTemplate } from '@documenso/email/templates/team-email-removed';
 import { WEBAPP_BASE_URL } from '@documenso/lib/constants/app';
@@ -8,6 +7,8 @@ import { FROM_ADDRESS, FROM_NAME } from '@documenso/lib/constants/email';
 import { TEAM_MEMBER_ROLE_PERMISSIONS_MAP } from '@documenso/lib/constants/teams';
 import { prisma } from '@documenso/prisma';
 
+import { queueJob } from '../queue/job';
+
 export type DeleteTeamEmailOptions = {
   userId: number;
   userEmail: string;
@@ -73,7 +74,9 @@ export const deleteTeamEmail = async ({ userId, userEmail, teamId }: DeleteTeamE
       teamUrl: team.url,
     });
 
-    await mailer.sendMail({
+    await queueJob({
+      job: 'create-document-audit-log',
+      args: {
         to: {
           address: team.owner.email,
           name: team.owner.name ?? '',
@@ -85,6 +88,7 @@ export const deleteTeamEmail = async ({ userId, userEmail, teamId }: DeleteTeamE
         subject: `Team email has been revoked for ${team.name}`,
         html: render(template),
         text: render(template, { plainText: true }),
+      },
     });
   } catch (e) {
     // Todo: Teams - Alert us.

packages/lib/server-only/team/request-team-ownership-transfer.ts

@@ -1,6 +1,5 @@
 import { createElement } from 'react';
 
-import { mailer } from '@documenso/email/mailer';
 import { render } from '@documenso/email/render';
 import { TeamTransferRequestTemplate } from '@documenso/email/templates/team-transfer-request';
 import { WEBAPP_BASE_URL } from '@documenso/lib/constants/app';
@@ -8,6 +7,8 @@ import { FROM_ADDRESS, FROM_NAME } from '@documenso/lib/constants/email';
 import { createTokenVerification } from '@documenso/lib/utils/token-verification';
 import { prisma } from '@documenso/prisma';
 
+import { queueJob } from '../queue/job';
+
 export type RequestTeamOwnershipTransferOptions = {
   /**
    * The ID of the user initiating the transfer.
@@ -93,7 +94,9 @@ export const requestTeamOwnershipTransfer = async ({
         token,
       });
 
-      await mailer.sendMail({
+      await queueJob({
+        job: 'create-document-audit-log',
+        args: {
           to: newOwnerUser.email,
           from: {
             name: FROM_NAME,
@@ -102,6 +105,7 @@ export const requestTeamOwnershipTransfer = async ({
           subject: `You have been requested to take ownership of team ${team.name} on Documenso`,
           html: render(template),
           text: render(template, { plainText: true }),
+        },
       });
     },
     { timeout: 30_000 },

packages/trpc/server/singleplayer-router/router.ts

@@ -2,12 +2,12 @@ import { createElement } from 'react';
 
 import { PDFDocument } from 'pdf-lib';
 
-import { mailer } from '@documenso/email/mailer';
 import { renderAsync } from '@documenso/email/render';
 import { DocumentSelfSignedEmailTemplate } from '@documenso/email/templates/document-self-signed';
 import { NEXT_PUBLIC_WEBAPP_URL } from '@documenso/lib/constants/app';
 import { FROM_ADDRESS, FROM_NAME, SERVICE_USER_EMAIL } from '@documenso/lib/constants/email';
 import { insertFieldInPDF } from '@documenso/lib/server-only/pdf/insert-field-in-pdf';
+import { queueJob } from '@documenso/lib/server-only/queue/job';
 import { alphaid } from '@documenso/lib/universal/id';
 import { getFile } from '@documenso/lib/universal/upload/get-file';
 import { putFile } from '@documenso/lib/universal/upload/put-file';
@@ -160,7 +160,9 @@ export const singleplayerRouter = router({
         ]);
 
         // Send email to signer.
-        await mailer.sendMail({
+        await queueJob({
+          job: 'send-mail',
+          args: {
             to: {
               address: signer.email,
               name: signer.name,
@@ -173,6 +175,7 @@ export const singleplayerRouter = router({
             html,
             text,
             attachments: [{ content: signedPdfBuffer, filename: documentName }],
+          },
         });
 
         return token;