documenso/packages/lib/server-only/recipient/update-recipient.ts

import { prisma } from '@documenso/prisma';
import type { RecipientRole, Team } from '@documenso/prisma/client';

import { DOCUMENT_AUDIT_LOG_TYPE } from '../../types/document-audit-logs';
import type { RequestMetadata } from '../../universal/extract-request-metadata';
import { diffRecipientChanges } from '../../utils/document-audit-logs';
import { queueJob } from '../queue/job';

export type UpdateRecipientOptions = {
  documentId: number;
  recipientId: number;
  email?: string;
  name?: string;
  role?: RecipientRole;
  userId: number;
  teamId?: number;
  requestMetadata?: RequestMetadata;
};

export const updateRecipient = async ({
  documentId,
  recipientId,
  email,
  name,
  role,
  userId,
  teamId,
  requestMetadata,
}: UpdateRecipientOptions) => {
  const recipient = await prisma.recipient.findFirst({
    where: {
      id: recipientId,
      Document: {
        id: documentId,
        ...(teamId
          ? {
              team: {
                id: teamId,
                members: {
                  some: {
                    userId,
                  },
                },
              },
            }
          : {
              userId,
              teamId: null,
            }),
      },
    },
  });

  let team: Team | null = null;

  if (teamId) {
    team = await prisma.team.findFirst({
      where: {
        id: teamId,
        members: {
          some: {
            userId,
          },
        },
      },
    });
  }

  const user = await prisma.user.findFirstOrThrow({
    where: {
      id: userId,
    },
  });

  if (!recipient) {
    throw new Error('Recipient not found');
  }

  const updatedRecipient = await prisma.recipient.update({
    where: {
      id: recipient.id,
    },
    data: {
      email: email?.toLowerCase() ?? recipient.email,
      name: name ?? recipient.name,
      role: role ?? recipient.role,
    },
  });

  const changes = diffRecipientChanges(recipient, updatedRecipient);

  if (changes.length > 0) {
    await queueJob({
      job: 'create-document-audit-log',
      args: {
        type: DOCUMENT_AUDIT_LOG_TYPE.RECIPIENT_UPDATED,
        documentId: documentId,
        user: {
          id: team?.id ?? user.id,
          name: team?.name ?? user.name,
          email: team ? '' : user.email,
        },
        requestMetadata,
        data: {
          changes,
          recipientId,
          recipientEmail: updatedRecipient.email,
          recipientName: updatedRecipient.name,
          recipientRole: updatedRecipient.role,
        },
      },
    });

    return updatedRecipient;
  }

  return updatedRecipient;
};