@nwire/mail-nodemailer 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Gefter / 200apps Ltd.
+
+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,73 @@
+# @nwire/mail-nodemailer
+
+> [Nodemailer](https://nodemailer.com)-backed `Mailer` — SMTP, Mailhog, Gmail, Office365.
+
+## What it does
+
+Wraps a nodemailer `Transporter` so handlers can send mail through the canonical `Mailer` contract without knowing whether they're talking to Mailhog, Postfix, or a cloud relay.
+
+## Install
+
+```bash
+pnpm add @nwire/mail-nodemailer @nwire/mail nodemailer
+```
+
+## Quick start
+
+```ts
+import { smtpMailer } from "@nwire/mail-nodemailer";
+import { mailPlugin } from "@nwire/mail";
+import { defineApp } from "@nwire/forge";
+
+defineApp("my-app", {
+  plugins: [
+    mailPlugin({
+      mailer: smtpMailer({
+        host: process.env.SMTP_HOST,
+        port: Number(process.env.SMTP_PORT),
+        auth: { user: process.env.SMTP_USER!, pass: process.env.SMTP_PASS! },
+      }),
+      defaultFrom: '"My App" <noreply@example.com>',
+    }),
+  ],
+});
+
+// Local dev:
+// smtpMailer({ host: "localhost", port: 1025 }) // Mailhog (no auth)
+```
+
+## API surface
+
+- `smtpMailer(transporterOptions)` — implements `Mailer` using a nodemailer transport.
+
+## When to use
+
+Production transactional mail or local-dev with Mailhog (`nwire infra up` ships Mailhog at `http://localhost:8025`). Fits L3 and up.
+
+## Standalone use
+
+For developers using `@nwire/mail-nodemailer` **without the rest of Nwire** — pair it with any TypeScript project, any container, any HTTP framework.
+
+```ts
+// See the package's main entry (src/) for the standalone surface.
+// The exports below work without @nwire/app or @nwire/forge.
+import {} from /* ...standalone exports... */ "@nwire/mail-nodemailer";
+```
+
+## Within nwire-app
+
+For developers using this package as part of the Nwire stack — register it via `app.use(...)` or it auto-wires when you compose `createApp({ modules })`.
+
+```ts
+import { createApp } from "@nwire/forge";
+
+const app = createApp({
+  /* ...config... */
+});
+// Adapter/plugin wiring happens here when applicable.
+```
+
+## See also
+
+- [Architecture sketch §05 — Adapters tier](../../architecture-sketch.html#packages)
+- Sibling packages: [@nwire/mail](../nwire-mail)

package/dist/__tests__/mail-nodemailer.integration.test.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Integration test — exercises `@nwire/mail-nodemailer` against real
+ * Mailhog. Mailhog accepts SMTP on `1025` and exposes a tiny JSON API
+ * on `8025/api/v2/messages` listing every received message — that's
+ * what we use to confirm the mail actually arrived as we sent it.
+ *
+ * Mailhog comes from the workspace docker-compose. When the SMTP port
+ * isn't reachable on `127.0.0.1:1025`, the whole suite skips.
+ *
+ * Why we need real SMTP for these checks:
+ *
+ *   - `transporter.verify()` (our healthCheck) opens a real connection,
+ *     completes the HELO + EHLO handshake, then closes. Mocks can't
+ *     prove the wire protocol is wired up correctly.
+ *   - The mapping from our `MailMessage` shape (mixed string +
+ *     `{email,name}` recipients, attachments as `Uint8Array`) into
+ *     RFC-822 headers + MIME parts is where Nodemailer's behavior is
+ *     most likely to surprise us across upgrades. Asserting against
+ *     Mailhog's parsed inbox lets us check the receiver's view.
+ *   - Pool teardown (`shutdown()`) only matters when there's a real
+ *     connection pool to close.
+ */
+export {};
+//# sourceMappingURL=mail-nodemailer.integration.test.d.ts.map

package/dist/__tests__/mail-nodemailer.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-nodemailer.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mail-nodemailer.integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/__tests__/mail-nodemailer.integration.test.js

@@ -0,0 +1,129 @@
+/**
+ * Integration test — exercises `@nwire/mail-nodemailer` against real
+ * Mailhog. Mailhog accepts SMTP on `1025` and exposes a tiny JSON API
+ * on `8025/api/v2/messages` listing every received message — that's
+ * what we use to confirm the mail actually arrived as we sent it.
+ *
+ * Mailhog comes from the workspace docker-compose. When the SMTP port
+ * isn't reachable on `127.0.0.1:1025`, the whole suite skips.
+ *
+ * Why we need real SMTP for these checks:
+ *
+ *   - `transporter.verify()` (our healthCheck) opens a real connection,
+ *     completes the HELO + EHLO handshake, then closes. Mocks can't
+ *     prove the wire protocol is wired up correctly.
+ *   - The mapping from our `MailMessage` shape (mixed string +
+ *     `{email,name}` recipients, attachments as `Uint8Array`) into
+ *     RFC-822 headers + MIME parts is where Nodemailer's behavior is
+ *     most likely to surprise us across upgrades. Asserting against
+ *     Mailhog's parsed inbox lets us check the receiver's view.
+ *   - Pool teardown (`shutdown()`) only matters when there's a real
+ *     connection pool to close.
+ */
+import { describe, it, expect, beforeAll, afterAll, beforeEach } from "vitest";
+import { isReachable } from "@nwire/test-kit";
+import { smtpMailer } from "../mail-nodemailer.js";
+const MAILHOG_HOST = "127.0.0.1";
+const MAILHOG_SMTP_PORT = 1025;
+const MAILHOG_HTTP_PORT = 8025;
+const MAILHOG_API = `http://${MAILHOG_HOST}:${MAILHOG_HTTP_PORT}/api/v2/messages`;
+const reachable = await isReachable(MAILHOG_HOST, MAILHOG_SMTP_PORT, 800);
+async function purgeInbox() {
+    await fetch(`http://${MAILHOG_HOST}:${MAILHOG_HTTP_PORT}/api/v1/messages`, {
+        method: "DELETE",
+    });
+}
+async function fetchInbox() {
+    const res = await fetch(MAILHOG_API);
+    if (!res.ok)
+        throw new Error(`Mailhog API ${res.status}`);
+    const data = (await res.json());
+    return data.items;
+}
+async function waitForCount(n, timeoutMs = 3_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const items = await fetchInbox();
+        if (items.length >= n)
+            return items;
+        await new Promise((r) => setTimeout(r, 25));
+    }
+    throw new Error(`waitForCount: only ${(await fetchInbox()).length}/${n} after ${timeoutMs}ms`);
+}
+describe.skipIf(!reachable)("mail-nodemailer ↔ real Mailhog", () => {
+    let mailer;
+    beforeAll(() => {
+        mailer = smtpMailer({
+            host: MAILHOG_HOST,
+            port: MAILHOG_SMTP_PORT,
+            // Mailhog has no auth and no TLS in the dev compose.
+            pool: true,
+        });
+    });
+    beforeEach(async () => {
+        await purgeInbox();
+    });
+    afterAll(async () => {
+        await mailer.shutdown?.();
+    });
+    it("healthCheck verifies the SMTP handshake", async () => {
+        await expect(mailer.healthCheck()).resolves.toBeUndefined();
+    });
+    it("sends a plain-text message with the right To/From/Subject headers", async () => {
+        const result = await mailer.send({
+            from: "noreply@example.com",
+            to: "alice@example.com",
+            subject: "Phase 77 hello",
+            text: "Hello from a real SMTP round-trip.",
+        });
+        expect(result.messageId).toMatch(/@/); // RFC-822 message-id
+        const [msg] = await waitForCount(1);
+        expect(msg.Content.Headers.Subject?.[0]).toBe("Phase 77 hello");
+        expect(msg.Content.Headers.From?.[0]).toContain("noreply@example.com");
+        expect(msg.Content.Headers.To?.[0]).toContain("alice@example.com");
+        expect(msg.Content.Body).toContain("Hello from a real SMTP round-trip.");
+    });
+    it("maps {email,name} recipient objects into RFC-822 display-name form", async () => {
+        await mailer.send({
+            from: { email: "noreply@example.com", name: "Phase 77" },
+            to: { email: "alice@example.com", name: "Alice Example" },
+            subject: "Named recipient",
+            text: "ok",
+        });
+        const [msg] = await waitForCount(1);
+        // Nodemailer emits `Display Name <addr>` for simple display names; only
+        // names with special chars get quoted. Verify both parts arrived.
+        const from = msg.Content.Headers.From?.[0] ?? "";
+        const to = msg.Content.Headers.To?.[0] ?? "";
+        expect(from).toContain("Phase 77");
+        expect(from).toContain("<noreply@example.com>");
+        expect(to).toContain("Alice Example");
+        expect(to).toContain("<alice@example.com>");
+    });
+    it("multi-recipient arrays produce a comma-separated To header", async () => {
+        await mailer.send({
+            from: "noreply@example.com",
+            to: ["alice@example.com", "bob@example.com"],
+            subject: "Group blast",
+            text: "ok",
+        });
+        const [msg] = await waitForCount(1);
+        const to = msg.Content.Headers.To?.[0] ?? "";
+        expect(to).toMatch(/alice@example\.com/);
+        expect(to).toMatch(/bob@example\.com/);
+    });
+    it("html bodies arrive as a MIME multipart with the expected content type", async () => {
+        await mailer.send({
+            from: "noreply@example.com",
+            to: "alice@example.com",
+            subject: "HTML test",
+            text: "fallback",
+            html: "<p>Hello, <b>real SMTP</b>.</p>",
+        });
+        const [msg] = await waitForCount(1);
+        const ct = msg.Content.Headers["Content-Type"]?.[0] ?? "";
+        expect(ct).toMatch(/multipart\/alternative/);
+        expect(msg.Content.Body).toContain("<b>real SMTP</b>");
+    });
+});
+//# sourceMappingURL=mail-nodemailer.integration.test.js.map

package/dist/__tests__/mail-nodemailer.integration.test.js.map

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

package/dist/__tests__/mail-nodemailer.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `@nwire/mail-nodemailer` — adapter unit tests.
+ *
+ * We don't boot a real SMTP server here; we stub the transporter so the
+ * tests run fast without Mailhog. Integration tests against real Mailhog
+ * happen via `nwire infra up`.
+ */
+export {};
+//# sourceMappingURL=mail-nodemailer.test.d.ts.map

package/dist/__tests__/mail-nodemailer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-nodemailer.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mail-nodemailer.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/__tests__/mail-nodemailer.test.js

@@ -0,0 +1,67 @@
+/**
+ * `@nwire/mail-nodemailer` — adapter unit tests.
+ *
+ * We don't boot a real SMTP server here; we stub the transporter so the
+ * tests run fast without Mailhog. Integration tests against real Mailhog
+ * happen via `nwire infra up`.
+ */
+import { describe, it, expect, vi } from "vitest";
+import { smtpMailer } from "../mail-nodemailer.js";
+import { MailSendError } from "@nwire/mail";
+function stubTransporter(overrides = {}) {
+    return {
+        sendMail: vi.fn(async () => ({ messageId: "<smtp-abc@local>" })),
+        verify: vi.fn(async () => true),
+        close: vi.fn(() => { }),
+        ...overrides,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    };
+}
+describe("smtpMailer", () => {
+    it("send maps the canonical MailMessage to Nodemailer's SendMailOptions", async () => {
+        const transporter = stubTransporter();
+        const mailer = smtpMailer({ host: "x", port: 1025, transporter });
+        await mailer.send({
+            to: [{ email: "alice@x", name: "Alice" }, "bob@x"],
+            from: { email: "noreply@x", name: "My App" },
+            subject: "Welcome",
+            html: "<p>hi</p>",
+            headers: { "X-Trace": "abc" },
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const call = transporter.sendMail.mock.calls[0][0];
+        expect(call.subject).toBe("Welcome");
+        expect(call.from).toEqual({ name: "My App", address: "noreply@x" });
+        expect(call.to).toEqual([
+            { name: "Alice", address: "alice@x" },
+            "bob@x",
+        ]);
+        expect(call.headers).toEqual({ "X-Trace": "abc" });
+    });
+    it("send returns a populated MailSendResult", async () => {
+        const mailer = smtpMailer({ host: "x", port: 1025, transporter: stubTransporter() });
+        const result = await mailer.send({ to: "a", subject: "" });
+        expect(result.messageId).toBe("<smtp-abc@local>");
+        expect(typeof result.durationMs).toBe("number");
+    });
+    it("send wraps transporter errors as MailSendError", async () => {
+        const transporter = stubTransporter({
+            sendMail: vi.fn(async () => { throw new Error("conn refused"); }),
+        });
+        const mailer = smtpMailer({ host: "x", port: 1025, transporter });
+        await expect(mailer.send({ to: "a", subject: "" })).rejects.toBeInstanceOf(MailSendError);
+    });
+    it("healthCheck calls transporter.verify", async () => {
+        const transporter = stubTransporter();
+        const mailer = smtpMailer({ host: "x", port: 1025, transporter });
+        await mailer.healthCheck();
+        expect(transporter.verify).toHaveBeenCalled();
+    });
+    it("shutdown closes the transporter", async () => {
+        const transporter = stubTransporter();
+        const mailer = smtpMailer({ host: "x", port: 1025, transporter });
+        await mailer.shutdown();
+        expect(transporter.close).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=mail-nodemailer.test.js.map

package/dist/__tests__/mail-nodemailer.test.js.map

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

package/dist/mail-nodemailer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `@nwire/mail-nodemailer` — Nodemailer-backed Mailer.
+ *
+ * Wraps a nodemailer Transporter so handlers can send mail through the
+ * canonical `Mailer` contract without knowing whether they're talking to
+ * Mailhog locally, Postfix on the same box, or a cloud relay.
+ *
+ *   import { smtpMailer } from "@nwire/mail-nodemailer";
+ *   import { mailPlugin } from "@nwire/mail";
+ *
+ *   defineApp("my-app", {
+ *     plugins: [mailPlugin({
+ *       mailer: smtpMailer({
+ *         host: process.env.SMTP_HOST,
+ *         port: Number(process.env.SMTP_PORT),
+ *         auth: { user: process.env.SMTP_USER!, pass: process.env.SMTP_PASS! },
+ *       }),
+ *       defaultFrom: '"My App" <noreply@example.com>',
+ *     })],
+ *   });
+ *
+ * For local dev:
+ *
+ *   smtpMailer({ host: "localhost", port: 1025 }) // Mailhog (no auth)
+ *
+ * Run `nwire infra up` and open http://localhost:8025 to inspect sent mail.
+ */
+import type { Transporter } from "nodemailer";
+import { type Mailer } from "@nwire/mail";
+export interface SmtpMailerOptions {
+    readonly host: string;
+    readonly port: number;
+    /** Use TLS at connect time (port 465). Default: false (STARTTLS otherwise). */
+    readonly secure?: boolean;
+    readonly auth?: {
+        readonly user: string;
+        readonly pass: string;
+    };
+    /**
+     * Reuse an existing nodemailer Transporter. Useful when the app already
+     * has a custom-configured transporter (multi-tenant, pooling tuned, ...)
+     */
+    readonly transporter?: Transporter;
+    /**
+     * Pool connections? Nodemailer's pool transport is more efficient for
+     * high-throughput senders. Default: true.
+     */
+    readonly pool?: boolean;
+}
+/** Build a Mailer backed by Nodemailer's SMTP transport. */
+export declare function smtpMailer(options: SmtpMailerOptions): Mailer;
+//# sourceMappingURL=mail-nodemailer.d.ts.map

package/dist/mail-nodemailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-nodemailer.d.ts","sourceRoot":"","sources":["../src/mail-nodemailer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC/D,OAAO,EAEL,KAAK,MAAM,EAIZ,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAa7D"}

package/dist/mail-nodemailer.js

@@ -0,0 +1,114 @@
+/**
+ * `@nwire/mail-nodemailer` — Nodemailer-backed Mailer.
+ *
+ * Wraps a nodemailer Transporter so handlers can send mail through the
+ * canonical `Mailer` contract without knowing whether they're talking to
+ * Mailhog locally, Postfix on the same box, or a cloud relay.
+ *
+ *   import { smtpMailer } from "@nwire/mail-nodemailer";
+ *   import { mailPlugin } from "@nwire/mail";
+ *
+ *   defineApp("my-app", {
+ *     plugins: [mailPlugin({
+ *       mailer: smtpMailer({
+ *         host: process.env.SMTP_HOST,
+ *         port: Number(process.env.SMTP_PORT),
+ *         auth: { user: process.env.SMTP_USER!, pass: process.env.SMTP_PASS! },
+ *       }),
+ *       defaultFrom: '"My App" <noreply@example.com>',
+ *     })],
+ *   });
+ *
+ * For local dev:
+ *
+ *   smtpMailer({ host: "localhost", port: 1025 }) // Mailhog (no auth)
+ *
+ * Run `nwire infra up` and open http://localhost:8025 to inspect sent mail.
+ */
+import nodemailer from "nodemailer";
+import { MailSendError, } from "@nwire/mail";
+/** Build a Mailer backed by Nodemailer's SMTP transport. */
+export function smtpMailer(options) {
+    // nodemailer's `createTransport` is union-typed — its SMTPTransportOptions
+    // overload accepts `host`, but TS can't always pick it without help.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const transporter = options.transporter ?? nodemailer.createTransport({
+        host: options.host,
+        port: options.port,
+        secure: options.secure ?? false,
+        auth: options.auth,
+        pool: options.pool ?? true,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    });
+    return new NodemailerMailer(transporter);
+}
+class NodemailerMailer {
+    transporter;
+    constructor(transporter) {
+        this.transporter = transporter;
+    }
+    async send(message) {
+        const startedAt = performance.now();
+        try {
+            const info = await this.transporter.sendMail(toNodemailer(message));
+            return {
+                messageId: info.messageId ?? "",
+                durationMs: performance.now() - startedAt,
+            };
+        }
+        catch (err) {
+            throw new MailSendError(`SMTP send failed: ${err?.message ?? String(err)}`, err);
+        }
+    }
+    async healthCheck() {
+        // verify() resolves true on success; reject otherwise. Cheap, exact.
+        await this.transporter.verify();
+    }
+    async shutdown() {
+        this.transporter.close();
+    }
+}
+// ─── Mapping ────────────────────────────────────────────────────────
+function toNodemailer(message) {
+    return {
+        from: toAddressField(message.from),
+        to: toRecipientField(message.to),
+        cc: toRecipientField(message.cc),
+        bcc: toRecipientField(message.bcc),
+        replyTo: toAddressField(message.replyTo),
+        subject: message.subject,
+        text: message.text,
+        html: message.html,
+        headers: message.headers,
+        attachments: message.attachments?.map((a) => ({
+            filename: a.filename,
+            // Nodemailer's `content` accepts string | Buffer | Readable; for
+            // Uint8Array we copy into a Buffer to satisfy the typing.
+            content: a.content instanceof Uint8Array && !Buffer.isBuffer(a.content)
+                ? Buffer.from(a.content)
+                : a.content,
+            path: a.path,
+            contentType: a.contentType,
+            cid: a.cid,
+        })),
+    };
+}
+function toAddressField(addr) {
+    if (!addr)
+        return undefined;
+    if (typeof addr === "string")
+        return addr;
+    return { name: addr.name ?? "", address: addr.email };
+}
+function toRecipientField(rec) {
+    if (!rec)
+        return undefined;
+    if (typeof rec === "string")
+        return rec;
+    if (Array.isArray(rec)) {
+        return rec.map((r) => typeof r === "string" ? r : { name: r.name ?? "", address: r.email });
+    }
+    const obj = rec;
+    return { name: obj.name ?? "", address: obj.email };
+}
+//# sourceMappingURL=mail-nodemailer.js.map

package/dist/mail-nodemailer.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@nwire/mail-nodemailer",
+  "version": "0.7.0",
+  "description": "Nwire — Nodemailer-backed mail adapter. Implements the Mailer contract via nodemailer's transporter (SMTP/Mailhog/Gmail/Office365/...). Health-checked with transporter.verify(); graceful shutdown closes the pool.",
+  "keywords": [
+    "adapter",
+    "mail",
+    "mailhog",
+    "nodemailer",
+    "nwire",
+    "smtp"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/mail-nodemailer.js",
+  "types": "./dist/mail-nodemailer.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/mail-nodemailer.js",
+      "types": "./dist/mail-nodemailer.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "nodemailer": "^6.9.16",
+    "@nwire/mail": "0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "@types/nodemailer": "^6.4.17",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.6",
+    "@nwire/test-kit": "0.7.0"
+  },
+  "scripts": {
+    "build": "tsc && node ../../scripts/fix-dist-extensions.mjs dist",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}