rails_mail 0.10.6 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d490206541f350f1c96e83e22233dc0829d3ef4e1102c7d9ef0aba2c2af6fc6
-  data.tar.gz: 84510c52a082d8d8abdec666c0634c55c092c4b10e7d9c25319aa9b8e2a26c00
+  metadata.gz: af2921494ffeba97ba5924b637e2629f63038c848c1e23bc884b5989e20ace82
+  data.tar.gz: f6db844c277f6cbbd5d21032b21b36d8d53582742f8e70221121840347033f08
 SHA512:
-  metadata.gz: 7c2fa09fbe238b7fa0c52e997dd7055922b8a8738e7e52270a1882e844ed877f4be6e6b0fc799e45c6ee525c3f5d3091aefa30df91edad2378a2af4fc08a5e15
-  data.tar.gz: 8f989621de7be287c283899ae8f73a4dfa1e088e57de32c1012c2173f812b15b585a8a8ecca8523d24650fcdc822ea8e64bc7f6b2f3096df18be8b09eda821b0
+  metadata.gz: d8705cb7c5616c3e7b1f147b763bd29369196e83bdc30a14513413aa158bf7c6e931377d25bab927c1a45b65477e6a65e5f7f1a2bfcc365ca1b92b0816cfdbea
+  data.tar.gz: a33272cdb0993a9fc264869c4f037f16a25ae1e00e0e7d5c7d5123b12113c462ae434b1e561b08caa8ab17720d6a22a0015bebf64cfb7e165d9b6a435dab9000

data/README.md

@@ -12,6 +12,7 @@ RailsMail saves all outgoing emails to your database instead of actually sending
 * Implements delivery_method for ActionMailer to catch emails and store them in the database
 * Real-time updates using Turbo and ActionCable
 * Search functionality across email fields (subject, from, to, cc, bcc)
+* Infinite scrolling with customizable per-page count
 * Clean, responsive UI for viewing email contents
 * Optional authentication support
 * Trimming emails older than a specified duration or a maximum number of emails
@@ -111,6 +112,9 @@ RailsMail.configure do |config|
 
   # Control whether trimming runs synchronously (:now) or asynchronously (:later)
   config.sync_via = :later
+
+  # Per-page count for infinite scroll
+  config.per_page = 20
 end
 ```
 
@@ -256,8 +260,6 @@ RailsMail uses Turbo, TurboStreams, and ActionCable to provide real-time updates
 - Implement introspection of application notifiers and allow manual delivery/inspection of emails
   - Need to introspect the arguments of the notifier and see if the arguments can be paired with active record models or to allow a mapping of argument type to sample data / fixtures. 
 - Implement read/unread functionality
-- Implement individual email delete
-- Implement multi-part (text/html) email support
 - Allow clients to add additional acceptable HTML tags to render
 
 ## Contributing

data/app/controllers/rails_mail/emails_controller.rb

@@ -2,20 +2,27 @@ module RailsMail
   class EmailsController < BaseController
     # GET /emails
     def index
-      @emails = Email.all
+      @emails = Email.order(created_at: :desc)
       @emails = @emails.search(params[:q]) if params[:q].present?
-      @emails = @emails.order(created_at: :desc)
-      @email = params[:id] ? Email.find(params[:id]) : Email.last
+      paginated = paginate_with_next_page(@emails, page: params[:page].to_i)
+      @emails, @next_page = paginated.items, paginated.next_page
+      @email = params[:id] ? Email.find(params[:id]) : @emails.last
+      # we're not paginating, so it means we're either the initial index page
+      # load or we're searching. In which case run an "update" turbo stream
+      # to replace all the results.
+      @turbo_stream_action = paginating? ? "append" : "update"
 
       respond_to do |format|
         format.html
-        format.turbo_stream if params.key?(:q)
+        format.turbo_stream if params[:q].present? || params[:page].present?
       end
     end
 
     # GET /emails/1
     def show
       @emails = Email.order(created_at: :desc)
+      paginated = paginate_with_next_page(@emails, page: params[:page].to_i)
+      @emails, @next_page = paginated.items, paginated.next_page
       @email = Email.find(params[:id])
       session[:current_email_id] = @email.id
 
@@ -40,5 +47,20 @@ module RailsMail
         format.turbo_stream
       end
     end
+
+    private
+
+    def paginating?
+      params.key?(:page) && params[:page].to_i >= 1
+    end
+
+    def paginate_with_next_page(relation, page: nil)
+      per_page = RailsMail.configuration.per_page || 20
+      current_page = (page || params[:page] || 0).to_i
+      total_count = relation.count
+      items = relation.offset(current_page * per_page).limit(per_page)
+      next_page = total_count > per_page * (current_page + 1) ? current_page + 1 : nil
+      Struct.new(:items, :next_page).new(items, next_page)
+    end
   end
 end

data/app/helpers/rails_mail/emails_helper.rb

@@ -8,7 +8,7 @@ module RailsMail
         a.set_attribute("data-turbo", "false")
       end
       sanitize(doc.to_html,
-        tags: ActionView::Base.sanitized_allowed_tags + [ "table", "tbody", "tr", "td" ],
+        tags: ActionView::Base.sanitized_allowed_tags + [ "table", "tbody", "tr", "td", "th", "thead", "tfoot" ],
         attributes: ActionView::Base.sanitized_allowed_attributes + [ "style", "target", "data-turbo" ])
     end
   end

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

@@ -24,7 +24,7 @@
                 <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16" />
               </svg>
             </label>
-            
+
             <!-- Title (centered) -->
             <%= link_to root_path, class: "text-gray-900" do %>
               <%= render "layouts/rails_mail/title" %>
@@ -32,7 +32,7 @@
 
             <!-- Clear All button (or empty div for spacing when button is hidden) -->
             <% if instance_eval(&RailsMail.show_clear_all_button_callback) %>
-              <%= button_to destroy_all_emails_path, 
+              <%= button_to destroy_all_emails_path,
                   class: "text-sm text-gray-600 hover:text-gray-900",
                   form: { data: { turbo_confirm: "Are you sure you want to clear all emails?" } },
                   method: :delete do %>
@@ -50,12 +50,12 @@
         </div>
 
         <div id="search-form" class="flex-none px-2 pb-2">
-          <%= form_with url: rails_mail.emails_path, method: :get, data: { turbo_stream: true, turbo_frame: "emails_list",controller: 'auto-submit' } do |f| %>
-            <%= f.search_field :q, 
-              value: params[:q],
-              class: "w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-1 focus:ring-blue-500 focus:border-blue-500",
-              placeholder: "Search emails...",
-              data: { action: 'keyup->auto-submit#submit search->auto-submit#submit' } %>
+          <%= form_with url: rails_mail.emails_path, method: :get, data: { turbo_stream: true, turbo_frame: "emails_list", controller: 'auto-submit' } do |f| %>
+            <%= f.search_field :q,
+                               value: params[:q],
+                               class: "w-full px-3 py-2 border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-1 focus:ring-blue-500 focus:border-blue-500",
+                               placeholder: "Search emails...",
+                               data: { action: 'keyup->auto-submit#submit search->auto-submit#submit' } %>
           <% end %>
         </div>
 
@@ -72,4 +72,4 @@
       </div>
     </div>
   </body>
-</html> 
+</html>

data/app/views/rails_mail/emails/index.turbo_stream.erb

@@ -1,7 +1,16 @@
-<turbo-stream action="update" target="email-sidebar">
+<turbo-stream action="<%= @turbo_stream_action %>" target="email-list-wrapper">
   <template>
     <% @emails&.each do |email| %>
       <%= render partial: "rails_mail/shared/email", locals: {email: email, email_path: email_path(email) }, formats: [:html] %>
     <% end %>
   </template>
 </turbo-stream>
+<turbo-stream action="replace" target="email-pagination">
+  <template>
+    <% if @next_page %>
+      <% path_opts = { format: "turbo_stream", page: @next_page.next } %>
+      <% path_opts[:q] = params[:q] if params[:q].present? %>
+      <%= turbo_frame_tag "email-pagination", src: emails_path(path_opts), loading: "lazy" %>
+    <% end %>
+  </template>
+</turbo-stream>

data/app/views/rails_mail/shared/_email.html.erb

@@ -16,7 +16,7 @@
     <div class="min-w-0">
       <div class="text-sm font-medium text-gray-900 truncate"><%= email.subject %></div>
       <div class="text-xs text-gray-500">
-        <span class="truncate"><%= email.to.join(', ') %></span>
+        <span class="truncate"><%= email.from %></span>
         <time 
           data-controller="timeago" 
           data-timeago-datetime-value="<%= email.created_at.iso8601 %>" 

data/app/views/rails_mail/shared/_email_sidebar.html.erb

@@ -3,7 +3,14 @@
 <% end %>
 
 <div id="email-sidebar" data-controller="email-highlight">
-  <% @emails&.each do |email| %>
-    <%= render "rails_mail/shared/email", email: email, email_path: email_path(email) %>
+  <div id="email-list-wrapper">
+    <% @emails&.each do |email| %>
+      <%= render "rails_mail/shared/email", email: email, email_path: email_path(email) %>
+    <% end %>
+  </div>
+  <% if @next_page %>
+    <% path_opts = { format: "turbo_stream", page: @next_page } %>
+    <% path_opts[:q] = params[:q] if params[:q].present? %>
+    <%= turbo_frame_tag "email-pagination", src: emails_path(path_opts), loading: "lazy", style: "display: block; height: 50px;" %>
   <% end %>
-</div>
+</div>

data/lib/rails_mail/configuration.rb

@@ -4,7 +4,7 @@ module RailsMail
   class Configuration
     attr_accessor :authentication_callback, :show_clear_all_button_callback,
                   :trim_emails_older_than, :trim_emails_max_count,
-                  :enqueue_trim_job
+                  :enqueue_trim_job, :per_page
 
     def initialize
       @authentication_callback = nil
@@ -12,6 +12,7 @@ module RailsMail
       @trim_emails_older_than = nil
       @trim_emails_max_count = nil
       @enqueue_trim_job = ->(email) { RailsMail::TrimEmailsJob.perform_later }
+      @per_page = nil
       register_default_renderers
     end
 

data/lib/rails_mail/renderer/html_renderer.rb

@@ -2,8 +2,7 @@ module RailsMail
   module Renderer
     class HtmlRenderer < Base
       def self.handles?(email)
-        email.content_type&.include?("text/html") ||
-          email.content_type&.include?("multipart/alternative")
+        email.html_part.present?
       end
 
       def self.partial_name

data/lib/rails_mail/renderer/text_renderer.rb

@@ -2,8 +2,7 @@ module RailsMail
   module Renderer
     class TextRenderer < Base
       def self.handles?(email)
-        email.content_type&.include?("text/plain") ||
-          email.content_type&.include?("multipart/alternative")
+        email.text_part.present?
       end
 
       def self.partial_name

data/lib/rails_mail/version.rb

@@ -1,3 +1,3 @@
 module RailsMail
-  VERSION = "0.10.6"
+  VERSION = "0.12.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_mail
 version: !ruby/object:Gem::Version
-  version: 0.10.6
+  version: 0.12.0
 platform: ruby
 authors:
 - Peter Philips
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-25 00:00:00.000000000 Z
+date: 2025-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails