@bencibro/tempmail-mcp 0.0.1

package/dist/providers/mail-cx.js

@@ -0,0 +1,154 @@
+import { BaseProvider } from "../base-provider.js";
+import { randomUsername } from "../utils.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 class MailCxProvider extends BaseProvider {
+    name = "mail.cx";
+    description = "Temporary email via mail.cx. Free tier: 500 req/day. Supports long-poll. Requires API token.";
+    requiresApiKey = true;
+    baseUrl = "https://api.mail.cx/v1";
+    apiToken = null;
+    constructor(apiToken) {
+        super();
+        if (apiToken)
+            this.apiToken = apiToken;
+    }
+    getHeaders() {
+        const headers = {};
+        if (this.apiToken) {
+            headers["x-api-token"] = this.apiToken;
+        }
+        return headers;
+    }
+    async api(path, options = {}, timeoutMs) {
+        const controller = new AbortController();
+        const timer = timeoutMs
+            ? setTimeout(() => controller.abort(), timeoutMs)
+            : undefined;
+        try {
+            const res = await fetch(`${this.baseUrl}${path}`, {
+                ...options,
+                headers: { ...this.getHeaders(), ...options.headers },
+                signal: controller.signal,
+            });
+            if (!res.ok && res.status !== 204) {
+                const text = await res.text().catch(() => "");
+                throw new Error(`Mail.cx API error ${res.status}: ${text || res.statusText}`);
+            }
+            if (res.status === 204)
+                return undefined;
+            return res.json();
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    async getDomains() {
+        const data = await this.api("/config");
+        // The config endpoint returns available system domains
+        return data.domains ?? data.mail_domains ?? [];
+    }
+    async createMailbox(params) {
+        const domains = await this.getDomains();
+        const username = (params.username || randomUsername()).toLowerCase();
+        const domain = params.domain && domains.length > 0 && domains.includes(params.domain)
+            ? params.domain
+            : domains[0] ?? "mail.cx";
+        const address = `${username}@${domain}`;
+        // Mail.cx: mailbox is implicit, no creation needed.
+        return {
+            address,
+            provider: this.name,
+            token: this.apiToken ?? undefined,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async getMessages(mailbox) {
+        // Long-poll: block up to 25s for new mail
+        const data = await this.api(`/inbox/${mailbox.address}`, {}, 30_000);
+        return (data.emails ?? []).map((e) => ({
+            id: e.id,
+            from: e.from_email ?? "",
+            subject: e.subject ?? "",
+            bodyText: e.preview_text,
+            date: e.created_at ?? new Date().toISOString(),
+        }));
+    }
+    async getMessage(_mailbox, messageId) {
+        const m = await this.api(`/email/${messageId}`);
+        return {
+            id: m.id,
+            from: m.from_email ?? "",
+            subject: m.subject ?? "",
+            bodyText: m.text,
+            bodyHtml: m.html,
+            date: m.created_at ?? new Date().toISOString(),
+            attachments: m.attachments?.map((a) => ({
+                filename: a.filename,
+                contentType: a.content_type,
+                size: a.size,
+            })),
+        };
+    }
+    /**
+     * Override waitForEmail to use mail.cx long-poll (more efficient).
+     */
+    async waitForEmail(mailbox, options) {
+        const opts = {
+            subjectContains: options?.subjectContains ?? "",
+            fromContains: options?.fromContains ?? "",
+            timeoutMs: options?.timeoutMs ?? 60_000,
+            pollIntervalMs: options?.pollIntervalMs ?? 25_000, // mail.cx long-poll is 25s
+        };
+        const deadline = Date.now() + opts.timeoutMs;
+        let since;
+        while (Date.now() < deadline) {
+            let path = `/inbox/${mailbox.address}`;
+            const params = new URLSearchParams();
+            if (since)
+                params.set("since", since);
+            if (opts.subjectContains)
+                params.set("subject", opts.subjectContains);
+            if (opts.fromContains)
+                params.set("from", opts.fromContains);
+            const qs = params.toString();
+            if (qs)
+                path += `?${qs}`;
+            const data = await this.api(path, {}, 30_000);
+            if (data.next_since)
+                since = data.next_since;
+            for (const e of data.emails ?? []) {
+                const full = await this.getMessage(mailbox, e.id);
+                const fromField = `${full.from}`.toLowerCase();
+                const subjectMatch = opts.subjectContains
+                    ? full.subject
+                        .toLowerCase()
+                        .includes(opts.subjectContains.toLowerCase())
+                    : true;
+                const fromMatch = opts.fromContains
+                    ? fromField.includes(opts.fromContains.toLowerCase())
+                    : true;
+                if (subjectMatch && fromMatch) {
+                    return full;
+                }
+            }
+        }
+        throw new Error(`Timed out after ${opts.timeoutMs / 1000}s waiting for email` +
+            (opts.subjectContains
+                ? ` matching subject "${opts.subjectContains}"`
+                : "") +
+            (opts.fromContains ? ` from "${opts.fromContains}"` : ""));
+    }
+    async deleteMailbox(mailbox) {
+        // Clear all emails at the address
+        await this.api(`/inbox/${mailbox.address}`, { method: "DELETE" });
+    }
+}
+//# sourceMappingURL=mail-cx.js.map

package/dist/providers/mail-cx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-cx.js","sourceRoot":"","sources":["../../src/providers/mail-cx.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAY;IACrC,IAAI,GAAG,SAAS,CAAC;IACjB,WAAW,GAClB,8FAA8F,CAAC;IACxF,cAAc,GAAG,IAAI,CAAC;IAEvB,OAAO,GAAG,wBAAwB,CAAC;IACnC,QAAQ,GAAkB,IAAI,CAAC;IAEvC,YAAY,QAAiB;QAC3B,KAAK,EAAE,CAAC;QACR,IAAI,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACzC,CAAC;IAEO,UAAU;QAChB,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,GAAG,CACf,IAAY,EACZ,UAAuB,EAAE,EACzB,SAAkB;QAElB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,SAAS;YACrB,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC;YACjD,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;gBAChD,GAAG,OAAO;gBACV,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,GAAI,OAAO,CAAC,OAAkC,EAAE;gBACjF,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC9C,MAAM,IAAI,KAAK,CACb,qBAAqB,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,EAAE,CAC7D,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,SAAc,CAAC;YAC9C,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;QAClC,CAAC;gBAAS,CAAC;YACT,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CACzB,SAAS,CACV,CAAC;QACF,uDAAuD;QACvD,OAAO,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAA2B;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,cAAc,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACrE,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;YACpE,CAAC,CAAC,MAAM,CAAC,MAAM;YACf,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAE9B,MAAM,OAAO,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;QAExC,oDAAoD;QACpD,OAAO;YACL,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,KAAK,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;YACjC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAoB;QACpC,0CAA0C;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAQxB,UAAU,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAE5C,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;YACxB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;YACxB,QAAQ,EAAE,CAAC,CAAC,YAAY;YACxB,IAAI,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAC/C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,UAAU,CACd,QAAqB,EACrB,SAAiB;QAEjB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAYrB,UAAU,SAAS,EAAE,CAAC,CAAC;QAE1B,OAAO;YACL,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,UAAU,IAAI,EAAE;YACxB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;YACxB,QAAQ,EAAE,CAAC,CAAC,IAAI;YAChB,QAAQ,EAAE,CAAC,CAAC,IAAI;YAChB,IAAI,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC9C,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtC,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,WAAW,EAAE,CAAC,CAAC,YAAY;gBAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAChB,OAAoB,EACpB,OAAmD;QAEnD,MAAM,IAAI,GAAG;YACX,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,EAAE;YAC/C,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,EAAE;YACzC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,MAAM;YACvC,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,MAAM,EAAE,2BAA2B;SAC/E,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7C,IAAI,KAAyB,CAAC;QAE9B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,IAAI,IAAI,GAAG,UAAU,OAAO,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,IAAI,KAAK;gBAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,eAAe;gBACtB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YAC9C,IAAI,IAAI,CAAC,YAAY;gBAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7D,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,EAAE;gBAAE,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;YAEzB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAUxB,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;YAErB,IAAI,IAAI,CAAC,UAAU;gBAAE,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;YAE7C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClD,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe;oBACvC,CAAC,CAAC,IAAI,CAAC,OAAO;yBACT,WAAW,EAAE;yBACb,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;oBACjD,CAAC,CAAC,IAAI,CAAC;gBACT,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY;oBACjC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;oBACrD,CAAC,CAAC,IAAI,CAAC;gBACT,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;oBAC9B,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAqB;YAC3D,CAAC,IAAI,CAAC,eAAe;gBACnB,CAAC,CAAC,sBAAsB,IAAI,CAAC,eAAe,GAAG;gBAC/C,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC5D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAoB;QACtC,kCAAkC;QAClC,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;CACF"}

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

@@ -0,0 +1,16 @@
+import type { TempMailbox, EmailMessage, CreateMailboxParams } from "../types.js";
+import { BaseProvider } from "../base-provider.js";
+export declare class MailTmProvider extends BaseProvider {
+    readonly name = "mail.tm";
+    readonly description = "Free temporary email via mail.tm. No API key required. 8 QPS rate limit.";
+    readonly requiresApiKey = false;
+    private baseUrl;
+    private token;
+    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=mail-tm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail-tm.d.ts","sourceRoot":"","sources":["../../src/providers/mail-tm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA6DnD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,8EACyD;IAC7E,QAAQ,CAAC,cAAc,SAAS;IAEhC,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,KAAK,CAAuB;YAEtB,GAAG;IAyBX,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAO/B,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqChE,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgB1D,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/mail-tm.js

@@ -0,0 +1,109 @@
+import { BaseProvider } from "../base-provider.js";
+import { randomUsername, randomString } from "../utils.js";
+export class MailTmProvider extends BaseProvider {
+    name = "mail.tm";
+    description = "Free temporary email via mail.tm. No API key required. 8 QPS rate limit.";
+    requiresApiKey = false;
+    baseUrl = "https://api.mail.tm";
+    token = null;
+    async api(path, options = {}) {
+        const headers = {
+            "Content-Type": "application/json",
+            ...(options.headers ?? {}),
+        };
+        if (this.token) {
+            headers["Authorization"] = `Bearer ${this.token}`;
+        }
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            ...options,
+            headers,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`mail.tm API error ${res.status}: ${text || res.statusText}`);
+        }
+        if (res.status === 204)
+            return undefined;
+        return res.json();
+    }
+    async getDomains() {
+        const data = await this.api("/domains");
+        return data["hydra:member"]
+            .filter((d) => d.isActive)
+            .map((d) => d.domain);
+    }
+    async createMailbox(params) {
+        const domains = await this.getDomains();
+        if (domains.length === 0) {
+            throw new Error("No active domains available from mail.tm");
+        }
+        const username = params.username || randomUsername();
+        const domain = params.domain && domains.includes(params.domain)
+            ? params.domain
+            : domains[Math.floor(Math.random() * domains.length)];
+        const address = `${username}@${domain}`;
+        const password = randomString(16);
+        // Create account
+        await this.api("/accounts", {
+            method: "POST",
+            body: JSON.stringify({ address, password }),
+        });
+        // Get token
+        const tokenData = await this.api("/token", {
+            method: "POST",
+            body: JSON.stringify({ address, password }),
+        });
+        this.token = tokenData.token;
+        return {
+            address,
+            provider: this.name,
+            token: this.token ?? undefined,
+            password,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async getMessages(mailbox) {
+        if (mailbox.token) {
+            this.token = mailbox.token;
+        }
+        const data = await this.api("/messages");
+        return data["hydra:member"].map((m) => ({
+            id: m.id,
+            from: m.from?.address ?? "",
+            fromName: m.from?.name,
+            subject: m.subject,
+            bodyText: m.intro,
+            date: m.createdAt,
+        }));
+    }
+    async getMessage(mailbox, messageId) {
+        if (mailbox.token) {
+            this.token = mailbox.token;
+        }
+        const m = await this.api(`/messages/${messageId}`);
+        return {
+            id: m.id,
+            from: m.from?.address ?? "",
+            fromName: m.from?.name,
+            subject: m.subject,
+            bodyText: m.text,
+            bodyHtml: m.html?.join("\n"),
+            date: m.createdAt,
+            attachments: m.attachments?.map((a) => ({
+                filename: a.filename,
+                contentType: a.contentType,
+                size: a.size,
+                downloadUrl: a.downloadUrl,
+            })),
+        };
+    }
+    async deleteMailbox(mailbox) {
+        if (mailbox.token) {
+            this.token = mailbox.token;
+        }
+        const meData = await this.api("/me");
+        await this.api(`/accounts/${meData.id}`, { method: "DELETE" });
+        this.token = null;
+    }
+}
+//# sourceMappingURL=mail-tm.js.map

package/dist/providers/mail-tm.js.map

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

package/dist/providers/maildrop.d.ts

@@ -0,0 +1,22 @@
+import type { TempMailbox, EmailMessage, CreateMailboxParams } from "../types.js";
+import { BaseProvider } from "../base-provider.js";
+/**
+ * MailDrop provider — requires API key (free tier available, 300 req/day).
+ * API docs: https://maildrop.cx/api-docs
+ * Auth: Bearer token in Authorization header.
+ */
+export declare class MailDropProvider extends BaseProvider {
+    readonly name = "maildrop";
+    readonly description = "Temporary email via MailDrop. Free tier: 300 req/day. Requires API key from maildrop.cx.";
+    readonly requiresApiKey = true;
+    private baseUrl;
+    private apiKey;
+    constructor(apiKey?: 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>;
+}
+//# sourceMappingURL=maildrop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maildrop.d.ts","sourceRoot":"","sources":["../../src/providers/maildrop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EAEpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,8FACyE;IAC7F,QAAQ,CAAC,cAAc,QAAQ;IAE/B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,CAAC,EAAE,MAAM;IAK3B,OAAO,CAAC,UAAU;YAUJ,GAAG;IAkBX,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK/B,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAuBhE,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmB1D,UAAU,CACd,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;CA+BzB"}

package/dist/providers/maildrop.js

@@ -0,0 +1,88 @@
+import { BaseProvider } from "../base-provider.js";
+import { randomUsername } from "../utils.js";
+/**
+ * MailDrop provider — requires API key (free tier available, 300 req/day).
+ * API docs: https://maildrop.cx/api-docs
+ * Auth: Bearer token in Authorization header.
+ */
+export class MailDropProvider extends BaseProvider {
+    name = "maildrop";
+    description = "Temporary email via MailDrop. Free tier: 300 req/day. Requires API key from maildrop.cx.";
+    requiresApiKey = true;
+    baseUrl = "https://maildrop.cx/api/v1";
+    apiKey = null;
+    constructor(apiKey) {
+        super();
+        if (apiKey)
+            this.apiKey = apiKey;
+    }
+    getHeaders() {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        return headers;
+    }
+    async api(path, options = {}) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            ...options,
+            headers: { ...this.getHeaders(), ...options.headers },
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`MailDrop API error ${res.status}: ${text || res.statusText}`);
+        }
+        if (res.status === 204)
+            return undefined;
+        return res.json();
+    }
+    async getDomains() {
+        // MailDrop's public domains
+        return ["maildrop.cc", "206969.xyz", "8191.us"];
+    }
+    async createMailbox(params) {
+        const username = (params.username || randomUsername()).toLowerCase();
+        const domains = await this.getDomains();
+        const domain = params.domain && domains.includes(params.domain)
+            ? params.domain
+            : domains[0];
+        const data = await this.api("/mailboxes", {
+            method: "POST",
+            body: JSON.stringify({ prefix: username, suffix: domain }),
+        });
+        return {
+            address: data.address,
+            provider: this.name,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async getMessages(mailbox) {
+        const data = await this.api(`/mailboxes/${mailbox.address}/messages`);
+        return (data.messages ?? []).map((m) => ({
+            id: m.id,
+            from: m.from ?? "",
+            subject: m.subject ?? "",
+            date: m.date ?? new Date().toISOString(),
+        }));
+    }
+    async getMessage(_mailbox, messageId) {
+        const m = await this.api(`/messages/${messageId}`);
+        return {
+            id: m.id,
+            from: m.from ?? "",
+            subject: m.subject ?? "",
+            date: m.date ?? new Date().toISOString(),
+            bodyText: m.text,
+            bodyHtml: m.html,
+            attachments: m.attachments?.map((a) => ({
+                filename: a.filename,
+                contentType: a.content_type,
+                size: a.size,
+                downloadUrl: a.download_url,
+            })),
+        };
+    }
+}
+//# sourceMappingURL=maildrop.js.map

package/dist/providers/maildrop.js.map

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

package/dist/providers/one-secmail.d.ts

@@ -0,0 +1,22 @@
+import type { TempMailbox, EmailMessage, CreateMailboxParams } from "../types.js";
+import { BaseProvider } from "../base-provider.js";
+/**
+ * 1secmail provider — free, no auth required.
+ * API: https://www.1secmail.com/api/v1/
+ * Simple query-based API with no session management.
+ *
+ * Note: 1secmail has a new paid API at api.1secmail.com (requires key).
+ * This adapter uses the legacy free public endpoints.
+ */
+export declare class OneSecMailProvider extends BaseProvider {
+    readonly name = "1secmail";
+    readonly description = "Free temporary email via 1secmail.com. No API key, no session. Simple and fast.";
+    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>;
+}
+//# sourceMappingURL=one-secmail.d.ts.map

package/dist/providers/one-secmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-secmail.d.ts","sourceRoot":"","sources":["../../src/providers/one-secmail.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,kBAAmB,SAAQ,YAAY;IAClD,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,WAAW,qFACgE;IACpF,QAAQ,CAAC,cAAc,SAAS;IAEhC,OAAO,CAAC,OAAO,CAAsC;YAEvC,GAAG;IAeX,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAa/B,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBhE,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA6B1D,UAAU,CACd,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC;CAyCzB"}

package/dist/providers/one-secmail.js

@@ -0,0 +1,98 @@
+import { BaseProvider } from "../base-provider.js";
+import { randomUsername } from "../utils.js";
+/**
+ * 1secmail provider — free, no auth required.
+ * API: https://www.1secmail.com/api/v1/
+ * Simple query-based API with no session management.
+ *
+ * Note: 1secmail has a new paid API at api.1secmail.com (requires key).
+ * This adapter uses the legacy free public endpoints.
+ */
+export class OneSecMailProvider extends BaseProvider {
+    name = "1secmail";
+    description = "Free temporary email via 1secmail.com. No API key, no session. Simple and fast.";
+    requiresApiKey = false;
+    baseUrl = "https://www.1secmail.com/api/v1/";
+    async api(params) {
+        const url = new URL(this.baseUrl);
+        for (const [k, v] of Object.entries(params)) {
+            url.searchParams.set(k, v);
+        }
+        const res = await fetch(url);
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`1secmail API error ${res.status}: ${text || res.statusText}`);
+        }
+        return res.json();
+    }
+    async getDomains() {
+        // Hardcoded fallback list (the live API may return 403)
+        return [
+            "1secmail.com",
+            "1secmail.org",
+            "1secmail.net",
+            "wwjmp.com",
+            "esiix.com",
+            "xojxe.com",
+            "yoggm.com",
+        ];
+    }
+    async createMailbox(params) {
+        const domains = await this.getDomains();
+        const username = params.username || randomUsername();
+        const domain = params.domain && domains.includes(params.domain)
+            ? params.domain
+            : domains[Math.floor(Math.random() * domains.length)];
+        const address = `${username}@${domain}`;
+        // 1secmail doesn't require account creation — the mailbox is implicit.
+        // Any address@domain works and starts receiving mail immediately.
+        return {
+            address,
+            provider: this.name,
+            createdAt: new Date().toISOString(),
+        };
+    }
+    async getMessages(mailbox) {
+        const [login, domain] = mailbox.address.split("@");
+        const data = await this.api({
+            action: "getMessages",
+            login,
+            domain,
+        });
+        return data.map((m) => ({
+            id: String(m.id),
+            from: m.from,
+            subject: m.subject,
+            date: m.date,
+            attachments: m.attachments?.map((a) => ({
+                filename: a.name,
+                contentType: "",
+                size: a.size,
+            })),
+        }));
+    }
+    async getMessage(mailbox, messageId) {
+        const [login, domain] = mailbox.address.split("@");
+        const data = await this.api({
+            action: "readMessage",
+            login,
+            domain,
+            id: messageId,
+        });
+        return {
+            id: String(data.id),
+            from: data.from,
+            subject: data.subject,
+            date: data.date,
+            bodyText: data.textBody || data.body,
+            bodyHtml: data.htmlBody,
+            attachments: data.attachments?.map((a) => ({
+                filename: a.name,
+                contentType: a.contentType,
+                size: a.size,
+                downloadUrl: a.downloadUrl,
+            })),
+        };
+    }
+}
+//# sourceMappingURL=one-secmail.js.map

package/dist/providers/one-secmail.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Core type definitions for the temporary email service.
+ */
+/**
+ * A received email message.
+ */
+export interface EmailMessage {
+    /** Unique ID of the message within the provider. */
+    id: string;
+    /** Sender email address. */
+    from: string;
+    /** Sender display name (if available). */
+    fromName?: string;
+    /** Email subject line. */
+    subject: string;
+    /** Plain text body (if available). */
+    bodyText?: string;
+    /** HTML body (if available). */
+    bodyHtml?: string;
+    /** ISO 8601 date string. */
+    date: string;
+    /** List of attachments (metadata only). */
+    attachments?: Attachment[];
+}
+/**
+ * An email attachment.
+ */
+export interface Attachment {
+    filename: string;
+    contentType: string;
+    size: number;
+    downloadUrl?: string;
+}
+/**
+ * A temporary email account / mailbox.
+ */
+export interface TempMailbox {
+    /** The full email address (e.g. user@example.com). */
+    address: string;
+    /** The provider that created this mailbox. */
+    provider: string;
+    /** Provider-specific auth token or session ID (if any). */
+    token?: string;
+    /** Provider-specific session cookie (for Guerrilla Mail etc.). */
+    sessionId?: string;
+    /** Account password (for Mail.tm). */
+    password?: string;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+}
+/**
+ * Parameters for creating a mailbox.
+ */
+export interface CreateMailboxParams {
+    /** Preferred username (local-part). If omitted, a random one is generated. */
+    username?: string;
+    /** Preferred domain. If omitted, a random one is chosen. */
+    domain?: string;
+}
+/**
+ * Options for waiting for an email.
+ */
+export interface WaitForEmailOptions {
+    /** Subject filter — only return emails whose subject contains this substring. */
+    subjectContains?: string;
+    /** Sender filter — only return emails whose From contains this substring. */
+    fromContains?: string;
+    /** Timeout in milliseconds. Default 60_000 (60s). */
+    timeoutMs?: number;
+    /** Poll interval in milliseconds. Default 3_000 (3s). */
+    pollIntervalMs?: number;
+}
+/**
+ * The interface that every temp-mail provider adapter must implement.
+ */
+export interface TempMailProvider {
+    /** Unique provider name (e.g. "mail.tm"). */
+    name: string;
+    /** Human-readable description. */
+    description: string;
+    /** Whether this provider requires an API key / token. */
+    requiresApiKey: boolean;
+    /** Get the list of available domains. */
+    getDomains(): Promise<string[]>;
+    /** Create (or claim) a temporary mailbox. */
+    createMailbox(params: CreateMailboxParams): Promise<TempMailbox>;
+    /** Get the list of messages for a mailbox. */
+    getMessages(mailbox: TempMailbox): Promise<EmailMessage[]>;
+    /** Get a single message by ID (full content). */
+    getMessage(mailbox: TempMailbox, messageId: string): Promise<EmailMessage>;
+    /** Delete a mailbox (if supported). */
+    deleteMailbox?(mailbox: TempMailbox): Promise<void>;
+    /** Wait for at least one email matching the options. Returns the first match. */
+    waitForEmail(mailbox: TempMailbox, options?: WaitForEmailOptions): Promise<EmailMessage>;
+}
+//# sourceMappingURL=types.d.ts.map