class Amber::Mailer::SMTPAdapter

• Amber::Mailer::SMTPAdapter
• Amber::Mailer::DeliveryAdapter
• Reference
• Object

Overview

SMTP delivery adapter for sending emails via an SMTP server.

Implements the SMTP protocol using Crystal's standard library Socket and OpenSSL modules. Supports STARTTLS for encrypted connections and AUTH LOGIN for authentication.

Usage

adapter = SMTPAdapter.new(
  host: "smtp.example.com",
  port: 587,
  username: "[email protected]",
  password: "secret",
  use_tls: true,
  helo_domain: "myapp.com"
)

result = adapter.deliver(email)

SMTP Protocol Flow

1. Connect to SMTP server
2. Read server greeting (220)
3. Send EHLO
4. Optionally upgrade to TLS via STARTTLS
5. Re-send EHLO after TLS upgrade
6. Authenticate via AUTH LOGIN if credentials are provided
7. Send MAIL FROM, RCPT TO, DATA commands
8. Send the MIME message
9. Send QUIT

Defined in:

amber/mailer/smtp_adapter.cr

Constructors

• .new(host : String = "localhost", port : Int32 = 25, username : String | Nil = nil, password : String | Nil = nil, use_tls : Bool = false, helo_domain : String = "localhost")

Instance Method Summary

• #deliver(email : Email) : DeliveryResult

  Delivers an email by connecting to the SMTP server and transmitting the message using the SMTP protocol.

• #helo_domain : String
• #helo_domain=(helo_domain : String)
• #host : String
• #host=(host : String)
• #password : String | Nil
• #password=(password : String | Nil)
• #port : Int32
• #port=(port : Int32)
• #use_tls : Bool
• #use_tls=(use_tls : Bool)
• #username : String | Nil
• #username=(username : String | Nil)

Constructor Detail

Instance Method Detail