QA Workflows

1. Create unique inbox  →  address + jwt
2. Trigger email flow   →  submit address to form/API under test
3. Poll inbox           →  wait for mail to arrive (with timeout)
4. Assert on content    →  verify subject, OTP, link, sender
5. Continue test flow   →  click link or submit code

async function testOtpSignup(page: Page) {
  const { address, jwt } = await createInbox();

  // Trigger email
  await page.fill('[name=email]', address);
  await page.click('[type=submit]');

  // Wait and extract
  const mail = await waitForMail(jwt);
  const otp = mail.raw.match(/\b\d{6}\b/)?.[0];
  expect(otp).toBeDefined();

  // Submit
  await page.fill('[name=otp]', otp!);
  await page.click('[type=submit]');
  await expect(page).toHaveURL(/verified/);
}

async function testMagicLink(page: Page) {
  const { address, jwt } = await createInbox();

  await submitLoginForm(page, address);

  const mail = await waitForMail(jwt);
  const link = mail.raw.match(/https:\/\/app\.example\.com\/auth\/[^\s"<]+/)?.[0];
  expect(link).toBeDefined();

  await page.goto(link!);
  await expect(page).toHaveURL(/dashboard/);
}

async function testWelcomeEmail(jwt: string) {
  const mail = await waitForMail(jwt);
  const meta = JSON.parse(mail.raw); // or parse raw headers
  
  expect(mail.subject).toContain('Welcome to');
  expect(mail.raw).toContain('Get started');
  expect(mail.raw).not.toContain('unsubscribe'); // welcome email shouldn't have this
}

test.describe.parallel('concurrent signups', () => {
  for (let i = 0; i < 5; i++) {
    test(`user ${i} signup`, async ({ page }) => {
      // Each test creates a separate inbox — no collision
      const { address, jwt } = await createInbox();
      await runSignupFlow(page, address, jwt);
    });
  }
});

async function testOnboardingSequence(page: Page) {
  const { address, jwt } = await createInbox();

  // Step 1: Signup confirmation
  await triggerSignup(page, address);
  const confirmMail = await waitForMail(jwt);
  await clickLink(page, confirmMail, /confirm/);

  // Clear so next poll only returns new mail
  await clearInbox(jwt);

  // Step 2: Onboarding email (arrives 5 min later in some apps)
  const onboardingMail = await waitForMail(jwt, { timeoutMs: 360_000 });
  expect(onboardingMail.subject).toContain('Getting started');
}