@bencibro/tempmail-mcp 0.0.1

package/dist/providers/auto-register.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Auto-registration result — pure API, no browser needed.
+ */
+export interface AutoRegisterResult {
+    /** The API key / token to use with the provider. */
+    apiKey: string;
+    /** The provider name ("maildrop" or "mail.cx"). */
+    provider: string;
+    /** The email address used for registration (if applicable). */
+    email: string;
+    /** ISO timestamp of registration. */
+    registeredAt: string;
+    /** Provider-specific metadata (e.g. private key for maildrop). */
+    metadata?: Record<string, string>;
+}
+/**
+ * MailDrop uses RSA Public-Key authentication.
+ *
+ * Registration flow (all pure HTTP + Node.js crypto):
+ * 1. Generate RSA 2048 keypair (RSASSA-PKCS1-v1_5, SHA-256)
+ * 2. POST /api/register.php { username, pubkey, auth_type: "pubkey" }
+ * 3. Sign timestamp-username to create a passcode
+ * 4. POST /api/login.php { username, pubkey: passcode } → sets session cookie
+ * 5. GET /account (with session cookie) or POST /api/create_api_key.php → get API key
+ *
+ * All crypto is done with Node's built-in `crypto` module — no browser needed.
+ */
+export declare function autoRegisterMailDrop(options?: {
+    username?: string;
+    timeoutMs?: number;
+}): Promise<AutoRegisterResult>;
+export declare function autoRegisterMailCx(options?: {
+    tokenName?: string;
+    timeoutMs?: number;
+}): Promise<AutoRegisterResult>;
+/**
+ * Auto-register on a provider and obtain an API key/token.
+ * Dispatches to the appropriate registration function based on provider name.
+ */
+export declare function autoRegister(provider: "maildrop" | "mail.cx", options?: {
+    username?: string;
+    tokenName?: string;
+    timeoutMs?: number;
+}): Promise<AutoRegisterResult>;
+//# sourceMappingURL=auto-register.d.ts.map

package/dist/providers/auto-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-register.d.ts","sourceRoot":"","sources":["../../src/providers/auto-register.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAID;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmJ9B;AAmBD,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmG9B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,kBAAkB,CAAC,CAW7B"}

package/dist/providers/auto-register.js

@@ -0,0 +1,249 @@
+import { generateKeyPairSync, createSign, } from "node:crypto";
+import { sleep, randomString, stripHtml } from "../utils.js";
+// ─── MailDrop auto-registration ────────────────────────────────────────────
+/**
+ * MailDrop uses RSA Public-Key authentication.
+ *
+ * Registration flow (all pure HTTP + Node.js crypto):
+ * 1. Generate RSA 2048 keypair (RSASSA-PKCS1-v1_5, SHA-256)
+ * 2. POST /api/register.php { username, pubkey, auth_type: "pubkey" }
+ * 3. Sign timestamp-username to create a passcode
+ * 4. POST /api/login.php { username, pubkey: passcode } → sets session cookie
+ * 5. GET /account (with session cookie) or POST /api/create_api_key.php → get API key
+ *
+ * All crypto is done with Node's built-in `crypto` module — no browser needed.
+ */
+export async function autoRegisterMailDrop(options) {
+    const username = options?.username ?? `tmp_${randomString(10)}`;
+    const timeoutMs = options?.timeoutMs ?? 60_000;
+    const deadline = Date.now() + timeoutMs;
+    const base = "https://maildrop.cx";
+    // Step 1: Generate RSA 2048 keypair
+    // Store as KeyObject for signing, and export to base64 DER for API upload
+    const { publicKey, privateKey } = generateKeyPairSync("rsa", {
+        modulusLength: 2048,
+        publicKeyEncoding: {
+            type: "spki",
+            format: "der",
+        },
+        privateKeyEncoding: {
+            type: "pkcs8",
+            format: "der",
+        },
+    });
+    // Convert to base64 (matching the browser's exportKey("spki") → base64)
+    const publicKeyBase64 = Buffer.from(publicKey).toString("base64");
+    const privateKeyBase64 = Buffer.from(privateKey).toString("base64");
+    // Re-import private key as KeyObject for signing
+    const privKeyObj = await import("node:crypto").then((m) => m.createPrivateKey({
+        key: Buffer.from(privateKeyBase64, "base64"),
+        format: "der",
+        type: "pkcs8",
+    }));
+    // Step 2: Register
+    const regRes = await fetch(`${base}/api/register.php`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Origin: base,
+            Referer: `${base}/app`,
+        },
+        body: JSON.stringify({
+            username,
+            pubkey: publicKeyBase64,
+            auth_type: "pubkey",
+        }),
+    });
+    const regData = await regRes.json().catch(() => ({}));
+    if (!regData.success) {
+        throw new Error(`MailDrop registration failed: ${regData.error || regRes.statusText}`);
+    }
+    // Step 3: Generate passcode (sign timestamp-username with RSA-SHA256)
+    const timestamp = Math.floor(Date.now() / 1000);
+    const dataToSign = `${timestamp}-${username}`;
+    const signer = createSign("RSA-SHA256");
+    signer.update(dataToSign);
+    signer.end();
+    const signature = signer.sign(privKeyObj);
+    const signatureBase64 = signature.toString("base64");
+    const dataToSignBase64 = Buffer.from(dataToSign).toString("base64");
+    const passcode = `${signatureBase64}&&${dataToSignBase64}`;
+    // Step 4: Login (get session cookie)
+    const loginRes = await fetch(`${base}/api/login.php`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Origin: base,
+            Referer: `${base}/app`,
+        },
+        body: JSON.stringify({ username, pubkey: passcode }),
+    });
+    const loginData = await loginRes.json().catch(() => ({}));
+    if (!loginData.success) {
+        throw new Error(`MailDrop login failed: ${loginData.error || loginRes.statusText}`);
+    }
+    // Extract session cookie from Set-Cookie header
+    const setCookie = loginRes.headers.get("set-cookie") || "";
+    const cookies = setCookie
+        .split(",")
+        .map((c) => c.trim().split(";")[0])
+        .filter(Boolean)
+        .join("; ");
+    if (Date.now() >= deadline)
+        throw new Error("MailDrop registration timed out");
+    // Step 5: Create an API key via /api/account/keys.php
+    const commonHeaders = {
+        Cookie: cookies,
+        "Content-Type": "application/json",
+        Origin: base,
+        Referer: `${base}/account`,
+    };
+    // First, check if there are existing keys
+    const keysListRes = await fetch(`${base}/api/account/keys.php`, {
+        headers: commonHeaders,
+    });
+    const keysList = await keysListRes.json().catch(() => ({}));
+    let apiKey = null;
+    // Check if we already have a key
+    if (keysList.keys && keysList.keys.length > 0) {
+        apiKey = keysList.keys[0].api_key;
+    }
+    // If no existing key, create one
+    if (!apiKey) {
+        const createKeyRes = await fetch(`${base}/api/account/keys.php`, {
+            method: "POST",
+            headers: commonHeaders,
+            body: JSON.stringify({ action: "create" }),
+        });
+        const createKeyData = await createKeyRes.json().catch(() => ({}));
+        if (createKeyData.api_key) {
+            apiKey = createKeyData.api_key;
+        }
+    }
+    if (!apiKey) {
+        throw new Error("MailDrop registration succeeded but could not obtain API key. " +
+            "You can try logging in manually at https://maildrop.cx/app to get your API key.");
+    }
+    return {
+        apiKey,
+        provider: "maildrop",
+        email: `${username}@maildrop.cc`,
+        registeredAt: new Date().toISOString(),
+        metadata: {
+            privateKey: privateKeyBase64,
+            username,
+            note: "Save the private key to re-login later. Store it securely.",
+        },
+    };
+}
+// ─── mail.cx auto-registration ─────────────────────────────────────────────
+/**
+ * mail.cx uses a magic-link sign-in flow.
+ *
+ * Registration flow (all pure HTTP, no browser needed):
+ * 1. Create a temp mailbox via mail.tm (no key needed)
+ * 2. POST https://mail.cx/v1/auth/magic-link/request { email } → sends magic link
+ * 3. Poll mail.tm for the magic link email, extract the token
+ * 4. POST https://mail.cx/v1/auth/magic-link/verify { token } → returns API token directly
+ *
+ * The verify endpoint returns the API token (tm_live_...) in the response body —
+ * no need to create a separate token or use session cookies.
+ */
+import { MailTmProvider } from "./mail-tm.js";
+export async function autoRegisterMailCx(options) {
+    const tokenName = options?.tokenName ?? "tempmail-mcp";
+    const timeoutMs = options?.timeoutMs ?? 120_000;
+    const deadline = Date.now() + timeoutMs;
+    // Step 1: Create a temp mailbox via mail.tm
+    const mailTm = new MailTmProvider();
+    const mailbox = await mailTm.createMailbox({});
+    const email = mailbox.address;
+    // Step 2: Request magic link from mail.cx
+    const magicRes = await fetch("https://mail.cx/v1/auth/magic-link/request", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ email }),
+    });
+    if (!magicRes.ok) {
+        const text = await magicRes.text().catch(() => "");
+        throw new Error(`mail.cx magic link request failed: ${magicRes.status} ${text}`);
+    }
+    const magicData = await magicRes.json().catch(() => ({}));
+    // mail.cx should return some kind of request_id or just { success: true }
+    // Step 3: Poll mail.tm for the magic link email
+    let magicLink = "";
+    const startWait = Date.now();
+    while (Date.now() - startWait < 90_000 && Date.now() < deadline) {
+        const messages = await mailTm.getMessages(mailbox);
+        if (messages.length > 0) {
+            const full = await mailTm.getMessage(mailbox, messages[0].id);
+            const body = full.bodyText || (full.bodyHtml ? stripHtml(full.bodyHtml) : "") || "";
+            // Look for mail.cx magic link URL
+            const match = body.match(/https:\/\/mail\.cx\/magic[^\s"'<>\\]+/i);
+            if (match) {
+                magicLink = match[0];
+                break;
+            }
+        }
+        await sleep(3_000);
+    }
+    if (!magicLink) {
+        throw new Error("Timed out waiting for mail.cx magic link email");
+    }
+    // Step 4: Extract the token from the magic link URL
+    const tokenMatch = magicLink.match(/token=([a-f0-9]+)/i);
+    if (!tokenMatch) {
+        throw new Error(`Could not extract token from magic link URL: ${magicLink}`);
+    }
+    const magicToken = tokenMatch[1];
+    // Step 5: Verify the magic link token — this returns the API token directly
+    const verifyRes = await fetch("https://mail.cx/v1/auth/magic-link/verify", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ token: magicToken }),
+    });
+    if (!verifyRes.ok) {
+        const text = await verifyRes.text().catch(() => "");
+        throw new Error(`mail.cx magic link verification failed: ${verifyRes.status} ${text}`);
+    }
+    const verifyData = await verifyRes.json().catch(() => ({}));
+    let apiToken = null;
+    if (verifyData.token) {
+        apiToken = verifyData.token;
+    }
+    else if (verifyData.data?.token) {
+        apiToken = verifyData.data.token;
+    }
+    else if (verifyData.api_token) {
+        apiToken = verifyData.api_token;
+    }
+    if (!apiToken) {
+        throw new Error("mail.cx magic link verification succeeded but no API token in response. " +
+            "Response: " + JSON.stringify(verifyData));
+    }
+    return {
+        apiKey: apiToken,
+        provider: "mail.cx",
+        email,
+        registeredAt: new Date().toISOString(),
+        metadata: {
+            tempMailbox: mailbox.address,
+            note: "The temp mailbox was used only to receive the magic link.",
+        },
+    };
+}
+/**
+ * Auto-register on a provider and obtain an API key/token.
+ * Dispatches to the appropriate registration function based on provider name.
+ */
+export async function autoRegister(provider, options) {
+    switch (provider) {
+        case "maildrop":
+            return autoRegisterMailDrop(options);
+        case "mail.cx":
+            return autoRegisterMailCx(options);
+        default:
+            throw new Error(`Auto-registration not supported for provider "${provider}". Supported: maildrop, mail.cx`);
+    }
+}
+//# sourceMappingURL=auto-register.js.map

package/dist/providers/auto-register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-register.js","sourceRoot":"","sources":["../../src/providers/auto-register.ts"],"names":[],"mappings":"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"}

package/dist/providers/catchmail.d.ts

@@ -0,0 +1,20 @@
+import type { TempMailbox, EmailMessage, CreateMailboxParams } from "../types.js";
+import { BaseProvider } from "../base-provider.js";
+/**
+ * Catchmail provider — free, no auth required for public endpoints.
+ * API docs: https://catchmail.io/docs
+ * Rate limit: 1 req/s per IP (anonymous).
+ * Custom domains supported via MX records.
+ */
+export declare class CatchmailProvider extends BaseProvider {
+    readonly name = "catchmail";
+    readonly description = "Free temporary email via catchmail.io. No API key required. Supports custom domains via MX records.";
+    readonly requiresApiKey = false;
+    private baseUrl;
+    getDomains(): Promise<string[]>;
+    createMailbox(params: CreateMailboxParams): Promise<TempMailbox>;
+    getMessages(mailbox: TempMailbox): Promise<EmailMessage[]>;
+    getMessage(mailbox: TempMailbox, messageId: string): Promise<EmailMessage>;
+    deleteMailbox(mailbox: TempMailbox): Promise<void>;
+}
+//# sourceMappingURL=catchmail.d.ts.map

package/dist/providers/catchmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catchmail.d.ts","sourceRoot":"","sources":["../../src/providers/catchmail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,yGACoF;IACxG,QAAQ,CAAC,cAAc,SAAS;IAEhC,OAAO,CAAC,OAAO,CAA8B;IAEvC,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/B,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAahE,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2B1D,UAAU,CACd,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;IAyClB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAWzD"}

package/dist/providers/catchmail.js

@@ -0,0 +1,79 @@
+import { BaseProvider } from "../base-provider.js";
+import { randomUsername } from "../utils.js";
+/**
+ * Catchmail provider — free, no auth required for public endpoints.
+ * API docs: https://catchmail.io/docs
+ * Rate limit: 1 req/s per IP (anonymous).
+ * Custom domains supported via MX records.
+ */
+export class CatchmailProvider extends BaseProvider {
+    name = "catchmail";
+    description = "Free temporary email via catchmail.io. No API key required. Supports custom domains via MX records.";
+    requiresApiKey = false;
+    baseUrl = "https://api.catchmail.io";
+    async getDomains() {
+        // Catchmail uses a single public domain + any custom domain with MX setup
+        return ["catchmail.io"];
+    }
+    async createMailbox(params) {
+        const username = params.username || randomUsername();
+        const domain = params.domain || "catchmail.io";
+        const address = `${username}@${domain}`;
+        // Catchmail doesn't require account creation — any address works.
+        return {
+            address,
+            provider: this.name,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async getMessages(mailbox) {
+        const url = new URL(`${this.baseUrl}/api/v1/mailbox`);
+        url.searchParams.set("address", mailbox.address);
+        const res = await fetch(url);
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`Catchmail API error ${res.status}: ${text || res.statusText}`);
+        }
+        const data = (await res.json());
+        return (data.messages ?? []).map((m) => ({
+            id: m.id,
+            from: m.from,
+            subject: m.subject,
+            date: m.date,
+        }));
+    }
+    async getMessage(mailbox, messageId) {
+        const url = new URL(`${this.baseUrl}/api/v1/message/${messageId}`);
+        url.searchParams.set("mailbox", mailbox.address);
+        const res = await fetch(url);
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`Catchmail API error ${res.status}: ${text || res.statusText}`);
+        }
+        const m = (await res.json());
+        return {
+            id: m.id,
+            from: m.from,
+            subject: m.subject,
+            date: m.date,
+            bodyText: m.body?.text,
+            bodyHtml: m.body?.html,
+            attachments: m.attachments?.map((a) => ({
+                filename: a.filename,
+                contentType: a.content_type,
+                size: a.size,
+                downloadUrl: a.download_url,
+            })),
+        };
+    }
+    async deleteMailbox(mailbox) {
+        // Delete all messages in the mailbox
+        const messages = await this.getMessages(mailbox);
+        for (const msg of messages) {
+            const url = new URL(`${this.baseUrl}/api/v1/message/${msg.id}`);
+            url.searchParams.set("mailbox", mailbox.address);
+            await fetch(url, { method: "DELETE" });
+        }
+    }
+}
+//# sourceMappingURL=catchmail.js.map

package/dist/providers/catchmail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catchmail.js","sourceRoot":"","sources":["../../src/providers/catchmail.ts"],"names":[],"mappings":"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"}

package/dist/providers/guerrillamail.d.ts

@@ -0,0 +1,21 @@
+import type { TempMailbox, EmailMessage, CreateMailboxParams } from "../types.js";
+import { BaseProvider } from "../base-provider.js";
+/**
+ * Guerrilla Mail provider — free, session-based.
+ * API docs: https://www.guerrillamail.com/GuerrillaMailAPI.html
+ * Uses PHPSESSID cookie for session management.
+ * Emails expire after 60 minutes.
+ */
+export declare class GuerrillaMailProvider extends BaseProvider {
+    readonly name = "guerrillamail";
+    readonly description = "Free temporary email via Guerrilla Mail. Session-based, 60 min expiry. No API key required.";
+    readonly requiresApiKey = false;
+    private baseUrl;
+    private api;
+    getDomains(): Promise<string[]>;
+    createMailbox(params: CreateMailboxParams): Promise<TempMailbox>;
+    getMessages(mailbox: TempMailbox): Promise<EmailMessage[]>;
+    getMessage(mailbox: TempMailbox, messageId: string): Promise<EmailMessage>;
+    deleteMailbox(mailbox: TempMailbox): Promise<void>;
+}
+//# sourceMappingURL=guerrillamail.d.ts.map

package/dist/providers/guerrillamail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guerrillamail.d.ts","sourceRoot":"","sources":["../../src/providers/guerrillamail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,iGAC4E;IAChG,QAAQ,CAAC,cAAc,SAAS;IAEhC,OAAO,CAAC,OAAO,CAA4C;YAE7C,GAAG;IAuBX,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAe/B,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAmChE,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA0B1D,UAAU,CACd,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;IAuBlB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAQzD"}

package/dist/providers/guerrillamail.js

@@ -0,0 +1,114 @@
+import { BaseProvider } from "../base-provider.js";
+import { randomUsername } from "../utils.js";
+/**
+ * Guerrilla Mail provider — free, session-based.
+ * API docs: https://www.guerrillamail.com/GuerrillaMailAPI.html
+ * Uses PHPSESSID cookie for session management.
+ * Emails expire after 60 minutes.
+ */
+export class GuerrillaMailProvider extends BaseProvider {
+    name = "guerrillamail";
+    description = "Free temporary email via Guerrilla Mail. Session-based, 60 min expiry. No API key required.";
+    requiresApiKey = false;
+    baseUrl = "https://api.guerrillamail.com/ajax.php";
+    async api(params, method = "GET", sessionId) {
+        const url = new URL(this.baseUrl);
+        for (const [k, v] of Object.entries(params)) {
+            url.searchParams.set(k, v);
+        }
+        const headers = {};
+        if (sessionId) {
+            headers["Cookie"] = `PHPSESSID=${sessionId}`;
+        }
+        const res = await fetch(url, { method, headers });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`Guerrilla Mail API error ${res.status}: ${text || res.statusText}`);
+        }
+        return res.json();
+    }
+    async getDomains() {
+        // Guerrilla Mail has fixed domains
+        return [
+            "guerrillamail.com",
+            "guerrillamailblock.com",
+            "grr.la",
+            "sharklasers.com",
+            "guerrillamail.net",
+            "guerrillamail.org",
+            "guerrillamail.biz",
+            "spam4.me",
+            "pokemail.net",
+        ];
+    }
+    async createMailbox(params) {
+        // Initialize session
+        const init = await this.api({
+            f: "get_email_address",
+            lang: "en",
+        });
+        const sessionId = init.sid_token;
+        let address = init.email_addr;
+        // If user wants a custom username, set it
+        if (params.username || params.domain) {
+            const username = params.username || randomUsername();
+            const domains = await this.getDomains();
+            const domain = params.domain && domains.includes(params.domain)
+                ? params.domain
+                : "guerrillamailblock.com";
+            const setResult = await this.api({ f: "set_email_user", email_user: username, lang: "en" }, "POST", sessionId);
+            address = setResult.email_addr;
+        }
+        return {
+            address,
+            provider: this.name,
+            sessionId,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async getMessages(mailbox) {
+        if (!mailbox.sessionId) {
+            throw new Error("No session ID for Guerrilla Mail mailbox");
+        }
+        const data = await this.api({ f: "check_email", seq: "0" }, "GET", mailbox.sessionId);
+        return (data.list ?? []).map((m) => ({
+            id: m.mail_id,
+            from: m.mail_from,
+            subject: decodeHtmlEntities(m.mail_subject),
+            bodyText: decodeHtmlEntities(m.mail_excerpt),
+            date: m.mail_date || new Date(m.mail_timestamp * 1000).toISOString(),
+        }));
+    }
+    async getMessage(mailbox, messageId) {
+        if (!mailbox.sessionId) {
+            throw new Error("No session ID for Guerrilla Mail mailbox");
+        }
+        const m = await this.api({ f: "fetch_email", email_id: messageId }, "GET", mailbox.sessionId);
+        return {
+            id: m.mail_id,
+            from: m.mail_from,
+            subject: decodeHtmlEntities(m.mail_subject),
+            bodyText: decodeHtmlEntities(m.mail_body),
+            bodyHtml: m.mail_body,
+            date: m.mail_date || new Date(m.mail_timestamp * 1000).toISOString(),
+        };
+    }
+    async deleteMailbox(mailbox) {
+        if (!mailbox.sessionId)
+            return;
+        await this.api({ f: "forget_me", email_addr: mailbox.address }, "POST", mailbox.sessionId);
+    }
+}
+/**
+ * Decode HTML entities (Guerrilla Mail escapes subject/excerpt).
+ */
+function decodeHtmlEntities(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, " ");
+}
+//# sourceMappingURL=guerrillamail.js.map

package/dist/providers/guerrillamail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guerrillamail.js","sourceRoot":"","sources":["../../src/providers/guerrillamail.ts"],"names":[],"mappings":"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"}

package/dist/providers/mail-cx.d.ts

@@ -0,0 +1,30 @@
+import type { TempMailbox, EmailMessage, CreateMailboxParams } from "../types.js";
+import { BaseProvider } from "../base-provider.js";
+/**
+ * Mail.cx provider — requires API token (free tier: 500 req/day).
+ * API docs: https://mail.cx/api-docs/
+ * Supports long-poll and SSE push. Mail kept for 1 hour.
+ *
+ * This adapter uses long-poll for waitForEmail, which is more efficient
+ * than the base class polling.
+ */
+export declare class MailCxProvider extends BaseProvider {
+    readonly name = "mail.cx";
+    readonly description = "Temporary email via mail.cx. Free tier: 500 req/day. Supports long-poll. Requires API token.";
+    readonly requiresApiKey = true;
+    private baseUrl;
+    private apiToken;
+    constructor(apiToken?: string);
+    private getHeaders;
+    private api;
+    getDomains(): Promise<string[]>;
+    createMailbox(params: CreateMailboxParams): Promise<TempMailbox>;
+    getMessages(mailbox: TempMailbox): Promise<EmailMessage[]>;
+    getMessage(_mailbox: TempMailbox, messageId: string): Promise<EmailMessage>;
+    /**
+     * Override waitForEmail to use mail.cx long-poll (more efficient).
+     */
+    waitForEmail(mailbox: TempMailbox, options?: import("../types.js").WaitForEmailOptions): Promise<EmailMessage>;
+    deleteMailbox(mailbox: TempMailbox): Promise<void>;
+}
+//# sourceMappingURL=mail-cx.d.ts.map

package/dist/providers/mail-cx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-cx.d.ts","sourceRoot":"","sources":["../../src/providers/mail-cx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;GAOG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,kGAC6E;IACjG,QAAQ,CAAC,cAAc,QAAQ;IAE/B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,QAAQ,CAAC,EAAE,MAAM;IAK7B,OAAO,CAAC,UAAU;YAQJ,GAAG;IA6BX,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQ/B,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBhE,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqB1D,UAAU,CACd,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;IA8BxB;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,OAAO,aAAa,EAAE,mBAAmB,GAClD,OAAO,CAAC,YAAY,CAAC;IA6DlB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzD"}