Skip to content

The Open Source DocuSign Alternative.

feat: dialog to enter custom recipients for creating document from template

Ephraim Atta-Duncan6ee896048ea9
diff --git a/apps/web/src/app/(dashboard)/templates/data-table-templates.tsx b/apps/web/src/app/(dashboard)/templates/data-table-templates.tsx
index 309695c88..e878d8df2 100644
--- a/apps/web/src/app/(dashboard)/templates/data-table-templates.tsx
+++ b/apps/web/src/app/(dashboard)/templates/data-table-templates.tsx
@@ -1,30 +1,31 @@
'use client';
-import { useState, useTransition } from 'react';
+import { useTransition } from 'react';
import Link from 'next/link';
-import { useRouter } from 'next/navigation';
-import { AlertTriangle, Loader, Plus } from 'lucide-react';
+import { AlertTriangle, Loader } from 'lucide-react';
import { useLimits } from '@documenso/ee/server-only/limits/provider/client';
import { useUpdateSearchParams } from '@documenso/lib/client-only/hooks/use-update-search-params';
-import type { Template } from '@documenso/prisma/client';
-import { trpc } from '@documenso/trpc/react';
+import type { Recipient, Template } from '@documenso/prisma/client';
import { Alert, AlertDescription, AlertTitle } from '@documenso/ui/primitives/alert';
-import { Button } from '@documenso/ui/primitives/button';
import { DataTable } from '@documenso/ui/primitives/data-table';
import { DataTablePagination } from '@documenso/ui/primitives/data-table-pagination';
-import { useToast } from '@documenso/ui/primitives/use-toast';
import { LocaleDate } from '~/components/formatter/locale-date';
import { TemplateType } from '~/components/formatter/template-type';
import { DataTableActionDropdown } from './data-table-action-dropdown';
import { DataTableTitle } from './data-table-title';
+import { UseTemplateDialog } from './use-template-dialog';
+
+type TemplateWithRecipient = Template & {
+ Recipient: Recipient[];
+};
type TemplatesDataTableProps = {
- templates: Template[];
+ templates: TemplateWithRecipient[];
perPage: number;
page: number;
totalPages: number;
@@ -47,14 +48,6 @@ export const TemplatesDataTable = ({
const { remaining } = useLimits();
- const router = useRouter();
-
- const { toast } = useToast();
- const [loadingStates, setLoadingStates] = useState<{ [key: string]: boolean }>({});
-
- const { mutateAsync: createDocumentFromTemplate } =
- trpc.template.createDocumentFromTemplate.useMutation();
-
const onPaginationChange = (page: number, perPage: number) => {
startTransition(() => {
updateSearchParams({
@@ -64,28 +57,6 @@ export const TemplatesDataTable = ({
});
};
- const onUseButtonClick = async (templateId: number) => {
- try {
- const { id } = await createDocumentFromTemplate({
- templateId,
- });
-
- toast({
- title: 'Document created',
- description: 'Your document has been created from the template successfully.',
- duration: 5000,
- });
-
- router.push(`${documentRootPath}/${id}`);
- } catch (err) {
- toast({
- title: 'Error',
- description: 'An error occurred while creating document from template.',
- variant: 'destructive',
- });
- }
- };
-
return (
<div className="relative">
{remaining.documents === 0 && (
@@ -121,22 +92,13 @@ export const TemplatesDataTable = ({
header: 'Actions',
accessorKey: 'actions',
cell: ({ row }) => {
- const isRowLoading = loadingStates[row.original.id];
-
return (
<div className="flex items-center gap-x-4">
- <Button
- disabled={isRowLoading || remaining.documents === 0}
- loading={isRowLoading}
- onClick={async () => {
- setLoadingStates((prev) => ({ ...prev, [row.original.id]: true }));
- await onUseButtonClick(row.original.id);
- setLoadingStates((prev) => ({ ...prev, [row.original.id]: false }));
- }}
- >
- {!isRowLoading && <Plus className="-ml-1 mr-2 h-4 w-4" />}
- Use Template
- </Button>
+ <UseTemplateDialog
+ templateId={row.original.id}
+ recipients={row.original.Recipient}
+ documentRootPath={documentRootPath}
+ />
<DataTableActionDropdown
row={row.original}
diff --git a/apps/web/src/app/(dashboard)/templates/use-template-dialog.tsx b/apps/web/src/app/(dashboard)/templates/use-template-dialog.tsx
new file mode 100644
index 000000000..f1cbb3e4c
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/use-template-dialog.tsx
@@ -0,0 +1,242 @@
+import { useRouter } from 'next/navigation';
+
+import { zodResolver } from '@hookform/resolvers/zod';
+import { Plus } from 'lucide-react';
+import { Controller, useFieldArray, useForm } from 'react-hook-form';
+import * as z from 'zod';
+
+import type { Recipient } from '@documenso/prisma/client';
+import { RecipientRole } from '@documenso/prisma/client';
+import { trpc } from '@documenso/trpc/react';
+import { Button } from '@documenso/ui/primitives/button';
+import {
+ Dialog,
+ DialogClose,
+ DialogContent,
+ DialogDescription,
+ DialogFooter,
+ DialogHeader,
+ DialogTitle,
+ DialogTrigger,
+} from '@documenso/ui/primitives/dialog';
+import { ROLE_ICONS } from '@documenso/ui/primitives/document-flow/add-signers';
+import { FormErrorMessage } from '@documenso/ui/primitives/form/form-error-message';
+import { Input } from '@documenso/ui/primitives/input';
+import { Label } from '@documenso/ui/primitives/label';
+import { Select, SelectContent, SelectItem, SelectTrigger } from '@documenso/ui/primitives/select';
+import { useToast } from '@documenso/ui/primitives/use-toast';
+
+const ZAddRecipientsForNewDocumentSchema = z.object({
+ recipients: z.array(
+ z.object({
+ email: z.string().email(),
+ name: z.string(),
+ role: z.nativeEnum(RecipientRole),
+ }),
+ ),
+});
+
+type TAddRecipientsForNewDocumentSchema = z.infer<typeof ZAddRecipientsForNewDocumentSchema>;
+
+export type UseTemplateDialogProps = {
+ templateId: number;
+ recipients: Recipient[];
+ documentRootPath: string;
+};
+
+export function UseTemplateDialog({
+ recipients,
+ documentRootPath,
+ templateId,
+}: UseTemplateDialogProps) {
+ const router = useRouter();
+ const { toast } = useToast();
+
+ const {
+ control,
+ handleSubmit,
+ formState: { errors, isSubmitting },
+ } = useForm<TAddRecipientsForNewDocumentSchema>({
+ resolver: zodResolver(ZAddRecipientsForNewDocumentSchema),
+ defaultValues: {
+ recipients:
+ recipients.length > 0
+ ? recipients.map((recipient) => ({
+ nativeId: recipient.id,
+ formId: String(recipient.id),
+ name: recipient.name,
+ email: recipient.email,
+ role: recipient.role,
+ }))
+ : [
+ {
+ name: '',
+ email: '',
+ role: RecipientRole.SIGNER,
+ },
+ ],
+ },
+ });
+
+ const { mutateAsync: createDocumentFromTemplate, isLoading: isCreatingDocumentFromTemplate } =
+ trpc.template.createDocumentFromTemplate.useMutation();
+
+ const onSubmit = async (data: TAddRecipientsForNewDocumentSchema) => {
+ try {
+ const { id } = await createDocumentFromTemplate({
+ templateId,
+ recipients: data.recipients,
+ });
+
+ toast({
+ title: 'Document created',
+ description: 'Your document has been created from the template successfully.',
+ duration: 5000,
+ });
+
+ router.push(`${documentRootPath}/${id}`);
+ } catch (err) {
+ toast({
+ title: 'Error',
+ description: 'An error occurred while creating document from template.',
+ variant: 'destructive',
+ });
+ }
+ };
+
+ const onCreateDocumentFromTemplate = handleSubmit(onSubmit);
+
+ const { fields: formRecipients } = useFieldArray({
+ control,
+ name: 'recipients',
+ });
+
+ return (
+ <Dialog>
+ <DialogTrigger asChild>
+ <Button className="cursor-pointer">
+ <Plus className="-ml-1 mr-2 h-4 w-4" />
+ Use Template
+ </Button>
+ </DialogTrigger>
+ <DialogContent className="sm:max-w-md">
+ <DialogHeader>
+ <DialogTitle>Document Recipients</DialogTitle>
+ <DialogDescription>Add the recipients to create the template with.</DialogDescription>
+ </DialogHeader>
+ <div className="flex flex-col space-y-4">
+ {formRecipients.map((recipient, index) => (
+ <div
+ key={recipient.id}
+ data-native-id={recipient.id}
+ className="flex flex-wrap items-end gap-x-4"
+ >
+ <div className="flex-1">
+ <Label htmlFor={`recipient-${recipient.id}-email`}>
+ Email
+ <span className="text-destructive ml-1 inline-block font-medium">*</span>
+ </Label>
+
+ <Controller
+ control={control}
+ name={`recipients.${index}.email`}
+ render={({ field }) => (
+ <Input
+ id={`recipient-${recipient.id}-email`}
+ type="email"
+ className="bg-background mt-2"
+ disabled={isSubmitting}
+ {...field}
+ />
+ )}
+ />
+ </div>
+
+ <div className="flex-1">
+ <Label htmlFor={`recipient-${recipient.id}-name`}>Name</Label>
+
+ <Controller
+ control={control}
+ name={`recipients.${index}.name`}
+ render={({ field }) => (
+ <Input
+ id={`recipient-${recipient.id}-name`}
+ type="text"
+ className="bg-background mt-2"
+ disabled={isSubmitting}
+ {...field}
+ />
+ )}
+ />
+ </div>
+
+ <div className="w-[60px]">
+ <Controller
+ control={control}
+ name={`recipients.${index}.role`}
+ render={({ field: { value, onChange } }) => (
+ <Select value={value} onValueChange={(x) => onChange(x)}>
+ <SelectTrigger className="bg-background">{ROLE_ICONS[value]}</SelectTrigger>
+
+ <SelectContent className="" align="end">
+ <SelectItem value={RecipientRole.SIGNER}>
+ <div className="flex items-center">
+ <span className="mr-2">{ROLE_ICONS[RecipientRole.SIGNER]}</span>
+ Signer
+ </div>
+ </SelectItem>
+
+ <SelectItem value={RecipientRole.CC}>
+ <div className="flex items-center">
+ <span className="mr-2">{ROLE_ICONS[RecipientRole.CC]}</span>
+ Receives copy
+ </div>
+ </SelectItem>
+
+ <SelectItem value={RecipientRole.APPROVER}>
+ <div className="flex items-center">
+ <span className="mr-2">{ROLE_ICONS[RecipientRole.APPROVER]}</span>
+ Approver
+ </div>
+ </SelectItem>
+
+ <SelectItem value={RecipientRole.VIEWER}>
+ <div className="flex items-center">
+ <span className="mr-2">{ROLE_ICONS[RecipientRole.VIEWER]}</span>
+ Viewer
+ </div>
+ </SelectItem>
+ </SelectContent>
+ </Select>
+ )}
+ />
+ </div>
+
+ <div className="w-full">
+ <FormErrorMessage className="mt-2" error={errors.recipients?.[index]?.email} />
+ <FormErrorMessage className="mt-2" error={errors.recipients?.[index]?.name} />
+ </div>
+ </div>
+ ))}
+ </div>
+
+ <DialogFooter className="justify-end">
+ <DialogClose asChild>
+ <Button type="button" variant="secondary">
+ Close
+ </Button>
+ </DialogClose>
+
+ <Button
+ type="button"
+ loading={isCreatingDocumentFromTemplate}
+ disabled={isCreatingDocumentFromTemplate}
+ onClick={onCreateDocumentFromTemplate}
+ >
+ Create Document
+ </Button>
+ </DialogFooter>
+ </DialogContent>
+ </Dialog>
+ );
+}
diff --git a/packages/lib/server-only/template/find-templates.ts b/packages/lib/server-only/template/find-templates.ts
index d453d28a0..69b43f9b9 100644
--- a/packages/lib/server-only/template/find-templates.ts
+++ b/packages/lib/server-only/template/find-templates.ts
@@ -38,6 +38,7 @@ export const findTemplates = async ({
include: {
templateDocumentData: true,
Field: true,
+ Recipient: true,
},
skip: Math.max(page - 1, 0) * perPage,
orderBy: {
diff --git a/packages/trpc/server/template-router/router.ts b/packages/trpc/server/template-router/router.ts
index 7417e7d00..3f5346554 100644
--- a/packages/trpc/server/template-router/router.ts
+++ b/packages/trpc/server/template-router/router.ts
@@ -52,6 +52,7 @@ export const templateRouter = router({
return await createDocumentFromTemplate({
templateId,
userId: ctx.user.id,
+ recipients: input.recipients,
});
} catch (err) {
throw new TRPCError({
diff --git a/packages/trpc/server/template-router/schema.ts b/packages/trpc/server/template-router/schema.ts
index 3d87d4b4f..561bad109 100644
--- a/packages/trpc/server/template-router/schema.ts
+++ b/packages/trpc/server/template-router/schema.ts
@@ -1,5 +1,7 @@
import { z } from 'zod';
+import { RecipientRole } from '@documenso/prisma/client';
+
export const ZCreateTemplateMutationSchema = z.object({
title: z.string().min(1).trim(),
teamId: z.number().optional(),
@@ -8,6 +10,15 @@ export const ZCreateTemplateMutationSchema = z.object({
export const ZCreateDocumentFromTemplateMutationSchema = z.object({
templateId: z.number(),
+ recipients: z
+ .array(
+ z.object({
+ email: z.string().email(),
+ name: z.string(),
+ role: z.nativeEnum(RecipientRole),
+ }),
+ )
+ .optional(),
});
export const ZDuplicateTemplateMutationSchema = z.object({
diff --git a/packages/ui/primitives/document-flow/add-signers.tsx b/packages/ui/primitives/document-flow/add-signers.tsx
index b1341c6ca..06e0a2af2 100644
--- a/packages/ui/primitives/document-flow/add-signers.tsx
+++ b/packages/ui/primitives/document-flow/add-signers.tsx
@@ -32,7 +32,7 @@ import {
import { ShowFieldItem } from './show-field-item';
import type { DocumentFlowStep } from './types';
-const ROLE_ICONS: Record<RecipientRole, JSX.Element> = {
+export const ROLE_ICONS: Record<RecipientRole, JSX.Element> = {
SIGNER: <PencilLine className="h-4 w-4" />,
APPROVER: <BadgeCheck className="h-4 w-4" />,
CC: <Copy className="h-4 w-4" />,