supermail 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5007ee69916bd3c91239105a78c65ac3fc6729adb206e914881166480cca8d63
-  data.tar.gz: 903ba6a76b34ec3f64d8dc0f4bab2d8782a3ea90c727dbec5647d8e8b99a3376
+  metadata.gz: 4efb804624582618a2d1330b68b48030e27a0764f82bd8e5a99d01ba955d2174
+  data.tar.gz: 362d37bf770583b50c86e26cd280158cb8885e8725589ec68a4093ed5fabe79a
 SHA512:
-  metadata.gz: d696046239e5c7bbb875b291ca99fc2533127f72babac2991ace61520522dc095788506857c1b8cc56c91f74e5c5f24de9db88a3046421ea10e9a677ac6fb4c1
-  data.tar.gz: c2e1303de634498310018e9edbecbb1f0718b545698f56b378d172b4a1fc11389d572ab35019a6bf419faf345b8554b27f95181f4c2ec4e4b0ddca4c81da6c78
+  metadata.gz: d3d68858b41c793e45eda60b43f557bd0fc3e049f248d22352f8bd2e52544b10d2b374befca84fac46de283807352e59e2dbd8bb1e8c605fa7826b2b70789935
+  data.tar.gz: 799eca08e4b0997fda627688b0707442cf5a2d66dc8c42fdf10bfcef6d7a1a2d6e2b4641c00de898ffc1e4dbd78b2af50bd58de8926b6ffbe520c76058f2dc8d

data/README.md

@@ -25,6 +25,13 @@ end
 
 Contrast that with rails ActionMailer, where you will spend 20 minutes trying to figure out how to send an email. I created this gem because I got tired of digging through Rails docs to understand how to intialize an email and send it. PORO's FTW!
 
+## Support this project
+
+Learn how to build UI's out of Ruby classes and support this project by ordering the [Phlex on Rails video course](https://beautifulruby.com/phlex).
+
+[![](https://immutable.terminalwire.com/hmM9jvv7yF89frBUfjikUfRmdUsTVZ8YvXc7OnnYoERXfLJLzDcj5dFM7qdfMG2bqQLuw633Zt1gl3O7z0zKmH6k8QmifN7z0kJo.png)](https://beautifulruby.com/phlex/forms/introduction)
+
+
 ## Installation
 
 Install the gem and add to the application's Gemfile by executing:
@@ -76,7 +83,7 @@ class User::WelcomeEmail < ApplicationEmail
   PLAIN
 end
 ```
-
+You can customize the email by overriding the `to`, `from`, `subject`, and `body` methods.s
 
 ```ruby
 # ./app/email/user/welcome.rb
@@ -99,6 +106,8 @@ class User::WelcomeEmail < ApplicationEmail
 end
 ```
 
+### Send emails from the server
+
 Then, to send the email.
 
 ```ruby
@@ -113,6 +122,41 @@ User::Welcome.new(user: User.first).message.tap do
 end.deliver_now
 ```
 
+### Launch the user's email client
+
+Supermail clases can be used to generate `mailto:` links with Rails helpers.
+
+```erb
+<%= link_to Support::OrderEmail.new(
+      user: current_user,
+      order: @order
+    ).mail_to s%>
+```
+
+This opens your users email client with prefilled information. A support email about an order might look like this:
+
+```ruby
+class Support::OrderEmail < ApplicationEmail
+  def initialize(user:, order:)
+    @user = user
+    @order = order
+  end
+
+  def to = "support@example.com"
+  def from = @user.email
+  def subject = "Question about order #{@order.id}"
+  def body = <<~BODY
+    Hi Support,
+
+    I need help with my order #{@order.id}.
+
+    Thanks,
+
+    #{@user.name}
+  BODY
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/generators/supermail/email/email_generator.rb

@@ -3,7 +3,7 @@
 require 'rails/generators/named_base'
 
 module Supermail
-  class EmailGenerator < Rails::Generators::NamedBase
+  class EmailGenerator < ::Rails::Generators::NamedBase
     source_root File.expand_path('templates', __dir__)
 
     desc "Generate a new email class"
@@ -22,4 +22,4 @@ module Supermail
       name.camelize
     end
   end
-end
+end

data/lib/generators/supermail/install/install_generator.rb

@@ -3,7 +3,7 @@
 require 'rails/generators/base'
 
 module Supermail
-  class InstallGenerator < Rails::Generators::Base
+  class InstallGenerator < ::Rails::Generators::Base
       source_root File.expand_path('templates', __dir__)
 
       desc "Install Supermail in a Rails application"
@@ -16,4 +16,4 @@ module Supermail
         empty_directory 'app/emails'
       end
   end
-end
+end

data/lib/generators/supermail/install/templates/application_email.rb.tt

@@ -1,4 +1,4 @@
-class ApplicationEmail < Supermail::Base
+class ApplicationEmail < Supermail::Rails::Base
   def from = "website@example.com"
 
   def body

data/lib/supermail/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Supermail
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/supermail.rb

@@ -1,30 +1,58 @@
 # frozen_string_literal: true
 
 require_relative "supermail/version"
-require 'action_mailer'
+require "action_mailer"
+require "erb"
 
 module Supermail
   class Error < StandardError; end
 
-  class Base
-    delegate :deliver, :deliver_now, :deliver_later, to: :message_delivery
+  module Rails
+    class Base
+      delegate \
+          :deliver,
+          :deliver_now,
+          :deliver_later,
+          :message,
+        to: :action_mailer_base_mail
 
-    def to = nil
-    def from = nil
-    def subject = nil
-    def body = ""
+      def to = nil
+      def from = nil
+      def subject = nil
+      def cc = []
+      def bcc = []
+      def body = ""
 
-    def message
-      message_delivery.message
-    end
+      # Generate a mailto: URL with appropriate escaping.
+      def mailto = MailTo.href(to:, from:, cc:, bcc:, subject:, body:)
+      alias :mail_to :mailto
 
-    def message_delivery
-      ActionMailer::Base.mail(to:, from:, subject:, body:)
+      private def action_mailer_base_mail
+        ActionMailer::Base.mail(to:, from:, cc:, bcc:, subject:, body:)
+      end
     end
   end
-end
 
-# Load generators only when Rails is available
-if defined?(::Rails)
-  require 'rails'
+  module MailTo
+    extend self
+
+    def href(to:, **params)
+      q = query(**params)
+      q.empty? ? "mailto:#{to}" : "mailto:#{to}?#{q}"
+    end
+
+    def query(**params)
+      params
+        .compact                          # drop nils
+        .reject { |k, v| v.is_a?(Array) && v.empty? }  # drop empty arrays
+        .map { |k, v| "#{k}=#{mailto_escape(v)}" }
+        .join("&")
+    end
+
+    private
+
+    def mailto_escape(str)
+      ERB::Util.url_encode(str.to_s).tr("+", "%20")
+    end
+  end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: supermail
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Brad Gessler
 bindir: exe
 cert_chain: []
-date: 2025-09-26 00:00:00.000000000 Z
+date: 2025-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionmailer