Configure SMTP
Connect a verified TLS relay or explicitly local development capture without exposing credentials.
Use a server-owned relay
import { createSmtpEmailAdapter } from "@smoothie-framework/email-smtp";
export function createRelay(user: string, pass: string) {
return createSmtpEmailAdapter({
host: "smtp.example.com",
port: 587,
security: "starttls",
auth: { user, pass },
});
}Load credentials on the server. starttls requires the upgrade; tls uses implicit verified TLS. Certificate verification cannot be disabled. Bound the send deadline for your deployment.
Capture development messages locally
local-plaintext is limited to supported loopback/local development hosts without credentials. It is not a remote production mode. Use a local mailbox such as Mailpit to inspect messages without sending to real recipients.
The adapter bounds delivery and projects safe outcomes; SMTP remains a remote side effect. Stable Message-ID can help duplicate handling, but cannot guarantee exactly-once delivery. Remote TLS and inbox behavior need deployment-specific checks.