feat: generate recipients and fields based on recipients

apps/remix/app/utils/analyze-ai-recipients.ts

@@ -0,0 +1,93 @@
+import { RecipientRole } from '@prisma/client';
+
+import { AppError } from '@documenso/lib/errors/app-error';
+
+export type AiRecipient = {
+  name: string;
+  email?: string;
+  role: 'SIGNER' | 'APPROVER' | 'CC';
+  signingOrder?: number;
+};
+
+const sanitizeEmailLocalPart = (value: string) => {
+  return value
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '.')
+    .replace(/\.+/g, '.')
+    .replace(/^\.+|\.+$/g, '')
+    .slice(0, 32);
+};
+
+export const createPlaceholderRecipientEmail = (
+  name: string,
+  envelopeId: string,
+  position: number,
+) => {
+  const normalizedName = sanitizeEmailLocalPart(name);
+  const baseLocalPart = normalizedName ? `${normalizedName}.${position}` : `recipient-${position}`;
+  const envelopeSuffix = envelopeId
+    .replace(/[^a-z0-9]/gi, '')
+    .toLowerCase()
+    .slice(0, 6);
+  const suffix = envelopeSuffix ? `-${envelopeSuffix}` : '';
+
+  return `${baseLocalPart}${suffix}@documenso.ai`;
+};
+
+export const analyzeRecipientsFromDocument = async (envelopeId: string): Promise<AiRecipient[]> => {
+  try {
+    const response = await fetch('/api/ai/analyze-recipients', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({ envelopeId }),
+    });
+
+    if (!response.ok) {
+      throw new Error('Failed to analyze recipients');
+    }
+
+    return (await response.json()) as AiRecipient[];
+  } catch (error) {
+    throw AppError.parseError(error);
+  }
+};
+
+export type RecipientForCreation = {
+  name: string;
+  email: string;
+  role: RecipientRole;
+  signingOrder?: number;
+};
+
+export const ensureRecipientEmails = (
+  recipients: AiRecipient[],
+  envelopeId: string,
+): RecipientForCreation[] => {
+  let recipientIndex = 1;
+  const allowedRoles: RecipientRole[] = [
+    RecipientRole.SIGNER,
+    RecipientRole.APPROVER,
+    RecipientRole.CC,
+  ];
+
+  return recipients.map((recipient) => {
+    const email =
+      recipient.email ??
+      createPlaceholderRecipientEmail(recipient.name, envelopeId, recipientIndex);
+
+    recipientIndex += 1;
+
+    const candidateRole = recipient.role as RecipientRole;
+    const normalizedRole = allowedRoles.includes(candidateRole)
+      ? candidateRole
+      : RecipientRole.SIGNER;
+
+    return {
+      ...recipient,
+      email,
+      role: normalizedRole,
+    };
+  });
+};