The temp email API built for your test suite

// __tests__/signup.test.ts  (Jest + fetch)
import { describe, it, expect } from '@jest/globals';

const BASE = 'https://api.openinbox.io/api';
const KEY = process.env.OPENINBOX_API_KEY!; // premium key — needed to poll

describe('User signup flow', () => {
  it('sends a verification email and confirms the account', async () => {
    // 1 — Create a disposable inbox (no auth required)
    const inbox = await fetch(`${BASE}/inbox`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
    }).then(r => r.json());

    // 2 — Register with the temp address
    await fetch('https://yourapp.com/api/register', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        email: inbox.email,
        password: 'Test1234!',
      }),
    });

    // 3 — Poll for the verification email (X-API-KEY required)
    let emails: any[] = [];
    for (let i = 0; i < 10; i++) {
      await new Promise(r => setTimeout(r, 3000));
      const res = await fetch(
        `${BASE}/inbound/api/emails?inboxEmail=${encodeURIComponent(inbox.email)}`,
        { headers: { 'X-API-KEY': KEY } },
      ).then(r => r.json());
      emails = res.emails ?? [];
      if (emails.length) break;
    }

    expect(emails.length).toBeGreaterThan(0);
    expect(emails[0].subject).toContain('Verify');

    // 4 — Extract the OTP from the email body with a regex
    const otp = emails[0].textBody?.match(/\b\d{4,8}\b/)?.[0];
    expect(otp).toBeDefined();

    // 5 — Confirm account
    const confirm = await fetch('https://yourapp.com/api/verify', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ email: inbox.email, code: otp }),
    }).then(r => r.json());

    expect(confirm.verified).toBe(true);
  });
});