ilusm.dev

eml

Minimal outbound email surface - send an email by specifying a recipient address, subject line, and message body. The actual transport (SMTP, API, queue) is provided by the embedder via __email_send. For full SMTP control including authentication, Cc, and HTML bodies, use the smtp module instead.

Load with: use eml

What this module does

eml is the smallest possible outbound email interface: one function, three arguments, no configuration. The host injects __email_send and decides how mail is actually delivered. This is useful in sandboxed or managed environments where the embedder controls the mail infrastructure and ilusm code only needs to trigger a send.

Quick example

use eml

emsnd("alice@example.com", "Hello!", "Just wanted to say hi.")

emsnd(
    "team@example.com",
    "Deployment successful",
    "Build #42 deployed to production at " + now_str
)

Functions

Sending

emsnd(to, subject, body)

Sends an email to to with subject and body. All arguments are coerced to strings. Delegates directly to __email_send. Return value is embedder-defined.

Notes

  • Requires the host to inject __email_send(to, subject, body).
  • For SMTP sessions with authentication, multiple recipients, HTML bodies, Cc, and Reply-To, use the smtp module.
  • No stdlib dependencies.