zerodrop / zerodrop

v0.1.0 2026-07-13 22:05 UTC

Requires

• php: >=8.1
• ext-curl: *
• ext-json: *

MIT

• ZeroDrop

• testing
• phpunit
• email
• ci
• otp
• pest
• e2e
• laravel-dusk
• email-verification
• magic-link

Published on Packagist.org on 2026-07-13 22:12 UTC

README

Email verification infrastructure for CI pipelines.

Send a verification email. Catch it at the edge. Get $email->otp and $email->magicLink back — auto-extracted, no regex, no Docker, no signup.

$email = $mail->waitForLatest($inbox, timeout: 15);

$email->otp;       // "123456" — auto-extracted
$email->magicLink; // "https://..." — no regex needed

Documentation · GitHub · Status

Install

composer require --dev zerodrop/zerodrop

PHP 8.1+ · ext-curl · ext-json — no other dependencies.

Quick start

use ZeroDrop\Client;

$mail = new Client();
$inbox = $mail->generateInbox();
// => "[e-mail]"

// Trigger your app's email flow with the inbox address...

$email = $mail->waitForLatest($inbox, timeout: 15);

$email->subject;   // "Verify your email"
$email->otp;       // "123456" — auto-extracted, no regex
$email->magicLink; // "https://..." — auto-extracted

PHPUnit

use PHPUnit\Framework\TestCase;
use ZeroDrop\Client;

final class SignupTest extends TestCase
{
    public function testEmailVerification(): void
    {
        $mail = new Client();
        $inbox = $mail->generateInbox();

        // Trigger signup with $inbox...

        $email = $mail->waitForLatest($inbox, timeout: 15);

        $this->assertNotNull($email->otp);
        $this->assertMatchesRegularExpression('/^\d{6}$/', $email->otp);
    }
}

Pest

use ZeroDrop\Client;

it('verifies the account via emailed OTP', function () {
    $mail = new Client();
    $inbox = $mail->generateInbox();

    // Trigger signup with $inbox...

    $email = $mail->waitForLatest($inbox, timeout: 15);

    expect($email->otp)->not->toBeNull()
        ->and($email->otp)->toMatch('/^\d{6}$/');
});

Laravel Dusk

use Laravel\Dusk\Browser;
use ZeroDrop\Client;

public function testSignupEmailVerification(): void
{
    $mail = new Client();
    $inbox = $mail->generateInbox();

    $this->browse(function (Browser $browser) use ($mail, $inbox) {
        $browser->visit('/signup')
                ->type('email', $inbox)
                ->type('password', 'TestPassword123!')
                ->press('Create account');

        $email = $mail->waitForLatest($inbox, timeout: 15);

        $browser->type('otp', $email->otp)
                ->press('Verify')
                ->assertPathIs('/dashboard');
    });
}

Email filtering

use ZeroDrop\Filter;

$email = $mail->waitForLatest(
    $inbox,
    timeout: 15,
    filter: new Filter(
        from: '[e-mail]',
        subject: 'Verify',
        hasOtp: true,
    ),
);

All string filters are case-insensitive partial matches.

Magic link flows

$email = $mail->waitForLatest(
    $inbox,
    timeout: 15,
    filter: new Filter(hasMagicLink: true),
);

$browser->visit($email->magicLink)
        ->assertPathIs('/dashboard');

Parallel test runs

generateInbox() runs locally — no network request, no collisions. Safe with Paratest and parallel Dusk runs; every call returns a unique isolated inbox.

Error handling

use ZeroDrop\Exception\TimeoutException;
use ZeroDrop\Exception\AuthException;
use ZeroDrop\Exception\NetworkException;

try {
    $email = $mail->waitForLatest($inbox, timeout: 15);
} catch (TimeoutException $e) {
    // No email arrived — check your app is sending correctly
} catch (AuthException $e) {
    // Invalid API key
} catch (NetworkException $e) {
    // Transport failure — message includes status page link
}

Workspaces

$mail = new Client(apiKey: getenv('ZERODROP_API_KEY'));

Self-hosted

$mail = new Client(baseUrl: 'https://your-instance.yourdomain.com');

API

Method	Description
new Client(?string $apiKey, string $baseUrl)	Create a client. No args = free sandbox mode.
generateInbox(): string	Instant inbox address. No network request.
fetchLatest(string $inbox, ?Filter $filter): ?Email	Latest matching email or null.
waitForLatest(string $inbox, float $timeout, float $pollInterval, ?Filter $filter): Email	Block until email arrives.

Free vs Workspace

	Free	Workspace
Inbox generation	✓	✓
OTP auto-extraction	✓	✓
Magic link extraction	✓	✓
Email filtering	✓	✓
Email retention	30 min	Extended
Custom domains	✗	✓

Get a Workspace at zerodrop.dev

License

MIT