e2e-mail 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric Gregoire
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# e2e-mail
+<p align="center">
+    <img width="256" height="256" alt="E2E Mail Logo" src="https://github.com/user-attachments/assets/7954e1d3-2be0-46f0-8c80-194b82bc0156" />
+</p>
+
+<h2 align="center">
+  Zero-config email testing for major E2E frameworks.
+</h3>
+
+<p align="center">
+    🚫 API Key | 🚫 Monthly Bill | 🚫 Domain Purchase | 🚫 Self-Destructing Inboxes
+</p>
+
+<p align="center">
+    ✅ Simply Free Email Testing
+</p>
+
+E2E Mail is on a mission to make email testing as simple, reliable, and accessible as the rest of your test suite.
+
+Most email testing solutions require paid APIs, custom domains, inbox management, vendor lock-in, or usage limits that make scaling difficult for open source projects, startups, and individual developers. E2E Mail takes a different approach.
+
+By leveraging free temporary email infrastructure behind a developer-friendly API, E2E Mail provides persistent, testable inboxes without the setup overhead. No accounts to create. No billing to configure. No DNS records to manage.
+
+Whether you're testing account verification flows, password resets, magic links, invitations, or transactional emails, E2E Mail helps you validate real email delivery inside your end-to-end tests with just a few lines of code.
+
+### Why E2E Mail?
+
+🆓 Free to use
+
+🧪 Built for automated testing
+
+🔄 Works with major E2E frameworks
+
+📬 Real inboxes for real email flows
+
+Email testing shouldn't require a subscription. It should just work.

package/dist/cypress.js

@@ -0,0 +1,32 @@
+import { E as s } from "./index-DalPChOM.js";
+let i = null;
+Cypress.Commands.add("initializeMailbox", (t, a) => (cy.log(`Creating mailbox ${t}`), cy.then(async () => {
+  i = new s(t, a), await i.initialize();
+})));
+Cypress.Commands.add("removeMailbox", () => cy.then(async () => {
+  if (!i)
+    throw new Error(
+      "Mailbox client not initialized. Call cy.initializeMailbox() first."
+    );
+  await i.dispose();
+}));
+Cypress.Commands.add("searchMailbox", (t, a = {}) => {
+  const {
+    timeout: l = Cypress.config().defaultCommandTimeout ?? 4e3,
+    autoDelete: r
+  } = a;
+  return cy.then({ timeout: l + 1e3 }, async () => {
+    if (!i)
+      throw new Error(
+        "Mailbox client not initialized. Call cy.initializeMailbox() first."
+      );
+    const e = await i.pollMessages(t, {
+      timeout: l,
+      autoDelete: r
+    }), o = Array.isArray(e.html) ? e.html[0] : e.html;
+    return o && cy.document().then((n) => {
+      n.open(), n.write(String(o)), n.close();
+    }), e;
+  });
+});
+//# sourceMappingURL=cypress.js.map

package/dist/cypress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cypress.js","sources":["../src/cypress/index.ts"],"sourcesContent":["import type { PollingOptions, SearchFilters } from \"../core/mailtm/mailtm\";\nimport type { components } from \"../core/api/mailtm-api.d\";\nimport { E2EMailClient } from \"../core/mailtm\";\n\nexport type { SearchFilters } from \"../core/mailtm/mailtm\";\n\ntype Message = components[\"schemas\"][\"Message-message.read\"];\n\ndeclare global {\n  namespace Cypress {\n    interface Chainable {\n      /**\n       * Initialize mailbox session\n       * @param address Email address\n       * @param password Account password\n       */\n      initializeMailbox(address: string, password: string): void;\n\n      /**\n       * Get most recent inbox match for an existing or new mail account\n       * @param filters Optional search filters\n       * @param options Configuration for message polling\n       */\n      searchMailbox(\n        filters?: SearchFilters,\n        options?: PollingOptions,\n      ): Chainable<Message>;\n\n      /**\n       * Delete the account mailbox and all its emails from the server\n       */\n      removeMailbox(): Chainable<void>;\n    }\n  }\n}\n\nlet mailClient: E2EMailClient | null = null;\n\nCypress.Commands.add(\"initializeMailbox\", (address, password) => {\n  cy.log(`Creating mailbox ${address}`);\n\n  return cy.then(async () => {\n    mailClient = new E2EMailClient(address, password);\n    await mailClient.initialize();\n  });\n});\n\nCypress.Commands.add(\"removeMailbox\", () => {\n  return cy.then(async () => {\n    if (!mailClient) {\n      throw new Error(\n        \"Mailbox client not initialized. Call cy.initializeMailbox() first.\",\n      );\n    }\n\n    await mailClient.dispose();\n  });\n});\n\nCypress.Commands.add(\"searchMailbox\", (filters, options = {}) => {\n  const {\n    timeout = Cypress.config().defaultCommandTimeout ?? 4000,\n    autoDelete,\n  } = options;\n\n  return cy.then({ timeout: timeout + 1000 }, async () => {\n    if (!mailClient) {\n      throw new Error(\n        \"Mailbox client not initialized. Call cy.initializeMailbox() first.\",\n      );\n    }\n\n    // Get most recent match\n    const message = await mailClient.pollMessages(filters, {\n      timeout,\n      autoDelete,\n    });\n    const html = Array.isArray(message.html) ? message.html[0] : message.html;\n\n    // Write HTML to Cypress DOM\n    if (html) {\n      cy.document().then((doc) => {\n        doc.open();\n        doc.write(String(html));\n        doc.close();\n      });\n    }\n\n    return message;\n  });\n});\n"],"names":["mailClient","address","password","E2EMailClient","filters","options","timeout","autoDelete","message","html","doc"],"mappings":";AAoCA,IAAIA,IAAmC;AAEvC,QAAQ,SAAS,IAAI,qBAAqB,CAACC,GAASC,OAClD,GAAG,IAAI,oBAAoBD,CAAO,EAAE,GAE7B,GAAG,KAAK,YAAY;AACzB,EAAAD,IAAa,IAAIG,EAAcF,GAASC,CAAQ,GAChD,MAAMF,EAAW,WAAA;AACnB,CAAC,EACF;AAED,QAAQ,SAAS,IAAI,iBAAiB,MAC7B,GAAG,KAAK,YAAY;AACzB,MAAI,CAACA;AACH,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAIJ,QAAMA,EAAW,QAAA;AACnB,CAAC,CACF;AAED,QAAQ,SAAS,IAAI,iBAAiB,CAACI,GAASC,IAAU,OAAO;AAC/D,QAAM;AAAA,IACJ,SAAAC,IAAU,QAAQ,OAAA,EAAS,yBAAyB;AAAA,IACpD,YAAAC;AAAA,EAAA,IACEF;AAEJ,SAAO,GAAG,KAAK,EAAE,SAASC,IAAU,IAAA,GAAQ,YAAY;AACtD,QAAI,CAACN;AACH,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAKJ,UAAMQ,IAAU,MAAMR,EAAW,aAAaI,GAAS;AAAA,MACrD,SAAAE;AAAA,MACA,YAAAC;AAAA,IAAA,CACD,GACKE,IAAO,MAAM,QAAQD,EAAQ,IAAI,IAAIA,EAAQ,KAAK,CAAC,IAAIA,EAAQ;AAGrE,WAAIC,KACF,GAAG,SAAA,EAAW,KAAK,CAACC,MAAQ;AAC1B,MAAAA,EAAI,KAAA,GACJA,EAAI,MAAM,OAAOD,CAAI,CAAC,GACtBC,EAAI,MAAA;AAAA,IACN,CAAC,GAGIF;AAAA,EACT,CAAC;AACH,CAAC;"}

package/dist/index-DalPChOM.js

@@ -0,0 +1,214 @@
+import h from "openapi-fetch";
+const o = h({
+  baseUrl: "https://api.mail.tm"
+});
+async function p() {
+  const { data: s = [], error: t } = await o.GET("/domains", {
+    headers: {
+      Accept: "application/json"
+    }
+  });
+  return { data: s, error: t };
+}
+async function u({
+  address: s,
+  password: t
+}) {
+  const { data: a, error: e } = await o.POST("/accounts", {
+    headers: {
+      Accept: "application/json"
+    },
+    body: {
+      address: s,
+      password: t
+    }
+  });
+  return { data: a, error: e };
+}
+async function w(s) {
+  const { data: t, error: a } = await o.GET("/me", {
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${s}`
+    }
+  });
+  return { data: t, error: a };
+}
+async function l(s, t) {
+  const { data: a, error: e } = await o.DELETE("/accounts/{id}", {
+    params: {
+      path: {
+        id: t
+      }
+    },
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${s}`
+    }
+  });
+  return { data: a, error: e };
+}
+async function m({
+  address: s,
+  password: t
+}) {
+  const { data: a, error: e } = await o.POST("/token", {
+    headers: {
+      Accept: "application/json"
+    },
+    body: {
+      address: s,
+      password: t
+    }
+  });
+  return { data: a, error: e };
+}
+async function f(s) {
+  const { data: t, error: a } = await o.GET("/messages", {
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${s}`
+    }
+  });
+  return { data: t, error: a };
+}
+async function g(s, t) {
+  const { data: a, error: e } = await o.GET("/messages/{id}", {
+    params: {
+      path: {
+        id: t
+      }
+    },
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${s}`
+    }
+  });
+  return { data: a, error: e };
+}
+async function E(s, t) {
+  const { data: a, error: e } = await o.DELETE("/messages/{id}", {
+    params: {
+      path: {
+        id: t
+      }
+    },
+    headers: {
+      Accept: "application/json",
+      Authorization: `Bearer ${s}`
+    }
+  });
+  return { data: a, error: e };
+}
+const A = async (s) => {
+  const { data: t } = await p(), a = s.split("@")[1], e = t.filter((n) => n.isActive).map((n) => n.domain), i = e.find((n) => n === a);
+  if (!i)
+    throw new Error(
+      `E2E Mail - Domain @${a} cannot be used to initialize mailbox.
+
+Try again with one of the following domains: ${e.join(", ")}`
+    );
+  return i;
+};
+function y(s = [], t) {
+  if (!t) return s;
+  const a = [];
+  if (t.recipient && a.push(
+    (e) => {
+      var i;
+      return (i = e.to) == null ? void 0 : i.some(
+        ({ address: n }) => n === t.recipient
+      );
+    }
+  ), t.sender && a.push(
+    (e) => {
+      var i;
+      return ((i = e.from) == null ? void 0 : i.address) === t.sender;
+    }
+  ), t.subject) {
+    const e = new RegExp(t.subject, "i");
+    a.push((i) => e.test(i.subject ?? ""));
+  }
+  if (t.createdAfter) {
+    const e = Date.parse(t.createdAfter);
+    a.push(
+      (i) => Date.parse(i.createdAt ?? "") > e
+    );
+  }
+  return s.filter(
+    (e) => a.every((i) => i(e))
+  );
+}
+const r = class r {
+  constructor(t, a) {
+    this.address = t, this.password = a;
+  }
+  async login() {
+    const { data: t } = await m({
+      address: this.address,
+      password: this.password
+    });
+    if (t != null && t.token) {
+      const { data: a } = await w(t.token);
+      this.token = t.token, this.accountId = a == null ? void 0 : a.id;
+    }
+  }
+  /** Initializes mailbox with existing credentials. If new and available account, it will be created automatically */
+  async initialize() {
+    if (await this.login(), !this.token) {
+      await A(this.address);
+      const { error: { detail: t = "" } = {} } = await u({
+        address: this.address,
+        password: this.password
+      });
+      if (t)
+        throw new Error(`E2E Mail - Failed to create Account.
+${t}`);
+      await this.login();
+    }
+  }
+  async dispose() {
+    if (!this.token || !this.accountId)
+      throw new Error(
+        `E2EMail - Deleting mailbox ${this.address} failed.
+
+Password is incorrect or account doesn't exist.`
+      );
+    return await l(this.token, this.accountId);
+  }
+  /** Fetch and filter emails for the initialized mailbox and return most recent match */
+  async queryMessages(t) {
+    if (!this.token)
+      throw new Error(
+        `E2EMail - Searching mailbox ${this.address} failed.
+
+Password is incorrect.`
+      );
+    const { data: a } = await f(this.token), [e] = y(a, t);
+    if (e) {
+      const { data: i } = await g(this.token, (e == null ? void 0 : e.id) || "");
+      return i;
+    }
+  }
+  /** Poll for messages in the initialized mailbox and timeout */
+  async pollMessages(t, { timeout: a = 3e4, autoDelete: e = !0 } = {}) {
+    const i = Date.now();
+    for (; Date.now() - i < a; ) {
+      const n = await this.queryMessages(t);
+      if (n)
+        return e && this.token && n.id && await E(this.token, n.id), n;
+      await new Promise(
+        (d) => setTimeout(d, r.POLL_INTERVAL)
+      );
+    }
+    throw new Error(
+      `E2E Mail - No message matching your criteria found found after ${a}ms.`
+    );
+  }
+};
+r.POLL_INTERVAL = 1e3;
+let c = r;
+export {
+  c as E
+};
+//# sourceMappingURL=index-DalPChOM.js.map

package/dist/index-DalPChOM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DalPChOM.js","sources":["../src/core/api/mailtm-api.ts","../src/core/mailtm/utils.ts","../src/core/mailtm/index.ts"],"sourcesContent":["import createClient from \"openapi-fetch\";\nimport type { paths } from \"../api/mailtm-api.d\";\nimport type { RequestPayload } from \".\";\n\n/** OpenAPI client for MailTM */\nconst client = createClient<paths>({\n  baseUrl: \"https://api.mail.tm\",\n});\n\n/**********\n * DOMAIN *\n *********/\nexport async function getDomains() {\n  const { data = [], error } = await client.GET(\"/domains\", {\n    headers: {\n      Accept: \"application/json\",\n    },\n  });\n\n  return { data, error };\n}\n\n/***********\n * ACCOUNT *\n **********/\nexport async function createAccount({\n  address,\n  password,\n}: RequestPayload<\"api_accounts_post\">) {\n  const { data, error } = await client.POST(\"/accounts\", {\n    headers: {\n      Accept: \"application/json\",\n    },\n    body: {\n      address,\n      password,\n    },\n  });\n\n  return { data, error };\n}\n\nexport async function getMe(token: string) {\n  const { data, error } = await client.GET(\"/me\", {\n    headers: {\n      Accept: \"application/json\",\n      Authorization: `Bearer ${token}`,\n    },\n  });\n\n  return { data, error };\n}\n\nexport async function deleteAccount(token: string, id: string) {\n  const { data, error } = await client.DELETE(\"/accounts/{id}\", {\n    params: {\n      path: {\n        id,\n      },\n    },\n    headers: {\n      Accept: \"application/json\",\n      Authorization: `Bearer ${token}`,\n    },\n  });\n\n  return { data, error };\n}\n\n/*********\n * TOKEN *\n ********/\nexport async function createToken({\n  address,\n  password,\n}: RequestPayload<\"login_check_post\">) {\n  const { data, error } = await client.POST(\"/token\", {\n    headers: {\n      Accept: \"application/json\",\n    },\n    body: {\n      address,\n      password,\n    },\n  });\n\n  return { data, error };\n}\n\n/************\n * MESSAGES *\n ***********/\nexport async function getMessages(token: string) {\n  const { data, error } = await client.GET(\"/messages\", {\n    headers: {\n      Accept: \"application/json\",\n      Authorization: `Bearer ${token}`,\n    },\n  });\n\n  return { data, error };\n}\n\nexport async function getMessage(token: string, id: string) {\n  const { data, error } = await client.GET(\"/messages/{id}\", {\n    params: {\n      path: {\n        id,\n      },\n    },\n    headers: {\n      Accept: \"application/json\",\n      Authorization: `Bearer ${token}`,\n    },\n  });\n\n  return { data, error };\n}\n\nexport async function deleteMessage(token: string, id: string) {\n  const { data, error } = await client.DELETE(\"/messages/{id}\", {\n    params: {\n      path: {\n        id,\n      },\n    },\n    headers: {\n      Accept: \"application/json\",\n      Authorization: `Bearer ${token}`,\n    },\n  });\n\n  return { data, error };\n}\n\n/**********\n * SOURCE *\n *********/\nexport async function getSource(token: string, id: string) {\n  const { data, error } = await client.GET(\"/sources/{id}\", {\n    params: {\n      path: {\n        id,\n      },\n    },\n    headers: {\n      Accept: \"application/json\",\n      Authorization: `Bearer ${token}`,\n    },\n  });\n\n  return { data, error };\n}\n","import { ResponseData } from \"../api\";\nimport { getDomains } from \"../api/mailtm-api\";\nimport type { SearchFilters } from \"./mailtm.d\";\n\n/** Determines if passed email domain matches any active domains from mail.tm, fail if not\n * @remarks This is intentionally bypassed if a token was successfully created for a previously established account whose domain was deactivated\n * @param address The email address for which to check domain validitity\n */\nexport const validateEmailDomain = async (address: string) => {\n  const { data: domains } = await getDomains();\n  const domain = address.split(\"@\")[1];\n  const activeDomains = domains.filter((d) => d.isActive).map((d) => d.domain);\n  const domainMatch = activeDomains.find((d) => d === domain);\n\n  if (!domainMatch) {\n    throw new Error(\n      `E2E Mail - Domain @${domain} cannot be used to initialize mailbox.\\n\\nTry again with one of the following domains: ${activeDomains.join(\", \")}`,\n    );\n  }\n\n  return domainMatch;\n};\n\n/** Search and filter account messages by message metadata or content\n * @param messages The messages returned from the account to filter\n * @param filters The filtering criteria to apply to the messages\n */\nexport function filterMessages(\n  messages: ResponseData<\"api_messages_get_collection\", 200> = [],\n  filters?: SearchFilters,\n) {\n  if (!filters) return messages;\n\n  const predicates: Array<\n    (message: ResponseData<\"api_messages_id_get\", 200>) => boolean\n  > = [];\n\n  if (filters.recipient) {\n    predicates.push((message) =>\n      (message.to as any[])?.some(\n        ({ address }) => address === filters.recipient,\n      ),\n    );\n  }\n\n  if (filters.sender) {\n    predicates.push(\n      (message) => (message.from as any)?.address === filters.sender,\n    );\n  }\n\n  if (filters.subject) {\n    const regex = new RegExp(filters.subject, \"i\");\n    predicates.push((message) => regex.test(message.subject ?? \"\"));\n  }\n\n  if (filters.createdAfter) {\n    const startTime = Date.parse(filters.createdAfter);\n    predicates.push(\n      (message) => Date.parse(message.createdAt ?? \"\") > startTime,\n    );\n  }\n\n  return messages.filter((message) =>\n    predicates.every((predicate) => predicate(message)),\n  );\n}\n","import {\n  createAccount,\n  deleteAccount,\n  createToken,\n  getMessage,\n  getMessages,\n  getMe,\n  deleteMessage,\n} from \"../api/mailtm-api\";\nimport type { PollingOptions, SearchFilters } from \"./mailtm.d\";\nimport { filterMessages, validateEmailDomain } from \"./utils\";\n\nexport class E2EMailClient {\n  private static readonly POLL_INTERVAL = 1000;\n  private address: string;\n  private password: string;\n  private token: string | undefined;\n  private accountId: string | undefined;\n\n  constructor(address: string, password: string) {\n    this.address = address;\n    this.password = password;\n  }\n\n  private async login() {\n    const { data: auth } = await createToken({\n      address: this.address,\n      password: this.password,\n    });\n\n    if (auth?.token) {\n      const { data: account } = await getMe(auth.token);\n\n      this.token = auth.token;\n      this.accountId = account?.id;\n    }\n  }\n\n  /** Initializes mailbox with existing credentials. If new and available account, it will be created automatically */\n  public async initialize() {\n    await this.login();\n\n    if (!this.token) {\n      await validateEmailDomain(this.address);\n      const { error: { detail = \"\" } = {} } = await createAccount({\n        address: this.address,\n        password: this.password,\n      });\n\n      if (detail)\n        throw new Error(`E2E Mail - Failed to create Account.\\n${detail}`);\n\n      await this.login();\n    }\n  }\n\n  public async dispose() {\n    if (!this.token || !this.accountId)\n      throw new Error(\n        `E2EMail - Deleting mailbox ${this.address} failed.\\n\\nPassword is incorrect or account doesn't exist.`,\n      );\n\n    return await deleteAccount(this.token, this.accountId);\n  }\n\n  /** Fetch and filter emails for the initialized mailbox and return most recent match */\n  private async queryMessages(filters?: SearchFilters) {\n    if (!this.token)\n      throw new Error(\n        `E2EMail - Searching mailbox ${this.address} failed.\\n\\nPassword is incorrect.`,\n      );\n\n    const { data: allMessages } = await getMessages(this.token);\n    const [firstMatch] = filterMessages(allMessages, filters);\n\n    if (firstMatch) {\n      const { data } = await getMessage(this.token, firstMatch?.id || \"\");\n      return data;\n    }\n\n    return;\n  }\n\n  /** Poll for messages in the initialized mailbox and timeout */\n  public async pollMessages(\n    filters?: SearchFilters,\n    { timeout = 30000, autoDelete = true }: PollingOptions = {},\n  ) {\n    const start = Date.now();\n\n    while (Date.now() - start < timeout) {\n      const message = await this.queryMessages(filters);\n\n      if (message) {\n        if (autoDelete && this.token && message.id) {\n          await deleteMessage(this.token, message.id);\n        }\n\n        return message;\n      }\n\n      await new Promise((resolve) =>\n        setTimeout(resolve, E2EMailClient.POLL_INTERVAL),\n      );\n    }\n\n    throw new Error(\n      `E2E Mail - No message matching your criteria found found after ${timeout}ms.`,\n    );\n  }\n}\n"],"names":["client","createClient","getDomains","data","error","createAccount","address","password","getMe","token","deleteAccount","id","createToken","getMessages","getMessage","deleteMessage","validateEmailDomain","domains","domain","activeDomains","d","domainMatch","filterMessages","messages","filters","predicates","message","_a","regex","startTime","predicate","_E2EMailClient","auth","account","detail","allMessages","firstMatch","timeout","autoDelete","start","resolve","E2EMailClient"],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import { E as e } from "./index-DalPChOM.js";
+export {
+  e as E2EMailClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/playwright.js

@@ -0,0 +1,43 @@
+import { test as m } from "@playwright/test";
+import { expect as h } from "@playwright/test";
+import { E as w } from "./index-DalPChOM.js";
+let i;
+const x = m.extend({
+  initializeMailbox: async ({}, t) => {
+    await t(async (a, e) => {
+      i = new w(a, e), await i.initialize();
+    });
+  },
+  removeMailbox: async ({}, t) => {
+    await t(async () => {
+      if (!i)
+        throw new Error(
+          "Mailbox client not initialized. Call initializeMailbox() first."
+        );
+      await i.dispose();
+    });
+  },
+  searchMailbox: async ({ page: t }, a) => {
+    await a(async (e, s = {}) => {
+      var l;
+      const {
+        timeout: r = x.info().project.use.actionTimeout ?? 4e3,
+        autoDelete: c
+      } = s;
+      if (!i)
+        throw new Error(
+          "Mailbox client not initialized. Call initializeMailbox() first."
+        );
+      const o = await i.pollMessages(e, {
+        timeout: r,
+        autoDelete: c
+      }), n = ((l = o.html) == null ? void 0 : l[0]) ?? o.html ?? "";
+      return n && await t.setContent(String(n)), o;
+    });
+  }
+});
+export {
+  h as expect,
+  x as test
+};
+//# sourceMappingURL=playwright.js.map

package/dist/playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.js","sources":["../src/playwright/index.ts"],"sourcesContent":["import { test as base } from \"@playwright/test\";\nimport type { PollingOptions, SearchFilters } from \"../core/mailtm/mailtm\";\nimport type { components } from \"../core/api/mailtm-api.d\";\nimport { E2EMailClient } from \"../core/mailtm\";\n\ntype Message = components[\"schemas\"][\"Message-message.read\"];\n\nexport type MailFixtures = {\n  /**\n   * Initialize mailbox session\n   * @param address Email address\n   * @param password Account password\n   */\n  initializeMailbox: (address: string, password: string) => void;\n\n  /**\n   * Get most recent inbox match for an existing or new mail account\n   * @param filters Optional search filters\n   * @param options Configuration for message polling\n   */\n  searchMailbox: (\n    filters?: SearchFilters,\n    options?: PollingOptions,\n  ) => Promise<Message>;\n\n  /**\n   * Delete the account mailbox and all its emails from the server\n   */\n  removeMailbox: () => void;\n};\n\nlet mailClient: E2EMailClient | undefined;\n\nexport const test = base.extend<MailFixtures>({\n  initializeMailbox: async ({}, use) => {\n    await use(async (address, password) => {\n      mailClient = new E2EMailClient(address, password);\n      await mailClient.initialize();\n    });\n  },\n\n  removeMailbox: async ({}, use) => {\n    await use(async () => {\n      if (!mailClient) {\n        throw new Error(\n          \"Mailbox client not initialized. Call initializeMailbox() first.\",\n        );\n      }\n\n      await mailClient.dispose();\n    });\n  },\n\n  searchMailbox: async ({ page }, use) => {\n    await use(async (filters, options = {}) => {\n      const {\n        timeout = test.info().project.use.actionTimeout ?? 4000,\n        autoDelete,\n      } = options;\n\n      if (!mailClient) {\n        throw new Error(\n          \"Mailbox client not initialized. Call initializeMailbox() first.\",\n        );\n      }\n\n      const message = await mailClient.pollMessages(filters, {\n        timeout,\n        autoDelete,\n      });\n      const html = message.html?.[0] ?? message.html ?? \"\";\n\n      if (html) {\n        await page.setContent(String(html));\n      }\n\n      return message;\n    });\n  },\n});\n\nexport { expect } from \"@playwright/test\";\n"],"names":["mailClient","test","base","use","address","password","E2EMailClient","page","filters","options","timeout","autoDelete","message","html","_a"],"mappings":";;;AA+BA,IAAIA;AAEG,MAAMC,IAAOC,EAAK,OAAqB;AAAA,EAC5C,mBAAmB,OAAO,CAAA,GAAIC,MAAQ;AACpC,UAAMA,EAAI,OAAOC,GAASC,MAAa;AACrC,MAAAL,IAAa,IAAIM,EAAcF,GAASC,CAAQ,GAChD,MAAML,EAAW,WAAA;AAAA,IACnB,CAAC;AAAA,EACH;AAAA,EAEA,eAAe,OAAO,CAAA,GAAIG,MAAQ;AAChC,UAAMA,EAAI,YAAY;AACpB,UAAI,CAACH;AACH,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAIJ,YAAMA,EAAW,QAAA;AAAA,IACnB,CAAC;AAAA,EACH;AAAA,EAEA,eAAe,OAAO,EAAE,MAAAO,EAAA,GAAQJ,MAAQ;AACtC,UAAMA,EAAI,OAAOK,GAASC,IAAU,CAAA,MAAO;;AACzC,YAAM;AAAA,QACJ,SAAAC,IAAUT,EAAK,KAAA,EAAO,QAAQ,IAAI,iBAAiB;AAAA,QACnD,YAAAU;AAAA,MAAA,IACEF;AAEJ,UAAI,CAACT;AACH,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAIJ,YAAMY,IAAU,MAAMZ,EAAW,aAAaQ,GAAS;AAAA,QACrD,SAAAE;AAAA,QACA,YAAAC;AAAA,MAAA,CACD,GACKE,MAAOC,IAAAF,EAAQ,SAAR,gBAAAE,EAAe,OAAMF,EAAQ,QAAQ;AAElD,aAAIC,KACF,MAAMN,EAAK,WAAW,OAAOM,CAAI,CAAC,GAG7BD;AAAA,IACT,CAAC;AAAA,EACH;AACF,CAAC;"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "e2e-mail",
+  "version": "0.0.1",
+  "description": "A zero-config solution for testing email in major testing frameworks.",
+  "main": "dist/index.js",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js"
+    },
+    "./cypress": {
+      "import": "./dist/cypress/index.js"
+    },
+    "./playwright": {
+      "import": "./dist/playwright/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/cypress/README.md",
+    "src/playwright/README.md"
+  ],
+  "scripts": {
+    "start": "tsx src/main.ts",
+    "schema": "tsx scripts/generate-types.ts application/json https://api.mail.tm/docs.jsonopenapi ./src/core/api/mailtm-api.d.ts",
+    "build": "vite build",
+    "build:watch": "vite build --watch",
+    "e2e:cypress": "cypress open",
+    "e2e:playwright": "playwright test --ui"
+  },
+  "keywords": [
+    "Cypress",
+    "Playwright",
+    "Testing",
+    "Email"
+  ],
+  "author": "Eric Gregoire",
+  "license": "MIT",
+  "devDependencies": {
+    "@playwright/test": "^1.49.0",
+    "@types/node": "^25.9.2",
+    "openapi-fetch": "^0.17.0",
+    "openapi-typescript": "^7.13.0",
+    "tsx": "^4.22.4",
+    "typescript": "^5.9.3",
+    "vite": "^6.3.0"
+  },
+  "peerDependencies": {
+    "cypress": "^15",
+    "playwright": "^1.60"
+  },
+  "peerDependenciesMeta": {
+    "cypress": {
+      "optional": true
+    },
+    "playwright": {
+      "optional": true
+    }
+  }
+}