feat: make jobs client type safe

packages/lib/jobs/definitions/index.ts

@@ -1,6 +0,0 @@
-import type { JobClient } from '../client/client';
-import { registerSendConfirmationEmailJob } from './send-confirmation-email';
-
-export const registerJobs = (client: JobClient) => {
-  registerSendConfirmationEmailJob(client);
-};

packages/lib/jobs/definitions/send-confirmation-email.ts

@@ -1,25 +1,23 @@
 import { z } from 'zod';
 
 import { sendConfirmationToken } from '../../server-only/user/send-confirmation-token';
-import type { JobClient } from '../client/client';
+import type { JobDefinition } from '../client/_internal/job';
 
-export const registerSendConfirmationEmailJob = (client: JobClient) => {
-  client.defineJob({
-    id: 'send.confirmation.email',
-    name: 'Send Confirmation Email',
-    version: '1.0.0',
-    trigger: {
-      name: 'send.confirmation.email',
-      schema: z.object({
-        email: z.string().email(),
-        force: z.boolean().optional(),
-      }),
-    },
-    handler: async ({ payload }) => {
-      await sendConfirmationToken({
-        email: payload.email,
-        force: payload.force,
-      });
-    },
-  });
-};
+export const SEND_CONFIRMATION_EMAIL_JOB_DEFINITION = {
+  id: 'send.confirmation.email',
+  name: 'Send Confirmation Email',
+  version: '1.0.0',
+  trigger: {
+    name: 'send.confirmation.email',
+    schema: z.object({
+      email: z.string().email(),
+      force: z.boolean().optional(),
+    }),
+  },
+  handler: async ({ payload }) => {
+    await sendConfirmationToken({
+      email: payload.email,
+      force: payload.force,
+    });
+  },
+} as const satisfies JobDefinition;

packages/lib/jobs/definitions/send-signing-email.ts

@@ -0,0 +1,149 @@
+import { createElement } from 'react';
+
+import { z } from 'zod';
+
+import { mailer } from '@documenso/email/mailer';
+import { render } from '@documenso/email/render';
+import DocumentInviteEmailTemplate from '@documenso/email/templates/document-invite';
+import { prisma } from '@documenso/prisma';
+import { DocumentStatus, RecipientRole, SendStatus } from '@documenso/prisma/client';
+
+import { NEXT_PUBLIC_WEBAPP_URL } from '../../constants/app';
+import { FROM_ADDRESS, FROM_NAME } from '../../constants/email';
+import {
+  RECIPIENT_ROLES_DESCRIPTION,
+  RECIPIENT_ROLE_TO_EMAIL_TYPE,
+} from '../../constants/recipient-roles';
+import { DOCUMENT_AUDIT_LOG_TYPE } from '../../types/document-audit-logs';
+import { createDocumentAuditLogData } from '../../utils/document-audit-logs';
+import { renderCustomEmailTemplate } from '../../utils/render-custom-email-template';
+import type { JobDefinition } from '../client/_internal/job';
+import { ZRequestMetadataSchema } from '../../universal/extract-request-metadata';
+
+export const SEND_SIGNING_EMAIL_JOB_DEFINITION = {
+  id: 'send.signing.email',
+  name: 'Send Signing Email',
+  version: '1.0.0',
+  trigger: {
+    name: 'send.signing.email',
+    schema: z.object({
+      userId: z.number(),
+      documentId: z.number(),
+      recipientId: z.number(),
+      requestMetadata: ZRequestMetadataSchema.optional(),
+    }),
+  },
+  handler: async ({ payload, io }) => {
+    const { userId, documentId, recipientId, requestMetadata } = payload;
+
+    const [user, document, recipient] = await Promise.all([
+      prisma.user.findFirstOrThrow({
+        where: {
+          id: userId,
+        },
+      }),
+      prisma.document.findFirstOrThrow({
+        where: {
+          id: documentId,
+          status: DocumentStatus.PENDING,
+        },
+        include: {
+          documentMeta: true,
+        },
+      }),
+      prisma.recipient.findFirstOrThrow({
+        where: {
+          id: recipientId,
+        },
+      }),
+    ]);
+
+    const { documentMeta } = document;
+
+    if (recipient.role === RecipientRole.CC) {
+      return;
+    }
+
+    const emailType = RECIPIENT_ROLE_TO_EMAIL_TYPE[recipient.role];
+    const roleDescription = RECIPIENT_ROLES_DESCRIPTION[recipient.role];
+
+    const isSendingToSelf = recipient.email === user.email;
+    const selfSignerMessage = `You have initiated the document ${`"${document.title}"`} that requires you to ${roleDescription.actionVerb.toLowerCase()} it.`;
+
+    const emailSubject = isSendingToSelf
+      ? `Please ${roleDescription.actionVerb.toLowerCase()} your document`
+      : `Please ${roleDescription.actionVerb.toLowerCase()} this document`;
+
+    const emailTemplateVariables = {
+      'signer.name': recipient.name,
+      'signer.email': recipient.email,
+      'document.title': document.title,
+    };
+
+    const assetBaseUrl = NEXT_PUBLIC_WEBAPP_URL() || 'http://localhost:3000';
+    const signDocumentUrl = `${NEXT_PUBLIC_WEBAPP_URL()}/sign/${recipient.token}`;
+
+    const template = createElement(DocumentInviteEmailTemplate, {
+      documentName: document.title,
+      inviterName: user.name || undefined,
+      inviterEmail: user.email,
+      assetBaseUrl,
+      signDocumentLink: signDocumentUrl,
+      customBody: renderCustomEmailTemplate(
+        isSendingToSelf ? selfSignerMessage : documentMeta?.message || '',
+        emailTemplateVariables,
+      ),
+      role: recipient.role,
+      selfSigner: isSendingToSelf,
+    });
+
+    await io.runTask('send-signing-email', async () => {
+      await mailer.sendMail({
+        to: {
+          name: recipient.name,
+          address: recipient.email,
+        },
+        from: {
+          name: FROM_NAME,
+          address: FROM_ADDRESS,
+        },
+        subject: renderCustomEmailTemplate(
+          documentMeta?.subject || emailSubject,
+          emailTemplateVariables,
+        ),
+        html: render(template),
+        text: render(template, { plainText: true }),
+      });
+    });
+
+    await io.runTask('update-recipient', async () => {
+      await prisma.recipient.update({
+        where: {
+          id: recipient.id,
+        },
+        data: {
+          sendStatus: SendStatus.SENT,
+        },
+      });
+    });
+
+    await io.runTask('store-audit-log', async () => {
+      await prisma.documentAuditLog.create({
+        data: createDocumentAuditLogData({
+          type: DOCUMENT_AUDIT_LOG_TYPE.EMAIL_SENT,
+          documentId: document.id,
+          user,
+          requestMetadata,
+          data: {
+            emailType,
+            recipientId: recipient.id,
+            recipientName: recipient.name,
+            recipientEmail: recipient.email,
+            recipientRole: recipient.role,
+            isResending: false,
+          },
+        }),
+      });
+    });
+  },
+} as const satisfies JobDefinition;