zerodrop-java

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 email = mail.waitForLatest(inbox, Duration.ofSeconds(15));

email.otp();       // Optional["123456"] — auto-extracted
email.magicLink(); // Optional["https://..."] — no regex needed

Documentation · GitHub · Status

Install

Gradle:

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    testImplementation 'com.github.zerodrop-dev:zerodrop-java:v0.1.0'
}

Maven:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.github.zerodrop-dev</groupId>
    <artifactId>zerodrop-java</artifactId>
    <version>v0.1.0</version>
    <scope>test</scope>
</dependency>

Java 11+ · one dependency (Gson).

Quick start

import dev.zerodrop.ZeroDrop;
import dev.zerodrop.Email;
import java.time.Duration;

ZeroDrop mail = ZeroDrop.create();
String inbox = mail.generateInbox();
// => "swift-x7k29ab@zerodrop-sandbox.online"

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

Email email = mail.waitForLatest(inbox, Duration.ofSeconds(15));

email.subject();   // "Verify your email"
email.otp();       // Optional["123456"] — auto-extracted, no regex
email.magicLink(); // Optional["https://..."] — auto-extracted

JUnit 5 + Selenium

import dev.zerodrop.ZeroDrop;
import dev.zerodrop.Email;
import org.junit.jupiter.api.Test;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;

import java.time.Duration;

import static org.junit.jupiter.api.Assertions.*;

class SignupTest {
    private final ZeroDrop mail = ZeroDrop.create();

    @Test
    void emailVerificationWithOtp() {
        String inbox = mail.generateInbox();

        driver.get("https://yourapp.com/signup");
        driver.findElement(By.name("email")).sendKeys(inbox);
        driver.findElement(By.name("password")).sendKeys("TestPassword123!");
        driver.findElement(By.cssSelector("button[type=submit]")).click();

        Email email = mail.waitForLatest(inbox, Duration.ofSeconds(15));

        String otp = email.otp().orElseThrow(
            () -> new AssertionError("expected OTP in verification email"));

        driver.findElement(By.name("otp")).sendKeys(otp);
        driver.findElement(By.cssSelector("button[type=submit]")).click();

        assertTrue(driver.getCurrentUrl().endsWith("/dashboard"));
    }
}

Playwright for Java

import com.microsoft.playwright.*;
import dev.zerodrop.ZeroDrop;
import dev.zerodrop.Email;
import java.time.Duration;

try (Playwright playwright = Playwright.create()) {
    Browser browser = playwright.chromium().launch();
    Page page = browser.newPage();

    ZeroDrop mail = ZeroDrop.create();
    String inbox = mail.generateInbox();

    page.navigate("https://yourapp.com/signup");
    page.fill("[name=email]", inbox);
    page.fill("[name=password]", "TestPassword123!");
    page.click("button[type=submit]");

    Email email = mail.waitForLatest(inbox, Duration.ofSeconds(15));

    page.fill("[name=otp]", email.otp().orElseThrow());
    page.click("button[type=submit]");

    assertThat(page).hasURL("https://yourapp.com/dashboard");
}

Email filtering

import dev.zerodrop.Filter;

Filter filter = Filter.builder()
    .from("noreply@yourapp.com")
    .subject("Verify")
    .hasOtp(true)
    .build();

Email email = mail.waitForLatest(inbox, Duration.ofSeconds(15), filter);

All string filters are case-insensitive partial matches.

Magic link flows

Filter filter = Filter.builder().hasMagicLink(true).build();
Email email = mail.waitForLatest(inbox, Duration.ofSeconds(15), filter);

driver.get(email.magicLink().orElseThrow());
assertTrue(driver.getCurrentUrl().endsWith("/dashboard"));

Parallel test runs

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

Error handling

import dev.zerodrop.ZeroDropException;

try {
    Email email = mail.waitForLatest(inbox, Duration.ofSeconds(15));
} catch (ZeroDropException.Timeout e) {
    // No email arrived — check your app is sending correctly
} catch (ZeroDropException.Auth e) {
    // Invalid API key
} catch (ZeroDropException.Network e) {
    // Transport failure — message includes status page link
}

Workspaces

ZeroDrop mail = ZeroDrop.builder()
    .apiKey(System.getenv("ZERODROP_API_KEY"))
    .build();

Self-hosted

ZeroDrop mail = ZeroDrop.builder()
    .baseUrl("https://your-instance.yourdomain.com")
    .build();

API

Method	Description
ZeroDrop.create()	Client in free sandbox mode.
ZeroDrop.builder()	Configure apiKey / baseUrl / httpClient.
generateInbox()	Instant inbox address. No network request.
fetchLatest(inbox, filter)	Optional<Email> — latest matching email.
waitForLatest(inbox, timeout, filter)	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