npm install zerodrop-client

import { ZeroDrop } from 'zerodrop-client';

const mail = new ZeroDrop(apiKey?, options?);

mail.generateInbox(): string

const inbox = mail.generateInbox();
// "swift-x7k2m@zerodrop-sandbox.online" without a key
// "k7x2-swift-x7k2m@zerodrop-sandbox.online" with the key zd_k7x2_…

mail.waitForLatest(inbox: string, options?): Promise<ZeroDropEmail>

// Default — SSE, 10s timeout
const email = await mail.waitForLatest(inbox);

// Custom timeout
const email = await mail.waitForLatest(inbox, { timeout: 30000 });

// Force polling
const email = await mail.waitForLatest(inbox, { sse: false });

mail.fetchLatest(inbox: string, filter?: ZeroDropFilter): Promise<ZeroDropEmail | null>

const email = await mail.fetchLatest(inbox);
if (email) {
  console.log(email.subject);
}

interface ZeroDropEmail {
  id: string;           // Unique message ID
  from: string;         // Sender address
  to: string;           // Recipient address
  subject: string;      // Email subject
  body: string;         // Parsed plain-text body
  rawBody: string;      // Full raw MIME message
  receivedAt: Date;     // UTC timestamp
  otp: string | null;   // Auto-extracted OTP code (4-8 digits)
  magicLink: string | null; // Auto-extracted verification/reset link
}

const email = await mail.waitForLatest(inbox);
console.log(email.otp); // "123456" or null

console.log(email.magicLink); // "https://app.com/verify?token=abc" or null

import { ZeroDropTimeoutError } from 'zerodrop-client';

try {
  const email = await mail.waitForLatest(inbox, { timeout: 10000 });
} catch (err) {
  if (err instanceof ZeroDropTimeoutError) {
    console.log('No email received in time');
  }
}

import { ZeroDropHeldError } from 'zerodrop-client';

try {
  const email = await mail.waitForLatest(inbox);
} catch (err) {
  if (err instanceof ZeroDropHeldError) {
    console.log(err.message); // why, and how to get a free key
  }
}

import { ZeroDropNetworkError } from 'zerodrop-client';

try {
  const email = await mail.fetchLatest(inbox);
} catch (err) {
  if (err instanceof ZeroDropNetworkError) {
    console.log('Network error — check https://zerodrop.instatus.com');
  }
}