mailbox

Локальный почтовый приёмник для разработки: запустите один SMTP-сервер и HTTP API для всей машины и направьте на него каждый проект. Письма никогда не покидают ваше устройство — вместо этого они попадают в просматриваемый почтовый ящик с веб-интерфейсом, CLI и MCP-сервером для ИИ-агентов.

Один общий экземпляр устраняет конфликты портов между проектами: запустите его один раз, подключайте многие.

Установка

pnpm add -D @sdk-e/mailbox   # or npm i -D / yarn add -D

Или запустите ad hoc:

npx @sdk-e/mailbox

Быстрый старт

mailbox            # SMTP on :11025, inbox UI on http://localhost:11090

Отправляйте почту на smtp://127.0.0.1:11025 из любого приложения (nodemailer, Resend dev mode и т.д.), затем:

open http://localhost:11090   # or: mailbox-cli open

Бинарники

Примеры использования CLI

mailbox-cli list
mailbox-cli read 3
mailbox-cli wait "verification code" --timeout 10   # blocks until a new matching message arrives
mailbox-cli clear

wait сопоставляет только сообщения, которые приходят после его запуска — запустите его до отправки.

Использование библиотеки

import { startMailbox } from "@sdk-e/mailbox";

const mailbox = await startMailbox({ smtpPort: 0, httpPort: 0 }); // 0 = ephemeral
console.log(mailbox.smtpPort, mailbox.url);
await mailbox.close();

Идеально подходит для интеграционных тестов, которым нужен изолированный временный почтовый ящик.

HTTP API (стабильный сетевой протокол)

Конфигурация

Переменные окружения (.env.local, затем .env в рабочем каталоге загружаются, если они присутствуют):

Направьте почтовик вашего приложения на smtp://127.0.0.1:$MAIL_SMTP_PORT локально; в продакшене продолжайте использовать вашего реального провайдера. Сервер отказывается запускаться, когда NODE_ENV=production.

Почему высокие порты?

1025/1080 (классические значения по умолчанию в стиле MailHog) часто конфликтуют. mailbox по умолчанию использует 11025/11090, чтобы несколько проектов SDK-E могли использовать один экземпляр, не мешая друг другу или другим локальным инструментам.

Разработка

Требуется Node >= 20 и pnpm >= 11.

pnpm install
pnpm verify     # format, lint, typecheck, test, build

См. CONTRIBUTING.md.

Лицензия

MIT