Email-aware QA pipelines, without the ops burden.

# conftest.py
import os, pytest
from catchotp import CatchOTP

@pytest.fixture(scope="session")
def otp_client():
    return CatchOTP(api_key=os.environ["CATCHOTP_KEY"])

@pytest.fixture
def inbox(otp_client):
    """One inbox per test. TTL handles cleanup."""
    box = otp_client.inboxes.create(mode="ephemeral", ttl_minutes=15)
    yield box
    otp_client.inboxes.delete(box.id)

# tests/test_password_reset.py
def test_password_reset_email_arrives(otp_client, inbox, http):
    # 1. Trigger the reset flow against your QA environment
    http.post("/api/auth/forgot-password", json={"email": inbox.address})

    # 2. Block until the reset email lands
    msg = otp_client.messages.wait_for(
        inbox.id, subject_regex=r"reset your password", timeout_seconds=30
    )
    assert msg.from_ == "noreply@yourapp.com"

    # 3. Pull the reset URL out of the parsed body
    reset_url = next(l.url for l in msg.links if "/reset?" in l.url)

    # 4. Drive the rest of the flow
    new_pwd = "n3w-securE-pwd!"
    resp = http.post(reset_url, data={"password": new_pwd})
    assert resp.status_code == 200

// Optional: set up a webhook so your CI tool gets notified directly
// instead of polling. Useful for long-running QA suites.
import { CatchOTP } from '@catchotp/sdk';
const otp = new CatchOTP({ apiKey: process.env.CATCHOTP_KEY });

await otp.webhooks.create({
  inboxId: 'inbox_01HK...',
  url: 'https://qa.yourapp.com/hooks/email-arrived',
  events: ['message.received', 'otp.parsed'],
  // Sign requests with this secret so your handler can verify origin
  secret: process.env.WEBHOOK_SECRET,
});

// Your TestRail or Xray integration can then file a result
// based on the webhook payload.