feat: add get recipient route (#1553)

packages/lib/server-only/recipient/get-recipient-by-id-v1-api.ts

@@ -0,0 +1,21 @@
+import { prisma } from '@documenso/prisma';
+
+export type GetRecipientByIdOptions = {
+  id: number;
+  documentId: number;
+};
+
+export const getRecipientByIdV1Api = async ({ documentId, id }: GetRecipientByIdOptions) => {
+  const recipient = await prisma.recipient.findFirst({
+    where: {
+      documentId,
+      id,
+    },
+  });
+
+  if (!recipient) {
+    throw new Error('Recipient not found');
+  }
+
+  return recipient;
+};

packages/lib/server-only/recipient/get-recipient-by-id.ts

@@ -1,20 +1,63 @@
+import type { z } from 'zod';
+
 import { prisma } from '@documenso/prisma';
+import { FieldSchema, RecipientSchema } from '@documenso/prisma/generated/zod';
+
+import { AppError, AppErrorCode } from '../../errors/app-error';
 
 export type GetRecipientByIdOptions = {
-  id: number;
-  documentId: number;
+  recipientId: number;
+  userId: number;
+  teamId?: number;
 };
 
-export const getRecipientById = async ({ documentId, id }: GetRecipientByIdOptions) => {
+export const ZGetRecipientByIdResponseSchema = RecipientSchema.extend({
+  Field: FieldSchema.array(),
+});
+
+export type TGetRecipientByIdResponse = z.infer<typeof ZGetRecipientByIdResponseSchema>;
+
+/**
+ * Get a recipient by ID. This will also return the recipient signing token so
+ * be careful when using this.
+ */
+export const getRecipientById = async ({
+  recipientId,
+  userId,
+  teamId,
+}: GetRecipientByIdOptions): Promise<TGetRecipientByIdResponse> => {
   const recipient = await prisma.recipient.findFirst({
     where: {
-      documentId,
-      id,
+      id: recipientId,
+      Document: {
+        OR: [
+          teamId === undefined
+            ? {
+                userId,
+                teamId: null,
+              }
+            : {
+                teamId,
+                team: {
+                  members: {
+                    some: {
+                      userId,
+                    },
+                  },
+                },
+              },
+        ],
+      },
+    },
+    include: {
+      Field: true,
     },
   });
 
   if (!recipient) {
-    throw new Error('Recipient not found');
+    throw new AppError(AppErrorCode.NOT_FOUND, {
+      message: 'Recipient not found',
+    });
   }
 
   return recipient;