pkgs.ml
Activity Stats For agents Log in with GitHub

suri-mailer

v0.0.43

Action Mailer-style message and delivery adapters for Suri apps

Repository Open docs Open in playground
Install
riot add suri-mailer
riot.toml
suri-mailer = "0.0.43"
Last release
May 15, 2026
License
Apache-2.0
Dependencies
2
Dependents
0
Installs
18
Published versions
10
Owner
@leostera@leostera
README Expand

Suri Mailer

suri-mailer is the Suri companion package for outbound email. It follows the useful parts of Rails Action Mailer without tying delivery to the web server:

  • mailer actions build typed Message.t values;
  • Mailer.t carries defaults such as from;
  • MessageDelivery.t is the deliverable wrapper;
  • Delivery.t selects how messages are sent;
  • local development and tests can use outbox, in-memory, or supervised mailbox delivery adapters.

Example:

let delivery = Suri_mailer.Delivery.outbox ~dir:"tmp/mails" ()

let mailer =
  Suri_mailer.Mailer.make
    ~default_from:"KaraokeCrowd <no-reply@example.test>"
    ~delivery
    ()

let welcome_email =
  Suri_mailer.Mailer.mail
    mailer
    ~to_:[ "singer@example.test" ]
    ~subject:"Welcome"
    ~text:"Welcome to KaraokeCrowd"
    ~html:"<p>Welcome to KaraokeCrowd</p>"
    ()

let result = Suri_mailer.MessageDelivery.deliver_now welcome_email

For Suri apps that need a test/dev inbox, start the supervised mailbox and mount its routes:

let mailer =
  Suri_mailer.Supervisor.start_link ()
  |> Result.unwrap

let app =
  Suri.Middleware.[
    router [
      Suri.Middleware.Router.scope "/__suri" [
        Suri.Middleware.Router.forward "/mailer" (Suri_mailer.routes mailer);
      ];
      (* your app routes *)
    ];
  ]

let delivery = Suri_mailer.Supervisor.delivery mailer

The mounted scope exposes:

  • GET /__suri/mailer for a small HTML inbox;
  • GET /__suri/mailer/messages for JSON summaries;
  • GET /__suri/mailer/messages/:id/json for JSON details;
  • GET /__suri/mailer/messages/:id/raw for the rendered .eml;
  • DELETE /__suri/mailer/messages or POST /__suri/mailer/clear to clear it.

For local end-to-end tests, use either Delivery.outbox when a file watcher is more convenient or Supervisor.delivery when the test harness can inspect the mounted mailbox routes. Suri_mailer.Supervisor.routes remains available when you want to keep all supervised mailbox calls under the Supervisor module.

Installs
Downloads over the last 30 days, stacked by release.
Total installs
18
Downloads over the last 30 days
v0.0.430
v0.0.420
v0.0.410
v0.0.4016
v0.0.390
Package status
Submission, indexing, and post-publish processing milestones for this release.
Submitted
May 15, 08:10 PM
Indexed
May 15, 08:10 PM
Searchable
May 15, 08:10 PM
Docs ready
May 15, 08:33 PM
Completed
Pending
Dependencies
Dependencies declared for this release.
Show 2 dependencies Expand
Dependents
Packages that currently depend on suri-mailer.
No dependents Expand

No indexed dependents yet.

Recent activity
Latest publication, indexing, and post-publish pipeline events recorded for this package.
Open full activity
Show 12 recent events Expand
  • Blocked
    suri-mailer 0.0.43 attempt 3 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:45:10 PM
    Event
    Blocked
    Package
    suri-mailer
    Version
    0.0.43
    Facts
    attempt 3 artifact 0b560622841d
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "status": "blocked",
  "attempt_count": 3,
  "error": "error: Unknown argument: suri-mailer"
}
  • Build failed
    suri-mailer 0.0.43 build · exit 1 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:45:08 PM
    Event
    Build failed
    Package
    suri-mailer
    Version
    0.0.43
    Summary
    error: Unknown argument: suri-mailer
    Facts
    build exit 1 artifact 0b560622841d
    Artifacts
    Result key
    pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/result.json
    Logs key
    pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/build.log
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "run_kind": "build",
  "result_key": "pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/result.json",
  "logs_key": "pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 62,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: suri-mailer",
  "stdout_excerpt": "error: Unknown argument: suri-mailer"
}
  • Processing
    suri-mailer 0.0.43 attempt 3 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:45:03 PM
    Event
    Processing
    Package
    suri-mailer
    Version
    0.0.43
    Facts
    attempt 3 artifact 0b560622841d
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "status": "processing",
  "attempt_count": 3
}
  • Requeued
    suri-mailer 0.0.43 attempt 2 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:39:32 PM
    Event
    Requeued
    Package
    suri-mailer
    Version
    0.0.43
    Facts
    attempt 2 artifact 0b560622841d
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "status": "pending",
  "attempt_count": 2,
  "next_attempt_at": "2026-05-15T20:44:32.511Z",
  "error": "error: Unknown argument: suri-mailer"
}
  • Build failed
    suri-mailer 0.0.43 build · exit 1 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:39:30 PM
    Event
    Build failed
    Package
    suri-mailer
    Version
    0.0.43
    Summary
    error: Unknown argument: suri-mailer
    Facts
    build exit 1 artifact 0b560622841d
    Artifacts
    Result key
    pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/result.json
    Logs key
    pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/build.log
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "run_kind": "build",
  "result_key": "pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/result.json",
  "logs_key": "pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 95,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: suri-mailer",
  "stdout_excerpt": "error: Unknown argument: suri-mailer"
}
  • Processing
    suri-mailer 0.0.43 attempt 2 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:39:25 PM
    Event
    Processing
    Package
    suri-mailer
    Version
    0.0.43
    Facts
    attempt 2 artifact 0b560622841d
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "status": "processing",
  "attempt_count": 2
}
  • Requeued
    suri-mailer 0.0.43 attempt 1 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:33:49 PM
    Event
    Requeued
    Package
    suri-mailer
    Version
    0.0.43
    Facts
    attempt 1 artifact 0b560622841d
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "status": "pending",
  "attempt_count": 1,
  "next_attempt_at": "2026-05-15T20:38:49.715Z",
  "error": "error: Unknown argument: suri-mailer"
}
  • Docs ready
    suri-mailer 0.0.43 docs · 2 json · doc.package_generation_completed · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:33:36 PM
    Event
    Docs ready
    Package
    suri-mailer
    Version
    0.0.43
    Facts
    docs 2 json doc.package_generation_completed artifact 0b560622841d
    Artifacts
    Result key
    pipelines/docs/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/result.json
    Logs key
    pipelines/docs/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/command.log
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "run_kind": "docs",
  "output_prefix": "docs/suri-mailer/0.0.43/",
  "public_docs_url": "https://docs.pkgs.ml/p/suri-mailer/0.0.43/",
  "result_key": "pipelines/docs/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/result.json",
  "logs_key": "pipelines/docs/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/command.log",
  "json_event_count": 2,
  "non_json_stdout_count": 0,
  "last_json_event_type": "doc.package_generation_completed"
}
  • Build failed
    suri-mailer 0.0.43 build · exit 1 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:33:35 PM
    Event
    Build failed
    Package
    suri-mailer
    Version
    0.0.43
    Summary
    error: Unknown argument: suri-mailer
    Facts
    build exit 1 artifact 0b560622841d
    Artifacts
    Result key
    pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/result.json
    Logs key
    pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/build.log
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "run_kind": "build",
  "result_key": "pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/result.json",
  "logs_key": "pipelines/builds/suri-mailer/0.0.43/0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05/build.log",
  "environment_probe": {
    "success": true,
    "exit_code": 0,
    "stdout": "glibc=glibc 2.39\nriot=riot 0.0.43 (build 2a3a2071a5f0)\nPRETTY_NAME=\"Ubuntu 24.04.4 LTS\"\nNAME=\"Ubuntu\"\nVERSION_ID=\"24.04\"\nVERSION=\"24.04.4 LTS (Noble Numbat)\"\nVERSION_CODENAME=noble\nID=ubuntu\nID_LIKE=debian\nHOME_URL=\"https://www.ubuntu.com/\"\nSUPPORT_URL=\"https://help.ubuntu.com/\"\nBUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"\nPRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"\nUBUNTU_CODENAME=noble\nLOGO=ubuntu-logo",
    "stderr": "",
    "duration_ms": 60,
    "command": [
      "sh",
      "-lc",
      "printf 'glibc=%s\\n' \"$(getconf GNU_LIBC_VERSION 2>/dev/null || echo unknown)\" && printf 'riot=%s\\n' \"$(/root/.riot/bin/riot version 2>/dev/null || echo unavailable)\" && cat /etc/os-release"
    ],
    "json_events": [],
    "non_json_stdout_lines": [
      "glibc=glibc 2.39",
      "riot=riot 0.0.43 (build 2a3a2071a5f0)",
      "PRETTY_NAME=\"Ubuntu 24.04.4 LTS\"",
      "NAME=\"Ubuntu\"",
      "VERSION_ID=\"24.04\"",
      "VERSION=\"24.04.4 LTS (Noble Numbat)\"",
      "VERSION_CODENAME=noble",
      "ID=ubuntu",
      "ID_LIKE=debian",
      "HOME_URL=\"https://www.ubuntu.com/\"",
      "SUPPORT_URL=\"https://help.ubuntu.com/\"",
      "BUG_REPORT_URL=\"https://bugs.launchpad.net/ubuntu/\"",
      "PRIVACY_POLICY_URL=\"https://www.ubuntu.com/legal/terms-and-policies/privacy-policy\"",
      "UBUNTU_CODENAME=noble",
      "LOGO=ubuntu-logo"
    ]
  },
  "exit_code": 1,
  "json_event_count": 0,
  "non_json_stdout_count": 1,
  "failure_summary": "error: Unknown argument: suri-mailer",
  "stdout_excerpt": "error: Unknown argument: suri-mailer"
}
  • Processing
    suri-mailer 0.0.43 attempt 1 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:33:23 PM
    Event
    Processing
    Package
    suri-mailer
    Version
    0.0.43
    Facts
    attempt 1 artifact 0b560622841d
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "status": "processing",
  "attempt_count": 1
}
  • Queued
    suri-mailer 0.0.43 artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:10:04 PM
    Event
    Queued
    Package
    suri-mailer
    Version
    0.0.43
    Facts
    artifact 0b560622841d
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "status": "pending"
}
  • Indexed
    suri-mailer 0.0.43 latest 0.0.43 · artifact 0b560622841d
    Details
    When
    May 15, 2026, 08:10:00 PM
    Event
    Indexed
    Package
    suri-mailer
    Version
    0.0.43
    Facts
    latest 0.0.43 artifact 0b560622841d
    Payload
    {
  "artifact_sha256": "0b560622841d93b55eb80a53f270bb8b346956eb98c58622663d202e6dd42c05",
  "latest": "0.0.43",
  "package_index_key": "index/v1/su/ri/suri-mailer.json",
  "package_index_url": "https://cdn.pkgs.ml/index/v1/su/ri/suri-mailer.json",
  "changed": true
}