feat: add envelope editor

2025-11-18 02:32:00 +10:00 · 2025-10-12 23:35:54 +11:00
parent bf89bc781b
commit 0da8e7dbc6
307 changed files with 24657 additions and 3681 deletions
--- a/packages/prisma/migrations/20250912023138_add_none_source/migration.sql
+++ b/packages/prisma/migrations/20250912023138_add_none_source/migration.sql
@ -0,0 +1,2 @@
+-- AlterEnum
+ALTER TYPE "DocumentSource" ADD VALUE 'NONE';
--- a/packages/prisma/migrations/20250918070645_add_envelopes/migration.sql
+++ b/packages/prisma/migrations/20250918070645_add_envelopes/migration.sql
@ -0,0 +1,470 @@
+/*
+  Warnings:
+
+  - You are about to drop the column `documentId` on the `DocumentAuditLog` table. All the data in the column will be lost.
+  - You are about to drop the column `documentId` on the `DocumentMeta` table. All the data in the column will be lost.
+  - You are about to drop the column `password` on the `DocumentMeta` table. All the data in the column will be lost.
+  - You are about to drop the column `templateId` on the `DocumentMeta` table. All the data in the column will be lost.
+  - You are about to drop the column `documentId` on the `DocumentShareLink` table. All the data in the column will be lost.
+  - You are about to drop the column `documentId` on the `Field` table. All the data in the column will be lost.
+  - You are about to drop the column `templateId` on the `Field` table. All the data in the column will be lost.
+  - You are about to drop the column `documentId` on the `Recipient` table. All the data in the column will be lost.
+  - You are about to drop the column `templateId` on the `Recipient` table. All the data in the column will be lost.
+  - You are about to drop the column `templateId` on the `TemplateDirectLink` table. All the data in the column will be lost.
+  - You are about to drop the `Document` table. If the table is not empty, all the data it contains will be lost.
+  - You are about to drop the `Template` table. If the table is not empty, all the data it contains will be lost.
+  - A unique constraint covering the columns `[envelopeId,email]` on the table `DocumentShareLink` will be added. If there are existing duplicate values, this will fail.
+  - A unique constraint covering the columns `[envelopeId,email]` on the table `Recipient` will be added. If there are existing duplicate values, this will fail.
+  - A unique constraint covering the columns `[envelopeId]` on the table `TemplateDirectLink` will be added. If there are existing duplicate values, this will fail.
+  - Added the required column `envelopeId` to the `DocumentAuditLog` table without a default value. This is not possible if the table is not empty.
+  - Added the required column `envelopeId` to the `DocumentShareLink` table without a default value. This is not possible if the table is not empty.
+  - Added the required column `envelopeId` to the `Field` table without a default value. This is not possible if the table is not empty.
+  - Added the required column `envelopeItemId` to the `Field` table without a default value. This is not possible if the table is not empty.
+  - Added the required column `envelopeId` to the `Recipient` table without a default value. This is not possible if the table is not empty.
+  - Added the required column `envelopeId` to the `TemplateDirectLink` table without a default value. This is not possible if the table is not empty.
+
+*/
+-- CreateEnum
+CREATE TYPE "EnvelopeType" AS ENUM ('DOCUMENT', 'TEMPLATE');
+
+-- DropForeignKey
+ALTER TABLE "Document" DROP CONSTRAINT "Document_documentDataId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Document" DROP CONSTRAINT "Document_folderId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Document" DROP CONSTRAINT "Document_teamId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Document" DROP CONSTRAINT "Document_templateId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Document" DROP CONSTRAINT "Document_userId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "DocumentAuditLog" DROP CONSTRAINT "DocumentAuditLog_documentId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "DocumentMeta" DROP CONSTRAINT "DocumentMeta_documentId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "DocumentMeta" DROP CONSTRAINT "DocumentMeta_templateId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "DocumentShareLink" DROP CONSTRAINT "DocumentShareLink_documentId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Field" DROP CONSTRAINT "Field_documentId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Field" DROP CONSTRAINT "Field_templateId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Recipient" DROP CONSTRAINT "Recipient_documentId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Recipient" DROP CONSTRAINT "Recipient_templateId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Template" DROP CONSTRAINT "Template_folderId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Template" DROP CONSTRAINT "Template_teamId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Template" DROP CONSTRAINT "Template_templateDocumentDataId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "Template" DROP CONSTRAINT "Template_userId_fkey";
+
+-- DropForeignKey
+ALTER TABLE "TemplateDirectLink" DROP CONSTRAINT "TemplateDirectLink_templateId_fkey";
+
+-- DropIndex
+DROP INDEX "DocumentMeta_documentId_key";
+
+-- DropIndex
+DROP INDEX "DocumentMeta_templateId_key";
+
+-- DropIndex
+DROP INDEX "DocumentShareLink_documentId_email_key";
+
+-- DropIndex
+DROP INDEX "Field_documentId_idx";
+
+-- DropIndex
+DROP INDEX "Field_templateId_idx";
+
+-- DropIndex
+DROP INDEX "Recipient_documentId_idx";
+
+-- DropIndex
+DROP INDEX "Recipient_templateId_idx";
+
+-- DropIndex
+DROP INDEX "TemplateDirectLink_templateId_key";
+
+-- [CUSTOM_CHANGE] Create DocumentMeta records for Documents that don't have them
+INSERT INTO "DocumentMeta" ("id", "documentId")
+SELECT
+  gen_random_uuid(),
+  id
+FROM "Document"
+WHERE "id" NOT IN (SELECT "documentId" FROM "DocumentMeta" WHERE "documentId" IS NOT NULL);
+
+-- [CUSTOM_CHANGE] Create DocumentMeta records for Templates that don't have them
+INSERT INTO "DocumentMeta" ("id", "templateId")
+SELECT
+  gen_random_uuid(),
+  id
+FROM "Template"
+WHERE "id" NOT IN (SELECT "templateId" FROM "DocumentMeta" WHERE "templateId" IS NOT NULL);
+
+-- AlterTable
+ALTER TABLE "DocumentAuditLog" ADD COLUMN     "envelopeId" TEXT;
+
+-- AlterTable
+ALTER TABLE "DocumentShareLink" ADD COLUMN     "envelopeId" TEXT;
+
+-- AlterTable
+ALTER TABLE "Field" ADD COLUMN     "envelopeId" TEXT,
+ADD COLUMN     "envelopeItemId" TEXT;
+
+-- AlterTable
+ALTER TABLE "Recipient" ADD COLUMN     "envelopeId" TEXT;
+
+-- AlterTable
+ALTER TABLE "TemplateDirectLink" ADD COLUMN     "envelopeId" TEXT;
+
+-- CreateTable
+CREATE TABLE "Envelope" (
+    "id" TEXT NOT NULL,
+    "secondaryId" TEXT NOT NULL,
+    "externalId" TEXT,
+    "type" "EnvelopeType" NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+    "completedAt" TIMESTAMP(3),
+    "deletedAt" TIMESTAMP(3),
+    "title" TEXT NOT NULL,
+    "status" "DocumentStatus" NOT NULL DEFAULT 'DRAFT',
+    "source" "DocumentSource" NOT NULL,
+    "qrToken" TEXT,
+    "internalVersion" INTEGER NOT NULL,
+    "useLegacyFieldInsertion" BOOLEAN NOT NULL DEFAULT false,
+    "authOptions" JSONB,
+    "formValues" JSONB,
+    "visibility" "DocumentVisibility" NOT NULL DEFAULT 'EVERYONE',
+    "templateType" "TemplateType" NOT NULL DEFAULT 'PRIVATE',
+    "publicTitle" TEXT NOT NULL DEFAULT '',
+    "publicDescription" TEXT NOT NULL DEFAULT '',
+    "templateId" INTEGER,
+    "userId" INTEGER NOT NULL,
+    "teamId" INTEGER NOT NULL,
+    "folderId" TEXT,
+    "documentMetaId" TEXT NOT NULL,
+
+    CONSTRAINT "Envelope_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "EnvelopeItem" (
+    "id" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "documentDataId" TEXT NOT NULL,
+    "envelopeId" TEXT NOT NULL,
+    "order" INTEGER NOT NULL,
+
+    CONSTRAINT "EnvelopeItem_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Counter" (
+    "id" TEXT NOT NULL,
+    "value" INTEGER NOT NULL,
+
+    CONSTRAINT "Counter_pkey" PRIMARY KEY ("id")
+);
+
+-- [CUSTOM_CHANGE] Initialize Counter table for document and template IDs
+INSERT INTO "Counter" ("id", "value") VALUES ('document', (SELECT COALESCE(MAX("id"), 0) FROM "Document"));
+INSERT INTO "Counter" ("id", "value") VALUES ('template', (SELECT COALESCE(MAX("id"), 0) FROM "Template"));
+
+-- [CUSTOM_CHANGE] Migrate Documents to Envelopes
+INSERT INTO "Envelope" (
+    "id",
+    "secondaryId",
+    "externalId",
+    "type",
+    "createdAt",
+    "updatedAt",
+    "completedAt",
+    "deletedAt",
+    "title",
+    "status",
+    "source",
+    "qrToken",
+    "internalVersion",
+    "useLegacyFieldInsertion",
+    "authOptions",
+    "formValues",
+    "visibility",
+    "templateType",
+    "publicTitle",
+    "publicDescription",
+    "templateId",
+    "userId",
+    "teamId",
+    "folderId",
+    "documentMetaId"
+)
+SELECT
+    generate_prefix_id('envelope'),
+    'document_' || d."id", -- Create legacy ID for documents
+    d."externalId",
+    'DOCUMENT'::"EnvelopeType",
+    d."createdAt",
+    d."updatedAt",
+    d."completedAt",
+    d."deletedAt",
+    d."title",
+    d."status",
+    d."source",
+    d."qrToken",
+    1,
+    d."useLegacyFieldInsertion",
+    d."authOptions",
+    d."formValues",
+    d."visibility",
+    'PRIVATE',
+    '',
+    '',
+    d."templateId",
+    d."userId",
+    d."teamId",
+    d."folderId",
+    dm."id"
+FROM "Document" d
+LEFT JOIN "DocumentMeta" dm ON dm."documentId" = d."id";
+
+-- [CUSTOM_CHANGE] Migrate Templates to Envelopes
+INSERT INTO "Envelope" (
+    "id",
+    "secondaryId",
+    "externalId",
+    "type",
+    "createdAt",
+    "updatedAt",
+    "completedAt",
+    "deletedAt",
+    "title",
+    "status",
+    "source",
+    "qrToken",
+    "internalVersion",
+    "useLegacyFieldInsertion",
+    "authOptions",
+    "formValues",
+    "visibility",
+    "templateType",
+    "publicTitle",
+    "publicDescription",
+    "templateId",
+    "userId",
+    "teamId",
+    "folderId",
+    "documentMetaId"
+)
+SELECT
+    generate_prefix_id('envelope'),
+    'template_' || t."id", -- Create legacy ID for templates
+    t."externalId",
+    'TEMPLATE'::"EnvelopeType",
+    t."createdAt",
+    t."updatedAt",
+    NULL,
+    NULL,
+    t."title",
+    'DRAFT',
+    'NONE'::"DocumentSource",
+    NULL,
+    1,
+    t."useLegacyFieldInsertion",
+    t."authOptions",
+    NULL,
+    t."visibility",
+    t."type",
+    t."publicTitle",
+    t."publicDescription",
+    NULL,
+    t."userId",
+    t."teamId",
+    t."folderId",
+    dm."id"
+FROM "Template" t
+LEFT JOIN "DocumentMeta" dm ON dm."templateId" = t."id";
+
+-- [CUSTOM_CHANGE] Create EnvelopeItems for Documents
+INSERT INTO "EnvelopeItem" ("id", "title", "documentDataId", "envelopeId", "order")
+SELECT
+    generate_prefix_id('envelope_item'),
+    d."title",
+    d."documentDataId",
+    e."id",
+    1
+FROM "Document" d
+JOIN "Envelope" e ON e."secondaryId" = 'document_' || d."id";
+
+-- [CUSTOM_CHANGE] Create EnvelopeItems for Templates
+INSERT INTO "EnvelopeItem" ("id", "title", "documentDataId", "envelopeId", "order")
+SELECT
+    generate_prefix_id('envelope_item'),
+    t."title",
+    t."templateDocumentDataId",
+    e."id",
+    1
+FROM "Template" t
+JOIN "Envelope" e ON e."secondaryId" = 'template_' || t."id";
+
+-- [CUSTOM_CHANGE] Update DocumentAuditLog with envelope IDs
+UPDATE "DocumentAuditLog"
+SET "envelopeId" = e."id"
+FROM "Document" d
+JOIN "Envelope" e ON e."secondaryId" = 'document_' || d."id"
+WHERE "DocumentAuditLog"."documentId" = d."id";
+
+-- [CUSTOM_CHANGE] Update Recipients for Documents
+UPDATE "Recipient"
+SET "envelopeId" = e."id"
+FROM "Document" d
+JOIN "Envelope" e ON e."secondaryId" = 'document_' || d."id"
+WHERE "Recipient"."documentId" = d."id";
+
+-- [CUSTOM_CHANGE] Update Recipients for Templates
+UPDATE "Recipient"
+SET "envelopeId" = e."id"
+FROM "Template" t
+JOIN "Envelope" e ON e."secondaryId" = 'template_' || t."id"
+WHERE "Recipient"."templateId" = t."id";
+
+-- [CUSTOM_CHANGE] Update Fields for Documents
+UPDATE "Field"
+SET "envelopeId" = e."id", "envelopeItemId" = ei."id"
+FROM "Document" d
+JOIN "Envelope" e ON e."secondaryId" = 'document_' || d."id"
+JOIN "EnvelopeItem" ei ON ei."envelopeId" = e."id"
+WHERE "Field"."documentId" = d."id";
+
+-- [CUSTOM_CHANGE] Update Fields for Templates
+UPDATE "Field"
+SET "envelopeId" = e."id", "envelopeItemId" = ei."id"
+FROM "Template" t
+JOIN "Envelope" e ON e."secondaryId" = 'template_' || t."id"
+JOIN "EnvelopeItem" ei ON ei."envelopeId" = e."id"
+WHERE "Field"."templateId" = t."id";
+
+-- [CUSTOM_CHANGE] Update DocumentShareLink
+UPDATE "DocumentShareLink"
+SET "envelopeId" = e."id"
+FROM "Document" d
+JOIN "Envelope" e ON e."secondaryId" = 'document_' || d."id"
+WHERE "DocumentShareLink"."documentId" = d."id";
+
+-- [CUSTOM_CHANGE] Update TemplateDirectLink
+UPDATE "TemplateDirectLink"
+SET "envelopeId" = e."id"
+FROM "Template" t
+JOIN "Envelope" e ON e."secondaryId" = 'template_' || t."id"
+WHERE "TemplateDirectLink"."templateId" = t."id";
+
+-- DropTable
+DROP TABLE "Document";
+
+-- DropTable
+DROP TABLE "Template";
+
+-- AlterTable
+ALTER TABLE "DocumentMeta" DROP COLUMN "documentId",
+DROP COLUMN "password",
+DROP COLUMN "templateId";
+
+-- AlterTable
+ALTER TABLE "DocumentAuditLog" DROP COLUMN "documentId",
+ALTER COLUMN "envelopeId" SET NOT NULL;
+
+-- AlterTable
+ALTER TABLE "DocumentShareLink" DROP COLUMN "documentId",
+ALTER COLUMN "envelopeId" SET NOT NULL;
+
+-- AlterTable
+ALTER TABLE "Field" DROP COLUMN "documentId",
+DROP COLUMN "templateId",
+ALTER COLUMN "envelopeId" SET NOT NULL,
+ALTER COLUMN "envelopeItemId" SET NOT NULL;
+
+-- AlterTable
+ALTER TABLE "Recipient" DROP COLUMN "documentId",
+DROP COLUMN "templateId",
+ALTER COLUMN     "envelopeId" SET NOT NULL;
+
+-- AlterTable
+ALTER TABLE "TemplateDirectLink" DROP COLUMN "templateId",
+ALTER COLUMN     "envelopeId" SET NOT NULL;
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Envelope_secondaryId_key" ON "Envelope"("secondaryId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Envelope_documentMetaId_key" ON "Envelope"("documentMetaId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "EnvelopeItem_documentDataId_key" ON "EnvelopeItem"("documentDataId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "DocumentShareLink_envelopeId_email_key" ON "DocumentShareLink"("envelopeId", "email");
+
+-- CreateIndex
+CREATE INDEX "Field_envelopeId_idx" ON "Field"("envelopeId");
+
+-- CreateIndex
+CREATE INDEX "Recipient_envelopeId_idx" ON "Recipient"("envelopeId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "TemplateDirectLink_envelopeId_key" ON "TemplateDirectLink"("envelopeId");
+
+-- AddForeignKey
+ALTER TABLE "Envelope" ADD CONSTRAINT "Envelope_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Envelope" ADD CONSTRAINT "Envelope_teamId_fkey" FOREIGN KEY ("teamId") REFERENCES "Team"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Envelope" ADD CONSTRAINT "Envelope_folderId_fkey" FOREIGN KEY ("folderId") REFERENCES "Folder"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Envelope" ADD CONSTRAINT "Envelope_documentMetaId_fkey" FOREIGN KEY ("documentMetaId") REFERENCES "DocumentMeta"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "EnvelopeItem" ADD CONSTRAINT "EnvelopeItem_documentDataId_fkey" FOREIGN KEY ("documentDataId") REFERENCES "DocumentData"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "EnvelopeItem" ADD CONSTRAINT "EnvelopeItem_envelopeId_fkey" FOREIGN KEY ("envelopeId") REFERENCES "Envelope"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "DocumentAuditLog" ADD CONSTRAINT "DocumentAuditLog_envelopeId_fkey" FOREIGN KEY ("envelopeId") REFERENCES "Envelope"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Recipient" ADD CONSTRAINT "Recipient_envelopeId_fkey" FOREIGN KEY ("envelopeId") REFERENCES "Envelope"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Field" ADD CONSTRAINT "Field_envelopeItemId_fkey" FOREIGN KEY ("envelopeItemId") REFERENCES "EnvelopeItem"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Field" ADD CONSTRAINT "Field_envelopeId_fkey" FOREIGN KEY ("envelopeId") REFERENCES "Envelope"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "DocumentShareLink" ADD CONSTRAINT "DocumentShareLink_envelopeId_fkey" FOREIGN KEY ("envelopeId") REFERENCES "Envelope"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "TemplateDirectLink" ADD CONSTRAINT "TemplateDirectLink_envelopeId_fkey" FOREIGN KEY ("envelopeId") REFERENCES "Envelope"("id") ON DELETE CASCADE ON UPDATE CASCADE;
--- a/packages/prisma/schema.prisma
+++ b/packages/prisma/schema.prisma
@ -330,6 +330,7 @@ enum DocumentSource {
  DOCUMENT
  TEMPLATE
  TEMPLATE_DIRECT_LINK
+  NONE
 }

 enum DocumentVisibility {
@ -371,9 +372,10 @@ enum EnvelopeType {
  TEMPLATE
 }

+/// @zod.import(["import { ZDocumentAuthOptionsSchema } from '@documenso/lib/types/document-auth';", "import { ZDocumentFormValuesSchema } from '@documenso/lib/types/document-form-values';"])
 model Envelope {
-  id          String  @id // document_asdfasdfsadf template_123asdf
-  secondaryId String  @unique // document_456456456 template_45465465
+  id          String  @id
+  secondaryId String  @unique
  externalId  String? /// @zod.string.describe("A custom external ID you can use to identify the document.")

  type EnvelopeType
@ -388,6 +390,7 @@ model Envelope {
  source  DocumentSource
  qrToken String? /// @zod.string.describe("The token for viewing the document using the QR code on the certificate.")

+  internalVersion         Int
  useLegacyFieldInsertion Boolean @default(false)

  envelopeItems EnvelopeItem[]
@ -406,7 +409,7 @@ model Envelope {
  publicTitle       String              @default("")
  publicDescription String              @default("")
  directLink        TemplateDirectLink?
-  templateId        Int? // Todo: Migrate from templateId -> This @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
+  templateId        Int?

  // Relations
  userId Int /// @zod.number.describe("The ID of the user that created this document.")
@ -422,12 +425,13 @@ model Envelope {
  documentMeta   DocumentMeta @relation(fields: [documentMetaId], references: [id])
 }

-/// @zod.import(["import { ZDocumentAuthOptionsSchema } from '@documenso/lib/types/document-auth';", "import { ZDocumentFormValuesSchema } from '@documenso/lib/types/document-form-values';"])
 model EnvelopeItem {
  id String @id

  title String

+  order Int
+
  documentDataId String
  documentData   DocumentData @relation(fields: [documentDataId], references: [id], onDelete: Cascade)

--- a/packages/prisma/seed/documents.ts
+++ b/packages/prisma/seed/documents.ts
@ -87,6 +87,7 @@ export const seedBlankDocument = async (
    data: {
      id: prefixedId('envelope'),
      secondaryId: documentId.formattedDocumentId,
+      internalVersion: 1,
      type: EnvelopeType.DOCUMENT,
      documentMetaId: documentMeta.id,
      source: DocumentSource.DOCUMENT,
@ -98,6 +99,7 @@ export const seedBlankDocument = async (
          id: prefixedId('envelope_item'),
          title: `[TEST] Document ${key} - Draft`,
          documentDataId: documentData.id,
+          order: 1,
        },
      },
      userId: owner.id,
@ -133,6 +135,7 @@ export const seedTeamDocumentWithMeta = async (team: Team) => {
  const document = await createEnvelope({
    userId: ownerUser.id,
    teamId: team.id,
+    internalVersion: 1,
    data: {
      type: EnvelopeType.DOCUMENT,
      title: `[TEST] Document ${nanoid(8)} - Draft`,
@ -222,6 +225,7 @@ export const seedTeamTemplateWithMeta = async (team: Team) => {
  const ownerUser = organisation.owner;

  const template = await createEnvelope({
+    internalVersion: 1,
    data: {
      type: EnvelopeType.TEMPLATE,
      title: `[TEST] Template ${nanoid(8)} - Draft`,
@ -303,6 +307,7 @@ export const seedDraftDocument = async (
    data: {
      id: prefixedId('envelope'),
      secondaryId: documentId.formattedDocumentId,
+      internalVersion: 1,
      type: EnvelopeType.DOCUMENT,
      documentMetaId: documentMeta.id,
      source: DocumentSource.DOCUMENT,
@ -314,6 +319,7 @@ export const seedDraftDocument = async (
          id: prefixedId('envelope_item'),
          title: `[TEST] Document ${key} - Draft`,
          documentDataId: documentData.id,
+          order: 1,
        },
      },
      userId: sender.id,
@ -394,6 +400,7 @@ export const seedPendingDocument = async (
    data: {
      id: prefixedId('envelope'),
      secondaryId: documentId.formattedDocumentId,
+      internalVersion: 1,
      type: EnvelopeType.DOCUMENT,
      documentMetaId: documentMeta.id,
      source: DocumentSource.DOCUMENT,
@ -405,6 +412,7 @@ export const seedPendingDocument = async (
          id: prefixedId('envelope_item'),
          title: `[TEST] Document ${key} - Pending`,
          documentDataId: documentData.id,
+          order: 1,
        },
      },
      userId: sender.id,
@ -629,6 +637,7 @@ export const seedCompletedDocument = async (
    data: {
      id: prefixedId('envelope'),
      secondaryId: documentId.formattedDocumentId,
+      internalVersion: 1,
      type: EnvelopeType.DOCUMENT,
      documentMetaId: documentMeta.id,
      source: DocumentSource.DOCUMENT,
@ -640,6 +649,7 @@ export const seedCompletedDocument = async (
          id: prefixedId('envelope_item'),
          title: `[TEST] Document ${key} - Completed`,
          documentDataId: documentData.id,
+          order: 1,
        },
      },
      userId: sender.id,
--- a/packages/prisma/seed/initial-seed.ts
+++ b/packages/prisma/seed/initial-seed.ts
@ -65,6 +65,7 @@ export const seedDatabase = async () => {
      data: {
        id: prefixedId('envelope'),
        secondaryId: documentId.formattedDocumentId,
+        internalVersion: 1,
        type: EnvelopeType.DOCUMENT,
        documentMetaId: documentMeta.id,
        source: DocumentSource.DOCUMENT,
@ -74,6 +75,7 @@ export const seedDatabase = async () => {
            id: prefixedId('envelope_item'),
            title: `Example Document ${i}`,
            documentDataId: documentData.id,
+            order: 1,
          },
        },
        userId: exampleUser.user.id,
@ -102,6 +104,7 @@ export const seedDatabase = async () => {
      data: {
        id: prefixedId('envelope'),
        secondaryId: documentId.formattedDocumentId,
+        internalVersion: 1,
        type: EnvelopeType.DOCUMENT,
        source: DocumentSource.DOCUMENT,
        title: `Document ${i}`,
@ -111,6 +114,7 @@ export const seedDatabase = async () => {
            id: prefixedId('envelope_item'),
            title: `Document ${i}`,
            documentDataId: documentData.id,
+            order: 1,
          },
        },
        userId: adminUser.user.id,
--- a/packages/prisma/seed/templates.ts
+++ b/packages/prisma/seed/templates.ts
@ -61,6 +61,7 @@ export const seedBlankTemplate = async (
    data: {
      id: prefixedId('envelope'),
      secondaryId: templateId.formattedTemplateId,
+      internalVersion: 1,
      type: EnvelopeType.TEMPLATE,
      title: `[TEST] Template ${key}`,
      teamId,
@ -69,6 +70,7 @@ export const seedBlankTemplate = async (
          id: prefixedId('envelope_item'),
          title: `[TEST] Template ${key}`,
          documentDataId: documentData.id,
+          order: 1,
        },
      },
      userId: owner.id,
@ -107,6 +109,7 @@ export const seedTemplate = async (options: SeedTemplateOptions) => {
    data: {
      id: prefixedId('envelope'),
      secondaryId: templateId.formattedTemplateId,
+      internalVersion: 1,
      type: EnvelopeType.TEMPLATE,
      title,
      envelopeItems: {
@ -114,6 +117,7 @@ export const seedTemplate = async (options: SeedTemplateOptions) => {
          id: prefixedId('envelope_item'),
          title,
          documentDataId: documentData.id,
+          order: 1,
        },
      },
      source: DocumentSource.TEMPLATE,
@ -163,6 +167,7 @@ export const seedDirectTemplate = async (options: SeedTemplateOptions) => {
    data: {
      id: prefixedId('envelope'),
      secondaryId: templateId.formattedTemplateId,
+      internalVersion: 1,
      type: EnvelopeType.TEMPLATE,
      title,
      envelopeItems: {
@ -170,6 +175,7 @@ export const seedDirectTemplate = async (options: SeedTemplateOptions) => {
          id: prefixedId('envelope_item'),
          title,
          documentDataId: documentData.id,
+          order: 1,
        },
      },
      source: DocumentSource.TEMPLATE,
--- a/packages/prisma/types/document-legacy-schema.ts
+++ b/packages/prisma/types/document-legacy-schema.ts
@ -2,6 +2,7 @@
 * Legacy Document schema to confirm backwards API compatibility since
 * we migrated Documents to Envelopes.
 */
+import { DocumentSource } from '@prisma/client';
 import { z } from 'zod';

 import { ZDocumentAuthOptionsSchema } from '@documenso/lib/types/document-auth';
@ -10,8 +11,6 @@ import { ZDocumentFormValuesSchema } from '@documenso/lib/types/document-form-va
 import DocumentStatusSchema from '../generated/zod/inputTypeSchemas/DocumentStatusSchema';
 import DocumentVisibilitySchema from '../generated/zod/inputTypeSchemas/DocumentVisibilitySchema';

-const DocumentSourceSchema = z.enum(['DOCUMENT', 'TEMPLATE', 'TEMPLATE_DIRECT_LINK']);
-
 /////////////////////////////////////////
 // DOCUMENT SCHEMA
 /////////////////////////////////////////
@ -19,7 +18,7 @@ const DocumentSourceSchema = z.enum(['DOCUMENT', 'TEMPLATE', 'TEMPLATE_DIRECT_LI
 export const LegacyDocumentSchema = z.object({
  visibility: DocumentVisibilitySchema,
  status: DocumentStatusSchema,
-  source: DocumentSourceSchema,
+  source: z.nativeEnum(DocumentSource),
  id: z.number(),
  qrToken: z
    .string()
@ -40,7 +39,7 @@ export const LegacyDocumentSchema = z.object({
   */
  formValues: ZDocumentFormValuesSchema.nullable(),
  title: z.string(),
-  // documentDataId: z.string(), // Todo: Migration
+  documentDataId: z.string(),
  createdAt: z.coerce.date(),
  updatedAt: z.coerce.date(),
  completedAt: z.coerce.date().nullable(),
--- a/packages/prisma/types/template-legacy-schema.ts
+++ b/packages/prisma/types/template-legacy-schema.ts
@ -21,7 +21,7 @@ export const TemplateSchema = z.object({
   * [DocumentAuthOptions]
   */
  authOptions: ZDocumentAuthOptionsSchema.nullable(),
-  // templateDocumentDataId: z.string(), // Todo: Migration - Removal.
+  templateDocumentDataId: z.string(),
  createdAt: z.coerce.date(),
  updatedAt: z.coerce.date(),
  publicTitle: z.string(),