sunabamail 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 856ebc548796776b7b192691b54668c2e81c9c2cfceb62b2057ab9358071270c
+  data.tar.gz: fa2b1dcb6033d4f6ad9a2af74937d07c03b2b8bdbfb2e91d2a9b11c9dd012d2e
+SHA512:
+  metadata.gz: fa0b4dc118595c7eb59f2d368c719925ba0e90cdb4bc6b661d9d46083306fcb706c1e8396dbabc9cd4fa22507e12cd7fab8df76eff91bd9ba829b0f1610c37dd
+  data.tar.gz: ec79d435cba4ddfaf3bc7dae08b8abc5a2bf8ed2655172242fe7406f495baf387f1bd5cb35ac786b49bc4a2ed6f0ac1fc9be6459bbbe69391aa9a4ed398c05fe

data/.github/workflows/main.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    name: "Ruby ${{ matrix.ruby }} x Rails ${{ matrix.rails }}"
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.1', '3.2', '3.3', '3.4', '4.0']
+        rails:
+          - '~> 7.0.0'
+          - '~> 7.1.0'
+          - '~> 7.2.0'
+          - '~> 8.0.0'
+          - '~> 8.1.0'
+          - 'head'
+        exclude:
+          - ruby: '3.1'
+            rails: 'head'
+          - ruby: '3.2'
+            rails: 'head'
+          - ruby: '3.1'
+            rails: '~> 8.0.0'
+          - ruby: '3.1'
+            rails: '~> 8.1.0'
+    env:
+      RAILS: ${{ matrix.rails }}
+    steps:
+      - uses: actions/checkout@v5
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - name: Run test
+        run: bundle exec rake test
+      - name: Run rubocop
+        run: bundle exec rake rubocop

data/.rubocop.yml

@@ -0,0 +1,7 @@
+# Omakase Ruby styling for Rails
+inherit_gem:
+  rubocop-rails-omakase: rubocop.yml
+
+AllCops:
+  Exclude:
+    - 'lib/generators/sunabamail/templates/**/*'

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-05-06
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Takashi SAKAGUCHI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,119 @@
+# Sunabamail
+
+Sunabamail is an Action Mailer delivery method that stores emails in the database - so you can inspect them from anywhere via a built-in web UI.
+
+## Why Sunabamail?
+
+In modern Rails applications, emails are often generated across multiple processes — web servers, background workers, and staging environments.
+
+Sunabamail is designed for this kind of setup.
+In other words, it makes emails observable regardless of where they are generated.
+
+By storing emails in the database, it allows you to:
+
+- Access emails from any process or server
+- Inspect emails generated by background jobs
+- Verify email behavior safely in staging
+
+It works well alongside traditional development tools, while focusing on setups where emails need to be observable across processes and environments.
+
+## Features
+
+- Drop-in replacement for `ActionMailer` delivery method
+- Stores emails in a dedicated database (separate from your app data)
+- Built-in Rails Engine UI (`/sunabamail`) for browsing emails
+- Works across processes and servers
+- Ideal for development and staging
+
+## Installation
+
+```sh
+bundle add sunabamail --group development
+bin/rails sunabamail:install
+```
+
+This will:
+
+- Configure action_mailer.delivery_method
+- Mount the engine
+- Generate db/sunabamail_schema.rb
+
+### Database configuration
+
+Add a dedicated database for Sunabamail.
+
+#### SQLite
+
+```yaml
+development:
+  primary:
+    <<: *default
+    database: storage/development.sqlite3
+  sunabamail:
+    <<: *default
+    database: storage/development_sunabamail.sqlite3
+    migrations_paths: db/sunabamail_migrate
+```
+
+#### MySQL / PostgreSQL / Trilogy
+
+```yaml
+development:
+  primary: &primary_development
+    <<: *default
+    database: app_development
+    username: app
+    password: <%= ENV["APP_DATABASE_PASSWORD"] %>
+  sunabamail:
+    <<: *primary_development
+    database: app_development_sunabamail
+    migrations_paths: db/sunabamail_migrate
+```
+Then run:
+
+```sh
+bin/rails db:prepare
+```
+
+### Usage
+
+Start your Rails server and visit:
+
+```
+http://localhost:3000/sunabamail
+```
+
+You will see a list of captured emails and their contents:
+
+![Web interface](assets/sunabamail.png)
+
+You can:
+
+- Browse captured emails
+- Inspect subject, body, and headers
+- Debug mailer behavior without sending real emails
+
+### Usage in staging
+
+Sunabamail can also be used in staging environments.
+
+This is especially useful when:
+
+- You want to verify email behavior without sending real emails
+- Your app runs background jobs on separate workers
+
+**NOTE** Not intended for production use.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/hamajyotan/sunabamail.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/app/controllers/sunabamail/application_controller.rb

@@ -0,0 +1,4 @@
+class Sunabamail::ApplicationController < ActionController::Base
+  # Only allow modern browsers supporting webp images, web push, badges, import maps, CSS nesting, and CSS :has.
+  allow_browser versions: :modern
+end

data/app/controllers/sunabamail/messages/alls_controller.rb

@@ -0,0 +1,6 @@
+class Sunabamail::Messages::AllsController < ApplicationController
+  def destroy
+    Sunabamail::Message.destroy_all
+    redirect_to messages_path, notice: "destroyed"
+  end
+end

data/app/controllers/sunabamail/messages/application_controller.rb

@@ -0,0 +1,9 @@
+class Sunabamail::Messages::ApplicationController < Sunabamail::ApplicationController
+  before_action :set_message
+
+  private
+
+  def set_message
+    @message = Sunabamail::Message.find(params.expect(:message_id))
+  end
+end

data/app/controllers/sunabamail/messages/attachments_controller.rb

@@ -0,0 +1,13 @@
+class Sunabamail::Messages::AttachmentsController < Sunabamail::Messages::ApplicationController
+  before_action :set_attachment, only: %i[show]
+
+  def show
+    send_data(@attachment.read, filename: @attachment.filename)
+  end
+
+  private
+
+  def set_attachment
+    @attachment = @message.mail.attachments[params.expect(:id).to_i]
+  end
+end

data/app/controllers/sunabamail/messages/htmls_controller.rb

@@ -0,0 +1,12 @@
+class Sunabamail::Messages::HtmlsController < Sunabamail::Messages::ApplicationController
+  def show
+    html = @message.mail.html_part.body.to_s.force_encoding(@message.mail.charset)
+    doc = Nokogiri::HTML.fragment(html)
+    doc.css("a").each do |a|
+      a["target"] = "_blank"
+      a["rel"] = "noopener noreferrer"
+    end
+
+    send_data doc.to_html, type: "text/html", disposition: "inline"
+  end
+end

data/app/controllers/sunabamail/messages/raws_controller.rb

@@ -0,0 +1,7 @@
+class Sunabamail::Messages::RawsController < Sunabamail::Messages::ApplicationController
+  def show
+    send_data @message.raw.encoded,
+      type: "text/plain",
+      disposition: "inline"
+  end
+end

data/app/controllers/sunabamail/messages/sources_controller.rb

@@ -0,0 +1,7 @@
+class Sunabamail::Messages::SourcesController < Sunabamail::Messages::ApplicationController
+  def show
+    send_data @message.mail.html_part.body.to_s.force_encoding(@message.mail.charset),
+      type: "text/plain",
+      disposition: "inline"
+  end
+end

data/app/controllers/sunabamail/messages/texts_controller.rb

@@ -0,0 +1,7 @@
+class Sunabamail::Messages::TextsController < Sunabamail::Messages::ApplicationController
+  def show
+    send_data @message.mail.text_part.body.to_s.force_encoding(@message.mail.charset),
+      type: "text/plain",
+      disposition: "inline"
+  end
+end

data/app/controllers/sunabamail/messages_controller.rb

@@ -0,0 +1,22 @@
+class Sunabamail::MessagesController < Sunabamail::ApplicationController
+  before_action :set_message, only: %i[show destroy]
+
+  def index
+    @messages = Sunabamail::Message.all.order(id: :desc)
+    @message = @messages.first
+  end
+
+  def show
+  end
+
+  def destroy
+    @message.destroy!
+    redirect_to messages_path, notice: "destroyed", status: :see_other
+  end
+
+  private
+
+  def set_message
+    @message = Sunabamail::Message.find(params.expect(:id))
+  end
+end

data/app/models/sunabamail/message.rb

@@ -0,0 +1,12 @@
+class Sunabamail::Message < Sunabamail::Record
+  has_one :raw,
+    foreign_key: :sunabamail_message_id,
+    class_name: "Sunabamail::MessageRaw",
+    inverse_of: :message,
+    dependent: :destroy,
+    autosave: true
+
+  def mail
+    Mail::Message.new(raw.encoded)
+  end
+end

data/app/models/sunabamail/message_raw.rb

@@ -0,0 +1,6 @@
+class Sunabamail::MessageRaw < Sunabamail::Record
+  belongs_to :message,
+    foreign_key: :sunabamail_message_id,
+    class_name: "Sunabamail::Message",
+    inverse_of: :raw
+end

data/app/models/sunabamail/record.rb

@@ -0,0 +1,5 @@
+class Sunabamail::Record < ActiveRecord::Base
+  self.abstract_class = true
+
+  connects_to(**Sunabamail.connects_to) if Sunabamail.connects_to
+end

data/app/views/layouts/sunabamail/application.html.erb

@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title><%= "Sunabamail" %></title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="application-name" content="Sunabamail">
+    <meta name="mobile-web-app-capable" content="yes">
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+
+    <%= yield :head %>
+
+    <%= render "styles" %>
+    <%= render "scripts" %>
+  </head>
+
+  <body>
+    <%= yield %>
+  </body>
+</html>

data/app/views/sunabamail/application/_scripts.html.erb

@@ -0,0 +1,155 @@
+<script>
+document.addEventListener('DOMContentLoaded', function() {
+  initConfirm();
+  initPaneSeparator();
+  initMessageList();
+});
+
+function initConfirm() {
+  document.addEventListener('click', function (e) {
+    const el = e.target.closest("[data-confirm]") || e.target.closest("[data-turbo-confirm]");
+    if (!el) return;
+
+    const message = el.dataset.confirm || el.dataset.turboConfirm;
+    if (!confirm(message)) {
+      e.preventDefault();
+    }
+  });
+}
+
+function initPaneSeparator() {
+  const separator = document.querySelector('[data-pane-separator]');
+  const container = document.querySelector('[data-messages-list-container]');
+  const listPane = document.querySelector('[data-messages-list-pane]');
+  if (!separator || !container || !listPane) return;
+
+  let startX = 0;
+  let startWidth = 0;
+
+  separator.addEventListener('pointerdown', (e) => {
+    e.preventDefault();
+
+    startX = e.clientX;
+    startWidth = listPane.offsetWidth;
+
+    separator.classList.add('dragging');
+    document.body.style.userSelect = 'none';
+
+    const onMove = (e) => {
+      const containerWidth = container.offsetWidth;
+      const minWidth = 200;
+      const maxWidth = Math.max(minWidth, containerWidth - 250);
+
+      const diffX = e.clientX - startX;
+      const newWidth = startWidth + diffX;
+
+      if (newWidth >= minWidth && newWidth <= maxWidth) {
+        listPane.style.flex = `0 0 ${newWidth}px`;
+      }
+    };
+
+    const onUp = () => {
+      separator.classList.remove('dragging');
+      document.body.style.userSelect = '';
+
+      document.removeEventListener('pointermove', onMove);
+      document.removeEventListener('pointerup', onUp);
+      window.removeEventListener('blur', onUp);
+    };
+
+    document.addEventListener('pointermove', onMove);
+    document.addEventListener('pointerup', onUp);
+    window.addEventListener('blur', onUp);
+  });
+}
+
+function initMessageList() {
+  const mailListContainer = document.querySelector('[data-mail-list-container]');
+  const mailContainer = document.querySelector('[data-mail-container]');
+  if (!mailListContainer || !mailContainer) return;
+
+  const mailListItems = mailListContainer.querySelectorAll('[data-mail-list-item]');
+  if (!mailListItems.length) return;
+
+  const mailErrorMessage = mailListContainer.querySelector('[data-mail-error-message]');
+
+  let currentRequestId = 0;
+
+  mailListContainer.addEventListener('click', (e) => {
+    const item = e.target.closest('[data-mail-list-item]');
+    if (!item) return;
+    if (e.target.closest('[data-mail-list-item-delete]')) return;
+
+    const messagePath = item.dataset.messagePath;
+    if (!messagePath) return;
+
+    mailListItems.forEach(i => i.classList.remove('active'));
+    item.classList.add('active');
+
+    fetchMessageDetail(messagePath);
+  });
+
+  mailContainer.addEventListener('click', (e) => {
+    const handle = e.target.closest('[data-mail-view-handle]');
+    if (!handle) return;
+
+    activateMailView(handle);
+  });
+
+  const firstMailListItem = mailListItems[0];
+  if (firstMailListItem) {
+    firstMailListItem.classList.add('active');
+    fetchMessageDetail(firstMailListItem.dataset.messagePath);
+  }
+
+  function fetchMessageDetail(url) {
+    const requestId = ++currentRequestId;
+
+    fetch(url, {
+      method: 'GET',
+      headers: {
+        'Accept': 'text/html'
+      }
+    })
+    .then(response => {
+      if (!response.ok) throw new Error('Failed to load message');
+      return response.text();
+    })
+    .then(html => {
+      if (requestId !== currentRequestId) return;
+
+      // Extract the main content div from the response
+      const parser = new DOMParser();
+      const doc = parser.parseFromString(html, 'text/html');
+      const messageContent = doc.querySelector('[data-mail-detail-root]')
+
+      if (messageContent) {
+        mailContainer.innerHTML = messageContent.innerHTML;
+        const firstHandle = mailContainer.querySelector('[data-mail-view-handle]')
+        firstHandle && activateMailView(firstHandle);
+      }
+    })
+    .catch(error => {
+      console.error('Error loading message:', error);
+      if (mailErrorMessage) {
+        mailContainer.innerHTML = mailErrorMessage.innerHTML;
+      }
+    });
+  }
+
+  function activateMailView(handle) {
+    mailContainer.querySelectorAll('[data-mail-view-handle]').forEach(i => i.classList.remove('active'));
+    handle.classList.add('active');
+    mailContainer.querySelectorAll('[data-mail-view]').forEach((v) => {
+      const active = (v.dataset.mailView === handle.dataset.mailViewTarget);
+      v.classList.toggle('active', active);
+      if (active) {
+        const iframe = v.querySelector('iframe');
+        if (iframe && !iframe.src && iframe.dataset.src) {
+          iframe.src = iframe.dataset.src;
+        }
+      }
+    });
+  }
+}
+</script>

data/app/views/sunabamail/application/_styles.html.erb

@@ -0,0 +1,281 @@
+<style>
+.message-header-container {
+  display: flex;
+  flex-direction: column;
+}
+
+.message-header {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 0 1rem;
+  border: 1px solid #dee2e6;
+  border-radius: 0.25rem;
+  padding: 1rem;
+  background-color: #f8f9fa;
+}
+
+.message-header dl {
+  margin: 0;
+  display: contents;
+}
+
+.message-header small {
+  grid-column: 1 / -1;
+  margin-top: 0.5rem;
+  color: #6c757d;
+}
+
+.message-subject {
+  margin-top: 0;
+}
+
+/* Message Views Tabs */
+.message-views-tabs-container {
+  display: flex;
+  flex-direction: column;
+}
+
+.message-views-tabs {
+  display: flex;
+  gap: 0.5rem;
+  margin: 1rem 0;
+  border-bottom: 2px solid #e0e0e0;
+  padding-bottom: 0;
+}
+
+.message-view-tab {
+  padding: 0.5rem 1rem;
+  background: none;
+  border: none;
+  border-bottom: 3px solid transparent;
+  cursor: pointer;
+  font-size: 0.9rem;
+  color: #666;
+  transition: color 0.2s, border-color 0.2s;
+}
+
+.message-view-tab:hover {
+  color: #333;
+}
+
+.message-view-tab.active {
+  color: #0066cc;
+  border-bottom-color: #0066cc;
+}
+
+.message-view-item {
+  display: none;
+  flex-direction: column;
+  flex: 1;
+}
+
+.message-view-item.active {
+  display: flex;
+}
+
+.message-view-item iframe {
+  width: 100%;
+  min-height: 400px;
+  border: 1px solid #e0e0e0;
+  border-radius: 0.25rem;
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+}
+
+.message-attachments {
+  padding: 1rem .25rem 0;
+  font-size: 0.875rem;
+}
+
+.message-attachments a {
+  display: inline-block;
+  margin-right: 1rem;
+  margin-bottom: 0.5rem;
+}
+
+.message-header dt {
+  color: #495057;
+  grid-column: 1;
+  font-size: 0.875rem;
+}
+
+.message-header dd {
+  margin: 0;
+  color: #212529;
+  grid-column: 2;
+  word-break: break-word;
+}
+
+.message-item-header {
+  display: grid;
+  grid-template-columns: auto 1fr;
+  gap: 0 0.5rem;
+  margin: 0.25rem 0;
+  font-size: 0.875rem;
+}
+
+.message-item-header dt {
+  display: inline;
+  margin: 0;
+}
+
+.message-item-header dd {
+  display: inline;
+  margin: 0;
+}
+
+.message-item-header small {
+  font-size: 0.75rem;
+  color: #999;
+}
+
+.messages-toolbar {
+  display: flex;
+  gap: 0.5rem;
+}
+
+.messages-toolbar button,
+.messages-toolbar form {
+  display: inline-block;
+}
+
+.messages-toolbar button img, .messages-toolbar button svg {
+  width: 20px;
+  height: 20px;
+}
+
+.messages-container {
+  display: flex;
+  gap: 0;
+  overflow: hidden;
+}
+
+.pane-separator {
+  flex: 0 0 8px;
+  cursor: col-resize;
+  user-select: none;
+  transition: background-color 0.2s;
+}
+
+.pane-separator:hover {
+  background-color: #a0a0a0;
+}
+
+.pane-separator.dragging {
+  background-color: #a0a0a0;
+}
+
+.messages-list-pane {
+  flex: 0 0 30%;
+  display: flex;
+  flex-direction: column;
+  height: calc(100vh - 2rem);
+  overflow: hidden;
+  min-height: 0;
+  background-color: #fafafa;
+}
+
+.messages-list-pane header {
+  margin: 1rem 1rem .5rem;
+  position: sticky;
+  top: 0;
+  z-index: 1;
+  background-color: #fafafa;
+}
+
+.messages-list-pane header h1 {
+  margin: 0 0 .5rem;
+  font-size: 1.25rem;
+  font-weight: 600;
+}
+
+.messages-list-pane header h1 a {
+  color: inherit;
+  text-decoration: none;
+}
+
+.messages-list-pane header h1 a:hover,
+.messages-list-pane header h1 a:focus {
+  text-decoration: none;
+  color: #333;
+  opacity: 0.8;
+}
+
+.messages-list-pane ul {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  overflow-y: auto;
+  flex: 1;
+  min-height: 0;
+}
+
+.messages-list-pane li {
+  border-bottom: 1px solid #e0e0e0;
+  padding: 1rem;
+  cursor: pointer;
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: 0.5rem;
+}
+
+.messages-list-pane li:hover {
+  background-color: #f0f0f0;
+}
+
+.messages-list-pane li.active {
+  background-color: #e3f2fd;
+}
+
+.message-item-content {
+  flex: 1;
+  min-width: 0;
+}
+
+.message-item-content p {
+  margin: 0 0 0.5rem 0;
+  font-weight: 500;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.message-item-content dl {
+  margin: 0.25rem 0;
+  font-size: 0.875rem;
+}
+
+.message-item-content dt,
+.message-item-content dd {
+  display: inline;
+  margin: 0;
+}
+
+.message-item-content dt::after {
+  content: " ";
+}
+
+.message-item-content dd::after {
+  content: "\A";
+  white-space: pre;
+}
+
+.message-item-content span {
+  font-size: 0.75rem;
+  color: #999;
+}
+
+.message-item-delete-button {
+  font-size: 1rem;
+}
+
+.messages-detail-pane {
+  display: flex;
+  flex-direction: column;
+  flex: 1;
+  padding: 1rem;
+  background-color: white;
+}
+</style>

data/app/views/sunabamail/messages/_message.html.erb

@@ -0,0 +1,82 @@
+<h2 class="message-subject"><%= object.subject %></h2>
+
+<div class="message-header-container">
+  <div class="message-header">
+    <dl>
+      <% if object.from %>
+        <dt>From:</dt>
+        <dd><%= object.from %></dd>
+      <% end %>
+
+      <% if object.sender %>
+        <dt>Sender:</dt>
+        <dd><%= object.sender %></dd>
+      <% end %>
+
+      <% if object.to %>
+        <dt>To:</dt>
+        <dd><%= object.to %></dd>
+      <% end %>
+
+      <% if object.cc %>
+        <dt>Cc:</dt>
+        <dd><%= object.cc %></dd>
+      <% end %>
+
+      <% if object.bcc %>
+        <dt>Bcc:</dt>
+        <dd><%= object.bcc %></dd>
+      <% end %>
+
+      <% if object.reply_to %>
+        <dt>Reply-To:</dt>
+        <dd><%= object.reply_to %></dd>
+      <% end %>
+    </dl>
+
+    <small><%= l object.created_at, format: :long %></small>
+  </div>
+</div>
+
+<% mail = object.mail %>
+
+<% if mail.attachments.any? %>
+  <div class="message-attachments">
+    <% mail.attachments.each.with_index do |attachment, index| %>
+      <%= link_to attachment.filename, message_attachment_path(object, index), download: true %>
+    <% end %>
+  </div>
+<% end %>
+
+<% has_html = mail.html_part.present? %>
+<% has_text = mail.text_part.present? %>
+
+<div class="message-views-tabs-container">
+  <div class="message-views-tabs">
+    <% if has_html %>
+      <button class="message-view-tab" data-mail-view-handle data-mail-view-target="html">Html</button>
+      <button class="message-view-tab" data-mail-view-handle data-mail-view-target="source">Html Source</button>
+    <% end %>
+    <% if has_text %>
+      <button class="message-view-tab" data-mail-view-handle data-mail-view-target="text">Text</button>
+    <% end %>
+    <button class="message-view-tab" data-mail-view-handle data-mail-view-target="raw">Raw</button>
+  </div>
+</div>
+
+<% if has_html %>
+  <div class="message-view-item" data-mail-view="html">
+    <%= tag.iframe sealmess: "sealmess", data: { src: message_html_path(object) } %>
+  </div>
+  <div class="message-view-item" data-mail-view="source">
+    <%= tag.iframe sealmess: "sealmess", data: { src: message_source_path(object) } %>
+  </div>
+<% end %>
+<% if has_text %>
+  <div class="message-view-item" data-mail-view="text">
+    <%= tag.iframe sealmess: "sealmess", data: { src: message_text_path(object) } %>
+  </div>
+<% end %>
+<div class="message-view-item" data-mail-view="raw">
+  <%= tag.iframe sealmess: "sealmess", data: { src: message_raw_path(object) } %>
+</div>

data/app/views/sunabamail/messages/index.html.erb

@@ -0,0 +1,71 @@
+<template data-mail-error-message>
+  <%= t("sunabamail.failed_to_load_email") %>
+</template>
+
+<div class="messages-container" data-messages-list-container>
+  <!-- Left Pane: Messages List -->
+  <div class="messages-list-pane" data-messages-list-pane>
+    <header>
+      <h1><%= link_to "Sunabamail", root_path %></h1>
+      <div class="messages-toolbar">
+        <%= button_to messages_path, method: :get, form: { style: "display: inline;" } do %>
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+            <path d="M4 12a8 8 0 0 1 13.66-5.66"/>
+            <polyline points="18 3 18 8 13 8"/>
+            <path d="M20 12a8 8 0 0 1-13.66 5.66"/>
+            <polyline points="6 21 6 16 11 16"/>
+          </svg>
+        <% end %>
+        <%= button_to messages_all_path, method: :delete,
+                                         disabled: @messages.blank?,
+                                         form: { style: "display: inline;" },
+                                         data: { turbo_confirm: t("sunabamail.destroy_confirm") } do %>
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+            <path d="M3 6h18"/>
+            <path d="M8 6V4h8v2"/>
+            <path d="M6 6l1 14h10l1-14"/>
+            <path d="M10 11v6"/>
+            <path d="M14 11v6"/>
+          </svg>
+        <% end %>
+      </div>
+    </header>
+
+    <ul id="messages" data-mail-list-container>
+      <p style="color: green"><%= notice %></p>
+
+      <% @messages.each do |message| %>
+        <li class="message-item" data-mail-list-item data-message-path="<%= message_path(message) %>">
+          <div class="message-item-content">
+            <p><%= message.subject %></p>
+            <dl class="message-item-header">
+              <% if message.from %>
+                <dt>From:</dt>
+                <dd><%= message.from %></dd>
+              <% end %>
+              <% if message.to %>
+                <dt>To:</dt>
+                <dd><%= message.to %></dd>
+              <% end %>
+            </dl>
+            <span><%= time_ago_in_words message.created_at %></span>
+          </div>
+          <%= button_to message_path(message), method: :delete,
+                                               class: "message-item-delete-button",
+                                               data: { turbo_confirm: t("sunabamail.destroy_confirm") },
+                                               form: { data: { mail_list_item_delete: true } } do %>
+            &times;
+          <% end %>
+        </li>
+      <% end %>
+    </ul>
+  </div>
+
+  <!-- Resizable Separator -->
+  <div class="pane-separator" data-pane-separator></div>
+
+  <!-- Right Pane: Message Detail -->
+  <div class="messages-detail-pane" data-mail-container>
+    <p><%= t("sunabamail.no_mail_items") %></p>
+  </div>
+</div>

data/app/views/sunabamail/messages/show.html.erb

@@ -0,0 +1,3 @@
+<div data-mail-detail-root>
+  <%= render "message", object: @message %>
+</div>

data/config/locales/en.yml

@@ -0,0 +1,5 @@
+en:
+  sunabamail:
+    destroy_confirm: "Are you sure?"
+    failed_to_load_email: "Failed to load email."
+    no_mail_items: "No mail items."

data/config/routes.rb

@@ -0,0 +1,16 @@
+Sunabamail::Engine.routes.draw do
+  namespace :messages do
+    resource :all, only: %i[destroy]
+  end
+  resources :messages, only: %i[index show destroy] do
+    scope module: :messages do
+      resources :attachments, only: %i[show]
+      resource :html, only: %i[show]
+      resource :raw, only: %i[show]
+      resource :source, only: %i[show]
+      resource :text, only: %i[show]
+    end
+  end
+
+  root to: redirect("messages")
+end

data/lib/generators/sunabamail/install_generator.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+class Sunabamail::InstallGenerator < Rails::Generators::Base
+  source_root File.expand_path("templates", __dir__)
+
+  def copy_files
+    template "db/sunabamail_schema.rb"
+  end
+
+  def configure_adapter
+    pathname = Pathname(destination_root).join("config/environments/development.rb")
+
+    if File.read(pathname).match?(/config\.action_mailer\.delivery_method\s*=/)
+      gsub_file pathname,
+        /(# )?config\.action_mailer\.delivery_method\s+=.*\n/,
+        "config.action_mailer.delivery_method = :sunabamail\n"
+    else
+      environment <<~RUBY, env: "development"
+        config.action_mailer.delivery_method = :sunabamail
+      RUBY
+    end
+  end
+
+  def configure_database
+    environment <<~RUBY, env: "development"
+      config.sunabamail.connects_to = { database: { writing: :sunabamail } }
+    RUBY
+  end
+
+  def add_mount_routes
+    route <<~ROUTE
+      if Rails.configuration.action_mailer.delivery_method == :sunabamail
+        mount Sunabamail::Engine => "/sunabamail"
+      end
+
+    ROUTE
+  end
+
+  def database_configuration_hint
+    say ""
+    say "#{set_color('✔', :green)} Sunabamail setup complete"
+    say ""
+
+    say "Changes applied:", :blue
+    say
+    say "  • Updated config/environments/development.rb"
+    say "    - action_mailer.delivery_method = :sunabamail"
+    say "    - config.sunabamail.connects_to = { database: { writing: :sunabamail } }"
+    say "  • Updated config/routes.rb"
+    say "    - Mounted Sunabamail::Engine at /sunabamail (when delivery_method is :sunabamail)"
+    say ""
+
+    say "Next steps:", :blue
+    say
+
+    say "1. Update config/database.yml:", :bold
+    say ""
+    say "    # if you're SQLite, it'll look like this:"
+    say ""
+    say "    development:"
+    say "      primary:"
+    say "        <<: *default"
+    say "        database: storage/development.sqlite3"
+    say "      sunabamail:"
+    say "        <<: *default"
+    say "        database: storage/development_sunabamail.sqlite3"
+    say "        migrations_paths: db/sunabamail_migrate"
+    say ""
+    say "    # ...or if you're using MySQL/PostgreSQL/Trilogy:"
+    say ""
+    say "    development:"
+    say "      primary: &primary_development"
+    say "        <<: *default"
+    say "        database: app_development"
+    say "        username: app"
+    say "        password: <%= ENV[\"APP_DATABASE_PASSWORD\"] %>"
+    say "      sunabamail:"
+    say "        <<: *primary_development"
+    say "        database: app_development_sunabamail"
+    say "        migrations_paths: db/sunabamail_migrate"
+    say ""
+    say "2. Run:"
+    say ""
+    say "    $ rails db:prepare"
+    say ""
+  end
+end

data/lib/generators/sunabamail/templates/db/sunabamail_schema.rb

@@ -0,0 +1,23 @@
+ActiveRecord::Schema[7.1].define(version: 1) do
+  create_table "sunabamail_message_raws", id: :bigint, force: :cascade do |t|
+    t.datetime "created_at", null: false
+    t.text "encoded", null: false
+    t.bigint "sunabamail_message_id", null: false
+    t.datetime "updated_at", null: false
+    t.index ["sunabamail_message_id"], name: "index_sunabamail_message_raws_on_sunabamail_message_id", unique: true
+  end
+
+  create_table "sunabamail_messages", id: :bigint, force: :cascade do |t|
+    t.string "bcc"
+    t.string "cc"
+    t.datetime "created_at", null: false
+    t.string "from"
+    t.string "reply_to"
+    t.string "sender"
+    t.string "subject"
+    t.string "to"
+    t.datetime "updated_at", null: false
+  end
+
+  add_foreign_key "sunabamail_message_raws", "sunabamail_messages"
+end

data/lib/sunabamail/delivery_method.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Sunabamail
+  class DeliveryMethod
+    def initialize(options = {})
+    end
+
+    def deliver!(mail)
+      subject = mail.subject
+      created_at = mail.date || Time.zone.now
+      updated_at = created_at
+      addresses = %i[bcc cc from reply_to sender to].to_h { [ _1, mail[_1].to_s.presence ] }
+
+      message = Sunabamail::Message.new(**addresses, subject:, created_at:, updated_at:)
+      message.build_raw(encoded: mail.encoded)
+      message.save!
+    end
+  end
+end

data/lib/sunabamail/engine.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Sunabamail
+  class Engine < ::Rails::Engine
+    isolate_namespace Sunabamail
+
+    rake_tasks do
+      load "sunabamail/tasks.rb"
+    end
+
+    config.sunabamail = ActiveSupport::OrderedOptions.new
+
+    initializer "sunabamail.config" do
+      Sunabamail.connects_to = { database: { writing: :sunabamail } }
+
+      config.sunabamail.each do |name, value|
+        Sunabamail.public_send("#{name}=", value)
+      end
+    end
+
+    initializer "sunabamail.add_delivery_method" do
+      ActiveSupport.on_load :action_mailer do
+        ActionMailer::Base.add_delivery_method(:sunabamail, Sunabamail::DeliveryMethod)
+      end
+    end
+  end
+end

data/lib/sunabamail/tasks.rb

@@ -0,0 +1,6 @@
+namespace :sunabamail do
+  desc "Install Sunabamail"
+  task :install do
+    Rails::Command.invoke :generate, [ "sunabamail:install" ]
+  end
+end

data/lib/sunabamail/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Sunabamail
+  VERSION = "0.1.0"
+end

data/lib/sunabamail.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "sunabamail/version"
+
+require "zeitwerk"
+
+loader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
+loader.ignore("#{__dir__}/sunabamail/tasks.rb")
+loader.ignore("#{__dir__}/generators")
+loader.setup
+
+module Sunabamail
+  extend self
+
+  attr_accessor :connects_to
+end
+
+begin
+  require "rails"
+rescue LoadError
+  # do nothing.
+end
+
+if defined?(Rails::Engine)
+  require "sunabamail/engine"
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: sunabamail
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- hamajyotan
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionmailer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+description: Provides a custom Action Mailer delivery method that stores outgoing
+  emails in the database instead of sending them. Stored emails can be viewed through
+  a dedicated interface, making it useful for development and staging environments.
+email:
+- hamajyotan@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".rubocop.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- app/controllers/sunabamail/application_controller.rb
+- app/controllers/sunabamail/messages/alls_controller.rb
+- app/controllers/sunabamail/messages/application_controller.rb
+- app/controllers/sunabamail/messages/attachments_controller.rb
+- app/controllers/sunabamail/messages/htmls_controller.rb
+- app/controllers/sunabamail/messages/raws_controller.rb
+- app/controllers/sunabamail/messages/sources_controller.rb
+- app/controllers/sunabamail/messages/texts_controller.rb
+- app/controllers/sunabamail/messages_controller.rb
+- app/models/sunabamail/message.rb
+- app/models/sunabamail/message_raw.rb
+- app/models/sunabamail/record.rb
+- app/views/layouts/sunabamail/application.html.erb
+- app/views/sunabamail/application/_scripts.html.erb
+- app/views/sunabamail/application/_styles.html.erb
+- app/views/sunabamail/messages/_message.html.erb
+- app/views/sunabamail/messages/index.html.erb
+- app/views/sunabamail/messages/show.html.erb
+- assets/sunabamail.png
+- config/locales/en.yml
+- config/routes.rb
+- lib/generators/sunabamail/install_generator.rb
+- lib/generators/sunabamail/templates/db/sunabamail_schema.rb
+- lib/sunabamail.rb
+- lib/sunabamail/delivery_method.rb
+- lib/sunabamail/engine.rb
+- lib/sunabamail/tasks.rb
+- lib/sunabamail/version.rb
+homepage: https://github.com/hamajyotan/sunabamail
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/hamajyotan/sunabamail
+  source_code_uri: https://github.com/hamajyotan/sunabamail
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: A drop-in Action Mailer delivery method that stores emails in the database
+  instead of sending them.
+test_files: []