envelope-editor-v2-e2e

What problem does it solve?

Provides a repeatable, maintainable pattern for writing Playwright end-to-end tests for the Envelope Editor V2 so teams can verify UI flows, persistence, and edge cases across native and embedded surfaces without flaky or duplicated test logic.

Core Features & Use Cases

• Surface Normalization: A single TEnvelopeEditorSurface abstraction unifies Document, Template, Embedded Create, and Embedded Edit flows so tests run the same logical flow across four surfaces.
• Fixture Helpers & Locators: Ready-made locator and action helpers simplify uploading PDFs, managing recipients, toggling settings, navigating steps, and asserting toasts.
• Database Assertions & Persistence: Prisma-based assertions and explicit persistEmbeddedEnvelope handling allow reliable verification of server-side state and guard against parallel-test collisions.
• Use Case: Add a new spec that tests recipient management and field placement, run it across all surfaces, and assert persistence using an externalId generated per test.

Quick Start

Create a new spec in the envelope-editor-v2 test folder, implement a runXxxFlow that uses the provided fixture helpers and externalId pattern, and run the envelope-editor-v2 tests with the repository test runner.