#moonbit-community/email

• compose plain text, HTML, or multipart messages
• derive SMTP envelopes
• encode to RFC 5322 / MIME
• send through SMTP with a small number of steps

#Facade API

• compose_plain_text
• compose_html
• compose_mixed
• envelope_for
• send_plain_text
• send_html
• send_mixed
• to_rfc5322
• parse_rfc5322
• render_to_rfc5322

• Mailbox
• Body
• Message
• Envelope
• SmtpConfig
• SmtpTransport
• FakeTransport
• FileTransport

#Quick Start

// assuming you import the `moonbit-community/email` facade package

///|
let from = Mailbox::new("sender@example.com", Some("Sender")) |> must_ok

///|
let to = Mailbox::address_only("reader@example.com") |> must_ok

///|
let message = compose_plain_text(from, [to], "Greetings", "Hello from MoonBit!")
  |> must_ok

///|
let envelope = envelope_for(message) |> must_ok

///|
let encoded = to_rfc5322(message)

///|
let config = SmtpConfig::new(
  "smtp.example.com",
  465,
  security=SmtpSecurity::Tls,
  auth=SmtpAuth::Plain("sender@example.com", "app-password"),
)

///|
let outcome = send_plain_text(
    config,
    from,
    [to],
    "Greetings",
    "Hello from MoonBit!",
  )
  |> must_ok

#HTML and Attachments

///|
let attachment = Body::attachment_file(
    "report.pdf",
    "/path/to/report.pdf",
    content_type=infer_content_type("report.pdf"),
  )
  |> must_ok

///|
let message = compose_mixed(from, [to], "Monthly report", [
    Body::plain_text("See attachment."),
    attachment,
  ])
  |> must_ok

#Testing and Local Inspection

///|
let transport = FakeTransport::new()

///|
let outcome = transport.send_message(envelope, message) |> must_ok

#Command-Line Example

• QQ SMTP over TLS
• repeated --attachment arguments
• file-backed attachment sending through SmtpTransport

moon run cmd/main -- \
  --sender your-account@example.com \
  --recipient someone@example.com \
  --auth-code your-auth-code \
  --subject "MoonBit email test" \
  --body "Hello from moonbit-community/email"

#Status

• top-level facade helpers for compose and send flows
• MIME render and parse support
• in-memory and file-backed attachments
• fake, file, and real SMTP transports

• higher-level extension features under ext
• provider-specific integrations

#Development

moon check
moon test
moon info
moon fmt