Skip to content

The Open Source DocuSign Alternative.

feat: templates

Ephraim Atta-Duncan31a9127c9e77
diff --git a/apps/marketing/src/app/(marketing)/singleplayer/client.tsx b/apps/marketing/src/app/(marketing)/singleplayer/client.tsx
index b7654c7cf..71f6963a2 100644
--- a/apps/marketing/src/app/(marketing)/singleplayer/client.tsx
+++ b/apps/marketing/src/app/(marketing)/singleplayer/client.tsx
@@ -151,6 +151,7 @@ export const SinglePlayerClient = () => {
email: '',
name: '',
token: '',
+ templateToken: '',
expired: null,
signedAt: null,
readStatus: 'OPENED',
diff --git a/apps/marketing/src/components/(marketing)/single-player-mode/single-player-mode-success.tsx b/apps/marketing/src/components/(marketing)/single-player-mode/single-player-mode-success.tsx
index aa423e522..1af71c775 100644
--- a/apps/marketing/src/components/(marketing)/single-player-mode/single-player-mode-success.tsx
+++ b/apps/marketing/src/components/(marketing)/single-player-mode/single-player-mode-success.tsx
@@ -6,8 +6,9 @@ import Link from 'next/link';
import signingCelebration from '@documenso/assets/images/signing-celebration.png';
import { useFeatureFlags } from '@documenso/lib/client-only/providers/feature-flag';
-import { DocumentStatus, Signature } from '@documenso/prisma/client';
-import { DocumentWithRecipient } from '@documenso/prisma/types/document-with-recipient';
+import type { Signature } from '@documenso/prisma/client';
+import { DocumentStatus } from '@documenso/prisma/client';
+import type { DocumentWithRecipient } from '@documenso/prisma/types/document-with-recipient';
import DocumentDialog from '@documenso/ui/components/document/document-dialog';
import { DocumentDownloadButton } from '@documenso/ui/components/document/document-download-button';
import { DocumentShareButton } from '@documenso/ui/components/document/document-share-button';
diff --git a/apps/web/src/app/(dashboard)/documents/data-table-action-dropdown.tsx b/apps/web/src/app/(dashboard)/documents/data-table-action-dropdown.tsx
index 9c3532f88..f1cbcc147 100644
--- a/apps/web/src/app/(dashboard)/documents/data-table-action-dropdown.tsx
+++ b/apps/web/src/app/(dashboard)/documents/data-table-action-dropdown.tsx
@@ -99,6 +99,7 @@ export const DataTableActionDropdown = ({ row }: DataTableActionDropdownProps) =
};
const nonSignedRecipients = row.Recipient.filter((item) => item.signingStatus !== 'SIGNED');
+
return (
<DropdownMenu>
<DropdownMenuTrigger>
@@ -127,7 +128,7 @@ export const DataTableActionDropdown = ({ row }: DataTableActionDropdownProps) =
Download
</DropdownMenuItem>
- <DropdownMenuItem onClick={() => setDuplicateDialogOpen(true)}>
+ <DropdownMenuItem disabled>
<Copy className="mr-2 h-4 w-4" />
Duplicate
</DropdownMenuItem>
diff --git a/apps/web/src/app/(dashboard)/templates/[id]/edit-template.tsx b/apps/web/src/app/(dashboard)/templates/[id]/edit-template.tsx
new file mode 100644
index 000000000..b4d20b60d
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/[id]/edit-template.tsx
@@ -0,0 +1,152 @@
+'use client';
+
+import { useState } from 'react';
+
+import { useRouter } from 'next/navigation';
+
+import { DocumentData, Field, Recipient, Template, User } from '@documenso/prisma/client';
+import { cn } from '@documenso/ui/lib/utils';
+import { Card, CardContent } from '@documenso/ui/primitives/card';
+import {
+ DocumentFlowFormContainer,
+ DocumentFlowFormContainerHeader,
+} from '@documenso/ui/primitives/document-flow/document-flow-root';
+import { DocumentFlowStep } from '@documenso/ui/primitives/document-flow/types';
+import { LazyPDFViewer } from '@documenso/ui/primitives/lazy-pdf-viewer';
+import { AddTemplateFieldsFormPartial } from '@documenso/ui/primitives/template-flow/add-template-fields';
+import { TAddTemplateFieldsFormSchema } from '@documenso/ui/primitives/template-flow/add-template-fields.types';
+import { AddTemplatePlaceholderRecipientsFormPartial } from '@documenso/ui/primitives/template-flow/add-template-placeholder-recipients';
+import { TAddTemplatePlacholderRecipientsFormSchema } from '@documenso/ui/primitives/template-flow/add-template-placeholder-recipients.types';
+import { useToast } from '@documenso/ui/primitives/use-toast';
+
+import { addTemplateFields } from '~/components/forms/edit-template/add-template-fields.action';
+import { addTemplatePlaceholders } from '~/components/forms/edit-template/add-template-placeholders.action';
+
+export type EditTemplateFormProps = {
+ className?: string;
+ user: User;
+ template: Template;
+ recipients: Recipient[];
+ fields: Field[];
+ documentData: DocumentData;
+};
+
+type EditTemplateStep = 'signers' | 'fields';
+
+export const EditTemplateForm = ({
+ className,
+ template,
+ recipients,
+ fields,
+ user: _user,
+ documentData,
+}: EditTemplateFormProps) => {
+ const { toast } = useToast();
+ const router = useRouter();
+
+ const [step, setStep] = useState<EditTemplateStep>('signers');
+
+ const documentFlow: Record<EditTemplateStep, DocumentFlowStep> = {
+ signers: {
+ title: 'Add Placeholders',
+ description: 'Add all relevant placeholders for each recipient.',
+ stepIndex: 1,
+ },
+ fields: {
+ title: 'Add Fields',
+ description: 'Add all relevant fields for each recipient.',
+ stepIndex: 2,
+ onBackStep: () => setStep('signers'),
+ },
+ };
+
+ const currentDocumentFlow = documentFlow[step];
+
+ const onAddTemplatePlaceholderFormSubmit = async (
+ data: TAddTemplatePlacholderRecipientsFormSchema,
+ ) => {
+ try {
+ await addTemplatePlaceholders({
+ templateId: template.id,
+ signers: data.signers,
+ });
+
+ router.refresh();
+
+ setStep('fields');
+ } catch (err) {
+ toast({
+ title: 'Error',
+ description: 'An error occurred while adding signers.',
+ variant: 'destructive',
+ });
+ }
+ };
+
+ const onAddFieldsFormSubmit = async (data: TAddTemplateFieldsFormSchema) => {
+ try {
+ await addTemplateFields({
+ templateId: template.id,
+ fields: data.fields,
+ });
+
+ toast({
+ title: 'Template saved',
+ description: 'Your templates has been saved successfully.',
+ duration: 5000,
+ });
+
+ router.push('/templates');
+ } catch (err) {
+ toast({
+ title: 'Error',
+ description: 'An error occurred while adding signers.',
+ variant: 'destructive',
+ });
+ }
+ };
+
+ return (
+ <div className={cn('grid w-full grid-cols-12 gap-8', className)}>
+ <Card
+ className="relative col-span-12 rounded-xl before:rounded-xl lg:col-span-6 xl:col-span-7"
+ gradient
+ >
+ <CardContent className="p-2">
+ <LazyPDFViewer key={documentData.id} documentData={documentData} />
+ </CardContent>
+ </Card>
+
+ <div className="col-span-12 lg:col-span-6 xl:col-span-5">
+ <DocumentFlowFormContainer onSubmit={(e) => e.preventDefault()}>
+ <DocumentFlowFormContainerHeader
+ title={currentDocumentFlow.title}
+ description={currentDocumentFlow.description}
+ />
+
+ {step === 'signers' && (
+ <AddTemplatePlaceholderRecipientsFormPartial
+ key={recipients.length}
+ documentFlow={documentFlow.signers}
+ recipients={recipients}
+ fields={fields}
+ numberOfSteps={Object.keys(documentFlow).length}
+ onSubmit={onAddTemplatePlaceholderFormSubmit}
+ />
+ )}
+
+ {step === 'fields' && (
+ <AddTemplateFieldsFormPartial
+ key={fields.length}
+ documentFlow={documentFlow.fields}
+ recipients={recipients}
+ fields={fields}
+ numberOfSteps={Object.keys(documentFlow).length}
+ onSubmit={onAddFieldsFormSubmit}
+ />
+ )}
+ </DocumentFlowFormContainer>
+ </div>
+ </div>
+ );
+};
diff --git a/apps/web/src/app/(dashboard)/templates/[id]/page.tsx b/apps/web/src/app/(dashboard)/templates/[id]/page.tsx
new file mode 100644
index 000000000..b8c645c80
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/[id]/page.tsx
@@ -0,0 +1,81 @@
+import React from 'react';
+
+import Link from 'next/link';
+import { redirect } from 'next/navigation';
+
+import { ChevronLeft } from 'lucide-react';
+
+import { getRequiredServerComponentSession } from '@documenso/lib/next-auth/get-server-session';
+import { getFieldsForTemplate } from '@documenso/lib/server-only/field/get-fields-for-template';
+import { getRecipientsForTemplate } from '@documenso/lib/server-only/recipient/get-recipients-for-template';
+import { getTemplateById } from '@documenso/lib/server-only/template/get-template-by-id';
+
+import { TemplateType } from '~/components/formatter/template-type';
+
+import { EditTemplateForm } from './edit-template';
+
+export type TemplatePageProps = {
+ params: {
+ id: string;
+ };
+};
+
+export default async function TemplatePage({ params }: TemplatePageProps) {
+ const { id } = params;
+
+ const templateId = Number(id);
+
+ if (!templateId || Number.isNaN(templateId)) {
+ redirect('/documents');
+ }
+
+ const { user } = await getRequiredServerComponentSession();
+
+ const template = await getTemplateById({
+ id: templateId,
+ userId: user.id,
+ }).catch(() => null);
+
+ if (!template || !template.templateDocumentData) {
+ redirect('/documents');
+ }
+
+ const { templateDocumentData } = template;
+
+ const [templateRecipients, templateFields] = await Promise.all([
+ await getRecipientsForTemplate({
+ templateId,
+ userId: user.id,
+ }),
+ await getFieldsForTemplate({
+ templateId,
+ userId: user.id,
+ }),
+ ]);
+
+ return (
+ <div className="mx-auto max-w-screen-xl px-4 md:px-8">
+ <Link href="/templates" className="flex items-center text-[#7AC455] hover:opacity-80">
+ <ChevronLeft className="mr-2 inline-block h-5 w-5" />
+ Templates
+ </Link>
+
+ <h1 className="mt-4 truncate text-2xl font-semibold md:text-3xl" title={template.title}>
+ {template.title}
+ </h1>
+
+ <div className="mt-2.5 flex items-center gap-x-6">
+ <TemplateType inheritColor type={template.type} className="text-muted-foreground" />
+ </div>
+
+ <EditTemplateForm
+ className="mt-8"
+ template={template}
+ user={user}
+ recipients={templateRecipients}
+ fields={templateFields}
+ documentData={templateDocumentData}
+ />
+ </div>
+ );
+}
diff --git a/apps/web/src/app/(dashboard)/templates/data-table-action-dropdown.tsx b/apps/web/src/app/(dashboard)/templates/data-table-action-dropdown.tsx
new file mode 100644
index 000000000..15ad9b58b
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/data-table-action-dropdown.tsx
@@ -0,0 +1,79 @@
+'use client';
+
+import { useState } from 'react';
+
+import Link from 'next/link';
+
+import { Copy, Edit, MoreHorizontal, Trash2 } from 'lucide-react';
+import { useSession } from 'next-auth/react';
+
+import { Template } from '@documenso/prisma/client';
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuLabel,
+ DropdownMenuTrigger,
+} from '@documenso/ui/primitives/dropdown-menu';
+
+import { DeleteTemplateDialog } from './delete-template-dialog';
+import { DuplicateTemplateDialog } from './duplicate-template-dialog';
+
+export type DataTableActionDropdownProps = {
+ row: Template;
+};
+
+export const DataTableActionDropdown = ({ row }: DataTableActionDropdownProps) => {
+ const { data: session } = useSession();
+
+ const [isDeleteDialogOpen, setDeleteDialogOpen] = useState(false);
+ const [isDuplicateDialogOpen, setDuplicateDialogOpen] = useState(false);
+
+ if (!session) {
+ return null;
+ }
+
+ const isOwner = row.userId === session.user.id;
+
+ return (
+ <DropdownMenu>
+ <DropdownMenuTrigger>
+ <MoreHorizontal className="text-muted-foreground h-5 w-5" />
+ </DropdownMenuTrigger>
+
+ <DropdownMenuContent className="w-52" align="start" forceMount>
+ <DropdownMenuLabel>Action</DropdownMenuLabel>
+
+ <DropdownMenuItem disabled={!isOwner} asChild>
+ <Link href={`/templates/${row.id}`}>
+ <Edit className="mr-2 h-4 w-4" />
+ Edit
+ </Link>
+ </DropdownMenuItem>
+
+ {/* <DropdownMenuItem disabled={!isOwner} onClick={async () => onDuplicateButtonClick(row.id)}> */}
+ <DropdownMenuItem disabled={!isOwner} onClick={() => setDuplicateDialogOpen(true)}>
+ <Copy className="mr-2 h-4 w-4" />
+ Duplicate
+ </DropdownMenuItem>
+
+ <DropdownMenuItem disabled={!isOwner} onClick={() => setDeleteDialogOpen(true)}>
+ <Trash2 className="mr-2 h-4 w-4" />
+ Delete
+ </DropdownMenuItem>
+ </DropdownMenuContent>
+
+ <DuplicateTemplateDialog
+ id={row.id}
+ open={isDuplicateDialogOpen}
+ onOpenChange={setDuplicateDialogOpen}
+ />
+
+ <DeleteTemplateDialog
+ id={row.id}
+ open={isDeleteDialogOpen}
+ onOpenChange={setDeleteDialogOpen}
+ />
+ </DropdownMenu>
+ );
+};
diff --git a/apps/web/src/app/(dashboard)/templates/data-table-templates.tsx b/apps/web/src/app/(dashboard)/templates/data-table-templates.tsx
new file mode 100644
index 000000000..3cc8102e7
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/data-table-templates.tsx
@@ -0,0 +1,136 @@
+'use client';
+
+import { useState, useTransition } from 'react';
+
+import { useRouter } from 'next/navigation';
+
+import { Loader, Plus } from 'lucide-react';
+
+import { useUpdateSearchParams } from '@documenso/lib/client-only/hooks/use-update-search-params';
+import { Template } from '@documenso/prisma/client';
+import { trpc } from '@documenso/trpc/react';
+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';
+
+type TemplatesDataTableProps = {
+ templates: Template[];
+ perPage: number;
+ page: number;
+ totalPages: number;
+};
+
+export const TemplatesDataTable = ({
+ templates,
+ perPage,
+ page,
+ totalPages,
+}: TemplatesDataTableProps) => {
+ const [isPending, startTransition] = useTransition();
+ const updateSearchParams = useUpdateSearchParams();
+
+ 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({
+ page,
+ perPage,
+ });
+ });
+ };
+
+ 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(`/documents/${id}`);
+ } catch (err) {
+ toast({
+ title: 'Error',
+ description: 'An error occurred while creating document from template.',
+ variant: 'destructive',
+ });
+ }
+ };
+
+ return (
+ <div className="relative">
+ <DataTable
+ columns={[
+ {
+ header: 'Created',
+ accessorKey: 'createdAt',
+ cell: ({ row }) => <LocaleDate date={row.original.createdAt} />,
+ },
+ {
+ header: 'Title',
+ cell: ({ row }) => <DataTableTitle row={row.original} />,
+ },
+ {
+ header: 'Type',
+ accessorKey: 'type',
+ cell: ({ row }) => <TemplateType type={row.original.type} />,
+ },
+ {
+ header: 'Actions',
+ accessorKey: 'actions',
+ cell: ({ row }) => {
+ const isRowLoading = loadingStates[row.original.id];
+
+ return (
+ <div className="flex items-center gap-x-4">
+ <Button
+ disabled={isRowLoading}
+ 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
+ </Button>
+ <DataTableActionDropdown row={row.original} />
+ </div>
+ );
+ },
+ },
+ ]}
+ data={templates}
+ perPage={perPage}
+ currentPage={page}
+ totalPages={totalPages}
+ onPaginationChange={onPaginationChange}
+ >
+ {(table) => <DataTablePagination additionalInformation="VisibleCount" table={table} />}
+ </DataTable>
+
+ {isPending && (
+ <div className="absolute inset-0 flex items-center justify-center bg-white/50">
+ <Loader className="h-8 w-8 animate-spin text-gray-500" />
+ </div>
+ )}
+ </div>
+ );
+};
diff --git a/apps/web/src/app/(dashboard)/templates/data-table-title.tsx b/apps/web/src/app/(dashboard)/templates/data-table-title.tsx
new file mode 100644
index 000000000..31e1011be
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/data-table-title.tsx
@@ -0,0 +1,26 @@
+import Link from 'next/link';
+
+import { useSession } from 'next-auth/react';
+
+import { Template } from '@documenso/prisma/client';
+
+export type DataTableTitleProps = {
+ row: Template;
+};
+
+export const DataTableTitle = ({ row }: DataTableTitleProps) => {
+ const { data: session } = useSession();
+
+ if (!session) {
+ return null;
+ }
+
+ return (
+ <Link
+ href={`/templates/${row.id}`}
+ className="block max-w-[10rem] cursor-pointer truncate font-medium hover:underline md:max-w-[20rem]"
+ >
+ {row.title}
+ </Link>
+ );
+};
diff --git a/apps/web/src/app/(dashboard)/templates/delete-template-dialog.tsx b/apps/web/src/app/(dashboard)/templates/delete-template-dialog.tsx
new file mode 100644
index 000000000..ed7db1e72
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/delete-template-dialog.tsx
@@ -0,0 +1,84 @@
+import { useRouter } from 'next/navigation';
+
+import { trpc as trpcReact } from '@documenso/trpc/react';
+import { Button } from '@documenso/ui/primitives/button';
+import {
+ Dialog,
+ DialogContent,
+ DialogDescription,
+ DialogFooter,
+ DialogHeader,
+ DialogTitle,
+} from '@documenso/ui/primitives/dialog';
+import { useToast } from '@documenso/ui/primitives/use-toast';
+
+type DeleteTemplateDialogProps = {
+ id: number;
+ open: boolean;
+ onOpenChange: (_open: boolean) => void;
+};
+
+export const DeleteTemplateDialog = ({ id, open, onOpenChange }: DeleteTemplateDialogProps) => {
+ const router = useRouter();
+
+ const { toast } = useToast();
+
+ const { mutateAsync: deleteDocument, isLoading } = trpcReact.template.deleteTemplate.useMutation({
+ onSuccess: () => {
+ router.refresh();
+
+ toast({
+ title: 'Template deleted',
+ description: 'Your document has been successfully deleted.',
+ duration: 5000,
+ });
+
+ onOpenChange(false);
+ },
+ });
+
+ const onDraftDelete = async () => {
+ try {
+ await deleteDocument({ id });
+ } catch {
+ toast({
+ title: 'Something went wrong',
+ description: 'This template could not be deleted at this time. Please try again.',
+ variant: 'destructive',
+ duration: 7500,
+ });
+ }
+ };
+
+ return (
+ <Dialog open={open} onOpenChange={(value) => !isLoading && onOpenChange(value)}>
+ <DialogContent>
+ <DialogHeader>
+ <DialogTitle>Do you want to delete this template?</DialogTitle>
+
+ <DialogDescription>
+ Please note that this action is irreversible. Once confirmed, your template will be
+ permanently deleted.
+ </DialogDescription>
+ </DialogHeader>
+
+ <DialogFooter>
+ <div className="flex w-full flex-1 flex-nowrap gap-4">
+ <Button
+ type="button"
+ variant="secondary"
+ onClick={() => onOpenChange(false)}
+ className="flex-1"
+ >
+ Cancel
+ </Button>
+
+ <Button type="button" loading={isLoading} onClick={onDraftDelete} className="flex-1">
+ Delete
+ </Button>
+ </div>
+ </DialogFooter>
+ </DialogContent>
+ </Dialog>
+ );
+};
diff --git a/apps/web/src/app/(dashboard)/templates/duplicate-template-dialog.tsx b/apps/web/src/app/(dashboard)/templates/duplicate-template-dialog.tsx
new file mode 100644
index 000000000..5c3118035
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/duplicate-template-dialog.tsx
@@ -0,0 +1,89 @@
+import { useRouter } from 'next/navigation';
+
+import { trpc as trpcReact } from '@documenso/trpc/react';
+import { Button } from '@documenso/ui/primitives/button';
+import {
+ Dialog,
+ DialogContent,
+ DialogDescription,
+ DialogFooter,
+ DialogHeader,
+ DialogTitle,
+} from '@documenso/ui/primitives/dialog';
+import { useToast } from '@documenso/ui/primitives/use-toast';
+
+type DuplicateTemplateDialogProps = {
+ id: number;
+ open: boolean;
+ onOpenChange: (_open: boolean) => void;
+};
+
+export const DuplicateTemplateDialog = ({
+ id,
+ open,
+ onOpenChange,
+}: DuplicateTemplateDialogProps) => {
+ const router = useRouter();
+
+ const { toast } = useToast();
+
+ const { mutateAsync: duplicateTemplate, isLoading } =
+ trpcReact.template.duplicateTemplate.useMutation({
+ onSuccess: () => {
+ router.refresh();
+
+ toast({
+ title: 'Template duplicated',
+ description: 'Your template has been duplicated successfully.',
+ duration: 5000,
+ });
+
+ onOpenChange(false);
+ },
+ });
+
+ const onDuplicate = async () => {
+ try {
+ await duplicateTemplate({
+ templateId: id,
+ });
+
+ router.refresh();
+ } catch (err) {
+ toast({
+ title: 'Error',
+ description: 'An error occurred while duplicating template.',
+ variant: 'destructive',
+ });
+ }
+ };
+
+ return (
+ <Dialog open={open} onOpenChange={(value) => !isLoading && onOpenChange(value)}>
+ <DialogContent>
+ <DialogHeader>
+ <DialogTitle>Do you want to duplicate this template?</DialogTitle>
+
+ <DialogDescription className="pt-2">Your template will be duplicated.</DialogDescription>
+ </DialogHeader>
+
+ <DialogFooter>
+ <div className="flex w-full flex-1 flex-nowrap gap-4">
+ <Button
+ type="button"
+ variant="secondary"
+ onClick={() => onOpenChange(false)}
+ className="flex-1"
+ >
+ Cancel
+ </Button>
+
+ <Button type="button" loading={isLoading} onClick={onDuplicate} className="flex-1">
+ Duplicate
+ </Button>
+ </div>
+ </DialogFooter>
+ </DialogContent>
+ </Dialog>
+ );
+};
diff --git a/apps/web/src/app/(dashboard)/templates/empty-state.tsx b/apps/web/src/app/(dashboard)/templates/empty-state.tsx
new file mode 100644
index 000000000..b928d8a83
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/empty-state.tsx
@@ -0,0 +1,17 @@
+import { Bird } from 'lucide-react';
+
+export const EmptyTemplateState = () => {
+ return (
+ <div className="text-muted-foreground/60 flex h-96 flex-col items-center justify-center gap-y-4">
+ <Bird className="h-12 w-12" strokeWidth={1.5} />
+
+ <div className="text-center">
+ <h3 className="text-lg font-semibold">We're all empty</h3>
+
+ <p className="mt-2 max-w-[50ch]">
+ You have not yet created any templates. To create a template please upload one.
+ </p>
+ </div>
+ </div>
+ );
+};
diff --git a/apps/web/src/app/(dashboard)/templates/new-template-dialog.tsx b/apps/web/src/app/(dashboard)/templates/new-template-dialog.tsx
new file mode 100644
index 000000000..7de1355a7
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/new-template-dialog.tsx
@@ -0,0 +1,217 @@
+'use client';
+
+import React, { useState } from 'react';
+
+import { useRouter } from 'next/navigation';
+
+import { zodResolver } from '@hookform/resolvers/zod';
+import { FilePlus, X } from 'lucide-react';
+import { useForm } from 'react-hook-form';
+import * as z from 'zod';
+
+import { createDocumentData } from '@documenso/lib/server-only/document-data/create-document-data';
+import { base64 } from '@documenso/lib/universal/base64';
+import { putFile } from '@documenso/lib/universal/upload/put-file';
+import { trpc } from '@documenso/trpc/react';
+import { Button } from '@documenso/ui/primitives/button';
+import { Card, CardContent } from '@documenso/ui/primitives/card';
+import {
+ Dialog,
+ DialogContent,
+ DialogDescription,
+ DialogHeader,
+ DialogTitle,
+ DialogTrigger,
+} from '@documenso/ui/primitives/dialog';
+import { DocumentDropzone } from '@documenso/ui/primitives/document-dropzone';
+import {
+ Form,
+ FormControl,
+ FormDescription,
+ FormField,
+ FormItem,
+ FormLabel,
+ FormMessage,
+} from '@documenso/ui/primitives/form/form';
+import { Input } from '@documenso/ui/primitives/input';
+import { Label } from '@documenso/ui/primitives/label';
+import { useToast } from '@documenso/ui/primitives/use-toast';
+
+const ZCreateTemplateFormSchema = z.object({
+ name: z.string(),
+});
+
+type TCreateTemplateFormSchema = z.infer<typeof ZCreateTemplateFormSchema>;
+
+export const NewTemplateDialog = () => {
+ const router = useRouter();
+ const { toast } = useToast();
+ const form = useForm<TCreateTemplateFormSchema>({
+ resolver: zodResolver(ZCreateTemplateFormSchema),
+ defaultValues: {
+ name: '',
+ },
+ });
+
+ const { mutateAsync: createTemplate, isLoading: isCreatingTemplate } =
+ trpc.template.createTemplate.useMutation();
+
+ const [showNewTemplateDialog, setShowNewTemplateDialog] = useState(false);
+ const [uploadedFile, setUploadedFile] = useState<{ file: File; fileBase64: string } | null>();
+
+ const onFileDrop = async (file: File) => {
+ try {
+ const arrayBuffer = await file.arrayBuffer();
+ const base64String = base64.encode(new Uint8Array(arrayBuffer));
+
+ setUploadedFile({
+ file,
+ fileBase64: `data:application/pdf;base64,${base64String}`,
+ });
+
+ if (!form.getValues('name')) {
+ form.setValue('name', file.name);
+ }
+ } catch {
+ toast({
+ title: 'Something went wrong',
+ description: 'Please try again later.',
+ variant: 'destructive',
+ });
+ }
+ };
+
+ const onSubmit = async (values: TCreateTemplateFormSchema) => {
+ if (!uploadedFile) {
+ return;
+ }
+
+ const file: File = uploadedFile.file;
+
+ try {
+ const { type, data } = await putFile(file);
+
+ const { id: templateDocumentDataId } = await createDocumentData({
+ type,
+ data,
+ });
+
+ const { id } = await createTemplate({
+ title: values.name ? values.name : file.name,
+ templateDocumentDataId,
+ });
+
+ toast({
+ title: 'Template document uploaded',
+ description:
+ 'Your document has been uploaded successfully. You will be redirected to the template page.',
+ duration: 5000,
+ });
+
+ setShowNewTemplateDialog(false);
+
+ void router.push(`/templates/${id}`);
+ } catch {
+ toast({
+ title: 'Something went wrong',
+ description: 'Please try again later.',
+ variant: 'destructive',
+ });
+ }
+ };
+
+ const resetForm = () => {
+ if (form.getValues('name') === uploadedFile?.file.name) {
+ form.reset();
+ }
+
+ setUploadedFile(null);
+ };
+
+ return (
+ <Dialog open={showNewTemplateDialog} onOpenChange={setShowNewTemplateDialog}>
+ <DialogTrigger asChild>
+ <Button className="cursor-pointer">
+ <>
+ <FilePlus className="-ml-1 mr-2 h-4 w-4" />
+ New Template
+ </>
+ </Button>
+ </DialogTrigger>
+ <DialogContent className="w-full max-w-xl">
+ <DialogHeader>
+ <DialogTitle className="mb-4">New Template</DialogTitle>
+ </DialogHeader>
+ <DialogDescription asChild>
+ <Form {...form}>
+ <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-4">
+ <FormField
+ control={form.control}
+ name="name"
+ render={({ field }) => (
+ <FormItem>
+ <FormLabel>Name your template</FormLabel>
+ <FormControl>
+ <Input id="email" type="text" className="bg-background mt-1.5" {...field} />
+ </FormControl>
+ <FormDescription>
+ <span className="text-muted-foreground text-xs">
+ Leave this empty if you would like to use your document's name for the
+ template
+ </span>
+ </FormDescription>
+ <FormMessage />
+ </FormItem>
+ )}
+ />
+
+ <div>
+ <Label htmlFor="template">Upload a Document</Label>
+ <div className="my-3">
+ {uploadedFile ? (
+ <Card gradient className="h-[40vh]">
+ <CardContent className="flex h-full flex-col items-center justify-center p-2">
+ <div
+ onClick={() => resetForm()}
+ className="absolute right-2 top-2 rounded-sm opacity-70 transition-opacity hover:opacity-100 focus:outline-none disabled:pointer-events-none"
+ >
+ <X className="h-5 w-5" />
+ <span className="sr-only">Remove Template</span>
+ </div>
+
+ <div className="border-muted-foreground/20 group-hover:border-documenso/80 dark:bg-muted/80 z-10 flex aspect-[3/4] w-24 flex-col gap-y-1 rounded-lg border bg-white/80 px-2 py-4 backdrop-blur-sm">
+ <div className="bg-muted-foreground/20 group-hover:bg-documenso h-2 w-full rounded-[2px]" />
+ <div className="bg-muted-foreground/20 group-hover:bg-documenso h-2 w-5/6 rounded-[2px]" />
+ <div className="bg-muted-foreground/20 group-hover:bg-documenso h-2 w-full rounded-[2px]" />
+ </div>
+ <p className="group-hover:text-foreground text-muted-foreground mt-4 font-medium">
+ Uploaded Document
+ </p>
+
+ <span className="text-muted-foreground/80 mt-1 text-sm">
+ {uploadedFile.file.name}
+ </span>
+ </CardContent>
+ </Card>
+ ) : (
+ <DocumentDropzone
+ className="mt-1.5 h-[40vh]"
+ onDrop={onFileDrop}
+ type="template"
+ />
+ )}
+ </div>
+ </div>
+
+ <div className="flex w-full justify-end">
+ <Button loading={isCreatingTemplate} type="submit">
+ Create Template
+ </Button>
+ </div>
+ </form>
+ </Form>
+ </DialogDescription>
+ </DialogContent>
+ </Dialog>
+ );
+};
diff --git a/apps/web/src/app/(dashboard)/templates/page.tsx b/apps/web/src/app/(dashboard)/templates/page.tsx
new file mode 100644
index 000000000..bc6a90b12
--- /dev/null
+++ b/apps/web/src/app/(dashboard)/templates/page.tsx
@@ -0,0 +1,49 @@
+import React from 'react';
+
+import { getRequiredServerComponentSession } from '@documenso/lib/next-auth/get-server-session';
+import { getTemplates } from '@documenso/lib/server-only/template/get-templates';
+
+import { TemplatesDataTable } from './data-table-templates';
+import { EmptyTemplateState } from './empty-state';
+import { NewTemplateDialog } from './new-template-dialog';
+
+type TemplatesPageProps = {
+ searchParams?: {
+ page?: number;
+ perPage?: number;
+ };
+};
+
+export default async function TemplatesPage({ searchParams = {} }: TemplatesPageProps) {
+ const { user } = await getRequiredServerComponentSession();
+ const page = Number(searchParams.page) || 1;
+ const perPage = Number(searchParams.perPage) || 10;
+
+ const { templates, totalPages } = await getTemplates({
+ userId: user.id,
+ page: page,
+ perPage: perPage,
+ });
+
+ return (
+ <div className="mx-auto max-w-screen-xl px-4 md:px-8">
+ <div className="flex items-center justify-between">
+ <h1 className="mb-5 mt-2 truncate text-2xl font-semibold md:text-3xl">Templates</h1>
+ <NewTemplateDialog />
+ </div>
+
+ <div className="relative">
+ {templates.length > 0 ? (
+ <TemplatesDataTable
+ templates={templates}
+ page={page}
+ perPage={perPage}
+ totalPages={totalPages}
+ />
+ ) : (
+ <EmptyTemplateState />
+ )}
+ </div>
+ </div>
+ );
+}
diff --git a/apps/web/src/components/(dashboard)/layout/desktop-nav.tsx b/apps/web/src/components/(dashboard)/layout/desktop-nav.tsx
index 76077cb04..bb3384d0a 100644
--- a/apps/web/src/components/(dashboard)/layout/desktop-nav.tsx
+++ b/apps/web/src/components/(dashboard)/layout/desktop-nav.tsx
@@ -3,6 +3,9 @@
import type { HTMLAttributes } from 'react';
import { useEffect, useState } from 'react';
+import Link from 'next/link';
+import { usePathname } from 'next/navigation';
+
import { Search } from 'lucide-react';
import { cn } from '@documenso/ui/lib/utils';
@@ -10,10 +13,22 @@ import { Button } from '@documenso/ui/primitives/button';
import { CommandMenu } from '../common/command-menu';
+const navigationLinks = [
+ {
+ href: '/documents',
+ label: 'Documents',
+ },
+ {
+ href: '/templates',
+ label: 'Templates',
+ },
+];
+
export type DesktopNavProps = HTMLAttributes<HTMLDivElement>;
export const DesktopNav = ({ className, ...props }: DesktopNavProps) => {
- // const pathname = usePathname();
+ const pathname = usePathname();
+
const [open, setOpen] = useState(false);
const [modifierKey, setModifierKey] = useState(() => 'Ctrl');
@@ -48,18 +63,20 @@ export const DesktopNav = ({ className, ...props }: DesktopNavProps) => {
</div>
</Button>
- {/* We have no other subpaths rn */}
- {/* <Link
- href="/documents"
- className={cn(
- 'text-muted-foreground focus-visible:ring-ring ring-offset-background rounded-md font-medium leading-5 hover:opacity-80 focus-visible:outline-none focus-visible:ring-2',
- {
- 'text-foreground': pathname?.startsWith('/documents'),
- },
- )}
- >
- Documents
- </Link> */}
+ {navigationLinks.map(({ href, label }) => (
+ <Link
+ key={href}
+ href={href}
+ className={cn(
+ 'text-muted-foreground dark:text-muted focus-visible:ring-ring ring-offset-background rounded-md font-medium leading-5 hover:opacity-80 focus-visible:outline-none focus-visible:ring-2',
+ {
+ 'text-foreground dark:text-muted-foreground': pathname?.startsWith(href),
+ },
+ )}
+ >
+ {label}
+ </Link>
+ ))}
</div>
);
};
diff --git a/apps/web/src/components/(dashboard)/layout/profile-dropdown.tsx b/apps/web/src/components/(dashboard)/layout/profile-dropdown.tsx
index e488ba6e9..2dcbb9864 100644
--- a/apps/web/src/components/(dashboard)/layout/profile-dropdown.tsx
+++ b/apps/web/src/components/(dashboard)/layout/profile-dropdown.tsx
@@ -4,6 +4,7 @@ import Link from 'next/link';
import {
CreditCard,
+ FileSpreadsheet,
Lock,
LogOut,
User as LucideUser,
@@ -106,6 +107,13 @@ export const ProfileDropdown = ({ user }: ProfileDropdownProps) => {
</DropdownMenuItem>
)}
+ <DropdownMenuSeparator />
+ <DropdownMenuItem asChild>
+ <Link href="/templates" className="cursor-pointer">
+ <FileSpreadsheet className="mr-2 h-4 w-4" />
+ Templates
+ </Link>
+ </DropdownMenuItem>
<DropdownMenuSeparator />
<DropdownMenuSub>
diff --git a/apps/web/src/components/formatter/template-type.tsx b/apps/web/src/components/formatter/template-type.tsx
new file mode 100644
index 000000000..a7f10105e
--- /dev/null
+++ b/apps/web/src/components/formatter/template-type.tsx
@@ -0,0 +1,50 @@
+import { HTMLAttributes } from 'react';
+
+import { Globe, Lock } from 'lucide-react';
+import type { LucideIcon } from 'lucide-react/dist/lucide-react';
+
+import { TemplateType as TemplateTypePrisma } from '@documenso/prisma/client';
+import { cn } from '@documenso/ui/lib/utils';
+
+type TemplateTypeIcon = {
+ label: string;
+ icon?: LucideIcon;
+ color: string;
+};
+
+type TemplateTypes = (typeof TemplateTypePrisma)[keyof typeof TemplateTypePrisma];
+
+const TEMPLATE_TYPES: Record<TemplateTypes, TemplateTypeIcon> = {
+ PRIVATE: {
+ label: 'Private',
+ icon: Lock,
+ color: 'text-blue-600 dark:text-blue-300',
+ },
+ PUBLIC: {
+ label: 'Public',
+ icon: Globe,
+ color: 'text-green-500 dark:text-green-300',
+ },
+};
+
+export type TemplateTypeProps = HTMLAttributes<HTMLSpanElement> & {
+ type: TemplateTypes;
+ inheritColor?: boolean;
+};
+
+export const TemplateType = ({ className, type, inheritColor, ...props }: TemplateTypeProps) => {
+ const { label, icon: Icon, color } = TEMPLATE_TYPES[type];
+
+ return (
+ <span className={cn('flex items-center', className)} {...props}>
+ {Icon && (
+ <Icon
+ className={cn('mr-2 inline-block h-4 w-4', {
+ [color]: !inheritColor,
+ })}
+ />
+ )}
+ {label}
+ </span>
+ );
+};
diff --git a/apps/web/src/components/forms/edit-template/add-template-fields.action.ts b/apps/web/src/components/forms/edit-template/add-template-fields.action.ts
new file mode 100644
index 000000000..2ee7ee825
--- /dev/null
+++ b/apps/web/src/components/forms/edit-template/add-template-fields.action.ts
@@ -0,0 +1,32 @@
+'use server';
+
+import { getRequiredServerComponentSession } from '@documenso/lib/next-auth/get-server-session';
+import { setFieldsForTemplate } from '@documenso/lib/server-only/field/set-fields-for-template';
+import { TAddTemplateFieldsFormSchema } from '@documenso/ui/primitives/template-flow/add-template-fields.types';
+
+export type AddTemplateFieldsActionInput = TAddTemplateFieldsFormSchema & {
+ templateId: number;
+};
+
+export const addTemplateFields = async ({ templateId, fields }: AddTemplateFieldsActionInput) => {
+ 'use server';
+
+ const { user } = await getRequiredServerComponentSession();
+
+ await setFieldsForTemplate({
+ userId: user.id,
+ templateId,
+ fields: fields.map((field) => ({
+ id: field.nativeId,
+ signerEmail: field.signerEmail,
+ signerId: field.signerId,
+ signerToken: field.signerToken,
+ type: field.type,
+ pageNumber: field.pageNumber,
+ pageX: field.pageX,
+ pageY: field.pageY,
+ pageWidth: field.pageWidth,
+ pageHeight: field.pageHeight,
+ })),
+ });
+};
diff --git a/apps/web/src/components/forms/edit-template/add-template-placeholders.action.ts b/apps/web/src/components/forms/edit-template/add-template-placeholders.action.ts
new file mode 100644
index 000000000..b2183eed1
--- /dev/null
+++ b/apps/web/src/components/forms/edit-template/add-template-placeholders.action.ts
@@ -0,0 +1,28 @@
+'use server';
+
+import { getRequiredServerComponentSession } from '@documenso/lib/next-auth/get-server-session';
+import { setRecipientsForTemplate } from '@documenso/lib/server-only/recipient/set-recipients-for-template';
+import { TAddTemplatePlacholderRecipientsFormSchema } from '@documenso/ui/primitives/template-flow/add-template-placeholder-recipients.types';
+
+export type AddTemplatePlaceholdersActionInput = TAddTemplatePlacholderRecipientsFormSchema & {
+ templateId: number;
+};
+
+export const addTemplatePlaceholders = async ({
+ templateId,
+ signers,
+}: AddTemplatePlaceholdersActionInput) => {
+ 'use server';
+
+ const { user } = await getRequiredServerComponentSession();
+
+ await setRecipientsForTemplate({
+ userId: user.id,
+ templateId,
+ recipients: signers.map((signer) => ({
+ id: signer.nativeId!,
+ email: signer.email,
+ name: signer.name!,
+ })),
+ });
+};
diff --git a/packages/lib/server-only/admin/get-recipients-stats.ts b/packages/lib/server-only/admin/get-recipients-stats.ts
index f24d0b5a2..b6663e988 100644
--- a/packages/lib/server-only/admin/get-recipients-stats.ts
+++ b/packages/lib/server-only/admin/get-recipients-stats.ts
@@ -19,9 +19,10 @@ export const getRecipientsStats = async () => {
results.forEach((result) => {
const { readStatus, signingStatus, sendStatus, _count } = result;
- stats[readStatus] += _count;
- stats[signingStatus] += _count;
- stats[sendStatus] += _count;
+ stats[readStatus as keyof typeof stats] += _count;
+ stats.TOTAL_RECIPIENTS += _count;
+ stats[signingStatus as keyof typeof stats] += _count;
+ stats[sendStatus as keyof typeof stats] += _count;
stats.TOTAL_RECIPIENTS += _count;
});
diff --git a/packages/lib/server-only/document/find-documents.ts b/packages/lib/server-only/document/find-documents.ts
index a27458a55..18600ebe6 100644
--- a/packages/lib/server-only/document/find-documents.ts
+++ b/packages/lib/server-only/document/find-documents.ts
@@ -8,7 +8,7 @@ import { ExtendedDocumentStatus } from '@documenso/prisma/types/extended-documen
import type { FindResultSet } from '../../types/find-result-set';
-export interface FindDocumentsOptions {
+export type FindDocumentsOptions = {
userId: number;
term?: string;
status?: ExtendedDocumentStatus;
@@ -19,7 +19,7 @@ export interface FindDocumentsOptions {
direction: 'asc' | 'desc';
};
period?: '' | '7d' | '14d' | '30d';
-}
+};
export const findDocuments = async ({
userId,
diff --git a/packages/lib/server-only/field/get-fields-for-template.ts b/packages/lib/server-only/field/get-fields-for-template.ts
new file mode 100644
index 000000000..c174d7eff
--- /dev/null
+++ b/packages/lib/server-only/field/get-fields-for-template.ts
@@ -0,0 +1,22 @@
+import { prisma } from '@documenso/prisma';
+
+export interface GetFieldsForTemplateOptions {
+ templateId: number;
+ userId: number;
+}
+
+export const getFieldsForTemplate = async ({ templateId, userId }: GetFieldsForTemplateOptions) => {
+ const fields = await prisma.field.findMany({
+ where: {
+ templateId,
+ Template: {
+ userId,
+ },
+ },
+ orderBy: {
+ id: 'asc',
+ },
+ });
+
+ return fields;
+};
diff --git a/packages/lib/server-only/field/remove-signed-field-with-token.ts b/packages/lib/server-only/field/remove-signed-field-with-token.ts
index 4a28e7627..ee472ec9f 100644
--- a/packages/lib/server-only/field/remove-signed-field-with-token.ts
+++ b/packages/lib/server-only/field/remove-signed-field-with-token.ts
@@ -27,6 +27,10 @@ export const removeSignedFieldWithToken = async ({
const { Document: document, Recipient: recipient } = field;
+ if (!document) {
+ throw new Error(`Document not found for field ${field.id}`);
+ }
+
if (document.status === DocumentStatus.COMPLETED) {
throw new Error(`Document ${document.id} has already been completed`);
}
diff --git a/packages/lib/server-only/field/set-fields-for-template.ts b/packages/lib/server-only/field/set-fields-for-template.ts
new file mode 100644
index 000000000..6e2e39afc
--- /dev/null
+++ b/packages/lib/server-only/field/set-fields-for-template.ts
@@ -0,0 +1,116 @@
+import { prisma } from '@documenso/prisma';
+import { FieldType } from '@documenso/prisma/client';
+
+export type Field = {
+ id?: number | null;
+ type: FieldType;
+ signerEmail: string;
+ signerId?: number;
+ pageNumber: number;
+ pageX: number;
+ pageY: number;
+ pageWidth: number;
+ pageHeight: number;
+};
+
+export type SetFieldsForTemplateOptions = {
+ userId: number;
+ templateId: number;
+ fields: Field[];
+};
+
+export const setFieldsForTemplate = async ({
+ userId,
+ templateId,
+ fields,
+}: SetFieldsForTemplateOptions) => {
+ const template = await prisma.template.findFirst({
+ where: {
+ id: templateId,
+ userId,
+ },
+ });
+
+ if (!template) {
+ throw new Error('Document not found');
+ }
+
+ const existingFields = await prisma.field.findMany({
+ where: {
+ templateId,
+ },
+ include: {
+ Recipient: true,
+ },
+ });
+
+ const removedFields = existingFields.filter(
+ (existingField) =>
+ !fields.find(
+ (field) =>
+ field.id === existingField.id || field.signerEmail === existingField.Recipient?.email,
+ ),
+ );
+
+ const linkedFields = fields.map((field) => {
+ const existing = existingFields.find((existingField) => existingField.id === field.id);
+
+ return {
+ ...field,
+ _persisted: existing,
+ };
+ });
+
+ const persistedFields = await prisma.$transaction(
+ // Disabling as wrapping promises here causes type issues
+ // eslint-disable-next-line @typescript-eslint/promise-function-async
+ linkedFields.map((field) =>
+ prisma.field.upsert({
+ where: {
+ id: field._persisted?.id ?? -1,
+ templateId,
+ },
+ update: {
+ page: field.pageNumber,
+ positionX: field.pageX,
+ positionY: field.pageY,
+ width: field.pageWidth,
+ height: field.pageHeight,
+ },
+ create: {
+ type: field.type,
+ page: field.pageNumber,
+ positionX: field.pageX,
+ positionY: field.pageY,
+ width: field.pageWidth,
+ height: field.pageHeight,
+ customText: '',
+ inserted: false,
+ Template: {
+ connect: {
+ id: templateId,
+ },
+ },
+ Recipient: {
+ connect: {
+ id: field.signerId,
+ email: field.signerEmail,
+ },
+ },
+ },
+ }),
+ ),
+ );
+
+ if (removedFields.length > 0) {
+ await prisma.field.deleteMany({
+ where: {
+ id: {
+ in: removedFields.map((field) => field.id),
+ },
+ },
+ });
+ }
+
+ return persistedFields;
+};
diff --git a/packages/lib/server-only/field/sign-field-with-token.ts b/packages/lib/server-only/field/sign-field-with-token.ts
index 6640a6a07..59fab71e5 100644
--- a/packages/lib/server-only/field/sign-field-with-token.ts
+++ b/packages/lib/server-only/field/sign-field-with-token.ts
@@ -33,6 +33,10 @@ export const signFieldWithToken = async ({
const { Document: document, Recipient: recipient } = field;
+ if (!document) {
+ throw new Error(`Document not found for field ${field.id}`);
+ }
+
if (document.status === DocumentStatus.COMPLETED) {
throw new Error(`Document ${document.id} has already been completed`);
}
diff --git a/packages/lib/server-only/recipient/get-recipients-for-template.ts b/packages/lib/server-only/recipient/get-recipients-for-template.ts
new file mode 100644
index 000000000..ab6f860eb
--- /dev/null
+++ b/packages/lib/server-only/recipient/get-recipients-for-template.ts
@@ -0,0 +1,25 @@
+import { prisma } from '@documenso/prisma';
+
+export interface GetRecipientsForTemplateOptions {
+ templateId: number;
+ userId: number;
+}
+
+export const getRecipientsForTemplate = async ({
+ templateId,
+ userId,
+}: GetRecipientsForTemplateOptions) => {
+ const recipients = await prisma.recipient.findMany({
+ where: {
+ templateId,
+ Template: {
+ userId,
+ },
+ },
+ orderBy: {
+ id: 'asc',
+ },
+ });
+
+ return recipients;
+};
diff --git a/packages/lib/server-only/recipient/set-recipients-for-template.ts b/packages/lib/server-only/recipient/set-recipients-for-template.ts
new file mode 100644
index 000000000..2145d47b4
--- /dev/null
+++ b/packages/lib/server-only/recipient/set-recipients-for-template.ts
@@ -0,0 +1,98 @@
+import { prisma } from '@documenso/prisma';
+
+import { nanoid } from '../../universal/id';
+
+export type SetRecipientsForTemplateOptions = {
+ userId: number;
+ templateId: number;
+ recipients: {
+ id?: number;
+ email: string;
+ name: string;
+ }[];
+};
+
+export const setRecipientsForTemplate = async ({
+ userId,
+ templateId,
+ recipients,
+}: SetRecipientsForTemplateOptions) => {
+ const template = await prisma.template.findFirst({
+ where: {
+ id: templateId,
+ userId,
+ },
+ });
+
+ if (!template) {
+ throw new Error('Template not found');
+ }
+
+ const normalizedRecipients = recipients.map((recipient) => ({
+ ...recipient,
+ email: recipient.email.toLowerCase(),
+ }));
+
+ const existingRecipients = await prisma.recipient.findMany({
+ where: {
+ templateId,
+ },
+ });
+
+ const removedRecipients = existingRecipients.filter(
+ (existingRecipient) =>
+ !normalizedRecipients.find(
+ (recipient) =>
+ recipient.id === existingRecipient.id || recipient.email === existingRecipient.email,
+ ),
+ );
+
+ const linkedRecipients = normalizedRecipients.map((recipient) => {
+ const existing = existingRecipients.find(
+ (existingRecipient) =>
+ existingRecipient.id === recipient.id || existingRecipient.email === recipient.email,
+ );
+
+ return {
+ ...recipient,
+ _persisted: existing,
+ };
+ });
+
+ const persistedRecipients = await prisma.$transaction(
+ // Disabling as wrapping promises here causes type issues
+ // eslint-disable-next-line @typescript-eslint/promise-function-async
+ linkedRecipients.map((recipient) =>
+ prisma.recipient.upsert({
+ where: {
+ id: recipient._persisted?.id ?? -1,
+ templateId,
+ },
+ update: {
+ name: recipient.name,
+ email: recipient.email,
+ templateId,
+ },
+ create: {
+ name: recipient.name,
+ email: recipient.email,
+ token: nanoid(),
+ templateToken: nanoid(),
+ templateId,
+ },
+ }),
+ ),
+ );
+
+ if (removedRecipients.length > 0) {
+ await prisma.recipient.deleteMany({
+ where: {
+ id: {
+ in: removedRecipients.map((recipient) => recipient.id),
+ },
+ },
+ });
+ }
+
+ return persistedRecipients;
+};
diff --git a/packages/lib/server-only/template/create-document-from-template.ts b/packages/lib/server-only/template/create-document-from-template.ts
new file mode 100644
index 000000000..b0589821f
--- /dev/null
+++ b/packages/lib/server-only/template/create-document-from-template.ts
@@ -0,0 +1,78 @@
+import { nanoid } from '@documenso/lib/universal/id';
+import { prisma } from '@documenso/prisma';
+import { TCreateDocumentFromTemplateMutationSchema } from '@documenso/trpc/server/template-router/schema';
+
+export type CreateDocumentFromTemplateOptions = TCreateDocumentFromTemplateMutationSchema & {
+ userId: number;
+};
+
+export const createDocumentFromTemplate = async ({
+ templateId,
+ userId,
+}: CreateDocumentFromTemplateOptions) => {
+ const template = await prisma.template.findUnique({
+ where: { id: templateId, userId },
+ include: {
+ Recipient: true,
+ Field: true,
+ templateDocumentData: true,
+ },
+ });
+
+ if (!template) {
+ throw new Error('Template not found.');
+ }
+
+ const documentData = await prisma.documentData.create({
+ data: {
+ type: template.templateDocumentData.type,
+ data: template.templateDocumentData.data,
+ initialData: template.templateDocumentData.initialData,
+ },
+ });
+
+ const document = await prisma.document.create({
+ data: {
+ userId,
+ title: template.title,
+ documentDataId: documentData.id,
+ Recipient: {
+ create: template.Recipient.map((recipient) => ({
+ email: recipient.email,
+ name: recipient.name,
+ token: nanoid(),
+ templateToken: recipient.templateToken,
+ })),
+ },
+ },
+
+ include: {
+ Recipient: true,
+ },
+ });
+
+ await prisma.field.createMany({
+ data: template.Field.map((field) => {
+ const recipient = template.Recipient.find((recipient) => recipient.id === field.recipientId);
+
+ const documentRecipient = document.Recipient.find(
+ (doc) => doc.templateToken === recipient?.templateToken,
+ );
+
+ return {
+ type: field.type,
+ page: field.page,
+ positionX: field.positionX,
+ positionY: field.positionY,
+ width: field.width,
+ height: field.height,
+ customText: field.customText,
+ inserted: field.inserted,
+ documentId: document.id,
+ recipientId: documentRecipient?.id || null,
+ };
+ }),
+ });
+
+ return document;
+};
diff --git a/packages/lib/server-only/template/create-template.ts b/packages/lib/server-only/template/create-template.ts
new file mode 100644
index 000000000..d00526a64
--- /dev/null
+++ b/packages/lib/server-only/template/create-template.ts
@@ -0,0 +1,20 @@
+import { prisma } from '@documenso/prisma';
+import { TCreateTemplateMutationSchema } from '@documenso/trpc/server/template-router/schema';
+
+export type CreateTemplateOptions = TCreateTemplateMutationSchema & {
+ userId: number;
+};
+
+export const createTemplate = async ({
+ title,
+ userId,
+ templateDocumentDataId,
+}: CreateTemplateOptions) => {
+ return await prisma.template.create({
+ data: {
+ title,
+ userId,
+ templateDocumentDataId,
+ },
+ });
+};
diff --git a/packages/lib/server-only/template/delete-template.ts b/packages/lib/server-only/template/delete-template.ts
new file mode 100644
index 000000000..f693bcec0
--- /dev/null
+++ b/packages/lib/server-only/template/delete-template.ts
@@ -0,0 +1,12 @@
+'use server';
+
+import { prisma } from '@documenso/prisma';
+
+export type DeleteTemplateOptions = {
+ id: number;
+ userId: number;
+};
+
+export const deleteTemplate = async ({ id, userId }: DeleteTemplateOptions) => {
+ return await prisma.template.delete({ where: { id, userId } });
+};
diff --git a/packages/lib/server-only/template/duplicate-template.ts b/packages/lib/server-only/template/duplicate-template.ts
new file mode 100644
index 000000000..14806707b
--- /dev/null
+++ b/packages/lib/server-only/template/duplicate-template.ts
@@ -0,0 +1,75 @@
+import { nanoid } from '@documenso/lib/universal/id';
+import { prisma } from '@documenso/prisma';
+import { TDuplicateTemplateMutationSchema } from '@documenso/trpc/server/template-router/schema';
+
+export type DuplicateTemplateOptions = TDuplicateTemplateMutationSchema & {
+ userId: number;
+};
+
+export const duplicateTemplate = async ({ templateId, userId }: DuplicateTemplateOptions) => {
+ const template = await prisma.template.findUnique({
+ where: { id: templateId, userId },
+ include: {
+ Recipient: true,
+ Field: true,
+ templateDocumentData: true,
+ },
+ });
+
+ if (!template) {
+ throw new Error('Template not found.');
+ }
+
+ const documentData = await prisma.documentData.create({
+ data: {
+ type: template.templateDocumentData.type,
+ data: template.templateDocumentData.data,
+ initialData: template.templateDocumentData.initialData,
+ },
+ });
+
+ const duplicatedTemplate = await prisma.template.create({
+ data: {
+ userId,
+ title: template.title + ' (copy)',
+ templateDocumentDataId: documentData.id,
+ Recipient: {
+ create: template.Recipient.map((recipient) => ({
+ email: recipient.email,
+ name: recipient.name,
+ token: nanoid(),
+ templateToken: recipient.templateToken,
+ })),
+ },
+ },
+
+ include: {
+ Recipient: true,
+ },
+ });
+
+ await prisma.field.createMany({
+ data: template.Field.map((field) => {
+ const recipient = template.Recipient.find((recipient) => recipient.id === field.recipientId);
+
+ const duplicatedTemplateRecipient = duplicatedTemplate.Recipient.find(
+ (doc) => doc.templateToken === recipient?.templateToken,
+ );
+
+ return {
+ type: field.type,
+ page: field.page,
+ positionX: field.positionX,
+ positionY: field.positionY,
+ width: field.width,
+ height: field.height,
+ customText: field.customText,
+ inserted: field.inserted,
+ templateId: duplicatedTemplate.id,
+ recipientId: duplicatedTemplateRecipient?.id || null,
+ };
+ }),
+ });
+
+ return duplicatedTemplate;
+};
diff --git a/packages/lib/server-only/template/get-template-by-id.ts b/packages/lib/server-only/template/get-template-by-id.ts
new file mode 100644
index 000000000..56f959a9b
--- /dev/null
+++ b/packages/lib/server-only/template/get-template-by-id.ts
@@ -0,0 +1,18 @@
+import { prisma } from '@documenso/prisma';
+
+export interface GetTemplateByIdOptions {
+ id: number;
+ userId: number;
+}
+
+export const getTemplateById = async ({ id, userId }: GetTemplateByIdOptions) => {
+ return await prisma.template.findFirstOrThrow({
+ where: {
+ id,
+ userId,
+ },
+ include: {
+ templateDocumentData: true,
+ },
+ });
+};
diff --git a/packages/lib/server-only/template/get-templates.ts b/packages/lib/server-only/template/get-templates.ts
new file mode 100644
index 000000000..60de7cd89
--- /dev/null
+++ b/packages/lib/server-only/template/get-templates.ts
@@ -0,0 +1,37 @@
+import { prisma } from '@documenso/prisma';
+
+export type GetTemplatesOptions = {
+ userId: number;
+ page: number;
+ perPage: number;
+};
+
+export const getTemplates = async ({ userId, page = 1, perPage = 10 }: GetTemplatesOptions) => {
+ const [templates, count] = await Promise.all([
+ await prisma.template.findMany({
+ where: {
+ userId,
+ },
+ include: {
+ templateDocumentData: true,
+ Field: true,
+ },
+ skip: Math.max(page - 1, 0) * perPage,
+ orderBy: {
+ createdAt: 'desc',
+ },
+ }),
+ await prisma.template.count({
+ where: {
+ User: {
+ id: userId,
+ },
+ },
+ }),
+ ]);
+
+ return {
+ templates,
+ totalPages: Math.ceil(count / perPage),
+ };
+};
diff --git a/packages/prisma/migrations/20231007013737_templates/migration.sql b/packages/prisma/migrations/20231007013737_templates/migration.sql
new file mode 100644
index 000000000..e0c1bf4ec
--- /dev/null
+++ b/packages/prisma/migrations/20231007013737_templates/migration.sql
@@ -0,0 +1,52 @@
+-- CreateEnum
+CREATE TYPE "TemplateStatus" AS ENUM ('PUBLIC', 'PRIVATE');
+
+-- CreateTable
+CREATE TABLE "Template" (
+ "id" SERIAL NOT NULL,
+ "userId" INTEGER NOT NULL,
+ "title" TEXT NOT NULL,
+ "description" TEXT,
+ "status" "TemplateStatus" NOT NULL DEFAULT 'PRIVATE',
+ "templateDataId" TEXT NOT NULL,
+
+ CONSTRAINT "Template_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "TemplateData" (
+ "id" TEXT NOT NULL,
+ "type" "DocumentDataType" NOT NULL,
+ "data" TEXT NOT NULL,
+ "initialData" TEXT NOT NULL,
+
+ CONSTRAINT "TemplateData_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "TemplateField" (
+ "id" SERIAL NOT NULL,
+ "templateId" INTEGER NOT NULL,
+ "type" "FieldType" NOT NULL,
+ "page" INTEGER NOT NULL,
+ "positionX" DECIMAL(65,30) NOT NULL DEFAULT 0,
+ "positionY" DECIMAL(65,30) NOT NULL DEFAULT 0,
+ "width" DECIMAL(65,30) NOT NULL DEFAULT -1,
+ "height" DECIMAL(65,30) NOT NULL DEFAULT -1,
+ "customText" TEXT NOT NULL,
+ "inserted" BOOLEAN NOT NULL,
+
+ CONSTRAINT "TemplateField_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Template_templateDataId_key" ON "Template"("templateDataId");
+
+-- AddForeignKey
+ALTER TABLE "Template" ADD CONSTRAINT "Template_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Template" ADD CONSTRAINT "Template_templateDataId_fkey" FOREIGN KEY ("templateDataId") REFERENCES "TemplateData"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "TemplateField" ADD CONSTRAINT "TemplateField_templateId_fkey" FOREIGN KEY ("templateId") REFERENCES "Template"("id") ON DELETE CASCADE ON UPDATE CASCADE;
diff --git a/packages/prisma/migrations/20231007014431_templates_type/migration.sql b/packages/prisma/migrations/20231007014431_templates_type/migration.sql
new file mode 100644
index 000000000..c89e09a61
--- /dev/null
+++ b/packages/prisma/migrations/20231007014431_templates_type/migration.sql
@@ -0,0 +1,15 @@
+/*
+ Warnings:
+
+ - The `status` column on the `Template` table would be dropped and recreated. This will lead to data loss if there is data in the column.
+
+*/
+-- CreateEnum
+CREATE TYPE "TemplateType" AS ENUM ('PUBLIC', 'PRIVATE');
+
+-- AlterTable
+ALTER TABLE "Template" DROP COLUMN "status",
+ADD COLUMN "status" "TemplateType" NOT NULL DEFAULT 'PRIVATE';
+
+-- DropEnum
+DROP TYPE "TemplateStatus";
diff --git a/packages/prisma/migrations/20231007021427_reuse_document_data/migration.sql b/packages/prisma/migrations/20231007021427_reuse_document_data/migration.sql
new file mode 100644
index 000000000..629f292fc
--- /dev/null
+++ b/packages/prisma/migrations/20231007021427_reuse_document_data/migration.sql
@@ -0,0 +1,14 @@
+/*
+ Warnings:
+
+ - You are about to drop the `TemplateData` table. If the table is not empty, all the data it contains will be lost.
+
+*/
+-- DropForeignKey
+ALTER TABLE "Template" DROP CONSTRAINT "Template_templateDataId_fkey";
+
+-- DropTable
+DROP TABLE "TemplateData";
+
+-- AddForeignKey
+ALTER TABLE "Template" ADD CONSTRAINT "Template_templateDataId_fkey" FOREIGN KEY ("templateDataId") REFERENCES "DocumentData"("id") ON DELETE CASCADE ON UPDATE CASCADE;
diff --git a/packages/prisma/migrations/20231007033447_remove_inserted_on_template_field/migration.sql b/packages/prisma/migrations/20231007033447_remove_inserted_on_template_field/migration.sql
new file mode 100644
index 000000000..25ace4f72
--- /dev/null
+++ b/packages/prisma/migrations/20231007033447_remove_inserted_on_template_field/migration.sql
@@ -0,0 +1,8 @@
+/*
+ Warnings:
+
+ - You are about to drop the column `inserted` on the `TemplateField` table. All the data in the column will be lost.
+
+*/
+-- AlterTable
+ALTER TABLE "TemplateField" DROP COLUMN "inserted";
diff --git a/packages/prisma/migrations/20231007080315_document_name_to_template/migration.sql b/packages/prisma/migrations/20231007080315_document_name_to_template/migration.sql
new file mode 100644
index 000000000..45a52de3d
--- /dev/null
+++ b/packages/prisma/migrations/20231007080315_document_name_to_template/migration.sql
@@ -0,0 +1,8 @@
+/*
+ Warnings:
+
+ - Added the required column `documentName` to the `Template` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- AlterTable
+ALTER TABLE "Template" ADD COLUMN "documentName" TEXT NOT NULL;
diff --git a/packages/prisma/migrations/20231007211915_template_created_date/migration.sql b/packages/prisma/migrations/20231007211915_template_created_date/migration.sql
new file mode 100644
index 000000000..816da092e
--- /dev/null
+++ b/packages/prisma/migrations/20231007211915_template_created_date/migration.sql
@@ -0,0 +1,9 @@
+/*
+ Warnings:
+
+ - Added the required column `updatedAt` to the `Template` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- AlterTable
+ALTER TABLE "Template" ADD COLUMN "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+ADD COLUMN "updatedAt" TIMESTAMP(3) NOT NULL;
diff --git a/packages/prisma/migrations/20231017041643_placeholder_recipients/migration.sql b/packages/prisma/migrations/20231017041643_placeholder_recipients/migration.sql
new file mode 100644
index 000000000..b84a567c8
--- /dev/null
+++ b/packages/prisma/migrations/20231017041643_placeholder_recipients/migration.sql
@@ -0,0 +1,51 @@
+/*
+ Warnings:
+
+ - You are about to drop the column `description` on the `Template` table. All the data in the column will be lost.
+ - You are about to drop the column `documentName` on the `Template` table. All the data in the column will be lost.
+ - You are about to drop the column `status` on the `Template` table. All the data in the column will be lost.
+ - You are about to drop the column `templateDataId` on the `Template` table. All the data in the column will be lost.
+ - A unique constraint covering the columns `[tempateDocumentDataId]` on the table `Template` will be added. If there are existing duplicate values, this will fail.
+ - Added the required column `tempateDocumentDataId` to the `Template` table without a default value. This is not possible if the table is not empty.
+ - Added the required column `inserted` to the `TemplateField` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- DropForeignKey
+ALTER TABLE "Template" DROP CONSTRAINT "Template_templateDataId_fkey";
+
+-- DropIndex
+DROP INDEX "Template_templateDataId_key";
+
+-- AlterTable
+ALTER TABLE "Template" DROP COLUMN "description",
+DROP COLUMN "documentName",
+DROP COLUMN "status",
+DROP COLUMN "templateDataId",
+ADD COLUMN "tempateDocumentDataId" TEXT NOT NULL,
+ADD COLUMN "type" "TemplateType" NOT NULL DEFAULT 'PRIVATE',
+ALTER COLUMN "updatedAt" SET DEFAULT CURRENT_TIMESTAMP;
+
+-- AlterTable
+ALTER TABLE "TemplateField" ADD COLUMN "inserted" BOOLEAN NOT NULL,
+ADD COLUMN "recipientId" INTEGER;
+
+-- CreateTable
+CREATE TABLE "TemplateRecipient" (
+ "id" SERIAL NOT NULL,
+ "templateId" INTEGER NOT NULL,
+ "placeholder" VARCHAR(255) NOT NULL,
+
+ CONSTRAINT "TemplateRecipient_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Template_tempateDocumentDataId_key" ON "Template"("tempateDocumentDataId");
+
+-- AddForeignKey
+ALTER TABLE "Template" ADD CONSTRAINT "Template_tempateDocumentDataId_fkey" FOREIGN KEY ("tempateDocumentDataId") REFERENCES "DocumentData"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "TemplateRecipient" ADD CONSTRAINT "TemplateRecipient_templateId_fkey" FOREIGN KEY ("templateId") REFERENCES "Template"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "TemplateField" ADD CONSTRAINT "TemplateField_recipientId_fkey" FOREIGN KEY ("recipientId") REFERENCES "TemplateRecipient"("id") ON DELETE CASCADE ON UPDATE CASCADE;
diff --git a/packages/prisma/migrations/20231017042227_fix_typo/migration.sql b/packages/prisma/migrations/20231017042227_fix_typo/migration.sql
new file mode 100644
index 000000000..ac9eaf10e
--- /dev/null
+++ b/packages/prisma/migrations/20231017042227_fix_typo/migration.sql
@@ -0,0 +1,23 @@
+/*
+ Warnings:
+
+ - You are about to drop the column `tempateDocumentDataId` on the `Template` table. All the data in the column will be lost.
+ - A unique constraint covering the columns `[templateDocumentDataId]` on the table `Template` will be added. If there are existing duplicate values, this will fail.
+ - Added the required column `templateDocumentDataId` to the `Template` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- DropForeignKey
+ALTER TABLE "Template" DROP CONSTRAINT "Template_tempateDocumentDataId_fkey";
+
+-- DropIndex
+DROP INDEX "Template_tempateDocumentDataId_key";
+
+-- AlterTable
+ALTER TABLE "Template" DROP COLUMN "tempateDocumentDataId",
+ADD COLUMN "templateDocumentDataId" TEXT NOT NULL;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Template_templateDocumentDataId_key" ON "Template"("templateDocumentDataId");
+
+-- AddForeignKey
+ALTER TABLE "Template" ADD CONSTRAINT "Template_templateDocumentDataId_fkey" FOREIGN KEY ("templateDocumentDataId") REFERENCES "DocumentData"("id") ON DELETE CASCADE ON UPDATE CASCADE;
diff --git a/packages/prisma/migrations/20231019043226_template_recipient_email/migration.sql b/packages/prisma/migrations/20231019043226_template_recipient_email/migration.sql
new file mode 100644
index 000000000..266333794
--- /dev/null
+++ b/packages/prisma/migrations/20231019043226_template_recipient_email/migration.sql
@@ -0,0 +1,8 @@
+/*
+ Warnings:
+
+ - Added the required column `email` to the `TemplateRecipient` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- AlterTable
+ALTER TABLE "TemplateRecipient" ADD COLUMN "email" VARCHAR(255) NOT NULL;
diff --git a/packages/prisma/migrations/20231020032507_template_recipient_token/migration.sql b/packages/prisma/migrations/20231020032507_template_recipient_token/migration.sql
new file mode 100644
index 000000000..9ce1fa70a
--- /dev/null
+++ b/packages/prisma/migrations/20231020032507_template_recipient_token/migration.sql
@@ -0,0 +1,8 @@
+/*
+ Warnings:
+
+ - Added the required column `token` to the `TemplateRecipient` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- AlterTable
+ALTER TABLE "TemplateRecipient" ADD COLUMN "token" TEXT NOT NULL;
diff --git a/packages/prisma/migrations/20231021193915_template_token_for_recipient/migration.sql b/packages/prisma/migrations/20231021193915_template_token_for_recipient/migration.sql
new file mode 100644
index 000000000..a6b3e7199
--- /dev/null
+++ b/packages/prisma/migrations/20231021193915_template_token_for_recipient/migration.sql
@@ -0,0 +1,5 @@
+-- AlterTable
+ALTER TABLE "Recipient" ADD COLUMN "templateToken" TEXT;
+
+-- AlterTable
+ALTER TABLE "TemplateRecipient" ADD COLUMN "templateToken" TEXT;
diff --git a/packages/prisma/migrations/20231030061522_recipient_name_not_placeholder/migration.sql b/packages/prisma/migrations/20231030061522_recipient_name_not_placeholder/migration.sql
new file mode 100644
index 000000000..8b9275c68
--- /dev/null
+++ b/packages/prisma/migrations/20231030061522_recipient_name_not_placeholder/migration.sql
@@ -0,0 +1,10 @@
+/*
+ Warnings:
+
+ - You are about to drop the column `placeholder` on the `TemplateRecipient` table. All the data in the column will be lost.
+ - Added the required column `name` to the `TemplateRecipient` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- AlterTable
+ALTER TABLE "TemplateRecipient" DROP COLUMN "placeholder",
+ADD COLUMN "name" VARCHAR(255) NOT NULL;
diff --git a/packages/prisma/migrations/20231208090322_remove_template_specific_models/migration.sql b/packages/prisma/migrations/20231208090322_remove_template_specific_models/migration.sql
new file mode 100644
index 000000000..7e2af3ef8
--- /dev/null
+++ b/packages/prisma/migrations/20231208090322_remove_template_specific_models/migration.sql
@@ -0,0 +1,54 @@
+/*
+ Warnings:
+
+ - You are about to drop the `TemplateField` table. If the table is not empty, all the data it contains will be lost.
+ - You are about to drop the `TemplateRecipient` table. If the table is not empty, all the data it contains will be lost.
+ - A unique constraint covering the columns `[templateId,email]` on the table `Recipient` will be added. If there are existing duplicate values, this will fail.
+
+*/
+-- DropForeignKey
+ALTER TABLE "Field" DROP CONSTRAINT "Field_recipientId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "TemplateField" DROP CONSTRAINT "TemplateField_recipientId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "TemplateField" DROP CONSTRAINT "TemplateField_templateId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "TemplateRecipient" DROP CONSTRAINT "TemplateRecipient_templateId_fkey";
+
+-- AlterTable
+ALTER TABLE "Field" ADD COLUMN "templateId" INTEGER,
+ALTER COLUMN "documentId" DROP NOT NULL;
+
+-- AlterTable
+ALTER TABLE "Recipient" ADD COLUMN "templateId" INTEGER,
+ALTER COLUMN "documentId" DROP NOT NULL,
+ALTER COLUMN "readStatus" DROP NOT NULL,
+ALTER COLUMN "signingStatus" DROP NOT NULL,
+ALTER COLUMN "sendStatus" DROP NOT NULL;
+
+-- DropTable
+DROP TABLE "TemplateField";
+
+-- DropTable
+DROP TABLE "TemplateRecipient";
+
+-- CreateIndex
+CREATE INDEX "Field_templateId_idx" ON "Field"("templateId");
+
+-- CreateIndex
+CREATE INDEX "Recipient_templateId_idx" ON "Recipient"("templateId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Recipient_templateId_email_key" ON "Recipient"("templateId", "email");
+
+-- AddForeignKey
+ALTER TABLE "Recipient" ADD CONSTRAINT "Recipient_templateId_fkey" FOREIGN KEY ("templateId") REFERENCES "Template"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Field" ADD CONSTRAINT "Field_templateId_fkey" FOREIGN KEY ("templateId") REFERENCES "Template"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Field" ADD CONSTRAINT "Field_recipientId_fkey" FOREIGN KEY ("recipientId") REFERENCES "Recipient"("id") ON DELETE SET NULL ON UPDATE CASCADE;
diff --git a/packages/prisma/schema.prisma b/packages/prisma/schema.prisma
index 75c175adc..d21c4c637 100644
--- a/packages/prisma/schema.prisma
+++ b/packages/prisma/schema.prisma
@@ -40,6 +40,7 @@ model User {
twoFactorEnabled Boolean @default(false)
twoFactorBackupCodes String?
VerificationToken VerificationToken[]
+ Template Template[]
@@index([email])
}
@@ -154,6 +155,7 @@ model DocumentData {
data String
initialData String
Document Document?
+ Template Template?
}
model DocumentMeta {
@@ -180,22 +182,27 @@ enum SigningStatus {
}
model Recipient {
- id Int @id @default(autoincrement())
- documentId Int
- email String @db.VarChar(255)
- name String @default("") @db.VarChar(255)
+ id Int @id @default(autoincrement())
+ documentId Int?
+ templateId Int?
+ email String @db.VarChar(255)
+ name String @default("") @db.VarChar(255)
token String
+ templateToken String?
expired DateTime?
signedAt DateTime?
- readStatus ReadStatus @default(NOT_OPENED)
- signingStatus SigningStatus @default(NOT_SIGNED)
- sendStatus SendStatus @default(NOT_SENT)
- Document Document @relation(fields: [documentId], references: [id], onDelete: Cascade)
+ readStatus ReadStatus? @default(NOT_OPENED)
+ signingStatus SigningStatus? @default(NOT_SIGNED)
+ sendStatus SendStatus? @default(NOT_SENT)
+ Document Document? @relation(fields: [documentId], references: [id], onDelete: Cascade)
+ Template Template? @relation(fields: [templateId], references: [id], onDelete: Cascade)
Field Field[]
Signature Signature[]
@@unique([documentId, email])
+ @@unique([templateId, email])
@@index([documentId])
+ @@index([templateId])
@@index([token])
}
@@ -210,7 +217,8 @@ enum FieldType {
model Field {
id Int @id @default(autoincrement())
- documentId Int
+ documentId Int?
+ templateId Int?
recipientId Int?
type FieldType
page Int
@@ -220,11 +228,13 @@ model Field {
height Decimal @default(-1)
customText String
inserted Boolean
- Document Document @relation(fields: [documentId], references: [id], onDelete: Cascade)
- Recipient Recipient? @relation(fields: [recipientId], references: [id], onDelete: Cascade)
+ Document Document? @relation(fields: [documentId], references: [id], onDelete: Cascade)
+ Template Template? @relation(fields: [templateId], references: [id], onDelete: Cascade)
+ Recipient Recipient? @relation(fields: [recipientId], references: [id])
Signature Signature?
@@index([documentId])
+ @@index([templateId])
@@index([recipientId])
}
@@ -254,3 +264,24 @@ model DocumentShareLink {
@@unique([documentId, email])
}
+
+enum TemplateType {
+ PUBLIC
+ PRIVATE
+}
+
+model Template {
+ id Int @id @default(autoincrement())
+ userId Int
+ User User @relation(fields: [userId], references: [id], onDelete: Cascade)
+ title String
+ type TemplateType @default(PRIVATE)
+ templateDocumentDataId String
+ templateDocumentData DocumentData @relation(fields: [templateDocumentDataId], references: [id], onDelete: Cascade)
+ createdAt DateTime @default(now())
+ updatedAt DateTime @default(now()) @updatedAt
+ Recipient Recipient[]
+ Field Field[]
+
+ @@unique([templateDocumentDataId])
+}
diff --git a/packages/trpc/server/router.ts b/packages/trpc/server/router.ts
index bf8a03ce1..77d18e06d 100644
--- a/packages/trpc/server/router.ts
+++ b/packages/trpc/server/router.ts
@@ -6,6 +6,7 @@ import { profileRouter } from './profile-router/router';
import { recipientRouter } from './recipient-router/router';
import { shareLinkRouter } from './share-link-router/router';
import { singleplayerRouter } from './singleplayer-router/router';
+import { templateRouter } from './template-router/router';
import { router } from './trpc';
import { twoFactorAuthenticationRouter } from './two-factor-authentication-router/router';
@@ -19,6 +20,7 @@ export const appRouter = router({
shareLink: shareLinkRouter,
singleplayer: singleplayerRouter,
twoFactorAuthentication: twoFactorAuthenticationRouter,
+ template: templateRouter,
});
export type AppRouter = typeof appRouter;
diff --git a/packages/trpc/server/template-router/router.ts b/packages/trpc/server/template-router/router.ts
new file mode 100644
index 000000000..e18f4cb4a
--- /dev/null
+++ b/packages/trpc/server/template-router/router.ts
@@ -0,0 +1,94 @@
+import { TRPCError } from '@trpc/server';
+
+import { createDocumentFromTemplate } from '@documenso/lib/server-only/template/create-document-from-template';
+import { createTemplate } from '@documenso/lib/server-only/template/create-template';
+import { deleteTemplate } from '@documenso/lib/server-only/template/delete-template';
+import { duplicateTemplate } from '@documenso/lib/server-only/template/duplicate-template';
+
+import { authenticatedProcedure, router } from '../trpc';
+import {
+ ZCreateDocumentFromTemplateMutationSchema,
+ ZCreateTemplateMutationSchema,
+ ZDeleteTemplateMutationSchema,
+ ZDuplicateTemplateMutationSchema,
+} from './schema';
+
+export const templateRouter = router({
+ createTemplate: authenticatedProcedure
+ .input(ZCreateTemplateMutationSchema)
+ .mutation(async ({ input, ctx }) => {
+ try {
+ const { title, templateDocumentDataId } = input;
+
+ return await createTemplate({
+ title,
+ userId: ctx.user.id,
+ templateDocumentDataId,
+ });
+ } catch (err) {
+ console.error(err);
+
+ throw new TRPCError({
+ code: 'BAD_REQUEST',
+ message: 'We were unable to create this template. Please try again later.',
+ });
+ }
+ }),
+
+ createDocumentFromTemplate: authenticatedProcedure
+ .input(ZCreateDocumentFromTemplateMutationSchema)
+ .mutation(async ({ input, ctx }) => {
+ try {
+ const { templateId } = input;
+
+ return await createDocumentFromTemplate({
+ templateId,
+ userId: ctx.user.id,
+ });
+ } catch (err) {
+ throw new TRPCError({
+ code: 'BAD_REQUEST',
+ message: 'We were unable to create this document. Please try again later.',
+ });
+ }
+ }),
+
+ duplicateTemplate: authenticatedProcedure
+ .input(ZDuplicateTemplateMutationSchema)
+ .mutation(async ({ input, ctx }) => {
+ try {
+ const { templateId } = input;
+
+ return await duplicateTemplate({
+ templateId,
+ userId: ctx.user.id,
+ });
+ } catch (err) {
+ console.error(err);
+
+ throw new TRPCError({
+ code: 'BAD_REQUEST',
+ message: 'We were unable to duplicate the template. Please try again later.',
+ });
+ }
+ }),
+
+ deleteTemplate: authenticatedProcedure
+ .input(ZDeleteTemplateMutationSchema)
+ .mutation(async ({ input, ctx }) => {
+ try {
+ const { id } = input;
+
+ const userId = ctx.user.id;
+
+ return await deleteTemplate({ id, userId });
+ } catch (err) {
+ console.error(err);
+
+ throw new TRPCError({
+ code: 'BAD_REQUEST',
+ message: 'We were unable to delete this template. Please try again later.',
+ });
+ }
+ }),
+});
diff --git a/packages/trpc/server/template-router/schema.ts b/packages/trpc/server/template-router/schema.ts
new file mode 100644
index 000000000..bc7161f74
--- /dev/null
+++ b/packages/trpc/server/template-router/schema.ts
@@ -0,0 +1,26 @@
+import { z } from 'zod';
+
+export const ZCreateTemplateMutationSchema = z.object({
+ title: z.string().min(1),
+ templateDocumentDataId: z.string().min(1),
+});
+
+export const ZCreateDocumentFromTemplateMutationSchema = z.object({
+ templateId: z.number(),
+});
+
+export const ZDuplicateTemplateMutationSchema = z.object({
+ templateId: z.number(),
+});
+
+export const ZDeleteTemplateMutationSchema = z.object({
+ id: z.number().min(1),
+});
+
+export type TCreateTemplateMutationSchema = z.infer<typeof ZCreateTemplateMutationSchema>;
+export type TCreateDocumentFromTemplateMutationSchema = z.infer<
+ typeof ZCreateDocumentFromTemplateMutationSchema
+>;
+
+export type TDuplicateTemplateMutationSchema = z.infer<typeof ZDuplicateTemplateMutationSchema>;
+export type TDeleteTemplateMutationSchema = z.infer<typeof ZDeleteTemplateMutationSchema>;
diff --git a/packages/ui/primitives/document-dropzone.tsx b/packages/ui/primitives/document-dropzone.tsx
index d81a3a7de..9ae4c2adb 100644
--- a/packages/ui/primitives/document-dropzone.tsx
+++ b/packages/ui/primitives/document-dropzone.tsx
@@ -75,10 +75,20 @@ const DocumentDropzoneCardCenterVariants: Variants = {
},
};
+const DocumentDescription = {
+ document: {
+ headline: 'Add a document',
+ },
+ template: {
+ headline: 'Upload Template Document',
+ },
+};
+
export type DocumentDropzoneProps = {
className?: string;
disabled?: boolean;
onDrop?: (_file: File) => void | Promise<void>;
+ type?: 'document' | 'template';
[key: string]: unknown;
};
@@ -86,6 +96,7 @@ export const DocumentDropzone = ({
className,
onDrop,
disabled,
+ type = 'document',
...props
}: DocumentDropzoneProps) => {
const { getRootProps, getInputProps } = useDropzone({
@@ -157,7 +168,7 @@ export const DocumentDropzone = ({
<input {...getInputProps()} />
<p className="group-hover:text-foreground text-muted-foreground mt-8 font-medium">
- Add a document
+ {DocumentDescription[type].headline}
</p>
<p className="text-muted-foreground/80 mt-1 text-sm ">Drag & drop your document here.</p>
diff --git a/packages/ui/primitives/document-flow/types.ts b/packages/ui/primitives/document-flow/types.ts
index 677dc931b..82f5706e6 100644
--- a/packages/ui/primitives/document-flow/types.ts
+++ b/packages/ui/primitives/document-flow/types.ts
@@ -24,7 +24,7 @@ export const ZDocumentFlowFormSchema = z.object({
formId: z.string().min(1),
nativeId: z.number().optional(),
type: z.nativeEnum(FieldType),
- signerEmail: z.string().min(1),
+ signerEmail: z.string().min(1).optional(),
pageNumber: z.number().min(1),
pageX: z.number().min(0),
pageY: z.number().min(0),
diff --git a/packages/ui/primitives/template-flow/add-template-fields.tsx b/packages/ui/primitives/template-flow/add-template-fields.tsx
new file mode 100644
index 000000000..138c73ea7
--- /dev/null
+++ b/packages/ui/primitives/template-flow/add-template-fields.tsx
@@ -0,0 +1,539 @@
+'use client';
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+
+import { Caveat } from 'next/font/google';
+
+import { ChevronsUpDown } from 'lucide-react';
+import { useFieldArray, useForm } from 'react-hook-form';
+
+import { getBoundingClientRect } from '@documenso/lib/client-only/get-bounding-client-rect';
+import { useDocumentElement } from '@documenso/lib/client-only/hooks/use-document-element';
+import { PDF_VIEWER_PAGE_SELECTOR } from '@documenso/lib/constants/pdf-viewer';
+import { nanoid } from '@documenso/lib/universal/id';
+import { Field, FieldType, Recipient } from '@documenso/prisma/client';
+import { cn } from '@documenso/ui/lib/utils';
+import { Button } from '@documenso/ui/primitives/button';
+import { Card, CardContent } from '@documenso/ui/primitives/card';
+import {
+ Command,
+ CommandEmpty,
+ CommandGroup,
+ CommandInput,
+ CommandItem,
+} from '@documenso/ui/primitives/command';
+import {
+ DocumentFlowFormContainerActions,
+ DocumentFlowFormContainerContent,
+ DocumentFlowFormContainerFooter,
+ DocumentFlowFormContainerStep,
+} from '@documenso/ui/primitives/document-flow/document-flow-root';
+import { FieldItem } from '@documenso/ui/primitives/document-flow/field-item';
+import {
+ DocumentFlowStep,
+ FRIENDLY_FIELD_TYPE,
+} from '@documenso/ui/primitives/document-flow/types';
+import { Popover, PopoverContent, PopoverTrigger } from '@documenso/ui/primitives/popover';
+
+// import { Tooltip, TooltipContent, TooltipTrigger } from '@documenso/ui/primitives/tooltip';
+import { TAddTemplateFieldsFormSchema } from './add-template-fields.types';
+
+const fontCaveat = Caveat({
+ weight: ['500'],
+ subsets: ['latin'],
+ display: 'swap',
+ variable: '--font-caveat',
+});
+
+const DEFAULT_HEIGHT_PERCENT = 5;
+const DEFAULT_WIDTH_PERCENT = 15;
+
+const MIN_HEIGHT_PX = 60;
+const MIN_WIDTH_PX = 200;
+
+export type AddTemplateFieldsFormProps = {
+ documentFlow: DocumentFlowStep;
+ hideRecipients?: boolean;
+ recipients: Recipient[];
+ fields: Field[];
+ numberOfSteps: number;
+ onSubmit: (_data: TAddTemplateFieldsFormSchema) => void;
+};
+
+export const AddTemplateFieldsFormPartial = ({
+ documentFlow,
+ hideRecipients = false,
+ recipients,
+ fields,
+ numberOfSteps,
+ onSubmit,
+}: AddTemplateFieldsFormProps) => {
+ const { isWithinPageBounds, getFieldPosition, getPage } = useDocumentElement();
+
+ const {
+ control,
+ handleSubmit,
+ formState: { isSubmitting },
+ } = useForm<TAddTemplateFieldsFormSchema>({
+ defaultValues: {
+ fields: fields.map((field) => ({
+ nativeId: field.id,
+ formId: `${field.id}-${field.templateId}`,
+ pageNumber: field.page,
+ type: field.type,
+ pageX: Number(field.positionX),
+ pageY: Number(field.positionY),
+ pageWidth: Number(field.width),
+ pageHeight: Number(field.height),
+ signerId: field.recipientId ?? -1,
+ signerEmail:
+ recipients.find((recipient) => recipient.id === field.recipientId)?.email ?? '',
+ signerToken:
+ recipients.find((recipient) => recipient.id === field.recipientId)?.templateToken ?? '',
+ })),
+ },
+ });
+
+ const onFormSubmit = handleSubmit(onSubmit);
+
+ const {
+ append,
+ remove,
+ update,
+ fields: localFields,
+ } = useFieldArray({
+ control,
+ name: 'fields',
+ });
+
+ const [selectedField, setSelectedField] = useState<FieldType | null>(null);
+ const [selectedSigner, setSelectedSigner] = useState<Recipient | null>(null);
+ const [showRecipientsSelector, setShowRecipientsSelector] = useState(false);
+
+ const [isFieldWithinBounds, setIsFieldWithinBounds] = useState(false);
+ const [coords, setCoords] = useState({
+ x: 0,
+ y: 0,
+ });
+
+ const fieldBounds = useRef({
+ height: 0,
+ width: 0,
+ });
+
+ const onMouseMove = useCallback(
+ (event: MouseEvent) => {
+ setIsFieldWithinBounds(
+ isWithinPageBounds(
+ event,
+ PDF_VIEWER_PAGE_SELECTOR,
+ fieldBounds.current.width,
+ fieldBounds.current.height,
+ ),
+ );
+
+ setCoords({
+ x: event.clientX - fieldBounds.current.width / 2,
+ y: event.clientY - fieldBounds.current.height / 2,
+ });
+ },
+ [isWithinPageBounds],
+ );
+
+ const onMouseClick = useCallback(
+ (event: MouseEvent) => {
+ if (!selectedField || !selectedSigner) {
+ return;
+ }
+
+ const $page = getPage(event, PDF_VIEWER_PAGE_SELECTOR);
+
+ if (
+ !$page ||
+ !isWithinPageBounds(
+ event,
+ PDF_VIEWER_PAGE_SELECTOR,
+ fieldBounds.current.width,
+ fieldBounds.current.height,
+ )
+ ) {
+ setSelectedField(null);
+ return;
+ }
+
+ const { top, left, height, width } = getBoundingClientRect($page);
+
+ const pageNumber = parseInt($page.getAttribute('data-page-number') ?? '1', 10);
+
+ // Calculate x and y as a percentage of the page width and height
+ let pageX = ((event.pageX - left) / width) * 100;
+ let pageY = ((event.pageY - top) / height) * 100;
+
+ // Get the bounds as a percentage of the page width and height
+ const fieldPageWidth = (fieldBounds.current.width / width) * 100;
+ const fieldPageHeight = (fieldBounds.current.height / height) * 100;
+
+ // And center it based on the bounds
+ pageX -= fieldPageWidth / 2;
+ pageY -= fieldPageHeight / 2;
+
+ append({
+ formId: nanoid(12),
+ type: selectedField,
+ pageNumber,
+ pageX,
+ pageY,
+ pageWidth: fieldPageWidth,
+ pageHeight: fieldPageHeight,
+ signerEmail: selectedSigner.email,
+ signerId: selectedSigner.id,
+ signerToken: selectedSigner.templateToken ?? '',
+ });
+
+ setIsFieldWithinBounds(false);
+ setSelectedField(null);
+ },
+ [append, isWithinPageBounds, selectedField, selectedSigner, getPage],
+ );
+
+ const onFieldResize = useCallback(
+ (node: HTMLElement, index: number) => {
+ const field = localFields[index];
+
+ const $page = window.document.querySelector<HTMLElement>(
+ `${PDF_VIEWER_PAGE_SELECTOR}[data-page-number="${field.pageNumber}"]`,
+ );
+
+ if (!$page) {
+ return;
+ }
+
+ const {
+ x: pageX,
+ y: pageY,
+ width: pageWidth,
+ height: pageHeight,
+ } = getFieldPosition($page, node);
+
+ update(index, {
+ ...field,
+ pageX,
+ pageY,
+ pageWidth,
+ pageHeight,
+ });
+ },
+ [getFieldPosition, localFields, update],
+ );
+
+ const onFieldMove = useCallback(
+ (node: HTMLElement, index: number) => {
+ const field = localFields[index];
+
+ const $page = window.document.querySelector<HTMLElement>(
+ `${PDF_VIEWER_PAGE_SELECTOR}[data-page-number="${field.pageNumber}"]`,
+ );
+
+ if (!$page) {
+ return;
+ }
+
+ const { x: pageX, y: pageY } = getFieldPosition($page, node);
+
+ update(index, {
+ ...field,
+ pageX,
+ pageY,
+ });
+ },
+ [getFieldPosition, localFields, update],
+ );
+
+ useEffect(() => {
+ if (selectedField) {
+ window.addEventListener('mousemove', onMouseMove);
+ window.addEventListener('mouseup', onMouseClick);
+ }
+
+ return () => {
+ window.removeEventListener('mousemove', onMouseMove);
+ window.removeEventListener('mouseup', onMouseClick);
+ };
+ }, [onMouseClick, onMouseMove, selectedField]);
+
+ useEffect(() => {
+ const observer = new MutationObserver((_mutations) => {
+ const $page = document.querySelector(PDF_VIEWER_PAGE_SELECTOR);
+
+ if (!$page) {
+ return;
+ }
+
+ const { height, width } = $page.getBoundingClientRect();
+
+ fieldBounds.current = {
+ height: Math.max(height * (DEFAULT_HEIGHT_PERCENT / 100), MIN_HEIGHT_PX),
+ width: Math.max(width * (DEFAULT_WIDTH_PERCENT / 100), MIN_WIDTH_PX),
+ };
+ });
+
+ observer.observe(document.body, {
+ childList: true,
+ subtree: true,
+ });
+
+ return () => {
+ observer.disconnect();
+ };
+ }, []);
+
+ useEffect(() => {
+ setSelectedSigner(recipients[0]);
+ }, [recipients]);
+
+ return (
+ <>
+ <DocumentFlowFormContainerContent>
+ <div className="flex flex-col">
+ {selectedField && (
+ <Card
+ className={cn(
+ 'bg-background pointer-events-none fixed z-50 cursor-pointer transition-opacity',
+ {
+ 'border-primary': isFieldWithinBounds,
+ 'opacity-50': !isFieldWithinBounds,
+ },
+ )}
+ style={{
+ top: coords.y,
+ left: coords.x,
+ height: fieldBounds.current.height,
+ width: fieldBounds.current.width,
+ }}
+ >
+ <CardContent className="text-foreground flex h-full w-full items-center justify-center p-2">
+ {FRIENDLY_FIELD_TYPE[selectedField]}
+ </CardContent>
+ </Card>
+ )}
+
+ {localFields.map((field, index) => (
+ <FieldItem
+ key={index}
+ field={field}
+ disabled={selectedSigner?.email !== field.signerEmail}
+ minHeight={fieldBounds.current.height}
+ minWidth={fieldBounds.current.width}
+ passive={isFieldWithinBounds && !!selectedField}
+ onResize={(options) => onFieldResize(options, index)}
+ onMove={(options) => onFieldMove(options, index)}
+ onRemove={() => remove(index)}
+ />
+ ))}
+
+ {!hideRecipients && (
+ <Popover open={showRecipientsSelector} onOpenChange={setShowRecipientsSelector}>
+ <PopoverTrigger asChild>
+ <Button
+ type="button"
+ variant="outline"
+ role="combobox"
+ className="bg-background text-muted-foreground mb-12 justify-between font-normal"
+ >
+ {selectedSigner?.email && (
+ <span className="flex-1 truncate text-left">
+ {selectedSigner?.name} ({selectedSigner?.email})
+ </span>
+ )}
+
+ {!selectedSigner?.email && (
+ <span className="flex-1 truncate text-left">{selectedSigner?.email}</span>
+ )}
+
+ <ChevronsUpDown className="ml-2 h-4 w-4" />
+ </Button>
+ </PopoverTrigger>
+
+ <PopoverContent className="p-0" align="start">
+ <Command>
+ <CommandInput />
+ <CommandEmpty>
+ <span className="text-muted-foreground inline-block px-4">
+ No recipient matching this description was found.
+ </span>
+ </CommandEmpty>
+
+ <CommandGroup>
+ {recipients.map((recipient, index) => (
+ <CommandItem
+ key={index}
+ className={cn({
+ // 'text-muted-foreground': recipient.sendStatus === SendStatus.SENT,
+ })}
+ onSelect={() => {
+ setSelectedSigner(recipient);
+ setShowRecipientsSelector(false);
+ }}
+ >
+ {/* {recipient.sendStatus !== SendStatus.SENT ? (
+ <Check
+ aria-hidden={recipient !== selectedSigner}
+ className={cn('mr-2 h-4 w-4 flex-shrink-0', {
+ 'opacity-0': recipient !== selectedSigner,
+ 'opacity-100': recipient === selectedSigner,
+ })}
+ />
+ ) : (
+ <Tooltip>
+ <TooltipTrigger>
+ <Info className="mr-2 h-4 w-4" />
+ </TooltipTrigger>
+ <TooltipContent className="max-w-xs">
+ This document has already been sent to this recipient. You can no
+ longer edit this recipient.
+ </TooltipContent>
+ </Tooltip>
+ )} */}
+
+ {recipient.name && (
+ <span
+ className="truncate"
+ title={`${recipient.name} (${recipient.email})`}
+ >
+ {recipient.name} ({recipient.email})
+ </span>
+ )}
+
+ {!recipient.name && (
+ <span className="truncate" title={recipient.email}>
+ {recipient.email}
+ </span>
+ )}
+ </CommandItem>
+ ))}
+ </CommandGroup>
+ </Command>
+ </PopoverContent>
+ </Popover>
+ )}
+
+ <div className="-mx-2 flex-1 overflow-y-auto px-2">
+ <div className="grid grid-cols-2 gap-x-4 gap-y-8">
+ <button
+ type="button"
+ className="group h-full w-full"
+ disabled={!selectedSigner}
+ onClick={() => setSelectedField(FieldType.SIGNATURE)}
+ onMouseDown={() => setSelectedField(FieldType.SIGNATURE)}
+ data-selected={selectedField === FieldType.SIGNATURE ? true : undefined}
+ >
+ <Card className="group-data-[selected]:border-documenso h-full w-full cursor-pointer group-disabled:opacity-50">
+ <CardContent className="flex flex-col items-center justify-center px-6 py-4">
+ <p
+ className={cn(
+ 'text-muted-foreground group-data-[selected]:text-foreground w-full truncate text-3xl font-medium',
+ fontCaveat.className,
+ )}
+ >
+ {selectedSigner?.name || 'Signature'}
+ </p>
+
+ <p className="text-muted-foreground mt-2 text-center text-xs">Signature</p>
+ </CardContent>
+ </Card>
+ </button>
+
+ <button
+ type="button"
+ className="group h-full w-full"
+ disabled={!selectedSigner}
+ onClick={() => setSelectedField(FieldType.EMAIL)}
+ onMouseDown={() => setSelectedField(FieldType.EMAIL)}
+ data-selected={selectedField === FieldType.EMAIL ? true : undefined}
+ >
+ <Card className="group-data-[selected]:border-documenso h-full w-full cursor-pointer group-disabled:opacity-50">
+ <CardContent className="flex flex-col items-center justify-center px-6 py-4">
+ <p
+ className={cn(
+ 'text-muted-foreground group-data-[selected]:text-foreground text-xl font-medium',
+ )}
+ >
+ {'Email'}
+ </p>
+
+ <p className="text-muted-foreground mt-2 text-xs">Email</p>
+ </CardContent>
+ </Card>
+ </button>
+
+ <button
+ type="button"
+ className="group h-full w-full"
+ disabled={!selectedSigner}
+ onClick={() => setSelectedField(FieldType.NAME)}
+ onMouseDown={() => setSelectedField(FieldType.NAME)}
+ data-selected={selectedField === FieldType.NAME ? true : undefined}
+ >
+ <Card className="group-data-[selected]:border-documenso h-full w-full cursor-pointer group-disabled:opacity-50">
+ <CardContent className="flex flex-col items-center justify-center px-6 py-4">
+ <p
+ className={cn(
+ 'text-muted-foreground group-data-[selected]:text-foreground text-xl font-medium',
+ )}
+ >
+ {'Name'}
+ </p>
+
+ <p className="text-muted-foreground mt-2 text-xs">Name</p>
+ </CardContent>
+ </Card>
+ </button>
+
+ <button
+ type="button"
+ className="group h-full w-full"
+ disabled={!selectedSigner}
+ onClick={() => setSelectedField(FieldType.DATE)}
+ onMouseDown={() => setSelectedField(FieldType.DATE)}
+ data-selected={selectedField === FieldType.DATE ? true : undefined}
+ >
+ <Card className="group-data-[selected]:border-documenso h-full w-full cursor-pointer group-disabled:opacity-50">
+ <CardContent className="flex flex-col items-center justify-center px-6 py-4">
+ <p
+ className={cn(
+ 'text-muted-foreground group-data-[selected]:text-foreground text-xl font-medium',
+ )}
+ >
+ {'Date'}
+ </p>
+
+ <p className="text-muted-foreground mt-2 text-xs">Date</p>
+ </CardContent>
+ </Card>
+ </button>
+ </div>
+ </div>
+ </div>
+ </DocumentFlowFormContainerContent>
+
+ <DocumentFlowFormContainerFooter>
+ <DocumentFlowFormContainerStep
+ title={documentFlow.title}
+ step={documentFlow.stepIndex}
+ maxStep={numberOfSteps}
+ />
+
+ <DocumentFlowFormContainerActions
+ loading={isSubmitting}
+ disabled={isSubmitting}
+ goNextLabel="Save Template"
+ onGoBackClick={() => {
+ documentFlow.onBackStep?.();
+ remove();
+ }}
+ onGoNextClick={() => void onFormSubmit()}
+ />
+ </DocumentFlowFormContainerFooter>
+ </>
+ );
+};
diff --git a/packages/ui/primitives/template-flow/add-template-fields.types.ts b/packages/ui/primitives/template-flow/add-template-fields.types.ts
new file mode 100644
index 000000000..4406f82a0
--- /dev/null
+++ b/packages/ui/primitives/template-flow/add-template-fields.types.ts
@@ -0,0 +1,23 @@
+import { z } from 'zod';
+
+import { FieldType } from '@documenso/prisma/client';
+
+export const ZAddTemplateFieldsFormSchema = z.object({
+ fields: z.array(
+ z.object({
+ formId: z.string().min(1),
+ nativeId: z.number().optional(),
+ type: z.nativeEnum(FieldType),
+ signerEmail: z.string().min(1),
+ signerToken: z.string(),
+ signerId: z.number().optional(),
+ pageNumber: z.number().min(1),
+ pageX: z.number().min(0),
+ pageY: z.number().min(0),
+ pageWidth: z.number().min(0),
+ pageHeight: z.number().min(0),
+ }),
+ ),
+});
+
+export type TAddTemplateFieldsFormSchema = z.infer<typeof ZAddTemplateFieldsFormSchema>;
diff --git a/packages/ui/primitives/template-flow/add-template-placeholder-recipients.tsx b/packages/ui/primitives/template-flow/add-template-placeholder-recipients.tsx
new file mode 100644
index 000000000..498314133
--- /dev/null
+++ b/packages/ui/primitives/template-flow/add-template-placeholder-recipients.tsx
@@ -0,0 +1,205 @@
+'use client';
+
+import React, { useId, useState } from 'react';
+
+import { zodResolver } from '@hookform/resolvers/zod';
+import { AnimatePresence, motion } from 'framer-motion';
+import { Plus, Trash } from 'lucide-react';
+import { Controller, useFieldArray, useForm } from 'react-hook-form';
+
+import { nanoid } from '@documenso/lib/universal/id';
+import { Field, Recipient } from '@documenso/prisma/client';
+import { Button } from '@documenso/ui/primitives/button';
+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 {
+ DocumentFlowFormContainerActions,
+ DocumentFlowFormContainerContent,
+ DocumentFlowFormContainerFooter,
+ DocumentFlowFormContainerStep,
+} from '../document-flow/document-flow-root';
+import { DocumentFlowStep } from '../document-flow/types';
+import {
+ TAddTemplatePlacholderRecipientsFormSchema,
+ ZAddTemplatePlacholderRecipientsFormSchema,
+} from './add-template-placeholder-recipients.types';
+
+export type AddTemplatePlaceholderRecipientsFormProps = {
+ documentFlow: DocumentFlowStep;
+ recipients: Recipient[];
+ fields: Field[];
+ numberOfSteps: number;
+ onSubmit: (_data: TAddTemplatePlacholderRecipientsFormSchema) => void;
+};
+
+export const AddTemplatePlaceholderRecipientsFormPartial = ({
+ documentFlow,
+ numberOfSteps,
+ recipients,
+ fields: _fields,
+ onSubmit,
+}: AddTemplatePlaceholderRecipientsFormProps) => {
+ const initialId = useId();
+ const [placeholderRecipientCount, setPlaceholderRecipientCount] = useState(1);
+
+ const {
+ control,
+ handleSubmit,
+ formState: { errors, isSubmitting },
+ } = useForm<TAddTemplatePlacholderRecipientsFormSchema>({
+ resolver: zodResolver(ZAddTemplatePlacholderRecipientsFormSchema),
+ defaultValues: {
+ signers:
+ recipients.length > 0
+ ? recipients.map((recipient) => ({
+ nativeId: recipient.id,
+ formId: String(recipient.id),
+ name: recipient.name,
+ email: recipient.email,
+ }))
+ : [
+ {
+ formId: initialId,
+ name: `John Doe`,
+ email: `[email protected]`,
+ },
+ ],
+ },
+ });
+
+ const onFormSubmit = handleSubmit(onSubmit);
+
+ const {
+ append: appendSigner,
+ fields: signers,
+ remove: removeSigner,
+ } = useFieldArray({
+ control,
+ name: 'signers',
+ });
+
+ const onAddPlaceholderRecipient = () => {
+ setPlaceholderRecipientCount(placeholderRecipientCount + 1);
+
+ appendSigner({
+ formId: nanoid(12),
+ name: `John Doe ${placeholderRecipientCount}`,
+ email: `johndoe${placeholderRecipientCount}@documenso.com`,
+ });
+ };
+
+ const onRemoveSigner = (index: number) => {
+ removeSigner(index);
+ };
+
+ const onKeyDown = (event: React.KeyboardEvent<HTMLInputElement>) => {
+ if (event.key === 'Enter' && event.target instanceof HTMLInputElement) {
+ onAddPlaceholderRecipient();
+ }
+ };
+
+ return (
+ <>
+ <DocumentFlowFormContainerContent>
+ <div className="flex w-full flex-col gap-y-4">
+ <AnimatePresence>
+ {signers.map((signer, index) => (
+ <motion.div
+ key={signer.id}
+ data-native-id={signer.nativeId}
+ className="flex flex-wrap items-end gap-x-4"
+ >
+ <div className="flex-1">
+ <Label htmlFor={`signer-${signer.id}-email`}>
+ Email
+ <span className="text-destructive ml-1 inline-block font-medium">*</span>
+ </Label>
+
+ <Controller
+ control={control}
+ name={`signers.${index}.email`}
+ render={({ field }) => (
+ <Input
+ id={`signer-${signer.id}-email`}
+ type="email"
+ className="bg-background mt-2"
+ disabled={isSubmitting}
+ onKeyDown={onKeyDown}
+ {...field}
+ />
+ )}
+ />
+ </div>
+
+ <div className="flex-1">
+ <Label htmlFor={`signer-${signer.id}-name`}>Name</Label>
+
+ <Controller
+ control={control}
+ name={`signers.${index}.name`}
+ render={({ field }) => (
+ <Input
+ id={`signer-${signer.id}-name`}
+ type="text"
+ className="bg-background mt-2"
+ disabled={isSubmitting}
+ onKeyDown={onKeyDown}
+ {...field}
+ />
+ )}
+ />
+ </div>
+
+ <div>
+ <button
+ type="button"
+ className="inline-flex h-10 w-10 items-center justify-center text-slate-500 hover:opacity-80 disabled:cursor-not-allowed disabled:opacity-50"
+ disabled={isSubmitting || signers.length === 1}
+ onClick={() => onRemoveSigner(index)}
+ >
+ <Trash className="h-5 w-5" />
+ </button>
+ </div>
+
+ <div className="w-full">
+ <FormErrorMessage className="mt-2" error={errors.signers?.[index]?.email} />
+ <FormErrorMessage className="mt-2" error={errors.signers?.[index]?.name} />
+ </div>
+ </motion.div>
+ ))}
+ </AnimatePresence>
+ </div>
+
+ <FormErrorMessage
+ className="mt-2"
+ // Dirty hack to handle errors when .root is populated for an array type
+ error={'signers__root' in errors && errors['signers__root']}
+ />
+
+ <div className="mt-4">
+ <Button type="button" disabled={isSubmitting} onClick={() => onAddPlaceholderRecipient()}>
+ <Plus className="-ml-1 mr-2 h-5 w-5" />
+ Add Placeholder Recipient
+ </Button>
+ </div>
+ </DocumentFlowFormContainerContent>
+
+ <DocumentFlowFormContainerFooter>
+ <DocumentFlowFormContainerStep
+ title={documentFlow.title}
+ step={documentFlow.stepIndex}
+ maxStep={numberOfSteps}
+ />
+
+ <DocumentFlowFormContainerActions
+ loading={isSubmitting}
+ disabled={isSubmitting}
+ onGoBackClick={documentFlow.onBackStep}
+ onGoNextClick={() => void onFormSubmit()}
+ />
+ </DocumentFlowFormContainerFooter>
+ </>
+ );
+};
diff --git a/packages/ui/primitives/template-flow/add-template-placeholder-recipients.types.ts b/packages/ui/primitives/template-flow/add-template-placeholder-recipients.types.ts
new file mode 100644
index 000000000..89c197f5e
--- /dev/null
+++ b/packages/ui/primitives/template-flow/add-template-placeholder-recipients.types.ts
@@ -0,0 +1,26 @@
+import { z } from 'zod';
+
+export const ZAddTemplatePlacholderRecipientsFormSchema = z
+ .object({
+ signers: z.array(
+ z.object({
+ formId: z.string().min(1),
+ nativeId: z.number().optional(),
+ email: z.string().min(1).email(),
+ name: z.string().optional(),
+ }),
+ ),
+ })
+ .refine(
+ (schema) => {
+ const emails = schema.signers.map((signer) => signer.email.toLowerCase());
+
+ return new Set(emails).size === emails.length;
+ },
+ // Dirty hack to handle errors when .root is populated for an array type
+ { message: 'Signers must have unique emails', path: ['signers__root'] },
+ );
+
+export type TAddTemplatePlacholderRecipientsFormSchema = z.infer<
+ typeof ZAddTemplatePlacholderRecipientsFormSchema
+>;