Test a sign-up email flow with Playwright

from datetime import datetime, timezone

import pytest
from devhelm import Devhelm
from playwright.sync_api import Page, expect

client = Devhelm()


@pytest.fixture
def mailbox():
    address = client.email.address(label="signup")
    yield address
    address.clear()


def test_signup_emails_a_working_code(page: Page, mailbox):
    page.goto("/signup")
    page.get_by_label("Email").fill(mailbox.email)
    page.get_by_label("Password").fill("correct-horse-battery-staple")

    since = datetime.now(timezone.utc)  # before the click that sends the email
    page.get_by_role("button", name="Create account").click()

    message = mailbox.wait(received_after=since, subject_contains="verify", timeout_ms=60_000)

    assert message.otp, "no code found in the email"
    page.get_by_label("Verification code").fill(message.otp[0].value)
    page.get_by_role("button", name="Verify").click()
    expect(page.get_by_role("heading", name="Welcome")).to_be_visible()

import { Devhelm, type EmailMessageDto } from "@devhelm/sdk";
import { expect, test } from "@playwright/test";

const client = new Devhelm({ token: process.env.DEVHELM_API_TOKEN! });

test("the wait and extraction handle a sign-up email", async () => {
  const mailbox = await client.email.address({ label: "signup-dry" });
  try {
    const since = new Date().toISOString();
    await mailbox.receive({
      from: "no-reply@example.com",
      subject: "Verify your email",
      text: "Your verification code is 482913.",
      html: '<a href="https://app.example.com/verify?token=abc&amp;step=2">Verify email</a>',
    });

    const message = await mailbox.wait({ receivedAfter: since, subjectContains: "verify", timeoutMs: 30_000 });
    // The 1.9.0 types need this cast.
    const mail = message as unknown as EmailMessageDto & { text?: string | null; html?: string | null };

    expect(mail.otp?.[0]?.value).toBe("482913");
    const link = mail.links?.find((l) => l.text === "Verify email");
    expect(link?.href.replaceAll("&amp;", "&")).toBe("https://app.example.com/verify?token=abc&step=2");
  } finally {
    await mailbox.clear();
  }
});