Email QA starts with
the real message.

import nodemailer from "nodemailer";

const mailer = nodemailer.createTransport({
  host: "smtp.emailens.dev",
  port: 2525, // Or port 587
  secure: false, // Upgrades automatically via STARTTLS
  requireTLS: true,
  auth: {
    user: process.env.EMAILENS_SMTP_USER, // e.g. esmtp_staging_clx9
    pass: process.env.EMAILENS_SMTP_PASS, // Generated per-service password
  },
});

await mailer.sendMail({
  from: '"Acme Auth" <auth@myapp.com>',
  to: "user@example.com", // Safely captured; never escapes to real recipient
  subject: "Your verification code: 492810",
  html: "<p>Your code is <b>492810</b>. Click <a href='https://myapp.com/verify?code=492810'>here</a> to verify.</p>",
});

import { test, expect } from "@playwright/test";

test("signup flow extracts OTP and finishes onboarding", async ({ page }) => {
  const inboxId = process.env.EMAILENS_INBOX_ID;
  const apiKey = process.env.EMAILENS_API_KEY;

  // 1. Trigger signup in your web UI
  await page.goto("https://myapp.com/signup");
  await page.fill('input[name="email"]', "test-runner@try.emailens.dev");
  await page.click('button[type="submit"]');

  // 2. Long-poll Emailens Sandbox until the confirmation email arrives
  const waitRes = await fetch(
    `https://app.emailens.dev/api/sandbox/v1/messages/wait?inboxId=${inboxId}&timeout=30&subject=verification`,
    { headers: { Authorization: `Bearer ${apiKey}` } }
  );
  expect(waitRes.ok).toBeTruthy();
  const { message } = await waitRes.json();

  // 3. Immediately use the regex-extracted OTP code
  expect(message.otp).toBeDefined(); // e.g. "492810"
  await page.fill('input[name="code"]', message.otp);
  await page.click('button[type="submit"]');

  await expect(page).toHaveURL("https://myapp.com/welcome");
});

# In your .env file:
MAIL_MAILER=smtp
MAIL_HOST=smtp.emailens.dev
MAIL_PORT=2525
MAIL_USERNAME=esmtp_laravel_worker
MAIL_PASSWORD=your_secure_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS="no-reply@myapp.local"
MAIL_FROM_NAME="My App Dev"

{
  "mcpServers": {
    "emailens": {
      "url": "https://app.emailens.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer ek_live_..."
      }
    }
  }
}